Инсталација и ажурирања
Инсталација без изненађења
Један инсталер по Firebird линији. Проналази Firebird, стари HQbird и агенте на серверу, приказује план и не мења ништа док не кажете „Да“. Након тога, агент сам себе ажурира, као и конзолу и Firebird, уз провере и враћање на претходно стање.
- 4 инсталера: Firebird 2.5 · 3.0 · 4.0 · 5.0
- 0 измена пре него што потврдите план
- интернет није потребан све у једној датотеци
- Windows и Linux чаробњак, тихи режим, .run
- враћање на претходно стање ако инсталација или ажурирање не успе
setup.exe · .run
Шта је у комплету
Инсталер је једна датотека: hqbird2027-fb50-setup-<version>.exe за Windows или hqbird2027-fb50-linux-<version>.run за Linux. Садржи све што је серверу потребно. Ништа се не преузима.
Сваки инсталер инсталира једну Firebird линију. Изаберите линију на којој раде ваше базе података. Инсталацију обавља агент из комплета: проверава сервер, прави план и извршава га.
| Компонента | Шта ради | Windows | Linux |
|---|---|---|---|
| Firebird, HQbird билд | Нови сервер или ажурирање на постојећем. За сервер који је већ инсталиран, у firebird.conf се додаје једна линија: MonitoringPlugin = fblwmon. За нови сервер, инсталер такође подешава порт. databases.conf, безбедносна база и SYSDBA лозинка се не мењају. | сервис FirebirdServer… | /opt/firebird |
| fbagent агент | Резервне копије, надгледање, одржавање, ажурирања. | HQbirdFBAgent-fb50 | hqbirdfbagent-fb50, корисник firebird |
| HQbird Monitor | Веб конзола за овај сервер. Порт = 20000 + Firebird порт: за 3050 то је 23050. Порт се бира приликом инсталације и касније се не мења, чак и ако промените Firebird порт. | HQbirdMonitor-fb50 | hqbirdmonitor-fb50 |
| Компоненте кластера | Програми кластера се постављају на сервер, али се не укључују: RCM и прозор за упаривање су подразумевано искључени. RCM чини сервер центром новог кластера и отвара портове 7443 и 7444. Прозор за упаривање отвара портове 7450–7459 на 24 сата: кроз њега RCM другог сервера може да позове овај сервер. Оба можете укључити и након инсталације. | страница чаробњака „Replication and cluster setup“; /RCM, /DISCOVERY | --rcm on, --cluster-pairing on |
| fbmcp MCP сервер | Приступ за AI клијенте до Firebird. Подразумевано само са овог сервера. | поље за потврду у чаробњаку или /NOFBMCP | --no-fbmcp |
| Firebird датотеке за отклањање грешака | Симболи за анализу падова Firebird. | — | да, --no-debug их искључује |
- WindowsПодржано: Windows 10 и 11, Windows Server 2016 и новији, 64-бит. Администраторска права. Инсталер је потписао IBSurgeon Software: Windows приказује издавача у захтеву за дозволе.
- Чаробњак или тихи режимСвака страница чаробњака доступна је и као прекидач:
/VERYSILENT /YES /LOG=…. Добро за скрипте и за стотину сервера. - Чаробњак на 8 језикаЕнглески, португалски (Бразил), немачки, руски, шпански, пољски, турски, кинески поједностављени. Подразумевано је језик Windows-а. Прекидач:
/LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN. - Име сервераЧаробњак пита за име новог агента; HQCenter приказује сервер под тим именом. Подразумевано је име рачунара. Тихи режим:
/AGENTID=, на Linux-у--agent-id. Агент који је већ инсталиран задржава своје име.
- Linuxx86_64, језгро 3.2 или новије, systemd, root. Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS и други са apt, dnf, yum или zypper.
- Сервер без интернетаИнсталер преузима неколико OS библиотека (libtommath, ICU) из репозиторијума. Ако нема репозиторијума, исписује тачне команде и не мења ништа.
Комплет се проверава два пута. Пре распакивања: sha256 целог комплета. Пре инсталације Firebird-а и агента: потпис сваке датотеке. Оштећено преузимање зауставља инсталацију пре било какве измене Firebird-а, агента или конзоле.
fbagent --install-plan
Прво план, измене после
Прво инсталер само чита: сервисе, регистар, Firebird и HQbird фасцикле. Затим приказује шта је пронашао и шта ће урадити. Измене почињу када кажете „Да“.
Изаберите шта је на серверу и погледајте план. Текстови су скраћени и преведени; редослед и одлуке су исти као у инсталеру за Firebird 5.0.
- 1Провера сервераправа, битност; на Linux-у и systemd и језгро
- 2Провера комплетаsha256 пре распакивања; потписи датотека пре инсталације
- 3Планшта је пронађено и шта ће бити урађено
- 4Питањаиме сервера за HQCenter; зауставити Firebird? друга верзија?
- 5ИнсталацијаFirebird, агент, конзола, сервиси
- 6✓ Резултатсервиси, адреса конзоле, пријава
Ако нешто пође наопако
Одбијање у фази плана (порт је заузет, фасцикла није празна) ништа не мења: инсталатер наводи разлог. У чаробњаку не можете да напустите страницу док је вредност погрешна.
Неуспех током инсталације, пре него што се покрене сервис агента: сервиси се враћају у претходно стање. Стари HQbird, ако је био заустављен, поново се покреће.
| Код | Значење (Linux .run) |
|---|---|
| 0 | Готово |
| 1 | Одбијено: сервер, прекидач или план. Ништа није промењено |
| 2 | Инсталација није успела, промене су поништене |
| 3 | Поништавање није потпуно: резултат наводи шта проверити |
| 4 | Потребан је одговор: нема терминала ни --yes |
| 5 | Комплет није прошао проверу: преузмите га поново |
| 6 | Нема библиотека ОС-а ни репозиторијума |
| 7 | Firebird из дистрибуцијских пакета |
| Код | Значење (Windows setup.exe) |
|---|---|
| 0 | Инсталирано |
| 1 | Одбијено пре инсталације: погрешан прекидач или датотека, инсталирана је новија верзија, нема администраторских права |
| 4 | Инсталатер је имао питање, али нема прекидача /YES |
| 7 | Провера сервера или инсталација није успела. Разлог је у дневнику и у датотеци резултата |
| 10 | Инсталирано, али веза са HQCenter није успела |
-p3050); нове инсталације добијају -fb50.FBDataGuard → fbagent
Прелазак са HQbird 2024
Инсталатер проналази стари HQbird и Firebird који он опслужује. Овај Firebird се ажурира на месту, послови FBDataGuard прелазе на агента, стари сервиси се заустављају. Базе података, конфигурације и лозинке остају.
- Шта се не мења
databases.confилиaliases.conf, безбедносна база, SYSDBA лозинка, базе података, резервне копије и датотеке старог HQbird. Уfirebird.confсе додаје само линијаMonitoringPlugin = fblwmon, ако недостаје. - Копија старог FirebirdПрограмска фасцикла старог Firebird се чува поред ње као
<folder>.old_<time>. - Пословиgbak и nbackup резервне копије, sweep, статистика индекса. Увоз се извршава једном и пролази кроз проверу нове конфигурације; стара конфигурација се чува.
- Старе резервне копијеАгент преузима резервне копије из дневника FBDataGuard у своје записе. Правила задржавања и враћања виде их исто као и нове. Називи nbackup нивоа остају исти.
- Називи пословаНазив посла се завршава називом базе података из FBDataGuard, на пример „Верификована резервна копија - MANUAL“. Групни послови понављају стабло изворних фасцикли.
- Стари сервиси: три опцијеАутоматски (препоручено): онемогућите их када сваки Firebird који опслужује FBDataGuard има агента. Онемогући све:
/DISABLEHQBIRD. Остави како јесте:/NOHQBIRD. - Можете да се вратитеСтање сваког сервиса пре него што је онемогућен чува се у
fbagent-hqbird-takeover.json. Помоћу ове датотеке стари HQbird може поново да се укључи. - ЛиценцаСтара HQbird лиценца се не преноси. Пробни период траје док не набавите нову лиценцу или се повежете са HQCenter.
- Нејасна путањаАко увоз не може да прошири замену у путањи FBDataGuard, оставља је како јесте и оставља посао онемогућен. Исправите путању и омогућите посао.
Ако се послови увезу, а стари сервиси и даље раде (на пример, сервер има два Firebird сервера под FBDataGuard), послови стижу онемогућени. На тај начин се један посао не извршава два пута.
Портови · фасцикле · сервиси
Неколико Firebird сервера на једном рачунару
Један агент по Firebird-у. Нова инстанца се инсталира поред осталих, на сопственом порту, са сопственим агентом и сопственом конзолом. Инсталиране инстанце се не мењају.
Додајте Firebird сервере и погледајте које називе и портове бира инсталатер.
- Портови по линијиПрви Firebird на серверу добија 3050. Следећи: 3052 за 2.5, 3053 за 3.0, 3054 за 4.0, 3055 за 5.0. Инсталатер не заузима порт који је већ у употреби.
- Друга инстанца исте линијеБрој
-2у називима фасцикли и сервиса. На Windows-у, то је опција чаробњака „Инсталирај другу инстанцу“; порт је први слободан у опсегу линије.
- Ажурирања само унутар линије5.0.x → 5.0.y. Прелазак са 3.0 на 5.0 значи другу инстанцу поред прве; базе се премештају помоћу backup-а и restore-а.
- XNET на Windows-уFirebird који није на порту 3050 добија своје име
IpcName = FIREBIRD_<port>. Локалне XNET конекције ка другом серверу раде. - Једна конзола по агентуHQbird Monitor на 20000 + порт Firebird-а: 23050, 23055. Један фајл за пријаву за све инстанце на серверу.
- Портови су фиксниПортови конзоле и локалног API-ја агента се уписују приликом инсталације. Ако касније промените порт Firebird-а, они остају исти. Агент не прихвата једнаке портове.
- Кластер: слот за сваки агентСваки агент на серверу добија свој слот од 0 до 9: порт за упаривање 7450 + слот, портови чвора 7051 + слот и 7061 + слот. Тако два агента једног сервера могу да се придруже кластеру. Прекидач
--pairing-portексплицитно поставља слот.
Слике · compose · портови
HQbird у Docker-у
Постоји готова слика за сваку Firebird линију. Firebird, агент и HQbird Monitor раде у контејнеру. Агент инсталира чвор кластера унутар самог контејнера када се сервер придружи кластеру. RCM инсталира само када је овај сервер одређен као RCM кластера.
| Слика | Firebird | Порт Firebird-а | HQbird Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
- Прво покретањеКопирајте
compose.yamlиз комплета, ставите SYSDBA лозинку у тајни фајл, уклоните#са линијаsecrets:и покренитеdocker compose up -d. Сервер је спреман кадаdocker compose psприкажеhealthy. - Порт Firebird-аПроменљива
HQBIRD_FB_PORT, подразумевано 3050. HQbird Monitor слуша на 20000 + овај порт. - Потпис сликеСлике су потписане алатом cosign. Јавни кључ за проверу још није објављен.
- Више инстанци на једном хостуFirebird на 3050 + N, HQbird Monitor на 20000 + порт Firebird-а, чвор кластера на 7051 + N. Само једна инстанца на хосту може имати RCM.
- Исти број порта споља и унутраОбјавите
3051:3051, не3051:3050. Агент и кластер пријављују порт који виде унутар контејнера. - КластерАдреса члана је адреса Docker хоста. Објавите порт чвора и, за RCM, портове 7443 и 7444.
Docker објављује портове мимо ufw. ufw правило „само порт 22“ не затвара портове контејнера. Објавите порт на једној адреси хоста или га затворите спољним firewall-ом.
Cloud и Docker: подешавања, волумини, портови, ажурирањаАгент · конзола · кластер · Firebird
Ажурирања након инсталације
Након што се повеже са HQCenter, агент сам ажурира себе, HQbird Monitor, компоненте кластера, fbmcp и Firebird. Сервер без HQCenter-а такође сам себе ажурира: агент преузима нове верзије са IBSurgeon сервера за ажурирања.
Агент види нову верзију себе у HQCenter-у у року од минута. Нове верзије HQbird Monitor-а, fbmcp-а и Firebird-а: у року од сата. Свако ажурирање прати један образац: провери, сачувај тачку за враћање, замени, провери да ради. Ако не ради, врати стару.
Ажурирања без HQCenter-а
- Шта се само ажурираАгент, HQbird Monitor и MCP сервер. Провера се извршава једном у 6 сати.
- Firebird чека командуFirebird пакет се преузима и чека. Администратор га примењује: дугметом на страници Updates или командом
fbagent --firebird-update --apply. - Ви бирате режимИнсталациони прекидач
--auto-update all|agent|off, на Windows-у/AUTOUPDATE=all|agent|off.agentје подразумевани.allтакође инсталира Firebird, у прозору за ажурирање.offне проверава ништа.
- Страница Updates у HQbird Monitor-уПриказује одакле агент преузима верзије, режим и последњи одговор сервера, стање ажурирања Firebird-а, конзоле и MCP сервера. Администратор мења режим и примењује Firebird пакет.
- Провера извораСервер за ажурирања се проверава према фиксираном кључу. Потпис добављача је увек обавезан.
- Кластер иде преко центраЧвор кластера и RCM се не ажурирају на овај начин: ажурирају их HQCenter или RCM.
Самоажурирање агента
- Само напредАгент не инсталира верзију старију од своје, чак ни обавезну. Провера се извршава пре него што се преузме иједан бајт. На тај начин лажни сервер не може да врати стару рањиву верзију. Изузетак је једна стара верзија дозвољена у сопственој конфигурацији агента (
allow_downgrade_to). - ПотписИздања су потписана Ed25519 кључем; јавни кључ је уграђен у агента. Погрешан потпис се увек одбија. Режим „само потписано“ укључује се у сопственој конфигурацији агента, а не са сервера.
- Ручно враћањеПоред агента постоји скрипта
rollback_to_version_NNN: она враћа претходни агент и конфигурацију и блокира неисправну верзију. Чувају се две најновије тачке враћања; старије се аутоматски бришу. - Linux: root покреће само сопствену копијуАгент ради као
firebird. Замену обавља проверена копија у фасцикли у коју само root може да пише.
Ажурирање Firebird
Firebird се ажурира само у оквиру своје линије и само на новију верзију. Агент може да преузме и припреми пакет у било ком тренутку, али зауставља Firebird само у прозору за ажурирање.
- 1Припремапреузимање, потпис, верзија није старија од мотора
- 2Прозордневни прозор; обавезно издање такође чека прозор
- 3Пословиgbak, nbackup или SQL скрипта се извршава: покушај се одлаже
- 4Заменастаре датотеке мотора се издвајају, конфигурације остају
- 5ПровераFirebird се покреће и одговара на свом порту
- 6✓ или враћањестаре датотеке се враћају, верзија се блокира
| Шта се ажурира | Заштита | Ако не успе |
|---|---|---|
| fbagent агент | Потпис, само новије, спремност у року од 180 s и 45 s рада | Враћање, пауза од 30 минута; други неуспех блокира верзију |
| HQbird Monitor, кластер, fbmcp | Потпис, само новије од инсталиране | Претходна верзија остаје; чувају се 2 најновије копије |
| Firebird | Прозор, чекање на резервне копије, провера након покретања | Стари мотор се враћа, верзија одлази на листу блокираних |
Блокирана верзија се више не инсталира, али следећа верзија се инсталира као и обично. На тај начин сервер не улази у петљу „ажурирај → врати → ажурирај“.
Фасцикле · дневници · деинсталација
Где су датотеке и како деинсталирати
Windows
C:\HQbird\ Firebird50\ Firebird 5.0, configs, security DB fbagent-fb50\ agent and HQbird Monitor agent_config.json agent config logs\ bak\ update\ logs, copies, update cache C:\HQbirdData\ agent and console working data config\access.properties console login C:\ProgramData\fbagent\ installation result and log
Linux
/opt/firebird/ Firebird 5.0 (second line: /opt/fb50) /opt/hqbird/ conf/access.properties console login, 0600 fbagent-fb50/ agent and HQ Monitor agent_config.json agent config logs/ bak/ update/ logs, copies, update cache /var/lib/hqmonitor/ console data /var/log/fbagent/install.log installation log, no passwords
- Деинсталација не дира ваше базе податакаВаше базе података и резервне копије (
*.fdb,*.gdb,*.fbk,*.nbk) увек остају. Уклањање података брише само security DB и примере из пакета Firebird. - Windows„Apps“: уклања агента, конзолу, RCM овог агента, правила заштитног зида и Firebird који је овај инсталатер инсталирао као нов. Ако други агенти користе RCM овог агента, чаробњак пита „Remove this instance anyway?“; тиха деинсталација захтева
/FORCE. Ажурирани Firebird остаје. Конфигурације и security DB се уклањају само ако изаберете „remove data“.
- Linux
--uninstallуклања услуге агента и конзоле, RCM овог агента, sudoers правила и портове које је инсталатер отворио у firewalld или ufw. Агент прво напушта кластер. Ако други агенти користе његов RCM, потребан вам је прекидач--force. Firebird остаје.--remove-dataтакође уклања конфигурацију, дневнике и податке конзоле. - Стари HQbirdДеинсталација HQbird 2027 не поново укључује старе услуге: администратор то одлучује помоћу датотеке стања.
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2