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

Материал из PayControl Wiki
Перейти к: навигация, поиск
(→‎Установка PayControl Interaction Server (External) 3.6 на WebLogic 12.2.1.3)
 
(не показано 14 промежуточных версий этого же участника)
Строка 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
 
# Добавить драйвер в CLASSPATH WebLogic
 
# Добавить драйвер в CLASSPATH WebLogic
−
Подробнее смотри в официальной документации<span>https://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729</span>
+
Подробнее смотри в официальной документации https://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729
  
−
Примечание: При тестировании использовалась опция добавления в CLASSPATH "<span><span>For all domains"</span></span>
+
Примечание: При тестировании использовалась опция добавления в CLASSPATH "For all domains"
−
===<span><span>Установка Java Cryptography Extension (JCE) Unlimited Strength</span></span>===
+
 
 +
===Установка 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<java_home></java_home>''/lib/security, заменив старые версии
+
# Распаковать и скопировать файлы по адресу JDK_HOME/lib/security, заменив старые версии
  
 
===Настройка JVM===
 
===Настройка JVM===
 
====Размер используемой памяти====
 
====Размер используемой памяти====
 
Для работы WebLogic с приложениями рекомендуется использовать не менее 2Gb оперативной памяти.
 
Для работы WebLogic с приложениями рекомендуется использовать не менее 2Gb оперативной памяти.
−
# Перейти по пути: ''PATH_TO_DOMAIN''''<path_to_domain></path_to_domain>''\bin
+
# Перейти по пути: PATH_TO_DOMAIN\bin
 
# Установить переменную USER_MEM_ARGS
 
# Установить переменную USER_MEM_ARGS
−
#* Для Windows в файле startWebLogic.cmd добавить запись''set USER_MEM_ARGS=-Xms256m -Xmx2048m''перед строкой''<em>call "%DOMAIN_HOME%\bin\setDomainEnv.cmd"''</em>
+
::* Для '''Windows''' в файле startWebLogic.cmd добавить запись
−
#* Для Linux в файле startWebLogic.sh добавить запись''USER_MEM_ARGS=-Xms256m -Xmx2048m''перед строкой''DOMAIN_HOME="<em>PATH_TO_DOMAIN</em><path_to_domain>"</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====
 
Для работы приложения PayControl необходимо указать в JNDI-префикс в качестве параметры Java-машины приложения
 
Для работы приложения PayControl необходимо указать в JNDI-префикс в качестве параметры Java-машины приложения
−
# Перейти по пути: ''PATH_TO_DOMAIN''''<path_to_domain></path_to_domain>''\bin
+
# Перейти по пути: PATH_TO_DOMAIN\bin
−
# Установить переменную ''JAVA_OPTIONS''
+
# Установить переменную JAVA_OPTIONS
−
#* Для Windows в файле startWebLogic.cmd строку<br />
+
::* Для '''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/'''
+
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%</syntaxhighlight>
−
* Для Linux в файле startWebLogic.sh строку''''<br />''''
+
:::добавить
−
''''''<em>JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}"<em>''</em>'''</em>'''''<em>заменить на'''''</em>'''<em>JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}'' -Dejb.jndi.prefix=java:global/PayControlServiceWar-3.6-WF-WL/PayControl-core-logic-3.6-jar-with-dependencies/</em>''
+
:::<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/

Текущая версия на 17: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»