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

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

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

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

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

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

Если планируется использование двухфакторной аутентификации, то необходимо [добавить новый фича-флаг](https://support.swarmica.com/article/ru/596) `2fa`

Так же, на этом же шаге можно [подключить оптимизацию портала базы знаний для LLM.](https://support.swarmica.com/article/ru/1483)

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

:::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\. Запустите команду переименования поля `chat_status` в `status`:

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

3\. Запустите команду переноса статуса автоназначения в поле `status`:

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

4\. Если вы используете YandexGPT, то в этом релизе необходимо его перенастроить:

4.1. Переключите модель с YandexGPT-Lite на YandexGPT

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

4.2. Сбросьте состояние YandexGPT до "чистого":

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

После того, как завершатся все пост-апгрейдные шаги, будет необходимо перейти в графический интерфейс > Настройки > Интеграции > Провайдеры ИИ и заново включить ИИ-ассистентов

5\. Запустите подсчет коэффициента несоблюдения SLA, который используется для упорядочивания тикетов при автоназначении:

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

6\. Запустите команду установки порядка избранных списков тикетов "по умолчанию":

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

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

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

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

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

### 🔐 **Безопасность и доступы**

• Возможность использования 2FA через TOTP и Email
• Черный список скомпроментированных JWT токенов
• Маскирование паролей, токенов и других чувствительных данных в API
• Защищенная форма ввода паролей, токенов и других чувствительных данных 

### 🧠 **Работа со статьями**

• Возможность перевода всей статьи целиком (ИИ)
• Возможность создания 30+ вкладок (табов) в статью
• Авто-якоря заголовков 
• События изменения статусов и сегментов статей
• Расширенные настройки SEO для статей
•[ Оптимизация базы знаний для LLM](https://support.swarmica.com/article/ru/1483-vklyuchenie-indeksacii-publichnogo-portala-bazy-znanij-dlya-llm-llmstxt.html)

### 📬 **Автоматизация и шаблоны**

• Поддержка Jinja в email-автоматизациях (to / cc / bcc)
• Поддержка Jinja переменных в тикетах
• Добавлен **Индекс SLA**, как интегральный показатель соблюдения/несоблюдения всех счетчиков, сконфигурированных в политиках, применяемых к тикетам

### 📊 **Отчеты и фильтры**

• Добавлены новые объекты и измеряемые сущности
• Поддержка isnull для продуктов/компановки/версий/платформ
• Модификаторы Час и День недели для полей типа Дата и время в отчетах + возможность задавать часовой пояс для этих модификаторов
• Возможность **сортировки** в конструкторе отчётов
• Возможность **поиск по отчётам** в конструкторе отчетов
• Доступ к отчетам для роли *Менеджер* в конструкторе отчетов

### 💬 **Мессенджеры и каналы**

• Углублена интеграция с MAX
• Добавлены настройки, ссылки и поддержка в виджете

***

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

🎨 Исправлены проблемы с редактором: видео, форматирование текста, отмена, выпадающие меню и стили.
📊 Отображение в отчётах: локали, даты, SLA-счётчики и отображение данных.
🧾 Исправлены ошибки логики автоназначения и обработки событий.
💬 Улучшена стабильность мессенджеров и обработка комментариев.
⚙️ Повышена стабильность и производительность системы: кэш, API, миграции и фоновые процессы.