Главная
Arenadata DB
Базовые операции
Управление кластером
Управление кластером через ADCM
Кластерные действия

Кластерные действия

Дарья Барышева

Свернуть контент Развернуть контент

Обзор

Управление кластером ADB осуществляется на странице Clusters в web-интерфейсе Arenadata Cluster Manager (ADCM).

Страница Clusters

Страница Clusters содержит таблицу со следующими столбцами:

Name — имя, присвоенное кластеру при создании.
State — текущий статус кластера.
Product — имя продукта.
Version — версия продуктового бандла, который был использован для установки или последнего обновления кластера.
Description — описание кластера, указанное при его создании.
Concerns. Если в конфигурации кластера обнаружены критичные ошибки или запущено блокирующее действие, в столбце отображается иконка — при наведении на нее курсора показывается окно с описанием ошибки и ссылкой, по которой можно перейти, чтобы выполнить необходимую настройку или получить подробную информацию.
Actions. В столбце показываются иконки для управления кластером:
- — открывает список действий, доступных для работы с кластером.
  
  Открытие списка доступных действий
- — указывает, доступна ли новая версия бандла, и позволяет запустить обновление кластера до новой версии.
- — удаляет информацию о кластере из ADCM (не удаляет ADB и не производит никаких изменений на хостах, относящихся к кластеру).

Используя приведенные выше иконки, можно запускать соответствующие кластерные действия в ADCM. При выборе действия отображается диалоговое окно для его подтверждения. В этом диалоговом окне можно установить флажок Verbose, чтобы просмотреть дополнительную информацию о выполнении действия на странице Jobs. Для некоторых действий предварительно требуется ввести дополнительные параметры в отдельном окне.

Стандартное окно для подтверждения всех действий

После того как действие запущено, ADCM отображает процесс его выполнения и результат на странице Jobs. С этой страницы можно перейти на страницу отдельной задачи (кликнув по имени задачи), чтобы увидеть внутренние этапы ее выполнения и проанализировать ошибки в случае их возникновения.

Страница задачи

Набор кластерных действий (доступных при нажатии иконки actions default dark actions default light ) определяется текущим статусом кластера ADB.

Доступные действия в зависимости от статуса ADB
Статус	Условие	Доступные действия
created	Кластер ADB создан в ADCM, но еще не установлен	Precheck Install
running	Кластер ADB успешно установлен в ADCM и запущен	Activate standby Check Expand Init Standby Master Reconfigure Vault integration Reconfigure parameter archiving Reinstall Reinstall statuschecker Stop
stopped	Кластер ADB успешно установлен в ADCM и остановлен	Activate standby Check Reinstall Reinstall statuschecker Start
activating_standby	В результате выполнения действия Activate standby активация резервного мастера выполнена успешно, но в процессе последующей настройки возникли некоторые ошибки	Activate standby postprocess
expanding	Выполнено расширение кластера с помощью действия Expand. Требуется перераспределение таблиц	Redistribute
ready to upgrade	Проведена подготовка кластера ADB к обновлению — путем запуска действия, доступного после нажатия на иконку	Upgrade

Действия Precheck и Install подробно описаны в статье Установка кластера. Прочие действия, доступные для уже установленного кластера, приведены ниже.

Activate standby

Действие Activate standby активирует резервный (Standby) мастер в случае сбоев на действующем мастере.

ВАЖНО

Активация Standby-мастера возможна, когда хост действующего мастера недоступен. Если же хост мастера доступен, для переключения на Standby необходимо предварительно остановить сервис ADB и установить флаг force activation в параметрах действия Activate standby. В иных случаях запуск действия завершается ошибкой.
При выполнении действия Activate standby сервисы ADB Control и ADBM должны быть запущены, т.к. требуется их реконфигурация. В противном случае запуск действия завершается ошибкой (однако ошибку можно исправить, запустив сервисы и применив действие Activate standby postprocess).

При выборе действия Activate standby открывается диалоговое окно, в котором можно указать следующие параметры:

force activation — флаг, определяющий необходимость принудительного переключения на резервный мастер, когда хост действующего мастера доступен, но процесс мастера внутри операционной системы остановлен;
run analyze — флаг, определяющий необходимость запуска ANALYZE после переключения на резервный мастер во всех базах кроме template0, template1 и postgres.

Окно для ввода параметров действия Activate standby

Для редактирования какого-либо параметра нажмите на его текущее значение и в открывшемся окне выберите новое значение, после чего нажмите кнопку Apply.

Ввод нового значения параметра

Для запуска действия Activate standby нажмите Run в исходном окне с параметрами, а затем подтвердите действие в открывшемся стандартном окне.

Во время выполнения действия кластер ADB находится в статусе activating_standby. Если действие завершается успешно, кластер переводится в статус running. Если активация Standby выполнена, но в процессе последующей настройки возникают некоторые ошибки — кластер остается в статусе activating_standby, а в списке кластерных действий становится доступно действие Activate standby postprocess. В этом случае необходимо определить причину ошибки на странице Jobs, внести необходимые исправления и запустить Activate standby postprocess.

Постобработка

Для того чтобы на новом мастере были созданы необходимые cron-задачи, примените следующие действия после завершения Activate standby:
- Действие Reconfigure parameter archiving для кластера ADB — чтобы выгружать конфигурации ADB в соответствии с расписанием, настроенным с помощью кластерных параметров Parameter archiving/Parameter archiving job setting.
- Действие Reconfigure для сервиса ADB — чтобы запускать скрипты, взаимодействующие со схемой arenadata_toolkit.
После того, как хост прежнего мастера вновь станет доступен (или сразу после завершения действия Activate standby, если переключение на резервный мастер не связано с недоступностью этого хоста), выполните на нем следующие шаги:
- Удалите задачи cron, подключившись к хосту под администратором ADB (gpadmin по умолчанию). Это необходимо для предотвращения обращений к незапущенному процессу устаревшего мастера:
  $ sudo su - gpadmin $ crontab -r
- Переименуйте или удалите каталог мастера (/data1/master по умолчанию) для того, чтобы случайно не запустить устаревший мастер и иметь возможность расположить на этом хосте новый резервный мастер в будущем.
После переключения на Standby-мастер старый мастер перестает участвовать в работе кластера ADB. При этом резервного мастера больше нет, так как он стал основным. Для создания нового Standby-мастера необходимо запустить действие Init Standby Master.

Activate standby postprocess

Действие Activate standby postprocess становится доступно, если в результате выполнения Activate standby активация резервного мастера проведена успешно, но в процессе последующей настройки возникли некоторые ошибки. После их устранения необходимо запустить Activate standby postprocess, чтобы завершить обработку и перевести кластер ADB в работающее состояние (running).

При выборе действия Activate standby postprocess открывается диалоговое окно, в котором можно указать параметр run analyze, описание которого приведено выше для действия Activate standby.

Окно для ввода параметров действия Activate standby postprocess

Для запуска действия Activate standby postprocess нажмите Run в окне с параметрами, а затем подтвердите действие в открывшемся стандартном окне.

Init Standby Master

Действие Init Standby Master предназначено для добавления либо удаления резервного (Standby) мастера из кластера ADB. После выбора действия необходимо выполнить следующие шаги:

На вкладке Configuration открывшегося окна заполните параметры:
- Reboot new servers after installation — флаг, определяющий необходимость автоматической перезагрузки хостов ADB после выполнения действия Init Standby Master. Если флаг сброшен, перезагрузку потребуется выполнить вручную.
- Reboot timeout, sec — время ожидания перезагрузки хостов (в секундах).
  
  Окно для ввода параметров действия Init Standby Master
  
  Для редактирования какого-либо параметра нажмите на его текущее значение и в открывшемся окне выберите новое значение, после чего нажмите кнопку Apply.
  
  Ввод нового значения параметра
Нажмите Next.

На открывшейся вкладке Host - Component выполните одной из действий:

При добавлении резервного мастера — разместите компонент ADB Standby на отдельном хосте. Для этого нажмите Add hosts в секции компонента и выберите хост в открывшемся диалоговом окне.

ПРИМЕЧАНИЕ

Для размещения Standby-мастера можно использовать хост, на котором ранее располагался основной мастер — до применения действия Activate standby. Для этого требуется предварительно переименовать или удалить каталог мастера (/data1/master по умолчанию) на выбранном хосте.

Добавление Standby Master

При удалении резервного мастера — нажмите Remove для хоста, назначенного компоненту ADB Standby.

Удаление Standby Master

Нажмите Run.
Подтвердите действие в открывшемся стандартном окне, нажав Run.

Expand

Действие Expand осуществляет расширение кластера ADB путем добавления новых сегмент-хостов.

Подготовка

Перед началом выполнения расширения кластера:

Создайте и настройте необходимые хосты на странице Hosts в ADCM, используя один из доступных хостпровайдеров.
Для каждого созданного хоста примените действия Check connection и Install statuschecker. Проверьте, что действия завершены успешно и все хосты доступны.
Убедитесь, что хосты добавлены в выбранный кластер ADB.

Новые хосты на странице Hosts

ВНИМАНИЕ

Если в кластере ADB используется зеркалирование (mirroring), число новых хостов должно быть достаточным для применения одной из его политик: spread или group. Если количество новых хостов больше числа сегментов на хост в используемой конфигурации, во время расширения кластера применяется spread-зеркалирование, иначе — group. При использовании политики зеркалирования group требуется не менее 2 новых хостов, в противном случае запуск действия завершится ошибкой: Not enough hosts for grouped mirroring. You must have at least 2.

Запуск действия

После выбора действия Expand необходимо выполнить следующие шаги:

На вкладке Configuration открывшегося окна переведите в активное состояние переключатель Show advanced и заполните приведенные ниже параметры:
- Reboot new servers after installation — флаг, определяющий необходимость автоматической перезагрузки хостов ADB с новыми компонентами после выполнения действия Expand. Перезагрузка требуется для применения значений некоторых параметров, изменяемых в процессе установки. Если флаг сброшен, перезагрузку потребуется выполнить вручную.
- Reboot timeout, sec — время ожидания перезагрузки хостов (в секундах).
- Additional primary segments count — количество primary-сегментов, которые необходимо дополнительно добавить на все хосты в кластере (включая уже существующие). Например, если в исходной конфигурации указано два primary-сегмента на хост и значение параметра 2 — на уже существующие хосты кластера будут добавлены два дополнительных primary-сегмента, на новые — четыре. Дополнительно, если в кластере используется зеркалирование, для каждого нового primary-сегмента также будут добавлены mirror-сегменты. Если увеличение количества сегментов не требуется, следует оставить значение по умолчанию — 0.
- Attach new data catalog (optional) — директория, которая будет использоваться для хранения данных новых сегментов. Все используемые data-каталоги должны содержать одинаковое количество сегментов во избежание неравномерной нагрузки на дисковую подсистему. В ином случае подготовка к расширению завершается ошибкой. Если поле не заполнено (по умолчанию), сегменты равномерно распределяются по существующим каталогам данных.
- Storage for data catalog (optional) — имя блочного устройства хранения данных для монтирования к директории Attach new data catalog (optional) на новых сегмент-хостах. Например, sdc (без указания префикса /dev).
- Specify path for every non-default tablespace — пути к директориям для хранения данных табличных пространств (tablespace). Пути необходимо указать, если заполнен параметр Attach new data catalog (optional).
- Check array — флаг, определяющий необходимость проверки того, что все сегмент-хосты имеют одинаковое количество primary-сегментов и сегментов-зеркал, а также одинаковые суффиксы имен сегментов вида -<n> (-1, -2, -3 и т.д.).
- Directory for gpexpand tar file (optional) — полный путь к директории на сегмент-хостах, куда утилита gpexpand копирует временный TAR-архив. Архив содержит файлы базы данных, используемые для создания сегментов. По умолчанию используется домашняя директория пользователя.
  
  Окно для ввода параметров действия Expand
  
  Для редактирования любого параметра (за исключением поля Specify path for every non-default tablespace, описанного ниже) нажмите на его текущее значение и в открывшемся окне выберите новое значение, после чего нажмите кнопку Apply.
  
  Ввод нового значения параметра
  
  Для заполнения параметра Specify path for every non-default tablespace (как и любого иного, представляющего собой массив значений) разверните узел с именем параметра и нажмите Add property. В открывшемся диалоговом окне укажите имя tablespace в поле Enter field name и путь к директории в поле Enter field value. Нажмите Apply для сохранения данных.
  
  Переход к заполнению пути для tablespace
  
  Заполнение пути для tablespace
Нажмите Next.

На открывшейся вкладке Host - Component сопоставьте компоненту ADB Segment новые сегмент-хосты. Для этого нажмите Add hosts в секции компонента и выберите хосты в открывшемся диалоговом окне.

Назначение новых хостов компоненту ADB Segment

ВАЖНО

Если в кластере используются сервисы PXF, Chrony, Monitoring Clients, их компоненты (PXF, NTP Slave, Monitoring Agents) также необходимо разместить на новых сегмент-хостах для корректного функционирования системы.

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

В ходе выполнения действия Expand запускается ряд проверок, после чего на добавленные хосты устанавливаются необходимые пакеты и производится их настройка. Затем в базе данных postgres создается временная схема gpexpand, объекты которой будут использоваться для хранения метаданных о таблицах, подлежащих перераспределению между сегментами кластера. В случае успешного завершения всех шагов действия кластер переводится в статус expanding, и возврат предыдущей конфигурации становится невозможен.

В статусе expanding для кластера становится доступно действие Redistribute, осуществляющее перераспределение данных таблиц между сегментами после расширения кластера. Запуск перераспределения необходим, поскольку в противном случае таблицы продолжат работать в пределах прежних сегмент-хостов без какого-либо увеличения производительности.

Кластер переведен в статус expanding

Синхронизация конфигураций PXF

Если в кластере ADB используется сервис PXF, после выполнения действия Expand необходимо скопировать конфигурационные файлы с профилями PXF на новые сегмент-хосты. В противном случае foreign-таблицы перестанут работать. Для синхронизации PXF-конфигураций на всех сегмент-хостах можно выполнить следующие шаги:

Подключитесь к Master-серверу ADB под пользователем gpadmin, который создается по умолчанию. Все команды, приведенные на шагах ниже, запускаются исключительно на хосте Master:
```
$ sudo su - gpadmin
```
Для синхронизации конфигурационных файлов PXF на всех хостах кластера ADB выполните команду:
```
$ pxf cluster sync
```
Результат:
```
Syncing PXF configuration files from master host to standby master host and 2 segment hosts...
PXF configs synced successfully on 3 out of 3 hosts
```

Перезапустите сервис PXF:

$ pxf cluster restart

Результат:

Restarting PXF on master host, standby master host, and 2 segment hosts...
PXF restarted successfully on 4 out of 4 hosts

Redistribute

Действие Redistribute предназначено для перераспределения данных между сегментами недавно расширенного кластера ADB. При выполнении действия используется Greenplum-утилита gpexpand.

Перед запуском действия рекомендуется выполнить ранжирование таблиц баз данных, т.е. указать, в каком порядке следует перераспределять таблицы.

Ранжирование таблиц перед перераспределением

Приоритет обработки таблиц во время перераспределения определяется их рангом (значением столбца rank) в таблице gpexpand.status_detail. Таблицы с наименьшим рангом будут перераспределяться в первую очередь. Для ранжирования таблиц используйте следующие шаги:

Подключитесь к базе данных postgres кластера ADB под пользователем gpadmin (например, через psql).
Для всех строк таблицы gpexpand.status_detail установите начальное значение столбца rank, который будет считаться максимальным (и соответствовать наименьшему приоритету обработки), например 100:
```
UPDATE gpexpand.status_detail SET rank = 100;
```
Уменьшите значение rank для тех таблиц, которые должны быть перераспределены в первую очередь. Например, следующие запросы приведут к тому, что во время выполнения действия Redistribute первой будет обработана таблица public.test, затем public.test2 и далее все остальные из gpexpand.status_detail.
```
UPDATE gpexpand.status_detail SET rank = 10 WHERE fq_name = 'public.test';
UPDATE gpexpand.status_detail SET rank = 20 WHERE fq_name = 'public.test2';
```

РЕКОМЕНДАЦИЯ

В качестве значения столбца fq_name необходимо указывать полное имя таблицы, включающее название схемы.
При ранжировании таблиц рекомендуется использовать шаг 10, а не 1 — чтобы в случае необходимости можно было быстро повысить приоритет какой-либо таблицы, не затрагивая остальные.
Наибольший приоритет (наименьшее значение rank) следует присвоить тем таблицам, что используются чаще других.
Для исключения таблицы из процедуры перераспределения следует удалить ее из таблицы gpexpand.status_detail.

Запуск перераспределения

Запуск перераспределения осуществляется с помощью кластерного действия Redistribute. Перераспределение рекомендуется выполнять в период низкой нагрузки на базу данных, когда блокировки таблиц не будут оказывать существенного влияния на функционирование кластера.

ВАЖНО

Для выполнения перераспределения на сегмент-хостах должно быть достаточно места для хранения временной копии наибольшей из существующих таблиц/партиций.
Во время перераспределения каждая обрабатываемая таблица или партиция блокируется (с типом блокировки ACCESS EXCLUSIVE) и становится недоступна для операций чтения и записи. После завершения перераспределения возможность операций для этой конкретной таблицы возобновляется.
Новые таблицы и партиции продолжают распределяться по всем сегментам в штатном режиме.

При выборе действия Redistribute открывается диалоговое окно, в котором можно заполнить следующие поля:

Timeout for expanding — максимальная длительность сеанса перераспределения в часах, минутах и секундах.
Number of parallel processes — значение опции -n для утилиты gpexpand. Определяет количество таблиц, перераспределяемых одновременно. Допускаются значения 1 — 96. Для каждого процесса перераспределения требуется два соединения к БД: одно для изменения таблицы и одно для обновления статуса таблицы в схеме gpexpand. Перед увеличением значения Number of parallel processes проверьте значение серверного параметра max_connections и убедитесь, что лимит соединений не исчерпан.

Окно для ввода параметров действия Redistribute

Для запуска действия Redistribute нажмите Run в окне с параметрами, а затем подтвердите действие в открывшемся стандартном окне. Если перераспределение данных всех таблиц завершается в срок, указанный в поле Timeout for expanding, схема gpexpand удаляется из базы данных postgres, а кластер ADB переводится в статус running. Иначе кластер остается в статусе expanding, а продолжить перераспределение можно путем повторного вызова действия Redistribute.

Мониторинг перераспределения

Для отслеживания прогресса перераспределения данных в режиме реального времени можно использовать запросы к следующим объектам схемы gpexpand в базе данных postgres:

gpexpand.status — таблица, отображающая историю изменения статуса процедуры расширения кластера.

Структура

Столбец Описание

status

Статус процедуры расширения кластера ADB. Возможные значения:

SETUP — подготовка к расширению начата в ходе выполнения действия Expand.
SETUP DONE — подготовка к расширению завершена в результате успешного выполнения действия Expand.
EXPANSION STARTED — перераспределение данных начато в ходе выполнения действия Redistribute.
EXPANSION STOPPED — перераспределение данных остановлено. Требуется повторный запуск действия Redistribute.
COMPLETED — перераспределение данных всех таблиц успешно завершено в результате одного или нескольких запусков действия Redistribute.

updated

Дата и время изменения статуса

Пример запроса

SELECT * FROM gpexpand.status;

Результат:

      status       |          updated
-------------------+----------------------------
 EXPANSION STARTED | 2024-02-28 08:02:31.026412
 SETUP DONE        | 2024-02-27 17:40:55.160054
 SETUP             | 2024-02-27 17:40:50.830922
(3 rows)

gpexpand.expansion_progress — представление, отображающее текущий статус перераспределения данных (сколько таблиц/байт уже успешно перераспределено и сколько осталось), а также прогноз скорости и времени завершения перераспределения данных. Прогноз строится один раз при каждом вызове действия Redistribute после обработки первой из таблиц. Статистика по таблицам/байтам обновляется сразу по мере их перераспределения.

ПРИМЕЧАНИЕ

В ADB запуск утилиты gpexpand производится с опцией --simple-progress — с целью повышения производительности расширения кластера путем уменьшения информации, записываемой в таблицы gpexpand. Поэтому в таблице ADB gpexpand.expansion_progress заполняются только поля Tables Expanded и Tables Left.

Структура

Столбец Описание

name

Название метрики:

Bytes Left — объем еще не распределенных данных (в байтах).
Bytes Done — объем успешно перераспределенных данных (в байтах).
Estimated Expansion Rate — прогнозируемая скорость перераспределения данных (с указанием единицы измерения).
Estimated Time to Completion — прогнозируемая длительность перераспределения данных (в часах, минутах и секундах).
Tables Expanded — число успешно перераспределенных таблиц.
Tables Left — число еще не распределенных таблиц.

value

Значение метрики, указанной в столбце name

Пример запроса

SELECT * FROM gpexpand.expansion_progress;

Результат:

      name       | value
-----------------+-------
 Tables Expanded | 90
 Tables Left     | 7
(2 rows)

gpexpand.status_detail — таблица, отображающая текущий статус перераспределения каждой таблицы/партиции.

Структура

Столбец Описание

table_oid

Внутренний идентификатор таблицы (OID)

dbname

Название базы данных, в которой расположена таблица

fq_name

Полное название таблицы с именем схемы

root_partition_oid

Для партиционированной таблицы — OID корневой партиции. Иначе — None

rank

Ранг, определяющий приоритет обработки таблицы во время перераспределения. Таблицы с наименьшим рангом обрабатываются в первую очередь

external_writable

Признак того, что таблица имеет тип EXTERNAL WRITABLE (для таких таблиц применяется иной синтаксис при вызове gpexpand)

status

Текущий статус перераспределения таблицы:

NOT STARTED — перераспределение не начато.
IN PROGRESS — перераспределение выполняется.
COMPLETED — перераспределение завершено.
NO LONGER EXISTS — таблица более не существует.

expansion_started

Дата и время начала перераспределения таблицы. Столбец заполняется после завершения перераспределения

expansion_finished

Дата и время завершения перераспределения таблицы

source_bytes

Размер исходной таблицы (в байтах). Ввиду возможного "вздутия данных" (bloat) в heap-таблицах, а также увеличения числа сегментов в кластере в процессе расширения, не гарантируется, что итоговый размер таблицы останется прежним. Значения данного столбца используются для оценки продолжительности выполнения перераспределения.

В ADB source_bytes=0 для всех таблиц ввиду использования опции --simple-progress

rel_storage

Тип хранения данных в таблице. См. pg_class.relstorage

Пример запроса

SELECT dbname, fq_name, status, expansion_started, expansion_finished, source_bytes FROM gpexpand.status_detail;

Фрагмент вывода:

  dbname   |                        fq_name                        |   status    |     expansion_started      |     expansion_finished     | source_bytes
-----------+-------------------------------------------------------+-------------+----------------------------+----------------------------+--------------
 adb       | kadb.offsets                                          | NOT STARTED |                            |                            |            0
 adb       | arenadata_toolkit.db_files_history_1_prt_p202310      | NOT STARTED |                            |                            |            0
 gpperfmon | public.database_history_1_prt_r1013160842             | NOT STARTED |                            |                            |            0
 gpperfmon | public.log_alert_history_1_prt_r598663655             | NOT STARTED |                            |                            |            0
 gpperfmon | public.log_alert_history_1_prt_r1113542580            | NOT STARTED |                            |                            |            0
 adb       | public.kafka_ssl                                      | NOT STARTED |                            |                            |            0
 adb       | public.adb_to_kafka_table3                            | NOT STARTED |                            |                            |            0
 adb       | arenadata_toolkit.db_files_current                    | NOT STARTED |                            |                            |            0
 adb       | arenadata_toolkit.db_files_history_1_prt_p202312      | NOT STARTED |                            |                            |            0
 gpperfmon | public.database_history_1_prt_r2098142994             | NOT STARTED |                            |                            |            0
 gpperfmon | public.network_interface_history_1_prt_1              | NOT STARTED |                            |                            |            0
 adb       | public.ext_adb_to_kafka_sasl_gssapi                   | NOT STARTED |                            |                            |            0
 adb       | public.adb_to_kafka_table7                            | NOT STARTED |                            |                            |            0
 adb       | arenadata_toolkit.db_files_history_1_prt_default_part | NOT STARTED |                            |                            |            0
 gpperfmon | public.queries_history_1_prt_r81170841                | NOT STARTED |                            |                            |            0
 gpperfmon | public.queries_history_1_prt_r419258856               | NOT STARTED |                            |                            |            0
 gpperfmon | public.diskspace_history_1_prt_r526486693             | NOT STARTED |                            |                            |            0
 adb       | public.test2                                          | COMPLETED   | 2024-02-28 08:02:37.00728  | 2024-02-28 08:02:38.048592 |            0
 gpperfmon | public.system_history_1_prt_r1569528921               | COMPLETED   | 2024-02-28 08:02:41.066986 | 2024-02-28 08:02:44.182122 |            0
 gpperfmon | public.database_history_1_prt_r932188937              | COMPLETED   | 2024-02-28 08:02:44.305985 | 2024-02-28 08:02:44.697928 |            0
 gpperfmon | public.segment_history_1_prt_1                        | COMPLETED   | 2024-02-28 08:02:44.841786 | 2024-02-28 08:02:45.426392 |            0
 diskquota | arenadata_toolkit.db_files_history_1_prt_default_part | COMPLETED   | 2024-02-28 08:02:46.096083 | 2024-02-28 08:02:48.04711  |            0
 adb       | diskquota.target                                      | COMPLETED   | 2024-02-28 08:02:48.166249 | 2024-02-28 08:02:48.602075 |            0
 adb       | arenadata_toolkit.db_files_history_1_prt_p202402      | COMPLETED   | 2024-02-28 08:02:48.73606  | 2024-02-28 08:02:49.505108 |            0

Reinstall

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

Reboot cluster servers after installation — флаг, определяющий необходимость автоматической перезагрузки хостов ADB после выполнения действия Reinstall. Если флаг сброшен, перезагрузку потребуется выполнить вручную.
Reboot timeout, sec — время ожидания перезагрузки хостов (в секундах).

Окно для ввода параметров действия Reinstall

Ввод нового значения параметра

Для запуска действия Reinstall нажмите Run в исходном окне с параметрами, а затем подтвердите действие в открывшемся стандартном окне.

Reinstall statuschecker

Действие Reinstall statuschecker перенастраивает и перезапускает службу проверки состояния (statuschecker) для всех сервисов кластера. Используется в случае миграции кластера под управление нового сервера ADCM.

После выбора действия открывается стандартное окно подтверждения, в котором следует нажать Run. Ввод дополнительных параметров не требуется.

Reconfigure Vault integration

Действие Reconfigure Vault integration предназначено для применения изменений к параметрам Vault integration, редактирование которых доступно на вкладке Configuration на странице кластера. Эти параметры определяют необходимость хранения секретов сервисов ADB в HashiCorp Vault.

ВАЖНО

Перед вводом интеграционных параметров убедитесь, что Vault предварительно установлен и сконфигурирован.
После каждого изменения и сохранения значений параметров из секции Vault integration необходимо запускать кластерное действие Reconfigure Vault integration.
В настоящий момент Vault может использоваться для хранения параметров аутентификации сервисов ADB Control и ADBM.

Reconfigure parameter archiving

Действие Reconfigure parameter archiving предназначено для применения изменений к параметрам Parameter archiving/Parameter archiving job setting, редактирование которых доступно на вкладке Configuration на странице кластера. Эти параметры определяют необходимость выгрузки конфигураций ADB в соответствии с настроенным расписанием.

ВАЖНО

После каждого изменения и сохранения значений полей Parameter archiving и Parameter archiving job setting необходимо запускать кластерное действие Reconfigure parameter archiving.

Check

Действие Check проверяет соответствие настроек хостов, сервисов и компонентов требованиям кластера ADB (аналогично действию Precheck) и дополнительно анализирует, работают ли установленные компоненты кластера правильно.

Start

Действие Start запускает все сервисы остановленного кластера ADB.

После успешного применения действия Start кластер ADB переводится в статус running.

Stop

Действие Stop останавливает все сервисы работающего кластера ADB. При выборе действия открывается диалоговое окно, в котором можно выбрать режим остановки кластера ADB shutdown mode:

fast — принудительная остановка кластера после прерывания и отката выполняющихся транзакций, а также закрытия всех активных соединений. Этот режим используется по умолчанию.
smart — остановка только в случае отсутствия клиентских соединений к базе данных. Иначе действие завершается с предупреждением.
immediate — принудительное завершение процессов postgres без корректной обработки активных транзакций. Этот режим не рекомендуется к использованию, так как в некоторых случаях может привести к повреждению базы данных.

Окно для ввода параметров действия Stop

Для редактирования режима остановки кластера нажмите на текущее значение поля ADB shutdown mode и в открывшемся окне выберите новое значение, после чего нажмите кнопку Apply.

Выбор режима остановки кластера

Для запуска действия Stop нажмите Run в исходном окне с параметрами, а затем подтвердите действие в открывшемся стандартном окне.

После успешного применения действия Stop кластер ADB переводится в статус stopped.

Upgrade

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

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

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

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

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

Подтверждение запуска подготовки к обновлению

В результате запускается задача подготовки к обновлению Upgrade: <bundle_version>, где <bundle_version> — выбранная версия бандла: например, Upgrade: 6.26.0_arenadata53_b1 (enterprise). В случае успешного выполнения задачи кластер ADB переводится в статус ready to upgrade.

Кластер ADB готов к обновлению
На странице Clusters нажмите на иконку в столбце Actions для кластера, требующего обновления. Выберите действие Upgrade.

Выбор действия Upgrade
В открывшемся окне заполните следующие параметры:
- Migrate db_files_history table now? — флаг, определяющий необходимость миграции таблицы arenadata_toolkit.db_files_history во время обновления. При установке флага таблица пересоздается с последующей загрузкой данных, а также опций партиционирования/сжатия данных. Для больших таблиц этот процесс может занять длительное время. Сброс флага означает, что миграция будет выполнена позднее вручную либо при следующем обновлении.
- Make sure all postgress processes have been stopped — флаг, установка которого говорит о необходимости проверки, что все процессы postgress были остановлены перед началом обновления.
- Reboot timeout, sec — время ожидания перезагрузки хостов после обновления (в секундах).
  
  Окно для ввода параметров действия Upgrade
Для редактирования какого-либо параметра нажмите на его текущее значение и в открывшемся окне выберите новое значение, после чего нажмите кнопку Apply.

Ввод нового значения параметра
Нажмите Run в исходном окне с параметрами, а затем подтвердите действие в открывшемся стандартном окне.

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

В случае успешного обновления кластер ADB переводится в статус running, а его версия актуализируется на странице Clusters.

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

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