InstallationGuide

Материал из RunaWFE

Перейти к: навигация, поиск

Руководство по установке

Версия 4.3.0

© 2015-2019, ООО "Процессные технологии", материалы этого документа распространяются свободно на условиях лицензии GNU FDL. RunaWFE Free является системой с открытым кодом и распространяется в соответствии с LGPL лицензией (http://www.gnu.org/licenses/lgpl.html).

Исходный код проекта был перенесён с https://sourceforge.net/p/runawfe на https://github.com/processtech.

Содержание

# Аппаратные требования

Сервер - компьютер с размером ОЗУ >= 1Гб, свободное место на диске 2Гб, Операционная система – Windows (WinXP и выше), Linux (AltLinux, Debian, Ubuntu, Mint, Fedora), Sun Solaris, Mac OS.

Клиентский компьютер - должен допускать установку интернет браузера, поддерживающего HTML 4.0 (Замечание. Начиная с версии RunaWFE 4.2.0 не поддерживается браузер IE версии 6 и 7)

# Необходимое программное обеспечение

Для работы RunaWFE необходимо наличие установленного в системе комплекта Java Development Kit (JDK).


До версии 4.3.0 RunaWFE поддерживала JAVA 6, 7. Начиная с версии 4.3.0 введена поддержка JAVA версии 8, и отказ от JAVA 6.

В дальнейшем планируется отказ от jboss (java7), поэтому рекомендуется использовать версию на базе wildfly java8.

RunaWFE на базе java7 использует сервер приложений - Jboss AS 7.1.1.Final, для поддержки java8 используется сервер WildFly Full 10.0.0.Final.


Установленную версию Java можно определить, выполнив последовательно в командной строке

для Windows

java -version
%JAVA_HOME%/bin/java -version

для Linux или Mac OS

java -version
$JAVA_HOME/bin/java -version

Java SE Development Kit 8 - можно свободно загрузить здесь

# Варианты распространения RunaWFE

RunaWFE распространяется в следующих вариантах:

  • в виде специализированных дистрибутивов для конкретных операционных систем
  • в виде исполнимых файлов java-машины
  • в исходных кодах

# Специализированные дистрибутивы

Специализированные дистрибутивы представляют собой инсталляционные пакеты для различных операционных систем (rpm/deb для Linux, установщик exe или ISO образ для Windows). Их можно скачать с портала sourceforge, в разделе Distributives https://sourceforge.net/projects/runawfe/files/Distributives/

Текущая версия RunaWFE распространяемая в виде специализированных дистрибутивов представлена только для ОС Windows https://sourceforge.net/projects/runawfe/files/Distributives/Distributives%20for%20Windows/4.3.0/

Для ОС "ALT Linux 8" есть возможность установки RunaWFE из стабильного бранча p8.

Для других ОС используйте варианты в виде исполнимых файлов java-машин либо сборки из исходных кодов.


Перечислим компоненты системы, которые можно установить при помощи специализированных дистрибутивов.

Компоненты, относящиеся к клиентской части системы:

  • Клиент (web-интерфейс)
  • Среда разработки
  • Симулятор бизнес-процессов
  • Компонент, сигнализирующий о поступивших задачах

Компоненты, относящиеся к серверной части системы:

  • RunaWFE – сервер
  • Бот-станция

Механизм совместной работы компонентов:

На одном сервере запускается RunaWFE – сервер

На нескольких серверах могут быть запущены бот-станции

На клиентских компьютерах запускается браузеры или специальные компоненты, сигнализирующие о поступивших задачах. (В окне этого компонента открывается браузер, в который загружается web-интерфейс системы)

На клиентских компьютерах может быть запущена Среда разработки, а также симулятор бизнес-процессов.

Описание функциональности компонентов системы

RunaWFE – сервер содержит определения загруженных в него бизнес-процессов и выполняющиеся экземпляры бизнес-процессов.

Бот станции содержат ботов, которые периодически опрашивают RunaWFE – сервер.

Если выполняющиеся на RunaWFE – сервере экземпляры бизнес-процессов содержат задачи для ботов, загруженных в бот-станцию, то боты выполняют эти задачи и возвращают результаты работы на RunaWFE – сервер.

При помощи web-интерфейса системы пользователь может:

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

При помощи web-интерфейса системы администратор может:

  • Создавать-удалять пользователей и группы пользователей
  • Включать (исключать) пользователей в группы.
  • Раздавать права на объекты системы пользователям и группам пользователей
  • Принудительно останавливать экземпляры бизнес-процессов
  • Добавлять, изменять правила замещения пользователей

При помощи Среды разработки аналитик может разрабатывать бизнес-процессы и экспортировать их в файлы-архивы в файловую систему.

При помощи симулятора бизнес-процессов можно тестировать разработанные бизнес-процессы на условной конфигурации на клиентском компьютере аналитика, не загружая их в промышленную систему.

Замечание. RunaWFE – сервер уже содержит в себе локальную бот-станцию. Поэтому предполагается, что установить бот-станцию как отдельный компонент можно только на компьютер, на котором не установлен RunaWFE – сервер.

Замечание. RunaWFE – сервер и симулятор не должны быть установлены на один компьютер.

# OC Windows

Специализированные дистрибутивы RunaWFE для ОС Windows поставляются в виде исполняемого EXE файлов или ISO образов, которые могут быть записаны на диск.

Дистрибутивы можно скачать с портала sourceforge: https://sourceforge.net/projects/runawfe/ по следующим ссылкам (ссылки для версии 4.3.0 на базе wildfly, java8):


EXE:

Для 64-х разрядной операционной системы - https://sourceforge.net/projects/runawfe/files/Distributives/Distributives%20for%20Windows/4.3.0/Execution/wildfly/RunaWFE-4.3.0-Wildfly-java8_64.exe/download

Для 32-х разрядной операционной системы - https://sourceforge.net/projects/runawfe/files/Distributives/Distributives%20for%20Windows/4.3.0/Execution/wildfly/RunaWFE-4.3.0-Wildfly-java8_32.exe/download


ISO:

Для 64-х разрядной операционной системы - https://sourceforge.net/projects/runawfe/files/Distributives/Distributives%20for%20Windows/4.3.0/ISO/installer-wildfly-java8_64.iso/download

Для 32-х разрядной операционной системы - https://sourceforge.net/projects/runawfe/files/Distributives/Distributives%20for%20Windows/4.3.0/ISO/installer-wildfly-java8_32.iso/download


Внимание, не допускается использование дистрибутива несоответствующего разрядности вашей операционной системы, кроме того возможны проблемы с запуском сервера в случае установки дистрибутива с поддержкой java 7 на базе jboss в системе с установленной java версии 8.

Используйте версию на базе wildfly, java8.


Рассмотрим процесс установки RunaWFE.

Вставьте диск в дисковод (в случае дистрибутива на CD-диске) или запустите на выполнение файл RunaWFE-4.3.0-*.exe. Появится экран описания проекта RunaWFE. Нажмите "установить", прочтите сообщение о LGPL лицензии.

Inst win ru1.png

Inst win ru1 1.png

После утвердительного ответа на вопрос о принятии условий лицензии появится выбор – установить на компьютер клиентские или серверные компоненты RunaWFE

Inst win ru2.png

Выбор клиентских:

Inst win ru3.png

Выбор серверных компонентов:

Inst win ru4.png

После выбора компонентов нажмите Далее, и выберите варианты установки

Inst win ru5.png

Для полной переустановки без сохранения данных рекомендуется использовать опцию "Удалить все данные и настройки, оставшиеся от предыдущей установки"

Далее

Inst win ru6.png

Если в системе присутствует предыдущая версия RunaWFE, инсталлятор это определит. Все компоненты будет предложено заменить на новые.

Ext inst18.png

Если в системе отсутствует java или ее версия ниже чем необходима, инсталлятор предложит установить соответствующую версии RunaWFE.

Ext inst24.png

Также важно значение системной переменной JAVA_HOME. Инсталлятор предупредит в случае обнаружения не соответствия версии или отсутствия переменной, и изменит ее автоматически.

Exe inst java home 8.png

Далее

Inst win ru7.png


Для первого знакомства с системой рекомендуется установить на компьютер клиентские компоненты. Клиентский компонент "симулятор" является адаптированной для рабочей станции версией RunaWFE сервера, этот компонент содержит в себе локальную бот-станцию. Поэтому клиентских компонентов достаточно для того, чтобы познакомиться со всей функциональностью RunaWFE.

После установки клиентских компонентов RunaWFE, работать с системой можно через системное меню ( Пуск / Программы / RunaWFE) или через расположенные на рабочем столе иконки.

Для возможности запуска и выполнения бизнес-процессов необходимо запустить RunaWFE сервер (симулятор). Симулятор можно запустить, например, командой меню Пуск / Программы / RunaWFE / Start Simulation. Далее для работы с системой через web-интерфейс рекомендуется выполнить команду Пуск / Программы / RunaWFE / Simulation Web Interface. Логин администратора по умолчанию – "Administrator" (существенно, что с большой буквы), пароль администратора – "wf".

Основным компонентом системы является RunaWFE сервер (В варианте установки клиентских компонентов - Симулятор). Остальные компоненты – дополнительные. При установленном RunaWFE сервере (симуляторе) для работы с системой достаточно только наличия Web-браузера.


# Переход с дистрибутива RunaWFE на базе jboss java7 на RunaWFE на базе wildfly java8

Внимание. Особым случаем есть переход с java7 jboss на wildfly с поддержкой java8, в этом случае после установки RunaWFE потребуется внести изменения в системную переменную path.

Добавьте путь к каталогу java bin, в зависимости от разрядности установленной версии java.


Выполните в командной строке (с правами администратора),

x64

setx -m path "%path%;C:\Program Files\Java\jre1.8.0_181\bin"

x86

setx -m path "%path%;C:\Program Files (x86)\Java\jre1.8.0_181\bin"


Или используйте GUI


В Windows 10 и Windows 8

  • В строке "Поиск" выполните поиск: Система (Панель управления)
  • Нажмите на ссылку "Дополнительные параметры системы".
  • Нажмите "Переменные среды". В разделе "Переменные среды" выберите переменную path. Нажмите "Изменить".
  • В открывшемся окне добавьте строку (в зависимости от разрядности и версии установленной java, см. выше)
;C:\Program Files\Java\jre1.8.0_181\bin 
  • Нажмите ОК. Закройте остальные открытые окна, нажимая ОК.


В Windows 7

  • На рабочем столе правой кнопкой нажмите на значок "Компьютер".
  • В контекстном меню выберите "Свойства".
  • Нажмите на ссылку "Дополнительные параметры системы".
  • Нажмите "Переменные среды". В разделе "Переменные среды" выберите переменную path. Нажмите "Изменить".
  • В открывшемся окне добавьте строку (в зависимости от разрядности и версии установленной java, см. выше)
;C:\Program Files\Java\jre1.8.0_181\bin

# OC Linux

Для ОС "ALT Linux 8" пакеты RunaWFE представлены в репозиториях p8 и Sisyphus.

Для других дистрибутивов семейства Linux отсутствуют специализированные пакеты, используйте варианты в виде исполнимых файлов java-машин либо сборки из исходных кодов..


Рассмотрим установку пакетов RunaWFE в ОС "ALT Linux 8"

Пакеты RunaWFE представлены в репозиториях p8 и Sisyphus (подключение репозитория Sisyphus)

  • выполните обновление локального индекса пакетов до последних изменений в репозиториях
sudo apt-get update
  • установите jdk версии 8
sudo apt-get install java-1.8.0-openjdk
  • установите пакеты RunaWFE (сервер, среда разработки и оповещатель о поступивших задачах)
sudo apt-get install runawfe-server runawfe-gpd runawfe-notifier


Для запуска сервера используйте соответствующий значок в меню "Запуск сервера RunaWFE" в категории "Офис", или воспользуйтесь командой

sudo service runawfe start

Для остановки используйте пункт "Остановка сервера RunaWFE" или команду

sudo service runawfe stop


Web интерфейс должен быть доступен по адресу http://localhost:28080/wfe

Замечание. В версиях сервера для ALTLinux изменен порт подключения к серверу на 28080.


Конфигурационные файлы сервера расположены в директории /usr/share/wildfly-as/standalone/configuration/ , используется конфигурация из файла standalone-runa.xml


Для запуска Среды разработки используйте значок в меню или команду

runawfe-gpd


Для запуска Оповещателя используйте значок в меню или команду

runawfe-notifier

# OC Macintosh

Для ОС Mac на текущий момент отсутствуют специализированные дистрибутивы, используйте вариант в виде исполнимых файлов java-машины.

# RunaWFE в случае распространения в виде исполнимых файлов java-машины

В этом случае RunaWFE распространяется в виде файла-архивов, содержащих откомпилированный код, а также все необходимые конфигурационные файлы и библиотеки.


Файл-архив сервера можно скачать с портала sourceforge runawfe-server-4.3.0.zip (на базе wildfly, java8)

Файл-архив среды разработки можно скачать с портала sourceforge Developer Studio (выбрать в зависимости от типа и разрядности ОС)

Файл-архив оповещателя можно скачать с портала sourceforge TaskNotifier (представлен только для Windows)


# Установка java машины

RunaWFE в случае распространения в виде исполнимых файлов java-машины требует установленную в системе JAVA версии 8.

Проверить установленную в системе версию JAVA можно с помощью команды

java -version

Например из следующего скриншота видно, что в системе установлена и используется Java машина 7-й версии для 64-х разрядной ОС.

Java ver.png


Установка Java в Linux выполняется с помощью соответствующего ОС инструмента для работы с пакетами. Например, для ALT Linux это может быть apt-get

sudo apt-get install java-1.8.0-openjdk


Далее рассмотрим пример процесса установки java для ОС Windows.

Java SE Development Kit 8 - можно свободно загрузить здесь

Запустите загруженный exe инсталлятор и нажмите Далее (Next)

Inst java1.png


Используйте путь установки "по умолчанию"

Inst java2.png


Нажмите Далее

Inst java3.png


Закройте окно инсталлятора (кнопка Close) после успешной установки

Inst java5.png


# Установка и запуск сервера

Загрузите файл-архив сервера runawfe-server-4.3.0.zip (на базе wildfly, java8)

Распакуйте его в произвольную папку.

Для запуска сервера в Windows используйте файл - standalone.bat

Для запуска в Linux файл - standalone.sh


запуск из терминала в Linux

sh standalone.sh

или

./standalone.sh 

Обратите внимание, должно быть разрешено выполнение файла standalone.sh как программы.


Debian standalone sh.png

или с помощью базовой команды

chmod +x standalone.sh

# Установка и запуск среды разработки

Загрузите файл-архив среды разработки Developer Studio (выбрать в зависимости от разрядности и типа ОС) и разархивируйте его.

Откройте на выполнение файл

runa-gpd.exe (Windows)
runa-gpd (Linux)

# RunaWFE в случае распространения в виде исходных текстов

Процесс сборки сервера описан в руководстве разработчика.

Процесс сборки Среды разработки описан в руководстве разработчика.

Процесс сборки оповещателя описан в руководстве разработчика.

# Возможные проблемы и их решения

# OC Linux

# Не открывается окно графа процесса в DevStudio

Для работы DevStudio 4.3.0 в Linux требуется установленный в системе пакет GTK+. Рекомендуется использовать версию 3.x

Однако в некоторых операционных системах были обнаружены проблемы с открытием окна графа БП, несмотря на присутствие gtk3

Fedora gtk3 npe.png


В частности такая проблема наблюдается в Fedora 28, при наличии установленного пакета

gtk3.x86_64 3.22.30-1.fc28 


В качестве возможного решения можно попробовать запустить DevStudio на gtk+ версии 2:

  • убедитесь в наличии в системе версии gtk2,

Fedora gtk2.png

  • добавьте в переменные окружения
SWT_GTK3=0
  • запустите DevStudio из командной строки
./runa-gpd


# Не открывается редактор форм в DevStudio

Для работы редактора форм в DevStudio, в ОС Linux используется WebKitGTK+ https://www.webkitgtk.org/

Рекомендуется использовать версию 3.x

В случае установленного в системе пакета webkitgtk неподходящей версии (1.x) или вовсе его отсутствия, при попытке вызвать редактор форм могут возникать ошибки следующего вида

org.eclipse.swt.SWTError: No more handles [Browser style SWT.MOZILLA and Java system property org.eclipse.swt.browser.DefaultType=mozilla are not supported with GTK 3 as XULRunner is not ported for GTK 3 yet]
   at org.eclipse.swt.SWT.error(SWT.java:4559)
   at org.eclipse.swt.browser.MozillaDelegate.<init>(MozillaDelegate.java:57)
   at org.eclipse.swt.browser.Mozilla.create(Mozilla.java:655)
org.eclipse.swt.SWTError: No more handles
   at org.eclipse.swt.SWT.error(SWT.java:4559)
   at org.eclipse.swt.SWT.error(SWT.java:4448)
   at org.eclipse.swt.SWT.error(SWT.java:4419)

No webkit err.png


Решением данной проблемы будет установка с помощью системного пакетного менеджера достаточной для запуска версии webkitgtk.

Например,

  • в Debian 9 помогла установка из репозитория libwebkitgtk версии 3.0-0,
apt-get install libwebkitgtk-3.0-0
dnf install webkitgtk-2.4.11-8.1.x86_64.rpm


# Ошибка распаковки файл-архива

В случае проблем с распаковкой файл-архива, содержащего сервер или DevStudio,

Debian extract err.png

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

  • попробуйте скачать архив заново, возможно архив был загружен с ошибками
  • используйте другой менеджер архивов для распаковки, возможно используется устаревшая версия

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

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

Здесь <wfserver> - адрес сервера. При установке RunaWFE на локальный компьютер надо заменить <wfserver> на localhost (http://localhost:8080/wfe)

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

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

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

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

Логин: Administrator

Пароль: wf

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

# Демо-конфигурация

В случае установки симулятора со специализированных дистрибутивов для Windows, на сервере автоматически будет развернута конфигурация с набором демо данных (пользователи, процессы, бот станция и т.д. ).

В случае использования RunaWFE в виде исполнимых файлов java-машины, демо-конфигурацию можно установить используя специальный скрипт. Для этого выполните следующие действия:

  • запустите сервер
  • перейдите в пункт меню "Система", раздел "Скрипты"
  • нажмите на ссылку "Загрузить"
  • в открывшемся окне перейдите в каталог ..\wildfly\adminkit\scripts\ и выберите файл deploy-samples-script.xml
  • введите название deploy-samples-script.xml и нажмите "Сохранить"

Deploy samples script1.png


  • кликните по ссылке на созданный скрипт, и нажмите "Выполнить"

Deploy samples script2.png


Признаком успешной установки демо-конфигурации, будет сообщение "Скрипт успешно выполнен".

Далее импортируйте с сервера демо процессы и бот станцию в среду разработки.


Кроме того, данные на сервер можно загрузить использую файл с данными (archive.datafile), подробнее в руководстве по экспорту и загрузке файла с данными.

Личные инструменты