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

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

Обзор

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

Страница Clusters
Страница Clusters

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

  • Name — имя, присвоенное кластеру при создании.

  • State — текущий статус кластера.

  • Product — имя продукта.

  • Version — версия продуктового бандла, который был использован для установки или последнего обновления кластера.

  • Description — описание кластера, указанное при его создании.

  • Concerns. Если в конфигурации кластера обнаружены критичные ошибки или запущено блокирующее действие, в столбце отображается иконка concern red dark concern red light — при наведении на нее курсора показывается окно с описанием ошибки и ссылкой, по которой можно перейти, чтобы выполнить необходимую настройку или получить подробную информацию.

  • Actions. В столбце показываются иконки для управления кластером:

    • actions default dark actions default light — открывает список действий, доступных для работы с кластером.

      Открытие списка кластерных действий ADB
      Открытие списка доступных действий

    • upgrade default — указывает, доступна ли новая версия бандла, и позволяет запустить обновление кластера до новой версии.

    • delete default — удаляет информацию о кластере из ADCM (не удаляет ADB и не производит никаких изменений на хостах, относящихся к кластеру).

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

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

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

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

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

Доступные действия в зависимости от статуса ADB
Статус Условие Доступные действия

created

Кластер ADB создан в ADCM, но еще не установлен

running

Кластер ADB успешно установлен в ADCM и запущен

stopped

Кластер ADB успешно установлен в ADCM и остановлен

activating_standby

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

expanding

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

ready to upgrade

Проведена подготовка кластера ADB к обновлению — путем запуска действия, доступного после нажатия на иконку upgrade default

Действия 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
Окно для ввода параметров действия 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

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

Init Standby Master

 

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

  1. На вкладке Configuration открывшегося окна заполните параметры:

    • Reboot new servers after installation — флаг, определяющий необходимость автоматической перезагрузки хостов ADB после выполнения действия Init Standby Master. Если флаг сброшен, перезагрузку потребуется выполнить вручную.

    • Reboot timeout, sec — время ожидания перезагрузки хостов (в секундах).

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

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

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

  2. Нажмите Next.

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

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

      ПРИМЕЧАНИЕ

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

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

      Удаление Standby Master
      Удаление Standby Master

  4. Нажмите Run.

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

Expand

 

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

Подготовка

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

  1. Создайте и настройте необходимые хосты на странице Hosts в ADCM, используя один из доступных хостпровайдеров.

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

  3. Убедитесь, что хосты добавлены в выбранный кластер ADB.

Новые хосты на странице Hosts
Новые хосты на странице Hosts
ВНИМАНИЕ

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

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

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

  1. На вкладке 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
      Окно для ввода параметров действия 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
      Заполнение пути для tablespace
      Заполнение пути для tablespace

  2. Нажмите Next.

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

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

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

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

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

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

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

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

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

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

  1. Подключитесь к Master-серверу ADB под пользователем gpadmin, который создается по умолчанию. Все команды, приведенные на шагах ниже, запускаются исключительно на хосте Master:

    $ sudo su - gpadmin

  2. Для синхронизации конфигурационных файлов 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

  3. Перезапустите сервис 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. Таблицы с наименьшим рангом будут перераспределяться в первую очередь. Для ранжирования таблиц используйте следующие шаги:

  1. Подключитесь к базе данных postgres кластера ADB под пользователем gpadmin (например, через psql).

  2. Для всех строк таблицы gpexpand.status_detail установите начальное значение столбца rank, который будет считаться максимальным (и соответствовать наименьшему приоритету обработки), например 100:

    UPDATE gpexpand.status_detail SET rank = 100;

  3. Уменьшите значение 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

Для запуска действия 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

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

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

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

Reinstall statuschecker

 

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

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

Reconfigure parameter archiving

 

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

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

ВАЖНО

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

Check

 

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

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

Start

 

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

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

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

Stop

 

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

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

  • smart — остановка только в случае отсутствия клиентских соединений к базе данных. Иначе действие завершается с предупреждением.

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

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

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

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

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

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

Upgrade

 

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

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

    Бандл ADB на странице Bundles
    Бандл ADB на странице Bundles

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

    Нажатие на иконку Upgrade
    Нажатие на иконку Upgrade

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

    Запуск подготовки к обновлению
    Запуск подготовки к обновлению

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

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

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

    Кластер ADB готов к обновлению
    Кластер ADB готов к обновлению

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

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

  6. В открывшемся окне заполните следующие параметры:

    • Migrate db_files_history table now? — флаг, определяющий необходимость миграции таблицы arenadata_toolkit.db_files_history во время обновления. При установке флага таблица пересоздается с последующей загрузкой данных, а также опций партиционирования/сжатия данных. Для больших таблиц этот процесс может занять длительное время. Сброс флага означает, что миграция будет выполнена позднее вручную либо при следующем обновлении.

    • Make sure all postgress processes have been stopped — флаг, установка которого говорит о необходимости проверки, что все процессы postgress были остановлены перед началом обновления.

    • Reboot timeout, sec — время ожидания перезагрузки хостов после обновления (в секундах).

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

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

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

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

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

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

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