Windows редакция

Основное окно конфигуратора:

Элементы управления:

• Закрыть - закрывается окно конфигуратора сервиса. При этом сервис остается в рабочем состоянии. Чтобы остановить сервис необходимо повторно открыть конфигуратор и воспользоваться кнопкой Остановить сервис.
• Стартовать сервис - сервис регистрируется в операционной системе как служба и запускается. Кнопка изменяет вид на . При нажатии на нее сервис будет остановлен.
• Тип конфигурации  - пошаговое создание новой конфигурации. Подробнее.
• Сервер в сети  - установка протокола обмена (HTTP, HTTPS). Подробнее.
• База данных Парус 8  - объявление базы данных, пользователя и пароля для доступа. Подробнее.
• Распределение соединений - распределение соединений в соответствии количеством доступных лицензий. Подробнее.
• Дополнительные возможности  - настройка протоколирования событий сервера (в файл, в БД). Подробнее.
• О программе / Проверка наличия обновлений - Показ диалогового окна "О программе" со сведениями о текущей версии, в котором можно проверить наличие новых версий сервиса на сайте разработчика. Подробнее.

Linux редакция

При запуске конфигуратора будет показана его версия и дата сборки, информация о текущем состоянии сервиса, а также основное меню действий:

• Создание/изменение конфигурации – пошаговое создание новой или изменение существующей конфигурации 
• Запустить сервис – регистрация сервиса в операционной системе как службы и ее запуск
• Остановить сервис – остановка службы сервиса
• Разрегистрировать сервис – разрегистрация службы сервиса из операционной системы
• Проверить наличие обновлений

Кстати

Для перехода между действиями, возврата к предыдущему меню или выходу из конфигуратора можно использовать комбинацию клавиш Ctrl+C.

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

В главном окне нажать значок "Тип конфигурации":

При наличии существующей конфигурации будет задан вопрос об ее использовании или начале новой конфигурации:

При выборе "Yes" ("Да") - вводимые настройки будут применяться к существующей конфигурации.

При выборе "No" ("Нет") - будет создана новая конфигурация сервера.

"Cancel" ("Отмена") - будет осуществлен возврат к предыдущему шагу настроек.

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

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

В окне прописываются доменные имена серверов (узлов кластера), на которые кластер должен перенаправлять запросы удаленных пользователей, а также вероятность перенаправления. На скриншоте-примере указаны три сервера с определенными доменными именами. При этом на сервер svody3.svody.ru будет перенаправляться 50% запросов, а на другие два по 25%. Это может быть связано с большей производительностью третьего сервера.

Установка флага "Автоматическая балансировка" позволяет распределять нагрузку на узлы кластер в автоматическом режиме. Балансировка возможна по времени отклика, по количеству сессий или по количеству соединений. Для выполнения автоматической балансировки серверу необходимо обладать информацией о текущей нагрузке на каждом из узлов кластера, для этого контроллер будет с указанной периодичностью опрашивать узлы. Для получения информации о текущей нагрузке, контроллеру необходимо авторизоваться на этих узлах используя указанные данные пользователя ОС Windows или Linux, который должен входить в группу "Администраторы". В случае с Windows это одноименная группа "Администраторы", в случае с Linux это группа wheel (для Red Hat и производных) или sudo (для Ubuntu и производных).

После того как будут заданы все узлы кластера, необходимо нажать ссылку "Завершить". Будет предложено сохранить изменения. Настройка контроллера кластера на этом завершена и необходимо перейти к настройке  узлов кластера.

Работа

Самостоятельный сервер / Узел кластера - данный вариант используется в случае если не планируется большое количество одновременных подключений удаленных пользователей или настраивается конкретный узел кластера.

После выбора данного пункта будет запущена пошаговая процедура настройки конфигурации.

Следующий шаг

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

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

- Протокол обмена данными  - HTTP

- Номер порта TCP - 80

- Время ожидания после старта системы - 0 сек

- Время бездействия сессии - 3600 сек

- Повторно использовать сессии - включено

- Сжимать трафик - включено

- Рабочий каталог (стартовая страница) - путь на жестком диске, указанный при установке Сервиса

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

- Без протоколирования

Работа

Для установки сетевых настроек нажмите

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

Доступны два варианта:

1. HTTP - стандартный протокол обмена данными через интернет
2. HTTPS - защищенный протокол обмена данными через интернет

Настройки для HTTP:

- Порт TCP: указывает номер порта TCP/IP, который будет прослушиваться сервисом для приема входящих запросов на всех имеющихся на момент старта сервиса в системе сетевых интерфейсах. Поскольку сервис реализует протокол HTTP, то рекомендуется использовать порт 80. В случае, если Web-сервер использует третье стороннее серверное программное обеспечение (Microsoft IIS, Apache, и т. п.), которое обслуживает 80 порт (и "занимает" его), то необходимо использовать порт, отличный от 80 (и при этом свободный). Обращаться к сервису в таком случае необходимо, указывая порт в строке адреса после двоеточия. При помощи команды Windows netstat можно узнать текущее состояние портов TCP.

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

- Время ожидания после старта службы: определяет количество секунд, в течение которых сервис будет ожидать завершения инициализирующих действий других компонент системы, после чего приступит к собственной инициализации. В случае, если web-сервер и сервер БД установлены на одной машине, то необходимо дождаться перехода БД в состояние "open", прежде, чем открывать сессии Oracle и приступать к обработке запросов удаленных пользователей. Время, необходимое для этого, нужно выразить в секундах и задать в значении этого параметра.

- Время бездействия сессии: определяет количество секунд, в течение которых сессия веб сервера (серверный объект, владеющий информацией о состоянии удаленного подключения) сохраняется в памяти сервера в случае отсутствия активности удаленного пользователя. После истечения этого времени сессия будет уничтожена вместе со всей несохраненной клиентом информацией (в том числе и аутентификационной). Категорически не рекомендуется устанавливать это значение меньше, чем 300 секунд (5 минут). Значение по умолчанию - 3600 секунд (1 час). Все ненулевые значения, меньшие 60, трактуются как 60 секунд.

- Время бездействия сессии Парус 8: устанавливает ограничение по времени бездействия в секундах, во время создания веб сессии Парус 8 в БД. Значение по умолчанию, соответствует времени бездействия сессии веб сервера. При использовании значения 0 - ограничение на время бездействия не накладывается. Но во время завершения сессии веб сервера по истечению времени бездействия, сессия Парус 8 автоматически также будет завершена. То же самое касается случая, когда значение времени бездействия сессии Парус 8, будет превышать время бездействия сессии сервера приложений. Все ненулевые значения, меньшие 60, трактуются как 60 секунд. Используемые значения конкретных сессий можно увидеть в интерфейсе Парус 8 - Администратор -> Учет -> Управление сеансами.

- Повторно использовать сессии: позволяет не пере-открывать соединения после каждого обмена "запрос-ответ" между клиентом и сервером. Повторно используются соединения только в том случае, если такие соединения поддерживаются клиентом и сервером согласованно. Время ожидания нового запроса на зарезервированном соединении составляет 75 секунд. Рекомендуется выключать этот параметр при обслуживании более 300 одновременных соединений, поскольку слишком большой ресурс сервера начинает тратиться на проверку состояния зарезервированных соединений, что отрицательно сказывается на производительности системы в целом.

- Сжимать трафик: позволяет серверу использовать сжатие передаваемых данных. Сжатие применяется только в том случае, если браузер удаленного клиента способен корректно обрабатывать сжатые данные. Для сжатия трафика используется библиотека zlib. Минимальная тестированная на совместимость версия - 1.0.4, она включается в стандартную поставку сервиса.

- Отключать алгоритм Nagle для соединений: Выключает алгоритм Nagle для TCP соединений, путем включения опции TCP_NO_DELAY у сокетов. Данная опция будет работать только при включенной опции "Повторно использовать сессии".

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

Настройки для HTTPS:

- Порт TCP: указывает номер порта TCP/IP, который будет прослушиваться сервисом для приема входящих запросов на всех имеющихся на момент старта сервиса в системе сетевых интерфейсах. Поскольку сервис реализует протокол HTTPS, то рекомендуется использовать порт 443. В случае, если Web-сервер использует третье стороннее серверное программное обеспечение (Microsoft IIS, Apache, и т. п.), которое обслуживает 443 порт (и "занимает" его), то необходимо использовать порт, отличный от 443 (и при этом свободный). Обращаться к сервису в таком случае необходимо, указывая порт в строке адреса после двоеточия. При помощи команды Windows netstat можно узнать текущее состояние портов TCP.

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

- Время ожидания после старта службы: определяет количество секунд, в течение которых сервис будет ожидать завершения инициализирующих действий других компонент системы, после чего приступит к собственной инициализации. В случае, если web-сервер и сервер БД установлены на одной машине, то необходимо дождаться перехода БД в состояние "open", прежде, чем открывать сессии Oracle и приступать к обработке запросов удаленных пользователей. Время, необходимое для этого, нужно выразить в секундах и задать в значении этого параметра.

Полезные цифры
1/2 минуты	30 секунд
1 минута	60 секунд
2 минуты	120 секунд
3 минуты	180 секунд
5 минут	300 секунд
10 минут	600 секунд

- Время бездействия сессии: определяет количество секунд, в течение которых сессия веб сервера (серверный объект, владеющий информацией о состоянии удаленного подключения) сохраняется в памяти сервера в случае отсутствия активности удаленного пользователя. После истечения этого времени сессия будет уничтожена вместе со всей несохраненной клиентом информацией (в том числе и аутентификационной). Категорически не рекомендуется устанавливать это значение меньше, чем 300 секунд (5 минут). Значение по умолчанию - 3600 секунд (1 час). Все ненулевые значения, меньшие 60, трактуются как 60 секунд.

- Время бездействия сессии Парус 8: устанавливает ограничение по времени бездействия в секундах, во время создания веб сессии Парус 8 в БД. Значение по умолчанию, соответствует времени бездействия сессии веб сервера. При использовании значения 0 - ограничение на время бездействия не накладывается. Но во время завершения сессии веб сервера по истечению времени бездействия, сессия Парус 8 автоматически также будет завершена. То же самое касается случая, когда значение времени бездействия сессии Парус 8, будет превышать время бездействия сессии сервера приложений. Все ненулевые значения, меньшие 60, трактуются как 60 секунд. Используемые значения конкретных сессий можно увидеть в интерфейсе Парус 8 - Администратор -> Учет -> Управление сеансами.

Полезные цифры
1/2 часа	1800 секунд
1 час	3600 секунд
3/2 часа, полтора часа	5400 секунд
2 часа	7200 секунд
3 часа	10800 секунд
Сутки	86400 секунд
Неделя	604800 секунд

- Повторно использовать сессии: позволяет не пере-открывать соединения после каждого обмена "запрос-ответ" между клиентом и сервером. Повторно используются соединения только в том случае, если такие соединения поддерживаются клиентом и сервером согласованно. Время ожидания нового запроса на зарезервированном соединении составляет 75 секунд. Рекомендуется выключать этот параметр при обслуживании более 100 одновременных соединений, поскольку слишком большой ресурс сервера начинает тратиться на проверку состояния зарезервированных соединений, что отрицательно сказывается на производительности системы в целом.

- Сжимать трафик: позволяет серверу использовать сжатие передаваемых данных. Сжатие применяется только в том случае, если браузер удаленного клиента способен корректно обрабатывать сжатые данные. Для сжатия трафика используется библиотека zlib (http://www.zlib.net/), включается в стандартную поставку сервиса.

- Отключать алгоритм Nagle для соединений: Выключает алгоритм Nagle для TCP соединений, путем включения опции TCP_NO_DELAY у сокетов. Данная опция будет работать только при включенной опции "Повторно использовать сессии".

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

- Сертификат центра сертификации: путь к файлу сертификата центра сертификации в pem-формате.

- Сертификат домена: путь к файлу сертификата домена в pem-формате.

- Закрытый ключ:  путь к файлу закрытого/приватного ключа, от сертификата домена.

- Пароль закрытого ключа: необязательный параметр, пароль от закрытого ключа сертификата.

- Набор шифров для TLS 1.2 и ранее: необязательный параметр, если оставить пустым, то будет использоваться набор шифров по умолчанию.

На данный момент, значение по умолчанию: EECDH+ECDSA+AESGCM EECDH+aRSA+AESGCM EECDH+ECDSA+SHA384 EECDH+ECDSA+SHA256 EECDH+aRSA+SHA384 EECDH+aRSA+SHA256 EECDH+aRSA EECDH EDH+aRSA !aNULL !eNULL !LOW !3DES !MD5 !EXP !PSK !SRP !DSS !RC4).
Указанные шифры будут использоваться между веб сервером и клиентом (клиент имеет свой набор поддерживаемых шифров), если при начале взаимодействия они найдут общие алгоритмы, доступные каждому из них.
Порядок указания шифров важен, т.к. проверка возможности применения шифра осуществляется слева на право, в том порядке, в котором они выписаны.

В умолчательный список не входят шифры с ГОСТ алгоритмами, поэтому в случае необходимости их поддержки (при использовании сертификата с ГОСТ алгоритмом шифрования) требуется их туда включить.
Например, для поддержки:
  - только ГОСТ 2012 (и ничего больше), требуется указать: GOST2012-GOST8912-GOST8912
  - всех версий ГОСТ (начиная с 89 и до 2012 включительно), требуется указать: GOST2012-GOST8912-GOST8912 GOST2001-GOST89-GOST89 GOST94-GOST89-GOST89
  - набор шифров по умолчанию + ГОСТ 2012, требуется указать: EECDH+ECDSA+AESGCM EECDH+aRSA+AESGCM EECDH+ECDSA+SHA384 EECDH+ECDSA+SHA256 EECDH+aRSA+SHA384 EECDH+aRSA+SHA256 EECDH+aRSA EECDH EDH+aRSA GOST2012-GOST8912-GOST8912 !aNULL !eNULL !LOW !3DES !MD5 !EXP !PSK !SRP !DSS !RC4)

Данный параметр применяется только для протокола TLS 1.2 и более ранних версий, т.е. если сервер и клиент для взаимодействия выбрали данные протоколы.

- Набор шифров для TLS 1.3+: необязательный параметр. По смыслу, данный параметр полностью идентичен "Набор шифров для TLS 1.2 и ранее", но он применим только для протокола TLS 1.3 и последующих версий, т.е. если сервер и клиент для взаимодействия выбрали данный протокол.

На данный момент, значение по умолчанию: TLS_AES_256_GCM_SHA384 TLS_CHACHA20_POLY1305_SHA256 TLS_AES_128_GCM_SHA256.

В умолчательный список, как и в случае с параметром для TLS 1.2, не входят шифры с ГОСТ алгоритмами, поэтому в случае необходимости их поддержки, требуется их туда включить.
Для поддержки ГОСТ 2015 определены следующие шифры: TLS_GOSTR341112_256_WITH_KUZNYECHIK_MGM_L, TLS_GOSTR341112_256_WITH_MAGMA_MGM_L, TLS_GOSTR341112_256_WITH_KUZNYECHIK_MGM_S, TLS_GOSTR341112_256_WITH_MAGMA_MGM_S.

В таком случае, для поддержки ГОСТ 2015: 
  - только ГОСТ 2015 (и ничего больше), требуется указать: TLS_GOSTR341112_256_WITH_KUZNYECHIK_MGM_L TLS_GOSTR341112_256_WITH_MAGMA_MGM_L TLS_GOSTR341112_256_WITH_KUZNYECHIK_MGM_S TLS_GOSTR341112_256_WITH_MAGMA_MGM_S
  - набор шифров по умолчанию + ГОСТ 2015, требуется указать: TLS_AES_256_GCM_SHA384 TLS_CHACHA20_POLY1305_SHA256 TLS_AES_128_GCM_SHA256 TLS_GOSTR341112_256_WITH_KUZNYECHIK_MGM_L, TLS_GOSTR341112_256_WITH_MAGMA_MGM_L, TLS_GOSTR341112_256_WITH_KUZNYECHIK_MGM_S, TLS_GOSTR341112_256_WITH_MAGMA_MGM_S

Про процесс получения SSL-сертификата написано здесь.

Особенности специфичные для Linux редакции описаны с соответствующем разделе.

При необходимости переадресации с каких-либо TCP портов и http(s) протоколов, на фактически используемый порт и протокол сервиса (например, с 80, 8080 портов на 443 порт по https протоколу), сформируйте необходимую таблицу переадресации.

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

В зависимости от того, какой фактический протокол будет использовать сервис (http или https), таблица настройки переадресации, будет иметь вид:

В случае настройки сервиса для работы по HTTP протоколу:

В случае настройки сервиса для работы по HTTPS протоколу:

Описание значений колонок:

• Порт - слушаемый порт дополнительного прослушивателя, для приема входящих запросов со всех имеющихся, на момент старта сервиса, сетевых интерфейсов, и переадресация их, на фактический порт сервиса. Например, с 80 порта на фактический порт, настроенный на предыдущем шаге.
• Протокол - протокол входящих запросов обрабатываемых дополнительным прослушивателем. Например, с указанного 80 порта должны приниматься запросы по http протоколу, а с 443 порта - по https протоколу, и переадресовываться на фактически используемый сервисом протокол.

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

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

Так же необходимо указать имена доменов (в случае нескольких используйте системный разделитель списков), пользователям которых вы хотите разрешить аутентифицироваться.

Важно!

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

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

В случае отсутствия указанного поставщика в БД, он будет создан во время сохранения конфигурации. Посмотреть существующие поставщики можно в интерфейсе Парус 8: Администратор -> Учет -> Внешние поставщики информационных услуг.

Зарегистрировать текущую учетную запись пользователя домена Windows в качестве внешнего идентификатора для текущего пользователя Парус 8 можно в интерфейсе Парус 8: Файл -> Сервис -> Параметры -> Расширения -> Пользовательские приложения -> "Зарегистрировать текущего пользователя домена Windows для удаленного доступа по доменной аутентификации".

Для установки параметров подключения к базе данных нажмите

Откроется окно настроек параметров подключения к базе данных:

В поле СУБД необходимо выбрать требуемую СУБД (Oracle или PostgreSQL), c которой планируется работа.

В поле База данных необходимо указать адрес БД в формате локального именования (псевдоним БД из файла tnsnames.ora ) или Easy Connect (строка подключения вида host:port/SID, например 192.168.1.42:1521/ORCL1 ).

Кстати

Если на сервере не установлен клиент Oracle требуемой разрядности, а он требуется, то можно скачать и установить Oracle Instant Client в процессе конфигурирования. Если при этом используется метод локального именования (tnsnames), то потребуется создать файл tnsnames.ora в папке установки, и включить в него реквизиты соединения.

Параметр Пользователь-владелец данных определяет имя схемы БД Парус 8, данные которой становятся доступны удаленным пользователям. По традиции это имя - "parus" без кавычек.

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

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

Параметр Пользователь сервиса и Пароль позволяют задать реквизиты доступа для пользователя, от имени которого будет работать сервис. Данный пользователь должен быть зарегистрирован в Парус 8 как анонимный пользователь. Предполагается, что данный пользователь к этому моменту уже будет создан в СУБД и зарегистрирован в Парус 8 как анонимный пользователь с назначением лицензии (в которой есть серверные лицензионные соединения для приложения MillAppServer).

Важно!

До указания в конфигураторе пользователя-владелеца данных и пользователя сервиса, необходимо убедиться, что данные пользователи существует в Парус 8, они настроены соответственно выполняемой роли (например, пользователь сервиса должен быть анонимным пользователем), а также им назначена лицензия, из которой планируется распределять серверные лицензии. Пользователь-владелец данных при использовании СУБД Postgres : Например, если это пользователь PARUS (при условии, что он является владельцем схемы или суперпользователем с необходимыми правами над объектами БД в используемой схеме), то все также как и в Oracle. Если это пользователь POSTGRES (владелец схемы по умолчанию), то необходимо обеспечить создание данного пользователя в Парус 8, и наделить его всеми теми же правами в учетной системе, что и пользователя PARUS при использовании Oracle.

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

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

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

При работе ЦУД не всегда возможно прямо сейчас штатно закрыть соединение с БД. В тех случаях когда это невозможно, попытка закрытия будет отложена и предпринята позднее, и так до тех пор пока закрытие не удастся (или отпадет необходимость в закрытии).

Если удаленный пользователь планирует использовать для работы с Сервисом приложение для Win32 в данном окне указываются настройки приложения.

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

- Собирать статистику действий удаленного клиента - при включении этого флажка агенты доступа к приложениям Win32 будут автоматически собирать статистику действий удаленного клиента. Подробности о работе этого механизма описаны в соответствующем разделе.

- Каталог - указывается папка на жестком диске, которая содержит стартовую страницу загрузки Win32 клиента.

- Путь к файлам - указываются пути к файлам, необходимым для работы клиента. В случае, если на web-сервере установлена клиентская часть ПП Парус 8, эти файлы будут обнаружены автоматически.

Сбор статистики осуществляется удаленным клиентом при запуске приложения p8application.exe с ключом командной строки -writeuserlog. Если вы установили соответствующий флажок в конфигураторе, он будет вызывать p8application.exe в этом режиме.

Статистика действий пользователя собирается в файл %ProgramData%\Techmill\parususerlog.bin. Если этот файл отсутствует, то он будет создан, и ему будет присвоен внутренний глобально-уникальный идентификатор. При дальнейших действиях с файлом идентификатор не изменится. Статистика действий удаленного пользователя сохраняется в этом файле в контексте сеанса. Если общий размер файла превысит 100 MB, то информация о наиболее старых сеансах будет из файла удалена. Сессии, хранящиеся в файле, нумеруются последовательными числами. Несколько процессов, работающих одновременно, разделят файл статистики.

Информация, накопленная в файле статистики, должна быть отправлена на сервер приложений. Для этого можно использовать любой из следующих способов:

1. В БД создан модуль пользовательского приложения с именем LoadRemoteUserLog
   
   Администратор должен привязать действие этого модуля к какому-либо разделу системы по своему усмотрению, и удаленный пользователь выполнит это действие.
2. Удаленный клиент передает файл статистики %ProgramData%\Techmill\parususerlog.bin администратору любым доступным ему способом, и администратор загружает его стандартными средствами "Обозревателя данных":
   

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

В случае задания нескольких серверов, все они будут доступны для выбора в окне логина в качестве параметра "База данных".

Важно!

Все указываемые сервера должны иметь (и поддерживать ее при последующих обновлениях) одинаковую версию настоящего Сервиса, а также версии файлов, необходимые для работы клиента, указанные на предыдущем шаге конфигурации. Клиентское приложение Win32 будет проверять наличие обновлений на всех указанных серверах (информация о версии сервиса будет запрошена параллельно), но итоговое решение о необходимости обновления будет приниматься на основании ответа сервера, который первым ответит на запрос. Обновление, в случае необходимости, будет производится сразу именно с этого сервера.

-  Наименование - указывается наименование, которое будет показано пользователю в окне логина Win32 приложения в параметре "База данных". В случае если наименование не будет указано, то вместо него будет использоваться соответствующий параметр  Хост сервера.

- Хост сервера - указывается адрес как минимум настраиваемого сервера (в случае необходимости, можно указать несколько дополнительных серверов), они должны быть доступны удаленным пользователям по указанным именам. Если доступ осуществляется по нестандартому порту, после двоеточия необходимо указать порт. Если протокол доступа к хосту отличается от протокола настраиваемого сервиса, то укажите префикс протокола (http:// или https://) в этом поле перед адресом.

- Путь серверного proxy - указывается путь синонима серверного proxy, по которому сервис будет доступен удаленному пользователю. Подробнее об использовании серверного proxy можно узнать здесь.

В случае необходимости включать в состав клиента удаленного доступа для приложения Win32 дополнительные модули/файлы, или указать переменные окружения, которые должны быть установлены в момент старта клиента, укажите их.

Диалог указания дополнительных модулей/файлов :

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

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

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

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

Важно!

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

Кстати

В качестве примера использования указанной возможности описывается процесс подключения ГОСТ алгоритмов шифрования в https протокол на клиентской стороне. Эта обеспечивается за счет включения в состав удаленного клиента дополнительной библиотеки для OpenSLL -  gost.dll, файла конфигурации этого плагина -  openssl.conf, и задания переменной окружения -  OPENSSL_CONF, указывающей путь к этому файлу конфигурации библиотекам OpenSSL (они входят в стандартную поставку клеинта, т.е. указывать их нет необходимости). Подробнее, необходимые требования и настройки, в частности пример содержимого файла конфигурации openssl.conf, описаны в статье "Использование SSL сертификатов c ГОСТ алгоритмами". В этой статье описывается настройка на стороне сервера приложений, но за исключением 4-го пункта, процесс полностью идентичен.

Для установки параметров, в главном окне выберите:

На данном шаге настроек осуществляется распределение общего числа лицензий по серверным лицензиям.

Информацию о наименованиях Организаций, конфигуратор получает из БД указанной в настройках подключения к БД. По умолчанию, для распределения доступно 100% доступных соединений из WIN-лицензии для приложения MillAppServer.

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

Если Вы распределили не все доступные соединения из лицензии, то появится сообщение:

На этом шаге можно вернуться к распределению снова. Или нажать "Yes" ("Да") для подтверждения операции.

Для каждого клиентского соединения будет использоваться 1 WEB-лицензия соответствующего приложения:

• Для web-приложений - WEB-лицензии из приложения Balance.
• Для Win32-приложения - WEB-лицензии из используемого клиентом приложения.

Для установки параметров протоколирования событий сервера нажмите:

В открывшемся окне необходимо выбрать способ протоколирования:

- В файл - записи о событиях сервера будут сохраняться в текстовый файл в формате W3CExtended. После начала работы сервера в рабочем каталоге будет создана папка LOGS, в которой будут сохранятся log-файлы с наименованием w3cext.log.

Пример

Пример log-файла: #Version: 1.0 #Date: 2012-06-04 15:55:53  #Software: DMAS/1.1 #Fields: date time time-taken bytes c-ip cs-username cs-method cs-uri cs-status cs-bytes sc-bytes x-cookie 2012-06-04 15:56:05 0.0 1433 127.0.0.1 - GET / 200 451 1102 HTTPID={921CFE12-F2B3-4186-A5FC-C03C12ABCBDD} 2012-06-04 15:56:05 0.0 0 127.0.0.1 - GET /parusjs/parus8.js 304 575 307 HTTPID={921CFE12-F2B3-4186-A5FC-C03C12ABCBDD} 2012-06-04 15:56:05 0.0 0 127.0.0.1 - GET /.system/contents.xml?dojo.preventCache=1338810965668 200 639 1101 HTTPID={921CFE12-F2B3-4186-A5FC-C03C12ABCBDD} 2012-06-04 15:56:13 0.0 0 127.0.0.1 parus GET /parus/sysinfo.xml?login=parus&password=parus&dojo.preventCache=1338810973239 200 663 489 HTTPID={921CFE12-F2B3-4186-A5FC-C03C12ABCBDD} 2012-06-04 15:56:13 0.0 0 127.0.0.1 parus GET /parusjs/balance.html 304 578 307 HTTPID={921CFE12-F2B3-4186-A5FC-C03C12ABCBDD} 2012-06-04 15:56:13 0.6 0 127.0.0.1 parus POST /parus/query.xml 200 808 973 HTTPID={921CFE12-F2B3-4186-A5FC-C03C12ABCBDD} 2012-06-04 15:56:15 0.92 0 127.0.0.1 parus POST /parus/query.xml 200 811 8479 HTTPID={921CFE12-F2B3-4186-A5FC-C03C12ABCBDD} 2012-06-04 15:56:15 0.1 0 127.0.0.1 parus POST /parus/query.xml 200 816 749 HTTPID={921CFE12-F2B3-4186-A5FC-C03C12ABCBDD} 2012-06-04 15:56:16 0.0 0 127.0.0.1 parus POST /parus/query.xml 200 794 381 HTTPID={921CFE12-F2B3-4186-A5FC-C03C12ABCBDD} 2012-06-04 15:56:45 0.0 0 127.0.0.1 - GET /.admin/counters.xml 200 123 816 - 2012-06-04 15:56:45 0.0 0 127.0.0.1 - GET /.admin/sessions.xml 200 123 765 - 2012-06-04 15:56:45 0.0 0 127.0.0.1 - GET /.admin/messages.xml 200 123 400 -

В начале файла идет служебная информация об используемом ПО для генерации log-файла.

Далее каждая строка описывает одно событие сервера, и содержит дату и время события, время выполнения, объем данных, ip-адрес клиента, используемый метод и т.д.

В дальнейшем, при необходимости, есть возможность экспортировать log-файл в базу данных.

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

При необходимости, есть возможность экспортировать протоколы сервиса из базы данных в файл формата W3C.

- Не протоколировать - отключить возможность протоколирования событий сервера.

Создание служебной схемы базы данных требуется в следующих случаях:

- настроено протоколирование в БД.

- разрешен сбор статистики действий удаленного клиента.

- Пользователь-владелец данных - имя пользователя-владельца схемы (значение не может быть изменено).

- Пароль - пароль для пользователя

- Пароль пользователя SYS - пароль пользователя, наделенного правами создания/изменения пользователя и схемы БД. Вы можете не указывать пароль пользователя SYS. В этом случае вы должны самостоятельно создать служебную схему.

При сохранении конфигурации будет создана (в случае ее отсутствия) и проинициализирована служебная схема БД.

Важно!

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

1. Создать пользователя - владельца схемы. Пользователь должен иметь табличное пространство по умолчанию, и достаточную квоту на него. В этом табличном пространстве будут созданы объекты служебной схемы.
2. Предоставить пользователю - владельцу схемы следующий набор привилегий:
   • create session
   • create table
   • create sequence
   • create view
   • create procedure
   • create trigger
   • create any context

1create user WEBSERVER identified by *****
2  default tablespace SYSAUX quota unlimited on SYSAUX;
3grant create session to WEBSERVER;
4grant create table to WEBSERVER;
5grant create sequence to WEBSERVER;
6grant create view to WEBSERVER;
7grant create procedure to WEBSERVER;
8grant create trigger to WEBSERVER;
9grant create any context to WEBSERVER;

При нажатии на

конфигуратор автоматически проверит наличие обновлений и, при необходимости, предложит скачать новую версию конфигуратора:

При нажатии кнопки "Yes" ("Да") будет произведено автоматическое скачивание новой версии сервиса.

По окончании скачивания подтвердите установку:

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

Если при проверке обновлений найдено не было, будет выведено сообщение:

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

Конфигуратор

При работе с конфигуратором, для перехода между действиями, возврата к предыдущему меню или выходу из конфигуратора можно использовать комбинацию клавиш Ctrl+C.

Конфигуратор при необходимости установит и настроит (предварительно спросив пользователя):

• Клиентские библиотеки доступа к Oracle (instant client)
• OpenSSL

Кстати

Управление и получение информации о состоянии служб ОС, без использования конфигуратора: service [имя сервиса] start | stop | reload | restart | status имя службы настоящего сервиса - ParusRemoteAccess

Настройка Firewall и SeLinux

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

Поддерживается 2 вида протоколирования:

• в локальный системный журнал (journalctl)
• отправка на syslog сервер (как локальный, так и внешний)

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

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

• -DebugMessageToJournal - протоколирование в локальный системный журнал
• -DebugMessageToSyslog host[:port] [-udp | -tcp | -ssl] - протоколирование на syslog сервер.

Для отбора из системного журнала отладочных сообщений, которые бы попали в Отладочный монитор в случае работы сервиса на Windows, можно использовать фильтрацию по аттрибуту SYSLOG_SDID=DebugMessage (без данной фильтрации будут отобраны сообщения от любых приложений/служб с данного хоста), а также указать другие критерии отбора.

Настройка Отладочного монитора, запущенного на Windows, в качестве syslog сервера, описана с статье Использование отладочного монитора.

Также стоит отметить, что по умолчанию в ОС все сообщения отправленные в системный журнал, автоматически попадают и на локальный syslog сервер (служба rsyslog). В свою очередь, rsyslog может быть настроен на пересылку локальных сообщений на некий внешний syslog сервер.

Это дает дополнительную возможность пересылать отладочные сообщения с Linux в Отладочный монитор, который запущен на Windows. Для этого можно добавить конфиг-файл (с любым именем, но расширением.conf) в каталог конфигов rsyslog ("/etc/rsyslog.d/") со следующим содержанием:

01template(name="SyslogProtocol23FormatFromCEE" type="list") {
02  constant(value="<")
03  property(name="pri")
04  constant(value=">1 ")
05  property(name="timestamp" dateFormat="rfc3339")
06  constant(value=" ")
07  property(name="hostname")
08  constant(value=" ")
09  property(name="programname")
10  constant(value=" ")
11  property(name="$!_PID")
12  constant(value=" ")
13  property(name="$!SYSLOG_MESSAGE_ID")
14  constant(value=" [")
15  property(name="$!SYSLOG_SDID")
16  constant(value="@77737676")
17  constant(value=" ModuleName=\"")
18  property(name="$!MODULENAME")
19  constant(value="\" TID=\"")
20  property(name="$!TID")
21  constant(value="\" Sender=\"")
22  property(name="$!SENDER")
23  constant(value="\"] ")
24  property(name="$bom")
25  property(name="$!MESSAGE")
26  constant(value="\n")
27}
28
29if $inputname == "imjournal" then {
30  if $!SYSLOG_SDID == "DebugMessage" then {
31    action(type="omfwd" Target="192.168.1.50" protocol="tcp" Port="514" TCP_Framing="octet-counted" Template="SyslogProtocol23FormatFromCEE")
32  }
33}

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

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

•  -CheckConfig: Проверка текущей конфигурации.
  Выполняется упрощенная проверка, с точки зрения конфигуратора, а именно проверяется наличие файла конфигурации, возможность его корректной загрузки, базовая проверка валидности, возможность соединения с БД указанной в конфигурации, проверка версии БД и наличие необходимых лицензий. Все эти пункты аналогично выполняются и во время интерактивного процесса конфигурации.
  
• -RegisterService: Регистрация и запуск сервиса ОС.
  Если на момент запуска команды сервис был уже зарегистрирован, но еще не запущен, то в результате он будет запущен.
  Если сервис зарегистрирован, и запущен, то в результате этой команды он будет перезапущен.
  В Linux редакции предоставляется возможность изменить параметры логирования, например логировать в syslog (локальный или удаленный) или в сервис journald. Параметры логирования хранятся в регистрационном файле, в виде ключей параметров запуска для сервиса, поэтому они запрашиваются во время регистрации сервиса.
• -UnRegisterService: Разрегистрация (и остановка при необходимости) сервиса ОС.
  
• -UpdateSchema: Инициализация и обновление служебной схемы базы данных.
• -UpdateDB: Обновление служебных объектов в базе данных Парус 8 (включая все действия выполняемые с ключем -UpdateSchema).
  
• -GenerateLaunchers: Генерация агентов удаленного доступа для приложения Win32.
  
• -ApplyConfig: Применение конфигурации целиком (включая все действия выполняемые с ключами -UpdateDB и -GenerateLaunchers).

Это же описание можно получить запустив консольный конфигуратор с ключиком -help.

Важно!

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