К статье
Практический материал

Администрирование · 12 мин

Как обновить платформу 1С на веб-сервере

Пошаговое обновление платформы 1С на веб-сервере Apache или IIS: установка дистрибутива, перепубликация баз, проверка работы и откат при ошибках.

Обновление платформы 1С на веб-сервере отличается от обычной установки на клиентский компьютер: недостаточно просто запустить инсталлятор. После обновления нужно заново опубликовать информационные базы, проверить соответствие версий платформы на сервере и у клиентов, а также убедиться, что веб-сервер (Apache или IIS) загружает модули новой версии, а не кэшированные старые.

Типичная ситуация, когда требуется такое обновление: конфигурация обновлена до релиза, который требует более новой версии платформы, либо в текущей версии исправлена критичная ошибка. Если базы работают через веб-сервер, пользователи подключаются по HTTP/HTTPS через браузер или тонкий клиент, и любой сбой публикации сразу останавливает работу всех сотрудников.

Ниже разобран полный цикл: подготовка и резервное копирование, установка новой платформы, перепубликация баз на Apache и IIS, проверка результата и откат при проблемах. Инструкция ориентирована на администратора, который уже умеет публиковать базы и имеет доступ к серверу.

Подготовка: что проверить перед обновлением

Первый шаг — убедиться, что новая версия платформы совместима с вашей конфигурацией. Откройте информацию о релизе конфигурации: вендор указывает минимальную требуемую версию платформы. Устанавливать платформу новее требуемой обычно безопасно, но переход через несколько редакций (например, с 8.3.18 на 8.3.24) стоит предварительно протестировать на копии базы.

Проверьте разрядность компонентов. Если на веб-сервере используется 64-разрядный Apache или IIS, модуль веб-расширения 1С (wsap24.dll / mod для Apache) должен быть той же разрядности, что и веб-сервер. Смешение 32-битного модуля с 64-битным веб-сервером — одна из самых частых причин ошибки «500» после обновления.

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

Резервное копирование и фиксация текущего состояния

Перед любыми действиями сделайте резервную копию. Для клиент-серверных баз — средствами СУБД (MS SQL, PostgreSQL), для файловых — копирование каталога базы или выгрузка в dt через конфигуратор. Выгрузка в dt дополнительно полезна тем, что позволяет развернуть копию на тестовом стенде и обкатать новую платформу заранее.

Зафиксируйте текущее состояние публикаций: сохраните копии файлов default.vrd из каталогов публикации каждой базы, а для Apache — также фрагменты конфигурации httpd.conf или файлы .htaccess, если публикация настроена через них. При откате эти файлы позволят быстро восстановить привязку к старой версии платформы.

Запишите точную версию установленной платформы (например, 8.3.22.1750) и убедитесь, что у вас есть её дистрибутив. Если дистрибутива нет — скачайте его с портала 1С до начала работ, пока не возникла необходимость срочного отката.

Установка новой версии платформы на сервер

Версии платформы 1С устанавливаются параллельно и не затирают друг друга: каждая версия лежит в своём каталоге (в Windows — C:\Program Files\1cv8\<номер версии>, в Linux — /opt/1cv8/x86_64/<номер версии>). Это значит, что установку новой версии можно выполнить заранее, не прерывая работу пользователей, — переключение произойдёт только при перепубликации баз.

Запустите установщик от имени администратора и выберите нужные компоненты. Для веб-сервера обязателен компонент «Модули расширения веб-сервера» (Web-сервисы / Web server extension modules) — без него публикация будет ссылаться на несуществующие библиотеки. Если сервер 1С (кластер) тоже стоит на этой машине, обновите и его, согласовав порядок: сначала остановка службы агента, затем установка, затем запуск.

После установки проверьте, что каталог новой версии содержит нужные файлы модуля веб-расширения. Для 64-разрядной версии это обычно подкаталог bin с библиотекой wsap24.dll (для Apache 2.4) или ws_isapi.dll для IIS.

Версия платформы в базеВидна в «О программе» или через веб-клиент

Сравните с минимально требуемой версией из релиза конфигурации

Разрядность веб-сервера32 или 64 бита

Разрядность модуля расширения 1С должна совпадать с разрядностью Apache/IIS

Тип базыФайловая или клиент-серверная

Для клиент-серверной нужно согласовать версию платформы с сервером 1С

Количество публикацийОдна или несколько баз на веб-сервере

Каждую базу нужно перепубликовать отдельно

Перепубликация информационных баз на веб-сервере

Перепубликация через конфигуратор

Самый наглядный способ — открыть конфигуратор нужной базы под пользователем с правами администратора и выбрать «Администрирование → Публикация на веб-сервере». Укажите имя публикации, тип веб-сервера и каталог, затем нажмите «Опубликовать». Конфигуратор запишет новый default.vrd со ссылкой на модуль той версии платформы, из которой выполняется публикация.

Важный нюанс: публиковать нужно именно из конфигуратора новой версии платформы. Если открыть базу в старой версии и нажать «Опубликовать», default.vrd перезапишется со ссылкой на старый модуль — и вы получите обратный эффект.

Перепубликация через командную строку

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

cmd
"C:\Program Files\1cv8\8.3.24.1467\bin\webinst.exe" -publish -apache24 -wsdir MyBase -dir "C:\inetpub\wwwroot\MyBase" -connstr "Srvr=Server1;Ref=TradeBase" -confPath "C:\Apache24\conf\httpd.conf"

После выполнения команды проверьте, что в каталоге публикации обновился default.vrd: откройте его и убедитесь, что в атрибуте ib указана строка подключения, а веб-сервер ссылается на модуль новой версии.

Особенности для IIS

На IIS публикация создаёт виртуальный каталог приложения. После перепубликации проверьте, что пул приложений настроен на нужную разрядность: для 64-битного модуля параметр «Enable 32-Bit Applications» должен быть отключён. Также убедитесь, что сопоставление обработчика (handler mapping) для ISAPI-модуля указывает на ws_isapi.dll из каталога новой версии, а не из старого.

Типичные ошибки при перепубликации
01
Публикация из конфигуратора старой версии — default.vrd перезаписывается со ссылкой на старый модуль, и база продолжает работать на прежней платформе
02
Забытый перезапуск веб-сервера — Apache/IIS продолжает держать в памяти старый модуль, пользователи получают ошибки несоответствия версий
03
Несовпадение разрядности модуля и веб-сервера — ошибка 500 или «модуль не загружен» сразу после обновления
04
Перепубликация не всех баз — часть баз работает на новой платформе, часть на старой, что приводит к путанице при диагностике ошибок

Перезапуск веб-сервера и проверка результата

После перепубликации обязательно перезапустите веб-сервер. Для Apache на Windows — перезапуск службы, на Linux — systemctl restart apache2 (или httpd). Для IIS достаточно выполнить iisreset или перезапустить конкретный пул приложений. Без перезапуска веб-сервер может продолжать использовать загруженный в память старый модуль расширения.

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

Контрольные точки

Как проверить результат обновления

Версия платформы в открытой базе
Норма

Отображается новая версия

Тревожный признак

Версия старая — публикация не перезаписана или веб-сервер не перезапущен

Загрузка страницы входа
Норма

Форма авторизации открывается без ошибок HTTP

Тревожный признак

Ошибка 500/503 — проблема с модулем расширения или разрядностью

Работа регламентных операций
Норма

Отчёты и обмены выполняются без ошибок

Тревожный признак

Ошибки в журнале регистрации после обновления

Сеансы пользователей
Норма

Пользователи подключаются и работают

Тревожный признак

Массовые разрывы соединений или зависания клиентов

Дополнительно проверьте журнал регистрации 1С и логи веб-сервера (error.log у Apache, Event Viewer и логи IIS у Microsoft) на наличие ошибок в первые часы работы. Часть проблем — например, с правами на временные каталоги — проявляется только под нагрузкой.

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

Если после обновления база не работает, откат сводится к обратной перепубликации: запустите конфигуратор старой версии платформы (она осталась установленной) и повторно опубликуйте базу, либо восстановите сохранённый ранее default.vrd в каталог публикации. Затем перезапустите веб-сервер.

Учтите важное ограничение: если обновление платформы сопровождалось обновлением конфигурации с реструктуризацией базы данных, простой откат публикации не поможет — база уже преобразована под новый формат. В этом случае потребуется восстановление из резервной копии. Именно поэтому копия перед обновлением обязательна.

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

Маршрут решения

Как выбрать действие в нештатной ситуации

Ошибка 500 сразу после обновленияПроверьте разрядность модуля расширения и веб-сервера, затем путь к модулю в default.vrd или handler mapping
База открывается, но версия платформы стараяПерепубликуйте базу из конфигуратора новой версии и перезапустите веб-сервер
После обновления не работает одна из нескольких базПроверьте, что эта база тоже перепубликована — публикации баз независимы друг от друга
Конфигурация требует реструктуризации и есть ошибкиОстановите работу, восстановите базу из резервной копии и повторите обновление на тестовом стенде

Особые случаи и ограничения

Если платформа обновляется не только на веб-сервере, но и на сервере 1С (кластере), версии должны совпадать: тонкий и веб-клиенты не смогут подключиться, если версия сервера отличается. Обновляйте кластер и веб-сервер в одном окне обслуживания.

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

На Linux-серверах после установки новой платформы проверьте права на каталоги публикации и временные каталоги: пользователь, под которым работает Apache, должен иметь к ним доступ. Проблемы с правами часто маскируются под «ошибку модуля».

Итог

Что важно запомнить

Обновление платформы на веб-сервере — это три обязательных действия: установка новой версии, перепубликация каждой базы именно из новой версии и перезапуск веб-сервера. Резервная копия и сохранённый дистрибутив старой версии — обязательное условие безопасного отката.

Частые вопросы

Можно ли обновить платформу без остановки работы пользователей?

Установить новую версию платформы можно параллельно с работой — версии не конфликтуют. Но перепубликация баз и перезапуск веб-сервера кратковременно прерывают работу, поэтому финальный этап планируйте на нерабочее время или окно обслуживания.

Нужно ли удалять старую версию платформы после обновления?

Сразу — нет. Оставьте предыдущую версию установленной минимум на несколько дней: это позволит быстро откатиться перепубликацией без поиска дистрибутива. Удалять старые версии имеет смысл только после подтверждения стабильной работы.

Почему после обновления браузер показывает ошибку 500?

Чаще всего причина в несовпадении разрядности модуля расширения 1С и веб-сервера либо в том, что публикация ссылается на модуль несуществующей версии. Проверьте default.vrd, настройки пула приложений IIS и перезапустите веб-сервер.

Нужно ли перепубликовывать базу, если платформа обновилась только на сервере 1С?

Если веб-сервер и кластер — разные машины и на веб-сервере платформа не менялась, перепубликация не требуется. Но версии платформы на веб-сервере и сервере 1С должны совпадать, иначе клиенты не подключатся.

Как проверить, какая версия платформы реально обслуживает базу через веб?

Откройте базу в браузере или тонком клиенте через веб-подключение и посмотрите сведения о программе (Справка — О программе). Дополнительно проверьте путь к модулю в default.vrd каталога публикации — он указывает на каталог конкретной версии платформы.

Можно ли автоматизировать обновление для нескольких баз?

Да. Утилита webinst из состава платформы позволяет публиковать базы из командной строки, поэтому перепубликацию всех баз и перезапуск веб-сервера можно собрать в один скрипт. Предварительно протестируйте скрипт на тестовой базе.