Диагностика и решение неисправностей

Статья описывает решение проблем, которые могут возникать во время установки модуля BI. Причина ошибки отображается в интерфейсе и сохраняется в файл /usr/local/mgr5/var/bi_installer.log на сервере с модулем.

В процессе установки возникли ошибки

Подключитесь к серверу с модулем BI по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.
Просмотрите файл логов установки:
```
cat /usr/local/mgr5/var/bi_installer.log
```
Устраните проблему и повторите установку модуля до получения уведомления об успешном завершении.

Caused by: response error: Captcha check failed, try again

Выключите ReCAPTCHA.

Caused by: response error: Access from this IP denied

Проверьте ограничения по IP-адресам для сотрудника, под которым выполнена интеграция.

Добавьте адрес внешнего сервера, на котором установлен модуль BI-системы, в список IP-адресов сотрудника.

Error: Type: already_exists

Если не удаётся включить доступ администратора в настройках модуля BI, проверьте, чтобы не было пользователей с двумя одинаковыми почтовыми ящиками. Измените повторяющийся почтовый ящик и включите нужные права для пользователя.

Модуль BI не появился в интерфейсе BILLmanager

Подключитесь к серверу с модулем BI по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.
Проверьте в лог-файлах /usr/local/mgr5/ etc/business_intelligence/ansible/logs/install_[дата]-*.log наличие записи:
```
TASK [Start BI app] ************************************************************

changed: [bi-host]
```

Выполните команды:

docker ps -a
docker network inspect bi-net

Установка прошла успешно, если в ответе присутствуют контейнеры bi-app, data-warehouse, etl.

Чтобы модуль BI отображался в интерфейсе BILLmanager, укажите в файле конфигурации /usr/local/mgr5/ etc/billmgr.conf параметры:

BIHost — адрес сервера с модулем BI;
BIPassword — пароль учётной записи администратора BI.

Ошибка "Mysql error: Failed to connect"

Описание ошибки: Модуль не может подключиться к базе данных BILLmanager.

Если модуль BI установлен на сервере с IP-адресом в приватной сети (например, с доступом через VPN), тогда у BILLmanager будут два IP-адреса: публичный и приватный. При установке модуля BI будет использован публичный IP-адрес BILLmanager. Компонент ETL для подключения к базе данных BILLmanager будет использовать публичный IP-адрес вместо приватного.

Чтобы исправить ошибку с подключением к базе данных, измените в настройках публичный IP-адрес на приватный:

Подключитесь к серверу с платформой по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.

Измените правило в firewalld:

firewall-cmd --zone=bi --add-source=<приватный_ip_адрес>

Удалите публичный IP-адрес из правила:

firewall-cmd --zone=bi --remove-source=<публичный_ip_адрес>

Перезапустите firewalld:
```
systemctl restart firewalld
```
Измените значение host для пользователя BI в mysql:
Откройте консоль mysql
```
mysql
```
Измените значение host для пользователя BI
```
UPDATE mysql.user SET host = '<приватный_ip_адрес>' WHERE user = 'bi' ;
FLUSH PRIVILEGES;
```
Закройте консоль mysql
```
exit
```
Замените в файле /usr/local/mgr5/etc/business_intelligence/ansible/vars.json значение параметра bill_db_host c localhost на приватный IP-адрес.
Запустите скрипт установки из директории /usr/local/mgr5/:
```
./etc/business_intelligence/ansible/run.sh install
```

В логах вместо ошибки Mysql error: Failed to connect будет сообщение об успешном подключении Datasource 'billmgr_db' added.

Ошибка "iptables: No chain/target/match by that name"

Чтобы исправить ошибку:

Подключитесь к серверу с модулем BI по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.

Остановите работу контейнеров:

docker stop etl
docker stop bi-app
docker stop data-warehouse

Удалите контейнеры:

docker rm etl
docker rm bi-app
docker rm data-warehouse

Удалите сеть docker:
```
docker network rm bi-net
```
Перезапустите docker:
```
systemctl restart docker
```
Установите модуль BI из веб-интерфейса BILLmanager. Подробнее см. в статье Установка модуля BI и настройка прав пользователей.