Контакты
IBSurgeon
Эта страница переведена машинным переводом. Читайте английский оригинал. English

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

Автономный мониторинг для 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 с опцией «Запуск от имени администратора». Командный файл выполнит следующее:

  1. создаст 2 службы: FBHQbird Monitor 4 и FBHQbird Trace 4
  2. создаст задание в планировщике задач для перезапуска мониторинга в 23:50
  3. Найдет Firebird (если он находится по стандартному пути) и настроит его. Установка расширенного мониторинга автоматически пытается настроить доступ к Firebird с пользователем/паролем по умолчанию и проверяет подключение к примеру базы данных employee.fdb. Если ваш пользователь-владелец не является SYSDBA или пароль не masterkey, установка запросит указать пользователя и пароль.
  4. Подключится к порталу 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. Установка с пользовательским именем пользователя/паролем

В случае нестандартного имени пользователя и/или пароля вас попросят ввести их в процессе установки в командной строке.

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 
Запуск службы...Windows 10
Текущая папка = 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

← Все новости