Yükseltme, yedekleme ve kaldırma

Botream'i, daha yeni MSI'ı kurulu olanın üzerine çalıştırarak yükseltirsiniz; ajanlar ardından kendilerini günceller. Bu sayfa ayrıca neleri yedeklemeniz gerektiğini, bir sunucuyu nasıl geri yükleyeceğinizi veya taşıyacağınızı ve kaldırmanın geride neler bıraktığını da ele alır.

#Yükseltmeden önce

1. SQL Server veritabanını ve C:\ProgramData\Botream\Server\server.json dosyasını yedekleyin (bkz. Yedekleme). Yükseltme veritabanını günceller; yedek, geri dönüş yolunuzdur.
2. Önemli bir görevin veya zamanlamanın vadesinin gelmediği bir anı seçin: kurulum paketi çalışırken BotreamServer hizmetini durdurur ve sunucu yeniden çalışana kadar ajanlar sunucuya ulaşamaz.

#Sunucuyu yükseltin

Yeni Botream-Server-<version>.msi dosyasını sunucuda, mevcut kurulumun üzerine çalıştırın.

• Port, veritabanı bağlantısı ve ayarlar korunur.
• Bekleyen veritabanı güncellemeleri sunucu başladığında otomatik olarak uygulanır. Ayrı bir geçiş adımı yoktur.
• Yeni sunucu MSI'ı uyumlu ajan kurulum paketini de içerir; bu nedenle sunucu çalışmaya başladığında ajanlar güncellenmeye başlar (aşağıya bakın).

Ardından Administration → System health sayfasını kontrol edin: veritabanının ve zamanlayıcının çalışıp çalışmadığını gösterir.

Not: Yükseltme yalnızca daha düşük bir sürüm numarasının üzerine kurulur. Daha yeni bir sürümün üzerine daha eski bir paket kurmak reddedilir ("A newer version of Botream Server is already installed."). Daha eski bir sürüme dönmek için kaldırın, yükseltmeden önce aldığınız veritabanı yedeğini geri yükleyin ve eski paketi kurun.

#Ajanları güncelleyin

Ajanlar otomatik olarak güncellenir:

• BotreamAgent hizmeti her 30 dakikada bir sunucuya daha yeni bir ajan kurulum paketi sunup sunmadığını sorar.
• Sunuyorsa ve çalışan bir görev yoksa ajan paketi indirir, bütünlüğünü doğrular ve sessizce kurar. Kurulumu başarısız olan bir sürüm 6 saat sonra yeniden denenir.
• Ayarlar ve ajan kimliği korunur.

Administration → Agents altındaki Version sütunu her ajanın sürümünü gösterir ve geride kalan ajanları Update to sürüm ile işaretler.

#Sunucuyu yükseltmeden daha yeni bir ajan sunun

Yalnızca ajanları güncellemek için Administration → Agents → Install an agent öğesini açın ve yeni Botream-Agent-<version>.msi dosyasını yüklemek için Upload a newer version düğmesine tıklayın. Bundan sonra sunucu bu paketi sunar ve ajanlar boşta olduklarında kurar. Alternatif olarak MSI'ı <server installation folder>\web\downloads klasörüne kopyalayın.

#Otomatik güncellemeleri kapatın

Administration → Settings altında Update agents automatically seçeneğini kapatın (Ajan ayarları). Ajanlar bu durumda siz güncelleyene kadar kendi sürümlerinde kalır.

#Bir ajanı elle güncelleyin

Yeni ajan MSI'ını makinede çalıştırın. Kaydedilmiş ayarlar korunur.

#Aynı sürüm numarası

Güncellemeler yalnızca daha yüksek sürüm numarasına sahip paketlerle çalışır. Aynı sürüm numarasına sahip yeni bir paket ne mevcut kurulumun üzerine kurulur ne de ajanlara otomatik olarak dağıtılır. Önce kurulu olanı kaldırın (bkz. Kaldırma), ardından yeni paketi kurun. Kaldırma sırasında ayarlar, veritabanı ve ajan kimliği korunur; bu nedenle yeniden kurulum bunları değişmemiş olarak bulur.

#Yedekleme

Botream verilerini iki yerde tutar. İkisini birlikte yedekleyin:

Uyarı: server.json içindeki şifreleme anahtarı olmadan kasalarda saklanan parolaların, e-posta parolasının ve yapay zekâ anahtarının şifresi çözülemez. Anahtar olmadan alınan bir veritabanı yedeği bu gizli bilgiler dışında her şeyi geri yükler. Anahtarın bir kopyasını (ilk çalıştırma kurulumunun sonunda da bir kez gösterilmişti) veritabanı yedeklerinden ayrı, güvenli bir yerde saklayın.

server.json gizli bilgiler içerir: yedeklerini yalnızca yöneticilerin okuyabileceği bir yerde saklayın.

#Veritabanını yedekleyin

Her zamanki SQL Server yedekleme yönteminizi kullanın; örneğin T-SQL ile tam yedekleme:

BACKUP DATABASE [Botream] TO DISK = N'D:\Backup\Botream.bak' WITH INIT;

SQL Server Express'te yedeklemeleri zamanlamak için SQL Server Agent yoktur; bunun yerine ifadeyi Windows Görev Zamanlayıcı'dan sqlcmd ile çalıştırın.

Veritabanının ne kadar büyüyeceği çoğunlukla çalıştırma geçmişine ve günlüklere bağlıdır. Administration → Settings altındaki Keep execution history for ve Keep audit log for bunu sınırlar (Ayarlar).

#Ajan makineleri

Ajanlar görev verisi tutmaz. C:\ProgramData\Botream\agent.json, makinenin ajan kimliğini ve ayarlarını saklar; o makineye özel olarak korunur ve ajan kaldırıldığında da silinmez.

#Sunucuyu taşıyın veya geri yükleyin

Aynı makine: Veritabanını geri yükleyin, server.json dosyasını C:\ProgramData\Botream\Server klasörüne geri koyun ve BotreamServer hizmetini başlatın.

Yeni makine (veya server.json kaybolduysa):

1. Veritabanı yedeğini SQL Server'a geri yükleyin.
2. Yeni sunucuya Botream-Server-<version>.msi paketini kurun ve o SQL Server'ı ve veritabanını seçin.
3. İlk çalıştırma kurulumunda veritabanı denetimi, veritabanında zaten Botream verileri bulunduğunu ve bunların korunduğunu bildirir.
4. Administrator adımında Keep the existing accounts seçeneğini işaretli bırakın ve Encryption key of the previous installation değerini girin. Bu anahtar olmadan saklanan parolalar (kasalar, e-posta, yapay zekâ anahtarı) okunamaz ve yeniden girilmeleri gerekir.
5. Finish setup düğmesine tıklayın. Kullanıcılar mevcut hesaplarıyla oturum açar.

Kurulum yeni bir Agent registration token oluşturur. Bu nedenle ajanların yeni belirtece ve değiştiyse yeni sunucu adresine ihtiyacı vardır: her ajanın tepsi simgesinden Settings öğesini açın, Change as administrator düğmesine tıklayın ve bunları girin (Ajanları kurun).

#Kaldırma

Botream Server veya Botream Agent uygulamasını Windows'ta Settings → Apps (veya Control Panel → Programs and Features) altından kaldırın.

Ayarlar, veritabanı ve ajan kimliği yerinde kaldığı için yeniden kurulum bunları değişmemiş olarak bulur.

Botream'i tamamen kaldırmak için sunucuda ve ajan makinelerinde C:\ProgramData\Botream klasörünü de silin ve veritabanını SQL Server'da kaldırın. Yeniden ihtiyaç duyabilirseniz önce bunları yedekleyin.