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

Материал из PayControl Wiki
Перейти к: навигация, поиск
Строка 12: Строка 12:
 
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: Строка 19:
 
# Перейти по пути: 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: Строка 32:
 
# Перейти по пути: 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=%SAVE_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=${SAVE_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

Версия 15:28, 23 ноября 2018

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

Подготовка

Установка необходимых 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=%SAVE_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=${SAVE_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