> 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/arkhivnye-versiya/versiya-11.1.x/obnovlenie-s-11.1.4-do-11.1.5.md).

# Обновление с 11.1.4 до 11.1.5

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

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

{% hint style="warning" %}

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

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

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

<br>

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

{% content-ref url="/spaces/uyjsNtEAtO6Sby8CHWyD/pages/OfLcDFWH4NaDvTwPEkDD" %}
[Как создать резервную копию в FastPanel](/help-center/administrirovanie/obsluzhivanie/kak-sozdat-rezervnuyu-kopiyu-v-fastpanel.md)
{% endcontent-ref %}

***

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

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

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

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

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

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

<figure><img src="/files/qocHcaTWkH820z8EwrL1" alt="" width="375"><figcaption></figcaption></figure>

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

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

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

{% stepper %}
{% step %}

### Очистка Frontend

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

Пример: `ваш_домен`&#x20;

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

```
dist
logs
```

<figure><img src="/files/PdteijinVPcGp99GU9mB" alt="" width="375"><figcaption></figcaption></figure>

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

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

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

{% step %}

### Очистка Backend

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

Пример: `app.ваш_домен`&#x20;

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

```
app
bootstrap
config
database
packages
resources
routes
vendor
```

<figure><img src="/files/K3CF9mlFjVc5C9Ms6DNv" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

#### Важно

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

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

{% step %}

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

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

```
public
storage
```

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

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

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

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

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

```
iexexchanger_frontend_update.zip
iexexchanger_backend_update.zip
```

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

{% stepper %}
{% step %}

### Архив Frontend

Загрузите: `iexexchanger_frontend_update.zip`&#x20;

в директорию основного сайта: `ваш_домен`
{% endstep %}

{% step %}

### Архив Backend

Загрузите: `iexexchanger_backend_update.zip`&#x20;

в директорию Backend: `app.ваш_домен`
{% endstep %}

{% step %}

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

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

* FastPanel;
* FileZilla;
* WinSCP;
* SFTP;
* SCP.

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

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

{% step %}

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

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

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

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

{% step %}

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

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

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

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

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

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

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

{% content-ref url="/spaces/uyjsNtEAtO6Sby8CHWyD/pages/cCEoFDjTDIufy3NUEakd" %}
[Подключение к серверу по SSH](/help-center/upravlenie-serverom/podklyuchenie-k-serveru-po-ssh.md)
{% endcontent-ref %}

{% stepper %}
{% step %}

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

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

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

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

{% step %}

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

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

**Проверка релиза**

```
php artisan product-updates:release-check 11.1.5
```

**Проверка пакета обновления**

```
php artisan product-updates:verify-release --to=11.1.5
```

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

```
php artisan product-updates:run --to=11.1.5
```

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

**Перестроение аналитики**

```
php artisan analytics:rebuild --recent=90
```

**Обновление файловых источников курсов**

```
php artisan rates:run-target files
```

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

{% step %}

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

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

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

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

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

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

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

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

{% stepper %}
{% step %}

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

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

```
iexexchanger_frontend_update.zip
iexexchanger_backend_update.zip
```

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

{% step %}

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

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

Через SSH: `reboot`

или воспользуйтесь инструментами вашей панели управления.
{% endstep %}
{% endstepper %}

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

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

Проверьте состояние процессов:&#x20;

```
pm2 list
```

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

{% content-ref url="/spaces/uyjsNtEAtO6Sby8CHWyD/pages/0yytVCNPTqBInGY7hcgi" %}
[Как переустановить PM2?](/help-center/upravlenie-serverom/pm2/kak-pereustanovit-pm2.md)
{% endcontent-ref %}

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

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

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

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


---

# 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/ustanovka-i-obnovlenie/obnovlenie/arkhivnye-versiya/versiya-11.1.x/obnovlenie-s-11.1.4-do-11.1.5.md?ask=<question>&goal=<endgoal>
```

`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.