Установка сервера взаимодействия на Linux (debian-based)
Для установки и настройки сервера взаимодействия необходимо скачать с сервера 1С дистрибутивы:
- Сервер взаимодействия
- PostgreSQL 1C 12
- Liberica JRE 11
Установка liberica JRE выполняется путем скачивания deb-пакета с сайта 1С и его установки через консольную команду
dpkg -i bellsoft_jre*.deb
Установка PostgreSQL выполняется путем установки deb-пакетов и установки всех необходимых зависимостей.
После этого необходимо распаковать сервер взаимодействия и выполнить команду 1ce-installer(-cli) в зависимости от наличия \ отсутствия графического интерфейса.
После этого необходимо перейти в каталог /opt/1C/1CE/components/1c-enterprise-ring-0.19.5+12-x86-64 Далее необходимо создать новые инстансы connection server, hazelcast, elastic search следующими командами:
./ring elasticsearch instance create --dir /var/cs_instance/elastic ./ring elasticsearch --instance elastic service create --stopped ./ring elasticsearch --instance elastic service java-home set /usr/lib/jvm/bellsoft-java11-runtime-full-amd64 ./ring hazelcast instance create --dir /var/cs_instance/hazelcast ./ring hazelcast --instance hazelcast service create --stopped ./ring hazelcast --isntance hazelcast service java-home set /usr/lib/jvm/bellsoft-java11-runtime-full-amd64 ./ring cs instance create --dir /var/cs_instance/cs ./ring cs --instance cs service create --stopped ./ring cs --instance cs service java-home set /usr/lib/jvm/bellsoft-java11-runtime-full-amd64
Введенные команды создадут новые инстансы и службы для запуска соответствующих сервисов, пока не включенных. После этого необходимо настроить работу сервисов, выполняется так же через командную строку
Перед началом настройки базы данных для работы с сервером взаимодействия, должны быть выполнены следующие настройки:
● Создан пользователь, от имени которого сервер взаимодействия будет взаимодействовать с СУБД. Данный пользователь должен обладать правами создания базы данных. В дальнейшем для определения имени этого пользователя будет использовать cs_user. Пароль данного пользователя будет указываться как cs_user_pwd.
● Создана база данных, в которой будут храниться данные сервера взаимодействия. В качестве владельца этой базы должен выступать пользователь cs_user. В дальнейшем для определения базы данных будет использоваться cs_db.
● Сервер должен поддерживать аутентификацию по паролю.
Для базы данных cs_db следует подключить расширения uuid-ossp. Для этого необходимо выполнить следующую команду базы данных:
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
Необходимо выполнить настройку параметров JDBC-драйверов PostgreSQL:
ring cs --instance cs jdbc pools --name common set-params --url jdbc:postgresql://localhost:5432/cs_db?currentSchema=public ring cs --instance cs jdbc pools --name common set-params --username cs_user ring cs --instance cs jdbc pools --name common set-params --password cs_user_pwd ring cs --instance cs jdbc pools --name privileged set-params --url jdbc:postgresql://localhost:5432/cs_db?currentSchema=public ring cs --instance cs jdbc pools --name privileged set-params --username cs_user ring cs --instance cs jdbc pools --name privileged set-params --password cs_user_pwd
Для взаимодействия сервера взаимодействия и клиентского приложения используется протокол WebSocket. Для настройки работы этого протокола следует выполнить следующие действия:
ring cs --instance cs websocket set-params --hostname localhost ring cs --instance cs websocket set-params --port 9094
Далее необходимо установить minio для работы с файлами. Для этого необходимо выполнить следующие команды:
wget https://dl.min.io/server/minio/release/linux-amd64/minio
sudo mv ./minio /usr/local/bin/minio
sudo chmod +x /usr/local/bin/minio
sudo chmod 777 /mnt
После этого нужно создать файл сервиса /etc/systemd/system/minio.service со следующим содержимым:
[Unit]
Description=MinIO
Documentation=https://docs.min.io
Wants=network-online.target
After=network-online.target
AssertFileIsExecutable=/usr/local/bin/minio
AssertFileNotEmpty=/etc/default/minio
[Service]
Type=notify
WorkingDirectory=/usr/local/
User=adminuser
Group=adminuser
ProtectProc=invisible
EnvironmentFile=/etc/default/minio
ExecStartPre=/bin/bash -c "if [ -z \"${MINIO_VOLUMES}\" ]; then echo \"Variable MINIO_VOLUMES not set in /etc/default/minio\"; exit 1; fi"
ExecStart=/usr/local/bin/minio server $MINIO_OPTS $MINIO_VOLUMES
# Let systemd restart this service always
Restart=always
# Specifies the maximum file descriptor number that can be opened by this process
LimitNOFILE=1048576
# Specifies the maximum number of threads this process can create
TasksMax=infinity
# Disable timeout logic and wait until process is stopped
TimeoutStopSec=infinity
SendSIGKILL=no
[Install]
WantedBy=multi-user.target
А также файл /etc/default/minio со следующим содержимым:
# Set the hosts and volumes MinIO uses at startup
# The command uses MinIO expansion notation {x...y} to denote a
# sequential series.
#
# The following example covers four MinIO hosts
# with 4 drives each at the specified hostname and drive locations.
# The command includes the port that each MinIO server listens on
# (default 9000)
MINIO_VOLUMES="http://localhost:9000/mnt/minio"
# Set all MinIO server options
#
# The following explicitly sets the MinIO Console listen address to
# port 9001 on all network interfaces. The default behavior is dynamic
# port selection.
MINIO_OPTS="--console-address :9001"
# Set the root username. This user has unrestricted permissions to
# perform S3 and administrative API operations on any resource in the
# deployment.
#
# Defer to your organizations requirements for superadmin user name.
MINIO_ROOT_USER=minioadmin
# Set the root password
#
# Use a long, random, unique string that meets your organizations
# requirements for passwords.
MINIO_ROOT_PASSWORD=13746533
# Set to the URL of the load balancer for the MinIO deployment
# This value *must* match across all MinIO servers. If you do
# not have a load balancer, set this value to to any *one* of the
# MinIO hosts in the deployment as a temporary measure.
MINIO_SERVER_URL="http://localhost:9000"
Установка службы выполняется командой systemctl enable minio.service, после этого можно запустить службу через service minio start
Далее необходимо зайти в консоль управления через браузер по адресу http://localhost:9001, войти под логином и паролем и создать bucket с именем csb.
После этого нужно запустить службы сервера взаимодействия следующими командами:
service 1ce-elastic start
service 1ce-hazelcast start
service 1ce-cs start
После успешной установки и настройки сервера взаимодействия необходимо инициализировать базу данных сервера. Команда инициализации выглядит следующим образом:
curl -Sf -X POST -H "Content-Type: application/json" -d "{ \"url\" : \"jdbc:postgresql://localhost:5432/cs_db\", \"username\" : \"cs_user\", \"password\" : \"13746533\", \"enabled\" : true }" http://localhost:8087/admin/bucket_server
Для подключения хранилища необходимо выполнить следующий скрипт в базе cs_db:
INSERT INTO public.storage_server(id, type, base_url, container_url, container_name, region, access_key_id, secret_key, signature_version, is_deleted, upload_limit, download_limit, file_size_limit, created_at, updated_at, cdn_url, cdn_key_id, cdn_secret_key, state, cdn_enabled, path_style_access_enabled, bytes_to_keep, days_to_keep, pricing_url, api_type, storage_type, files_to_keep)
VALUES(
uuid_generate_v4(), 'AMAZON', 'http://localhost:9000','http://localhost:9000/${container_name}',
'csb',
'',
'LOGIN_MINIO',
'PASS_MINIO',
'V4', false, 1073741824, 1073741824, 104857600, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP, NULL, NULL, NULL, 'ACTIVE', false, true, 0, 0, NULL, 'AMAZON', 'DEFAULT', 31);
Где LOGIN_MINIO и PASS_MINIO - параметры подключения к http://localhost:9001