Обновление с 3.6 до 3.8 — различия между версиями

Материал из PayControl Wiki
Перейти к: навигация, поиск
(→‎Настройка PCIS Internal (PCP))
Строка 1: Строка 1:
−
Новая версия поддерживает токены HMS и отправку пушей на устройства Huawei.
+
В версии 3.8 реализовано взаимодействие с [[PC Pusher 5.2]], который, в свою очередь, поддерживает отправку пуш-уведомлений на устройства Huawei. Обновлению с 3.6-3.7 подлежат модули PCS и PCIS External.  
−
 
+
{{Предупреждение|Модуль PCIS Internal 3.6/3.7 подлежит замене на модуль PC Pusher 5.2. PCS с версии 3.8 не поддерживает работу с модулем PCIS Internal.}}
  
 
=Обновление PCS и PCIS External=
 
=Обновление PCS и PCIS External=
Строка 14: Строка 14:
 
* и с расширением *.deployed, где вместо * будут указаны названия новых модулей.
 
* и с расширением *.deployed, где вместо * будут указаны названия новых модулей.
 
При появлении файлов с расширением *.failed, необходимо [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|перезапустить Wildfly]].
 
При появлении файлов с расширением *.failed, необходимо [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|перезапустить Wildfly]].
−
 
+
=Переход с PCIS Internal на PC Pusher=
−
=Обновление PCIS Internal (PC Pusher)=
+
==Замена файлов модулей==
−
 
+
{{Предупреждение|PC Pusher для своей работы не требует использования БД, в отличие от PCIS Internal.}}
−
'''Новая версия PCIS Internal больше не использует БД.'''
 
  
 
Для обновления необходимо заменить на сервере файлы модуля PCIS Internal в директории deployments сервера приложений Wildfly. Файл имеют названия вида:
 
Для обновления необходимо заменить на сервере файлы модуля PCIS Internal в директории deployments сервера приложений Wildfly. Файл имеют названия вида:
Строка 33: Строка 32:
 
*и с расширением *.deployed, где вместо * будут указаны названия новых модулей.
 
*и с расширением *.deployed, где вместо * будут указаны названия новых модулей.
 
При появлении файлов с расширением *.failed, необходимо [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|перезапустить Wildfly]].
 
При появлении файлов с расширением *.failed, необходимо [[Руководство_администратора_PayControl_v3#Запуск и остановка служб сервера PayControl|перезапустить Wildfly]].
−
 
+
==Настройка PCS для работы с PCP==
−
_ _ _
+
После замены PCIS Internal на PC Pusher необходимо заменить его адрес в БД PCS:
−
 
 
−
После обновления PCIS Internal (PC Pusher) необходимо заменить его адрес в БД PCS:
 
 
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url='http[s]://pcphost:port/pc-pusher-api/';</syntaxhighlight>
 
<syntaxhighlight lang="sql">update pc_system set pc_is_internal_url='http[s]://pcphost:port/pc-pusher-api/';</syntaxhighlight>
−
и настроить соответствующие сетевые доступы.
 
−
 
  
−
==Настройка PCIS Internal (PCP)==
+
==Настройка PC Pusher==
  
−
По умолчанию PCP отправляет пуши в приложение PayControl.
+
По умолчанию, если app/bundle id для отправки пуш-уведомлений явно не указан для устройства, PCS 3.8 отправляет пуши в приложение PayControl Classic.
  
 
Для отправки пушей в другое приложения необходимо:
 
Для отправки пушей в другое приложения необходимо:
−
*1) Произвести настройки в соответствии с [[PC_Pusher_5.2|этой статьей]]
+
# Произвести настройки аутентификационных данных "другого" мобильного приложения в соответствии с [[PC_Pusher_5.2|этой статьей]]
−
*2) Прописать идентификатор необходимого приложения в БД PCS:
+
# Прописать app/bundle id необходимого приложения в БД PCS:
−
Пример: <syntaxhighlight lang="sql">insert into pc_sys_property values (nextval('pc_setting_seq'), 'APP_ID_FOR_PUSHER', '{"Android":"ru.safe-tech.PayControl.v3","iOS":"ru.safe-tech.PayControl.v3"}');</syntaxhighlight>
+
Пример: <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"}');</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"}');</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"}');</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"}');</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"}');</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"}');</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"}');</syntaxhighlight>

Версия 15:47, 4 июня 2021

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

В работе
 Предупреждение! Модуль PCIS Internal 3.6/3.7 подлежит замене на модуль PC Pusher 5.2. PCS с версии 3.8 не поддерживает работу с модулем PCIS Internal.


Обновление PCS и PCIS External

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

  • PayControl-services-module-3.x.x.ear - PCS;
  • PayControl-interaction-rest-3.x.x.war - PCIS External.

Перед заменой файлов остановите Wildfly. Файлы сервера предыдущей версии настоятельно рекомендуем сохранить для возможности отката на предыдущую версию.

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

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

При появлении файлов с расширением *.failed, необходимо перезапустить Wildfly.

Переход с PCIS Internal на PC Pusher

Замена файлов модулей

В работе
 Предупреждение! PC Pusher для своей работы не требует использования БД, в отличие от PCIS Internal.


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

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

Перед заменой файлов остановите Wildfly. Файлы сервера предыдущей версии настоятельно рекомендуем сохранить для возможности отката на предыдущую версию.

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

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

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

При появлении файлов с расширением *.failed, необходимо перезапустить Wildfly.

Настройка PCS для работы с PCP

После замены PCIS Internal на PC Pusher необходимо заменить его адрес в БД PCS: 

update pc_system set pc_is_internal_url='http[s]://pcphost:port/pc-pusher-api/';

Настройка PC Pusher

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

Для отправки пушей в другое приложения необходимо:

  1. Произвести настройки аутентификационных данных "другого" мобильного приложения в соответствии с этой статьей
  2. Прописать app/bundle id необходимого приложения в БД PCS:

Пример: 

insert into pc_sys_property values (nextval('pc_setting_seq'), 'APP_ID_FOR_PUSHER', '{"Android":"com.example.mobile.app","iOS":"com.example.apple.app"}');

Шаблоны:

  • PostgreSQL 
    insert into pc_sys_property values (nextval('pc_setting_seq'), 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid"}');
  • MS SQL 
    insert into pc_sys_property values (NEXT VALUE FOR PC_SETTING_SEQ, 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid"}');
  • Oracle 
    insert into pc_sys_property values (PC_SETTING_SEQ.NEXTVAL, 'APP_ID_FOR_PUSHER', '{"Android":"your_appid","iOS":"your_appid"}');
Источник — «https://repo.paycontrol.org/wiki/index.php?title=Обновление_с_3.6_до_3.8&oldid=563»