|
|
| (не показано 8 промежуточных версий 3 участников) |
| Строка 1: |
Строка 1: |
| Статья описывает установку с помощью инсталляционного скрипта.
| | {{Уведомление|Актуальная документация по версии 5 располагается по адресу https://repo.paycontrol.org/index/safe-tech/#paycontrol}} |
| =Справка скрипта инсталляции=
| |
| <pre>Installation type (just one of them MUST be setted):
| |
| -i install
| |
| | |
| Install options
| |
| -r Register system (only on PCS, matters with -i option)
| |
| | |
| Install wildfly database driver
| |
| -p PostgreSQL
| |
| -o Oracle
| |
| Need to set up parameter - jdbc version:
| |
| 6 for Oracle 11.2, 11gR2 (JDK8)
| |
| 7 for Oracle 12.1, 12cR1 (JDK8)
| |
| 8 for Oracle 12.2, 12cR2 (JDK8) and Oracle 18.3 with JDK8, JDK9, JDK10
| |
| -m MS SQL
| |
|
| |
| Install PC Server roles
| |
| -S PCS
| |
| -I PCIS Internal/ Pusher
| |
| -E PCIS External/ External
| |
| | |
| Examples
| |
| install -i -o 8 -SIE -r
| |
| also like
| |
| install -io8SIEr
| |
| will install Oracle JDBC8 Driver, PCS, PCIS Internal, PCIS External and execute register system request</pre>
| |
| | |
| =Перед установкой компонентов PC сервера=
| |
| Перед установкой необходимо установить JRE.
| |
| =Конфигурирование=
| |
| Перед установкой необходимо сконфигурировать инсталлятор. Предварительно нужно скопировать файл ''install.conf.DEFAULT'' в файл ''install.conf''. Параметры установки необходимо устанавливать в файле ''install.conf'' в разделе <code>CUSTOMER Config</code>
| |
| ==Подключение к БД для PCS и PCP==
| |
| Необходимо установить корректные значения адресов и портов СУБД, имена пользователей и пароли.
| |
| ===СУБД Oracle===
| |
| При использовании СУБД Oracle необходимо указать, каким образом происходит выбор необходимой БД - с помощью SID или Service Name.
| |
| ==Java==
| |
| Установить параметр, указывающий, что используется Java версии 8. Так, например:
| |
| * если используется 8я версия, то параметр <code>IS_JAVA8</code> должен иметь значение <code>true</code>.
| |
| * При использовании версии 11, должно быть установлено значение <code>false</code>.
| |
| ==Настройка PCE для подключения к PCS==
| |
| Для соединения PCE с PCS необходимо указать правильный адрес сервера PC Server по которому он сможет получить к нему доступ.
| |
| ==Пример==
| |
| <syntaxhighlight lang="bash">###################################################
| |
| #
| |
| # CUSTOMER Config
| |
| #
| |
| ###################################################
| |
| | |
| PC_PATH='/opt/pc'
| |
| PC_PRODUCT='PayControl'
| |
| | |
| IS_JAVA8=true
| |
| | |
| # PC Servers Settings
| |
| ## PCS
| |
| ### DB
| |
| PCSDB_HOST='hostname:port'
| |
| PCSDB='DB'
| |
| PCSDB_USER='user'
| |
| PCSDB_PASSWD='password'
| |
| | |
| # Oracle connection string delimiters:
| |
| # - use ':', if PCSDB contains SID
| |
| # - use '/', if PCSDB contains Service Name
| |
| PCSDB_Oracle_delimiter=':'
| |
| | |
| | |
| ## PCIS Internal
| |
| ### APNS Push key
| |
| APNS_AUTH_FILE='safetech-apns-JVBQX52N5Z.p8'
| |
| ### DB
| |
| PCISDB_HOST='hostname:port'
| |
| PCISDB='DB'
| |
| PCISDB_USER='user'
| |
| PCISDB_PASSWD='password'
| |
| | |
| # Oracle connection string delimiters:
| |
| # - use ':', if PCISDB contains SID
| |
| # - use '/', if PCISDB contains Service Name
| |
| PCISDB_Oracle_delimiter=':'
| |
| | |
| ### PCIS External
| |
| PCS_HOSTNAME_PORT='localhost:8080'</syntaxhighlight>
| |
| | |
| =Установка=
| |
| У пользователя, осуществляющего установку должны быть права на выполнение действий с уровнем привилегий root, либо возможность использовать учётную запись root.
| |
| # Скопировать файлы дистрибутива на сервер, например в домашнюю папку пользователя.
| |
| # Перейти в директорию с дистрибутивом.
| |
| # Предоставить права пользователю на исполнение файла-скрипта. Пример:<syntaxhighlight lang="bash">chmod u+x install</syntaxhighlight>
| |
| # Запустить установочный скрипт с привилегиями root, с необходимыми параметрами.
| |
| =Результат выполнения инсталляционного скрипта=
| |
| Результат выполнения инсталляционного скрипта является:
| |
| * установка службы wildflу (директория /opt);
| |
| * включение автозапуска службы wildfly;
| |
| * добавление драйверов СУБД (опционально);
| |
| * добавление источников данных (только для PC Server и PC Pusher);
| |
| * развёртывание файлов сервера в wildfly;
| |
| * регистрация прикладной системы на сервере PC (при установленном параметре "'''r'''"). Результат регистрации - вывод на экран идентификатора системы в конце журнала работы инсталляционного скрипта (systemid). Пример:<syntaxhighlight lang="json">{
| |
| "answer_type": "system_info",
| |
| "answer": {
| |
| "result": {
| |
| "error_message": "Success",
| |
| "error_code": 0
| |
| },
| |
| "system_info": {
| |
| "billing_period": 365,
| |
| "system_id": "e64a67c9-73e9-462c-9c27-2d0195a2bd23",
| |
| "description": "Bank1 Payments",
| |
| "report_template_path": "/opt/pc/report.docx",
| |
| "created_at": "2020-03-23 12:34:1.895",
| |
| "pc_is_external_url": "https://bank1.example.com/pc-client-api/",
| |
| "register_request": "eyJyZXF1ZXN0Ijp7InFyVVJMU2NZXN0Ijp7InFyVoZW1lIjoiIiwiYmnN4enpPQzVwcUttQSsvNzBpc1hWenNzT1Uza0d6L2VURnSZEhTQUFKSZEhTQUFKRXc9PSJXc9PSJFSSZEhTQUFKRXc9PSJEhTQUFKRXc9PSZXN0Ijp7InFyVJ9",
| |
| "pc_is_internal_url": "http://localhost:8080/pc-pusher-api/",
| |
| "is_deleted": false,
| |
| "license_info": {
| |
| "users_count": 20,
| |
| "used": 0,
| |
| "message": "LICENSE NOT FOUND! You are using unlicensed demo-only version of the service"
| |
| },
| |
| "billing_type": 3,
| |
| "user_keys_expiration_period": 365,
| |
| "name": "Bank1"
| |
| }
| |
| },
| |
| "answer_version": 3
| |
| }</syntaxhighlight> В приведённом примере идентификатором зарегистрированной прикладной системы является ''e64a67c9-73e9-462c-9c27-2d0195a2bd23''. В дальнейшем этот идентификатор понадобится при настройке прикладной системы на работу с сервером PC. Если значение идентификатора прикладной системы утеряно, свяжитесь с компанией СэйфТек для его уточнения.
| |
| ==Примеры параметров запуска==
| |
| Примеры ниже приведены для установки компонентов PC сервера с драйвером PostgreSQL (параметр "'''p'''").
| |
| ===Всё на одном сервере===
| |
| ====Без регистрации прикладной системы====
| |
| <syntaxhighlight lang="bash">sudo ./install -ipSIE</syntaxhighlight>
| |
| ====С регистрацией прикладной системы====
| |
| <syntaxhighlight lang="bash">sudo ./install -ipSIEr</syntaxhighlight>
| |
| ===PC Server===
| |
| ====Без регистрации прикладной системы====
| |
| <syntaxhighlight lang="bash">sudo ./install -ipS</syntaxhighlight>
| |
| ====С регистрацией прикладной системы====
| |
| <syntaxhighlight lang="bash">sudo ./install -ipSr</syntaxhighlight>
| |
| ===PC Pusher===
| |
| <syntaxhighlight lang="bash">sudo ./install -ipI</syntaxhighlight>
| |
| ===PC External===
| |
| <syntaxhighlight lang="bash">sudo ./install -iE</syntaxhighlight>
| |
| =Контроль=
| |
| ==Вывод журнала в консоль в реальном времени==
| |
| <syntaxhighlight lang="bash">tail -n 300 -f /opt/wildfly/standalone/log/server.log</syntaxhighlight>
| |
| ==Просмотр успешности развёртывания компонентов сервера==
| |
| <syntaxhighlight lang="bash">ls -la /opt/pc/deployments/</syntaxhighlight>
| |
| Если компонент сервера развёрнут успешно, рядом с файлом компонента сервера создаётся файл с аналогичным именем файлу сервера с расширением "'''.deployed'''".
| |
| | |
| ==Проверка доступности сервисов==
| |
| При запросе на серверы по указанным ниже эндпоинтам будут выведены название модуля сервера PC, его версия и версия API.
| |
| ===PC Server===
| |
| <pre>http://<IP или имя сервера PC Server>:8080/pc-api/health_check/</pre>
| |
| ===PC Pusher===
| |
| <pre>http://<IP или имя сервера PC Pusher>:8080/pc-pusher-api/health_check/</pre>
| |
| ===PC External===
| |
| <pre>http://<IP или имя сервера PC External>:8080/pc-client-api/health_check/</pre>
| |
| | |
| =Внесение изменений в БД=
| |
| ==Создание индексов БД PCS==
| |
| Для создания индексов необходимо выполнить следующие запросы к БД PCS:
| |
| <syntaxhighlight lang="sql">create index pc_keyinfo1_idx on PC_KEYINFO (userID, expiration_date, is_deleted);
| |
| create index pc_delayedkeyinfo1_idx on PC_DELAYEDKEYINFO (userID, is_deleted);
| |
| create index pc_device1_idx on PC_DEVICE (userID, is_deleted);
| |
| create index pc_transaction1_idx on PC_TRANSACTION (userID, status);
| |
| create index pc_device2_idx on PC_DEVICE (userID);
| |
| create index pc_keyinfo2_idx on PC_KEYINFO (userID);
| |
| create index pc_transaction2_idx on PC_TRANSACTION (userID);
| |
| create index pc_user1_idx on PC_USER (systemID);</syntaxhighlight>
| |
| ==Корректировка типов данных для MS SQL==
| |
| Для корректировки типов данных необходимо выполнить следующий запрос к БД PC Server:
| |
| <syntaxhighlight lang="sql">ALTER TABLE PC_TRANSACTION ALTER COLUMN DATA_BINARY image;</syntaxhighlight>
| |
| =Внесение аутентификационных данных для отправки push-уведомлений=
| |
| {{Предупреждение|Для отличных от PostgreSQL СУБД измените метод работы с последовательностями}}
| |
| | |
| Для '''MSSQL''' необходимо вместо строк <code>nextval('pc_split_pusher_creds_seq'),</code> использовать строку <code>NEXT VALUE FOR pc_split_pusher_creds_seq,</code>.
| |
| | |
| Для '''Oracle''' необходимо вместо строк <code>nextval('pc_split_pusher_creds_seq'),</code> использовать строку <code>pc_split_pusher_creds_seq.NEXTVAL,</code>.
| |
| ==В приложение PayControl==
| |
| Для внесение аутентификационных данных для отправки push-уведомлений в приложение PayControl необходимо выполнить следующие запросы к БД PC Pusher, заменив значения %SYSTEMID% на корректное.
| |
| | |
| Обратите внимание, что знаки процента '''нужно удалить'''.
| |
| | |
| После выполнения запросов необходимо [[Руководство_администратора_PayControl_5#Запуск и остановка служб сервера PayControl|перезапустить Wildfly]] сервера PC Pusher.
| |
| | |
| Пример для СУБД PostgreSQL:
| |
| <syntaxhighlight lang="sql">INSERT INTO pc_split_pusher_credentials (
| |
| id,
| |
| appid,
| |
| credentials,
| |
| os,
| |
| systemid)
| |
| VALUES (
| |
| nextval('pc_split_pusher_creds_seq'),
| |
| 'org.paycontrol.app',
| |
| '{"google_api_key":"AAAAoZ7vyz4:APA91bFqLfNegQCs_GfHGFeOmS68PHWWSzWpeZaYKfnLul9iHufIQJiNIAjgAykeWrTxiDDs9qQzullXww3o5XR0VS9tlBEpuhTMlz4CyHdmN2EhntJBBUlSQa-8--Rw_UzDbKBCGCXk"}',
| |
| 'Android',
| |
| '%SYSTEMID%');
| |
| | |
| INSERT INTO pc_split_pusher_credentials (
| |
| id,
| |
| appid,
| |
| credentials,
| |
| os,
| |
| systemid)
| |
| VALUES (
| |
| nextval('pc_split_pusher_creds_seq'),
| |
| 'org.paycontrol.app',
| |
| '{"apns_key_file":"/opt/wildfly/safetech-apns-JVBQX52N5Z.p8","apns_key_id":"JVBQX52N5Z","apns_team_id":"48HZH4RWJD"}',
| |
| 'iOS',
| |
| '%SYSTEMID%');</syntaxhighlight>
| |
| | |
| ==В приложение PayConfirm==
| |
| Для внесение аутентификационных данных для отправки push-уведомлений в приложение PayConfirm необходимо выполнить следующие запросы к БД PC Pusher, заменив значения %SYSTEMID% на корректное. После выполнения запросов необходимо [[Руководство_администратора_PayControl_5#Запуск и остановка служб сервера PayControl|перезапустить Wildfly]] сервера PC Pusher.
| |
| | |
| Пример для СУБД PostgreSQL:
| |
| <syntaxhighlight lang="sql">INSERT INTO pc_split_pusher_credentials (
| |
| id,
| |
| appid,
| |
| credentials,
| |
| os,
| |
| systemid)
| |
| VALUES (
| |
| nextval('pc_split_pusher_creds_seq'),
| |
| 'org.payconfirm.app',
| |
| '{"google_api_key":"AAAA4H70m7M:APA91bFsaPiXXiIuRyj4h-xGZpyd0-I3B9F1udIIergxaK8uL9vPPvUQXOvPfau2w8E-xur_6TlTzmhb2JsO13hBCxVDrNybD6Rj8k4hZKXfs7tC5fnJuWmCIB3-O_4dLo0QHlhfSbGn"}',
| |
| 'Android',
| |
| '%SYSTEMID%');
| |
| | |
| INSERT INTO pc_split_pusher_credentials (
| |
| id,
| |
| appid,
| |
| credentials,
| |
| os,
| |
| systemid)
| |
| VALUES (
| |
| nextval('pc_split_pusher_creds_seq'),
| |
| 'org.payconfirm.app',
| |
| '{"apns_key_file":"/opt/pc/AuthKey_QCC684AGC4.p8","apns_key_id":"QCC684AGC4","apns_team_id":"B98K5P3YHV"}',
| |
| 'iOS',
| |
| '%SYSTEMID%');</syntaxhighlight>
| |
| | |
| ==В другое мобильное приложение==
| |
| Для внесение аутентификационных данных для отправки push-уведомлений необходимо выполнить запрос к БД PC Pusher, заменив значение %SYSTEMID%, %appid%, %путь к файлу ключа%, %apns_key_id%, %apns_team_id%, %google_api_key% на корректные (эти данные, за исключением %SYSTEMID%, можно получить от разработчика мобильного приложения):
| |
| <syntaxhighlight lang="sql">
| |
| INSERT INTO pc_split_pusher_credentials (
| |
| id,
| |
| appid,
| |
| credentials,
| |
| is_default,
| |
| os,
| |
| systemid)
| |
| VALUES (
| |
| nextval('pc_split_pusher_credentials_id_seq'),
| |
| '%appid%',
| |
| '{"google_api_key":"%google_api_key%"}',
| |
| 1,
| |
| 'Android',
| |
| '%SYSTEMID%');
| |
| | |
| INSERT INTO pc_split_pusher_credentials (
| |
| id,
| |
| appid,
| |
| credentials,
| |
| is_default,
| |
| os,
| |
| systemid)
| |
| VALUES (
| |
| nextval('pc_split_pusher_credentials_id_seq'),
| |
| '%appid%',
| |
| '{"apns_key_file":"%путь к файлу ключа%","apns_key_id":"%apns_key_id%","apns_team_id":"%apns_team_id%"}',
| |
| 1,
| |
| 'iOS',
| |
| '%SYSTEMID%');
| |
| | |
| commit;
| |
| </syntaxhighlight>
| |
| | |
| =Корректировка (смена) адресов компонентов серверов PC (при необходимости)=
| |
| {{Предупреждение|Не рекомендуется дополнительно указывать номер порта, в случаях, если для HTTP используется порт 80, или для HTTPS используется порт 443}}
| |
| ==Учёт изменения адреса сервера PC Server==
| |
| Для учёта изменения адреса PCS необходимо произвести изменения в настройках PCE. В файле /opt/wildfly/bin/standalone.conf, в следующей строке, указав правильный адрес и при необходимости порт сервера PC Server, а также уточнив протокол подключения (HTTP/HTTPS):
| |
| <syntaxhighlight lang="bash">
| |
| JAVA_OPTS="$JAVA_OPTS -Dpc_url=http[s]://<IP или DNS-имя>[:PORT]/pc-api/ -Duser.language=ru -Dpc_locale=ru"
| |
| </syntaxhighlight>
| |
| | |
| ==Учёт изменения адреса сервера PC Pusher==
| |
| Для учёта изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
| |
| <syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>[:PORT]/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>
| |
| ==Учёт изменения внешнего адреса сервера PC External==
| |
| {{Предупреждение|Если система была переведена в промышленную эксплуатацию, при смене адреса для доступа мобильных устройств, не рекомендуется выводить из действия предыдущий адрес на протяжении всего срока действия выпущенных ключей пользователя. Иначе мобильное приложение потеряет доступ к серверу PC и для восстановления будет необходимо перевыпустить ключ и заново добавить его в приложение пользователя.}}
| |
| Для учёта изменения внешнего адреса сервера PC, по которому связываются мобильное приложение с сервером PC, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
| |
| <syntaxhighlight lang="sql">update pc_system set pc_is_external_url = 'http[s]://<IP или DNS-имя>[:PORT]/pc-client-api/' where systemid='<SYSTEMID>';</syntaxhighlight>
| |
