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

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

Параметры установки WebLogic

После установки WebLogic при создании нового домена необходимо использовать следующие шаблоны:

1. Basic WebLogic Server Domain
2. WebLogic Advanced Web Services for JAX-WS Extension [oracle_common]
3. WebLogic JAX-WS SOAP/JMS Extension [oracle_common]

Подготовка

Установка необходимых JDBC-драйверов

Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД.
На примере PostgreSQL необходимо выполнить следующие действия:

1. Загрузить актуальную версию JDBC-драйвера (https://jdbc.postgresql.org/download.html)
2. Поместить драйвер в директорию установки Web Logic
3. Добавить драйвер в CLASSPATH WebLogic

Подробнее смотри в официальной документации https://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729

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

Установка Java Cryptography Extension (JCE) Unlimited Strength

PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии

1. Скачать архив по адресу http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html
2. Распаковать и скопировать файлы по адресу JDK_HOME/lib/security, заменив старые версии

Настройка JVM

Размер используемой памяти

Для работы WebLogic с приложениями рекомендуется использовать не менее 2Gb оперативной памяти.

1. Перейти по пути: PATH_TO_DOMAIN\bin
2. Установить переменную USER_MEM_ARGS

• Для Windows в файле startWebLogic.cmd добавить запись

set USER_MEM_ARGS=-Xms256m -Xmx2048m

перед строкой

call "%DOMAIN_HOME%\bin\setDomainEnv.cmd

• Для Linux в файле startWebLogic.sh добавить запись

USER_MEM_ARGS=-Xms256m -Xmx2048m

перед строкой

DOMAIN_HOME=PATH_TO_DOMAIN

Указать префикс для JNDI

Для работы приложения PayControl необходимо указать в JNDI-префикс в качестве параметры Java-машины приложения

1. Перейти по пути: PATH_TO_DOMAIN\bin
2. Установить переменную JAVA_OPTIONS

• Для Windows в файле startWebLogic.cmd после строки

set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%

добавить

set JAVA_OPTIONS=%JAVA_OPTIONS% -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/

• Для Linux в файле startWebLogic.sh после строки

JAVA_OPTIONS=${SAVE_JAVA_OPTIONS}

добавить

JAVA_OPTIONS=${JAVA_OPTIONS} -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/

Настройка логирования

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

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

Создать файл PATH_TO_DOMAIN\config\log4j.properties со следующим содержанием

# Root logger option
log4j.rootLogger=INFO, stdout

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

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

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

Добавление DataSource

PayControl Server использует DataSource с именем PayControlDS

DataSource'ы добавляются стандартным способом:

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

Установка приложения

Необходимо развернуть EAR-приложение PayControlServiceWar-3.6-WF-WL.ear в WebLogic стандартными средствами

1. В консоли WebLogic http://server-name:7001/console перейти в раздел Deployments
2. Развернуть приложение

Адрес WSDL сервиса

Сервис доступен по ссылкам

1. Основной сервис: http://<IP или имя сервера с WL>:7001/ws/PayControlServiceV3?wsdl
2. Сервис отчетности: http://<IP или имя сервера с WL>:7001/ws/PayControlReportService?wsdl

Установка PayControl Interaction Server (External) 3.6 на WebLogic 12.2.1.3

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

Подготовка

Установка адреса выполняется через задание параметра JAVA-машины.

1. Перейти по пути: PATH_TO_DOMAIN\bin
2. Установить переменную JAVA_OPTIONS

• Для Windows в файле startWebLogic.cmd после строки

set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%

добавить

set JAVA_OPTIONS=%JAVA_OPTIONS% -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3 -Dpaycontrol.locale=ru

• Для Linux в файле startWebLogic.sh после строки

JAVA_OPTIONS=${SAVE_JAVA_OPTIONS}

добавить

JAVA_OPTIONS=${JAVA_OPTIONS} -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3 -Dpaycontrol.locale=ru

Настройка логирования

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

Установка приложения

Необходимо развернуть EAR-приложение PayControl-interaction-rest.war в WebLogic стандартными средствами

1. В консоли WebLogic http://server-name:7001/console перейти в раздел Deployments
2. Развернуть приложение

Адрес сервиса

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