Обслуживание

Запуск и остановка

После установки Apiary работает как systemd сервис. Поэтому, управлять им можно так же, как обычным systemd сервисом:

Статус systemd сервиса Apiary:
```
systemctl status hw-fh
```
Останов Apiary:
```
systemctl stop hw-fh
```
Старт Apiary:
```
systemctl start hw-fh
```
Рестарт Apiary:
```
systemctl restart hw-fh
```

После рестарта машины сервис так же автоматически запускается как обычный systemd сервис, после успешного старта docker.

⚠️ Обратите внимание, что в случае изменения конфигурации простого рестарта недостаточно! Для того, что бы изменения вступили в силу требуется реконфигурация.

Установка обновлений

Чтобы обновить Apiary:

Скачайте установочный файл на целевую машину аналогично тому, как делали это в процессе инсталляции.
Запустите установку, так же как вы делали в процессе инсталляции.

Во время установки обновлений, сперва будет сохранена резервная копия Apiary (это может занимать значительное времени). Подробнее про резервные копии Apiary можете прочитать здесь. После этого будет установлено обновление.

После установки обновлений - Apiary автоматически запустится. - Соединения между проектами (Hive и Apiary) должно автоматически восстановиться, однако для этого может потребоваться время.

Если чего-то из этого не произошло, смотрите главу "Диагностика неполадок".

Реконфигурация

Для изменения конфигурации Apiary вы можете изменять файл /opt/hw-fh/config/user.ini.

Для применения изменений, которые вы сделали в файле user.ini нужно выполнить команду:

/opt/hw-fh/bin/reconfig

⚠️ Обратите внимание:

Есть несколько свойств, изменение которых не требует выполнения reconfig. В этих случаях в документации будет помечено особым образом. Если не сказано ничего другого, то reconfig обязателен.
Файлы defaults.ini и local.ini в директории /opt/hw-fh/config/ не предназначены для изменения пользователем. Файл defaults.ini будет обновляться при каждом обновлении Apiary. Файл local.ini содержит техническую информацию и может обновляться при каждой реконфигурации Apiary.
Список всех свойств, которые можно задавать в user.ini вы можете найти в файле user-template.ini в той же директории. Подробнее о некоторых наиболее важных из них описано в различных параграфах в главе Настройки.

Возможно, наиболее важные настройки: - настройка портов; - настройка https для доступа Apiary; - добавление корневого сертификата для TLS доступа к сторонним системам при настройке интеграции.

Удаление

Если, по какой-то причине, вам требуется удалить Apiary с машины, вы можете сделать следующее:

Остановите Apiary:
```
systemctl stop hw-fh
```
Удалите systemd сервис:
```
systemctl disable hw-fh
```
Удалите директорию с Apiary:
```
rm -rf /opt/hw-fh
```
Удалите директорию с резервными копиями:
```
rm -rf /opt/hw-fh_backup
```