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

В данной инструкции описывается процесс обновления Business Studio 7.

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

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

Перед проведением обновления:

1. Создайте резервные копии всех используемых баз. Для каждой из них:

1. Запустите десктопный клиент приложения (см. Десктопное приложение Business Studio).
2. В окне Выбор базы данных выберите нужную базу и нажмите «Свойства».
3. Нажмите кнопку «Сохранить» и выберите папку для сохранения.

2. Создайте резервную копию файлов конфигурации и сертификатов, используемых текущей установкой Business Studio. Рекомендуется сохранить копии следующих файлов:

• .env;
• docker-compose.yml;
• appsettings.json;
• SSL-сертификаты.

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

В рамках выхода новых версий Business Studio 7 в файлы конфигурации могут вноситься изменения: добавляться новые параметры, изменяться значения существующих, удаляться устаревшие ключи и т.д. Список измененных файлов и изменений по каждой версии приведён ниже в разделе Changelog ниже.

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

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

При обновлении можно воспользоваться любым из следующих подходов:

• Актуализировать свои файлы — внести в текущие конфигурационные файлы изменения на основе информации для устанавливаемой вами версии программы из раздела История измненений (Changelog) ниже и описаний параметров из файла Содержимое appsettings.jsonc (см. Файл "Содержимое appsettings.jsonc").
• Взять новые файлы за основу — использовать файлы конфигурации из папки с обновлением и перенести в них свои специфичные настройки. Описание параметров и примеры также см. в файле Содержимое appsettings.jsonc.

При переносе настроек в новые файлы конфигурации обратите особое внимание на:

• параметры файла .env, включая данные версии и авторизации из файла «Версии и авторизации.txt» из папки с обновлением;
• пользовательские настройки в файле appsettings.json;
• настройки портов и монтирования томов в файле docker-compose.yml;
• пути к сертификатам и другим внешним ресурсам.

Необходимо проверить:

• корректность монтирования томов и портов (это все переменные, указанные в строках Volumes и Ports);
• пути к сертификатам и другим внешним ресурсам.

Примеры строк, требующих проверки при использовании собственных сертификатов:

• ./DockerCompose/Certificates/https:/certs
• ./DockerCompose/Certificates/https/bs-backend:/https
• ./DockerCompose/Certificates/https/bs-license-server:/https
• ./DockerCompose/Certificates/https:/opt/certificates

Внимание! Используйте файлы конфигурации из новой версии. Копирование файлов .env, docker-compose.yml или appsettings.json из старой версии поверх новых может привести к критическим ошибкам при запуске стенда.

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

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

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

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

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

2. После внесения изменений в файлы конфигурации запустите стенд командой ./bs.sh --start и проверьте его работоспособность. Необходимо проверить:

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

Команда автоматически загрузит и запустит образы версии, указанной в файле .env, сохранив существующие данные в томах Docker.

Внимание! Команду необходимо запускать из папки текущего стенда.

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

3. После проверки работоспособности системы обновление считается завершённым.

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

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