¶ Начальные условия
- Используйте данное руководство, если в настоящее время у вас уже установлены гибридные ноды DION и вы хотите сократить время простоя системы при установке версии 5.6. Вы также всегда можете воспользоваться инструкцией по установке с нуля, если это удобнее.
- Обновление DION проходит с простоем сервиса. Планируйте обновление заранее.
Примеры в данном руководстве приведены для ОС Ubuntu
СТРАРЫЕ КОНФИГУРАЦИОННЫЕ ФАЙЛЫ НЕ ПОДХОДЯТ К НОВЫМ СЕРВИСАМ!
¶ Изменения в новой версии
В DION 5.6 произошли изменения относительно старых версий:
- Поддержка автоматического аварийного переключения TURN серверов. Если TURN серверов два и более, больше не придется уведомлять службу поддержки о выходе из строя одного из них, система автоматически зафиксирует сбой и переключит внешних участников конференции на другой сервер.
- Поддержка новых раскладок в конференции в хорошем качестве. До обновления гибридного медиа-сервера раскладки будут работать исправно, однако качество изображения не будет адаптироваться автоматически к изменению количества участников на экране. Это будет заметно в конференциях с пятью и более участниками. После обновления раскладки в гибридных конференциях будут работать так же хорошо, как и в облачных.
- Гибридный SIP. Для тех, кто заботится о безопасности SIP-звонков, будет возможность развернуть гибридные ноды SIP и терминировать звонки внутри контура организации. Это также поможет настроить SIP звонки в облако без использования SBC или сложного NAT. Исправлены баги совместимости с некоторыми устройствами относительно версии 5.3
- Моментальная обработка отказов нод dion-proxy. Если таких нод несколько, выход из строя одной из них пройдет незаметно для участников конференций. Может потребоваться изменить топологию согласно руководству.
- Каскадирование в облако, базовое геораспределение. В этом режиме локальные участники конференции будут подключены на гибридный медиа-сервер, а внешние — на облачный. Между медиа-серверами будет образовано каскадное соединение. Видео потоки в каскаде не дублируются, таким образом экономия пропускной способности тем больше, чем больше участников в конференции.
¶ Проверка статуса сервисов
После заполнения конфигурационных файлов сервисы DION необходимо перезапустить. В первую очередь конфигурируется сервис Dion-Proxy, затем все остальные.
Если запуск сервиса прошел успешно, сервис должен перейти в состояние Active (Running). Проверить состояние можно командой:
systemctl status {имя сервиса}
После того как сервис перешел в состояние Active (Running), он проходит регистрацию в облаке DION.
Статус регистрации сервисов можно отслеживать в административной панели на вкладке Настройки организации - Гибридные сервисы
При верной конфигурации в результате настройки все сервисы должны быть отмечены зеленым цветом.
¶ Подготовка к обновлению
Проверьте актуальность сетевых доступов для новой версии DION: https://faq.dion.vc/ru/network_requirements
Образы для обновления можно скачать по ссылке в следующем составе:
¶ Для проведения конференций в контуре предприятия:
Служебные сервисы:
- dion-proxy.deb
- TURN - пакет не требует обновления, обновление затрагивает только конфигурационный файл
Сервис MEDIA:
- SFU.deb
- audiohub.deb (обратите внимание, требуется версия 5.6.1, не 5.6.0)
¶ Для сервисов записи и хранения конференций:
Сервис KMS:
- kms.deb
Сервис Recorder:
- recorder.deb
- vscreen_transcoder.tar
Сервис Record Delivery:
- dion-record-delivery.deb
Сервис Record Converter:
- dion-record-converter.deb
¶ Для сервисов SIP:
Сервисы SIP Server и SIP Transcoder:
- dion-sip-server
- dion-sip-transcoder
Сервис SIP Translator:
- dion-sip-translator
- vscreen_transcoder.tar
У вас должны быть в наличии файлы с ключами и org_id. Обычно они уже скопированы на соответствующие виртуальные машины в процессе установки предыдущей версии DION:
- текстовый файл, содержащий ID вашей организации в DION, org_id.txt
- сертификат и ключ для вашей организации (.crt и .key)
- сертификат удостоверяющего центра (.pem)
Проверьте, что не истек срок действия сертификатов.
Если какой-либо информации из списка выше не хватает, запросите ее дополнительно у команды DION.
ID организации можно посмотреть в административной панели DION.
Если часть сервисов будет развернута впервые, например, сервисы записи, воспользуйтесь для их развертывания инструкцией по установке с нуля.
Прежде чем перейти к секциям ниже, скопируйте новые версии .deb пакетов DION на соответствующие машины. Предварительно проверьте, чтобы файла с точно таким же именем не было на устройстве. Если нужно, переименуйте файлы.
¶ Сетевые доступы
В связи с изменением логики работы TURN, необходимо добавить новый сетевой доступ:
| № | Инициатор | Получатель | Порт | Протокол | Назначение | ||
| 1 | DION-PROXY | TURN | 9088 | TCP | Health Check | ||
¶ Конфигурационные файлы
Перед обновлением скачайте шаблоны конфигурационных файлов и заполните их для каждого сервиса. Если нод одного типа несколько, создайте по одному файлу на каждый экземпляр сервиса.
Внимание! Все конфигурационные файлы НЕОБХОДИМО заполнить заново. В файлах есть изменения относительно версии 4.9 и 5.3
При заполнении шаблонов используйте комментарии в самих файлах. Редактировать файл можно в любом удобном текстовом редакторе, но обязательно с сохранением отступов и исходного формата расширения. В качестве дополнительной подсказки можно использовать соответствующий раздел инструкции по установке и старые конфигурационные файлы сервисов.
¶ Обновление сервисов конференций и записи
Прежде чем перейти к секциям ниже, убедитесь, что новые версии .deb пакетов DION скопированы на соответствующие машины
Для редактирования конфигурационных файлов и переустановки сервисов вам потребуются root права.
При недостатке прав используйте sudo или sudo su.
Если какая-либо из гибридных нод запущена в нескольких экземплярах, обновление нужно выполнить на каждом экземпляре.
¶ Dion-Proxy
Перейдите в cli ноды, на которой установлен пакет dion-proxy
1. Удалите старую версию сервиса
sudo apt purge dionproxy
либо
sudo apt purge dion-proxy
2. Установите новую версию сервиса 5.6
sudo apt install -f {путь к новому .deb пакету}
3. Удалите конфигурационный файл
sudo rm /etc/dion/proxy.yaml
Проверка: команда
ls /etc/dion/НЕ отображаетproxy.yamlв списке файлов в директории
4. Скопируйте созданный из шаблона на этапе подготовки конфигурационный файл в директорию /etc/dion/
Проверка: команда
ls /etc/dion/должна отобразить наличие в директории файлаproxy.yaml
5. Перезапустите сервис
systemctl stop dion-proxy
systemctl start dion-proxy
6. Убедитесь, что сервис запущен без ошибок и находится в статусе active (running)
systemctl status dion-proxy
¶ TURN
Сервис не требует обновления пакета, но требует обновления конфигурационного файла.
Можно удалить файл и заменить его на файл из шаблона, либо добавить необходимые новые строки в существующий конфигурационный файл.
¶ Подмена конфигурационного файла
Перейдите в cli ноды, на которой установлен пакет coturn
1. Удалите конфигурационный файл
sudo rm /etc/turnserver.conf
Проверка: команда
ls /etc/ | grep turnserver.confНЕ отображаетturnserver.confв списке файлов в директории
2. Скопируйте созданный из шаблона на этапе подготовки конфигурационный файл turnserver.conf в директорию /etc/
Проверка: команда
ls /etc/ | grep turnserver.confдолжна отобразить наличие в директории файлаturnserver.conf
¶ Добавление новых строк
Необходимо добавить в начало файла строки:
web-admin
# Укажите локальный адрес данного TURN без пробелов и кавычек
web-admin-ip=
web-admin-port=9088
¶ KMS
Перейдите в cli ноды, на которой установлен пакет dion-kms
1. Удалите старую версию сервиса
sudo apt purge dion-kms
2. Установите новую версию сервиса 5.6
sudo apt install -f {путь к новому .deb пакету}
3. Удалите конфигурационный файл
sudo rm /etc/dion/kms.yaml
Проверка: команда
ls /etc/dion/НЕ отображаетkms.yamlв списке файлов в директории
4. Скопируйте созданный из шаблона на этапе подготовки конфигурационный файл в директорию /etc/dion/
Проверка: команда
ls /etc/dion/должна отобразить наличие в директории файлаkms.yaml
5. Перезапустите сервис
systemctl stop dion-kms
systemctl start dion-kms
6. Убедитесь, что сервис запущен без ошибок и находится в статусе active (running)
systemctl status dion-kms
¶ Audiohub
Перейдите в cli ноды, на которой установлен пакет dion-audiohub
1. Удалите старую версию сервиса
sudo apt purge dion-audiohub
2. Установите новую версию сервиса 5.6
sudo apt install -f {путь к новому .deb пакету}
3. Удалите конфигурационный файл
sudo rm /etc/dion/audiohub.conf
Проверка: команда
ls /etc/dion/НЕ отображаетaudiohub.confв списке файлов в директории
4. Скопируйте созданный из шаблона на этапе подготовки конфигурационный файл в директорию /etc/dion/
Проверка: команда
ls /etc/dion/должна отобразить наличие в директории файлаaudiohub.conf
5. Перезапустите сервис
systemctl stop dion-audiohub
systemctl start dion-audiohub
6. Убедитесь, что сервис запущен без ошибок и находится в статусе active (running)
systemctl status dion-audiohub
¶ SFU
Перейдите в cli ноды, на которой установлен пакет dion-sfu
1. Удалите старую версию сервиса
sudo apt purge dion-sfu
2. Установите новую версию сервиса 5.6
sudo apt install -f {путь к новому .deb пакету}
3. Удалите конфигурационный файл
sudo rm /etc/dion/sfu.yaml
Проверка: команда
ls /etc/dion/НЕ отображаетsfu.yamlв списке файлов в директории
4. Скопируйте созданный из шаблона на этапе подготовки конфигурационный файл в директорию /etc/dion/
Проверка: команда
ls /etc/dion/должна отобразить наличие в директории файлаsfu.yaml
5. Перезапустите сервис
systemctl stop dion-sfu
systemctl start dion-sfu
6. Убедитесь, что сервис запущен без ошибок и находится в статусе active (running)
systemctl status dion-sfu
¶ Recorder
Перейдите в cli ноды, на которой установлен пакет dion-recorder
Убедитесь, что на виртуальную машину скопирован образ vscreen_transcoder.tar
- Выгрузите старую версию vscreen_transcoder из docker
- выполните команду
docker image lsи скопируйте из вывода команды значениеIMAGE ID
- подставьте ID в команду ниже и удалите образ
docker image rm {IMAGE ID}
2. Загрузите новую версию vscreen_transcoder
docker load -i {путь к образу vscreen_transcoder.tar}
Проверка: команда
docker image lsдолжна отобразить образ версии 4-3-0
- Проверьте версию сервиса командой
docker image ls - Убедитесь, что она совпадает с версией, указанной в переменной
TRANSCODER_CONTAINER_NAMEв шаблонеrecorder.conf, и исправьте значение в файле в случае необходимости
3. Удалите старую версию сервиса Recorder
sudo apt purge dion-recorder
4. Установите новую версию сервиса 5.6
sudo apt install -f {путь к новому .deb пакету}
5. Удалите конфигурационный файл
sudo rm /etc/dion/recorder.conf
Проверка: команда
ls /etc/dion/НЕ отображаетrecorder.confв списке файлов в директории
6. Скопируйте созданный из шаблона на этапе подготовки конфигурационный файл в директорию /etc/dion/
Проверка: команда
ls /etc/dion/должна отобразить наличие в директории файлаrecorder.conf
7. Перезапустите сервис
systemctl stop dion-recorder
systemctl start dion-recorder
8. Убедитесь, что сервис запущен без ошибок и находится в статусе active (running)
systemctl status dion-recorder
¶ Record Converter
Перейдите в cli ноды, на которой установлен пакет dion-record-converter
1. Удалите старую версию сервиса
sudo apt purge dion-record-converter
2. Установите новую версию сервиса 5.6
sudo apt install -f {путь к новому .deb пакету}
3. Удалите конфигурационный файл
sudo rm /etc/dion/record-converter.conf
Проверка: команда
ls /etc/dion/НЕ отображаетrecord-converter.confв списке файлов в директории
4. Скопируйте созданный из шаблона на этапе подготовки конфигурационный файл в директорию /etc/dion/
Проверка: команда
ls /etc/dion/должна отобразить наличие в директории файлаrecord-converter.conf
5. Перезапустите сервис
systemctl stop dion-record-converter
systemctl start dion-record-converter
6. Убедитесь, что сервис запущен без ошибок и находится в статусе active (running)
systemctl status dion-record-converter
¶ Record Delivery
Перейдите в cli ноды, на которой установлен пакет dion-record-delivery
- Удалите старую версию сервиса
sudo apt purge dion-record-delivery
2. Установите новую версию сервиса 5.6
sudo apt install -f {путь к новому .deb пакету}
3. Удалите конфигурационный файл
sudo rm /etc/dion/record-delivery.conf
Проверка: команда
ls /etc/dion/НЕ отображаетrecord-delivery.confв списке файлов в директории
4. Скопируйте созданный из шаблона на этапе подготовки конфигурационный файл в директорию /etc/dion/
Проверка: команда
ls /etc/dion/должна отобразить наличие в директории файлаrecord-delivery.conf
5. Перезапустите сервис
systemctl stop dion-record-delivery
systemctl start dion-record-delivery
6. Убедитесь, что сервис запущен без ошибок и находится в статусе active (running)
systemctl status dion-record-delivery
¶ Обновление сервисов SIP
¶ SIP Server
Перейдите в cli ноды, на которой установлен пакет dion-sipserver
1. Удалите старую версию сервиса
sudo apt purge dion-sipserver
2. Установите новую версию сервиса 5.6
sudo apt install -f {путь к новому .deb пакету}
4. Удалите конфигурационные файлы
sudo rm /etc/dion/sipserver.yml
sudo rm /etc/dion/sip/sipserver/organizations.yml
Проверка: команда
ls /etc/dion/sip/sipserver/НЕ отображаетsipserver.ymlиorganizations.ymlв списке файлов в директории
5. Скопируйте созданные из шаблона на этапе подготовки конфигурационные файлы sipserver.yml и organizations.yml в директорию /etc/dion/sip/sipserver/
Проверка: команда
ls /etc/dion/sip/sipserver/должна отобразить наличие в директории файловsipserver.yml,organizations.yml
6. Перезапустите сервис
systemctl stop dion-sipserver
systemctl start dion-sipserver
7. Убедитесь, что сервис запущен без ошибок и находится в статусе active (running)
systemctl status dion-sipserver
¶ SIP Transcoder
Перейдите в cli ноды, на которой установлен пакет dion-siptranscoder
- Удалите старую версию сервиса
sudo apt purge dion-siptranscoder
2. Установите новую версию сервиса 5.6
sudo apt install -f {путь к новому .deb пакету}
3. Удалите конфигурационный файл
sudo rm /etc/dion/sip/siptranscoder/siptranscoder.env
Проверка: команда
ls /etc/dion/sip/siptranscoder/НЕ отображаетsiptranscoder.envв списке файлов в директории
5. Скопируйте созданный из шаблона на этапе подготовки конфигурационный файл siptranscoder.env в директорию /etc/dion/sip/siptranscoder/
Проверка: команда
ls /etc/dion/sip/siptranscoder/отображаетsiptranscoder.envв списке файлов в директории
6. Перезапустите сервис
systemctl stop dion-siptranscoder
systemctl start dion-siptranscoder
7. Убедитесь, что сервис запущен без ошибок и находится в статусе active (running)
systemctl status dion-siptranscoder
¶ SIP Translator
Перейдите в cli ноды, на которой установлен пакет dion-siptranslator
¶ Контейнер vscreen_transocer
- Выгрузите старую версию vscreen_transcoder из docker
- выполните команду
docker image lsи скопируйте из вывода команды значениеIMAGE ID
- подставьте ID в команду ниже и удалите образ
docker image rm {IMAGE ID}
2. Загрузите новую версию vscreen_transcoder 5.6
docker load -i {путь к образу vscreen_transcoder.tar}
- Проверьте версию сервиса командой
docker image ls
Команда docker image ls должна отобразить образ версии 5-6-0
¶ Сервис SIP Translator
- Удалите старую версию сервиса
sudo apt purge dion-siptranslator
2. Установите новую версию сервиса 5.6
sudo apt install -f {путь к новому .deb пакету}
3. Удалите конфигурационный файл
sudo rm /etc/dion/sip/siptranslator/siptranslator.env
Проверка: команда
ls /etc/dion/sip/siptranslator/НЕ отображаетsiptranslator.envв списке файлов в директории
4. Скопируйте созданный из шаблона на этапе подготовки конфигурационный файл siptranslator.env в директорию /etc/dion/sip/siptranslator/
Проверка: команда
ls /etc/dion/sip/siptranslator/отображаетsiptranslator.envв списке файлов в директории
5. Перезапустите сервис
systemctl stop dion-siptranslator
systemctl start dion-siptranslator
6. Убедитесь, что сервис запущен без ошибок и находится в статусе active (running)
systemctl status dion-siptranslator
¶ Заключение
Прежде чем вводить систему в эксплуатацию, убедитесь, что все сервисы находятся в состоянии Active (Running) и отображены зеленым в административной панели DION в разделе “Гибридные сервисы”.
Ожидаемый результат успешного обновления гибридного DION:
- Можно создать комнату в DION, в настройках безопасности комнаты можно выбрать “On-Premise”
- Созданная комната запускается без ошибок
- В комнату могут подключиться пользователи из внутренней сети предприятия и пользователи из интернета, видят и слышат друг друга
- В комнате можно включить запись (если развернуты гибридные компоненты записи)
- Созданная запись доступна для скачивания по ссылке из автоматически сгенерированного письма
- В комнату можно позвонить по SIP (если развернуты сервисы SIP)
В случае возникновения проблем, воспользуйтесь Руководством по устранению неисправностей.
Если проблема не решается, обратитесь к вашей аккаунт команде или в службу поддержки DION (support@diongo.ru)