RUNA WFE. Руководство по установке и конфигурированию.

Версия 2.3

buy viagra online without a prescription http://erectionpillsvcl.com cialis generic price <a href= http://erectionpillsvcl.com >generic cialis next day delivery</a> levitra online sales

Запуск и остановка системы

Права для установки системы.

Вы должны иметь права на запуск приложений, слушающих порты, необходимые для работы сервера приложений, входящего в состав системы (по умолчанию 1098, 1099, 8083, 4444, 4445,8080)

Замечание. В случае операционной системы AltLinux порт 8080 занят системными службами, поэтому вместо него надо использовать другой порт. Как правило, это порт 28080.

Запуск системы

Вариант распространения в бинарных файлах

Перейдите в папку $(DIST_ROOT)/bin. В случае операционной системы Windows запустите run.bat, в случае операционной системы Unix (Linux), запустите run.sh

Вариант распространения в исходных текстах

Перейдите в папку ${JBOSS_HOME}/bin. В случае операционной системы Windows запустите run.bat, в случае операционной системы Unix (Linux), запустите run.sh

Остановка системы

Вариант распространения в бинарных файлах

В случае операционной системы «Windows» выполните:

$(DIST_ROOT)/bin/shutdown.bat -S

В случае операционной системы «Linux» выполните:

$(DIST_ROOT)/bin/shutdown.sh -S

Вариант распространения в исходных текстах

В случае операционной системы «Windows» выполните:

${JBOSS_HOME}/bin/shutdown.bat -S

В случае операционной системы «Linux» выполните:

${JBOSS_HOME}/bin/shutdown.sh -S

Как войти в систему.

Откройте web-браузер по адресу http://<servername>:8080/wfe

Здесь <servername>- адрес сервера.

Замечание. В случае операционной системы AltLinux порт 8080 занят системными службами, поэтому в этом случае используется другой порт (см. раздел «Как установить RUNA WFE»). Как правило, это порт 28080. Т.е в случае ОС AltLinux откройте web-браузер по адресу http://<servername>:28080/wfe

Замечание: Альтернативный вариант. Можно использовать VBS скрипт, находящийся в $(DIST_ROOT)/tools/login.vbs. В этом скрипте необходимо задать URL workflow сервера с указанием имени хоста и порта (установить переменную HOST_URL).

Замечание. В случае использования протокола SSL надо использовать другой адрес https://<servername>:8443/wfe

Браузер должен показать страницу ввода логина и пароля пользователя.

Логин и пароль администратора системы (по умолчанию):

Логин: Administrator

Пароль: wf

(В логине и пароле необходимо учитывать регистр)

Замечание. Файлы, соответствующие демо-процессам, находятся в папке $(DIST_ROOT)/samples.

Настройка web-контейнера входящего в состав системы

В состав системы входит web-контейнер Jakarta-Tomcat 5.0. Конфигурационные файлы контейнера находятся в директории $(DIST_ROOT)/server/default/jbossweb-tomcat50.sar. Полная документация по настройке контейнера находится на http://jakarta.apache.org/tomcat/tomcat-5.0-doc/index.html.

loShhu <a href="http://tchlzvjrdfcg.com/">tchlzvjrdfcg</a>, [url=http://oxhslautdaqm.com/]oxhslautdaqm[/url], [link=http://tghfvbzziojk.com/]tghfvbzziojk[/link], http://twcmvjudqqvn.com/

Настройка работы с базой данных (с перекомпиляцией системы, вариант дистрибутива в исходных текстах).

Настройка на MySQL сервер

1. Поместите драйвер для mysql сервера в папку $(DIST_ROOT)/server/default/lib

2. Создайте конфигурационный файл источника данных (Data Source) для сервера приложений JBOSS в папке $(DIST_ROOT)/server/default/deploy (например, myql-ds.xml) и настройте его на mysql сервер.

Замечание. Конфигурационный файл источника баз данных для JBOSS должен обязательно иметь суффикс –ds перед точкой в имени файла.

Пример файла:

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

<local-tx-datasource>

<jndi-name>af/ds/mysql</jndi-name>

<connection-url>jdbc:mysql://YourIp:3306/DEMO_WF_DB? UseUnicode=true&characterEncoding=UTF-8</connection-url>

<driver-class>com.mysql.jdbc.Driver</driver-class>

<user-name>yourusername</user-name>

<password>secret</password>

</local-tx-datasource>

</datasources>

3. Настройте файл конфигурации Hibernate - $(DIST_ROOT)/hibernate_build.properties

В файле укажите диалект - net.sf.hibernate.dialect.MySQLDialect

и созданный в предыдущем разделе Data Source.

Пример настройки файла, соответствующий примеру для Data Source:

# Hibernate configuration

hibernate.connection.datasource=java:/af/ds/mysql

hibernate.dialect=net.sf.hibernate.dialect.MySQLDialect

hibernate.transaction.factory_class=net.sf.hibernate.transaction.JTATransactionF

actory

hibernate.transaction.manager.lookup=net.sf.hibernate.transaction.JBossTransacti

onManagerLookup

hibernate.cache_provider=net.sf.hibernate.cache.EhCacheProvider

hibernate.cache.use_query_cache=true

hibernate.show_sql=true

hibernate.jdbc.batch_size=20

hibernate.jdbc.fetch_size=20

4. Настройте файл конфигурации ядра workflow системы - $(DIST_ROOT)/resources/wf/wf_jbpm.properties

В файле укажите диалект - net.sf.hibernate.dialect.MySQLDialect

и созданный в предыдущем разделе Data Source.

Пример настройки файла, соответствующий примеру для Data Source:

hibernate.connection.datasource=java:/af/ds/mysql

hibernate.dialect=net.sf.hibernate.dialect.MySQLDialect

hibernate.transaction.factory_class=net.sf.hibernate.transaction.JTATransactionFactory

hibernate.transaction.manager_lookup_class=net.sf.hibernate.transaction.JBossTransactionManagerLookup

hibernate.cache_provider=net.sf.hibernate.cache.EhCacheProvider

hibernate.cache.use_query_cache=true

hibernate.jdbc.batch_size=20

hibernate.jdbc.fetch_size=20

hibernate.show_sql=false

jbpm.log.stdout=off

jbpm.create.tables=force-create

Перекомпилируйте систему, произведите редеплоймент в контейнер сервера приложений JBOSS.

Настройка на MS SQL сервер

Замечание: для правильной работы с русскими буквами, созданная для системы база данных MS SQL SERVER должна иметь windows collation “Cyrillic_General_BIN”.

Настройка состоит в изменении двух значений в двух конфигурационных файлах и создании конфигурационного файла источника данных (Data Source) для сервера приложений JBOSS.

1. Поместите драйвер для ms sql сервера в папку $(DIST_ROOT)/server/default/lib

2. Создайте конфигурационный файл источника данных (Data Source) для сервера приложений JBOSS в папке $(DIST_ROOT)/server/default/deploy (например, myql-ds.xml) и настройте его на ms sql сервер. (подробнее см. раздел Настройка на MySQL сервер).

3. Настройте файл конфигурации Hibernate - $(DIST_ROOT)/hibernate_build.properties

В файле укажите диалект - net.sf.hibernate.dialect.SQLServerDialect

и созданный в предыдущем разделе Data Source.

4. Настройте файл конфигурации ядра workflow системы - $(DIST_ROOT)/resources/wf/wf_jbpm.properties

В файле укажите диалект - net.sf.hibernate.dialect.SQLServerDialect

и созданный в предыдущем разделе Data Source.

Перекомпилируйте систему, произведите редеплоймент в контейнер сервера приложений JBOSS.

Настройка работы с базой данных (без перекомпиляции системы).

Работа с базой данных по умолчанию.

По умолчанию в системе будет использоваться сервер баз данных HSQL. Однако систему можно настроить и на другие сервера баз данных: MySQL, MS SQL Server, Oracle и т.д. Приведем примеры настройки подключения к серверу баз данных в случае MS SQL Server’а и MySQL сервера.

Настройка на MySQL сервер

1. Поместите драйвер для mysql сервера в папку $(DIST_ROOT)/server/default/lib

2. Создайте конфигурационный файл источника данных (Data Source) для сервера приложений JBOSS в папке $(DIST_ROOT)/server/default/deploy (например, myql-ds.xml) и настройте его на mysql сервер (подробнее см. предыдущий раздел).

3. В файле-архиве $(DIST_ROOT)/server/default/deploy/af.logic.jar откройте файл hibernate.cfg.xml и измените в нем свойство

dialect на net.sf.hibernate.dialect.MySQLDialect.

(<property name="dialect">net.sf.hibernate.dialect.MySQLDialect</property>),

также измените свойство connection.datasource на имя источника данных, которое вы ввели в конфигурационном файле источника данных.

4. В файле-архиве $(DIST_ROOT)/server/default/deploy/wf.logic.jar откройте файл wf_jbpm.properties и измените в нем свойство dialect на net.sf.hibernate.dialect.MySQLDialect.

(hibernate.dialect=net.sf.hibernate.dialect.MySQLDialect),

также измените свойство hibernate.connection.datasource на имя источника данных, которое вы ввели в конфигурационном файле источника данных.

Замечание. RUNA WFE независимо хранит данные, относящиеся к выполнению экземпляров бизнес-процессов и данные, относящиеся к исполнителям и безопасности. Поэтому для настроек используются два конфигурационных файла. Однако в этих файлах можно указать одну и ту же базу данных.

Настройка на MS SQL сервер

1. Поместите драйвер для MS SQL сервера в папку $(DIST_ROOT)/server/default/lib

2. Создайте конфигурационный файл источника данных (Data Source) для сервера приложений JBOSS в папке $(DIST_ROOT)/server/default/deploy (например, mssql-ds.xml) и настройте его на mysql сервер.

3. В файле-архиве $(DIST_ROOT)/server/default/deploy/af.logic.jar откройте файл hibernate.cfg.xml и измените в нем свойство

dialect на net.sf.hibernate.dialect.SQLServerDialect.

(<property name="dialect">net.sf.hibernate.dialect.SQLServerDialect </property>),

также измените свойство connection.datasource на имя источника данных, которое вы ввели в конфигурационном файле источника данных.

4. В файле-архиве $(DIST_ROOT)/server/default/deploy/wf.logic.jar откройте файл wf_jbpm.properties и измените в нем свойство dialect на net.sf.hibernate.dialect.MySQLDialect.

(hibernate.dialect=net.sf.hibernate.dialect.SQLServerDialect),

также измените свойство hibernate.connection.datasource на имя источника данных, которое вы ввели в конфигурационном файле источника данных.

Настройка конфигурационного файла источника данных для MS SQL сервера на работу с конкретной базой данных

В файле $(DIST_ROOT)/server/default/deploy/<имя конфигурационного файла>.xml:

исправьте содержание элемента <connection-url> так, чтобы он указывал на выбранный для хранения данных сервер баз данных и на базу на этом сервере (детальное описание формата строки соединения с базой данных см. http://jtds.sourceforge.net/faq.html#urlFormat).
исправьте содержимое элементов <user-name> и <password> соответственно на реальные имя и пароль некоторого пользователя этой базы данных. (Этот пользователь должен иметь права на создание/удаление таблиц, выполнение запросов на выборку, изменение, удаление, добавление строк в созданных таблицах.)

Описание системы логирования

Логи в системе Runa WFE ведутся при помощи системы логирования log4j(http://logging.apache.org/log4j). Подробное описание системы находится в \\Workflow_comp\doc\programming\java\logging\log4j_The_Complete_Manual.pdf.

Настройки «по умолчанию» log4j в системе RunaWFE обеспечивают следующее:

Генерируемые WF-системой лог-файлы находятся в папке $(DIST_ROOT)/server/default/log

Генерируются следующие файлы:

boot.log – информация о загрузке
server.log – «серверные» события и ошибки
runa.log – события в системе RunaWFE

В штатном режиме функционирования системы RunaWFE интерес для администратора системы в основном представляет информация, содержащаяся в файле runa.log (Вся информация, направляемая в файл runa.log, также дублируется в NTEventLog).

В файл runa.log записываются следующие события:

Успешный login в систему
Неудачная попытка login’а в систему
Logout
Deployment бизнес-процесса в систему
Undeployment бизнес-процесса из системы
Запуск бизнес-процесса
Выполнение задачи в Узле-Действии бизнес-процесса
Отмена бизнес-процесса
Работа ботов

Framework log4j для WF-системы настраивается в файле $(DIST_ROOT)/server/default/conf/log4j.xml

Настройка SMTP логирования

Для включения возможности получать лог-сообщения по почте необходимо:

Добавить приемщика SMTP сообщений
Ассоциировать приемщика с необходимыми категориями сообщений

Приемщик SMTP сообщений добавляется следующим фрагментом конфигурационного файла

</layout>

</appender>

Настраиваемые параметры:

EvaluatorClass – класс определяющий политику отсылки логов, политика по умолчанию – кеширование всех принятых сообщений до появления первого сообщения с уровнем ERROR, после этого все сообщения отсылаются по назначению и очередь очищается. Указанный в примере evaluator class – AnyMessageTriggeringEventEvaluator отсылает сообщения сразу по мере их поступления, независимо от их уровня. (AnyMessageTriggeringEventEvaluator поставляется отдельно в архиве log4j-extra.jar)
To – получаетель писем
From – отправитель писем (содержание поля From в отсылаемом письме)
Subject – тема писем (содержание поля Subject в отсылаемом письме)
SMTPHost – имя хоста через который происходит отсылка писем
BufferSize – длина очереди сообщений (по умолчанию 512). При достижения лимита очереди самые старые сообщения в очереди заменяются на новые
errorHandler – обработчик сообщений. Указанный в примере error handler логирует только первое сообщений, все последующие точно такие же сообщений (с теми же атрибутами сообщения) отбрасываются
layout – описание формата отсылаемых сообщений

Ассоциировать приемщик с категорией можно следующим образом:

для обычной категории добавить ссылку на приемщик в описание категории, например:

<appender-ref ref="SMTP"/>

</category>

где SMTP – имя приемщика описанного ранее;

для коренной категории добавить ссылку в описание коренной категории, например:

<root>

<appender-ref ref="SMTP"/>

<appender-ref ref="FILE"/>

</root>

Настройка Event Viewer логирования

Для настройки логирования сообщений в Windows Event Viewer необходимо:

Добавить приемщика Event Viewer сообщений

Ассоциировать приемщика с необходимыми категориями сообщений
Поместить поставляемую отдельно библиотеку NTEventLogAppender.dll в системные пути (пути доступные через переменную окружения PATH)

Приемщик Event Viewer сообщений добавляется следующим фрагментом конфигурационного файла

</layout>

</appender>

Настраиваемые параметры:

source – источник сообщений отображаемый в Event Viewer

errorHandler – см. описание этого параметра в описании SMTP приемщика

Ассоциирование приемщика с категориями осуществляется так же как и для SMTP приемщика.

Приемщики сообщений поставляемые с конфигурацией по умолчанию

appender	Краткое описание
FILE	Этот приемщик соответствует файлу server.log
RUNAFILE	Этот приемщик соответствует файлу runa.log
CONSOLE	Этот приемщик направляет сообщения на консоль сервера приложений
NTEventViewer	Этот приемщик направляет сообщения в журнал приложений системы просмотра событий OS Windows

WF-system Installation guide ru

Contents

Запуск и остановка системы

Права для установки системы.

Запуск системы

Остановка системы

Как войти в систему.

Настройка web-контейнера входящего в состав системы

Настройка работы с базой данных (с перекомпиляцией системы, вариант дистрибутива в исходных текстах).

Настройка на MySQL сервер

Пример файла:

Настройка на MS SQL сервер

Настройка работы с базой данных (без перекомпиляции системы).

Работа с базой данных по умолчанию.

Настройка на MySQL сервер

Настройка на MS SQL сервер

Настройка конфигурационного файла источника данных для MS SQL сервера на работу с конкретной базой данных

Описание системы логирования

Настройка SMTP логирования

Настройка Event Viewer логирования

Navigation menu

Search