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

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

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

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

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

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

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

2. Снимите копию текущей конфигурации — скопируйте файлы проекта (папка «bs_web_<номер версии>_stu») и разместите их в отдельной директории.

3. Разместите файлы обновления в новой отдельной папке или в новом (тестовом) окружении. 

Обновите параметры файла .env согласно данным из файла Версии и авторизации.txt из папки с обновлением. 

Откройте docker-compose.yml в папке, где вы разместили файлы с обновлением. Если в прошлой версии вы меняли порты или пути к сертификатам, проверьте и измените эти настройки в новом файле.

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

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

1. Корректность монтирования томов и портов. Это все переменные, указанные в строках «Volumes» и «Ports».

2. Пути к сертификатам и другим внешним ресурсам. Примеры таких строк указаны ниже:

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

Откройте файл appsettings.json в папке, где вы разместили обновление. Если в прошлой версии вы меняли его настройки, проверьте и измените соответствующие параметры в новом файле. Для удобства откройте оба файла рядом (в режиме split view), чтобы сверить параметры.

В качестве справки можно использовать файл Содержимое appsettings.jsonc, который содержит описание каждого параметра. Этот файл можно найти по пути: …/DockerCompose/bs-backend/settings.

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

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

1. Перенесите SSL-сертификаты из старой версии в новое окружение.
2. Снимите пароль с приватного ключа, иначе система его не примет.

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

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



1. Остановите работу старого тестового стенда и освободите занимаемые им ресурсы (порты и сети) командой:

docker-compose down

Внимание! Команду необходимо запускать из папки старого стенда (копии снятой до обновления).

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

3. Запустите стенд командой ./bs.sh –start и проверьте его работоспособность. Необходимо проверить:

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

Внимание! Команду необходимо запускать из папки нового стенда/нового окружения.

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

4. При отсутствии ошибок во время тестирования выполните развертывание системы в производственном окружении.

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