Обновление версии экземпляра ПО с его остановкой

Введение

Здесь представлены инструкции по обновлению версии экземпляра ПО Comindware Platform на одном и том же сервере с остановкой экземпляра.

Инструкции даны для обновления с версии 4.7.2 и выше на версию 5.0 в ОС Linux.

Порядок обновления версии экземпляра ПО

1. Подготовьте экземпляр ПО к обновлению:

   • Сохраните резервную копию экземпляра ПО.
   • Остановите экземпляр ПО.
   • Сохраните конфигурацию экземпляра ПО и вспомогательных служб.
   • Удалите компоненты старой версии ПО.
   • Переместите директорию с базой данных экземпляра ПО в резервную директорию.

2. Обновите версию ПО для экземпляра:

   • Скачайте и распакуйте два дистрибутива: вспомогательного ПО и новой версии ПО.
   • Удостоверьтесь, что все компоненты вспомогательного ПО установлены корректно.
   • При необходимости обновите или установите вспомогательное ПО.
   • Установите новую версию ПО.
   • Удалите экземпляр ПО старой версии.
   • Создайте экземпляр ПО новой версии.
3. Обновите конфигурацию ПО и служб:
   • Отредактируйте конфигурационные файлы в соответствии с ранее сохранёнными резервными копиями.
   • Перезапустите экземпляр ПО и вспомогательные службы.
4. Инициализируйте экземпляр ПО:
   • Выполните вход и проверьте работоспособность ПО.
   • Остановите экземпляр ПО.
   • Скопируйте в экземпляр ПО ранее перемещённую директорию с базой данных.
5. Обновите и проверьте структуру данных:
   • Запустите экземпляр ПО.
   • Обновите структуру данных до новой версии.
   • Очистите кэши.
   • Снова перезапустите экземпляр ПО.
6. Подготовьте восстановленный экземпляр ПО к работе.

Подготовка экземпляра ПО к обновлению

1. Создайте и перенесите во внешнее хранилище резервную копию базы данных экземпляра ПО. См. «Резервное копирование. Настройка и запуск, просмотр журнала сеансов».

2. Перейдите в режим суперпользователя:

   sudo -s 
   

   или

   su - 
   

3. Сохраните резервную копию файлов конфигурации, например в директорию /var/backups/config_tmp:

   • Astra Linux, Ubuntu, Debian (DEB-based)

   mkdir -p /var/backups/config_tmp/ 
   cd /var/www/<instanceName>/ 
   cp *.config *.yml *.json /var/backups/config_tmp/ 
   cp /etc/nginx/sites-available/comindware<instanceName> /var/backups/config_tmp/ 
   cp /etc/sysconfig/comindware<instanceName>-env /var/backups/config_tmp/ 
   cp /usr/share/comindware/configs/instance/<instanceName>.yml /var/backups/config_tmp/ 
   

   • РЕД ОС, Rocky (RPM-based)

   mkdir -p /var/backups/config_tmp/ 
   cd /var/www/<instanceName>/ 
   cp *.config *.yml *.json /var/backups/config_tmp/ 
   cp /etc/nginx/conf.d/comindware<instanceName> /var/backups/config_tmp/ 
   cp /etc/sysconfig/comindware<instanceName>-env /var/backups/config_tmp/ 
   cp /usr/share/comindware/configs/instance/<instanceName>.yml /var/backups/config_tmp/ 
   

   • Альт Сервер

   mkdir -p /var/backups/config_tmp/ 
   cd /var/www/<instanceName>/ 
   cp *.config *.yml *.json /var/backups/config_tmp/ 
   cp /etc/nginx/sites-available.d/comindware<instanceName> /var/backups/config_tmp/ 
   cp /etc/sysconfig/comindware<instanceName>-env /var/backups/config_tmp/ 
   cp /usr/share/comindware/configs/instance/<instanceName>.yml /var/backups/config_tmp/ 
   

   Здесь <instanceName> — имя экземпляра ПО.

4. Остановите экземпляр ПО и вспомогательные службы и удостоверьтесь, что они остановлены:

   systemctl stop apigateway<instanceName> adapterhost<instanceName> comindware<instanceName> 
   systemctl status apigateway<instanceName> adapterhost<instanceName> comindware<instanceName> 
   

5. Удалите (или переместите в резервное хранилище) неиспользуемые предыдущие дистрибутивы ПО (<distPath> — путь к директории с дистрибутивом, <osname> — название операционной системы):

   rm -rf <distPath>/CMW_<osname> 
   

6. Переместите директорию с базой данных экземпляра ПО (<username> — имя пользователя Linux):

   mkdir -p /home/<username>/<instanceName> 
   mv /var/lib/comindware/<instanceName> /home/<username>/ 
   

Обновление версии ПО для экземпляра

1. Скачайте и распакуйте дистрибутив с новой версией вспомогательного ПО (X.X, <prerequisitesVersion> — номер версии):

   cd <distPath> 
   tar -xf X.X-release-ru-<prerequisitesVersion>.prerequisites.<osname>.tar.gz 
   

2. Перейдите в директорию со скриптами для развёртывания вспомогательного ПО:

   cd <prerequisitesDistPath>/CMW_<osname>/scripts 
   

   Здесь: <prerequisitesDistPath>/CMW_<osname>/ — путь к распакованному дистрибутиву со вспомогательным ПО.

3. Убедитесь, что все компоненты установлены:

   sh prerequisites_list.sh 
   

   Внимание!

   Если какой-то из компонентов не установлен или установлена старая версия, то установите вспомогательное ПО заново. См. «Установка вспомогательного ПО».

4. Скачайте и распакуйте дистрибутив с новой версией ПО (X.X, <version> — номер версии):

   cd <distPath> 
   tar -xf X.X-release-ru-<version>.<osname>.tar.gz 
   

5. Перейдите в распакованную директорию:

   cd CMW_<osname>_<version>/scripts/ 
   

6. Установите новую версию ПО:

   bash version_install.sh 
   

7. Проверьте наличие и имя директории установленной версии ПО:

   bash version_list.sh 
   

8. Отобразится список установленных версий ПО на сервере.

9. Удалите экземпляр ПО старой версии и его данные:

   bash instance_delete.sh -n=<instanceName> --deleteData 
   

10. Создайте экземпляр ПО новой версии:

    bash instance_create.sh -n=<instanceName> -p=<portNumber> -v=<version> 
    

    Здесь:

    • -n=<instanceName> — имя экземпляра ПО;
    • -p=<portNumber> - порт для экземпляра ПО, по умолчанию: 80 (необязательный ключ);
    • -v=<version> — установленная версия ПО.

11. По окончании создания скрипт выведет информацию о компонентах экземпляра ПО. Удостоверьтесь, что компоненты успешно установлены.

    Пример результата выполнения скрипта:

    ... 
    [Done] Creating Log Directories. 
    OK     Instance folder created. 
    OK     Instance Web config created. 
    OK     Instance Ignite config created. 
    OK     Instance binaries linked. 
    OK     Instance config created. 
    OK     Data folder created. 
    OK     Database folder created: Yes 
    OK     Streams folder created: No  
    OK     Logs folder created: Yes 
    OK     Used version: <version> 
    OK     Logs configured. 
    OK     Sites created. 
    OK     Sites enabled. 
    OK     API Gateway configured. 
    OK     Link to binaries is valid. 
    OK     Instance service started. 
    OK     Instance API gateway service started. 
    OK     NGINX started. 
    OK     Final status. 
    [Done] Upgrade CBAP instance. 
    

    Если какая-либо из служб имеет статус FAILED, игнорируйте это и продолжайте выполнение следующих шагов согласно инструкции, так как устранять эти неполадки следует позже.

12. Обновите конфигурацию ПО и служб.

Обновление конфигурации ПО и служб

1. Отредактируйте конфигурацию NGINX для экземпляра ПО в соответствии с резервной копией, сохранённой ранее:

   • Astra Linux, Ubuntu, Debian (DEB-based)

     nano /etc/nginx/sites-available/comindware<instanceName> 
     

   • РЕД ОС, Rocky (RPM-based)

     nano /etc/nginx/conf.d/comindware<instanceName> 
     

   • Альт Сервер

     nano /etc/nginx/sites-available.d/comindware<instanceName> 
     

2. Перезапустите службу NGINX для применения изменений:

   nginx -s reload 
   

3. Отредактируйте файлы конфигурации в соответствии с резервными копиями, сохранёнными ранее:

   nano /etc/sysconfig/comindware<instanceName>-env 
   nano /var/www/<instanceName>/adapterhost.yml 
   nano /var/www/<instanceName>/apigateway.yml 
   nano /var/www/<instanceName>/Ignite.config 
   nano /usr/share/comindware/configs/instance/<instanceName>.yml 
   

   Внимание!

   • В новейших версиях Comindware Platform отсутствует файл Workers.config.
   • Настройка соответствующих служб выполняется в файле конфигурации экземпляра ПО <instanceName>.yml.

4. Перезапустите службы Comindware Platform:

   systemctl restart adapterhost<instanceName>.service 
   systemctl restart comindware<instanceName>.service 
   systemctl restart apigateway<instanceName>.service 
   

5. Инициализируйте экземпляра ПО.

Инициализация экземпляра ПО

1. Откройте сайт экземпляра ПО в браузере, одновременно открыв выдачу журналов экземпляра в терминале:

   tail -f /var/log/comindware/<instanceName>/Logs/heartbeat* 
   

2. В браузере выполните инициализацию экземпляра ПО, выполните вход и проверьте работоспособность ПО.

3. Остановите экземпляр ПО:

   systemctl stop comindware<instanceName> 
   

4. Скопируйте в экземпляр ПО директорию с базой данных экземпляра ПО, сохранённую ранее (<username> — имя пользователя Linux):

   cp  -R /home/<username>/<instanceName>/Database /var/lib/comindware/<instanceName>/ 
   

5. Перейдите в папку с экземпляром ПО и поменяйте права для скопированной директории с базой данных:

   cd /var/lib/comindware/<instanceName>/ 
   chmod -R 777 Database/  
   sudo chown -R www-data:www-data Database/ 
   

6. Обновите структуру данных.

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

1. Запустите экземпляр ПО:

   systemctl start comindware<instanceName> 
   

2. Откройте сайт экземпляра ПО в браузере, дождитесь окончания загрузки, одновременно открыв выдачу журналов экземпляра в терминале:

   tail -f /var/log/comindware/<instanceName>/Logs/heartbeat* 
   

   См. «Подсистема журналирования».

3. Дождитесь завершения обновления структуры данных:

   • Удостоверьтесь, что появились журналы обновления:
     • /var/log/comindware/<instanceName>/Logs/UpgradeOntology.log
     • /var/log/comindware/<instanceName>/Logs/upgrade<ГГГГ-ММ-ДД>.log
   • Удостоверьтесь, что в журнале UpgradeOntology.log последняя запись содержит строку Upgrade of ontology completed successfully.
   • Удостоверьтесь, что в журнале upgrade<ГГГГ-ММ-ДД>.log последняя запись содержит строку Upgrade completed.
   • Удостоверьтесь, что в журналах отсутствуют ошибки обновления. Найдите их по ключевому слову error.

4. Проверьте результат обновления структуры данных.

   • Если обновление структуры данных выполнено успешно:

     • При обновлении с версии 5.0:
       • Обновление структуры данных завершено.
       • Переходите к Подготовке восстановленного экземпляра ПО к работе.
     • При обновлении с версии 4.7 на версию 5.0 переходите к шагу 5.

   • Если в журнале обновления имеются ошибки:

     • Не переходите к шагу 5.
     • Снова установите для экземпляра старую версию ПО.
     • Восстановите базу данных из резервной копии.
     • Обратитесь в службу поддержки Comindware, предоставив журналы обновления и ошибок для анализа.

5. Создайте резервную копию экземпляра ПО:

   • в формате .CDBBZ средствами Comindware Platform;

     или

   • c помощью скрипта для создания снимка базы.

6. Остановите экземпляр ПО.

7. Распакуйте резервную копию и удалите из неё следующие директории кэшей:

   rm -rf cacheGroup-*-TableIdentity 
   rm -rf cacheGroup-*-TableIdentityReplicated 
   rm -rf cacheGroup-*Value 
   rm -rf cacheGroup-*ValueReplicated 
   rm -rf cache-ignite-sys-cache 
   rm -rf cp 
   rm -rf metastorage 
   rm -rf cacheGroup-Keys 
   

8. Очистите директорию с базой данных экземпляра ПО:

   rm -rf /var/lib/comindware/<instanceName>/Database/* 
   

9. Скопируйте очищенную резервную копию в директорию с базой данных:

   /var/lib/comindware/<instanceName>/Database/ 
   

10. Назначьте владельца директории с базой данных:

    • Astra Linux, Ubuntu, Debian (DEB-based)

    chown -R www-data:www-data /var/lib/comindware/<instanceName>/Database 
    

    • РЕД ОС, Rocky (RPM-based)

    chown -R nginx:nginx /var/lib/comindware/<instanceName>/Database 
    

    • Альт Сервер

    chown -R _nginx:_nginx /var/lib/comindware/<instanceName>/Database 
    

11. Подготовьте восстановленный экземпляр ПО к работе.

Подготовка восстановленного ПО к работе

1. Запустите экземпляр ПО.
2. Проверьте и при необходимости исправьте конфигурацию экземпляра ПО. См. «Проверка и настройка конфигурации экземпляра ПО Comindware Platform после восстановления из резервной копии».
3. Проверьте и работоспособность экземпляра ПО.
4. Создайте резервную копию работоспособного экземпляра Comindware Platform.