Инструкция по установке на листах

Скачать 143.23 Kb.

Название	Инструкция по установке на листах
Тип	Инструкция

rykovodstvo.ru > Инструкция по эксплуатации > Инструкция

ООО "КСК ТЕХНОЛОГИИ"

наименование организации - разработчика документа

Подсистема взаимодействия с Государственной информационной системой о государственных и муниципальных платежах

наименование АИС

ПВ ГИС ГМП

сокращенное наименование АИС

ИНСТРУКЦИЯ ПО УСТАНОВКЕ

На листах

Москва 2017

Содержание

1.Введение 3

1.1.Назначение 3

1.2.Определения 3

2.Установка системы 5

2.1.Перечень пакетов Системы 5

2.2.Установка PostgreSQL на Linux 8

2.3.Установка OpenLDAP 9

2.4.Установка Nginx 10

2.5.Установка Liferay и общих компонентов 10

2.6.Установка модулей на портал ГИС ГМП 15

2.7.Установка Шины 16

2.8.Перезапуск компонентов системы СИУМВВ 18

1.Введение

1.1.Назначение

Настоящий документ является инструкция по установке АИС "Подсистема взаимодействия с Государственной информационной системой о государственных и муниципальных платежах" (АИС ПВ ГИС ГМП) и определяет действия, необходимые для установки и настройки системы.

1.2.Определения

Полное наименование документа — "Инструкция по установке АИС ПВ ГИС ГМП".

В данном документе применяются следующие термины и сокращения (Таблица ).

Таблица — Перечень терминов и сокращений

Аббревиатура	Пояснение
АИС	Автоматизированная информационная система
Система	АИС ПВ ГИС ГМП
Портал	Внутренняя часть АИС ПВ ГИС ГМП
Площадка	АИС ПВ ГИС ГМП Заказчика
HTTP	Протокол передачи гипертекста (HyperText Transfer Protocol) - протокол прикладного уровня передачи данных
ISO	Международная организация по стандартизации (International Organization for Standardization)
LDAP	Облегчённый протокол доступа к каталогам (Lightweight Directory Access Protocol) - протокол прикладного уровня для доступа к службе каталогов
SFTP	SSH File Transfer Protocol - протокол прикладного уровня, предназначенный для копирования и выполнения других операций с файлами поверх надёжного и безопасного соединения
SSH	Secure Shell - сетевой протокол прикладного уровня, позволяющий производить удалённое управление операционной системой и туннелирование TCP-соединений
TCP/IP	Протокол управления передачей (Transmission Control Protocol) и межсетевой протокол (Internet Protocol). Набор сетевых протоколов передачи данных, используемых в сетях, включая сеть Интернет
XML	Расширяемый язык разметки (eXtensible Markup Language)
XSD	Язык описания структуры XML-документа
БД	База данных
ОС	Операционная система
ПО	Программное обеспечение
СУБД	Система управления базами данных

2.Установка системы

Установка системы производится на операционную систему Ubuntu Server 14.04.2. При использовании других linux-based операционных систем некоторые команды могут незначительно отличаться. Необходимо свериться с документацией по используемой операционной системе.

2.1.Перечень пакетов Системы

Ниже представлены перечень пакетов Системы, необходимых для установки (Таблица 2):

Таблица — Пакеты АИС

Пакеты АИС	Русскоязычное описание
kck-gisgmp-gl-config	Пакет для конфигурации сервера приложений Glassfish
kck-liferay-6.2	Cервер приложений Glassfish + Liferay
kck-fs-web-server	Файловый сервер
kck-mm-mail-server	Почтовый сервер
kck-gisgmp-cas	CAS – сервер централизованной аутентификации
postgresql-9.4	СУБД Postgresql v. 9.4
kck-gisgmp-db-config	Конфигурационный пакет для СУБД Postgresql v.9.4
slapd	OpenLDAP
kck-siu-openldap	Конфигурационный пакет для OpenLDAP
kck-gisgmp-nginx	Конфигурационный пакет Nginx для портала
kck-jcp	Модуль подписи v.1.0.54
kck-jdk-7.21	Jdk v. 7.21
kck-servicemix	Servicemix
kck-activemq	ActiveMQ
kck-tmof-fix	Модули ядра.
kck-siu-esb-main-jars	Основые jar’ы Шины
kck-esb-db-config	Конфигурация БД Шины
kck-gisgmp-main-theme	Основная тема портала (может меняться в зависимости от поставки)
kck-user-management-portlet	Модуль управления операторами
kck-gisgmp-rest-postgres	Сервер системы ГИС ГМП
kck-gisgmp-hook	Дополнительные настройки Liferay
kck-gisgmp-updating-portlet	Настройка меню системы
kck-gisgmp-statistics-portlet	Портлет статистики начислений
kck-gisgmp-statistic-request-portlet	Портлет статистики запросов
kck-gisgmp-archive-portlet	Портлет архива системы
kck-gisgmp-charge-portlet	Портлет создания и передачи начеслений
kck-gisgmp-charge-sent-portlet	Портлет отправленных начислений
kck-gisgmp-charge-template-portlet	Портлет шаблонов начислений
kck-gisgmp-country-portlet	Портлет справочников стран
kck-gisgmp-export-portlet	Портлет загрузки файлов на форму
kck-gisgmp-forgot-pass-portlet	Портлет восстановления пароля
kck-gisgmp-myoffice-portlet	Портлет личных данных оператора
kck-gisgmp-oivrequests-portlet	Портлет мониторинга запросов на шине
kck-gisgmp-organization-portlet	Портлет справочников организаций
kck-gisgmp-payment-portlet	Портлет справочников типов платежей
kck-gisgmp-pre-charge-portlet	Портлет предварительных начислений
kck-gisgmp-req-answer-portlet	Портлет отображения отправленных запросов
kck-gisgmp-request-portlet	Портлет отправки запросов
kck-gisgmp-rights-portlet	Портлет управления правами пользователей
kck-gisgmp-settings-portlet	Портлет настройки автоматической проверки
kazna-SID0003998-v16x	Клиент сервиса ГИС ГМП
kck-esbclient-current-ds-keys	Модуль интеграции с шиной
kck-esbclient-external-esb-requests	Модуль интеграции с шиной
kck-esbclient-internal-esb-requests	Модуль интеграции с шиной
kck-esbclient-external-esb-services	Модуль интеграции с шиной
kck-esbclient-internal-esb-services	Модуль интеграции с шиной

Примечание.

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

Подразумевается, что архив с пакетами собственной разработки компании ООО "КСК ТЕХНОЛОГИИ" имеется в распоряжении у администратора, производящего установку Системы. При установке этих пакетов необходимо находиться в директории, куда они были распакованы. Сторонние Deb пакеты скачиваются через сеть Интернет с общедоступных репозиториев.

Процесс установки серверного программного обеспечения состоит из следующих этапов:

Установка PostgreSQL;
Установка LDAP;
Установка Nginx;
Установка Liferay;
Установка модулей на портал;
Установка Шины.

2.2.Установка PostgreSQL на Linux

Устанавливается на сервер СУБД.

Пакеты из архива, необходимые для этого шага: kck-gisgmp-db-config.

Добавить репозиторий для PostgreSQL:

sudo nano /etc/apt/sources.list.d/pgdg.list

Прописать:

deb http://apt.postgresql.org/pub/repos/apt/ trusty-pgdg main

Добавить публичный ключ:

wget --quiet -O -

https://www.postgresql.org/media/keys/ACCC4CF8.asc | \
sudo apt-key add -

Выполнить обновление apt/aptitude

sudo apt-get update -o Dir::Etc::sourcelist="sources.list.d/pgdg.list" -o Dir::Etc::sourceparts="-" -o APT::Get::List-Cleanup="0"

Установить:

sudo apt-get install postgresql-9.4

Настроить доступ к БД:

ВАЖНО!

В данном примере настройка идет для всех ПК сегмента сети. На продуктиве необходимо указывать только доменные имена и IP.

Редактировать файл/etc/postgresql/9.4/main/postgresql.conf

listen_addresses = '*'

Редактировать файл/etc/postgresql/9.4/main/pg_hba.conf

# IPv4 local connections:

host all all 127.0.0.1/32 md5

host all all 0.0.0.0/0 trust

Перезапустить Postgres

sudo service postgresql restart

Создать пользователя postgres:

sudo -u postgres psql -c "ALTER USER postgres PASSWORD 'postgres';"

Конфигурировать БД, следуя инструкциям конфигурационного пакета:

sudo dpkg –i install kck-gisgmp-db-config

2.3.Установка OpenLDAP

Устанавливается на сервер СУБД.

Пакеты из архива, необходимые для этого шага: kck-siu-openldap.

Установить пакет OpenLDAP:

sudo apt-get install slapd

Установить конфигурационный пакет:

sudo dpkg –i kck-siu-openldap

Вписать в baseDN актуальный для клиента логин и пароль администратора.

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

Создать файл sudo nano /tmp/test.ldif с содержимым:

dn: cn=test,ou=people,dc=kck,dc=ru
cn: test
mail: test@admin.ru
objectClass: inetOrgPerson
objectClass: organizationalPerson
objectClass: pguPersonInfo
objectClass: person
objectClass: top
givenName:: 0J3QuNC60L7Qu9Cw0Lk=
sn:: 0JDQu9GM0YTRgNC10YHQutC40L0=
userPassword: abcd1234

(!) dn: поменять на нужный

Выполнить команду:

ldapmodify -a -xWD cn=admin,dc=kck,dc=ru -f /tmp/test.ldif

(!) dn: поменять на нужный

2.4.Установка Nginx

Устанавливается на сервер портала ГИС ГМП.

Пакеты из архива, необходимые для этого шага: kck-gisgmp-nginx.

Установить из пакета:

sudo dpkg -i kck-gisgmp-nginx

Во время конфигурирования Nginx будет создан самоподписанный сертификат. Все поля могут быть заполнены на усмотрение, кроме поля FQDN —в нем прописывается полное доменное имя площадки.

2.5.Установка Liferay и общих компонентов

Устанавливается на сервер ГИС ГМП.

Пакеты из архива, необходимые для этого шага: kck-liferay-6.2, kck-gisgmp-cas, kck-gisgmp-main-theme, kck-gisgmp-gf-config.

Установить Liferay 6.2:

sudo dpkg -i kck-liferay-6.2

Установить сертификат:

sudo /opt/jdk/bin/keytool -import -alias gexpt -file /opt/nginx/ssl/gexpt-cert.pem -keystore /opt/liferay/glassfish/domains/domain1/config/cacerts.jks

sudo /opt/jdk/bin/keytool -import -alias siu-nginx -file /opt/nginx/ssl/gexpt-cert.pem -keystore /opt/jdk/jre/lib/security/cacerts

Пароль на хранилище по умолчанию"changeit".

Запустить портал:

sudo service kck-liferay start

Выполнить настройку Glassfish следуя подсказкам меню и учитывая, на какой именно портал настраивается:

sudo dpkg -i kck-gisgmp-gf-config

Установить тему:

sudo dpkg -i kck-gisgmp-main-theme

Установить CAS:

sudo dpkg –i kck-gisgmp-cas

Вносим необходимые значения:

Please, configure settings:

------------------------------------------------

1. CAS serverUrl:   localhost:389

2. CAS baseDN:      dc=dv,dc=kck,dc=ru

3. CAS login:       cn=admin

4. CAS password:    abcd1234

5. LiferayDB Name: liferay_kck

6. LiferayDB Host: localhost

7. Cas Externalname:    externalname

8. Portal Admin Password:   adminadmin

------------------------------------------------

0. Done configuring settings

s. Skip configuration

------------------------------------------------

Настроить связи на портале в панели управления Liferay.
1. Зайти на портал и авторизироваться test / abcd1234.
2. В верхнем меню перейти "Управление" > "Панель управления", в разделе "Конфигурация" выбрать пункт горизонтального меню "Настройки" (Рисунок ).

Рисунок — Конфигурация

Заполнить поля:

"Домашний URL" → /c/portal/login;
"Начальная страница после авторизации" → /web/guest/.

Настройка аутентификации:

В боковом меню справа нажать на пункт "Аутентификация".

Вкладка "Общий" → список "Как пользователи будут аутентифицироваться?" → вариант "По экранному имени";
вкладка "LDAP" → отметить чекбоксы "Включен", "Требуется", "Импорт включен", "Включен импорт при запуске" (Рисунок );

Рисунок — Настройка аутентификации

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

Рисунок — Настройки конфигурации LDAP

вкладка "CAS" (Рисунок ) →

отметить чекбоксы "Включен", "Импорт из LDAP";
"URL входа в систему" → https://{ХОСТ С NGINX}/cas/login;
"URL выхода из системы" → https://{ХОСТ С NGINX}/cas/logout?url=http://{ХОСТ С NGINX}/c/portal/login&service=https://{ХОСТ С NGINX} /c/portal/login;
"Имя сервера" → {ХОСТ С NGINX};
"URL сервера" → https://{ХОСТ С NGINX}/cas;
"Нет такого пользователя URL редиректа" → https://{ХОСТ С NGINX}/web/guest/usernotfound;
проверить настройки CAS соответствующей кнопкой.

Рисунок — Настройки CAS

Перезапуск портала

sudo service kck-liferay restart

2.6.Установка модулей на портал ГИС ГМП

Установить сервера и портлеты системы

sudo dpkg -i kck-fs-web-server

sudo dpkg -i kck-mm-mail-server

sudo dpkg -i user-management-portlet

sudo dpkg –i kck-jcp

sudo dpkg –i kck-jdk-7.21

sudo dpkg –i kck-gisgmp-rest-postgres

sudo dpkg –i kck-gisgmp-settings-portlet

sudo dpkg –i kck-gisgmp-rights-portlet

sudo dpkg –i kck-gisgmp-request-portlet

sudo dpkg –i kck-gisgmp-req-answer-portlet

sudo dpkg –i kck-gisgmp-pre-charge-portlet

sudo dpkg –i kck-gisgmp-payment-portlet

sudo dpkg –i kck-gisgmp-organization-portlet

sudo dpkg –i kck-gisgmp-oivrequests-portlet

sudo dpkg –i kck-gisgmp-myoffice-portlet

sudo dpkg –i kck-gisgmp-forgot-pass-portlet

sudo dpkg –i kck-gisgmp-export-portlet

sudo dpkg –i kck-gisgmp-country-portlet

sudo dpkg –i kck-gisgmp-charge-template-portlet

sudo dpkg –i kck-gisgmp-charge-sent-portlet

sudo dpkg –i kck-gisgmp-charge-portlet

sudo dpkg –i kck-gisgmp-archive-portlet

sudo dpkg –i kck-gisgmp-statistic-request-portlet

sudo dpkg –i kck-gisgmp-statistics-portlet

sudo dpkg –i kck-gisgmp-updating-portlet

sudo dpkg –i kck-gisgmp-hook

sudo dpkg –i kck-gisgmp-main-theme

Зайти на портал, сверху выбрать "Administration" > "Pages" и проверить, что первая страница имеет friendly url = /about.

2.7.Установка Шины

Установить JDK:

sudo dpkg -i kck-jdk-7.21

и создать символическую ссылку:

ln –s kck-jdk-7.21 jdk

Установка переменных:

отредактировать файл /etc/bash.bashrc:

export JAVA_HOME=/opt/jdk

export PATH=$PATH:$JAVA_HOME/bin

выполнить: source /etc/profile.

Дальнейшую установку лучше делать с правами суперпользователя: sudo -s

Настроить параметры ядра:

sudo dpkg -i kck-tmof-fix

Установить Шину:

sudo dpkg -i kck-servicemix

sudo dpkg –i kck-activemq

Установка СУБД для Шины осуществляется согласно пунктам 1–7 раздела Error: Reference source not found данной инструкции.
Сконфигурировать БД, следуя инструкциям конфигурационного пакета:

sudo dpkg –i install kck-esb-db-config

Выполнить:

sed -is/prod,federal,mongo/prod,mock,postgres /opt/servicemix/bin/setenv;

aptitude install unzip;

mkdir -p /var/CPROcsp/keys/www-data/;

cd /var/CPROcsp/keys/www-data/;

cp /<�директория с распакованным архивом>/demokck.000.zip /var/CPROcsp/keys/www-data/;

unzip demokck.000.zip;

chown-Rwww-data: /var/CPROcsp/keys/www-data/;

cd /opt/servicemix/etc/;

cp /<директория с распакованным архивом>/siuesb.properties /opt/servicemix/etc/;

chown -Rwww-data: /opt/servicemix/etc/siuesb.properties;

cd /<�директория с распакованным архивом>/;

dpkg -ikck-jcp

Выполнить:

dpkg -i kck-siu-esb-main-jars

и создать пустой файл конфигурации:

touch /opt/servicemix/etc/db.config.properties

Задеплоить бандл сервиса на шину командой:

sudo -u www-data cp [название бандла сервиса] /opt/servicemix/deploy

Выполнить конфигурацию БД Шины:

sudo dpkg -i kck-esb-db-config

и выполнить следующее:

sudo -u postgres psql template1

CREATE ROLE siuesb LOGIN ENCRYPTED PASSWORD 'abcd1234' NOSUPERUSER INHERIT CREATEDB CREATEROLE;

CREATE DATABASE siuesb WITH OWNER = siuesb ENCODING = 'UTF8' TABLESPACE = pg_default LC_COLLATE = 'ru_RU.UTF-8' LC_CTYPE = 'ru_RU.UTF-8' CONNECTION LIMIT = -1;

Проверить настройки Шины:

sudo nano /opt/servicemix/etc/siuesb.properties

Перезагрузить шину:

sudo service kck-servicemix restart

Проверить работоспособность Шины:

запустить консольный клиент;

export JAVA_HOME=/opt/jdk; /opt/servicemix/bin/client -h localhost -u smx -p smx

набрать команду.

list | grep siuesb

Бандлы шины должны быть в состоянии Started (не Installed или Failed).

2.8.Перезапуск компонентов системы СИУМВВ

Перезапуск портала: