Обновление с 11.1.5 до 11.1.6

Данная инструкция описывает полный процесс обновления платформы iEXExchanger до версии 11.1.6.

Перед началом внимательно ознакомьтесь со всеми этапами. Выполняйте действия последовательно и не пропускайте шаги.

Резервное копирование перед обновлением

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

Сначала сохраните файлы сайта. Для этого войдите в панель FastPanel, откройте файловый менеджер, найдите папку с вашим сайтом, создайте архив в формате ZIP и скачайте его на свой компьютер. Затем обязательно выполните резервное копирование базы данных: перейдите в раздел «Базы данных», выберите нужную базу и воспользуйтесь функцией экспорта, чтобы получить SQL-файл. Сохраните его в надёжном месте вместе с архивом сайта.

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

Как создать резервную копию в FastPanel

---

Перевод сайта в режим обслуживания

Перед началом обновления необходимо временно остановить работу обменного пункта.

Для этого в административной панели активируйте режим обслуживания.

Это позволит:

• исключить создание новых заявок;
• избежать конфликтов во время обновления;
• предотвратить ошибки при работе пользователей с системой.

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

Подготовка файлов к обновлению

Перед загрузкой новой версии необходимо удалить часть файлов текущей установки.

Данная процедура позволяет избежать конфликтов между файлами предыдущего и нового релиза.

1

Очистка Frontend

Перейдите в директорию основного сайта.

Пример: ваш_домен

Удалите следующие папки:

dist
logs

Назначение папок

Папка	Назначение
dist	Скомпилированная версия Frontend
logs	Журналы работы Frontend

После обновления данные директории будут автоматически созданы заново.

2

Очистка Backend

Перейдите в директорию Backend.

Пример: app.ваш_домен

Удалите следующие папки:

app
bootstrap
config
database
packages
resources
routes
vendor

Важно

Перед удалением обязательно убедитесь, что вы находитесь именно в директории Backend.

Удаление файлов в неправильной директории может привести к повреждению проекта.

3

Не удаляйте следующие папки

Никогда не удаляйте:

public
storage

В данных директориях хранятся:

• пользовательские изображения;
• загруженные файлы;
• документы;
• экспортированные данные;
• служебные файлы системы;
• пользовательский контент.

Удаление этих папок может привести к потере данных.

Важно:

Не забудьте скачать файлы лицензии.

Они обязательны для полной установки обновления. После загрузки и распаковки архивов обновления необходимо также загрузить файлы лицензии в папку backend.

Без файлов лицензии обновление может быть установлено не полностью или работать некорректно.

Файлы лицензии и релизы

Загрузка файлов обновления

Для обновления используются два архива:

iexexchanger_frontend_update.zip
iexexchanger_backend_update.zip

Каждый архив предназначен для своей части системы.

1

Архив Frontend

Загрузите: iexexchanger_frontend_update.zip

в директорию основного сайта: ваш_домен

2

Архив Backend

Загрузите: iexexchanger_backend_update.zip

в директорию Backend: app.ваш_домен

3

Способы загрузки

Вы можете использовать:

• FastPanel;
• FileZilla;
• WinSCP;
• SFTP;
• SCP.

Рекомендуется выполнять загрузку от имени пользователя сайта.

Использование пользователя root не рекомендуется.

4

Распаковка архивов

После загрузки архивов:

1. Найдите архив в нужной директории.
2. Выполните распаковку.
3. Подтвердите замену существующих файлов, если система запросит подтверждение.

Замена файлов является стандартной частью процесса обновления.

5

Проверка после распаковки

Убедитесь, что:

• архивы успешно распакованы;
• новые файлы появились в системе;
• не возникло ошибок файлового менеджера;
• файлы находятся непосредственно в рабочей директории проекта.

После завершения данного этапа можно переходить к установке обновления.

Применение обновления

После загрузки файлов необходимо выполнить обновление через SSH.

Если вы ранее не работали с SSH, воспользуйтесь отдельной инструкцией по подключению к серверу.

Подключение к серверу по SSH

1

Переход в директорию Backend

Подключитесь к серверу и выполните команду:

cd /var/www/USER/data/www/app.ваш_домен

Используйте фактический путь вашего проекта.

2

Выполнение команд обновления

Выполняйте команды строго в указанном порядке.

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

php artisan product-updates:run --to=11.1.6

Применяет все изменения новой версии системы.

Выполняет обновление файловых источников курсов.

3

Если команда завершилась с ошибкой

В некоторых случаях ошибка может быть связана с:

• нехваткой прав доступа;
• недостатком свободного места;
• незавершёнными процессами;
• временными сбоями сервера.

Рекомендуется:

1. Ознакомиться с текстом ошибки.
2. Устранить найденную проблему.
3. Повторно выполнить команду.

Если ошибка сохраняется, обратитесь в техническую поддержку и приложите полный текст ошибки.

Завершение обновления

После успешного выполнения всех команд рекомендуется выполнить финальные действия.

1

Удаление архивов обновления

Удалите ранее загруженные архивы:

iexexchanger_frontend_update.zip
iexexchanger_backend_update.zip

Это позволит избежать случайного использования устаревших файлов в будущем.

2

Перезагрузка сервера

Для применения всех изменений рекомендуется выполнить полную перезагрузку сервера.

Через SSH: reboot

или воспользуйтесь инструментами вашей панели управления.

Если сайт не открывается после обновления

Наиболее распространённая причина — не был автоматически запущен Frontend через PM2 после перезагрузки сервера.

Проверьте состояние процессов:

pm2 list

Если процесс отсутствует или находится в состоянии ошибки, воспользуйтесь инструкцией:

Как переустановить PM2?

Обновление успешно завершено

Поздравляем!

Система успешно обновлена до версии iEXExchanger 11.1.6.

После завершения проверки не забудьте отключить режим обслуживания и вернуть обменный пункт в рабочий режим.