Инструкция по установке и настройке шлюза рассылки

Содержание поставки

Приложение шлюза рассылки (CCS-CBS-GW) поставляется в виде архива. Файл архива называется ccs-cbs-gw-bin.zip.

Архив имеет следующую структуру:

ccs-cbs_gw.war	Приложение шлюза между CBS и сервером рассылки
ccs-gw.xml	Файл конфигурации

Порядок установки приложения под tomcat

Установка библиотек

Приложение устанавливается средствами tomcat manager (см. документацию по Tomcat).

Настройка приложения

После установки приложения следует выполнить настройку ресурсов. Настройка выполняется в файле $(CATALINA_HOME/conf/Catalina/localhost/ccs-cbs-gw.xml). В данном файле описаны JNDI ресурсы, используемые приложением.

Ресурс jdbc/cbs

Описывает подключение к базе данных CBS. Поставляемая по умолчанию конфигурация следующая:

<Resource name="jdbc/cbs"

      auth="Container"

      type="javax.sql.DataSource"

      driverClassName="oracle.jdbc.OracleDriver"

      user="colvir"

      password="colvir"

      url="jdbc:oracle:thin:@127.0.0.1:1521:COLVIR" />

Назначение атрибутов ресурса:

Атрибут	Описание
driverClassName	JDBC драйвер используемый для подключения к БД
User	Имя пользователя для подключения к БД
password	Пароль для подключения к БД
url	Строка подключения к БД

Настройка ресурса необходима, если будет использоваться подключение к базе данных CBS через JNDI. Если подключение будет настроено через указание прямого URL в настройке подключения, то настраивать его не обязательно.

Настройка шлюза

Поставляемый по умолчанию файл конфигурации шлюза расположен по пути WEB-INF/ccs-gw.xml. Этот файл нужно скопировать в каталог $(CATALINA_HOME)/conf. По умолчанию поставляется следующая конфигурация:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<Gateway>

  <Adapters>

    <!-- JNDI to TopicConnectionFactory -->

    <Adapter name="CBS" consumerName="CBS" description="Colvir Banking System"

      jndiName="java:comp/env/jms/CBS"

      className="com.colvir.ccs.gateway.JmsAdapter"

      systemTopic="COLVIR.C_MSGQUEUESYSTEM"

      dataTopic="COLVIR.C_MSGQUEUEDATA"

    />

    <!-- JDBC for Oracle AQjms API -->

    <Adapter name="CBS" consumerName="CBS" description="Colvir Banking System"

      jdbcUrl="jdbc:oracle:thin:colvir/colvir@1.1.1.40:1521:HGDEV"

      className="com.colvir.ccs.gateway.OracleJmsAdapter"

      systemTopic="COLVIR.C_MSGQUEUESYSTEM"

      dataTopic="COLVIR.C_MSGQUEUEDATA"

    />

  </Adapters>

</Gateway>

Настраивать необходимо узлы <Adapter>. Должно быть настроено столько узлов <Adapter>, сколько систем потребителей будет обслуживать приложение шлюза.

Атрибут jdbcUrl задает подключение к реализации JMS в базе данных CBS. Если атрибут задан в настройке (присутствует и не пустой) то шлюз будет использовать эту настройку. Атрибут используется только в том случае если не задан jndiName.

Атрибут jndiName задает имя ресурса, описывающего подключение к базе данных CBS.

Путь к файлу конфигурации указывается в системном свойстве Java com.colvir.ccs.gw.configFile. Установить системное свойство можно через переменную окружения JAVA_OPTS в файле bin/catalina.bat следующей командой: set JAVA_OPTS = %JAVA_OPTS% -Dcom.colvir.ccs.gw.configFile=”C:/tomcat/conf/ccs-gw.xml”.

Настройка логирования шлюза

Поставляемый по умолчанию файл настройки логирования шлюза расположен по пути WEB-INF/log4j.properties. Для изменения детализации логирования приложение следует пересобрать или корректировать настройки в репозитории сервера.

Изменять эти настройки не рекомендуется.

Порядок установки приложения шлюза под WebSphere

Установка библиотек

Шлюз устанавливается после установки системы рассылки (см. «Инструкцию по установке и настройке системы рассылки»). Установка дополнительных библиотек не требуется.

Установка приложения шлюза

Приложение устанавливается в консоли сервера (см. документацию на сервер приложений).

Group:	colvir
Artifact:	ccs-cbs-gw
Version:	1.0
Type:	war

Управление доступом

Приложение системы рассылки предоставляет Web интерфейс управления системой шлюза. Доступ к Web интерфейсу управления осуществляется по адресу: http://server/ccs-cbs-gw. Для ограничения доступа используются следующие роли:

ccs-cbs-gw.web.manager

Разрешает доступ к Web-приложению управления системой по адресу:
http://server/ccs-cbs-gw

Настройка пользователей и ролей должна выполняться на сервере приложений.

Icon

До разработки нового интерфейса средства мониторинга через web интерфейс отключены. Следить за работой шлюза необходимо по лог файлам (см. настройку логирования).

Настройка пользователей для сервера tomcat

По умолчанию пользователи настраиваются в файле $(CATALINA_HOME)/conf/tomcat-users.xml. Для настройки пользователей системы рассылки необходимо в этот файл добавить следующие настройки:

<role rolename="ccs-cbs-gw.web.manager"/>

<user username="gw" password="gw"

  roles="ccs-cbs-gw.web.manager" />

По умолчанию Tomcat хранит пароли в открытом виде. Чтобы изменить настройки авторизации обратитесь к документации по Tomcat.

Настройка пользователей для сервера WebSphere

В консоли сервера завести группу ccs-cbs-gw.web.manager.
В консоли сервера завести пользователя gw, добавить его в группу ccs-cbs-gw.web.manager.

Version	Status	Change Info	Actions
0.8.0	Complete	Page added in 0.8.0.	View Compare
0.9.0		Page not changed in version 0.9.0.	View Compare
0.10		Page not changed in version 0.10.	View Compare

Автоматизированные Банковские Системы

воскресенье, 5 октября 2014 г.