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

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

После установки 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.

Чтобы эти изменения вступили в силу, выполните команду:

/opt/hw-fh/bin/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
```