Standalone-bewaking voor Firebird

Hoe Firebird Advanced Monitoring standalone te installeren en configureren

1. Installatie

1.1. Registreer op “Online Tools For Firebird” om het bestand keyanswers.txt te verkrijgen

Om gebruik te kunnen maken van de geavanceerde bewaking, moet u een gratis account aanmaken op het portaal “Online Tools For Firebird”: https://cc.ib-aid.com/, en vervolgens het bestand keyanswers.txt downloaden om uw account en servers te koppelen.

Voor gebruikers die gebruik maken van een privé Control Center, moet het betreffende account door de beheerder worden aangemaakt.

1.1.1. Stappen om te registreren

1. Open https://cc.ib-aid.com/ en klik op Create new account:

Registreer bij Online Tools For Firebird

2. Geef vervolgens een geldig e-mailadres, gebruikersnaam en bedrijf (optioneel) op:

Vul het registratieformulier in

3. Wacht daarna 2-3 minuten om een bevestigingsmail te ontvangen en klik op de bevestigingslink. Er wordt een formulier geopend waarin u een wachtwoord en de bevestiging ervan moet invoeren. Daarna kunt u inloggen op het portaal “Online Tools For Firebird”.

1.1.2. Download keyanswers.txt

Na het inloggen ziet u de widget “Download Firebird Monitoring Agents”:

Download keyanswers.txt van Online Tools

Download de agent voor het benodigde besturingssysteem (momenteel worden alleen Windows-versies 7+/ Server 2008+ en Linux met systemd ondersteund).

Download ook het bestand keyanswers.txt.

Keyanswers.txt bevat de benodigde informatie om het Control Center-account en Advanced Monitoring te koppelen. Ga daarna verder met de installatie.

1.2. Installatie op Windows

De agent-distributie voor Advanced Monitoring op Windows is het zip-archiefbestand: install_fbcc.zip.

Pak het installatiearchief fbcc.zip uit naar de Firebird-map, bijvoorbeeld C:\Program Files\Firebird\Firebird_3_0\fbcc, en kopieer vervolgens het bestand keyanswers.txt uit de vorige stap naar de map fbcc.

Het resultaat zou er als volgt uit moeten zien:

Map met Advanced Monitoring-bestanden moet zich in de Firebird-map bevinden:

Zorg er ook voor dat keyanswers.txt zich in de map met de geavanceerde bewakingsbestanden bevindt:

Keanswers in de fbcc-map

Voer daarna het opdrachtbestand install_fbcc.cmd uit met de optie “Run As Administrator”. Het cmd-bestand doet het volgende:

maakt 2 services aan: FBHQbird Monitor 4 en FBHQbird Trace 4
maakt een taak in Taakplanner om de bewaking om 23:50 uur opnieuw te starten
zoekt Firebird (als deze zich op het standaardpad bevindt) en configureert het. De installatie van Advanced Monitoring probeert automatisch de toegang tot Firebird te configureren met de standaard gebruikersnaam/wachtwoord en controleert de verbinding met de voorbeelddatabase employee.fdb. Als uw eigenaar-gebruiker niet SYSDBA is of het wachtwoord niet masterkey is, zal de installatie vragen om gebruikersnaam en wachtwoord op te geven.
maakt verbinding met het Control Center-portaal, gespecificeerd in keyanswers.txt en registreert de server in uw account daar.

1.2.1. Installatie met standaard SYSDBA/masterkey

Hieronder staat een voorbeeld van het installatielogboek van Firebird met standaard gebruikersnaam/wachtwoord (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. Installatie met aangepaste gebruikersnaam/wachtwoord

In het geval van een niet-standaard gebruikersnaam en/of wachtwoord, wordt u tijdens het installatieproces in cmd gevraagd deze in te voeren.

1.2.3. De-installatie van Advanced Monitoring op Windows

Als u een fout maakt tijdens de installatie, een fout ziet, of gewoon besluit de Advanced Monitoring-agent te verwijderen, voer dan remove_fbcc.cmd uit. Dit stopt en verwijdert de service en de taakplannertaak. Het de-installatielogboek ziet er als volgt uit:

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. Installatie op Linux

Download het bestand install_fbcc.sh van “Online Tools For Firebird” (zie 1.1.2 voor details):

Code

sudo wget /download/fbcc/install_fbcc.sh

Dit bestand bevat de installer van Advanced Monitoring voor Firebird voor Linux.

De installer installeert de benodigde bestanden naar de locatie /opt/fbcc. Zorg er dus voor dat u daar voldoende vrije ruimte heeft.

1.3.1 Vereisten: Java 8 en jsvc

Java 8

U moet Java 8 geïnstalleerd hebben op de server waar u de bewaking wilt uitvoeren.

We raden aan om OpenJDK 8 Correto (van Amazon) te installeren:

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

Meer details: https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/generic-linux-install.html

jsvc

jsvc is een hulpmiddel om een Java-toepassing als service te starten. Het wordt gebruikt door de Firebird Advanced Monitoring-agent.

Installeer jsvc op CentOS

Code

yum install jsvc

op Ubuntu

Code

apt install jsvc

1.3.3. Plaats keyanswers.txt naast install_fbcc.sh

Haal keyanswers.txt op uit 1.1.2 en plaats het naast install_fbcc.sh

Houd er rekening mee dat er geen wget-opdracht is, omdat keynaswers.txt dynamisch op het portaal wordt gegenereerd en vereist dat de geregistreerde gebruiker inlogt en het downloadt. <4>1.3.4. Stappen om te installeren Maak het installatiescript uitvoerbaar:

Code

sudo chmod +x install_fbcc.sh

Voer de installatie uit:

Code

sudo install_fbcc.sh

Dit is een voorbeeld van welke bestanden aanwezig moeten zijn vóór de installatie:

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*

Voer daarna install_fbcc.sh uit.

Houd er rekening mee dat het script verwacht dat vanilla Firebird handmatig is geïnstalleerd in /opt/firebird vanuit het officiële tar-archief.

Als u Firebird vanuit een repository heeft geïnstalleerd, raden we aan om het te de-installeren en te installeren vanuit het officiële tar-archief van de website www.firebirdsql.org.

2. Probleemoplossing

Algemeen advies voor succesvolle probleemoplossing

Controleer de *.log-bestanden in de Bin-map van de Firebird Monitoring-installatie.

Logbestanden hebben namen die overeenkomen met de jar-naam, d.w.z. voor de launcher zal dit launcher.log zijn.

Logbestanden bevatten standaard fouten en belangrijke berichten.

Probleem: installatiepoging zonder keyasnwers.txt

Als u het bestand keyanswers.txt niet in dezelfde map heeft geplaatst als install_fbcc.cmd (op Windows) of install_fbcc.sh (op Linux), worden de services geïnstalleerd, maar niet geconfigureerd:

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.

Oplossing:

Voer het de-installatieopdrachtbestand uit (uninstall.cmd op Windows, gebruik rechtermuisknop en de optie “Run As Administrator”, of uninstall.sh in /opt/fbcc/uninstall.sh op Linux). Het zal de bewaking de-installeren met uitvoer zoals dit:

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>

Plaats daarna keyanswers.txt in de map naast install_fbcc.cmd en installeer opnieuw.

Probleem: installatiepakket kan de Firebird-map niet vinden

Als het bewakingsinstallatiepakket de Firebird-map niet kan vinden, geeft het de volgende uitvoer:

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

De berichten hierboven “Not found location, return empty” geven aan dat het installatiescript Firebird niet heeft gevonden op de volgende paden op 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"

en op Linux

Code

"/opt/firebird/bin"

Oplossing:

Installeer Firebird op het standaardpad (C:\Program Files\Firebird\Firebird_N_N op Windows of /opt/firebird) of gebruik HQbird met Advanced Monitoring die aangepaste paden naar Firebird ondersteunt.

Probleem: Start van bewaking zonder configuratiebestand geeft fouten in logboeken

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

Oplossing:

voer de juiste installatie uit met behulp van het keyanswers.txt-bestand van uw Control Center