Samostatné monitorování pro Firebird

Jak nainstalovat a nakonfigurovat Firebird Advanced Monitoring samostatně

1. Instalace

1.1. Registrace na portálu „Online Tools For Firebird“ pro získání souboru keyanswers.txt

Pro použití pokročilého monitorování je nutné vytvořit si bezplatný účet na portálu „Online Tools For Firebird“: https://cc.ib-aid.com/, a poté stáhnout soubor keyanswers.txt pro propojení vašeho účtu a serverů.

Pro uživatele, kteří používají soukromé Control Center, musí být příslušný účet vytvořen administrátorem.

1.1.1. Kroky k registraci

1. Otevřete https://cc.ib-aid.com/ a klikněte na Vytvořit nový účet:

Registrace do Online Tools For Firebird

2. Poté zadejte platný e-mail, uživatelské jméno a společnost (volitelné):

Vyplnění registračního formuláře

3. Poté počkejte 2-3 minuty na doručení potvrzovacího e-mailu a klikněte na potvrzovací odkaz. Otevře se formulář, kde je třeba zadat heslo a jeho potvrzení, poté se můžete přihlásit na portál „Online Tools For Firebird“.

1.1.2. Stažení souboru keyanswers.txt

Po přihlášení uvidíte widget „Stáhnout Firebird Monitoring Agents“:

Stažení keyanswers.txt z Online Tools

Stáhněte agenta pro příslušný operační systém (v současnosti jsou podporovány pouze Windows 7+ / Server 2008+ a Linux se systemd).

Také stáhněte soubor keyanswers.txt.

Soubor keyanswers.txt obsahuje potřebné informace pro propojení účtu Control Center a Advanced Monitoring, poté pokračujte instalací.

1.2. Instalace na Windows

Distribuce agenta pro Advanced Monitoring na Windows je zip archiv: install_fbcc.zip.

Rozbalte instalační archiv fbcc.zip do složky Firebird, například C:\Program Files\Firebird\Firebird_3_0\fbcc, a poté zkopírujte do složky fbcc soubor keyanswers.txt z předchozího kroku.

Výsledkem by měla být složka vypadající takto:

Složka se soubory Advanced Monitoring by měla být uvnitř složky Firebird:

Také se ujistěte, že soubor keyanswers.txt je ve složce se soubory pokročilého monitorování:

Keanswers ve složce fbcc

Poté spusťte příkazový soubor install_fbcc.cmd s možností „Spustit jako správce“. Soubor cmd provede následující:

vytvoří 2 služby: FBHQbird Monitor 4 a FBHQbird Trace 4
vytvoří úlohu v Plánovači úloh pro restart monitorování ve 23:50
Najde Firebird (pokud je umístěn ve standardní cestě) a nakonfiguruje jej. Instalace Advanced Monitoring se automaticky pokusí nakonfigurovat přístup k Firebird s výchozím uživatelem/heslem a zkontroluje připojení k příkladové databázi employee.fdb. Pokud váš vlastnický uživatel není SYSDBA nebo heslo není masterkey, instalace požádá o zadání uživatele a hesla.
Připojí se k portálu Control Center, uvedenému v souboru keyanswers.txt, a zaregistruje server ve vašem účtu.

1.2.1. Instalace s výchozím SYSDBA/masterkey

Níže je příklad instalačního logu z Firebird s výchozím uživatelem/heslem (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. Instalace s vlastním uživatelským jménem/heslem

V případě nedefaultního uživatelského jména a/nebo hesla budete požádáni o jejich zadání během procesu instalace v cmd.

1.2.3. Odinstalace Advanced Monitoring na Windows

Pokud uděláte chybu během instalace, nebo uvidíte jakoukoli chybu, nebo se jen rozhodnete odebrat agenta Advanced Monitoring, spusťte remove_fbcc.cmd, který zastaví a odebere službu a úlohu Plánovače úloh. Log odinstalace bude vypadat takto:

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. Instalace na Linux

Stáhněte soubor install_fbcc.sh z „Online Tools For Firebird“ (podrobnosti viz 1.1.2):

Code

sudo wget /download/fbcc/install_fbcc.sh

Tento soubor obsahuje instalační program Advanced Monitoring pro Firebird pro Linux.

Instalační program nainstaluje potřebné soubory do umístění /opt/fbcc, proto se ujistěte, že máte dostatek volného místa.

1.3.1 Předpoklady: Java 8 a jsvc

Java 8

Na serveru, kde potřebujete spustit monitorování, musíte mít nainstalovanou Javu 8.

Doporučujeme nainstalovat OpenJDK 8 Correto (od Amazon):

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

Více podrobností: https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/generic-linux-install.html

jsvc

jsvc je nástroj pro spouštění Java aplikací jako služby, používá ho agent Firebird Advanced Monitoring.

Instalace jsvc na CentOS

Code

yum install jsvc

na Ubuntu

Code

apt install jsvc

1.3.3. Umístěte keyanswers.txt vedle install_fbcc.sh

Získejte keyanswers.txt z bodu 1.1.2 a umístěte jej vedle install_fbcc.sh

Upozorňujeme, že neexistuje příkaz wget, protože keynaswers.txt je generován na portálu dynamicky a vyžaduje přihlášení registrovaného uživatele ke stažení. <4>1.3.4. Kroky k instalaci Udělejte instalační skript spustitelným:

Code

sudo chmod +x install_fbcc.sh

Spusťte instalaci:

Code

sudo install_fbcc.sh

Toto je příklad, jaké soubory by měly být na místě před instalací:

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*

Poté spusťte install_fbcc.sh.

Upozorňujeme, že skript očekává, že standardní Firebird byl ručně nainstalován do /opt/firebird z oficiálního tar archivu.

Pokud jste nainstalovali Firebird z repozitáře, doporučujeme jej odinstalovat a nainstalovat z oficiálního tar archivu z webu www.firebirdsql.org.

2. Řešení problémů

Obecné rady pro úspěšné řešení problémů

Zkontrolujte soubory *.log ve složce Bin instalace Firebird Monitoring.

Soubory logů mají názvy podle názvu jar souboru, tj. pro launcher bude launcher.log.

Soubory logů ve výchozím nastavení obsahují chyby a důležité zprávy.

Problém: pokus o instalaci bez souboru keyasnwers.txt

Pokud jste nevložili soubor keyanswers.txt do stejné složky jako install_fbcc.cmd (na Windows) nebo install_fbcc.sh (na Linux), služby budou nainstalovány, ale nebudou nakonfigurovány:

Code

c:\Firebird30\fbcc>install_fbcc.cmd
The Service FBHQbirdMON4 has been installed

 Installation stopped: keyanswers.txt file not found near install_fbcc.cmd.
 Please download it from cc.ib-aid.com or use manual mode installation.
 To try installation again, run remove_fbcc script and then install_fbcc again.

Řešení:

spusťte odinstalační příkazový soubor (uninstall.cmd na Windows, použijte kliknutí pravým tlačítkem a možnost „Spustit jako správce“, nebo uninstall.sh v /opt/fbcc/uninstall.sh na Linuxu). Odinstaluje monitorování s výstupem takto:

Code

c:\Firebird30\fbcc>remove_fbcc.cmd
The FBHQbird Monitor 4 service is not started.

More help is available by typing NET HELPMSG 3521.

The FBHQbird Trace 4 service is not started.

More help is available by typing NET HELPMSG 3521.

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:\fbcc>

Poté vložte keyanswers.txt do složky vedle install_fbcc.cmd a znovu nainstalujte.

Problém: instalační balíček nemůže najít složku Firebird

Pokud instalační balíček monitorování nenajde složku Firebird, zobrazí následující výstup:

Code

c:\Firebird30\fbcc>install_fbcc.cmd

The Service FBHQbirdMON4 has been installed
2022-02-12 09:11:23 ERROR MainCreateConf:287 - Not found location, return empty string
2022-02-12 09:11:23 ERROR MainCreateConf:287 - Not found location, return empty string
2022-02-12 09:11:23 ERROR MainCreateConf:287 - Not found location, return empty string

Checking access to Firebird Monitoring Portal...
Connected to Portal: Ok
2022-02-12 09:11:24 ERROR MainCreateConf:592 - Cannot find test database - setting version to 3.0.0 and arch to Classic
Paths checked:
2022-02-12 09:11:24 ERROR MainCreateConf:594 - /../examples/empbuild/employee.fdb
2022-02-12 09:11:24 ERROR MainCreateConf:594 - /../help/help.fdb
2022-02-12 09:11:24 ERROR MainCreateConf:594 - /examples/empbuild/employee.fdb
2022-02-12 09:11:24 ERROR MainCreateConf:594 - /help/help.fdb

Please enter owner user for Firebird databases, or hit Enter to use SYSDBA

Zprávy výše „Not found location, return empty“ znamenají, že instalační skript nenašel Firebird v následujících cestách na Windows:

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"

a na Linuxu

Code

"/opt/firebird/bin"

Řešení:

Buď nainstalujte Firebird do standardní cesty (C:\Program Files\Firebird\Firebird_N_N na Windows nebo /opt/firebird), nebo použijte HQbird s Advanced Monitoring, který podporuje vlastní cesty k Firebird.

Problém: spuštění monitorování bez konfiguračního souboru způsobuje chyby v logách

Code

Starting service...Windows 10
Current folder = E:\fbcc\_OUT
2022-02-09 10:43:20 ERROR Main:350 - Stopping: not found mainconfig.enc or mainconfig.json in ../conf/mainconfig.enc

Řešení:

proveďte řádnou instalaci pomocí souboru keyanswers.txt z vašeho Control Center