Questa pagina è stata tradotta automaticamente. Leggi l'originale in inglese. English

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. 1. Cosa installa l’installer
  2. 2. L’installazione in breve
  3. 3. Nuova installazione
  4. 4. Dopo l’installazione
  5. 5. Aggiornamento di un HQbird più vecchio (2024 e precedenti)
  6. 6. Aggiornamento di HQbird 2027 a una nuova versione
  7. 7. Comandi di manutenzione
  8. 8. Collegamento al tuo HQCenter
  9. 9. Installazione non presidiata e script
  10. 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.conf per 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-debug li salta.
  • HQbird agent (fbagent): l’unità systemd hqbirdfbagent-fb50, in esecuzione come utente firebird, 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, indirizzo http://<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/hqbirdrcm e gira come unità hqbirdrcm; il riepilogo ne stampa l’indirizzo nella riga RCM:. Il nodo riceve la sua unità (ad esempio hqclusternode-master-p3050) quando collegate l’host in RCM. I kit dalla 2027.2.19 con un agent precedente installano RCM su ogni server (--rcm off lo 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à hqbirdrcm e nessuna riga RCM:.

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

Diagram

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

Command
KIT=hqbird2027-fb50-linux-2027.2.9.run
curl -fL -O https://ib-aid.com/download/hqbird/v2027/$KIT -O https://ib-aid.com/download/hqbird/v2027/$KIT.sha256
sha256sum -c $KIT.sha256

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

Command
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

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

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

text
 HQbird 2027 setup <version> | Firebird 5.0 (5.0.5.1917)

 Plan M1: New Firebird and HQbird agent
   Firebird: new /opt/firebird (unit firebird, port 3050)
   Agent: new, in /opt/hqbird/fbagent-fb50
   OS packages to install: libtommath1 (see Plan details)

   Language         English (auto)
   Firebird folder  automatic (/opt/firebird)
   Firebird port    automatic (3050)
   Agent id         automatic (srv1261114-fb50)
   SYSDBA password  generated (for a new Firebird)
   HQ Monitor       port automatic, login admin
   License          not now (add it later in HQ Monitor)
   HQCenter         not attached
   Cluster          RCM off, discovery mode off
   Components       debug files: yes, fbmcp: yes
   Updates          HQbird only (recommended)

 > Install
   Plan details
   About plans
   Quit

 Up/Down: move   Enter: change or start   Esc: quit

Le 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 variabile HQBIRD_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 è dumb o non impostata;
  • la finestra è più piccola di 80 colonne per 24 righe (dentro tmux con 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:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] host: Ubuntu 24.04.5 LTS, kernel 6.8.0-142-generic
[install] checking the payload (sha256) ...
[install] unpacking into /var/tmp/hqbird2027.k3Qf1x ...
[install] OS libraries missing: libtommath.so.1 (packages: libtommath1)
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              OS packages to install: libtommath1
[install] Install as planned? Yes/No y
[install] installing from the package repository: libtommath1
[install] OS libraries: installed
[install] installing (fbagent --setup-install; log /var/log/fbagent/install.log) ...
...
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1916 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
[install] done. Uninstall: sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall

Questo 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:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    off; turn it on in HQbird Monitor or with fbagent --cluster-pairing on (port 7450)

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] e Turn 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. --yes e 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 da root e 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:

  1. l’opzione --lang en|ru|pt-BR|de;
  2. la variabile HQBIRD_LANG;
  3. la locale della console (LC_ALL, poi LC_MESSAGES, poi LANG), quando è una locale UTF-8;
  4. l’inglese.

La seconda riga dell’output dice quale lingua è e come cambiarla. Questa riga è sempre in inglese:

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

Note:

  • PuTTY non invia LANG al 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. --lang funziona comunque anche lì.
  • L’installer necessita di una locale UTF-8 sull’host per le altre lingue (C.UTF-8 o en_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.log e 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:

text
[install] plan M1: New Firebird and HQbird agent
[install]              This host has no Firebird and no older HQbird. Setup installs a new Firebird and a new HQbird agent.
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)

--plan-help 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 ID fornisce 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-id lì 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

Command
systemctl status firebird hqbirdfbagent-fb50 hqbirdmonitor-fb50 --no-pager
ss -ltnp | grep -E ':3050|:23050'
ISC_PASSWORD="$(sed -n 's/^SYSDBA_PASS=//p' /root/fbagent-install-sysdba.txt)" \
  /opt/firebird/bin/isql -user SYSDBA localhost/3050:/opt/firebird/examples/empbuild/employee.fdb

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

text
/opt/firebird/                         Firebird 5.0 server: bin/, lib/, plugins/, firebird.conf,
                                       databases.conf, security5.fdb, *.debug files (symbols)
/opt/fb50/                             a Firebird 5.0 next to another line (/opt/fb40, /opt/fb30)
/opt/hqbird/                           root of the HQbird agents
  conf/access.properties               HQ Monitor sign-in, shared by all instances of the host (0600)
  fbagent-fb50/                        HQbird agent of this Firebird
    fbagent                            the agent (unit hqbirdfbagent-fb50)
    hqmonitor                          HQ Monitor (unit hqbirdmonitor-fb50)
    agent_config.json                  agent configuration (encrypted secrets: config_secret.key)
    config.properties                  HQ Monitor configuration
    hqbird2027-firebird.json           the Firebird this installer installed
    hqbird2027-hqmonitor-firewall.json the HQ Monitor port this installer opened in firewalld or ufw
    conf/                              trace and job settings
    logs/                              agent log (firebird-agent_<date>.jsonl), license_state.json;
                                       journal.log and server_status.json after the first checks
    bak/                               backups of the configuration
    outcoming/                         status reports for HQCenter
    update/                            update cache: hqmonitor/, hqclusternode/, hqbirdrcm/
    certs/                             certificates after the attach to HQCenter
  fbagent-hqbird-takeover.json         state of the older HQbird units before the takeover (section 5)
/opt/hqbirdrcm/                        the cluster console RCM (unit hqbirdrcm, owner firebird):
                                       with agent 3.1.0 only after --rcm on (or HQ Monitor);
                                       kits 2027.2.19+ with an older agent: unless --rcm off
/opt/hqclusternode/                    the cluster node (owner firebird), empty until the host is
                                       linked in RCM or HQCenter adds it to a cluster
/var/lib/hqmonitor/<server id>/        HQ Monitor data
/var/log/fbagent/install.log           log of the installer's steps (passwords are hidden)
/root/fbagent-install-sysdba.txt       SYSDBA password of a new Firebird (root only, 0600)
/etc/sysctl.d/90-hqbird-firebird.conf  kernel settings for Firebird (vm.max_map_count), only when
                                       the system value is lower (Ubuntu 24.04 needs none)
/etc/sudoers.d/                        the agent's sudoers rules for its root helpers (updates, HQ Monitor)

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 --json per 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:

Diagram

Cosa vedi sul terminale:

text
[install]   found Firebird 5.0.5.1878: /opt/firebird, port 3050, unit firebird, no agent
[install] plan M4: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install]              HQbird services to turn off: hqbird
[install] Firebird 5.0.5.1878: unit firebird, port 3050, 0 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1878? Yes/No y
  • Il piano indica il Firebird che viene aggiornato; --fb-root e --port non 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 version viene chiesto quando il vecchio HQbird gestisce un Firebird di un’altra versione (aggiorna quello, oppure uno nuovo accanto ad esso). --yes risponde Sì a tutte le domande; senza un terminale e senza --yes l’installer si ferma con codice di uscita 4 e non cambia nulla.
  • --disable-hqbird disattiva le unit del vecchio HQbird in ogni caso; --no-hqbird lascia 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.properties viene conservato, quindi accedi con il login e la password che usavi prima. L’installer assegna il file a firebird con 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, o aliases.conf per la 2.5) come righe name = 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 direttiva include non viene modificato.
  • Rimuove i vecchi log di monitoraggio del vecchio HQbird: il contenuto delle cartelle mon/outcoming e mon/outtrace della 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:

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

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

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

Nell’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:

text
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install]   found Firebird 5.0.5.1880: /opt/firebird, port 3050, unit firebird, agent hqbirdfbagent-p3050
[install] plan M10: Firebird update /opt/firebird (unit firebird, port 3050)
[install]              agent in_place in /opt/hqbird/fbagent-p3050 (unit hqbirdfbagent-p3050), HQ Monitor hqbirdmonitor-p3050
[install] Firebird 5.0.5.1880: unit firebird, port 3050, 2 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1880? Yes/No y
...
Firebird updated: 5.0.5.1880 -> 5.0.5.1916
HQ Monitor updated 1.31.0 -> 1.33.0 (...)
Done: agent hqbirdfbagent-p3050 in /opt/hqbird/fbagent-p3050, Firebird 5.0.5.1916 in /opt/firebird (port 3050).

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

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

Il 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:

Command
# the agent and HQ Monitor of this instance; Firebird, the databases, configs and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
# the same, and the agent's configuration, logs, license state and HQ Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data

Senza --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:

Command
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:

Command
B=/opt/fb50-2
U=firebird.$(echo ${B#/} | tr / _)          # /opt/fb50-2 -> firebird.opt_fb50-2
systemctl list-unit-files "$U*"             # the units that will be removed
sudo systemctl disable --now $(systemctl list-unit-files "$U*" --no-legend | awk '$1 !~ /@/ {print $1}')
sudo rm -f /usr/lib/systemd/system/$U* /etc/systemd/system/$U*
sudo systemctl daemon-reload
sudo rm -rf $B

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

Diagram
  1. 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 salvare attach.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 quando admin_panel.install_script_url è impostato.
  2. Copiare attach.json sul server.
  3. Collegarsi in uno dei due modi:
Command
# during the installation
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --attach /root/attach.json
# later, for an installed agent
cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /root/attach.json

Con 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:

Command
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:

Command
umask 077
printf '%s\n' 'S3cret-Sysdba' > /root/sysdba.txt
printf '%s\n' 'S3cret-Monitor' > /root/hqm.txt
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --fb-root /opt/firebird --port 3050 \
  --sysdba-pass-file /root/sysdba.txt \
  --hqmonitor-port 24000 --hqmonitor-login ops --hqmonitor-password-file /root/hqm.txt
rm -f /root/sysdba.txt /root/hqm.txt

Nuova installazione con l’email di prova, un file di licenza e il file di attach:

Command
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
  --email [email protected] --accept-privacy --trial-zone EU \
  --license /root/hqbird-license.json \
  --attach /root/attach.json

Aggiornamento di un vecchio HQbird, tutte le unità del vecchio HQbird disattivate:

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

Aggiornamento di HQbird 2027 a una nuova versione (una istanza; con più istanze, aggiungi --fb-root e --port):

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

Una seconda istanza di Firebird 5.0 sulla porta 3056:

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

Rimozione:

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

Uno script che si ferma in caso di installazione fallita:

Command
#!/bin/sh
set -e
sh hqbird2027-fb50-linux-2027.2.9.run --yes || {
  rc=$?
  echo "HQbird setup failed with code $rc, see /var/log/fbagent/install.log" >&2
  exit $rc
}
echo "HQbird 2027 installed"

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:

text
[install] ERROR: no access to the package repository, or a package is not there; nothing was changed.
[install] Missing: libtommath1
[install] Install them, then run this file again:
[install]   apt-get install -y libtommath1
[install] On a server without internet: on a PC with the same Ubuntu 24.04.5 LTS
[install]   apt-get download libtommath1
[install] copy the .deb files here and run:  apt-get install -y ./*.deb

Sulla 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