6 Устранение неисправностей "Спектра"

6.1 Не открывается веб-интерфейс "Спектра"

6.1.1 Описание неисправности

В браузере отображается сообщение об ошибке браузера, например "Unable to connect".

6.1.2 Способ устранения

Проверить корректность указания порта и протокола в адресной строке браузера. При использовании протоколов HTTP и HTTPS порт "Спектра" по умолчанию 8092. Ниже приведены корректные способы указания адреса "Спектра" в браузере:
- 192.168.190.136/clusters
- https://192.168.190.207:8092/clusters
Если адрес введен корректно, проверить статус веб-сервера Nginx на хосте "Спектра", выполнив команду:
```
systemctl status nginx
```
Если статус веб-сервера отличается от active (running), запустить веб-сервер командой:
```
systemctl start nginx
```

6.2 В веб-интерфейсе отсутствуют данные об объектах управления

6.2.1 Описание неисправности

Веб-интерфейс "Спектра" открывается, но в списке кластеров, узлов, сервисов отображается сообщение "Нет данных", хотя ранее данные были.

6.2.2 Способ устранения

На хосте "Спектра" проверить статус СУБД PostgreSQL командой:
```
systemctl status postgresql
```
Если статус отличается от active (running), запустить веб-сервер командой:
```
systemctl start postgresql
```
Если в выводе статуса присутствуют сообщения о том, что закончилось свободное место на диске, необходимо освободить место на диске. Например, могут быть удалены или перемещены на другой диск старые файлы логов "Спектра", расположенные в папке /var/log/spectrum. После очистки места на диске повторить запуск PostgreSQL, см. п. 1.

6.3 В веб-интерфейсе отображаются сообщения об ошибках при получении данных

6.3.1 Описание неисправности

При открытии страницы "Спектра" появляются сообщения об ошибках:

Произошла ошибка при получении данных.

API: /nodes?page=1&size=100

Код: 502
Произошла ошибка при получении данных.

API: /clusters?page=1&size=100

Код: 502

6.3.2 Способ устранения

На хосте "Спектра" проверить статус сервиса spectrum-api:
```
systemctl status spectrum-api
```
Если статус отличается от active (running), запустить сервис командой:
```
systemctl start spectrum-api
```
Проверить работоспособность веб-сервера Nginx. См. описание неисправности "Не открывается веб-интерфейс "Спектра"".
Проверить содержание конфигурационных файлов "Спектра".

6.4 В веб-интерфейсе отображаются устаревшие данные об объектах управления

6.4.1 Описание неисправности

В веб-интерфейсе "Спектра" отображаются статусы объектов управления, не соответствующие реальным статусам объектов. Например, в "Спектре" отображается статус узла "Резерв", а в выводе команды управления кластерным ПО Pacemaker/Corosync pcs status статус узла `Online".

6.4.2 Способ устранения

На хосте "Спектра" проверить статус сервиса spectrum-scheduler, отвечающего за обновление данных об объектах управления в "Спектре":
```
systemctl status spectrum-scheduler
```
Если статус отличается от active (running), запустить сервис командой:
```
systemctl start spectrum-scheduler
```
Если сервис spectrum-scheduler работает корректно, то необходимо проверить доступность узлов кластера с хоста "Спектра".

Для этого через веб-интерфейс получить IP-адреса узлов кластера, через которые "Спектр" осуществляет управление кластером, они отображаются на странице, доступной через пункт левого меню "Узлы".

С хоста "Спектра" при помощи команды ping проверить доступность узла:
```
ping 192.168.190.71
```
Если в выводе команды ping присутствуют сообщения о недоступности узла –- устранить проблему сетевой связности между хостом "Спектра" и узлом кластера.
Если узел доступен с хоста "Спектра", на узле необходимо проверить статус Агента "Спектра":
```
systemctl status spectrum-agent
```
Если статус отличается от active (running), запустить сервис командой:
```
systemctl start spectrum-agent
```

6.5 Операция завершается с сообщением об ошибке Агента "Спектра"

6.5.1 Описание неисправности

При запуске операций над объектами управления одна из задач завершается с сообщениями об ошибках выполнения запросов к Агенту "Спектра".

6.5.2 Способ устранения

На всех узлах кластера, над которым выполнялась операция, проверить статус Агента "Спектра" и при необходимости запустить сервис spectrum-agent, см. шаг 3 в разделе "В веб-интерфейсе отображаются устаревшие данные об объектах управления".

6.6 Не запускается PgAdmin

6.6.1 Описание неисправности

После запуска скрипта установки PgAdmin не отображаются контейнеры в статусе UP и выводится сообщение "after fixing and launching containers succesfully, delete them and relaunch this script".

6.6.2 Способ устранения:

Выполнить команду
```
docker ps -a
```
Если в выводе команды отсутствует контейнер, созданный несколько минут назад, и на машине, на которую устанавливался PgAdmin используется сеть 172.22.0.0 с маской 16 или больше, перейти ко второму шагу.
Открыть файл /pgadmin_dist-9.3/.env и заменить в параметрах

PGADMIN_CONTAINER_IP_ADDRESS=172.22.0.3 PGADMIN_CONTAINER_IP_SUBNET=172.22.0.0/16

адреса на неиспользуемые на Машине, после чего перезапустить установку PgAdmin.