PayControl Wiki - Вклад [ru]

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.

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

2024-11-15T14:22:54Z

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/

== Завершение обновления ==

После выполнения вышеизложенных пунктов нужно [[Руководство_администратора_PayControl_v5#Запуск и остановка служб сервера PayControl|запустить wildfly]].

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

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

* 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:22:42Z

D.bizyukov: /* Health Check */

= Введение =

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

Перед обновлением необходимо выполнить резервное копирование БД 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/

== Завершение обновления ==

После выполнения вышеизложенных пунктов нужно [[Руководство_администратора_PayControl_v5#Запуск и остановка служб сервера PayControl|запустить wildfly]].

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

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

* 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:22:28Z

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/

== Завершение обновления ==

После выполнения вышеизложенных пунктов нужно [[Руководство_администратора_PayControl_v5#Запуск и остановка служб сервера PayControl|запустить wildfly]].

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

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

* 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>:8080/pc-pusher-api/health_check
* PC External - http://<host>:8080/pc-client-api/health_check

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

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

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

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

Запустите wildfly.

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

2024-11-15T14:15:40Z

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/

== Завершение обновления ==

После выполнения вышеизложенных пунктов нужно [[Руководство_администратора_PayControl_v5#Запуск и остановка служб сервера PayControl|запустить wildfly]].

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

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

* 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>:8080/pc-pusher-api/health_check
* PC External - http://<host>:8080/pc-client-api/health_check

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

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

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

Запустите wildfly.

При замене файлов необходимо проверить, что в директории ''deployments'' отсутствуют файлы с расширением undeployed.

== PCS. Настройка подключения с PC External ==
На сервере PCIS\PC External необходимо заменить часть строки с адресом сервера PCS (host и port заменить на реальные значения). Для этого:
* на Linux в файле ''<WF_PATH>/bin/standalone.conf'' нужно заменить <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpc_url=http://<host>:<port>/pc-api/ -Dpc_locale=ru"</syntaxhighlight> на строку <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3?wsdl -Duser.language=ru -Dpaycontrol.locale=ru"</syntaxhighlight>
* на Windows в файле ''<WF_PATH>/bin/standalone.conf.bat'' нужно заменить <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpc_url=http://<host>:<port>/pc-api/ -Dpc_locale=ru"</syntaxhighlight> '''выше''' метки :JAVA_OPTS_SET на строку <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3?wsdl -Duser.language=ru -Dpaycontrol.locale=ru"</syntaxhighlight>

АРМ РКС PayControl v3

2024-11-07T21:08:52Z

D.bizyukov: /* Nginx */

АРМ РКС представляет из себя пользовательский Web-интерфейс, предоставляемый установленным в инфраструктуре заказчика Web-сервером с поддержкой исполнения PHP. Для получения запрашиваемой информации, Web-сервер АРМ РКС использует подключение к PCS через SOAP API, и подключение к БД PCS.
=Настройка подключения=
Для взаимодействия АРМ РКС необходимо установить Apache HTTP-сервер и PHP, в т.ч. модули php-soap и php-json.
==Подключение к БД==
Кроме того необходимо настроить подключение к БД с использованием PDO-драйверов:
===PostgreSQL===
Для начала нужно распаковать архив с файлами АРМ РКС в папку /var/www/html/.

Затем установить драйвер [[PostgreSQL]] для [[PHP]] и настроить подключение к БД с его помощью в конфигурационном файле.
<syntaxhighlight lang="bash">sudo apt install php-pgsql</syntaxhighlight>
====CentOS====
На CentOS необходимо установить '''PHP (last)''' + '''php-pgsql''' + '''php-pdo''' + '''php-fpm'''.

Также необходимо разрешить подключение для IP адреса этого сервера к БД PC Server (даже в случае, если АРМ РКС и СУБД располагаются на одном хосте) - файл ''postgresql.conf'', и добавить запись для разрешения аутентификации с этого IP - файл ''pg_hba.conf''. Подробнее - [[#Разрешение подключения с других хостов|Разрешение подключения с других хостов]].

Для проверки успешности подключения, можно проверить информацию о PHP (http://rks_host:port/rks/phpinfo.php), должны отображаться установленные PDO-драйверы:
<gallery>
php-pdo-pgsql.png|PHP Info при настроенных драйверах PostgreSQL
</gallery>

====ALT Linux====

1) Обновление сописка доcnупных пакетов
apt-get update

2) Установка необходимых пакетов (вместо '''?''' укажите номер версии php)

<syntaxhighlight lang="bash">apt-get install php? php?-fpm-fcgi php?-pdo_pgsql php?-pgsql php?-soap php?-pdo php?-xml</syntaxhighlight>

3) Настройте конфигурацию apache в файле ''/etc/httpd2/conf/httpd2.conf'', добавив строки

(проверьте, что путь и имя .sock файла соответствую вашей версии, и, что путь к файлам с АРМ РКС верен)

Пример:
<syntaxhighlight lang="bash">
# Подключение модуля proxy и proxy_fcgi для работы с php-fpm
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so

# Обработка PHP-файлов через php-fpm сокет
<FilesMatch \.php$>
SetHandler "proxy:unix:/var/run/php7-fpm/php7-fpm.sock|fcgi://localhost/"
</FilesMatch>

# Директория с PHP-файлами
<Directory "/var/www/html/rks/">
AllowOverride All
Require all granted
</Directory>
</syntaxhighlight>

Также необходимо разрешить подключение для IP адреса этого сервера к БД PC Server (даже в случае, если АРМ РКС и СУБД располагаются на одном хосте) - файл ''postgresql.conf'', и добавить запись для разрешения аутентификации с этого IP - файл ''pg_hba.conf''. Подробнее - [[#Разрешение подключения с других хостов|Разрешение подключения с других хостов]].

Для проверки успешности подключения, можно проверить информацию о PHP (http://rks_host:port/rks/phpinfo.php), должны отображаться установленные PDO-драйверы:
<gallery>
php-pdo-pgsql.png|PHP Info при настроенных драйверах PostgreSQL
</gallery>

[[#Конфигурирование подключения|Настройка подключения к БД PC Server]]
=====Разрешение подключения с других хостов=====
#Раскомментировать строку "listen_addresses = 'localhost'" в файле <syntaxhighlight lang="bash">sudo vi /var/lib/pgsql/data/postgresql.conf</syntaxhighlight> и перечислить через запятую список хостов или указать "*". Требуется перезапуск после изменения параметра.
#Добавить для нового хоста запись в <syntaxhighlight lang="bash">sudo vi /var/lib/pgsql/data/pg_hba.conf</syntaxhighlight> и указать требуемый тип аутентификации.

===Oracle===
====Ubuntu====
[https://rosemberg.net.br/en/installing-pdo-oracle-and-oci8-from-php7-on-ubuntumint-oracle-11-2/ Инструкция для настройки PHP + PDO + OCI8]

Проверено на Ubuntu 16.04 + php7.0.30 + apache2 + Oracle Instant Client 18.3
====Centos====
Для подключения к СУБД Oracle необходимо использовать PHP версии 7.x и установить Oracle-client. Подробное описание установки драйверов Oracle для PHP доступно по ссылке: https://www.codeproject.com/Articles/1231012/Installing-OCI-PHP-on-RHEL-or-CentOS.

Драйверы Oracle доступны по ссылке https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html

Пример выполнения команд по установке:
<syntaxhighlight lang="bash">sudo yum install epel-release yum-utils
sudo yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm
sudo yum-config-manager --enable remi-php73
sudo yum install php php-oci8 php-pdo php-soap
sudo yum install oracle-instantclient19.3-basic-19.3.0.0.0-1.x86_64.rpm oracle-instantclient19.3-devel-19.3.0.0.0-1.x86_64.rpm
sudo sh -c "echo /usr/lib/oracle/19.3/client64/lib > /etc/ld.so.conf.d/oracle-instantclient.conf"
sudo ldconfig
php -v
sudo systemctl restart httpd
</syntaxhighlight>
Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
php-oci.png|Установленный Oracle Call Interface (OCI) драйвер в PHP
php-pdo-oci.png|Подключённый OCI как PDO в PHP
</gallery>

Необходимо в [[SELinux]] предоставить Apache разрешение на установку сетевого подключение к СУБД Oracle:
<syntaxhighlight lang="bash">semanage port -m -t http_port_t -p tcp 1521</syntaxhighlight>
Также, для успешного подключения к HTTPD необходимо разрешить подключения к порту 80 или 443:
<syntaxhighlight lang="bash">sudo firewall-cmd --zone=public --add-service=http</syntaxhighlight>

===MS SQL===
Необходима установка драйвера dblib для PHP.
====Ubuntu====
Пример команды для установки драйвера для Ubuntu:
<syntaxhighlight lang="bash">sudo apt install php7.0-sybase</syntaxhighlight>
====CentOS 7====
Команда для предоставления доступа Apache на подключение к другим ресурсам:
<syntaxhighlight lang="bash">setsebool httpd_can_network_connect 1</syntaxhighlight>
<syntaxhighlight lang="bash">sudo yum install epel-release php-soap php-json
sudo yum install php-mssql
sudo systemctl restart httpd.service</syntaxhighlight>
При установке ''php-mssql'' должен автоматически установиться ''php-pdo''.

Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
Centos php-mssql.png|Установленный MSSQL драйвер в PHP
Файл:Centos pdo mssql.png|Подключённый MSSQL как PDO в PHP
</gallery>

====CentOS 8====
*Команда для предоставления доступа Apache на подключение к другим ресурсам:
<syntaxhighlight lang="bash">setsebool httpd_can_network_connect 1</syntaxhighlight>
*Установка PHP:
<syntaxhighlight lang="bash">
sudo su
dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install https://rpms.remirepo.net/enterprise/remi-release-8.rpm
dnf install yum-utils
dnf module reset php
dnf module install php:remi-7.2
subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms
dnf update
dnf install php php-pdo php-pear php-soap php-json php-fpm
</syntaxhighlight>
*Загрузка и установка драйвера Microsoft ODBC 17:
<syntaxhighlight lang="bash">
sudo curl https://packages.microsoft.com/config/rhel/8/prod.repo > /etc/yum.repos.d/mssql-release.repo
sudo yum remove unixODBC-utf16 unixODBC-utf16-devel #to avoid conflicts
sudo ACCEPT_EULA=Y yum install msodbcsql17
</syntaxhighlight>
*Установка драйверов PHP для Microsoft SQL Server
<syntaxhighlight lang="bash">
sudo yum install php-sqlsrv
</syntaxhighlight>
Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
Centos php-mssql.png|Установленный MSSQL драйвер в PHP
Файл:Centos pdo mssql.png|Подключённый MSSQL как PDO в PHP
</gallery>

====MS Windows====
=====Развёртывание Apache и PHP=====
* Скачать Apache, распаковать, например в ''c:\Apache24'';
* Скачать PHP 7, распаковать, например в ''c:\php'';
* Подключить PHP в Apache (файл ''c:\Apache24\conf\httpd.conf''):<syntaxhighlight lang="bash">
LoadModule php7_module c:/php/php7apache2_4.dll
<IfModule dir_module>
DirectoryIndex index.html index.htm index.php
</IfModule>
AddType application/x-httpd-php .php
AddHandler application/x-httpd-php .php
PHPiniDir "c:/php"
</syntaxhighlight>
* Включить поддержку SOAP API в PHP (файл ''c:\php\php.ini''):<syntaxhighlight lang="bash">
extension=soap
</syntaxhighlight>
* Добавить PDO SQL (pdo_sqlsrv) драйвер в PHP. Для этого:
** Скачать драйвер Microsoft Drivers 5.6 for PHP for SQL Server (или свежее) с https://www.microsoft.com/en-us/download/details.aspx?id=57916 (при выпуске более свежей версии драйвера, возможно ссылка на него будет новая)
** Распаковать в ''c:\php\ext''
** Сконфигурировать в ''c:\php\php.ini'':<syntaxhighlight lang="bash">
extension=php_pdo_sqlsrv_73_ts_x64
extension=php_sqlsrv_73_ts_x64.dll
</syntaxhighlight>
* Скачать и установить ODBC-драйвер https://docs.microsoft.com/ru-ru/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-2017
* Распаковать файлы АРМ РКС в ''c:\Apache24\htdocs'';
* Установить службу <syntaxhighlight lang="bat">c:\Apache24\bin\httpd.exe -k install</syntaxhighlight> при этом она будет автоматически запущена и будет включён автозапуск.

==Конфигурирование подключения==
===Конфигурирование===
Для подключения необходимо создать копию файла ''config.php.DEFAULT'' с именем ''config.php''. В новом файле:
* указать адрес WSDL-схемы [[Вызов методов SOAP интерфейса|SOAP-интерфейса]] [[Сервер PayControl|сервера PCS]] (имеет вид ''http://pctest.local:8080/ws/PayControlServiceV3?wsdl'');
* указать идентификатор [[Прикладная система|прикладной системы]] (systemid);
* раскомментировать блок с параметрами подключения к соответствующей СУБД. Указать в переменных окружения параметры для подключения БД PCS.
====Конфигурирование с переменными окружения Linux====
Для подключения необходимо создать копию файла ''config.php.ENVIRONMENTS'' с именем ''config.php''. В новом файле:
* указать адрес WSDL-схемы [[Вызов методов SOAP интерфейса|SOAP-интерфейса]] [[Сервер PayControl|сервера PCS]] (имеет вид ''http://pctest.local:8080/ws/PayControlServiceV3?wsdl'');
* указать идентификатор [[Прикладная система|прикладной системы]] (systemid);
* раскомментировать блок с параметрами подключения к соответствующей СУБД. Указать в переменных окружения параметры для подключения БД PCS.
=====Apache=====
* разрешить чтение из переменных окружения, включив модуль mod_env.so с помощью - '''sudo a2enmod env'''
* добавить в конфиг Apache ''/etc/httpd2/conf/httpd2.conf'' перечень переменных, которые нужно забирать:
<syntaxhighlight lang="unixconfig">
<IfModule mod_env.c>
PassEnv PC_CRT_DB_USERNAME
PassEnv PC_CRT_DB_PASSWORD
PassEnv PC_CRT_DB_CONNSTRING
</IfModule>
</syntaxhighlight>
=====Nginx=====
* добавить в конфиг Nginx ''/etc/nginx/sites-available/your-site-config'' перечень переменных, которые передавать PC_CRT_DB_CONNSTRING, PC_CRT_DB_USERNAME, PC_CRT_DB_PASSWORD.
Пример:
<syntaxhighlight lang="unixconfig">
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; #убедитесь, что версия php указана верно и верен путь до файла *-fpm.sock
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_param PC_CRT_DB_CONNSTRING "pgsql:host=yourdbhost;port=5432;dbname=yourdbname";
fastcgi_param PC_CRT_DB_USERNAME "yourdbuser";
fastcgi_param PC_CRT_DB_PASSWORD "yourdbpass";
}
</syntaxhighlight>

=Системные требования=
Требования указаны без учёта системных требований ОС.
==Минимальные==
* ЦП: одно ядро;
* ОЗУ: 100 MB;
* Дисковое пространство: 150 MB.
==Рекомендуемые==
* ЦП: одно ядро;
* ОЗУ: 512 MB;
* Дисковое пространство: 1 GB.

[[Категория:Серверная часть]]
[[Категория:Пользовательский интерфейс]]
[[Категория:Руководства]]
[[Категория:Документация]]
[[Категория:Инсталляция]]

АРМ РКС PayControl v3

2024-11-07T21:07:44Z

D.bizyukov: /* Конфигурирование подключения */

АРМ РКС представляет из себя пользовательский Web-интерфейс, предоставляемый установленным в инфраструктуре заказчика Web-сервером с поддержкой исполнения PHP. Для получения запрашиваемой информации, Web-сервер АРМ РКС использует подключение к PCS через SOAP API, и подключение к БД PCS.
=Настройка подключения=
Для взаимодействия АРМ РКС необходимо установить Apache HTTP-сервер и PHP, в т.ч. модули php-soap и php-json.
==Подключение к БД==
Кроме того необходимо настроить подключение к БД с использованием PDO-драйверов:
===PostgreSQL===
Для начала нужно распаковать архив с файлами АРМ РКС в папку /var/www/html/.

Затем установить драйвер [[PostgreSQL]] для [[PHP]] и настроить подключение к БД с его помощью в конфигурационном файле.
<syntaxhighlight lang="bash">sudo apt install php-pgsql</syntaxhighlight>
====CentOS====
На CentOS необходимо установить '''PHP (last)''' + '''php-pgsql''' + '''php-pdo''' + '''php-fpm'''.

Также необходимо разрешить подключение для IP адреса этого сервера к БД PC Server (даже в случае, если АРМ РКС и СУБД располагаются на одном хосте) - файл ''postgresql.conf'', и добавить запись для разрешения аутентификации с этого IP - файл ''pg_hba.conf''. Подробнее - [[#Разрешение подключения с других хостов|Разрешение подключения с других хостов]].

Для проверки успешности подключения, можно проверить информацию о PHP (http://rks_host:port/rks/phpinfo.php), должны отображаться установленные PDO-драйверы:
<gallery>
php-pdo-pgsql.png|PHP Info при настроенных драйверах PostgreSQL
</gallery>

====ALT Linux====

1) Обновление сописка доcnупных пакетов
apt-get update

2) Установка необходимых пакетов (вместо '''?''' укажите номер версии php)

<syntaxhighlight lang="bash">apt-get install php? php?-fpm-fcgi php?-pdo_pgsql php?-pgsql php?-soap php?-pdo php?-xml</syntaxhighlight>

3) Настройте конфигурацию apache в файле ''/etc/httpd2/conf/httpd2.conf'', добавив строки

(проверьте, что путь и имя .sock файла соответствую вашей версии, и, что путь к файлам с АРМ РКС верен)

Пример:
<syntaxhighlight lang="bash">
# Подключение модуля proxy и proxy_fcgi для работы с php-fpm
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so

# Обработка PHP-файлов через php-fpm сокет
<FilesMatch \.php$>
SetHandler "proxy:unix:/var/run/php7-fpm/php7-fpm.sock|fcgi://localhost/"
</FilesMatch>

# Директория с PHP-файлами
<Directory "/var/www/html/rks/">
AllowOverride All
Require all granted
</Directory>
</syntaxhighlight>

Также необходимо разрешить подключение для IP адреса этого сервера к БД PC Server (даже в случае, если АРМ РКС и СУБД располагаются на одном хосте) - файл ''postgresql.conf'', и добавить запись для разрешения аутентификации с этого IP - файл ''pg_hba.conf''. Подробнее - [[#Разрешение подключения с других хостов|Разрешение подключения с других хостов]].

Для проверки успешности подключения, можно проверить информацию о PHP (http://rks_host:port/rks/phpinfo.php), должны отображаться установленные PDO-драйверы:
<gallery>
php-pdo-pgsql.png|PHP Info при настроенных драйверах PostgreSQL
</gallery>

[[#Конфигурирование подключения|Настройка подключения к БД PC Server]]
=====Разрешение подключения с других хостов=====
#Раскомментировать строку "listen_addresses = 'localhost'" в файле <syntaxhighlight lang="bash">sudo vi /var/lib/pgsql/data/postgresql.conf</syntaxhighlight> и перечислить через запятую список хостов или указать "*". Требуется перезапуск после изменения параметра.
#Добавить для нового хоста запись в <syntaxhighlight lang="bash">sudo vi /var/lib/pgsql/data/pg_hba.conf</syntaxhighlight> и указать требуемый тип аутентификации.

===Oracle===
====Ubuntu====
[https://rosemberg.net.br/en/installing-pdo-oracle-and-oci8-from-php7-on-ubuntumint-oracle-11-2/ Инструкция для настройки PHP + PDO + OCI8]

Проверено на Ubuntu 16.04 + php7.0.30 + apache2 + Oracle Instant Client 18.3
====Centos====
Для подключения к СУБД Oracle необходимо использовать PHP версии 7.x и установить Oracle-client. Подробное описание установки драйверов Oracle для PHP доступно по ссылке: https://www.codeproject.com/Articles/1231012/Installing-OCI-PHP-on-RHEL-or-CentOS.

Драйверы Oracle доступны по ссылке https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html

Пример выполнения команд по установке:
<syntaxhighlight lang="bash">sudo yum install epel-release yum-utils
sudo yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm
sudo yum-config-manager --enable remi-php73
sudo yum install php php-oci8 php-pdo php-soap
sudo yum install oracle-instantclient19.3-basic-19.3.0.0.0-1.x86_64.rpm oracle-instantclient19.3-devel-19.3.0.0.0-1.x86_64.rpm
sudo sh -c "echo /usr/lib/oracle/19.3/client64/lib > /etc/ld.so.conf.d/oracle-instantclient.conf"
sudo ldconfig
php -v
sudo systemctl restart httpd
</syntaxhighlight>
Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
php-oci.png|Установленный Oracle Call Interface (OCI) драйвер в PHP
php-pdo-oci.png|Подключённый OCI как PDO в PHP
</gallery>

Необходимо в [[SELinux]] предоставить Apache разрешение на установку сетевого подключение к СУБД Oracle:
<syntaxhighlight lang="bash">semanage port -m -t http_port_t -p tcp 1521</syntaxhighlight>
Также, для успешного подключения к HTTPD необходимо разрешить подключения к порту 80 или 443:
<syntaxhighlight lang="bash">sudo firewall-cmd --zone=public --add-service=http</syntaxhighlight>

===MS SQL===
Необходима установка драйвера dblib для PHP.
====Ubuntu====
Пример команды для установки драйвера для Ubuntu:
<syntaxhighlight lang="bash">sudo apt install php7.0-sybase</syntaxhighlight>
====CentOS 7====
Команда для предоставления доступа Apache на подключение к другим ресурсам:
<syntaxhighlight lang="bash">setsebool httpd_can_network_connect 1</syntaxhighlight>
<syntaxhighlight lang="bash">sudo yum install epel-release php-soap php-json
sudo yum install php-mssql
sudo systemctl restart httpd.service</syntaxhighlight>
При установке ''php-mssql'' должен автоматически установиться ''php-pdo''.

Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
Centos php-mssql.png|Установленный MSSQL драйвер в PHP
Файл:Centos pdo mssql.png|Подключённый MSSQL как PDO в PHP
</gallery>

====CentOS 8====
*Команда для предоставления доступа Apache на подключение к другим ресурсам:
<syntaxhighlight lang="bash">setsebool httpd_can_network_connect 1</syntaxhighlight>
*Установка PHP:
<syntaxhighlight lang="bash">
sudo su
dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install https://rpms.remirepo.net/enterprise/remi-release-8.rpm
dnf install yum-utils
dnf module reset php
dnf module install php:remi-7.2
subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms
dnf update
dnf install php php-pdo php-pear php-soap php-json php-fpm
</syntaxhighlight>
*Загрузка и установка драйвера Microsoft ODBC 17:
<syntaxhighlight lang="bash">
sudo curl https://packages.microsoft.com/config/rhel/8/prod.repo > /etc/yum.repos.d/mssql-release.repo
sudo yum remove unixODBC-utf16 unixODBC-utf16-devel #to avoid conflicts
sudo ACCEPT_EULA=Y yum install msodbcsql17
</syntaxhighlight>
*Установка драйверов PHP для Microsoft SQL Server
<syntaxhighlight lang="bash">
sudo yum install php-sqlsrv
</syntaxhighlight>
Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
Centos php-mssql.png|Установленный MSSQL драйвер в PHP
Файл:Centos pdo mssql.png|Подключённый MSSQL как PDO в PHP
</gallery>

====MS Windows====
=====Развёртывание Apache и PHP=====
* Скачать Apache, распаковать, например в ''c:\Apache24'';
* Скачать PHP 7, распаковать, например в ''c:\php'';
* Подключить PHP в Apache (файл ''c:\Apache24\conf\httpd.conf''):<syntaxhighlight lang="bash">
LoadModule php7_module c:/php/php7apache2_4.dll
<IfModule dir_module>
DirectoryIndex index.html index.htm index.php
</IfModule>
AddType application/x-httpd-php .php
AddHandler application/x-httpd-php .php
PHPiniDir "c:/php"
</syntaxhighlight>
* Включить поддержку SOAP API в PHP (файл ''c:\php\php.ini''):<syntaxhighlight lang="bash">
extension=soap
</syntaxhighlight>
* Добавить PDO SQL (pdo_sqlsrv) драйвер в PHP. Для этого:
** Скачать драйвер Microsoft Drivers 5.6 for PHP for SQL Server (или свежее) с https://www.microsoft.com/en-us/download/details.aspx?id=57916 (при выпуске более свежей версии драйвера, возможно ссылка на него будет новая)
** Распаковать в ''c:\php\ext''
** Сконфигурировать в ''c:\php\php.ini'':<syntaxhighlight lang="bash">
extension=php_pdo_sqlsrv_73_ts_x64
extension=php_sqlsrv_73_ts_x64.dll
</syntaxhighlight>
* Скачать и установить ODBC-драйвер https://docs.microsoft.com/ru-ru/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-2017
* Распаковать файлы АРМ РКС в ''c:\Apache24\htdocs'';
* Установить службу <syntaxhighlight lang="bat">c:\Apache24\bin\httpd.exe -k install</syntaxhighlight> при этом она будет автоматически запущена и будет включён автозапуск.

==Конфигурирование подключения==
===Конфигурирование===
Для подключения необходимо создать копию файла ''config.php.DEFAULT'' с именем ''config.php''. В новом файле:
* указать адрес WSDL-схемы [[Вызов методов SOAP интерфейса|SOAP-интерфейса]] [[Сервер PayControl|сервера PCS]] (имеет вид ''http://pctest.local:8080/ws/PayControlServiceV3?wsdl'');
* указать идентификатор [[Прикладная система|прикладной системы]] (systemid);
* раскомментировать блок с параметрами подключения к соответствующей СУБД. Указать в переменных окружения параметры для подключения БД PCS.
====Конфигурирование с переменными окружения Linux====
Для подключения необходимо создать копию файла ''config.php.ENVIRONMENTS'' с именем ''config.php''. В новом файле:
* указать адрес WSDL-схемы [[Вызов методов SOAP интерфейса|SOAP-интерфейса]] [[Сервер PayControl|сервера PCS]] (имеет вид ''http://pctest.local:8080/ws/PayControlServiceV3?wsdl'');
* указать идентификатор [[Прикладная система|прикладной системы]] (systemid);
* раскомментировать блок с параметрами подключения к соответствующей СУБД. Указать в переменных окружения параметры для подключения БД PCS.
=====Apache=====
* разрешить чтение из переменных окружения, включив модуль mod_env.so с помощью - '''sudo a2enmod env'''
* добавить в конфиг Apache ''/etc/httpd2/conf/httpd2.conf'' перечень переменных, которые нужно забирать:
<syntaxhighlight lang="unixconfig">
<IfModule mod_env.c>
PassEnv PC_CRT_DB_USERNAME
PassEnv PC_CRT_DB_PASSWORD
PassEnv PC_CRT_DB_CONNSTRING
</IfModule>
</syntaxhighlight>
=====Nginx=====
* добавить в конфиг Nginx ''/etc/nginx/sites-available/your-site-config'' перечень переменных, которые передавать.
Пример:
<syntaxhighlight lang="unixconfig">
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; #убедитесь, что версия php указана верно и верен путь до файла *-fpm.sock
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_param PC_CRT_DB_CONNSTRING "pgsql:host=yourdbhost;port=5432;dbname=yourdbname";
fastcgi_param PC_CRT_DB_USERNAME "yourdbuser";
fastcgi_param PC_CRT_DB_PASSWORD "yourdbpass";
}
</syntaxhighlight>

=Системные требования=
Требования указаны без учёта системных требований ОС.
==Минимальные==
* ЦП: одно ядро;
* ОЗУ: 100 MB;
* Дисковое пространство: 150 MB.
==Рекомендуемые==
* ЦП: одно ядро;
* ОЗУ: 512 MB;
* Дисковое пространство: 1 GB.

[[Категория:Серверная часть]]
[[Категория:Пользовательский интерфейс]]
[[Категория:Руководства]]
[[Категория:Документация]]
[[Категория:Инсталляция]]

АРМ РКС PayControl v3

2024-11-07T21:00:31Z

D.bizyukov: /* Конфигурирование */

АРМ РКС представляет из себя пользовательский Web-интерфейс, предоставляемый установленным в инфраструктуре заказчика Web-сервером с поддержкой исполнения PHP. Для получения запрашиваемой информации, Web-сервер АРМ РКС использует подключение к PCS через SOAP API, и подключение к БД PCS.
=Настройка подключения=
Для взаимодействия АРМ РКС необходимо установить Apache HTTP-сервер и PHP, в т.ч. модули php-soap и php-json.
==Подключение к БД==
Кроме того необходимо настроить подключение к БД с использованием PDO-драйверов:
===PostgreSQL===
Для начала нужно распаковать архив с файлами АРМ РКС в папку /var/www/html/.

Затем установить драйвер [[PostgreSQL]] для [[PHP]] и настроить подключение к БД с его помощью в конфигурационном файле.
<syntaxhighlight lang="bash">sudo apt install php-pgsql</syntaxhighlight>
====CentOS====
На CentOS необходимо установить '''PHP (last)''' + '''php-pgsql''' + '''php-pdo''' + '''php-fpm'''.

Также необходимо разрешить подключение для IP адреса этого сервера к БД PC Server (даже в случае, если АРМ РКС и СУБД располагаются на одном хосте) - файл ''postgresql.conf'', и добавить запись для разрешения аутентификации с этого IP - файл ''pg_hba.conf''. Подробнее - [[#Разрешение подключения с других хостов|Разрешение подключения с других хостов]].

Для проверки успешности подключения, можно проверить информацию о PHP (http://rks_host:port/rks/phpinfo.php), должны отображаться установленные PDO-драйверы:
<gallery>
php-pdo-pgsql.png|PHP Info при настроенных драйверах PostgreSQL
</gallery>

====ALT Linux====

1) Обновление сописка доcnупных пакетов
apt-get update

2) Установка необходимых пакетов (вместо '''?''' укажите номер версии php)

<syntaxhighlight lang="bash">apt-get install php? php?-fpm-fcgi php?-pdo_pgsql php?-pgsql php?-soap php?-pdo php?-xml</syntaxhighlight>

3) Настройте конфигурацию apache в файле ''/etc/httpd2/conf/httpd2.conf'', добавив строки

(проверьте, что путь и имя .sock файла соответствую вашей версии, и, что путь к файлам с АРМ РКС верен)

Пример:
<syntaxhighlight lang="bash">
# Подключение модуля proxy и proxy_fcgi для работы с php-fpm
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so

# Обработка PHP-файлов через php-fpm сокет
<FilesMatch \.php$>
SetHandler "proxy:unix:/var/run/php7-fpm/php7-fpm.sock|fcgi://localhost/"
</FilesMatch>

# Директория с PHP-файлами
<Directory "/var/www/html/rks/">
AllowOverride All
Require all granted
</Directory>
</syntaxhighlight>

Также необходимо разрешить подключение для IP адреса этого сервера к БД PC Server (даже в случае, если АРМ РКС и СУБД располагаются на одном хосте) - файл ''postgresql.conf'', и добавить запись для разрешения аутентификации с этого IP - файл ''pg_hba.conf''. Подробнее - [[#Разрешение подключения с других хостов|Разрешение подключения с других хостов]].

Для проверки успешности подключения, можно проверить информацию о PHP (http://rks_host:port/rks/phpinfo.php), должны отображаться установленные PDO-драйверы:
<gallery>
php-pdo-pgsql.png|PHP Info при настроенных драйверах PostgreSQL
</gallery>

[[#Конфигурирование подключения|Настройка подключения к БД PC Server]]
=====Разрешение подключения с других хостов=====
#Раскомментировать строку "listen_addresses = 'localhost'" в файле <syntaxhighlight lang="bash">sudo vi /var/lib/pgsql/data/postgresql.conf</syntaxhighlight> и перечислить через запятую список хостов или указать "*". Требуется перезапуск после изменения параметра.
#Добавить для нового хоста запись в <syntaxhighlight lang="bash">sudo vi /var/lib/pgsql/data/pg_hba.conf</syntaxhighlight> и указать требуемый тип аутентификации.

===Oracle===
====Ubuntu====
[https://rosemberg.net.br/en/installing-pdo-oracle-and-oci8-from-php7-on-ubuntumint-oracle-11-2/ Инструкция для настройки PHP + PDO + OCI8]

Проверено на Ubuntu 16.04 + php7.0.30 + apache2 + Oracle Instant Client 18.3
====Centos====
Для подключения к СУБД Oracle необходимо использовать PHP версии 7.x и установить Oracle-client. Подробное описание установки драйверов Oracle для PHP доступно по ссылке: https://www.codeproject.com/Articles/1231012/Installing-OCI-PHP-on-RHEL-or-CentOS.

Драйверы Oracle доступны по ссылке https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html

Пример выполнения команд по установке:
<syntaxhighlight lang="bash">sudo yum install epel-release yum-utils
sudo yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm
sudo yum-config-manager --enable remi-php73
sudo yum install php php-oci8 php-pdo php-soap
sudo yum install oracle-instantclient19.3-basic-19.3.0.0.0-1.x86_64.rpm oracle-instantclient19.3-devel-19.3.0.0.0-1.x86_64.rpm
sudo sh -c "echo /usr/lib/oracle/19.3/client64/lib > /etc/ld.so.conf.d/oracle-instantclient.conf"
sudo ldconfig
php -v
sudo systemctl restart httpd
</syntaxhighlight>
Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
php-oci.png|Установленный Oracle Call Interface (OCI) драйвер в PHP
php-pdo-oci.png|Подключённый OCI как PDO в PHP
</gallery>

Необходимо в [[SELinux]] предоставить Apache разрешение на установку сетевого подключение к СУБД Oracle:
<syntaxhighlight lang="bash">semanage port -m -t http_port_t -p tcp 1521</syntaxhighlight>
Также, для успешного подключения к HTTPD необходимо разрешить подключения к порту 80 или 443:
<syntaxhighlight lang="bash">sudo firewall-cmd --zone=public --add-service=http</syntaxhighlight>

===MS SQL===
Необходима установка драйвера dblib для PHP.
====Ubuntu====
Пример команды для установки драйвера для Ubuntu:
<syntaxhighlight lang="bash">sudo apt install php7.0-sybase</syntaxhighlight>
====CentOS 7====
Команда для предоставления доступа Apache на подключение к другим ресурсам:
<syntaxhighlight lang="bash">setsebool httpd_can_network_connect 1</syntaxhighlight>
<syntaxhighlight lang="bash">sudo yum install epel-release php-soap php-json
sudo yum install php-mssql
sudo systemctl restart httpd.service</syntaxhighlight>
При установке ''php-mssql'' должен автоматически установиться ''php-pdo''.

Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
Centos php-mssql.png|Установленный MSSQL драйвер в PHP
Файл:Centos pdo mssql.png|Подключённый MSSQL как PDO в PHP
</gallery>

====CentOS 8====
*Команда для предоставления доступа Apache на подключение к другим ресурсам:
<syntaxhighlight lang="bash">setsebool httpd_can_network_connect 1</syntaxhighlight>
*Установка PHP:
<syntaxhighlight lang="bash">
sudo su
dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install https://rpms.remirepo.net/enterprise/remi-release-8.rpm
dnf install yum-utils
dnf module reset php
dnf module install php:remi-7.2
subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms
dnf update
dnf install php php-pdo php-pear php-soap php-json php-fpm
</syntaxhighlight>
*Загрузка и установка драйвера Microsoft ODBC 17:
<syntaxhighlight lang="bash">
sudo curl https://packages.microsoft.com/config/rhel/8/prod.repo > /etc/yum.repos.d/mssql-release.repo
sudo yum remove unixODBC-utf16 unixODBC-utf16-devel #to avoid conflicts
sudo ACCEPT_EULA=Y yum install msodbcsql17
</syntaxhighlight>
*Установка драйверов PHP для Microsoft SQL Server
<syntaxhighlight lang="bash">
sudo yum install php-sqlsrv
</syntaxhighlight>
Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
Centos php-mssql.png|Установленный MSSQL драйвер в PHP
Файл:Centos pdo mssql.png|Подключённый MSSQL как PDO в PHP
</gallery>

====MS Windows====
=====Развёртывание Apache и PHP=====
* Скачать Apache, распаковать, например в ''c:\Apache24'';
* Скачать PHP 7, распаковать, например в ''c:\php'';
* Подключить PHP в Apache (файл ''c:\Apache24\conf\httpd.conf''):<syntaxhighlight lang="bash">
LoadModule php7_module c:/php/php7apache2_4.dll
<IfModule dir_module>
DirectoryIndex index.html index.htm index.php
</IfModule>
AddType application/x-httpd-php .php
AddHandler application/x-httpd-php .php
PHPiniDir "c:/php"
</syntaxhighlight>
* Включить поддержку SOAP API в PHP (файл ''c:\php\php.ini''):<syntaxhighlight lang="bash">
extension=soap
</syntaxhighlight>
* Добавить PDO SQL (pdo_sqlsrv) драйвер в PHP. Для этого:
** Скачать драйвер Microsoft Drivers 5.6 for PHP for SQL Server (или свежее) с https://www.microsoft.com/en-us/download/details.aspx?id=57916 (при выпуске более свежей версии драйвера, возможно ссылка на него будет новая)
** Распаковать в ''c:\php\ext''
** Сконфигурировать в ''c:\php\php.ini'':<syntaxhighlight lang="bash">
extension=php_pdo_sqlsrv_73_ts_x64
extension=php_sqlsrv_73_ts_x64.dll
</syntaxhighlight>
* Скачать и установить ODBC-драйвер https://docs.microsoft.com/ru-ru/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-2017
* Распаковать файлы АРМ РКС в ''c:\Apache24\htdocs'';
* Установить службу <syntaxhighlight lang="bat">c:\Apache24\bin\httpd.exe -k install</syntaxhighlight> при этом она будет автоматически запущена и будет включён автозапуск.

==Конфигурирование подключения==
===Linux===
Для удобства настройки, можно предоставить группе pc_admins доступ на запись в директорию web-сервера:<syntaxhighlight lang="bash">chown -Rv :pc_admins /var/www/html/
chmod -Rv g+w /var/www/html/</syntaxhighlight>
===Конфигурирование===
Для подключения необходимо создать копию файла ''config.php.DEFAULT'' с именем ''config.php''. В новом файле:
* указать адрес WSDL-схемы [[Вызов методов SOAP интерфейса|SOAP-интерфейса]] [[Сервер PayControl|сервера PCS]] (имеет вид ''http://pctest.local:8080/ws/PayControlServiceV3?wsdl'');
* указать идентификатор [[Прикладная система|прикладной системы]] (systemid);
* раскомментировать блок с параметрами подключения к соответствующей СУБД. Указать в переменных окружения параметры для подключения БД PCS.
====Конфигурирование с переменными окружения====
Для подключения необходимо создать копию файла ''config.php.ENVIRONMENTS'' с именем ''config.php''. В новом файле:
* указать адрес WSDL-схемы [[Вызов методов SOAP интерфейса|SOAP-интерфейса]] [[Сервер PayControl|сервера PCS]] (имеет вид ''http://pctest.local:8080/ws/PayControlServiceV3?wsdl'');
* указать идентификатор [[Прикладная система|прикладной системы]] (systemid);
* раскомментировать блок с параметрами подключения к соответствующей СУБД. Указать в переменных окружения параметры для подключения БД PCS.
=====Apache=====
* разрешить чтение из переменных окружения, включив модуль mod_env.so с помощью - '''sudo a2enmod env'''
* добавить в конфиг Apache ''/etc/httpd2/conf/httpd2.conf'' перечень переменных, которые нужно забирать:
<syntaxhighlight lang="unixconfig">
<IfModule mod_env.c>
PassEnv PC_CRT_DB_USERNAME
PassEnv PC_CRT_DB_PASSWORD
PassEnv PC_CRT_DB_CONNSTRING
</IfModule>
</syntaxhighlight>
=====Nginx=====
* добавить в конфиг Nginx ''/etc/nginx/sites-available/your-site-config'' перечень переменных, которые передавать.
Пример:
<syntaxhighlight lang="unixconfig">
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; #убедитесь, что версия php указана верно и верен путь до файла *-fpm.sock
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_param PC_CRT_DB_CONNSTRING "pgsql:host=yourdbhost;port=5432;dbname=yourdbname";
fastcgi_param PC_CRT_DB_USERNAME "yourdbuser";
fastcgi_param PC_CRT_DB_PASSWORD "yourdbpass";
}
</syntaxhighlight>

=Системные требования=
Требования указаны без учёта системных требований ОС.
==Минимальные==
* ЦП: одно ядро;
* ОЗУ: 100 MB;
* Дисковое пространство: 150 MB.
==Рекомендуемые==
* ЦП: одно ядро;
* ОЗУ: 512 MB;
* Дисковое пространство: 1 GB.

[[Категория:Серверная часть]]
[[Категория:Пользовательский интерфейс]]
[[Категория:Руководства]]
[[Категория:Документация]]
[[Категория:Инсталляция]]

АРМ РКС PayControl v3

2024-11-07T08:04:57Z

D.bizyukov: /* Конфигурирование */

АРМ РКС представляет из себя пользовательский Web-интерфейс, предоставляемый установленным в инфраструктуре заказчика Web-сервером с поддержкой исполнения PHP. Для получения запрашиваемой информации, Web-сервер АРМ РКС использует подключение к PCS через SOAP API, и подключение к БД PCS.
=Настройка подключения=
Для взаимодействия АРМ РКС необходимо установить Apache HTTP-сервер и PHP, в т.ч. модули php-soap и php-json.
==Подключение к БД==
Кроме того необходимо настроить подключение к БД с использованием PDO-драйверов:
===PostgreSQL===
Для начала нужно распаковать архив с файлами АРМ РКС в папку /var/www/html/.

Затем установить драйвер [[PostgreSQL]] для [[PHP]] и настроить подключение к БД с его помощью в конфигурационном файле.
<syntaxhighlight lang="bash">sudo apt install php-pgsql</syntaxhighlight>
====CentOS====
На CentOS необходимо установить '''PHP (last)''' + '''php-pgsql''' + '''php-pdo''' + '''php-fpm'''.

Также необходимо разрешить подключение для IP адреса этого сервера к БД PC Server (даже в случае, если АРМ РКС и СУБД располагаются на одном хосте) - файл ''postgresql.conf'', и добавить запись для разрешения аутентификации с этого IP - файл ''pg_hba.conf''. Подробнее - [[#Разрешение подключения с других хостов|Разрешение подключения с других хостов]].

Для проверки успешности подключения, можно проверить информацию о PHP (http://rks_host:port/rks/phpinfo.php), должны отображаться установленные PDO-драйверы:
<gallery>
php-pdo-pgsql.png|PHP Info при настроенных драйверах PostgreSQL
</gallery>

====ALT Linux====

1) Обновление сописка доcnупных пакетов
apt-get update

2) Установка необходимых пакетов (вместо '''?''' укажите номер версии php)

<syntaxhighlight lang="bash">apt-get install php? php?-fpm-fcgi php?-pdo_pgsql php?-pgsql php?-soap php?-pdo php?-xml</syntaxhighlight>

3) Настройте конфигурацию apache в файле ''/etc/httpd2/conf/httpd2.conf'', добавив строки

(проверьте, что путь и имя .sock файла соответствую вашей версии, и, что путь к файлам с АРМ РКС верен)

Пример:
<syntaxhighlight lang="bash">
# Подключение модуля proxy и proxy_fcgi для работы с php-fpm
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so

# Обработка PHP-файлов через php-fpm сокет
<FilesMatch \.php$>
SetHandler "proxy:unix:/var/run/php7-fpm/php7-fpm.sock|fcgi://localhost/"
</FilesMatch>

# Директория с PHP-файлами
<Directory "/var/www/html/rks/">
AllowOverride All
Require all granted
</Directory>
</syntaxhighlight>

Также необходимо разрешить подключение для IP адреса этого сервера к БД PC Server (даже в случае, если АРМ РКС и СУБД располагаются на одном хосте) - файл ''postgresql.conf'', и добавить запись для разрешения аутентификации с этого IP - файл ''pg_hba.conf''. Подробнее - [[#Разрешение подключения с других хостов|Разрешение подключения с других хостов]].

Для проверки успешности подключения, можно проверить информацию о PHP (http://rks_host:port/rks/phpinfo.php), должны отображаться установленные PDO-драйверы:
<gallery>
php-pdo-pgsql.png|PHP Info при настроенных драйверах PostgreSQL
</gallery>

[[#Конфигурирование подключения|Настройка подключения к БД PC Server]]
=====Разрешение подключения с других хостов=====
#Раскомментировать строку "listen_addresses = 'localhost'" в файле <syntaxhighlight lang="bash">sudo vi /var/lib/pgsql/data/postgresql.conf</syntaxhighlight> и перечислить через запятую список хостов или указать "*". Требуется перезапуск после изменения параметра.
#Добавить для нового хоста запись в <syntaxhighlight lang="bash">sudo vi /var/lib/pgsql/data/pg_hba.conf</syntaxhighlight> и указать требуемый тип аутентификации.

===Oracle===
====Ubuntu====
[https://rosemberg.net.br/en/installing-pdo-oracle-and-oci8-from-php7-on-ubuntumint-oracle-11-2/ Инструкция для настройки PHP + PDO + OCI8]

Проверено на Ubuntu 16.04 + php7.0.30 + apache2 + Oracle Instant Client 18.3
====Centos====
Для подключения к СУБД Oracle необходимо использовать PHP версии 7.x и установить Oracle-client. Подробное описание установки драйверов Oracle для PHP доступно по ссылке: https://www.codeproject.com/Articles/1231012/Installing-OCI-PHP-on-RHEL-or-CentOS.

Драйверы Oracle доступны по ссылке https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html

Пример выполнения команд по установке:
<syntaxhighlight lang="bash">sudo yum install epel-release yum-utils
sudo yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm
sudo yum-config-manager --enable remi-php73
sudo yum install php php-oci8 php-pdo php-soap
sudo yum install oracle-instantclient19.3-basic-19.3.0.0.0-1.x86_64.rpm oracle-instantclient19.3-devel-19.3.0.0.0-1.x86_64.rpm
sudo sh -c "echo /usr/lib/oracle/19.3/client64/lib > /etc/ld.so.conf.d/oracle-instantclient.conf"
sudo ldconfig
php -v
sudo systemctl restart httpd
</syntaxhighlight>
Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
php-oci.png|Установленный Oracle Call Interface (OCI) драйвер в PHP
php-pdo-oci.png|Подключённый OCI как PDO в PHP
</gallery>

Необходимо в [[SELinux]] предоставить Apache разрешение на установку сетевого подключение к СУБД Oracle:
<syntaxhighlight lang="bash">semanage port -m -t http_port_t -p tcp 1521</syntaxhighlight>
Также, для успешного подключения к HTTPD необходимо разрешить подключения к порту 80 или 443:
<syntaxhighlight lang="bash">sudo firewall-cmd --zone=public --add-service=http</syntaxhighlight>

===MS SQL===
Необходима установка драйвера dblib для PHP.
====Ubuntu====
Пример команды для установки драйвера для Ubuntu:
<syntaxhighlight lang="bash">sudo apt install php7.0-sybase</syntaxhighlight>
====CentOS 7====
Команда для предоставления доступа Apache на подключение к другим ресурсам:
<syntaxhighlight lang="bash">setsebool httpd_can_network_connect 1</syntaxhighlight>
<syntaxhighlight lang="bash">sudo yum install epel-release php-soap php-json
sudo yum install php-mssql
sudo systemctl restart httpd.service</syntaxhighlight>
При установке ''php-mssql'' должен автоматически установиться ''php-pdo''.

Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
Centos php-mssql.png|Установленный MSSQL драйвер в PHP
Файл:Centos pdo mssql.png|Подключённый MSSQL как PDO в PHP
</gallery>

====CentOS 8====
*Команда для предоставления доступа Apache на подключение к другим ресурсам:
<syntaxhighlight lang="bash">setsebool httpd_can_network_connect 1</syntaxhighlight>
*Установка PHP:
<syntaxhighlight lang="bash">
sudo su
dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install https://rpms.remirepo.net/enterprise/remi-release-8.rpm
dnf install yum-utils
dnf module reset php
dnf module install php:remi-7.2
subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms
dnf update
dnf install php php-pdo php-pear php-soap php-json php-fpm
</syntaxhighlight>
*Загрузка и установка драйвера Microsoft ODBC 17:
<syntaxhighlight lang="bash">
sudo curl https://packages.microsoft.com/config/rhel/8/prod.repo > /etc/yum.repos.d/mssql-release.repo
sudo yum remove unixODBC-utf16 unixODBC-utf16-devel #to avoid conflicts
sudo ACCEPT_EULA=Y yum install msodbcsql17
</syntaxhighlight>
*Установка драйверов PHP для Microsoft SQL Server
<syntaxhighlight lang="bash">
sudo yum install php-sqlsrv
</syntaxhighlight>
Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
Centos php-mssql.png|Установленный MSSQL драйвер в PHP
Файл:Centos pdo mssql.png|Подключённый MSSQL как PDO в PHP
</gallery>

====MS Windows====
=====Развёртывание Apache и PHP=====
* Скачать Apache, распаковать, например в ''c:\Apache24'';
* Скачать PHP 7, распаковать, например в ''c:\php'';
* Подключить PHP в Apache (файл ''c:\Apache24\conf\httpd.conf''):<syntaxhighlight lang="bash">
LoadModule php7_module c:/php/php7apache2_4.dll
<IfModule dir_module>
DirectoryIndex index.html index.htm index.php
</IfModule>
AddType application/x-httpd-php .php
AddHandler application/x-httpd-php .php
PHPiniDir "c:/php"
</syntaxhighlight>
* Включить поддержку SOAP API в PHP (файл ''c:\php\php.ini''):<syntaxhighlight lang="bash">
extension=soap
</syntaxhighlight>
* Добавить PDO SQL (pdo_sqlsrv) драйвер в PHP. Для этого:
** Скачать драйвер Microsoft Drivers 5.6 for PHP for SQL Server (или свежее) с https://www.microsoft.com/en-us/download/details.aspx?id=57916 (при выпуске более свежей версии драйвера, возможно ссылка на него будет новая)
** Распаковать в ''c:\php\ext''
** Сконфигурировать в ''c:\php\php.ini'':<syntaxhighlight lang="bash">
extension=php_pdo_sqlsrv_73_ts_x64
extension=php_sqlsrv_73_ts_x64.dll
</syntaxhighlight>
* Скачать и установить ODBC-драйвер https://docs.microsoft.com/ru-ru/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-2017
* Распаковать файлы АРМ РКС в ''c:\Apache24\htdocs'';
* Установить службу <syntaxhighlight lang="bat">c:\Apache24\bin\httpd.exe -k install</syntaxhighlight> при этом она будет автоматически запущена и будет включён автозапуск.

==Конфигурирование подключения==
===Linux===
Для удобства настройки, можно предоставить группе pc_admins доступ на запись в директорию web-сервера:<syntaxhighlight lang="bash">chown -Rv :pc_admins /var/www/html/
chmod -Rv g+w /var/www/html/</syntaxhighlight>
===Конфигурирование===
Для подключения необходимо создать копию файла ''config.php.DEFAULT'' с именем ''config.php''. В новом файле:
* указать адрес WSDL-схемы [[Вызов методов SOAP интерфейса|SOAP-интерфейса]] [[Сервер PayControl|сервера PCS]] (имеет вид ''http://pctest.local:8080/ws/PayControlServiceV3?wsdl'');
* указать идентификатор [[Прикладная система|прикладной системы]] (systemid);
* раскомментировать блок с параметрами подключения к соответствующей СУБД. Указать в переменных окружения параметры для подключения БД PCS.
* разрешить чтение из переменных окружения, включив модуль mod_env.so с помощью - '''sudo a2enmod env'''
* добавить в конфиг Apache ''/etc/httpd2/conf/httpd2.conf'' перечень переменных, которые нужно забирать:
<syntaxhighlight lang="unixconfig">
<IfModule mod_env.c>
PassEnv PC_CRT_DB_USERNAME
PassEnv PC_CRT_DB_PASSWORD
PassEnv PC_CRT_DB_CONNSTRING
</IfModule>
</syntaxhighlight>

=Системные требования=
Требования указаны без учёта системных требований ОС.
==Минимальные==
* ЦП: одно ядро;
* ОЗУ: 100 MB;
* Дисковое пространство: 150 MB.
==Рекомендуемые==
* ЦП: одно ядро;
* ОЗУ: 512 MB;
* Дисковое пространство: 1 GB.

[[Категория:Серверная часть]]
[[Категория:Пользовательский интерфейс]]
[[Категория:Руководства]]
[[Категория:Документация]]
[[Категория:Инсталляция]]

АРМ РКС PayControl v3

2024-11-05T16:57:08Z

D.bizyukov: /* Подключение к БД */

АРМ РКС представляет из себя пользовательский Web-интерфейс, предоставляемый установленным в инфраструктуре заказчика Web-сервером с поддержкой исполнения PHP. Для получения запрашиваемой информации, Web-сервер АРМ РКС использует подключение к PCS через SOAP API, и подключение к БД PCS.
=Настройка подключения=
Для взаимодействия АРМ РКС необходимо установить Apache HTTP-сервер и PHP, в т.ч. модули php-soap и php-json.
==Подключение к БД==
Кроме того необходимо настроить подключение к БД с использованием PDO-драйверов:
===PostgreSQL===
Для начала нужно распаковать архив с файлами АРМ РКС в папку /var/www/html/.

Затем установить драйвер [[PostgreSQL]] для [[PHP]] и настроить подключение к БД с его помощью в конфигурационном файле.
<syntaxhighlight lang="bash">sudo apt install php-pgsql</syntaxhighlight>
====CentOS====
На CentOS необходимо установить '''PHP (last)''' + '''php-pgsql''' + '''php-pdo''' + '''php-fpm'''.

Также необходимо разрешить подключение для IP адреса этого сервера к БД PC Server (даже в случае, если АРМ РКС и СУБД располагаются на одном хосте) - файл ''postgresql.conf'', и добавить запись для разрешения аутентификации с этого IP - файл ''pg_hba.conf''. Подробнее - [[#Разрешение подключения с других хостов|Разрешение подключения с других хостов]].

Для проверки успешности подключения, можно проверить информацию о PHP (http://rks_host:port/rks/phpinfo.php), должны отображаться установленные PDO-драйверы:
<gallery>
php-pdo-pgsql.png|PHP Info при настроенных драйверах PostgreSQL
</gallery>

====ALT Linux====

1) Обновление сописка доcnупных пакетов
apt-get update

2) Установка необходимых пакетов (вместо '''?''' укажите номер версии php)

<syntaxhighlight lang="bash">apt-get install php? php?-fpm-fcgi php?-pdo_pgsql php?-pgsql php?-soap php?-pdo php?-xml</syntaxhighlight>

3) Настройте конфигурацию apache в файле ''/etc/httpd2/conf/httpd2.conf'', добавив строки

(проверьте, что путь и имя .sock файла соответствую вашей версии, и, что путь к файлам с АРМ РКС верен)

Пример:
<syntaxhighlight lang="bash">
# Подключение модуля proxy и proxy_fcgi для работы с php-fpm
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so

# Обработка PHP-файлов через php-fpm сокет
<FilesMatch \.php$>
SetHandler "proxy:unix:/var/run/php7-fpm/php7-fpm.sock|fcgi://localhost/"
</FilesMatch>

# Директория с PHP-файлами
<Directory "/var/www/html/rks/">
AllowOverride All
Require all granted
</Directory>
</syntaxhighlight>

Также необходимо разрешить подключение для IP адреса этого сервера к БД PC Server (даже в случае, если АРМ РКС и СУБД располагаются на одном хосте) - файл ''postgresql.conf'', и добавить запись для разрешения аутентификации с этого IP - файл ''pg_hba.conf''. Подробнее - [[#Разрешение подключения с других хостов|Разрешение подключения с других хостов]].

Для проверки успешности подключения, можно проверить информацию о PHP (http://rks_host:port/rks/phpinfo.php), должны отображаться установленные PDO-драйверы:
<gallery>
php-pdo-pgsql.png|PHP Info при настроенных драйверах PostgreSQL
</gallery>

[[#Конфигурирование подключения|Настройка подключения к БД PC Server]]
=====Разрешение подключения с других хостов=====
#Раскомментировать строку "listen_addresses = 'localhost'" в файле <syntaxhighlight lang="bash">sudo vi /var/lib/pgsql/data/postgresql.conf</syntaxhighlight> и перечислить через запятую список хостов или указать "*". Требуется перезапуск после изменения параметра.
#Добавить для нового хоста запись в <syntaxhighlight lang="bash">sudo vi /var/lib/pgsql/data/pg_hba.conf</syntaxhighlight> и указать требуемый тип аутентификации.

===Oracle===
====Ubuntu====
[https://rosemberg.net.br/en/installing-pdo-oracle-and-oci8-from-php7-on-ubuntumint-oracle-11-2/ Инструкция для настройки PHP + PDO + OCI8]

Проверено на Ubuntu 16.04 + php7.0.30 + apache2 + Oracle Instant Client 18.3
====Centos====
Для подключения к СУБД Oracle необходимо использовать PHP версии 7.x и установить Oracle-client. Подробное описание установки драйверов Oracle для PHP доступно по ссылке: https://www.codeproject.com/Articles/1231012/Installing-OCI-PHP-on-RHEL-or-CentOS.

Драйверы Oracle доступны по ссылке https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html

Пример выполнения команд по установке:
<syntaxhighlight lang="bash">sudo yum install epel-release yum-utils
sudo yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm
sudo yum-config-manager --enable remi-php73
sudo yum install php php-oci8 php-pdo php-soap
sudo yum install oracle-instantclient19.3-basic-19.3.0.0.0-1.x86_64.rpm oracle-instantclient19.3-devel-19.3.0.0.0-1.x86_64.rpm
sudo sh -c "echo /usr/lib/oracle/19.3/client64/lib > /etc/ld.so.conf.d/oracle-instantclient.conf"
sudo ldconfig
php -v
sudo systemctl restart httpd
</syntaxhighlight>
Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
php-oci.png|Установленный Oracle Call Interface (OCI) драйвер в PHP
php-pdo-oci.png|Подключённый OCI как PDO в PHP
</gallery>

Необходимо в [[SELinux]] предоставить Apache разрешение на установку сетевого подключение к СУБД Oracle:
<syntaxhighlight lang="bash">semanage port -m -t http_port_t -p tcp 1521</syntaxhighlight>
Также, для успешного подключения к HTTPD необходимо разрешить подключения к порту 80 или 443:
<syntaxhighlight lang="bash">sudo firewall-cmd --zone=public --add-service=http</syntaxhighlight>

===MS SQL===
Необходима установка драйвера dblib для PHP.
====Ubuntu====
Пример команды для установки драйвера для Ubuntu:
<syntaxhighlight lang="bash">sudo apt install php7.0-sybase</syntaxhighlight>
====CentOS 7====
Команда для предоставления доступа Apache на подключение к другим ресурсам:
<syntaxhighlight lang="bash">setsebool httpd_can_network_connect 1</syntaxhighlight>
<syntaxhighlight lang="bash">sudo yum install epel-release php-soap php-json
sudo yum install php-mssql
sudo systemctl restart httpd.service</syntaxhighlight>
При установке ''php-mssql'' должен автоматически установиться ''php-pdo''.

Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
Centos php-mssql.png|Установленный MSSQL драйвер в PHP
Файл:Centos pdo mssql.png|Подключённый MSSQL как PDO в PHP
</gallery>

====CentOS 8====
*Команда для предоставления доступа Apache на подключение к другим ресурсам:
<syntaxhighlight lang="bash">setsebool httpd_can_network_connect 1</syntaxhighlight>
*Установка PHP:
<syntaxhighlight lang="bash">
sudo su
dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install https://rpms.remirepo.net/enterprise/remi-release-8.rpm
dnf install yum-utils
dnf module reset php
dnf module install php:remi-7.2
subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms
dnf update
dnf install php php-pdo php-pear php-soap php-json php-fpm
</syntaxhighlight>
*Загрузка и установка драйвера Microsoft ODBC 17:
<syntaxhighlight lang="bash">
sudo curl https://packages.microsoft.com/config/rhel/8/prod.repo > /etc/yum.repos.d/mssql-release.repo
sudo yum remove unixODBC-utf16 unixODBC-utf16-devel #to avoid conflicts
sudo ACCEPT_EULA=Y yum install msodbcsql17
</syntaxhighlight>
*Установка драйверов PHP для Microsoft SQL Server
<syntaxhighlight lang="bash">
sudo yum install php-sqlsrv
</syntaxhighlight>
Для проверки успешности подключения, проверить информацию о PHP (выводится с помощью вызова функции phpinfo();), должны отображаться установленные PDO-драйверы:
<gallery>
Centos php-mssql.png|Установленный MSSQL драйвер в PHP
Файл:Centos pdo mssql.png|Подключённый MSSQL как PDO в PHP
</gallery>

====MS Windows====
=====Развёртывание Apache и PHP=====
* Скачать Apache, распаковать, например в ''c:\Apache24'';
* Скачать PHP 7, распаковать, например в ''c:\php'';
* Подключить PHP в Apache (файл ''c:\Apache24\conf\httpd.conf''):<syntaxhighlight lang="bash">
LoadModule php7_module c:/php/php7apache2_4.dll
<IfModule dir_module>
DirectoryIndex index.html index.htm index.php
</IfModule>
AddType application/x-httpd-php .php
AddHandler application/x-httpd-php .php
PHPiniDir "c:/php"
</syntaxhighlight>
* Включить поддержку SOAP API в PHP (файл ''c:\php\php.ini''):<syntaxhighlight lang="bash">
extension=soap
</syntaxhighlight>
* Добавить PDO SQL (pdo_sqlsrv) драйвер в PHP. Для этого:
** Скачать драйвер Microsoft Drivers 5.6 for PHP for SQL Server (или свежее) с https://www.microsoft.com/en-us/download/details.aspx?id=57916 (при выпуске более свежей версии драйвера, возможно ссылка на него будет новая)
** Распаковать в ''c:\php\ext''
** Сконфигурировать в ''c:\php\php.ini'':<syntaxhighlight lang="bash">
extension=php_pdo_sqlsrv_73_ts_x64
extension=php_sqlsrv_73_ts_x64.dll
</syntaxhighlight>
* Скачать и установить ODBC-драйвер https://docs.microsoft.com/ru-ru/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-2017
* Распаковать файлы АРМ РКС в ''c:\Apache24\htdocs'';
* Установить службу <syntaxhighlight lang="bat">c:\Apache24\bin\httpd.exe -k install</syntaxhighlight> при этом она будет автоматически запущена и будет включён автозапуск.

==Конфигурирование подключения==
===Linux===
Для удобства настройки, можно предоставить группе pc_admins доступ на запись в директорию web-сервера:<syntaxhighlight lang="bash">chown -Rv :pc_admins /var/www/html/
chmod -Rv g+w /var/www/html/</syntaxhighlight>
===Конфигурирование===
Для подключения необходимо создать копию файла ''config.php.DEFAULT'' с именем ''config.php''. В новом файле:
* указать адрес WSDL-схемы [[Вызов методов SOAP интерфейса|SOAP-интерфейса]] [[Сервер PayControl|сервера PCS]] (имеет вид ''http://pctest.local:8080/ws/PayControlServiceV3?wsdl'');
* указать идентификатор [[Прикладная система|прикладной системы]] (systemid);
* раскомментировать блок с параметрами подключения к соответствующей СУБД. Указать параметры для подключения [[База данных PayControl|БД PCS]].

=Системные требования=
Требования указаны без учёта системных требований ОС.
==Минимальные==
* ЦП: одно ядро;
* ОЗУ: 100 MB;
* Дисковое пространство: 150 MB.
==Рекомендуемые==
* ЦП: одно ядро;
* ОЗУ: 512 MB;
* Дисковое пространство: 1 GB.

[[Категория:Серверная часть]]
[[Категория:Пользовательский интерфейс]]
[[Категория:Руководства]]
[[Категория:Документация]]
[[Категория:Инсталляция]]

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

2024-10-01T15:46: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 register_request='%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 с версии 5 на версию 6

2024-10-01T15:46:14Z

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 register_request='%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 с версии 5 на версию 6

2024-10-01T15:36:10Z

D.bizyukov: /* Обновление Java */

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

* заменить <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>

=== Лицензия ===

Установите лицензию одним из приведённых в [https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/#установка-лицензии руководстве администратора PC] способов.

= Документация по работе с 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 с версии 5 на версию 6

2024-10-01T15:34:43Z

D.bizyukov: /* Обновление модулей PC */

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

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

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам. Для того чтобы компоненты работали под Java 17, необходимо либо удалить неактуальную версию Java, либо выбрать необходимую версию с помощью:

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

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

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

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

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

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

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

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

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

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

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

* заменить <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>

=== Лицензия ===

Установите лицензию одним из приведённых в [https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/#установка-лицензии руководстве администратора PC] способов.

= Документация по работе с 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 с версии 5 на версию 6

2024-10-01T15:33:56Z

D.bizyukov: /* Документация по работе с PC 6-й версии */

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

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

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам. Для того чтобы компоненты работали под Java 17, необходимо либо удалить неактуальную версию Java, либо выбрать необходимую версию с помощью:

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

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

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

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

После обновления крайне рекомендуется отключить автозапуск Wildfly.

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

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

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

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

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

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

* заменить <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>

=== Лицензия ===

Установите лицензию одним из приведённых в [https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/#установка-лицензии руководстве администратора PC] способов.

= Документация по работе с 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 с версии 5 на версию 6

2024-10-01T15:32:37Z

D.bizyukov: /* Обновление модулей PC */

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

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

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам. Для того чтобы компоненты работали под Java 17, необходимо либо удалить неактуальную версию Java, либо выбрать необходимую версию с помощью:

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

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

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

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

После обновления крайне рекомендуется отключить автозапуск Wildfly.

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

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

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

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

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

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

* заменить <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>

=== Лицензия ===

Установите лицензию одним из приведённых в [https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/#установка-лицензии руководстве администратора PC] способов.

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

Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/
Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/
Вся документация - https://repo.paycontrol.org/index/safe-tech/#paycontrol-demo-portal

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

2024-10-01T15:32:24Z

D.bizyukov: /* Обновление Java */

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

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

При установке Java новой версии, старая версия не удаляется, и PC может продолжить работать на версии 11, что приведёт к ошибкам. Для того чтобы компоненты работали под Java 17, необходимо либо удалить неактуальную версию Java, либо выбрать необходимую версию с помощью:

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

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

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

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

После обновления крайне рекомендуется отключить автозапуск Wildfly.

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

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

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

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

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

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

* заменить <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>

=== Лицензия ===

Установите лицензию одним из приведённых в [https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/#установка-лицензии руководстве администратора PC] способов.

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

Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/
Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/
Вся документация - https://repo.paycontrol.org/index/safe-tech/#paycontrol-demo-portal

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

2024-10-01T13:02:59Z

D.bizyukov: Новая страница: « = Обновление Java = Перед обновлением компонентов PC '''требуется''' остановить Wildfly и обнови…»

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

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

При установке Java новой версии, старая версия не удаляется, и [[Wildfly]] может продолжить работать на версии 11, что приведёт к ошибкам. Для того чтобы компоненты работали под Java 17, необходимо либо удалить неактуальную версию Java, либо выбрать необходимую версию с помощью:

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

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

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

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

После обновления крайне рекомендуется отключить автозапуск Wildfly.

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

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

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

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

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

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

* заменить <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>

=== Лицензия ===

Установите лицензию одним из приведённых в [https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/#установка-лицензии руководстве администратора PC] способов.

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

Руководство администратора - https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/
Справочное руководство - https://repo.paycontrol.org/server/doc/latest/pc-reference-guide/ru/
Вся документация - https://repo.paycontrol.org/index/safe-tech/#paycontrol-demo-portal

Обновление PayControl с 3.5 на 3.9

2024-06-25T13:53:08Z

D.bizyukov: /* Удаление ненужных полей */

В версии 3.8 реализовано взаимодействие с [[PC Pusher 5.2|PC Pusher 5.x]], который, в свою очередь, поддерживает отправку пуш-уведомлений на устройства Huawei. Обновлению с 3.5-3.7 подлежат модули PCS и PC External.

{{Предупреждение|Модуль PCIS Internal 3.5-3.7 подлежит замене на модуль PC Pusher 5.5. PCS с версии 3.8 не поддерживает работу с модулем PCIS Internal.}}

В версии 3.9 добавлена функциональность формирования имитовставки, для соответствия п.5.1 Положения Банка России от 17 апреля 2019 года N 683-П:

В целях обеспечения целостности электронных сообщений и подтверждения их составления уполномоченным на это лицом кредитные организации должны обеспечивать реализацию мер по использованию усиленной квалифицированной электронной подписи, усиленной неквалифицированной электронной подписи или СКЗИ, реализующих функцию имитозащиты информации с аутентификацией отправителя сообщения.

Модули сервера доступны по ссылкам:
* PC Server (https://repo.paycontrol.org/server/maven/tech/paycon/server/PayControl-services-module/), версия 3.9.xxx;
* PC External (https://repo.paycontrol.org/server/maven/tech/paycon/server/PayControl-interaction-rest/), версия 3.9.xxx;
* PC Pusher (https://repo.paycontrol.org/server/maven/tech/paycon/server/pc-pusher/), версия 5.5.xxx.

Если при обновлении сервера также необходимо обновить Wildfly, то перед обновлением '''необходимо''' остановить службу, убрать её из автозапуска.

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

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

При установке Java новой версии, старая версия не удаляется, и [[Wildfly]] может продолжить работать на версии 8, что приведёт к ошибкам. Для того чтобы компоненты работали под Java 11, необходимо либо удалить неактуальную версию Java, либо выбрать необходимую версию с помощью:

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

=Обновление компонентов PCS=
Для обновления нужно заменить файл приложения сервера <WF_PATH>\standalone\deployments\ на новый:
* на PCS - файл ''PayControl-services-module-<VERSION>.ear''

[[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|Остановите wildfly]].

==Отключение поддержки совместимости с PCS 3.5==
Для отключения в модуле PCIS External 3.7 режима совместимости с сервером версии 3.5 необходимо убрать из окружения Java параметр <code>paycontrol.pcsVersion</code> со значением <code>3.5</code>. Это можно сделать следующим образом:
* для Linux:
*: в файле /opt/wildfly/bin/standalone.conf удалить строку <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.pcsVersion=3.5"</syntaxhighlight>
* для Windows:
*: в файле C:\wildfly\bin\standalone.conf.bat удалить строку <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.pcsVersion=3.5"</syntaxhighlight>

==Изменения в БД==
*Для переноса параметров из pc_system в pc_system_params, что необходимо, при обновлении, нужно выполнить запрос:
<syntaxhighlight lang="sql">
INSERT INTO pc_system_params (systemid, created_at, is_deleted, updated_at, billed_date_request, billing_period, billed_date, billing_type, description, front_end_url, license, online_confirmation_url, register_request, report_template_path, user_keys_expiration_period)
SELECT systemid, created_at, is_deleted, updated_at, billed_date_request, billing_period, billed_date, billing_type, description, front_end_url, license, online_confirmation_url, register_request, report_template_path, user_keys_expiration_period
FROM pc_system;
</syntaxhighlight>
*Чтобы поправить настройки пользователей нужно выполнить запрос:
<syntaxhighlight lang="sql">
update pc_keyinfo set key_flags=0 where need_to_use_fingerprint=0;
update pc_keyinfo set key_flags=1 where need_to_use_fingerprint=1;
update pc_delayedkeyinfo set key_flags=0 where need_to_use_fingerprint=0;
update pc_delayedkeyinfo set key_flags=1 where need_to_use_fingerprint=1;
</syntaxhighlight>

==Запрос на регистрацию==
===Получение нового запроса===
Для получения нового запроса на регистрацию нужно выполнить запрос к БД PCS
<code>
select * from pc_system;
</code>, и обратиться с результатами запроса в компанию Сэйфтек.

===Замена запроса в БД===
В приведённом ниже запросе необходимо:
* заменить <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>

==Лицензия==
===Получение обновленной лицензии===
Для получения обновленной лицензии нужно выполнить запрос к БД PCS
<code>
select * from pc_system;
</code>, и обратиться с результатами запроса в компанию Сэйфтек.

===Замена лицензии в БД===
*На сервере PC Server, удалите файл(*.paycontrol.license) с лицензией, если такой есть.
*Выполните к БД PC Server запрос:
В приведённом ниже запросе необходимо:
# заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
# заменить <code>%LICENSE%</code> на реальные данные лицензии(*.paycontrol.license), созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных лицензии
<code><?xml version="1.0" encoding="UTF-8" standalone="yes"?><licenseInformationWithSignature xmlns="http://ws.safetech.ru/PayControl/services/ws/request/"><licenseInformation><systemId>48000c91-dd4a-47d5-9041-fd8d0a32c13b</systemId><validTo>2020-11-07T20:59:59.000Z</validTo><usersCount>100</usersCount></licenseInformation><signature>MEQCIDyHJwCnp7iLDSAllrcjVya+ukW6Ov1dJJiSXd8HIowBAiB8cEBnjhm3up1ui2pjp9oqx6GzxOfRCBG0EddiIqCIqA==</signature></licenseInformationWithSignature></code>
<syntaxhighlight lang="sql">
update pc_system_params set license='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=PCIS Internal и External=
==Для PCIS версии ниже, чем 3.7==
Этот пункт следует выполнять только в случае, если основной сервер PCS имеет версию 3.5, а серверы PCIS имеют версию ниже 3.7 - [[Обновление PCIS до версии 3.7|Обновление PCIS до версии 3.7]]

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

Для обновления необходимо заменить на серверах файл модуля PC External в директории ''deployments'' сервера приложений [[Wildfly]].

Он имеет название вида:
* PayControl-interaction-rest-3.x.x.war - PC External.
Перед заменой файлов [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|остановите Wildfly]].
Файлы сервера предыдущей версии настоятельно рекомендуем сохранить для возможности отката на предыдущую версию.

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

==Переход с PCIS Internal на PC Pusher==
===Замена файлов модулей===
{{Предупреждение|PC Pusher для своей работы не требует использования БД, в отличие от PCIS Internal.}}

Для обновления необходимо заменить на сервере файлы модуля PCIS Internal в директории deployments сервера приложений Wildfly. Файл имеют названия вида:

*PayControl-interaction-module-3.x.xxx.ear - PCIS Internal

Перед заменой файлов [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|остановите Wildfly]].
Файлы сервера предыдущей версии настоятельно рекомендуем сохранить для возможности отката на предыдущую версию.

*Новый файл имеет название вида: pc-pusher-5.5.xxx.war

После замены файлов и развёртывания новых, в директории deployments будут созданы файлы с названиями:

*.undeployed, где вместо * будет указано название убранного из директории файла модуля сервера. Файлы с расширением undeployed рекомендуется удалить.
*и с расширением *.deployed, где вместо * будут указаны названия новых модулей.
При появлении файлов с расширением *.failed, необходимо [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|перезапустить Wildfly]].
===Настройка PC Server для работы с PC Pusher===
После замены PCIS Internal на PC Pusher '''необходимо''' заменить его адрес в БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url='http[s]://pcphost:port/pc-pusher-api/';</syntaxhighlight>

Далее, '''необходимо''' предоставить доступ PC Pusher для отправки данных пушей в сервис HMS (Huawei Mobile Services).
При отправке push-сообщений, запросы должны отправляются по адресу https://push-api.cloud.huawei.com/ ,порт 443.

Также, с сервера PC Pusher '''должен''' быть доступен адрес: https://oauth-login.cloud.huawei.com/oauth2/v3/token

В случае, если PC Pusher находится на одном сервере с PC External, то '''необходимо''' перенастроить правила URL-фильтрации.

===Настройка PC Pusher===
Если для подтверждения транзакций используется приложение PayControl, то данная настройка не требуется.

По умолчанию, если app/bundle id для отправки пуш-уведомлений явно не указан для устройства, PCS 3.9 отправляет пуши в приложение PayControl Classic.

Для отправки пушей в другое приложения необходимо:
# Произвести настройки аутентификационных данных "другого" мобильного приложения в соответствии с [[PC_Pusher_5.2|этой статьей]]
# Прописать app/bundle id необходимого приложения в БД PCS(после выполнения запроса необходимо перезапустить Wildfly):
Пример: <syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'APP_ID_FOR_PUSHER', '{"Android":"com.example.mobile.app","iOS":"com.example.apple.app","Huawei":"com.example.apple.app"}');</syntaxhighlight>
Шаблоны:
* PostgreSQL <syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid","Huawei":"your_appid"}');</syntaxhighlight>
* MS SQL <syntaxhighlight lang="sql">insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid","Huawei":"your_appid"}');</syntaxhighlight>
* Oracle <syntaxhighlight lang="sql">insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid","Huawei":"your_appid"}');</syntaxhighlight>

= Завершение обновления =
После выполнения вышеизложенных пунктов нужно [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|запустить wildfly]].

==Правка последовательностей MS SQL==

Данный пункт нужно выполнить в том случае, если в вашей БД нет последовательностей\сиквенсов, описанных ниже, а вместо них используются таблицы.

Пример:
* Мы хотим создать сиквенс PC_ATTEMPT_SEQ
* Для этого идем в таблицу PC_ATTEMPT_SEQ
* Берем оттуда последнее значение id
* Добавляем в запрос на создание сиквенса вместо знака вопроса
* Переименовываем старую таблицу PC_ATTEMPT_SEQ
* Создаем сиквенс

Перед добавлением сиквенсов переименуйте старые таблицы:

<syntaxhighlight lang="sql">
sp_rename PC_ATTEMPT_SEQ, PC_ATTEMPT_SEQ_OLD;
sp_rename PC_DELAYEDKEYINFO_SEQ, PC_DELAYEDKEYINFO_SEQ_OLD;
sp_rename PC_DEVICE_SEQ, PC_DEVICE_SEQ_OLD;
sp_rename PC_KEYINFO_SEQ, PC_KEYINFO_SEQ_OLD;
sp_rename PC_PUBLICKEY_SEQ, PC_PUBLICKEY_SEQ_OLD;
sp_rename PC_SETTING_SEQ, PC_SETTING_SEQ_OLD;
sp_rename PC_EVENT_SEQ, PC_EVENT_SEQ_OLD;
</syntaxhighlight>

Теперь можно добавлять сиквенсы.

Список команд для добавления необходимых сиквенсов:

Знаки вопроса нужно заменить на последний id в таблице-сиквенсе с тем же названием.

<syntaxhighlight lang="sql">
create sequence PC_ATTEMPT_SEQ start with ? increment by 1;
create sequence PC_DELAYEDKEYINFO_SEQ start with ? increment by 1;
create sequence PC_DEVICE_SEQ start with ? increment by 1;
create sequence PC_KEYINFO_SEQ start with ? increment by 1;
create sequence PC_PUBLICKEY_SEQ start with ? increment by 1;
create sequence PC_SETTING_SEQ start with ? increment by 1;
create sequence PC_EVENT_SEQ start with ? increment by 1;
</syntaxhighlight>

== Удаление ненужных полей ==
'''Если''' у вас всё обновилось и '''точно''' работает, можно удалить не нужные поля от предыдущей версии, они больше не нужны, или перенесены.

Удалить не используемые столбцы можно с помощью запросов:
<syntaxhighlight lang="sql">
ALTER TABLE pc_system
DROP COLUMN IF EXISTS internal_cert_fingerprint,
DROP COLUMN IF EXISTS key_container,
DROP COLUMN IF EXISTS key_password,
DROP COLUMN IF EXISTS additional_key_options,
DROP COLUMN IF EXISTS key_type,
DROP COLUMN IF EXISTS system_type,
DROP COLUMN IF EXISTS billed_date_request,
DROP COLUMN IF EXISTS billing_period,
DROP COLUMN IF EXISTS billed_date,
DROP COLUMN IF EXISTS billing_type,
DROP COLUMN IF EXISTS description,
DROP COLUMN IF EXISTS front_end_url,
DROP COLUMN IF EXISTS license,
DROP COLUMN IF EXISTS online_confirmation_url,
DROP COLUMN IF EXISTS register_request,
DROP COLUMN IF EXISTS report_template_path,
DROP COLUMN IF EXISTS user_keys_expiration_period;

ALTER TABLE pc_keyinfo DROP COLUMN IF EXISTS need_to_use_fingerprint;

ALTER TABLE pc_delayedkeyinfo DROP COLUMN IF EXISTS need_to_use_fingerprint;
</syntaxhighlight>

= Проверка доступности сервисов =
Адреса конечных точек по умолчанию:
* PC Server:
<code>http://<host>:8080/ws/PayControlServiceV3?wsdl

http://<host>:8080/ws/PayControlReportService?wsdl</code>

* PC Pusher:
<code>http://<host>:8080/pc-pusher-api/health_check</code>

* PC External(при запросе на этот адрес должно возвратиться «Not Found»):
<code>http[s]://<host>:8080/PayControl-interaction-rest/</code>

= Включение имитовставки =

Способ включения выработки имитовставки описан в статье [[Включение формирования имитовставки]].

= Откат обновления в случае сбоя =
При возникновении проблем при обновлении необходимо:
*Удалить новые файлы модулей серверов и заменить их старыми файлами.
*При замене файлов необходимо проверить, что в директории ''deployments'' отсутствуют файлы с расширением undeployed.
*Восстановить БД PCS и PCIS Internal из резервной копии.
*Также нужно вернуть [[Обновление_PCIS_до_версии_3.7#Дополнительно, только для версии 3.5 | параметр]], отвечающий за работу PCS 3.5 с PCIS 3.7.

Обновление PayControl с 3.5 на 3.9

2024-06-25T13:52:53Z

D.bizyukov: /* Удаление ненужных полей */

В версии 3.8 реализовано взаимодействие с [[PC Pusher 5.2|PC Pusher 5.x]], который, в свою очередь, поддерживает отправку пуш-уведомлений на устройства Huawei. Обновлению с 3.5-3.7 подлежат модули PCS и PC External.

{{Предупреждение|Модуль PCIS Internal 3.5-3.7 подлежит замене на модуль PC Pusher 5.5. PCS с версии 3.8 не поддерживает работу с модулем PCIS Internal.}}

В версии 3.9 добавлена функциональность формирования имитовставки, для соответствия п.5.1 Положения Банка России от 17 апреля 2019 года N 683-П:

В целях обеспечения целостности электронных сообщений и подтверждения их составления уполномоченным на это лицом кредитные организации должны обеспечивать реализацию мер по использованию усиленной квалифицированной электронной подписи, усиленной неквалифицированной электронной подписи или СКЗИ, реализующих функцию имитозащиты информации с аутентификацией отправителя сообщения.

Модули сервера доступны по ссылкам:
* PC Server (https://repo.paycontrol.org/server/maven/tech/paycon/server/PayControl-services-module/), версия 3.9.xxx;
* PC External (https://repo.paycontrol.org/server/maven/tech/paycon/server/PayControl-interaction-rest/), версия 3.9.xxx;
* PC Pusher (https://repo.paycontrol.org/server/maven/tech/paycon/server/pc-pusher/), версия 5.5.xxx.

Если при обновлении сервера также необходимо обновить Wildfly, то перед обновлением '''необходимо''' остановить службу, убрать её из автозапуска.

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

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

При установке Java новой версии, старая версия не удаляется, и [[Wildfly]] может продолжить работать на версии 8, что приведёт к ошибкам. Для того чтобы компоненты работали под Java 11, необходимо либо удалить неактуальную версию Java, либо выбрать необходимую версию с помощью:

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

=Обновление компонентов PCS=
Для обновления нужно заменить файл приложения сервера <WF_PATH>\standalone\deployments\ на новый:
* на PCS - файл ''PayControl-services-module-<VERSION>.ear''

[[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|Остановите wildfly]].

==Отключение поддержки совместимости с PCS 3.5==
Для отключения в модуле PCIS External 3.7 режима совместимости с сервером версии 3.5 необходимо убрать из окружения Java параметр <code>paycontrol.pcsVersion</code> со значением <code>3.5</code>. Это можно сделать следующим образом:
* для Linux:
*: в файле /opt/wildfly/bin/standalone.conf удалить строку <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.pcsVersion=3.5"</syntaxhighlight>
* для Windows:
*: в файле C:\wildfly\bin\standalone.conf.bat удалить строку <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.pcsVersion=3.5"</syntaxhighlight>

==Изменения в БД==
*Для переноса параметров из pc_system в pc_system_params, что необходимо, при обновлении, нужно выполнить запрос:
<syntaxhighlight lang="sql">
INSERT INTO pc_system_params (systemid, created_at, is_deleted, updated_at, billed_date_request, billing_period, billed_date, billing_type, description, front_end_url, license, online_confirmation_url, register_request, report_template_path, user_keys_expiration_period)
SELECT systemid, created_at, is_deleted, updated_at, billed_date_request, billing_period, billed_date, billing_type, description, front_end_url, license, online_confirmation_url, register_request, report_template_path, user_keys_expiration_period
FROM pc_system;
</syntaxhighlight>
*Чтобы поправить настройки пользователей нужно выполнить запрос:
<syntaxhighlight lang="sql">
update pc_keyinfo set key_flags=0 where need_to_use_fingerprint=0;
update pc_keyinfo set key_flags=1 where need_to_use_fingerprint=1;
update pc_delayedkeyinfo set key_flags=0 where need_to_use_fingerprint=0;
update pc_delayedkeyinfo set key_flags=1 where need_to_use_fingerprint=1;
</syntaxhighlight>

==Запрос на регистрацию==
===Получение нового запроса===
Для получения нового запроса на регистрацию нужно выполнить запрос к БД PCS
<code>
select * from pc_system;
</code>, и обратиться с результатами запроса в компанию Сэйфтек.

===Замена запроса в БД===
В приведённом ниже запросе необходимо:
* заменить <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>

==Лицензия==
===Получение обновленной лицензии===
Для получения обновленной лицензии нужно выполнить запрос к БД PCS
<code>
select * from pc_system;
</code>, и обратиться с результатами запроса в компанию Сэйфтек.

===Замена лицензии в БД===
*На сервере PC Server, удалите файл(*.paycontrol.license) с лицензией, если такой есть.
*Выполните к БД PC Server запрос:
В приведённом ниже запросе необходимо:
# заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
# заменить <code>%LICENSE%</code> на реальные данные лицензии(*.paycontrol.license), созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных лицензии
<code><?xml version="1.0" encoding="UTF-8" standalone="yes"?><licenseInformationWithSignature xmlns="http://ws.safetech.ru/PayControl/services/ws/request/"><licenseInformation><systemId>48000c91-dd4a-47d5-9041-fd8d0a32c13b</systemId><validTo>2020-11-07T20:59:59.000Z</validTo><usersCount>100</usersCount></licenseInformation><signature>MEQCIDyHJwCnp7iLDSAllrcjVya+ukW6Ov1dJJiSXd8HIowBAiB8cEBnjhm3up1ui2pjp9oqx6GzxOfRCBG0EddiIqCIqA==</signature></licenseInformationWithSignature></code>
<syntaxhighlight lang="sql">
update pc_system_params set license='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=PCIS Internal и External=
==Для PCIS версии ниже, чем 3.7==
Этот пункт следует выполнять только в случае, если основной сервер PCS имеет версию 3.5, а серверы PCIS имеют версию ниже 3.7 - [[Обновление PCIS до версии 3.7|Обновление PCIS до версии 3.7]]

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

Для обновления необходимо заменить на серверах файл модуля PC External в директории ''deployments'' сервера приложений [[Wildfly]].

Он имеет название вида:
* PayControl-interaction-rest-3.x.x.war - PC External.
Перед заменой файлов [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|остановите Wildfly]].
Файлы сервера предыдущей версии настоятельно рекомендуем сохранить для возможности отката на предыдущую версию.

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

==Переход с PCIS Internal на PC Pusher==
===Замена файлов модулей===
{{Предупреждение|PC Pusher для своей работы не требует использования БД, в отличие от PCIS Internal.}}

Для обновления необходимо заменить на сервере файлы модуля PCIS Internal в директории deployments сервера приложений Wildfly. Файл имеют названия вида:

*PayControl-interaction-module-3.x.xxx.ear - PCIS Internal

Перед заменой файлов [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|остановите Wildfly]].
Файлы сервера предыдущей версии настоятельно рекомендуем сохранить для возможности отката на предыдущую версию.

*Новый файл имеет название вида: pc-pusher-5.5.xxx.war

После замены файлов и развёртывания новых, в директории deployments будут созданы файлы с названиями:

*.undeployed, где вместо * будет указано название убранного из директории файла модуля сервера. Файлы с расширением undeployed рекомендуется удалить.
*и с расширением *.deployed, где вместо * будут указаны названия новых модулей.
При появлении файлов с расширением *.failed, необходимо [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|перезапустить Wildfly]].
===Настройка PC Server для работы с PC Pusher===
После замены PCIS Internal на PC Pusher '''необходимо''' заменить его адрес в БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url='http[s]://pcphost:port/pc-pusher-api/';</syntaxhighlight>

Далее, '''необходимо''' предоставить доступ PC Pusher для отправки данных пушей в сервис HMS (Huawei Mobile Services).
При отправке push-сообщений, запросы должны отправляются по адресу https://push-api.cloud.huawei.com/ ,порт 443.

Также, с сервера PC Pusher '''должен''' быть доступен адрес: https://oauth-login.cloud.huawei.com/oauth2/v3/token

В случае, если PC Pusher находится на одном сервере с PC External, то '''необходимо''' перенастроить правила URL-фильтрации.

===Настройка PC Pusher===
Если для подтверждения транзакций используется приложение PayControl, то данная настройка не требуется.

По умолчанию, если app/bundle id для отправки пуш-уведомлений явно не указан для устройства, PCS 3.9 отправляет пуши в приложение PayControl Classic.

Для отправки пушей в другое приложения необходимо:
# Произвести настройки аутентификационных данных "другого" мобильного приложения в соответствии с [[PC_Pusher_5.2|этой статьей]]
# Прописать app/bundle id необходимого приложения в БД PCS(после выполнения запроса необходимо перезапустить Wildfly):
Пример: <syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'APP_ID_FOR_PUSHER', '{"Android":"com.example.mobile.app","iOS":"com.example.apple.app","Huawei":"com.example.apple.app"}');</syntaxhighlight>
Шаблоны:
* PostgreSQL <syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid","Huawei":"your_appid"}');</syntaxhighlight>
* MS SQL <syntaxhighlight lang="sql">insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid","Huawei":"your_appid"}');</syntaxhighlight>
* Oracle <syntaxhighlight lang="sql">insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid","Huawei":"your_appid"}');</syntaxhighlight>

= Завершение обновления =
После выполнения вышеизложенных пунктов нужно [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|запустить wildfly]].

==Правка последовательностей MS SQL==

Данный пункт нужно выполнить в том случае, если в вашей БД нет последовательностей\сиквенсов, описанных ниже, а вместо них используются таблицы.

Пример:
* Мы хотим создать сиквенс PC_ATTEMPT_SEQ
* Для этого идем в таблицу PC_ATTEMPT_SEQ
* Берем оттуда последнее значение id
* Добавляем в запрос на создание сиквенса вместо знака вопроса
* Переименовываем старую таблицу PC_ATTEMPT_SEQ
* Создаем сиквенс

Перед добавлением сиквенсов переименуйте старые таблицы:

<syntaxhighlight lang="sql">
sp_rename PC_ATTEMPT_SEQ, PC_ATTEMPT_SEQ_OLD;
sp_rename PC_DELAYEDKEYINFO_SEQ, PC_DELAYEDKEYINFO_SEQ_OLD;
sp_rename PC_DEVICE_SEQ, PC_DEVICE_SEQ_OLD;
sp_rename PC_KEYINFO_SEQ, PC_KEYINFO_SEQ_OLD;
sp_rename PC_PUBLICKEY_SEQ, PC_PUBLICKEY_SEQ_OLD;
sp_rename PC_SETTING_SEQ, PC_SETTING_SEQ_OLD;
sp_rename PC_EVENT_SEQ, PC_EVENT_SEQ_OLD;
</syntaxhighlight>

Теперь можно добавлять сиквенсы.

Список команд для добавления необходимых сиквенсов:

Знаки вопроса нужно заменить на последний id в таблице-сиквенсе с тем же названием.

<syntaxhighlight lang="sql">
create sequence PC_ATTEMPT_SEQ start with ? increment by 1;
create sequence PC_DELAYEDKEYINFO_SEQ start with ? increment by 1;
create sequence PC_DEVICE_SEQ start with ? increment by 1;
create sequence PC_KEYINFO_SEQ start with ? increment by 1;
create sequence PC_PUBLICKEY_SEQ start with ? increment by 1;
create sequence PC_SETTING_SEQ start with ? increment by 1;
create sequence PC_EVENT_SEQ start with ? increment by 1;
</syntaxhighlight>

== Удаление ненужных полей ==
'''Если''' у вас всё обновилось и '''точно''' работает, можно удалить не нужные поля от предыдущей версии, они больше не нужны, или перенесены.

Удалить не используемые столбцы можно с помощью запроса:
<syntaxhighlight lang="sql">
ALTER TABLE pc_system
DROP COLUMN IF EXISTS internal_cert_fingerprint,
DROP COLUMN IF EXISTS key_container,
DROP COLUMN IF EXISTS key_password,
DROP COLUMN IF EXISTS additional_key_options,
DROP COLUMN IF EXISTS key_type,
DROP COLUMN IF EXISTS system_type,
DROP COLUMN IF EXISTS billed_date_request,
DROP COLUMN IF EXISTS billing_period,
DROP COLUMN IF EXISTS billed_date,
DROP COLUMN IF EXISTS billing_type,
DROP COLUMN IF EXISTS description,
DROP COLUMN IF EXISTS front_end_url,
DROP COLUMN IF EXISTS license,
DROP COLUMN IF EXISTS online_confirmation_url,
DROP COLUMN IF EXISTS register_request,
DROP COLUMN IF EXISTS report_template_path,
DROP COLUMN IF EXISTS user_keys_expiration_period;

ALTER TABLE pc_keyinfo DROP COLUMN IF EXISTS need_to_use_fingerprint;

ALTER TABLE pc_delayedkeyinfo DROP COLUMN IF EXISTS need_to_use_fingerprint;
</syntaxhighlight>

= Проверка доступности сервисов =
Адреса конечных точек по умолчанию:
* PC Server:
<code>http://<host>:8080/ws/PayControlServiceV3?wsdl

http://<host>:8080/ws/PayControlReportService?wsdl</code>

* PC Pusher:
<code>http://<host>:8080/pc-pusher-api/health_check</code>

* PC External(при запросе на этот адрес должно возвратиться «Not Found»):
<code>http[s]://<host>:8080/PayControl-interaction-rest/</code>

= Включение имитовставки =

Способ включения выработки имитовставки описан в статье [[Включение формирования имитовставки]].

= Откат обновления в случае сбоя =
При возникновении проблем при обновлении необходимо:
*Удалить новые файлы модулей серверов и заменить их старыми файлами.
*При замене файлов необходимо проверить, что в директории ''deployments'' отсутствуют файлы с расширением undeployed.
*Восстановить БД PCS и PCIS Internal из резервной копии.
*Также нужно вернуть [[Обновление_PCIS_до_версии_3.7#Дополнительно, только для версии 3.5 | параметр]], отвечающий за работу PCS 3.5 с PCIS 3.7.

Обновление PayControl с 3.5 на 3.9

2024-06-25T13:45:37Z

D.bizyukov: /* Изменения в БД */

В версии 3.8 реализовано взаимодействие с [[PC Pusher 5.2|PC Pusher 5.x]], который, в свою очередь, поддерживает отправку пуш-уведомлений на устройства Huawei. Обновлению с 3.5-3.7 подлежат модули PCS и PC External.

{{Предупреждение|Модуль PCIS Internal 3.5-3.7 подлежит замене на модуль PC Pusher 5.5. PCS с версии 3.8 не поддерживает работу с модулем PCIS Internal.}}

В версии 3.9 добавлена функциональность формирования имитовставки, для соответствия п.5.1 Положения Банка России от 17 апреля 2019 года N 683-П:

В целях обеспечения целостности электронных сообщений и подтверждения их составления уполномоченным на это лицом кредитные организации должны обеспечивать реализацию мер по использованию усиленной квалифицированной электронной подписи, усиленной неквалифицированной электронной подписи или СКЗИ, реализующих функцию имитозащиты информации с аутентификацией отправителя сообщения.

Модули сервера доступны по ссылкам:
* PC Server (https://repo.paycontrol.org/server/maven/tech/paycon/server/PayControl-services-module/), версия 3.9.xxx;
* PC External (https://repo.paycontrol.org/server/maven/tech/paycon/server/PayControl-interaction-rest/), версия 3.9.xxx;
* PC Pusher (https://repo.paycontrol.org/server/maven/tech/paycon/server/pc-pusher/), версия 5.5.xxx.

Если при обновлении сервера также необходимо обновить Wildfly, то перед обновлением '''необходимо''' остановить службу, убрать её из автозапуска.

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

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

При установке Java новой версии, старая версия не удаляется, и [[Wildfly]] может продолжить работать на версии 8, что приведёт к ошибкам. Для того чтобы компоненты работали под Java 11, необходимо либо удалить неактуальную версию Java, либо выбрать необходимую версию с помощью:

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

=Обновление компонентов PCS=
Для обновления нужно заменить файл приложения сервера <WF_PATH>\standalone\deployments\ на новый:
* на PCS - файл ''PayControl-services-module-<VERSION>.ear''

[[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|Остановите wildfly]].

==Отключение поддержки совместимости с PCS 3.5==
Для отключения в модуле PCIS External 3.7 режима совместимости с сервером версии 3.5 необходимо убрать из окружения Java параметр <code>paycontrol.pcsVersion</code> со значением <code>3.5</code>. Это можно сделать следующим образом:
* для Linux:
*: в файле /opt/wildfly/bin/standalone.conf удалить строку <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.pcsVersion=3.5"</syntaxhighlight>
* для Windows:
*: в файле C:\wildfly\bin\standalone.conf.bat удалить строку <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.pcsVersion=3.5"</syntaxhighlight>

==Изменения в БД==
*Для переноса параметров из pc_system в pc_system_params, что необходимо, при обновлении, нужно выполнить запрос:
<syntaxhighlight lang="sql">
INSERT INTO pc_system_params (systemid, created_at, is_deleted, updated_at, billed_date_request, billing_period, billed_date, billing_type, description, front_end_url, license, online_confirmation_url, register_request, report_template_path, user_keys_expiration_period)
SELECT systemid, created_at, is_deleted, updated_at, billed_date_request, billing_period, billed_date, billing_type, description, front_end_url, license, online_confirmation_url, register_request, report_template_path, user_keys_expiration_period
FROM pc_system;
</syntaxhighlight>
*Чтобы поправить настройки пользователей нужно выполнить запрос:
<syntaxhighlight lang="sql">
update pc_keyinfo set key_flags=0 where need_to_use_fingerprint=0;
update pc_keyinfo set key_flags=1 where need_to_use_fingerprint=1;
update pc_delayedkeyinfo set key_flags=0 where need_to_use_fingerprint=0;
update pc_delayedkeyinfo set key_flags=1 where need_to_use_fingerprint=1;
</syntaxhighlight>

==Запрос на регистрацию==
===Получение нового запроса===
Для получения нового запроса на регистрацию нужно выполнить запрос к БД PCS
<code>
select * from pc_system;
</code>, и обратиться с результатами запроса в компанию Сэйфтек.

===Замена запроса в БД===
В приведённом ниже запросе необходимо:
* заменить <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>

==Лицензия==
===Получение обновленной лицензии===
Для получения обновленной лицензии нужно выполнить запрос к БД PCS
<code>
select * from pc_system;
</code>, и обратиться с результатами запроса в компанию Сэйфтек.

===Замена лицензии в БД===
*На сервере PC Server, удалите файл(*.paycontrol.license) с лицензией, если такой есть.
*Выполните к БД PC Server запрос:
В приведённом ниже запросе необходимо:
# заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
# заменить <code>%LICENSE%</code> на реальные данные лицензии(*.paycontrol.license), созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных лицензии
<code><?xml version="1.0" encoding="UTF-8" standalone="yes"?><licenseInformationWithSignature xmlns="http://ws.safetech.ru/PayControl/services/ws/request/"><licenseInformation><systemId>48000c91-dd4a-47d5-9041-fd8d0a32c13b</systemId><validTo>2020-11-07T20:59:59.000Z</validTo><usersCount>100</usersCount></licenseInformation><signature>MEQCIDyHJwCnp7iLDSAllrcjVya+ukW6Ov1dJJiSXd8HIowBAiB8cEBnjhm3up1ui2pjp9oqx6GzxOfRCBG0EddiIqCIqA==</signature></licenseInformationWithSignature></code>
<syntaxhighlight lang="sql">
update pc_system_params set license='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=PCIS Internal и External=
==Для PCIS версии ниже, чем 3.7==
Этот пункт следует выполнять только в случае, если основной сервер PCS имеет версию 3.5, а серверы PCIS имеют версию ниже 3.7 - [[Обновление PCIS до версии 3.7|Обновление PCIS до версии 3.7]]

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

Для обновления необходимо заменить на серверах файл модуля PC External в директории ''deployments'' сервера приложений [[Wildfly]].

Он имеет название вида:
* PayControl-interaction-rest-3.x.x.war - PC External.
Перед заменой файлов [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|остановите Wildfly]].
Файлы сервера предыдущей версии настоятельно рекомендуем сохранить для возможности отката на предыдущую версию.

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

==Переход с PCIS Internal на PC Pusher==
===Замена файлов модулей===
{{Предупреждение|PC Pusher для своей работы не требует использования БД, в отличие от PCIS Internal.}}

Для обновления необходимо заменить на сервере файлы модуля PCIS Internal в директории deployments сервера приложений Wildfly. Файл имеют названия вида:

*PayControl-interaction-module-3.x.xxx.ear - PCIS Internal

Перед заменой файлов [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|остановите Wildfly]].
Файлы сервера предыдущей версии настоятельно рекомендуем сохранить для возможности отката на предыдущую версию.

*Новый файл имеет название вида: pc-pusher-5.5.xxx.war

После замены файлов и развёртывания новых, в директории deployments будут созданы файлы с названиями:

*.undeployed, где вместо * будет указано название убранного из директории файла модуля сервера. Файлы с расширением undeployed рекомендуется удалить.
*и с расширением *.deployed, где вместо * будут указаны названия новых модулей.
При появлении файлов с расширением *.failed, необходимо [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|перезапустить Wildfly]].
===Настройка PC Server для работы с PC Pusher===
После замены PCIS Internal на PC Pusher '''необходимо''' заменить его адрес в БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url='http[s]://pcphost:port/pc-pusher-api/';</syntaxhighlight>

Далее, '''необходимо''' предоставить доступ PC Pusher для отправки данных пушей в сервис HMS (Huawei Mobile Services).
При отправке push-сообщений, запросы должны отправляются по адресу https://push-api.cloud.huawei.com/ ,порт 443.

Также, с сервера PC Pusher '''должен''' быть доступен адрес: https://oauth-login.cloud.huawei.com/oauth2/v3/token

В случае, если PC Pusher находится на одном сервере с PC External, то '''необходимо''' перенастроить правила URL-фильтрации.

===Настройка PC Pusher===
Если для подтверждения транзакций используется приложение PayControl, то данная настройка не требуется.

По умолчанию, если app/bundle id для отправки пуш-уведомлений явно не указан для устройства, PCS 3.9 отправляет пуши в приложение PayControl Classic.

Для отправки пушей в другое приложения необходимо:
# Произвести настройки аутентификационных данных "другого" мобильного приложения в соответствии с [[PC_Pusher_5.2|этой статьей]]
# Прописать app/bundle id необходимого приложения в БД PCS(после выполнения запроса необходимо перезапустить Wildfly):
Пример: <syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'APP_ID_FOR_PUSHER', '{"Android":"com.example.mobile.app","iOS":"com.example.apple.app","Huawei":"com.example.apple.app"}');</syntaxhighlight>
Шаблоны:
* PostgreSQL <syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid","Huawei":"your_appid"}');</syntaxhighlight>
* MS SQL <syntaxhighlight lang="sql">insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid","Huawei":"your_appid"}');</syntaxhighlight>
* Oracle <syntaxhighlight lang="sql">insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid","Huawei":"your_appid"}');</syntaxhighlight>

= Завершение обновления =
После выполнения вышеизложенных пунктов нужно [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|запустить wildfly]].

==Правка последовательностей MS SQL==

Данный пункт нужно выполнить в том случае, если в вашей БД нет последовательностей\сиквенсов, описанных ниже, а вместо них используются таблицы.

Пример:
* Мы хотим создать сиквенс PC_ATTEMPT_SEQ
* Для этого идем в таблицу PC_ATTEMPT_SEQ
* Берем оттуда последнее значение id
* Добавляем в запрос на создание сиквенса вместо знака вопроса
* Переименовываем старую таблицу PC_ATTEMPT_SEQ
* Создаем сиквенс

Перед добавлением сиквенсов переименуйте старые таблицы:

<syntaxhighlight lang="sql">
sp_rename PC_ATTEMPT_SEQ, PC_ATTEMPT_SEQ_OLD;
sp_rename PC_DELAYEDKEYINFO_SEQ, PC_DELAYEDKEYINFO_SEQ_OLD;
sp_rename PC_DEVICE_SEQ, PC_DEVICE_SEQ_OLD;
sp_rename PC_KEYINFO_SEQ, PC_KEYINFO_SEQ_OLD;
sp_rename PC_PUBLICKEY_SEQ, PC_PUBLICKEY_SEQ_OLD;
sp_rename PC_SETTING_SEQ, PC_SETTING_SEQ_OLD;
sp_rename PC_EVENT_SEQ, PC_EVENT_SEQ_OLD;
</syntaxhighlight>

Теперь можно добавлять сиквенсы.

Список команд для добавления необходимых сиквенсов:

Знаки вопроса нужно заменить на последний id в таблице-сиквенсе с тем же названием.

<syntaxhighlight lang="sql">
create sequence PC_ATTEMPT_SEQ start with ? increment by 1;
create sequence PC_DELAYEDKEYINFO_SEQ start with ? increment by 1;
create sequence PC_DEVICE_SEQ start with ? increment by 1;
create sequence PC_KEYINFO_SEQ start with ? increment by 1;
create sequence PC_PUBLICKEY_SEQ start with ? increment by 1;
create sequence PC_SETTING_SEQ start with ? increment by 1;
create sequence PC_EVENT_SEQ start with ? increment by 1;
</syntaxhighlight>

== Удаление ненужных полей ==
'''Если''' у вас всё обновилось и '''точно''' работает, можно удалить не нужные поля от предыдущей версии, они больше не нужны, или перенесены.

Удалить не используемые столбцы можно с помощью запроса:
<syntaxhighlight lang="sql">
ALTER TABLE pc_system
DROP COLUMN IF EXISTS internal_cert_fingerprint,
DROP COLUMN IF EXISTS key_container,
DROP COLUMN IF EXISTS key_password,
DROP COLUMN IF EXISTS additional_key_options,
DROP COLUMN IF EXISTS key_type,
DROP COLUMN IF EXISTS system_type,
DROP COLUMN IF EXISTS billed_date_request,
DROP COLUMN IF EXISTS billing_period,
DROP COLUMN IF EXISTS billed_date,
DROP COLUMN IF EXISTS billing_type,
DROP COLUMN IF EXISTS description,
DROP COLUMN IF EXISTS front_end_url,
DROP COLUMN IF EXISTS license,
DROP COLUMN IF EXISTS online_confirmation_url,
DROP COLUMN IF EXISTS register_request,
DROP COLUMN IF EXISTS report_template_path,
DROP COLUMN IF EXISTS user_keys_expiration_period;
</syntaxhighlight>

= Проверка доступности сервисов =
Адреса конечных точек по умолчанию:
* PC Server:
<code>http://<host>:8080/ws/PayControlServiceV3?wsdl

http://<host>:8080/ws/PayControlReportService?wsdl</code>

* PC Pusher:
<code>http://<host>:8080/pc-pusher-api/health_check</code>

* PC External(при запросе на этот адрес должно возвратиться «Not Found»):
<code>http[s]://<host>:8080/PayControl-interaction-rest/</code>

= Включение имитовставки =

Способ включения выработки имитовставки описан в статье [[Включение формирования имитовставки]].

= Откат обновления в случае сбоя =
При возникновении проблем при обновлении необходимо:
*Удалить новые файлы модулей серверов и заменить их старыми файлами.
*При замене файлов необходимо проверить, что в директории ''deployments'' отсутствуют файлы с расширением undeployed.
*Восстановить БД PCS и PCIS Internal из резервной копии.
*Также нужно вернуть [[Обновление_PCIS_до_версии_3.7#Дополнительно, только для версии 3.5 | параметр]], отвечающий за работу PCS 3.5 с PCIS 3.7.

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

2024-06-06T15:21:41Z

D.bizyukov: /* Правки для корректной отправки пушей */

= Введение =

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

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

== Java ==

Для работы обновленных модулей PC требуется JDK 11.

Версия Wildfly должна быть не выше 26.1.3.

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

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

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

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

== Для PCIS версии ниже 3.7 ==

Если версия PCS имеет версию 3.6, а серверы PCIS имеют версию ниже 3.7, то необходимо сначала произвести обновление до 3.7. Инструкция по обновлению доступна по [[PCWiki:Обновление PCIS до версии 3.7|ссылке]].

== Обновление компонентов серверов ==

Для обновления нужно [[Руководство_администратора_PayControl_v5#Запуск и остановка служб сервера PayControl|остановить сервис Wildfly]] и заменить файл приложения сервера <WF_PATH>\standalone\deployments\ на новый:
* на PCS - файл ''PayControl-services-module-<VERSION>.ear'' заменить на файл pc-server-<VERSION>.ear
* на PCIS Internal(PC Pusher после обновления) - файл ''PayControl-interaction-module-<VERSION>.ear'' заменить на файл pc-pusher-<VERSION>.war
* на PCIS External(PC External после обновления) - файл ''PayControl-interaction-rest-<VERSION>.war'' заменить на файл pc-external-<VERSION>.war

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

В файле <WF_HOME>/standalone/configuration/standalone.xml нужно найти и заменить:
* PayControlDS на PCServerDS
* PayControlISDS на PCPusherDS

== Корректировка (смена) адресов компонентов серверов 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>

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

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

=== Postgres ===

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

<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>

=== Oracle ===
Перед выполнением правок в БД PCS перезапустите Wildfly '''минимум два раза'''.

Должны создаться таблицы PC_CERTIFICATE, PC_CMS_SIGNATURE и PC_ONLINE_CREDENTIALS.

Когда эти таблицы появятся в БД, можно выполнять правки.

Если после нескольких перезапусков создались не все таблицы, то выполните правки, а затем, проверьте наличие недостающих таблиц.

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

<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_device modify (is_deleted not NULL);
alter table pc_device modify (is_deleted default 0);

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 varchar(64));
alter table pc_event drop column eventposturl;
alter table pc_event add (event_data clob);

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_publickey modify (is_deleted not NULL);
alter table pc_publickey modify (is_deleted default 0);

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 varchar(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 add (qr_url_scheme varchar(24));

alter table pc_user add (user_name varchar(255));
alter table pc_user add (blocked NUMBER(5,0));

alter table pc_system_params add (license_1 clob);
update pc_system_params set license_1 = license;
alter table pc_system_params drop column license;
alter table pc_system_params rename column license_1 to license;

alter table pc_transaction modify (is_deleted not NULL);
alter table pc_transaction modify (is_deleted default 0);
alter table pc_transaction add (operationid varchar(36));

alter table pc_user modify (is_deleted not NULL);
alter table pc_user modify (is_deleted default 0);

alter table pc_keyinfo add (external_approve_data_id varchar(255));

alter table pc_confirm_attempt add (data_hash_1 blob);
update pc_confirm_attempt set data_hash_1 = data_hash;
alter table pc_confirm_attempt drop column data_hash;
alter table pc_confirm_attempt rename column data_hash_1 to data_hash;

alter table pc_delayedkeyinfo add (key_content_1 blob);
update pc_delayedkeyinfo set key_content_1 = key_content;
alter table pc_delayedkeyinfo drop column key_content;
alter table pc_delayedkeyinfo rename column key_content_1 to key_content;

alter table pc_keyinfo add (key_content_1 blob);
update pc_keyinfo set key_content_1 = key_content;
alter table pc_keyinfo drop column key_content;
alter table pc_keyinfo rename column key_content_1 to key_content;

alter table pc_publickey add (public_key_1 blob);
update pc_publickey set public_key_1 = public_key;
alter table pc_publickey drop column public_key;
alter table pc_publickey rename column public_key_1 to public_key;

alter table pc_transaction add (data_hash_1 blob);
update pc_transaction set data_hash_1 = data_hash;
alter table pc_transaction drop column data_hash;
alter table pc_transaction rename column data_hash_1 to data_hash;

ALTER TABLE PC_TRANSACTION ADD (DATA_TR_TEXT clob);
ALTER TABLE PC_CONFIRM_ATTEMPT ADD (SCORING_RESULTS varchar(512));
ALTER TABLE PC_CONFIRM_ATTEMPT ADD (SCORING_SETTINGS varchar(512));
alter table PC_SYS_PROPERTY modify (SETTING_VALUE varchar(1023));
alter table PC_DELAYEDKEYINFO add (RENEW_CHALLENGE varchar(255));
ALTER TABLE PC_TRANSACTION ADD (EXT_PULP blob);
ALTER TABLE PC_TRANSACTION ADD (EXTENDED_CHECK NUMBER(5,0));
ALTER TABLE PC_TRANSACTION ADD (RENDER_TYPE NUMBER(10,0));
ALTER TABLE PC_TRANSACTION ADD (SCORING_SETTINGS varchar(1023));
ALTER TABLE PC_TRANSACTION ADD (SNIPPED_TEXT varchar(1023));
ALTER TABLE PC_TRANSACTION ADD (TRANSACTION_TYPE NUMBER(10,0));
ALTER TABLE PC_TRANSACTION ADD (SNIPPET_HASH blob);
ALTER TABLE PC_TRANSACTION ADD (AUTOSIGN_ENABLED NUMBER(5,0));
ALTER TABLE PC_DEVICE ADD (APP_ID varchar(255));
ALTER TABLE PC_PUBLICKEY ADD (AUTOSIGN_PUBLIC_KEY blob);
alter table PC_KEYINFO drop column GOST_IMIT_KEY;
alter table PC_KEYINFO add (GOST_IMIT_KEY blob);

## PCSB в запросах нужно заменить на имя вашей схемы и на имя вашего TABLESPACE, где идет указание именно TABLESPACE.

CREATE SEQUENCE PCSB.PC_EXTAUTH_SEQ INCREMENT BY 1 MINVALUE 1 MAXVALUE 9999999999999999999999999999 NOCYCLE CACHE 20 NOORDER;
CREATE SEQUENCE PCSB.PC_USERS_LICENSE_SEQ INCREMENT BY 1 MINVALUE 1 MAXVALUE 9999999999999999999999999999 NOCYCLE CACHE 20 NOORDER;

CREATE TABLE "PCSB"."PC_EXTAUTH"
( "EXTAUTHID" NUMBER(19,0) NOT NULL ENABLE,
"CREATED_AT" TIMESTAMP (6),
"IS_DELETED" NUMBER(5,0) DEFAULT 0 NOT NULL ENABLE,
"UPDATED_AT" TIMESTAMP (6),
"AUTH_TEMPLATE" VARCHAR2(2048 CHAR),
"EVENTID" NUMBER(19,0),
"USERID" VARCHAR2(64 CHAR),
"AUTH_FAIL_COUNT" NUMBER(*,0),
PRIMARY KEY ("EXTAUTHID")
USING INDEX PCTFREE 10 INITRANS 2 MAXTRANS 255 COMPUTE STATISTICS
TABLESPACE "PCSB" ENABLE,
CONSTRAINT "PC_EXTAUTH_EVENTID_FK" FOREIGN KEY ("EVENTID")
REFERENCES "PCSB"."PC_EVENT" ("EVENTID") ENABLE,
CONSTRAINT "PC_EXTAUTH_USERID_FK" FOREIGN KEY ("USERID")
REFERENCES "PCSB"."PC_USER" ("USERID") ENABLE
) SEGMENT CREATION DEFERRED
PCTFREE 10 PCTUSED 40 INITRANS 1 MAXTRANS 255
NOCOMPRESS LOGGING
TABLESPACE "PCSB" ;

CREATE TABLE "PCSB"."PC_USERS_LICENSING"
( "USERS_LICENSE_ID" NUMBER(19,0) NOT NULL ENABLE,
"CREATED_AT" TIMESTAMP (6),
"IS_DELETED" NUMBER(5,0) DEFAULT 0 NOT NULL ENABLE,
"UPDATED_AT" TIMESTAMP (6),
"LICENSED_AT" TIMESTAMP (6),
"LICENSED_TILL" TIMESTAMP (6),
"LICENSED_UID" VARCHAR2(255 CHAR),
"PC_SIGNATURE" VARCHAR2(255 CHAR),
"USERID" VARCHAR2(64 CHAR),
PRIMARY KEY ("USERS_LICENSE_ID")
USING INDEX PCTFREE 10 INITRANS 2 MAXTRANS 255 COMPUTE STATISTICS
TABLESPACE "PCSB" ENABLE,
CONSTRAINT "PC_USER_LICENSING_USERID_FK" FOREIGN KEY ("USERID")
REFERENCES "PCSB"."PC_USER" ("USERID") ENABLE
) SEGMENT CREATION DEFERRED
PCTFREE 10 PCTUSED 40 INITRANS 1 MAXTRANS 255
NOCOMPRESS LOGGING
TABLESPACE "PCSB" ;
</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>

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

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

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

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

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

* заменить <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>

==== Лицензия ====

Установите лицензию одним из приведённых в [https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/#установка-лицензии руководстве администратора PC] способов.

== Завершение обновления ==

После выполнения вышеизложенных пунктов нужно [[Руководство_администратора_PayControl_v5#Запуск и остановка служб сервера PayControl|запустить wildfly]].

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

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

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

=== Health Check ===

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

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

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

Остановите Wildfly.

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

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

При замене файлов необходимо проверить, что в директории ''deployments'' отсутствуют файлы с расширением undeployed.

== PCS. Настройка подключения с PC External ==
На сервере PCIS\PC External необходимо заменить часть строки с адресом сервера PCS (host и port заменить на реальные значения). Для этого:
* на Linux в файле ''<WF_PATH>/bin/standalone.conf'' нужно заменить <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpc_url=http://<host>:<port>/pc-api/ -Dpc_locale=ru"</syntaxhighlight> на строку <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3?wsdl -Duser.language=ru -Dpaycontrol.locale=ru"</syntaxhighlight>
* на Windows в файле ''<WF_PATH>/bin/standalone.conf.bat'' нужно заменить <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpc_url=http://<host>:<port>/pc-api/ -Dpc_locale=ru"</syntaxhighlight> '''выше''' метки :JAVA_OPTS_SET на строку <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3?wsdl -Duser.language=ru -Dpaycontrol.locale=ru"</syntaxhighlight>

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

2024-06-06T15:06:11Z

D.bizyukov: /* Oracle */

= Введение =

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

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

== Java ==

Для работы обновленных модулей PC требуется JDK 11.

Версия Wildfly должна быть не выше 26.1.3.

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

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

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

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

== Для PCIS версии ниже 3.7 ==

Если версия PCS имеет версию 3.6, а серверы PCIS имеют версию ниже 3.7, то необходимо сначала произвести обновление до 3.7. Инструкция по обновлению доступна по [[PCWiki:Обновление PCIS до версии 3.7|ссылке]].

== Обновление компонентов серверов ==

Для обновления нужно [[Руководство_администратора_PayControl_v5#Запуск и остановка служб сервера PayControl|остановить сервис Wildfly]] и заменить файл приложения сервера <WF_PATH>\standalone\deployments\ на новый:
* на PCS - файл ''PayControl-services-module-<VERSION>.ear'' заменить на файл pc-server-<VERSION>.ear
* на PCIS Internal(PC Pusher после обновления) - файл ''PayControl-interaction-module-<VERSION>.ear'' заменить на файл pc-pusher-<VERSION>.war
* на PCIS External(PC External после обновления) - файл ''PayControl-interaction-rest-<VERSION>.war'' заменить на файл pc-external-<VERSION>.war

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

В файле <WF_HOME>/standalone/configuration/standalone.xml нужно найти и заменить:
* PayControlDS на PCServerDS
* PayControlISDS на PCPusherDS

== Корректировка (смена) адресов компонентов серверов 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>

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

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

=== Postgres ===

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

<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>

=== Oracle ===
Перед выполнением правок в БД PCS перезапустите Wildfly '''минимум два раза'''.

Должны создаться таблицы PC_CERTIFICATE, PC_CMS_SIGNATURE и PC_ONLINE_CREDENTIALS.

Когда эти таблицы появятся в БД, можно выполнять правки.

Если после нескольких перезапусков создались не все таблицы, то выполните правки, а затем, проверьте наличие недостающих таблиц.

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

<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_device modify (is_deleted not NULL);
alter table pc_device modify (is_deleted default 0);

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 varchar(64));
alter table pc_event drop column eventposturl;
alter table pc_event add (event_data clob);

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_publickey modify (is_deleted not NULL);
alter table pc_publickey modify (is_deleted default 0);

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 varchar(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 add (qr_url_scheme varchar(24));

alter table pc_user add (user_name varchar(255));
alter table pc_user add (blocked NUMBER(5,0));

alter table pc_system_params add (license_1 clob);
update pc_system_params set license_1 = license;
alter table pc_system_params drop column license;
alter table pc_system_params rename column license_1 to license;

alter table pc_transaction modify (is_deleted not NULL);
alter table pc_transaction modify (is_deleted default 0);
alter table pc_transaction add (operationid varchar(36));

alter table pc_user modify (is_deleted not NULL);
alter table pc_user modify (is_deleted default 0);

alter table pc_keyinfo add (external_approve_data_id varchar(255));

alter table pc_confirm_attempt add (data_hash_1 blob);
update pc_confirm_attempt set data_hash_1 = data_hash;
alter table pc_confirm_attempt drop column data_hash;
alter table pc_confirm_attempt rename column data_hash_1 to data_hash;

alter table pc_delayedkeyinfo add (key_content_1 blob);
update pc_delayedkeyinfo set key_content_1 = key_content;
alter table pc_delayedkeyinfo drop column key_content;
alter table pc_delayedkeyinfo rename column key_content_1 to key_content;

alter table pc_keyinfo add (key_content_1 blob);
update pc_keyinfo set key_content_1 = key_content;
alter table pc_keyinfo drop column key_content;
alter table pc_keyinfo rename column key_content_1 to key_content;

alter table pc_publickey add (public_key_1 blob);
update pc_publickey set public_key_1 = public_key;
alter table pc_publickey drop column public_key;
alter table pc_publickey rename column public_key_1 to public_key;

alter table pc_transaction add (data_hash_1 blob);
update pc_transaction set data_hash_1 = data_hash;
alter table pc_transaction drop column data_hash;
alter table pc_transaction rename column data_hash_1 to data_hash;

ALTER TABLE PC_TRANSACTION ADD (DATA_TR_TEXT clob);
ALTER TABLE PC_CONFIRM_ATTEMPT ADD (SCORING_RESULTS varchar(512));
ALTER TABLE PC_CONFIRM_ATTEMPT ADD (SCORING_SETTINGS varchar(512));
alter table PC_SYS_PROPERTY modify (SETTING_VALUE varchar(1023));
alter table PC_DELAYEDKEYINFO add (RENEW_CHALLENGE varchar(255));
ALTER TABLE PC_TRANSACTION ADD (EXT_PULP blob);
ALTER TABLE PC_TRANSACTION ADD (EXTENDED_CHECK NUMBER(5,0));
ALTER TABLE PC_TRANSACTION ADD (RENDER_TYPE NUMBER(10,0));
ALTER TABLE PC_TRANSACTION ADD (SCORING_SETTINGS varchar(1023));
ALTER TABLE PC_TRANSACTION ADD (SNIPPED_TEXT varchar(1023));
ALTER TABLE PC_TRANSACTION ADD (TRANSACTION_TYPE NUMBER(10,0));
ALTER TABLE PC_TRANSACTION ADD (SNIPPET_HASH blob);
ALTER TABLE PC_TRANSACTION ADD (AUTOSIGN_ENABLED NUMBER(5,0));
ALTER TABLE PC_DEVICE ADD (APP_ID varchar(255));
ALTER TABLE PC_PUBLICKEY ADD (AUTOSIGN_PUBLIC_KEY blob);
alter table PC_KEYINFO drop column GOST_IMIT_KEY;
alter table PC_KEYINFO add (GOST_IMIT_KEY blob);

## PCSB в запросах нужно заменить на имя вашей схемы и на имя вашего TABLESPACE, где идет указание именно TABLESPACE.

CREATE SEQUENCE PCSB.PC_EXTAUTH_SEQ INCREMENT BY 1 MINVALUE 1 MAXVALUE 9999999999999999999999999999 NOCYCLE CACHE 20 NOORDER;
CREATE SEQUENCE PCSB.PC_USERS_LICENSE_SEQ INCREMENT BY 1 MINVALUE 1 MAXVALUE 9999999999999999999999999999 NOCYCLE CACHE 20 NOORDER;

CREATE TABLE "PCSB"."PC_EXTAUTH"
( "EXTAUTHID" NUMBER(19,0) NOT NULL ENABLE,
"CREATED_AT" TIMESTAMP (6),
"IS_DELETED" NUMBER(5,0) DEFAULT 0 NOT NULL ENABLE,
"UPDATED_AT" TIMESTAMP (6),
"AUTH_TEMPLATE" VARCHAR2(2048 CHAR),
"EVENTID" NUMBER(19,0),
"USERID" VARCHAR2(64 CHAR),
"AUTH_FAIL_COUNT" NUMBER(*,0),
PRIMARY KEY ("EXTAUTHID")
USING INDEX PCTFREE 10 INITRANS 2 MAXTRANS 255 COMPUTE STATISTICS
TABLESPACE "PCSB" ENABLE,
CONSTRAINT "PC_EXTAUTH_EVENTID_FK" FOREIGN KEY ("EVENTID")
REFERENCES "PCSB"."PC_EVENT" ("EVENTID") ENABLE,
CONSTRAINT "PC_EXTAUTH_USERID_FK" FOREIGN KEY ("USERID")
REFERENCES "PCSB"."PC_USER" ("USERID") ENABLE
) SEGMENT CREATION DEFERRED
PCTFREE 10 PCTUSED 40 INITRANS 1 MAXTRANS 255
NOCOMPRESS LOGGING
TABLESPACE "PCSB" ;

CREATE TABLE "PCSB"."PC_USERS_LICENSING"
( "USERS_LICENSE_ID" NUMBER(19,0) NOT NULL ENABLE,
"CREATED_AT" TIMESTAMP (6),
"IS_DELETED" NUMBER(5,0) DEFAULT 0 NOT NULL ENABLE,
"UPDATED_AT" TIMESTAMP (6),
"LICENSED_AT" TIMESTAMP (6),
"LICENSED_TILL" TIMESTAMP (6),
"LICENSED_UID" VARCHAR2(255 CHAR),
"PC_SIGNATURE" VARCHAR2(255 CHAR),
"USERID" VARCHAR2(64 CHAR),
PRIMARY KEY ("USERS_LICENSE_ID")
USING INDEX PCTFREE 10 INITRANS 2 MAXTRANS 255 COMPUTE STATISTICS
TABLESPACE "PCSB" ENABLE,
CONSTRAINT "PC_USER_LICENSING_USERID_FK" FOREIGN KEY ("USERID")
REFERENCES "PCSB"."PC_USER" ("USERID") ENABLE
) SEGMENT CREATION DEFERRED
PCTFREE 10 PCTUSED 40 INITRANS 1 MAXTRANS 255
NOCOMPRESS LOGGING
TABLESPACE "PCSB" ;
</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>

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

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

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

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

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

* заменить <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>

==== Лицензия ====

Установите лицензию одним из приведённых в [https://repo.paycontrol.org/server/doc/latest/pc-admin-guide/ru/#установка-лицензии руководстве администратора PC] способов.

== Завершение обновления ==

После выполнения вышеизложенных пунктов нужно [[Руководство_администратора_PayControl_v5#Запуск и остановка служб сервера PayControl|запустить wildfly]].

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

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

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

=== Health Check ===

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

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

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

Остановите Wildfly.

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

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

При замене файлов необходимо проверить, что в директории ''deployments'' отсутствуют файлы с расширением undeployed.

== PCS. Настройка подключения с PC External ==
На сервере PCIS\PC External необходимо заменить часть строки с адресом сервера PCS (host и port заменить на реальные значения). Для этого:
* на Linux в файле ''<WF_PATH>/bin/standalone.conf'' нужно заменить <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpc_url=http://<host>:<port>/pc-api/ -Dpc_locale=ru"</syntaxhighlight> на строку <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3?wsdl -Duser.language=ru -Dpaycontrol.locale=ru"</syntaxhighlight>
* на Windows в файле ''<WF_PATH>/bin/standalone.conf.bat'' нужно заменить <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpc_url=http://<host>:<port>/pc-api/ -Dpc_locale=ru"</syntaxhighlight> '''выше''' метки :JAVA_OPTS_SET на строку <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3?wsdl -Duser.language=ru -Dpaycontrol.locale=ru"</syntaxhighlight>

Обновление PayControl с 3.5 на 3.9

2024-06-04T09:54:06Z

D.bizyukov: /* Отключение поддержки совместимости с PCS 3.5 */

В версии 3.8 реализовано взаимодействие с [[PC Pusher 5.2|PC Pusher 5.x]], который, в свою очередь, поддерживает отправку пуш-уведомлений на устройства Huawei. Обновлению с 3.5-3.7 подлежат модули PCS и PC External.

{{Предупреждение|Модуль PCIS Internal 3.5-3.7 подлежит замене на модуль PC Pusher 5.5. PCS с версии 3.8 не поддерживает работу с модулем PCIS Internal.}}

В версии 3.9 добавлена функциональность формирования имитовставки, для соответствия п.5.1 Положения Банка России от 17 апреля 2019 года N 683-П:

В целях обеспечения целостности электронных сообщений и подтверждения их составления уполномоченным на это лицом кредитные организации должны обеспечивать реализацию мер по использованию усиленной квалифицированной электронной подписи, усиленной неквалифицированной электронной подписи или СКЗИ, реализующих функцию имитозащиты информации с аутентификацией отправителя сообщения.

Модули сервера доступны по ссылкам:
* PC Server (https://repo.paycontrol.org/server/maven/tech/paycon/server/PayControl-services-module/), версия 3.9.xxx;
* PC External (https://repo.paycontrol.org/server/maven/tech/paycon/server/PayControl-interaction-rest/), версия 3.9.xxx;
* PC Pusher (https://repo.paycontrol.org/server/maven/tech/paycon/server/pc-pusher/), версия 5.5.xxx.

Если при обновлении сервера также необходимо обновить Wildfly, то перед обновлением '''необходимо''' остановить службу, убрать её из автозапуска.

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

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

При установке Java новой версии, старая версия не удаляется, и [[Wildfly]] может продолжить работать на версии 8, что приведёт к ошибкам. Для того чтобы компоненты работали под Java 11, необходимо либо удалить неактуальную версию Java, либо выбрать необходимую версию с помощью:

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

=Обновление компонентов PCS=
Для обновления нужно заменить файл приложения сервера <WF_PATH>\standalone\deployments\ на новый:
* на PCS - файл ''PayControl-services-module-<VERSION>.ear''

[[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|Остановите wildfly]].

==Отключение поддержки совместимости с PCS 3.5==
Для отключения в модуле PCIS External 3.7 режима совместимости с сервером версии 3.5 необходимо убрать из окружения Java параметр <code>paycontrol.pcsVersion</code> со значением <code>3.5</code>. Это можно сделать следующим образом:
* для Linux:
*: в файле /opt/wildfly/bin/standalone.conf удалить строку <syntaxhighlight lang="bash">JAVA_OPTS="$JAVA_OPTS -Dpaycontrol.pcsVersion=3.5"</syntaxhighlight>
* для Windows:
*: в файле C:\wildfly\bin\standalone.conf.bat удалить строку <syntaxhighlight lang="bat">set "JAVA_OPTS=%JAVA_OPTS% -Dpaycontrol.pcsVersion=3.5"</syntaxhighlight>

==Изменения в БД==
*Для переноса параметров из pc_system в pc_system_params, что необходимо, при обновлении, нужно выполнить запрос:
<syntaxhighlight lang="sql">
INSERT INTO pc_system_params (systemid, created_at, is_deleted, updated_at, billed_date_request, billing_period, billed_date, billing_type, description, front_end_url, license, online_confirmation_url, register_request, report_template_path, user_keys_expiration_period)
SELECT systemid, created_at, is_deleted, updated_at, billed_date_request, billing_period, billed_date, billing_type, description, front_end_url, license, online_confirmation_url, register_request, report_template_path, user_keys_expiration_period
FROM pc_system;
</syntaxhighlight>
*Чтобы поправить настройки пользователей нужно выполнить запрос:
<syntaxhighlight lang="sql">
update pc_keyinfo set key_flags=0 where need_to_use_fingerprint=0;
update pc_keyinfo set key_flags=1 where need_to_use_fingerprint=1;
</syntaxhighlight>

==Запрос на регистрацию==
===Получение нового запроса===
Для получения нового запроса на регистрацию нужно выполнить запрос к БД PCS
<code>
select * from pc_system;
</code>, и обратиться с результатами запроса в компанию Сэйфтек.

===Замена запроса в БД===
В приведённом ниже запросе необходимо:
* заменить <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>

==Лицензия==
===Получение обновленной лицензии===
Для получения обновленной лицензии нужно выполнить запрос к БД PCS
<code>
select * from pc_system;
</code>, и обратиться с результатами запроса в компанию Сэйфтек.

===Замена лицензии в БД===
*На сервере PC Server, удалите файл(*.paycontrol.license) с лицензией, если такой есть.
*Выполните к БД PC Server запрос:
В приведённом ниже запросе необходимо:
# заменить <code>%SYSTEMID%</code> на реальное значение systemid зарегистрированное для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
# заменить <code>%LICENSE%</code> на реальные данные лицензии(*.paycontrol.license), созданной для Вашей прикладной системы. Обратите внимание, что знаки процента '''нужно удалить''';
** пример нужных данных лицензии
<code><?xml version="1.0" encoding="UTF-8" standalone="yes"?><licenseInformationWithSignature xmlns="http://ws.safetech.ru/PayControl/services/ws/request/"><licenseInformation><systemId>48000c91-dd4a-47d5-9041-fd8d0a32c13b</systemId><validTo>2020-11-07T20:59:59.000Z</validTo><usersCount>100</usersCount></licenseInformation><signature>MEQCIDyHJwCnp7iLDSAllrcjVya+ukW6Ov1dJJiSXd8HIowBAiB8cEBnjhm3up1ui2pjp9oqx6GzxOfRCBG0EddiIqCIqA==</signature></licenseInformationWithSignature></code>
<syntaxhighlight lang="sql">
update pc_system_params set license='%LICENSE%' where systemid='%SYSTEMID%';
</syntaxhighlight>

=PCIS Internal и External=
==Для PCIS версии ниже, чем 3.7==
Этот пункт следует выполнять только в случае, если основной сервер PCS имеет версию 3.5, а серверы PCIS имеют версию ниже 3.7 - [[Обновление PCIS до версии 3.7|Обновление PCIS до версии 3.7]]

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

Для обновления необходимо заменить на серверах файл модуля PC External в директории ''deployments'' сервера приложений [[Wildfly]].

Он имеет название вида:
* PayControl-interaction-rest-3.x.x.war - PC External.
Перед заменой файлов [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|остановите Wildfly]].
Файлы сервера предыдущей версии настоятельно рекомендуем сохранить для возможности отката на предыдущую версию.

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

==Переход с PCIS Internal на PC Pusher==
===Замена файлов модулей===
{{Предупреждение|PC Pusher для своей работы не требует использования БД, в отличие от PCIS Internal.}}

Для обновления необходимо заменить на сервере файлы модуля PCIS Internal в директории deployments сервера приложений Wildfly. Файл имеют названия вида:

*PayControl-interaction-module-3.x.xxx.ear - PCIS Internal

Перед заменой файлов [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|остановите Wildfly]].
Файлы сервера предыдущей версии настоятельно рекомендуем сохранить для возможности отката на предыдущую версию.

*Новый файл имеет название вида: pc-pusher-5.5.xxx.war

После замены файлов и развёртывания новых, в директории deployments будут созданы файлы с названиями:

*.undeployed, где вместо * будет указано название убранного из директории файла модуля сервера. Файлы с расширением undeployed рекомендуется удалить.
*и с расширением *.deployed, где вместо * будут указаны названия новых модулей.
При появлении файлов с расширением *.failed, необходимо [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|перезапустить Wildfly]].
===Настройка PC Server для работы с PC Pusher===
После замены PCIS Internal на PC Pusher '''необходимо''' заменить его адрес в БД PCS:
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url='http[s]://pcphost:port/pc-pusher-api/';</syntaxhighlight>

Далее, '''необходимо''' предоставить доступ PC Pusher для отправки данных пушей в сервис HMS (Huawei Mobile Services).
При отправке push-сообщений, запросы должны отправляются по адресу https://push-api.cloud.huawei.com/ ,порт 443.

Также, с сервера PC Pusher '''должен''' быть доступен адрес: https://oauth-login.cloud.huawei.com/oauth2/v3/token

В случае, если PC Pusher находится на одном сервере с PC External, то '''необходимо''' перенастроить правила URL-фильтрации.

===Настройка PC Pusher===
Если для подтверждения транзакций используется приложение PayControl, то данная настройка не требуется.

По умолчанию, если app/bundle id для отправки пуш-уведомлений явно не указан для устройства, PCS 3.9 отправляет пуши в приложение PayControl Classic.

Для отправки пушей в другое приложения необходимо:
# Произвести настройки аутентификационных данных "другого" мобильного приложения в соответствии с [[PC_Pusher_5.2|этой статьей]]
# Прописать app/bundle id необходимого приложения в БД PCS(после выполнения запроса необходимо перезапустить Wildfly):
Пример: <syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'APP_ID_FOR_PUSHER', '{"Android":"com.example.mobile.app","iOS":"com.example.apple.app","Huawei":"com.example.apple.app"}');</syntaxhighlight>
Шаблоны:
* PostgreSQL <syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid","Huawei":"your_appid"}');</syntaxhighlight>
* MS SQL <syntaxhighlight lang="sql">insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid","Huawei":"your_appid"}');</syntaxhighlight>
* Oracle <syntaxhighlight lang="sql">insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid","Huawei":"your_appid"}');</syntaxhighlight>

= Завершение обновления =
После выполнения вышеизложенных пунктов нужно [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|запустить wildfly]].

==Правка последовательностей MS SQL==

Данный пункт нужно выполнить в том случае, если в вашей БД нет последовательностей\сиквенсов, описанных ниже, а вместо них используются таблицы.

Пример:
* Мы хотим создать сиквенс PC_ATTEMPT_SEQ
* Для этого идем в таблицу PC_ATTEMPT_SEQ
* Берем оттуда последнее значение id
* Добавляем в запрос на создание сиквенса вместо знака вопроса
* Переименовываем старую таблицу PC_ATTEMPT_SEQ
* Создаем сиквенс

Перед добавлением сиквенсов переименуйте старые таблицы:

<syntaxhighlight lang="sql">
sp_rename PC_ATTEMPT_SEQ, PC_ATTEMPT_SEQ_OLD;
sp_rename PC_DELAYEDKEYINFO_SEQ, PC_DELAYEDKEYINFO_SEQ_OLD;
sp_rename PC_DEVICE_SEQ, PC_DEVICE_SEQ_OLD;
sp_rename PC_KEYINFO_SEQ, PC_KEYINFO_SEQ_OLD;
sp_rename PC_PUBLICKEY_SEQ, PC_PUBLICKEY_SEQ_OLD;
sp_rename PC_SETTING_SEQ, PC_SETTING_SEQ_OLD;
sp_rename PC_EVENT_SEQ, PC_EVENT_SEQ_OLD;
</syntaxhighlight>

Теперь можно добавлять сиквенсы.

Список команд для добавления необходимых сиквенсов:

Знаки вопроса нужно заменить на последний id в таблице-сиквенсе с тем же названием.

<syntaxhighlight lang="sql">
create sequence PC_ATTEMPT_SEQ start with ? increment by 1;
create sequence PC_DELAYEDKEYINFO_SEQ start with ? increment by 1;
create sequence PC_DEVICE_SEQ start with ? increment by 1;
create sequence PC_KEYINFO_SEQ start with ? increment by 1;
create sequence PC_PUBLICKEY_SEQ start with ? increment by 1;
create sequence PC_SETTING_SEQ start with ? increment by 1;
create sequence PC_EVENT_SEQ start with ? increment by 1;
</syntaxhighlight>

== Удаление ненужных полей ==
'''Если''' у вас всё обновилось и '''точно''' работает, можно удалить не нужные поля от предыдущей версии, они больше не нужны, или перенесены.

Удалить не используемые столбцы можно с помощью запроса:
<syntaxhighlight lang="sql">
ALTER TABLE pc_system
DROP COLUMN IF EXISTS internal_cert_fingerprint,
DROP COLUMN IF EXISTS key_container,
DROP COLUMN IF EXISTS key_password,
DROP COLUMN IF EXISTS additional_key_options,
DROP COLUMN IF EXISTS key_type,
DROP COLUMN IF EXISTS system_type,
DROP COLUMN IF EXISTS billed_date_request,
DROP COLUMN IF EXISTS billing_period,
DROP COLUMN IF EXISTS billed_date,
DROP COLUMN IF EXISTS billing_type,
DROP COLUMN IF EXISTS description,
DROP COLUMN IF EXISTS front_end_url,
DROP COLUMN IF EXISTS license,
DROP COLUMN IF EXISTS online_confirmation_url,
DROP COLUMN IF EXISTS register_request,
DROP COLUMN IF EXISTS report_template_path,
DROP COLUMN IF EXISTS user_keys_expiration_period;
</syntaxhighlight>

= Проверка доступности сервисов =
Адреса конечных точек по умолчанию:
* PC Server:
<code>http://<host>:8080/ws/PayControlServiceV3?wsdl

http://<host>:8080/ws/PayControlReportService?wsdl</code>

* PC Pusher:
<code>http://<host>:8080/pc-pusher-api/health_check</code>

* PC External(при запросе на этот адрес должно возвратиться «Not Found»):
<code>http[s]://<host>:8080/PayControl-interaction-rest/</code>

= Включение имитовставки =

Способ включения выработки имитовставки описан в статье [[Включение формирования имитовставки]].

= Откат обновления в случае сбоя =
При возникновении проблем при обновлении необходимо:
*Удалить новые файлы модулей серверов и заменить их старыми файлами.
*При замене файлов необходимо проверить, что в директории ''deployments'' отсутствуют файлы с расширением undeployed.
*Восстановить БД PCS и PCIS Internal из резервной копии.
*Также нужно вернуть [[Обновление_PCIS_до_версии_3.7#Дополнительно, только для версии 3.5 | параметр]], отвечающий за работу PCS 3.5 с PCIS 3.7.

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

2024-06-03T13:27: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, при их возникновении.

Файлы журналов за текущий день доступны по следующему пути:
* 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>

==Linux==
Файл лицензии необходимо скопировать в /opt/wildfly/ на сервер PCS.
==Windows==
===Запросом к БД===
Для установки лицензии необходимо выполнить 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 в одну из папок:

*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 при их наличии.
[[Категория:Руководства]]
[[Категория:Серверная часть]]

Push-уведомления

2024-02-19T07:52:19Z

D.bizyukov: /* Актуальный API */

Push-сообщения могут отправляться через [[Сервер PayControl|PCIS Internal]], либо через PayControl Inform.
=Аутентификация=
Для отправки push-уведомлений требуется аутентификация.
==Перечисление аутентификационных данных==
===Android===
* Google API Key
===iOS===
Для аутентификации используется либо ключ (p8), либо сертификат (p12).
====p8====
Аутентификация посредством ключевого файла. Ключ имеет неограниченный срок действия. Требуются следующие данные:
* ключевой файл в формате p8;
* APNS App ID,
* APNS Key ID,
* APNS Team ID.
====p12====
Аутентификация посредством сертификата, имеющего ограниченный срок действия. Требуются следующие данные:
* APNS App ID,
* сертификат в формате контейнера p12,
* пароль для доступа к закрытой части ключа в контейнере.
==Установка аутентификационных данных==
Перед внесением необходимо заменить %SYSTEMID% на идентификатор системы.
===Сервер PayControl 3.6===
Аутентификационные данные для приложения PayControl:
<syntaxhighlight lang="sql">INSERT INTO pc_push_credentials (
systemid,
google_api_key,
use_ios_fcm,
apns_app_id,
apns_key_file,
apns_key_id,
apns_team_id)
VALUES (
'%SYSTEMID%',
'AAAAZJTm6y0:APA91bF1OQYv9T2opZtIMJPZknA7tGLifzvTVB3PFSlQejBzPzyeYg4JFn-nud5mE_pZe920I2zR-8Lv-yabeaJ8PdduS96G3ESj_pfxAJAhaT1JistaXMchspMkPLL0e8tLxCmBzhda',
'0',
'ru.safe-tech.PayControl.v3',
'/opt/wildfly/safetech-apns-JVBQX52N5Z.p8',
'JVBQX52N5Z',
'48HZH4RWJD');</syntaxhighlight>

===Сервер PayControl 3.7 и 5.1===
====Структура записи====
<syntaxhighlight lang="sql">
INSERT INTO pc_split_pusher_credentials (
id,
appid,
credentials,
is_default,
os,
systemid,
templates,
use_ios_fcm)
VALUES (
nextval('pc_split_pusher_creds_seq'),
'org.payconfirm.app',
'{"google_api_key":"AAAAPvs4KBA:APA91bEEv_nwmSQZPDBGh0gn2PwqRQusHJNdlekZ-eKcj8IYrm18EcXwJ1wt6nUEOavGcVjPuXJmfhV_9oS6VNbtKjyQSqBb3HHMnJZp6FauWz6hWpVcqsbenqkgamFgCAl1Exrd3JV_"}',
0,
'Android',
'%SYSTEMID%',
'{"messages":[{"to":"%DEVICE_TOKEN%","notification":{"tag":"%USER_ID%","title":"PayControl","body":"%PUSH_TEXT%","icon":"paycontrol_push","sound":"default"},"data":{"type":"PayControl_v2"}},{"to":"%DEVICE_TOKEN%","data": {"type": "PayControl_v2", "userid": "%USER_ID%"}}]}',
0);
</syntaxhighlight>
====== Поле credentials для iOS ======
<syntaxhighlight lang="json">
{
"apns_key_file": "/opt/wildfly/safetech-apns-JVBQX52N5Z.p8",
"apns_key_id": "JVBQX52N5Z",
"apns_team_id": "48HZH4RWJD",
"apnsP12File" : "/opt/wildfly/certificate.p12",
"apnsP12Pass" : "************",
"use_dev_gate": false
}
</syntaxhighlight>

===== Поле templates iOS =====
<syntaxhighlight lang="json">
{
"messages": [
{
"aps": {
"alert": "%PUSH_TEXT%",
"sound": "%PUSH_SOUND%",
"badge": "%PUSH_IOS_BADGE%"
},
"type": "%PUSH_TYPE%",
"userid": "%USER_ID%",

"pc_notification_type" : "alert/background",
"pc_notification_priority" : 10,
"pc_notification_timeout": 600,
"pc_collapse_id": "%USER_ID%"
}
]
}
</syntaxhighlight>
Параметры с версии 3.7.398
* pc_notification_type
* pc_notification_priority
* pc_notification_timeout
* ''pc_collapse_id (с 5.0.110?)''
задают соответственно
* apns-push-type. Возможные значения alert/background/voip/complication/fileprovider/mdm. По-умолчанию alert.
* apns-priority. Возможные значения 5 или 10. По-умолчанию 10.
* apns-expiration. Задаётся в секундах. Максимально возможное значение в секундах 2147483647. По-умолчанию не передаётся.
* ''apns-collapse-id. Значение, по которому будут группироваться и очищаться пуши (с 5.0.110?)''.
pc_notification_timeout влияет на установку значение apns-expiration, вычисляющегося как (текущее значение UnixTime)+APNS_EXPIRATION.

Подробнее https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/sending_notification_requests_to_apns

Также с версии 3.7.398 в таблице pc_sys_property добавлен параметр APNS_EXPIRATION значение из которого будет браться, если в шаблоне не установлено значение pc_notification_timeout.

===== Поле credentials для Android =====
<syntaxhighlight lang="json">
{"google_api_key":"AAAAZJTm6y0:APA91bF1OQYv9T2opZtIMJPZknA7tGLifzvTVB3PFSlQejBzPzyeYg4JFn-nud5mE_pZe920I2zR-8Lv-yabeaJ8PdduS96G3ESj_pfxAJAhaT1JistaXMchspMkPLL0e8tLxCmBzhda"}
</syntaxhighlight>

====PayControl 3====
=====Android=====
<syntaxhighlight lang="sql">
INSERT INTO pc_split_pusher_credentials (
id,
appid,
credentials,
is_default,
os,
systemid)
VALUES (
nextval('pc_split_pusher_creds_seq'),
'ru.safe-tech.PayControl.v3',
'{"google_api_key":"AAAAZJTm6y0:APA91bF1OQYv9T2opZtIMJPZknA7tGLifzvTVB3PFSlQejBzPzyeYg4JFn-nud5mE_pZe920I2zR-8Lv-yabeaJ8PdduS96G3ESj_pfxAJAhaT1JistaXMchspMkPLL0e8tLxCmBzhda"}',
1,
'Android',
'%SYSTEMID%');
</syntaxhighlight>
=====iOS=====
<syntaxhighlight lang="sql">
INSERT INTO pc_split_pusher_credentials (
id,
appid,
credentials,
is_default,
os,
systemid)
VALUES (
nextval('pc_split_pusher_creds_seq'),
'ru.safe-tech.PayControl.v3',
'{"apns_key_file":"/opt/wildfly/safetech-apns-JVBQX52N5Z.p8","apns_key_id":"JVBQX52N5Z","apns_team_id":"48HZH4RWJD"}',
1,
'iOS',
'%SYSTEMID%');
</syntaxhighlight>
=====iOS sandbox=====
<syntaxhighlight lang="sql">
INSERT INTO pc_split_pusher_credentials (
id,
appid,
credentials,
os,
systemid)
VALUES (
nextval('pc_split_pusher_creds_seq'),
'ru.safe-tech.PayControl.v3.dev',
'{"apns_key_file":"/opt/wildfly/safetech-apns-JVBQX52N5Z.p8","apns_key_id":"JVBQX52N5Z","apns_team_id":"48HZH4RWJD","use_dev_gate": true}',
'iOS',
'%SYSTEMID%');
</syntaxhighlight>
====PayControl 5====
=====Android=====
<syntaxhighlight lang="sql">
INSERT INTO pc_split_pusher_credentials (
id,
appid,
credentials,
os,
systemid)
VALUES (
nextval('pc_split_pusher_creds_seq'),
'org.paycontrol.app',
'{"google_api_key":"AAAAoZ7vyz4:APA91bFqLfNegQCs_GfHGFeOmS68PHWWSzWpeZaYKfnLul9iHufIQJiNIAjgAykeWrTxiDDs9qQzullXww3o5XR0VS9tlBEpuhTMlz4CyHdmN2EhntJBBUlSQa-8--Rw_UzDbKBCGCXk"}',
'Android',
'%SYSTEMID%');
</syntaxhighlight>
=====iOS=====
<syntaxhighlight lang="sql">
INSERT INTO pc_split_pusher_credentials (
id,
appid,
credentials,
os,
systemid)
VALUES (
nextval('pc_split_pusher_creds_seq'),
'org.paycontrol.app',
'{"apns_key_file":"/opt/wildfly/safetech-apns-JVBQX52N5Z.p8","apns_key_id":"JVBQX52N5Z","apns_team_id":"48HZH4RWJD"}',
'iOS',
'%SYSTEMID%');
</syntaxhighlight>
=====iOS sandbox=====
<syntaxhighlight lang="sql">
INSERT INTO pc_split_pusher_credentials (
id,
appid,
credentials,
os,
systemid)
VALUES (
nextval('pc_split_pusher_creds_seq'),
'org.paycontrol.app.dev',
'{"apns_key_file":"/opt/wildfly/safetech-apns-JVBQX52N5Z.p8","apns_key_id":"JVBQX52N5Z","apns_team_id":"48HZH4RWJD","use_dev_gate": true}',
'iOS',
'%SYSTEMID%');
</syntaxhighlight>
====PayConfirm 5====
=====Android=====
<syntaxhighlight lang="sql">
INSERT INTO pc_split_pusher_credentials (
id,
appid,
credentials,
os,
systemid)
VALUES (
nextval('pc_split_pusher_creds_seq'),
'org.payconfirm.app',
'{"google_api_key":"AAAA4H70m7M:APA91bFsaPiXXiIuRyj4h-xGZpyd0-I3B9F1udIIergxaK8uL9vPPvUQXOvPfau2w8E-xur_6TlTzmhb2JsO13hBCxVDrNybD6Rj8k4hZKXfs7tC5fnJuWmCIB3-O_4dLo0QHlhfSbGn"}',
'Android',
'%SYSTEMID%');
</syntaxhighlight>

=====iOS=====
<syntaxhighlight lang="sql">
INSERT INTO pc_split_pusher_credentials (
id,
appid,
credentials,
os,
systemid)
VALUES (
nextval('pc_split_pusher_creds_seq'),
'org.payconfirm.app',
'{"apns_key_file":"/opt/pc/AuthKey_QCC684AGC4.p8","apns_key_id":"QCC684AGC4","apns_team_id":"B98K5P3YHV"}',
'iOS',
'%SYSTEMID%');
</syntaxhighlight>
=====iOS Sandbox=====
<syntaxhighlight lang="sql">
INSERT INTO pc_split_pusher_credentials (
id,
appid,
credentials,
os,
systemid)
VALUES (
nextval('pc_split_pusher_creds_seq'),
'org.payconfirm.app.dev',
'{"apns_key_file":"/opt/pc/AuthKey_QCC684AGC4.p8","apns_key_id":"QCC684AGC4","apns_team_id":"B98K5P3YHV","use_dev_gate": true}',
'iOS',
'%SYSTEMID%');
</syntaxhighlight>

===Сервер PayControl 5.2===
Работа с аутентификационными данными в PayControl версии 5.2 описана в [[PC_Pusher_5.2|этой статье]].

=Настройка шаблонов PayControl Interaction Server Internal (при необходимости)=
Настройки производятся в [[База данных PayControl#PCIS Internal|БД PCIS]]. Шаблон push-сообщений определяется в формате [[JSON]]. Существует два варианта настройки push-сообщений:
* для всех [[Прикладная система|прикладных систем]] - задаётся в таблице pc_sys_property (setting_name = ANDROID_PUSH_PAYLOAD_TEMPLATE/IOS_PUSH_PAYLOAD_TEMPLATE);
* для каждой [[Прикладная система|прикладной системы]] отдельно. Имеет более высокий приоритет. Задаётся в pc_push_credentials. Поля '''ios_push_template''' и '''android_push_template'''
==Переменные==
Доступны следующие переменные для использования в шаблоне:
{| class="wikitable"
!Переменная
!Значение
|-
|%PUSH_TEXT% || PUSH_TEXT
|-
|%PUSH_TITLE% || PUSH_TITLE
|-
|%PUSH_SOUND% || PUSH_IOS_SOUND либо PUSH_ANDROID_SOUND, в зависимости от устройства, на которое отправляется пуш
|-
|%PUSH_ICON% || PUSH_ICON
|-
|%PUSH_IOS_BADGE% || PUSH_IOS_BADGE
|-
|%PUSH_TYPE% || "PayControl"
|-
|%USER_ID% || userId
|-
|%SYSTEM_ID% || systemId
|-
|%TRANSACTION_ID% || transactionId
|-
|%DEVICE_TOKEN% || deviceId
|}
==Шаблоны для разных версий PCIS==
===До версии PCIS 3.5 включительно===
При создании транзакции отправляется одно push сообщение.
===Версия PCIS 3.5.5===
При отправке оповещения о созданной транзакции на android отправляются два push-сообщения - Notification и Silent. Такая модификация потребовалась в связи с тем, что некоторые устройства не будят приложение для отрисовки уведомления. Для этого в БД PCIS Internal добавлено поле android_second_push_template.

Таким образом, значения полей выглядят следующим образом:
{| class="wikitable"
!Поле
!Значение
|-
|android_push_template
|<syntaxhighlight lang="json">{"to":"%DEVICE_TOKEN%","notification":{"tag":"%USER_ID%","title":"PayControl","body":"%PUSH_TEXT%","icon":"paycontrol_push","sound":"default"},"data":{"type":"PayControl_v2"}}</syntaxhighlight>
|-
|android_second_push_template
|<syntaxhighlight lang="json">{"to":"%DEVICE_TOKEN%","data": {"type": "PayControl_v2", "userid": "%USER_ID%"}}</syntaxhighlight>
|}
===С версии PCIS 3.6===
Шаблон push-сообщений определяется как массив шаблонов сообщений в формате [[JSON]], которые отправляются последовательно (количество элементов в массиве - от 1):
<syntaxhighlight lang="json">{"messages":[массив объектов шаблонов push-сообщений, который будет отправлен PayControl]}</syntaxhighlight>
Пример:
* android_push_template <syntaxhighlight lang="json">{"messages":[{"to":"%DEVICE_TOKEN%","notification":{"tag":"%USER_ID%","title":"PayControl","body":"%PUSH_TEXT%","icon":"paycontrol_push","sound":"default"},"data":{"type":"PayControl_v2"}},{"to":"%DEVICE_TOKEN%","data": {"type": "PayControl_v2", "userid": "%USER_ID%"}}]}</syntaxhighlight>
* ios_push_template <syntaxhighlight lang="json">{"messages":[{"aps":{"alert":"%PUSH_TEXT%","sound":"%PUSH_SOUND%","badge":%PUSH_IOS_BADGE%},"type":"%PUSH_TYPE%","userid":"%USER_ID%"}]}</syntaxhighlight>
===Для мобильных приложений версии 3.7 и выше===
На Android стало достаточно отправки одного data-пуша. При этом можно указать следующие типы (type) (регистр не имеет значения):
* paycontrol и payconfirm - звук и вибрация;
* PayControl-v2 - использовать не стоит, т.к. в этом случае звука или вибрации не будет. Применяется в случае, если отправляется 2 пуша - notification и data.
<syntaxhighlight lang="json">{"messages":[{"to":"%DEVICE_TOKEN%","data": {"type": "paycontrol", "userid": "%USER_ID%"}}]}</syntaxhighlight>
Тем не менее, шаблон следующий:
<source lang="json">{
"messages":[
{
"to":"%DEVICE_TOKEN%",
"notification":{
"tag":"%USER_ID%",
"title":"PayControl",
"body":"%PUSH_TEXT%",
"icon":"paycontrol_push",
"sound":"default"
},
"data":{
"type":"PayControl_v2"
}
},
{
"to":"%DEVICE_TOKEN%",
"data":{
"type":"PayControl_v2",
"userid":"%USER_ID%"
}
}
]
}</source>

==Установка новых шаблонов в БД==
===Обновление шаблонов===
<syntaxhighlight lang="sql">update pc_push_credentials set android_push_template='{"messages":[{"to":"%DEVICE_TOKEN%","notification":{"tag":"%USER_ID%","title":"PayControl","body":"%PUSH_TEXT%","icon":"paycontrol_push","sound":"default"},"data":{"type":"PayControl_v2"}},{"to":"%DEVICE_TOKEN%","data": {"type": "PayControl_v2", "userid": "%USER_ID%"}}]}' where systemid='bef89e01-f248-4841-bd62-8b08056e6fea';</syntaxhighlight>
<syntaxhighlight lang="sql">update pc_push_credentials set ios_push_template='{"messages":[{"aps":{"alert":"%PUSH_TEXT%","sound":"%PUSH_SOUND%","badge":%PUSH_IOS_BADGE%},"type":"%PUSH_TYPE%","userid":"%USER_ID%"}]}' where systemid='bef89e01-f248-4841-bd62-8b08056e6fea';</syntaxhighlight>
Удаление шаблона второго push-сообщения:
<syntaxhighlight lang="sql">update pc_push_credentials set android_second_push_template = NULL;</syntaxhighlight>
Одним запросом:
<syntaxhighlight lang="sql">update pc_push_credentials set android_push_template='{"messages":[{"to":"%DEVICE_TOKEN%","notification":{"tag":"%USER_ID%","title":"PayControl","body":"%PUSH_TEXT%","icon":"paycontrol_push","sound":"default"},"data":{"type":"PayControl_v2"}},{"to":"%DEVICE_TOKEN%","data": {"type": "PayControl_v2", "userid": "%USER_ID%"}}]}', ios_push_template='{"messages":[{"aps":{"alert":"%PUSH_TEXT%","sound":"%PUSH_SOUND%","badge":%PUSH_IOS_BADGE%},"type":"%PUSH_TYPE%","userid":"%USER_ID%"}]}', android_second_push_template = NULL;</syntaxhighlight>
===Добавление новой записи===
Указать верные:
* google_api_key
* apns_key_file
* apns_key_id
* apns_team_id
Уточнить:
* apns_app_id

<syntaxhighlight lang="sql">INSERT INTO pc_push_credentials (systemid, android_push_template, google_api_key, ios_push_template, use_ios_fcm, apns_app_id, apns_key_file, apns_key_id, apns_team_id) VALUES ('e33affa9-1ff8-4d2a-aa42-856fb59309e0', '{"messages":[{"to":"%DEVICE_TOKEN%","notification":{"tag":"%USER_ID%","title":"PayControl","body":"%PUSH_TEXT%","icon":"paycontrol_push","sound":"default"},"data":{"type":"PayControl_v2"}},{"to":"%DEVICE_TOKEN%","data": {"type": "PayControl_v2", "userid": "%USER_ID%"}}]}', 'AAAAZJTm6y0:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX', '{"messages":[{"aps":{"alert":"%PUSH_TEXT%","sound":"%PUSH_SOUND%","badge":%PUSH_IOS_BADGE%},"type":"%PUSH_TYPE%","userid":"%USER_ID%"}]}', '0','ru.safe-tech.PayControl.v3','/opt/wildfly/safetech-apns-JVBQX52N5Z.p8','JVXXXXXXXXX','48XXXXXXX');</syntaxhighlight>
== Использование FCM для iOS ==
В таблице pc_push_credentials можно выставить значение use_ios_fcm в значение 1. В этом случае для отправки push-сообщения в iOS будет использоваться Google Firebase.<br>
'''При использовании use_ios_fcm обязательно указать шаблон push-сообщения для iOS, иначе push-сообщение пойдет в формате APNS, что вызовет ошибку'''<br>
Пример шаблона push-сообщения для iOS через FCM:<syntaxhighlight lang="json">{"messages":[{"to":"%DEVICE_TOKEN%","notification":{"title":"Название Банка","body":"%PUSH_TEXT%","sound":"%PUSH_SOUND%","badge":%PUSH_IOS_BADGE%},"data":{"type" : "%PUSH_TYPE%","userid":"%USER_ID%"}}]}</syntaxhighlight>
Пример запроса к БД PCIS для переключения на использование FCM для iOS:
<syntaxhighlight lang="sql">update pc_push_credentials set use_ios_fcm=1, ios_push_template='{"messages":[{"to":"%DEVICE_TOKEN%","notification":{"title":"Название банка","body":"%PUSH_TEXT%","sound":"%PUSH_SOUND%","badge":%PUSH_IOS_BADGE%},"data":{"type":"%PUSH_TYPE%","userid":"%USER_ID%"}}]}';</syntaxhighlight>

=Настройка для работы через [[pcwiki:PayControl Inform|PayControl Inform]]=
В [[База данных PayControl#pc_system|БД PCS в таблице pc_system]] значение pc_is_internal_url должно иметь вид:
[pc-inform]{PayControl Infrom URL}
Например:
[pc-inform]http://pcinform.local/api/notification/

Для настройки шаблонов push-сообщений, в БД PCS, в [[Сервер PayControl#PCS|таблице pc_sys_properties]] должны быть записи (формат шаблона - PC Inform):
setting_name = ANDROID_PUSH_PAYLOAD_TEMPLATE
setting_value = {"messages":[{"notification":{"tag":"%USER_ID%","title":"PayControl","body":"%PUSH_TEXT%","icon":"paycontrol_push","sound":"default"},"data":{"type":"PayControl_v2"}},{"data": {"type": "PayControl_v2", "userid": "%USER_ID%"}}]}

setting_name = IOS_PUSH_PAYLOAD_TEMPLATE
setting_value = {"messages":[{"aps":{"alert":"%PUSH_TEXT%","sound":"%PUSH_SOUND%","badge":%PUSH_IOS_BADGE%},"type":"%PUSH_TYPE%","userid":"%USER_ID%"}]}

=Адреса серверов для отправки Push=
==Apple Push Notification Service==
Development server: api.development.push.apple.com:443 (используется для отправки уведомлений в debug-сборки (залитые из XCode))

Production server: '''api.push.apple.com:443''' (Используется для отправки в приложения из AppStore и TestFlight)

''!!!В PayControl в настоящее время не используется!!! Вместо порта 443 можно использовать порт 2197 для связи с APNS. К примеру этот порт можно использовать, если система фильтрации на межсетевом экране не позволяет разрешить трафик по 443 порту исключительно с серверами APNS.''

[[Участник:A.bursakov|A.bursakov]] ([[Обсуждение участника:A.bursakov|обсуждение]]) 16:47, 7 августа 2018 (MSK)

Источник - https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/CommunicatingwithAPNs.html

==Google Firebase==
===Актуальный API===
Для отправки push-сообщений, запросы должны отправляться по адресу https://'''fcmdata.googleapis.com''' и https://'''oauth2.googleapis.com:443'''

Источник - https://firebase.google.com/docs/reference/fcmdata/rest?hl=ru

===Legacy===
Для отправки push-сообщений, запросы должны отправляться по адресу https://'''fcm.googleapis.com:443'''/fcm/send

[[Участник:A.bursakov|A.bursakov]] ([[Обсуждение участника:A.bursakov|обсуждение]]) 16:47, 7 августа 2018 (MSK)

Источник - https://firebase.google.com/docs/cloud-messaging/http-server-ref

==Huawei Mobile Services==
Для отправки push-сообщений, запросы должны отправляться по адресу https://'''push-api.cloud.huawei.com''' ,порт 443

Также, с сервера PC Pusher должен быть доступен адрес: https://oauth-login.cloud.huawei.com/oauth2/v3/token

Источник - https://developer.huawei.com/consumer/en/doc/quickapp-access-push-kit#h2-1582279071471

=Проблемы при отправке пушей=
Проблемы при отправке пуша могут быть следующие:
* Создаётся транзакция без указания notification_type "PUSH"
* У PCS нет связи с PCP (ошибка свидетельствующая об этом должна быть в логе PCS, в момент попытки отправки пуша).
* У PCP не настроены аутентификационные данные для отправки пушей
* У PCP нет доступа к серверам Firebase/APNS
* На телефоне не разрешён приём пушей для приложения
[[Категория:Серверная часть]]
[[Категория:Мобильное приложение]]