> 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/learn/9.-sistema-i-rasshireniya/06-system-updates.md).

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

Загрузите проверенную пару архивов, сформируйте план, проследите обновление и подготовьте откат

## Что вы получите

Система обновляется из панели по подтверждённому плану: оба архива проверяет Update Agent, до изменения создаются резервная копия и контрольная точка баз, а ход операции остаётся доступным во время режима обслуживания. Команда понимает, когда продолжать, откатывать или остановиться.

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

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

## Проверьте готовность

Перед загрузкой убедитесь, что:

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

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

## Подготовьте два архива одной поставки

Панель принимает ровно два независимых ZIP:

* `iexexchanger_backend_update.zip`;
* `iexexchanger_frontend_update.zip`.

Они должны относиться к одной целевой версии. Общий лимит пары в форме — 5 ГиБ. Не переименовывайте другой файл под ожидаемое имя и не смешивайте backend одной поставки с frontend другой.

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

{% stepper %}
{% step %}

### Выберите оба ZIP

Поместите backend и frontend в соответствующие поля. Панель пересчитает доступный остаток размера для второго файла.
{% endstep %}

{% step %}

### Нажмите «Загрузить и проверить»

Дождитесь состояний передачи, приёма агентом и проверки. Готовым считается релиз, который агент проверил и защитил от дальнейшего изменения.
{% endstep %}

{% step %}

### Продолжите загрузку после перезагрузки

Если браузер перезагрузился, выберите ту же пару файлов. Передача продолжится с подтверждённого смещения; новый комплект создаёт другой результат и не является безопасным продолжением.
{% endstep %}

{% step %}

### Не обходите ошибку проверки

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

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

Нажмите **«Сформировать план»**. Это ещё не запускает обновление.

Сверьте:

| Раздел плана       | Что подтвердить                                          |
| ------------------ | -------------------------------------------------------- |
| Переход            | Исходная и целевая версии ожидаемы                       |
| Резервная копия    | Обязательный backup включён в план                       |
| Режим обслуживания | Команда знает, когда сайт может быть временно недоступен |
| Маршрут            | Переход поддерживается текущим Updater                   |
| Срок               | План ещё действителен                                    |
| Контроль           | SHA-256 плана и manifest присутствуют                    |
| Сервер             | Изменения host-профиля понятны и ожидаемы                |
| Этапы              | Нет необъяснённых предупреждений и ручных действий       |

Если срок плана истёк или состояние сервера изменилось, сформируйте новый план. Не подтверждайте устаревший расчёт.

## Запустите и наблюдайте

{% stepper %}
{% step %}

### Нажмите «Подтвердить обновление»

Ещё раз сверьте переход и нажмите **«Запустить обновление»** один раз.
{% endstep %}

{% step %}

### Дождитесь подтверждения агента

Интерфейс сначала передаёт команду, затем только читает состояние. При неопределённом ответе автоматический повтор не выполняется.
{% endstep %}

{% step %}

### Следите за журналом этапов

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

{% step %}

### Получите конечное состояние

Успешным считается завершение итоговой приёмки и появление целевой версии как текущей. Результат **«Проверено — изменений не требуется»** тоже является успешной проверкой без изменений: агент подтвердил, что применить нечего. Состояния **«Ошибка»** и **«Нужно ручное действие»** не разрешают открывать клиентский контур.
{% endstep %}
{% endstepper %}

Если запуск не подтверждён, сначала откройте активную операцию и **«Историю операций»**. Кнопка ручного повтора использует тот же защищённый ключ и не должна создавать вторую системную операцию.

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

## Продолжите только ту же операцию

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

Если агент сообщает, что рабочая версия уже восстановлена, старый план закрыт. Для исправленной поставки заново загрузите оба ZIP и сформируйте новый план; не продолжайте отвергнутые байты.

## Выполните откат или возврат

Откройте вкладку **«Установленные версии»**.

{% tabs %}
{% tab title="Откат" %}
Для прежней версии кнопка появляется только при наличии проверенного релиза и контрольной точки обеих баз. Сформируйте план отката, прочитайте его и подтвердите отдельную операцию.
{% endtab %}

{% tab title="Возврат" %}
После отката более новая сохранённая версия может стать доступной для быстрого возврата. Система снова формирует план и создаёт резервную копию перед переключением.
{% endtab %}
{% endtabs %}

Откат файлов без соответствующего состояния баз недопустим. Если кнопки нет, агент не подтвердил безопасный маршрут; не имитируйте его ручным переключением каталогов.

## Удаляйте старую версию отдельно

Удаление версии не является частью успешного обновления и не запускается автоматически.

1. Нажмите **«Удалить»** у выбранной сохранённой версии.
2. Дождитесь расчёта файлов, каталогов, ссылок и занимаемого места.
3. Проверьте, сохраняется ли резервный снимок и будет ли потеряна точка быстрого отката.
4. Если расчёт устарел, нажмите **«Пересчитать состав»**.
5. Подтвердите только точную выбранную версию.

Текущую версию удалить нельзя. Для предыдущей версии требуется явное подтверждение потери быстрого отката. Зашифрованная резервная копия живёт по отдельной backup-политике и не удаляется этой кнопкой.

## Проверьте после завершения

1. Сверьте текущую версию и конечное состояние операции.
2. Откройте **«Историю операций»** и **«Журнал действий»**.
3. Проверьте [службы](https://docs.iexexchanger.com/learn/9.-sistema-i-rasshireniya/07-server-services.md) и полную [диагностику](https://docs.iexexchanger.com/learn/10.-zapusk/14-system-diagnostics.md).
4. Проверьте вход администратора и клиента, очередь, курсы, экспорт и уведомления.
5. Создайте новую контрольную заявку.
6. Только после приёмки снимайте усиленное наблюдение.

Если получено **«Проверено — изменений не требуется»**, убедитесь, что текущая поставка действительно ожидаемая, сохраните запись проверки и не запускайте ту же операцию повторно.

## Этап завершён, если

* [ ] Update Agent готов и нет конкурирующей операции;
* [ ] загружены два ZIP с точными именами из одной поставки;
* [ ] агент подтвердил архивы и план;
* [ ] резервная копия и контрольная точка входят в план;
* [ ] команда наблюдала все этапы, включая режим обслуживания;
* [ ] неопределённый ответ не привёл к повторному слепому запуску;
* [ ] конечная версия и успешная итоговая приёмка подтверждены;
* [ ] результат «изменений не требуется» распознаётся как проверенный итог, а не как ошибка;
* [ ] способ отката доступен либо отсутствие отката явно принято;
* [ ] старая версия не удалена до окончания наблюдения;
* [ ] службы, диагностика и новая заявка проверены после операции.

Далее изучите [состояние и управление службами](https://docs.iexexchanger.com/learn/9.-sistema-i-rasshireniya/07-server-services.md).
