> 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. Проверьте [службы](/learn/9.-sistema-i-rasshireniya/07-server-services.md) и полную [диагностику](/learn/10.-zapusk/14-system-diagnostics.md). 4. Проверьте вход администратора и клиента, очередь, курсы, экспорт и уведомления. 5. Создайте новую контрольную заявку. 6. Только после приёмки снимайте усиленное наблюдение. Если получено **«Проверено — изменений не требуется»**, убедитесь, что текущая поставка действительно ожидаемая, сохраните запись проверки и не запускайте ту же операцию повторно. ## Этап завершён, если * [ ] Update Agent готов и нет конкурирующей операции; * [ ] загружены два ZIP с точными именами из одной поставки; * [ ] агент подтвердил архивы и план; * [ ] резервная копия и контрольная точка входят в план; * [ ] команда наблюдала все этапы, включая режим обслуживания; * [ ] неопределённый ответ не привёл к повторному слепому запуску; * [ ] конечная версия и успешная итоговая приёмка подтверждены; * [ ] результат «изменений не требуется» распознаётся как проверенный итог, а не как ошибка; * [ ] способ отката доступен либо отсутствие отката явно принято; * [ ] старая версия не удалена до окончания наблюдения; * [ ] службы, диагностика и новая заявка проверены после операции. Далее изучите [состояние и управление службами](/learn/9.-sistema-i-rasshireniya/07-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/learn/9.-sistema-i-rasshireniya/06-system-updates.md?ask=&goal= ``` `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.