HQbird 2027 for Linux: kurulum kılavuzu
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. Yükleyicinin kurduğu şeyler
- 2. Bir bakışta kurulum
- 3. Yeni kurulum
- 4. Kurulumdan sonra
- 5. Eski bir HQbird’in (2024 ve öncesi) güncellenmesi
- 6. HQbird 2027’nin yeni bir sürüme güncellenmesi
- 7. Bakım komutları
- 8. HQCenter’ınıza bağlanın
- 9. Katılımsız kurulum ve betikler
- 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çinaliases.conf), güvenlik veritabanı ve SYSDBA parolası korunur. - Firebird hata ayıklama dosyaları (çökme analizi için semboller), Firebird klasörüne kurulur.
--no-debugbunları atlar. - HQbird ajanı (
fbagent):firebirdkullanıcısı olarak çalışan, yedeklemeleri, izlemeyi, bakım işlerini ve güncellemeleri yapanhqbirdfbagent-fb50systemd birimi. Ad, Firebird hattıyla biter (-fb25…-fb50); hattın ikinci bir örneği-fb50-2alır. - HQ Monitor: bu HQbird örneğinin web konsolu, birim
hqbirdmonitor-fb50, adreshttp://<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/hqbirdrcmiçine kurulur vehqbirdrcmbirimi olarak çalışır; özet, adresiniRCM:satırında yazdırır. Düğüm, ana makineyi RCM’de bağladığınızda birimini alır (örneğinhqclusternode-master-p3050). Daha eski bir ajana sahip 2027.2.19’dan itibaren kitler, her sunucuya RCM kurar (--rcm offonu ö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:hqbirdrcmbirimi veRCM: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
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
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.sha256Diğ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ı)
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
sudo sh hqbird2027-fb50-linux-2027.2.9.run2027.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.
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-tuiseçeneği veyaHQBIRD_NO_TUI=1değ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.loggibi bir boru hattı; TERMdumbise veya ayarlanmamışsa;- pencere 80 sütun x 24 satırdan küçükse (
tmuxiçinde durum satırıyla 80x24’lük bir terminal 23 satıra sahiptir: pencereyi büyütün veya--no-tuikullanı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ı:
[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 --uninstallBu ö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:
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.
yyanı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--yesgeç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]veTurn 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.--yesve terminal olmadan bir çalıştırma No yanıtlar (çıkış kodu 4 yok). - HQ Monitor: adres ve giriş. Yeni bir kurulum
admingirişini alır; oluşturulan parolası/opt/hqbird/conf/access.propertiesiçindedir (mod 0600, yalnızcarootve 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:
--lang en|ru|pt-BR|deseçeneği;HQBIRD_LANGdeğişkeni;- konsolun yerel ayarı (
LC_ALL, ardındanLC_MESSAGES, ardındanLANG), bir UTF-8 yerel ayarı olduğunda; - İ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:
[install] Language: Русский (auto). Use --lang en to change.Notlar:
- PuTTY
LANGdeğişkenini sunucuya göndermez. Sunucunun kendi yerel ayarı geçerlidir, bu yüzden dil genellikle İngilizcedir.--langkullanın. --yesile ve terminal olmadan otomatik dil İngilizcedir: betikler o çıktıyı okur.--langorada da çalışır.- Kurulumun diğer diller için ana makinede bir UTF-8 yerel ayarına ihtiyacı
vardır (
C.UTF-8veyaen_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.logve 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:
[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 IDkendi 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-idyalnı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
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).
/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--jsonekleyin). 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:
Terminalde gördüğünüz:
[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-rootve--portonu 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 versionsorulur (onu güncelleyin veya yanına yeni bir tane kurun).--yestüm soruları Evet ile yanıtlar; terminal olmadan ve--yesolmadan kurulum programı çıkış kodu 4 ile durur ve hiçbir şeyi değiştirmez. --disable-hqbirdeski HQbird birimlerini her durumda kapatır;--no-hqbirdeski 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.propertiesdosyası korunur, bu nedenle daha önce kullandığınız oturum açma adı ve parolasıyla oturum açın. Kurulum programı dosyayıfirebirdkullanı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.confveya 2.5 içinaliases.conf)ad = yolsatırları olarak kaydeder. Önce eski dosya kopyalanır. Bir veritabanı, yolu zaten dosyada varsa veya dosyası mevcut değilse atlanır.includeyö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/outcomingvemon/outtraceklasö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:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird6. 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.
sudo sh hqbird2027-fb50-linux-2027.2.9.runMetin 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:
[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
offolmadı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
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056Yeni 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:
# 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:
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:
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 $B8. 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.
- 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 veattach.jsondosyası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ızcaadmin_panel.install_script_urlayarlandığında gösterilir. attach.jsondosyasını sunucuya kopyalayın.- İki yoldan biriyle bağlanın:
# 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.jsonSı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:
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:
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.txtDeneme e-postası, bir lisans dosyası ve attach dosyasıyla yeni kurulum:
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.jsonEski bir HQbird’in güncellenmesi, tüm eski HQbird birimleri kapalı:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbirdHQbird 2027’nin yeni bir sürüme güncellenmesi (tek örnek; birden fazlaysa
--fb-root ve --port ekleyin):
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes3056 numaralı bağlantı noktasında ikinci bir Firebird 5.0 örneği:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056Kaldırma:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataBaşarısız bir kurulumda duran bir betik:
#!/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:
[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 ./*.debRHEL 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 |