Обновление ADB ES

Антон Васильев

Содержание

Запуск обновления
Настройка GID для группы ADB ES при обновлении до 1.2.0
Перенос Advanced-параметров
- Пример переноса параметра

ПРИМЕЧАНИЕ

Обновление ADB ES поддерживается только между версиями, дата выпуска которых отличается не более чем на один год. Если разница между датами выпуска исходной и целевой версий превышает год, выполните последовательное обновление через хотя бы одну промежуточную версию (если нет иных требований в прошедших релизах).
При обновлении с версий, в которых ADB Control и ADBM были частью бандла ADB, следуйте процедуре, описанной в статье Миграция метаданных ADB Control и ADBM при установке ADB ES.

Запуск обновления

Для обновления кластера ADB ES выполните следующие шаги:

Загрузите бандл ADB ES нужной версии (см. раздел Загрузка бандла в ADCM в статье Создание кластера). В результате информация о бандле отображается на странице Bundles в ADCM.

Бандл ADB ES на странице Bundles
На странице Clusters нажмите на иконку в строке с кластером ADB ES, который требуется обновить. Иконка становится активной после успешной загрузки бандла на предыдущем шаге. При этом версия загруженного бандла должна быть больше, чем текущая версия кластера.

Иконка Upgrade
В открывшемся диалоговом окне выберите версию бандла в поле Upgrade to version и нажмите Upgrade.

Запуск подготовки к обновлению
Подтвердите действие в открывшемся окне, нажав Run.

В результате запускается задача подготовки к обновлению Upgrade: <bundle_version>, где <bundle_version> — выбранная версия бандла, например Upgrade: 1.1.0_b2 (enterprise). В случае успешного выполнения задачи кластер ADB ES переводится в статус ready to upgrade.
На странице Clusters нажмите на иконку в столбце Actions и выберите действие Upgrade.

Выбор действия Upgrade

При обновлении ADB ES с 1.1.1 (или более ранней версии) до 1.2.0 (или более поздней версии), в форме действия Upgrade можно указать GID системной группы adbes.
Подтвердите действие в открывшемся окне, нажав Run.

Подтверждение действия Upgrade

В результате запускается задача Upgrade. Для просмотра прогресса обновления конкретных компонентов можно воспользоваться вкладкой Jobs.

Прогресс действия Upgrade

В случае успешного обновления кластер ADB ES переводится в статус installed, а его версия актуализируется в столбце Version на странице Clusters. Если обновление закончилось ошибкой, проверьте логи в деталях задачи Upgrade на наличие ошибок.

Действие Upgrade завершено

ПРИМЕЧАНИЕ

Бандл ADB ES может также включать в себя обновления для агентов ADBC и ADBM. Чтобы обновить их на новую версию, после обновления ADB ES запустите действие Reinstall в соответствующих сервисах ADBC agents и ADBM agents во всех кластерах ADB, связанных с обновленным кластером ADB ES.

Настройка GID для группы ADB ES при обновлении до 1.2.0

Для корректной работы SSL файлы сертификатов должны иметь владельцев и группы в соответствии с разделом Manage SSL. В ADB ES 1.2.0 была введена системная группа adbes, которая используется в качестве группы-владельца файлов keystore и truststore, используемых сервисами ADB Control, ADBM и AD Eureka.

При обновлении ADB ES с 1.1.1 (или более ранней версии) до 1.2.0 (или более поздней) бандл автоматически создает системную группу adbes с указанным GID (по умолчанию — 3033). Перед обновлением необходимо назначить этот GID файлам keystore и truststore на каждом хосте, где установлены ADB Control, ADBM и AD Eureka.

Если вы использовали переменные окружения для настройки SSL для ADBM (например, ADBM_CORE_SSL_KEY_STORE и ADBM_CORE_SSL_TRUST_STORE), удалите их.
Назначьте GID требуемым файлам keystore и truststore. Например:
```
$ chgrp 3033 /opt/ssl/adcc-server/truststore.p12 /opt/ssl/adcc-server/keystore.p12
```
Запустите процесс обновления.
В форме действия Upgrade в поле ADB ES group GID введите указанный идентификатор, например 3033.

Поле ADB ES group GID в действии Upgrade
Нажмите Next, а затем Run, чтобы завершить обновление. Во время обновления бандл создаст группу adbes с указанным GID.

ВАЖНО

Если вы не назначите указанный GID требуемым файлам keystore и truststore, задача обновления в ADCM завершится успешно, но сервис миграции ADBM завершит работу с ошибкой. В этом случае назначьте GID требуемым файлам после обновления и затем запустите кластерное действие Manage SSL.

Перенос Advanced-параметров

При обновлении с ADB 6.29.1 или более ранней версии, может потребоваться перенос параметров тонкой настройки (Advanced-параметров) в новый формат. В ADB 6.29.1 и ранее такие параметры настраивались в формате YAML в группе Advanced parameters сервисов ADB Control и ADBM кластера ADB.

В ADB ES Advanced-параметры находятся в соответствующих сервисах кластера ADB ES, как показано в таблицах ниже. Параметры агентов находятся в соответствующих кластерах ADB.

Advanced-параметры ADB Control
Параметр (ADB 6.29.1 и ранее)	Текущий сервис	Текущее расположение
Backend app parameters	ADB Control	Backend parameters
Registry app parameters	AD Eureka	Registry parameters
UI server app parameters	ADB Control	UI component parameters
Scheduler app parameters	ADB Control	ADB Control scheduler param
Migration app parameters	ADB Control	Database migration parameters
ADB Control agent properties	ADBC agents	Подключенный кластер ADB
ADB Control agent hazelcast properties	ADBC agents	Подключенный кластер ADB

Advanced-параметры ADBM
Параметр (ADB 6.29.1 и ранее)	Текущий сервис	Текущее расположение
Backend app parameters	ADBM	Backend parameters
Backend auth properties	ADBM	Backend parameters
Migration app parameters	ADBM	Database migration parameters
ADBM agent properties	ADBM agents	Подключенный кластер ADB

Для каждого компонента доступен следующий набор параметров:

Поле app parameters (например, Backend app parameters в ADB Control), в котором содержатся переменные окружения в виде ${ENV_VAR:default}. Поле можно использовать как справочник для получения списка возможных переменных.
Секция environment key-value (например, Backend server app environment key-value), которую можно использовать для кастомизации значений переменных.

ПРИМЕЧАНИЕ

Для агентов поле со списком возможных переменных доступно в соответствующем серверном компоненте: ADB Control и ADBM.
Параметры logback на данный момент не имеют собственной секции в ADCM. Для изменения уровня логирования используйте параметр Log level в каждом из компонентов.

Пример переноса параметра

Чтобы перенести значение параметра, скопируйте его и определите имя переменной, к которой это значение должно быть применено. Например, чтобы перенести значение параметра moveToActiveTimeoutSeconds:

В кластере ADB (версии 6.29.1 и более ранней) на вкладке Services выберите сервис ADB Control, установите флаг Advanced и разверните группу Advanced parameters.
Откройте группу параметров ADB Control agent properties (в формате YAML), найдите нужный параметр (moveToActiveTimeoutSeconds в этом примере) и скопируйте его значение.

ADB Control agent properties в 6.29.1 и более ранних версиях
Чтобы найти имя переменной, которое нужно использовать в ADB ES, перейдите в кластер ADB ES, выберите сервис ADB Control, нажмите на поле ADCC agents environment reference file (доступное только для чтения) и выполните поиск по moveToActiveTimeoutSeconds.

ADCC agents environment reference file

Файл содержит следующий фрагмент:
```
    queryIdCache:
      moveToActiveTimeoutSeconds: ${ADCC_QUERY_ID_CACHE_MOVE_TO_ACTIVE_TIMEOUT_SECONDS:5}
```
Значит, имя переменной, которое нужно использовать в ADB ES — ADCC_QUERY_ID_CACHE_MOVE_TO_ACTIVE_TIMEOUT_SECONDS.
Поскольку это параметр уровня агента, откройте подключенный кластер ADB, обновленный до более новой версии.
На вкладке Services выберите сервис ADBC agents и перейдите в ADB control agent parameters.
В разделе Environment key-value нажмите Add property и введите ADCC_QUERY_ID_CACHE_MOVE_TO_ACTIVE_TIMEOUT_SECONDS в качестве имени переменной и требуемое значение в секундах.

Добавление свойства сервиса ADBC agents

В результате параметры сервиса ADBC agents выглядят подобным образом:

Итоговые настройки сервиса ADBC agents
Нажмите Save и запустите действие Reconfigure and restart сервиса ADBC agents, чтобы применить изменения.

Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней