Обновление программы

Внимание! Данная инструкция описывает обновление Business Studio 7 с официально вышедших обновлений. Если вы обновляетесь с бета-версии (ниже 7.0.9544), напишите в техническую поддержку для получения рекомендаций по обновлению для вашей ситуации:support@businessstudio.ru

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

Рекомендуемая схема обновления зависит от того, с какой версии вы обновляетесь:

• С версии 7.0.9614:

1. Сделайте резервные копии.
2. Загрузите файлы новой версии.
3. Внесите изменения в конфигурацию.
4. Сконвертируйте базы данных.
5. Запустите стенд и проверьте его работу.

• С версии ниже 7.0.9614:

1. Сделайте резервные копии.
2. Разверните инсталлятор версии 7.0.9728 в отдельном каталоге, не поверх рабочего стенда.
3. Возьмите из него актуальные .env, docker-compose.yml и appsettings.json и перенесите в них свои значения: домены, пароли, порты, пути к сертификатам, GITLAB_TOKEN.
4. Сконвертируйте базы данных.
5. Запустите стенд и проверьте его работу.

Примечание. В разделах ниже приведены подробные инструкции для каждого этапа.

Создайте копии:

• всех используемых баз: в десктопном приложении (см. Десктопное приложение Business Studio) в окне Выбор базы данных выберите базу, нажмите «Свойства» затем «Сохранить» и укажите папку;
• файлов .env, docker-compose.yml, appsettings.json и SSL-сертификатов.

Они понадобятся для сравнения файлов и для отката.

В консоли веб-сервера Linux перейдите в каталог, где установлен проект Business Studio 7, и выполните команду загрузки (её выдаёт техническая поддержка). В каталог будут загружены:

• docker-images.md - список Docker-образов новой версии;
• versions-and-auth.md - справочный файл о версиях и авторизации;
• bs_menu.sh - скрипт администрирования стенда, заменяет bs.sh и generate_cert.sh (в новых версиях они не поставляются);
• bs_dbs_<версия>.zip - архив баз данных новой версии.

Команда не запускает инсталлятор и не меняет ваши конфигурацию и сертификаты. При ошибке не переходите дальше, обратитесь в техническую поддержку. Файлы bs_setup.sh, eula.md, INSTALL.md и logs-cleanup.sh относятся к первичной установке и обслуживанию, при обновлении не нужны.

В новых версиях в конфигурацию добавляются параметры, меняются значения и удаляются устаревшие ключи. Изменения по версиям - в Changelog ниже, подробности на странице версии.

• .env - версии образов BS_BACKEND_VERSION, BS_LICENCE_SERVER_VERSION, BS_NODE_JS_VERSION приведите в соответствие с docker-images.md и versions-and-auth.md. В ARTIFACT_URL (фронтенд) укажите ссылку для новой версии: она своя для каждой версии, со старой загрузится прежний фронтенд. GITLAB_TOKEN, домены, пароли и порты не изменяйте.
• docker-compose.yml - замените образы на указанные в docker-images.md. Свои порты и тома (секции ports и volumes) сохраните.
• appsettings.json - внесите изменения из Changelog, свои настройки сохраните. Описание параметров: Файл "Содержимое appsettings.jsonc".

Файлы из колонки «Опционально» (fluent.conf, nginx.conf.template, entrypoint.sh) нужны только при использовании соответствующих функций.

Чтобы понять, чем файлы конфигурации новой версии отличаются от ваших текущих, можно воспользоваться любым из следующих способов:

1. Команда vimdiff — открывает оба файла рядом с цветовой подсветкой различий:
   vimdiff <свой_файл> <новый_файл>
2. В текстовом редакторе с функцией сравнения, например, Notepad++ (меню Plugins - Compare), VS Code (выделите два файла - правая кнопка мыши - Compare Selected) или любой другой редактор с поддержкой diff.
3. В специализированных утилитах сравнения, например, Meld, Beyond Compare.
4. Через ИИ-ассистента - загрузите оба файла в любой чат-ассистент и попросите найти отличия.
   Пример промпта для ИИ:
   Сравни два файла конфигурации. Для каждого отличия укажи: тип изменения (добавлено / изменено / удалено), секцию и ключ, краткое описание на русском языке что делает этот параметр. Результат оформи таблицей с колонками: Тип, Секция, Ключ, Описание.

Для настройки безопасного соединения выполните следующие шаги:

1. Убедитесь, что в конфигурации указаны корректные пути к SSL-сертификатам.
2. Если используются собственные SSL-сертификаты, проверьте их наличие и доступность для контейнеров.
3. Снимите пароль с приватного ключа, иначе система его не примет.

Примечание: рекомендуемый формат приватного ключа — PKCS#8. Если формат ключа другой, его можно сконвертировать командой:

openssl pkcs8 -topk8 -inform PEM -outform PEM -in <старый ключ>.key -out <новый ключ>.key -nocrypt

• Выполните конвертацию баз данных по инструкции: Конвертация базы данных.

Запустите ./bs_menu.sh, перейдите в раздел «Управление BS7» и выберите нужное действие:

• «Запуск BS7» — загружает образы версий, указанных в `.env`, и пересоздаёт контейнеры. Используйте при обновлении версии.
• «Перезапустить BS7» — пересоздаёт контейнеры из уже загруженных образов. Используйте для применения изменений конфигурации, когда контейнеры уже запущены.

• Проверьте доступность веб-интерфейса, авторизацию пользователей, работу с документами и отсутствие критических ошибок в логах. Полный перечень проверок приведён в чек-листе проверки стенда. После успешного выполнения проверок обновление считается завершённым.

• При возникновении ошибок обратитесь в техническую поддержку: support@businessstudio.ru, приложив скриншоты и описание ошибки. При необходимости восстановите систему из резервных копий баз данных и конфигурации, используя процедуру отката.

• История изменений (Changelog) 7.0.9614
• История изменений (Changelog) 7.0.9728