> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/knowledge-base/obsluzhivanie/maintenance-overview/product-update.md).

# Обновление системы

Загрузка, проверка и безопасная установка обновления из панели управления

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

Точный путь:

**«Обновления»**

## Какие права нужны

Права находятся в блоке «Админпанель» и выдаются по пути **«Пользователи» — «Список групп пользователей»**. Откройте нужную группу.

| Право                                 | Что разрешает                                                            |
| ------------------------------------- | ------------------------------------------------------------------------ |
| «Просмотр обновлений системы»         | Версии, состояние агента, историю операций и журнал действий             |
| «Запуск обновлений и откатов системы» | Загрузку пакетов, установку, продолжение, откат и удаление старых версий |

Сотрудник только с правом просмотра не может изменить систему. Старое право «Разрешить управление системой обновления» не заменяет два новых права.

{% hint style="danger" %}
Право запуска относится к критическим. Выдавайте его только техническому администратору, который отвечает за резервные копии, окно обслуживания и приёмку обменного пункта.
{% endhint %}

## Что показывает экран

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

| Вкладка                | Назначение                                                          |
| ---------------------- | ------------------------------------------------------------------- |
| «Установленные версии» | Текущая и сохранённые версии, доступность отката и занимаемое место |
| «История операций»     | Установки, откаты, возвраты вперёд, время, этапы и итоговый отчёт   |
| «Журнал действий»      | Кто, когда и какое защищённое действие выполнил                     |

Если агент недоступен, панель остаётся доступной для чтения истории, но не позволяет начинать новую операцию.

## Проверка актуальной версии

Блок «Актуальная версия iEXExchanger» получает сведения из официального каталога. Нажмите «Проверить», чтобы обновить дату проверки и сравнение с установленной версией. Архивы при этом не скачиваются и не устанавливаются автоматически.

Если каталог временно недоступен, панель может показать последние сохранённые данные. Локальная история, состояние агента и доступный откат продолжают работать независимо от каталога.

После повторяющихся технических ошибок агент может приостановить запуск новых обновлений. Прочитайте причину и историю, устраните проблему и только затем нажмите «Возобновить». Это не продолжает старую операцию: незавершённая операция обрабатывается отдельным действием «Продолжить».

## Какие файлы загрузить

Для обновления нужна пара ZIP-файлов одной поставки:

* архив Backend;
* архив Frontend.

Имя файла может содержать номер и идентификатор поставки, поэтому ориентируйтесь на назначение слота и результат проверки, а не только на название. Не смешивайте части из разных поставок. Допустимый размер показан возле каждого поля и учитывает общий лимит пары.

## Установка обновления

{% stepper %}
{% step %}

### Подготовьте рабочее окно

Завершите критичные ручные операции, проверьте активные заявки и предупредите операторов. Не начинайте обновление одновременно с переносом данных, сменой DNS или другой серверной работой.
{% endstep %}

{% step %}

### Загрузите пару архивов

Выберите оба файла и нажмите «Загрузить и проверить». Дождитесь завершения проверки каждого файла. Повторно нажимать кнопку во время загрузки не нужно.
{% endstep %}

{% step %}

### Сформируйте план

Нажмите «Сформировать план». Проверьте исходную и целевую версии, необходимость обслуживания, резервную копию, изменения служб и этапы операции.
{% endstep %}

{% step %}

### Подтвердите обновление

Нажмите «Подтвердить обновление», внимательно прочитайте предупреждение и подтвердите только тот план, который был проверен. Просроченный или изменившийся план нужно сформировать заново.
{% endstep %}

{% step %}

### Запустите операцию

Нажмите «Запустить обновление». Не закрывайте работу операторов вручную и не запускайте серверные команды параллельно: панель сама создаёт контрольную точку и управляет режимом обслуживания.
{% endstep %}

{% step %}

### Дождитесь итогового результата

Следите за этапами «Проверка», «Применение», «Проверка результата» и «Завершение». Если операция остановлена безопасно, используйте действие, предложенное самой панелью.
{% endstep %}

{% step %}

### Выполните прикладную приёмку

После успешного результата войдите заново, откройте список заявок, выполните расчёт, создайте безопасную тестовую заявку, проверьте очередь, уведомление и чат. Технический статус не заменяет проверку рабочего сценария.
{% endstep %}
{% endstepper %}

## Что проверяет план

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

Не обходите блокирующую проверку ручной распаковкой файлов. Сохраните сообщение и передайте его вместе с данными из статьи [«Данные для технической поддержки»](/knowledge-base/obsluzhivanie/maintenance-overview/support-evidence.md).

## Что происходит автоматически

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

Порядок защищает систему от преждевременной активации:

| Этап                | Что должно быть подтверждено                                                   |
| ------------------- | ------------------------------------------------------------------------------ |
| Проверка поставки   | Оба архива относятся к одной доверенной и совместимой поставке                 |
| Резервные данные    | Созданы и проверены копии основной базы и базы мониторинга                     |
| Файлы версии        | Новые файлы подготовлены отдельно от текущей рабочей версии                    |
| Контрольная точка   | Сохранено состояние, необходимое для разрешённого отката                       |
| Применение          | Выполнены обязательные изменения и согласованное переключение служб            |
| Проверка результата | Панель, клиентская часть и обязательные технические проверки ответили ожидаемо |
| Завершение          | Новая версия отмечена текущей, обслуживание снято, отчёт сохранён              |

Состояние этапа **«Проверено — изменений не требуется»** является успешной проверкой: агент подтвердил, что на этом шаге нечего применять. Оно не означает пропущенную ошибку. Отличайте его от «Ожидает», «Выполняется» и «Ошибка» по точной подписи и общему результату операции.

Новая версия не должна становиться текущей, если обязательная резервная копия, контрольная точка или итоговая проверка не подтверждены. Откройте журнал этапов и найдите первый неуспешный обязательный шаг, а не ориентируйтесь только на общий процент.

Незавершённая операция не запускается второй раз. Порядок безопасного продолжения описан в [«Ход обновления и восстановление операции»](/knowledge-base/obsluzhivanie/maintenance-overview/product-update/update-progress-and-recovery.md), а возврат — в [«Откат и история версий»](/knowledge-base/obsluzhivanie/maintenance-overview/product-update/rollback-and-release-history.md).

После завершения откройте **«Утилиты» — «Службы»** и проверьте критические процессы по инструкции [«Службы обменника»](/knowledge-base/obsluzhivanie/maintenance-overview/server-services.md). Экран обновлений управляет ими автоматически; отдельный ручной перезапуск во время операции выполнять нельзя.

## Результат

Обновление считается завершённым, когда экран показывает успешный итог, режим обслуживания выключен, текущая версия изменилась, критические службы работают и прикладная приёмка пройдена. Сохраните запись истории операции и результат проверки.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/knowledge-base/obsluzhivanie/maintenance-overview/product-update.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.