PayControl Wiki - Вклад [ru]

Обновление PayControl с версии 3 на версию 6

2026-07-16T14:36:07Z

D.bizyukov: /* Изменение адреса для внешних подключений (PCE) с мобильных устройств */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== Postgre ===

<syntaxhighlight lang="sql">
alter table pc_delayedkeyinfo alter column is_deleted set not null;
alter table pc_delayedkeyinfo alter column is_deleted set default 0;
alter table pc_delayedkeyinfo drop column type;
alter table pc_delayedkeyinfo add column renew_challenge varchar(255);

alter table pc_device alter column is_deleted set not null;
alter table pc_device alter column is_deleted set default 0;
alter table pc_device add column app_id varchar(255);

alter table pc_event alter column is_deleted set not null;
alter table pc_event alter column is_deleted set default 0;
alter table pc_event alter column requester_ip type varchar(64);
alter table pc_event add column event_data text;
alter table pc_event drop column eventposturl;

alter table pc_keyinfo alter column is_deleted set not null;
alter table pc_keyinfo alter column is_deleted set default 0;
alter table pc_keyinfo drop column type;
alter table pc_keyinfo drop column key_container_id;
alter table pc_keyinfo add column external_approve_data_id varchar(255);

alter table pc_publickey alter column is_deleted set not null;
alter table pc_publickey alter column is_deleted set default 0;
alter table pc_publickey add column autosign_public_key bytea;

alter table pc_system alter column is_deleted set not null;
alter table pc_system alter column is_deleted set default 0;
alter table pc_system add column callback_url varchar(255);

alter table pc_system_params alter column is_deleted set not null;
alter table pc_system_params alter column is_deleted set default 0;
alter table pc_system_params alter column license type varchar(4096);
alter table pc_system_params add column qr_url_scheme varchar(24);

alter table pc_transaction alter column is_deleted set not null;
alter table pc_transaction alter column is_deleted set default 0;
alter table pc_transaction add column autosign_enabled int2;
alter table pc_transaction add column ext_pulp bytea;
alter table pc_transaction add column extended_check int2;
alter table pc_transaction add column render_type int4;
alter table pc_transaction add column scoring_settings varchar(1023);
alter table pc_transaction add column transaction_type int4;

alter table pc_user alter column is_deleted set not null;
alter table pc_user alter column is_deleted set default 0;
alter table pc_user add column blocked int2;

alter table pc_confirm_attempt add column scoring_results varchar(512);
alter table pc_confirm_attempt add column scoring_settings varchar(512);
</syntaxhighlight>

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_KEYINFO
DROP COLUMN type;

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_DELAYEDKEYINFO
DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

=== Oracle ===

<syntaxhighlight lang="sql">
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_delayedkeyinfo DROP COLUMN type;
ALTER TABLE pc_delayedkeyinfo ADD renew_challenge VARCHAR2(255);

ALTER TABLE pc_device MODIFY is_deleted NOT NULL;
ALTER TABLE pc_device MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_device ADD app_id VARCHAR2(255);

ALTER TABLE pc_event MODIFY is_deleted NOT NULL;
ALTER TABLE pc_event MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_event MODIFY requester_ip VARCHAR2(64);
ALTER TABLE pc_event ADD event_data CLOB;
ALTER TABLE pc_event DROP COLUMN eventposturl;

ALTER TABLE pc_keyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_keyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_keyinfo DROP COLUMN type;
ALTER TABLE pc_keyinfo DROP COLUMN key_container_id;
ALTER TABLE pc_keyinfo ADD external_approve_data_id VARCHAR2(255);

ALTER TABLE pc_publickey MODIFY is_deleted NOT NULL;
ALTER TABLE pc_publickey MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_publickey ADD autosign_public_key BLOB;

ALTER TABLE pc_system MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system ADD callback_url VARCHAR2(255);

ALTER TABLE pc_system_params MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system_params MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system_params MODIFY license VARCHAR2(4000);
ALTER TABLE pc_system_params ADD qr_url_scheme VARCHAR2(24);

ALTER TABLE pc_transaction MODIFY is_deleted NOT NULL;
ALTER TABLE pc_transaction MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_transaction ADD autosign_enabled NUMBER(5);
ALTER TABLE pc_transaction ADD ext_pulp BLOB;
ALTER TABLE pc_transaction ADD extended_check NUMBER(5);
ALTER TABLE pc_transaction ADD render_type NUMBER(10);
ALTER TABLE pc_transaction ADD scoring_settings VARCHAR2(1023);
ALTER TABLE pc_transaction ADD transaction_type NUMBER(10);
ALTER TABLE pc_transaction ADD snipped_text VARCHAR2(1023);

ALTER TABLE pc_user MODIFY is_deleted NOT NULL;
ALTER TABLE pc_user MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_user ADD blocked NUMBER(5);

ALTER TABLE pc_confirm_attempt ADD scoring_results VARCHAR2(512);
ALTER TABLE pc_confirm_attempt ADD scoring_settings VARCHAR2(512);

ALTER TABLE pc_sys_property MODIFY SETTING_VALUE VARCHAR2(1023);

</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения обновленного запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set license='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
update pc_keyinfo set is_activated=1;
update pc_transaction set transaction_type=0;
update pc_transaction set render_type=0;
update pc_transaction set status=6 where status=4;
update pc_transaction set status=7 where status=5;

</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Только для версии 6.9.0 и ниже''':

Для работы старых ключей, обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-pc-ext-example.com:8081/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';
</syntaxhighlight>

PostgreSQL
<syntaxhighlight lang="sql">
update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;
</syntaxhighlight>

Oracle
<syntaxhighlight lang="sql">
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

</syntaxhighlight>

MS SQL
<syntaxhighlight lang="sql">

CREATE OR ALTER FUNCTION dbo.split_part
(
@str NVARCHAR(MAX),
@delim NVARCHAR(100),
@idx INT
)
RETURNS NVARCHAR(MAX)
AS
BEGIN

IF @str IS NULL RETURN NULL;
IF @idx IS NULL OR @idx <= 0 RETURN NULL;
IF @delim IS NULL OR LEN(@delim) = 0 RETURN NULL;

DECLARE @dlen INT = LEN(@delim);

DECLARE @start INT = 1;
DECLARE @pos INT;
DECLARE @cur INT = 1;

WHILE 1 = 1
BEGIN
SET @pos = CHARINDEX(@delim, @str, @start);

IF @pos = 0
BEGIN
IF @cur = @idx
RETURN SUBSTRING(@str, @start, LEN(@str) - @start + 1);
RETURN NULL;
END

IF @cur = @idx
RETURN SUBSTRING(@str, @start, @pos - @start);

SET @start = @pos + @dlen;
SET @cur += 1;
END

RETURN NULL;
END;
GO

UPDATE pc_device SET app_id = dbo.split_part(device_push_id, '####', 2) WHERE app_id IS NULL;
UPDATE pc_device SET device_push_id = dbo.split_part(device_push_id, '####', 1) WHERE app_id IS NOT NULL;
</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Установка PayControl v3.9 Linux

2026-07-11T14:27:29Z

D.bizyukov: /* Учёт изменения адреса сервера PC Pusher */

Статья описывает установку с помощью инсталляционного скрипта.
=Справка скрипта инсталляции=
<pre>Execution modes:
-i Install. Set it for process installation.
-h Help. Will show this help.

Installation options:
-r Register system (only on PCS, matters with -i option). Optional. For registration you must put you register system request file to "customer" directory before. Contact you supplier for obtain this request file.

PC roles (must selected at least one of them):
-S PC Server
-P PC Pusher
-E External / PCIS External
-G PC Server Signer (only for version 5.2 and above)

Install wildfly database driver (mandatory for PCS and PCSS modules):
-p PostgreSQL
-o Oracle
Need to set up parameter - jdbc version:
8 JDBCv8. Certified with JDK8 and JDK11. Supports Oracle Database versions - 21c, 19c, 18c, and 12.2
0 JDBCv10. Implements JDBC 4.3 spec and certified with JDK11. Supports Oracle Database versions - 21c, 19c, 18c, and 12.2
1 JDBCv11. Implements JDBC 4.3 spec and certified with JDK11 and JDK17. Supports Oracle Database versions - 21c, 19c, 18c, and 12.2
-m MS SQL

Examples
install.sh -i -SPEG -r -o8
also like
install.sh -iSPEGro8
will install PCS, PCP, PCE, PCSS, Oracle JDBC8 Driver and execute register system request

install.sh -i -Sp
also like
install.sh -Sp
will install PCS with Postgres drivers</pre>

= Перед установкой PayControl =

Установить последнюю версию JDK 11.

= Конфигурирование =

Конфигурирование производится путём редактирования раздела <code>CUSTOMER Config</code> файла <code>install.conf</code>.

== Подключение к БД для PCS==

Необходимо установить корректные значения адресов и портов СУБД, имена пользователей и пароли.

=== СУБД Oracle ===

При использовании СУБД Oracle необходимо указать, каким образом происходит выбор необходимой БД - с помощью SID или Service Name.

Также '''необходимо''' следуя высланной инструкции '''Oracle. Создание пользователя, табличного пространства и таблиц''' выполнить ее 3-й пункт.

== Настройка PCE для подключения к PCS ==

Для соединения PCE с PCS необходимо указать правильный адрес сервера PCS по которому он сможет получить к нему доступ.

== Пример ==

<syntaxhighlight lang="bash">###################################################
#
# CUSTOMER Config
#
###################################################

PC_PATH='/opt/pc'
PC_PRODUCT='PayControl'

# 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=':'

### PCE

PCS_HOSTNAME_PORT='localhost:8080'</syntaxhighlight>

= Установка =

У пользователя, осуществляющего установку должны быть права на выполнение действий с уровнем привилегий root, либо возможность использовать учётную запись root.
# Скопировать файлы дистрибутива на сервер, например в домашнюю папку пользователя.
# Перейти в директорию с дистрибутивом.
# Запустить установочный скрипт с привилегиями root, с необходимыми параметрами.

== PC Pusher ==

Установка PC Pusher на сервере вместе с другим уже установленным модулем PC выполняется следующим образом:

* Скопировать файл приложения сервера в ''WF_PATH\standalone\deployments\'':
** на PC Pusher - файл ''pc-pusher-<VERSION>.war''
* Дождаться старта WF, проверить, что нет ошибок запуска.
* После развёртывания новых файлов, в директории deployments будут созданы файлы:
** с расширением *.deployed, где вместо * будут указаны названия новых модулей.
** После того, как появятся файлы *.deployed, рекомендуется перезапустить Wildfly
** При появлении файлов с расширением *.failed, необходимо перезапустить Wildfly.

= Результат выполнения инсталляционного скрипта =

Результат выполнения инсталляционного скрипта является:

* установка службы wildflу (директория /opt);
* включение автозапуска службы wildfly;
* добавление драйверов СУБД (опционально);
* добавление источников данных (только для PCS);
* развёртывание файлов сервера в wildfly;
* регистрация прикладной системы в PayControl (при установленном параметре "'''r'''"). Результат регистрации - вывод на экран идентификатора системы в конце журнала работы инсталляционного скрипта (systemid). Пример:<syntaxhighlight lang="xml"><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Body><ns3:registerSystemResponse xmlns:ns2="http://ws.safetech.ru/PayControl/services/ws/common/" xmlns:ns3="http://ws.safetech.ru/PayControlV3/"><systemId>e64a67c9-73e9-462c-9c27-2d0195a2bd23</systemId></ns3:registerSystemResponse></soap:Body></soap:Envelope></syntaxhighlight> В приведённом примере идентификатором зарегистрированной прикладной системы является ''e64a67c9-73e9-462c-9c27-2d0195a2bd23''. В дальнейшем этот идентификатор понадобится при настройке прикладной системы на работу с PayControl. Если значение идентификатора прикладной системы утеряно, свяжитесь с компанией СэйфТек для его уточнения.

== Примеры параметров запуска ==

Примеры ниже приведены для установки PayControl с драйвером PostgreSQL (параметр "'''p'''").

=== Всё на одном сервере ===

==== Без регистрации прикладной системы ====

<syntaxhighlight lang="bash">sudo ./install.sh -ipSE</syntaxhighlight>

==== С регистрацией прикладной системы ====

<syntaxhighlight lang="bash">sudo ./install.sh -ipSEr</syntaxhighlight>

=== PCS ===

==== Без регистрации прикладной системы ====

<syntaxhighlight lang="bash">sudo ./install.sh -ipS</syntaxhighlight>

==== С регистрацией прикладной системы ====

<syntaxhighlight lang="bash">sudo ./install.sh -ipSr</syntaxhighlight>

=== PCE ===

<syntaxhighlight lang="bash">sudo ./install.sh -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'''".

== Проверка доступности сервисов ==

=== PCS ===

Сервисы доступны по ссылкам (при запросе на эти адреса должна возвратиться WSDL-схема):
<pre>http://<IP или имя сервера PCS>:8080/ws/PayControlServiceV3?wsdl
http://<IP или имя сервера PCS>:8080/ws/PayControlReportService?wsdl</pre>

=== PCP ===

Сервис доступен по адресу:

<pre>http://<IP или имя сервера PC Pusher>:8080/pc-pusher-api/health_check</pre>

=== PCE ===

Сервис доступен по адресу

<pre>http://<IP или имя сервера PCIS External>:8080/PayControl-interaction-rest/</pre>

При запросе на этот адрес должно возвратиться текст «Not Found» с HTTP-кодом 404. В Internet Explorer будет выведена своя страница браузера, сообщающая о том, что страница не найдена.

= Внесение изменений в БД =

== Создание индексов БД 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 ==

Для корректировки типов данных необходимо выполнить следующий запрос к БД PCS:

<syntaxhighlight lang="sql">ALTER TABLE PC_TRANSACTION ALTER COLUMN DATA_BINARY image;</syntaxhighlight>

= Настройка PC Pusher для отправки пушей в другое приложение (при необходимости) =
Необходимо выполнить пункты описанные по ссылке [[Обновление_с_3.6_до_3.8#Настройка PC Pusher|"Настройка PCS и PC Pusher"]]

= Корректировка (смена) адресов серверов PayControl (при необходимости) =

{{Предупреждение|Не рекомендуется дополнительно указывать номер порта, в случаях, если для HTTP используется порт 80, или для HTTPS используется порт 443}}

== Учёт изменения адреса сервера PCS ==

Для учёта изменения адреса сервера PCS необходимо произвести изменения в настройках PCE. В файле /opt/wildfly/bin/standalone.conf, в следующей строке, указав правильный адрес и при необходимости порт сервера PCS, а также уточнив протокол подключения (HTTP/HTTPS):

<syntaxhighlight lang="bash">
JAVA_OPTS="$JAVA_OPTS -Dpcservice.endpoint=http[s]://<IP или DNS-имя>[:PORT]/ws/PayControlServiceV3?wsdl -Duser.language=ru -Dpaycontrol.locale=ru"
</syntaxhighlight>

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

== Учёт изменения адреса сервера PC Pusher ==

Для учёта изменения адреса сервера PC Pusher, необходимо, предварительно указав корректные данные (протокол (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>

== Учёт изменения внешнего адреса сервера PCE ==

{{Предупреждение|Если система была переведена в промышленную эксплуатацию, при смене адреса для доступа мобильных устройств, не рекомендуется выводить из действия предыдущий адрес на протяжении всего срока действия выпущенных ключей пользователя. Иначе мобильное приложение потеряет доступ к серверу PayControl и для восстановления будет необходимо перевыпустить ключ и заново добавить его в приложение пользователя.}}
Для учёта изменения внешнего адреса сервера PayControl, по которому связываются мобильное приложение с сервером PayControl, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:

<syntaxhighlight lang="sql">update pc_system set pc_is_external_url = 'http[s]://<IP или DNS-имя>[:PORT]/PayControl-interaction-rest/' where systemid='<SYSTEMID>';</syntaxhighlight>

Установка PayControl v3.9 Linux

2026-07-11T14:26:56Z

D.bizyukov: /* Создание индексов БД PCS */

Статья описывает установку с помощью инсталляционного скрипта.
=Справка скрипта инсталляции=
<pre>Execution modes:
-i Install. Set it for process installation.
-h Help. Will show this help.

Installation options:
-r Register system (only on PCS, matters with -i option). Optional. For registration you must put you register system request file to "customer" directory before. Contact you supplier for obtain this request file.

PC roles (must selected at least one of them):
-S PC Server
-P PC Pusher
-E External / PCIS External
-G PC Server Signer (only for version 5.2 and above)

Install wildfly database driver (mandatory for PCS and PCSS modules):
-p PostgreSQL
-o Oracle
Need to set up parameter - jdbc version:
8 JDBCv8. Certified with JDK8 and JDK11. Supports Oracle Database versions - 21c, 19c, 18c, and 12.2
0 JDBCv10. Implements JDBC 4.3 spec and certified with JDK11. Supports Oracle Database versions - 21c, 19c, 18c, and 12.2
1 JDBCv11. Implements JDBC 4.3 spec and certified with JDK11 and JDK17. Supports Oracle Database versions - 21c, 19c, 18c, and 12.2
-m MS SQL

Examples
install.sh -i -SPEG -r -o8
also like
install.sh -iSPEGro8
will install PCS, PCP, PCE, PCSS, Oracle JDBC8 Driver and execute register system request

install.sh -i -Sp
also like
install.sh -Sp
will install PCS with Postgres drivers</pre>

= Перед установкой PayControl =

Установить последнюю версию JDK 11.

= Конфигурирование =

Конфигурирование производится путём редактирования раздела <code>CUSTOMER Config</code> файла <code>install.conf</code>.

== Подключение к БД для PCS==

Необходимо установить корректные значения адресов и портов СУБД, имена пользователей и пароли.

=== СУБД Oracle ===

При использовании СУБД Oracle необходимо указать, каким образом происходит выбор необходимой БД - с помощью SID или Service Name.

Также '''необходимо''' следуя высланной инструкции '''Oracle. Создание пользователя, табличного пространства и таблиц''' выполнить ее 3-й пункт.

== Настройка PCE для подключения к PCS ==

Для соединения PCE с PCS необходимо указать правильный адрес сервера PCS по которому он сможет получить к нему доступ.

== Пример ==

<syntaxhighlight lang="bash">###################################################
#
# CUSTOMER Config
#
###################################################

PC_PATH='/opt/pc'
PC_PRODUCT='PayControl'

# 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=':'

### PCE

PCS_HOSTNAME_PORT='localhost:8080'</syntaxhighlight>

= Установка =

У пользователя, осуществляющего установку должны быть права на выполнение действий с уровнем привилегий root, либо возможность использовать учётную запись root.
# Скопировать файлы дистрибутива на сервер, например в домашнюю папку пользователя.
# Перейти в директорию с дистрибутивом.
# Запустить установочный скрипт с привилегиями root, с необходимыми параметрами.

== PC Pusher ==

Установка PC Pusher на сервере вместе с другим уже установленным модулем PC выполняется следующим образом:

* Скопировать файл приложения сервера в ''WF_PATH\standalone\deployments\'':
** на PC Pusher - файл ''pc-pusher-<VERSION>.war''
* Дождаться старта WF, проверить, что нет ошибок запуска.
* После развёртывания новых файлов, в директории deployments будут созданы файлы:
** с расширением *.deployed, где вместо * будут указаны названия новых модулей.
** После того, как появятся файлы *.deployed, рекомендуется перезапустить Wildfly
** При появлении файлов с расширением *.failed, необходимо перезапустить Wildfly.

= Результат выполнения инсталляционного скрипта =

Результат выполнения инсталляционного скрипта является:

* установка службы wildflу (директория /opt);
* включение автозапуска службы wildfly;
* добавление драйверов СУБД (опционально);
* добавление источников данных (только для PCS);
* развёртывание файлов сервера в wildfly;
* регистрация прикладной системы в PayControl (при установленном параметре "'''r'''"). Результат регистрации - вывод на экран идентификатора системы в конце журнала работы инсталляционного скрипта (systemid). Пример:<syntaxhighlight lang="xml"><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Body><ns3:registerSystemResponse xmlns:ns2="http://ws.safetech.ru/PayControl/services/ws/common/" xmlns:ns3="http://ws.safetech.ru/PayControlV3/"><systemId>e64a67c9-73e9-462c-9c27-2d0195a2bd23</systemId></ns3:registerSystemResponse></soap:Body></soap:Envelope></syntaxhighlight> В приведённом примере идентификатором зарегистрированной прикладной системы является ''e64a67c9-73e9-462c-9c27-2d0195a2bd23''. В дальнейшем этот идентификатор понадобится при настройке прикладной системы на работу с PayControl. Если значение идентификатора прикладной системы утеряно, свяжитесь с компанией СэйфТек для его уточнения.

== Примеры параметров запуска ==

Примеры ниже приведены для установки PayControl с драйвером PostgreSQL (параметр "'''p'''").

=== Всё на одном сервере ===

==== Без регистрации прикладной системы ====

<syntaxhighlight lang="bash">sudo ./install.sh -ipSE</syntaxhighlight>

==== С регистрацией прикладной системы ====

<syntaxhighlight lang="bash">sudo ./install.sh -ipSEr</syntaxhighlight>

=== PCS ===

==== Без регистрации прикладной системы ====

<syntaxhighlight lang="bash">sudo ./install.sh -ipS</syntaxhighlight>

==== С регистрацией прикладной системы ====

<syntaxhighlight lang="bash">sudo ./install.sh -ipSr</syntaxhighlight>

=== PCE ===

<syntaxhighlight lang="bash">sudo ./install.sh -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'''".

== Проверка доступности сервисов ==

=== PCS ===

Сервисы доступны по ссылкам (при запросе на эти адреса должна возвратиться WSDL-схема):
<pre>http://<IP или имя сервера PCS>:8080/ws/PayControlServiceV3?wsdl
http://<IP или имя сервера PCS>:8080/ws/PayControlReportService?wsdl</pre>

=== PCP ===

Сервис доступен по адресу:

<pre>http://<IP или имя сервера PC Pusher>:8080/pc-pusher-api/health_check</pre>

=== PCE ===

Сервис доступен по адресу

<pre>http://<IP или имя сервера PCIS External>:8080/PayControl-interaction-rest/</pre>

При запросе на этот адрес должно возвратиться текст «Not Found» с HTTP-кодом 404. В Internet Explorer будет выведена своя страница браузера, сообщающая о том, что страница не найдена.

= Внесение изменений в БД =

== Создание индексов БД 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 ==

Для корректировки типов данных необходимо выполнить следующий запрос к БД PCS:

<syntaxhighlight lang="sql">ALTER TABLE PC_TRANSACTION ALTER COLUMN DATA_BINARY image;</syntaxhighlight>

= Настройка PC Pusher для отправки пушей в другое приложение (при необходимости) =
Необходимо выполнить пункты описанные по ссылке [[Обновление_с_3.6_до_3.8#Настройка PC Pusher|"Настройка PCS и PC Pusher"]]

= Корректировка (смена) адресов серверов PayControl (при необходимости) =

{{Предупреждение|Не рекомендуется дополнительно указывать номер порта, в случаях, если для HTTP используется порт 80, или для HTTPS используется порт 443}}

== Учёт изменения адреса сервера PCS ==

Для учёта изменения адреса сервера PCS необходимо произвести изменения в настройках PCE. В файле /opt/wildfly/bin/standalone.conf, в следующей строке, указав правильный адрес и при необходимости порт сервера PCS, а также уточнив протокол подключения (HTTP/HTTPS):

<syntaxhighlight lang="bash">
JAVA_OPTS="$JAVA_OPTS -Dpcservice.endpoint=http[s]://<IP или DNS-имя>[:PORT]/ws/PayControlServiceV3?wsdl -Duser.language=ru -Dpaycontrol.locale=ru"
</syntaxhighlight>

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

== Учёт изменения адреса сервера PC Pusher ==

Для учёта изменения адреса сервера PC Pusher, необходимо, предварительно указав корректные данные (протокол (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>

== Учёт изменения внешнего адреса сервера PCE ==

{{Предупреждение|Если система была переведена в промышленную эксплуатацию, при смене адреса для доступа мобильных устройств, не рекомендуется выводить из действия предыдущий адрес на протяжении всего срока действия выпущенных ключей пользователя. Иначе мобильное приложение потеряет доступ к серверу PayControl и для восстановления будет необходимо перевыпустить ключ и заново добавить его в приложение пользователя.}}
Для учёта изменения внешнего адреса сервера PayControl, по которому связываются мобильное приложение с сервером PayControl, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:

<syntaxhighlight lang="sql">update pc_system set pc_is_external_url = 'http[s]://<IP или DNS-имя>[:PORT]/PayControl-interaction-rest/' where systemid='<SYSTEMID>';</syntaxhighlight>

Руководство администратора PayControl v3

2026-07-07T18:58:50Z

D.bizyukov: /* Изменение записи */

= Назначение документа =
Настоящее руководство предназначено для администраторов, выполняющих задачи по обслуживанию серверов PayControl: запуск и остановку служб, журналирование, установку лицензии, обновление и регламентные работы.

= О продукте =
PayControl — программный комплекс для подтверждения пользователем операций в системах дистанционного банковского обслуживания и электронного документооборота. По сравнению с SMS, одноразовыми паролями (OTP), скретч-картами и MAC-токенами PayControl обеспечивает более высокий уровень удобства и информационной безопасности.

= Общее описание =
Сервер PayControl работает на базе сервера приложений [[Wildfly]] в среде Java 11 и состоит из трёх компонентов:

{| class="wikitable"
! Компонент !! Назначение !! Расположение и требования
|-
| '''PayControl Server (PCS)''' || Основной сервер. Взаимодействует с прикладной системой, хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External. || Локальная сеть.
|-
| '''PCIS Internal''' (PayControl Interaction Server Internal) || Отправляет Push-уведомления о появлении неподтверждённой транзакции (без сведений о самой транзакции). || Как правило, DMZ-зона, с доступом в Интернет - требуется доступ к серверам Google и Apple. Может размещаться на одном сервере с PCS или PCIS External - в зависимости от требований ИБ и возможностей ИТ-инфраструктуры банка.
|-
| '''PCIS External''' (PayControl Interaction Server External) || Взаимодействует с мобильными приложениями: передаёт данные платежа, принимает результаты подтверждения транзакций. || DMZ-зона с доступом извне; внешний фиксированный IP-адрес. Для TLS - доменное имя и сертификат внешнего УЦ.
|}

= Запуск и остановка служб =
== Linux ==
<syntaxhighlight lang="bash">
systemctl start wildfly.service # запуск
systemctl stop wildfly.service # остановка
systemctl restart wildfly.service # перезапуск
</syntaxhighlight>

== Windows ==
Через консоль управления службами (''services.msc'') либо из командной строки:
<syntaxhighlight lang="bat">
net start wildfly
net stop wildfly
</syntaxhighlight>

= Журналирование =
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

== Включение вывода информационных данных работы PayControl ==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayControl.
=== Для PCS и PCIS Internal ===
==== Вывод отладочной информации ====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL-запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

===== Изменение записи =====
Пример SQL-запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

==== Вывод содержимого SOAP-запросов и ответов ====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <code><nowiki><extensions> ... </extensions></nowiki></code> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

=== PCIS External (с версии 3.6) ===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

= Отправка информации о событиях =
Адрес для отправки информации об устройстве и о событиях взаимодействия мобильного приложения (SDK) с сервером PayControl задаётся в БД PCS: таблица <code>pc_system</code>, поле <code>events_post_url</code>.
<syntaxhighlight lang="sql">
update pc_system set events_post_url = 'http://example.com/pc_events_reciever' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';
</syntaxhighlight>

После изменения перезапустите WildFly PCS.

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

= Установка лицензии =
Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.

При включённой отладочной информации в журнал выводятся сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

== Запросом к БД ==
Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:
* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

== Добавлением файла лицензии ==
Скопируйте файл лицензии на сервер PCS:
* Linux — в <code>/opt/wildfly/</code>;
* Windows — в <code>C:\wildfly\</code> или <code>C:\PayControl\</code>.

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:58:32Z

D.bizyukov: /* Вывод отладочной информации */

= Назначение документа =
Настоящее руководство предназначено для администраторов, выполняющих задачи по обслуживанию серверов PayControl: запуск и остановку служб, журналирование, установку лицензии, обновление и регламентные работы.

= О продукте =
PayControl — программный комплекс для подтверждения пользователем операций в системах дистанционного банковского обслуживания и электронного документооборота. По сравнению с SMS, одноразовыми паролями (OTP), скретч-картами и MAC-токенами PayControl обеспечивает более высокий уровень удобства и информационной безопасности.

= Общее описание =
Сервер PayControl работает на базе сервера приложений [[Wildfly]] в среде Java 11 и состоит из трёх компонентов:

{| class="wikitable"
! Компонент !! Назначение !! Расположение и требования
|-
| '''PayControl Server (PCS)''' || Основной сервер. Взаимодействует с прикладной системой, хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External. || Локальная сеть.
|-
| '''PCIS Internal''' (PayControl Interaction Server Internal) || Отправляет Push-уведомления о появлении неподтверждённой транзакции (без сведений о самой транзакции). || Как правило, DMZ-зона, с доступом в Интернет - требуется доступ к серверам Google и Apple. Может размещаться на одном сервере с PCS или PCIS External - в зависимости от требований ИБ и возможностей ИТ-инфраструктуры банка.
|-
| '''PCIS External''' (PayControl Interaction Server External) || Взаимодействует с мобильными приложениями: передаёт данные платежа, принимает результаты подтверждения транзакций. || DMZ-зона с доступом извне; внешний фиксированный IP-адрес. Для TLS - доменное имя и сертификат внешнего УЦ.
|}

= Запуск и остановка служб =
== Linux ==
<syntaxhighlight lang="bash">
systemctl start wildfly.service # запуск
systemctl stop wildfly.service # остановка
systemctl restart wildfly.service # перезапуск
</syntaxhighlight>

== Windows ==
Через консоль управления службами (''services.msc'') либо из командной строки:
<syntaxhighlight lang="bat">
net start wildfly
net stop wildfly
</syntaxhighlight>

= Журналирование =
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

== Включение вывода информационных данных работы PayControl ==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayControl.
=== Для PCS и PCIS Internal ===
==== Вывод отладочной информации ====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL-запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

===== Изменение записи =====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

==== Вывод содержимого SOAP-запросов и ответов ====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <code><nowiki><extensions> ... </extensions></nowiki></code> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

=== PCIS External (с версии 3.6) ===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

= Отправка информации о событиях =
Адрес для отправки информации об устройстве и о событиях взаимодействия мобильного приложения (SDK) с сервером PayControl задаётся в БД PCS: таблица <code>pc_system</code>, поле <code>events_post_url</code>.
<syntaxhighlight lang="sql">
update pc_system set events_post_url = 'http://example.com/pc_events_reciever' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';
</syntaxhighlight>

После изменения перезапустите WildFly PCS.

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

= Установка лицензии =
Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.

При включённой отладочной информации в журнал выводятся сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

== Запросом к БД ==
Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:
* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

== Добавлением файла лицензии ==
Скопируйте файл лицензии на сервер PCS:
* Linux — в <code>/opt/wildfly/</code>;
* Windows — в <code>C:\wildfly\</code> или <code>C:\PayControl\</code>.

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:56:41Z

D.bizyukov: /* Вывод содержимого SOAP-запросов и ответов */

= Назначение документа =
Настоящее руководство предназначено для администраторов, выполняющих задачи по обслуживанию серверов PayControl: запуск и остановку служб, журналирование, установку лицензии, обновление и регламентные работы.

= О продукте =
PayControl — программный комплекс для подтверждения пользователем операций в системах дистанционного банковского обслуживания и электронного документооборота. По сравнению с SMS, одноразовыми паролями (OTP), скретч-картами и MAC-токенами PayControl обеспечивает более высокий уровень удобства и информационной безопасности.

= Общее описание =
Сервер PayControl работает на базе сервера приложений [[Wildfly]] в среде Java 11 и состоит из трёх компонентов:

{| class="wikitable"
! Компонент !! Назначение !! Расположение и требования
|-
| '''PayControl Server (PCS)''' || Основной сервер. Взаимодействует с прикладной системой, хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External. || Локальная сеть.
|-
| '''PCIS Internal''' (PayControl Interaction Server Internal) || Отправляет Push-уведомления о появлении неподтверждённой транзакции (без сведений о самой транзакции). || Как правило, DMZ-зона, с доступом в Интернет - требуется доступ к серверам Google и Apple. Может размещаться на одном сервере с PCS или PCIS External - в зависимости от требований ИБ и возможностей ИТ-инфраструктуры банка.
|-
| '''PCIS External''' (PayControl Interaction Server External) || Взаимодействует с мобильными приложениями: передаёт данные платежа, принимает результаты подтверждения транзакций. || DMZ-зона с доступом извне; внешний фиксированный IP-адрес. Для TLS - доменное имя и сертификат внешнего УЦ.
|}

= Запуск и остановка служб =
== Linux ==
<syntaxhighlight lang="bash">
systemctl start wildfly.service # запуск
systemctl stop wildfly.service # остановка
systemctl restart wildfly.service # перезапуск
</syntaxhighlight>

== Windows ==
Через консоль управления службами (''services.msc'') либо из командной строки:
<syntaxhighlight lang="bat">
net start wildfly
net stop wildfly
</syntaxhighlight>

= Журналирование =
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

== Включение вывода информационных данных работы PayControl ==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayControl.
=== Для PCS и PCIS Internal ===
==== Вывод отладочной информации ====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

===== Изменение записи =====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

==== Вывод содержимого SOAP-запросов и ответов ====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <code><nowiki><extensions> ... </extensions></nowiki></code> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

=== PCIS External (с версии 3.6) ===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

= Отправка информации о событиях =
Адрес для отправки информации об устройстве и о событиях взаимодействия мобильного приложения (SDK) с сервером PayControl задаётся в БД PCS: таблица <code>pc_system</code>, поле <code>events_post_url</code>.
<syntaxhighlight lang="sql">
update pc_system set events_post_url = 'http://example.com/pc_events_reciever' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';
</syntaxhighlight>

После изменения перезапустите WildFly PCS.

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

= Установка лицензии =
Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.

При включённой отладочной информации в журнал выводятся сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

== Запросом к БД ==
Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:
* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

== Добавлением файла лицензии ==
Скопируйте файл лицензии на сервер PCS:
* Linux — в <code>/opt/wildfly/</code>;
* Windows — в <code>C:\wildfly\</code> или <code>C:\PayControl\</code>.

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:55:34Z

D.bizyukov: /* Включение вывода информационных данных работы PayControl */

= Назначение документа =
Настоящее руководство предназначено для администраторов, выполняющих задачи по обслуживанию серверов PayControl: запуск и остановку служб, журналирование, установку лицензии, обновление и регламентные работы.

= О продукте =
PayControl — программный комплекс для подтверждения пользователем операций в системах дистанционного банковского обслуживания и электронного документооборота. По сравнению с SMS, одноразовыми паролями (OTP), скретч-картами и MAC-токенами PayControl обеспечивает более высокий уровень удобства и информационной безопасности.

= Общее описание =
Сервер PayControl работает на базе сервера приложений [[Wildfly]] в среде Java 11 и состоит из трёх компонентов:

{| class="wikitable"
! Компонент !! Назначение !! Расположение и требования
|-
| '''PayControl Server (PCS)''' || Основной сервер. Взаимодействует с прикладной системой, хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External. || Локальная сеть.
|-
| '''PCIS Internal''' (PayControl Interaction Server Internal) || Отправляет Push-уведомления о появлении неподтверждённой транзакции (без сведений о самой транзакции). || Как правило, DMZ-зона, с доступом в Интернет - требуется доступ к серверам Google и Apple. Может размещаться на одном сервере с PCS или PCIS External - в зависимости от требований ИБ и возможностей ИТ-инфраструктуры банка.
|-
| '''PCIS External''' (PayControl Interaction Server External) || Взаимодействует с мобильными приложениями: передаёт данные платежа, принимает результаты подтверждения транзакций. || DMZ-зона с доступом извне; внешний фиксированный IP-адрес. Для TLS - доменное имя и сертификат внешнего УЦ.
|}

= Запуск и остановка служб =
== Linux ==
<syntaxhighlight lang="bash">
systemctl start wildfly.service # запуск
systemctl stop wildfly.service # остановка
systemctl restart wildfly.service # перезапуск
</syntaxhighlight>

== Windows ==
Через консоль управления службами (''services.msc'') либо из командной строки:
<syntaxhighlight lang="bat">
net start wildfly
net stop wildfly
</syntaxhighlight>

= Журналирование =
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

== Включение вывода информационных данных работы PayControl ==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayControl.
=== Для PCS и PCIS Internal ===
==== Вывод отладочной информации ====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

===== Изменение записи =====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

==== Вывод содержимого SOAP-запросов и ответов ====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

=== PCIS External (с версии 3.6) ===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

= Отправка информации о событиях =
Адрес для отправки информации об устройстве и о событиях взаимодействия мобильного приложения (SDK) с сервером PayControl задаётся в БД PCS: таблица <code>pc_system</code>, поле <code>events_post_url</code>.
<syntaxhighlight lang="sql">
update pc_system set events_post_url = 'http://example.com/pc_events_reciever' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';
</syntaxhighlight>

После изменения перезапустите WildFly PCS.

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

= Установка лицензии =
Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.

При включённой отладочной информации в журнал выводятся сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

== Запросом к БД ==
Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:
* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

== Добавлением файла лицензии ==
Скопируйте файл лицензии на сервер PCS:
* Linux — в <code>/opt/wildfly/</code>;
* Windows — в <code>C:\wildfly\</code> или <code>C:\PayControl\</code>.

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:54:14Z

D.bizyukov:

= Назначение документа =
Настоящее руководство предназначено для администраторов, выполняющих задачи по обслуживанию серверов PayControl: запуск и остановку служб, журналирование, установку лицензии, обновление и регламентные работы.

= О продукте =
PayControl — программный комплекс для подтверждения пользователем операций в системах дистанционного банковского обслуживания и электронного документооборота. По сравнению с SMS, одноразовыми паролями (OTP), скретч-картами и MAC-токенами PayControl обеспечивает более высокий уровень удобства и информационной безопасности.

= Общее описание =
Сервер PayControl работает на базе сервера приложений [[Wildfly]] в среде Java 11 и состоит из трёх компонентов:

{| class="wikitable"
! Компонент !! Назначение !! Расположение и требования
|-
| '''PayControl Server (PCS)''' || Основной сервер. Взаимодействует с прикладной системой, хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External. || Локальная сеть.
|-
| '''PCIS Internal''' (PayControl Interaction Server Internal) || Отправляет Push-уведомления о появлении неподтверждённой транзакции (без сведений о самой транзакции). || Как правило, DMZ-зона, с доступом в Интернет - требуется доступ к серверам Google и Apple. Может размещаться на одном сервере с PCS или PCIS External - в зависимости от требований ИБ и возможностей ИТ-инфраструктуры банка.
|-
| '''PCIS External''' (PayControl Interaction Server External) || Взаимодействует с мобильными приложениями: передаёт данные платежа, принимает результаты подтверждения транзакций. || DMZ-зона с доступом извне; внешний фиксированный IP-адрес. Для TLS - доменное имя и сертификат внешнего УЦ.
|}

= Запуск и остановка служб =
== Linux ==
<syntaxhighlight lang="bash">
systemctl start wildfly.service # запуск
systemctl stop wildfly.service # остановка
systemctl restart wildfly.service # перезапуск
</syntaxhighlight>

== Windows ==
Через консоль управления службами (''services.msc'') либо из командной строки:
<syntaxhighlight lang="bat">
net start wildfly
net stop wildfly
</syntaxhighlight>

= Журналирование =
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

== Включение вывода информационных данных работы PayControl ==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
=== Для PCS и PCIS Internal ===
==== Вывод отладочной информации ====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

===== Изменение записи =====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

==== Вывод содержимого SOAP-запросов и ответов ====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

=== PCIS External (с версии 3.6) ===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

= Отправка информации о событиях =
Адрес для отправки информации об устройстве и о событиях взаимодействия мобильного приложения (SDK) с сервером PayControl задаётся в БД PCS: таблица <code>pc_system</code>, поле <code>events_post_url</code>.
<syntaxhighlight lang="sql">
update pc_system set events_post_url = 'http://example.com/pc_events_reciever' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';
</syntaxhighlight>

После изменения перезапустите WildFly PCS.

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

= Установка лицензии =
Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.

При включённой отладочной информации в журнал выводятся сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

== Запросом к БД ==
Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:
* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

== Добавлением файла лицензии ==
Скопируйте файл лицензии на сервер PCS:
* Linux — в <code>/opt/wildfly/</code>;
* Windows — в <code>C:\wildfly\</code> или <code>C:\PayControl\</code>.

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:50:26Z

D.bizyukov:

= Назначение документа =
Настоящее руководство предназначено для администраторов, выполняющих задачи по обслуживанию серверов PayControl: запуск и остановку служб, журналирование, установку лицензии, обновление и регламентные работы.

= О продукте =
PayControl — программный комплекс для подтверждения пользователем операций в системах дистанционного банковского обслуживания и электронного документооборота. По сравнению с SMS, одноразовыми паролями (OTP), скретч-картами и MAC-токенами PayControl обеспечивает более высокий уровень удобства и информационной безопасности.

= Общее описание =
Сервер PayControl работает на базе сервера приложений [[Wildfly]] в среде Java 11 и состоит из трёх компонентов:

{| class="wikitable"
! Компонент !! Назначение !! Расположение и требования
|-
| '''PayControl Server (PCS)''' || Основной сервер. Взаимодействует с прикладной системой, хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External. || Локальная сеть.
|-
| '''PCIS Internal''' (PayControl Interaction Server Internal) || Отправляет Push-уведомления о появлении неподтверждённой транзакции (без сведений о самой транзакции). || Как правило, DMZ-зона, с доступом в Интернет - требуется доступ к серверам Google и Apple. Может размещаться на одном сервере с PCS или PCIS External - в зависимости от требований ИБ и возможностей ИТ-инфраструктуры банка.
|-
| '''PCIS External''' (PayControl Interaction Server External) || Взаимодействует с мобильными приложениями: передаёт данные платежа, принимает результаты подтверждения транзакций. || DMZ-зона с доступом извне; внешний фиксированный IP-адрес. Для TLS - доменное имя и сертификат внешнего УЦ.
|}

= Запуск и остановка служб сервера PayControl =
== Linux ==
<syntaxhighlight lang="bash">
systemctl start wildfly.service # запуск
systemctl stop wildfly.service # остановка
systemctl restart wildfly.service # перезапуск
</syntaxhighlight>

== Windows ==
Через консоль управления службами (''services.msc'') либо из командной строки:
<syntaxhighlight lang="bat">
net start wildfly
net stop wildfly
</syntaxhighlight>

= Журналирование =
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

== Включение вывода информационных данных работы PayControl ==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
=== Для PCS и PCIS Internal ===
==== Вывод отладочной информации ====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

===== Изменение записи =====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

==== Вывод содержимого SOAP-запросов и ответов ====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

=== PCIS External (с версии 3.6) ===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

= Отправка информации о событиях =
Адрес для отправки информации об устройстве и о событиях взаимодействия мобильного приложения (SDK) с сервером PayControl задаётся в БД PCS: таблица <code>pc_system</code>, поле <code>events_post_url</code>.
<syntaxhighlight lang="sql">
update pc_system set events_post_url = 'http://example.com/pc_events_reciever' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';
</syntaxhighlight>

После изменения перезапустите WildFly PCS.

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

= Установка лицензии =
Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.

При включённой отладочной информации в журнал выводятся сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

== Запросом к БД ==
Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:
* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

== Добавлением файла лицензии ==
Скопируйте файл лицензии на сервер PCS:
* Linux — в <code>/opt/wildfly/</code>;
* Windows — в <code>C:\wildfly\</code> или <code>C:\PayControl\</code>.

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:48:07Z

D.bizyukov: /* Отправка информации о событиях */

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.
=Назначение=
Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
=Общее описание=
Сервер PayControl работает на базе сервера приложений [[Wildfly]] в среде Java 11 и состоит из трёх компонентов:

{| class="wikitable"
! Компонент !! Назначение !! Расположение и требования
|-
| '''PayControl Server (PCS)''' || Основной сервер. Взаимодействует с прикладной системой, хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External. || Локальная сеть.
|-
| '''PCIS Internal''' (PayControl Interaction Server Internal) || Отправляет Push-уведомления о появлении неподтверждённой транзакции (без сведений о самой транзакции). || Как правило, DMZ-зона, с доступом в Интернет - требуется доступ к серверам Google и Apple. Может размещаться на одном сервере с PCS или PCIS External - в зависимости от требований ИБ и возможностей ИТ-инфраструктуры банка.
|-
| '''PCIS External''' (PayControl Interaction Server External) || Взаимодействует с мобильными приложениями: передаёт данные платежа, принимает результаты подтверждения транзакций. || DMZ-зона с доступом извне; внешний фиксированный IP-адрес. Для TLS - доменное имя и сертификат внешнего УЦ.
|}

= Запуск и остановка служб сервера PayControl =
== Linux ==
<syntaxhighlight lang="bash">
systemctl start wildfly.service # запуск
systemctl stop wildfly.service # остановка
systemctl restart wildfly.service # перезапуск
</syntaxhighlight>

== Windows ==
Через консоль управления службами (''services.msc'') либо из командной строки:
<syntaxhighlight lang="bat">
net start wildfly
net stop wildfly
</syntaxhighlight>

=Журналирование=
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

=====Изменение записи=====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

=Отправка информации о событиях=
Адрес для отправки информации об устройстве и о событиях взаимодействия мобильного приложения (SDK) с сервером PayControl задаётся в БД PCS: таблица <code>pc_system</code>, поле <code>events_post_url</code>.
<syntaxhighlight lang="sql">
update pc_system set events_post_url = 'http://example.com/pc_events_reciever' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';
</syntaxhighlight>

После изменения перезапустите WildFly PCS.

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

=Установка лицензии=
Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.

При включённой отладочной информации в журнал выводятся сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:
* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==
Скопируйте файл лицензии на сервер PCS:
* Linux — в <code>/opt/wildfly/</code>;
* Windows — в <code>C:\wildfly\</code> или <code>C:\PayControl\</code>.

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:44:18Z

D.bizyukov: /* Запуск и остановка служб сервера PayControl */

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.
=Назначение=
Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
=Общее описание=
Сервер PayControl работает на базе сервера приложений [[Wildfly]] в среде Java 11 и состоит из трёх компонентов:

{| class="wikitable"
! Компонент !! Назначение !! Расположение и требования
|-
| '''PayControl Server (PCS)''' || Основной сервер. Взаимодействует с прикладной системой, хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External. || Локальная сеть.
|-
| '''PCIS Internal''' (PayControl Interaction Server Internal) || Отправляет Push-уведомления о появлении неподтверждённой транзакции (без сведений о самой транзакции). || Как правило, DMZ-зона, с доступом в Интернет - требуется доступ к серверам Google и Apple. Может размещаться на одном сервере с PCS или PCIS External - в зависимости от требований ИБ и возможностей ИТ-инфраструктуры банка.
|-
| '''PCIS External''' (PayControl Interaction Server External) || Взаимодействует с мобильными приложениями: передаёт данные платежа, принимает результаты подтверждения транзакций. || DMZ-зона с доступом извне; внешний фиксированный IP-адрес. Для TLS - доменное имя и сертификат внешнего УЦ.
|}

= Запуск и остановка служб сервера PayControl =
== Linux ==
<syntaxhighlight lang="bash">
systemctl start wildfly.service # запуск
systemctl stop wildfly.service # остановка
systemctl restart wildfly.service # перезапуск
</syntaxhighlight>

== Windows ==
Через консоль управления службами (''services.msc'') либо из командной строки:
<syntaxhighlight lang="bat">
net start wildfly
net stop wildfly
</syntaxhighlight>

=Журналирование=
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

=====Изменение записи=====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

=Отправка информации о событиях=
Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения или SDK PayControl с сервером PayControl устанавливается в БД PCS, таблица pc_system, поле events_post_url.
<syntaxhighlight lang="sql">
update pc_system set events_post_url='http://example.com/pc_events_reciever';
</syntaxhighlight>
После этого нужно перезапустить WildFly PCS для применения изменений.

{{Предупреждение|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
=Установка лицензии=
Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.

При включённой отладочной информации в журнал выводятся сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:
* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==
Скопируйте файл лицензии на сервер PCS:
* Linux — в <code>/opt/wildfly/</code>;
* Windows — в <code>C:\wildfly\</code> или <code>C:\PayControl\</code>.

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:42:34Z

D.bizyukov: /* Общее описание */

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.
=Назначение=
Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
=Общее описание=
Сервер PayControl работает на базе сервера приложений [[Wildfly]] в среде Java 11 и состоит из трёх компонентов:

{| class="wikitable"
! Компонент !! Назначение !! Расположение и требования
|-
| '''PayControl Server (PCS)''' || Основной сервер. Взаимодействует с прикладной системой, хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External. || Локальная сеть.
|-
| '''PCIS Internal''' (PayControl Interaction Server Internal) || Отправляет Push-уведомления о появлении неподтверждённой транзакции (без сведений о самой транзакции). || Как правило, DMZ-зона, с доступом в Интернет - требуется доступ к серверам Google и Apple. Может размещаться на одном сервере с PCS или PCIS External - в зависимости от требований ИБ и возможностей ИТ-инфраструктуры банка.
|-
| '''PCIS External''' (PayControl Interaction Server External) || Взаимодействует с мобильными приложениями: передаёт данные платежа, принимает результаты подтверждения транзакций. || DMZ-зона с доступом извне; внешний фиксированный IP-адрес. Для TLS - доменное имя и сертификат внешнего УЦ.
|}

=Запуск и остановка служб сервера PayControl=
==Linux==
Запуск:
<syntaxhighlight lang="bash">
systemctl start wildfly.service
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bash">
systemctl stop wildfly.service
</syntaxhighlight>
Перезапуск:
<syntaxhighlight lang="bash">
systemctl restart wildfly.service
</syntaxhighlight>
==Windows==
===Из графического интерфейса===
Запуск, остановка и перезапуск службы осуществляется из консоли управления службами сервером (консоль services.msc).
===С помощью командной строки===
Запуск:
<syntaxhighlight lang="bat">
net start wildfly
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bat">
net stop wildfly
</syntaxhighlight>
=Журналирование=
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

=====Изменение записи=====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

=Отправка информации о событиях=
Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения или SDK PayControl с сервером PayControl устанавливается в БД PCS, таблица pc_system, поле events_post_url.
<syntaxhighlight lang="sql">
update pc_system set events_post_url='http://example.com/pc_events_reciever';
</syntaxhighlight>
После этого нужно перезапустить WildFly PCS для применения изменений.

{{Предупреждение|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
=Установка лицензии=
Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.

При включённой отладочной информации в журнал выводятся сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:
* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==
Скопируйте файл лицензии на сервер PCS:
* Linux — в <code>/opt/wildfly/</code>;
* Windows — в <code>C:\wildfly\</code> или <code>C:\PayControl\</code>.

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:35:47Z

D.bizyukov: /* Общее описание */

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

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

=Запуск и остановка служб сервера PayControl=
==Linux==
Запуск:
<syntaxhighlight lang="bash">
systemctl start wildfly.service
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bash">
systemctl stop wildfly.service
</syntaxhighlight>
Перезапуск:
<syntaxhighlight lang="bash">
systemctl restart wildfly.service
</syntaxhighlight>
==Windows==
===Из графического интерфейса===
Запуск, остановка и перезапуск службы осуществляется из консоли управления службами сервером (консоль services.msc).
===С помощью командной строки===
Запуск:
<syntaxhighlight lang="bat">
net start wildfly
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bat">
net stop wildfly
</syntaxhighlight>
=Журналирование=
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

=====Изменение записи=====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

=Отправка информации о событиях=
Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения или SDK PayControl с сервером PayControl устанавливается в БД PCS, таблица pc_system, поле events_post_url.
<syntaxhighlight lang="sql">
update pc_system set events_post_url='http://example.com/pc_events_reciever';
</syntaxhighlight>
После этого нужно перезапустить WildFly PCS для применения изменений.

{{Предупреждение|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
=Установка лицензии=
Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.

При включённой отладочной информации в журнал выводятся сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:
* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==
Скопируйте файл лицензии на сервер PCS:
* Linux — в <code>/opt/wildfly/</code>;
* Windows — в <code>C:\wildfly\</code> или <code>C:\PayControl\</code>.

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:34:18Z

D.bizyukov: /* Установка лицензии */

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.
=Назначение=
Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
=Общее описание=
Сервер PayControl функционирует на базе сервера приложений [[Wildfly]] выполняющейся в среде Java 8 и состоит из следующих частей:
* PayControl Server (PCS) – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с прикладной системой. Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
* PayControl Interaction Server Internal (PCIS Internal) – сервер для отправки Push уведомлений о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Требуется доступ к серверам Google и Apple. Может быть размещён в т.ч. на одном сервере с PCS или PCIS Extrnal (в зависимости от требований ИБ к ИТ инфраструктуре Банка и функциональных возможностей ИТ инфраструктуры Банка).
* PayControl Interaction Server External (PCIS External). С этим сервером взаимодействуют приложения на мобильных устройствах для получения информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.
=Запуск и остановка служб сервера PayControl=
==Linux==
Запуск:
<syntaxhighlight lang="bash">
systemctl start wildfly.service
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bash">
systemctl stop wildfly.service
</syntaxhighlight>
Перезапуск:
<syntaxhighlight lang="bash">
systemctl restart wildfly.service
</syntaxhighlight>
==Windows==
===Из графического интерфейса===
Запуск, остановка и перезапуск службы осуществляется из консоли управления службами сервером (консоль services.msc).
===С помощью командной строки===
Запуск:
<syntaxhighlight lang="bat">
net start wildfly
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bat">
net stop wildfly
</syntaxhighlight>
=Журналирование=
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

=====Изменение записи=====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

=Отправка информации о событиях=
Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения или SDK PayControl с сервером PayControl устанавливается в БД PCS, таблица pc_system, поле events_post_url.
<syntaxhighlight lang="sql">
update pc_system set events_post_url='http://example.com/pc_events_reciever';
</syntaxhighlight>
После этого нужно перезапустить WildFly PCS для применения изменений.

{{Предупреждение|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
=Установка лицензии=
Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.

При включённой отладочной информации в журнал выводятся сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:
* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==
Скопируйте файл лицензии на сервер PCS:
* Linux — в <code>/opt/wildfly/</code>;
* Windows — в <code>C:\wildfly\</code> или <code>C:\PayControl\</code>.

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:34:09Z

D.bizyukov: /* Установка лицензии */

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.
=Назначение=
Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
=Общее описание=
Сервер PayControl функционирует на базе сервера приложений [[Wildfly]] выполняющейся в среде Java 8 и состоит из следующих частей:
* PayControl Server (PCS) – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с прикладной системой. Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
* PayControl Interaction Server Internal (PCIS Internal) – сервер для отправки Push уведомлений о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Требуется доступ к серверам Google и Apple. Может быть размещён в т.ч. на одном сервере с PCS или PCIS Extrnal (в зависимости от требований ИБ к ИТ инфраструктуре Банка и функциональных возможностей ИТ инфраструктуры Банка).
* PayControl Interaction Server External (PCIS External). С этим сервером взаимодействуют приложения на мобильных устройствах для получения информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.
=Запуск и остановка служб сервера PayControl=
==Linux==
Запуск:
<syntaxhighlight lang="bash">
systemctl start wildfly.service
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bash">
systemctl stop wildfly.service
</syntaxhighlight>
Перезапуск:
<syntaxhighlight lang="bash">
systemctl restart wildfly.service
</syntaxhighlight>
==Windows==
===Из графического интерфейса===
Запуск, остановка и перезапуск службы осуществляется из консоли управления службами сервером (консоль services.msc).
===С помощью командной строки===
Запуск:
<syntaxhighlight lang="bat">
net start wildfly
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bat">
net stop wildfly
</syntaxhighlight>
=Журналирование=
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

=====Изменение записи=====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

=Отправка информации о событиях=
Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения или SDK PayControl с сервером PayControl устанавливается в БД PCS, таблица pc_system, поле events_post_url.
<syntaxhighlight lang="sql">
update pc_system set events_post_url='http://example.com/pc_events_reciever';
</syntaxhighlight>
После этого нужно перезапустить WildFly PCS для применения изменений.

{{Предупреждение|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
=Установка лицензии=
Без лицензионного файла сервер работает в демонстрационном режиме: можно завести не более 20 активных пользователей PayControl.

При включённой отладочной информации в журнал выводятся сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:
* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==
Скопируйте файл лицензии на сервер PCS:
* Linux — в <code>/opt/wildfly/</code>;
* Windows — в <code>C:\wildfly\</code> или <code>C:\PayControl\</code>.

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:31:49Z

D.bizyukov: /* Запросом к БД */

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.
=Назначение=
Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
=Общее описание=
Сервер PayControl функционирует на базе сервера приложений [[Wildfly]] выполняющейся в среде Java 8 и состоит из следующих частей:
* PayControl Server (PCS) – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с прикладной системой. Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
* PayControl Interaction Server Internal (PCIS Internal) – сервер для отправки Push уведомлений о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Требуется доступ к серверам Google и Apple. Может быть размещён в т.ч. на одном сервере с PCS или PCIS Extrnal (в зависимости от требований ИБ к ИТ инфраструктуре Банка и функциональных возможностей ИТ инфраструктуры Банка).
* PayControl Interaction Server External (PCIS External). С этим сервером взаимодействуют приложения на мобильных устройствах для получения информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.
=Запуск и остановка служб сервера PayControl=
==Linux==
Запуск:
<syntaxhighlight lang="bash">
systemctl start wildfly.service
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bash">
systemctl stop wildfly.service
</syntaxhighlight>
Перезапуск:
<syntaxhighlight lang="bash">
systemctl restart wildfly.service
</syntaxhighlight>
==Windows==
===Из графического интерфейса===
Запуск, остановка и перезапуск службы осуществляется из консоли управления службами сервером (консоль services.msc).
===С помощью командной строки===
Запуск:
<syntaxhighlight lang="bat">
net start wildfly
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bat">
net stop wildfly
</syntaxhighlight>
=Журналирование=
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

=====Изменение записи=====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

=Отправка информации о событиях=
Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения или SDK PayControl с сервером PayControl устанавливается в БД PCS, таблица pc_system, поле events_post_url.
<syntaxhighlight lang="sql">
update pc_system set events_post_url='http://example.com/pc_events_reciever';
</syntaxhighlight>
После этого нужно перезапустить WildFly PCS для применения изменений.

{{Предупреждение|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
=Установка лицензии=
Если установка лицензионного файла не проводилась на сервер, то он работает в демонстрационном режиме, ограничивающем возможность заведения более 20 пользователей PayControl.
Также при включённом выводе информационных данных работы PayControl, в журнал выводятся сообщения сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Поместите содержимое файла лицензии в SQL-запрос к БД PCS, указав идентификатор системы:
* до версии 3.5 включительно:<syntaxhighlight lang="sql">update pc_system set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:<syntaxhighlight lang="sql">update pc_system_params set license = 'СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid = 'ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==
Скопируйте файл лицензии на сервер PCS:
* Linux — в <code>/opt/wildfly/</code>;
* Windows — в <code>C:\wildfly\</code> или <code>C:\PayControl\</code>.

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:29:11Z

D.bizyukov: /* Добавлением файла лицензии */

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.
=Назначение=
Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
=Общее описание=
Сервер PayControl функционирует на базе сервера приложений [[Wildfly]] выполняющейся в среде Java 8 и состоит из следующих частей:
* PayControl Server (PCS) – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с прикладной системой. Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
* PayControl Interaction Server Internal (PCIS Internal) – сервер для отправки Push уведомлений о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Требуется доступ к серверам Google и Apple. Может быть размещён в т.ч. на одном сервере с PCS или PCIS Extrnal (в зависимости от требований ИБ к ИТ инфраструктуре Банка и функциональных возможностей ИТ инфраструктуры Банка).
* PayControl Interaction Server External (PCIS External). С этим сервером взаимодействуют приложения на мобильных устройствах для получения информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.
=Запуск и остановка служб сервера PayControl=
==Linux==
Запуск:
<syntaxhighlight lang="bash">
systemctl start wildfly.service
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bash">
systemctl stop wildfly.service
</syntaxhighlight>
Перезапуск:
<syntaxhighlight lang="bash">
systemctl restart wildfly.service
</syntaxhighlight>
==Windows==
===Из графического интерфейса===
Запуск, остановка и перезапуск службы осуществляется из консоли управления службами сервером (консоль services.msc).
===С помощью командной строки===
Запуск:
<syntaxhighlight lang="bat">
net start wildfly
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bat">
net stop wildfly
</syntaxhighlight>
=Журналирование=
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

=====Изменение записи=====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

=Отправка информации о событиях=
Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения или SDK PayControl с сервером PayControl устанавливается в БД PCS, таблица pc_system, поле events_post_url.
<syntaxhighlight lang="sql">
update pc_system set events_post_url='http://example.com/pc_events_reciever';
</syntaxhighlight>
После этого нужно перезапустить WildFly PCS для применения изменений.

{{Предупреждение|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
=Установка лицензии=
Если установка лицензионного файла не проводилась на сервер, то он работает в демонстрационном режиме, ограничивающем возможность заведения более 20 пользователей PayControl.
Также при включённом выводе информационных данных работы PayControl, в журнал выводятся сообщения сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Для установки лицензии необходимо выполнить SQL-запрос к БД PCS, поместив в него содержимое файла лицензии указав идентификатор системы
* до версии 3.5 включительно:
*: <syntaxhighlight lang="sql">update pc_system set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:
*: <syntaxhighlight lang="sql">update pc_system_params set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==
Скопируйте файл лицензии на сервер PCS:
* Linux — в <code>/opt/wildfly/</code>;
* Windows — в <code>C:\wildfly\</code> или <code>C:\PayControl\</code>.

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:27:49Z

D.bizyukov: /* PCIS External (с версии 3.6) */

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.
=Назначение=
Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
=Общее описание=
Сервер PayControl функционирует на базе сервера приложений [[Wildfly]] выполняющейся в среде Java 8 и состоит из следующих частей:
* PayControl Server (PCS) – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с прикладной системой. Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
* PayControl Interaction Server Internal (PCIS Internal) – сервер для отправки Push уведомлений о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Требуется доступ к серверам Google и Apple. Может быть размещён в т.ч. на одном сервере с PCS или PCIS Extrnal (в зависимости от требований ИБ к ИТ инфраструктуре Банка и функциональных возможностей ИТ инфраструктуры Банка).
* PayControl Interaction Server External (PCIS External). С этим сервером взаимодействуют приложения на мобильных устройствах для получения информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.
=Запуск и остановка служб сервера PayControl=
==Linux==
Запуск:
<syntaxhighlight lang="bash">
systemctl start wildfly.service
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bash">
systemctl stop wildfly.service
</syntaxhighlight>
Перезапуск:
<syntaxhighlight lang="bash">
systemctl restart wildfly.service
</syntaxhighlight>
==Windows==
===Из графического интерфейса===
Запуск, остановка и перезапуск службы осуществляется из консоли управления службами сервером (консоль services.msc).
===С помощью командной строки===
Запуск:
<syntaxhighlight lang="bat">
net start wildfly
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bat">
net stop wildfly
</syntaxhighlight>
=Журналирование=
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

=====Изменение записи=====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии 3.6 PCIS External может журналировать запросы к <code>/jsonrequest_v2</code>.

Для включения добавьте в опции Java-машины параметр <code>paycontrol.logRequests=yes</code>:

* Linux — в файл <code>/opt/wildfly/bin/standalone.conf</code>:<syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* Windows — в файл <code>C:\wildfly\bin\standalone.conf.bat</code>:<syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>

Затем перезапустите службу wildfly.

=Отправка информации о событиях=
Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения или SDK PayControl с сервером PayControl устанавливается в БД PCS, таблица pc_system, поле events_post_url.
<syntaxhighlight lang="sql">
update pc_system set events_post_url='http://example.com/pc_events_reciever';
</syntaxhighlight>
После этого нужно перезапустить WildFly PCS для применения изменений.

{{Предупреждение|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
=Установка лицензии=
Если установка лицензионного файла не проводилась на сервер, то он работает в демонстрационном режиме, ограничивающем возможность заведения более 20 пользователей PayControl.
Также при включённом выводе информационных данных работы PayControl, в журнал выводятся сообщения сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Для установки лицензии необходимо выполнить SQL-запрос к БД PCS, поместив в него содержимое файла лицензии указав идентификатор системы
* до версии 3.5 включительно:
*: <syntaxhighlight lang="sql">update pc_system set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:
*: <syntaxhighlight lang="sql">update pc_system_params set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==

===Linux===
Файл лицензии необходимо скопировать в /opt/wildfly/ на сервер PCS.
===Windows===
Файл лицензии необходимо скопировать на сервер PCS в одну из папок:

*C:\wildfly\
*C:\PayControl\

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:25:12Z

D.bizyukov: /* Вывод содержимого SOAP-запросов и ответов */

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.
=Назначение=
Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
=Общее описание=
Сервер PayControl функционирует на базе сервера приложений [[Wildfly]] выполняющейся в среде Java 8 и состоит из следующих частей:
* PayControl Server (PCS) – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с прикладной системой. Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
* PayControl Interaction Server Internal (PCIS Internal) – сервер для отправки Push уведомлений о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Требуется доступ к серверам Google и Apple. Может быть размещён в т.ч. на одном сервере с PCS или PCIS Extrnal (в зависимости от требований ИБ к ИТ инфраструктуре Банка и функциональных возможностей ИТ инфраструктуры Банка).
* PayControl Interaction Server External (PCIS External). С этим сервером взаимодействуют приложения на мобильных устройствах для получения информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.
=Запуск и остановка служб сервера PayControl=
==Linux==
Запуск:
<syntaxhighlight lang="bash">
systemctl start wildfly.service
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bash">
systemctl stop wildfly.service
</syntaxhighlight>
Перезапуск:
<syntaxhighlight lang="bash">
systemctl restart wildfly.service
</syntaxhighlight>
==Windows==
===Из графического интерфейса===
Запуск, остановка и перезапуск службы осуществляется из консоли управления службами сервером (консоль services.msc).
===С помощью командной строки===
Запуск:
<syntaxhighlight lang="bat">
net start wildfly
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bat">
net stop wildfly
</syntaxhighlight>
=Журналирование=
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

=====Изменение записи=====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Опция не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux: <code>/opt/wildfly/standalone/configuration/standalone.xml</code>
#* Windows: <code>C:\wildfly\standalone\configuration\standalone.xml</code>
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии PCIS External 3.6 компонент может журналировать запросы, приходящие на /jsonrequest_v2.

Для включения журналирования необходимо в опции Java-машины добавить параметр ''paycontrol.logRequests=yes'' следующим образом:
* для Linux:
*: в файл /opt/wildfly/bin/standalone.conf добавить <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* для Windows:
*: в файл C:\wildfly\bin\standalone.conf.bat добавить <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>
затем перезапустить службу wildfly.

=Отправка информации о событиях=
Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения или SDK PayControl с сервером PayControl устанавливается в БД PCS, таблица pc_system, поле events_post_url.
<syntaxhighlight lang="sql">
update pc_system set events_post_url='http://example.com/pc_events_reciever';
</syntaxhighlight>
После этого нужно перезапустить WildFly PCS для применения изменений.

{{Предупреждение|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
=Установка лицензии=
Если установка лицензионного файла не проводилась на сервер, то он работает в демонстрационном режиме, ограничивающем возможность заведения более 20 пользователей PayControl.
Также при включённом выводе информационных данных работы PayControl, в журнал выводятся сообщения сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Для установки лицензии необходимо выполнить SQL-запрос к БД PCS, поместив в него содержимое файла лицензии указав идентификатор системы
* до версии 3.5 включительно:
*: <syntaxhighlight lang="sql">update pc_system set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:
*: <syntaxhighlight lang="sql">update pc_system_params set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==

===Linux===
Файл лицензии необходимо скопировать в /opt/wildfly/ на сервер PCS.
===Windows===
Файл лицензии необходимо скопировать на сервер PCS в одну из папок:

*C:\wildfly\
*C:\PayControl\

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:20:53Z

D.bizyukov: /* Журналирование */

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.
=Назначение=
Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
=Общее описание=
Сервер PayControl функционирует на базе сервера приложений [[Wildfly]] выполняющейся в среде Java 8 и состоит из следующих частей:
* PayControl Server (PCS) – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с прикладной системой. Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
* PayControl Interaction Server Internal (PCIS Internal) – сервер для отправки Push уведомлений о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Требуется доступ к серверам Google и Apple. Может быть размещён в т.ч. на одном сервере с PCS или PCIS Extrnal (в зависимости от требований ИБ к ИТ инфраструктуре Банка и функциональных возможностей ИТ инфраструктуры Банка).
* PayControl Interaction Server External (PCIS External). С этим сервером взаимодействуют приложения на мобильных устройствах для получения информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.
=Запуск и остановка служб сервера PayControl=
==Linux==
Запуск:
<syntaxhighlight lang="bash">
systemctl start wildfly.service
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bash">
systemctl stop wildfly.service
</syntaxhighlight>
Перезапуск:
<syntaxhighlight lang="bash">
systemctl restart wildfly.service
</syntaxhighlight>
==Windows==
===Из графического интерфейса===
Запуск, остановка и перезапуск службы осуществляется из консоли управления службами сервером (консоль services.msc).
===С помощью командной строки===
Запуск:
<syntaxhighlight lang="bat">
net start wildfly
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bat">
net stop wildfly
</syntaxhighlight>
=Журналирование=
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.

Примеры SQL запросов добавления записи для разных СУБД:

{| class="wikitable"
! СУБД !! Запрос
|-
| PostgreSQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| Oracle || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
|-
| MS SQL || <syntaxhighlight lang="sql" inline>insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
|}

=====Изменение записи=====
Пример SQL запроса для изменения записи (для всех перечисленных СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>

====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Включение опции вывода содержимого SOAP-запросов не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux:
#*: /opt/wildfly/standalone/configuration/standalone.xml
#* Windows:
#*: C:\wildfly\standalone\configuration\standalone.xml
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии PCIS External 3.6 компонент может журналировать запросы, приходящие на /jsonrequest_v2.

Для включения журналирования необходимо в опции Java-машины добавить параметр ''paycontrol.logRequests=yes'' следующим образом:
* для Linux:
*: в файл /opt/wildfly/bin/standalone.conf добавить <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* для Windows:
*: в файл C:\wildfly\bin\standalone.conf.bat добавить <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>
затем перезапустить службу wildfly.

=Отправка информации о событиях=
Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения или SDK PayControl с сервером PayControl устанавливается в БД PCS, таблица pc_system, поле events_post_url.
<syntaxhighlight lang="sql">
update pc_system set events_post_url='http://example.com/pc_events_reciever';
</syntaxhighlight>
После этого нужно перезапустить WildFly PCS для применения изменений.

{{Предупреждение|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
=Установка лицензии=
Если установка лицензионного файла не проводилась на сервер, то он работает в демонстрационном режиме, ограничивающем возможность заведения более 20 пользователей PayControl.
Также при включённом выводе информационных данных работы PayControl, в журнал выводятся сообщения сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Для установки лицензии необходимо выполнить SQL-запрос к БД PCS, поместив в него содержимое файла лицензии указав идентификатор системы
* до версии 3.5 включительно:
*: <syntaxhighlight lang="sql">update pc_system set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:
*: <syntaxhighlight lang="sql">update pc_system_params set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==

===Linux===
Файл лицензии необходимо скопировать в /opt/wildfly/ на сервер PCS.
===Windows===
Файл лицензии необходимо скопировать на сервер PCS в одну из папок:

*C:\wildfly\
*C:\PayControl\

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:11:32Z

D.bizyukov: /* Доступ к данным журнала */

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.
=Назначение=
Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
=Общее описание=
Сервер PayControl функционирует на базе сервера приложений [[Wildfly]] выполняющейся в среде Java 8 и состоит из следующих частей:
* PayControl Server (PCS) – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с прикладной системой. Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
* PayControl Interaction Server Internal (PCIS Internal) – сервер для отправки Push уведомлений о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Требуется доступ к серверам Google и Apple. Может быть размещён в т.ч. на одном сервере с PCS или PCIS Extrnal (в зависимости от требований ИБ к ИТ инфраструктуре Банка и функциональных возможностей ИТ инфраструктуры Банка).
* PayControl Interaction Server External (PCIS External). С этим сервером взаимодействуют приложения на мобильных устройствах для получения информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.
=Запуск и остановка служб сервера PayControl=
==Linux==
Запуск:
<syntaxhighlight lang="bash">
systemctl start wildfly.service
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bash">
systemctl stop wildfly.service
</syntaxhighlight>
Перезапуск:
<syntaxhighlight lang="bash">
systemctl restart wildfly.service
</syntaxhighlight>
==Windows==
===Из графического интерфейса===
Запуск, остановка и перезапуск службы осуществляется из консоли управления службами сервером (консоль services.msc).
===С помощью командной строки===
Запуск:
<syntaxhighlight lang="bat">
net start wildfly
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bat">
net stop wildfly
</syntaxhighlight>
=Журналирование=
== Расположение журналов ==
События работы сервера PayControl записываются в общий журнал [[Wildfly]]. По умолчанию фиксируются только ошибки PayControl.

{| class="wikitable"
! ОС !! Путь к журналу за текущий день
|-
| Linux || <code>/opt/wildfly/standalone/log/server.log</code>
|-
| Windows || <code>C:\wildfly\standalone\log\server.log</code>
|}

Журналы за прошлые дни имеют суффикс с датой: <code>server.log.YYYY-MM-DD</code>.

==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.
=====Добавление записи=====
Примеры SQL запросов добавления записи для разных СУБД:
* PostgreSQL <syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
* Oracle <syntaxhighlight lang="sql">insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
* MS SQL <syntaxhighlight lang="sql">insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
=====Изменение записи=====
Пример SQL запроса для изменения записи (подходит для всех перечисленных в предыдущем подразделе СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>
====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Включение опции вывода содержимого SOAP-запросов не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux:
#*: /opt/wildfly/standalone/configuration/standalone.xml
#* Windows:
#*: C:\wildfly\standalone\configuration\standalone.xml
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии PCIS External 3.6 компонент может журналировать запросы, приходящие на /jsonrequest_v2.

Для включения журналирования необходимо в опции Java-машины добавить параметр ''paycontrol.logRequests=yes'' следующим образом:
* для Linux:
*: в файл /opt/wildfly/bin/standalone.conf добавить <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* для Windows:
*: в файл C:\wildfly\bin\standalone.conf.bat добавить <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>
затем перезапустить службу wildfly.
=Отправка информации о событиях=
Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения или SDK PayControl с сервером PayControl устанавливается в БД PCS, таблица pc_system, поле events_post_url.
<syntaxhighlight lang="sql">
update pc_system set events_post_url='http://example.com/pc_events_reciever';
</syntaxhighlight>
После этого нужно перезапустить WildFly PCS для применения изменений.

{{Предупреждение|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
=Установка лицензии=
Если установка лицензионного файла не проводилась на сервер, то он работает в демонстрационном режиме, ограничивающем возможность заведения более 20 пользователей PayControl.
Также при включённом выводе информационных данных работы PayControl, в журнал выводятся сообщения сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Для установки лицензии необходимо выполнить SQL-запрос к БД PCS, поместив в него содержимое файла лицензии указав идентификатор системы
* до версии 3.5 включительно:
*: <syntaxhighlight lang="sql">update pc_system set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:
*: <syntaxhighlight lang="sql">update pc_system_params set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==

===Linux===
Файл лицензии необходимо скопировать в /opt/wildfly/ на сервер PCS.
===Windows===
Файл лицензии необходимо скопировать на сервер PCS в одну из папок:

*C:\wildfly\
*C:\PayControl\

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:07:54Z

D.bizyukov:

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.
=Назначение=
Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
=Общее описание=
Сервер PayControl функционирует на базе сервера приложений [[Wildfly]] выполняющейся в среде Java 8 и состоит из следующих частей:
* PayControl Server (PCS) – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с прикладной системой. Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
* PayControl Interaction Server Internal (PCIS Internal) – сервер для отправки Push уведомлений о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Требуется доступ к серверам Google и Apple. Может быть размещён в т.ч. на одном сервере с PCS или PCIS Extrnal (в зависимости от требований ИБ к ИТ инфраструктуре Банка и функциональных возможностей ИТ инфраструктуры Банка).
* PayControl Interaction Server External (PCIS External). С этим сервером взаимодействуют приложения на мобильных устройствах для получения информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.
=Запуск и остановка служб сервера PayControl=
==Linux==
Запуск:
<syntaxhighlight lang="bash">
systemctl start wildfly.service
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bash">
systemctl stop wildfly.service
</syntaxhighlight>
Перезапуск:
<syntaxhighlight lang="bash">
systemctl restart wildfly.service
</syntaxhighlight>
==Windows==
===Из графического интерфейса===
Запуск, остановка и перезапуск службы осуществляется из консоли управления службами сервером (консоль services.msc).
===С помощью командной строки===
Запуск:
<syntaxhighlight lang="bat">
net start wildfly
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bat">
net stop wildfly
</syntaxhighlight>
=Журналирование=
==Доступ к данным журнала==
Журнал работы сервера PayControl записывается общий журнал функционирования [[Wildfly]]. В общем случае записываются только ошибки PayControl, при их возникновении.

Файлы журналов за текущий день доступны по следующему пути:
* Linux:
*: /opt/wildfly/standalone/log/server.log
* Windows:
*: C:\wildfly\standalone\log\server.log
Для просмотра журнала за другие дни, нужно добавить к имени файла требуемую дату в формате server.log.YYYY-MM-DD
==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.
=====Добавление записи=====
Примеры SQL запросов добавления записи для разных СУБД:
* PostgreSQL <syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
* Oracle <syntaxhighlight lang="sql">insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
* MS SQL <syntaxhighlight lang="sql">insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
=====Изменение записи=====
Пример SQL запроса для изменения записи (подходит для всех перечисленных в предыдущем подразделе СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>
====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Включение опции вывода содержимого SOAP-запросов не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux:
#*: /opt/wildfly/standalone/configuration/standalone.xml
#* Windows:
#*: C:\wildfly\standalone\configuration\standalone.xml
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии PCIS External 3.6 компонент может журналировать запросы, приходящие на /jsonrequest_v2.

Для включения журналирования необходимо в опции Java-машины добавить параметр ''paycontrol.logRequests=yes'' следующим образом:
* для Linux:
*: в файл /opt/wildfly/bin/standalone.conf добавить <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* для Windows:
*: в файл C:\wildfly\bin\standalone.conf.bat добавить <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>
затем перезапустить службу wildfly.
=Отправка информации о событиях=
Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения или SDK PayControl с сервером PayControl устанавливается в БД PCS, таблица pc_system, поле events_post_url.
<syntaxhighlight lang="sql">
update pc_system set events_post_url='http://example.com/pc_events_reciever';
</syntaxhighlight>
После этого нужно перезапустить WildFly PCS для применения изменений.

{{Предупреждение|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
=Установка лицензии=
Если установка лицензионного файла не проводилась на сервер, то он работает в демонстрационном режиме, ограничивающем возможность заведения более 20 пользователей PayControl.
Также при включённом выводе информационных данных работы PayControl, в журнал выводятся сообщения сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Для установки лицензии необходимо выполнить SQL-запрос к БД PCS, поместив в него содержимое файла лицензии указав идентификатор системы
* до версии 3.5 включительно:
*: <syntaxhighlight lang="sql">update pc_system set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:
*: <syntaxhighlight lang="sql">update pc_system_params set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==

===Linux===
Файл лицензии необходимо скопировать в /opt/wildfly/ на сервер PCS.
===Windows===
Файл лицензии необходимо скопировать на сервер PCS в одну из папок:

*C:\wildfly\
*C:\PayControl\

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

= Регламентное обслуживание =
Администратору PayControl необходимо в плановом режиме:
* контролировать достаточность свободного места на серверах PayControl;
* контролировать достаточность дискового пространства, выделенного базам данных (БД PCS и БД PCIS);
* своевременно заменять сертификат HTTPS сервера PCIS External;
* своевременно заменять сертификаты HTTPS серверов PCS и PCIS Internal (при их наличии).
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-07T18:06:06Z

D.bizyukov: /* Процесс обновления в рамках одной версии */

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.
=Назначение=
Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
=Общее описание=
Сервер PayControl функционирует на базе сервера приложений [[Wildfly]] выполняющейся в среде Java 8 и состоит из следующих частей:
* PayControl Server (PCS) – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с прикладной системой. Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
* PayControl Interaction Server Internal (PCIS Internal) – сервер для отправки Push уведомлений о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Требуется доступ к серверам Google и Apple. Может быть размещён в т.ч. на одном сервере с PCS или PCIS Extrnal (в зависимости от требований ИБ к ИТ инфраструктуре Банка и функциональных возможностей ИТ инфраструктуры Банка).
* PayControl Interaction Server External (PCIS External). С этим сервером взаимодействуют приложения на мобильных устройствах для получения информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.
=Запуск и остановка служб сервера PayControl=
==Linux==
Запуск:
<syntaxhighlight lang="bash">
systemctl start wildfly.service
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bash">
systemctl stop wildfly.service
</syntaxhighlight>
Перезапуск:
<syntaxhighlight lang="bash">
systemctl restart wildfly.service
</syntaxhighlight>
==Windows==
===Из графического интерфейса===
Запуск, остановка и перезапуск службы осуществляется из консоли управления службами сервером (консоль services.msc).
===С помощью командной строки===
Запуск:
<syntaxhighlight lang="bat">
net start wildfly
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bat">
net stop wildfly
</syntaxhighlight>
=Журналирование=
==Доступ к данным журнала==
Журнал работы сервера PayControl записывается общий журнал функционирования [[Wildfly]]. В общем случае записываются только ошибки PayControl, при их возникновении.

Файлы журналов за текущий день доступны по следующему пути:
* Linux:
*: /opt/wildfly/standalone/log/server.log
* Windows:
*: C:\wildfly\standalone\log\server.log
Для просмотра журнала за другие дни, нужно добавить к имени файла требуемую дату в формате server.log.YYYY-MM-DD
==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.
=====Добавление записи=====
Примеры SQL запросов добавления записи для разных СУБД:
* PostgreSQL <syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
* Oracle <syntaxhighlight lang="sql">insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
* MS SQL <syntaxhighlight lang="sql">insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
=====Изменение записи=====
Пример SQL запроса для изменения записи (подходит для всех перечисленных в предыдущем подразделе СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>
====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Включение опции вывода содержимого SOAP-запросов не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux:
#*: /opt/wildfly/standalone/configuration/standalone.xml
#* Windows:
#*: C:\wildfly\standalone\configuration\standalone.xml
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии PCIS External 3.6 компонент может журналировать запросы, приходящие на /jsonrequest_v2.

Для включения журналирования необходимо в опции Java-машины добавить параметр ''paycontrol.logRequests=yes'' следующим образом:
* для Linux:
*: в файл /opt/wildfly/bin/standalone.conf добавить <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* для Windows:
*: в файл C:\wildfly\bin\standalone.conf.bat добавить <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>
затем перезапустить службу wildfly.
=Отправка информации о событиях=
Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения или SDK PayControl с сервером PayControl устанавливается в БД PCS, таблица pc_system, поле events_post_url.
<syntaxhighlight lang="sql">
update pc_system set events_post_url='http://example.com/pc_events_reciever';
</syntaxhighlight>
После этого нужно перезапустить WildFly PCS для применения изменений.

{{Предупреждение|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
=Установка лицензии=
Если установка лицензионного файла не проводилась на сервер, то он работает в демонстрационном режиме, ограничивающем возможность заведения более 20 пользователей PayControl.
Также при включённом выводе информационных данных работы PayControl, в журнал выводятся сообщения сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Для установки лицензии необходимо выполнить SQL-запрос к БД PCS, поместив в него содержимое файла лицензии указав идентификатор системы
* до версии 3.5 включительно:
*: <syntaxhighlight lang="sql">update pc_system set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:
*: <syntaxhighlight lang="sql">update pc_system_params set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==

===Linux===
Файл лицензии необходимо скопировать в /opt/wildfly/ на сервер PCS.
===Windows===
Файл лицензии необходимо скопировать на сервер PCS в одну из папок:

*C:\wildfly\
*C:\PayControl\

= Процесс обновления в рамках одной версии =
Обновление выполняется заменой файлов модулей в директории ''deployments'' сервера приложений [[Wildfly]]:

{| class="wikitable"
! Модуль !! Пример имени файла
|-
| PC Server || <code>PayControl-services-module-3.9.452.ear</code>
|-
| PC Pusher || <code>pc-pusher-5.5.348.war</code>
|-
| PC External || <code>PayControl-interaction-rest-3.9.452.war</code>
|}

Порядок действий:
# Сохраните файлы модулей текущей версии — они понадобятся для отката.
# Замените файлы модулей в директории ''deployments'' на новые.
# Дождитесь развёртывания. В директории появятся файлы-маркеры:
#* <code>*.undeployed</code> — для убранных модулей; такие файлы рекомендуется удалить;
#* <code>*.deployed</code> — для успешно развёрнутых новых модулей.
# Если появились файлы <code>*.failed</code> — [[#Запуск и остановка служб|перезапустите Wildfly]].

=Контроль=
Администратору PayControl необходимо в плановом режиме выполнять проверку:
* Достаточности свободного места на серверах PayControl;
* Достаточности свободного места, выделенного дискового пространства базам данных PayControl (БД PCS и БД PCIS).
=Плановые работы=
Плановыми работами по обслуживанию является:
* Замена сертификата для обеспечения HTTPS защиты сервера PCIS External;
* Замена сертификатов для обеспечения HTTPS защиты на серверах PCS и PCIS Internal при их наличии.
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Руководство администратора PayControl v3

2026-07-03T10:39:03Z

D.bizyukov: /* Установка лицензии */

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

PayControl призван, в первую очередь, повысить уровень удобства подтверждения и информационной безопасности по сравнению с такими способами подтверждения как SMS, одноразовые пароли (One-Time Password), скретч-карты, MAC-токены и пр.

При помощи PayControl могут подтверждаться волеизъявления на совершение банковских транзакций, аутентификация, создание и исполнение документов, факты получения и/или ознакомления с определённой информацией.
=Назначение=
Настоящий документ предназначен работникам организаций, выполняющим прикладные задачи по обслуживанию серверов PayControl.
=Общее описание=
Сервер PayControl функционирует на базе сервера приложений [[Wildfly]] выполняющейся в среде Java 8 и состоит из следующих частей:
* PayControl Server (PCS) – основной сервер PayControl. Располагается внутри локальной сети. Взаимодействует с прикладной системой. Хранит данные в БД PCS. Отправляет данные на PCIS Internal, получает данные с PCIS External.
* PayControl Interaction Server Internal (PCIS Internal) – сервер для отправки Push уведомлений о появлении неподтверждённой транзакции у пользователя (без содержания информации о транзакции). Как правило располагается в DMZ-зоне, имеющей доступ к сети Интернет. Требуется доступ к серверам Google и Apple. Может быть размещён в т.ч. на одном сервере с PCS или PCIS Extrnal (в зависимости от требований ИБ к ИТ инфраструктуре Банка и функциональных возможностей ИТ инфраструктуры Банка).
* PayControl Interaction Server External (PCIS External). С этим сервером взаимодействуют приложения на мобильных устройствах для получения информации о данных платежа и отправки результатов подтверждения транзакций. Располагается в DMZ-зоне с доступом извне. Должен иметь внешний фиксированный IP-адрес. При необходимости использования TLS, должно быть присвоено доменное имя и выпущен сертификат внешним УЦ.
=Запуск и остановка служб сервера PayControl=
==Linux==
Запуск:
<syntaxhighlight lang="bash">
systemctl start wildfly.service
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bash">
systemctl stop wildfly.service
</syntaxhighlight>
Перезапуск:
<syntaxhighlight lang="bash">
systemctl restart wildfly.service
</syntaxhighlight>
==Windows==
===Из графического интерфейса===
Запуск, остановка и перезапуск службы осуществляется из консоли управления службами сервером (консоль services.msc).
===С помощью командной строки===
Запуск:
<syntaxhighlight lang="bat">
net start wildfly
</syntaxhighlight>
Остановка:
<syntaxhighlight lang="bat">
net stop wildfly
</syntaxhighlight>
=Журналирование=
==Доступ к данным журнала==
Журнал работы сервера PayControl записывается общий журнал функционирования [[Wildfly]]. В общем случае записываются только ошибки PayControl, при их возникновении.

Файлы журналов за текущий день доступны по следующему пути:
* Linux:
*: /opt/wildfly/standalone/log/server.log
* Windows:
*: C:\wildfly\standalone\log\server.log
Для просмотра журнала за другие дни, нужно добавить к имени файла требуемую дату в формате server.log.YYYY-MM-DD
==Включение вывода информационных данных работы PayControl==
В некоторых случаях может потребоваться вывод отладочной информации PayControl. Порядок её включения описан ниже для разных компонентов сервера PayСоntrol.
===Для PCS и PCIS Internal===
====Вывод отладочной информации====
Для включения вывода отладочной информации необходимо:
# В БД PCS или БД PCIS соответственно для нужного сервера, добавить/изменить запись в таблице pc_sys_property, установив следующие значения:
#* setting_name='DEBUG_INFO'
#* setting_value = '1'
# Перезапустить службу wildfly.
=====Добавление записи=====
Примеры SQL запросов добавления записи для разных СУБД:
* PostgreSQL <syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'DEBUG_INFO', '1');</syntaxhighlight>
* Oracle <syntaxhighlight lang="sql">insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'DEBUG_INFO', '1');</syntaxhighlight>
* MS SQL <syntaxhighlight lang="sql">insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'DEBUG_INFO', '1');</syntaxhighlight>
=====Изменение записи=====
Пример SQL запроса для изменения записи (подходит для всех перечисленных в предыдущем подразделе СУБД):
<syntaxhighlight lang="sql">update pc_sys_property set setting_value = '1' where setting_name='DEBUG_INFO';</syntaxhighlight>
====Вывод содержимого SOAP-запросов и ответов====
{{Предупреждение|Включение опции вывода содержимого SOAP-запросов не работает в [[Wildfly]] версии 13.0.0-Final.}}
Для включения вывода содержимого SOAP-запросов и ответов службой wildfly необходимо:
# Добавить после блока <extensions> ... </extensions> в файл
#* Linux:
#*: /opt/wildfly/standalone/configuration/standalone.xml
#* Windows:
#*: C:\wildfly\standalone\configuration\standalone.xml
#: следующий блок:<syntaxhighlight lang="xml">
<system-properties>
<property name="org.apache.cxf.logging.enabled" value="pretty"/>
</system-properties>
</syntaxhighlight>
# Перезапустить службу wildfly.

===PCIS External (с версии 3.6)===
Начиная с версии PCIS External 3.6 компонент может журналировать запросы, приходящие на /jsonrequest_v2.

Для включения журналирования необходимо в опции Java-машины добавить параметр ''paycontrol.logRequests=yes'' следующим образом:
* для Linux:
*: в файл /opt/wildfly/bin/standalone.conf добавить <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.logRequests=yes"</syntaxhighlight>
* для Windows:
*: в файл C:\wildfly\bin\standalone.conf.bat добавить <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.logRequests=yes"</syntaxhighlight>
затем перезапустить службу wildfly.
=Отправка информации о событиях=
Адрес для отправки информации об устройстве и событиях взаимодействия мобильного приложения или SDK PayControl с сервером PayControl устанавливается в БД PCS, таблица pc_system, поле events_post_url.
<syntaxhighlight lang="sql">
update pc_system set events_post_url='http://example.com/pc_events_reciever';
</syntaxhighlight>
После этого нужно перезапустить WildFly PCS для применения изменений.

{{Предупреждение|Обязательным требованием для сбора информации о событиях является установка флага сбора информации о событиях при создании ключа, а для передачи данных об устройстве — ещё и флага сбора информации об устройстве. Подробнее — в описании API сервера.}}
=Установка лицензии=
Если установка лицензионного файла не проводилась на сервер, то он работает в демонстрационном режиме, ограничивающем возможность заведения более 20 пользователей PayControl.
Также при включённом выводе информационных данных работы PayControl, в журнал выводятся сообщения сообщения вида:
<pre>
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.utils.licenseManager.LicenseManager] (default task-2) --- no license found in database
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- Error load License, cheking if free users count exceeded
2018-12-07 11:51:07,295 INFO [ru.safetech.ws.PayControl.services.impl.PayControlServiceV3Impl] (default task-2) --- ATTENTION! LICENSE NOT FOUND! You are using unlicensed demo-only version of the service
</pre>

==Запросом к БД==
Для установки лицензии необходимо выполнить SQL-запрос к БД PCS, поместив в него содержимое файла лицензии указав идентификатор системы
* до версии 3.5 включительно:
*: <syntaxhighlight lang="sql">update pc_system set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>
* с версии 3.6:
*: <syntaxhighlight lang="sql">update pc_system_params set license='СОДЕРЖИМОЕ ФАЙЛА ЛИЦЕНЗИИ' where systemid='ИДЕНТИФИКАТОР СИСТЕМЫ';</syntaxhighlight>

==Добавлением файла лицензии==

===Linux===
Файл лицензии необходимо скопировать в /opt/wildfly/ на сервер PCS.
===Windows===
Файл лицензии необходимо скопировать на сервер PCS в одну из папок:

*C:\wildfly\
*C:\PayControl\

= Процесс обновления в рамках одной версии =
Для обновления необходимо заменить на серверах файлы модулей PC Server, PC Pusher и PC External в директории ''deployments'' сервера приложений [[Wildfly]]. Они имеют названия вида:
* PayControl-services-module-3.9.452.ear - PC Server;
* pc-pusher-5.5.348.war - PC Pusher;
* PayControl-interaction-rest-3.9.452.war - PC External.
Файлы сервера предыдущей версии настоятельно рекомендуем сохранить для возможности отката на предыдущую версию.

После замены файлов и развёртывания новых, в директории ''deployments'' будут созданы файлы с названиями:
* *.undeployed, где вместо * будет указано название убранного из директории файла модуля сервера. Файлы с расширением undeployed рекомендуется удалить.
* и с расширением *.deployed, где вместо * будут указаны названия новых модулей.
При появлении файлов с расширением *.failed, необходимо [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|перезапустить Wildfly]].

=Контроль=
Администратору PayControl необходимо в плановом режиме выполнять проверку:
* Достаточности свободного места на серверах PayControl;
* Достаточности свободного места, выделенного дискового пространства базам данных PayControl (БД PCS и БД PCIS).
=Плановые работы=
Плановыми работами по обслуживанию является:
* Замена сертификата для обеспечения HTTPS защиты сервера PCIS External;
* Замена сертификатов для обеспечения HTTPS защиты на серверах PCS и PCIS Internal при их наличии.
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Ручная проверка работоспособности PayControl v6

2026-06-24T10:26:15Z

D.bizyukov: Новая страница: «=Создание пользователя и транзакции= В примерах ниже замените плейсхолдеры на свои значения: * '''pcs.example:8080''' — адрес и порт вашего сервера PayControl; * '''systemid''' — идентификатор вашей системы; * '''userid''' — идентификатор созданного пользователя. Значения в прим...»

=Создание пользователя и транзакции=

В примерах ниже замените плейсхолдеры на свои значения:
* '''pcs.example:8080''' — адрес и порт вашего сервера PayControl;
* '''systemid''' — идентификатор вашей системы;
* '''userid''' — идентификатор созданного пользователя.

Значения в примерах ответов приведены для наглядности и могут отличаться в зависимости от версии сервера.

1) Установите мобильное приложение PayControl из Google Play, RuStore, Huawei AppGallery или Apple App Store.

2) Для запроса на создание пользователя с выводом ключевой информации в QR ознакомьтесь с его описанием: https://repo.paycontrol.org/server/doc/latest/rest-api/en/#create-user

Пример запроса (нужно вписать ваш '''systemid'''):
<syntaxhighlight lang="json">
curl --location --request POST 'http://pcs.example:8080/pc-api/systemid/users' \
--header 'Content-Type: application/json' \
--data-raw '{
"id_prefix":"rest-api-test-",
"key_params":{
"with_finger_print": false,
"collect_events": true,
"collect_device_info": true,
"collect_device_SIM_info": false,
"collect_device_location": false,
"pass_policy": 0,
"deny_store_with_OS_protection": false,
"deny_renew_public_key": false,
"scoring_enabled": true,
"autosign_enabled": false
},
"return_key_method":"FULL_QR"
}'
</syntaxhighlight>

Пример ответа:
<syntaxhighlight lang="json">
{
"answer_type": "user_created",
"answer": {
"result": {
"error_message": "Success",
"error_code": 0
},
"user_created": {
"expiration_date": "2022-03-19",
"system_settings": {
"confirm_code_time_sampling_interval": 180,
"auth_code_time_sampling_interval": 180
},
"user_id": "rest-api-test-d3ee8aa6-5467-4dc3-b856-ed39577c9363",
"system_id": "6d5f8706-89d7-4378-8a96-707d5939c0f1",
"expiration_timestamp": 1647698161,
"system_name": "Example",
"key_flags": 6,
"ext_auth_available_methods": [
"codeword"
],
"key_QR": "R0lGODlhLAEsAfAAAAAAAP///ywAAAAALAEsAUAC/4yPq...uqhLuqjTuqlbuqnjuqpruqrzuqt7uqvHoYFAAA7"
}
},
"answer_version": 3
}
</syntaxhighlight>

=Работа с QR-кодом=
1) Отобразить возвращённый QR можно, например, с помощью этой утилиты https://base64.guru/converter/decode/image/gif, скопировав из ответа на создание пользователя данные поля key_QR
<syntaxhighlight lang="json">
"key_QR": "данные_QR_кода"
</syntaxhighlight>

2) Убедитесь, что в полученном QR-коде прописан правильный адрес для подключения к PC External, отсканировав его в любом QR-ридере.

3) Добавьте ключ в мобильное приложение PC, отсканировав QR-код.

=Создание транзакции и пуша=
1) Для запроса на создание транзакции ознакомьтесь с его описанием: https://repo.paycontrol.org/server/doc/latest/rest-api/en/#create-transaction

Пример запроса (нужно вписать ваш '''systemid и userid''' созданного пользователя):
<syntaxhighlight lang="json">
curl --location --request POST 'http://pcs.example:8080/pc-api/systemid/users/userid/transactions' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
"transaction_data":{
"text":"Перевод средств на счёт №213154254 на сумму 12000 рублей"
},
"notification_type": "Push",
"callback_url": "https://paycontrol.org/receive_request/",
"confirm_code_length": 8,
"ttl": 0
}'
</syntaxhighlight>
Пример ответа:
<syntaxhighlight lang="json">
{
"answer_type": "transaction_created",
"answer": {
"result": {
"error_message": "Success",
"error_code": 0
},
"transaction_created": {
"transaction_id": "b82f3436-c618-4c57-9760-4dec3a1ba807",
"system_id": "6d5f8706-89d7-4378-8a96-707d5939c0f1",
"autosign_enabled": false,
"pc_transaction_version": 3,
"confirm_code_length": 8,
"ttl": 0,
"callback_url": "https://paycontrol.org/receive_request/",
"user_id": "rest-api-test-d3ee8aa6-5467-4dc3-b856-ed39577c9363",
"extended_check": false,
"data_type": "TEXT",
"text_render_type": "raw",
"confirm_type": "PUSH",
"transaction_qr": "R0lGODlhLAEsAfAAAAAAAP///ywAAAAALAEsAUAC/4yPqcvt...jTuqlbuqnjuqpruqrzuqt7uqvDutpWAAAOw==",
"status": "initialized"
}
},
"answer_version": 3
}
</syntaxhighlight>

2) Чтобы на устройство был отправлен пуш, при создании транзакции нужно указать следующий параметр в теле запроса
<syntaxhighlight lang="json">
"notification_type": "Push"
</syntaxhighlight>

Для PC Pusher должны быть доступны адреса, пописанные по ссылке - https://repo.paycontrol.org/server/doc/latest/infrastructure/ru/#адреса-для-отправки-push-уведомлений

3) После создания транзакции, подтвердите её в мобильном приложении.

PayControl PKI

2026-04-06T11:48:34Z

D.bizyukov: /* Указание пути к файлу конфигурации PKI коннектора */

PC базово в своём составе имеет коннекторы к двум УЦ:

* КриптоПро УЦ
* УЦ на базе OpenSSL

= КриптоПро УЦ =

С версии 6.9.0, PC может быть подключён к КриптоПро УЦ 2.0 (исполнение 15 и 16) для выпуска сертификатов пользователям PC.

Коннектор к УЦ КриптоПро является модулем компонента PCS. Взаимодействие с УЦ КриптоПро ведётся через его компонент — центр регистрации.

Для работы с УЦ КриптоПро необходимо включить коннектор, настроить его, добавить ключ для аутентификации запросов в центр регистрации (или два раздельных ключа, один для mTLS, второй для подписания запросов к ЦР), добавить корневой сертификат УЦ для проверки аутентичности сервера при подключении.

== Конфигурирование PKI коннектора ==

=== Указание пути к файлу конфигурации PKI коннектора ===

Путь к файлу конфигурации устанавливается в настройках сервера PCS в параметре <code>PKI_SETTINGS_PATH</code>. Значением по умолчанию является <code>/opt/pc/pki/pki-settings.properties</code>. Способ установки описан в [https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/#установка-параметров|справочном руководстве].

При изменении <code>pki-settings.properties</code> требуется перезапуск PC Server.

=== Состав файла конфигурации ===

<syntaxhighlight lang="shell"># Connector type selection (MUST not be changed to use this connector)
# Указание типа коннектора (не подлежит изменению при использовании этого коннектора)
caType=CPCA20

# Alias of the Operator's private key and certificate stored in HDImage
# Алиас закрытого ключа и сертификата оператора в HDImage хранилище (используется для установки mTLS и подписи запросов к УЦ)
cpca20OperatorKeyAlias=Operator-1

# Password to the Operator's private key container
# Пароль закрытого ключа оператора
cpca20OperatorKeyPassword=

# Trusted certificates in PEM for establishing TLS connection with CA
# Путь к файлу с доверенными сертификатами
cpca20TrustedCertificatesPath=/opt/pc/cp_ca/etc/904C46A177CC4BAA6B683AD47E4BF625FADD166B.pem

# URL for the CA 2.0 instance
# Адрес центра регистрации УЦ КриптоПро для взаимодействия
cpca20InteractionUrl=https://cpca.loc

# URL for the CA 2.0 distribution point
# Адрес распространения списков отзывов сертификатов
cpca20CrlDp=http://cpca.loc/cdp/904C46A177CC4BAA6B683AD47E4BF625FADD166B.crl

# OID for the custom component in subject's DN (UnstructuredName)
# OID для поля UnstructuredName
cacp20UserNameOID=1.2.840.113549.1.9.2

# OID for the certificate template to be included in the extensions of certificate requests
# OID шаблона сертификата для включения в расширение в запросе сертификата
cacp20CertTemplateOID=1.2.643.2.999.1.1.1

# Folder to be used when creating users at RA
# Папка, в которой создаются сертификаты пользователей в ЦР УЦ КриптоПро
cacp20RegistrationFolder=Ra

# Whether to use specified CRL DP for certificate checking (useful when CRL DP is not included into certificate extensions)
# Флаг разрешающий использование установленного в cpca20CrlDp адреса для получения списка отзыва сертификатов (для случаев, если в сертификате не указана точка распространения списка отзывов)
cacp20UseCrlDpForCertificateValidation=true

# Timeout in milliseconds for establishing connection with CA
# Время ожидания установки TCP соединения с УЦ в мс
cacp20ConnectionTimeout=2000

# Timeout in milliseconds for requesting connection from the connection manager
# Время ожидания готовности сервера принять запрос в мс
cacp20ConnectionRequestTimeout=2000

# Timeout in milliseconds for getting response from CA
# Время ожидания ответа от УЦ в мс
cacp20ResponseTimeout=2000</syntaxhighlight>

=== Сертификат УЦ ===

Сертификат УЦ необходимо разместить в доступном для сервиса месте (например в <code>/opt/pc/cp_ca/etc/</code>), и указать путь к этому файлу в параметре <code>cpca20TrustedCertificatesPath</code> конфигурационного файла.

== Размещение ключей ==

Файлы ключа и сертификата оператора в формате КриптоПро CSP HDImage необходимо разместить по по пути <code>/var/opt/cprocsp/keys/ProcessUsername/OperatorKeyAlias</code>, где вместо значений:

* <code>ProcessUsername</code> должено быть указано имя пользователя, под которым запущен процесс PCS;
* <code>OperatorKeyAlias</code> должен быть указан алиас оператора (для приведённого примера файла конфигурации это будет <code>Operator-1</code> и путь будет следующий <code>/var/opt/cprocsp/keys/user/Operator-1</code>).

Владельцем директорий <code>ProcessUsername/OperatorKeyAlias</code> и файлов ключей должен быть пользователь, под которым запущен процесс PCS. Если эти директории принадлежат другому пользователю, необходимо скорректировать принадлежность, например, с помощью <code>chown</code>.

= OpenSSL =

== Конфигурирование PKI коннектора ==

=== Путь к конфигурационному файлу коннектора ===

Настройку необходимо внести в pc_sys_property БД PCS.

PKI_SETTINGS_PATH | /opt/pc/pki/pki-settings.properties

Пример для PostgreSQL:<syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'PKI_SETTINGS_PATH', '/opt/pc/pki/pki-settings.properties');</syntaxhighlight>

=== Пример конфигурационного файла ===

<syntaxhighlight lang="shell">
# check certificate's expiration, cert path and other constrains during each cert use
checkCertificates=true

# check certificate revocation status, to use checkCertificates must be true
checkRevocation=true
useCRL=true
useOCSP=false

# -- OpenSSL Settings
caType=OpenSSL
issueCertificateCmd=/opt/pc/pki/issue_cert.sh
revokeCertificateCmd=/opt/pc/pki/revoke_cert.sh

# files prefixes must contain path where tmp files will be stored
csrTmpFilePrefix=pc-openssl-connector-csr-
certTmpFilePrefix=pc-openssl-connector-cert-

# certificate chain in PEM-format
# the first certificate must be CA (self-signed), second - 1st intermediate, third - 2nd intermediate and so on
# if checkRevocation is true, then each of intermediate certificates must contain OCSP url or CRL Distribution point
caChainFileName=/opt/pc/pki/Intermediate_CA/certs/intermediate.chain.pem
</syntaxhighlight>

== Пример файла выпуска сертификата ==

=== ECDSA ===

<syntaxhighlight lang="shell">
#!/bin/sh
CA_DIR=/opt/pc/pki/Intermediate_CA
KEY_PASS=secretpassword

DER_CSR_FILE_NAME=$1
DER_CSR_BASE_FILE_NAME="$(basename -- $DER_CSR_FILE_NAME)"
DER_CSR_BASE_FILE_NAME="${DER_CSR_BASE_FILE_NAME%.*}"
PEM_CSR_FILE_NAME=csr/$DER_CSR_BASE_FILE_NAME.pem
PEM_CERT_FILE_NAME=certs/$DER_CSR_BASE_FILE_NAME.cert.pem
DER_CERT_FILE_NAME=certs/$DER_CSR_BASE_FILE_NAME.cert.der

DEST_CERT_FILE_NAME=$2

cd $CA_DIR
openssl req -inform DER -in $DER_CSR_FILE_NAME -out $PEM_CSR_FILE_NAME
openssl ca -config openssl.cnf -extensions usr_cert -days 375 -notext -md sha256 -in $PEM_CSR_FILE_NAME -out $PEM_CERT_FILE_NAME -passin pass:$KEY_PASS -batch
openssl x509 -outform der -in $PEM_CERT_FILE_NAME -out $DER_CERT_FILE_NAME

cp $DER_CERT_FILE_NAME $DEST_CERT_FILE_NAME
</syntaxhighlight>

=== ГОСТ ===

<syntaxhighlight lang="shell">
#!/bin/sh
CA_DIR=/opt/pc/pki/Intermediate_CA
KEY_PASS=secretpassword

DER_CSR_FILE_NAME=$1
DER_CSR_BASE_FILE_NAME="$(basename -- $DER_CSR_FILE_NAME)"
DER_CSR_BASE_FILE_NAME="${DER_CSR_BASE_FILE_NAME%.*}"
PEM_CSR_FILE_NAME=csr/$DER_CSR_BASE_FILE_NAME.pem
PEM_CERT_FILE_NAME=certs/$DER_CSR_BASE_FILE_NAME.cert.pem
DER_CERT_FILE_NAME=certs/$DER_CSR_BASE_FILE_NAME.cert.der

DEST_CERT_FILE_NAME=$2

cd $CA_DIR
openssl req -inform DER -in $DER_CSR_FILE_NAME -out $PEM_CSR_FILE_NAME
openssl ca -config openssl.cnf -extensions usr_cert -days 375 -notext -md gost12_256 -in $PEM_CSR_FILE_NAME -out $PEM_CERT_FILE_NAME -passin pass:$KEY_PASS -batch
openssl x509 -outform der -in $PEM_CERT_FILE_NAME -out $DER_CERT_FILE_NAME

cp $DER_CERT_FILE_NAME $DEST_CERT_FILE_NAME
</syntaxhighlight>
== Пример файла отзыва сертификата ==

<syntaxhighlight lang="shell">
#!/bin/sh
CERT_FILE_NAME=$1
KEY_PASS=secretpassword
CA_DIR=/opt/pc/pki/Intermediate_CA
INTERMEDIATE_CRL_LOCATION=crl/intermediate.crl

cd $CA_DIR

#revoke
openssl ca -config openssl.cnf -revoke $CERT_FILE_NAME -passin pass:$KEY_PASS
#publish CRL
openssl ca -config openssl.cnf -gencrl -out $INTERMEDIATE_CRL_LOCATION -passin pass:$KEY_PASS
cp -v $INTERMEDIATE_CRL_LOCATION /opt/pc/pki/pub/crl/
</syntaxhighlight>

== Пример файла скрипта публикации списка отзыва корневого УЦ ==

<syntaxhighlight lang="shell">
#!/bin/bash
openssl ca \
-config /opt/pc/pki/Root_CA/openssl_host.cnf \
-gencrl \
-out /opt/pc/pki/Root_CA/crl/root.crl \
-passin pass:secretpassword
cp /opt/pc/pki/Root_CA/crl/root.crl /opt/pc/pki/pub/crl/
</syntaxhighlight>

== Пример файла скрипта публикации списка отзыва промежуточного УЦ ==

<syntaxhighlight lang="shell">
#!/bin/bash
openssl ca \
-config /opt/pc/pki/Intermediate_CA/openssl_host.cnf \
-gencrl \
-out /opt/pc/pki/Intermediate_CA/crl/intermediate.crl \
-passin pass:secretpassword
cp /opt/pc/pki/Intermediate_CA/crl/intermediate.crl /opt/pc/pki/pub/crl/
</syntaxhighlight>

== Включение ГОСТ в OpenSSL ==

=== Установка модуля ГОСТ ===

Для работы OpenSSL с криптоалгоритмами ГОСТ необходимо установить криптографическую библиотеку и настроить работу с этой библиотекой в конфигурационном файле, для этого:

* Установите пакет <code>openssl-gost-engine</code>, либо, если его нет в репозитории Вашего дистрибутива, скачайте по ссылке https://repo.paycontrol.org/cdn/artefacts/gost-engine/engine/gost.so (sha256sum: <code>435a0dee3273d924458c14ad57ac44b0711aa37fb3df9f2ba987a118f2339b1f gost.so</code>) и разместите скаченный файл криптобиблиотеки в директории модулей OpenSSL (в зависимости от дистрибутива это может быть <code>/usr/lib/engines-3/</code>, или, например <code>/usr/lib64/engines-3/</code>).
* В кофигурационный файл OpenSSL добавьте:<syntaxhighlight lang="shell">openssl_conf = openssl_def

[openssl_def]
engines = engine_section

[engine_section]
gost = gost_section

[gost_section]
engine_id = gost
dynamic_path = /usr/lib/engines-3/gost.so
default_algorithms = ALL </syntaxhighlight>, где в качестве значения <code>dynamic_path</code> должен быть указан путь к библиотеке <code>gost.so</code>.
* В кофигурационном файле OpenSSL параметру <code>default_md</code> необходимо установить значение <code>md_gost12_256</code>.

== Пример команд для создания корневого и промежуточного ГОСТ-УЦ в OpenSSL ==

=== Создание корневого сертификата ===

<syntaxhighlight lang="shell">
openssl genpkey -config openssl_intermediate.cnf -pass pass:$KEY_PASS -algorithm gost2012_256 -pkeyopt paramset:A -out private/root.key.pem
openssl req -config openssl_intermediate.cnf -key private/root.key.pem -passin pass:${PKI_KEY_PASS} -new -x509 -days 7300 -md_gost12_256 -extensions v3_ca -subj "${PKI_ROOT_SUBJECT}" -out certs/root.cert.pem
</syntaxhighlight>

=== Создание ключа и запроса для промежуточного УЦ ===

<syntaxhighlight lang="shell">
openssl genpkey -config openssl_root.cnf -pass pass:$KEY_PASS -algorithm gost2012_256 -pkeyopt paramset:A -out private/intermediate.key.pem
openssl req -config openssl_root.cnf -key private/intermediate.key.pem -passin pass:${PKI_KEY_PASS} -new -md_gost12_256 -subj "${PKI_INTERMEDIATE_SUBJECT}" -out csr/intermediate.csr.pem
</syntaxhighlight>

=== Выпуск сертификата для промежуточного УЦ ===

<syntaxhighlight lang="shell">
openssl ca -config openssl_intermediate.cnf -extensions v3_intermediate_ca -passin pass:${PKI_KEY_PASS} -days 3650 -notext -md gost12_256 -in ../Intermediate_CA/csr/intermediate.csr.pem -out ../Intermediate_CA/certs/intermediate.cert.pem -out certs/intermediate.cert.pem -batch
</syntaxhighlight>

[[Категория:OpenSSL]]
[[Категория:PKI]]
[[Категория:Сертификаты]]
[[Категория:КриптоПро УЦ]]

Обновление PayControl с версии 3 на версию 6

2026-01-28T11:19:35Z

D.bizyukov: /* Правки для корректной отправки пушей */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== Postgre ===

<syntaxhighlight lang="sql">
alter table pc_delayedkeyinfo alter column is_deleted set not null;
alter table pc_delayedkeyinfo alter column is_deleted set default 0;
alter table pc_delayedkeyinfo drop column type;
alter table pc_delayedkeyinfo add column renew_challenge varchar(255);

alter table pc_device alter column is_deleted set not null;
alter table pc_device alter column is_deleted set default 0;
alter table pc_device add column app_id varchar(255);

alter table pc_event alter column is_deleted set not null;
alter table pc_event alter column is_deleted set default 0;
alter table pc_event alter column requester_ip type varchar(64);
alter table pc_event add column event_data text;
alter table pc_event drop column eventposturl;

alter table pc_keyinfo alter column is_deleted set not null;
alter table pc_keyinfo alter column is_deleted set default 0;
alter table pc_keyinfo drop column type;
alter table pc_keyinfo drop column key_container_id;
alter table pc_keyinfo add column external_approve_data_id varchar(255);

alter table pc_publickey alter column is_deleted set not null;
alter table pc_publickey alter column is_deleted set default 0;
alter table pc_publickey add column autosign_public_key bytea;

alter table pc_system alter column is_deleted set not null;
alter table pc_system alter column is_deleted set default 0;
alter table pc_system add column callback_url varchar(255);

alter table pc_system_params alter column is_deleted set not null;
alter table pc_system_params alter column is_deleted set default 0;
alter table pc_system_params alter column license type varchar(4096);
alter table pc_system_params add column qr_url_scheme varchar(24);

alter table pc_transaction alter column is_deleted set not null;
alter table pc_transaction alter column is_deleted set default 0;
alter table pc_transaction add column autosign_enabled int2;
alter table pc_transaction add column ext_pulp bytea;
alter table pc_transaction add column extended_check int2;
alter table pc_transaction add column render_type int4;
alter table pc_transaction add column scoring_settings varchar(1023);
alter table pc_transaction add column transaction_type int4;

alter table pc_user alter column is_deleted set not null;
alter table pc_user alter column is_deleted set default 0;
alter table pc_user add column blocked int2;

alter table pc_confirm_attempt add column scoring_results varchar(512);
alter table pc_confirm_attempt add column scoring_settings varchar(512);
</syntaxhighlight>

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_KEYINFO
DROP COLUMN type;

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_DELAYEDKEYINFO
DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

=== Oracle ===

<syntaxhighlight lang="sql">
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_delayedkeyinfo DROP COLUMN type;
ALTER TABLE pc_delayedkeyinfo ADD renew_challenge VARCHAR2(255);

ALTER TABLE pc_device MODIFY is_deleted NOT NULL;
ALTER TABLE pc_device MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_device ADD app_id VARCHAR2(255);

ALTER TABLE pc_event MODIFY is_deleted NOT NULL;
ALTER TABLE pc_event MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_event MODIFY requester_ip VARCHAR2(64);
ALTER TABLE pc_event ADD event_data CLOB;
ALTER TABLE pc_event DROP COLUMN eventposturl;

ALTER TABLE pc_keyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_keyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_keyinfo DROP COLUMN type;
ALTER TABLE pc_keyinfo DROP COLUMN key_container_id;
ALTER TABLE pc_keyinfo ADD external_approve_data_id VARCHAR2(255);

ALTER TABLE pc_publickey MODIFY is_deleted NOT NULL;
ALTER TABLE pc_publickey MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_publickey ADD autosign_public_key BLOB;

ALTER TABLE pc_system MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system ADD callback_url VARCHAR2(255);

ALTER TABLE pc_system_params MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system_params MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system_params MODIFY license VARCHAR2(4000);
ALTER TABLE pc_system_params ADD qr_url_scheme VARCHAR2(24);

ALTER TABLE pc_transaction MODIFY is_deleted NOT NULL;
ALTER TABLE pc_transaction MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_transaction ADD autosign_enabled NUMBER(5);
ALTER TABLE pc_transaction ADD ext_pulp BLOB;
ALTER TABLE pc_transaction ADD extended_check NUMBER(5);
ALTER TABLE pc_transaction ADD render_type NUMBER(10);
ALTER TABLE pc_transaction ADD scoring_settings VARCHAR2(1023);
ALTER TABLE pc_transaction ADD transaction_type NUMBER(10);
ALTER TABLE pc_transaction ADD snipped_text VARCHAR2(1023);

ALTER TABLE pc_user MODIFY is_deleted NOT NULL;
ALTER TABLE pc_user MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_user ADD blocked NUMBER(5);

ALTER TABLE pc_confirm_attempt ADD scoring_results VARCHAR2(512);
ALTER TABLE pc_confirm_attempt ADD scoring_settings VARCHAR2(512);

ALTER TABLE pc_sys_property MODIFY SETTING_VALUE VARCHAR2(1023);

</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения обновленного запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set license='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
update pc_keyinfo set is_activated=1;
update pc_transaction set transaction_type=0;
update pc_transaction set render_type=0;
update pc_transaction set status=6 where status=4;
update pc_transaction set status=7 where status=5;

</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Не требуется начиная с версии 6.9.1''':

Для работы старых ключей, обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-pc-ext-example.com:8081/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';
</syntaxhighlight>

PostgreSQL
<syntaxhighlight lang="sql">
update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;
</syntaxhighlight>

Oracle
<syntaxhighlight lang="sql">
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

</syntaxhighlight>

MS SQL
<syntaxhighlight lang="sql">

CREATE OR ALTER FUNCTION dbo.split_part
(
@str NVARCHAR(MAX),
@delim NVARCHAR(100),
@idx INT
)
RETURNS NVARCHAR(MAX)
AS
BEGIN

IF @str IS NULL RETURN NULL;
IF @idx IS NULL OR @idx <= 0 RETURN NULL;
IF @delim IS NULL OR LEN(@delim) = 0 RETURN NULL;

DECLARE @dlen INT = LEN(@delim);

DECLARE @start INT = 1;
DECLARE @pos INT;
DECLARE @cur INT = 1;

WHILE 1 = 1
BEGIN
SET @pos = CHARINDEX(@delim, @str, @start);

IF @pos = 0
BEGIN
IF @cur = @idx
RETURN SUBSTRING(@str, @start, LEN(@str) - @start + 1);
RETURN NULL;
END

IF @cur = @idx
RETURN SUBSTRING(@str, @start, @pos - @start);

SET @start = @pos + @dlen;
SET @cur += 1;
END

RETURN NULL;
END;
GO

UPDATE pc_device SET app_id = dbo.split_part(device_push_id, '####', 2) WHERE app_id IS NULL;
UPDATE pc_device SET device_push_id = dbo.split_part(device_push_id, '####', 1) WHERE app_id IS NOT NULL;
</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

PC via queues

2025-10-08T12:01:11Z

D.bizyukov: /* Настройка PC External */

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

https://repo.paycontrol.org/server/doc/latest/pc-handbook/ru/#использование-очередей-для-ограничения-соединений-от-pce-к-pcs.

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

Загрузить RabbitMQ можно на сайте: https://www.rabbitmq.com

Для корректной работы с очередями нужно создать админ-пользователя помимо guest и настроить подключение через этого нового пользователя.

Приложение состоит из двух модулей:
* для зоны DMZ - ''pc-queue-dmz-1.0.jar'';
* для внутренней сети ''pc-queue-lan-1.0.jar''.

=Файлы для запуска=
==Linux==
Файлы запуска имеют разрешение ''.service''.

Для корректной работы приложения необходимо их отредактировать под конкретное окружение.

''WorkingDirectory=/opt/clientSide'' - директория в которой располагается исполняемый файл конкретного приложения

''ExecStart=java -Xms256m -Xmx512m -jar /opt/clientSide/clientSide-1.0.jar /opt/clientSide/application.yml'' - строка для запуска приложения

Также необходимо обратить на пути до приложения и файла настроек

''User=pcontrol'' - пользователь под которым будет запускаться приложение.

=Установка=
==pc-dmz-queue==
===Windows===
Распакуйте архив в корень диска, так, чтобы файл ''winsw.exe'' был доступен по пути ''C:\pc-dmz-queue\winsw.exe''

В командной строке выполните следующие команды
<source lang="cmd">
cd C:\pc-queue-dmz\
winsw.exe install pc-queue-dmz-1.0.jar
</source>

Логи пишутся в ''C:\pc-queue-dmz\''.

Созданной службой можно управлять из приложения Службы(Services).

Настройка подключений производится в ''application.yml''.

===Linux===
Создать папку
<source lang="bash">
mkdir /opt/pc-queue-dmz
</source>
В настройках файлов `.service` указать пользователя wildfly или создать нового, с аналогичными параметрами.
<source lang="bash">
groupadd -r username
useradd -r -g username -d /opt/pc-queue-dmz -s /sbin/nologin username
</source>
Предоставить доступ на запуск файлу start.sh
<source lang="bash">
chmod +x start.sh
</source>
Скопировать файл сервиса, запустить его и включить автозапуск
<source lang="bash">
sudo cp -v pc-dmz-queue.service /etc/systemd/system/
sudo systemctl enable pc-queue-dmz.service
sudo systemctl start pc-queue-dmz.service
</source>
Для просмотра журнала работы сервиса необходимо использовать
<source lang="bash">
journalctl -u pc-queue-dmz.service
</source>

==pc-queue-lan==
===Windows===
Распакуйте архив в корень диска, так, чтобы файл ''winsw.exe'' был доступен по пути ''C:\pc-queue-lan\winsw.exe''

В командной строке выполните следующие команды
<source lang="cmd">
cd C:\pc-queue-lan\
winsw.exe install pc-queue-lan-1.0.jar
</source>

Логи пишутся в ''C:\pc-queue-lan\''.

Созданной службой можно управлять из приложения Службы(Services).

Настройка подключений производится в ''application.yml''.

===Linux===
Создать папку
<source lang="bash">
mkdir /opt/pc-queue-lan
</source>

В настройках файлов `.service` указать пользователя wildfly или создать нового, с аналогичными параметрами.
<source lang="bash">
groupadd -r username
useradd -r -g username -d /opt/pc-queue-lan -s /sbin/nologin username
</source>

Предоставить доступ на запуск файлу start.sh
<source lang="bash">
chmod +x start.sh
</source>

Скопировать файл сервиса, запустить его и включить автозапуск
<source lang="bash">
sudo cp -v pc-queue-lan.service /etc/systemd/system/
sudo systemctl start pc-queue-lan.service
sudo systemctl enable pc-queue-lan.service
</source>

Для просмотра журнала работы сервиса необходимо использовать
<source lang="bash">
journalctl -u pc-queue-lan.service
</source>

=Конфигурирование модулей=
Установка параметров работы модулей производится в файле application.yml.

==Настройка входящих соединений==
Можно уточнить сетевой порт и адрес, который будет слушать модуль.
<source lang="yml">
server:
port: 8090
address: 0.0.0.0
</source>

0.0.0.0 - означает что модуль будет принимать все запросы на любых сетевых интерфейсах

==Настройка подключения к брокеру очередей==
Модули работают с брокером RabbitMQ. Пример параметров подключения:
<source lang="yml">
spring:
rabbitmq:
username: exampleuser
password: examplepass
virtual-host: /
host: example.rabbit.loc
port: 5672
</source>

==Настройка модуля pc-queue-lan для подключения к серверу PCS==
Адрес и порт сервера PCS:
<source lang="yml">
paycontrol:
url: example.pcs.loc
port: 8080
</source>

=Настройка PC на работу через очередь=
==Настройка PC External==
Для настройки PC External на отправку сообщений в очередь, необхоимо в файле
* Linux - `/opt/wildfly/bin/standalone.conf`
* Windows - `wildfly\bin\standalone.conf.bat`
в параметрах переменных окружения, вместо адреса сервера PCS задать адрес модуля pc-queue-dmz, например:

===v3===
<source lang="bash">
-Dpcservice.endpoint=http://localhost:8090/ws/PayControlServiceV3?wsdl
</source>
===v5===
<source lang="bash">
-Dpc_url=http://localhost:8090/pc-api/
</source>
===v6===
<source lang="yml">
pc:
external:
server:
url: http://localhost:8090/pc-api/
</source>

При этом адрес эндпоинта должен оставаться таким-же как и для сервера PC Server.

==Настройка PC Server==
Внесение настроек на сервер PC Server не требуется.

Обновление PayControl с версии 3 на версию 6

2025-09-25T08:31:27Z

D.bizyukov: /* Изменение адреса для внешних подключений (PCE) с мобильных устройств */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== Postgre ===

<syntaxhighlight lang="sql">
alter table pc_delayedkeyinfo alter column is_deleted set not null;
alter table pc_delayedkeyinfo alter column is_deleted set default 0;
alter table pc_delayedkeyinfo drop column type;
alter table pc_delayedkeyinfo add column renew_challenge varchar(255);

alter table pc_device alter column is_deleted set not null;
alter table pc_device alter column is_deleted set default 0;
alter table pc_device add column app_id varchar(255);

alter table pc_event alter column is_deleted set not null;
alter table pc_event alter column is_deleted set default 0;
alter table pc_event alter column requester_ip type varchar(64);
alter table pc_event add column event_data text;
alter table pc_event drop column eventposturl;

alter table pc_keyinfo alter column is_deleted set not null;
alter table pc_keyinfo alter column is_deleted set default 0;
alter table pc_keyinfo drop column type;
alter table pc_keyinfo drop column key_container_id;
alter table pc_keyinfo add column external_approve_data_id varchar(255);

alter table pc_publickey alter column is_deleted set not null;
alter table pc_publickey alter column is_deleted set default 0;
alter table pc_publickey add column autosign_public_key bytea;

alter table pc_system alter column is_deleted set not null;
alter table pc_system alter column is_deleted set default 0;
alter table pc_system add column callback_url varchar(255);

alter table pc_system_params alter column is_deleted set not null;
alter table pc_system_params alter column is_deleted set default 0;
alter table pc_system_params alter column license type varchar(4096);
alter table pc_system_params add column qr_url_scheme varchar(24);

alter table pc_transaction alter column is_deleted set not null;
alter table pc_transaction alter column is_deleted set default 0;
alter table pc_transaction add column autosign_enabled int2;
alter table pc_transaction add column ext_pulp bytea;
alter table pc_transaction add column extended_check int2;
alter table pc_transaction add column render_type int4;
alter table pc_transaction add column scoring_settings varchar(1023);
alter table pc_transaction add column transaction_type int4;

alter table pc_user alter column is_deleted set not null;
alter table pc_user alter column is_deleted set default 0;
alter table pc_user add column blocked int2;

alter table pc_confirm_attempt add column scoring_results varchar(512);
alter table pc_confirm_attempt add column scoring_settings varchar(512);
</syntaxhighlight>

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_KEYINFO
DROP COLUMN type;

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_DELAYEDKEYINFO
DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

=== Oracle ===

<syntaxhighlight lang="sql">
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_delayedkeyinfo DROP COLUMN type;
ALTER TABLE pc_delayedkeyinfo ADD renew_challenge VARCHAR2(255);

ALTER TABLE pc_device MODIFY is_deleted NOT NULL;
ALTER TABLE pc_device MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_device ADD app_id VARCHAR2(255);

ALTER TABLE pc_event MODIFY is_deleted NOT NULL;
ALTER TABLE pc_event MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_event MODIFY requester_ip VARCHAR2(64);
ALTER TABLE pc_event ADD event_data CLOB;
ALTER TABLE pc_event DROP COLUMN eventposturl;

ALTER TABLE pc_keyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_keyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_keyinfo DROP COLUMN type;
ALTER TABLE pc_keyinfo DROP COLUMN key_container_id;
ALTER TABLE pc_keyinfo ADD external_approve_data_id VARCHAR2(255);

ALTER TABLE pc_publickey MODIFY is_deleted NOT NULL;
ALTER TABLE pc_publickey MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_publickey ADD autosign_public_key BLOB;

ALTER TABLE pc_system MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system ADD callback_url VARCHAR2(255);

ALTER TABLE pc_system_params MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system_params MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system_params MODIFY license VARCHAR2(4000);
ALTER TABLE pc_system_params ADD qr_url_scheme VARCHAR2(24);

ALTER TABLE pc_transaction MODIFY is_deleted NOT NULL;
ALTER TABLE pc_transaction MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_transaction ADD autosign_enabled NUMBER(5);
ALTER TABLE pc_transaction ADD ext_pulp BLOB;
ALTER TABLE pc_transaction ADD extended_check NUMBER(5);
ALTER TABLE pc_transaction ADD render_type NUMBER(10);
ALTER TABLE pc_transaction ADD scoring_settings VARCHAR2(1023);
ALTER TABLE pc_transaction ADD transaction_type NUMBER(10);
ALTER TABLE pc_transaction ADD snipped_text VARCHAR2(1023);

ALTER TABLE pc_user MODIFY is_deleted NOT NULL;
ALTER TABLE pc_user MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_user ADD blocked NUMBER(5);

ALTER TABLE pc_confirm_attempt ADD scoring_results VARCHAR2(512);
ALTER TABLE pc_confirm_attempt ADD scoring_settings VARCHAR2(512);

ALTER TABLE pc_sys_property MODIFY SETTING_VALUE VARCHAR2(1023);

</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения обновленного запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set license='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
update pc_keyinfo set is_activated=1;
update pc_transaction set transaction_type=0;
update pc_transaction set render_type=0;
update pc_transaction set status=6 where status=4;
update pc_transaction set status=7 where status=5;

</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Не требуется начиная с версии 6.9.1''':

Для работы старых ключей, обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-pc-ext-example.com:8081/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 3 на версию 6

2025-08-07T11:40:15Z

D.bizyukov: /* Обновление модулей PC */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== Postgre ===

<syntaxhighlight lang="sql">
alter table pc_delayedkeyinfo alter column is_deleted set not null;
alter table pc_delayedkeyinfo alter column is_deleted set default 0;
alter table pc_delayedkeyinfo drop column type;
alter table pc_delayedkeyinfo add column renew_challenge varchar(255);

alter table pc_device alter column is_deleted set not null;
alter table pc_device alter column is_deleted set default 0;
alter table pc_device add column app_id varchar(255);

alter table pc_event alter column is_deleted set not null;
alter table pc_event alter column is_deleted set default 0;
alter table pc_event alter column requester_ip type varchar(64);
alter table pc_event add column event_data text;
alter table pc_event drop column eventposturl;

alter table pc_keyinfo alter column is_deleted set not null;
alter table pc_keyinfo alter column is_deleted set default 0;
alter table pc_keyinfo drop column type;
alter table pc_keyinfo drop column key_container_id;
alter table pc_keyinfo add column external_approve_data_id varchar(255);

alter table pc_publickey alter column is_deleted set not null;
alter table pc_publickey alter column is_deleted set default 0;
alter table pc_publickey add column autosign_public_key bytea;

alter table pc_system alter column is_deleted set not null;
alter table pc_system alter column is_deleted set default 0;
alter table pc_system add column callback_url varchar(255);

alter table pc_system_params alter column is_deleted set not null;
alter table pc_system_params alter column is_deleted set default 0;
alter table pc_system_params alter column license type varchar(4096);
alter table pc_system_params add column qr_url_scheme varchar(24);

alter table pc_transaction alter column is_deleted set not null;
alter table pc_transaction alter column is_deleted set default 0;
alter table pc_transaction add column autosign_enabled int2;
alter table pc_transaction add column ext_pulp bytea;
alter table pc_transaction add column extended_check int2;
alter table pc_transaction add column render_type int4;
alter table pc_transaction add column scoring_settings varchar(1023);
alter table pc_transaction add column transaction_type int4;

alter table pc_user alter column is_deleted set not null;
alter table pc_user alter column is_deleted set default 0;
alter table pc_user add column blocked int2;

alter table pc_confirm_attempt add column scoring_results varchar(512);
alter table pc_confirm_attempt add column scoring_settings varchar(512);
</syntaxhighlight>

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_KEYINFO
DROP COLUMN type;

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_DELAYEDKEYINFO
DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

=== Oracle ===

<syntaxhighlight lang="sql">
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_delayedkeyinfo DROP COLUMN type;
ALTER TABLE pc_delayedkeyinfo ADD renew_challenge VARCHAR2(255);

ALTER TABLE pc_device MODIFY is_deleted NOT NULL;
ALTER TABLE pc_device MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_device ADD app_id VARCHAR2(255);

ALTER TABLE pc_event MODIFY is_deleted NOT NULL;
ALTER TABLE pc_event MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_event MODIFY requester_ip VARCHAR2(64);
ALTER TABLE pc_event ADD event_data CLOB;
ALTER TABLE pc_event DROP COLUMN eventposturl;

ALTER TABLE pc_keyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_keyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_keyinfo DROP COLUMN type;
ALTER TABLE pc_keyinfo DROP COLUMN key_container_id;
ALTER TABLE pc_keyinfo ADD external_approve_data_id VARCHAR2(255);

ALTER TABLE pc_publickey MODIFY is_deleted NOT NULL;
ALTER TABLE pc_publickey MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_publickey ADD autosign_public_key BLOB;

ALTER TABLE pc_system MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system ADD callback_url VARCHAR2(255);

ALTER TABLE pc_system_params MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system_params MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system_params MODIFY license VARCHAR2(4000);
ALTER TABLE pc_system_params ADD qr_url_scheme VARCHAR2(24);

ALTER TABLE pc_transaction MODIFY is_deleted NOT NULL;
ALTER TABLE pc_transaction MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_transaction ADD autosign_enabled NUMBER(5);
ALTER TABLE pc_transaction ADD ext_pulp BLOB;
ALTER TABLE pc_transaction ADD extended_check NUMBER(5);
ALTER TABLE pc_transaction ADD render_type NUMBER(10);
ALTER TABLE pc_transaction ADD scoring_settings VARCHAR2(1023);
ALTER TABLE pc_transaction ADD transaction_type NUMBER(10);
ALTER TABLE pc_transaction ADD snipped_text VARCHAR2(1023);

ALTER TABLE pc_user MODIFY is_deleted NOT NULL;
ALTER TABLE pc_user MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_user ADD blocked NUMBER(5);

ALTER TABLE pc_confirm_attempt ADD scoring_results VARCHAR2(512);
ALTER TABLE pc_confirm_attempt ADD scoring_settings VARCHAR2(512);

ALTER TABLE pc_sys_property MODIFY SETTING_VALUE VARCHAR2(1023);

</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения обновленного запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set license='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
update pc_keyinfo set is_activated=1;
update pc_transaction set transaction_type=0;
update pc_transaction set render_type=0;
update pc_transaction set status=6 where status=4;
update pc_transaction set status=7 where status=5;

</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

На версии сервера 6.0.0-6.9.0 '''для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-pc-ext-example.com:8081/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 5 на версию 6

2025-08-05T11:02:59Z

D.bizyukov: /* Замена лицензии(при наличии) в БД */

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

= Изменения в БД =

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения нового запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set license='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly.

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

Обновление PayControl с версии 3 на версию 6

2025-07-09T07:25:46Z

D.bizyukov: /* Получение нового запроса и лицензии */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== Postgre ===

<syntaxhighlight lang="sql">
alter table pc_delayedkeyinfo alter column is_deleted set not null;
alter table pc_delayedkeyinfo alter column is_deleted set default 0;
alter table pc_delayedkeyinfo drop column type;
alter table pc_delayedkeyinfo add column renew_challenge varchar(255);

alter table pc_device alter column is_deleted set not null;
alter table pc_device alter column is_deleted set default 0;
alter table pc_device add column app_id varchar(255);

alter table pc_event alter column is_deleted set not null;
alter table pc_event alter column is_deleted set default 0;
alter table pc_event alter column requester_ip type varchar(64);
alter table pc_event add column event_data text;
alter table pc_event drop column eventposturl;

alter table pc_keyinfo alter column is_deleted set not null;
alter table pc_keyinfo alter column is_deleted set default 0;
alter table pc_keyinfo drop column type;
alter table pc_keyinfo drop column key_container_id;
alter table pc_keyinfo add column external_approve_data_id varchar(255);

alter table pc_publickey alter column is_deleted set not null;
alter table pc_publickey alter column is_deleted set default 0;
alter table pc_publickey add column autosign_public_key bytea;

alter table pc_system alter column is_deleted set not null;
alter table pc_system alter column is_deleted set default 0;
alter table pc_system add column callback_url varchar(255);

alter table pc_system_params alter column is_deleted set not null;
alter table pc_system_params alter column is_deleted set default 0;
alter table pc_system_params alter column license type varchar(4096);
alter table pc_system_params add column qr_url_scheme varchar(24);

alter table pc_transaction alter column is_deleted set not null;
alter table pc_transaction alter column is_deleted set default 0;
alter table pc_transaction add column autosign_enabled int2;
alter table pc_transaction add column ext_pulp bytea;
alter table pc_transaction add column extended_check int2;
alter table pc_transaction add column render_type int4;
alter table pc_transaction add column scoring_settings varchar(1023);
alter table pc_transaction add column transaction_type int4;

alter table pc_user alter column is_deleted set not null;
alter table pc_user alter column is_deleted set default 0;
alter table pc_user add column blocked int2;

alter table pc_confirm_attempt add column scoring_results varchar(512);
alter table pc_confirm_attempt add column scoring_settings varchar(512);
</syntaxhighlight>

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_KEYINFO
DROP COLUMN type;

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_DELAYEDKEYINFO
DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

=== Oracle ===

<syntaxhighlight lang="sql">
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_delayedkeyinfo DROP COLUMN type;
ALTER TABLE pc_delayedkeyinfo ADD renew_challenge VARCHAR2(255);

ALTER TABLE pc_device MODIFY is_deleted NOT NULL;
ALTER TABLE pc_device MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_device ADD app_id VARCHAR2(255);

ALTER TABLE pc_event MODIFY is_deleted NOT NULL;
ALTER TABLE pc_event MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_event MODIFY requester_ip VARCHAR2(64);
ALTER TABLE pc_event ADD event_data CLOB;
ALTER TABLE pc_event DROP COLUMN eventposturl;

ALTER TABLE pc_keyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_keyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_keyinfo DROP COLUMN type;
ALTER TABLE pc_keyinfo DROP COLUMN key_container_id;
ALTER TABLE pc_keyinfo ADD external_approve_data_id VARCHAR2(255);

ALTER TABLE pc_publickey MODIFY is_deleted NOT NULL;
ALTER TABLE pc_publickey MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_publickey ADD autosign_public_key BLOB;

ALTER TABLE pc_system MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system ADD callback_url VARCHAR2(255);

ALTER TABLE pc_system_params MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system_params MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system_params MODIFY license VARCHAR2(4000);
ALTER TABLE pc_system_params ADD qr_url_scheme VARCHAR2(24);

ALTER TABLE pc_transaction MODIFY is_deleted NOT NULL;
ALTER TABLE pc_transaction MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_transaction ADD autosign_enabled NUMBER(5);
ALTER TABLE pc_transaction ADD ext_pulp BLOB;
ALTER TABLE pc_transaction ADD extended_check NUMBER(5);
ALTER TABLE pc_transaction ADD render_type NUMBER(10);
ALTER TABLE pc_transaction ADD scoring_settings VARCHAR2(1023);
ALTER TABLE pc_transaction ADD transaction_type NUMBER(10);
ALTER TABLE pc_transaction ADD snipped_text VARCHAR2(1023);

ALTER TABLE pc_user MODIFY is_deleted NOT NULL;
ALTER TABLE pc_user MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_user ADD blocked NUMBER(5);

ALTER TABLE pc_confirm_attempt ADD scoring_results VARCHAR2(512);
ALTER TABLE pc_confirm_attempt ADD scoring_settings VARCHAR2(512);

ALTER TABLE pc_sys_property MODIFY SETTING_VALUE VARCHAR2(1023);

</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения обновленного запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set license='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
update pc_keyinfo set is_activated=1;
update pc_transaction set transaction_type=0;
update pc_transaction set render_type=0;
</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

На версии сервера 6.0.0-6.9.0 '''для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-pc-ext-example.com:8081/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 3 на версию 6

2025-07-09T07:25:35Z

D.bizyukov: /* Получение нового запроса и лицензии */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== Postgre ===

<syntaxhighlight lang="sql">
alter table pc_delayedkeyinfo alter column is_deleted set not null;
alter table pc_delayedkeyinfo alter column is_deleted set default 0;
alter table pc_delayedkeyinfo drop column type;
alter table pc_delayedkeyinfo add column renew_challenge varchar(255);

alter table pc_device alter column is_deleted set not null;
alter table pc_device alter column is_deleted set default 0;
alter table pc_device add column app_id varchar(255);

alter table pc_event alter column is_deleted set not null;
alter table pc_event alter column is_deleted set default 0;
alter table pc_event alter column requester_ip type varchar(64);
alter table pc_event add column event_data text;
alter table pc_event drop column eventposturl;

alter table pc_keyinfo alter column is_deleted set not null;
alter table pc_keyinfo alter column is_deleted set default 0;
alter table pc_keyinfo drop column type;
alter table pc_keyinfo drop column key_container_id;
alter table pc_keyinfo add column external_approve_data_id varchar(255);

alter table pc_publickey alter column is_deleted set not null;
alter table pc_publickey alter column is_deleted set default 0;
alter table pc_publickey add column autosign_public_key bytea;

alter table pc_system alter column is_deleted set not null;
alter table pc_system alter column is_deleted set default 0;
alter table pc_system add column callback_url varchar(255);

alter table pc_system_params alter column is_deleted set not null;
alter table pc_system_params alter column is_deleted set default 0;
alter table pc_system_params alter column license type varchar(4096);
alter table pc_system_params add column qr_url_scheme varchar(24);

alter table pc_transaction alter column is_deleted set not null;
alter table pc_transaction alter column is_deleted set default 0;
alter table pc_transaction add column autosign_enabled int2;
alter table pc_transaction add column ext_pulp bytea;
alter table pc_transaction add column extended_check int2;
alter table pc_transaction add column render_type int4;
alter table pc_transaction add column scoring_settings varchar(1023);
alter table pc_transaction add column transaction_type int4;

alter table pc_user alter column is_deleted set not null;
alter table pc_user alter column is_deleted set default 0;
alter table pc_user add column blocked int2;

alter table pc_confirm_attempt add column scoring_results varchar(512);
alter table pc_confirm_attempt add column scoring_settings varchar(512);
</syntaxhighlight>

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_KEYINFO
DROP COLUMN type;

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_DELAYEDKEYINFO
DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

=== Oracle ===

<syntaxhighlight lang="sql">
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_delayedkeyinfo DROP COLUMN type;
ALTER TABLE pc_delayedkeyinfo ADD renew_challenge VARCHAR2(255);

ALTER TABLE pc_device MODIFY is_deleted NOT NULL;
ALTER TABLE pc_device MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_device ADD app_id VARCHAR2(255);

ALTER TABLE pc_event MODIFY is_deleted NOT NULL;
ALTER TABLE pc_event MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_event MODIFY requester_ip VARCHAR2(64);
ALTER TABLE pc_event ADD event_data CLOB;
ALTER TABLE pc_event DROP COLUMN eventposturl;

ALTER TABLE pc_keyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_keyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_keyinfo DROP COLUMN type;
ALTER TABLE pc_keyinfo DROP COLUMN key_container_id;
ALTER TABLE pc_keyinfo ADD external_approve_data_id VARCHAR2(255);

ALTER TABLE pc_publickey MODIFY is_deleted NOT NULL;
ALTER TABLE pc_publickey MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_publickey ADD autosign_public_key BLOB;

ALTER TABLE pc_system MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system ADD callback_url VARCHAR2(255);

ALTER TABLE pc_system_params MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system_params MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system_params MODIFY license VARCHAR2(4000);
ALTER TABLE pc_system_params ADD qr_url_scheme VARCHAR2(24);

ALTER TABLE pc_transaction MODIFY is_deleted NOT NULL;
ALTER TABLE pc_transaction MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_transaction ADD autosign_enabled NUMBER(5);
ALTER TABLE pc_transaction ADD ext_pulp BLOB;
ALTER TABLE pc_transaction ADD extended_check NUMBER(5);
ALTER TABLE pc_transaction ADD render_type NUMBER(10);
ALTER TABLE pc_transaction ADD scoring_settings VARCHAR2(1023);
ALTER TABLE pc_transaction ADD transaction_type NUMBER(10);
ALTER TABLE pc_transaction ADD snipped_text VARCHAR2(1023);

ALTER TABLE pc_user MODIFY is_deleted NOT NULL;
ALTER TABLE pc_user MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_user ADD blocked NUMBER(5);

ALTER TABLE pc_confirm_attempt ADD scoring_results VARCHAR2(512);
ALTER TABLE pc_confirm_attempt ADD scoring_settings VARCHAR2(512);

ALTER TABLE pc_sys_property MODIFY SETTING_VALUE VARCHAR2(1023);

</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения обновленого запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set license='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
update pc_keyinfo set is_activated=1;
update pc_transaction set transaction_type=0;
update pc_transaction set render_type=0;
</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

На версии сервера 6.0.0-6.9.0 '''для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-pc-ext-example.com:8081/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 3 на версию 6

2025-06-19T12:34:39Z

D.bizyukov: /* Изменение адреса для внешних подключений (PCE) с мобильных устройств */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== Postgre ===

<syntaxhighlight lang="sql">
alter table pc_delayedkeyinfo alter column is_deleted set not null;
alter table pc_delayedkeyinfo alter column is_deleted set default 0;
alter table pc_delayedkeyinfo drop column type;
alter table pc_delayedkeyinfo add column renew_challenge varchar(255);

alter table pc_device alter column is_deleted set not null;
alter table pc_device alter column is_deleted set default 0;
alter table pc_device add column app_id varchar(255);

alter table pc_event alter column is_deleted set not null;
alter table pc_event alter column is_deleted set default 0;
alter table pc_event alter column requester_ip type varchar(64);
alter table pc_event add column event_data text;
alter table pc_event drop column eventposturl;

alter table pc_keyinfo alter column is_deleted set not null;
alter table pc_keyinfo alter column is_deleted set default 0;
alter table pc_keyinfo drop column type;
alter table pc_keyinfo drop column key_container_id;
alter table pc_keyinfo add column external_approve_data_id varchar(255);

alter table pc_publickey alter column is_deleted set not null;
alter table pc_publickey alter column is_deleted set default 0;
alter table pc_publickey add column autosign_public_key bytea;

alter table pc_system alter column is_deleted set not null;
alter table pc_system alter column is_deleted set default 0;
alter table pc_system add column callback_url varchar(255);

alter table pc_system_params alter column is_deleted set not null;
alter table pc_system_params alter column is_deleted set default 0;
alter table pc_system_params alter column license type varchar(4096);
alter table pc_system_params add column qr_url_scheme varchar(24);

alter table pc_transaction alter column is_deleted set not null;
alter table pc_transaction alter column is_deleted set default 0;
alter table pc_transaction add column autosign_enabled int2;
alter table pc_transaction add column ext_pulp bytea;
alter table pc_transaction add column extended_check int2;
alter table pc_transaction add column render_type int4;
alter table pc_transaction add column scoring_settings varchar(1023);
alter table pc_transaction add column transaction_type int4;

alter table pc_user alter column is_deleted set not null;
alter table pc_user alter column is_deleted set default 0;
alter table pc_user add column blocked int2;

alter table pc_confirm_attempt add column scoring_results varchar(512);
alter table pc_confirm_attempt add column scoring_settings varchar(512);
</syntaxhighlight>

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_KEYINFO
DROP COLUMN type;

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_DELAYEDKEYINFO
DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

=== Oracle ===

<syntaxhighlight lang="sql">
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_delayedkeyinfo DROP COLUMN type;
ALTER TABLE pc_delayedkeyinfo ADD renew_challenge VARCHAR2(255);

ALTER TABLE pc_device MODIFY is_deleted NOT NULL;
ALTER TABLE pc_device MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_device ADD app_id VARCHAR2(255);

ALTER TABLE pc_event MODIFY is_deleted NOT NULL;
ALTER TABLE pc_event MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_event MODIFY requester_ip VARCHAR2(64);
ALTER TABLE pc_event ADD event_data CLOB;
ALTER TABLE pc_event DROP COLUMN eventposturl;

ALTER TABLE pc_keyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_keyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_keyinfo DROP COLUMN type;
ALTER TABLE pc_keyinfo DROP COLUMN key_container_id;
ALTER TABLE pc_keyinfo ADD external_approve_data_id VARCHAR2(255);

ALTER TABLE pc_publickey MODIFY is_deleted NOT NULL;
ALTER TABLE pc_publickey MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_publickey ADD autosign_public_key BLOB;

ALTER TABLE pc_system MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system ADD callback_url VARCHAR2(255);

ALTER TABLE pc_system_params MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system_params MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system_params MODIFY license VARCHAR2(4000);
ALTER TABLE pc_system_params ADD qr_url_scheme VARCHAR2(24);

ALTER TABLE pc_transaction MODIFY is_deleted NOT NULL;
ALTER TABLE pc_transaction MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_transaction ADD autosign_enabled NUMBER(5);
ALTER TABLE pc_transaction ADD ext_pulp BLOB;
ALTER TABLE pc_transaction ADD extended_check NUMBER(5);
ALTER TABLE pc_transaction ADD render_type NUMBER(10);
ALTER TABLE pc_transaction ADD scoring_settings VARCHAR2(1023);
ALTER TABLE pc_transaction ADD transaction_type NUMBER(10);
ALTER TABLE pc_transaction ADD snipped_text VARCHAR2(1023);

ALTER TABLE pc_user MODIFY is_deleted NOT NULL;
ALTER TABLE pc_user MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_user ADD blocked NUMBER(5);

ALTER TABLE pc_confirm_attempt ADD scoring_results VARCHAR2(512);
ALTER TABLE pc_confirm_attempt ADD scoring_settings VARCHAR2(512);

ALTER TABLE pc_sys_property MODIFY SETTING_VALUE VARCHAR2(1023);

</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения нового запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set license='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
update pc_keyinfo set is_activated=1;
update pc_transaction set transaction_type=0;
update pc_transaction set render_type=0;
</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

На версии сервера 6.0.0-6.9.0 '''для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-pc-ext-example.com:8081/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 3 на версию 6

2025-04-01T08:32:02Z

D.bizyukov: /* Замена лицензии(при наличии) в БД */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== Postgre ===

<syntaxhighlight lang="sql">
alter table pc_delayedkeyinfo alter column is_deleted set not null;
alter table pc_delayedkeyinfo alter column is_deleted set default 0;
alter table pc_delayedkeyinfo drop column type;
alter table pc_delayedkeyinfo add column renew_challenge varchar(255);

alter table pc_device alter column is_deleted set not null;
alter table pc_device alter column is_deleted set default 0;
alter table pc_device add column app_id varchar(255);

alter table pc_event alter column is_deleted set not null;
alter table pc_event alter column is_deleted set default 0;
alter table pc_event alter column requester_ip type varchar(64);
alter table pc_event add column event_data text;
alter table pc_event drop column eventposturl;

alter table pc_keyinfo alter column is_deleted set not null;
alter table pc_keyinfo alter column is_deleted set default 0;
alter table pc_keyinfo drop column type;
alter table pc_keyinfo drop column key_container_id;
alter table pc_keyinfo add column external_approve_data_id varchar(255);

alter table pc_publickey alter column is_deleted set not null;
alter table pc_publickey alter column is_deleted set default 0;
alter table pc_publickey add column autosign_public_key bytea;

alter table pc_system alter column is_deleted set not null;
alter table pc_system alter column is_deleted set default 0;
alter table pc_system add column callback_url varchar(255);

alter table pc_system_params alter column is_deleted set not null;
alter table pc_system_params alter column is_deleted set default 0;
alter table pc_system_params alter column license type varchar(4096);
alter table pc_system_params add column qr_url_scheme varchar(24);

alter table pc_transaction alter column is_deleted set not null;
alter table pc_transaction alter column is_deleted set default 0;
alter table pc_transaction add column autosign_enabled int2;
alter table pc_transaction add column ext_pulp bytea;
alter table pc_transaction add column extended_check int2;
alter table pc_transaction add column render_type int4;
alter table pc_transaction add column scoring_settings varchar(1023);
alter table pc_transaction add column transaction_type int4;

alter table pc_user alter column is_deleted set not null;
alter table pc_user alter column is_deleted set default 0;
alter table pc_user add column blocked int2;

alter table pc_confirm_attempt add column scoring_results varchar(512);
alter table pc_confirm_attempt add column scoring_settings varchar(512);
</syntaxhighlight>

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_KEYINFO
DROP COLUMN type;

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_DELAYEDKEYINFO
DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

=== Oracle ===

<syntaxhighlight lang="sql">
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_delayedkeyinfo DROP COLUMN type;
ALTER TABLE pc_delayedkeyinfo ADD renew_challenge VARCHAR2(255);

ALTER TABLE pc_device MODIFY is_deleted NOT NULL;
ALTER TABLE pc_device MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_device ADD app_id VARCHAR2(255);

ALTER TABLE pc_event MODIFY is_deleted NOT NULL;
ALTER TABLE pc_event MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_event MODIFY requester_ip VARCHAR2(64);
ALTER TABLE pc_event ADD event_data CLOB;
ALTER TABLE pc_event DROP COLUMN eventposturl;

ALTER TABLE pc_keyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_keyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_keyinfo DROP COLUMN type;
ALTER TABLE pc_keyinfo DROP COLUMN key_container_id;
ALTER TABLE pc_keyinfo ADD external_approve_data_id VARCHAR2(255);

ALTER TABLE pc_publickey MODIFY is_deleted NOT NULL;
ALTER TABLE pc_publickey MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_publickey ADD autosign_public_key BLOB;

ALTER TABLE pc_system MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system ADD callback_url VARCHAR2(255);

ALTER TABLE pc_system_params MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system_params MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system_params MODIFY license VARCHAR2(4000);
ALTER TABLE pc_system_params ADD qr_url_scheme VARCHAR2(24);

ALTER TABLE pc_transaction MODIFY is_deleted NOT NULL;
ALTER TABLE pc_transaction MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_transaction ADD autosign_enabled NUMBER(5);
ALTER TABLE pc_transaction ADD ext_pulp BLOB;
ALTER TABLE pc_transaction ADD extended_check NUMBER(5);
ALTER TABLE pc_transaction ADD render_type NUMBER(10);
ALTER TABLE pc_transaction ADD scoring_settings VARCHAR2(1023);
ALTER TABLE pc_transaction ADD transaction_type NUMBER(10);
ALTER TABLE pc_transaction ADD snipped_text VARCHAR2(1023);

ALTER TABLE pc_user MODIFY is_deleted NOT NULL;
ALTER TABLE pc_user MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_user ADD blocked NUMBER(5);

ALTER TABLE pc_confirm_attempt ADD scoring_results VARCHAR2(512);
ALTER TABLE pc_confirm_attempt ADD scoring_settings VARCHAR2(512);

ALTER TABLE pc_sys_property MODIFY SETTING_VALUE VARCHAR2(1023);

</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения нового запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set license='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
update pc_keyinfo set is_activated=1;
update pc_transaction set transaction_type=0;
update pc_transaction set render_type=0;
</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-pc-ext-example.com:8081/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

PC via queues

2025-03-24T12:22:02Z

D.bizyukov: /* v5, v6 */

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

https://repo.paycontrol.org/server/doc/latest/pc-handbook/ru/#использование-очередей-для-ограничения-соединений-от-pce-к-pcs.

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

Загрузить RabbitMQ можно на сайте: https://www.rabbitmq.com

Для корректной работы с очередями нужно создать админ-пользователя помимо guest и настроить подключение через этого нового пользователя.

Приложение состоит из двух модулей:
* для зоны DMZ - ''pc-queue-dmz-1.0.jar'';
* для внутренней сети ''pc-queue-lan-1.0.jar''.

=Файлы для запуска=
==Linux==
Файлы запуска имеют разрешение ''.service''.

Для корректной работы приложения необходимо их отредактировать под конкретное окружение.

''WorkingDirectory=/opt/clientSide'' - директория в которой располагается исполняемый файл конкретного приложения

''ExecStart=java -Xms256m -Xmx512m -jar /opt/clientSide/clientSide-1.0.jar /opt/clientSide/application.yml'' - строка для запуска приложения

Также необходимо обратить на пути до приложения и файла настроек

''User=pcontrol'' - пользователь под которым будет запускаться приложение.

=Установка=
==pc-dmz-queue==
===Windows===
Распакуйте архив в корень диска, так, чтобы файл ''winsw.exe'' был доступен по пути ''C:\pc-dmz-queue\winsw.exe''

В командной строке выполните следующие команды
<source lang="cmd">
cd C:\pc-queue-dmz\
winsw.exe install pc-queue-dmz-1.0.jar
</source>

Логи пишутся в ''C:\pc-queue-dmz\''.

Созданной службой можно управлять из приложения Службы(Services).

Настройка подключений производится в ''application.yml''.

===Linux===
Создать папку
<source lang="bash">
mkdir /opt/pc-queue-dmz
</source>
В настройках файлов `.service` указать пользователя wildfly или создать нового, с аналогичными параметрами.
<source lang="bash">
groupadd -r username
useradd -r -g username -d /opt/pc-queue-dmz -s /sbin/nologin username
</source>
Предоставить доступ на запуск файлу start.sh
<source lang="bash">
chmod +x start.sh
</source>
Скопировать файл сервиса, запустить его и включить автозапуск
<source lang="bash">
sudo cp -v pc-dmz-queue.service /etc/systemd/system/
sudo systemctl enable pc-queue-dmz.service
sudo systemctl start pc-queue-dmz.service
</source>
Для просмотра журнала работы сервиса необходимо использовать
<source lang="bash">
journalctl -u pc-queue-dmz.service
</source>

==pc-queue-lan==
===Windows===
Распакуйте архив в корень диска, так, чтобы файл ''winsw.exe'' был доступен по пути ''C:\pc-queue-lan\winsw.exe''

В командной строке выполните следующие команды
<source lang="cmd">
cd C:\pc-queue-lan\
winsw.exe install pc-queue-lan-1.0.jar
</source>

Логи пишутся в ''C:\pc-queue-lan\''.

Созданной службой можно управлять из приложения Службы(Services).

Настройка подключений производится в ''application.yml''.

===Linux===
Создать папку
<source lang="bash">
mkdir /opt/pc-queue-lan
</source>

В настройках файлов `.service` указать пользователя wildfly или создать нового, с аналогичными параметрами.
<source lang="bash">
groupadd -r username
useradd -r -g username -d /opt/pc-queue-lan -s /sbin/nologin username
</source>

Предоставить доступ на запуск файлу start.sh
<source lang="bash">
chmod +x start.sh
</source>

Скопировать файл сервиса, запустить его и включить автозапуск
<source lang="bash">
sudo cp -v pc-queue-lan.service /etc/systemd/system/
sudo systemctl start pc-queue-lan.service
sudo systemctl enable pc-queue-lan.service
</source>

Для просмотра журнала работы сервиса необходимо использовать
<source lang="bash">
journalctl -u pc-queue-lan.service
</source>

=Конфигурирование модулей=
Установка параметров работы модулей производится в файле application.yml.

==Настройка входящих соединений==
Можно уточнить сетевой порт и адрес, который будет слушать модуль.
<source lang="yml">
server:
port: 8090
address: 0.0.0.0
</source>

0.0.0.0 - означает что модуль будет принимать все запросы на любых сетевых интерфейсах

==Настройка подключения к брокеру очередей==
Модули работают с брокером RabbitMQ. Пример параметров подключения:
<source lang="yml">
spring:
rabbitmq:
username: exampleuser
password: examplepass
virtual-host: /
host: example.rabbit.loc
port: 5672
</source>

==Настройка модуля pc-queue-lan для подключения к серверу PCS==
Адрес и порт сервера PCS:
<source lang="yml">
paycontrol:
url: example.pcs.loc
port: 8080
</source>

=Настройка PC на работу через очередь=
==Настройка PC External==
Для настройки PC External на отправку сообщений в очередь, необхоимо в файле
* Linux - `/opt/wildfly/bin/standalone.conf`
* Windows - `wildfly\bin\standalone.conf.bat`
в параметрах переменных окружения, вместо адреса сервера PCS задать адрес модуля pc-queue-dmz, например:

===v3===
<source lang="bash">
-Dpcservice.endpoint=http://localhost:8090/ws/PayControlServiceV3?wsdl
</source>
===v5===
<source lang="bash">
-Dpc_url=http://localhost:8090/pc-api/
</source>

При этом адрес эндпоинта должен оставаться таким-же как и для сервера PC Server.

==Настройка PC Server==
Внесение настроек на сервер PC Server не требуется.

PC via queues

2025-03-24T12:21:46Z

D.bizyukov: /* v5 */

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

https://repo.paycontrol.org/server/doc/latest/pc-handbook/ru/#использование-очередей-для-ограничения-соединений-от-pce-к-pcs.

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

Загрузить RabbitMQ можно на сайте: https://www.rabbitmq.com

Для корректной работы с очередями нужно создать админ-пользователя помимо guest и настроить подключение через этого нового пользователя.

Приложение состоит из двух модулей:
* для зоны DMZ - ''pc-queue-dmz-1.0.jar'';
* для внутренней сети ''pc-queue-lan-1.0.jar''.

=Файлы для запуска=
==Linux==
Файлы запуска имеют разрешение ''.service''.

Для корректной работы приложения необходимо их отредактировать под конкретное окружение.

''WorkingDirectory=/opt/clientSide'' - директория в которой располагается исполняемый файл конкретного приложения

''ExecStart=java -Xms256m -Xmx512m -jar /opt/clientSide/clientSide-1.0.jar /opt/clientSide/application.yml'' - строка для запуска приложения

Также необходимо обратить на пути до приложения и файла настроек

''User=pcontrol'' - пользователь под которым будет запускаться приложение.

=Установка=
==pc-dmz-queue==
===Windows===
Распакуйте архив в корень диска, так, чтобы файл ''winsw.exe'' был доступен по пути ''C:\pc-dmz-queue\winsw.exe''

В командной строке выполните следующие команды
<source lang="cmd">
cd C:\pc-queue-dmz\
winsw.exe install pc-queue-dmz-1.0.jar
</source>

Логи пишутся в ''C:\pc-queue-dmz\''.

Созданной службой можно управлять из приложения Службы(Services).

Настройка подключений производится в ''application.yml''.

===Linux===
Создать папку
<source lang="bash">
mkdir /opt/pc-queue-dmz
</source>
В настройках файлов `.service` указать пользователя wildfly или создать нового, с аналогичными параметрами.
<source lang="bash">
groupadd -r username
useradd -r -g username -d /opt/pc-queue-dmz -s /sbin/nologin username
</source>
Предоставить доступ на запуск файлу start.sh
<source lang="bash">
chmod +x start.sh
</source>
Скопировать файл сервиса, запустить его и включить автозапуск
<source lang="bash">
sudo cp -v pc-dmz-queue.service /etc/systemd/system/
sudo systemctl enable pc-queue-dmz.service
sudo systemctl start pc-queue-dmz.service
</source>
Для просмотра журнала работы сервиса необходимо использовать
<source lang="bash">
journalctl -u pc-queue-dmz.service
</source>

==pc-queue-lan==
===Windows===
Распакуйте архив в корень диска, так, чтобы файл ''winsw.exe'' был доступен по пути ''C:\pc-queue-lan\winsw.exe''

В командной строке выполните следующие команды
<source lang="cmd">
cd C:\pc-queue-lan\
winsw.exe install pc-queue-lan-1.0.jar
</source>

Логи пишутся в ''C:\pc-queue-lan\''.

Созданной службой можно управлять из приложения Службы(Services).

Настройка подключений производится в ''application.yml''.

===Linux===
Создать папку
<source lang="bash">
mkdir /opt/pc-queue-lan
</source>

В настройках файлов `.service` указать пользователя wildfly или создать нового, с аналогичными параметрами.
<source lang="bash">
groupadd -r username
useradd -r -g username -d /opt/pc-queue-lan -s /sbin/nologin username
</source>

Предоставить доступ на запуск файлу start.sh
<source lang="bash">
chmod +x start.sh
</source>

Скопировать файл сервиса, запустить его и включить автозапуск
<source lang="bash">
sudo cp -v pc-queue-lan.service /etc/systemd/system/
sudo systemctl start pc-queue-lan.service
sudo systemctl enable pc-queue-lan.service
</source>

Для просмотра журнала работы сервиса необходимо использовать
<source lang="bash">
journalctl -u pc-queue-lan.service
</source>

=Конфигурирование модулей=
Установка параметров работы модулей производится в файле application.yml.

==Настройка входящих соединений==
Можно уточнить сетевой порт и адрес, который будет слушать модуль.
<source lang="yml">
server:
port: 8090
address: 0.0.0.0
</source>

0.0.0.0 - означает что модуль будет принимать все запросы на любых сетевых интерфейсах

==Настройка подключения к брокеру очередей==
Модули работают с брокером RabbitMQ. Пример параметров подключения:
<source lang="yml">
spring:
rabbitmq:
username: exampleuser
password: examplepass
virtual-host: /
host: example.rabbit.loc
port: 5672
</source>

==Настройка модуля pc-queue-lan для подключения к серверу PCS==
Адрес и порт сервера PCS:
<source lang="yml">
paycontrol:
url: example.pcs.loc
port: 8080
</source>

=Настройка PC на работу через очередь=
==Настройка PC External==
Для настройки PC External на отправку сообщений в очередь, необхоимо в файле
* Linux - `/opt/wildfly/bin/standalone.conf`
* Windows - `wildfly\bin\standalone.conf.bat`
в параметрах переменных окружения, вместо адреса сервера PCS задать адрес модуля pc-queue-dmz, например:

===v3===
<source lang="bash">
-Dpcservice.endpoint=http://localhost:8090/ws/PayControlServiceV3?wsdl
</source>
===v5, v6===
<source lang="bash">
-Dpc_url=http://localhost:8090/pc-api/
</source>

При этом адрес эндпоинта должен оставаться таким-же как и для сервера PC Server.

==Настройка PC Server==
Внесение настроек на сервер PC Server не требуется.

Обновление PayControl с версии 3 на версию 6

2025-03-19T14:22:25Z

D.bizyukov: /* Oracle */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== Postgre ===

<syntaxhighlight lang="sql">
alter table pc_delayedkeyinfo alter column is_deleted set not null;
alter table pc_delayedkeyinfo alter column is_deleted set default 0;
alter table pc_delayedkeyinfo drop column type;
alter table pc_delayedkeyinfo add column renew_challenge varchar(255);

alter table pc_device alter column is_deleted set not null;
alter table pc_device alter column is_deleted set default 0;
alter table pc_device add column app_id varchar(255);

alter table pc_event alter column is_deleted set not null;
alter table pc_event alter column is_deleted set default 0;
alter table pc_event alter column requester_ip type varchar(64);
alter table pc_event add column event_data text;
alter table pc_event drop column eventposturl;

alter table pc_keyinfo alter column is_deleted set not null;
alter table pc_keyinfo alter column is_deleted set default 0;
alter table pc_keyinfo drop column type;
alter table pc_keyinfo drop column key_container_id;
alter table pc_keyinfo add column external_approve_data_id varchar(255);

alter table pc_publickey alter column is_deleted set not null;
alter table pc_publickey alter column is_deleted set default 0;
alter table pc_publickey add column autosign_public_key bytea;

alter table pc_system alter column is_deleted set not null;
alter table pc_system alter column is_deleted set default 0;
alter table pc_system add column callback_url varchar(255);

alter table pc_system_params alter column is_deleted set not null;
alter table pc_system_params alter column is_deleted set default 0;
alter table pc_system_params alter column license type varchar(4096);
alter table pc_system_params add column qr_url_scheme varchar(24);

alter table pc_transaction alter column is_deleted set not null;
alter table pc_transaction alter column is_deleted set default 0;
alter table pc_transaction add column autosign_enabled int2;
alter table pc_transaction add column ext_pulp bytea;
alter table pc_transaction add column extended_check int2;
alter table pc_transaction add column render_type int4;
alter table pc_transaction add column scoring_settings varchar(1023);
alter table pc_transaction add column transaction_type int4;

alter table pc_user alter column is_deleted set not null;
alter table pc_user alter column is_deleted set default 0;
alter table pc_user add column blocked int2;

alter table pc_confirm_attempt add column scoring_results varchar(512);
alter table pc_confirm_attempt add column scoring_settings varchar(512);
</syntaxhighlight>

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_KEYINFO
DROP COLUMN type;

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_DELAYEDKEYINFO
DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

=== Oracle ===

<syntaxhighlight lang="sql">
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_delayedkeyinfo DROP COLUMN type;
ALTER TABLE pc_delayedkeyinfo ADD renew_challenge VARCHAR2(255);

ALTER TABLE pc_device MODIFY is_deleted NOT NULL;
ALTER TABLE pc_device MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_device ADD app_id VARCHAR2(255);

ALTER TABLE pc_event MODIFY is_deleted NOT NULL;
ALTER TABLE pc_event MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_event MODIFY requester_ip VARCHAR2(64);
ALTER TABLE pc_event ADD event_data CLOB;
ALTER TABLE pc_event DROP COLUMN eventposturl;

ALTER TABLE pc_keyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_keyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_keyinfo DROP COLUMN type;
ALTER TABLE pc_keyinfo DROP COLUMN key_container_id;
ALTER TABLE pc_keyinfo ADD external_approve_data_id VARCHAR2(255);

ALTER TABLE pc_publickey MODIFY is_deleted NOT NULL;
ALTER TABLE pc_publickey MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_publickey ADD autosign_public_key BLOB;

ALTER TABLE pc_system MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system ADD callback_url VARCHAR2(255);

ALTER TABLE pc_system_params MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system_params MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system_params MODIFY license VARCHAR2(4000);
ALTER TABLE pc_system_params ADD qr_url_scheme VARCHAR2(24);

ALTER TABLE pc_transaction MODIFY is_deleted NOT NULL;
ALTER TABLE pc_transaction MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_transaction ADD autosign_enabled NUMBER(5);
ALTER TABLE pc_transaction ADD ext_pulp BLOB;
ALTER TABLE pc_transaction ADD extended_check NUMBER(5);
ALTER TABLE pc_transaction ADD render_type NUMBER(10);
ALTER TABLE pc_transaction ADD scoring_settings VARCHAR2(1023);
ALTER TABLE pc_transaction ADD transaction_type NUMBER(10);
ALTER TABLE pc_transaction ADD snipped_text VARCHAR2(1023);

ALTER TABLE pc_user MODIFY is_deleted NOT NULL;
ALTER TABLE pc_user MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_user ADD blocked NUMBER(5);

ALTER TABLE pc_confirm_attempt ADD scoring_results VARCHAR2(512);
ALTER TABLE pc_confirm_attempt ADD scoring_settings VARCHAR2(512);

ALTER TABLE pc_sys_property MODIFY SETTING_VALUE VARCHAR2(1023);

</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения нового запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
update pc_keyinfo set is_activated=1;
update pc_transaction set transaction_type=0;
update pc_transaction set render_type=0;
</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-pc-ext-example.com:8081/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 3 на версию 6

2025-03-03T08:34:25Z

D.bizyukov:

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== Postgre ===

<syntaxhighlight lang="sql">
alter table pc_delayedkeyinfo alter column is_deleted set not null;
alter table pc_delayedkeyinfo alter column is_deleted set default 0;
alter table pc_delayedkeyinfo drop column type;
alter table pc_delayedkeyinfo add column renew_challenge varchar(255);

alter table pc_device alter column is_deleted set not null;
alter table pc_device alter column is_deleted set default 0;
alter table pc_device add column app_id varchar(255);

alter table pc_event alter column is_deleted set not null;
alter table pc_event alter column is_deleted set default 0;
alter table pc_event alter column requester_ip type varchar(64);
alter table pc_event add column event_data text;
alter table pc_event drop column eventposturl;

alter table pc_keyinfo alter column is_deleted set not null;
alter table pc_keyinfo alter column is_deleted set default 0;
alter table pc_keyinfo drop column type;
alter table pc_keyinfo drop column key_container_id;
alter table pc_keyinfo add column external_approve_data_id varchar(255);

alter table pc_publickey alter column is_deleted set not null;
alter table pc_publickey alter column is_deleted set default 0;
alter table pc_publickey add column autosign_public_key bytea;

alter table pc_system alter column is_deleted set not null;
alter table pc_system alter column is_deleted set default 0;
alter table pc_system add column callback_url varchar(255);

alter table pc_system_params alter column is_deleted set not null;
alter table pc_system_params alter column is_deleted set default 0;
alter table pc_system_params alter column license type varchar(4096);
alter table pc_system_params add column qr_url_scheme varchar(24);

alter table pc_transaction alter column is_deleted set not null;
alter table pc_transaction alter column is_deleted set default 0;
alter table pc_transaction add column autosign_enabled int2;
alter table pc_transaction add column ext_pulp bytea;
alter table pc_transaction add column extended_check int2;
alter table pc_transaction add column render_type int4;
alter table pc_transaction add column scoring_settings varchar(1023);
alter table pc_transaction add column transaction_type int4;

alter table pc_user alter column is_deleted set not null;
alter table pc_user alter column is_deleted set default 0;
alter table pc_user add column blocked int2;

alter table pc_confirm_attempt add column scoring_results varchar(512);
alter table pc_confirm_attempt add column scoring_settings varchar(512);
</syntaxhighlight>

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_KEYINFO
DROP COLUMN type;

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_DELAYEDKEYINFO
DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

=== Oracle ===

<syntaxhighlight lang="sql">
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_delayedkeyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_delayedkeyinfo DROP COLUMN type;
ALTER TABLE pc_delayedkeyinfo ADD renew_challenge VARCHAR2(255);

ALTER TABLE pc_device MODIFY is_deleted NOT NULL;
ALTER TABLE pc_device MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_device ADD app_id VARCHAR2(255);

ALTER TABLE pc_event MODIFY is_deleted NOT NULL;
ALTER TABLE pc_event MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_event MODIFY requester_ip VARCHAR2(64);
ALTER TABLE pc_event ADD event_data CLOB;
ALTER TABLE pc_event DROP COLUMN eventposturl;

ALTER TABLE pc_keyinfo MODIFY is_deleted NOT NULL;
ALTER TABLE pc_keyinfo MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_keyinfo DROP COLUMN type;
ALTER TABLE pc_keyinfo DROP COLUMN key_container_id;
ALTER TABLE pc_keyinfo ADD external_approve_data_id VARCHAR2(255);

ALTER TABLE pc_publickey MODIFY is_deleted NOT NULL;
ALTER TABLE pc_publickey MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_publickey ADD autosign_public_key BLOB;

ALTER TABLE pc_system MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system ADD callback_url VARCHAR2(255);

ALTER TABLE pc_system_params MODIFY is_deleted NOT NULL;
ALTER TABLE pc_system_params MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_system_params MODIFY license VARCHAR2(4000);
ALTER TABLE pc_system_params ADD qr_url_scheme VARCHAR2(24);

ALTER TABLE pc_transaction MODIFY is_deleted NOT NULL;
ALTER TABLE pc_transaction MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_transaction ADD autosign_enabled NUMBER(5);
ALTER TABLE pc_transaction ADD ext_pulp BLOB;
ALTER TABLE pc_transaction ADD extended_check NUMBER(5);
ALTER TABLE pc_transaction ADD render_type NUMBER(10);
ALTER TABLE pc_transaction ADD scoring_settings VARCHAR2(1023);
ALTER TABLE pc_transaction ADD transaction_type NUMBER(10);
ALTER TABLE pc_transaction ADD snipped_text VARCHAR2(1023);

ALTER TABLE pc_user MODIFY is_deleted NOT NULL;
ALTER TABLE pc_user MODIFY is_deleted DEFAULT 0;
ALTER TABLE pc_user ADD blocked NUMBER(5);

ALTER TABLE pc_confirm_attempt ADD scoring_results VARCHAR2(512);
ALTER TABLE pc_confirm_attempt ADD scoring_settings VARCHAR2(512);
</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения нового запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
update pc_keyinfo set is_activated=1;
update pc_transaction set transaction_type=0;
update pc_transaction set render_type=0;
</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-pc-ext-example.com:8081/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 3 на версию 6

2024-11-22T06:29:12Z

D.bizyukov: /* Обновление модулей PC */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== Postgre ===

<syntaxhighlight lang="sql">
alter table pc_delayedkeyinfo alter column is_deleted set not null;
alter table pc_delayedkeyinfo alter column is_deleted set default 0;
alter table pc_delayedkeyinfo drop column type;
alter table pc_delayedkeyinfo add column renew_challenge varchar(255);

alter table pc_device alter column is_deleted set not null;
alter table pc_device alter column is_deleted set default 0;
alter table pc_device add column app_id varchar(255);

alter table pc_event alter column is_deleted set not null;
alter table pc_event alter column is_deleted set default 0;
alter table pc_event alter column requester_ip type varchar(64);
alter table pc_event add column event_data text;
alter table pc_event drop column eventposturl;

alter table pc_keyinfo alter column is_deleted set not null;
alter table pc_keyinfo alter column is_deleted set default 0;
alter table pc_keyinfo drop column type;
alter table pc_keyinfo drop column key_container_id;
alter table pc_keyinfo add column external_approve_data_id varchar(255);

alter table pc_publickey alter column is_deleted set not null;
alter table pc_publickey alter column is_deleted set default 0;
alter table pc_publickey add column autosign_public_key bytea;

alter table pc_system alter column is_deleted set not null;
alter table pc_system alter column is_deleted set default 0;
alter table pc_system add column callback_url varchar(255);

alter table pc_system_params alter column is_deleted set not null;
alter table pc_system_params alter column is_deleted set default 0;
alter table pc_system_params alter column license type varchar(4096);
alter table pc_system_params add column qr_url_scheme varchar(24);

alter table pc_transaction alter column is_deleted set not null;
alter table pc_transaction alter column is_deleted set default 0;
alter table pc_transaction add column autosign_enabled int2;
alter table pc_transaction add column ext_pulp bytea;
alter table pc_transaction add column extended_check int2;
alter table pc_transaction add column render_type int4;
alter table pc_transaction add column scoring_settings varchar(1023);
alter table pc_transaction add column transaction_type int4;

alter table pc_user alter column is_deleted set not null;
alter table pc_user alter column is_deleted set default 0;
alter table pc_user add column blocked int2;

alter table pc_confirm_attempt add column scoring_results varchar(512);
alter table pc_confirm_attempt add column scoring_settings varchar(512);
</syntaxhighlight>

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_KEYINFO
DROP COLUMN type;

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_DELAYEDKEYINFO
DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения нового запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
update pc_keyinfo set is_activated=1;
update pc_transaction set transaction_type=0;
update pc_transaction set render_type=0;
</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-pc-ext-example.com:8081/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 3 на версию 6

2024-11-21T07:49:09Z

D.bizyukov:

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== Postgre ===

<syntaxhighlight lang="sql">
alter table pc_delayedkeyinfo alter column is_deleted set not null;
alter table pc_delayedkeyinfo alter column is_deleted set default 0;
alter table pc_delayedkeyinfo drop column type;
alter table pc_delayedkeyinfo add column renew_challenge varchar(255);

alter table pc_device alter column is_deleted set not null;
alter table pc_device alter column is_deleted set default 0;
alter table pc_device add column app_id varchar(255);

alter table pc_event alter column is_deleted set not null;
alter table pc_event alter column is_deleted set default 0;
alter table pc_event alter column requester_ip type varchar(64);
alter table pc_event add column event_data text;
alter table pc_event drop column eventposturl;

alter table pc_keyinfo alter column is_deleted set not null;
alter table pc_keyinfo alter column is_deleted set default 0;
alter table pc_keyinfo drop column type;
alter table pc_keyinfo drop column key_container_id;
alter table pc_keyinfo add column external_approve_data_id varchar(255);

alter table pc_publickey alter column is_deleted set not null;
alter table pc_publickey alter column is_deleted set default 0;
alter table pc_publickey add column autosign_public_key bytea;

alter table pc_system alter column is_deleted set not null;
alter table pc_system alter column is_deleted set default 0;
alter table pc_system add column callback_url varchar(255);

alter table pc_system_params alter column is_deleted set not null;
alter table pc_system_params alter column is_deleted set default 0;
alter table pc_system_params alter column license type varchar(4096);
alter table pc_system_params add column qr_url_scheme varchar(24);

alter table pc_transaction alter column is_deleted set not null;
alter table pc_transaction alter column is_deleted set default 0;
alter table pc_transaction add column autosign_enabled int2;
alter table pc_transaction add column ext_pulp bytea;
alter table pc_transaction add column extended_check int2;
alter table pc_transaction add column render_type int4;
alter table pc_transaction add column scoring_settings varchar(1023);
alter table pc_transaction add column transaction_type int4;

alter table pc_user alter column is_deleted set not null;
alter table pc_user alter column is_deleted set default 0;
alter table pc_user add column blocked int2;

alter table pc_confirm_attempt add column scoring_results varchar(512);
alter table pc_confirm_attempt add column scoring_settings varchar(512);
</syntaxhighlight>

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_KEYINFO
DROP COLUMN type;

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_DELAYEDKEYINFO
DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения нового запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
UPDATE PC_KEYINFO SET is_activated=1;
</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-pc-ext-example.com:8081/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 3 на версию 6

2024-11-17T22:41:32Z

D.bizyukov: /* Изменение адреса для внешних подключений (PCE) с мобильных устройств */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_KEYINFO
DROP COLUMN type;

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_DELAYEDKEYINFO
DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения нового запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
UPDATE PC_KEYINFO SET is_activated=1;
</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-pc-ext-example.com:8081/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 3 на версию 6

2024-11-15T14:53:54Z

D.bizyukov: /* MS SQL */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_KEYINFO
DROP COLUMN type;

IF EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'type'
)
ALTER TABLE PC_DELAYEDKEYINFO
DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения нового запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
UPDATE PC_KEYINFO SET is_activated=1;
</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-example.loc:8080/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 3 на версию 6

2024-11-15T14:51:46Z

D.bizyukov: /* Запрос на регистрацию и лицензия */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

ALTER TABLE PC_KEYINFO DROP COLUMN type;

ALTER TABLE PC_DELAYEDKEYINFO DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения нового запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
UPDATE PC_KEYINFO SET is_activated=1;
</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-example.loc:8080/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 3 на версию 6

2024-11-15T14:49:57Z

D.bizyukov: /* MS SQL */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

ALTER TABLE PC_KEYINFO DROP COLUMN type;

ALTER TABLE PC_DELAYEDKEYINFO DROP COLUMN type;

ALTER TABLE PC_EVENT ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения нового запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
UPDATE PC_KEYINFO SET is_activated=1;
</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-example.loc:8080/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 3 на версию 6

2024-11-15T14:28:39Z

D.bizyukov: /* Обновление модулей PC */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

alter table pc_event ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения нового запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly и выполнить запрос к БД:

<syntaxhighlight lang="sql">
UPDATE PC_KEYINFO SET is_activated=1;
</syntaxhighlight>

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера PCP, необходимо, предварительно указав корректные данные (протокол (HTTP/HTTPS), имя или IP сервера, порт, идентификатор системы), выполнить запрос к БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url = 'http[s]://<IP или DNS-имя>:8082/pc-pusher-api/' where systemid='<SYSTEMID>';</syntaxhighlight>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-example.loc:8080/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 3 на версию 6

2024-11-15T14:27:00Z

D.bizyukov: /* Корректировка (смена) адресов компонентов серверов PC */

Обновление PayControl с версии 3 на версию 6

2024-11-15T14:26:14Z

D.bizyukov: /* Корректировка (смена) адресов компонентов серверов PC */

Обновление PayControl с версии 3 на версию 6

2024-11-15T14:25:19Z

D.bizyukov: /* Откат обновления в случае сбоя */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

alter table pc_event ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения нового запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly.

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCS для подключения с PCE ===

На сервере PCE необходимо заменить часть строки с адресом сервера PCS (host и port заменить на реальные значения). Для этого:
* на Linux в файле ''<WF_PATH>/bin/standalone.conf'' нужно заменить <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3?wsdl -Duser.language=ru -Dpaycontrol.locale=ru"</syntaxhighlight> на строку <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpc_url=http://<host>:<port>/pc-api/ -Dpc_locale=ru"</syntaxhighlight>
* на Windows в файле ''<WF_PATH>/bin/standalone.conf.bat'' нужно заменить <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3?wsdl -Duser.language=ru -Dpaycontrol.locale=ru"</syntaxhighlight> выше метки :JAVA_OPTS_SET на строку <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpc_url=http://<host>:<port>/pc-api/ -Dpc_locale=ru"</syntaxhighlight>

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера 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>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-example.loc:8080/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly и включите автозапуск.

Обновление PayControl с версии 3 на версию 6

2024-11-15T14:23:14Z

D.bizyukov: /* Документация по работе с PC 6-й версии */

= Введение =

== Резервное копирование ==

Перед обновлением необходимо выполнить резервное копирование БД PCS и PCIS Internal.

= Обновление Java =

Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обновить Java до версии 17. Версия 11 больше не поддерживается.

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам.

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

<syntaxhighlight lang="shell">
sudo update-alternatives --config java
</syntaxhighlight>

== Изменение названий серверов ==

В версии 6 изменены названия серверов:

* PC Server (PCS) — без изменений;
* PC Interaction Internal — PC Pusher (PCP);
* PC Interaction External — PC External (PCE).

= Изменения в БД =

== Правки структуры таблиц БД PCS ==

Для обеспечения должного функционирования системы PC, в некоторые таблицы необходимо внести изменения, выполнив запросы:

=== MS SQL ===

<syntaxhighlight lang="sql">
IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'transaction_type'
)
ALTER TABLE PC_TRANSACTION
ADD
transaction_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_SYSTEM]')
AND name = 'callback_url'
)
ALTER TABLE PC_SYSTEM
ADD
callback_url character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_USER]')
AND name = 'blocked'
)
ALTER TABLE PC_USER
ADD
blocked smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_KEYINFO]')
AND name = 'external_approve_data_id'
)
ALTER TABLE PC_KEYINFO
ADD
external_approve_data_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_PUBLICKEY]')
AND name = 'autosign_public_key'
)
ALTER TABLE PC_PUBLICKEY
ADD
autosign_public_key varbinary(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DELAYEDKEYINFO]')
AND name = 'renew_challenge'
)
ALTER TABLE PC_DELAYEDKEYINFO
ADD
renew_challenge character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_DEVICE]')
AND name = 'app_id'
)
ALTER TABLE PC_DEVICE
ADD
app_id character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'autosign_enabled'
)
ALTER TABLE PC_TRANSACTION
ADD
autosign_enabled smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'ext_pulp'
)
ALTER TABLE PC_TRANSACTION
ADD
ext_pulp character varying(255);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'extended_check'
)
ALTER TABLE PC_TRANSACTION
ADD
extended_check smallint;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'render_type'
)
ALTER TABLE PC_TRANSACTION
ADD
render_type integer;

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_TRANSACTION]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_TRANSACTION
ADD
scoring_settings character varying(1023);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_results'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_results character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_CONFIRM_ATTEMPT]')
AND name = 'scoring_settings'
)
ALTER TABLE PC_CONFIRM_ATTEMPT
ADD
scoring_settings character varying(512);

IF NOT EXISTS(
SELECT *
FROM sys.columns
WHERE object_id = OBJECT_ID(N'[dbo].[PC_EVENT]')
AND name = 'event_data'
)
ALTER TABLE PC_EVENT
ADD
event_data VARCHAR(MAX);
ELSE
ALTER TABLE PC_EVENT
ALTER COLUMN event_data VARCHAR(MAX);

alter table pc_event ALTER COLUMN requester_ip varchar(64);
</syntaxhighlight>

== Запрос на регистрацию и лицензия ==

=== Получение нового запроса и лицензии ===

Для получения нового запроса на регистрацию и лицензии обратитесь в компанию Сэйфтек.

=== Замена запроса в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%REGISTERREQUEST%</code> на реальные данные запроса, созданного для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>eyJyZXF1ZXN0Ijp7InFyVVJMU2NoZW1lIjoiIiwiYmlsbGluZ1R5cGUiOjIsImludGVyYWN0aW9uRXh0ZXJuYWxVUkwiOiJodHRwczovL3BheWNvbnRyb2wuZXhhbXBsZS5jb20vcGMtY2xpZW50LWFwaS8iLCJpbnRlcmFjd----m1VRERpZndVU3VOS3BoYmV4emsifQ==</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%REGISTERREQUEST%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=== Замена лицензии(при наличии) в БД ===

В приведённом ниже запросе необходимо:

* заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
* заменить <code>%LICENSE%</code> на реальные данные лицензии, созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных запроса <code>{"request":{"systemId":"99000000-e00e-0ad0-00ab-f00f0000a0b0","dateTime":1700000000000,"usersCount":100,"licenseID":"0000e000-0000-0000-b0ec-c0f0000000f0","type":2,"features":{"gost_crypto":false,"pki":{"openssl":false},"binary_data":{"raw":true,"pdf":true},"server_signer":false,"rks":false}},"signature":"MEYCIQDy7OUT6iiligbiugYcpK9fjkU/GDRIUiJtB+UcHppVwIhAKzS+EcktxyRikvqEThPyo1jHlPuAfgxW+EEo5gioW7Y"}</code>

<syntaxhighlight lang="sql">
update pc_system_params set register_request='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

= Обновление модулей PC =

Перед обновлением настоятельно рекомендуем также выполнить резервное копирование баз данных PC.

Для установки PC 6-й версии воспользуйтесь инструкцией по ссылке - https://repo.paycontrol.org/server/doc/latest/pc-install-guide/ru/#перед-установкой

После обновления '''необходимо''' отключить автозапуск Wildfly.

== Корректировка (смена) адресов компонентов серверов PC ==

=== Изменение адреса PCS для подключения с PCE ===

На сервере PCE необходимо заменить часть строки с адресом сервера PCS (host и port заменить на реальные значения). Для этого:
* на Linux в файле ''<WF_PATH>/bin/standalone.conf'' нужно заменить <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3?wsdl -Duser.language=ru -Dpaycontrol.locale=ru"</syntaxhighlight> на строку <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpc_url=http://<host>:<port>/pc-api/ -Dpc_locale=ru"</syntaxhighlight>
* на Windows в файле ''<WF_PATH>/bin/standalone.conf.bat'' нужно заменить <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3?wsdl -Duser.language=ru -Dpaycontrol.locale=ru"</syntaxhighlight> выше метки :JAVA_OPTS_SET на строку <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpc_url=http://<host>:<port>/pc-api/ -Dpc_locale=ru"</syntaxhighlight>

=== Изменение адреса PCP для подключения с PCS ===

Для изменения адреса сервера 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>

=== Изменение адреса для внешних подключений (PCE) с мобильных устройств ===

Для изменения внешнего адреса сервера 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>

'''Для работы старых ключей''', обращающихся по эндпоинту <code>/PayControl-interaction-rest/</code> нужно установить проксирование на эндпоинт <code>/pc-client-api/</code>, любым удобным способом.

Пример для nginx:
<syntaxhighlight lang="bash">
location /PayControl-interaction-rest/ {
proxy_pass http://o-example.loc:8080/pc-client-api/;
}
</syntaxhighlight>

== Правки для корректной отправки пушей ==

<syntaxhighlight lang="sql">
update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=1;
!!!Запрос выше для Android при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='Android';

update pc_device set app_id ='org.example.app' where device_push_id not like '%####%' and app_id is null and type=2;
!!!Запрос выше для iOS при обновлении с 3.6-3.7. Вместо org.example.app нужно вписать app_id вашего приложения из БД PCIS Internal:
select appid from pc_split_pusher_credentials where os='iOS';

update pc_device set app_id = split_part(device_push_id,'####',2) where app_id is NULL;
update pc_device set device_push_id = split_part(device_push_id,'####',1) where app_id is not NULL;

!!! '''Обратите внимание''', что для выполнения запросов со split_part на Oracle нужно сначала выполнить запрос ниже:
create or replace function split_part(pString varchar2, pDelimiter varchar2, pPartNumber integer) return varchar2 deterministic is
vStart number;
vEnd number;
begin
if pPartNumber <> 0 and pDelimiter is not null then
vStart := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber));
vEnd := instr(pDelimiter||pString||pDelimiter, pDelimiter, sign(pPartNumber), abs(pPartNumber) + 1);
end if;
return case
when pDelimiter is null and abs(pPartNumber) = 1 then pString
when pPartNumber > 0 then substr(pString, vStart, vEnd - vStart - length(pDelimiter))
when pPartNumber < 0 then substr(pString, vEnd, vStart - vEnd - length(pDelimiter))
else null
end;
end;
/

</syntaxhighlight>

= Документация по работе с PC 6-й версии =

* Вся документация - https://repo.paycontrol.org/

* Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/

* Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/

== Доступ к сервисам ==

Адреса конечных точек по умолчанию:

* PC Server - http://<host>:8080/pc-api/
* PC Pusher - http://<host>:8082/pc-pusher-api/
* PC External - http://<host>:8081/pc-client-api/

=== Health Check ===

Адреса конечных точек health check:

* PC Server - http://<host>:8080/pc-api/health_check
* PC Pusher - http://<host>:8082/pc-pusher-api/health_check
* PC External - http://<host>:8081/pc-client-api/health_check

= Откат обновления в случае сбоя =

Остановите сервисы PC.

Восстановите БД PCS и PCIS Internal из бэкапа.

Переключитесь на Java 11.

Запустите wildfly.