Перед установкой

Для установки и последующей настройки ПО ВИДЕОСЕЛЕКТОР СЕРВЕР вам потребуется:

  • Дистрибутив рекомендуемой ОС
  • Дистрибутив ПО ВИДЕОСЕЛЕКТОР СЕРВЕР (предоставляется по запросу)
  • Параметры сетевого интерфейса сервера (IP-адрес, маска, шлюз)
  • DNS имя для обращения к веб-интерфейсу сервера (например, vselector.example.com)
  • DNS имя для обращения к системе входа (например, auth.example.com)
  • SSL сертификат (wilcard или включающий два DNS имени, указанных выше)
  • Настройки почтового сервера для отправки уведомлений (необязательно)
  • Доступ сервера к сети интернет (необязательно)

Установка сервера

Для установки ПО ВИДЕОСЕЛЕКТОР СЕРВЕР вам необходимо:

  • Установить на сервер одну из рекомендуемых ОС

    Рекомендуемые ОС:

    Начиная с версии 8.2.0 установка ВИДЕОСЕЛЕКТОР сервер на ОС Debian 9 и Astra Linux Орел 2.12 не поддерживается.

    Обратите внимание при планировании обновления ПО.

  • Установить ВИДЕОСЕЛЕКТОР СЕРВЕР

Установка ОС

Debian 10

Для установки ВИДЕОСЕЛЕКТОР СЕРВЕР на Debian 10 вам необходимо скачать образ по ссылке:

https://cdimage.debian.org/cdimage/archive/10.13.0/amd64/iso-dvd/debian-10.13.0-amd64-DVD-1.iso

Использование другого образа может привести к ошибкам установки.

Картинки экранов могут незначительно отличаться от нижеприведенных.

  • На стартовом экране выберите вариант установки "Install":

  • В открывшемся окне выберите язык "Русский":

  • В открывшемся окне выберите местонахождение "Российская Федерация":

  • В окне настройки клавиатуры выберите раскладку "Русская":

  • В окне настройки клавиатуры выберите способ переключения раскладки клавиатуры "Alt+Shift" (или другой удобный для вас способ):

  • На следующем этапе настройки сети, в случае использования в вашей локальной сети DHCP-сервера для выдачи адресов, в окне настройки сети укажите DNS-имя сервера: 

Если DHCP-сервер отсутствует, то вам потребуется дополнительно ввести статический IP-адрес.

  • Если в сети используется домен, то в коне настройки сети укажите его. В противном случае, пропустите этот шаг:

  • В окне настройки учетных записей и паролей ведите пароль суперпользователя (Администратора сервера):

  • Подтвердите введенный ранее пароль:

  • Укажите имя для создаваемого локального пользователя:

  • Укажите пароль для локального пользователя:

  • Выберите часовой пояс вашего региона. По умолчанию указан "Москва":

  • Выберите метод разметки диска, по умолчанию указана автоматическая разметка всего диска. Для целей тестирования рекомендуем оставить значение по умолчанию:

  • Выберите диск для разметки:

  • Выберите схему разметки диска, по умолчанию указан "Все файлы в одном разделе". Для целей тестирования рекомендуем оставить значение по умолчанию:

  • Завершите процесс разметки диска и запустите запись изменений на диск:

  • Запустится процесс установки базовой системы:

  • По завершению процесса базовой установки система выдаст сообщения:
    • Об успешности процесса сканирования и запрос о необходимости дальнейшего сканирования, выберите "Нет":

    • Запрос о необходимости использования зеркала архива в сети. Выберите "Нет":

    • Запрос об участии в опросе популярности пакетов. Выберите "Нет":

  • В окне выбора программного обеспечения выберите необходимые для установки пакеты:
    • SSH-server
    • Стандартные системные утилиты

  • Запустится процесс установки

  • На завершающем этапе установки подтвердите установку системного загрузчика в главную загрузочную запись:

  • По завершению процесса установки система выдаст соответствующее информационное соглашение:

ALSE 1.7

Для установки ВИДЕОСЕЛЕКТОР СЕРВЕР вам необходима актуальная версия Astra Linux Special Edition 1.7.

Использование неактуальной версии ОС может привести к ошибкам.

Инструкция по установке размещена на портале разработчика:

https://wiki.astralinux.ru/pages/viewpage.action?pageId=153485981

Установка ПО

Ниже все примеры команд выполняются от созданного при установке ОС пользователя, например installuser с домашним каталогом /home/installuser

  • Подключитесь к серверу через ssh-клиент, например:

    ssh installuser@server_name_here
    CODE

    где server_name_here имя вашего сервера, доступное по сети

  • Повысьте права до супер-пользователя командой:

    su -
    CODE


    Если операционная система была предварительно установлена не из рекомендуемого дистрибутива, а стороннего источника, настоятельно рекомендуется настроить правильно системную локаль. Делается это следующим набором команд (от пользователя root):

    dpkg-reconfigure locales
    CODE

    В появившейся форме ищем локаль ru_RU.UTF-8 и отмечаем её нажатием пробелом. При следующем запросе выбора локали по умолчанию, указываем её же.

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

    reboot
    CODE


  • Разместите файлы дистрибутива ВИДЕОСЕЛЕКТОР сервер в домашнем каталоге пользователя, включая:

    Имя файлаСодержимое
    repo.tar.gzархив дистрибутива ПО ВИДЕОСЕЛЕКТОР с необходимыми зависимостями
    install.shскрипт установки ПО ВИДЕОСЕЛЕКТОР

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

    cd /home/installuser
    CODE


  • Создайте и заполните значения в конфигурационном файле install.conf (рекомендуется)

    nano install.conf
    CODE

    Предположим, что сервис будет опубликован под именем vselector.example.com

    Для системы входа будет использоваться имя auth.example.com.

    Wildcard-cертификат и приватный ключ с именами example.com.crt и example.com.key размещены в стандартном хранилище ОС Debian: /etc/ssl/private

    Файл сертификата example.com.crt должен содержать полную цепочку сертификатов или сервер, на котором выполнеятся установка должен доверять этому сертификату

    Тогда пример заполненного конфигурационного файла будет выглядеть следующим образом:

    path_to_crt=/etc/ssl/private/example.com.crt
path_to_key=/etc/ssl/private/example.com.key
dns_web=vselector.example.com
dns_auth=auth.example.com
    CODE

    Если на момент установки у вас нет данных о DNS-именах и SSl-сертфикате, вы можете пропустить этот шаг и выполнить эту настройку позже.

    Скрипт установки определит отсутствие файла конфигурации и осуществит установку с параметрами по умолчанию.

    В этом случае установка будет выполнена для локальных доменных имен videoselector.local и kk.videoselector.local и сгенерирован самоподписанный сертификат


  • Запустите скрипт установки командандой:

    Запуск скрипта установки

    bash install.sh
    BASH

    Установка проходит в полностью автоматизированном режиме. Процедура занимает от 1 до нескольких минут в зависимости от аппаратной составляющей сервера. В процессе установки будут прописаны абсолютные пути на указанные в файле сертификаты, а также доменные имена обоих сервисов. По окончании процедуры установки будет отображено уведомление об успешном завершении.

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

    В случае открытия в процессе установки дополнительных диалоговых окон, оставьте заданные по умолчанию параметры и нажимаем "Enter".

  • После установки проверьте состояние служб ВИДЕОСЕЛЕКТОР командой:

    vselector-control
    CODE

Пример ответа:

root@videoselector-demo:/home/installuser# vselector-control 

Usage: vselector-control { start | stop | restart | kill socket | sendmail | removerecords | db } 

Running STANDALONE configuration 
vksdog 9489 
vselector-media-core 9594 
vselector-mcu-core 9582 
vselector-mcu-proxy 9533 9534 
vselector-mcu-codec 9553 9554 9555 9556 9557 9558 9560 9561 9563 9565 9567 
vselector-media-sipuad 9607 
OpenSIPs 9467 9472 9473 9474 9475 9476 9477 
sockets 9667 9700 9735 9770 vselector-bridge 9508 
vselector-mailer not running! 
vselector-job 9597 
vselector-media-recorder not running! 
vselector-media-wrtc not running! 
vselector-media-echo not running! 
vselector-media-player not running! 
vselector-toschecker not running!
CODE

Установка успешно завершена!

Убедитесь в доступности сервера, подключившись через совместимый браузер к веб-интерфейсу сервера по адресу https://{DNS-имя сервера}.

Подробней о начале работы с сервером и интерфейсе настройки ознакомьтесь в разделах:

Настройка и управление сервером

Настройки сервера

Начальная настройка сервера

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

  • Сменить стандартный пароль администратора (обязательно)
  • Настроить основной IP-адреса сервера по инструкции инструкции(если сервер имеет более одного сетевого интерфейса настройте нужный IP-адрес для работы по )
  • Настроить DNS-имена и SSL сертификат веб-сервера для безопасной публикации по инструкции (если при установке был пропущен шаг указания параметров в файле install.conf)
  • Настроить параметры подключения к почтовому серверу по инструкции

Смена стандартного пароля администратора системы входа KeyCloak

Перед началом использования ВИДЕОСЕЛЕКТОР, настоятельно рекомендуется изменить стандартный пароль пользователя admin системы входа

Также смените пароль администратора ПО ВИДЕОСЕЛЕКТОР по инструкции  в разделе Настройки сервера

  • Откройте браузер и перейдите по URL-адресу системы входа (например, auth.example.com)
  • Перейдите в "Administration Console". Выполните вход с логином admin и паролем admin
  • Выберите Realm = Master и перейдите в раздел Users и выберите для редактирования пользователя admin (учетная запись администратора системы входа)
  • Перейдите на вкладку Credentials, нажмите Reset password
  • Снимите галочку с Temporary, введите новый пароль с подтверждением и сохраняем результат нажмите Save.

На этом смена пароля пользователя администратор завершена! В дальнейшем при входе в интерфейс системы под пользователем admin используйте указанный после смены пароль


Удаление ПО

Перед удалением сервера сохраните видеозаписи в каталоге /opt/videoselector/records

  • Подключитесь к серверу через ssh-клиент, например:

    ssh installuser@server_name_here
    CODE

    где server_name_here имя вашего сервера, доступное по сети

  • Повысьте права до супер-пользователя командой:

    su -
    CODE

  • Остановите службы 

    vselector-control stop
systemctl stop opensips
    CODE

  • Удалите пакеты videoselector и videoselector-libs, а также ненужные зависимости, которые останутся после удаления

    apt purge videoselector videoselector-libs
apt autoremove
    CODE

  •  Удалите базу данных

    systemctl restart postgresql
sudo --user=postgres psql -c "drop database videoselector"
sudo --user=postgres psql -c "drop role videoselector_database"
    CODE

Переустановка ПО

При необходимости вы можете произвести переустановку ПО.

Для этого выполните удаление ПО (см. раздел Удаление ПО) и затем установите ПО ((см. раздел Установка ПО)