Avanpost CA : 3. Обновление Avanpost CA

Назначение

Раздел содержит инструкции по обновлению Avanpost CA из дистрибутива в поддерживаемой Linux ОС.

Обновляемые компоненты

PostgreSQL-совместимая СУБДОбновление схемы БД, выполнение миграций
Avanpost CAОбновление конфигурационных и исполняемых файлов приложения

Предварительные требования

Перед обновлением необходимо:

  • проверить поддерживаемый путь обновления;

  • изучить Release Notes всех затрагиваемых версий;

  • создать резервную копию БД и конфигурации;

  • проверить восстановление;

  • выполнить обновление на тестовом контуре;

  • зафиксировать текущую версию приложения и БД;

  • определить допустимое время простоя;

  • проверить совместимость ОС, СУБД, Vault, криптопровайдера и HSM;

  • подготовить план отката.

Предварительные условия:

  • получен дистрибутив с обновлением Avanpost CA;
  • получена контрольная сумма или электронная подпись дистрибутива;

1. Проверка дистрибутива

Проверьте имя и размер файла:

ls -lh <DISTRIBUTION_FILE>

Если вместе с дистрибутивом предоставлен файл SHA-256:

sha256sum -c <CHECKSUM_FILE>

Ожидаемый результат:

<DISTRIBUTION_FILE>: OK

Если контрольная сумма или подпись не совпадает, не продолжайте установку.

2. Распаковка дистрибутива

Сначала просмотрите содержимое:

unzip -l <DISTRIBUTION_FILE>

Распакуйте дистрибутив:

sudo unzip <DISTRIBUTION_FILE> -d /opt/avanpost

Назначьте владельца:

sudo chown -R avanpost:avanpost /opt/avanpost
sudo find /opt/avanpost -type d -exec chmod 750 {} \;

Не применяйте массовый chmod к закрытым ключам. Для них должны использоваться права 600.

3. Проверка исполняемых файлов

Пути в текущем дистрибутиве:

/opt/avanpost/ca/ca
/opt/avanpost/tools/migratetool/migratetool

Проверьте наличие:

sudo test -x /opt/avanpost/ca/ca
sudo test -x /opt/avanpost/tools/migratetool/migratetool

Если структура отличается, используйте пути из поставляемой инструкции.

4. Выполнение миграции

При обновлении перед миграцией обязательна резервная копия.

Запустите миграцию с переменными окружения приложения:

sudo -u avanpost bash -c '
  set -a
  source /opt/avanpost/ca/config/env
  set +a
  /opt/avanpost/tools/migratetool/migratetool
'

Ожидаемый результат должен содержать сообщение об успешном завершении миграции.

Если миграция завершилась с ошибкой:

  • не запускайте приложение;
  • сохраните журнал;
  • проверьте строку подключения;
  • проверьте права роли БД;
  • проверьте версию PostgreSQL;
  • при повторной установке восстановите БД из резервной копии.

5. Проверка прав

sudo find /opt/avanpost -maxdepth 3 -printf "%M %u:%g %p\n"

Проверьте, что:

  • файлы принадлежат avanpost:avanpost;
  • конфигурация доступна только владельцу;
  • закрытые ключи, если они уже созданы, имеют права 600;
  • каталоги не доступны на запись посторонним пользователям.

Критерии готовности

  • контрольная сумма дистрибутива проверена;
  • дистрибутив размещен в /opt/avanpost;
  • исполняемые файлы доступны;
  • конфигурация имеет права 600;
  • миграция завершена успешно.

Обсуждение