5. Обновление версии

5.1. Обновление из консоли для Datamart Platform Studio

Примечание

В зависимости от мощности сервера и скорости каналов связи процесс обновления может занять от 30 до 60 минут.

Для обновления Datamart Platform Studio, установленной на сервере необходимо произвести следующие действия в консоли от имени пользователя datamart:

  1. Перейти в папку с установленной Datamart Platform Studio (в текущем примере /home/datamart)

# cd /home/datamart
  1. Остановить текущую версию, выполнив команду stop:

# ./datamart-studio stop
Остановка Datamart Platform Studio

Рисунок 5.1 Остановка Datamart Platform Studio

  1. Создать бэкап текущей версии Datamart Platform Studio

Перед созданием бэкапа желательно удалить из папки старые архивы, если они там есть (например, файл datamart-studio-xxx.tgz мог остаться после установки), так как они будут занимать лишнее место в папке бэкапа.

Для запуска процедуры архивации бэкап копии текущей версии выполняем команду:

# sudo ./datamart-studio backup

Примечание

Созданный бэкап-файл будет помещен по умолчанию в подпапку ./backup, если требуется применить дополнительные опции бэкапирования - см. Раздел 4 Резервное копирование и восстановление. Процесс архивации достаточно длительный и, в зависимости от размера программы и мощности сервера, может занимать 10 минут или более.

  1. Скачать архив с обновлением для новой версии

    Например, для скачивания архива в папку /tmp, необходимо выполнить команды:

# cd /tmp
# sudo wget https://dms-demo.datamart.ru/datamart/dtms-builds/datamart-studio-NEW_VERSION.tar.gz
  1. Распаковать архив

    Для этого необходимо создать новый каталог в папке, в которую был скачен архив на предыдущем шаге (в примере папка /tmp) и распаковать в него скачанный архив:

# mkdir datamart_studio_upgrade
# tar zxvf datamart-studio-NEW_VERSION.tar.gz -C datamart_studio_upgrade
  1. Запустить процедуру обновления

    Для запуска процедуры обновления, необходимо зайти в каталог, в котором было распаковано обновление ( в примере каталог /tmp/datamart_studio_upgrade/ ) и запустить процесс обновления (с sudo), указав в команде каталог, в котором установлена текущая версия Программы (/home/datamart/):

# cd /tmp/datamart_studio_upgrade/
# sudo ./datamart-studio upgrade /home/datamart

Примечание

Процесс обновления достаточно длительный и в зависимости от размера программы и мощности сервера может занимать 10 минут или более.

В случае успешного обновления, процесс завершается сообщением:

Datamart Platform Studio updated to version <NEW_VERSION>

Программа Datamart Platform Studio будет запущена автоматически. В шапке веб-интерфейса программы должен быть отображён номер новой версии:

Версия Datamart Platform Studio после обновления

Рисунок 5.2 Версия Datamart Platform Studio после обновления

  1. Обновить бандлы приложений из хранилища репозиториев

    После проведения обновления и запуска программы необходимо обновить бандлы и приложения из хранилищ(а) репозиториев.

    Вариант 1: Обновить из консоли

    Обновить все хранилища репозиториев можно командой:

    docker-compose -f docker-compose.datamart.yaml exec app bundle exec rails runner "Rephub.all.each { |r| r.grab_repositories }"
    

    Обновить отдельное хранилище репозиториев по ID:

    docker-compose -f docker-compose.datamart.yaml exec app bundle exec rails runner "Rephub.find(:id).grab_repositories"
    

    Вариант 2: Обновить из веб-интерфейса Datamart Platform Studio

    Обновить данные хранилищ в веб-интерфейсе Datamart Platform Studio можно в разделе «Репозитории». В указанном разделе необходимо нажать на кнопку «Обновить все» ( см. Рисунок 5.3):

Обновление данных хранилищ в веб-интерфейсе Datamart Platform Studio

Рисунок 5.3 Обновление данных хранилищ в веб-интерфейсе Datamart Platform Studio

Примечание

Если у вас подключено несколько хранилищ репозиториев (реп-хабов), можно обновить бандлы из репозиториев для каждого из подключенных хранилищ.

5.2. Определение версии сборки

Версия текущей сборки ПО Datamart Platform Studio отображается в заголовке на странице сводной панели во всплывающем окне (см. Рисунок 5.4):

Версия сборки Datamart Platform Studio

Рисунок 5.4 Версия сборки Datamart Platform Studio

5.3. Особенности обновлений

5.3.1. Особенности обновления до версии 2.7.0

Для проведения консистентного обновления установленных услуг в Datamart Platform Studio до версии 2.7.0 потребуется обновление установленных приложений из бандлов. Это связано с обновлением логики связи исходящих интерфейсов по нескольким портам. В версии 2.6.0 и ранее возможно было установить соединения только по одному общему порту.

5.3.2. Концепция обновления для группы Студий

При обслуживании группы отдельно развернутых версий Datamart Platform Studio для удобства единовременного обновления и соблюдения единообразного содержания хранилищ репозиториев, версий бандлов и версий доступного для разворачивания и реконфигурирования Витрин данных ПО, может применяться схема со служебной мастер-Студией тех. поддержки и дочерними Студиями (клиентскими версиями).

В этом случае, обновление происходит в 2 этапа:

  1. Сначала, обычным образом, обновляется мастер-Студия.

  2. После обновления мастер-Студии, для каждой дочерней запускается скрипт обновления из мастера.

При этом, в файле конфигураций дочерних студий, настройки хранилища Nexus и Gitea настраиваются таким образом, чтобы они смотрели не на собственные хранилища, а на централизованный Nexus и Gitea в мастер-Студии (см. в файле конфигурации Раздел 10.3 Настройка параметров в файле конфигурации настройку параметров DOCKER_REGISTRY, GLOBAL_VALUES, GITEA_HOST).

5.3.3. Обнаружение ошибок миграции

Если после обновления в заголовке Datamart Platform Studio выводится предупреждающее сообщение об ошибках миграции, то это значит, что какая-то часть скриптов миграции при обновлении версии выполнена некорректно. Необходимо проверить статус прохождения процессов миграции данных командой rails data:migrate:status и схемы данных командой rails db:migrate:status:

# docker-compose -f docker-compose.datamart.yaml exec app bundle exec rails data:migrate:status

# docker-compose -f docker-compose.datamart.yaml exec app bundle exec rails db:migrate:status

В случае обнаружения ошибочного статуса (down) в одной из миграций, попробовать повторить процесс миграции командой rails db:migrate для схемы данных:

# docker-compose -f docker-compose.datamart.yaml exec app bundle exec rails db:migrate

и миграции данных командой rails data:migrate :

# docker-compose -f docker-compose.datamart.yaml exec app bundle exec rails data:migrate

запустить обе миграции сразу можно командой rails db:migrate:with_data :

# docker-compose -f docker-compose.datamart.yaml exec app bundle exec rails db:migrate:with_data

В случае повторения ошибок, прислать данные ошибок в службу технической поддержки Datamart Platform Studio для выяснения причин и оперативного устранения проблемы.