Bu sayfa makine çevirisidir. İngilizce orijinalini okuyun. English

Bu kılavuz, HQbird 2027’yi çevrimdışı yükleyici hqbird2027-fbNN-linux-<version>.run ile bir Linux sunucusuna kuran yönetici içindir. Yeni kurulumu, daha eski bir HQbird’in ve önceki bir HQbird 2027’nin güncellenmesini, bakım komutlarını, HQCenter’ınıza bağlanmayı, katılımsız (betikli) kurulumu ve kurulumdan sonra dosyaların nerede olduğunu kapsar.

Örnekler, Ubuntu 24.04 üzerinde Firebird 5.0 için yükleyiciyi gösterir. Firebird 2.5, 3.0 ve 4.0 için yükleyiciler aynı şekilde çalışır; yalnızca sürüm, varsayılan port ve klasör adları farklıdır. Windows kurulumu Windows kurulumu bölümünde açıklanmıştır.

İçindekiler

  1. 1. Yükleyicinin kurduğu şeyler
  2. 2. Bir bakışta kurulum
  3. 3. Yeni kurulum
  4. 4. Kurulumdan sonra
  5. 5. Eski bir HQbird’in (2024 ve öncesi) güncellenmesi
  6. 6. HQbird 2027’nin yeni bir sürüme güncellenmesi
  7. 7. Bakım komutları
  8. 8. HQCenter’ınıza bağlanın
  9. 9. Katılımsız kurulum ve betikler
  10. 10. Sorun giderme

1. Yükleyicinin kurduğu şeyler

Bir .run dosyası = bir Firebird hattı. Veritabanlarınızın kullandığı Firebird sürümünün yükleyicisini seçin:

Yükleyici Kurduğu veya güncellediği Firebird Ana makinedeki ilk Firebird Boyut
hqbird2027-fb50-linux-<version>.run Firebird 5.0 (HQbird derlemesi) /opt/firebird, port 3050 yaklaşık 250 MB
hqbird2027-fb40-linux-<version>.run Firebird 4.0 (HQbird derlemesi) /opt/firebird, port 3050 yaklaşık 220 MB
hqbird2027-fb30-linux-<version>.run Firebird 3.0 (HQbird derlemesi) /opt/firebird, port 3050 yaklaşık 130 MB
hqbird2027-fb25-linux-<version>.run Firebird 2.5 (HQbird derlemesi) /opt/firebird, port 3050 yaklaşık 80 MB

Her yükleyici, İnternet olmadan şunları içerir ve kurar:

  • Firebird (o hattın HQbird derlemesi): yeni bir sunucu veya ana makinede zaten bulunan o hattın Firebird’ünün yerinde güncellenmesi. firebird.conf, databases.conf (2.5 için aliases.conf), güvenlik veritabanı ve SYSDBA parolası korunur.
  • Firebird hata ayıklama dosyaları (çökme analizi için semboller), Firebird klasörüne kurulur. --no-debug bunları atlar.
  • HQbird ajanı (fbagent): firebird kullanıcısı olarak çalışan, yedeklemeleri, izlemeyi, bakım işlerini ve güncellemeleri yapan hqbirdfbagent-fb50 systemd birimi. Ad, Firebird hattıyla biter (-fb25 … -fb50); hattın ikinci bir örneği -fb50-2 alır.
  • HQ Monitor: bu HQbird örneğinin web konsolu, birim hqbirdmonitor-fb50, adres http://<server>:<20000 + Firebird port>/ (3050 portundaki Firebird için: http://localhost:23050/).
  • Küme bileşenleri: küme konsolu RCM (hqbirdrcm) ve küme düğümü (hqclusternode) ajanın önbelleğine kopyalanır. Ajan (fbagent) 3.1.0 ve sonrasını içeren kitler varsayılan olarak küme oluşturmaz: RCM yok, eşleştirme penceresi yok, güvenlik duvarında küme portu yok. İki soru (veya --rcm on, --cluster-pairing on) bunları açar (bölüm 3’te “Sonraki: küme”). RCM ile, /opt/hqbirdrcm içine kurulur ve hqbirdrcm birimi olarak çalışır; özet, adresini RCM: satırında yazdırır. Düğüm, ana makineyi RCM’de bağladığınızda birimini alır (örneğin hqclusternode-master-p3050). Daha eski bir ajana sahip 2027.2.19’dan itibaren kitler, her sunucuya RCM kurar (--rcm off onu önbellekte bırakır) ve eşleştirme penceresini açar. 2027.2.19 öncesi kitler yalnızca her iki bileşeni ajanın önbelleğine kopyalar: hqbirdrcm birimi ve RCM: satırı yoktur.

2027.2.9 öncesinde kurulan örnekler ajan adlarında Firebird portunu taşır: klasör /opt/hqbird/fbagent-p3050, birimler hqbirdfbagent-p3050 ve hqbirdmonitor-p3050. Bir güncelleme bu adları değiştirmez. Yalnızca yeni örnekler -fb<NN> adlarını alır, böylece bir ana makinede her iki biçim de bulunabilir.

Gereksinimler: x86_64, çekirdek 3.2 veya daha yeni, systemd; apt, dnf/yum veya zypper içeren bir Linux (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS ve diğerleri); root. Kurulum sırasında /var/tmp içinde yaklaşık 300 MB boş alan (programların çalışabileceği bir klasör; bkz. --tmpdir). Birkaç işletim sistemi kütüphanesi (libtommath, ICU) dağıtımın deposundan alınır; İnternet olmayan bir sunucu bunları hazırlamak için tam komutları alır (bölüm 9).

Desteklenmez: dağıtımın paketlerinden (firebird3.0-server, firebird rpm) kurulmuş bir Firebird. Yükleyici herhangi bir şeyi değiştirmeden önce durur (çıkış kodu 7); önce paketleri kaldırın (veritabanlarınızın bir gbak yedeğini saklayın) veya --import-firebird ile çevrimiçi yükleyiciyi kullanın.

Bir sunucuda birkaç Firebird hattı: her hattın kendi yükleyicisi vardır. Ana makinedeki ilk Firebird /opt/firebird içine gider; ikinci bir hat /opt/fb<NN> (/opt/fb50, /opt/fb40, /opt/fb30) içine, kendi hattının portunda gider: 3.0 için 3053, 4.0 için 3054, 5.0 için 3055. Bu port kullanımdayken yükleyici durur ve --port N ister. Bir hattın birkaç örneği (başka bir portta ikinci bir Firebird 5.0) --fb-root <new folder> --port <port> ile kurulur (bölüm 7). Firebird 2.5’in yalnızca bir örneği vardır, /opt/firebird içinde; yanında ikinci bir sunucu için başka bir hat kullanın (örneğin /opt/fb50 içinde Firebird 5.0).

3050 ve 3051 portlarında iki örnek için, her hat için, kopyala-yapıştır komutlarıyla adım adım bir çalıştırma kılavuzu hqbird2027-linux-two-instances-runbook.ru.md (Rusça) ve hqbird2027-linux-two-instances-runbook.pt.md (Portekizce) içinde bulunur.

Deneme: lisans olmadan ajan 7 günlük bir deneme çalıştırır. Deneme e-postası (--email) bunu 30 güne uzatır. Bir lisans dosyası (--license) veya HQCenter’ınıza bağlantı (bölüm 8) denemenin yerini alır.

Güncellemeler: 2027.2.31 kitinden (ajan 3.3.0) itibaren hiçbir HQCenter’a bağlı olmayan bir sunucu, satıcının güncelleme sunucusunu denetler. Varsayılan olarak ajan, HQ Monitor ve fbmcp kendilerini günceller ve yeni bir Firebird paketi indirilip sizi bekler. --auto-update all|agent|off veya metin arayüzünün Updates satırı bunu değiştirir (bölüm 4’te “HQCenter olmadan güncellemeler”). Bir HQCenter’a bağlı bir sunucu güncellemelerini o HQCenter’dan alır.

2. Bir bakışta kurulum

Diagram

Sunucu denetimi ve kurulumun kendisi, yükleyicinin taşıdığı HQbird ajanı tarafından yapılır (fbagent --install-plan, fbagent --setup-install). Eksik işletim sistemi paketleri dışında hiçbir şey indirilmez. Plan onaylanmadan önce hiçbir şey değiştirilmez: işletim sistemi paketleri onaydan sonra kurulur. Bir terminalde, 2027.2.30 sonrası kitler metin arayüzünü açar (bölüm 3’ün 3. adımı); --no-tui sorularını metin satırları olarak soran düz yükleyiciyi çalıştırır. Terminal olmadan ve --yes olmadan yükleyici onayda çıkış kodu 4 ile durur. Kurulum ajan birimi başlamadan önce başarısız olursa, ajan birimleri önceki durumlarına geri alır (çıkış kodu 2; geri alma tamamlanmadığında kod 3, özet neyi denetlemeniz gerektiğini söyler).

3. Yeni kurulum

Adım 1: Yükleyiciyi indirin ve denetleyin

Command
KIT=hqbird2027-fb50-linux-2027.2.9.run
curl -fL -O https://ib-aid.com/download/hqbird/v2027/$KIT -O https://ib-aid.com/download/hqbird/v2027/$KIT.sha256
sha256sum -c $KIT.sha256

Diğer hatlar aynı adlara fb40, fb30, fb25 ile sahiptir. Beklenen: hqbird2027-fb50-linux-2027.2.9.run: OK. İnternet olmayan bir sunucu: iki dosyayı aynı bağlantılarla bir bilgisayarda indirin ve sunucuya kopyalayın (scp, bir USB sürücü, bir paylaşım).

Yükleyici ayrıca herhangi bir şeyi açmadan önce kendi yükünü denetler: kesilmiş veya hasarlı bir indirme çıkış kodu 5 ile durur (“tekrar indirin”).

Adım 2: Ana makineyi değiştirmeden denetleyin (isteğe bağlı)

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --check

--check ana makine denetimini çalıştırır, eksik işletim sistemi kütüphanelerini (ve İnternet olmayan bir sunucuda bunları edinme komutlarını) bildirir, ajanın ne bulduğunu ve ne yapacağını gösterir ve çıkar. Hiçbir şey kurulmaz.

Adım 3: Yükleyiciyi çalıştırın

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

2027.2.30 sonrası kitler, bir terminalde başlattığınızda metin arayüzünü açar: plan ve ayarlarla tam ekran sayfalar. 2027.2.30’a kadar olan kitler ve aşağıdaki “Düz yükleyici” bölümündeki durumlar, sorularını metin satırları olarak sorar. Her ikisi de aynı seçeneklerle aynı kurulumu yapar.

Metin arayüzü

Yükleyici ana makineyi denetler, kendini açar, planı okur ve ilk sayfayı gösterir. Install sayfasında kurulumu başlatana kadar ana makinede hiçbir şey değiştirilmez.

text
 HQbird 2027 setup <version> | Firebird 5.0 (5.0.5.1917)

 Plan M1: New Firebird and HQbird agent
   Firebird: new /opt/firebird (unit firebird, port 3050)
   Agent: new, in /opt/hqbird/fbagent-fb50
   OS packages to install: libtommath1 (see Plan details)

   Language         English (auto)
   Firebird folder  automatic (/opt/firebird)
   Firebird port    automatic (3050)
   Agent id         automatic (srv1261114-fb50)
   SYSDBA password  generated (for a new Firebird)
   HQ Monitor       port automatic, login admin
   License          not now (add it later in HQ Monitor)
   HQCenter         not attached
   Cluster          RCM off, discovery mode off
   Components       debug files: yes, fbmcp: yes
   Updates          HQbird only (recommended)

 > Install
   Plan details
   About plans
   Quit

 Up/Down: move   Enter: change or start   Esc: quit

Üst satırlar şu anki ayarlar için plandır: kodu ve yükleyicinin Firebird ve ajanla ne yapacağı. Mümkün olmayan bir plan kırmızıdır, nedeniyle birlikte ve imleç onu düzelten ayarın üzerinde durur. Her değişiklikten sonra yükleyici planı yeniden okur.

Tuş Ne yapar
Yukarı, Aşağı İmleci taşır (ayrıca k, j)
Enter İmlecin altındaki ayarı açar, bir öğe seçer, yazılan bir değeri kabul eder
Boşluk Bir bileşeni açar veya kapatır (Components sayfası)
Esc Önceki sayfaya döner; ilk sayfada: yükleyiciden çıkar (önce sorar)
Ctrl+C Yükleyiciyi hemen durdurur (çıkış kodu 2). Install sayfasından önce hiçbir şey değiştirilmemişti

Bir değer yazdığınız sayfada (bir klasör, bir port, bir adres), Enter onu kabul eder ve boş bir değer “otomatik” anlamına gelir. Esc böyle bir sayfadan çıkmaz.

Ayar Ne seçersiniz Seçenekle aynısı
Dil İngilizce, Rusça, Brezilya Portekizcesi, Almanca; sayfalar hemen değişir --lang
Firebird klasörü Yeni bir Firebird’ün veya güncellenecek Firebird’ün klasörü. Firebird 2.5’in tek klasörü vardır, bu yüzden yükleyicisinde böyle bir satır yoktur --fb-root
Firebird portu Firebird’ün TCP portu --port
Ajan kimliği Otomatik, ana makine adı, ana makine adı ve örnek veya kendi değeriniz. Yalnızca yeni bir ajan için: kurulu bir ajan kimliğini korur ve satır gösterilmez --agent-id
SYSDBA parolası Yeni bir Firebird için: oluşturulur veya kendinizinki --sysdba-pass-file
HQ Monitor Web konsolunun portu ve oturum açması --hqmonitor-port, --hqmonitor-login, --hqmonitor-password-file
Lisans Şimdi değil, e-posta ile 30 günlük deneme (adres, gizlilik bildirimi, bölge) veya bir lisans dosyası --email --accept-privacy --trial-zone, --license
HQCenter HQCenter’ınızın attach.json dosyası --attach
Küme Küme yöneticisi RCM (küme kimliği, yönetici parolası), keşif modu, eşleştirme portu --rcm, --cluster-id, --rcm-password-file, --cluster-pairing, --pairing-port
Bileşenler Firebird hata ayıklama dosyaları; fbmcp ve uzak modunun adresleri --no-debug, --no-fbmcp, --fbmcp-allow-from

| Güncellemeler | Yalnızca HQbird (agent, HQ Monitor ve fbmcp kendilerini günceller, yeni bir Firebird sizi bekler), HQbird ve Firebird (Firebird de kendini günceller, gece 03:30 ile 04:00 arasında, Firebird yeniden başlatılarak) veya Kapalı. Kitler 2027.2.31’den itibaren; yalnızca attach.json dosyası olmayan yeni bir agent için: bir HQCenter, bağlı bir agent’ın güncellemelerini yönetir | --auto-update |

Komut satırındaki seçenekler, sayfaların başlangıç değerleridir: sudo sh hqbird2027-fb50-linux-<ver>.run --rcm on --port 3055, ilk sayfayı RCM açık ve 3055 portuyla açar.

Ayarların altındaki dört satır:

  • Install, planı tam olarak gösterir, ardından imleç No üzerindeyken Start the install now? diye sorar. Planın soruları (eski bir HQbird, durdurulacak çalışan bir Firebird) aynı sayfadadır: Yes hepsine yanıt verir. Yes’ten sonra sayfalar kapanır ve kurulum günlüğünü ve özeti normal ekranda yazdırır, aşağıdaki düz kurulumda olduğu gibi.
  • Plan details, planın kodunun ne anlama geldiğini, kurulumun ana makinede ne bulduğunu, uyarıları ve kuracağı işletim sistemi paketlerini gösterir.
  • About plans, tüm kodları (M1 … M17) listeler. Bir kod üzerinde Enter onu açıklar. Bir * şu anki planın kodunu işaretler.
  • Quit, kurulumdan çıkar (çıkış kodu 1). Hiçbir şey değiştirilmedi.

Düz kurulum

Düz kurulum şunlardan biri doğru olduğunda çalışır:

  • --no-tui seçeneği veya HQBIRD_NO_TUI=1 değişkeni;
  • --yes, --check, --uninstall, --extract, --plan-help, --help;
  • stdin veya stdout bir terminal değilse: bir betik, terminal olmadan ssh host 'command' veya ... 2>&1 | tee install.log gibi bir boru hattı;
  • TERM dumb ise veya ayarlanmamışsa;
  • pencere 80 sütun x 24 satırdan küçükse (tmux içinde durum satırıyla 80x24’lük bir terminal 23 satıra sahiptir: pencereyi büyütün veya --no-tui kullanın);
  • ana makinedeki bash 4.4’ten eskiyse (RHEL 7, CentOS 7);
  • kit 2027.2.30 veya daha eskiyse.

Pencere ve bash için, çıktının ilk satırı sayfaların neden açılmadığını söyler.

Firebird olmayan bir sunucuda düz kurulumun tipik bir çalışması:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] host: Ubuntu 24.04.5 LTS, kernel 6.8.0-142-generic
[install] checking the payload (sha256) ...
[install] unpacking into /var/tmp/hqbird2027.k3Qf1x ...
[install] OS libraries missing: libtommath.so.1 (packages: libtommath1)
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              OS packages to install: libtommath1
[install] Install as planned? Yes/No y
[install] installing from the package repository: libtommath1
[install] OS libraries: installed
[install] installing (fbagent --setup-install; log /var/log/fbagent/install.log) ...
...
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1916 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
[install] done. Uninstall: sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall

Bu örnek 2027.2.9 kitindendir. 2027.2.19 kitinden itibaren özet ayrıca küme konsolunun RCM: ve Pairing: satırlarını içerir (aşağıda “Next: cluster”). Agent 3.1.0 ve sonrasıyla ve hiçbir küme seçilmeden bunlar şöyledir:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    off; turn it on in HQbird Monitor or with fbagent --cluster-pairing on (port 7450)

Satırların anlamları:

  • host: dağıtım ve çekirdek; kurulum x86_64 olmayan, systemd’si olmayan veya 3.2’den eski bir çekirdek çalıştıran bir ana makineyi reddeder.
  • OS libraries: bu hattın Firebird’ünün işletim sisteminden ihtiyaç duyduğu şeyler (bölüm 9). Plan eksik paketleri (OS packages to install) listeler; onaydan sonra kurulum bunları dağıtımın deposundan alır. Depo yoksa çıkış kodu 6 ile durur ve komutları yazdırır.
  • plan: agent’ın ne bulduğu (found Firebird ..., HQbird: ... satırları) ve ne yapacağı: Firebird new (yeni bir sunucu), update (bu hattın Firebird’ü yerinde güncellenir) veya nedeniyle bir ret (çıkış kodu 1, hiçbir şey değişmedi).
  • Install as planned? Yes/No: herhangi bir şey değiştirilmeden önceki son soru. y yanıtlayın. Planın kendi soruları olduğunda (eski bir HQbird, başka bir sürüm), bunlar onun yerine gelir (bölüm 5). Terminal yoksa --yes geçin; aksi halde kurulum çıkış kodu 4 ile durur.
  • Cluster soruları (agent 3.1.0 ve sonrası): Install the cluster manager (RCM) on this host and make a new cluster? [y/N] ve Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N]. Varsayılan No’dur. Birincisi yalnızca ana makinede RCM yoksa ve agent hiçbir kümede değilse sorulur; ikincisi agent bir kümedeyse veya RCM çalıştırıyorsa sorulmaz. --yes ve terminal olmadan bir çalıştırma No yanıtlar (çıkış kodu 4 yok).
  • HQ Monitor: adres ve giriş. Yeni bir kurulum admin girişini alır; oluşturulan parolası /opt/hqbird/conf/access.properties içindedir (mod 0600, yalnızca root ve agent tarafından okunabilir). Ana makinenin tüm HQbird 2027 örnekleri bu dosyayı paylaşır. Parolayı HQ Monitor’de değiştirin.

Yeni bir Firebird’ün SYSDBA parolası oluşturulur ve /root/fbagent-install-sysdba.txt içine kaydedilir (mod 0600): bir yorum satırı, ardından SYSDBA_PASS=<password> satırı. Aynı ana makineye daha sonra kurulan bir başka Firebird aynı parolayı bu dosyadan alır. Kendi parolanızı ayarlamak için --sysdba-pass-file <file> (dosyanın ilk satırı) veya --sysdba-pass <password> geçin.

Kurulumun dili

2027.2.30 sonrası kitler dört dil konuşur: İngilizce, Rusça (ru), Brezilya Portekizcesi (pt-BR) ve Almanca (de). Kurulum dili şu sırayla seçer:

  1. --lang en|ru|pt-BR|de seçeneği;
  2. HQBIRD_LANG değişkeni;
  3. konsolun yerel ayarı (LC_ALL, ardından LC_MESSAGES, ardından LANG), bir UTF-8 yerel ayarı olduğunda;
  4. İngilizce.

Çıktının ikinci satırı hangi dilin olduğunu ve nasıl değiştirileceğini söyler. Bu satır her zaman İngilizcedir:

text
[install] Language: Русский (auto). Use --lang en to change.

Notlar:

  • PuTTY LANG değişkenini sunucuya göndermez. Sunucunun kendi yerel ayarı geçerlidir, bu yüzden dil genellikle İngilizcedir. --lang kullanın.
  • --yes ile ve terminal olmadan otomatik dil İngilizcedir: betikler o çıktıyı okur. --lang orada da çalışır.
  • Kurulumun diğer diller için ana makinede bir UTF-8 yerel ayarına ihtiyacı vardır (C.UTF-8 veya en_US.UTF-8). Kendisi için bir tane ayarlar. Yoksa İngilizce konuşur.
  • Metin arayüzünde ilk sayfanın Language satırı dili hemen değiştirir. Terminal UTF-8 göstermelidir (PuTTY: Window, Translation, Remote character set UTF-8, ki bu varsayılanıdır).
  • İngilizce olarak kalır: kurulumun kendi ilerleme satırları, Done: özeti, /var/log/fbagent/install.log ve ana makine taramasının uyarıları.

Planın kodu

Planın bir kodu vardır: M1, M2, … Kurulumun ana makinede bulduğu durumu adlandırır. Kurulum kodun ne anlama geldiğini yazdırır:

text
[install] plan M1: New Firebird and HQbird agent
[install]              This host has no Firebird and no older HQbird. Setup installs a new Firebird and a new HQbird agent.
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)

--plan-help tüm kodları yazdırır ve çıkar. Hiçbir şeyi değiştirmez. Metin arayüzünde ilk sayfa kodu ve başlığını gösterir, “Plan details” metni gösterir ve “About plans” tüm kodları listeler.

Kod Kurulumun bulduğu Firebird Agent Eski HQbird
M1 hiçbir şey yeni yeni —
M2 bu hattın Firebird’ü, eski HQbird yok güncelle yeni —
M3 başka bir hattın Firebird’ü, eski HQbird yok yeni, port 305N yeni —
M4 bu hattın Firebird’üne hizmet eden eski HQbird güncelle yeni kapatıldı, işleri etkin olarak içe aktarıldı
M5 başka bir hattın eski HQbird’ü; bu hattın bir Firebird’ü var güncelle, bir sorudan sonra yeni çalışmaya devam eder
M6 başka bir hattın eski HQbird’ü; bu hattın Firebird’ü yok yeni, bir sorudan sonra yeni çalışmaya devam eder
M7 bilinen bir sürümün yerel Firebird’ü olmayan eski HQbird güncelle veya yeni yeni çalışmaya devam eder, bir uyarı
M8 başka bir Firebird için bir HQbird 2027 agent’ı güncelle veya yeni yeni, birincinin yanında değiştirilmedi
M9 M8 gibi, ve eski bir HQbird bu hatta hizmet ediyor güncelle yeni, birincinin yanında kapatıldı, işleri etkin olarak içe aktarıldı
M10 bir agent zaten bu Firebird’e hizmet ediyor (tekrarlanan bir çalıştırma) güncelle yerinde çalışıyorsa kapatıldı
M11 --fb-root bu hattın bir Firebird’üdür güncelle yeni veya yerinde yukarıdaki gibi
M13 --fb-root boş veya yeni bir klasördür o klasörde yeni yeni yukarıdaki gibi

Bir ret kodu (çıkış kodu 1, hiçbir şey değişmedi): M12 klasörde kurulumun güncelleyemediği bir Firebird var (başka bir hat, okuyamadığı bir sürüm, devre dışı bir hizmet); M14 klasör boş değil ve bir Firebird yok; M16 bu hattın birkaç Firebird sunucusu, --fb-root verin; M17 Firebird 2.5 yalnızca /opt/firebird içinde çalışır. M15 yalnızca agent kitidir: Firebird kurulmaz ve güncellenmez.

Agent kimliği

Agent kimliği, agent’ı HQCenter’da, lisansta ve kümede adlandırır. Yalnızca ilk kurulumda ayarlanır:

  • Varsayılan: ana makine adı + tarih + örnek, örneğin srv1261114-fb50.
  • --agent-id ID kendi kimliğinizi verir (1-128 harf, rakam, ., _ veya -; ilki bir harf veya rakam).
  • Kurulum, ana makinenin başka bir agent’ının sahip olduğu bir kimliği reddeder.
  • Metin arayüzünde Agent id sayfası otomatik kimliği, ana makine adını, örnek ile ana makine adını ve kendi değerinizi sunar ve ana makinenin zaten sahip olduğu kimlikleri listeler.
  • Kurulu bir agent kimliğini korur. Tekrarlanan bir çalıştırma bunu planda gösterir (id srv1 (kept)), metin arayüzünde o zaman Agent id satırı yoktur ve oradaki --agent-id yalnızca bir uyarı verir. Daha önceki bir kurulumun yapılandırmasıyla bıraktığı bir klasördeki yeni bir agent da o yapılandırmanın kimliğini korur.

Adım 4: Sonucu kontrol edin

Command
systemctl status firebird hqbirdfbagent-fb50 hqbirdmonitor-fb50 --no-pager
ss -ltnp | grep -E ':3050|:23050'
ISC_PASSWORD="$(sed -n 's/^SYSDBA_PASS=//p' /root/fbagent-install-sysdba.txt)" \
  /opt/firebird/bin/isql -user SYSDBA localhost/3050:/opt/firebird/examples/empbuild/employee.fdb

Örnek veritabanının tam yolunu kullanın: her hat için ve bir güncellemeden sonra da çalışır, oysa eski bir kurulumun korunan databases.conf dosyasında employee takma adı olmayabilir (2027.2.3’ün yeni bir kurulumunda vardır).

Bir tarayıcıda http://<server>:23050/ adresini açın ve /opt/hqbird/conf/access.properties içindeki parolayla admin olarak giriş yapın. Firebird portu ve HQ Monitor portu, çalıştığında firewalld içinde (public bölgesi), aksi halde etkinse ufw içinde açılır; başka bir güvenlik duvarıyla bunları kendiniz açın. Küme portları yalnızca bir küme seçeneği için açılır: 7443, 7444 ve --rcm on ile düğüm portu; düğüm portu ve eşleştirme portu --cluster-pairing on ile. Etkin bir güvenlik duvarı yoksa kurulum açmadığı portlarla bir satır yazdırır. Kurulumdan önce açık olan bir port olduğu gibi bırakılır.

Sonraki: küme

Veritabanlarınızı bir ana sunucudan bir replika sunucusuna çoğaltmak için iki sunucuyu küme konsolu RCM’de bağlayın. Agent 3.1.0 ve sonrasıyla, RCM’yi yalnızca ana sunucuya kurun (--rcm on veya y yanıtlayın) ve replikada keşif modunu açın (--cluster-pairing on). Keşif modu eşleştirme penceresini 24 saat boyunca açar: agent’ın yuvasının eşleştirme portu (ilk örnek için 7450, ikinci için 7451, 7459’a kadar) güvenlik duvarında açıktır ve RCM agent’ı davet edebilir. Bir ana makinede bir RCM vardır (7443 ve 7444 portları); onu oluşturan agent onu çalıştırır ve hiçbir eşleştirme penceresi açmaz.

Daha sonra, kurulum programı olmadan: HQ Monitor → Clusters → Cluster on this server veya fbagent --cluster-init <id> ve fbagent --cluster-pairing on. 2027.2.19 ve sonrası kitlerde daha eski bir ajan varsa her sunucuda RCM başlatılır ve özetin RCM: satırında adresi yazdırılır; 2027.2.19 öncesi bir kurulum, daha yeni bir kitle güncellendiğinde RCM alır (bölüm 6). Küme kılavuzu (kit 2027.2.33 için) iki yeni sunucudan çalışan bir replikaya kadar adım adım ekran görüntüleriyle anlatır: Linux küme kılavuzu (ayrıca Rusça ve Portekizce). Aynı adımlar yalnızca komutlar olarak: hqbird2027-linux-cluster-runbook.md (hqbird2027-linux-cluster-runbook.ru.md, hqbird2027-linux-cluster-runbook.pt.md).

4. Kurulumdan sonra

Birimler

Birim Ne Şu kullanıcı olarak çalışır
firebird (2.5, 4.0, 5.0, /opt/firebird içinde); firebird-superserver (3.0, /opt/firebird içinde); başka bir klasör için klasör adı / → _ olacak şekilde: firebird.opt_fb50, firebird.opt_fb40-2 (4.0, 5.0, /opt/fb50, /opt/fb40-2 içinde), firebird.opt_fb30-superserver (3.0, /opt/fb30 içinde) Firebird sunucusu firebird
hqbirdfbagent-fb50 (ikinci örnek hqbirdfbagent-fb50-2; 2027.2.9 öncesi hqbirdfbagent-p<Firebird port>) HQbird ajanı firebird
hqbirdmonitor-fb50 (hqbirdmonitor-fb50-2; 2027.2.9 öncesi hqbirdmonitor-p<Firebird port>) HQ Monitor firebird

Üçü de etkindir ve açılışta başlar. journalctl -u hqbirdfbagent-fb50 ajanın birim günlüğünü gösterir. Firebird 3.0 ayrıca firebird-classic.socket ve [email protected] birimlerine sahiptir (başka bir klasörde firebird.opt_fb30-classic.*), Firebird 2.5 ise firebird.socket birimine sahiptir: bunlar inactive kalır, bu normaldir. Firebird 2.5 süreci fb_smp_server (SuperClassic) şeklindedir.

Dosyaların bulunduğu yerler

Örnek, 3050 portunda /opt/firebird içindeki ilk Firebird 5.0 örneğidir. Hattın ikinci bir örneğinde ajan adlarında -2 bulunur (fbagent-fb50-2, hqbirdfbagent-fb50-2, hqbirdmonitor-fb50-2). 2027.2.9 öncesi kurulan örneklerde bu adlarda port bulunur (fbagent-p3050, hqbirdfbagent-p3050, hqbirdmonitor-p3050).

text
/opt/firebird/                         Firebird 5.0 server: bin/, lib/, plugins/, firebird.conf,
                                       databases.conf, security5.fdb, *.debug files (symbols)
/opt/fb50/                             a Firebird 5.0 next to another line (/opt/fb40, /opt/fb30)
/opt/hqbird/                           root of the HQbird agents
  conf/access.properties               HQ Monitor sign-in, shared by all instances of the host (0600)
  fbagent-fb50/                        HQbird agent of this Firebird
    fbagent                            the agent (unit hqbirdfbagent-fb50)
    hqmonitor                          HQ Monitor (unit hqbirdmonitor-fb50)
    agent_config.json                  agent configuration (encrypted secrets: config_secret.key)
    config.properties                  HQ Monitor configuration
    hqbird2027-firebird.json           the Firebird this installer installed
    hqbird2027-hqmonitor-firewall.json the HQ Monitor port this installer opened in firewalld or ufw
    conf/                              trace and job settings
    logs/                              agent log (firebird-agent_<date>.jsonl), license_state.json;
                                       journal.log and server_status.json after the first checks
    bak/                               backups of the configuration
    outcoming/                         status reports for HQCenter
    update/                            update cache: hqmonitor/, hqclusternode/, hqbirdrcm/
    certs/                             certificates after the attach to HQCenter
  fbagent-hqbird-takeover.json         state of the older HQbird units before the takeover (section 5)
/opt/hqbirdrcm/                        the cluster console RCM (unit hqbirdrcm, owner firebird):
                                       with agent 3.1.0 only after --rcm on (or HQ Monitor);
                                       kits 2027.2.19+ with an older agent: unless --rcm off
/opt/hqclusternode/                    the cluster node (owner firebird), empty until the host is
                                       linked in RCM or HQCenter adds it to a cluster
/var/lib/hqmonitor/<server id>/        HQ Monitor data
/var/log/fbagent/install.log           log of the installer's steps (passwords are hidden)
/root/fbagent-install-sysdba.txt       SYSDBA password of a new Firebird (root only, 0600)
/etc/sysctl.d/90-hqbird-firebird.conf  kernel settings for Firebird (vm.max_map_count), only when
                                       the system value is lower (Ubuntu 24.04 needs none)
/etc/sudoers.d/                        the agent's sudoers rules for its root helpers (updates, HQ Monitor)

Kurulum programı /var/tmp içinde hiçbir şey bırakmaz: çalışma klasörü /var/tmp/hqbird2027.XXXXXX sonunda, bir hata sonrasında da kaldırılır.

Günlükler

Günlük Yeri
Kurulum programı terminal; /var/log/fbagent/install.log
Ajan /opt/hqbird/fbagent-fb50/logs/firebird-agent_<tarih>.jsonl, journal.log; journalctl -u hqbirdfbagent-fb50
HQ Monitor journalctl -u hqbirdmonitor-fb50; denetim günlüğü /opt/hqbird/fbagent-fb50/hqmonitor_audit.log
Firebird /opt/firebird/firebird.log

HQCenter olmadan güncellemeler

2027.2.31 kitinden (ajan 3.3.0) itibaren hiçbir HQCenter’a bağlı olmayan bir ajan yeni sürümleri satıcının güncelleme sunucusundan alır. Güncelleme modu agent_config.json dosyasının update.mode anahtarıdır:

Mod Kendiliğinden neyi günceller
agent (varsayılan) Ajanı, HQ Monitor’ü ve fbmcp’yi. Yeni bir Firebird paketi indirilir ve yöneticiyi bekler
all Aynısı, ve Firebird’ü de, uygulama penceresinde (gece 03:30 ile 04:00 arası; güncelleme Firebird’ü yeniden başlatır)
off Hiçbir şey: ajan hiçbir güncelleme kontrolü yapmaz. Güncellemek için yeni sürümün kurulum programını çalıştırın (bölüm 6)
  • Kurulumda: metin arayüzünün Updates satırı veya --auto-update all|agent|off. Bunlar olmadan kurulum programı modu değiştirmez.
  • Daha sonra: HQ Monitor’ün Updates sayfası veya kurulum programı yine --auto-update <mod> ile.
  • Durum: sudo /opt/hqbird/fbagent-fb50/fbagent --update-status (bir betik için --json ekleyin). Sürüm kaynağını, bölgeyi ve güncelleme sunucusunun son yanıtını yazdırır.

Ajan yalnızca bu adreslere giden HTTPS bağlantıları açar. Gelen port gerekmez.

Amaç Adres
Güncellemeler, AB bölgesi liceu.ibsurgeon.com:9443
Güncellemeler, BR bölgesi licbr.ibsurgeon.com:9443
Güncellemeler, RU bölgesi licru.ibsurgeon.com:20943
Deneme lisansı trialeu.ibsurgeon.com:9443, trialbr.ibsurgeon.com:19443, trialru.ibsurgeon.com:23943

Bir HQCenter’a bağlı bir sunucu güncelleme adreslerini kullanmaz: güncellemelerini o HQCenter’dan alır (bölüm 8).

Bildirimler

2027.2.33 kitinden (ajan 3.4.0) itibaren ajan sunucu sorunlarıyla ilgili mesajları kendi Telegram botunuza, bir webhook’a veya e-postaya (SMTP) gönderir. Kurulum programı hiçbir kanal ayarlamaz ve siz bir tane ekleyene kadar hiçbir şey gönderilmez: HQ Monitor → Servers → Notifications. Bir kanalı komut satırından test etmek için: sudo -u firebird /opt/hqbird/fbagent-fb50/fbagent --notify-test <kanal>; --notify-history son teslimatları yazdırır.

5. Eski bir HQbird’in (2024 ve öncesi) güncellenmesi

Kurulum programı /opt/hqbird içinde kurulu bir HQbird (FBDataGuard) ve birimlerini ve yönettiği Firebird sunucularını bulur. Ardından HQbird kurulum betikleriyle aynı kuralları izler:

Diagram

Terminalde gördüğünüz:

text
[install]   found Firebird 5.0.5.1878: /opt/firebird, port 3050, unit firebird, no agent
[install] plan M4: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              HQbird services to turn off: hqbird
[install] Firebird 5.0.5.1878: unit firebird, port 3050, 0 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1878? Yes/No y
  • Plan, güncellenen Firebird’ü adlandırır; --fb-root ve --port onu taşıyamaz (birimi alınmıştır).
  • Confirm to stop running Firebird? sorusu, motorun durdurulması gerektiğinde sorulur; önündeki satır açık bağlantıları gösterir. Eski HQbird başka bir sürümün Firebird’ünü yönetiyorsa Another version sorulur (onu güncelleyin veya yanına yeni bir tane kurun). --yes tüm soruları Evet ile yanıtlar; terminal olmadan ve --yes olmadan kurulum programı çıkış kodu 4 ile durur ve hiçbir şeyi değiştirmez.
  • --disable-hqbird eski HQbird birimlerini her durumda kapatır; --no-hqbird eski HQbird’e dokunmaz (HQbird 2027’nin yanında çalışmaya devam eder).
  • SYSDBA parolası sorulmaz: ajan onu eski HQbird’den alır.
  • HQ Monitor eski HQbird’in oturum açma bilgisini kullanır: onun /opt/hqbird/conf/access.properties dosyası korunur, bu nedenle daha önce kullandığınız oturum açma adı ve parolasıyla oturum açın. Kurulum programı dosyayı firebird kullanıcısına 0600 moduyla verir (eski HQbird onu her kullanıcı tarafından okunabilir bırakmıştı). Eski HQbird’in konuk oturum açması (access.guest-login) HQ Monitor tarafından kullanılmaz.

Korunanlar: firebird.conf, databases.conf / aliases.conf, güvenlik veritabanı, SYSDBA parolası, veritabanları, yedekler ve eski HQbird’in dosyaları. Güncelleme, Firebird program dosyalarını yerinde değiştirir; değiştirdiği dosyalar /opt/fbagent-update-backup/<klasör adı>-<id>/<zaman>_<eski sürüm>_to_<yeni sürüm>/ içinde tutulur (en yeni iki güncelleme kalır). HQbird işleri (yedeklemeler, sweep’ler, izleme) yeni ajana içe aktarılır. Eski HQbird’in HQbird lisansı aktarılmaz: yeni ajan, bir lisans kurulana veya sunucu HQCenter’ınıza bağlanana kadar deneme sürümünü çalıştırır.

2027.2.33 kitinden (ajan 3.4.0) itibaren eski HQbird’in yapılandırmasının içe aktarılması iki şey daha yapar:

  • Eski HQbird’in veritabanlarını Firebird takma adlar dosyasına (databases.conf veya 2.5 için aliases.conf) ad = yol satırları olarak kaydeder. Önce eski dosya kopyalanır. Bir veritabanı, yolu zaten dosyada varsa veya dosyası mevcut değilse atlanır. include yönergesi içeren bir dosya değiştirilmez.
  • Eski HQbird’in eski izleme günlüklerini kaldırır: çıktı klasörünün mon/outcoming ve mon/outtrace klasörlerinin içeriği (klasörler kalır). Eski HQbird’in bir hizmeti çalışırken hiçbir şey kaldırılmaz. Kaldırma geri alınamaz: bu günlüklere ihtiyacınız varsa kurulumdan önce kopyalayın.

Her ikisi de varsayılan olarak açıktır. agent_config.json dosyasının hqbird_import.register_databases ve hqbird_import.clean_mon_logs anahtarları (her ikisi de HQ Monitor’ün yapılandırma düzenleyicisindedir) bunları daha sonraki bir içe aktarma için kapatır; kurulum programının onlar için bir seçeneği yoktur.

Eski HQbird birimlerinin devralma öncesi durumu /opt/hqbird/fbagent-hqbird-takeover.json içinde kaydedilir. --uninstall onları yeniden açmaz.

Gözetimsiz biçim:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

6. HQbird 2027’nin yeni bir sürüme güncellenmesi

Aynı hattın daha yeni bir kurulum programı, HQbird 2027 kurulu bir ana bilgisayarda çalıştırıldığında kurulu örneği yerinde günceller: Firebird, hata ayıklama dosyaları, ajan ve HQ Monitor. Yapılandırma, veritabanları, deneme veya lisans durumu, HQ Monitor portu ve oturum açma bilgisi korunur.

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run

Metin arayüzünde ilk sayfa Plan M10: Update of an installed HQbird 2027 gösterir, ajanı kimliğiyle birlikte (kept) olarak gösterir ve Agent id satırı göstermez; Install güncellemeyi başlatır. Düz kurulum programı şunu yazdırır:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install]   found Firebird 5.0.5.1880: /opt/firebird, port 3050, unit firebird, agent hqbirdfbagent-p3050
[install] plan M10: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent in_place in /opt/hqbird/fbagent-p3050 (unit hqbirdfbagent-p3050), HQ Monitor hqbirdmonitor-p3050
[install] Firebird 5.0.5.1880: unit firebird, port 3050, 2 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1880? Yes/No y
...
Firebird updated: 5.0.5.1880 -> 5.0.5.1916
HQ Monitor updated 1.31.0 -> 1.33.0 (...)
Done: agent hqbirdfbagent-p3050 in /opt/hqbird/fbagent-p3050, Firebird 5.0.5.1916 in /opt/firebird (port 3050).

Bir güncelleme agent klasörünün ve birimlerinin adlarını değiştirmez: bu örnekteki örnek 2027.2.9’dan önce kurulmuştur ve fbagent-p3050 adını korur.

Kurulum programının Firebird derlemesi zaten kurulu olanla aynı olduğunda (örneğin 2.5 için her HQbird 2027’de Firebird 2.5.9.27194), yalnızca agent ve HQ Monitor güncellenir: Firebird durdurulmaz ve Confirm to stop sorusu sorulmaz.

Daha eski bir HQbird 2027 tarafından kurulmuş bir örneğin korunan databases.conf dosyasında employee takma adı olmayabilir; örnek veritabanına tam yoluyla bağlanın (bölüm 3, adım 4). Firebird 3.0’da 2027.2.0’dan yapılan bir güncelleme /opt/firebird/examples/empbuild/employee.fdb dosyasını 0444 moduyla bırakır ve Firebird onu açamaz (no permission for read-write access); örnek veritabanına ihtiyacınız varsa: sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb. Kendi veritabanlarınıza dokunulmaz.

  • Hatta birden fazla örnek varsa, güncellenecek olanı belirtin: --fb-root /opt/fb50-2 --port 3056.
  • Aynı kurulum programının kurulu sürümün üzerine yeniden çalıştırılması bir onarımdır: program dosyaları ve birimler yeniden yazılır, veriler kalır.
  • Bir HQCenter’a bağlantıdan sonra (bölüm 8) agent, HQ Monitor, Firebird ve küme bileşenleri HQCenter kataloğundan güncellenir; artık yeni bir kurulum programına gerek yoktur.
  • Hiçbir HQCenter’a bağlı olmayan ve agent 3.3.0 veya daha yeni olan bir sunucu (2027.2.31’den itibaren kitler) güncelleme modu off olmadıkça agent, HQ Monitor ve fbmcp’yi kendiliğinden günceller (“Updates without HQCenter”, bölüm 4). 2027.2.31’den önce yapılmış bir kurulum bunu daha yeni bir kurulum programıyla bir güncellemeden sonra alır. Kurulum programıyla yapılan bir güncelleme güncelleme modunu korur; --auto-update <mode> bunu değiştirir.

7. Bakım komutları

Her bakım işlemi, seçeneklerle kurulum programının çalıştırılması veya agent klasöründeki bir agent komutudur. Bir terminalde --yes olmadan çalıştırma, bu seçenekler zaten ayarlanmış olarak metin arayüzünü açar (2027.2.30’dan sonraki kitler): ilk sayfadaki planı kontrol edin, ardından Install’ı seçin.

İşlem Komut
Bu hattın başka bir örneği sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50-2 --port 3056
Onarım / güncelleme sudo sh hqbird2027-fb50-linux-<ver>.run (birden fazla örnekle: --fb-root <folder> --port <port>)
HQCenter’a bağlan Kurulum sırasında sudo sh hqbird2027-fb50-linux-<ver>.run --attach attach.json, veya daha sonra cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /path/attach.json
Deneme e-postasını gönder cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email [email protected] --accept-privacy
E-postadaki deneme kodunu onayla cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-confirm <code> (veya HQ Monitor’de)
Bir lisans dosyası kur Kurulum sırasında --license <file>, veya cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --license-install /path/license.json
Kurulumun durumu sudo /opt/hqbird/fbagent-fb50/fbagent --install-state --json
Güncellemelerin durumu (HQCenter yok) sudo /opt/hqbird/fbagent-fb50/fbagent --update-status
Güncelleme modunu değiştir (HQCenter yok) HQ Monitor, Updates sayfası; veya sudo sh hqbird2027-fb50-linux-<ver>.run --auto-update all|agent|off
Kaldır sudo sh hqbird2027-fb50-linux-<ver>.run --uninstall [--remove-data] [--force] [--agent-dir /opt/hqbird/fbagent-fb50]

Başka bir örnek

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056

Yeni Firebird /opt/fb50-2 konumuna gider (yeni veya boş bir klasör), birim firebird.opt_fb50-2, kendi agent’ı (/opt/hqbird/fbagent-fb50-2, birim hqbirdfbagent-fb50-2) ve kendi HQ Monitor’ü (http://localhost:23056/, birim hqbirdmonitor-fb50-2) ile. Agent, hattın en düşük boş numarasını alır: ikinci örnek için fb50-2, 2027.2.9’dan önce kurulmuş bir agent’ın (fbagent-p3050) yanında da. HQ Monitor oturum açma dosyası /opt/hqbird/conf/access.properties sunucunun örnekleri tarafından paylaşılır: --hqmonitor-login olmadan yeni bir örnek mevcut oturum açmayı korur ve herhangi bir örnekte --hqmonitor-login/--hqmonitor-password-file hepsinin oturum açmasını değiştirir (eski dosya access.properties.bak-<time> olarak saklanır). Firebird 2.5 ikinci bir örneği desteklemez: kurulum programı refused (M17): Firebird 2.5 works only in /opt/firebird, not in <folder> ile durur (çıkış kodu 1, hiçbir şey değişmez). Yanına başka bir hattın Firebird’ünü kurun, örneğin sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50 --port 3051.

Kaldır

Windows ve Linux’ta kaldırma, bir kümedeki sunucular ve diskte kalanlar tam olarak kaldırma kılavuzunda açıklanmıştır. Kısaca:

Command
# the agent and HQ Monitor of this instance; Firebird, the databases, configs and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
# the same, and the agent's configuration, logs, license state and HQ Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

--agent-dir olmadan kurulum programı /opt/hqbird içindeki tek agent’ı kaldırır. Sunucuda birden fazla agent varsa durur (çıkış kodu 1), klasörlerini listeler ve --agent-dir ister:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

--uninstall, agent’ın ve HQ Monitor’ünün birimlerini (hqbirdfbagent-fb50, hqbirdmonitor-fb50), agent’ın ve programlarının sudoers kurallarını (fbagent, hqmonitor) durdurur ve kaldırır ve kurulumun firewalld veya ufw içinde açtığı HQ Monitor portunu kapatır. Agent klasörü yapılandırma ve günlüklerle birlikte kalır; --remove-data klasörü ve HQ Monitor verilerini /var/lib/hqmonitor/ içinde de kaldırır. Firebird kurulu kalır (birim, program klasörü, veritabanları); kapatılmış eski HQbird birimleri kapalı kalır. Sunucuda birden fazla agent varsa, paylaşılan HQ Monitor oturum açma dosyası son agent kaldırılana kadar kalır.

Agent sunucunun RCM’sini çalıştırıyorsa ve diğer agent’lar bu RCM’yi kullanıyorsa, --uninstall çıkış kodu 5 ile reddeder ve hiçbir şeyi değiştirmez: this agent runs the RCM of the host, and other agents use it: remove the cluster in the RCM console, or run again with --force. --force agent’ı yine de kaldırır; küme ardından CA’sını kaybeder (yeni sertifika yok, yeni üye yok). Sunucunun diğer agent’ları kullandığı sürece RCM birimi kalır. Eski sahip gittiğinde başka bir agent’ı yeni bir RCM’nin sahibi yapmak için: fbagent --cluster-init <id> --rcm-takeover (yeni bir CA: üyeleri yeniden bağlayın).

Bir kurulumun sonundaki ipucunda (Uninstall: sudo sh ... --uninstall) --agent-dir yoktur: birden fazla örnekle yukarıda gösterildiği gibi ekleyin.

Bir örneğin Firebird’ünü de kaldırmak için (kurulum programı bunu yapmaz; önce veritabanlarının gbak yedeklerini alın), örneğin /opt/fb50-2 içindeki Firebird:

Command
B=/opt/fb50-2
U=firebird.$(echo ${B#/} | tr / _)          # /opt/fb50-2 -> firebird.opt_fb50-2
systemctl list-unit-files "$U*"             # the units that will be removed
sudo systemctl disable --now $(systemctl list-unit-files "$U*" --no-legend | awk '$1 !~ /@/ {print $1}')
sudo rm -f /usr/lib/systemd/system/$U* /etc/systemd/system/$U*
sudo systemctl daemon-reload
sudo rm -rf $B

8. HQCenter’ınıza bağlanın

HQCenter, HQbird agent’larını yöneten şirketinizin merkezi sunucusudur: lisanslar, yapılandırma, güncellemeler, yedeklere genel bakış. Bir HQCenter olmadan agent, kurulum programının sürümleri ve deneme veya lisans dosyasıyla kendi başına çalışır.

Diagram
  1. HQCenter yönetim panelinde Tokens bölümünü açın (https://<hqcenter>:8443/admin/tokens). Install script formunda lisansı (veya hiçbirini), modu, sunucu sayısını ve geçerliliği (1 ila 365 gün) seçin; platform ve Firebird alanları kullanılmaz. Download connection file düğmesine tıklayın ve attach.json dosyasını kaydedin. Dosya gizli bir token içerir: güvenli tutun (chmod 600), kullandıktan sonra silin ve aynı sayfadaki listede token’ı iptal edin. Form yalnızca admin_panel.install_script_url ayarlandığında gösterilir.
  2. attach.json dosyasını sunucuya kopyalayın.
  3. İki yoldan biriyle bağlanın:
Command
# during the installation
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --attach /root/attach.json
# later, for an installed agent
cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /root/attach.json

Sıradan bir token ile komut, HQCenter yöneticisi isteği onaylayana kadar bekler (en fazla 30 dakika). Bir lisans token’ı ile agent hemen bağlanır ve lisansı alır. Bağlantıdan sonra, HQCenter agent’a bir lisans verdiğinde deneme sona erer; agent, HQ Monitor, Firebird ve küme bileşenleri ardından HQCenter kataloğundan güncellenir. Kurulum sırasında başarısız bir bağlantı kurulumu geri almaz: özet bunu söyler ve yukarıdaki komut bunu tekrarlar.

Gereksinimler: HQCenter (goafts) 1.15.0 veya daha yeni (eski sürümlerde bağlantı dosyası düğmesi yoktur); sunucu, bağlantı için bir kez HQCenter bootstrap portuna ve ardından agent’ların portuna (varsayılan olarak 443) ulaşır. HQCenter İnternet olmadan olabilir. Aynı sunucunun aynı HQCenter’a ikinci kez bağlanması, bir lisans token’ıyla bile yöneticinin onayını gerektirir.

9. Katılımsız kurulum ve betikler

Her seçenek terminalde de çalışır. Katılımsız bir çalıştırma --yes gerektirir (planın sorularını yanıtlar; terminal olmadan ve --yes olmadan kurulum programı çıkış kodu 4 ile durur). --yes asla metin arayüzünü açmaz. Kurulum programını bir terminalde başlatan ve sorularını kendisi yanıtlayan bir betik (örneğin expect ile) --no-tui eklemeli veya HQBIRD_NO_TUI=1 ayarlamalıdır: 2027.2.30’dan sonraki kitler sayfaları orada açar. Çıkış kodu sonucu bildirir; ayrıntılar terminalde ve /var/log/fbagent/install.log içindedir.

Seçenekler

Seçenek Anlamı Varsayılan
--fb-root DIR Yeni Firebird’ün klasörü (yeni veya boş); veya güncellenecek Firebird’ün klasörü /opt/firebird, ardından /opt/fb<NN>
--port N Firebird portu ilk Firebird için 3050; başka bir hat için hattın portu (3.0 için 3053, 4.0 için 3054, 5.0 için 3055)
--sysdba-pass-file F, --sysdba-pass P Yeni bir Firebird’ün SYSDBA parolası (F’nin ilk satırı; P 0600 izinli bir dosyaya yazılır) oluşturulur, /root/fbagent-install-sysdba.txt içine kaydedilir; sunucudaki bir sonraki Firebird parolayı bu dosyadan alır
--agent-id ID Yeni agent’ın agent.id değeri; yalnızca ilk kurulumda, kurulu bir agent kimliğini korur (bölüm 3’te “The agent id”) sunucu adı + tarih + örnek
--hqmonitor-port N HQ Monitor portu 20000 + Firebird portu
--hqmonitor-login L --hqmonitor-password-file F HQ Monitor oturum açma bilgisi, sunucunun tüm örnekleri tarafından paylaşılır: bir örnekte verilirse hepsinin oturum açmasını değiştirir admin + oluşturulan parola; bir güncelleme veya başka bir örnek mevcut oturum açmayı korur
--email ADDR --accept-privacy [--trial-zone RU|EU|BR] Deneme e-postası (30 gün); adres satıcının deneme sunucusuna gönderilir yok
--auto-update all|agent|off Hiçbir HQCenter’a bağlı olmayan bir sunucunun güncellemeleri (2027.2.31’den itibaren kitler): agent = agent, HQ Monitor ve fbmcp kendiliğinden güncellenir, bir Firebird paketi sizi bekler; all = Firebird de, kendi penceresinde; off = güncelleme denetimi yok (bölüm 4’te “Updates without HQCenter”) mod değiştirilmez; yeni bir agent agent moduna sahiptir

| --license F | Kurulacak lisans dosyası | yok | | --attach F | HQCenter’ınıza bağlan (attach.json) | yok | | --no-hqbird, --disable-hqbird | Eski HQbird’i olduğu gibi bırak / tüm birimlerini kapat | otomatik | | --no-debug | Firebird hata ayıklama dosyalarını kurma | kurulur | | --no-fbmcp | fbmcp’yi (AI istemcileri için MCP sunucusu) kurma ve bu ana makinenin fbmcp’sini değiştirme | kurulur | | --fbmcp-allow-from A,B | Bu yönetici adresleri için fbmcp’nin uzak modunu aç (IP veya CIDR) | yalnızca yerel | | --fbmcp-port N, --fbmcp-dns NAME,..., --fbmcp-ip ADDR | fbmcp’nin uzak bağlantı noktası; sertifikası için ek adlar; sertifika ve dinleyici için adres | 8650 numaralı bağlantı noktası | | --rcm on\|off | Bu ana makineye küme konsolu RCM’yi kur ve yeni bir küme oluştur (aracı 3.1.0 ve sonrası) | sorulur; Hayır | | --rcm-password-file F | --rcm on ile RCM yönetici parolası (F’nin ilk satırı) | oluşturulur, sonunda gösterilir | | --cluster-id ID | --rcm on ile küme kimliği | ana makine adı | | --cluster-pairing on\|off | Keşif modu: 24 saatlik eşleştirme penceresi, bir RCM bu aracıyı davet edebilir | sorulur; Hayır | | --rcm-allow A,B,... | Keşif modunda yalnızca bu RCM’ler bu ana makineyi davet edebilir (IP, CIDR veya ana makine adı) | herhangi bir RCM | | --pairing-port N | Yeni bir aracının 7450–7459 eşleştirme bağlantı noktası; dilimi kendisi seçer (düğüm bağlantı noktaları 7051+k, 7061+k). Sonraki kurulum dilimi korur | ilk boş dilim | | --cluster-node on\|off | Küme düğümü hizmetini aracının önbelleğine koy | açık | | --yes | Planın sorularına Evet yanıtı ver (küme sorularına Hayır) | sor | | --check | Yalnızca kontroller, kitaplıklar ve plan; hiçbir şey değiştirilmez | — | | --plan-help | Planın kodlarının (M1, M2, …) ne anlama geldiğini yazdır ve çık | — | | --no-tui | Metin arayüzü olmayan düz kurulum; ayrıca HQBIRD_NO_TUI=1 değişkeni (bölüm 3’teki “The plain installer”) | bir terminalde metin arayüzü | | --lang en\|ru\|pt-BR\|de | Kurulumun dili; ayrıca HQBIRD_LANG değişkeni (bölüm 3’teki “Language of the installer”) | konsolun UTF-8 yerel ayarı, yoksa İngilizce | | --tmpdir DIR | Buraya aç (programların çalışabileceği bir klasör) | /var/tmp | | --extract DIR | Yalnızca yükü DIR/payload içine aç ve çık | — | | --uninstall [--remove-data] [--force] [--agent-dir DIR] | Aracıyı ve HQ Monitor’ü kaldır (Firebird kalır); --force ayrıca diğer aracılar kullanırken ana makinenin RCM’sini çalıştıran aracıyı da kaldırır | — |

Seçenekler --port 3055 veya --port=3055 şeklinde yazılabilir. Göreli yollar geçerli klasörden sayılır.

Örnekler

Varsayılanlarla yeni kurulum:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes
echo "exit code $?"

Seçilen bir klasöre ve bağlantı noktasına, bir dosyadan SYSDBA parolası ve bir HQ Monitor oturum açma bilgisiyle yeni kurulum:

Command
umask 077
printf '%s\n' 'S3cret-Sysdba' > /root/sysdba.txt
printf '%s\n' 'S3cret-Monitor' > /root/hqm.txt
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --fb-root /opt/firebird --port 3050 \
  --sysdba-pass-file /root/sysdba.txt \
  --hqmonitor-port 24000 --hqmonitor-login ops --hqmonitor-password-file /root/hqm.txt
rm -f /root/sysdba.txt /root/hqm.txt

Deneme e-postası, bir lisans dosyası ve attach dosyasıyla yeni kurulum:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --email [email protected] --accept-privacy --trial-zone EU \
  --license /root/hqbird-license.json \
  --attach /root/attach.json

Eski bir HQbird’in güncellenmesi, tüm eski HQbird birimleri kapalı:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird

HQbird 2027’nin yeni bir sürüme güncellenmesi (tek örnek; birden fazlaysa --fb-root ve --port ekleyin):

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes

3056 numaralı bağlantı noktasında ikinci bir Firebird 5.0 örneği:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056

Kaldırma:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

Başarısız bir kurulumda duran bir betik:

Command
#!/bin/sh
set -e
sh hqbird2027-fb50-linux-2027.2.9.run --yes || {
  rc=$?
  echo "HQbird setup failed with code $rc, see /var/log/fbagent/install.log" >&2
  exit $rc
}
echo "HQbird 2027 installed"

İnternetsiz sunucu: İşletim sistemi kitaplıkları

Bir hattın Firebird’ü işletim sisteminden şu kitaplıklara ihtiyaç duyar (glibc’ye ek olarak):

Hat Paketler (Debian/Ubuntu) Paketler (RHEL ailesi)
5.0 libtommath1, libicu<NN>, libgssapi-krb5-2 libtommath (EPEL), libicu, krb5-libs
4.0 libtommath1, libicu<NN> libtommath (EPEL), libicu
3.0 libtommath1, libicu<NN> libtommath (EPEL), libicu
2.5 genellikle hiçbir şey (libstdc++6 temel sistemdedir) genellikle hiçbir şey

3.0, 4.0 ve 5.0 hatlarının 2027.2.30 sonrası kitleri ayrıca Firebird kurulum betiğinin kullandığı colrm programına ihtiyaç duyar: bsdextrautils paketi (eski Debian ve Ubuntu’da bsdmainutils). Minimal bir Debian’da bu yoktur; RHEL ailesinde her zaman mevcut olan util-linux içindedir.

Bir paket eksik olduğunda ve depoya erişilemediğinde, kurulum 6 çıkış koduyla durur ve hiçbir şey değiştirilmez:

text
[install] ERROR: no access to the package repository, or a package is not there; nothing was changed.
[install] Missing: libtommath1
[install] Install them, then run this file again:
[install]   apt-get install -y libtommath1
[install] On a server without internet: on a PC with the same Ubuntu 24.04.5 LTS
[install]   apt-get download libtommath1
[install] copy the .deb files here and run:  apt-get install -y ./*.deb

RHEL ailesinde libtommath EPEL’dedir: erişilebilir bir depo varsa kurulum epel-release paketini kendisi ekler. Yoksa komutlar dnf install -y epel-release, dnf download --resolve <packages> ve dnf install -y ./*.rpm şeklindedir. --check aynı listeyi önceden yazdırır, böylece paketler kurulum penceresinden önce hazırlanabilir.

Çıkış kodları

Kod Anlamı Ana makinedeki değişiklikler
0 Tamamlandı (deneme e-postası, attach veya lisansla ilgili uyarılar özette yer alır) evet
1 Reddedildi: ana makine, bir seçenek, bir dosya veya plan (neden yazdırılır). Ayrıca: metin arayüzünde Çık yok
2 Kurulum başarısız oldu ve geri alındı. Ayrıca: kurulum bir sinyalle durduruldu (Ctrl+C) geri alındı; kurulumdan önce durdurulduysa yok
3 Kurulum başarısız oldu ve geri alma tamamlanmadı (özet neyin kontrol edileceğini söyler) kısmen
4 Planın bir sorusu onaylanmadı (terminal yok, --yes yok). yok
5 Yük kontrolü geçemedi (sha256, imzalar): dosyayı yeniden indirin. --uninstall ile: reddedildi, aracı ana makinenin RCM’sini çalıştırıyor ve diğer aracılar onu kullanıyor (bölüm 7) yok
6 İşletim sistemi kitaplıkları eksik ve paket deposuna erişilemiyor yok
7 Dağıtımın paketlerinden bir Firebird kurulu yok

10. Sorun giderme

Sorun Ne yapmalı
run as root (sudo sh ...) Kurulumu sudo ile veya root olarak çalıştırın
Metin arayüzünün sayfaları açılmıyor İlk satır nedenini söyler: needs a window of 80x24 or larger (pencereyi büyütün; durum satırlı tmux bir satır alır) veya needs bash 4.4 or newer. Ardından çalışan düz kurulum aynı kurulumu yapar
Sayfalarda yanlış karakterler veya bozuk satırlar Terminali UTF-8’e ayarlayın veya --lang en ile çalıştırın; --no-tui düz kurulumu çalıştırır
/var/tmp is mounted noexec --tmpdir /root ile yeniden çalıştırın (programların çalışabileceği herhangi bir klasör)
is damaged or cut (çıkış kodu 5) .run dosyasını yeniden kopyalayın ve sha256sum değerini yayımlanan değerle karşılaştırın
Çıkış kodu 6, kitaplıklar eksik Paketleri yazdırıldığı gibi hazırlayın (bölüm 9), ardından kurulumu yeniden çalıştırın
Çıkış kodu 7, dağıtım paketlerinden Firebird Paketleri kaldırın (apt-get remove firebird3.0-server, bir gbak yedeği saklayın) veya --import-firebird ile çevrimiçi kurulumu kullanın
refused (M17): Firebird 2.5 works only in /opt/firebird İkinci bir Firebird 2.5 mümkün değildir; yanına başka bir hat kurun (bölüm 7)
Birden fazla aracıyla --uninstall reddedildi (çıkış kodu 1) Listeden bir klasörle --agent-dir ekleyin, örneğin --agent-dir /opt/hqbird/fbagent-fb50-2
--uninstall reddedildi (çıkış kodu 5): this agent runs the RCM of the host Önce RCM konsolunda kümeyi kaldırın veya --force ile yeniden çalıştırın (bölüm 7)
Bir güncellemeden sonra employee.fdb için no permission for read-write access (3.0) sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb (bölüm 6)
refused (M14): the folder is not empty --fb-root ile boş veya yeni bir klasör seçin ya da güncellenecek Firebird’ü belirtin
Çıkış kodu 2 veya 3 /var/log/fbagent/install.log dosyasını okuyun; birimler çalıştırmadan önceki durumlarına döndü (kod 2) veya bir kontrol gerekiyor (kod 3)
HQ Monitor açılmıyor systemctl status hqbirdmonitor-fb50 (hqbirdmonitor-p<port> 2027.2.9 öncesi); bağlantı noktasını başka bir şeyin dinlemediğini kontrol edin; güvenlik duvarında bağlantı noktasını açın; başka bir bağlantı noktası için --hqmonitor-port
HQ Monitor parolası kayboldu Kurulumu (onarım) --hqmonitor-login admin --hqmonitor-password-file <file> ile yeniden çalıştırın; eski /opt/hqbird/conf/access.properties dosyası access.properties.bak-<time> olarak saklanır. Yeni oturum açma bilgisi ana makinenin tüm örnekleri için geçerlidir
Deneme e-postası gönderilmedi (ağ yok) Daha sonra gönderin: cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email <address> --accept-privacy
SELinux (AlmaLinux, RHEL) Enforcing modunda desteklenir: kurulum yazdığı dosyaların bağlamlarını geri yükler; yapılacak bir şey yok