Samostalno praćenje za Firebird

Kako instalirati i konfigurisati napredno praćenje Firebird-a samostalno

1. Instalacija

1.1. Registrujte se na „Online Tools For Firebird“ da biste dobili datoteku keyanswers.txt

Da biste koristili napredno praćenje, potrebno je da kreirate besplatan nalog na portalu „Online Tools For Firebird“: https://cc.ib-aid.com/, a zatim preuzmete datoteku keyanswers.txt da biste povezali svoj nalog i servere.

Za korisnike koji koriste privatni Control Center, odgovarajući nalog mora kreirati administrator.

1.1.1. Koraci za registraciju

1. Otvorite https://cc.ib-aid.com/ i kliknite na „Create new account“:

Registrujte se na Online Tools For Firebird

2. Zatim navedite važeću e-adresu, korisničko ime i kompaniju (opciono):

Popunite formular za registraciju

3. Nakon toga, sačekajte 2-3 minuta da primite e-poruku za potvrdu i kliknite na link za potvrdu. Otvoriće se formular u koji treba da unesete lozinku i njenu potvrdu, nakon čega možete da se prijavite na portal „Online Tools For Firebird“.

1.1.2. Preuzimanje keyanswers.txt

Nakon prijave videćete widget „Download Firebird Monitoring Agents“:

Preuzmite keyanswers.txt sa Online Tools

Preuzmite agenta za odgovarajući operativni sistem (trenutno su podržane samo Windows verzije 7+/ Server 2008+ i Linux sa systemd-om).

Takođe, preuzmite datoteku keyanswers.txt.

Keyanswers.txt sadrži potrebne informacije za povezivanje Control Center naloga i naprednog praćenja, a zatim nastavite sa instalacijom.

1.2. Instalacija na Windows-u

Distribucija agenta za napredno praćenje na Windows-u je zip arhiva: install_fbcc.zip.

Otpakujte instalacionu arhivu fbcc.zip u Firebird fasciklu, na primer, C:\Program Files\Firebird\Firebird_3_0\fbcc, a zatim kopirajte datoteku keyanswers.txt iz prethodnog koraka u fasciklu fbcc.

Kao rezultat, fascikla bi trebalo da izgleda ovako:

Fascikla sa datotekama naprednog praćenja treba da bude unutar Firebird fascikle:

Takođe, uverite se da se keyanswers.txt nalazi u fascikli sa datotekama naprednog praćenja:

Keanswers u fbcc fascikli

Zatim pokrenite komandnu datoteku install_fbcc.cmd sa opcijom „Run As Administrator“. Cmd datoteka će uraditi sledeće:

kreirati 2 servisa: FBHQbird Monitor 4 i FBHQbird Trace 4
kreirati zadatak u Planeru zadataka za ponovno pokretanje praćenja u 23:50
Pronaći Firebird (ako se nalazi na standardnoj putanji) i konfigurisati ga. Instalacija naprednog praćenja automatski pokušava da konfiguriše pristup Firebird-u sa podrazumevanim korisnikom/lozinkom i proverava vezu sa primerom baze podataka employee.fdb. Ako vaš vlasnički korisnik nije SYSDBA ili lozinka nije masterkey, instalacija će tražiti da unesete korisnika i lozinku.
Povezati se sa Control Center portalom, navedenim u keyanswers.txt, i registrovati server na vašem nalogu tamo.

1.2.1. Instalacija sa podrazumevanim SYSDBA/masterkey

Ispod je primer dnevnika instalacije sa Firebird-om sa podrazumevanim korisnikom/lozinkom (SYSDBA/masterkey):

Code

c:\Firebird30\fbcc>install_fbcc.cmd
The Service FBHQbirdMON4 has been installed
2022-02-12 09:41:40 ERROR MainCreateConf:287 - Not found location, return empty string

Checking access to Firebird Monitoring Portal...
Connected to Portal: Ok
Determined architecture: SuperServer and version: 3.0.6
Verified connection with Firebird user: SYSDBA: Ok.
Using autodiscovery to watch for all active databases.

Registering server in Firebird Monitoring Control Center
Registered new server with name=SRV-DESKTOP-NS28RCG-2202012214,  GUID=99c54d1jjqxj0r   (id=314285)
Successful! Now you can see your server in Firebird Control Center: https://cc.ib-aid.com
The Service FBHQbirdTrace4 has been installed
SUCCESS: The scheduled task "Restart Mon4 Service (Firebird Monitoring)" has successfully been created.
The FBHQbird Monitor 4 service is starting.
The FBHQbird Monitor 4 service was started successfully.

The FBHQbird Trace 4 service is starting.
The FBHQbird Trace 4 service was started successfully.

c:\Firebird30\fbcc>

1.2.2. Instalacija sa prilagođenim korisničkim imenom/lozinkom

U slučaju nestandardnog korisničkog imena i/ili lozinke, bićete upitani da ih unesete tokom procesa instalacije u cmd.

1.2.3. Deinstalacija naprednog praćenja na Windows-u

Ako napravite grešku tokom instalacije, ili vidite bilo koju grešku, ili jednostavno odlučite da uklonite agenta naprednog praćenja, pokrenite remove_fbcc.cmd, koji će zaustaviti i ukloniti servis i zadatak u Planeru zadataka. Dnevnik deinstalacije će izgledati ovako:

Code

c:\Firebird30\fbcc>remove_fbcc.cmd
The FBHQbird Monitor 4 service is stopping.
The FBHQbird Monitor 4 service was stopped successfully.

The FBHQbird Trace 4 service is stopping.
The FBHQbird Trace 4 service was stopped successfully.

The FBHQbird Monitor 4 service is not started.

More help is available by typing NET HELPMSG 3521.

[SC] DeleteService SUCCESS
The FBHQbird Trace 4 service is not started.

More help is available by typing NET HELPMSG 3521.

[SC] DeleteService SUCCESS
SUCCESS: The scheduled task "Restart Mon4 Service (Firebird Monitoring)" was successfully deleted.
c:\Firebird30\fbcc>

1.3. Instalacija na Linux-u

Preuzmite datoteku install_fbcc.sh sa „Online Tools For Firebird“ (pogledajte 1.1.2 za detalje):

Code

sudo wget /download/fbcc/install_fbcc.sh

Ova datoteka sadrži instalater naprednog praćenja za Firebird za Linux.

Instalater će instalirati potrebne datoteke na lokaciju /opt/fbcc, pa se uverite da imate dovoljno slobodnog prostora tamo.

1.3.1 Preduslovi: Java 8 i jsvc

Java 8

Potrebno je da imate instaliranu Javu 8 na serveru na kome treba da pokrenete praćenje.

Preporučujemo da instalirate OpenJDK 8 Correto (od Amazona):

Code

wget -O- https://apt.corretto.aws/corretto.key | sudo apt-key add -
 sudo add-apt-repository 'deb https://apt.corretto.aws stable main'

sudo apt-get update; sudo apt-get install -y java-1.8.0-amazon-corretto-jdk

Code

Više detalja: https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/generic-linux-install.html

jsvc

jsvc je alat za pokretanje Java aplikacije kao servisa, koristi ga agent naprednog praćenja za Firebird.

Instalirajte jsvc na CentOS-u

Code

yum install jsvc

na Ubuntu-u

Code

apt install jsvc

1.3.3. Postavite keyanswers.txt pored install_fbcc.sh

Preuzmite keyanswers.txt iz 1.1.2 i postavite ga pored install_fbcc.sh

Imajte na umu da ne postoji wget komanda, jer se keynaswers.txt generiše dinamički na portalu i zahteva da se registrovani korisnik prijavi i preuzme. <4>1.3.4. Koraci za instalaciju Učinite skriptu za instalaciju izvršnom:

Code

sudo chmod +x install_fbcc.sh

Pokrenite instalaciju:

Code

sudo install_fbcc.sh

Ovo je primer koje datoteke treba da budu na mestu pre instalacije:

Code

total 18624
drwxr-xr-x  3 root root     4096 May  3 23:32 ./
drwxr-xr-x 20 root root     4096 Feb 14 02:06 ../
drwxr-xr-x 12 root root     4096 May  3 23:19 firebird/
-rwxr-xr-x  1 root root 19050609 Sep 29  2021 install_fbcc.sh*
-rwxrwxrwx  1 root root      110 May  3 23:26 keyanswers.txt*

Nakon toga, pokrenite install_fbcc.sh.

Imajte na umu da skripta očekuje da je standardni Firebird ručno instaliran u /opt/firebird iz zvanične tar arhive.

Ako ste instalirali Firebird iz repozitorijuma, preporučujemo da ga deinstalirate i instalirate iz zvanične tar arhive sa veb sajta www.firebirdsql.org.

2. Rešavanje problema

Opšti saveti za uspešno rešavanje problema

Proverite *.log datoteke u Bin fascikli instalacije Firebird praćenja.

Datoteke dnevnika imaju nazive prema imenu jar datoteke, tj. za launcher će biti launcher.log.

Datoteke dnevnika po podrazumevanoj konfiguraciji sadrže greške i važne poruke.

Problem: pokušaj instalacije bez keyasnwers.txt

Ako niste postavili datoteku keyanswers.txt u istu fasciklu kao install_fbcc.cmd (na Windows-u) ili install_fbcc.sh (na Linux-u), servisi će biti instalirani, ali ne i konfigurisani:

Code

c:\Firebird30\fbcc>install_fbcc.cmd
Servis FBHQbirdMON4 je instaliran

 Instalacija zaustavljena: fajl keyanswers.txt nije pronađen pored install_fbcc.cmd.
 Preuzmite ga sa cc.ib-aid.com ili koristite ručni način instalacije.
 Da biste pokušali ponovo instalaciju, pokrenite remove_fbcc skriptu, a zatim ponovo install_fbcc.

Rešenje:

Pokrenite komandni fajl za deinstalaciju (uninstall.cmd na Windows-u, koristite desni klik i opciju „Pokreni kao administrator“, ili uninstall.sh u /opt/fbcc/uninstall.sh na Linux-u). To će deinstalirati monitoring sa izlazom poput ovog:

Code

c:\Firebird30\fbcc>remove_fbcc.cmd
Servis FBHQbird Monitor 4 nije pokrenut.

Više pomoći je dostupno kucanjem NET HELPMSG 3521.

Servis FBHQbird Trace 4 nije pokrenut.

Više pomoći je dostupno kucanjem NET HELPMSG 3521.

Servis FBHQbird Monitor 4 nije pokrenut.

Više pomoći je dostupno kucanjem NET HELPMSG 3521.

[SC] DeleteService USPEH
Servis FBHQbird Trace 4 nije pokrenut.

Više pomoći je dostupno kucanjem NET HELPMSG 3521.

[SC] DeleteService USPEH
USPEH: Planirani zadatak "Restart Mon4 Service (Firebird Monitoring)" je uspešno obrisan.
C:\fbcc>

Nakon toga, stavite keyanswers.txt u folder pored install_fbcc.cmd i ponovo instalirajte.

Problem: Instalacioni paket ne može da pronađe Firebird folder

U slučaju da instalacioni paket za monitoring ne pronađe Firebird folder, daće sledeći izlaz:

Code

c:\Firebird30\fbcc>install_fbcc.cmd

Servis FBHQbirdMON4 je instaliran
2022-02-12 09:11:23 GREŠKA MainCreateConf:287 - Lokacija nije pronađena, vraćen prazan string
2022-02-12 09:11:23 GREŠKA MainCreateConf:287 - Lokacija nije pronađena, vraćen prazan string
2022-02-12 09:11:23 GREŠKA MainCreateConf:287 - Lokacija nije pronađena, vraćen prazan string

Provera pristupa Firebird Monitoring Portalu...
Povezano sa Portalom: Ok
2022-02-12 09:11:24 GREŠKA MainCreateConf:592 - Test baza podataka nije pronađena - postavljanje verzije na 3.0.0 i arhitekture na Classic
Proverene putanje:
2022-02-12 09:11:24 GREŠKA MainCreateConf:594 - /../examples/empbuild/employee.fdb
2022-02-12 09:11:24 GREŠKA MainCreateConf:594 - /../help/help.fdb
2022-02-12 09:11:24 GREŠKA MainCreateConf:594 - /examples/empbuild/employee.fdb
2022-02-12 09:11:24 GREŠKA MainCreateConf:594 - /help/help.fdb

Molimo unesite vlasničkog korisnika za Firebird baze podataka, ili pritisnite Enter da koristite SYSDBA

Poruke iznad „Lokacija nije pronađena, vraćen prazan string“ ukazuju da instalaciona skripta nije pronašla Firebird na sledećim putanjama na Windows-u:

Code

"C:/Program Files/Firebird/Firebird_4_0",
"D:/Program Files/Firebird/Firebird_4_0",
"E:/Program Files/Firebird/Firebird_4_0",
"F:/Program Files/Firebird/Firebird_4_0",
"C:/Program Files/Firebird/Firebird_3_0",
"C:/Program Files/Firebird/Firebird_2_5/bin",
"D:/Program Files/Firebird/Firebird_3_0",
"D:/Program Files/Firebird/Firebird_2_5/bin",
"E:/Program Files/Firebird/Firebird_3_0",
"E:/Program Files/Firebird/Firebird_2_5/bin",
"F:/Program Files/Firebird/Firebird_3_0",
"F:/Program Files/Firebird/Firebird_2_5/bin",
"C:/HQbird/Firebird40",
"D:/HQbird/Firebird40",
"E:/HQbird/Firebird40",
"F:/HQbird/Firebird30",
"C:/HQbird/Firebird30",
"C:/HQbird/Firebird25/bin",
"D:/HQbird/Firebird30",
"D:/HQbird/Firebird25/bin",
"E:/HQbird/Firebird30",
"E:/HQbird/Firebird25/bin",
"F:/HQbird/Firebird30",
"F:/HQbird/Firebird25/bin"

i na Linux-u

Code

"/opt/firebird/bin"

Rešenje:

Ili instalirajte Firebird na standardnu putanju (C:\Program Files\Firebird\Firebird_N_N na Windows-u ili /opt/firebird) ili koristite HQbird sa Advanced Monitoring koji podržava prilagođene putanje do Firebird-a.

Problem: Pokretanje monitoringa bez konfiguracionog fajla daje greške u logovima

Code

Pokretanje servisa...Windows 10
Trenutni folder = E:\fbcc\_OUT
2022-02-09 10:43:20 GREŠKA Main:350 - Zaustavljanje: mainconfig.enc ili mainconfig.json nije pronađen u ../conf/mainconfig.enc

Rešenje:

napravite ispravnu instalaciju koristeći keyanswers.txt fajl iz vašeg Control Center-a