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

Материал из PayControl Wiki
Перейти к: навигация, поиск

Установка 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/

Источник — «https://repo.paycontrol.org/wiki/index.php?title=Установка_на_WebLogic&oldid=99»