Введение

UCS Common Server – основа микросерверной архитектуры компании UCS. Он предназначен для связи различных модулей ПО UCS друг с другом. Любой модуль ПО UCS публикует на Common Server свой GUID и URL. Другие модули продуктов UCS могут установить связь с этим модулем.

Службы и приложения UCS, которые могут устанавливать связь с Common Server, называют Feature Server. По технологии Feature Server на данный момент работают несколько модулей ПО UCS: RK7 MenuBoard, RK7 SecondScreen, Репликация R-Keeper CRM 507, TimeKeeper, интерактивные отчёты (ИА) и другие. Если в состав какого-то ПО входит несколько Feature Server, то все они работают с одним Common Server, используя его для связи друг с другом.

При недоступности Common Server любой из пытающихся соединится с ним Feature Server пишет в лог ошибку, в которой говорится о недоступности Common Server.

В процессе работы Feature Server периодически обновляет свою регистрацию на Common Server. Если  Feature Server не обновит регистрацию за определенный промежуток времени, Common Server прекращает работу с ним и удаляет его из списка Feature Server'ов. Таким образом, при попытке какого-то из Feature Server связаться с незарегистрированным на Common Server Server'ом, Common Server вернёт ошибку о недоступности Feature Server.

Common Server необходим для управления серверами Feature Server.

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

Инсталлятор и деинсталлятор лежат на FTP: ftp://ftp.ucs.ru/rk7/other/UCS_CS/, либо могут быть в дистрибутиве ПО, работающего с Feature Server. Скачайте инсталлятор и сохраните в удобное место. Запустите файл CSSetup.exe и следуйте инструкции по шагам.


Укажите пусть установки

Назовите экземпляр Common Server'a

Укажите порт, на котором будет работать сервер. Подойдёт любой свободный.
По умолчанию порт 7007.

Укажите порт для SSL-подключения. 
 

Если у вас нет сертификатов, не используйте настройку Использовать SSL.

Выберите необходимый уровень логирования.

Рекомендуем устанавливать Common Server как службу. 

Нажмите Установить для начала установки.
После завершения вы увидите окно:
Которое значит, что Common Server установился и всё в порядке.
Feature Server сам подключается к Common Server. Если вы запустили Common Server после Feature Server - нажмите кнопку Registration on Common Server.

Настройка параметров 

Сервер при установке создаёт файл настроек – CS_Service.ini, где хранятся все параметры. По-умолчанию он выглядит так:

[CS_CONNECTION]
connect_timeout(s)=30
receive_timeout(s)=30
send_timeout(s)=30
compression=c_Base64_ZLib
def_port=7007
SSL_port=7008
db_path=V:\Program Files (x86)\UCS\CommonServer\CommonServer7007\UCS.csdb

[CS]
Name=CS_CommonServer7007
loglevel=0
Log_level=3
i_guid={E35D7CBF-D999-4BED-AAC4-F5C876B6C6A5}
certificate_path=V:\Program Files (x86)\UCS\CommonServer\CommonServer7007\
Root_Cert_File=ca.cer
Cert_File=work.cer
Key_File=work.key
Вы можете менять эти параметры по желанию.

Описание параметров

  1. def_port – HTTP-порт сервера. По умолчанию – 7007, SSL – 7008
  2. i_guid – GUID экземпляра сервера
  3. certificate_path – полный путь к папке с HTTPS-сертификатами
  4. db_path – путь рабочей базы данных SQlite
  5. SSL_port – HTTPS-порт сервера
  6. connect_timeout(s), receive_timeout(s)send_timeout(s) – таймауты соединения
  7. compression – по-умолчанию используестя сжатие c_Base64_ZLib
    Параметр может иметь только следующие значения:

    1. c_Base64
    2. c_Base64_LZ
    3. c_Base64_ZLib

Примеры

Корректно работающий Common Server выглядит так:

Корректно работающий Feature Server выглядит так: