Обновление веб-ЛК и возврат прежней версии

Для администратора существующей установки; основной текст готовится для 4.0.34. Первая версия этого порядка не установлена. Обновление файлов ЛК и обновление базы УИТ — разные операции. Версии и совместимость.

Подготовьтесь

1. Узнайте текущую версию в «Справке» кабинета или в manifest.json его папки. Скачайте нужный опубликованный архив.
2. Откройте CHANGELOG.md нового архива и прочитайте все пропущенные выпуски. Найдите указания «Настройки веб-сервера», изменения API и другие обязательные действия. Номер инструкции не подтверждает появление выпуска в загрузках.
3. Сохраните отдельно всю действующую папку ЛК, config.json, настройки IIS/Apache, свои значки и установленные плагины с их настройками. Не ограничивайте копию только двумя файлами, если кабинет дорабатывался.
4. Проверьте новую поставку на тестовом стенде с нужной базой УИТ. Согласуйте короткий перерыв для рабочей замены: во время копирования посетители могут получить неполный комплект файлов.

Замените файлы

1. Ещё раз проверьте физический путь отдельной папки кабинета. Не очищайте папку публикации базы, каталог ИБ или весь сайт.
2. После резервного копирования уберите старые файлы из папки ЛК и скопируйте содержимое app новой версии. Не копируйте поверх старого комплекта: между выпусками меняются имена файлов.
3. На IIS обязательно положите рядом с index.html файл deploy/iis/web.config нового архива. Верните необходимые местные настройки осознанно; прежний файл целиком вместо нового не используйте.
4. На Apache сравните указания журналов выпусков о lk-alias.conf. Если нужна замена, возьмите новый файл, заново заполните свои ITLK_PATH и ITLK_DIR, проверьте синтаксис и примените настройки по Windows или Ubuntu. При обычной замене только файлов перезапуск Apache не требуется.
5. Перенесите адреса своей базы в новый config.json, сверив его поля с инструкцией поставки. Верните собственный значок и совместимые плагины. Если для другого формата значка вы меняли ссылку в index.html, повторите её в новом файле.
6. Откройте кабинет, обновите страницу с очисткой кэша (Ctrl+F5 в Windows) и сравните версию в «Справке» с архивом. Проверьте вход, проект/задание, вложение, базу знаний и обновление страницы. Затем выполните общую проверку.

Если появился запрос адреса базы, начните с config.json. При ошибках загрузки файлов проверьте полный комплект новой версии; повторное копирование одного index.html не заменяет обновление.

Если нужно вернуться

Сохраните текст ошибки и время. Верните весь прежний комплект файлов, его config.json и соответствующие серверные настройки из резервной копии. При изменении конфигурации Apache сначала проверьте синтаксис. Повторите проверку входа и версии.

Резервную копию не удаляйте до подтверждения нормальной работы. Если одновременно менялась база УИТ, возврат файлов ЛК не откатывает базу: её восстановление выполняет администратор 1С по отдельному плану.