Sunucuyu kurun

Botream Server, web uygulamasını, API'yi ve zamanlayıcıyı BotreamServer Windows hizmeti olarak kuran tek bir Windows kurulum paketidir; bu sayfa sizi boş bir makineden ilk oturum açmaya kadar götürür.

#Neleri kurarsınız

Bir Botream kurulumu iki paketten oluşur:

Şu sırayla kurun:

1. SQL Server
2. Botream Server
3. Tarayıcıda ilk çalıştırma kurulumu
4. Ajanlar (Ajanları kurun)

#Gereksinimler

SQL Server, Botream'in ihtiyaç duyduğu tek dış bileşendir. Node.js veya .NET kurmanız gerekmez: ikisi de pakete dahildir.

#SQL Server'ı hazırlayın

Kuruluşunuzda Botream için bir SQL Server yoksa önce SQL Server'ı kurun. Botream her şeyi tek bir veritabanında (varsayılan adı Botream) tutar; kurulum, veritabanı yoksa onu oluşturur.

SQL Server'ın ihtiyaçları nerede çalıştığına bağlıdır:

• Sunucu makinesinde: Örnek üzerinde sysadmin olan bir Windows hesabıyla oturum açıyorsanız kurulumun ötesinde hiçbir şey gerekmez. TCP/IP ve SQL Server oturum açmaları kapalıysa kurulum bunları kendisi açar.
• Başka bir makinede: TCP/IP açık, SQL Server kimlik doğrulaması etkin ve SQL Server portuna (varsayılan 1433) o makinenin güvenlik duvarında izin verilmiş olmalıdır. Veritabanını oluşturma izni olan bir SQL oturum açma hesabına ihtiyacınız vardır.

#Sunucu kurulum paketini çalıştırın

Sunucuda Botream-Server-<version>.msi dosyasını çalıştırın. Sihirbazda şu sayfalar bulunur:

1. Welcome — Next düğmesine tıklayın.

2. Destination Folder — kurulum klasörü. Varsayılan: C:\Program Files\Botream Server.

3. Port — tarayıcıların ve ajanların Botream'e ulaşmak için kullandığı port (varsayılan 3000). Kurulum bu portu Windows Güvenlik Duvarı'nda açar. 3000 başka bir uygulama tarafından kullanılıyorsa başka bir port seçin.

4. Database — SQL Server'ın nerede olduğu:

   Seçenek	Ne zaman	Sonraki sayfa
   On this computer	SQL Server bu makinede kurulu	Örneği ve oturum açma yöntemini sorar
   On another computer	SQL Server ağdaki başka bir makinede	Adresi, portu ve SQL oturum açma hesabını sorar
   Decide later, in the browser	Bağlantıyı daha sonra girmek istiyorsunuz	Doğrudan kuruluma geçer

5. Seçiminize ait veritabanı ayrıntıları (aşağıya bakın).

6. Ready to install — Install düğmesine tıklayın.

7. Son sayfada Open Botream in the browser to finish the setup seçeneğini işaretli bırakın ve Finish düğmesine tıklayın. İlk çalıştırma kurulumu tarayıcıda açılır.

#Bu bilgisayardaki SQL Server

• Instance: Kurulu örnekler listelenir; kullanılacak olanı seçin.
• Database: Veritabanı adı (varsayılan Botream). Yoksa oluşturulur.
• Oturum açma yöntemi:
  • My Windows account: Windows hesabınız bu SQL Server üzerinde sysadmin olmalıdır. Kurulum veritabanını ve rastgele parolalı, veritabanının sahibi olan bir botream SQL oturum açma hesabı oluşturur. Kapalıysa TCP/IP'yi ve SQL Server oturum açmalarını açar; bunun için SQL Server bir kez yeniden başlatılır.
  • A SQL Server login: Mevcut bir SQL oturum açma hesabının adını ve parolasını girersiniz.
• Test connection bağlantıyı dener; Next aynı denetimi çalıştırır.

Bu makinede SQL Server yoksa sihirbaz bunu belirtir. Önce SQL Server'ı kurun veya diğer seçeneklerden birini kullanın.

#Başka bir bilgisayardaki SQL Server

• Server: Makine adı veya IP adresi. Port: varsayılan 1433. Adlandırılmış bir örnek için örnek adı yerine o örneğin sabit TCP portunu girin.
• Database: Veritabanı adı (varsayılan Botream). Yoksa oluşturulur.
• SQL login / Password: Veritabanını oluşturma izni olan bir SQL oturum açma hesabı.
• Trust the server's certificate: Şirket ağındaki SQL Server'lar için genellikle işaretli bırakılır.
• Test connection bağlantıyı dener.

#Tarayıcıda ilk çalıştırma kurulumu

Kurulum bittiğinde tarayıcıda http://localhost:<port> açılır.

Uyarı: İlk çalıştırma kurulumu yalnızca sunucunun kendisindeki bir tarayıcıda çalışır. Ağdan gelen kurulum istekleri reddedilir; kurulum tamamlanana kadar diğer bilgisayarlar Botream is not set up yet mesajını görür.

Kurulum üç adımdan oluşur: Database, Administrator ve Done.

1. Database
   • Veritabanını kurulum paketinde seçtiyseniz sayfa hazırlanan bağlantıyı (Server, Database, SQL login) gösterir ve denetler; siz de Next düğmesine tıklarsınız. Use a different SQL Server başka bir sunucu girmenizi sağlar.
   • Decide later, in the browser seçeneğini seçtiyseniz Server, Port, Database, SQL login ve Password bilgilerini girer, Test connection ve ardından Next düğmesine tıklarsınız. Veritabanı ve tabloları oluşturulur.
2. Administrator — tam erişime sahip ilk hesap: Username (en az 3 karakter), Email, Password (en az 8 karakter) ve Repeat password. Finish setup düğmesine tıklayın.
3. Done — sayfa iki anahtarı yalnızca bir kez gösterir:
   • Agent registration token — ajanları kurarken girersiniz. Yöneticiler bunu daha sonra Administration → Agents → Install an agent altında yeniden görüntüleyebilir.
   • Encryption key — kasalardaki parolaları, e-posta parolasını ve yapay zekâ anahtarını şifreler. Bir kopyasını güvenli bir yerde saklayın: yeniden kurulumda saklanan parolaları okumak için gereklidir.

Open Botream düğmesine tıklayın. Sunucu yeniden başlatma gerektirmeden normal çalışmaya geçer ve yönetici hesabıyla oturum açabilirsiniz. Diğer kullanıcılar Administration → Users altında eklenir (Kullanıcılar ve roller).

Diğer bilgisayarlardan adres http://<server-name>:<port> şeklindedir.

Not: Veritabanında zaten Botream verileri varsa (örneğin yeniden kurulumdan sonra), Administrator adımı Keep the existing accounts seçeneğini ve Encryption key of the previous installation için bir alan sunar. Bkz. Yükseltme, yedekleme ve kaldırma.

#Sessiz kurulum

Yazılım dağıtım araçları için kurulum paketini yükseltilmiş bir komut isteminden çalıştırın:

# Database chosen later, in the browser
msiexec /i Botream-Server-<version>.msi /qn PORT=3000

# SQL Server on this machine
msiexec /i Botream-Server-<version>.msi /qn SQLMODE=local [SQLINSTANCE=SQLEXPRESS] [SQLDATABASE=Botream] [SQLUSER=.. SQLPASSWORD=..]

# SQL Server on another machine
msiexec /i Botream-Server-<version>.msi /qn SQLMODE=remote SQLSERVER=sql01 [SQLPORT=1433] [SQLDATABASE=Botream] SQLUSER=.. SQLPASSWORD=.. [SQLTRUSTCERT=0]

SQLMODE=local kullanıldığında ve SQLUSER verilmediğinde kurulum, kurulumu çalıştıran Windows hesabıyla bağlanır; bu hesap örnek üzerinde sysadmin olmalıdır.

Sessiz kurulumdan sonra ilk yönetici hesabını oluşturmak için sunucuda http://localhost:<port> adresini açın.

#Hizmet, dosyalar ve portlar

Hizmet, sunucu işlemi beklenmedik şekilde durursa onu kendiliğinden yeniden başlatır. Sunucu başladığında SQL Server henüz hazır değilse sunucu yeniden denemeye devam eder.

#Portlar

Bağlantıyı sunucuya ajanlar açar; ajan makinelerine dışarıdan hiçbir şey bağlanmaz.

#Yapılandırma

İlk çalıştırma kurulumu C:\ProgramData\Botream\Server\server.json dosyasını yazar. Dosya şunları içerir:

Aynı adlara sahip ortam değişkenleri dosyadan önceliklidir. Geri kalan her şey — yeni ajanların onaylanması, geçmişin saklanması, self-healing (kendi kendini onarma), e-posta, yapay zekâ — web uygulamasında Administration → Settings altında yapılandırılır (Ayarlar).

Uyarı: server.json dosyasını SQL veritabanıyla birlikte yedekleyin. İçindeki şifreleme anahtarı olmadan kasalardaki parolaların şifresi çözülemez. Bkz. Yükseltme, yedekleme ve kaldırma.

#HTTPS

Sunucu, seçilen portta düz HTTP üzerinden dinler. Ajanlar veya kullanıcılar sunucuya güvenmediğiniz ağlar üzerinden ulaşıyorsa Botream'i HTTPS arkasında yayınlayın ve ajanlara https:// adresini girin. Görevlerin kasalardan okuduğu kimlik bilgileri ajanların bağlantısı üzerinden iletilir; bu nedenle üretim ortamında sunucu ile ajanlar arasında HTTPS kullanın.

#Kurulumu kontrol edin

• Administration → System health, veritabanı gidiş-dönüş süresini, zamanlayıcının durumunu ve son hatasını ve bağlı ajanları gösterir.
• GET /api/system/health, izleme sisteminiz için en düşük düzeyde, herkese açık bir yoklama uç noktasıdır.

#Sorun giderme

Sonraki adım: Ajanları kurun.