Установка Корпоративный сервер 2024 и Сервер документов на RedOS 7.3.5

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

0. Потребуется для разворачивания

• 2 Виртуальные машины;
• ТХ Машин, для тестирования, возможно использовать;
• От 4 CPU;
• От 8 Гб RAM;
• От 40 Гб свободного пространства на диске;
• Более конкретные данные рассчитываются по обращению в ТП;
• Отключение или перевод selinux в режим permissive для корректной работы сервисов.

1. Архитектура

1.1. Схема

2. Установка Сервер документов для Linux РЕД ОС

Сервер документов устанавливается на локальном сервере и позволяет интегрировать онлайн-редакторы с платформой для совместной работы.

Сервер документов — это офисный пакет для работы онлайн, который включает в себя инструменты просмотра и редакторы текстовых документов, электронных таблиц и презентаций, полностью совместимые с форматами Office Open XML: .docx, .xlsx, .pptx и позволяющие совместно редактировать документы в режиме реального времени.

2.1. Функциональность

• Редактор документов;
• Редактор электронных таблиц;
• Редактор презентаций;
• Приложения просмотра на мобильных устройствах через веб-браузер;
• Совместное редактирование;
• Поддержка иероглифов;
• Поддержка всех популярных форматов: DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX, HTML.

Интегрировав этот модуль с Корпоративный сервер 2024, вы сможете:

• Организовать совместный доступ к файлам;
• Управлять правами доступа к документам;
• Встраивать документы в сайт;
• Просматривать и редактировать файлы, сохраненные в сторонних сервисах Yandex.disk, Mail.ru Диск, OwnCloud, Nextcloud подключенных к Корпоративный сервер 2024.

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

• Процессор: рекомендуется от 4 ядер;
• Оперативная память: рекомендуется от 8 Гб;
• Свободное место на жестком диске: рекомендуется от 40 Гб.

2.3. Требования к программному обеспечению

• Поддерживаемые операционные системы;
• Дополнительные требования:
  • PostgreSQL: версия 11.14 или выше;
  • NGINX: версия 1.24 или выше;
  • Redis: версия 6.2.5 или выше;
  • Erlang: версия 19.3.6.1 или выше;
  • RabbitMQ: версия 3 (4 версия не поддерживается).

2.4. Предварительные действия

2.4.1. Установка зависимостей

Установите NGINX:

sudo yum install nginx -y

После этого сохраним основной конфигурационный файл NGINX /etc/nginx/nginx.conf и создадим новый, чтобы он выглядел следующим образом:

sudo mv /etc/nginx/nginx.conf /etc/nginx/nginx.conf.bak
sudo nano /etc/nginx/nginx.conf

user nginx;
worker_processes 1;
error_log /var/log/nginx/error.log warn;
pid /var/run/nginx.pid;
events {
worker_connections 1024;
}
http {
include /etc/nginx/mime.types;
default_type application/octet-stream;
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log /var/log/nginx/access.log main;
sendfile on;
#tcp_nopush on;
keepalive_timeout 65;
#gzip on;
include /etc/nginx/conf.d/*.conf;
}

2.4.2. Установка и настройка PostgreSQL

Установите версию PostgreSQL:

sudo yum install postgresql postgresql-server -y

Если вы хотите установить какую-то другую версию PostgreSQL из репозитория PostgreSQL, обратитесь за дополнительной информацией к официальной документации PostgreSQL.

2.4.3. Инициализируйте базу данных PostgreSQL в случае, если не был создан /var/lib/pgsql/data/pg_hba.conf

sudo service postgresql initdb

2.4.4. Добавьте в автозагрузку БД

sudo chkconfig postgresql on
sudo systemctl enable postgresql.service

2.4.5. Включите метод аутентификации ‘trust’ для адреса localhost в формате IPv4 и IPv6

Откройте файл /var/lib/pgsql/data/pg_hba.conf в текстовом редакторе.

Найдите строку host all all 127.0.0.1/32 ident и замените ее на следующую:

host all all 127.0.0.1/32 trust

Затем найдите строку host all all ::1/128 ident и замените ее на следующую:

host all all ::1/128 trust

Сохраните изменения.

2.4.6. Перезапустите сервис PostgreSQL

sudo service postgresql restart

2.4.7. Создайте базу данных и пользователя PostgreSQL

Пользователем и паролем для созданной базы данных должны быть r7office.

Сначала выполните команду:

cd /tmp

Для предотвращения ситуации, когда при запуске от имени суперпользователя выдаётся сообщение could not change directory to «/root».

После этого необходимо создать базу данных и пользователя:

sudo -u postgres psql -c "CREATE USER r7office WITH password 'r7office';"
sudo -u postgres psql -c "CREATE DATABASE r7office OWNER r7office;"
sudo -u postgres psql -c "GRANT ALL privileges ON DATABASE r7office TO r7office;"

2.4.8. Установка Redis

sudo yum install redis -y

Запустите сервис Redis и добавьте его в автозагрузку:

sudo service redis start
sudo systemctl enable redis

2.4.9. Установка RabbitMQ

sudo yum install 'rabbitmq-server-3.*' -y

Запустите сервис RabbitMQ и добавьте его в автозагрузку:

sudo service rabbitmq-server start
sudo systemctl enable rabbitmq-server

2.4.10. Использование нестандартного порта

По умолчанию Сервер документов слушает входящие соединения на порту 80. Начиная с версии 4.3 вы можете сменить порт для Сервер документов в случае, если вы планируете использовать его вместо того, который идёт по умолчанию.

Если вы меняете порт по умолчанию, убедитесь, что он открыт для исходящих/входящих соединений. Посмотрите полный список портов, которые используются Сервер документов.

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

export DS_PORT=<PORT_NUMBER>

Вместо <PORT_NUMBER> в команде выше необходимо вписать номер порта, который будет использоваться.

Если вы хотите поменять протокол Сервер документов на HTTPS, не меняйте порт на 443, а воспользуйтесь инструкцией п.2.8.

2.5. Установка Р7-Офис. Профессиональный. Сервер документов

2.5.1. Добавление репозитория и установка Р7-Офис. Профессиональный. Сервер документов

2.5.1.1. Откройте файл на редактирование

sudo nano /etc/yum.repos.d/r7server.repo

2.5.1.2. Добавьте следующий текст

[r7server]
name=r7server
baseurl=https://downloads.r7-office.ru/repository/r7-server-yum/
enabled=1
gpgcheck=1
gpgkey=https://download.r7-office.ru/repos/RPM-GPG-KEY-R7-OFFICE.public
sslverify=1
username=server
password=KwmuQmOzuFIw9wcJsL3zb

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

sudo yum makecache

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

yum install r7-office-documentserver-ee -y

2.5.1.5. Запустите зависимые сервисы и добавьте их в автозагрузку

sudo systemctl start ds-docservice.service
sudo systemctl start ds-converter.service
sudo systemctl start ds-metrics.service
 
sudo systemctl enable ds-docservice.service
sudo systemctl enable ds-converter.service
sudo systemctl enable ds-metrics.service
 
sudo systemctl start nginx.service
sudo systemctl enable nginx.service

После этого Сервер документов будет запущен как процесс. Пакет будет обновляться, как любой другой rpm-пакет.

2.6. Настройка Сервер документов

2.6.1. Запустите скрипт конфигурации

Запустите скрипт documentserver-configure.sh:

bash documentserver-configure.sh

Вам будет предложено указать параметры подключения к PostgreSQL, Redis и RabbitMQ. Используйте следующие данные:

Для PostgreSQL:

• Host: localhost;
• Database: r7office;
• User: r7office;
• Password: r7office.

Для Redis:

• Host: localhost.

Для AMQP:

• Host: localhost;
• User: guest;
• Password: guest.

2.6.2. Добавьте исключение межсетевого экрана

sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
sudo firewall-cmd --reload

2.6.3. Отключите SELinux (не используется с версии 5.0)

Откройте файл /etc/selinux/config в любом текстовом редакторе, замените строку SELINUX=enforcing или SELINUX=permissive на следующую: SELINUX=disabled. Сохраните изменения.

Или воспользуйтесь командами:

# Замена SELINUX=enforcing или SELINUX=permissive на SELINUX=disabled
sudo sed -i 's/^SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config
sudo sed -i 's/^SELINUX=permissive/SELINUX=disabled/' /etc/selinux/config
 
# Проверка изменений
grep ^SELINUX= /etc/selinux/config

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

reboot

После перезагрузки проверяем статус:

sestatus

После всего этого вы можете ввести http://localhost в адресной строке браузера, чтобы открыть страницу приветствия Сервер документов, где приводятся дальнейшие инструкции о том, как подключить примеры документов или интегрировать онлайн-редакторы в веб-приложение с помощью API.

2.7. Регистрация вашей версии Сервера документов

Если вы купили Сервер документов и получили файл license.lic, вы можете поместить его в инсталляцию для получения полной версии программы.

Если вы используете дистрибутив Linux на базе Red Hat, файл license.lic помещается в следующую папку: /var/www/r7-office/Data/license.lic.

Имя файла лицензии должно быть строго license.lic.

После этого ваша версия Сервер документов станет зарегистрированной и полнофункциональной.

2.8. Переключение Р7-Офис. Сервер Документов на HTTPS вручную

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

2.8.1. Создаем директорию

mkdir /var/www/r7-office/Data/ssl

Сертификат безопасности (.crt) и закрытый ключ сертификата (.key) необходимо поместить по пути /var/www/r7-office/Data/ssl:

2.8.2. Скопируйте файл ds-ssl.conf.tmpl в файл ds.conf с помощью следующей команды

sudo cp -f /etc/r7-office/documentserver/nginx/ds-ssl.conf.tmpl /etc/r7-office/documentserver/nginx/ds.conf

2.8.3. Отредактируйте файл

sudo nano /etc/r7-office/documentserver/nginx/ds.conf

В разделе HTTPS host изменить строки:

# закомментировать
#ssl on
ssl_certificate /var/www/r7-office/Data/ssl/имя_файла.crt;
ssl_certificate_key /var/www/r7-office/Data/ssl/имя_файла.key;

Необходимо сохранить файл.

2.8.4. Тестирование конфигурации командой

sudo nginx -t

Получаем вывод команды о успешной тестирования конфигурации:

2.8.5. Перезапуск nginx

service nginx restart

2.8.6. Выполните следующий скрипт для актуализации параметра

sudo bash /usr/bin/documentserver-update-securelink.sh

После данных действий проверьте доступность сервера в браузере, перейдя по установленному DNS имени в сети.

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

3.1. Системные требования для Р7 Диск

• Поддерживается только 64-битная архитектура;
• Процессор: рекомендуется от 2 ядер;
• Оперативная память: рекомендуется от 8 Гб;
• Свободное место на жестком диске: рекомендуется от 50 Гб;
• Операционная система из перечня поддерживаемых;
• Подключение к сети Интернет;
• Опционально: при использовании HTTPS требуется сертификат типа wildcard.

Минимальные системные требования рассчитаны при одновременной работе до 300 пользователей.

# Добавляем службу:
sudo firewall-cmd --permanent --zone=public --add-service=https
sudo firewall-cmd --permanent --zone=public --add-service=http
   
# Перезапускаем службу firewalld:
sudo firewall-cmd --reload
   
# Проверяем правила для зоны public:
sudo firewall-cmd --zone=public --list-all

3.1.1. Добавление репозитория

3.1.1.1. Откройте файл на редактирование

sudo nano /etc/yum.repos.d/r7server.repo

3.1.1.2. Добавьте следующий текст

[r7server]
name=r7server
baseurl=https://downloads.r7-office.ru/repository/r7-server-yum/
enabled=1
gpgcheck=1
gpgkey=https://download.r7-office.ru/repos/RPM-GPG-KEY-R7-OFFICE.public
sslverify=1
username=server
password=KwmuQmOzuFIw9wcJsL3zb

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

sudo yum makecache

3.1.2. Скачайте архив Р7-Диск для установки и положите его на ВМ

Рекомендуем, для корректной установки, архив разместите в директории, отличной от /root, например в /mnt или /tmp.

3.1.3. Заходим в директорию с архивом

cd /mnt

3.1.4. Распаковываем

unzip RedOS_*.zip

3.1.5. Выполните команду

sed -i "s/dnf install -y postgresql-client/dnf install -y postgresql/" CDDisk/install.sh

3.2. Установка Р7 Диск

3.2.1. Для SSL инсталляции

Для корректной работы Корпоративного сервера обязательно требуется настройка HTTPS. Перед установкой скопируйте crt и key файлы в папку sslcert.

Имя файла должно содержать название домена и расширение. Рекомендуем в .crt указывать всю цепочку сертификатов, домен, промежуточные и корневой.

3.2.2. Добавьте права на исполнение скрипту

chmod +x *.sh

3.2.3. Запустите установку

Если установка online:

sudo bash ./online_installer.sh

Если установка offline:

sudo bash ./offline_installer.sh

На запрос пароля для sudo ввести его.

3.2.4. В процессе установки

3.2.4.1. Чистая установка

Если требуется выполнить чистую установку (удалит имеющуюся инсталляцию Р7-Диск и зависимости):

• Выберите Да.

3.2.4.2. Установка СУБД на локальную ВМ

Для установки PostgreSQL (при инсталляции всё в одном) на локальный компьютер:

• Выберите Да.

Если PostgreSQL будет на другой ВМ, то:

• Выберите Нет.

3.2.4.3. Установка Сервера Документов

Сервер Документов находится на другой ВМ, то:

• Выберите Нет.

Также, необходимо сделать А-запись в DNS ds.r7.ru, где r7.ru — ваш домен.

Пример добавленной А-записи в DNS у провайдера Selectel указан на скриншоте:

3.2.4.3.1. Исправление ошибок Nginx

Для обхода данных ошибок выполните следующие шаги:

1. Конфигурацию /etc/nginx/nginx.conf приведите к виду:

user nginx;
worker_processes 1;
error_log /var/log/nginx/error.log warn;
pid /var/run/nginx.pid;
events {
worker_connections 1024;
}

http {
include /etc/nginx/mime.types;

map $http_x_forwarded_proto $the_scheme {
default $scheme;
"https" "https";
}

default_type application/octet-stream;
log_format main '3603remote_addr - 3603remote_user [3603time_local] "3603request" '
'3603status 3603body_bytes_sent "3603http_referer" '
'"3603http_user_agent" "3603http_x_forwarded_for"';
access_log /var/log/nginx/access.log main;
sendfile on;
keepalive_timeout 65;

include /etc/nginx/conf.d/*.conf;
include /etc/nginx/sites-enabled/*;
}

2. Далее выполните команды:

sudo sed -i 's/proxy_set_header Connection \$proxy_connection;/proxy_set_header Connection "";/g' /etc/nginx/sites-available/*
systemctl restart nginx

3.2.4.4. URL Сервера документов

Укажите URL и протокол, который вы присвоили серверу документов:

3.2.4.5. Секрет для DS и формирования JWT

Необходимо ввести секрет (Набор цифр, букв и спецсимволов. Длина от 8 символов) для защищённого доступа Р7-Диска и Сервера Документов.

Значение должно быть введено в формате Base64 и сохранено.

3.2.4.6. Установка api и web диска

Основное приложения Р7-Диска и веба (статика) сайта.

Для его установки:

• Выбрать Да.

3.2.4.7. Тип СУБД Р7-Диск

• Выбрать PostgreSQL.

3.2.4.8. Создание БД

Создать ли БД cddisk для работы приложения:

• Выбрать Да.

Если создание БД не требуется, и Вы её создали самостоятельно:

• Выбрать Нет.

3.2.4.9. Хост СУБД

При локальной установке:

• Выбрать Ок.

Если СУБД установлена отдельно:

• Указать IP-адрес или имя хоста.

3.2.4.10. Порт СУБД

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

3.2.4.11. Пользователь cddisk

Обязательно оставить по умолчанию cddisk:

• Нажать Ок.

3.2.4.12. Пароль для пользователя cddisk

Ввести (создать) пароль для пользователя cddisk:

3.2.4.13. coremachinkey от Корпоративного сервера

Изменить на актуальный, если есть Корпоративный сервер 2024 и нажмите Ок, если нет, нажмите Ок без редактирования:

3.2.4.14. Настройка https

• Выберите Да.

3.2.4.15. Укажите домен

Необходимо указать домен, в котором у вас созданы записи.

В значении указываем именно r7.ru, не созданную А-запись.

3.2.4.16. Префикс Р7-Диск

Указать имя, которое будет открываться в браузере для веб Р7-Диска.

Также, необходимо сделать соответствующую А-запись в DNS, пример в п.3.2.4.15.

3.2.4.17. Префикс Р7-Управление

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

Также, необходимо сделать соответствующую А-запись в DNS. Пример ниже:

3.2.4.18. Префикс Р7-Контакты

Указать имя, которое будет открываться в браузере для веб контакты.

Также, необходимо сделать соответствующую А-запись в DNS.

3.2.4.19. Префикс Р7-Проекты

Указать имя, которое будет открываться в браузере для «Проекты».

3.2.4.20. Префикс Р7-Страницы

Указать имя, которое будет открываться в браузере для «Страницы».

Также, необходимо сделать соответствующую А запись в DNS.

3.2.4.21. Префикс Р7-Формы

Указать имя, которое будет открываться в браузере для «Формы».

Также, необходимо сделать соответствующую А запись в DNS.

3.2.4.22. Префикс Р7-Почта

Указать имя, которое будет открываться в браузере для веб клиенты почты.

Также, необходимо сделать соответствующую А-запись в DNS. Пример ниже:

3.2.4.23. Префикс Р7-Календарь

Указать имя, которое будет открываться в браузере для веб календаря.

Также, необходимо сделать соответствующую А-запись в DNS. Пример ниже:

3.2.4.24. Префикс Р7-документ сервер

Указать имя, которое будет открываться в браузере для документ сервера.

Также, необходимо сделать соответствующую А-запись в DNS.

3.2.4.25. Установка Р7 Почтовый сервер

Рекомендуем, перед продолжением инсталляции, прописать записи в DNS, для работы почтового сервера.

Необходимо добавить А-запись (mx.your-domain.ru) и обратную запись, а также запись MX и TXT v=spf1 +mx ~all.

Пример:

MX r7.ru TTL Приоритет
mx.r7.ru 300 10
TXT r7.ru TTL
v=spf1+mx~all 300
A mx.vr7.ru TTL
33.195.16.110 300

Если вы выбрали установки без HTTPS, то, после инсталляции, почтовый сервер работать не будет.

Для его работы необходимо положить сертификаты по пути:

smtpd_tls_cert_file = /etc/nginx/ssl/r7.ru.crt
smtpd_tls_key_file = /etc/nginx/ssl/r7.ru.key

Где, r7.ru — имя вашего домена, который ввели в п.3.2.4.15.

Если требуется установка:

• Выберите Да.

Если не требуется установка:

• Выберите Нет.

3.2.4.26. Выберите базу данных

• Выбираем PostgreSQL.

3.2.4.27. Введите MX запись

Укажите имя MX записи, которая сделана или будет сделана в DNS, без домена.

3.2.4.28. Укажите IP-адрес

Укажите внешний IP-адрес сервера, для корректной работы почтового сервера.

Если указать приватный внутренний IP-адрес, то почта будет работать только внутри сети организации.

3.2.4.29. Пароль postfix для PostgreSQL

Укажите пароль для пользователя postfix, для действий в БД.

3.2.4.30. Установка SpamAssassin

Если требуется установка:

• Выберите 1.

Если не требуется установка:

• Выберите 2.

3.2.4.31. Установка OpenDKIM

Если требуется установка:

• Выберите Да.

Если не требуется установка:

• Выберите Нет.

После инсталляции в консоли будет предложено сделать TXT запись:

3.2.4.32. Перезагружаем систему

Для корректной работы Р7-Диска, требуется перезагрузка.

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

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

https://admin.example.ru/organizations/edit/1/mail-servers

Первоначальный данные для авторизации:

Логин: superadmin
Пароль: superadmin

Укажите настройки почтового сервера, для интеграции установите чек-бокс, добавьте значение в поле ключ:

Ключ можно найти в консоли после завершения инсталляции или в логе установки:

3.3. Интеграция Корпоративного сервера 2024 с вынесенным сервером документов

3.3.1. На сервере Корпоративного сервера 2024 в БД (postgresql) выведите информацию

sudo -i -u postgres psql cddisk (или psql -U postgres -d cddisk)
SELECT * FROM public."MessageSettings" WHERE "Key" = 'documentServerUrl';
SELECT * FROM public."MessageSettings" WHERE "Key" = 'apiUrlInternal';
SELECT * FROM public."MessageSettings" WHERE "Key" = 'files.docservice.secret'; - где потребуется сохранить значение files.docservice.secret

Далее обновите на новые значения командами:

UPDATE public."MessageSettings" SET "Value"='https://ds.r7o.ru' WHERE "Key" = 'documentServerUrl'; -- указав вместо https://ds.r7o.ru адрес вынесенного сервера документов (если адрес на вынесенном ДС одноименный - нет необходимости менять), для примера, указан в запросе - Value"='https://ds.r7o.ru'
UPDATE public."MessageSettings" SET "Value"='https://disk.r7o.ru' WHERE "Key" = 'apiUrlInternal'; -- указав вместо https://disk.r7o.ru полный адрес Корпоративного сервера 2024

Для выхода из БД введите:

\q

3.3.2. На вынесенном сервере документов укажите секрет из запроса

По значению ключа Key» = 'files.docservice.secret', в файле: /etc/r7-office/documentserver/local.json.

Пример:

"secret": {       
      "inbox": {
       "string": " "   // в кавычках указать ключ из селекта п. 3, по значению ключа "Key" = 'files.docservice.secret'       
   },
   "outbox": {
       "string": " "   // в кавычках указать ключ из селекта п. 3, по значению ключа "Key" = 'files.docservice.secret'
           },
   "session": {
       "string": " "   // в кавычках указать ключ из селекта п. 3, по значению ключа "Key" = 'files.docservice.secret'
           },

В /etc/hosts вынесенного Сервера документа укажите IP-адрес для Корпоративного сервера 2024 и Сервера документов, например:

192.168.26.223 disk.r7o.ru
127.0.0.1 ds.r7o.ru

Перезапустите сервис DS (на вынесенном сервере документов) и проверьте статусы сервисов:

systemctl restart ds-* --all
systemctl status ds-*

3.3.3. Перезапустите сервисы на Корпоративном сервере 2024

В /etc/hosts Корпоративного сервера 2024 измените запись ds в файле. Указать IP-адрес для Сервера документов, например:

192.168.26.116 ds.r7o.ru

Перезапустите сервисы на Корпоративном сервере 2024:

supervisorctl restart all

Проверьте открытие документов.