# Обновление v5.8.x
## Инструкция

:::danger
ВАЖНО! Перед обновлением на v5.8.x необходимо иметь версию Swarmica не ниже [v5.7.x](https://support.swarmica.com/article/ru/1237-obnovlenie-v57x.html "v5.7.x")

Обновления важно выполнять последовательно: если версия Swarmica ниже v5.5.x, например, v5.3.x, то сначала нужно обновиться до v5.4.x, затем до v5.5.x, и так далее.
:::

### Подготовка

1\. Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

```bash
~# grep VERSION .env
SW_FRONTEND_VERSION=v5.8.0
SW_BACKEND_VERSION=v5.8.0
SW_HELPCENTER_VERSION=v5.8.0
```

2\. Ознакомьтесь со статьей про [фича-флаги ](https://support.swarmica.com/article/ru/596-ficha-flagi-features-vozmozhnost-vklyuchat-i-vyklyuchat-bloki-funkcij-v-swarmica.html)и убедитесь, что вы заменили старые значения  на новые или добавили отсутствующие в `/root/swarmica/.env` в переменной `FEATURES`:

| Старое значение (до 5.8.0) | Новое значение (начиная с 5.8.0)                                                                                    | Комментарий                                                                                                                                  |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| article\_comments          | \_\_article\_comments                                                                                               | Стал нелицензируемым                                                                                                                         |
| csat\_anytime              | \_\_csat\_anytime                                                                                                   | Стал нелицензируемым                                                                                                                         |
| sensitive\_data            | \_\_sensitive\_data                                                                                                 | Стал нелицензируемым                                                                                                                         |
| \_\_external\_tickets      | external\_tickets                                                                                                   | Стал лицензируемым                                                                                                                           |
| \_\_automations            | automations, automations\_outgoing\_emails,automations\_outgoing\_webhooks,automations\_macros,automations\_scripts | Стал лицензируемым + добавились отдельные флаги для каждого из видов автоматизаций                                                           |
| **НЕ БЫЛО**                | api\_keys                                                                                                           | Теперь возможность создавать апи токены проверяется лицензией. Добавьте этот флаг, если используются интеграции с использованием API токенов |
| **НЕ БЫЛО**                | issue\_tracker                                                                                                      | Теперь возможность подключать трекеры задач проверяется лицензией. Добавьте этот флаг, если используются интеграции с трекерами задач        |
| **НЕ БЫЛО**                | max                                                                                                                 | Появилась возможность интеграции с мессенджером MAX                                                                                          |
| webhooks                   | **НЕ НУЖНО**                                                                                                        | Теперь при использовании интеграции с Mango Office или Beeline PBX не требуется отдельно прописывать флаг webhools. Его нужно удалить        |

3\. Ознакомьтесь с [инструкцией подключения мессенджера MAX](https://support.swarmica.com/article/ru/1349-integraciya-s-messendzherom-max.html), если вы планируете подключить эту интеграцию

### Обновление

:::tip
Будет прерывание сервиса на несколько минут, рекомендуется выполнять обновление в часы, когда использование системы минимально
:::

Выполните обновление с перезагрузкой системы:

```bash
docker compose pull
docker compose down
docker compose up -d
```

### После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1\. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

```bash
docker exec --env-file .env -it swarmica-django-1 python manage.py post_start
```

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2\. Запустите команду, которая установит свойство locale для всех имеющихся тикетов в системе:

```bash
docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_ticket_locale
```

3\. Запустите команду, чтобы установить порядок разделов базы знаний по умолчанию:

```bash
docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_articlecategory_order
```

4\. Запустите команду, которая установит порядок продуктов на формах и в базе знаний по умолчанию:

```bash
docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_product_order
```

5\. Запустите команду, которая сделает связь тикетов двусторонней:

```bash
docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_related_tickets
```

6\. Запустите команду, которая подготовит данные событий для использования в автоматизациях:

```bash
docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_event_value_data
```

7\. Запустите очистку неиспользуемых данных:

```bash
docker system prune -a
```

:::tip
ВАЖНО! Убедитесь, что все контейнеры успешно запустились, перед запуском этой команды
:::

## ✨ **Основные улучшения**

💬 🅿️ Добавили возможность подключать [мессенджер MAX](https://support.swarmica.com/article/ru/1349-integraciya-s-messendzherom-max.html) как канал

💅 Добавили **визуальный конструктор для макросов**

👨‍🔧 **Упростили** создание сложных **автоматизаций**

🤌 Сделали **клонирование правил автоназначения**, чтобы экономить время на создании похожих правил

🪢 Сделали **двустороннюю прозрачную связь заявок**

🌎 Добавили возможность **менять язык**, на котором идет общение в заявке

🧩 Теперь можно задавать **произвольный порядок для разделов** базы знаний и продуктов

💆‍♀️ Добавили информации о **запусках периодических задач** и визуальный редактор условий

📊 Расширили и углубили возможности для **создания произвольных отчетов**

## **🔧 Исправленные ошибки**&#x20;

🎨 Исправлены проблемы с видео в статьях, копированием кода, таблицами, курсором и dropdown’ами.&#x20;

📊 Починено отображение локалей, дат, кастомных полей в сводных отчетах. Улучшена производительность страницы отчётов.

🧾 Исправлены ошибки создания SLA, работы относительных дат в QA и массового редактирования. Корректно отображаются логические значения в событиях.

💬 Исправлена обработка CSAT в мессенджерах. Предотвращено создание пустых комментариев.&#x20;

🧑‍💼 Исправлены ошибки с локалями и параллельным сохранением кастомных полей. Уточнены ограничения ролей.

⚙️ Улучшена работа кэша, логирования SLA и автоматизаций. Обновлены зависимости и закрыты потенциальные уязвимости.

🧩 Исправлено отображение CSAT, вложений и навигации в чатах.