Kurulum Rehberi

Windows Yedekleme Ajanı Kurulumu

Ajan, sunucunuzda veya bilgisayarınızda arka planda çalışır; panelde tanımladığınız işleri zamanı geldiğinde çalıştırır, dosyaları sıkıştırır ve şifreli bağlantı üzerinden Senkronis depolama alanına yükler. Kurulum yaklaşık 5 dakika sürer.

1

Gereksinimler

  • Windows 10 / 11 veya Windows Server 2016 ve üzeri
  • PowerShell 5.1 veya üzeri (Windows ile birlikte gelir)
  • Yönetici (Administrator) yetkisi
  • İnternet erişimi (giden HTTPS / 443 portu)
  • MSSQL yedekleri için: sunucuda sqlcmd aracı (SQL Server Management Studio veya "Microsoft Command Line Utilities for SQL Server" ile gelir) ve yedek alabilen bir SQL kullanıcısı (db_backupoperator rolü yeterlidir).
  • Şifreli arşiv için: 7-Zip kurulu olması önerilir. Kurulu değilse ajan, taşınabilir 7zr.exe dosyasını otomatik indirmeyi dener; o da başarısız olursa şifresiz ZIP ile devam eder.
2

Panelde cihaz oluşturun

Müşteri panelinde Cihazlar → Yeni Cihaz adımından bir cihaz ekleyin. Oluşturulan her cihaza özel bir cihaz anahtarı (token) verilir. Bu anahtar, ajanın hangi hesaba ve hangi cihaza ait olduğunu belirler; kimseyle paylaşmayın.

3

Tek komutla kurulum

Cihaz detay sayfasındaki "Kurulum Komutu" alanındaki komutu kopyalayın ve Yönetici olarak açılmış PowerShell penceresine yapıştırın. Komut aşağıdaki gibidir (cihaz anahtarı ve sunucu adresi size özel üretilir):

Set-ExecutionPolicy Bypass -Scope Process -Force
$u = "https://SUNUCU-ADRESI/api/agent/download/install.ps1"
iwr $u -OutFile "$env:TEMP\install.ps1"
& "$env:TEMP\install.ps1" -Token "CIHAZ-ANAHTARI" -Server "https://SUNUCU-ADRESI"

Kurulum betiği şunları yapar:

  • Ajan dosyalarını C:\ProgramData\Senkronis\Agent klasörüne kopyalar
  • Token ve sunucu adresini config.json dosyasına yazar
  • SenkronisAgent adlı bir Görev Zamanlayıcı görevi oluşturur (SYSTEM hesabı ile, her 1 dakikada bir çalışır)
  • Sunucuya kayıt isteği gönderir; panelde cihaz "Çevrimiçi" görünür
4

Yedekleme işi tanımlayın

Panelde Yedekleme İşleri → Yeni İş adımından cihaza iş ekleyin. Üç tür desteklenir:

  • Klasör yedeği: Bir veya birden fazla klasör yolu (örn. D:\Muhasebe). Dilerseniz hariç tutulacak uzantılar belirtebilirsiniz.
  • MSSQL veritabanı yedeği: Sunucu adı, veritabanı adları ve SQL kullanıcı bilgileri. Ajan BACKUP DATABASE komutunu çalıştırır, oluşan .bak dosyalarını sıkıştırıp yükler.
  • Kullanıcı profili yedeği: Seçilen Windows kullanıcısının Masaüstü, Belgeler, Resimler ve İndirilenler klasörleri.

Zamanlama günlük / haftalık / aylık olabilir. Saklama kuralı olarak "son N yedek" veya "son N gün" seçebilirsiniz; eski yedekler otomatik silinir. "Şimdi Çalıştır" düğmesi ajanın bir sonraki kontrolünde (en geç 1 dakika) işi hemen başlatır.

5

MSSQL yedeği için hazırlık

SQL Server üzerinde yedek alma yetkisine sahip bir kullanıcı oluşturun ve SQL Server Authentication'ın açık olduğundan emin olun:

CREATE LOGIN senkronis_backup WITH PASSWORD = 'GucluBirSifre!2026';
USE [VeritabaniAdi];
CREATE USER senkronis_backup FOR LOGIN senkronis_backup;
ALTER ROLE db_backupoperator ADD MEMBER senkronis_backup;

Ajan SYSTEM hesabı ile çalıştığı için geçici .bak dosyaları C:\ProgramData\Senkronis\Agent\temp klasörüne yazılır. SQL Server servisinin bu klasöre yazma yetkisi olmalıdır (kurulum betiği gerekli izni verir).

6

Şifreli arşiv (7-Zip)

İş tanımında "ZIP şifresi" girerseniz ajan, 7-Zip ile AES-256 şifreli arşiv oluşturur. Şifre Senkronis tarafında saklanmaz; indirdiğiniz arşivi açmak için şifreyi bilmeniz gerekir. 7-Zip'i 7-zip.org adresinden kurabilirsiniz.

7

Günlük (log) dosyaları ve kontrol

Ajanın çalışıp çalışmadığını kontrol etmek için:

Get-ScheduledTask -TaskName SenkronisAgent | Get-ScheduledTaskInfo
Get-Content C:\ProgramData\Senkronis\Agent\logs\agent.log -Tail 50

Ajanı elle çalıştırmak için: powershell -ExecutionPolicy Bypass -File C:\ProgramData\Senkronis\Agent\agent.ps1

8

Sorun giderme

  • Cihaz çevrimdışı görünüyor: Görev Zamanlayıcı'da SenkronisAgent görevinin etkin olduğunu ve internet erişimini kontrol edin.
  • "Kota dolu" hatası: Paketinizi yükseltin veya saklama sayısını azaltın; eski yedekleri panelden silebilirsiniz.
  • MSSQL yedeği başarısız: sqlcmd'nin PATH üzerinde olduğundan ve kullanıcı bilgilerinin doğru olduğundan emin olun. Hata mesajı panelde Geçmiş sayfasında görünür.
  • Geçersiz token: Cihaz panelden silinmiş veya anahtar yenilenmiş olabilir. Yeni anahtar ile kurulumu tekrar çalıştırın.
9

Kaldırma

Unregister-ScheduledTask -TaskName SenkronisAgent -Confirm:$false
Remove-Item -Recurse -Force C:\ProgramData\Senkronis\Agent

Ardından panelden cihazı silebilirsiniz; cihaza ait yedekler de depodan kaldırılır.