HQbird 2027 per Linux: guida all'installazione
Questa guida è per l’amministratore che installa HQbird 2027 su un server Linux con l’installer offline hqbird2027-fbNN-linux-<version>.run. Copre una nuova installazione, l’aggiornamento di un HQbird precedente e di una versione precedente di HQbird 2027, i comandi di manutenzione, la connessione al vostro HQCenter, l’installazione non presidiata (scriptata) e dove si trovano i file dopo l’installazione.
Gli esempi mostrano l’installer per Firebird 5.0 su Ubuntu 24.04. Gli installer per Firebird 2.5, 3.0 e 4.0 funzionano allo stesso modo; cambiano solo la versione, la porta predefinita e i nomi delle cartelle. L’installazione su Windows è descritta in Windows installation.
Contenuti
- 1. Cosa installa l’installer
- 2. L’installazione in breve
- 3. Nuova installazione
- 4. Dopo l’installazione
- 5. Aggiornamento di un HQbird più vecchio (2024 e precedenti)
- 6. Aggiornamento di HQbird 2027 a una nuova versione
- 7. Comandi di manutenzione
- 8. Collegamento al tuo HQCenter
- 9. Installazione non presidiata e script
- 10. Risoluzione dei problemi
1. Cosa installa l’installer
Un file .run = una linea di Firebird. Scegliete l’installer della versione di Firebird usata dai vostri database:
| Installer | Firebird che installa o aggiorna | Primo Firebird sull’host | Dimensione |
|---|---|---|---|
hqbird2027-fb50-linux-<version>.run |
Firebird 5.0 (build HQbird) | /opt/firebird, porta 3050 |
circa 250 MB |
hqbird2027-fb40-linux-<version>.run |
Firebird 4.0 (build HQbird) | /opt/firebird, porta 3050 |
circa 220 MB |
hqbird2027-fb30-linux-<version>.run |
Firebird 3.0 (build HQbird) | /opt/firebird, porta 3050 |
circa 130 MB |
hqbird2027-fb25-linux-<version>.run |
Firebird 2.5 (build HQbird) | /opt/firebird, porta 3050 |
circa 80 MB |
Ogni installer contiene e installa senza Internet:
- Firebird (la build HQbird di quella linea): un nuovo server, oppure un aggiornamento in-place del Firebird di quella linea già presente sull’host. Il vostro
firebird.conf,databases.conf(aliases.confper 2.5), il database di sicurezza e la password SYSDBA vengono conservati. - File di debug di Firebird (simboli per l’analisi dei crash), installati nella cartella di Firebird.
--no-debugli salta. - HQbird agent (
fbagent): l’unità systemdhqbirdfbagent-fb50, in esecuzione come utentefirebird, che esegue i backup, il monitoraggio, i job di manutenzione e gli aggiornamenti. Il nome termina con la linea di Firebird (-fb25…-fb50); una seconda istanza della linea ha-fb50-2. - HQ Monitor: la console web di questa istanza HQbird, unità
hqbirdmonitor-fb50, indirizzohttp://<server>:<20000 + Firebird port>/(per Firebird sulla porta 3050:http://localhost:23050/). - Componenti cluster: la console cluster RCM (
hqbirdrcm) e il nodo cluster (hqclusternode) vengono copiati nella cache dell’agent. I kit con agent (fbagent) 3.1.0 e successivi non creano alcun cluster per impostazione predefinita: nessun RCM, nessuna finestra di pairing, nessuna porta cluster nel firewall. Due domande (oppure--rcm on,--cluster-pairing on) li attivano (“Next: cluster” nella sezione 3). Con RCM, viene installato in/opt/hqbirdrcme gira come unitàhqbirdrcm; il riepilogo ne stampa l’indirizzo nella rigaRCM:. Il nodo riceve la sua unità (ad esempiohqclusternode-master-p3050) quando collegate l’host in RCM. I kit dalla 2027.2.19 con un agent precedente installano RCM su ogni server (--rcm offlo lascia nella cache) e aprono la finestra di pairing. I kit precedenti alla 2027.2.19 copiano solo entrambi i componenti nella cache dell’agent: non c’è alcuna unitàhqbirdrcme nessuna rigaRCM:.
Le istanze installate prima della 2027.2.9 hanno la porta di Firebird nei nomi dell’agent: cartella /opt/hqbird/fbagent-p3050, unità hqbirdfbagent-p3050 e hqbirdmonitor-p3050. Un aggiornamento non cambia questi nomi. Solo le nuove istanze ricevono i nomi -fb<NN>, quindi un host può avere entrambe le forme.
Requisiti: x86_64, kernel 3.2 o successivo, systemd; un Linux con apt, dnf/yum o zypper (Ubuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS e altri); root. Circa 300 MB liberi in /var/tmp durante l’installazione (una cartella in cui i programmi possono essere eseguiti; vedere --tmpdir). Alcune librerie del sistema operativo (libtommath, ICU) vengono prese dal repository della distribuzione; un server senza Internet riceve i comandi esatti per prepararle (sezione 9).
Non supportato: un Firebird installato dai pacchetti della distribuzione (firebird3.0-server, rpm firebird). L’installer si ferma prima di modificare qualsiasi cosa (codice di uscita 7); rimuovete prima i pacchetti (conservate un backup gbak dei vostri database) oppure usate l’installer online con --import-firebird.
Più linee di Firebird su un server: ogni linea ha il proprio installer. Il primo Firebird sull’host va in /opt/firebird; una seconda linea va in /opt/fb<NN> (/opt/fb50, /opt/fb40, /opt/fb30) sulla porta della sua linea: 3053 per 3.0, 3054 per 4.0, 3055 per 5.0. Quando quella porta è in uso, l’installer si ferma e chiede --port N. Più istanze di una stessa linea (un secondo Firebird 5.0 su un’altra porta) si installano con --fb-root <new folder> --port <port> (sezione 7). Firebird 2.5 ha una sola istanza, in /opt/firebird; per un secondo server accanto ad esso usate un’altra linea (ad esempio Firebird 5.0 in /opt/fb50).
Un runbook passo passo per due istanze sulle porte 3050 e 3051, per ogni linea, con comandi da copiare e incollare, è in hqbird2027-linux-two-instances-runbook.ru.md (russo) e hqbird2027-linux-two-instances-runbook.pt.md (portoghese).
Prova: senza licenza l’agent esegue una prova di 7 giorni. L’email di prova (--email) la estende a 30 giorni. Un file di licenza (--license) o la connessione al vostro HQCenter (sezione 8) sostituisce la prova.
Aggiornamenti: dal kit 2027.2.31 (agent 3.3.0) un server non collegato ad alcun HQCenter controlla il server di aggiornamento del fornitore. Per impostazione predefinita l’agent, HQ Monitor e fbmcp si aggiornano da soli, e un nuovo pacchetto Firebird viene scaricato e attende voi. --auto-update all|agent|off o la riga Updates dell’interfaccia testuale modificano questo comportamento (“Updates without HQCenter” nella sezione 4). Un server collegato a un HQCenter riceve gli aggiornamenti da quel HQCenter.
2. L’installazione in breve
Il controllo del server e l’installazione stessa sono eseguiti dall’HQbird agent che l’installer trasporta (fbagent --install-plan, fbagent --setup-install). Nulla viene scaricato tranne i pacchetti OS mancanti. Nulla viene modificato prima della conferma del piano: i pacchetti OS vengono installati dopo la conferma. In un terminale, i kit successivi alla 2027.2.30 aprono l’interfaccia testuale (passo 3 della sezione 3); --no-tui esegue l’installer semplice, che pone le sue domande come righe di testo. Senza terminale e senza --yes l’installer si ferma alla conferma con codice di uscita 4. Se l’installazione fallisce prima che parta l’unità dell’agent, l’agent riporta le unità allo stato che avevano prima (codice di uscita 2; codice 3 quando il rollback non è stato completo, il riepilogo indica cosa controllare).
3. Nuova installazione
Passo 1: Scaricare l’installer e verificarlo
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.sha256Le altre linee hanno gli stessi nomi con fb40, fb30, fb25. Atteso: hqbird2027-fb50-linux-2027.2.9.run: OK. Un server senza Internet: scaricate i due file su un PC con gli stessi link e copiateli sul server (scp, una chiavetta USB, una condivisione).
L’installer verifica anche il proprio payload prima di estrarre qualsiasi cosa: un download interrotto o danneggiato si ferma con codice di uscita 5 (“scaricatelo di nuovo”).
Passo 2: Controllare l’host senza modificarlo (facoltativo)
sudo sh hqbird2027-fb50-linux-2027.2.9.run --check--check esegue il controllo dell’host, segnala le librerie OS mancanti (e i comandi per ottenerle su un server senza Internet), mostra cosa ha trovato l’agent e cosa farebbe, quindi esce. Nulla viene installato.
Passo 3: Eseguire l’installer
sudo sh hqbird2027-fb50-linux-2027.2.9.runI kit successivi alla 2027.2.30 aprono l’interfaccia testuale quando li avviate in un terminale: pagine a schermo intero con il piano e le impostazioni. I kit fino alla 2027.2.30, e i casi in “L’installer semplice” qui sotto, pongono le loro domande come righe di testo. Entrambi eseguono la stessa installazione con le stesse opzioni.
L’interfaccia testuale
L’installer controlla l’host, si estrae, legge il piano e mostra la prima pagina. Nulla sull’host viene modificato finché non avviate l’installazione nella pagina 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: quitLe righe in alto sono il piano per le impostazioni attuali: il suo codice e cosa farà l’installer con Firebird e l’agent. Un piano non possibile è rosso, con il motivo, e il cursore si trova sull’impostazione che lo risolve. Dopo ogni modifica l’installer rilegge il piano.
| Tasto | Cosa fa |
|---|---|
| Su, Giù | Sposta il cursore (anche k, j) |
| Invio | Apre l’impostazione sotto il cursore, seleziona una voce, accetta un valore digitato |
| Spazio | Attiva o disattiva un componente (la pagina Components) |
| Esc | Torna alla pagina precedente; sulla prima pagina: esce dall’installer (chiede prima) |
| Ctrl+C | Ferma subito l’installer (codice di uscita 2). Nulla è stato modificato prima della pagina Install |
Su una pagina in cui digitate un valore (una cartella, una porta, un indirizzo), Invio lo accetta e un valore vuoto significa “automatico”. Esc non lascia una tale pagina.
| Impostazione | Cosa scegliete | Equivale all’opzione |
|---|---|---|
| Language | Inglese, russo, portoghese brasiliano, tedesco; le pagine cambiano subito | --lang |
| Firebird folder | La cartella di un nuovo Firebird, o del Firebird da aggiornare. Firebird 2.5 ha una sola cartella, quindi il suo installer non ha questa riga | --fb-root |
| Firebird port | La porta TCP di Firebird | --port |
| Agent id | Automatico, il nome dell’host, il nome dell’host e l’istanza, oppure un vostro valore. Solo per un nuovo agent: un agent installato mantiene il suo id, e la riga non viene mostrata | --agent-id |
| SYSDBA password | Per un nuovo Firebird: generata, o la vostra | --sysdba-pass-file |
| HQ Monitor | La porta e l’accesso della console web | --hqmonitor-port, --hqmonitor-login, --hqmonitor-password-file |
| License | Non ora, una prova di 30 giorni via e-mail (indirizzo, informativa sulla privacy, zona), oppure un file di licenza | --email --accept-privacy --trial-zone, --license |
| HQCenter | Il file attach.json del vostro HQCenter |
--attach |
| Cluster | Il gestore cluster RCM (id cluster, password admin), modalità discovery, la porta di pairing | --rcm, --cluster-id, --rcm-password-file, --cluster-pairing, --pairing-port |
| Components | File di debug di Firebird; fbmcp e gli indirizzi della sua modalità remota | --no-debug, --no-fbmcp, --fbmcp-allow-from |
| Aggiornamenti | Solo HQbird (l’agente, HQ Monitor e fbmcp si aggiornano da soli, un nuovo Firebird attende te), HQbird e Firebird (anche Firebird si aggiorna da solo, di notte dalle 03:30 alle 04:00, con un riavvio di Firebird), oppure Off. Kit da 2027.2.31; solo per un nuovo agente senza file attach.json: un HQCenter controlla gli aggiornamenti di un agente collegato | --auto-update |
Le opzioni sulla riga di comando sono i valori con cui le pagine si aprono:
sudo sh hqbird2027-fb50-linux-<ver>.run --rcm on --port 3055 apre la
prima pagina con RCM attivo e porta 3055.
Le quattro righe sotto le impostazioni:
- Install mostra il piano per intero, poi chiede
Start the install now?con il cursore su No. Le domande del piano (un vecchio HQbird, un Firebird in esecuzione da fermare) sono sulla stessa pagina: Yes risponde a tutte. Dopo Yes le pagine si chiudono e l’installazione stampa il suo log e il riepilogo sullo schermo normale, come nell’installer semplice qui sotto. - Plan details mostra cosa significa il codice del piano, cosa ha trovato l’installer sull’host, gli avvisi e i pacchetti OS che installerà.
- About plans elenca tutti i codici (M1 … M17). Invio su un codice lo
spiega. Un
*contrassegna il codice del piano attuale. - Quit esce dall’installer (codice di uscita 1). Nulla è stato modificato.
L’installer semplice
L’installer semplice viene eseguito quando è vera una di queste condizioni:
- l’opzione
--no-tui, o la variabileHQBIRD_NO_TUI=1; --yes,--check,--uninstall,--extract,--plan-help,--help;- stdin o stdout non è un terminale: uno script,
ssh host 'command'senza un terminale, o una pipe come... 2>&1 | tee install.log; TERMèdumbo non impostata;- la finestra è più piccola di 80 colonne per 24 righe (dentro
tmuxcon la sua riga di stato un terminale 80x24 ha 23 righe: ingrandisci la finestra, oppure usa--no-tui); - bash sull’host è precedente alla 4.4 (RHEL 7, CentOS 7);
- il kit è 2027.2.30 o precedente.
Per la finestra e per bash, la prima riga dell’output dice perché le pagine non si sono aperte.
Una tipica esecuzione dell’installer semplice su un server senza 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 --uninstallQuesto esempio è del kit 2027.2.9. Dal kit 2027.2.19 il riepilogo contiene
anche le righe RCM: e Pairing: della console del cluster (“Next: cluster”
qui sotto). Con l’agente 3.1.0 e successivi e nessun cluster scelto, sono:
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)Cosa significano le righe:
- host: la distribuzione e il kernel; l’installer rifiuta un host che non sia x86_64, che non abbia systemd, o che esegua un kernel precedente alla 3.2.
- OS libraries: ciò di cui il Firebird di questa linea ha bisogno dal
sistema operativo (sezione 9). Il piano elenca i pacchetti mancanti (
OS packages to install); dopo la conferma l’installer li preleva dal repository della distribuzione. Senza un repository si ferma con codice di uscita 6 e stampa i comandi. - plan: cosa ha trovato l’agente (righe
found Firebird ...,HQbird: ...) e cosa farà:Firebird new(un nuovo server),update(il Firebird di questa linea viene aggiornato sul posto), oppure un rifiuto con il motivo (codice di uscita 1, nulla modificato). - Install as planned? Yes/No: l’ultima domanda prima che qualsiasi cosa
venga modificata. Rispondi
y. Quando il piano ha domande proprie (un vecchio HQbird, un’altra versione), arrivano invece quelle (sezione 5). Senza un terminale, passa--yes; altrimenti l’installer si ferma con codice di uscita 4. - Cluster questions (agente 3.1.0 e successivi):
Install the cluster manager (RCM) on this host and make a new cluster? [y/N]eTurn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N]. Il valore predefinito è No. La prima viene chiesta solo quando l’host non ha un RCM e l’agente non è in nessun cluster; la seconda no, quando l’agente è in un cluster o esegue l’RCM.--yese un’esecuzione senza terminale rispondono No (nessun codice di uscita 4). - HQ Monitor: l’indirizzo e il login. Una nuova installazione riceve il
login
admin; la sua password generata è in/opt/hqbird/conf/access.properties(permessi 0600, leggibile solo daroote dall’agente). Tutte le istanze HQbird 2027 dell’host condividono questo file. Cambia la password in HQ Monitor.
La password SYSDBA di un nuovo Firebird viene generata e salvata in
/root/fbagent-install-sysdba.txt (permessi 0600): una riga di commento, poi
la riga SYSDBA_PASS=<password>. Un ulteriore Firebird installato in seguito
sullo stesso host riceve la stessa password da questo file. Per impostarne
una tua, passa --sysdba-pass-file <file> (prima riga del file) o
--sysdba-pass <password>.
Lingua dell’installer
I kit successivi alla 2027.2.30 parlano quattro lingue: inglese, russo
(ru), portoghese brasiliano (pt-BR) e tedesco (de). L’installer sceglie
la lingua in questo ordine:
- l’opzione
--lang en|ru|pt-BR|de; - la variabile
HQBIRD_LANG; - la locale della console (
LC_ALL, poiLC_MESSAGES, poiLANG), quando è una locale UTF-8; - l’inglese.
La seconda riga dell’output dice quale lingua è e come cambiarla. Questa riga è sempre in inglese:
[install] Language: Русский (auto). Use --lang en to change.Note:
- PuTTY non invia
LANGal server. Conta la locale del server stesso, quindi spesso la lingua è l’inglese. Usa--lang. - Con
--yes, e senza un terminale, la lingua automatica è l’inglese: gli script leggono quell’output.--langfunziona comunque anche lì. - L’installer necessita di una locale UTF-8 sull’host per le altre lingue
(
C.UTF-8oen_US.UTF-8). Ne imposta una per sé. Senza, parla inglese. - Nell’interfaccia testuale la riga Language della prima pagina cambia la lingua immediatamente. Il terminale deve mostrare UTF-8 (PuTTY: Window, Translation, Remote character set UTF-8, che è il suo valore predefinito).
- Restano in inglese: le righe di avanzamento dell’installazione stessa, il
riepilogo
Done:,/var/log/fbagent/install.loge gli avvisi della scansione dell’host.
Il codice del piano
Il piano ha un codice: M1, M2, … Indica il caso che l’installer ha
trovato sull’host. L’installer stampa cosa significa il codice:
[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 stampa tutti i codici ed esce. Non modifica nulla.
Nell’interfaccia testuale la prima pagina mostra il codice e il suo titolo,
“Plan details” mostra il testo e “About plans” elenca tutti i codici.
| Codice | Cosa ha trovato l’installer | Firebird | Agente | Vecchio HQbird |
|---|---|---|---|---|
| M1 | nulla | nuovo | nuovo | — |
| M2 | Firebird di questa linea, nessun vecchio HQbird | aggiornamento | nuovo | — |
| M3 | Firebird di un’altra linea, nessun vecchio HQbird | nuovo, porta 305N | nuovo | — |
| M4 | vecchio HQbird che serve il Firebird di questa linea | aggiornamento | nuovo | disattivato, i suoi job importati come abilitati |
| M5 | vecchio HQbird di un’altra linea; c’è un Firebird di questa linea | aggiornamento, dopo una domanda | nuovo | continua a funzionare |
| M6 | vecchio HQbird di un’altra linea; nessun Firebird di questa linea | nuovo, dopo una domanda | nuovo | continua a funzionare |
| M7 | vecchio HQbird senza un Firebird locale di una versione nota | aggiornamento o nuovo | nuovo | continua a funzionare, un avviso |
| M8 | un agente HQbird 2027 per un altro Firebird | aggiornamento o nuovo | nuovo, accanto al primo | non modificato |
| M9 | come M8, e un vecchio HQbird serve questa linea | aggiornamento | nuovo, accanto al primo | disattivato, i suoi job importati come abilitati |
| M10 | un agente serve già questo Firebird (un’esecuzione ripetuta) | aggiornamento | sul posto | disattivato quando è in esecuzione |
| M11 | --fb-root è un Firebird di questa linea |
aggiornamento | nuovo o sul posto | come sopra |
| M13 | --fb-root è una cartella vuota o nuova |
nuovo in quella cartella | nuovo | come sopra |
Codici di un rifiuto (codice di uscita 1, nulla modificato): M12 la
cartella contiene un Firebird che l’installer non può aggiornare (un’altra
linea, una versione che non riesce a leggere, un servizio disabilitato);
M14 la cartella non è vuota e non contiene un Firebird; M16 diversi
server Firebird di questa linea, fornisci --fb-root; M17 Firebird 2.5
funziona solo in /opt/firebird. M15 è il kit solo agente: Firebird non
viene installato né aggiornato.
L’id dell’agente
L’id dell’agente identifica l’agente in HQCenter, nella licenza e nel cluster. Viene impostato solo alla prima installazione:
- Predefinito: nome host + data + istanza, per esempio
srv1261114-fb50. --agent-id IDfornisce un tuo id (1-128 lettere, cifre,.,_o-; il primo carattere una lettera o una cifra).- L’installer rifiuta un id che un altro agente dell’host possiede.
- Nell’interfaccia testuale la pagina Agent id offre l’id automatico, il nome host, il nome host con l’istanza e un tuo valore, ed elenca gli id che l’host possiede già.
- Un agente installato mantiene il suo id. Un’esecuzione ripetuta lo mostra
nel piano (
id srv1 (kept)), l’interfaccia testuale non ha allora alcuna riga Agent id, e--agent-idlì produce solo un avviso. Un nuovo agente in una cartella che una precedente installazione ha lasciato con la sua configurazione mantiene anch’esso l’id di quella configurazione.
Passo 4: Verifica il risultato
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.fdbUsa il percorso completo del database di esempio: funziona per ogni linea e
anche dopo un aggiornamento, mentre il databases.conf conservato di una
vecchia installazione potrebbe non avere l’alias employee (una nuova
installazione della 2027.2.3 ce l’ha).
Apri http://<server>:23050/ in un browser e accedi come admin con la
password da /opt/hqbird/conf/access.properties. La porta Firebird e la
porta HQ Monitor vengono aperte in firewalld (zona public) quando è in
esecuzione, altrimenti in ufw quando è attivo; con un altro firewall
aprile tu stesso. Le porte del cluster vengono aperte solo per un’opzione di
cluster: 7443, 7444 e la porta del nodo con --rcm on; la porta del nodo e
la porta di pairing con --cluster-pairing on. Senza un firewall attivo
l’installer stampa una riga con le porte che non ha aperto. Una porta che era
aperta prima dell’installazione viene lasciata com’è.
Poi: cluster
Per replicare i tuoi database da un server master a un server replica, collega
i due server nella console del cluster RCM. Con l’agente 3.1.0 e successivi,
installa RCM solo sul master (--rcm on, oppure rispondi y) e attiva la
modalità discovery sulla replica (--cluster-pairing on). La modalità
discovery apre la finestra di pairing per 24 ore: la porta di pairing dello
slot dell’agente (7450 per la prima istanza, 7451 per la seconda, fino a
7459) è aperta nel firewall, e l’RCM può invitare l’agente. Un host ha un solo
RCM (porte 7443 e 7444); l’agente che l’ha creato lo esegue e non apre alcuna
finestra di pairing.
Successivamente, senza l’installer: HQ Monitor → Clusters → Cluster on this
server, oppure fbagent --cluster-init <id> e fbagent --cluster-pairing on. I kit dalla 2027.2.19 con un agente più vecchio avviano RCM su ogni server e
ne stampano l’indirizzo nella riga RCM: del riepilogo; un’installazione precedente
alla 2027.2.19 ottiene RCM quando la si aggiorna con un kit più recente (sezione 6). La
guida al cluster (per il kit 2027.2.33) procede passo
per passo da due nuovi server a una replica funzionante, con screenshot:
Linux cluster guide
(anche in Russian e
Portuguese). Gli stessi passaggi come
soli comandi:
hqbird2027-linux-cluster-runbook.md
(hqbird2027-linux-cluster-runbook.ru.md,
hqbird2027-linux-cluster-runbook.pt.md).
4. Dopo l’installazione
Unit
| Unit | Cosa | Eseguito come |
|---|---|---|
firebird (2.5, 4.0, 5.0 in /opt/firebird); firebird-superserver (3.0 in /opt/firebird); per un’altra cartella il nome della cartella con / → _: firebird.opt_fb50, firebird.opt_fb40-2 (4.0, 5.0 in /opt/fb50, /opt/fb40-2), firebird.opt_fb30-superserver (3.0 in /opt/fb30) |
Server Firebird | firebird |
hqbirdfbagent-fb50 (seconda istanza hqbirdfbagent-fb50-2; prima della 2027.2.9 hqbirdfbagent-p<porta Firebird>) |
Agente HQbird | firebird |
hqbirdmonitor-fb50 (hqbirdmonitor-fb50-2; prima della 2027.2.9 hqbirdmonitor-p<porta Firebird>) |
HQ Monitor | firebird |
Tutte e tre sono abilitate e si avviano al boot. journalctl -u hqbirdfbagent-fb50
mostra il log dell’unit dell’agente. Firebird 3.0 ha anche le unit
firebird-classic.socket e [email protected]
(firebird.opt_fb30-classic.* in un’altra cartella), e Firebird 2.5 ha
firebird.socket: restano inactive, è normale. Il processo di Firebird 2.5
è fb_smp_server (SuperClassic).
Dove sono i file
L’esempio è la prima istanza di Firebird 5.0 in /opt/firebird sulla porta
3050. Una seconda istanza della linea ha -2 nei nomi dell’agente
(fbagent-fb50-2, hqbirdfbagent-fb50-2, hqbirdmonitor-fb50-2).
Le istanze installate prima della 2027.2.9 hanno la porta in questi nomi
(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)L’installer non conserva nulla in /var/tmp: la sua cartella di lavoro
/var/tmp/hqbird2027.XXXXXX viene rimossa alla fine, anche dopo un errore.
Log
| Log | Dove |
|---|---|
| Installer | il terminale; /var/log/fbagent/install.log |
| Agente | /opt/hqbird/fbagent-fb50/logs/firebird-agent_<date>.jsonl, journal.log; journalctl -u hqbirdfbagent-fb50 |
| HQ Monitor | journalctl -u hqbirdmonitor-fb50; log di audit /opt/hqbird/fbagent-fb50/hqmonitor_audit.log |
| Firebird | /opt/firebird/firebird.log |
Aggiornamenti senza HQCenter
Dal kit 2027.2.31 (agente 3.3.0) un agente che non è collegato ad alcun HQCenter
preleva le nuove versioni dal server di aggiornamento del fornitore. La modalità di aggiornamento è la
chiave update.mode di agent_config.json:
| Modalità | Cosa si aggiorna da solo |
|---|---|
agent (predefinita) |
L’agente, HQ Monitor e fbmcp. Un nuovo pacchetto Firebird viene scaricato e attende l’amministratore |
all |
Lo stesso, e anche Firebird, nella sua finestra di applicazione (di notte dalle 03:30 alle 04:00; l’aggiornamento riavvia Firebird) |
off |
Nulla: l’agente non effettua controlli di aggiornamento. Per aggiornare, eseguire l’installer di una nuova versione (sezione 6) |
- All’installazione: la riga Updates dell’interfaccia testuale, oppure
--auto-update all|agent|off. Senza di esse l’installer non modifica la modalità. - Successivamente: la pagina Updates di HQ Monitor, oppure di nuovo l’installer con
--auto-update <mode>. - Lo stato:
sudo /opt/hqbird/fbagent-fb50/fbagent --update-status(aggiungere--jsonper uno script). Stampa la fonte della release, la zona e l’ultima risposta del server di aggiornamento.
L’agente apre connessioni HTTPS in uscita solo verso questi indirizzi. Non è necessaria alcuna porta in ingresso.
| Scopo | Indirizzo |
|---|---|
| Aggiornamenti, zona EU | liceu.ibsurgeon.com:9443 |
| Aggiornamenti, zona BR | licbr.ibsurgeon.com:9443 |
| Aggiornamenti, zona RU | licru.ibsurgeon.com:20943 |
| Licenza di prova | trialeu.ibsurgeon.com:9443, trialbr.ibsurgeon.com:19443, trialru.ibsurgeon.com:23943 |
Un server collegato a un HQCenter non usa gli indirizzi di aggiornamento: preleva i suoi aggiornamenti da quel HQCenter (sezione 8).
Notifiche
Dal kit 2027.2.33 (agente 3.4.0) l’agente invia messaggi sui problemi del server
a un bot Telegram proprio, a un webhook o via e-mail (SMTP). L'
installer non imposta alcun canale, e nulla viene inviato finché non ne aggiungi uno: HQ
Monitor → Servers → Notifications. Per testare un canale dalla
riga di comando: sudo -u firebird /opt/hqbird/fbagent-fb50/fbagent --notify-test <channel>; --notify-history stampa le ultime consegne.
5. Aggiornamento di un HQbird più vecchio (2024 e precedenti)
L’installer trova un HQbird (FBDataGuard) installato in /opt/hqbird e
le sue unit, e i server Firebird che gestisce. Segue poi le stesse
regole degli script di installazione di HQbird:
Cosa vedi sul terminale:
[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- Il piano indica il Firebird che viene aggiornato;
--fb-roote--portnon possono spostarlo (la sua unit è presa). - La domanda Confirm to stop running Firebird? viene posta quando
il motore deve essere fermato; la riga precedente mostra le connessioni aperte.
Another versionviene chiesto quando il vecchio HQbird gestisce un Firebird di un’altra versione (aggiorna quello, oppure uno nuovo accanto ad esso).--yesrisponde Sì a tutte le domande; senza un terminale e senza--yesl’installer si ferma con codice di uscita 4 e non cambia nulla. --disable-hqbirddisattiva le unit del vecchio HQbird in ogni caso;--no-hqbirdlascia in pace il vecchio HQbird (continua a funzionare accanto a HQbird 2027).- La password SYSDBA non viene chiesta: l’agente la prende dal vecchio HQbird.
- HQ Monitor usa le credenziali del vecchio HQbird: il suo file
/opt/hqbird/conf/access.propertiesviene conservato, quindi accedi con il login e la password che usavi prima. L’installer assegna il file afirebirdcon modalità 0600 (il vecchio HQbird lo lasciava leggibile da ogni utente). Il login guest del vecchio HQbird (access.guest-login) non è usato da HQ Monitor.
Cosa viene conservato: firebird.conf, databases.conf / aliases.conf, il
database di sicurezza, la password SYSDBA, i database, i backup e i
file del vecchio HQbird. L’aggiornamento sostituisce i file di programma di Firebird
sul posto; i file sostituiti sono conservati in
/opt/fbagent-update-backup/<folder name>-<id>/<time>_<old version>_to_<new version>/
(i due aggiornamenti più recenti restano). I job di HQbird (backup, sweep, monitoraggio)
vengono importati nel nuovo agente. La licenza HQbird del vecchio HQbird non
viene trasferita: il nuovo agente esegue la versione di prova finché non viene installata una licenza
o il server viene collegato al tuo HQCenter.
Dal kit 2027.2.33 (agente 3.4.0) l’importazione della configurazione del vecchio HQbird fa altre due cose:
- Registra i database del vecchio HQbird nel file degli alias di Firebird
(
databases.conf, oaliases.confper la 2.5) come righename = path. Il vecchio file viene prima copiato. Un database viene escluso quando il suo percorso è già nel file, o quando il suo file non esiste. Un file con una direttivaincludenon viene modificato. - Rimuove i vecchi log di monitoraggio del vecchio HQbird: il contenuto delle
cartelle
mon/outcomingemon/outtracedella sua cartella di output (le cartelle restano). Nulla viene rimosso mentre un servizio del vecchio HQbird è in esecuzione. La rimozione non può essere annullata: se hai bisogno di questi log, copiali prima dell’installazione.
Entrambe sono attive per impostazione predefinita. Le chiavi hqbird_import.register_databases e
hqbird_import.clean_mon_logs di agent_config.json (entrambe sono nell'
editor di configurazione di HQ Monitor) le disattivano per un’importazione successiva; l’installer
non ha alcuna opzione per esse.
Lo stato delle unit del vecchio HQbird prima della presa in carico è salvato in
/opt/hqbird/fbagent-hqbird-takeover.json. --uninstall non le
riattiva.
Forma non presidiata:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird6. Aggiornamento di HQbird 2027 a una nuova versione
Un installer più recente della stessa linea, eseguito su un host con HQbird 2027, aggiorna l’istanza installata sul posto: Firebird, i file di debug, l’agente e HQ Monitor. La configurazione, i database, lo stato di prova o licenza, la porta di HQ Monitor e le credenziali vengono conservati.
sudo sh hqbird2027-fb50-linux-2027.2.9.runNell’interfaccia testuale la prima pagina mostra Plan M10: Update of an installed HQbird 2027, l’agente con il suo id (kept), e nessuna riga Agent id; Install
avvia l’aggiornamento. L’installer semplice stampa:
[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).Un aggiornamento non cambia i nomi della cartella dell’agente e delle unità: l’istanza
in questo esempio è stata installata prima della 2027.2.9 e mantiene
fbagent-p3050.
Quando la build di Firebird dell’installer è quella già installata (per
esempio Firebird 2.5.9.27194 in ogni HQbird 2027 per la 2.5), vengono aggiornati solo l’agente
e HQ Monitor: Firebird non viene arrestato e non c’è la
domanda Confirm to stop.
Il databases.conf conservato di un’istanza installata da un HQbird 2027
precedente può non avere l’alias employee; connettersi al database di esempio tramite il suo percorso completo
(sezione 3, passo 4). Su Firebird 3.0 un aggiornamento dalla 2027.2.0 lascia
/opt/firebird/examples/empbuild/employee.fdb con permessi 0444, e Firebird
non riesce ad aprirlo (no permission for read-write access); se serve il
database di esempio: sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb.
I tuoi database non vengono toccati.
- Con più istanze della linea, indicare quella da aggiornare:
--fb-root /opt/fb50-2 --port 3056. - Lo stesso installer eseguito di nuovo sulla versione installata è una riparazione: i file del programma e le unità vengono riscritti, i dati restano.
- Dopo la connessione a un HQCenter (sezione 8) l’agente, HQ Monitor, Firebird e i componenti del cluster vengono aggiornati dal catalogo HQCenter; un nuovo installer non è più necessario.
- Un server non collegato ad alcun HQCenter con agente 3.3.0 o successivo (kit dalla
2027.2.31) aggiorna da solo l’agente, HQ Monitor e fbmcp, a meno che la
modalità di aggiornamento sia
off(“Updates without HQCenter” nella sezione 4). Un’installazione effettuata prima della 2027.2.31 ottiene questo dopo un aggiornamento con un installer più recente. Un aggiornamento con l’installer mantiene la modalità di aggiornamento;--auto-update <mode>la cambia.
7. Comandi di manutenzione
Ogni azione di manutenzione è un’esecuzione dell’installer con opzioni, oppure un
comando dell’agente nella cartella dell’agente. In un terminale un’esecuzione senza --yes apre
l’interfaccia testuale con queste opzioni già impostate (kit successivi alla 2027.2.30):
controllare il piano nella prima pagina, poi scegliere Install.
| Azione | Comando |
|---|---|
| Un’altra istanza di questa linea | sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50-2 --port 3056 |
| Riparazione / aggiornamento | sudo sh hqbird2027-fb50-linux-<ver>.run (con più istanze: --fb-root <folder> --port <port>) |
| Collegamento a HQCenter | sudo sh hqbird2027-fb50-linux-<ver>.run --attach attach.json durante l’installazione, oppure in seguito cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /path/attach.json |
| Invio dell’email di prova | cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email [email protected] --accept-privacy |
| Conferma del codice di prova dalla mail | cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-confirm <code> (oppure in HQ Monitor) |
| Installazione di un file di licenza | --license <file> durante l’installazione, oppure cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --license-install /path/license.json |
| Stato dell’installazione | sudo /opt/hqbird/fbagent-fb50/fbagent --install-state --json |
| Stato degli aggiornamenti (senza HQCenter) | sudo /opt/hqbird/fbagent-fb50/fbagent --update-status |
| Modifica della modalità di aggiornamento (senza HQCenter) | HQ Monitor, pagina Updates; oppure sudo sh hqbird2027-fb50-linux-<ver>.run --auto-update all|agent|off |
| Rimozione | sudo sh hqbird2027-fb50-linux-<ver>.run --uninstall [--remove-data] [--force] [--agent-dir /opt/hqbird/fbagent-fb50] |
Un’altra istanza
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056Il nuovo Firebird va in /opt/fb50-2 (una cartella nuova o vuota), unità
firebird.opt_fb50-2, con il proprio agente (/opt/hqbird/fbagent-fb50-2, unità
hqbirdfbagent-fb50-2) e il proprio HQ Monitor (http://localhost:23056/,
unità hqbirdmonitor-fb50-2). L’agente riceve il numero libero più basso della
linea: fb50-2 per la seconda istanza, anche accanto a un agente installato
prima della 2027.2.9 (fbagent-p3050). Il file di accesso di HQ Monitor
/opt/hqbird/conf/access.properties è condiviso dalle istanze dell’host:
una nuova istanza senza --hqmonitor-login mantiene l’accesso esistente, e
--hqmonitor-login/--hqmonitor-password-file su qualsiasi istanza cambiano l’accesso
di tutte (il vecchio file viene conservato come
access.properties.bak-<time>). Firebird 2.5 non supporta una seconda
istanza: l’installer si arresta con refused (M17): Firebird 2.5 works only in /opt/firebird, not in <folder> (codice di uscita 1, nulla modificato). Installare un
Firebird di un’altra linea accanto, per esempio
sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50 --port 3051.
Rimozione
La rimozione su Windows e Linux, i server in un cluster e ciò che rimane sul disco sono descritti in dettaglio nella guida alla rimozione. In breve:
# 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-dataSenza --agent-dir l’installer rimuove l’unico agente in
/opt/hqbird. Con più agenti sull’host si arresta (codice di uscita 1),
elenca le loro cartelle e richiede --agent-dir:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2--uninstall arresta e rimuove le unità dell’agente e del suo HQ Monitor
(hqbirdfbagent-fb50, hqbirdmonitor-fb50), le regole sudoers dell’agente e dei suoi programmi
(fbagent, hqmonitor), e chiude la porta di HQ Monitor che
l’installazione aveva aperto in firewalld o ufw. La cartella dell’agente resta con la configurazione e
i log; --remove-data rimuove anche la cartella e i dati di HQ Monitor in
/var/lib/hqmonitor/. Firebird resta installato (unità, cartella del programma,
database); le vecchie unità HQbird che erano state disattivate restano disattivate.
Con più agenti sull’host, il file di accesso condiviso di HQ Monitor resta
finché non viene rimosso l’ultimo agente.
Se l’agente esegue l’RCM dell’host e altri agenti usano quell’RCM,
--uninstall rifiuta con codice di uscita 5 e non cambia nulla:
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 rimuove
comunque l’agente; il cluster perde allora la sua CA (nessun nuovo certificato, nessun nuovo
membro). L’unità RCM resta finché altri agenti dell’host la usano. Per rendere
un altro agente il proprietario di un nuovo RCM quando il vecchio proprietario non c’è più:
fbagent --cluster-init <id> --rcm-takeover (una nuova CA: collegare di nuovo i membri).
Il suggerimento alla fine di un’installazione (Uninstall: sudo sh ... --uninstall)
non ha --agent-dir: con più istanze aggiungerlo come mostrato sopra.
Per rimuovere anche il Firebird di un’istanza (l’installer non lo fa;
eseguire prima backup gbak dei suoi database), per esempio il Firebird in
/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. Collegamento al tuo HQCenter
HQCenter è il server centrale della tua azienda che gestisce gli agenti HQbird: licenze, configurazione, aggiornamenti, panoramica dei backup. Senza un HQCenter l’agente lavora da solo con le versioni dell’installer e il file di prova o di licenza.
- Nel pannello di amministrazione di HQCenter aprire Tokens
(
https://<hqcenter>:8443/admin/tokens). Nel modulo Install script scegliere la licenza (o nessuna), la modalità, il numero di server e la validità (da 1 a 365 giorni); i campi piattaforma e Firebird non vengono usati. Fare clic su Download connection file e salvareattach.json. Il file contiene un token segreto: conservarlo al sicuro (chmod 600), eliminarlo dopo l’uso e revocare il token nell’elenco sulla stessa pagina. Il modulo viene mostrato solo quandoadmin_panel.install_script_urlè impostato. - Copiare
attach.jsonsul server. - Collegarsi in uno dei due modi:
# 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.jsonCon un token ordinario il comando attende che l’amministratore di HQCenter approvi la richiesta (fino a 30 minuti). Con un token di licenza l’agente viene collegato subito e riceve la licenza. Dopo il collegamento la prova termina quando HQCenter fornisce all’agente una licenza; l’agente, HQ Monitor, Firebird e i componenti del cluster vengono quindi aggiornati dal catalogo HQCenter. Un collegamento non riuscito durante l’installazione non annulla l’installazione: il riepilogo lo indica, e il comando sopra lo ripete.
Requisiti: HQCenter (goafts) 1.15.0 o successivo (le versioni precedenti non hanno il pulsante del file di connessione); il server raggiunge la porta bootstrap di HQCenter una volta per il collegamento e poi la porta degli agenti (443 per impostazione predefinita). HQCenter può essere senza Internet. Un secondo collegamento dello stesso server allo stesso HQCenter richiede l’approvazione dell’amministratore anche con un token di licenza.
9. Installazione non presidiata e script
Ogni opzione funziona anche sul terminale. Un’esecuzione non presidiata richiede --yes
(risponde alle domande del piano; senza un terminale e senza --yes
l’installer si arresta con codice di uscita 4). --yes non apre mai l’interfaccia
testuale. Uno script che avvia l’installer in un terminale e risponde da solo
alle sue domande (per esempio con expect) deve aggiungere --no-tui o impostare
HQBIRD_NO_TUI=1: i kit successivi alla 2027.2.30 aprono lì le pagine. Il codice di uscita indica il risultato; i
dettagli sono sul terminale e in /var/log/fbagent/install.log.
Opzioni
| Opzione | Significato | Predefinito |
|---|---|---|
--fb-root DIR |
Cartella del nuovo Firebird (nuova o vuota); oppure la cartella del Firebird da aggiornare | /opt/firebird, poi /opt/fb<NN> |
--port N |
Porta di Firebird | 3050 per il primo Firebird; per un’altra linea la porta della linea (3053 per 3.0, 3054 per 4.0, 3055 per 5.0) |
--sysdba-pass-file F, --sysdba-pass P |
Password SYSDBA di un nuovo Firebird (prima riga di F; P viene scritta in un file 0600) |
generata, salvata in /root/fbagent-install-sysdba.txt; un ulteriore Firebird sull’host prende la password da quel file |
--agent-id ID |
agent.id del nuovo agente; solo alla prima installazione, un agente installato mantiene il suo id (“The agent id” nella sezione 3) |
nome host + data + istanza |
--hqmonitor-port N |
Porta di HQ Monitor | 20000 + porta di Firebird |
--hqmonitor-login L --hqmonitor-password-file F |
Accesso a HQ Monitor, condiviso da tutte le istanze dell’host: specificato su un’istanza, cambia l’accesso di tutte | admin + password generata; un aggiornamento o un’ulteriore istanza mantiene l’accesso esistente |
--email ADDR --accept-privacy [--trial-zone RU|EU|BR] |
Email di prova (30 giorni); l’indirizzo viene inviato al server di prova del fornitore | nessuno |
--auto-update all|agent|off |
Aggiornamenti di un server non collegato ad alcun HQCenter (kit dalla 2027.2.31): agent = l’agente, HQ Monitor e fbmcp si aggiornano da soli, un pacchetto Firebird attende te; all = anche Firebird, nella sua finestra; off = nessun controllo degli aggiornamenti (“Updates without HQCenter” nella sezione 4) |
la modalità non viene cambiata; un nuovo agente ha agent |
| --license F | File di licenza da installare | nessuno |
| --attach F | Collega al tuo HQCenter (attach.json) | nessuno |
| --no-hqbird, --disable-hqbird | Lascia in pace il vecchio HQbird / disattiva tutte le sue unità | automatico |
| --no-debug | Non installare i file di debug di Firebird | installati |
| --no-fbmcp | Non installare fbmcp (il server MCP per i client AI) e non modificare il fbmcp di questo host | installato |
| --fbmcp-allow-from A,B | Attiva la modalità remota di fbmcp per questi indirizzi amministrativi (IP o CIDR) | solo locale |
| --fbmcp-port N, --fbmcp-dns NAME,..., --fbmcp-ip ADDR | La porta remota di fbmcp; nomi aggiuntivi per il suo certificato; l’indirizzo per il certificato e il listener | porta 8650 |
| --rcm on\|off | Installa la console cluster RCM su questo host e crea un nuovo cluster (agent 3.1.0 e successivi) | richiesto; No |
| --rcm-password-file F | Password admin RCM con --rcm on (prima riga di F) | generata, mostrata alla fine |
| --cluster-id ID | Id del cluster con --rcm on | il nome dell’host |
| --cluster-pairing on\|off | Modalità discovery: la finestra di pairing per 24 ore, un RCM può invitare questo agent | richiesto; No |
| --rcm-allow A,B,... | Solo questi RCM possono invitare questo host in modalità discovery (IP, CIDR o nome host) | qualsiasi RCM |
| --pairing-port N | Porta di pairing 7450–7459 di un nuovo agent; sceglie lo slot (porte dei nodi 7051+k, 7061+k). Un setup successivo mantiene lo slot | il primo slot libero |
| --cluster-node on\|off | Inserisce il servizio del nodo cluster nella cache dell’agent | on |
| --yes | Rispondi Sì alle domande del piano (No alle domande sul cluster) | chiedi |
| --check | Solo i controlli, le librerie e il piano; nulla viene modificato | — |
| --plan-help | Stampa il significato dei codici del piano (M1, M2, …) ed esce | — |
| --no-tui | L’installer semplice, senza l’interfaccia testuale; anche la variabile HQBIRD_NO_TUI=1 (“The plain installer” nella sezione 3) | l’interfaccia testuale in un terminale |
| --lang en\|ru\|pt-BR\|de | Lingua dell’installer; anche la variabile HQBIRD_LANG (“Language of the installer” nella sezione 3) | la locale UTF-8 della console, altrimenti inglese |
| --tmpdir DIR | Estrai qui (una cartella in cui i programmi possono essere eseguiti) | /var/tmp |
| --extract DIR | Estrai solo il payload in DIR/payload ed esci | — |
| --uninstall [--remove-data] [--force] [--agent-dir DIR] | Rimuove l’agent e HQ Monitor (Firebird resta); --force rimuove anche l’agent che esegue l’RCM dell’host mentre altri agent lo usano | — |
Le opzioni possono essere scritte come --port 3055 o --port=3055. I percorsi relativi
si contano dalla cartella corrente.
Esempi
Nuova installazione con i valori predefiniti:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes
echo "exit code $?"Nuova installazione in una cartella e porta scelte, con una password SYSDBA da un file e un accesso a 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.txtNuova installazione con l’email di prova, un file di licenza e il file di attach:
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.jsonAggiornamento di un vecchio HQbird, tutte le unità del vecchio HQbird disattivate:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbirdAggiornamento di HQbird 2027 a una nuova versione (una istanza; con più istanze, aggiungi
--fb-root e --port):
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yesUna seconda istanza di Firebird 5.0 sulla porta 3056:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056Rimozione:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataUno script che si ferma in caso di installazione fallita:
#!/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"Server senza Internet: librerie del sistema operativo
Il Firebird di una linea richiede queste librerie dal sistema operativo (oltre a glibc):
| Linea | Pacchetti (Debian/Ubuntu) | Pacchetti (famiglia 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 | di solito nulla (libstdc++6 è nel sistema base) |
di solito nulla |
I kit successivi alla 2027.2.30 delle linee 3.0, 4.0 e 5.0 richiedono anche il programma
colrm, che lo script di installazione di Firebird usa: pacchetto bsdextrautils
(bsdmainutils su Debian e Ubuntu più vecchi). Un Debian minimale non ne ha nessuno; la
famiglia RHEL lo ha in util-linux, che è sempre presente.
Quando un pacchetto manca e il repository non è raggiungibile, l’installer si ferma con codice di uscita 6 e nulla viene modificato:
[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 ./*.debSulla famiglia RHEL libtommath è in EPEL: con un repository raggiungibile
l’installer aggiunge epel-release da solo. Senza, i comandi sono dnf install -y epel-release, dnf download --resolve <packages> e dnf install -y ./*.rpm. --check stampa
la stessa lista in anticipo, così i pacchetti possono essere preparati prima della
finestra di installazione.
Codici di uscita
| Codice | Significato | Modifiche sull’host |
|---|---|---|
| 0 | Fatto (gli avvisi sull’email di prova, l’attach o la licenza sono nel riepilogo) | sì |
| 1 | Rifiutato: l’host, un’opzione, un file o il piano (il motivo è stampato). Anche: Esci nell’interfaccia testuale | nessuna |
| 2 | L’installazione è fallita ed è stata annullata. Anche: l’installer è stato fermato da un segnale (Ctrl+C) | annullata; nessuna se fermato prima dell’installazione |
| 3 | L’installazione è fallita e l’annullamento non è stato completo (il riepilogo dice cosa controllare) | parziale |
| 4 | Una domanda del piano non è stata confermata (nessun terminale, nessun --yes). |
nessuna |
| 5 | Il payload non ha superato il controllo (sha256, firme): scarica di nuovo il file. Con --uninstall: rifiutato, l’agent esegue l’RCM dell’host e altri agent lo usano (sezione 7) |
nessuna |
| 6 | Mancano librerie del sistema operativo e il repository dei pacchetti non è raggiungibile | nessuna |
| 7 | È installato un Firebird dai pacchetti della distribuzione | nessuna |
10. Risoluzione dei problemi
| Problema | Cosa fare |
|---|---|
run as root (sudo sh ...) |
Esegui l’installer con sudo o come root |
| Le pagine dell’interfaccia testuale non si aprono | La prima riga dice perché: needs a window of 80x24 or larger (ingrandisci la finestra; tmux con una riga di stato occupa una riga) oppure needs bash 4.4 or newer. L’installer semplice che viene eseguito allora fa la stessa installazione |
| Caratteri sbagliati o righe spezzate nelle pagine | Imposta il terminale su UTF-8, oppure esegui con --lang en; --no-tui esegue l’installer semplice |
/var/tmp is mounted noexec |
Esegui di nuovo con --tmpdir /root (qualsiasi cartella in cui i programmi possono essere eseguiti) |
is damaged or cut (codice di uscita 5) |
Copia di nuovo il file .run e confronta il suo sha256sum con il valore pubblicato |
| Codice di uscita 6, librerie mancanti | Prepara i pacchetti come stampato (sezione 9), poi esegui di nuovo l’installer |
| Codice di uscita 7, Firebird dai pacchetti della distro | Rimuovi i pacchetti (apt-get remove firebird3.0-server, conserva un backup gbak) oppure usa l’installer online con --import-firebird |
refused (M17): Firebird 2.5 works only in /opt/firebird |
Un secondo Firebird 2.5 non è possibile; installa un’altra linea accanto (sezione 7) |
--uninstall rifiutato (codice di uscita 1) con più agent |
Aggiungi --agent-dir con una cartella dalla lista, per esempio --agent-dir /opt/hqbird/fbagent-fb50-2 |
--uninstall rifiutato (codice di uscita 5): this agent runs the RCM of the host |
Rimuovi prima il cluster nella console RCM, oppure esegui di nuovo con --force (sezione 7) |
no permission for read-write access a employee.fdb dopo un aggiornamento (3.0) |
sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb (sezione 6) |
refused (M14): the folder is not empty |
Scegli una cartella vuota o nuova con --fb-root, oppure indica il Firebird da aggiornare |
| Codice di uscita 2 o 3 | Leggi /var/log/fbagent/install.log; le unità sono tornate allo stato precedente all’esecuzione (codice 2) o necessitano di un controllo (codice 3) |
| HQ Monitor non si apre | systemctl status hqbirdmonitor-fb50 (hqbirdmonitor-p<port> prima della 2027.2.9); controlla che nient’altro sia in ascolto sulla porta; apri la porta nel firewall; --hqmonitor-port per un’altra porta |
| Password di HQ Monitor persa | Esegui di nuovo l’installer (riparazione) con --hqmonitor-login admin --hqmonitor-password-file <file>; il vecchio /opt/hqbird/conf/access.properties è conservato come access.properties.bak-<time>. Il nuovo accesso vale per tutte le istanze dell’host |
| L’email di prova non è stata inviata (nessuna rete) | Inviala più tardi: cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email <address> --accept-privacy |
| SELinux (AlmaLinux, RHEL) | Supportato in modalità enforcing: l’installer ripristina i contesti dei file che scrive; nulla da fare |