Перейти к содержанию

Установка на WebLogic: различия между версиями

Материал из PayControl Wiki
← Предыдущая правка
P.melnichenko (обсуждение | вклад)
Администраторы
33 правки
Нет описания правки
 
(не показано 12 промежуточных версий этого же участника)
Строка 1: Строка 1:
=Установка PayControl 3.6 на WebLogic 12.2.1.3=
=Установка PayControl Server 3.6 на WebLogic 12.2.1.3=
 
==Параметры установки WebLogic==
После установки WebLogic при создании нового домена необходимо использовать следующие шаблоны:
# Basic WebLogic Server Domain
# WebLogic Advanced Web Services for JAX-WS Extension [oracle_common]
# WebLogic JAX-WS SOAP/JMS Extension [oracle_common]
 
==Подготовка==
==Подготовка==
===Установка необходимых JDBC-драйверов===
===Установка необходимых JDBC-драйверов===
Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД.На примере PostgreSQL необходимо выполнить следующие действия:
Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД.<br>
На примере PostgreSQL необходимо выполнить следующие действия:
# Загрузить актуальную версию JDBC-драйвера (https://jdbc.postgresql.org/download.html)
# Загрузить актуальную версию JDBC-драйвера (https://jdbc.postgresql.org/download.html)
# Поместить драйвер в директорию установки Web Logic
# Поместить драйвер в директорию установки Web Logic
Строка 9: Строка 17:


Примечание: При тестировании использовалась опция добавления в CLASSPATH "For all domains"
Примечание: При тестировании использовалась опция добавления в CLASSPATH "For all domains"
===Установка Java Cryptography Extension (JCE) Unlimited Strength===
===Установка Java Cryptography Extension (JCE) Unlimited Strength===
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
# Скачать архив по адресу http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html
# Скачать архив по адресу http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html
# Распаковать и скопировать файлы по адресу 'JDK_HOME/lib/security, заменив старые версии
# Распаковать и скопировать файлы по адресу JDK_HOME/lib/security, заменив старые версии


===Настройка JVM===
===Настройка JVM===
Строка 19: Строка 28:
# Перейти по пути: PATH_TO_DOMAIN\bin
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную USER_MEM_ARGS
# Установить переменную USER_MEM_ARGS
## Для Windows в файле startWebLogic.cmd добавить запись set USER_MEM_ARGS=-Xms256m -Xmx2048m перед строкой call "%DOMAIN_HOME%\bin\setDomainEnv.cmd
::* Для '''Windows''' в файле startWebLogic.cmd добавить запись
## Для Linux в файле startWebLogic.sh добавить запись USER_MEM_ARGS=-Xms256m -Xmx2048m перед строкой DOMAIN_HOME=PATH_TO_DOMAIN
:::<syntaxhighlight lang="bash">set USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой  
:::<syntaxhighlight lang="bash">call "%DOMAIN_HOME%\bin\setDomainEnv.cmd</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh добавить запись
:::<syntaxhighlight lang="bash">USER_MEM_ARGS=-Xms256m -Xmx2048m</syntaxhighlight>
:::перед строкой
:::<syntaxhighlight lang="bash">DOMAIN_HOME=PATH_TO_DOMAIN</syntaxhighlight>


====Указать префикс для JNDI====
====Указать префикс для JNDI====
Строка 26: Строка 41:
# Перейти по пути: PATH_TO_DOMAIN\bin
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную JAVA_OPTIONS
# Установить переменную JAVA_OPTIONS
#* Для Windows в файле startWebLogic.cmd строку set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% заменить на set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/
::* Для '''Windows''' в файле startWebLogic.cmd после строки
#* Для Linux в файле startWebLogic.sh строку JAVA_OPTIONS=${SAVE_JAVA_OPTIONS} заменить на JAVA_OPTIONS=${SAVE_JAVA_OPTIONS} -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%JAVA_OPTIONS% -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh после строки
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS}</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${JAVA_OPTIONS} -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</syntaxhighlight>
 
==Настройка логирования==
PayControl использует log4j версии 1.2 для логирования.
Для включения log4j в WebLogic необходимо создать файл свойств log4j и добавить его в CLASSPATH WebLogic.
 
Самый простой способ это сделать следующий
 
Создать файл PATH_TO_DOMAIN\config\log4j.properties со следующим содержанием
<syntaxhighlight lang="bash"># 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
</syntaxhighlight>
 
Данные настройки позволяют выводить лог в stdout сервера WebLogic
 
Более подробно настройку log4j можно посмотреть на сайте log4j http://logging.apache.org/log4j/1.2/
 
==Добавление DataSource==
PayControl Server использует DataSource с именем PayControlDS<br>
 
DataSource'ы добавляются стандартным способом:
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Environment -> Data Sources
# Добавить Generic Data Source с указанием JNDI Name: '''PayControlDS'''
# Активировать Data Source для нужно сервера (Select Target). Например, для Admin Server.
 
==Установка приложения==
Необходимо развернуть EAR-приложение '''PayControlServiceWar-3.6-WF-WL.ear''' в WebLogic стандартными средствами
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Deployments
# Развернуть приложение
 
==Адрес WSDL сервиса==
Сервис доступен по ссылкам
# Основной сервис: http://<IP или имя сервера с WL>:7001/ws/PayControlServiceV3?wsdl
# Сервис отчетности: 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-машины.
# Перейти по пути: PATH_TO_DOMAIN\bin
# Установить переменную JAVA_OPTIONS
::* Для '''Windows''' в файле startWebLogic.cmd после строки
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%JAVA_OPTIONS% -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3 -Dpaycontrol.locale=ru</syntaxhighlight>
::* Для '''Linux''' в файле startWebLogic.sh после строки
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${SAVE_JAVA_OPTIONS}</syntaxhighlight>
:::добавить
:::<syntaxhighlight lang="bash">JAVA_OPTIONS=${JAVA_OPTIONS} -Dpcservice.endpoint=http://<host>:<port>/ws/PayControlServiceV3 -Dpaycontrol.locale=ru</syntaxhighlight>
 
==Настройка логирования==
Настройка логирования выполняется полностью аналогично [[Установка на WebLogic#Настройка логирования]]
 
==Установка приложения==
Необходимо развернуть EAR-приложение '''PayControl-interaction-rest.war''' в WebLogic стандартными средствами
# В консоли WebLogic http://''server-name'':7001/console перейти в раздел Deployments
# Развернуть приложение
 
==Адрес сервиса==
Сервис доступен по ссылке<br>
http://<IP или имя сервера с WL>:7001/PayControl-interaction-rest/jsonrequest_v2/

Текущая версия от 14:14, 23 ноября 2018

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