Bu kılavuz, HQbird 2027’yi bir Windows sunucusuna Setup programı hqbird2027-fbNN-setup-<version>.exe ile nasıl kuracağınızı gösterir. İki bölümü vardır:

Daha eski bir HQbird’ün güncellemesi, Setup’ın bakım kipi, kaldırma ve sorun giderme tam kılavuzdadır: hqbird2027-windows-setup-guide.md.

Ekran görüntüleri, temiz bir Windows 10 üzerinde Firebird 5.0 için Setup 2027.2.33’ü gösterir. Firebird 2.5, 3.0 ve 4.0 için Setup programlarının sayfaları aynıdır. Sessiz çalıştırmanın ekran görüntüsü bir test derlemesiyle alınmıştır.

1. Başlamadan önce

Setup’ı seçin. Bir Setup bir Firebird sürümü kurar:

Setup Firebird Varsayılan bağlantı noktası
hqbird2027-fb50-setup-<version>.exe 5.0 3050
hqbird2027-fb40-setup-<version>.exe 4.0 3050
hqbird2027-fb30-setup-<version>.exe 3.0 3050
hqbird2027-fb25-setup-<version>.exe 2.5 3050

Gereksinimler:

  • Windows 10 veya 11 ya da Windows Server 2016 veya daha yenisi, 64 bit.
  • Bir yönetici hesabı. Setup yükseltme ister.
  • İnternet bağlantısı gerekmez. Setup tüm dosyaları içerir.

Setup’ın kurdukları:

Bileşen Windows hizmeti Varsayılan konum
Firebird sunucusu (HQbird derlemesi) FirebirdServerHQBirdInstanceFB5 C:\HQbird\Firebird50, bağlantı noktası 3050
HQbird aracısı (yedekler, izleme, güncellemeler) HQbirdFBAgent-fb50 C:\HQbird\fbagent-fb50
HQbird Monitor (web konsolu) HQbirdMonitor-fb50 http://localhost:23050/
fbmcp, AI istemcileri için MCP sunucusu (isteğe bağlı) fbmcp C:\HQbird\fbmcp

Aracının ve HQbird Monitor’ün çalışma verileri C:\HQbirdData klasörüne gider. Yukarıdaki adlar Firebird 5.0 içindir. Firebird 4.0 için fb40 ve FB4 içerirler ve bu böyle gider.

Diller. Sihirbazda 8 dil vardır: İngilizce, Brezilya Portekizcesi, Almanca, Rusça, İspanyolca, Lehçe, Türkçe ve Basitleştirilmiş Çince. Setup’ı başlattığınızda bir dil listesi gösterir. Windows dili seçilidir.

2. Etkileşimli kurulum

Setup dosyasını başlatın ve Windows’un yükseltme istemini kabul edin. Dili seçin ve Tamam düğmesine tıklayın.

Kuruluma hazır sayfasında Kur düğmesine tıklayana kadar Setup bilgisayarda hiçbir şeyi değiştirmez. Her sayfada Geri düğmesine tıklayabilirsiniz.

Adım 1: Hoş geldiniz

Hoş geldiniz

Sayfa, HQbird sürümünü ve Firebird sürümünü gösterir. İleri düğmesine tıklayın.

Adım 2: Lisans sözleşmesi

Lisans sözleşmesi

Sözleşmeyi okuyun. Sözleşmeyi kabul ediyorum seçeneğini seçin ve İleri düğmesine tıklayın.

Setup ardından dosyalarını açar ve bilgisayarı denetler. Bu birkaç saniye sürer.

Adım 3: Sunucu denetimi sonuçları

Sunucu denetimi sonuçları

Sayfa iki liste gösterir:

  • Bu bilgisayarda bulunanlar: daha eski bir HQbird, HQbird aracıları ve Firebird sunucuları.
  • Planlanan eylemler: Setup’ın varsayılan ayarlarla kuracakları.

fbmcp istemiyorsanız AI istemcileri için MCP sunucusu fbmcp’yi kur onay kutusunun işaretini kaldırın. İleri düğmesine tıklayın.

Setup aynı sürümden bir Firebird veya daha eski bir HQbird bulursa sonraki sayfa Kurulum türü sayfasıdır (güncelleme veya yeni bir örnek). Tam kılavuza bakın: hqbird2027-windows-setup-guide.md.

Adım 4: Kurulum klasörleri

Kurulum klasörleri

  • HQbird klasörü: Firebird ve HQbird aracısı bu klasörün alt klasörlerine gider.
  • Veri klasörü: HQbird aracısının ve HQbird Monitor’ün çalışma verileri ve HQbird Monitor oturum açma dosyası. Veritabanları burada saklanmaz.

İki farklı klasör kullanın.

Adım 5: Firebird sunucusu

Firebird sunucusu

  • Firebird klasörü: varsayılan, HQbird klasöründe Firebird50 olur.
  • Bağlantı noktası: varsayılan 3050’dır. Başka hiçbir programın kullanmadığı bir bağlantı noktası kullanın.
  • Firebird hizmet adı: yalnızca başka bir Firebird aynı adı kullanıyorsa değiştirin.

Son satırlar, HQbird aracısının ve HQbird Monitor’ün klasörünü ve hizmet adlarını gösterir.

Adım 6: SYSDBA parolası

SYSDBA parolası

Firebird yöneticisinin (SYSDBA) parolasını iki kez girin. İki alanı boş bırakırsanız Setup varsayılan Firebird parolasını kullanır: masterkey. Bir üretim sunucusunda güçlü bir parola kullanın.

Adım 7: HQbird Monitor

HQbird Monitor

HQbird Monitor, HQbird’ün web konsoludur.

  • Bağlantı noktası: varsayılan, 20000 + Firebird bağlantı noktasıdır (23050). Setup bu bağlantı noktasını Windows Güvenlik Duvarı’nda açar.
  • Kullanıcı adı: varsayılan admin olur.
  • Parola: harf ve rakam içeren 7 ile 128 karakter. İki kez girin.

HQbird Monitor’e bu kullanıcı adı ve parolayla oturum açarsınız.

Adım 8: Sunucu adı

Sunucu adı

Sunucu adı, yeni HQbird aracısının aracı kimliğidir. HQCenter sunucuyu bu ad altında gösterir. Varsayılan, bilgisayar adının küçük harflerle yazılmış halidir. Ad 1 ile 128 karakter olabilir: harf, rakam, - veya _.

Adım 9: Replikasyon ve küme kurulumu (isteğe bağlı)

Replikasyon ve küme kurulumu

İki seçenek varsayılan olarak kapalıdır. Bunları daha sonra HQbird Monitor’de açabilirsiniz.

  • Replikasyon düğümü keşif modunu aç: önümüzdeki 24 saat içinde bu örnekte replikasyonu yapılandıracaksanız seçin.
  • Replikasyon Kümesi Yöneticisini (RCM) bu sunucuya kur: RCM, sunucuları bir replikasyon kümesine bağlayan web konsoludur. Onu yalnızca kümenin bir sunucusuna kurun.

Adım 10: Deneme süresi (isteğe bağlı)

Deneme süresi

Kayıt olmadan deneme 7 gün sürer. Bunu 30 güne uzatmak için:

  1. İş e-posta adresinizi girin.
  2. E-postanın dilini seçin.
  3. Setup’ın e-posta adresimi IBSurgeon’a göndermesini kabul ediyorum seçeneğini seçin.

Ardından 6 haneli bir kod içeren bir e-posta alırsınız. Kodu HQbird Monitor’e girin. Bu adımı atlamak için adresi boş bırakın ve İleri düğmesine tıklayın.

Adım 11: Otomatik güncellemeler

Otomatik güncellemeler

Setup, sunucu HQCenter’a bağlı değilken bu sayfayı gösterir. HQbird o zaman yeni sürümler için IBSurgeon güncelleme sunucusunu denetleyebilir. HQbird’ün kendiliğinden neyi güncelleyeceğini seçin:

  • Yalnızca HQbird (önerilir): HQbird aracısı, HQbird Monitor ve fbmcp kendiliğinden güncellenir. Yeni bir Firebird sürümü indirilir ve yöneticiyi bekler.
  • HQbird ve Firebird: Firebird de kendiliğinden güncellenir, geceleri 03:30 ile 04:00 arasında. Güncelleme Firebird’ü yeniden başlatır.
  • Kapalı: güncelleme denetimi yok. Güncellemek için yeni bir HQbird sürümünün Setup programını çalıştırın.

Bu ayarı daha sonra HQbird Monitor’de değiştirebilirsiniz. Sunucuyu daha sonra HQCenter’a bağlarsanız güncellemeleri HQCenter yönetir.

Setup, Setup klasörü attach.json içerdiğinde bu sayfayı atlar.

Adım 12: Lisans dosyası (isteğe bağlı)

Lisans dosyası

Bir HQbird lisans dosyanız (.json veya .lic) varsa onu seçin. Lisans dosyası olmadan HQbird deneme modunda çalışır. Lisansı daha sonra Başlat menüsü kısayolu HQbird 2027 (Firebird 5.0) bakım ile kurabilirsiniz.

Adım 13: HQCenter’a bağlanma (isteğe bağlı)

HQCenter’a bağlan

Şirketiniz HQCenter kullanıyorsa, HQCenter’dan indirdiğiniz bağlantı dosyasını (attach.json) seçin. Kullanmıyorsa bu adımı atlayın. Dosya gizli bir erişim belirteci içerir: kurulumdan sonra onu silin.

Adım 14: Kuruluma hazır

Kuruluma hazır

Sayfa; görevi, eylemleri, klasörleri, hizmet adlarını ve otomatik güncelleme kipini listeler. Tüm satırları görmek için listeyi kaydırın. Listeyi okuyun. Bir ayarı değiştirmek için Geri, başlamak için Kur düğmesine tıklayın.

Adım 15: Kuruluyor

Kuruluyor

Setup; Firebird’ü, HQbird aracısını ve HQbird Monitor’ü kurar. Bu birkaç dakika sürer. Pencereyi kapatmayın.

Adım 16: Kurulum tamamlandı

Kurulum tamamlandı

Özet şunları gösterir:

  • Firebird sürümü, klasörü ve bağlantı noktası.
  • HQbird aracısının klasörü, hizmeti ve sunucu adı.
  • HQbird Monitor adresleri: bu bilgisayarda ve başka bir bilgisayardan.
  • HQbird Monitor kullanıcı adı.
  • fbmcp, replikasyon ve isteğe bağlı adımlar hakkında notlar.

HQbird Monitor’ü aç düğmesi web konsolunu tarayıcıda açar. İleri düğmesine tıklayın.

Adım 17: Bitir

Bitir

Web konsolunu açmak için HQbird Monitor’ü tarayıcıda aç seçili kalsın ve Bitir düğmesine tıklayın.

Kurulumdan sonra

  • HQbird Monitor: http://localhost:23050/ adresini açın ve adım 7’deki kullanıcı adı ve parolayla oturum açın.
  • Başlat menüsü, HQbird 2027 grubu: HQbird Monitor (Firebird 5.0, bağlantı noktası 23050), HQbird belgeleri (Firebird 5.0), HQCenter’a bağlan (Firebird 5.0) ve HQbird 2027 (Firebird 5.0) bakım.
  • Hizmetler: FirebirdServerHQBirdInstanceFB5, HQbirdFBAgent-fb50 ve HQbirdMonitor-fb50 çalışır ve otomatik başlar.
  • Klasörler: programlar C:\HQbird içinde, çalışma verileri C:\HQbirdData içinde.

3. Komut satırı kurulumu (sessiz)

Sessiz bir çalıştırma pencere göstermez ve soru sormaz. Bunu komut dosyalarında ve uzaktan kurulum için kullanın.

Komut

Bir komut istemini yönetici olarak açın ve çalıştırın:

Command
start /wait "" hqbird2027-fb50-setup-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /YES /LOG=C:\Temp\hqbird-setup.log
echo Exit code: %ERRORLEVEL%
Anahtar Anlam
/VERYSILENT Sihirbaz ve ilerleme penceresi yok. Çalıştırma lisans sözleşmesini kabul eder
/SUPPRESSMSGBOXES İleti kutusu yok
/YES Setup’ın sorularına evet yanıtı verin (örneğin: Firebird’ü durdurun)
/LOG=<file> Setup günlüğünü yazın. Her zaman ekleyin: sessiz çalıştırmanın hataları yalnızca günlüktedir

start /wait, Setup’ı bekler ve çıkış kodunu %ERRORLEVEL% içine koyar. Çıkış kodu 0 = kuruldu.

Başka anahtarlar olmadan Setup sihirbazın varsayılanlarını kullanır: klasörler C:\HQbird ve C:\HQbirdData, Firebird bağlantı noktası 3050, HQbird Monitor bağlantı noktası 23050, deneme e-postası yok, lisans dosyası yok, yalnızca HQbird’ün otomatik güncellemeleri. Parolalar sihirbazdakinden farklıdır:

  • SYSDBA: Setup bir parola oluşturur. Kendinizinkini /SYSDBAPASSFILE= ile verin.
  • HQbird Monitor: oluşturulan bir parolayla admin kullanıcısı. Parola C:\HQbirdData\config\access.properties içindedir (yalnızca yöneticiler). Kendinizinkini /HQMLOGIN= ve /HQMPASSFILE= ile verin.

Örnek: parolalarınızla sessiz kurulum

Command
cd /d C:\Temp
echo Sysdba-2027-Pass>sysdba.txt
echo Monitor-2027-Pass>hqm.txt
start /wait "" hqbird2027-fb50-setup-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /YES /SYSDBAPASSFILE=sysdba.txt /HQMLOGIN=admin /HQMPASSFILE=hqm.txt /LOG=C:\Temp\hqbird-setup.log
echo Exit code: %ERRORLEVEL%
del sysdba.txt hqm.txt

Komut isteminde sessiz kurulum

Notlar:

  • Parola dosyası bir UTF-8 metin dosyasıdır. Setup ilk satırını okur.
  • echo komutunda > işaretinden önce boşluk koymayın: boşluk parolanın bir parçası olur.
  • Göreli bir dosya yolu, Setup klasöründen sayılır.
  • PowerShell’de dosyayı Set-Content -Encoding UTF8 ile yazın. PowerShell’in > işareti UTF-16 yazar ve Setup böyle bir dosyayı reddeder.

Aynısı PowerShell’de (yönetici olarak çalıştırın):

Command
Set-Content -Path C:\Temp\sysdba.txt -Value 'Sysdba-2027-Pass' -Encoding UTF8
Set-Content -Path C:\Temp\hqm.txt -Value 'Monitor-2027-Pass' -Encoding UTF8
$p = Start-Process -Wait -PassThru -FilePath C:\Temp\hqbird2027-fb50-setup-<version>.exe `
  -ArgumentList '/VERYSILENT', '/SUPPRESSMSGBOXES', '/YES', `
    '/SYSDBAPASSFILE=C:\Temp\sysdba.txt', '/HQMLOGIN=admin', '/HQMPASSFILE=C:\Temp\hqm.txt', `
    '/LOG=C:\Temp\hqbird-setup.log'
$p.ExitCode   # 0 = installed
Remove-Item C:\Temp\sysdba.txt, C:\Temp\hqm.txt

Sihirbaz ayarlarının anahtarları

Sihirbazın her ayarının bir anahtarı vardır:

Sihirbaz sayfası Anahtar Varsayılan
Sunucu denetimi sonuçları /NOFBMCP: fbmcp kurma fbmcp kurulur
Kurulum klasörleri /HQBIRDROOT=<folder>: HQbird klasörü C:\HQbird
Kurulum klasörleri /DATAROOT=<folder>: veri klasörü C:\HQbirdData
Firebird sunucusu /FBDIR=<folder>: Firebird klasörü C:\HQbird\Firebird50
Firebird sunucusu /FBPORT=<port>: Firebird bağlantı noktası 3050
Firebird sunucusu /FBINSTANCE=<name>: hizmet FirebirdServer<name> olur HQBirdInstanceFB5
SYSDBA parolası /SYSDBAPASSFILE=<file> oluşturulur
HQbird Monitor /HQMPORT=<port> 20000 + Firebird bağlantı noktası
HQbird Monitor /HQMLOGIN=<name> /HQMPASSFILE=<file> admin, oluşturulan parola
Sunucu adı /AGENTID=<name> küçük harflerle bilgisayar adı
Replikasyon ve küme kurulumu /DISCOVERY: keşif modunu 24 saatliğine aç kapalı
Replikasyon ve küme kurulumu /RCM: RCM’yi bu sunucuya kur kapalı
Deneme süresi /EMAIL=<address> /ACCEPTPRIVACY [/MAILLANG=en|ru|pt-BR] deneme e-postası yok
Otomatik güncellemeler /AUTOUPDATE=all|agent|off: agent = yalnızca HQbird, all = HQbird ve Firebird, off = güncelleme denetimi yok agent
Lisans dosyası /LICENSE=<file> yok
HQCenter’a bağlan /ATTACH=<attach.json> Setup klasöründe varsa attach.json
Dil listesi /LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN Windows dili

/SYSDBAPASS=<password> ve /HQMPASS=<password> de çalışır, ancak parola o zaman Setup günlüğünde görünür. Parola dosyalarını tercih edin.

/AUTOUPDATE= yalnızca sunucu HQCenter’a bağlı değilken etkilidir. HQCenter ile güncellemeleri HQCenter yönetir.

Sessiz bir çalıştırmada /LANG= günlükteki bazı iletilerin dilini ayarlar. İngilizce bir günlük için /LANG=en kullanın.

Başka klasörler, başka bir bağlantı noktası ve bir deneme e-postası ile örnek:

Command
start /wait "" hqbird2027-fb50-setup-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /YES ^
  /HQBIRDROOT=D:\HQbird /DATAROOT=D:\HQbirdData /FBPORT=3055 ^
  /SYSDBAPASSFILE=C:\Temp\sysdba.txt /HQMLOGIN=admin /HQMPASSFILE=C:\Temp\hqm.txt ^
  /[email protected] /ACCEPTPRIVACY /MAILLANG=en ^
  /LANG=en /LOG=C:\Temp\hqbird-setup.log

Çıkış kodları

Kod Anlam
0 Kuruldu
1 Kurulumdan önce reddedildi: hatalı bir anahtar veya dosya, daha yeni bir sürüm kurulu veya yönetici hakları yok. Neden günlüktedir
4 Setup’ın bir sorusu vardı ve komutta /YES yoktu
7 Sunucu denetimi veya kurulum başarısız oldu. Hata günlüktedir ve %ProgramData%\fbagent\hqbird2027-setup-result.json dosyasındadır
10 Kuruldu, ancak HQCenter bağlantısı başarısız oldu

Sonucu denetleyin

Command
sc query FirebirdServerHQBirdInstanceFB5 | findstr "SERVICE_NAME STATE"
sc query HQbirdFBAgent-fb50 | findstr "SERVICE_NAME STATE"
sc query HQbirdMonitor-fb50 | findstr "SERVICE_NAME STATE"

Üç hizmetin durumu RUNNING olmalıdır. Ardından http://localhost:23050/ adresini açın ve HQbird Monitor’de oturum açın.

Kurulum başarısız olunca duran bir komut dosyası:

Command
@echo off
start /wait "" hqbird2027-fb50-setup-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /YES /LOG=C:\Temp\hqbird-setup.log
if errorlevel 1 (
  echo HQbird setup failed with code %ERRORLEVEL%, see C:\Temp\hqbird-setup.log
  exit /b %ERRORLEVEL%
)
echo HQbird 2027 installed

Sessiz kaldırma

Command
start /wait "" "C:\HQbird\setup\fb50\unins000.exe" /VERYSILENT

Bu, programları ve hizmetleri kaldırır. Veritabanları, yapılandırma dosyaları ve Firebird güvenlik veritabanı kalır. Çalışma verilerini, güvenlik veritabanını ve yapılandırma dosyalarını da kaldırmak için /REMOVEDATA ekleyin. Veritabanı dosyaları her zaman kalır.

4. Daha fazla bilgi

  • Güncelleme, bakım, birkaç örnek, HQCenter, tüm anahtarlar ve sorun giderme: hqbird2027-windows-setup-guide.md.
  • Windows ve Linux’ta kaldırma: Kaldırma.
  • Linux kurucusu: Linux kurulum kılavuzu.