Ова страница је машински преведена. Прочитајте енглески оригинал. English

Овај водич је за администратора који инсталира HQbird 2027 на Linux сервер помоћу офлајн инсталера hqbird2027-fbNN-linux-<version>.run. Он покрива нову инсталацију, ажурирање старијег HQbird-а и ранијег HQbird 2027, команде за одржавање, повезивање са вашим HQCenter-ом, ненадгледану (скриптовану) инсталацију и где се налазе датотеке након инсталације.

Примери приказују инсталер за Firebird 5.0 на Ubuntu 24.04. Инсталери за Firebird 2.5, 3.0 и 4.0 раде на исти начин; разликују се само верзија, подразумевани порт и називи фасцикли. Windows подешавање је описано у Windows installation.

Садржај

  1. 1. Шта инсталер инсталира
  2. 2. Инсталација на први поглед
  3. 3. Нова инсталација
  4. 4. Након инсталације
  5. 5. Ажурирање старијег HQbird-а (2024 и раније)
  6. 6. Ажурирање HQbird 2027 на нову верзију
  7. 7. Команде за одржавање
  8. 8. Повезивање са вашим HQCenter-ом
  9. 9. Ненадгледана инсталација и скрипте
  10. 10. Решавање проблема

1. Шта инсталер инсталира

Једна .run датотека = једна Firebird линија. Изаберите инсталер за верзију Firebird-а коју користе ваше базе података:

Инсталер Firebird који инсталира или ажурира Први Firebird на хосту Величина
hqbird2027-fb50-linux-<version>.run Firebird 5.0 (HQbird build) /opt/firebird, порт 3050 око 250 MB
hqbird2027-fb40-linux-<version>.run Firebird 4.0 (HQbird build) /opt/firebird, порт 3050 око 220 MB
hqbird2027-fb30-linux-<version>.run Firebird 3.0 (HQbird build) /opt/firebird, порт 3050 око 130 MB
hqbird2027-fb25-linux-<version>.run Firebird 2.5 (HQbird build) /opt/firebird, порт 3050 око 80 MB

Сваки инсталер садржи и инсталира без интернета:

  • Firebird (HQbird build те линије): нови сервер, или ажурирање на месту Firebird-а те линије који је већ на хосту. Ваш firebird.conf, databases.conf (aliases.conf за 2.5), безбедносна база података и SYSDBA лозинка се задржавају.
  • Firebird debug датотеке (симболи за анализу падова), инсталирају се у Firebird фасциклу. --no-debug их прескаче.
  • HQbird agent (fbagent): systemd јединица hqbirdfbagent-fb50, која ради као корисник firebird, и обавља резервне копије, надгледање, послове одржавања и ажурирања. Назив се завршава Firebird линијом (-fb25 … -fb50); друга инстанца линије има -fb50-2.
  • HQ Monitor: веб конзола ове HQbird инстанце, јединица hqbirdmonitor-fb50, адреса http://<server>:<20000 + Firebird port>/ (за Firebird на порту 3050: http://localhost:23050/).
  • Компоненте кластера: конзола кластера RCM (hqbirdrcm) и чвор кластера (hqclusternode) се копирају у кеш агента. Комплети са агентом (fbagent) 3.1.0 и новијим подразумевано не праве кластер: без RCM-а, без прозора за упаривање, без порта кластера у заштитном зиду. Два питања (или --rcm on, --cluster-pairing on) их укључују („Следеће: кластер" у одељку 3). Са RCM-ом, инсталира се у /opt/hqbirdrcm и ради као јединица hqbirdrcm; резиме исписује његову адресу у линији RCM:. Чвор добија своју јединицу (на пример hqclusternode-master-p3050) када повежете хост у RCM-у. Комплети од 2027.2.19 са старијим агентом инсталирају RCM на сваком серверу (--rcm off га оставља у кешу) и отварају прозор за упаривање. Комплети пре 2027.2.19 само копирају обе компоненте у кеш агента: нема јединице hqbirdrcm ни линије RCM:.

Инстанце инсталиране пре 2027.2.9 имају Firebird порт у називима агента: фасцикла /opt/hqbird/fbagent-p3050, јединице hqbirdfbagent-p3050 и hqbirdmonitor-p3050. Ажурирање не мења ове називе. Само нове инстанце добијају називе -fb<NN>, тако да један хост може имати оба облика.

Захтеви: x86_64, кернел 3.2 или новији, systemd; Linux са apt, dnf/yum или zypper (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS и други); root. Око 300 MB слободно у /var/tmp током инсталације (фасцикла у којој програми могу да се извршавају; видите --tmpdir). Неколико OS библиотека (libtommath, ICU) се преузима из репозиторијума дистрибуције; сервер без интернета добија тачне команде за њихово припремање (одељак 9).

Није подржано: Firebird инсталиран из пакета дистрибуције (firebird3.0-server, firebird rpm). Инсталер се зауставља пре него што било шта промени (излазни код 7); прво уклоните пакете (сачувајте gbak резервну копију ваших база података) или користите онлајн инсталер са --import-firebird.

Неколико Firebird линија на једном серверу: свака линија има свој инсталер. Први Firebird на хосту иде у /opt/firebird; друга линија иде у /opt/fb<NN> (/opt/fb50, /opt/fb40, /opt/fb30) на порту своје линије: 3053 за 3.0, 3054 за 4.0, 3055 за 5.0. Када је тај порт заузет, инсталер се зауставља и тражи --port N. Неколико инстанци једне линије (други Firebird 5.0 на другом порту) инсталира се са --fb-root <new folder> --port <port> (одељак 7). Firebird 2.5 има само једну инстанцу, у /opt/firebird; за други сервер поред њега користите другу линију (на пример Firebird 5.0 у /opt/fb50).

Детаљан водич корак по корак за две инстанце на портовима 3050 и 3051, за сваку линију, са командама за копирање и лепљење, налази се у hqbird2027-linux-two-instances-runbook.ru.md (руски) и hqbird2027-linux-two-instances-runbook.pt.md (португалски).

Пробни период: без лиценце агент ради 7-дневни пробни период. Пробни имејл (--email) га продужава на 30 дана. Датотека лиценце (--license) или веза са вашим HQCenter-ом (одељак 8) замењује пробни период.

Ажурирања: од комплета 2027.2.31 (агент 3.3.0) сервер који није повезан ни са једним HQCenter-ом проверава добављачев сервер за ажурирања. Подразумевано се агент, HQ Monitor и fbmcp сами ажурирају, а нови Firebird пакет се преузима и чека вас. --auto-update all|agent|off или линија Updates текстуалног интерфејса мења ово („Ажурирања без HQCenter-а" у одељку 4). Сервер повезан са HQCenter-ом преузима ажурирања са тог HQCenter-а.

2. Инсталација на први поглед

Diagram

Проверу сервера и саму инсталацију обавља HQbird agent који инсталер носи (fbagent --install-plan, fbagent --setup-install). Ништа се не преузима осим недостајућих OS пакета. Ништа се не мења пре него што се план потврди: OS пакети се инсталирају након потврде. У терминалу, комплети после 2027.2.30 отварају текстуални интерфејс (корак 3 одељка 3); --no-tui покреће обичан инсталер, који поставља своја питања као линије текста. Без терминала и без --yes инсталер се зауставља на потврди са излазним кодом 4. Ако инсталација не успе пре него што јединица агента почне, агент враћа јединице у стање које су имале пре (излазни код 2; код 3 када враћање није било потпуно, резиме каже шта треба проверити).

3. Нова инсталација

Корак 1: Преузмите инсталер и проверите га

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

Друге линије имају исте називе са fb40, fb30, fb25. Очекивано: hqbird2027-fb50-linux-2027.2.9.run: OK. Сервер без интернета: преузмите две датотеке на рачунару са истим линковима и копирајте их на сервер (scp, USB уређај, дељени ресурс).

Инсталер такође проверава сопствени садржај пре него што било шта распакује: пресечен

или прекинуто преузимање се зауставља са излазним кодом 5 („преузмите поново").

Корак 2: Проверите host без измена (опционо)

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

--check покреће проверу host-а, пријављује библиотеке ОС-а које недостају (и команде за њихово добављање на серверу без интернета), приказује шта је агент пронашао и шта би урадио, и излази. Ништа се не инсталира.

Корак 3: Покрените инсталатер

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

Комплети после 2027.2.30 отварају текстуални интерфејс када их покренете у терминалу: екране преко целог екрана са планом и подешавањима. Комплети до 2027.2.30, и случајеви у „Обичан инсталатер" испод, постављају своја питања као редове текста. Оба врше исту инсталацију са истим опцијама.

Текстуални интерфејс

Инсталатер проверава host, распакује себе, чита план и приказује прву страницу. Ништа на host-у се не мења док не покренете инсталацију на страници Install.

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

Горњи редови су план за тренутна подешавања: његов код и шта ће инсталатер урадити са Firebird-ом и агентом. План који није могућ је црвен, са разлогом, и курсор стоји на подешавању које га исправља. После сваке измене инсталатер поново чита план.

Тастер Шта ради
Up, Down Помера курсор (такође k, j)
Enter Отвара подешавање под курсором, бира ставку, прихвата унету вредност
Space Укључује или искључује компоненту (страница Components)
Esc Повратак на претходну страницу; на првој страници: напушта инсталатер (прво пита)
Ctrl+C Зауставља инсталатер одмах (излазни код 2). Ништа није промењено пре странице Install

На страници на којој уносите вредност (фасцикла, порт, адреса), Enter је прихвата и празна вредност значи „аутоматски". Esc не напушта такву страницу.

Подешавање Шта бирате Исто као опција
Language енглески, руски, бразилски португалски, немачки; странице се мењају одмах --lang
Firebird folder Фасцикла новог Firebird-а, или Firebird-а који се ажурира. Firebird 2.5 има једну фасциклу, па његов инсталатер нема тај ред --fb-root
Firebird port TCP порт Firebird-а --port
Agent id Аутоматски, име host-а, име host-а и инстанца, или ваша сопствена вредност. Само за новог агента: инсталирани агент задржава свој id, и ред се не приказује --agent-id
SYSDBA password За нови Firebird: генерисана, или ваша сопствена --sysdba-pass-file
HQ Monitor Порт и пријава веб конзоле --hqmonitor-port, --hqmonitor-login, --hqmonitor-password-file
License Не сада, 30-дневна пробна верзија путем е-поште (адреса, обавештење о приватности, зона), или датотека лиценце --email --accept-privacy --trial-zone, --license
HQCenter Датотека attach.json вашег HQCenter-а --attach
Cluster Менаџер кластера RCM (id кластера, администраторска лозинка), режим откривања, порт за упаривање --rcm, --cluster-id, --rcm-password-file, --cluster-pairing, --pairing-port
Components Датотеке за отклањање грешака Firebird-а; fbmcp и адресе његовог удаљеног режима --no-debug, --no-fbmcp, --fbmcp-allow-from
Updates Само HQbird (агент, HQ Monitor и fbmcp се сами ажурирају, нови Firebird чека вас), HQbird и Firebird (Firebird се такође сам ажурира, ноћу од 03:30 до 04:00, са поновним покретањем Firebird-а), или Off. Комплети од 2027.2.31; само за новог агента без датотеке attach.json: HQCenter контролише ажурирања прикљученог агента --auto-update

Опције на командној линији су вредности са којима странице почињу: sudo sh hqbird2027-fb50-linux-<ver>.run --rcm on --port 3055 отвара прву страницу са укљученим RCM-ом и портом 3055.

Четири реда испод подешавања:

  • Install приказује план у целини, затим пита Start the install now? са курсором на No. Питања плана (старији HQbird, Firebird који ради и треба зауставити) су на истој страници: Yes одговара на сва. После Yes странице се затварају, и инсталација исписује свој дневник и резиме на нормалном екрану, као у обичном инсталатеру испод.
  • Plan details приказује шта значи код плана, шта је инсталатер пронашао на host-у, упозорења и пакете ОС-а које ће инсталирати.
  • About plans наводи све кодове (M1 … M17). Enter на коду га објашњава. * означава код тренутног плана.
  • Quit напушта инсталатер (излазни код 1). Ништа није промењено.

Обичан инсталатер

Обичан инсталатер се покреће када је једно од следећег тачно:

  • опција --no-tui, или променљива HQBIRD_NO_TUI=1;
  • --yes, --check, --uninstall, --extract, --plan-help, --help;
  • stdin или stdout није терминал: скрипта, ssh host 'command' без терминала, или цев као што је ... 2>&1 | tee install.log;
  • TERM је dumb или није постављен;
  • прозор је мањи од 80 колона са 24 реда (унутар tmux-а са његовом статусном линијом терминал 80x24 има 23 реда: повећајте прозор, или користите --no-tui);
  • bash на host-у је старији од 4.4 (RHEL 7, CentOS 7);
  • комплет је 2027.2.30 или старији.

За прозор и за bash, први ред излаза каже зашто се странице нису отвориле.

Типично покретање обичног инсталатера на серверу без Firebird-а:

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

Овај пример је из комплета 2027.2.9. Од комплета 2027.2.19 резиме такође има редове RCM: и Pairing: конзоле кластера („Следеће: кластер" испод). Са агентом 3.1.0 и новијим и без изабраног кластера, они су:

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)

Шта редови значе:

  • host: дистрибуција и кернел; инсталатер одбија host који није x86_64, нема systemd, или покреће кернел старији од 3.2.
  • OS libraries: шта Firebird ове линије захтева од ОС-а (одељак 9). План наводи пакете који недостају (OS packages to install); после потврде инсталатер их узима из репозиторијума дистрибуције. Без репозиторијума се зауставља са излазним кодом 6

и исписује команде.

  • план: шта је агент пронашао (found Firebird ..., HQbird: ... линије) и шта ће урадити: Firebird new (нов сервер), update (Firebird ове линије се ажурира на месту), или одбијање са разлогом (излазни код 1, ништа није промењено).
  • Install as planned? Yes/No: последње питање пре него што се било шта промени. Одговорите y. Када план има сопствена питања (старији HQbird, друга верзија), она долазе уместо тога (одељак 5). Без терминала, проследите --yes; иначе инсталатер стаје са излазним кодом 4.
  • Питања о кластеру (агент 3.1.0 и новији): Install the cluster manager (RCM) on this host and make a new cluster? [y/N] и Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N]. Подразумевано је Не. Прво се пита само када домаћин нема RCM и агент није у ниједном кластеру; друго не када је агент у кластеру или покреће RCM. --yes и покретање без терминала одговарају Не (без излазног кода 4).
  • HQ Monitor: адреса и пријава. Нова инсталација добија пријаву admin; њена генерисана лозинка је у /opt/hqbird/conf/access.properties (режим 0600, читљиво за root и агента само). Све HQbird 2027 инстанце домаћина деле овај фајл. Промените лозинку у HQ Monitor.

SYSDBA лозинка новог Firebird-а се генерише и чува у /root/fbagent-install-sysdba.txt (режим 0600): линија коментара, затим линија SYSDBA_PASS=<password>. Још један Firebird инсталиран касније на истом домаћину добија исту лозинку из овог фајла. Да поставите своју, проследите --sysdba-pass-file <file> (прва линија фајла) или --sysdba-pass <password>.

Језик инсталатера

Комплети после 2027.2.30 говоре четири језика: енглески, руски (ru), бразилски португалски (pt-BR) и немачки (de). Инсталатер бира језик овим редом:

  1. опција --lang en|ru|pt-BR|de;
  2. променљива HQBIRD_LANG;
  3. локал конзоле (LC_ALL, затим LC_MESSAGES, затим LANG), када је UTF-8 локал;
  4. енглески.

Друга линија излаза каже који је језик и како да га промените. Ова линија је увек на енглеском:

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

Напомене:

  • PuTTY не шаље LANG серверу. Рачуна се сопствени локал сервера, па је језик често енглески. Користите --lang.
  • Са --yes, и без терминала, аутоматски језик је енглески: скрипте читају тај излаз. --lang и даље ради тамо.
  • Инсталатеру је потребан UTF-8 локал на домаћину за остале језике (C.UTF-8 или en_US.UTF-8). Он поставља један за себе. Без њега говори енглески.
  • У текстуалном интерфејсу линија Language прве странице мења језик одмах. Терминал мора да приказује UTF-8 (PuTTY: Window, Translation, Remote character set UTF-8, што је његово подразумевано).
  • Енглески остаје у: линијама напретка саме инсталације, сажетку Done:, /var/log/fbagent/install.log, и упозорењима скенирања домаћина.

Код плана

План има код: M1, M2, … Он именује случај који је инсталатер пронашао на домаћину. Инсталатер исписује шта код значи:

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 исписује све кодове и излази. Ништа не мења. У текстуалном интерфејсу прва страница приказује код и његов наслов, “Plan details” приказује текст, а “About plans” наводи све кодове.

Код Шта је инсталатер пронашао Firebird Агент Старији HQbird
M1 ништа нов нов —
M2 Firebird ове линије, без старијег HQbird ажурирање нов —
M3 Firebird друге линије, без старијег HQbird нов, порт 305N нов —
M4 старији HQbird који опслужује Firebird ове линије ажурирање нов искључен, његови послови увезени као омогућени
M5 старији HQbird друге линије; Firebird ове линије је тамо ажурирање, после питања нов наставља да ради
M6 старији HQbird друге линије; нема Firebird ове линије нов, после питања нов наставља да ради
M7 старији HQbird без локалног Firebird-а познате верзије ажурирање или нов нов наставља да ради, упозорење
M8 HQbird 2027 агент за други Firebird ажурирање или нов нов, поред првог није промењен
M9 као M8, и старији HQbird опслужује ову линију ажурирање нов, поред првог искључен, његови послови увезени као омогућени
M10 агент већ опслужује овај Firebird (поновљено покретање) ажурирање на месту искључен када се покрене
M11 --fb-root је Firebird ове линије ажурирање нов или на месту као горе
M13 --fb-root је празна или нова фасцикла нов у тој фасцикли нов као горе

Кодови одбијања (излазни код 1, ништа није промењено): M12 фасцикла има Firebird који инсталатер не може да ажурира (друга линија, верзија коју не може да прочита, онемогућена услуга); M14 фасцикла није празна и нема Firebird; M16 неколико Firebird сервера ове линије, дајте --fb-root; M17 Firebird 2.5 ради само у /opt/firebird. M15 је комплет само за агента: Firebird се не инсталира и не ажурира.

ID агента

ID агента именује агента у HQCenter, у лиценци и у кластеру. Поставља се само при првој инсталацији:

  • Подразумевано: име домаћина + датум + инстанца, на пример srv1261114-fb50.
  • --agent-id ID даје ваш сопствени ID (1-128 слова, цифре, ., _ или -; први знак слово или цифра).
  • Инсталатер одбија ID који има други агент домаћина.
  • У текстуалном интерфејсу страница Agent id нуди аутоматски ID, име домаћина, име домаћина са инстанцом, и вашу сопствену вредност, и наводи ID-ове које домаћин већ има.
  • Инсталирани агент задржава свој ID. Поновљено покретање га приказује у плану (id srv1 (kept)), текстуални интерфејс тада нема линију Agent id, а --agent-id тамо даје само упозорење. Нови агент у фасцикли коју је ранија инсталација оставила са својом конфигурацијом такође задржава ID те конфигурације.

Корак 4: Проверите резултат

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

Користите пуну путању пример базе података: ради за сваку линију и такође после ажурирања, док задржани databases.conf старије инсталације можда нема алијас employee (нова инсталација 2027.2.3 га има).

Отворите http://<server>:23050/ у прегледачу и пријавите се као admin са лозинком из /opt/hqbird/conf/access.properties. Firebird порт и HQ Monitor порт се отварају у firewalld (зона public) када ради, иначе у ufw када је активан; са другим заштитним зидом отворите их сами. Портови кластера се отварају само за опцију кластера: 7443, 7444 и порт чвора са --rcm on; порт чвора и порт за упаривање са --cluster-pairing on. Без активног заштитног зида инсталатер исписује једну линију са портовима које није отворио. Порт који је био отворен пре инсталације остаје какав јесте.

Следеће: кластер

Да реплицирате своје базе података са главног сервера на сервер реплике, повежите два сервера у конзоли кластера RCM. Са агентом 3.1.0 и новијим, инсталирајте RCM само на главном (--rcm on, или одговорите y) и укључите режим откривања на реплици (--cluster-pairing on). Режим откривања отвара прозор за упаривање на 24 сата: порт за упаривање слота агента (7450 за прву инстанцу, 7451 за другу, до 7459) је отворен у заштитном зиду, и RCM може да позове агента. Један домаћин има један RCM (портови 7443 и 7444); агент који га је направио га покреће и не отвара никакав прозор за упаривање.

Касније, без инсталера: HQ Monitor → Clusters → Cluster on this server, или fbagent --cluster-init <id> и fbagent --cluster-pairing on. Комплети од 2027.2.19 са старијим агентом покрећу RCM на сваком серверу и исписују његову адресу у линији RCM: резимеа; инсталација пре 2027.2.19 добија RCM када је ажурирате новијим комплетом (одељак 6). Водич за кластер (за комплет 2027.2.33) води корак по корак од два нова сервера до радне реплике, са снимцима екрана: Водич за Linux кластер (такође на руском и португалском). Исти кораци само као команде: hqbird2027-linux-cluster-runbook.md (hqbird2027-linux-cluster-runbook.ru.md, hqbird2027-linux-cluster-runbook.pt.md).

4. Након инсталације

Јединице

Јединица Шта Покреће се као
firebird (2.5, 4.0, 5.0 у /opt/firebird); firebird-superserver (3.0 у /opt/firebird); за други фолдер назив фолдера са / → _: firebird.opt_fb50, firebird.opt_fb40-2 (4.0, 5.0 у /opt/fb50, /opt/fb40-2), firebird.opt_fb30-superserver (3.0 у /opt/fb30) Firebird сервер firebird
hqbirdfbagent-fb50 (друга инстанца hqbirdfbagent-fb50-2; пре 2027.2.9 hqbirdfbagent-p<Firebird port>) HQbird агент firebird
hqbirdmonitor-fb50 (hqbirdmonitor-fb50-2; пре 2027.2.9 hqbirdmonitor-p<Firebird port>) HQ Monitor firebird

Све три су омогућене и покрећу се при подизању система. journalctl -u hqbirdfbagent-fb50 приказује дневник јединице агента. Firebird 3.0 такође има јединице firebird-classic.socket и [email protected] (firebird.opt_fb30-classic.* у другом фолдеру), а Firebird 2.5 има firebird.socket: оне остају inactive, то је нормално. Процес Firebird 2.5 је fb_smp_server (SuperClassic).

Где су датотеке

Пример је прва инстанца Firebird 5.0 у /opt/firebird на порту 3050. Друга инстанца линије има -2 у називима агената (fbagent-fb50-2, hqbirdfbagent-fb50-2, hqbirdmonitor-fb50-2). Инстанце инсталиране пре 2027.2.9 имају порт у овим називима (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)

Инсталер не задржава ништа у /var/tmp: његов радни фолдер /var/tmp/hqbird2027.XXXXXX се уклања на крају, такође и након грешке.

Дневници

Дневник Где
Инсталер терминал; /var/log/fbagent/install.log
Агент /opt/hqbird/fbagent-fb50/logs/firebird-agent_<date>.jsonl, journal.log; journalctl -u hqbirdfbagent-fb50
HQ Monitor journalctl -u hqbirdmonitor-fb50; дневник ревизије /opt/hqbird/fbagent-fb50/hqmonitor_audit.log
Firebird /opt/firebird/firebird.log

Ажурирања без HQCenter-а

Од комплета 2027.2.31 (агент 3.3.0) агент који није повезан ни са једним HQCenter-ом преузима нове верзије са добављачевог сервера за ажурирања. Режим ажурирања је кључ update.mode у agent_config.json:

Режим Шта се самостално ажурира
agent (подразумевано) Агент, HQ Monitor и fbmcp. Нови Firebird пакет се преузима и чека администратора
all Исто, и Firebird, у свом прозору за примену (ноћу од 03:30 до 04:00; ажурирање поново покреће Firebird)
off Ништа: агент не врши провере ажурирања. За ажурирање покрените инсталер нове верзије (одељак 6)
  • При инсталацији: линија Updates у текстуалном интерфејсу, или --auto-update all|agent|off. Без њих инсталер не мења режим.
  • Касније: страница Updates у HQ Monitor-у, или поново инсталер са --auto-update <mode>.
  • Стање: sudo /opt/hqbird/fbagent-fb50/fbagent --update-status (додајте --json за скрипту). Исписује извор издања, зону и последњи одговор сервера за ажурирања.

Агент отвара одлазне HTTPS везе само ка овим адресама. Ниједан долазни порт није потребан.

Намена Адреса
Ажурирања, зона EU liceu.ibsurgeon.com:9443
Ажурирања, зона BR licbr.ibsurgeon.com:9443
Ажурирања, зона RU licru.ibsurgeon.com:20943
Пробна лиценца trialeu.ibsurgeon.com:9443, trialbr.ibsurgeon.com:19443, trialru.ibsurgeon.com:23943

Сервер који је повезан са HQCenter-ом не користи адресе за ажурирања: он преузима ажурирања са тог HQCenter-а (одељак 8).

Обавештења

Од комплета 2027.2.33 (агент 3.4.0) агент шаље поруке о проблемима сервера на ваш сопствени Telegram бот, webhook или е-пошту (SMTP). Инсталер не подешава ниједан канал, и ништа се не шаље док не додате један: HQ Monitor → Servers → Notifications. За тестирање канала из командне линије: sudo -u firebird /opt/hqbird/fbagent-fb50/fbagent --notify-test <channel>; --notify-history приказује последње доставе.

5. Ажурирање старијег HQbird-а (2024 и раније)

Инсталер проналази инсталирани HQbird (FBDataGuard) у /opt/hqbird и његове јединице, и Firebird сервере којима управља. Затим следи иста правила као HQbird инсталационе скрипте:

Diagram

Шта видите на терминалу:

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
  • План именује Firebird који се ажурира; --fb-root и --port не могу га преместити (његова јединица је заузета).
  • Питање Потврдите заустављање покренутог Firebird-а? се поставља када се машина мора зауставити; ред пре њега приказује отворене везе. Another version се пита када старији HQbird управља Firebird-ом друге верзије (ажурирајте тај, или нови поред њега). --yes одговара на сва питања са Да; без терминала и без --yes инсталатер се зауставља са излазним кодом 4 и ништа не мења.
  • --disable-hqbird искључује старије HQbird јединице у сваком случају; --no-hqbird оставља старији HQbird на миру (он наставља да ради поред HQbird 2027).
  • SYSDBA лозинка се не пита: агент је преузима од старијег HQbird-а.
  • HQ Monitor користи пријаву старијег HQbird-а: његова датотека /opt/hqbird/conf/access.properties се чува, па се пријавите са логином и лозинком које сте раније користили. Инсталатер даје датотеку кориснику firebird са режимом 0600 (старији HQbird ју је оставио читљиву за све кориснике). Гостујућа пријава старијег HQbird-а (access.guest-login) се не користи од стране HQ Monitor-а.

Шта се чува: firebird.conf, databases.conf / aliases.conf, безбедносна база података, SYSDBA лозинка, базе података, резервне копије и датотеке старијег HQbird-а. Ажурирање замењује програмске датотеке Firebird-а на месту; датотеке које је заменило чувају се у /opt/fbagent-update-backup/<folder name>-<id>/<time>_<old version>_to_<new version>/ (два најновија ажурирања остају). HQbird послови (резервне копије, чишћења, надгледање) се увозе у нови агент. HQbird лиценца старијег HQbird-а се не преноси: нови агент ради у пробном режиму док се лиценца не инсталира или док се сервер не повеже са вашим HQCenter-ом.

Од комплета 2027.2.33 (агент 3.4.0) увоз конфигурације старијег HQbird-а ради још две ствари:

  • Региструје базе података старијег HQbird-а у Firebird датотеци алијаса (databases.conf, или aliases.conf за 2.5) као редове name = path. Стара датотека се прво копира. База података се изоставља када је њена путања већ у датотеци, или када њена датотека не постоји. Датотека са директивом include се не мења.
  • Уклања старе логове надгледања старијег HQbird-а: садржај фасцикли mon/outcoming и mon/outtrace његове излазне фасцикле (фасцикле остају). Ништа се не уклања док ради нека услуга старијег HQbird-а. Уклањање се не може опозвати: ако су вам потребни ови логови, копирајте их пре инсталације.

Обе опције су подразумевано укључене. Кључеви hqbird_import.register_databases и hqbird_import.clean_mon_logs у agent_config.json (оба су у уређивачу конфигурације HQ Monitor-а) искључују их за каснији увоз; инсталатер нема опцију за њих.

Стање старијих HQbird јединица пре преузимања се чува у /opt/hqbird/fbagent-hqbird-takeover.json. --uninstall их не поново укључује.

Неинтерактивни облик:

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

6. Ажурирање HQbird 2027 на нову верзију

Новији инсталатер исте линије, покренут на хосту са HQbird 2027, ажурира инсталирану инстанцу на месту: Firebird, датотеке за отклањање грешака, агент и HQ Monitor. Конфигурација, базе података, стање пробног режима или лиценце, HQ Monitor порт и пријава се чувају.

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

У текстуалном интерфејсу прва страница приказује Plan M10: Update of an installed HQbird 2027, агент са његовим id (kept), и без реда Agent id; Install покреће ажурирање. Обичан инсталатер исписује:

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).

Ажурирање не мења називе фасцикле агента и јединица: инстанца у овом примеру је инсталирана пре 2027.2.9 и задржава fbagent-p3050.

Када је Firebird билд инсталатера онај који је већ инсталиран (на пример Firebird 2.5.9.27194 у сваком HQbird 2027 за 2.5), ажурирају се само агент и HQ Monitor: Firebird се не зауставља и нема питања Confirm to stop.

Задржани databases.conf инстанце инсталиране старијим HQbird 2027 можда нема алијас employee; повежите се са примером базе података по њеној пуној путањи (одељак 3, корак 4). На Firebird 3.0 ажурирање са 2027.2.0 оставља /opt/firebird/examples/empbuild/employee.fdb са режимом 0444, и Firebird не може да га отвори (no permission for read-write access); ако вам је потребна пример база података: sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb. Ваше сопствене базе података се не дирају.

  • Са неколико инстанци линије, именујте ону коју треба ажурирати: --fb-root /opt/fb50-2 --port 3056.
  • Поновно покретање истог инсталатера преко инсталиране верзије је поправка: програмске датотеке и јединице се поново уписују, подаци остају.
  • Након везе са HQCenter-ом (одељак 8) агент, HQ Monitor, Firebird и компоненте кластера се ажурирају из HQCenter каталога; нови инсталатер тада није потребан.
  • Сервер повезан са ниједним HQCenter-ом са агентом 3.3.0 или новијим (комплети од 2027.2.31) сам ажурира агент, HQ Monitor и fbmcp, осим ако је режим ажурирања off („Updates without HQCenter“ у одељку 4). Инсталација направљена пре 2027.2.31 добија ово након једног ажурирања са новијим инсталатером. Ажурирање са инсталатером задржава режим ажурирања; --auto-update <mode> га мења.

7. Команде за одржавање

Свака акција одржавања је покретање инсталатера са опцијама, или команда агента у фасцикли агента. У терминалу покретање без --yes отвара текстуални интерфејс са већ подешеним овим опцијама (комплети после 2027.2.30): проверите план на првој страници, затим изаберите Install.

Акција Команда
Друга инстанца ове линије sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50-2 --port 3056
Поправка / ажурирање sudo sh hqbird2027-fb50-linux-<ver>.run (са неколико инстанци: --fb-root <folder> --port <port>)
Повезивање са HQCenter-ом sudo sh hqbird2027-fb50-linux-<ver>.run --attach attach.json током инсталације, или касније cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /path/attach.json
Пошаљи пробни имејл cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email [email protected] --accept-privacy
Потврди пробни код из имејла cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-confirm <code> (или у HQ Monitor-у)
Инсталирај датотеку лиценце --license <file> током инсталације, или cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --license-install /path/license.json
Стање инсталације sudo /opt/hqbird/fbagent-fb50/fbagent --install-state --json
Стање ажурирања (без HQCenter-а) sudo /opt/hqbird/fbagent-fb50/fbagent --update-status
Промени режим ажурирања (без HQCenter-а) HQ Monitor, страница Updates; или sudo sh hqbird2027-fb50-linux-<ver>.run --auto-update all|agent|off
Уклони sudo sh hqbird2027-fb50-linux-<ver>.run --uninstall [--remove-data] [--force] [--agent-dir /opt/hqbird/fbagent-fb50]

Друга инстанца

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

Нови Firebird иде у /opt/fb50-2 (нова или празна фасцикла), јединица firebird.opt_fb50-2, са сопственим агентом (/opt/hqbird/fbagent-fb50-2, јединица hqbirdfbagent-fb50-2) и сопственим HQ Monitor-ом (http://localhost:23056/, јединица hqbirdmonitor-fb50-2). Агент добија најмањи слободан број у линији: fb50-2 за другу инстанцу, такође поред агента инсталираног пре 2027.2.9 (fbagent-p3050). Датотека за пријаву HQ Monitor-а /opt/hqbird/conf/access.properties је заједничка за инстанце на хосту: нова инстанца без --hqmonitor-login задржава постојећу пријаву, а --hqmonitor-login/--hqmonitor-password-file на било којој инстанци мењају пријаву за све њих (стара датотека се чува као access.properties.bak-<time>). Firebird 2.5 не подржава другу инстанцу: инсталатер се зауставља са refused (M17): Firebird 2.5 works only in /opt/firebird, not in <folder> (излазни код 1, ништа није промењено). Инсталирајте Firebird друге линије поред њега, на пример sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50 --port 3051.

Уклањање

Уклањање на Windows-у и Linux-у, сервери у кластеру и шта остаје на диску детаљно су описани у упутству за уклањање. Укратко:

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 инсталатер уклања јединог агента у /opt/hqbird. Са неколико агената на хосту зауставља се (излазни код 1), наводи њихове фасцикле и тражи --agent-dir:

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

--uninstall зауставља и уклања јединице агента и његовог HQ Monitor-а (hqbirdfbagent-fb50, hqbirdmonitor-fb50), sudoers правила агента и његових програма (fbagent, hqmonitor), и затвара порт HQ Monitor-а који је инсталација отворила у firewalld или ufw. Фасцикла агента остаје са конфигурацијом и логовима; --remove-data уклања и фасциклу и податке HQ Monitor-а у /var/lib/hqmonitor/. Firebird остаје инсталиран (јединица, фасцикла програма, базе података); старијe HQbird јединице које су биле искључене остају искључене. Са неколико агената на хосту, заједничка датотека за пријаву HQ Monitor-а остаје док се последњи агент не уклони.

Ако агент покреће RCM хоста и други агенти користе тај RCM, --uninstall одбија са излазним кодом 5 и ништа не мења: 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 ипак уклања агента; кластер тада губи свој CA (нема нових сертификата, нема нових чланова). RCM јединица остаје док је други агенти хоста користе. Да бисте учинили другог агента власником новог RCM-а када старог власника нема: fbagent --cluster-init <id> --rcm-takeover (нови CA: поново повежите чланове).

Напомена на крају инсталације (Uninstall: sudo sh ... --uninstall) нема --agent-dir: са неколико инстанци додајте га као што је приказано горе.

Да бисте уклонили и Firebird инстанце (инсталатер то не чини; прво направите gbak резервне копије њених база података), на пример Firebird у /opt/fb50-2:

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-ом

HQCenter је централни сервер ваше компаније који управља HQbird агентима: лиценцама, конфигурацијом, ажурирањима, прегледом резервних копија. Без HQCenter-а агент ради самостално са верзијама инсталатера и пробном или лиценцном датотеком.

Diagram
  1. У административном панелу HQCenter-а отворите Tokens (https://<hqcenter>:8443/admin/tokens). У обрасцу Install script изаберите лиценцу (или ниједну), режим, број сервера и важност (1 до 365 дана); поља за платформу и Firebird се не користе. Кликните Download connection file и сачувајте attach.json. Датотека садржи тајни токен: чувајте је безбедно (chmod 600), избришите је после употребе и опозовите токен на листи на истој страници. Образац се приказује само када је admin_panel.install_script_url подешен.
  2. Копирајте attach.json на сервер.
  3. Повежите се на један од два начина:
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

Са обичним токеном команда чека док администратор HQCenter-а не одобри захтев (до 30 минута). Са лиценцним токеном агент се повезује одмах и добија лиценцу. После повезивања пробни период се завршава када HQCenter да агенту лиценцу; агент, HQ Monitor, Firebird и компоненте кластера се тада ажурирају из каталога HQCenter-а. Неуспешно повезивање током инсталације не поништава инсталацију: резиме то наводи, а горња команда га понавља.

Захтеви: HQCenter (goafts) 1.15.0 или новији (старије верзије немају дугме за датотеку везе); сервер достиже HQCenter bootstrap порт једном за повезивање, а затим порт агената (443 подразумевано). HQCenter може бити без интернета. Друго повезивање истог сервера са истим HQCenter-ом захтева одобрење администратора чак и са лиценцним токеном.

9. Ненадгледана инсталација и скрипте

Свака опција ради и на терминалу. Ненадгледано покретање захтева --yes (одговара на питања плана; без терминала и без --yes инсталатер се зауставља са излазним кодом 4). --yes никада не отвара текстуални интерфејс. Скрипта која покреће инсталатер на терминалу и сама одговара на његова питања (на пример са expect) мора да дода --no-tui или постави HQBIRD_NO_TUI=1: комплети после 2027.2.30 тамо отварају странице. Излазни код говори резултат; детаљи су на терминалу и у /var/log/fbagent/install.log.

Опције

Опција Значење Подразумевано
--fb-root DIR Фасцикла новог Firebird-а (нова или празна); или фасцикла Firebird-а који се ажурира /opt/firebird, затим /opt/fb<NN>
--port N Порт Firebird-а 3050 за први Firebird; за другу линију порт линије (3053 за 3.0, 3054 за 4.0, 3055 за 5.0)
--sysdba-pass-file F, --sysdba-pass P SYSDBA лозинка новог Firebird-а (први ред F; P се уписује у датотеку 0600) генерише се, чува у /root/fbagent-install-sysdba.txt; даљи Firebird на хосту узима лозинку из те датотеке
--agent-id ID agent.id новог агента; само при првој инсталацији, инсталирани агент задржава свој id („The agent id“ у одељку 3) име хоста + датум + инстанца
--hqmonitor-port N Порт HQ Monitor-а 20000 + порт Firebird-а
--hqmonitor-login L --hqmonitor-password-file F Пријава за HQ Monitor, заједничка за све инстанце на хосту: дата на једној инстанци, мења пријаву за све admin + генерисана лозинка; ажурирање или даља инстанца задржава постојећу пријаву
--email ADDR --accept-privacy [--trial-zone RU|EU|BR] Пробни email (30 дана); адреса се шаље на пробни сервер добављача нема
--auto-update all|agent|off Ажурирања сервера који није повезан ни са једним HQCenter-ом (комплети од 2027.2.31): agent = агент, HQ Monitor и fbmcp се сами ажурирају, пакет Firebird-а чека вас; all = и Firebird, у његовом прозору; off = нема провера ажурирања („Updates without HQCenter“ у одељку 4) режим се не мења; нови агент има agent

| --license F | Датотека лиценце за инсталирање | нема | | --attach F | Повезивање са вашим HQCenter (attach.json) | нема | | --no-hqbird, --disable-hqbird | Оставити старији HQbird нетакнутим / искључити све његове јединице | аутоматски | | --no-debug | Не инсталирати Firebird датотеке за отклањање грешака | инсталиране | | --no-fbmcp | Не инсталирати fbmcp (MCP сервер за AI клијенте) и не мењати fbmcp овог хоста | инсталиран | | --fbmcp-allow-from A,B | Укључити удаљени режим fbmcp за ове администраторске адресе (IP или CIDR) | само локално | | --fbmcp-port N, --fbmcp-dns NAME,..., --fbmcp-ip ADDR | Удаљени порт fbmcp; додатна имена за његов сертификат; адреса за сертификат и слушаоца | порт 8650 | | --rcm on\|off | Инсталирати конзолу кластера RCM на овај хост и направити нови кластер (агент 3.1.0 и новији) | пита се; Не | | --rcm-password-file F | RCM администраторска лозинка са --rcm on (први ред датотеке F) | генерише се, приказује на крају | | --cluster-id ID | ID кластера са --rcm on | име хоста | | --cluster-pairing on\|off | Режим откривања: прозор за упаривање од 24 сата, RCM може позвати овај агент | пита се; Не | | --rcm-allow A,B,... | Само ови RCM-ови могу позвати овај хост у режиму откривања (IP, CIDR или име хоста) | било који RCM | | --pairing-port N | Порт за упаривање 7450–7459 новог агента; он бира слот (портови чворова 7051+k, 7061+k). Касније подешавање задржава слот | први слободан слот | | --cluster-node on\|off | Ставити услугу чвора кластера у кеш агента | укључено | | --yes | Одговорити Да на питања плана (Не на питања о кластеру) | пита се | | --check | Само провере, библиотеке и план; ништа се не мења | — | | --plan-help | Исписати шта значе кодови плана (M1, M2, …) и изаћи | — | | --no-tui | Обичан инсталатер, без текстуалног интерфејса; такође променљива HQBIRD_NO_TUI=1 („Обичан инсталатер“ у одељку 3) | текстуални интерфејс у терминалу | | --lang en\|ru\|pt-BR\|de | Језик инсталатера; такође променљива HQBIRD_LANG („Језик инсталатера“ у одељку 3) | UTF-8 локал конзоле, иначе енглески | | --tmpdir DIR | Распаковати овде (фасцикла у којој програми могу да се извршавају) | /var/tmp | | --extract DIR | Само распаковати садржај у DIR/payload и изаћи | — | | --uninstall [--remove-data] [--force] [--agent-dir DIR] | Уклонити агента и HQ Monitor (Firebird остаје); --force такође уклања агента који покреће RCM хоста док га други агенти користе | — |

Опције могу да се пишу као --port 3055 или --port=3055. Релативне путање се рачунају од тренутне фасцикле.

Примери

Нова инсталација са подразумеваним вредностима:

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

Нова инсталација у изабрану фасциклу и порт, са SYSDBA лозинком из датотеке и пријавом на HQ Monitor:

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

Нова инсталација са пробним имејлом, датотеком лиценце и датотеком за повезивање:

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

Ажурирање старијег HQbird-а, све старије HQbird јединице искључене:

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

Ажурирање HQbird 2027 на нову верзију (једна инстанца; са више њих додајте --fb-root и --port):

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

Друга Firebird 5.0 инстанца на порту 3056:

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

Уклањање:

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

Скрипта која се зауставља на неуспешној инсталацији:

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"

Сервер без интернета: OS библиотеке

Firebird одређене линије захтева ове библиотеке из OS (поред glibc):

Линија Пакети (Debian/Ubuntu) Пакети (RHEL фамилија)
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 обично ништа (libstdc++6 је у основном систему) обично ништа

Комплети после 2027.2.30 за линије 3.0, 4.0 и 5.0 такође захтевају програм colrm, који користи Firebird инсталациона скрипта: пакет bsdextrautils (bsdmainutils на старијим Debian и Ubuntu). Минимални Debian га нема; RHEL фамилија га има у util-linux, који је увек присутан.

Када пакет недостаје и репозиторијум није доступан, инсталатер се зауставља са излазним кодом 6 и ништа се не мења:

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 фамилији libtommath је у EPEL: са доступним репозиторијумом инсталатер сам додаје epel-release. Без њега, команде су dnf install -y epel-release, dnf download --resolve <packages> и dnf install -y ./*.rpm. --check исписује исту листу унапред, тако да пакети могу да се припреме пре инсталационог прозора.

Излазни кодови

Код Значење Промене на хосту
0 Завршено (упозорења о пробном имејлу, повезивању или лиценци су у резимеу) да
1 Одбијено: хост, опција, датотека или план (разлог је исписан). Такође: Изађи у текстуалном интерфејсу нема
2 Инсталација није успела и враћена је. Такође: инсталатер је заустављен сигналом (Ctrl+C) враћено; нема када је заустављен пре инсталације
3 Инсталација није успела и враћање није било потпуно (резиме каже шта проверити) делимично
4 Питање плана није потврђено (нема терминала, нема --yes). нема
5 Садржај није прошао проверу (sha256, потписи): преузмите датотеку поново. Са --uninstall: одбијено, агент покреће RCM хоста и други агенти га користе (одељак 7) нема
6 OS библиотеке недостају и репозиторијум пакета није доступан нема
7 Инсталиран је Firebird из пакета дистрибуције нема

10. Решавање проблема

Проблем Шта учинити
run as root (sudo sh ...) Покрените инсталатер са sudo или као root
Странице текстуалног интерфејса се не отварају Први ред каже зашто: needs a window of 80x24 or larger (повећајте прозор; tmux са статусном линијом заузима један ред) или needs bash 4.4 or newer. Обичан инсталатер који се тада покрене ради исту инсталацију
Погрешни знакови или преломљени редови на страницама Подесите терминал на UTF-8 или покрените са --lang en; --no-tui покреће обичан инсталатер
/var/tmp is mounted noexec Покрените поново са --tmpdir /root (било која фасцикла у којој програми могу да се извршавају)
is damaged or cut (излазни код 5) Копирајте .run датотеку поново и упоредите њен sha256sum са објављеном вредношћу
Излазни код 6, библиотеке недостају Припремите пакете како је исписано (одељак 9), затим поново покрените инсталатер
Излазни код 7, Firebird из пакета дистрибуције Уклоните пакете (apt-get remove firebird3.0-server, сачувајте gbak резервну копију) или користите онлајн инсталатер са --import-firebird

| refused (M17): Firebird 2.5 ради само у /opt/firebird | Други Firebird 2.5 није могућ; инсталирајте другу линију поред њега (одељак 7) | | --uninstall одбијено (излазни код 1) са неколико агената | Додајте --agent-dir са фасциклом из листе, на пример --agent-dir /opt/hqbird/fbagent-fb50-2 | | --uninstall одбијено (излазни код 5): this agent runs the RCM of the host | Прво уклоните кластер у RCM конзоли или поново покрените са --force (одељак 7) | | no permission for read-write access на employee.fdb након ажурирања (3.0) | sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb (одељак 6) | | refused (M14): the folder is not empty | Изаберите празну или нову фасциклу са --fb-root или наведите Firebird који треба ажурирати | | Излазни код 2 или 3 | Прочитајте /var/log/fbagent/install.log; јединице су враћене у стање пре покретања (код 2) или захтевају проверу (код 3) | | HQ Monitor се не отвара | systemctl status hqbirdmonitor-fb50 (hqbirdmonitor-p<port> пре 2027.2.9); проверите да ништа друго не слуша на порту; отворите порт у заштитном зиду; --hqmonitor-port за други порт | | Изгубљена лозинка за HQ Monitor | Поново покрените инсталатер (поправка) са --hqmonitor-login admin --hqmonitor-password-file <file>; стари /opt/hqbird/conf/access.properties се чува као access.properties.bak-<time>. Нова пријава важи за све инстанце на хосту | | Пробни имејл није послат (нема мреже) | Пошаљите га касније: cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email <address> --accept-privacy | | SELinux (AlmaLinux, RHEL) | Подржано у enforcing режиму: инсталатер враћа контексте датотека које уписује; нема шта да се ради |