Развертывание Linux сервера с community-версией платформы

Зачем?

До выхода платформы 1С:Предприятия версии 8.3.23 бесплатно можно было использовать только учебную версию платформы со значительными техническими ограничениями (не более одного сеанса, только файловый вариант, нет возможностей печати и сохранения документов и т.д.).

В версии 8.3.23 появилась Community-лицензия, которая позволяет использовать платформу для обучения, разработки и отладки бесплатно без ограничений по функциональности и в том числе в клиент-серверном режиме работы.

При разработке для клиент-серверного режима часто допускаются ошибки, связанные с работой клиента и сервера на одной машине (самая частая - использование пути в файлу на клиенте в контексте сервера). Поэтому, для максимально приближенному к реальному сценарию эксплуатации, развернем клиент и сервер на разных машинах с помощью community-лицензии. На физической (хост) машине будем запускать клиент, а в качестве сервера используем виртуальную машину.

В качестве гостевой ОС на виртуальной машине будем использовать CentOS 7, в качестве СУБД PosgreSQL. Эта комбинация часто используется на внедрениях.

Ограничения

На текущий момент версия 8.3.23 является тестовой, поэтому ее скачивание доступно только при наличии соответствующего доступа к ИТС.

Для активации community-лицензии необходима учетная запись на портале developer.1c.ru

Описанная схема потребует 2 активаций community-лицензии. Всего для 1 учетной записи доступно не более 3 одновременных активаций.

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

Описание сценария рассчитано на опытного пользователя Windows, базово знакомого с ОС Linux. Если какие-то аспекты непонятны - задавайте вопросы в комментариях. Постараюсь ответить или дополнить статью.

Подготовка дистрибутивов

1. Скачиваем и устанавливаем VirtualBox https://www.virtualbox.org/
2. Скачиваем CentOS 7 x86_64 Minimal https://www.centos.org/download/
3. Скачиваем дистрибутив платформы x64 8.3.23.1437 для Linux и для Windows
4. Скачиваем и устанавливаем WinSCP (для удобной работы с файловой системой ВМ)
5. Скачиваем и устанавливаем SSH-клиент (Putty или расширения для Chrome "Secure Shell")

Создание и первичная настройка виртуальной машины

1. Запускаем VirtualBox
2. Создаем виртуальную машину (ВМ) из образа CentOS
3. Устанавливаем ОС по умолчанию, устанавливаем пароль для root, создаем первого пользователя администратора с логином admin. Обязательно запомните или запишите оба пароля, дальнейшая настройка без них будет невозможна.
4. Настраиваем сеть для ВМ, нам необходимо, чтобы она была доступа по сети с хост-машины:
   • Выключаем машину

   shutdown now

   • Заходим в настройки ВМ / Сеть, на закладке Адаптер 2 включаем сетевой адаптер, переключаем Тип подключения на Виртуальный адаптер хоста
   • Включаем машину
   • Выполняем команду ip a, смотрим присвоенный ip-адрес в последнем адаптере
5. Настраиваем выход в интернет для ВМ:
   • Проверяем доступность интернета с ВМ коман дой ping ya.ru, если пинг есть, то этот пункт можно пропустить
   • Подключаемся к машине через WinSCP по ip-адресу 
   • Открываем файл /etc/sysconfig/network-scripts/ifcfg-enp0s3 в блокноте или другом текстовом редакторе
   • Меняем значение ONBOOT=no на ONBOOT=yes
   • Перезапускаем службу сети systemctl restart network
6. Далее для удобства ввода команд удобнее подключиться через SSH-клиент. Если используем расширение для Chrome, то надо ввести ssh, пробел, admin@[ip-адрес]
7. Обновляем пакетный менеджер

   sudo yum update
   sudo yum upgrade

8. Проверяем локаль locale, если отличная от "ru_RU.UTF-8", то выполняем команду localectl set-locale LANG=ru_RU.UTF-8 и перелогиниваемся
9. Через WinSCP открываем файл /etc/selinux/config и меняем значение SELINUX=enforcing на SELINUX=disabled
10. Устанавливаем репозиторий epel

    sudo yum install -y epel-release

11. Устанавливаем необходимые для работы платформы библиотеки и шрифты

    sudo yum install ImageMagick
    sudo yum install https://disweb.ru/files/rpm/compat-libtermcap-2.0.8-49.el6.x86_64.rpm
    sudo yum install https://disweb.ru/files/rpm/compat-readline5-5.2-17.1.el6.x86_64.rpm
    sudo yum install https://disweb.ru/files/rpm/fonts-ttf-ms-1.0-eter4centos.noarch.rpm

12. Настраиваем имя виртуальной машины

    hostnamectl set-hostname your-new-hostname

13. Прописываем имя виртуальной машины в hosts. Через WinSPC открываем файл /etc/hosts. В строчку, которая начинается с 127.0.0.1 добавляем пробел и имя виртуальной машины your-new-hostname
14. Делаем снимок ВМ средствами VirtualBox, чтобы в случае возникновения проблем далее можно было откатиться на эту точку 

Установка платформы 1С:Предприятие 

1. Устанавливаем на хост-машину платформу из дистрибутива для Windows. Обязательные компоненты: 1С:Предприятие 8, Модули расширения веб-сервера, Администрирование сервера 1С:Предприятия
2. Устанавливаем на ВМ платформу из дистрибутива для Linux.
   • С помощью WinSCP создаем новый каталог "/home/admin/distrib/" и переносим в него файлы платформы для Linux
   • С помощью SSH-клиента переходим в созданный каталог cd /home/admin/distrib/
   • Распаковываем платформу sudo tar -x -f server64_8_3_23_1437.tar.gz
   • Запускаем установку платформы

   sudo chmod +x setup-full-8.3.23.1437-x86_64.run
   sudo ./setup-full-8.3.23.1437-x86_64.run --mode unattended --enable-components client_full,client_thin_fib,liberica_jre,server,ws,server_admin

3. Добавляем службу сервера платформы

   sudo ln /opt/1cv8/x86_64/8.3.23.1437/srv1cv8-8.3.23.1437@{,default}.service
   sudo systemctl link /opt/1cv8/x86_64/8.3.23.1437/srv1cv8-8.3.23.1437@default.service
   systemctl enable srv1cv8-8.3.23.1437@default.service
   systemctl start srv1cv8-8.3.23.1437@default.service

4. Проверяем работу службы сервера 1С:Предприятие командой systemctl status srv1cv8-8.3.23.1437@default.service. При корректной настройке среди выведенных строк должно быть Active: active (running)
5. Добавляем порты платформы в исключение файрвола:

   sudo firewall-cmd --zone=public --add-port=1540-1541/tcp --permanent
   sudo firewall-cmd --zone=public --add-port=1560-1591/tcp --permanent
   sudo firewall-cmd --reload

6. Проверяем доступность сервера с хост-машине (действия выполняем на хост-машине)
   • Запускаем консоль кластера серверов 1С:Предприятия C:\Program Files\1cv8\common\1CV8 Servers (x86-64).msc
   • Должен быть добавлен центральный сервер и локальный кластер внутри
7. Делаем снимок ВМ средствами VirtualBox, чтобы в случае возникновения проблем далее можно было откатиться на эту точку

Установка графики и активация лицензии на сервере

1. Через SSH-клиент устанавливаем пакеты GNOME:

   sudo yum -y groups install "GNOME Desktop"
   echo "exec gnome-session" >> ~/.xinitrc    

2. Через VirtualBox интерактивно открываем ВМ и выполняем команду startx
3. Запускаем терминал и устаналиваем GNOME графическим интерфейсом по умолчанию:

   systemctl set-default graphical.target    

4. Далее через терминал запускаем платформу 1С:Предприятие

   sudo /opt/1cv8/x86_64/8.3.23.1437/1cv8

5. Создаем файловую базу. Выбираем добавить базу в список, Включение в список ранее созданноой информационной базы устанавливаем название и путь для хранения (желательно в каталоге /home/admin/)
6. Запускаем конфигуратор для созданной файловой базы
7. Выбираем Активировать комьюнити-лицензию и вводим данные от developer.1c.ru
8. Делаем снимок ВМ средствами VirtualBox, чтобы в случае возникновения проблем далее можно было откатиться на эту точку

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

1. Через SSH-клиент запускаем установку сервера

   sudo wget https://repo.postgrespro.ru/1c-14/keys/pgpro-repo-add.sh
   sudo sh pgpro-repo-add.sh
   sudo yum install postgrespro-1c-14

2. Устанавливаем пароль для пользователя postgres sudo passwd postgres. Запомните или запишите пароль, он потребуется на следующих шагах.
3. Переходим под пользователя postgres su - postgres
4. Запускаем Postgre

   psql    

5. Создаем пользователя для платформы 1С:Предприятие. В тексте скрипта замените password на ваш пароль, который надо записать или запомнить. Далее он будет использоваться при создании информационных баз.

   create user pg1cv8 with superuser;
   alter user pg1cv8 password 'password';  

Создание информационной базы и активация лицензии на клиенте

1. Пересоздаем локальный кластер (возможно ошибка или нужно устанавливать имя хоста раньше)
   • Запускаем консоль управления кластером
   • Удаляем локальный кластер
   • Создаем кластер с именем "Локальный кластер", комьютером - ip-адрес ВМ, Портом - 1541
2. На хост-машине запускаем консоль управления кластером и создаем информационную базу:
   • Имя: demo
   • Сервер баз данных: localhost
   • Тип СУБД: PostgreSQL
   • База данных: demo
   • Пользователь сервера БД: pg1cv8
   • Пароль пользователя БД: [Ваш пароль, введенный ранее]
   • Создать базу данных: Да
   • Установить блокировку регламентных заданий: Да
3. На хост-машине добавляем в список серверную базу, которую только что создали.
4. Запускаем конфигуратор, активируем комьюнити-лицензию на хост-машине.

Включение отладки на сервере

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

   sudo systemctl edit srv1cv8-8.3.23.1437@default.service     

2. Добавляем в файл строки для включения отладки и сохраняем файл

   [Service]
   Environment=SRV1CV8_DEBUG=-debug
   

3. Перезапускаем службу с обновлением параметров

   sudo systemctl stop srv1cv8-8.3.23.1437@default
   sudo systemctl daemon-reload
   sudo systemctl start srv1cv8-8.3.23.1437@default
   

4. Проверяем состояние службы, в описании процесса rphost должны быть флаги -debug -tcp

   sudo systemctl status srv1cv8-8.3.23.1437@default
   

5. Проверяем работу отладки в конфигураторе. Если в списке предметов отладки видно серверный сеанс, но точки останова не срабатывают, то вероятнее всего подключение блокирует брадмауэр на хост машине. Для проверки можно его временно отключить. Если после этого отладка заработает, то необходимо включить обратно и настроить исключения на нужные порты и сети.

В результате у нас развернут сервер на линуксе, клиент на Windows. Машины разные, поэтому можно будет в полностью честной среде отлаживать клиент-серверное взаимодействие (у каждой машины своя файловая система). При необходимости публикации на веб-сервере на хост-машине можно поставить Apache и опубликовать базу через конфигуратор.

Дополнительные материалы:

1. Стрим с разбором установки по описанному сценарию.
2. Подкасты Никиты Зайцева про виртуализацию: Настольная виртуальная машина и Пример быстрого развертывания настольной виртуализации