BPS用户手册

业务流程服务器用户手册
➢目录
1 系统概述 (3)
1.1 概述 (3)
1.2特点及功能 (3)
2技术概览 (4)
2.1体系结构 (4)
2.2基础服务 (6)
2.3 管理与监控 (6)
3 快速开始 (6)
3.1 概述 (6)
3.2 基本功能快速入门 (12)
4安装指南 (15)
4.1 系统配置要求 (15)
4.2 产品安装 (15)
4.3 安装后的工作 (16)
5 管理指南 (16)
5.1 系统管理 (16)
5.2 系统日志 (22)
A.概述
BPS成为业务出服务（以下简称BPS）是一套完整的基于WEB界面的工作流管理系统（BPM），用于部署、管理、监控业务流程及其实例。

它是基于WSO2—Carbon平台开发的，以OSGi框架为基础，高度模块化，可根据SOA需要个性化增减系统模块。

B.特点及功能
BPS的主要特点：
高度模块化：模块间独立性强，可根据功能需求自由定制；
安全性高：具备完整的用户权限管理机制，并可对发布的业务流程加密，提高安全可靠性；
配置灵活：后台管理系统具有全面丰富的配置详单，可对系统进行全面的监视，并可根据需要自由配置系统监视功能。

BPS的主要功能：
B PS主要用于部署、管理和监控业务流程及其流程实例。

A.体系结构
a)数据交互结构
上图说明WSO2—Business Process Server与其他WSO2产品的交互关系。

在工作流服务器运行时，会与AppServer、DataService、ESB、Governance Registry、Gadget Server等不同类服务器发生数据交互。

前端交互：BPS作为SOA的重要组成部分，是在Portal之后直接支持业务运转的关键服务器。

BPS通过Gadget Server与用户发生交互，接收业务流请求，并将响应和执行结果及时通过Gadget Server将呈现结果；
内部运行：BPS执行BPEL流程时，BPS借助Governance Registry扩展对BPEL的解析支持；在监控流程运行情况方面，系统通过事件监听（Event Listener）和消息拦截（Message Exchange Interceptor）对运行情况进行监控，获取数据并显示在WEB端管理后台；
底层交互：BPS运行时必然需要数据服务（DS）支持和应用服务
（AS）支持，同时也需要其挂载的ESB提供代理服务等支持。

b)体系结构组成
上图展示了BPS内部体系结构和组成。

BPS是基于WSO2 Carbon平台，以编译运行BPEL文件为中心的一套BPM系统，包含UI层、发布模块、ODE整合部分和ODE BPEL运行时环境四个主要部分。

下面对各组成部分进行说明：
BPEL Manager UI：管理BPEL的前端界面；
BPEL Deployer：负责BPEL流程的部署和发布；
Management API：用于整合ODE的管理API；
BPEL Compiler：用于编译BPEL文件；
JACOB：Java-COM组件，可通过该组件在Java环境中调用COM组件和Win32类库；
ODE Data Access Objects：ODE数据连接对象。

B.基础服务
BPS中的主要基础服务包括：
用户角色及权限管理；
业务流程和实例的查询与监控；
系统配置；
其他基础服务；
其中，业务流程和实例的查询与监控是最重要的一项服务，也是BPS的核心服务。

C.管理与监控
B PS系统除提供以上基础服务外，还具备强大的系统管理配置和监控服务。

基于OSGi框
架的BPS，高度的模块化和模块间的低耦合度，使系统的管理配置十分方便；底层API广泛应用造就了实用的监控功能，配合对监控数据的图形化分析处理，将令管理员监控系统的工作变得十分轻松。

➢快速开始
A.概述
本章将介绍如何创建一个BPEL流程发布包，并发布在BPS系统中试用。

a)开始前准备
开始前请确认已安装以下软件：
JDK 1.5及以上版本；
WSO2 BPS 2.0.1及以上版本；
Eclipse 3.6.1（J2EE版）；
在Eclipse中添加BPEL 2.0插件：进入“Help->Install New Software”，在“Work with”中键入以下网址，安装BPEL 2.0插件到Eclipse中。

/technology/bpel/update-site
b)创建BPEL流程包
1.添加BPEL
2.0插件成功后，在Eclipse中新建BPEL Project，命名为Hello World：
2.在工程中新建BPEL Process文件：
3.双击“HelloWorld.bpel”，进入BPEL Designer，创建流程：
初始流程只有receiveInput、receiveOutput、EmptyBusinessLogic三个主要节点，为确保流程运转，须将EmptyBusinessLogic节点更改为Assign活动节点；
4.配置流程节点属性：
进入“Details”，点击“New”创建新的Assign Procedure，做变量映射，即将"input->payload->input" 映射到"output->payload->
result"，过程中会要求变量初始化，点“Yes”即可；
5.配置“.wsdl”文件：
流程创建时，系统会自动创建一个“.wsdl”文件，描述流程节点的输入和输出数据类型，以及数据流端口信息。

打开“.wsdl”文件，在右边出现的工作空间中（右键添加“Service”和“port”，分别命名为“HelloWorldProcessService”和“HelloWorldProcessPort”）->（右键添加“Binding”，命名为
“HelloWorldSoapBinding”）->并（“PortType”中选择“HelloWorld”）->（点击“Generate Binding Content”）->（“Protocal”中选择“SOAP”）->（“SOAP Binding”中选“Document Literal”）->（“HelloWorldProcessPort”的属性中选择“HelloWorldSOAPBinding”，地址设为：http://localhost:9763/services/HelloWorldService）；
6.配置“deploy.xml”：
发布BPEL流程包之前，还需要创建ODE Deployment Descrip- tor。

（用ODE Deployment Descriptor Editor打开“deploy.xml”，在“General”
标签下选择“activated”）->（在“Inbound Interfaces（Services）”标签下的
“Associated Port”中选“HelloWorldProcessPort”，相应的“Related Service”
也会改变）->（用XML Editor打开“deploy.xml”，找到“retired element”，右键“remove”）；
7.打包发布HelloWorld：
将“HelloWorld”工程的选定文件导出为“File System”，并打包成“.zip”
文件，准备部署到BPS系统中；
8.测试HelloWorld服务：
进入BPS的WEB端控制台，将HelloWorld.zip上传至服务器；进入“Service List”，找到“HelloWorld”服务->“Try this Service”即可测试刚刚创建好的“HelloWorld”流程。

B.基本功能快速入门
a)启动/关闭服务器
假设BPS安装文件解压在“C:\bps-2.0.1”路径下，在C:\bps-2.0.1\bin中打开“wso2server.bat”，即可启动BPS服务器；
在WEB端控制台的“Manage->Shutdown/Restart”中可以智能/强制关闭服务器，或智能/强制重启服务器。

b)流程信息查询和监控
在WEB端控制台的“Business Process->Processes”中，可以查看已发布的流程信息，包括流程ID、版本号、流程状态、发布时间等信息。

点击流程ID，进入查看流程的更多信息：流程基本信息、相关实例状态、服务配置、WSDL 详细信息和流程的图例，同时可以编辑流程定义。

c)系统信息查询和监控
在WEB端控制台的“Monitor->System Statistics”中，可以查看系统的相关信息：服务器运行时间、服务器基本信息、数据统计和相关配置等信息。

➢安装指南
A.系统配置要求
安装系统所需基本配置信息请参考《WSO2-BPS系统配置手册》。

B.产品安装
a)获取安装包
可前往以下链接下载最新版的WSO2 Business Process Server安装文件。

/products/bps/2.0.2/wso2bps-2.0.2.zip
b)Windows系统下的安装
1.安装前请确认系统环境已配置完成；
2.解压安装包，将系统文件释放到不含中文的路径位置，以下表示该路径为C:\bps-2.0.1；
3.运行C:\bps-2.0.1\bin目录下的“wso2server.bat”，启动BPS服务器；
4.若需要将BPS注册为Windows系统服务，请运行同目录下的“install.bat”;
5.打开浏览器，访问“https://localhost:9443/carbon”前往BPS的Web端控制台；
6.使用用户名“admin”和密码“admin”登录控制台，即可开始操作使用。

c)Linux系统下的安装
1.安装前请确认系统环境已配置完成；
2.解压安装包，将安装文件释放到任意位置，以下用“C:\bps-2.0.1”表示该路径；
3.在SHELL控制台中进入“C:\bps-2.0.1\bin”目录下，运行如下命令，“sudo sh
wso2server.sh”，开启服务器；
4.打开浏览器，访问“https://localhost:9443/carbon”前往BPS的Web端控制台；
5.使用用户名“admin”和密码“admin”登录控制台，即可开始操作使用。

C.安装后的工作
a)BPS安装目录结构
\bin —系统可执行文件；
\dbscripts —bps和Registry的数据库脚本；
\docs —系统帮助文档；
\lib —系统库文件；
\repository —BPEL库（bpel），系统组件（components），配置文件
（conf），数据库文件（database），已发布服务（deployment），系统日志（logs）；
\resources —待访问资源，相关安全文件；
\samples —样例；
\tmp —缓存文件；
b)卸载服务器
删除所有安装文件及目录即可卸载服务器。

另外，若安装时将BPS注册为WINDOWS系统服务，请在删除安装文件前先运行C:\bps-2.0.1\bin目录下的“uninstall.bat”卸载服务，然后再行删除。

➢管理指南
A.系统管理
a)用户角色管理
WSO2 BPS提供了完备的用户及角色管理系统，在BPS中管理员可根据需要添加、编辑删除系统用户信息，并赋予相应权限。

具体操作如下：
▪添加用户
▪配置角色（权限）
系统默认有“admin”和“everyone”两个角色，“everyone”角色的权限是可以配置的，其他新建的用户权限也可做类似配置。

此外，也可以为系统加入新的角色，并配置权限：
▪修改密码
▪导入用户信息
BPS的用户角色管理系统还支持从外部导入和导出用户信息，为用户信息的备份转移提供了便利。

b)系统功能配置
1.在“Configure->Features”中可对系统的功能进行配置：添加新功能、启用
或禁用已安装的功能模块。

•添加新功能
•配置已安装的功能
•查看安装历史
•管理资源库
2.在“Manage->Modules”中，可对系统模块进行配置。

•添加新模块
•查看模块列表
在模块列表中，可查看当前系统已部署的模块及其版本和功能描述，并可做相关配置。

c)KeyStore管理
KeyStore用于查看、保存和管理与对应CA证书匹配的Key。

▪添加Key
▪管理Key
B.系统日志
a)系统日志及Log4j配置
在“Monitor->System Logs”中，可查看系统运行日志，也可对相关信息进行搜索。

b)SOAP消息跟踪设置
BPS系统提供对SOAP消息的跟踪和消息过滤、搜索功能，具体可在“Monitor->SOAP Tracer”中进行设置。