PayControl Wiki - Вклад [ru]

Установка PayControl v5. Linux

2020-05-08T11:18:21Z

P.melnichenko: /* В приложение 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/pc/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>

Установка компонентов сервера PayControl v5 вручную

2020-01-13T14:42:05Z

P.melnichenko:

==Подготовка БД==
* Создать базу данных и пользователя на сервере СУБД, где будет работать база данных PCS (pcs-user, pcs-pass, pcs-db, pcs-db-host). Предоставить права на доступ пользователю к БД.
* Создать базу данных и пользователя на сервере СУБД, где будет работать база данных PCIS (pcis-user, pcis-pass, pcis-db, pcis-db-host). Предоставить права на доступ пользователю к БД.
==Установка Java==
Установить последнюю версию JRE ветки 1.8 или 11
===Обновление Security===
Для версии JRE 1.8:
* Скачать архив по адресу http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html
* Распаковать и скопировать файлы по адресу ''<JRE>\lib\security\'', заменив старые версии.

Для версии JRE 11 - аналогично
==Установка Wildfly==
* Скачать и распаковать актуальную версию WildFly Server. (При распаковке рекомендуется исключить кириллические символы в пути, а также пробелы.)
https://wildfly.org/downloads/
* Создать символьную ссылку, к примеру ''C:\wildfly'', на распакованную директорию. Пример команды:
<syntaxhighlight lang="bat">mklink /D c:\wildfly c:\wildfly-18.0.1.Final\</syntaxhighlight>
Далее по тексту, под <WF_PATH> имеется в виду адрес созданной символьной ссылки.
===Добавление JDBC-драйвера СУБД===
====MS SQL====
* Скачать JDBC-драйвер с сайта Microsoft https://docs.microsoft.com/ru-ru/sql/connect/jdbc/download-microsoft-jdbc-driver-for-sql-server?view=sql-server-ver15
* Создать директорию ''<WF_PATH>/modules/system/layers/base/com/microsoft/sqlserver/main/''
* В директорию распаковать файлы и директории драйвера. Файлы драйвера (*.jar) должны располагаться непосредственно в директории ''main/''
* Создать в этой же папке файл module.xml следующего содержания
<syntaxhighlight lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.3" name="com.microsoft.sqlserver">
<resources>

<resource-root path="JAR_PATH"/>
</resources>
<dependencies>
<module name="javax.api"/>
<module name="javax.transaction.api"/>
<module name="javax.xml.bind.api"/>
</dependencies>
</module>
</syntaxhighlight>
===Настройка standalone.xml===
В файл ''<WF_PATH>/standalone/configuration/standalone.xml'' внести следующие изменения
* Добавить новый источник данных (секция ''<datasources>''):
<syntaxhighlight lang="xml">

<datasource jta="true" jndi-name="java:jboss/datasources/PCServerDS" pool-name="PCServerDS" enabled="true" use-ccm="true">
<connection-url>jdbc:sqlserver://pcs-db-host:port;databaseName=pcs-db</connection-url>
<connection-property name="url">
jdbc:sqlserver://pcs-db-host:port;databaseName=pcs-db
</connection-property>
<driver>mssql</driver>
<security>
<user-name>pcs-user</user-name>
<password>pcs-pass</password>
</security>
<pool>
<min-pool-size>5</min-pool-size>
<max-pool-size>50</max-pool-size>
<prefill>false</prefill>
<use-strict-min>false</use-strict-min>
<flush-strategy>FailingConnectionOnly</flush-strategy>
</pool>
<validation>
<valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLValidConnectionChecker"></valid-connection-checker>
</validation>
</datasource>


<datasource jta="true" jndi-name="java:jboss/datasources/PCPusherDS" pool-name="PCPusherDS" enabled="true" use-ccm="true">
<connection-url>jdbc:sqlserver://pcis-db-host:port;databaseName=pcis-db</connection-url>
<connection-property name="url">
jdbc:sqlserver://pcis-db-host:port;databaseName=pcis-db
</connection-property>
<driver>mssql</driver>
<security>
<user-name>pcis-user</user-name>
<password>pcis-pass</password>
</security>
<pool>
<min-pool-size>5</min-pool-size>
<max-pool-size>50</max-pool-size>
<prefill>false</prefill>
<use-strict-min>false</use-strict-min>
<flush-strategy>FailingConnectionOnly</flush-strategy>
</pool>
<validation>
<valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLValidConnectionChecker"></valid-connection-checker>
</validation>
</datasource>
</syntaxhighlight>
* Добавить новый драйвер (секция ''<datasources/drivers>'')
<syntaxhighlight lang="xml">
<driver name="mssql" module="com.microsoft.sqlserver">
<driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class>
</driver>
</syntaxhighlight>
*Удалить источник данных по умолчанию и welcome-page
При конфигурировании Wildfly можно (при переводе системы в промышленную эксплуатацию - рекомендуется) удалить пример источника данных и страницу-приветствие. Для этого в файле standalone.xml необходимо убрать (либо закомментировать) следующие объекты:
<syntaxhighlight lang="xml">
<datasource jndi-name="java:jboss/datasources/ExampleDS" pool-name="ExampleDS" enabled="true" use-java-context="true">
<connection-url>jdbc:h2:mem:test;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE</connection-url>
<driver>h2</driver>
<security>
<user-name>sa</user-name>
<password>sa</password>
</security>
</datasource>
</syntaxhighlight>
<syntaxhighlight lang="xml">
<driver name="h2" module="com.h2database.h2">
<xa-datasource-class>org.h2.jdbcx.JdbcDataSource</xa-datasource-class>
</driver>
</syntaxhighlight>
<syntaxhighlight lang="xml">
<default-bindings context-service="java:jboss/ee/concurrency/context/default" datasource="java:jboss/datasources/ExampleDS" managed-executor-service="java:jboss/ee/concurrency/executor/default" managed-scheduled-executor-service="java:jboss/ee/concurrency/scheduler/default" managed-thread-factory="java:jboss/ee/concurrency/factory/default"/>
</syntaxhighlight>
<syntaxhighlight lang="xml">
<location name="/" handler="welcome-content"/>
</syntaxhighlight>
<syntaxhighlight lang="xml">
<handlers>
<file name="welcome-content" path="${jboss.home.dir}/welcome-content"/>
</handlers>
</syntaxhighlight>
===Настройка standalone.conf.bat===
В файл ''<WF_PATH>/bin/standalone.conf.bat'' внести следующие изменения:

* На всех серверах установить максимальный объем используемой памяти, равный ''ОбщийОбъёмОЗУ - 1536MB''
Для этого в строке
''JAVA_OPTS="-Xms64m -Xmx512m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djava.net.preferIPv4Stack=true"'' поменять параметр ''Xmx''

* На сервере PayControl External необходимо установить адрес сервера PC Server (host и port заменить на реальные значения)
<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpc_url=http://<host>:<port>/pc-api/ -Dpc_locale=ru"</syntaxhighlight>

* При необходимости отладки сообщений от мобильных устройств на PayControl External, можно включить вывод отладочной информации
<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpc_logRequests=true"</syntaxhighlight>
==Запуск проекта==
* Скопировать файл приложения сервера ''<WF_PATH>\standalone\deployments\'':
** на PC Server - файл ''pc-server-<VERSION>.ear''
** на PC Pusher - файл ''pc-pusher-<VERSION>.war''
** на PC External - файл ''pc-external-<VERSION>.war''
Один сервер WildFly может запускать одно или несколько приложений сервера
* Запустить <syntaxhighlight lang="bat"><WF_PATH>\bin\standalone.bat -b 0.0.0.0</syntaxhighlight> где -b 0.0.0.0 - позволяет подключаться к серверу используя любой его интерфейс (опция bind)
* Дождаться старта WF, проверить, что нет ошибок запуска.
==Настройка автозапуска службы сервера==
Скопировать папку 
''<WF_PATH>\docs\contrib\scripts\service\'' 
в папку 
''<WF_PATH>\bin\'' 
Выполнить
<syntaxhighlight lang="bat"><WF_PATH>\bin\service\service.bat install /startup</syntaxhighlight>
При запуске в качестве службы, возможно отклонение запросов. В таком случае необходимо установить параметры JAVA_OPTS в файле standalone.conf.bat или standalone.bat, если установленные в предыдущем файле параметры не применяются.
<syntaxhighlight lang="bat">JAVA_OPTS=%JAVA_OPTS% -Djboss.bind.address=0.0.0.0</syntaxhighlight>
==URL-фильтрация при совмещении PC Pusher и PC External==
При совмещении ролей PC Pusher и PC External на одном сервере необходимо исключить возможность выполнения запросов PC Pusher со стороны сети интернет. 
Для этого необходимо со стороны сети интернет разрешить подключения только на конечную точку PC External. 
Конечная точка PC External - ''<host>:<port>/pc-client-api/*'' 
Доступ к другим конечным точкам должен быть запрещен.

При этом доступ к PC Pusher со стороны PC Server должен сохраниться. 
Конечная точка PC Pusher - ''<host>:<port>/pc-pusher-api/*''
==Создание индексов в базе данных==
После первого запуска приложения, в базе данных будут созданы необходимые таблицы.

На продуктивной среде после этого необходимо создать индексы в базе данных PC Server.

Для этого выполните SQL скрипт:
<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==
Java-приложение при создании таблиц БД неоптимально устанавливает тип для одного из полей для СУБД MS SQL.

Для его корректировки после того, как таблицы созданы, выполните запрос
<syntaxhighlight lang="sql">
ALTER TABLE PC_TRANSACTION ALTER COLUMN DATA_BINARY image;
</syntaxhighlight>
==Регистрация системы==
После успешного запуска приложения PC Server до начала работы необходимо зарегистрировать прикладную систему.

Это действие выполняется путем отправки на PC Server запроса, сформированного ST/Airome. Содержание запроса предоставляется дополнительно.

Для отправки запроса можно использовать любое средство отправки HTTP-запросов, например, cURL

<syntaxhighlight lang="curl">
curl --location --request POST 'http://<host>:<port>/pc-api/' \
--header 'Content-Type: application/json' \
--data-raw '{
"request":"eyJyZXF1ZXN0Ijp... [request content]"
}'
</syntaxhighlight>
==Доступ к сервисам==
Адреса конечных точек по умолчанию:
* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8080/pc-pusher-api/
* PC External - http://<host>:8080/pc-client-api/

===Health Check===
Адреса конечных точек health check:
* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8080/pc-pusher-api/health_check
* PC External - http://<host>:8080/pc-client-api/health_check

Установка компонентов сервера PayControl v5 вручную

2020-01-13T13:58:08Z

P.melnichenko: Новая страница: «==Подготовка БД== * Создать базу данных и пользователя на сервере СУБД, где будет работать…»

==Подготовка БД==
* Создать базу данных и пользователя на сервере СУБД, где будет работать база данных PCS (pcs-user, pcs-pass, pcs-db, pcs-db-host). Предоставить права на доступ пользователю к БД.
* Создать базу данных и пользователя на сервере СУБД, где будет работать база данных PCIS (pcis-user, pcis-pass, pcis-db, pcis-db-host). Предоставить права на доступ пользователю к БД.
==Установка Java==
Установить последнюю версию JRE ветки 1.8 или 11
===Обновление Security===
Для версии JRE 1.8:
* Скачать архив по адресу http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html
* Распаковать и скопировать файлы по адресу ''<JRE>\lib\security\'', заменив старые версии.

Для версии JRE 11 - аналогично
==Установка Wildfly==
* Скачать и распаковать актуальную версию WildFly Server. (При распаковке рекомендуется исключить кириллические символы в пути, а также пробелы.)
https://wildfly.org/downloads/
* Создать символьную ссылку, к примеру ''C:\wildfly'', на распакованную директорию. Пример команды:
<syntaxhighlight lang="bat">mklink /D c:\wildfly c:\wildfly-18.0.1.Final\</syntaxhighlight>
Далее по тексту, под <WF_PATH> имеется в виду адрес созданной символьной ссылки.
===Добавление JDBC-драйвера СУБД===
====MS SQL====
* Скачать JDBC-драйвер с сайта Microsoft https://docs.microsoft.com/ru-ru/sql/connect/jdbc/download-microsoft-jdbc-driver-for-sql-server?view=sql-server-ver15
* Создать директорию ''<WF_PATH>/modules/system/layers/base/com/microsoft/sqlserver/main/''
* В директорию распаковать файлы и директории драйвера. Файлы драйвера (*.jar) должны располагаться непосредственно в директории ''main/''
* Создать в этой же папке файл module.xml следующего содержания
<syntaxhighlight lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.3" name="com.microsoft.sqlserver">
<resources>

<resource-root path="JAR_PATH"/>
</resources>
<dependencies>
<module name="javax.api"/>
<module name="javax.transaction.api"/>
<module name="javax.xml.bind.api"/>
</dependencies>
</module>
</syntaxhighlight>
===Настройка standalone.xml===
В файл ''<WF_PATH>/standalone/configuration/standalone.xml'' внести следующие изменения
* Добавить новый источник данных (секция ''<datasources>''):
<syntaxhighlight lang="xml">

<datasource jta="true" jndi-name="java:jboss/datasources/PCServerDS" pool-name="PCServerDS" enabled="true" use-ccm="true">
<connection-url>jdbc:sqlserver://pcs-db-host:port;databaseName=pcs-db</connection-url>
<connection-property name="url">
jdbc:sqlserver://pcs-db-host:port;databaseName=pcs-db
</connection-property>
<driver>mssql</driver>
<security>
<user-name>pcs-user</user-name>
<password>pcs-pass</password>
</security>
<pool>
<min-pool-size>5</min-pool-size>
<max-pool-size>50</max-pool-size>
<prefill>false</prefill>
<use-strict-min>false</use-strict-min>
<flush-strategy>FailingConnectionOnly</flush-strategy>
</pool>
<validation>
<valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLValidConnectionChecker"></valid-connection-checker>
</validation>
</datasource>


<datasource jta="true" jndi-name="java:jboss/datasources/PCPusherDS" pool-name="PCPusherDS" enabled="true" use-ccm="true">
<connection-url>jdbc:sqlserver://pcis-db-host:port;databaseName=pcis-db</connection-url>
<connection-property name="url">
jdbc:sqlserver://pcis-db-host:port;databaseName=pcis-db
</connection-property>
<driver>mssql</driver>
<security>
<user-name>pcis-user</user-name>
<password>pcis-pass</password>
</security>
<pool>
<min-pool-size>5</min-pool-size>
<max-pool-size>50</max-pool-size>
<prefill>false</prefill>
<use-strict-min>false</use-strict-min>
<flush-strategy>FailingConnectionOnly</flush-strategy>
</pool>
<validation>
<valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLValidConnectionChecker"></valid-connection-checker>
</validation>
</datasource>
</syntaxhighlight>
* Добавить новый драйвер (секция ''<datasources/drivers>'')
<syntaxhighlight lang="xml">
<driver name="mssql" module="com.microsoft.sqlserver">
<driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class>
</driver>
</syntaxhighlight>
===Настройка standalone.conf.bat===
В файл ''<WF_PATH>/bin/standalone.conf.bat'' внести следующие изменения:
* На сервере PayControl External необходимо установить адрес сервера PC Server (host и port заменить на реальные значения)
<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpc_url=http://<host>:<port>/pc-api/ -Dpc_locale=ru"</syntaxhighlight>

* При необходимости отладки сообщений от мобильных устройств на PayControl External, можно включить вывод отладочной информации
<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpc_logRequests=true"</syntaxhighlight>
==Запуск проекта==
* Скопировать файл приложения сервера ''<WF_PATH>\standalone\deployments\'':
** на PC Server - файл ''pc-server-<VERSION>.ear''
** на PC Pusher - файл ''pc-pusher-<VERSION>.war''
** на PC External - файл ''pc-external-<VERSION>.war''
Один сервер WildFly может запускать одно или несколько приложений сервера
* Запустить <syntaxhighlight lang="bat"><WF_PATH>\bin\standalone.bat -b 0.0.0.0</syntaxhighlight> где -b 0.0.0.0 - позволяет подключаться к серверу используя любой его интерфейс (опция bind)
* Дождаться старта WF, проверить, что нет ошибок запуска.
==Настройка автозапуска службы сервера==
Скопировать папку 
''<WF_PATH>\docs\contrib\scripts\service\'' 
в папку 
''<WF_PATH>\bin\'' 
Выполнить
<syntaxhighlight lang="bat"><WF_PATH>\bin\service\service.bat install /startup</syntaxhighlight>
При запуске в качестве службы, возможно отклонение запросов. В таком случае необходимо установить параметры JAVA_OPTS в файле standalone.conf.bat или standalone.bat, если установленные в предыдущем файле параметры не применяются.
<syntaxhighlight lang="bat">JAVA_OPTS=%JAVA_OPTS% -Djboss.bind.address=0.0.0.0</syntaxhighlight>
==URL-фильтрация при совмещении PC Pusher и PC External==
При совмещении ролей PC Pusher и PC External на одном сервере необходимо исключить возможность выполнения запросов PC Pusher со стороны сети интернет. 
Для этого необходимо со стороны сети интернет разрешить подключения только на конечную точку PC External. 
Конечная точка PC External - ''<host>:<port>/pc-client-api/*'' 
Доступ к другим конечным точкам должен быть запрещен.

При этом доступ к PC Pusher со стороны PC Server должен сохраниться. 
Конечная точка PC Pusher - ''<host>:<port>/pc-pusher-api/*''
==Создание индексов в базе данных==
После первого запуска приложения, в базе данных будут созданы необходимые таблицы.

На продуктивной среде после этого необходимо создать индексы в базе данных PC Server.

Для этого выполните SQL скрипт:
<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>
==Регистрация системы==
После успешного запуска приложения PC Server до начала работы необходимо зарегистрировать прикладную систему.

Это действие выполняется путем отправки на PC Server запроса, сформированного ST/Airome. Содержание запроса предоставляется дополнительно.

Для отправки запроса можно использовать любое средство отправки HTTP-запросов, например, cURL

<syntaxhighlight lang="curl">
curl --location --request POST 'http://<host>:<port>/pc-api/' \
--header 'Content-Type: application/json' \
--data-raw '{
"request":"eyJyZXF1ZXN0Ijp... [request content]"
}'
</syntaxhighlight>
==Доступ к сервисам==
Адреса конечных точек по умолчанию:
* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8080/pc-pusher-api/
* PC External - http://<host>:8080/pc-client-api/

===Health Check===
Адреса конечных точек health check:
* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8080/pc-pusher-api/health_check
* PC External - http://<host>:8080/pc-client-api/health_check

Обновление PCIS до версии 3.7

2019-09-02T13:16:41Z

P.melnichenko:

В связи с подготовкой выхода новой версии мобильного приложения PayControl было подготовлено обновление сервера с целью обеспечения:
* поддержки тем оформления одновременно для нового и классического приложения;
* поддержки возможности отправки Push-уведомлений в разные приложения, в зависимости от того, какое установлено у пользователя.
=Описание=
==Обновляемые компоненты==
Обновление необходимо только для компонентов PCIS Internal и PCIS External. Это компоненты, обеспечивающие взаимодействие с мобильным приложением.

Основной компонент PC Sever (PCS), содержащий информацию о пользователях и выполняющий основные функции PayControl, обновления не требует.

==Совместимость==
PCIS Internal 3.7 и PCIS External 3.7 совместимы с PCS версий 3.5-3.7.
==PCIS Internal==
В зависимости от того, какое мобильное приложение пользователь зарегистрировал на сервере – Push-уведомления будут предаваться в соответствуюее. До версии 3.7 для каждой прикладной системы можно было настроить только одно приложение для отправки уведомлений.
==PCIS External==
После обновления модуля сервера появляется возможность публикации файлов тем для классического и нового мобильного приложения:
* Для классического приложения, как и раньше, необходимо опубликовать файл оформления в <WILDFLY_PATH>/paycontrol_skins/<SYSTEMID>.zip (если по этому пути уже опубликован файл оформления, то ничего не изменится, он будет публиковаться как и раньше).
* Для новых версий мобильного приложения необходимо в директорию <WILDFLY_PATH>/pc_themes/<НОМЕР ВЕРСИИ МОБИЛЬНОГО ПРИЛОЖЕНИЯ>/ разместить новый файл оформления с именем в формате "<SYSTEMID>.zip".
Кроме того, для новых версий приложения появился механизм обновления оформления, даже в случае, если файл оформления уже был скачан на мобильное устройство - приложение будет делать это автоматически при размещении на сервере обновлённого файла темы оформления.
= Процесс обновления =
Для обновления необходимо заменить на серверах файлы модулей PCIS Internal и PCIS External в директории ''deployments'' сервера приложений [[Wildfly]]. Они имеют названия вида:
* PayControl-interaction-module-3.6.359.ear - PCIS Internal;
* PayControl-interaction-rest-3.6.360.war - PCIS External.
Файлы сервера предыдущей версии настоятельно рекомендуем сохранить для возможности отката на предыдущую версию.

После замены файлов и развёртывания новых в директории ''deployments'' будут созданы файлы с названиями:
* *.undeployed, где вместо * будет указано название убранного из директории файла модуля сервера. Файлы с расширением undeployed рекомендуется удалить.
* и с расширением *.deployed, где вместо * будут указаны названия новых модулей.

== Изменения в БД PCIS ==
После отправки первого первого Push-уведомления в БД PCIS будет создана таблица ''pc_split_pusher_credentials'' в которую будут скопированы аутентификационные данные APNS и Firebase для отправки Push-уведомлений. Таблица ''pc_push_credentials'' в дальнейшем использоваться не будет.
В таблице pc_sys_property будет добавлена запись:
{| class="wikitable"
|-
!setting_id!!setting_name!!setting_value
|-
|...||USE_SPLIT_PUSHER||1/0
|-
|}
Где значение поля setting_id будет установлено автоматически используя значение счётчика записей таблицы, а значение в поле setting_value будет установлено следующим образом:
* 1 - данные из таблицы ''pc_push_credentials'' успешно перенесены в таблицу ''pc_split_pusher_credentials''. Для отправки будут использоваться данные из ''pc_split_pusher_credentials''.
* 0 - при переносе данных из таблицы ''pc_push_credentials'' возникли проблемы. Для отправки будут использоваться данные из ''pc_push_credentials''.
Если такая запись не была создана, значит попытка отправки Push-уведомления не производилась.
== Описание процесса отката изменений ==
При возникновении проблем при обновлении необходимо удалить новый файл модуля сервера и заменить его старым файлом. При замене файлов необходимо проверить, что в директории ''deployments'' отсутствуют файлы с расширением undeployed.

PayControl3.x Регистрация прикладной системы

2018-11-23T15:34:08Z

P.melnichenko: /* Регистрация при помощи curl */

PayControl в своей работе оперирует понятием Прикладная система. 
Это идентификатор в формате GUID, который идентифицирует систему, работающую с PayControl. 
К Прикладной системе привязаны пользователи, к ним, в свою очередь, ключи, транзакции и прочее. 
К свойствам Прикладной системы относятся URL-ы для взаимодействия с сервером, различные настройки и пр.

=Запрос на регистрацию=
Запрос на регистрацию Прикладной системы формируется в SafeTech и, при необходимости, передаётся Заказчику в текстовом виде.
Для формирования запроса необходимы следующие параметры:
# Название системы
# Описание системы (произвольное)
# URL PayControl Interaction Server (External) - адрес, на который будут обращаться мобильные устройства
# URL PayControl Interaction Server (Internal) - адрес сервиса отправки пуш-уведомлений (может быть PC Inform)
# Срок жизни ключей
# Тип биллинга (Pre-pay, Post-pay)
# Биллинговый период

=Регистрация при помощи SOAP UI=
Для выполнения запроса через графический интерфейс SOAP UI необходимо
# Скачать и установить SOAP UI https://www.soapui.org/downloads/soapui.html
# Добавить новый проект SOAP
# В поле "Initial WSDL" вписать адрес PayControl Server (например, https://dev.paycontrol.org/ws/PayControlServiceV3?wsdl), указать удобное название, нажать "Ок"
# Раскрыть созданный проект
# Выбрать запрос registerSystem -> Request 1
# В тег '''request''' вместо знака '''?''' вставить запрос, полученный от SafeTech
# Нажать кнопку "Выполнить запрос"
# В области ответа должен появиться ответ от сервиса с указанием '''systemId''', либо ошибка с описанием

=Регистрация при помощи curl=
Запрос может быть выполнен при помощи программы curl
:: 1. Создайте файл с запросом на регистрацию, например request.xml, следующего содержания:
:::<syntaxhighlight lang="xml"><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pay="http://ws.safetech.ru/PayControlV3/">
<soapenv:Header/>
<soapenv:Body>
<pay:registerSystemRequest>
<request>[запрос на регистрацию, полученный от SafeTech]</request>
</pay:registerSystemRequest>
</soapenv:Body>
</soapenv:Envelope></syntaxhighlight>
:: 2. Выполните команду
:::<syntaxhighlight lang="bash">curl --header "Content-Type: text/xml;charset=UTF-8" --header "SOAPAction: registerSystem" --data @request.xml http://<host>:<port>/ws/PayControlServiceV3</syntaxhighlight>
:: 3. В ответ должен быть получен XML-ответ от сервиса с указанием '''systemId''', либо ошибка с описанием

PayControl3.x Регистрация прикладной системы

2018-11-23T15:33:11Z

P.melnichenko:

PayControl в своей работе оперирует понятием Прикладная система. 
Это идентификатор в формате GUID, который идентифицирует систему, работающую с PayControl. 
К Прикладной системе привязаны пользователи, к ним, в свою очередь, ключи, транзакции и прочее. 
К свойствам Прикладной системы относятся URL-ы для взаимодействия с сервером, различные настройки и пр.

=Запрос на регистрацию=
Запрос на регистрацию Прикладной системы формируется в SafeTech и, при необходимости, передаётся Заказчику в текстовом виде.
Для формирования запроса необходимы следующие параметры:
# Название системы
# Описание системы (произвольное)
# URL PayControl Interaction Server (External) - адрес, на который будут обращаться мобильные устройства
# URL PayControl Interaction Server (Internal) - адрес сервиса отправки пуш-уведомлений (может быть PC Inform)
# Срок жизни ключей
# Тип биллинга (Pre-pay, Post-pay)
# Биллинговый период

=Регистрация при помощи SOAP UI=
Для выполнения запроса через графический интерфейс SOAP UI необходимо
# Скачать и установить SOAP UI https://www.soapui.org/downloads/soapui.html
# Добавить новый проект SOAP
# В поле "Initial WSDL" вписать адрес PayControl Server (например, https://dev.paycontrol.org/ws/PayControlServiceV3?wsdl), указать удобное название, нажать "Ок"
# Раскрыть созданный проект
# Выбрать запрос registerSystem -> Request 1
# В тег '''request''' вместо знака '''?''' вставить запрос, полученный от SafeTech
# Нажать кнопку "Выполнить запрос"
# В области ответа должен появиться ответ от сервиса с указанием '''systemId''', либо ошибка с описанием

=Регистрация при помощи curl=
Запрос может быть выполнен при помощи программы curl
:: 1. Создайте файл с запросом на регистрацию в файл, например request.xml, следующего содержания:
:::<syntaxhighlight lang="xml"><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pay="http://ws.safetech.ru/PayControlV3/">
<soapenv:Header/>
<soapenv:Body>
<pay:registerSystemRequest>
<request>[запрос на регистрацию, полученный от SafeTech]</request>
</pay:registerSystemRequest>
</soapenv:Body>
</soapenv:Envelope></syntaxhighlight>
:: 2. Выполните команду
:::<syntaxhighlight lang="bash">curl --header "Content-Type: text/xml;charset=UTF-8" --header "SOAPAction: registerSystem" --data @request.xml http://<host>:<port>/ws/PayControlServiceV3</syntaxhighlight>
:: 3. В ответ должен быть получен XML-ответ от сервиса с указанием '''systemId''', либо ошибка с описанием

PayControl3.x Внесение настроек по умолчанию

2018-11-23T15:32:17Z

P.melnichenko: /* PostgreSQL */

'''Сервер PayControl''' это совокупность нескольких серверов:
* '''PayControl Server (PCS)''' – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с [[Прикладная система|прикладной системой]] (например, BSS Корректс, iSimple и т.д.). Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
* '''PayControl Interaction Server Internal (PCIS Internal)''' – сервер для отправки [[Push-уведомления|Push уведомлений]] о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Серверу требуется доступ к серверам Google и Apple.
* '''PayControl Interaction Server External (PCIS External)'''. С этим сервером взаимодействуют приложения на мобильных устройствах для получении информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.

=Варианты включения в инфраструктуру=
Допустимо объединение серверов PCIS на одной машине при выполнении условий
* на входе извне будет установлен фильтр HTTP-запросов, обеспечивающий:
** доступность снаружи только адреса ''<IP или имя сервера>/PayControl-interaction-rest/''
**доступность адреса ''<IP или имя сервера>/wsis/PayControlInteractionService?wsdl'' только изнутри.
* при использовании TLS, фильтр HTTP-запросов должен обладать функцией терминирования TLS.

=Параметры настройки=
==PCS==
===Параметры системы===
Настройки сервера PCS устанавливаются в [[База данных PayControl#pc_sys_property|БД PCS, таблица pc_sys_property]], путём добавления/изменения записей. Запись состоит из setting_name и setting_value. Возможные значения setting_name:
{| class="wikitable"
!setting_name!!Тип!!По умолчанию!!Описание
|-
|REPORT_TEMPLATE || string || || Путь к шаблону отчёта.
|-
|KILT || long || 365 ||Время жизни ключевой информации пользователя (в днях). Сокращение от "KEY_INFO_LIFE_TIME".
|-
|BILL_PERIOD || long || 365 ||Период [[Биллинг|биллинга]] (в днях).
|-
|DEBUG_INFO || long || 0 || Выводить отладочную информацию (0 – не выводить, 1 - выводить).
|-
|CRYPTO_PROVIDER || string || BC || Криптопровайдер. Устаревший параметр. Значение только "BC" (сокращение от [[wikipedia:ru:Bouncy Castle|Bouncy Castle]])
|-
|T_AUTH_CODE || long || 180 || Интервал дескритизации для кода аутентификации (auth_code) (в секундах).
|-
|T_CONFIRM_CODE || long || 180 || Интервал дескритизации для кода подтверждения (в секундах).
|-
|KEY_QR_SIZE || long || 300 || Размер [[QR-код|QR-кода]] ключа (в пикселях).
|-
|TRANSACTION_QR_SIZE || long || 300 || Размер [[QR-код|QR-кода]] транзакции (в пикселях).
|-
|CLEAN_TRANSACTION || long || 1 || Очищать данные транзакции после подтверждения.
|-
|DEFAULT_TRANSACTION_TTL || long || 0 || Время жизни транзакций по умолчанию в секундах. 0 – без ограничений.
|-
|COLLECT_EVENTS || long || 0 || Включает сбор информации о событиях для сервера.
|-
|COLLECT_DEVICE_INFORMATION || long || 0 || Включает сбор информации об устройстве для сервера.
|-
|CHECK_HTTP_AUTH_HEADER || long || 1 || Включает проверку аутентификации HTTP запросов от МП по значению, передаваемому в HTTP заголовке.
|-
|IOS_PUSH_PAYLOAD_TEMPLATE|| string || || Шаблон [[Push-сообщения#Настройка для работы через PayControl Inform|push-сообщений]] для iOS. Используются только при отправке через [[PayControl Inform|PCInform]].
|-
|ANDROID_PUSH_PAYLOAD_TEMPLATE|| string || ||Шаблон [[Push-сообщения#Настройка для работы через PayControl Inform|push-сообщений]] для Android. Используются только при отправке через [[PayControl Inform|PCInform]].
|-
|}
====Примеры запросов для изменения параметров====
=====PostgreSQL=====
Добавление значения с помощью SQL-запроса (После выполнения запроса требуется перезапуск службы):<syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'COLLECT_EVENTS', '1');</syntaxhighlight>
Изменение значения для включения расширенного логирования с помощью SQL-запроса (После выполнения запроса требуется перезапуск службы):<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

=====Oracle=====
<syntaxhighlight lang="sql">insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'COLLECT_EVENTS', '1');</syntaxhighlight>
=====MS SQL=====
<syntaxhighlight lang="sql">insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'COLLECT_EVENTS', '1');</syntaxhighlight>

==PCIS Internal==
===Параметры системы===
Настройки сервера PCIS устанавливаются в [[База данных PayControl#PCIS Internal|БД PCIS, таблица pc_sys_property]], путём добавления/изменения записей. Запись состоит из setting_name и setting_value. Возможные значения setting_name:
{| class="wikitable"
!setting_name!!Тип!!По умолчанию!!Описание
|-
|DEBUG_INFO || long || 0 || Выводить отладочную информацию (0 – не выводить, 1 - выводить).
|-
|GOOGLE_SERVER_KEY || string || || Ключ для аутентификации на серверах Google FCM при отправке [[Push-сообщения|push-сообщений]]
|-
|IOS_KS_PATH || string || || Путь к ключевому файлу в формате pkcs-12. Ключ в этом контейнере используется для аутентификации на APNS при отправке [[Push-сообщения|push-сообщений]]
|-
|IOS_KS_PASSWORD || string || || Пароль к ключевому файлу, заданному в IOS_KS_PATH
|-
|IOS_PUSH_PAYLOAD_TEMPLATE|| string || || Шаблон [[Push-сообщения#Настройка для работы через PayControl Inform|push-сообщений]] для iOS. Используются только при отправке через [[PayControl Inform|PCInform]].
|-
|ANDROID_PUSH_PAYLOAD_TEMPLATE|| string || ||Шаблон [[Push-сообщения#Настройка для работы через PayControl Inform|push-сообщений]] для Android. Используются только при отправке через [[PayControl Inform|PCInform]].
|-
|PROXY_HOST || string || || Адрес прокси-сервера
|-
|PROXY_PORT || long || 0 || Порт прокси-сервера
|-
|PROXY_USERNAME || string || || Имя учётной записи для аутентификации на прокси-сервере
|-
|PROXY_PASSWORD || string || || Пароль учётной записи для аутентификации на прокси-сервере
|-
|}

PayControl3.x Внесение настроек по умолчанию

2018-11-23T14:57:50Z

P.melnichenko: Новая страница: «'''Сервер PayControl''' это совокупность нескольких серверов: * '''PayControl Server (PCS)''' – основной серв…»

'''Сервер PayControl''' это совокупность нескольких серверов:
* '''PayControl Server (PCS)''' – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с [[Прикладная система|прикладной системой]] (например, BSS Корректс, iSimple и т.д.). Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
* '''PayControl Interaction Server Internal (PCIS Internal)''' – сервер для отправки [[Push-уведомления|Push уведомлений]] о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Серверу требуется доступ к серверам Google и Apple.
* '''PayControl Interaction Server External (PCIS External)'''. С этим сервером взаимодействуют приложения на мобильных устройствах для получении информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.

=Варианты включения в инфраструктуру=
Допустимо объединение серверов PCIS на одной машине при выполнении условий
* на входе извне будет установлен фильтр HTTP-запросов, обеспечивающий:
** доступность снаружи только адреса ''<IP или имя сервера>/PayControl-interaction-rest/''
**доступность адреса ''<IP или имя сервера>/wsis/PayControlInteractionService?wsdl'' только изнутри.
* при использовании TLS, фильтр HTTP-запросов должен обладать функцией терминирования TLS.

=Параметры настройки=
==PCS==
===Параметры системы===
Настройки сервера PCS устанавливаются в [[База данных PayControl#pc_sys_property|БД PCS, таблица pc_sys_property]], путём добавления/изменения записей. Запись состоит из setting_name и setting_value. Возможные значения setting_name:
{| class="wikitable"
!setting_name!!Тип!!По умолчанию!!Описание
|-
|REPORT_TEMPLATE || string || || Путь к шаблону отчёта.
|-
|KILT || long || 365 ||Время жизни ключевой информации пользователя (в днях). Сокращение от "KEY_INFO_LIFE_TIME".
|-
|BILL_PERIOD || long || 365 ||Период [[Биллинг|биллинга]] (в днях).
|-
|DEBUG_INFO || long || 0 || Выводить отладочную информацию (0 – не выводить, 1 - выводить).
|-
|CRYPTO_PROVIDER || string || BC || Криптопровайдер. Устаревший параметр. Значение только "BC" (сокращение от [[wikipedia:ru:Bouncy Castle|Bouncy Castle]])
|-
|T_AUTH_CODE || long || 180 || Интервал дескритизации для кода аутентификации (auth_code) (в секундах).
|-
|T_CONFIRM_CODE || long || 180 || Интервал дескритизации для кода подтверждения (в секундах).
|-
|KEY_QR_SIZE || long || 300 || Размер [[QR-код|QR-кода]] ключа (в пикселях).
|-
|TRANSACTION_QR_SIZE || long || 300 || Размер [[QR-код|QR-кода]] транзакции (в пикселях).
|-
|CLEAN_TRANSACTION || long || 1 || Очищать данные транзакции после подтверждения.
|-
|DEFAULT_TRANSACTION_TTL || long || 0 || Время жизни транзакций по умолчанию в секундах. 0 – без ограничений.
|-
|COLLECT_EVENTS || long || 0 || Включает сбор информации о событиях для сервера.
|-
|COLLECT_DEVICE_INFORMATION || long || 0 || Включает сбор информации об устройстве для сервера.
|-
|CHECK_HTTP_AUTH_HEADER || long || 1 || Включает проверку аутентификации HTTP запросов от МП по значению, передаваемому в HTTP заголовке.
|-
|IOS_PUSH_PAYLOAD_TEMPLATE|| string || || Шаблон [[Push-сообщения#Настройка для работы через PayControl Inform|push-сообщений]] для iOS. Используются только при отправке через [[PayControl Inform|PCInform]].
|-
|ANDROID_PUSH_PAYLOAD_TEMPLATE|| string || ||Шаблон [[Push-сообщения#Настройка для работы через PayControl Inform|push-сообщений]] для Android. Используются только при отправке через [[PayControl Inform|PCInform]].
|-
|}
====Примеры запросов для изменения параметров====
=====PostgreSQL=====
Добавление значения с помощью SQL-запроса (После выполнения запроса требуется перезапуск службы):<syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'COLLECT_EVENTS', 1);</syntaxhighlight>
Изменение значения для включения расширенного логирования с помощью SQL-запроса (После выполнения запроса требуется перезапуск службы):<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>
=====Oracle=====
<syntaxhighlight lang="sql">insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'COLLECT_EVENTS', '1');</syntaxhighlight>
=====MS SQL=====
<syntaxhighlight lang="sql">insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'COLLECT_EVENTS', '1');</syntaxhighlight>

==PCIS Internal==
===Параметры системы===
Настройки сервера PCIS устанавливаются в [[База данных PayControl#PCIS Internal|БД PCIS, таблица pc_sys_property]], путём добавления/изменения записей. Запись состоит из setting_name и setting_value. Возможные значения setting_name:
{| class="wikitable"
!setting_name!!Тип!!По умолчанию!!Описание
|-
|DEBUG_INFO || long || 0 || Выводить отладочную информацию (0 – не выводить, 1 - выводить).
|-
|GOOGLE_SERVER_KEY || string || || Ключ для аутентификации на серверах Google FCM при отправке [[Push-сообщения|push-сообщений]]
|-
|IOS_KS_PATH || string || || Путь к ключевому файлу в формате pkcs-12. Ключ в этом контейнере используется для аутентификации на APNS при отправке [[Push-сообщения|push-сообщений]]
|-
|IOS_KS_PASSWORD || string || || Пароль к ключевому файлу, заданному в IOS_KS_PATH
|-
|IOS_PUSH_PAYLOAD_TEMPLATE|| string || || Шаблон [[Push-сообщения#Настройка для работы через PayControl Inform|push-сообщений]] для iOS. Используются только при отправке через [[PayControl Inform|PCInform]].
|-
|ANDROID_PUSH_PAYLOAD_TEMPLATE|| string || ||Шаблон [[Push-сообщения#Настройка для работы через PayControl Inform|push-сообщений]] для Android. Используются только при отправке через [[PayControl Inform|PCInform]].
|-
|PROXY_HOST || string || || Адрес прокси-сервера
|-
|PROXY_PORT || long || 0 || Порт прокси-сервера
|-
|PROXY_USERNAME || string || || Имя учётной записи для аутентификации на прокси-сервере
|-
|PROXY_PASSWORD || string || || Пароль учётной записи для аутентификации на прокси-сервере
|-
|}

PayControl3.x Регистрация прикладной системы

2018-11-23T14:44:54Z

P.melnichenko:

PayControl в своей работе оперирует понятием Прикладная система. 
Это идентификатор в формате GUID, который идентифицирует систему, работающую с PayControl.
К Прикладной системе привязаны пользователи, к ним, в свою очередь, ключи, транзакции и прочее.
К свойствам Прикладной системы относятся URL-ы для взаимодействия с сервером, различные настройки и пр.

=Запрос на регистрацию=
Запрос на регистрацию Прикладной системы формируется в SafeTech и, при необходимости, передаётся Заказчику в текстовом виде.
Для формирования запроса необходимы следующие параметры:
# Название системы
# Описание системы (произвольное)
# URL PayControl Interaction Server (External) - адрес, на который будут обращаться мобильные устройства
# URL PayControl Interaction Server (Internal) - адрес сервиса отправки пуш-уведомлений (может быть PC Inform)
# Срок жизни ключей
# Тип биллинга (Pre-pay, Post-pay)
# Биллинговый период

=Регистрация при помощи SOAP UI=
Для выполнения запроса через графический интерфейс SOAP UI необходимо
# Скачать и установить SOAP UI https://www.soapui.org/downloads/soapui.html
# Добавить новый проект SOAP
# В поле "Initial WSDL" вписать адрес PayControl Server (например, https://dev.paycontrol.org/ws/PayControlServiceV3?wsdl), указать удобное название, нажать "Ок"
# Раскрыть созданный проект
# Выбрать запрос registerSystem -> Request 1
# В тег '''request''' вместо знака '''?''' вставить запрос, полученный от SafeTech
# Нажать кнопку "Выполнить запрос"
# В области ответа должен появиться ответ от сервиса с указанием '''systemId''', либо ошибка с описанием

=Регистрация при помощи curl=
Запрос может быть выполнен при помощи программы curl
:: 1. Создайте файл с запросом на регистрацию в файл, например request.xml, следующего содержания:
:::<syntaxhighlight lang="xml"><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pay="http://ws.safetech.ru/PayControlV3/">
<soapenv:Header/>
<soapenv:Body>
<pay:registerSystemRequest>
<request>[запрос на регистрацию, полученный от SafeTech]</request>
</pay:registerSystemRequest>
</soapenv:Body>
</soapenv:Envelope></syntaxhighlight>
:: 2. Выполните команду
:::<syntaxhighlight lang="bash">curl --header "Content-Type: text/xml;charset=UTF-8" --header "SOAPAction: registerSystem" --data @request.xml http://<host>:<port>/ws/PayControlServiceV3</syntaxhighlight>
:: 3. В ответ должен быть получен XML-ответ от сервиса с указанием '''systemId''', либо ошибка с описанием

PayControl3.x Регистрация прикладной системы

2018-11-23T14:42:50Z

P.melnichenko:

PayControl3.x Регистрация прикладной системы

2018-11-23T14:33:15Z

P.melnichenko: Новая страница: «PayControl в своей работе оперирует понятием Прикладная система. Это идентификатор в форма…»

Установка на WebLogic

2018-11-23T14:14:36Z

P.melnichenko: /* Установка PayControl Interaction Server (External) 3.6 на WebLogic 12.2.1.3 */

=Установка PayControl Server 3.6 на WebLogic 12.2.1.3=

==Параметры установки WebLogic==
После установки WebLogic при создании нового домена необходимо использовать следующие шаблоны:
# Basic WebLogic Server Domain
# WebLogic Advanced Web Services for JAX-WS Extension [oracle_common]
# WebLogic JAX-WS SOAP/JMS Extension [oracle_common]

==Подготовка==
===Установка необходимых JDBC-драйверов===
Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД. 
На примере PostgreSQL необходимо выполнить следующие действия:
# Загрузить актуальную версию JDBC-драйвера (https://jdbc.postgresql.org/download.html)
# Поместить драйвер в директорию установки Web Logic
# Добавить драйвер в CLASSPATH WebLogic
Подробнее смотри в официальной документации https://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729

Примечание: При тестировании использовалась опция добавления в CLASSPATH "For all domains"

===Установка Java Cryptography Extension (JCE) Unlimited Strength===
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
# Скачать архив по адресу http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html
# Распаковать и скопировать файлы по адресу JDK_HOME/lib/security, заменив старые версии

===Настройка JVM===
====Размер используемой памяти====
Для работы WebLogic с приложениями рекомендуется использовать не менее 2Gb оперативной памяти.
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную USER_MEM_ARGS
::* Для '''Windows''' в файле startWebLogic.cmd добавить запись
:::<syntaxhighlight lang="bash">set USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">call "%DOMAIN_HOME%\bin\setDomainEnv.cmd</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh добавить запись
:::<syntaxhighlight lang="bash">USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">DOMAIN_HOME=PATH_TO_DOMAIN</syntaxhighlight>

====Указать префикс для JNDI====
Для работы приложения PayControl необходимо указать в JNDI-префикс в качестве параметры Java-машины приложения
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную JAVA_OPTIONS
::* Для '''Windows''' в файле startWebLogic.cmd после строки
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%JAVA_OPTIONS% -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh после строки
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS}</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${JAVA_OPTIONS} -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>

==Настройка логирования==
PayControl использует log4j версии 1.2 для логирования.
Для включения log4j в WebLogic необходимо создать файл свойств log4j и добавить его в CLASSPATH WebLogic.

Самый простой способ это сделать следующий

Создать файл PATH_TO_DOMAIN\config\log4j.properties со следующим содержанием
<syntaxhighlight lang="bash"># Root logger option
log4j.rootLogger=INFO, stdout

# Direct log messages to stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
</syntaxhighlight>

Данные настройки позволяют выводить лог в stdout сервера WebLogic

Более подробно настройку log4j можно посмотреть на сайте log4j http://logging.apache.org/log4j/1.2/

==Добавление DataSource==
PayControl Server использует DataSource с именем PayControlDS 

DataSource'ы добавляются стандартным способом:
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Environment -> Data Sources
# Добавить Generic Data Source с указанием JNDI Name: '''PayControlDS'''
# Активировать Data Source для нужно сервера (Select Target). Например, для Admin Server.

==Установка приложения==
Необходимо развернуть EAR-приложение '''PayControlServiceWar-3.6-WF-WL.ear''' в WebLogic стандартными средствами
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Deployments
# Развернуть приложение

==Адрес WSDL сервиса==
Сервис доступен по ссылкам
# Основной сервис: http://<IP или имя сервера с WL>:7001/ws/PayControlServiceV3?wsdl
# Сервис отчетности: http://<IP или имя сервера с WL>:7001/ws/PayControlReportService?wsdl

=Установка PayControl Interaction Server (External) 3.6 на WebLogic 12.2.1.3=
Для работы PayControl Interaction Server (External) необходимо только указание адреса PayControl Server, с которым будет осуществляться взаимодействие.

==Подготовка==
Установка адреса выполняется через задание параметра JAVA-машины.
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную JAVA_OPTIONS
::* Для '''Windows''' в файле startWebLogic.cmd после строки
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%JAVA_OPTIONS% -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3 -Dpaycontrol.locale=ru</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh после строки
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS}</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${JAVA_OPTIONS} -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3 -Dpaycontrol.locale=ru</syntaxhighlight>

==Настройка логирования==
Настройка логирования выполняется полностью аналогично [[Установка на WebLogic#Настройка логирования]]

==Установка приложения==
Необходимо развернуть EAR-приложение '''PayControl-interaction-rest.war''' в WebLogic стандартными средствами
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Deployments
# Развернуть приложение

==Адрес сервиса==
Сервис доступен по ссылке 
http://<IP или имя сервера с WL>:7001/PayControl-interaction-rest/jsonrequest_v2/

Установка на WebLogic

2018-11-23T14:01:08Z

P.melnichenko: /* Установка PayControl Interaction Server (External) 3.6 на WebLogic 12.2.1.3 */

=Установка PayControl Server 3.6 на WebLogic 12.2.1.3=

==Параметры установки WebLogic==
После установки WebLogic при создании нового домена необходимо использовать следующие шаблоны:
# Basic WebLogic Server Domain
# WebLogic Advanced Web Services for JAX-WS Extension [oracle_common]
# WebLogic JAX-WS SOAP/JMS Extension [oracle_common]

==Подготовка==
===Установка необходимых JDBC-драйверов===
Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД. 
На примере PostgreSQL необходимо выполнить следующие действия:
# Загрузить актуальную версию JDBC-драйвера (https://jdbc.postgresql.org/download.html)
# Поместить драйвер в директорию установки Web Logic
# Добавить драйвер в CLASSPATH WebLogic
Подробнее смотри в официальной документации https://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729

Примечание: При тестировании использовалась опция добавления в CLASSPATH "For all domains"

===Установка Java Cryptography Extension (JCE) Unlimited Strength===
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
# Скачать архив по адресу http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html
# Распаковать и скопировать файлы по адресу JDK_HOME/lib/security, заменив старые версии

===Настройка JVM===
====Размер используемой памяти====
Для работы WebLogic с приложениями рекомендуется использовать не менее 2Gb оперативной памяти.
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную USER_MEM_ARGS
::* Для '''Windows''' в файле startWebLogic.cmd добавить запись
:::<syntaxhighlight lang="bash">set USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">call "%DOMAIN_HOME%\bin\setDomainEnv.cmd</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh добавить запись
:::<syntaxhighlight lang="bash">USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">DOMAIN_HOME=PATH_TO_DOMAIN</syntaxhighlight>

====Указать префикс для JNDI====
Для работы приложения PayControl необходимо указать в JNDI-префикс в качестве параметры Java-машины приложения
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную JAVA_OPTIONS
::* Для '''Windows''' в файле startWebLogic.cmd после строки
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%JAVA_OPTIONS% -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh после строки
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS}</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${JAVA_OPTIONS} -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>

==Настройка логирования==
PayControl использует log4j версии 1.2 для логирования.
Для включения log4j в WebLogic необходимо создать файл свойств log4j и добавить его в CLASSPATH WebLogic.

Самый простой способ это сделать следующий

Создать файл PATH_TO_DOMAIN\config\log4j.properties со следующим содержанием
<syntaxhighlight lang="bash"># Root logger option
log4j.rootLogger=INFO, stdout

# Direct log messages to stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
</syntaxhighlight>

Данные настройки позволяют выводить лог в stdout сервера WebLogic

Более подробно настройку log4j можно посмотреть на сайте log4j http://logging.apache.org/log4j/1.2/

==Добавление DataSource==
PayControl Server использует DataSource с именем PayControlDS 

DataSource'ы добавляются стандартным способом:
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Environment -> Data Sources
# Добавить Generic Data Source с указанием JNDI Name: '''PayControlDS'''
# Активировать Data Source для нужно сервера (Select Target). Например, для Admin Server.

==Установка приложения==
Необходимо развернуть EAR-приложение '''PayControlServiceWar-3.6-WF-WL.ear''' в WebLogic стандартными средствами
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Deployments
# Развернуть приложение

==Адрес WSDL сервиса==
Сервис доступен по ссылкам
# Основной сервис: http://<IP или имя сервера с WL>:7001/ws/PayControlServiceV3?wsdl
# Сервис отчетности: http://<IP или имя сервера с WL>:7001/ws/PayControlReportService?wsdl

=Установка PayControl Interaction Server (External) 3.6 на WebLogic 12.2.1.3=
Для работы PayControl Interaction Server (External) необходимо только указание адреса PayControl Server, с которым будет осуществляться взаимодействие.

==Подготовка==
Установка адреса выполняется через задание параметра JAVA-машины.
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную JAVA_OPTIONS
::* Для '''Windows''' в файле startWebLogic.cmd после строки
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%JAVA_OPTIONS% -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3 -Dpaycontrol.locale=ru</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh после строки
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS}</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${JAVA_OPTIONS} -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3 -Dpaycontrol.locale=ru</syntaxhighlight>

==Настройка логирования==
Настройка логирования выполняется полностью аналогично [[Установка на WebLogic#Настройка логирования]]

==Адрес сервиса==
Сервис доступен по ссылке 
http://<IP или имя сервера с WL>:7001/PayControl-interaction-rest/jsonrequest_v2/

Установка на WebLogic

2018-11-23T13:57:31Z

P.melnichenko: /* Настройка логирования */

Установка на WebLogic

2018-11-23T13:56:56Z

P.melnichenko: /* Настройка логирования */

Установка на WebLogic

2018-11-23T13:55:47Z

P.melnichenko: /* Настройка логирования */

Установка на WebLogic

2018-11-23T13:55:18Z

P.melnichenko:

Установка на WebLogic

2018-11-23T12:54:31Z

P.melnichenko: /* Установка приложения */

Установка на WebLogic

2018-11-23T12:53:35Z

P.melnichenko:

=Установка PayControl Server 3.6 на WebLogic 12.2.1.3=

==Параметры установки WebLogic==
После установки WebLogic при создании нового домена необходимо использовать следующие шаблоны:
# Basic WebLogic Server Domain
# WebLogic Advanced Web Services for JAX-WS Extension [oracle_common]
# WebLogic JAX-WS SOAP/JMS Extension [oracle_common]

==Подготовка==
===Установка необходимых JDBC-драйверов===
Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД. 
На примере PostgreSQL необходимо выполнить следующие действия:
# Загрузить актуальную версию JDBC-драйвера (https://jdbc.postgresql.org/download.html)
# Поместить драйвер в директорию установки Web Logic
# Добавить драйвер в CLASSPATH WebLogic
Подробнее смотри в официальной документации https://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729

Примечание: При тестировании использовалась опция добавления в CLASSPATH "For all domains"

===Установка Java Cryptography Extension (JCE) Unlimited Strength===
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
# Скачать архив по адресу http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html
# Распаковать и скопировать файлы по адресу JDK_HOME/lib/security, заменив старые версии

===Настройка JVM===
====Размер используемой памяти====
Для работы WebLogic с приложениями рекомендуется использовать не менее 2Gb оперативной памяти.
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную USER_MEM_ARGS
::* Для '''Windows''' в файле startWebLogic.cmd добавить запись
:::<syntaxhighlight lang="bash">set USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">call "%DOMAIN_HOME%\bin\setDomainEnv.cmd</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh добавить запись
:::<syntaxhighlight lang="bash">USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">DOMAIN_HOME=PATH_TO_DOMAIN</syntaxhighlight>

====Указать префикс для JNDI====
Для работы приложения PayControl необходимо указать в JNDI-префикс в качестве параметры Java-машины приложения
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную JAVA_OPTIONS
::* Для '''Windows''' в файле startWebLogic.cmd после строки
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%JAVA_OPTIONS% -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh после строки
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS}</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${JAVA_OPTIONS} -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>

==Настройка логирования==
PayControl использует log4j версии 1.2 для логирования.
Для включения log4j в WebLogic необходимо создать файл свойств log4j и добавить его в CLASSPATH WebLogic.

Самый простой способ это сделать следующий

Создать файл PATH_TO_DOMAIN\config\log4j.properties со следующим содержанием
<syntaxhighlight lang="bash"># Root logger option
log4j.rootLogger=INFO, stdout

# Direct log messages to stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
</syntaxhighlight>

Данные настройки позволяют выводить лог в stdout сервера WebLogic

Более подробно настройку log4j можно посмотреть на сайте log4j http://logging.apache.org/log4j/1.2/

==Добавление DataSource==
PayControl Server использует DataSource с именем PayControlDS 

DataSource'ы добавляются стандартным способом:
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Environment -> Data Sources
# Добавить Generic Data Source с указанием JNDI Name: '''PayControlDS'''
# Активировать Data Source для нужно сервера (Select Target). Например, для Admin Server.

==Установка приложения==
Необходимо развернуть EAR-приложение в WebLogic стандартными средствами
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Deployments
# Развернуть приложение

==Адрес WSDL сервиса==
Сервис доступен по ссылкам
# Основной сервис: http://<IP или имя сервера с WL>:7001/ws/PayControlServiceV3?wsdl
# Сервис отчетности: http://<IP или имя сервера с WL>:7001/ws/PayControlReportService?wsdl

Установка на WebLogic

2018-11-23T12:52:33Z

P.melnichenko: /* Указать префикс для JNDI */

=Установка PayControl 3.6 на WebLogic 12.2.1.3=

==Параметры установки WebLogic==
После установки WebLogic при создании нового домена необходимо использовать следующие шаблоны:
# Basic WebLogic Server Domain
# WebLogic Advanced Web Services for JAX-WS Extension [oracle_common]
# WebLogic JAX-WS SOAP/JMS Extension [oracle_common]

==Подготовка==
===Установка необходимых JDBC-драйверов===
Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД. 
На примере PostgreSQL необходимо выполнить следующие действия:
# Загрузить актуальную версию JDBC-драйвера (https://jdbc.postgresql.org/download.html)
# Поместить драйвер в директорию установки Web Logic
# Добавить драйвер в CLASSPATH WebLogic
Подробнее смотри в официальной документации https://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729

Примечание: При тестировании использовалась опция добавления в CLASSPATH "For all domains"

===Установка Java Cryptography Extension (JCE) Unlimited Strength===
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
# Скачать архив по адресу http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html
# Распаковать и скопировать файлы по адресу JDK_HOME/lib/security, заменив старые версии

===Настройка JVM===
====Размер используемой памяти====
Для работы WebLogic с приложениями рекомендуется использовать не менее 2Gb оперативной памяти.
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную USER_MEM_ARGS
::* Для '''Windows''' в файле startWebLogic.cmd добавить запись
:::<syntaxhighlight lang="bash">set USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">call "%DOMAIN_HOME%\bin\setDomainEnv.cmd</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh добавить запись
:::<syntaxhighlight lang="bash">USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">DOMAIN_HOME=PATH_TO_DOMAIN</syntaxhighlight>

====Указать префикс для JNDI====
Для работы приложения PayControl необходимо указать в JNDI-префикс в качестве параметры Java-машины приложения
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную JAVA_OPTIONS
::* Для '''Windows''' в файле startWebLogic.cmd после строки
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%JAVA_OPTIONS% -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh после строки
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS}</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${JAVA_OPTIONS} -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>

==Настройка логирования==
PayControl использует log4j версии 1.2 для логирования.
Для включения log4j в WebLogic необходимо создать файл свойств log4j и добавить его в CLASSPATH WebLogic.

Самый простой способ это сделать следующий

Создать файл PATH_TO_DOMAIN\config\log4j.properties со следующим содержанием
<syntaxhighlight lang="bash"># Root logger option
log4j.rootLogger=INFO, stdout

# Direct log messages to stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
</syntaxhighlight>

Данные настройки позволяют выводить лог в stdout сервера WebLogic

Более подробно настройку log4j можно посмотреть на сайте log4j http://logging.apache.org/log4j/1.2/

==Добавление DataSource==
PayControl Server использует DataSource с именем PayControlDS 

DataSource'ы добавляются стандартным способом:
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Environment -> Data Sources
# Добавить Generic Data Source с указанием JNDI Name: '''PayControlDS'''
# Активировать Data Source для нужно сервера (Select Target). Например, для Admin Server.

==Установка приложения==
Необходимо развернуть EAR-приложение в WebLogic стандартными средствами
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Deployments
# Развернуть приложение

==Адрес WSDL сервиса==
Сервис доступен по ссылкам
# Основной сервис: http://<IP или имя сервера с WL>:7001/ws/PayControlServiceV3?wsdl
# Сервис отчетности: http://<IP или имя сервера с WL>:7001/ws/PayControlReportService?wsdl

Установка на WebLogic

2018-11-23T12:47:40Z

P.melnichenko: /* Установка необходимых JDBC-драйверов */

=Установка PayControl 3.6 на WebLogic 12.2.1.3=

==Параметры установки WebLogic==
После установки WebLogic при создании нового домена необходимо использовать следующие шаблоны:
# Basic WebLogic Server Domain
# WebLogic Advanced Web Services for JAX-WS Extension [oracle_common]
# WebLogic JAX-WS SOAP/JMS Extension [oracle_common]

==Подготовка==
===Установка необходимых JDBC-драйверов===
Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД. 
На примере PostgreSQL необходимо выполнить следующие действия:
# Загрузить актуальную версию JDBC-драйвера (https://jdbc.postgresql.org/download.html)
# Поместить драйвер в директорию установки Web Logic
# Добавить драйвер в CLASSPATH WebLogic
Подробнее смотри в официальной документации https://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729

Примечание: При тестировании использовалась опция добавления в CLASSPATH "For all domains"

===Установка Java Cryptography Extension (JCE) Unlimited Strength===
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
# Скачать архив по адресу http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html
# Распаковать и скопировать файлы по адресу JDK_HOME/lib/security, заменив старые версии

===Настройка JVM===
====Размер используемой памяти====
Для работы WebLogic с приложениями рекомендуется использовать не менее 2Gb оперативной памяти.
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную USER_MEM_ARGS
::* Для '''Windows''' в файле startWebLogic.cmd добавить запись
:::<syntaxhighlight lang="bash">set USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">call "%DOMAIN_HOME%\bin\setDomainEnv.cmd</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh добавить запись
:::<syntaxhighlight lang="bash">USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">DOMAIN_HOME=PATH_TO_DOMAIN</syntaxhighlight>

====Указать префикс для JNDI====
Для работы приложения PayControl необходимо указать в JNDI-префикс в качестве параметры Java-машины приложения
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную JAVA_OPTIONS
::* Для '''Windows''' в файле startWebLogic.cmd строку
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%</syntaxhighlight>
:::заменить на
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh строку
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS}</syntaxhighlight>
:::заменить на
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS} -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>

==Настройка логирования==
PayControl использует log4j версии 1.2 для логирования.
Для включения log4j в WebLogic необходимо создать файл свойств log4j и добавить его в CLASSPATH WebLogic.

Самый простой способ это сделать следующий

Создать файл PATH_TO_DOMAIN\config\log4j.properties со следующим содержанием
<syntaxhighlight lang="bash"># Root logger option
log4j.rootLogger=INFO, stdout

# Direct log messages to stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
</syntaxhighlight>

Данные настройки позволяют выводить лог в stdout сервера WebLogic

Более подробно настройку log4j можно посмотреть на сайте log4j http://logging.apache.org/log4j/1.2/

==Добавление DataSource==
PayControl Server использует DataSource с именем PayControlDS 

DataSource'ы добавляются стандартным способом:
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Environment -> Data Sources
# Добавить Generic Data Source с указанием JNDI Name: '''PayControlDS'''
# Активировать Data Source для нужно сервера (Select Target). Например, для Admin Server.

==Установка приложения==
Необходимо развернуть EAR-приложение в WebLogic стандартными средствами
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Deployments
# Развернуть приложение

==Адрес WSDL сервиса==
Сервис доступен по ссылкам
# Основной сервис: http://<IP или имя сервера с WL>:7001/ws/PayControlServiceV3?wsdl
# Сервис отчетности: http://<IP или имя сервера с WL>:7001/ws/PayControlReportService?wsdl

Установка на WebLogic

2018-11-23T12:47:03Z

P.melnichenko:

=Установка PayControl 3.6 на WebLogic 12.2.1.3=

==Параметры установки WebLogic==
После установки WebLogic при создании нового домена необходимо использовать следующие шаблоны:
# Basic WebLogic Server Domain
# WebLogic Advanced Web Services for JAX-WS Extension [oracle_common]
# WebLogic JAX-WS SOAP/JMS Extension [oracle_common]

==Подготовка==
===Установка необходимых JDBC-драйверов===
Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД.На примере PostgreSQL необходимо выполнить следующие действия:
# Загрузить актуальную версию JDBC-драйвера (https://jdbc.postgresql.org/download.html)
# Поместить драйвер в директорию установки Web Logic
# Добавить драйвер в CLASSPATH WebLogic
Подробнее смотри в официальной документации https://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729

Примечание: При тестировании использовалась опция добавления в CLASSPATH "For all domains"
===Установка Java Cryptography Extension (JCE) Unlimited Strength===
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
# Скачать архив по адресу http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html
# Распаковать и скопировать файлы по адресу JDK_HOME/lib/security, заменив старые версии

===Настройка JVM===
====Размер используемой памяти====
Для работы WebLogic с приложениями рекомендуется использовать не менее 2Gb оперативной памяти.
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную USER_MEM_ARGS
::* Для '''Windows''' в файле startWebLogic.cmd добавить запись
:::<syntaxhighlight lang="bash">set USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">call "%DOMAIN_HOME%\bin\setDomainEnv.cmd</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh добавить запись
:::<syntaxhighlight lang="bash">USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">DOMAIN_HOME=PATH_TO_DOMAIN</syntaxhighlight>

====Указать префикс для JNDI====
Для работы приложения PayControl необходимо указать в JNDI-префикс в качестве параметры Java-машины приложения
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную JAVA_OPTIONS
::* Для '''Windows''' в файле startWebLogic.cmd строку
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%</syntaxhighlight>
:::заменить на
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh строку
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS}</syntaxhighlight>
:::заменить на
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS} -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>

==Настройка логирования==
PayControl использует log4j версии 1.2 для логирования.
Для включения log4j в WebLogic необходимо создать файл свойств log4j и добавить его в CLASSPATH WebLogic.

Самый простой способ это сделать следующий

Создать файл PATH_TO_DOMAIN\config\log4j.properties со следующим содержанием
<syntaxhighlight lang="bash"># Root logger option
log4j.rootLogger=INFO, stdout

# Direct log messages to stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
</syntaxhighlight>

Данные настройки позволяют выводить лог в stdout сервера WebLogic

Более подробно настройку log4j можно посмотреть на сайте log4j http://logging.apache.org/log4j/1.2/

==Добавление DataSource==
PayControl Server использует DataSource с именем PayControlDS 

DataSource'ы добавляются стандартным способом:
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Environment -> Data Sources
# Добавить Generic Data Source с указанием JNDI Name: '''PayControlDS'''
# Активировать Data Source для нужно сервера (Select Target). Например, для Admin Server.

==Установка приложения==
Необходимо развернуть EAR-приложение в WebLogic стандартными средствами
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Deployments
# Развернуть приложение

==Адрес WSDL сервиса==
Сервис доступен по ссылкам
# Основной сервис: http://<IP или имя сервера с WL>:7001/ws/PayControlServiceV3?wsdl
# Сервис отчетности: http://<IP или имя сервера с WL>:7001/ws/PayControlReportService?wsdl

Установка на WebLogic

2018-11-23T12:32:59Z

P.melnichenko:

=Установка PayControl 3.6 на WebLogic 12.2.1.3=
==Подготовка==
===Установка необходимых JDBC-драйверов===
Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД.На примере PostgreSQL необходимо выполнить следующие действия:
# Загрузить актуальную версию JDBC-драйвера (https://jdbc.postgresql.org/download.html)
# Поместить драйвер в директорию установки Web Logic
# Добавить драйвер в CLASSPATH WebLogic
Подробнее смотри в официальной документации https://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729

Примечание: При тестировании использовалась опция добавления в CLASSPATH "For all domains"
===Установка Java Cryptography Extension (JCE) Unlimited Strength===
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
# Скачать архив по адресу http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html
# Распаковать и скопировать файлы по адресу JDK_HOME/lib/security, заменив старые версии

===Настройка JVM===
====Размер используемой памяти====
Для работы WebLogic с приложениями рекомендуется использовать не менее 2Gb оперативной памяти.
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную USER_MEM_ARGS
::* Для '''Windows''' в файле startWebLogic.cmd добавить запись
:::<syntaxhighlight lang="bash">set USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">call "%DOMAIN_HOME%\bin\setDomainEnv.cmd</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh добавить запись
:::<syntaxhighlight lang="bash">USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">DOMAIN_HOME=PATH_TO_DOMAIN</syntaxhighlight>

====Указать префикс для JNDI====
Для работы приложения PayControl необходимо указать в JNDI-префикс в качестве параметры Java-машины приложения
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную JAVA_OPTIONS
::* Для '''Windows''' в файле startWebLogic.cmd строку
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%</syntaxhighlight>
:::заменить на
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh строку
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS}</syntaxhighlight>
:::заменить на
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS} -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>

==Настройка логирования==
PayControl использует log4j версии 1.2 для логирования.
Для включения log4j в WebLogic необходимо создать файл свойств log4j и добавить его в CLASSPATH WebLogic.

Самый простой способ это сделать следующий

Создать файл PATH_TO_DOMAIN\config\log4j.properties со следующим содержанием
<syntaxhighlight lang="bash"># Root logger option
log4j.rootLogger=INFO, stdout

# Direct log messages to stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
</syntaxhighlight>

Данные настройки позволяют выводить лог в stdout сервера WebLogic

Более подробно настройку log4j можно посмотреть на сайте log4j http://logging.apache.org/log4j/1.2/

Установка на WebLogic

2018-11-23T12:28:50Z

P.melnichenko:

=Установка PayControl 3.6 на WebLogic 12.2.1.3=
==Подготовка==
===Установка необходимых JDBC-драйверов===
Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД.На примере PostgreSQL необходимо выполнить следующие действия:
# Загрузить актуальную версию JDBC-драйвера (https://jdbc.postgresql.org/download.html)
# Поместить драйвер в директорию установки Web Logic
# Добавить драйвер в CLASSPATH WebLogic
Подробнее смотри в официальной документации https://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729

Примечание: При тестировании использовалась опция добавления в CLASSPATH "For all domains"
===Установка Java Cryptography Extension (JCE) Unlimited Strength===
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
# Скачать архив по адресу http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html
# Распаковать и скопировать файлы по адресу JDK_HOME/lib/security, заменив старые версии

===Настройка JVM===
====Размер используемой памяти====
Для работы WebLogic с приложениями рекомендуется использовать не менее 2Gb оперативной памяти.
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную USER_MEM_ARGS
::* Для '''Windows''' в файле startWebLogic.cmd добавить запись
:::<syntaxhighlight lang="bash">set USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">call "%DOMAIN_HOME%\bin\setDomainEnv.cmd</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh добавить запись
:::<syntaxhighlight lang="bash">USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">DOMAIN_HOME=PATH_TO_DOMAIN</syntaxhighlight>

====Указать префикс для JNDI====
Для работы приложения PayControl необходимо указать в JNDI-префикс в качестве параметры Java-машины приложения
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную JAVA_OPTIONS
::* Для '''Windows''' в файле startWebLogic.cmd строку
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%</syntaxhighlight>
:::заменить на
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh строку
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS}</syntaxhighlight>
:::заменить на
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS} -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>

==Настройка логирования==
PayControl использует log4j версии 1.2 для логирования.
Для включения log4j в WebLogic необходимо создать файл свойств log4j и добавить его в CLASSPATH WebLogic.
Самый простой способ это сделать:
Создать файл PATH_TO_DOMAIN\config\log4j.properties со следующим содержанием
<syntaxhighlight lang="bash"># Root logger option
log4j.rootLogger=INFO, stdout

# Direct log messages to stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
</syntaxhighlight>

Данные настройки позволяют выводить лог в stdout сервера WebLogic

Более подробно настройку log4j можно посмотреть на сайте log4j

Установка на WebLogic

2018-11-23T11:27:36Z

P.melnichenko:

Установка на WebLogic

2018-11-23T11:26:04Z

P.melnichenko:

Установка на WebLogic

2018-11-23T11:20:28Z

P.melnichenko:

=Установка PayControl 3.6 на WebLogic 12.2.1.3=
==Подготовка==
===Установка необходимых JDBC-драйверов===
Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД.На примере PostgreSQL необходимо выполнить следующие действия:
# Загрузить актуальную версию JDBC-драйвера (https://jdbc.postgresql.org/download.html)
# Поместить драйвер в директорию установки Web Logic
# Добавить драйвер в CLASSPATH WebLogic
Подробнее смотри в официальной документацииhttps://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729

Примечание: При тестировании использовалась опция добавления в CLASSPATH "For all domains"
===Установка Java Cryptography Extension (JCE) Unlimited Strength===
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
# Скачать архив по адресу http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html
# Распаковать и скопировать файлы по адресу ''JDK_HOME<java_home></java_home>''/lib/security, заменив старые версии

===Настройка JVM===
====Размер используемой памяти====
Для работы WebLogic с приложениями рекомендуется использовать не менее 2Gb оперативной памяти.
# Перейти по пути: ''PATH_TO_DOMAIN''''<path_to_domain></path_to_domain>''\bin
# Установить переменную USER_MEM_ARGS
#* Для Windows в файле startWebLogic.cmd добавить запись''set USER_MEM_ARGS=-Xms256m -Xmx2048m''перед строкой''call "%DOMAIN_HOME%\bin\setDomainEnv.cmd"''
#* Для Linux в файле startWebLogic.sh добавить запись''USER_MEM_ARGS=-Xms256m -Xmx2048m''перед строкой''DOMAIN_HOME="PATH_TO_DOMAIN<path_to_domain>"</path_to_domain>''

===='''Указать префикс для JNDI'''====
Для работы приложения PayControl необходимо указать в JNDI-префикс в качестве параметры Java-машины приложения
# Перейти по пути: ''PATH_TO_DOMAIN''''<path_to_domain></path_to_domain>''\bin
# Установить переменную ''JAVA_OPTIONS''
#* Для Windows в файле startWebLogic.cmd строку 
''set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% заменить на set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/'''
* Для Linux в файле startWebLogic.sh строку'''' ''''
''''''JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}"''''''''''заменить на''''''''JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}'' -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/''

Установка на WebLogic

2018-11-23T11:19:11Z

P.melnichenko: /* Установка PayControl 3.6 на WebLogic 12.2.1.3 */

=Установка PayControl 3.6 на WebLogic 12.2.1.3=
==Подготовка==
===Установка необходимых JDBC-драйверов===
Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД.На примере PostgreSQL необходимо выполнить следующие действия:
# Загрузить актуальную версию JDBC-драйвера (https://jdbc.postgresql.org/download.html)
# Поместить драйвер в директорию установки Web Logic
# Добавить драйвер в CLASSPATH WebLogic
Подробнее смотри в официальной документацииhttps://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729

Примечание: При тестировании использовалась опция добавления в CLASSPATH "For all domains"
===Установка Java Cryptography Extension (JCE) Unlimited Strength===
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
# Скачать архив по адресу <a href="http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html">http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html</a>
# Распаковать и скопировать файлы по адресу ''JDK_HOME<java_home></java_home>''/lib/security, заменив старые версии

===Настройка JVM===
====Размер используемой памяти====
Для работы WebLogic с приложениями рекомендуется использовать не менее 2Gb оперативной памяти.
# Перейти по пути: ''PATH_TO_DOMAIN''''<path_to_domain></path_to_domain>''\bin
# Установить переменную USER_MEM_ARGS
#* Для Windows в файле startWebLogic.cmd добавить запись''set USER_MEM_ARGS=-Xms256m -Xmx2048m''перед строкой''call "%DOMAIN_HOME%\bin\setDomainEnv.cmd" %*''
#* Для Linux в файле startWebLogic.sh добавить запись''USER_MEM_ARGS=-Xms256m -Xmx2048m''перед строкой''DOMAIN_HOME="PATH_TO_DOMAIN<path_to_domain>"</path_to_domain>''

===='''Указать префикс для JNDI'''====
Для работы приложения PayControl необходимо указать в JNDI-префикс в качестве параметры Java-машины приложения
# Перейти по пути: ''PATH_TO_DOMAIN''''<path_to_domain></path_to_domain>''\bin
# Установить переменную ''JAVA_OPTIONS''
#* Для Windows в файле startWebLogic.cmd строку 
''set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% заменить на set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/'''
* Для Linux в файле startWebLogic.sh строку'''' ''''
''''''JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}"''''''''''заменить на''''''''JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}'' -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/''

Установка на WebLogic

2018-11-23T11:16:47Z

P.melnichenko: /* Установка PayControl 3.6 на WebLogic 12.2.1.3 */

=Установка PayControl 3.6 на WebLogic 12.2.1.3=
==Подготовка==
===Установка необходимых JDBC-драйверов===
Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД.На примере PostgreSQL необходимо выполнить следующие действия (https://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729):
# Загрузить актуальную версию JDBC-драйвера (<a href="https://jdbc.postgresql.org/download.html)">https://jdbc.postgresql.org/download.html)</a>
# Поместить драйвер в директорию установки Web Logic
# Добавить драйвер в CLASSPATH WebLogic
Подробнее смотри в официальной документацииhttps://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729

Примечание: При тестировании использовалась опция добавления в CLASSPATH "For all domains"
===Установка Java Cryptography Extension (JCE) Unlimited Strength===
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
# Скачать архив по адресу <a href="http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html">http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html</a>
# Распаковать и скопировать файлы по адресу ''JDK_HOME<java_home></java_home>''/lib/security, заменив старые версии

===Настройка JVM===
====Размер используемой памяти====
Для работы WebLogic с приложениями рекомендуется использовать не менее 2Gb оперативной памяти.
# Перейти по пути: ''PATH_TO_DOMAIN''''<path_to_domain></path_to_domain>''\bin
# Установить переменную USER_MEM_ARGS
#* Для Windows в файле startWebLogic.cmd добавить запись''set USER_MEM_ARGS=-Xms256m -Xmx2048m''перед строкой''call "%DOMAIN_HOME%\bin\setDomainEnv.cmd" %*''
#* Для Linux в файле startWebLogic.sh добавить запись''USER_MEM_ARGS=-Xms256m -Xmx2048m''перед строкой''DOMAIN_HOME="PATH_TO_DOMAIN<path_to_domain>"</path_to_domain>''

===='''Указать префикс для JNDI'''====
Для работы приложения PayControl необходимо указать в JNDI-префикс в качестве параметры Java-машины приложения
# Перейти по пути: ''PATH_TO_DOMAIN''''<path_to_domain></path_to_domain>''\bin
# Установить переменную ''JAVA_OPTIONS''
#* ''''Для Windows в файле startWebLogic.cmd строку 
''set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%''''заменить на''''''set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/''''''''''''
* Для Linux в файле startWebLogic.sh строку'''' ''''
''''JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}"''''''''заменить на''''''''JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}'' -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/''

Установка на WebLogic

2018-11-23T11:04:48Z

P.melnichenko:

Установка на WebLogic

2018-11-23T10:50:39Z

P.melnichenko: Новая страница: «Начинаем писать»

Начинаем писать

PayControl Inform

2018-11-19T17:25:44Z

P.melnichenko:

'''PayControl Inform 2.0''' (сокр. PC Inform) является модулем для платформы PayControl, обеспечивающим высокопроизводительную доставку push-уведомлений до клиентских устройств с обеспечением безопасности передаваемых через уведомление данных.

Конечному устройству информация может передаваться в двух вариантах:
* Только push-уведомление;
* Push-уведомление и полезная нагрузка (payload).
=Описание интерфейса взаимодействия с PC Inform=
Интерфейс общения с сервером представляет собой HTTP RESTful интерфейс.
==Отправка уведомления==
===Запрос===
Отправка запроса производится на адрес http://<hostname>/api/notification/ с помощью '''HTTP POST''' запроса.

Данные для отправки уведомления передаются в формате JSON и содержат следующие параметры:
* message - payload, который отправляется на устройство через FCM/APNs;
* payload - (опционально) дополнительный пэйлоад;
* callback_url - (опционально) адрес, по которому будет осуществляться callback;
* time_to_live - время жизни уведомления в секундах (0 - сервер FCM/APNs не будет пытаться отправить повторно);
* priority - приоритет ("high" или "normal");
* collapse_key - значение параметра FCM collapse_key/ APNs apns-collapse-id;

Примеры отправки запроса при помощи утилиты [[wikipedia:ru:curl|cURL]]:
====Android====
<syntaxhighlight lang="bash">
curl \
-H "Content-Type: application/json" \
-X POST \
-d '{"device_token": "XXXXXXXXXX", "device_type": "google", "time_to_live": 3, "priority": "high", "collapse_key": "1234567890", "payload": "dGVzdA0KdGVzdCBQYXlDb250cm9sIEluZm9ybQ0KUGF5Q29udHJvbCBJbmZvcm0gdGVzdA0KdGVzdA==", "callback_url" : "http://<callbackhost>/callback.php", "message": {"notification":{"title": "Hello from Firebase", "body": "This is notification"}}}' \
http://<hostname>/api/notification/
</syntaxhighlight>
====iOS====
<syntaxhighlight lang="bash">
curl \
-H "Content-Type: application/json" \
-X POST \
-d '{"device_token": "XXXXXXXX", "device_type": "apple", "time_to_live": 3, "priority": "high", "collapse_key": "1234567890","payload": "dGVzdA0KdGVzdCBQYXlDb250cm9sIEluZm9ybQ0KUGF5Q29udHJvbCBJbmZvcm0gdGVzdA0KdGVzdA==", "callback_url" : "http://<callbackhost>/callback.php", "message": {"aps": {"alert": "Hello from APNs", "badge": "1"}}}' \
http://<hostname>/api/notification/
</syntaxhighlight>
===Ответ===
В ответ сервис выдает UUID-идентификатор созданного запроса на уведомление в сообщении вида:
<syntaxhighlight lang="json">
{"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx"}
</syntaxhighlight>
==Информация о состоянии Push-уведомления==
===Запрос===
Отправка запроса производится на адрес http://<hostname>/api/notification/<xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx> с помощью '''HTTP GET''' запроса, где <xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx> - идентификатор, который возвратил PC Inform при запросе на создание push-уведомления.

Пример отправки запроса при помощи утилиты cURL:
<syntaxhighlight lang="bash">
curl http://<hostname>/api/notification/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx
</syntaxhighlight>
===Ответ===
Пример ответа:
<syntaxhighlight lang="json">{"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx", "device_token": "XXXXXXXXXX", "payload": "dGVzdA0KdGVzdCBQYXlDb250cm9sIEluZm9ybQ0KUGF5Q29udHJvbCBJbmZvcm0gdGVzdA0KdGVzdA==", "callback_url": "http://<callbackhost>/callback.php", "created_at": "2018-11-19 14:53:51.780572", "updated_at": "2018-11-19 14:53:52.344391", "status": "notification_sent"}</syntaxhighlight>
==Получения пэйлоада==
===Запрос===
Получения пэйлоада осуществляется мобильным устройством с помощью отправки '''HTTP POST''' запроса на адрес http://<hostname>/api/payload/

Пример отправки запроса при помощи утилиты cURL:
<syntaxhighlight lang="bash">
curl -i \
-H "Content-Type: application/json" \
-X POST \
-d '{"auth_token": "XXXXXXXXXX", "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx"}' \
http://<hostname>/api/payload/
</syntaxhighlight>
где:
* auth_token - авторизационный токен, вычисляемый как HMAC(sha256(`device_token`), `uuid`)
* uuid - uuid запроса на уведомление
===Ответ===
* Если токен невалидый, то сервис возвращает 401
* Если токен, валидный, но пэйлоада нет, то сервис возвращает 204
* Если токен валидный и пэйлоад есть, то сервис возвращает его с кодом 200. Пример:<syntaxhighlight lang="json">{"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx", "payload": "dGVzdA0KdGVzdCBQYXlDb250cm9sIEluZm9ybQ0KUGF5Q29udHJvbCBJbmZvcm0gdGVzdA0KdGVzdA=="}</syntaxhighlight>
==Callback==
PC Inform с использованием callback-адреса, указанного при создании задачи, выполняет HTTP POST вызов в Прикладную систему для уведомления о статусе получения уведомления.

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

Отправка callback'а происходит после запроса на получение пэйлоада.

Пример отправляемых в callback данных:
<syntaxhighlight lang="json">
{"task_uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx", "status": 3}
</syntaxhighlight>

Заглавная страница

2018-11-14T15:25:34Z

P.melnichenko:

=PayControl Wiki=
Ресурс содержит документацию и справочные сведения и предназначен для предоставления доступа к этой информации партнёрам компании SafeTech.

Тут очень крутая табличка!
{| class="wikitable"
|-
||''Мега-столбец''
||''Супер-Столбец''
||''Сттттаааааалбээээц''
|-
|| 
||Хэллоу
|| 
|-
|| 
|| 
|| 
|-
|| 
|| 
|| 
|-
|| 
|| 
|| 
|-
|| 
|| 
|| 
|}

Тыдыщ-пыщ-пыщ