Обновление до ADB 5.15.1_arenadata4

В разделе описывается путь обновления от версии ADB 5.x до ADB 5.15.1_arenadata4:

Подготовка к обновлению

Перед началом процесса обновления следует выполнить следующие рекомендации:

  • Проверить работоспособность хост-оборудования ADB и убедиться, что хосты соответствуют требованиям для работы базы данных. Утилита gpcheckperf может помочь в подтверждении требований к хосту. Рекомендуется запускать утилиту gpcheckcat за несколько недель до обновления и, в случае обнаружения проблем, будет возможность разрешить их до запланированного обновления.

Утилита находится в $GPHOME/bin. Рекомендуется, чтобы ADB находилась в ограниченном режиме при запуске утилиты gpcheckcat. Если gpcheckcat сообщает о несоответствиях каталогов, можно запустить ее с параметром -g для создания SQL-скриптов для устранения несоответствий.

После запуска SQL-скриптов необходимо снова запустить gpcheckcat. Возможно, придется повторить процесс запуска gpcheckcat и создания SQL-скриптов, чтобы убедиться в отсутствии несоответствий. Рекомендуется, чтобы SQL-скрипты, созданные gpcheckcat, запускались в статистической системе, так как в ином случае утилита может сообщать ложные предупреждения.

Important

Если утилита gpcheckcat сообщает об ошибках, но не создает SQL-скрипт для их исправления, необходимо обратиться в службу поддержки ADB – e-mail: info@arenadata.io

  • Во время процесса миграции с ADB 5.0.0 создается резервная копия некоторых файлов и каталогов в $MASTER_DATA_DIRECTORY. Рекомендуется, чтобы файлы и каталоги, которые не использовались в ADB, при неободимости были скопированы и затем удалены из файла $MASTER_DATA_DIRECTORY перед миграцией.

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

Обновление ADB с 5.x до 5.15.1_arenadata4

Обновление версии с 5.x до ADB 5.15.1_arenadata4 включает в себя остановку ADB, обновление бинарных файлов базы данных, обновление ADB и ее перезапуск.

При наличии баз данных, созданных с помощью ADB 5.3.0 или более ранней версии 5.x, необходимо обновить функцию gp_bloat_diag и визуализацию в схеме gp_toolkit (дополнительная информация приведена в разделе Обновление gp_toolkit.gp_bloat_diag).

Если в ADB установлена база данных gpperfmon, процесс миграции изменяет ключ распределения таблиц log_alert_* на столбец logtime. Перераспределение данных таблицы может занять некоторое время при первом запуске ADB после миграции.

Порядок действий для обновления базы данных ADB с версии 5.x до 5.15.1_arenadata4:

  1. Войти в мастер-узел ADB от администратора:
$ su - gpadmin
  1. Выполнить интеллектуальное завершение работы текущей системы ADB 5.x (чтобы не было активных подключений). В примере используется опция -a для отключения запросов на подтверждение:
$ gpstop -a
  1. Запустить бинарную программу установки для 5.15.1_arenadata4 на мастер-хосте ADB. Указать место установки в том же базовом каталоге, что и текущая инсталляция. Например:
/usr/lib/gpdb

Если ADB устанавливается с rpm (с правами администратора root), каталог установки – /usr/lib/gpdb. Для установки rpm необходимо обновить права для новой сборки. Например, запустить команду как root, чтобы сменить пользователя и группу устанавливаемых файлов на gpadmin:

# chown -R gpadmin:gpadmin /usr/lib/gpdb
  1. Если для развертывания ADB используется аутентификация LDAP, следует вручную отредактировать файл /usr/lib/gpdb/greenplum_path.sh, добавив строку:
export LDAPCONF=/etc/openldap/ldap.conf
  1. Отредактировать среду суперпользователя (gpadmin) ADB и убедиться, что для новой установки используется файл greenplum_path.sh. Проверить на корректность следующую строку в .bashrc или в выбранном файле профиля:
source /usr/lib/gpdb/greenplum_path.sh

Если в файлах профиля используется символическая ссылка (/usr/lib/gpdb), необходимо ее обновить и указать новую установленную версию.

  1. Среда только что отредактированного исходного файла:
$ source ~/.bashrc
  1. Запустить утилиту gpseginstall для установки бинарных файлов 5.15.1_arenadata4 на всех узлах сегмента, указанных в hostfile. Например:
$ gpseginstall -f hostfile
  1. Если ранее использовались любые расширения ADB, такие как pgcrypto, PL/R, PL/Java, PL/Perl и PostGIS, следует загрузить соответствующие пакеты и установить их с помощью утилиты gppkg.
  2. Если в предыдущей установке базы данных ADB был настроен PgBouncer, необходимо перейти на новый PgBouncer.
  3. После обновления всех хостов сегмента войти в систему как пользователь gpadmin и перезапустить ADB:
# su - gpadmin
$ gpstart
  1. Если в предыдущей версии ADB была настроена PXF, необходимо повторно инициализировать платформу после обновления базы данных.

Устранение неполадок при неудачном обновлении

При возникновении проблем во время процесса миграции и наличии прав на ADB, приобретенных у Arenadata, необходимо обратиться в техническую поддержку Arenadata по адресу info@arenadata.io и предоставить следующую информацию: