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.
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
sqlcmdaracı (SQL Server Management Studio veya "Microsoft Command Line Utilities for SQL Server" ile gelir) ve yedek alabilen bir SQL kullanıcısı (db_backupoperatorrolü yeterlidir). - Şifreli arşiv için: 7-Zip kurulu olması önerilir. Kurulu değilse ajan, taşınabilir
7zr.exedosyasını otomatik indirmeyi dener; o da başarısız olursa şifresiz ZIP ile devam eder.
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.
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\Agentklasörüne kopyalar - Token ve sunucu adresini
config.jsondosyası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
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 DATABASEkomutunu ç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.
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).
Ş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.
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 50Ajanı elle çalıştırmak için: powershell -ExecutionPolicy Bypass -File C:\ProgramData\Senkronis\Agent\agent.ps1
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.
Kaldırma
Unregister-ScheduledTask -TaskName SenkronisAgent -Confirm:$false
Remove-Item -Recurse -Force C:\ProgramData\Senkronis\AgentArdından panelden cihazı silebilirsiniz; cihaza ait yedekler de depodan kaldırılır.