Обновление для версии 3.0 и выше

Внимание!

Выполните резервное копирование перед выполнением процедуры обновления!
Дальнейший процесс обновления актуален для версии "eXpress" 3.x и выше. Если версия "eXpress" ниже 3.0, следуйте инструкции "Обновление для версии ниже 3.0".

Single CTS

Обновление сервера VoEx

Перейдите в директорию "eXpress": cd /opt/express-voice/.
Остановите сервисы из директории "eXpress":
```
DPL_PULL_POLICY=never dpl --dc stop
```
Запустите обновление:
```
dpl -d
```
Проверьте логи на наличие ошибок командой:
```
dpl --dc logs --tail=200 -f
```

Обновление системы

Примечание

22.07.2022 Начиная с версии 2.4 изменились минимальные требования по версии postgres. Теперь поставляется образ postgresql версии 14.4. Процедура обновления встроенной БД описана в инструкции "Обновление без доступа к apt.postgresql.org".
15.12.2022. Перед обновлением сервера настройте Kafka. Процедура настройки описана в инструкции "Обновление Kafka";
перед обновлением сервера CTS на версию 3.6 и выше необходимо добавить в файл settings.yaml на Front CTS параметр: redis_cache_connection_string: redis://10.0.0.1:6379/1, где 10.0.0.1 это адрес Back CTS.

Для обновления системы:

Перейдите в директорию "eXpress": cd /opt/express/.
Остановите сервисы из директории "eXpress":
```
DPL_PULL_POLICY=never dpl --dc stop
```
Выполните резервное копирование /var/lib/docker/volumes (или другого места, где они лежат в этой системе).

При выполнении обновления сервера с версии 1.28 измените хозяина файлов для сервисов (выполняется один раз):
```
docker volume inspect --format '{{ .Mountpoint }}' cts_ccs_admin_public cts_file_service_uploads cts_messaging_cache cts_messaging_uploads cts_phonebook_uploads | xargs chown -R 888:888
```
Если предыдущая версия nginx меньше, чем 1.20.1 и используются letsencrypt сертификаты, очистите хранилище letsencrypt (один раз):
```
rm -rf cts/letsencrypt
dpl cadvinstall && dpl nxinstall
```
Обновите node exporter и container advisor:
```
dpl cadvinstall && dpl nxinstall
```
Запустите обновление:
```
dpl -d
```
После запуска обновления требуется время на проведение внутренних процедур (ориентировочное время — 10-15 минут).
Проверьте логи на наличие ошибок командой:
```
dpl --dc logs --tail=200 -f 
```

Откат обновления

Внимание!

С версий 2.2 и 2.3 откатываться назад нельзя!

Поправьте файл settings.yaml, указав параметр, например:

images:
    trusts: ccs/trusts:1.28.0

Back CTS и Front CTS

После обновления сервера VoEx первым обновляется сервер Front CTS, затем — сервер Back CTS.

Обновление сервера VoEx

Перейдите в директорию "eXpress" cd /opt/express-voice/.
Остановите сервисы из директории "eXpress":
```
DPL_PULL_POLICY=never dpl --dc stop
```
Запустите обновление:
```
dpl -d
```
Проверьте логи на наличие ошибок командой:
```
dpl --dc logs --tail=200 -f
```

Обновление сервера Front CTS

Внимание!

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

Примечание

05.03.2022 Для установок с разделением на frontend и backend нужно убедиться, что c frontend сервера доступны tcp порты 2379, 5432, 6379, 9092 на сервере backend. Также желательно закрыть доступ к этим портам отовсюду кроме frontend.
22.07.2022 Начиная с версии 2.4 изменились минимальные требования по версии postgres. Теперь поставляется образ postgresql версии 14.4. Процедура обновления встроенной БД описана в инструкции "Обновление без доступа к apt.postgresql.org".
15.12.2022 Перед обновлением сервера на версию 2.6 настройте Kafka. Процедура настройки описана в инструкции "Обновление Kafka".

Перейдите в директорию "eXpress": cd /opt/express/.
Остановите работу приложения командой:
```
DPL_PULL_POLICY=never dpl --dc stop
```
Выполните резервное копирование файлов /var/lib/docker/volumes (после нескольких дней эксплуатации скопированные файлы можно удалить).

Если предыдущая версия nginx меньше, чем 1.20.1 и используются letsencrypt сертификаты, очистите хранилище letsencrypt (один раз):
```
rm -rf cts/letsencrypt
```
Запустите обновление:
```
dpl –d
```
После запуска обновления требуется время на проведение внутренних процедур (ориентировочное время — 10-15 минут).
Проверьте логи на наличие ошибок командой:
```
dpl --dc logs --tail=200 -f
```

Обновление сервера Back CTS

Запустите командную строку.
Остановите работу приложения командой:
```
DPL_PULL_POLICY=never dpl --dc stop
```
Выполните резервное копирование файлов /var/lib/docker/volumes (после нескольких дней эксплуатации скопированные файлы можно удалить).

Если версия сервера ниже 1.28, выполните:

docker volume inspect --format '{{ .Mountpoint }}' cts_ccs_admin_public \ cts_file_service_uploads cts_messaging_cache cts_messaging_uploads \ cts_phonebook_uploads | xargs chown -R 888:888
dpl cadvinstall && dpl nxinstall

Запустите обновление:
```
dpl –d
```
После запуска обновления требуется время на проведение внутренних процедур (ориентировочное время — 10-15 минут).
Проверьте логи на наличие ошибок командой:
```
dpl --dc logs --tail=200 -f
```