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

Статья описывает решение проблем, которые могут возникать во время установки модуля BI.

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

Перейдите в раздел Состояние системы → Уведомления:

Выберите уведомление → кнопка Подробности. В поле Дополнительно будет описание проблемы.
Устраните проблему и повторите установку модуля до получения уведомления об успешном завершении.

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.
Проверьте в лог-файлах /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, укажите в файле конфигурации /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-адрес на приватный:

Подключитесь к серверу с BILLmanager по 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.

Подключение модуля BI к базе данных BILLmanger

Если вы используете дубликат базы данных BILLmanager, который расположен на другом сервере:

Подключитесь к серверу с дубликатом базы данных BILLmanager по SSH.

Добавьте правило в firewalld:

firewall-cmd --zone=bi --add-source=<ip_адрес_сервера_с_bi>

Перезапустите firewalld:
```
systemctl restart firewalld
```

Добавьте пользователя в mysql:

Откройте консоль mysql

mysql

CREATE USER 'bi'@'адрес_сервера_с_bi' IDENTIFIED BY 'пароль';

GRANT SELECT on billmngr.* TO 'bi'.'адрес_сервера_с_bi' WITH GRANT OPTION;

FLUSH PRIVILEGES;

Закройте консоль mysql

exit

Подключитесь к серверу с BILLmanager по SSH.
Укажите в файле /etc/business_intelligence/ansible/vars.json новые значения для параметров bill_db_host, bill_db_port, bill_db_password.
Запустите скрипт установки из директории /usr/local/mgr5/:
```
./etc/business_intelligence/ansible/run.sh install
```

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

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

Подключитесь к серверу с модулем BI по 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.