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

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

Материал из PayControl Wiki
← Предыдущая правка
P.melnichenko (обсуждение | вклад)
Администраторы
33 правки
 
(не показано 16 промежуточных версий этого же участника)
Строка 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 необходимо выполнить следующие действия (https://docs.oracle.com/middleware/1213/wls/JDBCA/third_party_drivers.htm#JDBCA729):
Если используется СУБД, отличная от Oracle, то необходимо установить JDBC-драйвер для необходимой СУБД.<br>
# Загрузить актуальную версию JDBC-драйвера (<a href="https://jdbc.postgresql.org/download.html)">https://jdbc.postgresql.org/download.html)</a>
На примере PostgreSQL необходимо выполнить следующие действия:
# Загрузить актуальную версию 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 "For all domains"


Примечание: При тестировании использовалась опция добавления в CLASSPATH "<span><span>For all domains"</span></span>
===Установка Java Cryptography Extension (JCE) Unlimited Strength===
===<span><span>Установка Java Cryptography Extension (JCE) Unlimited Strength</span></span>===
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
PayControl использует криптографические примитивы, поэтому для используемой Java-машины должно быть снято ограничение на "стойкость" криптографии
# Скачать архив по адресу <a href="http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html">http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html</a>
# Скачать архив по адресу 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/''''''''<span></span>''''
:::<syntaxhighlight lang="bash">set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%</syntaxhighlight>
* Для Linux в файле startWebLogic.sh строку''''<br />''''
:::добавить
''''<em><em>JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}"''</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/

Текущая версия от 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