Руководство по установке серверной части модуля Команда ПО Р7-Офис на ОС Debian Linux

Распечатать/сохранить в PDF

"max_conference_capacity": 100,

sudo systemctl restart opensips.service

1. Общие положения о модуле Р7-Команда

1.1. Загрузка дистрибутива

Необходимо скачать дистрибутив Р7-Команда и разместить его на сервере. Ссылку на дистрибутив необходимо получить у вашего партнёра или у вашего менеджера в компании АО «Р7».

Также, актуальную версию можно скачать на странице:

https://r7-office.ru/download/team_server

1.2. Состав дистрибутива

В состав дистрибутива входят: дистрибутив модуля Р7-Команда и скрипт для автоматизированного развертывания, обновления и обслуживания ПО.

1.3. Поддерживаемые операционные системы

Проверена совместимость со следующими операционными системами:

• Debian 11 Bullseye английская версия (локализация) без графического интерфейса.

2. Подготовка инфраструктуры для развертывания серверного ПО Р7-Команда

2.1. Описание:

Для развертывания системы необходимо 3 сервера (или виртуальные машины):

• R7Office — Корпоративный сервер 2024 (инструкция по развертыванию и настройке передается дополнительно);
• R7Team – сервер управления и чатов Р7-Команда;
• R7Team-M – медиа-сервер для работы звонков и ВКС модуля Р7-Команды. Для работы решения для серверов R7Team и R7Team-M требуется 2 публичных и 1 внутренний IP адрес. Для интеграции с R7Team-M с АТС Заказчика налаженное сетевое взаимодействие. Сервера должны иметь доступ друг к другу через локальную сеть.

Порядок установки серверов смотрите ниже.

2.2. Добавление DNS записей

Для корректной работы ПО Р7-Команда необходимо произвести добавления Host(А) в DNS зону Заказчика.
Добавление Host(А) записей обязательно для корректной работы ПО Р7-Команда.
Полный перечень необходимых А записей для подключения к серверу и их назначение указаны в следующей таблице.

2.3. Архитектура и таблица сетевого взаимодействия

Подходит в качестве стандартной архитектуры для эксплуатации до 1000 пользователей. Общая архитектура решения приведена на следующей диаграмме.

Обратите внимание на схему и таблицу портов.

2.4. Системные требования

Минимальные требования к ресурсам приведены ниже по ролям.

Р7-Офис Сервер

Расчёт производится отдельно согласно системных требований предъявляемых к порталу.

Р7-Команда с ролью Сервер управления:

• Кол-во ядер процессора (CPU cores) – 4;
• Частота процессора (CPU MHZ per core) – 2ГГц;
• ОЗУ (RAM) – 8 ГБ
• Диск 1 (используется для хранения установочных файлов и ОС) – рекомендуем использовать SSD не менее 60 ГБ;
• (Опционально) Диск 2 (используется для хранения файлов, отправляемых пользователями) – рекомендуем использовать HDD не менее 100 ГБ;
• 1 внутренний IP адрес в локальной сети Заказчика (или сети ДМЗ Заказчика);
• 1 публичный IP адрес (настраивается на маршрутизаторе/межсетевом экране с функцией перенаправления портов на внутренний IP адрес в локальной сети или сети ДМЗ Заказчика).

Р7-Команда с ролью Медиа-сервер:

• Кол-во ядер процессора (CPU cores) – 4;
• Частота процессора (CPU MHZ per core) – 2ГГц;
• ОЗУ (RAM) – 4 ГБ;
• Диск 1 (используется для хранения установочных файлов, ОС и установки ПО Mind API) – рекомендуем использовать SSD не менее 60 ГБ;
• 1 IP адрес (если требуются звонки с устройств расположенных в сети интернет на сетевом интерфейсе, необходимо назначить публичный «белый» IP адрес, если звонки с устройств из сети интернет не требуются, то возможно назначения внутреннего IP адреса в локальной сети Заказчика);
• в случае использования виртуальных машин KVM нужно принудительно указать процессор как host;
• нужна одна партиция (не считая swap-партиции), то есть чтобы не было отдельной партиции для /home;
• нужно поставить системный hostname в r7team-m.<domain>.

3. Порядок установки

Для установки Системы следует придерживаться следующего порядка

1. Генерация, получение необходимых SSL сертификатов.
2. В случае необходимости интеграции с Корпоративным сервером 2024 проводим работы по подготовке и дополнительной настройке КС 2024, результаты работы нам потребуются при установке сервера управления.
3. Установка медиа сервера. На этом этапе мы получаем appID, token которые нам понадобятся при установке сервера управления.
4. Установка сервера управления.

4. Установка Медиа-сервера модуля Р7-Команда.

4.1. Подготовка к установке

Файл /etc/hosts необходимо привести к виду:

127.0.0.1 localhost
ip_адрес домен

Например

Скопировать установочный архив и ранее выписанный ssl сертификат и ключ на сервер

Архив с дистрибутивом размещаем в каталоге /opt, ssl сертификат и ключ в каталоге /etc/ssl

Переходим в каталог с архивом

cd /opt

Проверяем чексумму с чек суммой на сайте командой:

md5sum install_r7_team*

Распаковываем архив

mkdir -p install && tar -xzf install_r7_team*.tar.gz -C install

Переходим в каталог с разархивированным содержимым

cd install

Выполняем команду перед запуском скрипта установки:

apt remove libx11-6

И запускаем скрипт установки

chmod +x install.sh && ./install.sh

4.2 Процесс установки медиа сервера

Выбираем язык и переходим в установку медиа сервера

Продолжаем установку

Вводим имя медиа сервера

Настроить https отвечаем Да

И указываем путь к сертификату и ключу на сервере

После этого запустится процесс установки, ожидаем завершения.

По завершению процесса инсталляции пользователю будет выдано информационное сообщение о результатах инсталляции.

Для доступа к функционалу видеоконференцсвязи необходим идентификатор приложения и его токен доступа.
По умолчанию он будет сохранен в файл /root/.team/config

Выходим из скрипта установки

5. Установка сервера управления модуля Команда

5.1. Подготовка к установке

Файл hosts приводим к виду

127.0.0.1 localhost
ip_адрес домен

Например,

Скопировать установочный архив и ранее выписанный ssl сертификат и ключ на сервер

Архив с дистрибутивом размещаем в каталоге /opt, ssl сертификат и ключ в каталоге /etc/ssl

Переходим в каталог с архивом

cd /opt

Проверяем чексумму с чек суммой на сайте командой:

md5sum install_r7_team*

Распаковываем архив

mkdir -p install
tar -xzf install_r7_team*.tar.gz -C install

Переходим в каталог с разархивированным содержимым

cd install

Выполняем команду перед запуском скрипта установки:

apt remove libx11-6

И запускаем скрипт установки

chmod +x install.sh
./install.sh

5.2 Процесс установки сервера управления

Переходим в меню установки сервера управления

Отмечаем компоненты для установки, если не используются внешние:

Вводим используемое имя сервера:

Выбираем порт для HTTP:

Настраиваем HTTPS:

Выбираем порт для HTTPS:

Указываем пути к ssl сертификату и ключу:

Задаем учетные данные администратора и название его организации:

Вводим путь для хранения файлов:

Настраиваем подключение к медиа серверу:

И указываем адрес для подключения:

где r7team-m.sip2.p7office.ru это адрес обращения к медиа серверу, который указывается на сервере шлюз в файле /etc/nginx/conf.d/r7teamm.conf по умолчанию

Повторяем адрес в следующем окне:

Значения applicationId и applicationToken вводим из файла /root/.team/config на медиа сервере:

Выбираем Yes для проверки доступа до медиа сервера:

В случае возникновения проблем с соединением получим ошибку:

Если при настройке медиа-сервера производилось подключение к SIP-to-PSTN шлюзу (Инструкция), то выбрать Yes:

Если выбрали настройку SIP телефонии, то следуйте инструкции.

В противном случае, продолжайте далее.

Выбираем интеграцию с корпоративным сервером 2024:

Вводим адрес админ панели корпоративного сервера:

И адрес диска:

Client Id и Client Secret для Р7 Команда вводим из админ панели корпоративного сервера 2024:

Если для КС 2024 используется брокер, расположенный на том же сервере, что и сам КС 2024, то в адрес и порт очереди вводим ip адрес диска (в ином случае вводим адрес и порт брокера):

Логин и пароль вводим из админ панели Диска

Проверяем подключения к брокеру:

В случае возникновения проблем с соединением, получим ошибку:

При необходимости включаем push уведомления для мобильных устройств:

Далее вводим полученные значения:

Выбираем, как хотим передавать данные:

Проверяем данные для подключения к сервису:

В случае ошибки ввода получим ошибку:

В последнем окне проверяем введенные данные и нажимаем Продолжить (или Настроить заново для изменения)

И ожидаем завершения установки

После завершения установки переходим в админ панель сервера управления по адресу https://r7team.sip2.p7office.ru/admin/

Вводим учетные данные администратора и загружаем файл лицензии

6. Добавление корневых сертификатов в доверенные

В некоторых случаях, например, при использовании самоподписанных сертификатов, для корректной работы Р7-Команда требуется добавить корневые сертификаты в доверенные.

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

Располагаем корневой сертификат на сервере управления.

Запускаем скрипт установки Р7-Команда:

./install.sh

Переходим в сервисное меню сервера управления — Исправление ошибок установки:

Выбираем пункт Импортировать корневой сертификат:

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

Выбираем путь для хранилища ключей Java:

Будет предложено перезагрузить сейчас или позже.

7. Обновление модуля Р7-Команда

Удалить предыдущий установочный архив и папку с распакованными файлами (если ранее не были удалены)

Скопировать установочный архив на сервера

Распаковать архив командой

unzip -d install install_r7_team_{version}.zip

Перейти в папку install

cd install

Запустить скрипт выполнив команду

./install.sh

и выбрать пункт «Обновить Р7 Команда сервер управления».

Следовать руководству мастера установки, основываясь на описании шагов в разделе «Установка Р7-Команда».

8. Удаление модуля Р7-Команда

Перейти в папку /opt/team

cd /opt/team

Запустить скрипт выполнив команду

./install.sh

и выбрать пункт «Удалить Р7 Команда сервер управления»

Для запуска процесса удаления необходимо дать подтверждение в открывшемся диалоговом окне.

По завершению процесса удаления пользователю будет выдано информационное сообщение об успешном удалении модуля.

При необходимости удалить содержимое баз данных Postgresql и

MongoDb, а так же сохраненные медиафайлы в папке /var/team/storage.

9. Установка и настройка Корпоративного сервера 2024

9.1. Установите Корпоративный сервер 2024

Установку можно произвести по инструкции:

https://support.r7-office.ru/corporate-server2024/install-r7server/ustanovka-r7-disk

9.2. Внесите изменения в файл конфигурации

nano /opt/r7-office/Api/appsettings.json

Где, в секции OAuth20 добавьте укажите путь к директории, в которой хранится сертификат и ключ Корпоративного сервера 2024:

  "OAuth20": {
    "SigningCertificateFile": "",
    "CertPath": "/etc/nginx/ssl",
    "KeyPath": "/etc/nginx/ssl"
  },
  "DbType": "postgre"
}

где

• CertPath — путь к директории с сертификатом
• KeyPath — путь к директории с ключом

9.3. Перезапустите зависимые службы

Если выполнялось изменение в конфигурационных файлах, выполните перезапуск:

supervisorctl restart cddisk:api cddisk:processing

9.4. Синхронизация пользователей

Авторизуйтесь в модуле Р7-Админ

Для настройки интеграции необходимо авторизоваться пользователем с ролью СуперАдмин, например пользователь superadmin

Данные авторизации после инсталляции:

• superadmin
• superadmin

В модуле «Общие настройки» выберите панель «Интеграция», включите интеграцию, заполните данные и нажмите сохранить.

Пример данных:

https://team.devr7.ru?provider=r7disk
Где

• https://team.devr7.ru — имя сервера управления команд

10. Информация о поддержке

Вы можете связаться со службой поддержки ПО Р7-Офис с помощью обращения:

• по электронной почте, адрес: support@r7-office.ru .
• через портал: https://support.r7-office.ru .