> 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/ustanovka-i-obnovlenie/obnovlenie-produkta/obnovlenie-s-servera.md). # Обновление с сервера Подключение сервера, предзагрузка, получение комплекта и установка через административную панель Подключите обменник к получению обновлений по вашей лицензии, чтобы сервер сам скачивал комплект. Затем проверьте план и запустите установку через административную панель. На этой странице также описаны автоматическая подготовка и ручная загрузка двух ZIP с компьютера. ## Готовый промпт для обновления через панель Перед использованием заполните домены, выбранный релиз и способ получения комплекта. Подтверждение сервера в кабинете владельца выполняйте после проверки его данных. {% prompt description="Обновление через административную панель" icon="desktop" openInAIProviders="true" defaultExpanded="partial" %} ```markdown Помоги штатно обновить iEXExchanger через раздел «Инструменты» — «Обновления». Сайт обменника: https://ваш_домен. Серверная часть: https://app.ваш_домен. Целевая версия: укажу отдельно. Способ получения: скачивание сервером, готовая предзагрузка или два ZIP с компьютера — укажу отдельно. Проверь текущую версию, состояние Update Agent, резервного копирования и незавершённых операций. Для скачивания сервером проверь подключение лицензии. Если требуется подтверждение IP, доменов, отпечатка или кода из письма, дай мне выполнить его в кабинете владельца. Получение и подготовка файлов не разрешают установку автоматически. Подготовь план и покажи переход версий, обслуживание, резервное копирование, изменения окружения и предупреждения. До моего подтверждения установки не нажимай «Запустить обновление». После принятия команды наблюдай существующую операцию. При потере ответа проверь её состояние; не создавай второй запуск. При ошибке сохрани этап, идентификатор и код, затем выбери разрешённое продолжение или восстановление по рекомендации системы. После успеха проверь новую текущую версию, отсутствие обслуживания, серверные службы, HTTPS обоих доменов, вход в панель и основные функции продукта. После проверки сохрани резервную копию новой версии и отчёт. Не распаковывай ZIP поверх проекта, не запускай миграции отдельно, не меняй ссылки релизов и не снимай обслуживание вручную после сбоя. ``` {% endprompt %} ## Подключение получения обновлений В административной панели откройте: **«Обновления»**
{% stepper %} {% step %} ### Запросите подключение в панели 1. В разделе **«Обновления»** нажмите **«Обновления с сервера»**. Также можно начать через **«Настроить»** в сообщении о неподключённом получении файлов. 2. В окне **«Подключение сервера»** нажмите **«Подключить получение обновлений»**. 3. Дождитесь результата запроса. При состоянии **«Ожидается подтверждение сервера»** перейдите к подтверждению в личном кабинете. {% endstep %} {% step %} ### Подтвердите сервер в личном кабинете 1. Откройте [официальный сайт iEXExchanger](https://iexexchanger.com) под владельцем лицензии и перейдите в **«Личный кабинет» — «Лицензия обменника»**. 2. Откройте лицензию своего обменника и блок **«Получение обновлений сервером»**. 3. Сравните домен, публичный исходящий IP сервера и **«Отпечаток ключа установки»** с данными в разделе обновлений обменника. 4. В поле **«Подтвердите IP-адрес сервера»** введите проверенный адрес или нажмите **«Подставить IP»**. Отметьте подтверждение сверки домена, IP и отпечатка. 5. Нажмите **«Подтвердить сервер»**. Если откроется окно **«Подтвердите сервер по почте»**, введите **«Код из письма»** и подтвердите действие. Почтовый код содержит шесть цифр и действует 10 минут. Если срок истёк, запросите новый через **«Отправить код повторно»**, когда кнопка станет доступна. Используйте код из последнего письма. Для входа в лицензии применяется двухфакторная защита аккаунта. Если система просит подтвердить почту или включить двухфакторную защиту, выполните указанное действие в настройках личного кабинета. {% hint style="warning" %} Подтверждение разрешает конкретной установке получать файлы по вашей лицензии. Сверяйте данные сервера перед подтверждением. Если IP, домены или отпечаток отличаются, сначала выясните причину. {% endhint %} {% endstep %} {% step %} ### Проверьте подтверждение Вернитесь в панель обменника, нажмите **«Обновить статус»** и дождитесь состояния **«Получение обновлений подтверждено»**. Подключение не включает предзагрузку автоматически. После подключения можно скачивать по кнопке или отдельно включить фоновую подготовку. {% endstep %} {% endstepper %} ### Если лицензия связана с другим сервером При переносе обменника используйте заявку на смену сервера из новой установки. 1. Откройте состояние подключения и нажмите **«Отправить заявку на смену сервера»**. 2. В окне **«Смена привязки сервера»** прочитайте сведения и нажмите **«Подать заявку»**. 3. Дождитесь проверки и подтверждения администратором официального сайта. При состоянии ожидающей заявки повторная отправка не требуется. 4. Используйте **«Проверить статус»**. После одобрения нажмите **«Продолжить после подтверждения»** и завершите подключение. 5. Повторно проверьте статус получения обновлений. До подтверждения переноса прежняя установка сохраняет доступ, а новая не получает право скачивания. Данные прежнего сервера не передаются в админку нового обменника: их сверяет владелец лицензии и уполномоченный администратор официального сайта. Изменение исходящего IP, отзыв доступа или полная отвязка также могут потребовать вмешательства администратора официального сайта. Изменение поля **«IP для установки»** в лицензии само по себе не заменяет подтверждение сервера обновлений. *** ## Получение комплекта обновления Выберите источник файлов. Во всех случаях сервер проверяет комплект, а установка начинается после подтверждения плана. ### Если требуется новый ZIP лицензии При обычном обновлении Updater сохраняет действующие лицензионные файлы. Дополнительный ZIP лицензии нужен, когда его применение предусмотрено для выбранного перехода или прежние файлы нельзя безопасно сохранить. В форме ручного обновления есть два поля: Backend и Frontend. Поля для ZIP лицензии в ней нет. Если нужен новый ZIP лицензии, технический специалист задаёт его источник в полной конфигурации Updater до приёма комплекта агентом. {% content-ref url="/pages/JWOtjTp6xQSetScQNuph" %} [Обновление через терминал](/ustanovka-i-obnovlenie/obnovlenie-produkta/obnovlenie-cherez-terminal.md) {% endcontent-ref %} Принятая агентом загрузка использует сохранённую конфигурацию. Изменение базового файла после приёма архивов не обновляет уже подготовленную операцию. Если её нужно заменить, сначала завершите допустимую отмену и создайте новую подготовку. {% tabs %} {% tab title="Скачать с сервера" %} 1. Убедитесь, что подключение подтверждено и комплект доступен вашей лицензии. 2. Откройте получение обновления через доступное действие **«Перейти к обновлению»** или форму нового обновления. 3. Если в форме показан **«Способ загрузки»**, выберите **«С официального сайта»**. 4. Проверьте версию и состав комплекта, затем нажмите **«Скачать обновление»**. 5. Следите за передачей серверной части и сайта обменника. При необходимости используйте **«Обновить статус»** или **«Открыть загрузку»**. 6. Дождитесь проверки обоих архивов. При готовых файлах нажмите **«Перейти к обновлению»**, а при готовой подготовке — **«Просмотреть план»**. 7. Проверьте план и подтвердите установку в разделе «План и запуск установки». Файлы получает сервер обменника. После принятия задачи окно и браузер можно закрыть: скачивание и подготовка сохраняются на сервере. Во время скачивания интерфейс показывает полученный объём, ожидаемый размер, скорость и состояние передачи. При временных сетевых сбоях сервер может повторять запросы и продолжать передачу с сохранённого места. Если показана причина, требующая вашего действия, сначала устраните её. Сообщение **«Оба архива получены и проверены»** подтверждает готовность комплекта. Оно ещё не подтверждает установку новой версии. {% endtab %} {% tab title="Загрузить с компьютера" %} ### Подготовьте файлы Для одного обновления используются два официальных ZIP одного релиза: | Файл | Поле формы | Содержимое | | ---------------------------------- | ---------- | --------------- | | `iexexchanger_backend_update.zip` | Backend | Серверная часть | | `iexexchanger_frontend_update.zip` | Frontend | Сайт обменника | Передайте оригинальные файлы без распаковки, перепаковки и изменения содержимого. Сохраните имена файлов. Архивы чистой установки не заменяют архивы обновления. Стандартные пределы загрузки: Backend — 400 МиБ, Frontend — 100 МиБ, вместе — 500 МиБ. Форма показывает действующие ограничения сервера; ориентируйтесь на них. #### Получите файлы в личном кабинете 1. На [официальном сайте](https://iexexchanger.com) откройте **«Личный кабинет» — «Лицензия обменника»** и лицензию нужного проекта. 2. В блоке **«Релизы и файлы лицензии»** проверьте версию доступного релиза. 3. В разделе **«Обновление»** скачайте Frontend и Backend кнопками **«Скачать»** у соответствующих файлов. 4. Сверьте имена, версию, размеры и контрольные суммы, если они показаны в карточке. 5. Если для перехода требуется новый ZIP лицензии, получите его отдельно через **«Скачать ZIP лицензии»** в блоке **«Версия и лицензия»**. Ручная выдача зависит от настроек и доступа к релизу. Если блок сообщает, что выдача ZIP закрыта, используйте скачивание сервером. Для специального ручного сценария согласуйте получение комплекта с поддержкой. Не подбирайте файлы разных версий и не собирайте ZIP из установленного проекта. ### Загрузите и проверьте файлы 1. В разделе **«Обновления»** нажмите **«Новое обновление»** или **«Обновить вручную»**. 2. Если доступен выбор источника, выберите **«С компьютера»**. 3. В поле Backend выберите `iexexchanger_backend_update.zip`, в поле Frontend — `iexexchanger_frontend_update.zip` того же релиза. Файлы также можно перетащить в соответствующие области. 4. Проверьте выбранные файлы. До начала передачи можно заменить или убрать ошибочный выбор. 5. Нажмите **«Загрузить и проверить»**. 6. Дождитесь передачи обоих файлов и проверки агентом. Завершение индикатора передачи ещё не заменяет серверную проверку. 7. После приёма файлов система переходит к подготовке плана. Если форма предлагает **«Сформировать план»**, нажмите эту кнопку. 8. Проверьте план и подтвердите установку. После приёма агент фиксирует содержимое архивов. Заменить файлы внутри этой подготовки нельзя: для исправленного комплекта нужна новая загрузка. Кнопка **«Подтвердить обновление»**, если она показана для уже готового плана, открывает его для просмотра. Установка начинается кнопкой **«Запустить обновление»** в плане. ### Если передача файлов прервалась При потере связи или перезагрузке браузера откройте раздел повторно и выберите ту же пару оригинальных файлов. Если сессия загрузки ещё действует, передача продолжится с подтверждённого сервером места. Система сравнивает файлы с прежним выбором. Другая версия или изменённый ZIP не подходят для продолжения этой сессии. Пока файлы передаются с компьютера, браузер должен оставаться открыт. После приёма комплекта и начала серверной подготовки дальнейшее состояние хранится на сервере. Если сессия истекла до запуска операции, создайте новую загрузку. Для прекращения незавершённой передачи используйте **«Отменить загрузку»**. Если ручные архивы уже приняты, но план не подготовлен, карточка **«Архивы загружены вручную»** позволяет нажать **«Подготовить план»** и продолжить без повторной передачи файлов. {% endtab %} {% endtabs %} ## Автоматическая подготовка обновлений ### Настройте предзагрузку 1. Подтвердите подключение сервера к получению обновлений. 2. Откройте **«Настройки обновлений»** кнопкой с шестерёнкой. 3. Включите **«Заранее скачивать обновления»**. 4. Укажите ограничение скорости и срок хранения неиспользованных архивов. 5. Выберите, показывать ли кнопку ручного обновления. 6. Нажмите **«Сохранить»** и дождитесь подтверждения. | Параметр | Доступные значения | Что меняется | | --------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------- | | «Кнопка ручного обновления» | «Показывать» или «Скрывать» | Видимость ручной кнопки в разделе | | «Заранее скачивать обновления» | Включено или выключено | Фоновое получение доступных новых комплектов и подготовка плана | | «Ограничение скорости, КиБ/с» | `0` либо от `64` до `102400` | Максимальная скорость фоновой предзагрузки; `0` означает отсутствие ограничения | | «Хранить неиспользованные архивы, дней» | От `1` до `30` | Срок хранения неиспользованного автоматически полученного комплекта | Исходные значения: предзагрузка выключена, скорость не ограничена, срок хранения — 7 дней. Параметры скорости и хранения показываются при включённой предзагрузке. **«Скрывать»** меняет видимость кнопки. Права на обновления и работу ручной загрузки определяет доступ пользователя. Закрытие формы без **«Сохранить»** не применяет изменения. Если настройки уже изменили в другой сессии, обновите данные, снова проверьте значения и повторите сохранение. ### Как работает фоновая подготовка Планировщик периодически проверяет персонально доступный релиз. Когда подтверждена новая версия и готов весь комплект, сервер создаёт задачу, скачивает архивы, проверяет их и сохраняет план. Браузер для этого не нужен. Задача и её состояние сохраняются в системе. Во время активной установки, незавершённой операции, ручной загрузки или режима обслуживания новая подготовка может ожидать освобождения системы. Предзагрузка выполняется с учётом прав пользователя, включившего её. Если пользователь удалён, заблокирован или потерял право управления обновлениями, подготовку нужно проверить и заново настроить от действующего администратора. Выключение предзагрузки прекращает создание новых автоматических скачиваний. Уже принятая передача может завершиться; выключение настройки не отменяет существующую операцию. ### Откройте подготовленное обновление Когда подготовка завершена, в разделе появляется карточка **«Обновление … подготовлено»**. 1. Нажмите **«Просмотреть план»**. 2. Дождитесь проверки готовности. Если сохранённый план устарел, система повторно подготовит его по текущему состоянию. 3. Проверьте переход, обязательные действия и предупреждения. 4. Продолжите по разделу «План и запуск установки»: проверьте план, выберите время и подтвердите запуск. Если появилось **«Подготовку обновления нужно продолжить»**, используйте действие, указанное рядом: **«Проверить подключение»**, **«Продолжить после исправления»** или повторную проверку состояния. ### Напоминание о новой версии Система сообщает о доступном обновлении через уведомления. Переход из уведомления открывает раздел обновлений. Если версия пока не устанавливается, нажмите **«Напомнить позже»**, выберите **«Через 4 часа»**, **«Через сутки»**, **«Через 3 дня»** или **«Через неделю»**, затем нажмите **«Подтвердить»**. Отсрочка относится к выбранной версии и хранится для установки в целом. Следующий новый релиз может уведомить отдельно. Действие **«Отменить отсрочку»** снимает установленную отсрочку. Напоминание не назначает время установки и не выключает предзагрузку. ### Отмена подготовки и удаление скачанных архивов У готовой или остановившейся подготовки доступно действие **«Отмена»**. После него система проверяет, можно ли удалить неиспользованный комплект, и просит подтвердить отмену подготовки. В окне серверной загрузки для неиспользованного комплекта может быть доступно **«Удалить архивы»**. Это удаление входных файлов и связанной подготовки. Рабочая установленная версия сохраняется, история действий остаётся. Архивы, уже используемые подтверждённой операцией, защищены от такого удаления. Для существующей операции применяются правила отмены или восстановления из раздела ниже. Срок хранения в настройках относится к неиспользованным автоматически предзагруженным комплектам. Он не задаёт срок хранения установленных релизов и резервных копий. После удаления или истечения срока неиспользованного комплекта эта версия не скачивается повторно фоновой предзагрузкой. При необходимости запросите её явно через **«Скачать обновление»**. Следующий доступный релиз остаётся кандидатом на автоматическую подготовку. ## План и запуск установки Эти действия одинаковы для скачивания с сервера, автоматической подготовки и ручной загрузки ZIP. {% stepper %} {% step %} ### Проверьте план План показывает: * **«Исходная версия»** и **«Целевая версия»** — какой переход будет выполнен. * **«Резервная копия»** — обязательность резервного копирования. * **«Режим обслуживания сайта»** — необходимость временного обслуживания. * **«Маршрут обновления»** — подтверждённый способ перехода. * **«Изменения на сервере»** — необходимые изменения окружения, если они есть. * **«Этапы»** — последовательность проверок и действий. * **«Предупреждение»** — условия, которые следует проверить до запуска. * **«План действителен до»** — крайнее время запуска этого плана. * Контрольные суммы плана и описания релиза — сведения для сопоставления и диагностики. План должен соответствовать выбранному релизу и текущему состоянию сервера. Он проверяет совместимость комплекта и перехода, но ещё не устанавливает новую версию. Если срок истёк, текущая версия изменилась или повторная проверка отклонила план, сформируйте новый. При сообщении **«План не сформирован»** устраните указанную причину и повторите подготовку. Безопасно исправляемые права файлов агент может исправить в ходе штатной операции. Если указан владелец или состояние, которое нельзя исправить автоматически, передайте ошибку администратору сервера до установки. {% endstep %} {% step %} ### Запустите установку 1. Убедитесь, что показаны нужные исходная и целевая версии. 2. Прочитайте предупреждения о режиме обслуживания и изменениях сервера. 3. Нажмите **«Запустить обновление»**. 4. Дождитесь подтверждения команды агентом и открытия прогресса операции. 5. Следите за текущим этапом и общим результатом. После принятия команды операцию выполняет сервер. Закрытие окна прогресса не отменяет её. Повторно открыть состояние можно в **«Истории операций»**. В прогрессе показаны текущая фаза, этап и время последнего ответа. Долгое резервное копирование, сохранение баз или проверка служб сами по себе не означают ошибку. При сообщении **«Уточняем состояние операции»** интерфейс показывает последние подтверждённые данные. Действие **«Проверить результат»** читает состояние существующей операции. Если показано **«Запуск не подтверждён»**, сначала проверьте состояние существующей операции. Интерфейс сохраняет защиту от повторного запуска. Кнопка **«Повторить отправку»** повторяет запрос этой попытки с прежним ключом. {% hint style="warning" %} Во время установки сайт может быть временно недоступен. Не запускайте параллельное обновление из терминала или другой сессии и не прерывайте серверный процесс из-за переподключения браузера. {% endhint %} {% endstep %} {% step %} ### Дождитесь серверного результата Конкретный набор этапов указан в плане. Штатная последовательность включает проверку места на диске, полную резервную копию, подготовку нового релиза отдельно от работающего сайта, проверку файлов и необходимых компонентов окружения. Затем Updater включает режим обслуживания, останавливает службы, изменяющие данные, и сохраняет согласованную точку обеих баз. После этого применяет постоянные файлы, изменения конфигурации и прикладные обновления баз, активирует новую версию и запускает службы. Работа веб-сервера, приложения и сайта проверяется до завершения перехода. После подтверждения результата система сохраняет состояние установленной версии и открывает сайт. Старая версия сохраняется для допустимого возврата. Количество этапов может различаться. Для переходов с изменением окружения план может включать обновление PHP, ionCube, Node.js и управляемых конфигураций. Служебные компоненты Updater, Update Agent и `iexctl` обновляются штатной системой при необходимости. Во время переключения службы возможен разрыв связи с панелью; после него сверяйте существующую операцию. {% endstep %} {% endstepper %} ### Состояния операции | Состояние | Что означает | Что делать | | ----------------------- | ------------------------------------------------- | ------------------------------------------------- | | «План готов» | Подготовка завершена, установка ещё не началась | Проверить и подтвердить план | | «Срок плана истёк» | Старый план нельзя запускать | Подготовить новый | | «В очереди» | Команда принята | Дождаться выполнения | | «Выполняется» | Сервер выполняет этапы | Следить за прогрессом | | «Обслуживание сайта» | Сайт временно закрыт на время операции | Дождаться результата или выполнить восстановление | | «Успешно» | Обновление завершено | Проверить сервер и продукт | | «Ошибка» | Выполнение остановилось | Изучить неуспешный этап и рекомендацию | | «Нужно ручное действие» | Требуется указанное вмешательство | Передать сведения техническому специалисту | | «Откат выполнен» | Завершён переход к сохранённой старой версии | Проверить восстановленный продукт | | «Возврат выполнен» | Завершён возврат к сохранённой более новой версии | Проверить продукт | | «Отменено» | Допустимая отмена подтверждена | При необходимости создать новую подготовку | Отметка этапа **«Проверено — изменений не требуется»** означает успешную проверку: нужное состояние уже достигнуто. Она не означает ошибку операции. ## Проверка после обновления Откройте клиентский сайт `https://ваш_домен` и сохранённый адрес входа в панель на серверной части `https://app.ваш_домен`. Проверьте: * Оба домена доступны по HTTPS. * Сайт загружается и показывает ожидаемые страницы, направления и курсы. * Вход в административную панель работает. * Разделы панели открываются после перезагрузки страницы. * В обновлениях отображается правильная текущая версия. * Режим обслуживания завершён. * API, WebSocket и используемые интеграции работают. * Основные функции, затронутые релизом, проходят согласованный тестовый сценарий. Ошибки `500`, бесконечная загрузка и недоступность ключевых функций требуют проверки даже при успешном серверном отчёте. Для проверки создания заявок используйте согласованный сценарий: такие действия могут отправлять уведомления и обращаться к интеграциям. Сохраните исходную и целевую версии, дату, идентификатор и отчёт операции. После проверки поручите техническому специалисту создать резервную копию новой версии. [инструкция по обновлению через терминал](/ustanovka-i-obnovlenie/obnovlenie-produkta/obnovlenie-cherez-terminal.md) содержит серверные команды проверки и резервного копирования. Обновление завершено после проверки текущей версии, завершения обслуживания, сайта и основных функций, а также сохранения проверенной копии новой версии. ## Если скачивание или установка остановились ### Скачивание с сервера недоступно | Ситуация | Действие | | ------------------------------------ | ----------------------------------------------------------------------------------- | | Сервер ожидает подтверждения | Завершите подтверждение в кабинете владельца и обновите статус | | Нужна регистрация сервера | Нажмите «Проверить подключение» и выполните указанные шаги | | Лицензия связана с другой установкой | Подайте заявку на смену сервера | | Скачивание запрещено по лицензии | Проверьте активность лицензии, разрешение на скачивание и доступ к релизу | | IP, домены или ключ не совпадают | Проверьте привязку; для её изменения обратитесь к администратору официального сайта | | Комплект релиза ещё не готов | Дождитесь доступности обоих архивов и нужных лицензионных файлов | | Неверное время подписи | Синхронизируйте часы сервера и повторите проверку | | Архив или подпись не прошли проверку | Сохраните ошибку и передайте её в поддержку; такой комплект не устанавливайте | Ручная загрузка готовой пары ZIP работает независимо от подключения к скачиванию. Доступность самой установки всё равно определяется агентом и проверкой плана. ### Если пропала связь с панелью Обновление агента или временная недоступность приложения могут прервать получение прогресса. Закрытие браузера также не означает остановку серверной установки. 1. Дождитесь восстановления связи и откройте раздел повторно. 2. В **«Истории операций»** откройте существующую запись. 3. Обновите её состояние. 4. Если операция выполняется, продолжайте наблюдение. 5. Если она остановлена, изучите этап, ошибку и доступное действие. Для неподтверждённой команды используется **«Повторить отправку»**. Для остановленной существующей операции — **«Продолжить»** или **«Повторить незавершённый этап»**, если система разрешает такое действие. ### Безопасная отмена попытки Действие **«Отменить попытку»** применимо, когда сервер подтвердил, что установка ещё не начиналась. 1. Откройте существующую остановленную попытку. 2. Выберите отмену и дождитесь проверки её допустимости. 3. Прочитайте результат проверки. 4. Если отмена разрешена, подтвердите **«Отменить попытку»**. 5. Дождитесь состояния **«Отменено»** перед загрузкой исправленного комплекта. Допустимая отмена снимает блокировку и удаляет входные архивы этой попытки. Рабочая версия и история операции сохраняются. Если установка уже начиналась, используйте продолжение или управляемое восстановление. Если агент не подтвердил безопасность отмены, блокировка сохраняется; нажмите **«Проверить ещё раз»** после устранения причины. Отмена передачи ZIP, отмена подготовки и отмена попытки установки относятся к разным этапам. Выбирайте действие, показанное для текущего состояния. ### Продолжение операции 1. Откройте запись в **«Истории операций»**. 2. Прочитайте ошибку и рекомендованное действие. 3. Устраните причину: например, нехватку места, недоступность службы или указанную проблему прав файлов. 4. Нажмите **«Продолжить»** либо **«Повторить незавершённый этап»**, если действие доступно. 5. Подтвердите продолжение этой же операции. 6. Дождитесь повторной проверки сохранённых этапов и итогового результата. Сервер проверяет уже выполненные действия и продолжает сохранённую операцию. Исправленный комплект другого релиза требует новой подготовки после допустимого закрытия прежней попытки. Если система сообщает **«Нужно ручное действие»**, автоматическое продолжение может быть недоступно. Передайте номер операции и код ошибки техническому специалисту. ### Если новые обновления приостановлены Сообщение **«Новые обновления приостановлены»** запрещает новые установки. Приостановка может быть ручной или автоматической после ошибок. Изучите историю, устраните причину и нажмите **«Возобновить»**, когда запуск новых обновлений снова допустим. | Действие | Что делает | | -------------------- | ------------------------------------------------------- | | «Повторить отправку» | Повторяет неподтверждённую команду существующей попытки | | «Продолжить» | Продолжает остановленную операцию | | «Возобновить» | Снова разрешает новые обновления | Возобновление новых обновлений не исправляет остановленную операцию и не снимает обслуживание автоматически. ### Причины остановки | Причина | Следующее действие | | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- | | Архивы разных версий, неверного назначения или повреждены | Получить правильную пару и создать новую подготовку после допустимой отмены | | План устарел или изменилось состояние сервера | Повторно сформировать план | | Недостаточно места или запаса файловой системы | Освободить место допустимым способом и продолжить существующую операцию | | Резервное копирование недоступно | Восстановить службу копирования и повторить проверку | | Изменены файлы принятого релиза | Проверить и восстановить установленную версию; загрузка других ZIP не исправляет её целостность | | Права файлов нельзя безопасно исправить автоматически | Передать этап и код ошибки администратору сервера | | Обновление службы несовместимо или переход не поддерживается | Передать версии и ошибку в поддержку | | Агент занят другой операцией | Открыть её состояние и дождаться завершения | | Операция требует ручного восстановления | Завершить рекомендованное восстановление перед новым запуском | Повторяйте действие после устранения причины. Если система требует исправленный релиз, повтор той же операции с прежними архивами ошибку не устранит. Для серверного восстановления после неуспешной установки и подготовки диагностического комплекта используйте [инструкция по обновлению через терминал](/ustanovka-i-obnovlenie/obnovlenie-produkta/obnovlenie-cherez-terminal.md). Передайте специалисту время, идентификатор операции, исходную и целевую версии, этап, код ошибки и рекомендацию системы. ## Откат и возврат через панель Откат нужен при подтверждённой проблеме уже установленной новой версии. Он является отдельной операцией с планом, проверками и резервным копированием. {% hint style="danger" %} Откат возвращает код и обе базы данных к сохранённому состоянию выбранной версии. Данные, созданные или изменённые после этой точки, будут потеряны. Перед подтверждением оцените последствия для заявок, платежей, пользователей и других данных. {% endhint %} Для быстрого отката должны сохраниться файлы версии и подтверждённые данные восстановления. Наличие записи о старой версии само по себе не гарантирует возможность отката. ### Откат к сохранённой версии 1. Откройте **«Установленные версии»**. 2. Найдите версию со статусом **«Доступна для отката»**. 3. Нажмите **«Откатиться до …»** и дождитесь подготовки плана. 4. Сверьте исходную и целевую версии, обязательные действия и предупреждение о восстановлении данных. 5. Нажмите **«Запустить откат»** и дождитесь состояния **«Откат выполнен»**. 6. Проверьте сервер и продукт по разделу проверки после обновления. Если план уже создан и открыт через историю, нажмите **«Подтвердить откат»**, чтобы перейти к его проверке и запуску. Если агент не подтверждает безопасный откат, кнопка перехода недоступна. Изучите причину; не переключайте файлы вручную. ### Возврат после отката После отката сохранённая более новая версия может получить состояние **«Готова к возврату»** и действие **«Вернуться на …»**. Откройте его, дождитесь проверки нового плана и изучите предупреждение о данных. Затем нажмите **«Вернуться на актуальную версию»**. Для плана, открытого через историю, сначала используйте **«Подтвердить возврат»**. Дождитесь состояния **«Возврат выполнен»** и повторите проверки продукта. Возврат восстанавливает данные, сохранённые для выбранной более новой версии. Он не объединяет данные, накопившиеся при работе на разных версиях. ## Хранение архивов и удаление версий ### Что сохранять после обновления Сохраните вне обновляемого сервера оригинальные ZIP установленного релиза, применяемые лицензионные файлы, опубликованные контрольные суммы, отчёт и идентификатор операции. На период проверки новой версии сохраняйте прежний релиз и точки возврата. Если требуется продолжение или восстановление, оставьте также входные архивы и конфигурацию этой операции. Копии входных ZIP можно удалить после успешной проверки продукта и завершения всех операций, которым они нужны. Для комплектов, принятых агентом, используйте доступное штатное действие удаления. ### Удалите сохранённую версию 1. Откройте **«Установленные версии»**. 2. У нужного сохранённого релиза выберите **«Удалить»**. 3. Дождитесь расчёта и проверьте версию, состав удаляемых объектов и освобождаемое место. 4. Прочитайте сведения о точке отката и сохраняемой резервной копии. 5. Подтвердите **«Удалить версию»**, если удаление допустимо. 6. Дождитесь подтверждённого результата. Предварительный расчёт показывает размер содержимого, фактически занятое место и объём, который освободится сразу. Эти значения могут различаться из-за совместного хранения данных. Текущую версию удалить нельзя. Состояние сервера, активная операция и отсутствие безопасного расчёта также могут блокировать удаление. {% hint style="warning" %} Если показано **«Будет удалена текущая точка отката»**, подтверждение называется **«Удалить и отказаться от отката»**. После такого удаления быстрый возврат к этой версии станет недоступен. {% endhint %} Зашифрованный резервный снимок базы не удаляется этой кнопкой и хранится по отдельной политике резервного копирования. Его наличие не сохраняет быстрый откат после удаления файлов релиза и служебной записи точки восстановления. Если расчёт устарел, нажмите **«Пересчитать состав»** и проверьте его заново. Если результат удаления не подтверждён или удаление осталось незавершённым, используйте **«Повторить удаление»**: сервер продолжит прежнее действие. Не удаляйте каталоги релизов, точки восстановления и журналы вручную. ## Возможности раздела «Обновления» ### Состояние сервера и доступная версия В верхней части раздела показаны текущая версия, дата установки, версия агента, канал и доступность обновлений. Предупреждения рядом объясняют, почему действие заблокировано. Карточка **«Общедоступная версия»** сообщает об опубликованном релизе. Кнопка **«Подробнее»** открывает сведения о нём. Возможность получить этот комплект по вашей лицензии проверяется отдельно. Если показано **«Каталог временно недоступен»**, повторите проверку позднее. Сам по себе сбой каталога не удаляет локальную историю и точки возврата; доступность действий с ними определяется состоянием агента. Верхние действия раздела:
ДействиеНазначение
«Как обновляться»Открывает обучение подключению и подготовке обновлений
«Обновления с сервера»Открывает состояние подключения сервера к получению файлов
«Новое обновление»Открывает форму получения комплекта; название ручной кнопки зависит от подключения
«Обновить вручную»Открывает ручной вариант, когда получение с сервера уже подключено
«Настройки обновлений»Управляет предзагрузкой, её параметрами и показом ручной кнопки
### Вкладки раздела
ВкладкаЧто в ней находится
«Установленные версии»Текущий и сохранённые релизы, доступность отката, возврата и удаления
«История операций»Планы и операции панели: состояние, ответственный, этапы и результат
«Журнал действий»Значимые действия с пользователем, временем, IP-адресом и результатом
Запись **«План готов»** в истории означает, что установка ещё не выполнена. Пустая история релизов при недоступном агенте означает, что сервер не передал сведения о версиях. Чтобы изучить запись, нажмите **«Открыть»** в истории. В деталях показаны переход версий, ответственный, состояние, этапы и события операции. Для уже подготовленного плана доступны **«Подтвердить обновление»**, **«Подтвердить откат»** или **«Подтвердить возврат»**: они открывают план для окончательного запуска. Таблицы истории и журнала поддерживают переход между страницами. Если событие журнала связано с операцией, его действие **«Открыть»** ведёт к её подробностям. Состояние сохранённых релизов читается так:
Состояние версииЗначение
«Текущая»Активная установленная версия
«Доступна для отката»Агент подтвердил допустимость возврата к более старой версии
«Готова к возврату»После отката доступна сохранённая более новая версия
«Сохранена»Релиз хранится; допустимые действия определяются его состоянием
«Недоступен»Безопасный переход к этой версии не подтверждён
### Права и недоступные действия Право **«Просмотр обновлений системы»** разрешает читать состояние, планы, ход операций и историю. Право **«Запуск обновлений и откатов системы»** требуется для загрузки и подготовки комплектов, изменения настроек, запуска, продолжения, отката и других управляющих действий раздела. В режиме чтения и при переключении в аккаунт с доступом только для чтения управляющие действия блокируются. Если кнопка отсутствует, проверьте права и настройку показа ручной кнопки. Если кнопка недоступна, прочитайте причину блокировки в разделе. ### Обучение «Как обновляться» Курс **«Обновления без ручной загрузки»** содержит четыре части: **«Начало»**, **«Подключение»**, **«Подготовка»**, **«Установка»**. Кнопка **«Начать настройку»** переводит к подключению. После подтверждения сервера можно включить **«Включить автоматическую подготовку»**. Этот шаг сохраняет настройку предзагрузки. Кнопки **«Позже»** и **«Закрыть»** позволяют выйти из курса. Повторно открыть его можно через **«Как обновляться»**. Прохождение курса само по себе не запускает установку.