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

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

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

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

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

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

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

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

---

Важно

В данной версии изменена схема работы Nginx. После установки обновления необходимо внести изменения в конфигурацию Nginx согласно актуальной документации.

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

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

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

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

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

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

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

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

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

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 www/app.ваш_домен

или

cd /var/www/имя_пользователя_backend/data/www/app.ваш_домен

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

2

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

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

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

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

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

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

3

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

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

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

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

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

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

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

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

1

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

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

iexexchanger_frontend_update.zip
iexexchanger_backend_update.zip

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

2

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

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

Через SSH: reboot

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

Проверка файла .env

Перед проверкой конфигурации PM2 откройте файл .env, расположенный в директории Frontend основного домена (например, ваш_сайт), и убедитесь, что параметры имеют актуальные значения.

Проверьте параметр ALLOWED_HOSTS. Он должен содержать основной домен сайта и домен Backend:

ALLOWED_HOSTS=ваш_домен,app.ваш_домен

Проверьте параметр SUPPORTED_LANGUAGES. Он должен содержать список всех поддерживаемых языков:

Настройка языков

SUPPORTED_LANGUAGES=ru,en,es,fr,pl,uk,zh,ka,kk

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

DEFAULT_LANGUAGE=ru

Если какие-либо значения отличаются, приведите их к указанному виду, сохраните файл .env и только после этого переходите к проверке конфигурации PM2.

Проверка конфигурации PM2

После обновления также рекомендуется проверить файл ecosystem.config.cjs, расположенный в директории основного сайта ваш_сайт.

Настройка Frontend

В версии 11.1.8 необходимо использовать актуальную конфигурацию PM2. Если в файле указаны другие параметры (например, cluster или instances: 'max'), замените их на рекомендуемую конфигурацию.

Файл ecosystem.config.cjs должен выглядеть следующим образом:

module.exports = {
    apps: [
        {
            name: 'iexexchanger',
            script: 'dist/exchanger/server/server.mjs',
            cwd: __dirname,
            instances: 1,
            exec_mode: 'fork',
            autorestart: true,
            watch: false,
            max_memory_restart: '1G',
            env: {
                NODE_ENV: 'production',
                PORT: 4000,
                HOST: '127.0.0.1',
                PM2: 'true',
            },
            log_date_format: 'YYYY-MM-DD HH:mm:ss Z',
            error_file: 'logs/err.log',
            out_file: 'logs/out.log',
            merge_logs: true,
            time: true,
            wait_ready: true,
            listen_timeout: 10000,
            kill_timeout: 5000,
            exp_backoff_restart_delay: 100,
        },
    ],
};

После внесения изменений сохраните файл и перезапустите процесс Frontend через PM2, чтобы новая конфигурация вступила в силу.

Проверка и обновление конфигурации Nginx

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

В версии 11.1.8 изменилась схема работы Nginx, поэтому старая конфигурация может работать некорректно.

Перейдите по ссылке на актуальную инструкцию:

Настройка Nginx

Внимательно проверьте конфигурацию и приведите её к актуальной версии.

Особое внимание уделите:

• настройке проксирования Frontend на Angular SSR;
• отсутствию старых языковых редиректов в Nginx.

После внесения изменений сохраните конфигурацию, проверьте её корректность и перезапустите Nginx.

Только после этого переходите к проверке работы сайта.

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

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

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

pm2 list

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

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

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

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

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

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

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

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

Вы можете выполнить перезагрузку одним из способов.

1

Через SSH

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

Авторизуйтесь на сервере под пользователем root и выполните команду:

reboot

2

Через FastPanel

Перейдите в раздел «Настройки» → «Основное» и нажмите «Перезагрузить сервер».

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