HQbird 2027 за Linux: водич за инсталацију
Овај водич је за администратора који инсталира 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. Шта инсталер инсталира
- 2. Инсталација на први поглед
- 3. Нова инсталација
- 4. Након инсталације
- 5. Ажурирање старијег HQbird-а (2024 и раније)
- 6. Ажурирање HQbird 2027 на нову верзију
- 7. Команде за одржавање
- 8. Повезивање са вашим HQCenter-ом
- 9. Ненадгледана инсталација и скрипте
- 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. Инсталација на први поглед
Проверу сервера и саму инсталацију обавља HQbird agent
који инсталер носи (fbagent --install-plan,
fbagent --setup-install). Ништа се не преузима осим недостајућих OS
пакета. Ништа се не мења пре него што се план потврди: OS пакети
се инсталирају након потврде. У терминалу, комплети после 2027.2.30
отварају текстуални интерфејс (корак 3 одељка 3); --no-tui покреће обичан
инсталер, који поставља своја питања као линије текста. Без терминала и
без --yes инсталер се зауставља на потврди са излазним кодом 4. Ако инсталација не успе пре него што
јединица агента почне, агент враћа јединице у стање које су имале пре (излазни
код 2; код 3 када враћање није било потпуно, резиме каже шта треба
проверити).
3. Нова инсталација
Корак 1: Преузмите инсталер и проверите га
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 без измена (опционо)
sudo sh hqbird2027-fb50-linux-2027.2.9.run --check--check покреће проверу host-а, пријављује библиотеке ОС-а које недостају (и
команде за њихово добављање на серверу без интернета), приказује шта је агент
пронашао и шта би урадио, и излази. Ништа се не инсталира.
Корак 3: Покрените инсталатер
sudo sh hqbird2027-fb50-linux-2027.2.9.runКомплети после 2027.2.30 отварају текстуални интерфејс када их покренете у терминалу: екране преко целог екрана са планом и подешавањима. Комплети до 2027.2.30, и случајеви у „Обичан инсталатер" испод, постављају своја питања као редове текста. Оба врше исту инсталацију са истим опцијама.
Текстуални интерфејс
Инсталатер проверава host, распакује себе, чита план и приказује прву страницу. Ништа на host-у се не мења док не покренете инсталацију на страници Install.
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-а:
[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 и новијим и без изабраног кластера, они су:
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). Инсталатер бира
језик овим редом:
- опција
--lang en|ru|pt-BR|de; - променљива
HQBIRD_LANG; - локал конзоле (
LC_ALL, затимLC_MESSAGES, затимLANG), када је UTF-8 локал; - енглески.
Друга линија излаза каже који је језик и како да га промените. Ова линија је увек на енглеском:
[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, … Он именује случај који је инсталатер пронашао
на домаћину. Инсталатер исписује шта код значи:
[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: Проверите резултат
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).
/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 инсталационе скрипте:
Шта видите на терминалу:
[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 их не поново укључује.
Неинтерактивни облик:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird6. Ажурирање HQbird 2027 на нову верзију
Новији инсталатер исте линије, покренут на хосту са HQbird 2027, ажурира инсталирану инстанцу на месту: Firebird, датотеке за отклањање грешака, агент и HQ Monitor. Конфигурација, базе података, стање пробног режима или лиценце, HQ Monitor порт и пријава се чувају.
sudo sh hqbird2027-fb50-linux-2027.2.9.runУ текстуалном интерфејсу прва страница приказује Plan M10: Update of an installed HQbird 2027, агент са његовим id (kept), и без реда Agent id; Install
покреће ажурирање. Обичан инсталатер исписује:
[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] |
Друга инстанца
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-у, сервери у кластеру и шта остаје на диску детаљно су описани у упутству за уклањање. Укратко:
# 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:
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:
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-ом
HQCenter је централни сервер ваше компаније који управља HQbird агентима: лиценцама, конфигурацијом, ажурирањима, прегледом резервних копија. Без HQCenter-а агент ради самостално са верзијама инсталатера и пробном или лиценцном датотеком.
- У административном панелу HQCenter-а отворите Tokens
(
https://<hqcenter>:8443/admin/tokens). У обрасцу Install script изаберите лиценцу (или ниједну), режим, број сервера и важност (1 до 365 дана); поља за платформу и Firebird се не користе. Кликните Download connection file и сачувајтеattach.json. Датотека садржи тајни токен: чувајте је безбедно (chmod 600), избришите је после употребе и опозовите токен на листи на истој страници. Образац се приказује само када јеadmin_panel.install_script_urlподешен. - Копирајте
attach.jsonна сервер. - Повежите се на један од два начина:
# 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. Релативне путање
се рачунају од тренутне фасцикле.
Примери
Нова инсталација са подразумеваним вредностима:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes
echo "exit code $?"Нова инсталација у изабрану фасциклу и порт, са SYSDBA лозинком из датотеке и пријавом на HQ Monitor:
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Нова инсталација са пробним имејлом, датотеком лиценце и датотеком за повезивање:
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 јединице искључене:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbirdАжурирање HQbird 2027 на нову верзију (једна инстанца; са више њих додајте
--fb-root и --port):
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yesДруга Firebird 5.0 инстанца на порту 3056:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056Уклањање:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataСкрипта која се зауставља на неуспешној инсталацији:
#!/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 и ништа се не мења:
[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 режиму: инсталатер враћа контексте датотека које уписује; нема шта да се ради |