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

Инсталација без изненађења

Један инсталер по 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 линију. Изаберите линију на којој раде ваше базе података. Инсталацију обавља агент из комплета: проверава сервер, прави план и извршава га.

КомпонентаШта радиWindowsLinux
Firebird, HQbird билдНови сервер или ажурирање на постојећем. За сервер који је већ инсталиран, у firebird.conf се додаје једна линија: MonitoringPlugin = fblwmon. За нови сервер, инсталер такође подешава порт. databases.conf, безбедносна база и SYSDBA лозинка се не мењају.сервис FirebirdServer…/opt/firebird
fbagent агентРезервне копије, надгледање, одржавање, ажурирања.HQbirdFBAgent-fb50hqbirdfbagent-fb50, корисник firebird
HQbird MonitorВеб конзола за овај сервер. Порт = 20000 + Firebird порт: за 3050 то је 23050. Порт се бира приликом инсталације и касније се не мења, чак и ако промените Firebird порт.HQbirdMonitor-fb50hqbirdmonitor-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. 1Провера сервераправа, битност; на Linux-у и systemd и језгро
  2. 2Провера комплетаsha256 пре распакивања; потписи датотека пре инсталације
  3. 3Планшта је пронађено и шта ће бити урађено
  4. 4Питањаиме сервера за HQCenter; зауставити Firebird? друга верзија?
  5. 5ИнсталацијаFirebird, агент, конзола, сервиси
  6. 6✓ Резултатсервиси, адреса конзоле, пријава

Ако нешто пође наопако

Одбијање у фази плана (порт је заузет, фасцикла није празна) ништа не мења: инсталатер наводи разлог. У чаробњаку не можете да напустите страницу док је вредност погрешна.

Неуспех током инсталације, пре него што се покрене сервис агента: сервиси се враћају у претходно стање. Стари HQbird, ако је био заустављен, поново се покреће.

КодЗначење (Linux .run)
0Готово
1Одбијено: сервер, прекидач или план. Ништа није промењено
2Инсталација није успела, промене су поништене
3Поништавање није потпуно: резултат наводи шта проверити
4Потребан је одговор: нема терминала ни --yes
5Комплет није прошао проверу: преузмите га поново
6Нема библиотека ОС-а ни репозиторијума
7Firebird из дистрибуцијских пакета
КодЗначење (Windows setup.exe)
0Инсталирано
1Одбијено пре инсталације: погрешан прекидач или датотека, инсталирана је новија верзија, нема администраторских права
4Инсталатер је имао питање, али нема прекидача /YES
7Провера сервера или инсталација није успела. Разлог је у дневнику и у датотеци резултата
10Инсталирано, али веза са HQCenter није успела
План у чаробњаку. „Пронађено на овом рачунару“ и „Инсталација ће урадити следеће“. На дну: ништа се не мења док не кликнете на Инсталирај.
Резултат. Шта је инсталирано, адреса конзоле са овог рачунара и са другог, где је лозинка за пријаву. Преузето из ране верзије: тамо називи сервиса агента и фасцикли користе порт (-p3050); нове инсталације добијају -fb50.

FBDataGuard → fbagent

Прелазак са HQbird 2024

Инсталатер проналази стари HQbird и Firebird који он опслужује. Овај Firebird се ажурира на месту, послови FBDataGuard прелазе на агента, стари сервиси се заустављају. Базе података, конфигурације и лозинке остају.

Прелазак са HQbird 2024: послови FBDataGuard прелазе на агента HQbird 2027, Firebird се ажурира на месту, стари сервиси HQbird се онемогућавају
  • Шта се не мења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 експлицитно поставља слот.
Две инстанце једне линије. План види оба Firebird сервера и оба агента и мења само изабрану инстанцу.

Слике · compose · портови

HQbird у Docker-у

Постоји готова слика за сваку Firebird линију. Firebird, агент и HQbird Monitor раде у контејнеру. Агент инсталира чвор кластера унутар самог контејнера када се сервер придружи кластеру. RCM инсталира само када је овај сервер одређен као RCM кластера.

СликаFirebirdПорт Firebird-аHQbird Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050
  • Прво покретањеКопирајте 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.

Самоажурирање агента

Самоажурирање агента: провере, тачка враћања, замена, спремност у року од 180 s, 45 s рада; у случају неуспеха: враћање, пауза од 30 min, верзија блокирана након другог неуспеха
  • Само напредАгент не инсталира верзију старију од своје, чак ни обавезну. Провера се извршава пре него што се преузме иједан бајт. На тај начин лажни сервер не може да врати стару рањиву верзију. Изузетак је једна стара верзија дозвољена у сопственој конфигурацији агента (allow_downgrade_to).
  • ПотписИздања су потписана Ed25519 кључем; јавни кључ је уграђен у агента. Погрешан потпис се увек одбија. Режим „само потписано“ укључује се у сопственој конфигурацији агента, а не са сервера.
  • Ручно враћањеПоред агента постоји скрипта rollback_to_version_NNN: она враћа претходни агент и конфигурацију и блокира неисправну верзију. Чувају се две најновије тачке враћања; старије се аутоматски бришу.
  • Linux: root покреће само сопствену копијуАгент ради као firebird. Замену обавља проверена копија у фасцикли у коју само root може да пише.

Ажурирање Firebird

Firebird се ажурира само у оквиру своје линије и само на новију верзију. Агент може да преузме и припреми пакет у било ком тренутку, али зауставља Firebird само у прозору за ажурирање.

  1. 1Припремапреузимање, потпис, верзија није старија од мотора
  2. 2Прозордневни прозор; обавезно издање такође чека прозор
  3. 3Пословиgbak, nbackup или SQL скрипта се извршава: покушај се одлаже
  4. 4Заменастаре датотеке мотора се издвајају, конфигурације остају
  5. 5ПровераFirebird се покреће и одговара на свом порту
  6. 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 не поново укључује старе услуге: администратор то одлучује помоћу датотеке стања.
Linux, деинсталација једне инстанце (Firebird и базе података остају):
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

← Назад на преглед HQbird 2027 · Здравље сервера →