¶ Технические требования к аппаратному и программному обеспечению для работы Интранет-версии КонсультантПлюс
В данном разделе приводятся минимальные технические требования и рекомендуемые характеристики сетевой Интранет-версии для Uncom OS. Сетевая Интранет-версия состоит из двух частей: серверной и клиентской. Установка серверной части описана в соответствующей документации. Клиентской частью является браузер.
- МИНИМАЛЬНЫЕ ТРЕБОВАНИЯ ДЛЯ СЕРВЕРНОЙ ЧАСТИ СЕТЕВОЙ ИНТРАНЕТ-ВЕРСИИ
- Процессор – 4 ядра и более.
- ОЗУ – 4 Гб и более.
- Подключение к локальной сети Интранет на скорости 100 Мбит/с и выше.
- Объем диска – не менее 1,5 объёмов установленного комплекта КонсультантПлюс.
- Возможность аппаратного или программного подключения электронного ключа защиты к порту USB.
- Возможность доступа к почтовому серверу по протоколу SMTP (только в случае использования режима собственной авторизации).
- МИНИМАЛЬНЫЕ ТРЕБОВАНИЯ ДЛЯ КЛИЕНТСКОЙ ЧАСТИ СЕТЕВОЙ ИНТРАНЕТ-ВЕРСИИ
- Подключение к локальной сети на скорости 2 Мбит/с и выше.
- Разрешение экрана 1280х1024 точек и выше.
- Браузеры: Firefox, Opera, Google Chrome, Яндекс.Браузер последних версий, доступных на сайтах производителей или в магазине приложений.
- В браузере должны быть разрешены: приём файлов cookie, поддержка активных сценариев (JavaScript).
- Для доступа к онлайн-сервисам в локальном и сетевом антивирусе/файерволе, а также на прокси-серверах/маршрутизаторах должен быть открыт доступ к ресурсам ".consultant.ru" для 80-го (http-протокол) и 443-го портов (https-протокол).
По умолчанию в браузере все необходимые возможности включены. Но службой информационной безопасности предприятия может быть установлена иная политика безопасности. Перед установкой СПС КонсультантПлюс обязательно проконсультируйтесь, не отключены ли эти возможности у пользователей.
- РЕКОМЕНДУЕМЫЕ ХАРАКТЕРИСТИКИ ДЛЯ СЕРВЕРНОЙ ЧАСТИ ИНТРАНЕТ-ВЕРСИИ
- Процессор серверного класса 8 ядер и более (при ОД выше 500 – 12 ядер и более).
- ОЗУ – 32 Гб и более.
- Подключение к локальной сети на скорости 1 Гбит/с и выше.
- Накопители на SSD-дисках.
- Объем диска – не менее 2,5 объёмов установленного комплекта КонсультантПлюс.
- Возможность аппаратного или программного подключения электронного ключа защиты к порту USB.
- Возможность доступа к почтовому серверу по протоколу SMTP (только в случае использования режима собственной авторизации).
- РЕКОМЕНДУЕМЫЕ ХАРАКТЕРИСТИКИ СЕРВЕРА СУБД
Опциональный сервер СУБД используется для хранения рабочих данных пользователей Интранет-версии СПС КонсультантПлюс (папки, закладки и т.д.). Рекомендуется подключение сервера СУБД при ОД выше 10 (вне зависимости от количества пользователей) для повышения эффективности работы. В зависимости от нагрузки и технических характеристик используемого оборудования СУБД может быть установлена как на одном сервере с СПС, так и на выделенном сервере.
- Установленная СУБД PostgreSQL (9.5 и выше).
- Процессор – 4 ядра и более.
- ОЗУ – 8 Гб и более (рекомендуется 16 Гб и более).
- Подключение к локальной сети на скорости 1 Гбит/с и выше.
- Свободное дисковое пространство – не менее 50 Гб.
- Накопители на SSD-дисках.
¶ Инструкция по установке и настройке интранет-версии КонсультантПлюс на Uncom OS
¶ Проверка пользователя, обслуживающего ИВ
ВНИМАНИЕ! В качестве примера будет использована тестовая конфигурация для пользователя consultant и группы consultant. Предварительно рекомендуется проверить и при необходимости создать пользователя и группу consultant. Администратора ИВ или Офлайн ИБ рекомендуется добавить в группу consultant. Допускается изменение имён пользователей и групп, работающих с ИВ или Офлайн ИБ, с изменением соответствующих настроек для пользователей и групп в конфигурационных файлах
Проверяем:
$ sudo id -un consultant
При необходимости добавляем пользователя consultant, если его нет в системе:
$ sudo useradd -m consultant
¶ Копирование и регистрация Офлайн комплекта
- Копирование офлайн ИБ.
Имена файлов и каталогов в путях регистрозависимы!
Для корректной работы ИВ на сервере необходимо скопировать офлайн-комплект в папку, для упрощения в нашем случае это/home/consultant/OFFLINE/CONSBASE, где/mnt/flash/- источник с подготовленным комплектом
$ sudo cp -fR /mnt/flash/OFFLINE/ /home/consultant/OFFLINE/ - Краткое описание
liconsXXXXXX.
liconsXXXXXX- консольное приложение OC Linux без графического интерфейса для обслуживания информационных банков. Оно понимает те же самые ключи командной строки, что и Windows-версия КонсультантПлюс. Поскольку в Linux параметры командной строки не принято задавать через слэш, вместо него вliconsXXXXXXприменяется два подряд идущих дефис. Например, команда приёма пополнения во все базы комплекта будет выглядеть так:
$ ./liconsXXXXXX --adm --receive --base* - Регистрация приложения КонсультантПлюс.
Регистрация Linux офлайн-версии осуществляется только через файловый обмен.
$ cd /home/consultant/OFFLINE/CONSBASE
$ sudo ./liconsXXXXXX --reg
В папке SEND будет сформирован файл с расширением .QR, его необходимо обработать в ОРЦ РИЦ и получить файлы с кодом ответа и расширением .AR. Эти файлы нужно положить в папку RECEIVE, и повторно запустить регистрацию:
$ cd /home/consultant/OFFLINE/CONSBASE
$ sudo ./liconsXXXXXX --reg
Дополнительно будет выдана информация о регистрации ИБ.
Пример:
После этого необходимо проинициализировать комплект с ключом --adm. Программа выведет в консоль версию сборки, копирайт, каталог с ИБ и каталог запускаliconsXXXXXX. При необходимости программа построит общие словари:
$ sudo ./liconsXXXXXX –-adm - Установка прав для офлайн ИБ.
После копирования файлов офлайн-версии необходимо поставить соответствующие права папке CONSBASE и всему её содержимому для работы программы:
$ sudo chown -R consultant:consultant /home/consultant/OFFLINE/
$ sudo chmod -R 775 /home/consultant/OFFLINE/
Примечание: при обслуживании офлайн комплекта рекомендуется добавить пользователя, являющегося администратором офлайн комплекта в группу consultant.
¶ Добавление компонентов ОС для работы с ИВ
Перед установкой интранет-версии необходимо установить и настроить ряд пакетов и сервисов ОС. Используются компоненты из «родных» репозиториев ОС.
- Установите пакеты web-сервера Apache:
$ sudo apt install apache2 - Установите пакет балансировки нагрузки:
$ sudo apt install haproxy - Установите пакет драйвера odbc не ниже версии 09.05.0400 для подключения режима авторизации в ИВ:
$ sudo apt install odbc-postgresql - Установите пакет шрифтов и обновите кэш шрифтов:
$ sudo apt install fonts-dejavu
$ sudo fc-cache -r -f -v - Установите системные библиотеки для работы служб КонсультантПлюс
sudo apt install libssl1.1
sudo apt instal libldap-2.4-2
¶ Копирование и настройка файловой структуры ИВ
ВНИМАНИЕ! В качестве примера будет использована тестовая конфигурация для пользователя consultant и группы consultant.
Для корректной работы ИВ на сервере необходимо скопировать структуру ИВ в папку, в нашем случае это /home/consultant/ONLINE/cons/с помощью команды:
$ sudo cp -fR /mnt/flash/ONLINE/ /home/consultant/
где /mnt/flash/ - источник с подготовленным комплектом.
- Проверьте и скорректируйте файл
START.KEY, в котором прописан каталог с кэшем для ИВ:
$ sudo sh -c 'echo --CACHEDIR=/home/consultant/ONLINE/cons/TEMP > /home/consultant/ONLINE/cons/CGI/START.KEY' - Синхронизируйте и настройте
START.KEYдля обслуживания кэша ИВ при
пополнении офлайн ИБ:
$ sudo cp -fR /home/consultant/ONLINE/cons/CGI/START.KEY /home/consultant/OFFLINE/CONSBASE/ - Проверьте и при необходимости скорректируйте в файле
/home/consultant/ONLINE/cons/CGI/BASE.DIRпуть до офлайн ИБ:
$ sudo sh -c 'echo basedir=/home/consultant/OFFLINE/CONSBASE/ > /home/consultant/ONLINE/cons/CGI/BASE.DIR' - Проверьте или создайте в папке
TEMPкаталогRTFCACHE:
$ sudo mkdir -p /home/consultant/ONLINE/cons/TEMP/CONSCACHE/RTFCACHE - Создайте символическую ссылку на папку
RTFCACHEв каталоге с ресурсомcons:
$ sudo ln -s /home/consultant/ONLINE/cons/TEMP/CONSCACHE/RTFCACHE /home/consultant/ONLINE/cons/ - Установите необходимые права для работы ИВ:
$ sudo chown -R consultant:consultant /home/consultant/OFFLINE
$ sudo chmod 775 -R /home/consultant/OFFLINE
$ sudo chown -R consultant:consultant /home/consultant/ONLINE
$ sudo chmod 775 -R /home/consultant/ONLINE
$ sudo chmod 775 /home/consultant - Установите корректные права для работы юнитов в ОС:
$ sudo chmod 664 -R /home/consultant/ONLINE/cons/SYSTEM/conssrv2.service
$ sudo chmod 664 -R /home/consultant/ONLINE/cons/SYSTEM/online-pool.target
$ sudo chmod 664 -R /home/consultant/ONLINE/cons/SYSTEM/online-worker@.service
$ sudo chmod 664 -R /home/consultant/ONLINE/cons/SYSTEM/online.conf
¶ Настройка интранет-версии
ВНИМАНИЕ! В качестве примера будет использована тестовая конфигурация для пользователя consultant и группы consultant, имя которого можно заменить на любое другое. При замене пользователя или каталогов необходимо скорректировать и привести пути в конфигурационных файлах в соответствие с теми, которые будут созданы или изменены.
Имена файлов и каталогов в путях регистрозависимы!
- В файле
/home/consultant/ONLINE/cons/SYSTEM/conssrv2.serviceпроверьте и скорректируйте параметры:
WorkingDirectory=/home/consultant/ONLINE/cons/SYSTEM
ExecStart=/home/consultant/ONLINE/cons/SYSTEM/conssrv2
User=consultant
Group=consultant
Создайте символическую ссылку на этот файл в директории /etc/systemd/system:
$ sudo systemctl link /home/consultant/ONLINE/cons/SYSTEM/conssrv2.service
- В файле
/home/consultant/ONLINE/cons/SYSTEM/online-worker@.serviceпроверьте и скорректируйте параметры:
WorkingDirectory=/home/consultant/ONLINE/cons/TEMP/CONSCACHE
ExecStart=/home/consultant/ONLINE/cons/CGI/online.cgi --port %I --
conssrv standalone
User=consultant
Group=consultant
Создайте символическую ссылку на этот файл в директории /etc/systemd/system:
$ sudo systemctl link /home/consultant/ONLINE/cons/SYSTEM/online-worker@.service
- В файле
/home/consultant/ONLINE/cons/SYSTEM/online-pool.targetпроверьте и скорректируйте параметры:
В параметреWantsсекции[Unit]указывается нужное количество запускаемых обработчиков в форматеonline-worker@ПОРТ.service. Для каждого обработчика нужно указать свой номер ip/tcp порта, который он будет использовать. В примере приведена настройка запуска двух параллельных процессов на портах8006и8007:
[Unit]
Wants=conssrv2.service online-worker@8006.service onlineworker@8007.service
[Install]
WantedBy=multi-user.target
Создайте символическую ссылку на этот файл в директории /etc/systemd/system:
$ sudo systemctl link /home/consultant/ONLINE/cons/SYSTEM/online-pool.target
Примечание: обычно команда systemctl link создаёт символическую ссылку в каталоге
/etc/systemd/system
Пример:
-
Перезапустите сервис systemd командой:
$ sudo systemctl daemon-reload -
Запустите пул обработчиков. Проверьте наличие воркеров в системе:
$ sudo systemctl start online-pool.target
$ ps aux | grep online.cgi
Корректный результат:
ВНИМАНИЕ! Если процессы не запустились, нужно внимательно проверить права на папки и файлы для пользователя
consultant, а также пути во всех конфигурационных файлах (следите за регистром).
- Для добавления пула обработчиков в автозапуск, после перезагрузки ОС,необходимо выполнить команду:
$ sudo systemctl enable online-pool.target
ВНИМАНИЕ! Настройку пула обработчиков online-pool.target необходимо прописать вручную, если автоподстановка по клавише
Tabне отработает. Это допустимое поведение.
- Для проверки пула обработчиков в автозапуске необходимо выполнить:
$ sudo systemctl is-enabled online-pool.target
¶ Настройка web-сервера Apache
-
Перед началом настройки активируйте все необходимые модули apache2:
$ sudo a2enmod proxy proxy_balancer proxy_http
После активации модулей apache2 необходимо перезапустить сервис:
$ sudo systemctl restart apache2 -
Настраиваем основной порт ИВ для «прослушивания» и открытия пула приложений ИВ. В файле
/etc/apache2/ports.confукажите порт, на котором будет работать ваш ресурс в виде (в примере порт 8000). Корректируем в редакторе:
$ sudo gedit /etc/apache2/ports.conf
В открывшемся файле добавляем строку с параметромListen 8000 -
Настраиваем, при необходимости, файл конфигурации виртуального сайта для ресурса cons, в файле
/home/consultant/ONLINE/cons/SYSTEM/online.conf. -
Скорректируйте порт, используемый приложением ИВ. Для этого в файле
online.confв тэге<VirtualHost *:8000>укажите порт, на котором будет работать ваш ресурс (в примере порт 8000). -
Скорректируйте в файле
online.confадмин e-mail. -
Скорректируйте в файле
online.confразрешения для каталога<Directory “/home/consultant/ONLINE/cons”>. -
Скорректируйте каталог для записи логов, например,
/var/log/apache2/.
Пример файлаonline.conf:
-
Создайте ссылку на файл /home/consultant/ONLINE/cons/SYSTEM/online.conf в каталоге
/etc/apache2/sites-available:
$ sudo ln -s /home/consultant/ONLINE/cons/SYSTEM/online.conf /etc/apache2/sites-available
Примечание: при необходимости допускается скопировать физически файл
online.confв каталог/etc/apache2/sites-available.
- Активируйте необходимые настройки web-сервера Apache для сайта ИВ:
$ sudo a2ensite online.conf
Команда a2ensite создаёт символическую ссылку в каталоге/etc/apache2/sites-enabled/online.conf. Можно проверить:
$ sudo ls -l /etc/apache2/sites-enabled/
Пример:
- Проверьте синтаксис файлов конфигурации apache2 командой:
$ sudo apache2ctl -t
Корректный результат выполнения команды, не содержит сообщений об ошибках
(Syntax OK).
- Если сервисы работают корректно, перезапустите apache2:
$ sudo systemctl restart apache2 - Для проверки сервиса веб-сервера необходимо выполнить:
$ sudo systemctl status apache2.service
¶ Настройка балансировщика для распределения нагрузки
- Для распределения нагрузки используется прокси-сервер
haproxy. Настройка осуществляется в файле/etc/haproxy/haproxy.cfg. - Добавляем параметры балансировки. Корректируем в редакторе:
$ sudo gedit /etc/haproxy/haproxy.cfg - Добавляем пул портов, используемые приложением ИВ:
Примечание: важно, чтобы настройки пула портов, секции frontend и backend, находились после секций с описанием global и defaults
- Проверьте корректность внесённых изменений конфигурационного файла:
$ sudo haproxy -c -- /etc/haproxy/haproxy.cfg
Корректный результат:
- Если сервисы работают корректно, перезапустите сервис haproxy:
$ sudo systemctl restart haproxy - Для проверки автозапуска балансировщика необходимо выполнить:
$ sudo systemctl is-enabled haproxy.service - Для добавления балансировщика в автозапуск, после перезагрузки ОС, необходимо выполнить команду:
$ sudo systemctl enable haproxy.service
¶ Проверка готовности ИВ
Для проверки запущенных процессов, необходимых для работы ИВ, введите команду:
$ sudo systemctl list-units | grep -E "conssrv|online-|apache|haproxy"
В результате отобразятся процессы со статусом “loaded active running”:
¶ Обновления ИВ на новую версию
Для замены модуля приложения online.cgi остановите пул приложений:
$ sudo systemctl stop online-pool.target
Замените необходимые файлы ИВ online.cgi и файлы в каталоге staticXXXX_XX_XX_XXXXXX.
Запустите пул приложений:
$ sudo systemctl start online-pool.target
Для замены модуля службы conssrv2 остановите пул приложений:
$ sudo systemctl stop conssrv2.service
Замените файлы и запустите службу:
$ sudo systemctl start conssrv2.service
¶ Применение изменений в файле online.ini
Группу приложений online-pool.target необходимо перезагружать при изменении в файлах каталога CGI и SYSTEM.
Остановите пул приложений:
$ sudo systemctl stop online-pool.target
Внесите необходимые изменения в конфигурационные файлы ИВ. Запустите пул приложений:
$ sudo systemctl start online-pool.target
¶ Диагностика для проверки работы ИВ
Примечание: если при входе на сайт ожидаемая страница не отображается, то для
диагностики можно посмотреть записи в лог-файлах:
/var/log/apache2/error.log
/home/consultant/ONLINE/cons/CGI/CONS_ERR.TXT
/home/consultant/ONLINE/cons/SYSTEM/CONS_ERR.TXT
/home/consultant/ONLINE/cons/TEMP/CONSCACHE/CONS_ERR.TXT
/home/consultant/ONLINE/cons/TEMP/CONSCACHE/LOG.TXT
/home/consultant/OFFLINE/CONSBASE/CONS_ERR.TXT
Диагностика работы сервисов выполняется командами:
$ sudo systemctl list-units | grep -E "conssrv|online-|apache|haproxy"
$ sudo systemctl status conssrv2.service
$ sudo systemctl status online-pool.target
$ sudo systemctl status online-worker@800*
$ sudo systemctl status apache2.service
$ sudo systemctl status haproxy
Примечание: При работе ИВ, с включённой авторизацией, в каталоге CGI может
появляться много файлов, типа XXXX.log. Рекомендуем отключить "избыточное"
логирование в настройках ODBC, в файле /etc/odbcinst.ini установить параметры:
Debug=0
CommLog=0
¶ Подключение ключа защиты RUTOKEN
ВНИМАНИЕ! Физически готовый ключ защиты со всеми необходимыми сертификатами передаётся из КЦ вместе с комплектом дистрибутивов и не требует дополнительных настроек.
ВАЖНО! Для установки ключа требуется наличие доступа пользователя к файловой
структуре суперпользователя (sudo) и возможности выполнять команды с правами root.
- Для установки пакетов нужно выполнить команду:
$ sudo apt install libccid pcscd libpcsclite1 libpam-p11 libpam-pkcs11 libp11-3 libengine-pkcs11-openssl pcsc-tools opensc - Перезапустите службы или перегрузите ОС.
$ sudo systemctl restart pcscd.service pcscd.socket - После установки пакетов подключите RUTOKEN к серверу. Проверьте командой:
$ pcsc_scan
Пример корректного подключения:
- Проверьте работоспособность устройства, выполнив команду:
$ pkcs11-tool --module /usr/lib/librtpkcs11ecp.so -T
Пример корректного подключения:
После успешной установки RUTOKEN необходимо выполнить регистрацию
Интранет-версии КонсультантПлюс.
¶ Привязка и регистрация ИВ
ВНИМАНИЕ! К моменту регистрации RUTOKEN на сервере уже должна быть установлена и настроена Интранет-версия КонсультантПлюс
- Откройте установленную интранет-версию в браузере, где должно отображаться следующее сообщение:
- Сформируйте параметры регистрации через запрос
req=iregв адресной строке браузера. Будут выданы параметры, которые необходимо зарегистрировать в ОРЦ вашего РИЦ. Сохраните в файл (вы получите файл с расширением.IQR). Рекомендуем предавать параметры через файловый обмен.
Пример:http://localhost:8000/cgi/online.cgi?req=ireg
- Полученный файл ответа в ОРЦ с расширением
.IARнеобходимо положить в каталогRECEIVEоффлайн-комплекта КонсультантПлюс на сервере и запустить оффлайн модуль./liconsXXXXXXс ключом--ireg. В процессе работы оффлайн модуля дополнительных сообщений не будет и при успешной процедуре регистрации ИВ файл.IARудалится из каталогаRECEIVE.
Для завершения процедуры регистрации нужно перейти в каталог с офлайн комплектом и выполнить команду:
$ ./liconsXXXXXX --ireg
Для корректного завершения установки и настройки необходимо обновить запущенные процессы online.cgi.
Остановите пул приложения:
$ sudo systemctl stop online-pool.target
Остановите службу conssrv2:
$ sudo systemctl stop conssrv2.service
Запустите пул приложений:
$ sudo systemctl start online-pool.target
Примечание: при запуске пула приложения автоматически должна запуститься служба conssrv2.
Примечание: при успешной регистрации ИВ и инициализации RUTOKEN, на запрос reg=ireg в адресной строке браузера будет выдано сообщение «Система уже зарегистрирована».
Внимание! При извлечении ключа из сервера система становится неработоспособной, при подключении ключа работа системы восстанавливается автоматически
На этом настройка серверной части интранет-версии завершена. Проверить её работоспособность можно открыв браузер и зайдя по адресу http://127.0.0.1:8000
¶ Подключение к Интранет-Версии КонсультантПлюс с рабочей станции
Для подключения к Интранет-Версии КонсультантПлюс используется любой современный интернет-браузер. Для подключения необходимо ввести в адресной строке
http://ip_адрес_сервера:порт
Где ip_адрес_сервера - это IP-адрес ПК, на котором развернут сервер Интранет-Версии КонсультантПлюс, порт - заданный при настройке сервера Интранет-Версии КонсультантПлюс порт http-сервиса (8000 в нашем примере).
Рабочая станция и сервер Интранет-Версии КонсультантПлюс должны находиться в одной подсети.
В данной статье мы не будем рассматривать методы настройки авторизации в КонсультантПлюс, для примера используется работа без авторизации
Страница Интранет-Версии КонсультантПлюс корректно открылась в браузере и доступна для навигации:
