Установка на локальном сервере

Документ описывает процесс установки Webitel на собственном сервере в on-site варианте развертывания.

Linux

Рекомендуем использовать Debian Stretch либо Ubuntu Server. Только 64bit! Ниже приведенная инструкция подходит, в первую очередь, этим двум дистрибутивам.

Установка docker

Самый простой способ установки - это использование скрипта:

# apt-get install curl ntp
# curl -sSL https://get.docker.com/ | sh
# docker --version

Варианты установки на других дистрибутивах: https://docs.docker.com/engine/installation/

Установка docker-compose

Поскольку Webitel это комплекс из нескольких приложений, рекомендуем использовать docker-compose. Установка:

# curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
# chmod +x /usr/local/bin/docker-compose
# docker-compose --version

Подготовка к запуску webitel

Для запуска Webitel Вам необходимо скачать подготовленные для docker-compose файлы, внести свои правки и запустить.

Текущая стабильная версия Webitel 3.11.6

Получение файлов:

$ sudo gpasswd -a ${USER} docker
$ cd /opt
$ sudo mkdir /opt/webitel
$ sudo git clone https://github.com/webitel/orchestration.git
$ sudo chown -R ${USER}:docker /opt/webitel /opt/orchestration
$ cd /opt/orchestration
$ git checkout v3.11.6

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

Конфигурационные файлы

В директории /opt/orchestration/env поставляются файлы конфигурации с расширением *.example. Вам необходимо скопировать эти файлы без расширения. Самый простой способ - выполнить команду:

Прежде, чем приступить к запуску, нам нужно изменить 2 значения в файле env/environment:

WEBITEL_HOST - необходимо указать полное FQDN имя или скрипт попытается определить IP адрес вашего сервера webitel автоматически.
WEBITEL_PASS - пароль для пользователя root. Пароль может содержать символы латинского алфавита, цифры, а так же знаки: + - _ .

Параметры Linux:

Для Ubuntu необходимо дополнительно выполнить:

Добавить Webitel в автозагрузку:

Запуск Webitel

Имея готовый файл с описанием контейнеров, мы можем скачать образы c Docker Hub на сервер и создать контейнеры.

Основные команды:

Команда	Описание

Команда	Описание
fs	Запустить fs_cli для подключения к консоли FreeSWITCH
backup	Выполняет резервное копирование базы данных и конфигурации webitel
-	не указывая ничего, запускаем webitel

Аргументы:

Аргумент	Описание

Аргумент	Описание
up	Создать либо пересоздать контейнеры. Для запуска контейнера в фоновом режиме, необходимо добавить ключ -d
stop	Остановить контейнеры
start	Запустить созданные раньше контейнеры
rm	Удалить контейнеры
pull	Скачать последнюю версию образов
ps	Вывести список контейнеров и их состояние
logs	Отобразить вывод логов из контейнеров

Запускаем webitel:

$ cd /opt/orchestration

Проверяем, что все запустилось и работает:

Создание сертификата X.509v3

Что бы перезапустить полностью все контейнеры webitel, используйте последовательность:

Наше приложение готово к работе.

Приложение	URL

Приложение	URL
Webitel WebClient	http://наш_домен/
WebSocket сервер и RESTFul API	http://наш_домен/engine/
WebRTC подключение	http://наш_домен/verto/
Kibana	http://наш_домен/kibana/
Документация по API	http://наш_домен/docs/

Теперь можем переходить к разделу Первичная настройка системы.