Система рассылки разрабатывается для работы под управлением сервера приложений. Система рассылки состоит из следующих компонентов:
- Приложение системы рассылки.
- БД рассылки.
- Приложение сопряжения с системами Oracle.
Содержание поставки системы рассылки
Приложение системы рассылки (CCS) поставляется в виде архива. Файл архива называется ccs-bin.zip.
Архив имеет следующую структуру:
| ccs.war | Приложение сервера рассылки |
| ccs-api.war | API сервера рассылки (для WebSphere) |
| activity-explorer.war | Приложение для работы с ручными сценариями рассылки (компонент Activiti) |
| lib/ | Папка с библиотеками, устанавливаемыми на сервер приложений |
Порядок установки под tomcat
Установка библиотек
Библиотеки поставляются в каталоге lib дистрибутива. Перечень библиотек, устанавливаемых на сервер приложений:
| ccs-api.jar | API системы рассылки, поставляется вместе с системой. |
| mail.jar | Библиотека JavaMail 1.4.5 |
| ojdbc6.jar | JDBC драйвер Oracle |
| jaxws/ | Библиотека JAX-WS RI 2.2.6-2 |
Библиотеки копируются в каталог $(CATALINA_HOME)/lib.
Установка приложения системы рассылки
Приложение устанавливается средствами tomcat manager (см. документацию по tomcat).
Настройка приложения системы рассылки
После установки приложения нужно выполнить настройку ресурсов. Настройка выполняется в файле $(CATALINA_HOME/conf/Catalina/localhost/ccs.xml). В этом файле описаны JNDI ресурсы используемые приложением.
Ресурс jdbc/cbs
Описывает подключение к базе данных CBS. Поставляемая по умолчанию конфигурация следующая:
Назначение атрибутов ресурса:
| Атрибут | Описание |
| driverClassName | JDBC драйвер используемый для подключения к БД |
| User | Имя пользователя для подключения к БД |
| Password | Пароль для подключения к БД |
| url | Строка подключения к БД |
Ресурс mail/Session
Описывает параметры библиотеки JavaMail, используемые при отправке электронной почты по каналу EMAIL. Поставляемая по умолчанию конфигурация следующая:
Назначение атрибутов ресурса:
| Атрибут | Описание |
| mail.from | Задает адрес отправителя, подставляемый в исходящие сообщения |
| mail.transport.protocol | Задает используемый протокол отправки почты |
| mail.smtp.host | Адрес SMTP сервера |
| mail.smtp.port | Порт SMTP сервера |
| mail.smtp.auth | Необходима авторизация при подключении к SMTP серверу |
| mail.smtp.from | Адрес отправителя, передаваемый SMTP серверу |
| mail.smtp.account | Пользователь, зарегистрированный на SMTP сервере |
| mail.smtp.password | Пароль пользователя SMTP сервера |
| mail.debug | Необходимость вывода диагностики SMTP |
| mail.compress | Формат упаковки для вложений |
Настройка канала SMS
Файл конфигурации по умолчанию находится в каталоге установленного WEB приложения по пути: com/colvir/ccs/serever/settings/ccs.sms.xml. Поставляемый файл конфигурации изменять не рекомендуется!
Порядок индивидуальной настройки:
- Скопировать файл ccs.sms.xml в каталог $(CATALINA_HOME)/conf.
- Выполнить индивидуальные настройки провайдера SMPP.
- Установить системное свойство Java com.colvir.ccs.SMSConfigFile в значение полного пути к файлу. Например, "C:/tomcat/conf/ccs.sms.xml". Установить системное свойство можно через переменную окружения JAVA_OPTS в файле bin/catalina.bat следующей командной: set JAVA_OPTS = %JAVA_OPTS% -Dcom.colvir.ccs.SMSConfigFile="C:/tomcat/conf/ccs.sms.xml".
- Перезапустить сервер tomcat.
Порядок установки под WebSphere
Установка библиотек
Установка библиотек выполняется из консоли сервера, меню Services\Repository.
Добавляем ccs-api.war.
| Group: | colvir |
| Artifact: | ccs-api |
| Version: | 1.0 |
| Type: | war |
Добавляем JDBC драйвер ojdbc6.jar (если не устанавливался ранее).
| Group: | colvir |
| Artifact: | ccs-cbs-gw |
| Version: | 1.0 |
| Type: | war |
Настройка сервера приложений
Прежде чем устанавливать приложение необходимо выполнить настройки сервера.
Настройка подключения к БД
Настройка подключения выполняется в консоли сервера в разделе Services/Database Pools. Необходимо добавить DB Pool с именем ccs.
| Pool Name: | ccs | |
| Database Type: | Oracle Thin | |
| JDBC Driver Class: | oracle.jdbc.OracleDriver | |
| Driver JAR: | colvir/oracle/1.0/jar | |
| DB User Name: | ccs | Параметры подключения уточнять у администратора |
| DB Password: | ccs | |
| Host:Port:SID | 127.0.0.1:1521:CCS |
Настройка параметров JavaMail
Возможно два варианта настройки использования JavaMail:
- Использование настроек JavaMail по умолчанию.
- Локальные настройки JavaMail для приложения.
Настройки JavaMail по умолчанию
Сервер WebSphere поставляется с собственным модулем JavaMail. Настройки могут быть выполнены через файлы конфигурации сервера. Для настройки поставляемого в составе WebSphere компонента JavaMail необходимо выполнить следующие действия:
- Остановить работающий сервер.
- В файле var/config/config.xml найти описание модуляorg.apache.geronimo.configs/javamail/2.1.4/car.
- В описание модуля добавляется настройка дополнительных свойств JavaMail. Полное описание модуля выглядит так:
4. В файле var/config/config-substitutions.properties задаем значения переменных для использования электронной почты:
5. Запустить сервер.
Локальная настройка JavaMail
Для этого в поставляемом архиве приложения ccs.war следует изменить настройки в файле geronimo-web.xml. Порядок изменения настроек следующий:
- Извлечь файл ccs.war:WEB-INF/geronimo-web.xml
- Изменить в файле секцию ссылки на ресурсы:
3. Убрать комментарий для локальной настройки сессии:
4. Запаковать обратно измененный файл в ccs.war или использовать измененный файл дискриптора для разворачивания приложения.
Настройка канала отправки SMS сообщений
Для отправки SMS сообщений используется протокол SMPP. По умолчанию поставляется настройка канала отправки, использующая сервер SMPP на локальном компьютере:
| Хост: | 127.0.0.1 |
| Порт: | 2775 |
| Пользователь: | ccs |
| Пароль: | ccs |
Файл конфигурации по умолчанию находится в каталоге установленного WEB приложения по пути com/colvir/ccs/serever/settings/ccs.sms.xml. Поставляемый файл конфигурации изменять не рекомендуется!
Порядок индивидуальной настройки:
- Скопировать файл ccs.sms.xml в каталог $(GERONIMO_HOME)/var/config.
- Выполнить индивидуальные настройки провайдера SMPP.
- Установить системное свойство Java com.colvir.ccs.SMSConfigFile в значение полного пути к файлу. Например, "C:\Program Files\IBM\WebSphere\AppServerCommunityEdition\var\config\ccs.sms.xml". Установить системное свойство можно через переменную окружения JAVA_OPTS в файле "C:\Program Files\IBM\WebSphere\AppServerCommunityEdition\bin\setjavaenv.bat" следующей командной: set JAVA_OPTS = %JAVA_OPTS% -Dcom.colvir.ccs.SMSConfigFile=" C:\Program Files\IBM\WebSphere\AppServerCommunityEdition\var\config\ccs.sms.xml".
- Перезапустить сервер WebSphere.
Установка приложения работы со сценариями рассылки
Приложение устанавливается на сервер после установки приложения рассылки, так как использует те же ресурсы подключения к базе рассылки. Приложение устанавливается через консоль сервера.
Управление доступом
Приложение системы рассылки предоставляет Web интерфейс управления системой и Web сервисы. Доступ к Web интерфейсу управления осуществляется по адресу: http://server/ccs. Доступ к Web сервисам осуществляется по адресу: http://server/ccs/ServerEngineWS. Для ограничения доступа используются следующие роли:
| ccs.web.manager | Разрешает доступ к Web приложению управления системой по адресу: http://server/ccs |
| ccs.web.service | Разрешает использование Web сервисов по адресу: http://server/ccs/ServerEngineWS |
Настройка пользователей и ролей должна выполняться на сервере приложений.
Настройка пользователей для сервера tomcat
По умолчанию пользователи настраиваются в файле $(CATALINA_HOME)/conf/tomcat-users.xml. Для настройки пользователей системы рассылки необходимо в этот файл добавить следующие настройки:
По умолчанию Tomcat хранит пароли в открытом виде. Чтобы изменить настройки авторизации обратитесь к документации по Tomcat.
Настройка пользователей для сервера WebSphere
- В консоли сервера завести группы ccs.web.manager, ccs.web.service.
- В консоли сервера завести пользователя ccs, добавить его в группы ccs.web.manager, ccs.web.service.
Комментариев нет:
Отправить комментарий