Настоящая инструкция описывает процедуру обновления с версии Polymatica Analytics 5.7.61 (в том числе кластерной версии) на Polymatica Analytics 5.9.x.

Если у вас установлена версия ниже, чем 5.7.61(_cluster), настоятельно рекомендуется сначала обновиться до версии 5.7.61(_cluster), а затем уже осуществлять миграцию на 5.9.x.

Миграция с 5.7.61 на 5.9.x

При обновлении с версии 5.7.61 на версию 5.9.12 и выше см. инструкцию в следующем разделе на этой странице.

Для обновления системы необходимо выполнить следующие действия: 

  1. Остановить приложение:

    systemctl stop polymatica
  2.  Удалить пакет polymatica-oracle-extension:
  3. Подключить репозиторий с новой версией согласно руководству по установке.
  4. Выполнить обновление пакетов: 

  5. Выполнить конвертирование репозитория:

     plm-util --convert-repo
  6. Добавить в файл конфигурации параметр для режима работы на одном узле:
    plm.cluster.master.enable_servers

  7. Добавить нужные нестандартные параметры в новый файл конфигурации и разместить его по стандартному пути:

    /etc/polymatica/polymatica.conf

  8. Выполнить перезапуск приложения: 

    systemctl restart polymatica

Миграция с 5.7.61 на 5.9.12 и выше

При обновлении с версии 5.7.61 на версию 5.9.12 и выше могут возникнуть проблемы со сценариями, созданными в версиях 5.7.49–5.7.62 и содержащими шаги, связанные с перемещением объектов на панели размерностей и фактов. Во избежание данных проблем необходимо сначала обновиться до версии 5.9.11.3, после чего следует выполнить скрипт для пересохранения сценариев по следующей инструкции:

Инструкция к скрипту пересохранения сценариев при переходе с 5.7 на 5.9

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

  1. В конфигурационном файле config.json указать параметры подключения к запущенному серверу Рolymatica Аnalytics:
    1. адрес подключения — поле "url";
    2. параметры авторизации на сервере, один из двух вариантов:
      1. логин/пароль учетной записи с правами администратора — поля "username" и "password";
      2. параметры существующей сессии:
        1. "session_id" — идентификатор существующей сессии;
        2. "manager_uuid" — идентификатор менеджера;
        3. "full_polymatica_version" — 5.9.11.3.
    3. количество сценариев, необходимых для обработки за запуск скрипта — "resaved_scenarios_limit";
    4. признак пропуска сценариев с недоступными мультисферами — "skip_if_cubes_unavailable".
    5. признак сохранения сценария при возникновении ошибок в ходе воспроизведения — "save_on_error".

Пример заполненного конфигурационного файла: 

{
   "connection": {
       "url": "http://123.456.78.910/",
       "login": {
           "username": "login",
           "password": "password"
       },
       "session": {
           "session_id": null,
           "manager_uuid": null,
           "full_polymatica_version": null
       }
   },
   "resaved_scenarios_limit": null,
   "skip_if_cubes_unavailable": true,
   "save_on_error": false
}

Одновременно должны быть заполнены или поля login (аутентификация через логин и пароль), или session (аутентификация через имеющуюся сессию).

Параметры конфигурационного файла соответствуют параметрам запуска скрипта через командную строку, которые указаны ниже.

    2. Запустить скрипт и дождаться его выполнения, при этом:

    1. Рolymatica Аnalytics останавливать не требуется;
    2. скрипт не мешает работе пользователей;
    3. скрипт создает дополнительную нагрузку за счет последовательного выполнения сценариев, подлежащих перезаписи.

Пример запуска скрипта:

     3. Результатом работы скрипта может быть:

    1. отчет об успешном сохранении всех/заданного количества проблемных сценариев;
    2. отчет о том, что для некоторого списка сценариев были недоступны мультисферы, которые используются в сценарии, или имели место ошибки в шагах сценариев — такие сценарии пропускаются и записываются в выходной файл skipped_scenarios.txt. При необходимости пересохранения таких сценариев (проблемные/недоступные шаги будут пропущены и не сохранены в новый сценарий) в конфигурационном файле необходимо указать параметры "skip_if_cubes_unavailable" в значении false и "save_on_error" в значении true.

Список параметров командной строки скрипта:

  1. --connection_url — адрес сервера Polymatica Analytics;
  2. --connection_session — параметры существующей в системе сессии, включающие: session_id, manager_uuid и full_polymatica_version;
  3. --connection_login — параметры для авторизации по логину, включает в себя: username, password;
  4. --limit — максимальное количество перезаписываемых сценариев за один запуск скрипта, если null, то скрипт перезапишет все сценарии;
  5. --skip_if_cubes_unavailable — пропускать проблемные сценарии, если для них не все мультисферы доступны;
  6. --save_on_error — флаг перезаписи сценариев, если в ходе воспроизведения возникли ошибки (имели место недоступные для воспроизведения шаги).

Для получения доступа к архиву с кодом скрипта и файлом конфигурации обратитесь в техническую поддержку.

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


Миграция с 5.7.61_cluster на 5.9.x

Для обновления системы необходимо выполнить следующие действия:

  1. Остановить приложение на всех узлах:
    systemctl stop polymatica
  2. Удалить пакет polymatica-cluster на Slave-узлах:
  3. Удалить пакет polymatica-oracle-extension на Master-узле:
  4. Подключить репозиторий с новой версией на всех узлах согласно руководству по установке.
  5. Выполнить обновление пакетов: 

  6. Добавить в файл конфигурации Slave-серверов параметры для подключения к Master-узлу:

    plm.cluster.master.address = <ip_master>
plm.cluster.master.port = 8080

  7. Добавить нужные нестандартные параметры в файлы конфигурации Master и Slave и разместить их по стандартному пути:

    /etc/polymatica/polymatica.conf
  8. Перезапустить приложение сначала на Master-узле, потом на Slave-узлах:
    systemctl restart polymatica