Обновление компонента Kintsugi (DBCM)#

Внимание

Перед началом обновления Kintsugi (DBCM) сделайте резервную копию баз данных метаданных и метрик согласно документации Platform V Pangolin DB (PSQ)/PostgreSQL.

Миграция данных для Kintsugi (DBCM) версий 1.3.Х#

Примечание

Миграция данных с Kintsugi (DBCM) версий 1.2.Х и ниже не поддерживается.

Миграция данных в текущей версии Kintsugi (DBCM) из хранилища timeseries-данных метрик мониторинга и хранилища порогов метрик не требуется.

Миграции подвергаются все записи таблицы monitoring в БД метаданных.

Рекомендуется выполнить резервное копирование БД перед выполнением обновления.

Шаги обновления#

Для миграции данных из хранилища метаданных:

  1. Найдите SQL-скрипт schema_upgrade.sql, расположенный в архиве DBCM-dbinit-X.X.X-XX-distrib.zip.

  2. Выполните команду запуска SQL-скрипта schema_upgrade.sql в схеме репозитория метаданных:

    psql 'host=10.xx.xx.xx user=admin dbname=kintsugi.example.test port=5555 options=--search_path=kintsugi.example.schema' -f schema_upgrade.sql

    Описание параметров:

    • host – адрес базы данных;

    • user – пользователь, выполняющий миграцию;

    • dbname – база данных, на которой выполняется миграция;

    • port – порт базы данных;

    • options – схема репозитория метаданных;

    • schema_upgrade.sql – файл, где содержится SQL-скрипт.

    Во время миграции будет предложено ввести имя БД по умолчанию для объектов мониторинга.

  3. Выдайте схеме данных meta привилегии: SELECT, INSERT, DELETE, UPDATE:

    GRANT SELECT, INSERT, DELETE, UPDATE ON ALL TABLES IN SCHEMA meta TO kintsugi;
GRANT USAGE, SELECT, UPDATE ON ALL SEQUENCES IN SCHEMA meta TO kintsugi;

Проверка обновления#

Проверьте корректность обновления Kintsugi (DBCM) согласно разделу Проверка работоспособности Kintsugi (DBCM).

Обновление SQL-запросов получения значений метрик для Kintsugi (DBCM) версии 1.4.0#

Внимание

Обновление SQL-запросов актуально при миграции с Kintsugi (DBCM) версии 1.4.0 до 1.4.1 или 1.4.2.

Шаги обновления#

Для обновления SQL-запросов получения значений метрик:

  1. Найдите SQL-скрипт update_sql_requests.sql, расположенный в архиве DBCM-dbinit-X.X.X-XX-distrib.zip.

  2. Выполните команду запуска SQL-скрипта update_sql_requests.sql в схеме репозитория метаданных:

    psql 'host=10.xx.xx.xx user=admin dbname=kintsugi.example.test port=5555 options=--search_path=kintsugi.example.schema' -f update_sql_requests.sql

    Описание параметров:

    • host – адрес базы данных;

    • user – пользователь, выполняющий миграцию;

    • dbname – база данных, на которой выполняется миграция;

    • port – порт базы данных;

    • options – схема репозитория метаданных;

    • schema_upgrade.sql – файл, где содержится SQL-скрипт.

Проверка обновления#

Проверьте корректность обновления Kintsugi (DBCM) согласно разделу Проверка работоспособности Kintsugi (DBCM).

Обновление SQL-запросов получения значений метрик для Kintsugi (DBCM) версии 1.4.1 и 1.4.2#

Внимание

Обновление SQL-запросов актуально при миграции с Kintsugi (DBCM) версии 1.4.1 или 1.4.2 до 1.4.3.

Шаги обновления#

Для обновления SQL-запросов получения значений метрик:

  1. Найдите SQL-скрипт update_sql_requests.sql, расположенный в архиве DBCM-dbinit-X.X.X-XX-distrib.zip.

  2. Выполните команду запуска SQL-скрипта update_sql_requests.sql в схеме репозитория метаданных:

    psql 'host=10.xx.xx.xx user=admin dbname=kintsugi.example.test port=5555 options=--search_path=kintsugi.example.schema' -f update_sql_requests.sql

    Описание параметров:

    • host – адрес базы данных;

    • user – пользователь, выполняющий миграцию;

    • dbname – база данных, на которой выполняется миграция;

    • port – порт базы данных;

    • options – схема репозитория метаданных;

    • update_sql_requests.sql – файл, где содержится SQL-скрипт.

Проверка обновления#

Проверьте корректность обновления Kintsugi (DBCM) согласно разделу Проверка работоспособности Kintsugi (DBCM).

Миграция данных для Kintsugi (DBCM) версий 1.5.Х и выше#

Шаги обновления#

Для миграции данных для Kintsugi (DBCM) версий 1.5.Х и выше выполните обновления:

Обновление БД порогов метрик#

Для обновления БД порогов метрик:

  1. Распакуйте содержимое архива db_scripts_thresholds.zip.

  2. Выполните конфигурацию файла liquibase.properties.

    Пример конфигурации:

    changelogFile: /path/to/changelog/thresholds/master_changelog.xml
url: jdbc:postgresql://thresholds_host:thresholds_port/thresholds_db
username: {username_example}
password: {password_example}
defaultSchemaName: metrics_thresholds

  3. Выполните сценарий инсталляции БД:

    ./liquibase update

  4. Выполните проверку состояния БД:

    ./liquibase history

  5. Установите тег новой версии Kintsugi для реализации возможности отката:

    ./liquibase tag --tag=<ВЕРСИЯ_KINTSUGI>

Обновление БД метаинформации Kintsugi (DBCM)#

Для обновления БД метаинформации Kintsugi:

  1. Распакуйте содержимое архива db_scripts_repository.zip.

  2. Выполните конфигурацию файла liquibase.properties.

    Пример конфигурации:

    changelogFile: /path/to/changelog/repository/master_changelog.xml
url: jdbc:postgresql://meta_host:meta_port/meta_db
username: {username_example}
password: {password_example}
defaultSchemaName: meta

  3. Выполните шаги 3 – 5 сценария «Обновление порогов метрик».

  4. Выдайте пользователю kintsugi привилегии (SELECT, INSERT, DELETE, UPDATE) в схеме meta:

    GRANT SELECT, INSERT, DELETE, UPDATE ON ALL TABLES IN SCHEMA meta TO kintsugi;

Обновление БД мониторинга TimescaleDB#

Для обновления БД мониторинга TimescaleDB:

  1. Распакуйте содержимое архива db_scripts_timescaledb.zip.

  2. Выполните конфигурацию файла liquibase.properties.

    Пример конфигурации:

    changelogFile: /path/to/changelog/timescaledb/master_changelog.xml
url: jdbc:postgresql://metrics_host:metrics_port/metrics_db
username: {username_example}
password: {password_example}
defaultSchemaName: metrics

  3. Выполните шаги 3 – 5 сценария «Обновление порогов метрик».

Проверка обновления#

Проверьте корректность обновления Kintsugi (DBCM) согласно разделу «Проверка работоспособности Kintsugi (DBCM)» пункт Сервисы хранения данных.

Обновление компонента Kintsugi (DBCM) версии до версии 1.9.0#

Шаги обновления#

Для обновления Kintsugi (DBCM) версии 1.9.0:

  1. Проверьте, какие чарты установлены:

    helm ls
NAME                    NAMESPACE           REVISION        UPDATED                                 STATUS          CHART                   APP VERSION
<имя чарта kintsugi>    <имя namespace>     1               2023-05-23 09:23:07.027896 +0300 MSK    deployed        App Helm chart-1.0.0

  2. Выберите нужный чарт и выполните следующую команду:

    helm upgrade <имя чарта> <путь к файлу с конфигурацией> -n <имя namespace, в котором развернут проект>
#Сообщение об успешном завершении команды:
Release <имя чарта> has been upgraded. Happy Helming!
NAME: <имя>
LAST DEPLOYED: Tue May 23 09:28:01 2023
NAMESPACE: <имя namespace>
STATUS: deployed
REVISION: 2
TEST SUITE: None

Проверка обновления#

Проверьте корректность обновления Kintsugi (DBCM) согласно разделу Проверка работоспособности Kintsugi (DBCM).