Автономний моніторинг для Firebird

Як встановити та налаштувати розширений моніторинг Firebird автономно

1. Встановлення

1.1. Зареєструйтесь на «Online Tools For Firebird», щоб отримати файл keyanswers.txt

Для використання розширеного моніторингу вам потрібно створити безкоштовний обліковий запис на порталі «Online Tools For Firebird»: https://cc.ib-aid.com/, а потім завантажити файл keyanswers.txt, щоб пов’язати ваш обліковий запис і сервери.

Для користувачів, які використовують приватний Control Center, відповідний обліковий запис має бути створений адміністратором.

1.1.1. Кроки для реєстрації

1. Відкрийте https://cc.ib-aid.com/ і натисніть Create new account:

Реєстрація в Online Tools For Firebird

2. Потім вкажіть дійсну електронну пошту, ім’я користувача та компанію (необов’язково):

Заповнення реєстраційної форми

3. Після цього зачекайте 2-3 хвилини, щоб отримати лист із підтвердженням, і натисніть на посилання для підтвердження. Воно відкриє форму, де потрібно ввести пароль та його підтвердження, після чого ви зможете увійти на портал «Online Tools For Firebird».

1.1.2. Завантаження keyanswers.txt

Після входу ви побачите віджет «Download Firebird Monitoring Agents»:

Завантаження keyanswers.txt з Online Tools

Завантажте агента для потрібної ОС (наразі підтримуються лише Windows 7+/ Server 2008+ та Linux із systemd).

Також завантажте файл keyanswers.txt.

Keyanswers.txt містить необхідну інформацію для зв’язку облікового запису Control Center та розширеного моніторингу, після чого можна продовжити встановлення.

1.2. Встановлення на Windows

Дистрибутив агента для розширеного моніторингу на Windows - це zip-архів: install_fbcc.zip.

Розпакуйте архів встановлення fbcc.zip у папку Firebird, наприклад, C:\Program Files\Firebird\Firebird_3_0\fbcc, а потім скопіюйте у папку fbcc файл keyanswers.txt із попереднього кроку.

У результаті папка має виглядати так:

Папка з файлами розширеного моніторингу має бути всередині папки Firebird:

Також переконайтеся, що keyanswers.txt знаходиться в папці з файлами розширеного моніторингу:

Keanswers у папці fbcc

Потім запустіть командний файл install_fbcc.cmd із параметром «Запуск від імені адміністратора». Файл cmd виконає наступне:

створить 2 служби: FBHQbird Monitor 4 та FBHQbird Trace 4
створить завдання в Планувальнику завдань для перезапуску моніторингу о 23:50
Знайде Firebird (якщо він розташований за стандартним шляхом) і налаштує його. Встановлення розширеного моніторингу автоматично намагається налаштувати доступ до Firebird із користувачем/паролем за замовчуванням і перевіряє підключення до прикладу бази даних employee.fdb. Якщо ваш власник не є SYSDBA або пароль не masterkey, встановлення попросить вказати користувача та пароль.
Підключиться до порталу Control Center, вказаного в keyanswers.txt, і зареєструє сервер у вашому обліковому записі.

1.2.1. Встановлення зі стандартними SYSDBA/masterkey

Нижче наведено приклад журналу встановлення з Firebird із користувачем/паролем за замовчуванням (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. Встановлення з користувацьким ім’ям користувача/паролем

У разі нестандартного імені користувача та/або пароля вас попросять ввести їх під час процесу встановлення в cmd.

1.2.3. Видалення розширеного моніторингу на Windows

Якщо ви допустили помилку під час встановлення, або бачите будь-яку помилку, або просто вирішили видалити агента розширеного моніторингу, запустіть remove_fbcc.cmd, який зупинить і видалить службу та завдання планувальника завдань. Журнал видалення буде таким:

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. Встановлення на Linux

Завантажте файл install_fbcc.sh із «Online Tools For Firebird» (див. 1.1.2 для деталей):

Code

sudo wget /download/fbcc/install_fbcc.sh

Цей файл містить інсталятор розширеного моніторингу для Firebird для Linux.

Інсталятор встановить необхідні файли в розташування /opt/fbcc, тому переконайтеся, що там достатньо вільного місця.

1.3.1 Попередні вимоги: Java 8 та jsvc

Java 8

Вам потрібно мати Java 8, встановлену на сервері, де потрібно запускати моніторинг.

Ми рекомендуємо встановити OpenJDK 8 Correto (від 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

Більше деталей: https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/generic-linux-install.html

jsvc

jsvc - це інструмент для запуску java-застосунку як служби, він використовується агентом розширеного моніторингу Firebird.

Встановіть jsvc на CentOS

Code

yum install jsvc

на Ubuntu

Code

apt install jsvc

1.3.3. Розмістіть keyanswers.txt поруч із install_fbcc.sh

Отримайте keyanswers.txt із 1.1.2 і розмістіть його поруч із install_fbcc.sh

Зверніть увагу, що команди wget немає, оскільки keynaswers.txt генерується на порталі динамічно та вимагає, щоб зареєстрований користувач увійшов і завантажив його. <4>1.3.4. Кроки для встановлення Зробіть скрипт встановлення виконуваним:

Code

sudo chmod +x install_fbcc.sh

Запустіть встановлення:

Code

sudo install_fbcc.sh

Ось приклад того, які файли мають бути на місці перед встановленням:

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*

Після цього запустіть install_fbcc.sh.

Зверніть увагу, що скрипт очікує, що стандартний Firebird буде встановлено вручну в /opt/firebird з офіційного tar-архіву.

Якщо ви встановили Firebird із репозиторію, ми рекомендуємо видалити його та встановити з офіційного tar-архіву з веб-сайту www.firebirdsql.org.

2. Усунення неполадок

Загальні поради для успішного усунення неполадок

Перевірте файли *.log у папці Bin встановлення моніторингу Firebird.

Файли журналів мають назви відповідно до назви jar, тобто для лаунчера буде launcher.log.

Файли журналів за замовчуванням містять помилки та важливі повідомлення.

Проблема: спроба встановлення без keyasnwers.txt

Якщо ви не розмістили файл keyanswers.txt у тій самій папці, що й install_fbcc.cmd (на Windows) або install_fbcc.sh (на Linux), служби будуть встановлені, але не налаштовані:

Code

c:\Firebird30\fbcc>install_fbcc.cmd
Службу FBHQbirdMON4 встановлено

 Встановлення зупинено: файл keyanswers.txt не знайдено поруч із install_fbcc.cmd.
 Завантажте його з cc.ib-aid.com або скористайтеся ручним режимом встановлення.
 Щоб спробувати встановити знову, запустіть скрипт remove_fbcc, а потім install_fbcc знову.

Рішення:

запустіть файл команди видалення (uninstall.cmd у Windows, використовуйте правий клік і опцію «Запуск від імені адміністратора», або uninstall.sh у /opt/fbcc/uninstall.sh на Linux). Він видалить моніторинг із таким виводом:

Code

c:\Firebird30\fbcc>remove_fbcc.cmd
Службу FBHQbird Monitor 4 не запущено.

Додаткову допомогу можна отримати, ввівши NET HELPMSG 3521.

Службу FBHQbird Trace 4 не запущено.

Додаткову допомогу можна отримати, ввівши NET HELPMSG 3521.

Службу FBHQbird Monitor 4 не запущено.

Додаткову допомогу можна отримати, ввівши NET HELPMSG 3521.

[SC] DeleteService SUCCESS
Службу FBHQbird Trace 4 не запущено.

Додаткову допомогу можна отримати, ввівши NET HELPMSG 3521.

[SC] DeleteService SUCCESS
SUCCESS: Заплановане завдання "Restart Mon4 Service (Firebird Monitoring)" успішно видалено.
C:\fbcc>

Після цього помістіть keyanswers.txt у папку поруч із install_fbcc.cmd і встановіть знову.

Проблема: інсталяційний пакет не може знайти папку Firebird

Якщо інсталяційний пакет моніторингу не знайде папку Firebird, він видасть такий вивід:

Code

c:\Firebird30\fbcc>install_fbcc.cmd

Службу FBHQbirdMON4 встановлено
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

Перевірка доступу до порталу моніторингу Firebird...
Підключено до порталу: Ok
2022-02-12 09:11:24 ERROR MainCreateConf:592 - Cannot find test database - setting version to 3.0.0 and arch to Classic
Перевірені шляхи:
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

Будь ласка, введіть власника баз даних Firebird або натисніть Enter, щоб використати SYSDBA

Повідомлення вище «Not found location, return empty» вказують, що інсталяційний скрипт не знайшов Firebird у таких шляхах у 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"

і на Linux

Code

"/opt/firebird/bin"

Рішення:

Або встановіть Firebird у стандартний шлях (C:\Program Files\Firebird\Firebird_N_N у Windows або /opt/firebird), або використовуйте HQbird із розширеним моніторингом, який підтримує власні шляхи до Firebird.

Проблема: запуск моніторингу без файлу конфігурації дає помилки в журналах

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

Рішення:

виконайте правильне встановлення за допомогою файлу keyanswers.txt із вашого Control Center