bps流程开发配置文档.docx

bps流程开发安装配置文档1 开发工具安装1.1 基于MyEclipse 5.5的安装本步骤以说明以MyEclipse为基础进行BPS开发环境安装为基础，说明在MyEclipse上如何配置BPS环境。1.1.1 总体步骤说明基于MyEclipse的安装分为以下几步进行：1. MyEclipse 5.5 安装，2. BPS插件安装1.1.2 MyEclipse 5.5安装参见MyEclipse 5.5安装说明，没有特别说明。1.1.3 BPS插件安装MyEclipse 5.5 平台选择BPS_6.1_Studio_Plugin_V3.2.zip，安装BPS插件有以下两种方法：1. 方法1：直接将Plugin.zip解压缩到eclipse.exe所在目录（即MyEclipse 5.5的安装目录）。2. 方法2：将bpstools、bpsbiztools、emf、gef、WTP-1.5.1解压缩到任意位置，在Eclipse安装目录下的links文件夹当中建立如下3个link文件：a) bpstools.link文件内容为：path=bpstool文件夹的绝对路径或者相对于MyEclipse 5.5安装目录的路径b) bpsbiztools.link安装bpsbiztools之后，可以针对业务资源进行开发;文件内容为：path=bpsbiztools文件夹的绝对路径或者相对于MyEclipse 5.5安装目录的路径c) emf.link文件内容为：path=emf文件夹的绝对路径或者相对于MyEclipse 5.5安装目录的路径d) gef.link文件内容为：path=gef文件夹的绝对路径或者相对于MyEclipse 5.5安装目录的路径e) wtp.link文件内容是：path=wtp文件夹的绝对路径或者相对于MyEclipse 5.5安装目录的路径;该组件为选件，安装后可以方便的开发Web项目1.2 基于BPS的安装1.2.1 总体说明本步骤说明在以BPS为基础进行开发环境安装的步骤，即在先安装BPS的基础上引入MyEclipse开发环境以适合更多的开发场景。BPS6.1 Studio（BPS流程设计建模工具）是基于Eclipse插件体系结构实现的可视化流程设计器，提供可视化的业务流程定义、可视化表单开发与调试、以及业务流程部署等功能。BPS6.1 Studio可以与基于Eclipse的Java集成开发环境融合，教程中案例的软件环境如表1-1所示。表1-1 软件环境软件清单备注Microsoft Windows XP Professional中文版操作系统Oracle9i Release 9.2.0.1.0 - Production数据库Primeton BPS 6.1开发版（Development Edition）BPS开发运行环境MyEclipse_5.5.1GA_E3.2.2_Installer.exeMyEcliipse插件版Struts1.1开源框架Hibernate3.1开源框架1.2.2 安装BPS1. 启动安装程序将安装光盘插入CD-ROM中，在autorun界面中选择安装Primeton BPS 6.1开发版。若不是通过autorun形式启动安装程序，请直接执行安装程序文件install.exe。2. 阅读安装简介，如图1-2所示，单击【下一步】按钮。图1-2 简介3. 阅读开发版的许可声明后，选择“本人接受许可协议条款”单选按钮，如图1-3所示，单击【下一步】按钮。图1-3 许可协议4. 单击【浏览】按钮，从弹出的对话框中选择安装目录，如图1-4所示。设置完毕，单击【下一步】按钮。安装路径最多可输入64个字符，只能由半角英文字符、数字或下划线“_”组成，且不允许带空格。如果所选的安装目录已经安装过BPS6.1产品，则安装程序将提示用户选择其他目录。图1-4 选择安装路径5. 设置管理员信息，根据实际情况输入用户名称和机构名称，安装程序默认用户名称为当前登录操作系统的用户名,如图1-5所示,单击【下一步】按钮。图1-5 设置管理员信息6. 选择IP，在下拉列表框中选择本机IP，如图1-6所示，单击【下一步】按钮。图1-6 选择IP7. 选择应用服务器，在下拉列表框中选择应用服务器，BPS开发版缺省提供Tomcat-5.5.20服务器，如图1-7所示，单击【下一步】按钮。图1-7 选择应用服务器8. 创建应用，应用名默认为“default”，如图1-8所示，单击【下一步】按钮。图1-8 创建应用9. 选择安装组件，如图1-9所示，单击【下一步】按钮。图1-9 选择安装组件10. 配置数据库。(1) 在下拉列表框中选择数据库类型，如“Oracle 9i/10g”。(2) 输入数据库的相关配置信息。配置Oracle9类型数据库的界面，如图1-10所示。图1-10 配置Oracle 9类型数据库(3) 选择是否“初始化数据库”如果初次安装BPS且是初次使用某个数据库用户，建议选择初始化数据库，将BPS所需表结构建立起来。对于已执行过初始化的数据库，再次初始化将覆盖已经存在的BPS系统表。(4) 单击【数据库连接测试】按钮，测试所配置数据库是否可以成功连接。(5) 单击【下一步】按钮。11. 阅读预安装摘要，如图1-11所示，单击【安装】按钮。图1-11 预安装摘要12. 开始安装，安装过程中显示各组件的安装进程，如图1-12所示。图1-12 正在安装13. 程序提示开发版已经成功安装，如图1-13所示。 选择“现在查看readme.txt文件。”复选框，可以查看readme文件内容。图1-13 安装完成14. 单击【完成】按钮，完成BPS开发版的安装。15. 验证安装(1) 创建如下快捷菜单,如图1-14所示。图1-14 快捷菜单用户第一次安装Primeton BPS 6.1产品后，开始/程序中会添加“Primeton BPS 6.1”菜单。同一个登录用户若多次安装BPS产品，开始/所有程序中会依次添加“Primeton BPS 6.1(BPS Home2)”菜单，以示区别。(2) 检查安装日志。打开BPS安装目录下的bpsinstall.log安装日志文件，检查安装过程是否有异常信息。(3) 通过“开始à程序àPrimeton BPS 6.1à启动BPS Server”启动BPS Server，查看控制台是否有异常。http侦听默认占用8080端口，此端口容易冲突，冲突导致服务无法启动成功。修改Tomcat中的端口：打开安装目录apache_tomcat-5.5.20conf目录下的server.xml，修改其中的8080端口。1.1.2 MyEclipse安装1. 下载安装程序获取MyEclipse_5.5.1GA_E3.2.2_Installer.exe。2. 启动安装程序采用默认方式完成安装注意安装过程中Choose Eclipse Folder选择刚刚安装的BPS中的eclipse目录，本示例中为C:primetonBPSideeclipse，如图1-15所示。图1-15 Choose Eclispe Folder3. 验证安装。通过“开始à程序àPrimeton BPS 6.1àBPS Studio 6.1”启动BPS Studio，BPS Studio中已成功集成Myeclipse插件，如图1-16所示。图1-16 MyEclispe插件4. 配置服务器。启动BPS Studio，在菜单“窗口à首选项àMyEclipseàApplication ServersàTomcatàTomcat 5.x”，选择BPS开发版本自带的tomcat-5.5.20，如图1-17所示。图1-17 配置服务器到这里开发环境配置已经完成，接下来您可以继续第2章的案例开发。2 环境配置2.1 插件安装2.1.1 说明插件的基本内容包括：SVN、hibernate以及Tomcat插件：1、SVN是公司统一使用的版本控制工具，安装好开发环境后必须配置SVN插件。当然也可是单独安装SVN客户端，并通过客户端下载和上传数据。2、hibernate是在使用SSH框架时必要的生成工具，能大大提高开发效率3、Tomcat：方便服务测试环境的启动配置等2.1.2 插件安装目录有两种不同形式的安装方法，在插件放置时就有两个不同的位置：svn、hibernate和tomcat插件放置位置：1、 基于MyEclipse：安装目录<install_path>MyEclipse 5.5.1 GAeclipsemyplugin文件夹2、 基于BPS安装：<install_path>BPSideeclipsepluginsLinks文件放置位置1、 基于MyEclipse：安装目录<install_path>MyEclipse 5.5.1 GAeclipselinks文件夹2、 基于BPS安装：<install_path>BPSideeclipselinksLinks文件内容：path=<%path%>eclipse/myplugin/tomcatpath=<%path%>eclipse/myplugin/svnpath=<%path%>eclipse/myplugin/hibernate在D:Program FilesMyEclipse 5.5.1 GAeclipselinks文件夹下放入 三个文件，记得修改文件内容是自己本机插件的路径。2.2 插件配置2.2.1 Tomcat1. 版本要求：tomcat安装目录路径,tomcat版本要5.5.20版本2. 插件检测：配置好tomcat插件后，工具栏、菜单中都可以看到相应的内容3. 为了保证TOMCAT的稳定运行以及方便启动与配置服务，需要对TOMCAT配置相关参数。具体步骤如下：a) 选择preferences菜单b) 选择tomcat安装路径c) 、配置jvm参数，尽量避免内存溢出-Xms512m Xmx1024m -XX:PermSize=64M -XX:MaxNewSize=128m -XX:MaxPermSize=128m这里数字代表内存大小以M为单位；各参数意义如下：-Xms：最小内存大小，即初始内存大小-Xmx：最大内存大小，表示服务器JVM可用内存上限-XX:MaxNewSize：当前内存到达上限时，一次新分配的内存大小-XX:PermSize：初始保留内存大小-XX:MaxPermSize：最大保留内存说明：保留内存是在固定存在的内存空间，存放不经常被交换的类d) 配置tomcat时区，如果发现系统时间差异为8小时，则需要配置一下tomcat时区；在相应位置录入参数：-Duser.timezone=GMT+08e) 、选中要发布的项目，以保证在服务器启动时可以加载相应的应用程序2.2.2 配置SVN2.2.2.1 SVN证书配置SVN的配置有2中方式。第一种：1、打开Myeclipse，在工具栏中选择help-> software updates ->find and install，进入之后如图所示：2、选择 search for new features to install，点击next进入下一步：3、点击“new remote site”按钮，在弹出的对话框中输入name：svn，url：http:/subclipse.tigris.org/update_1.4.x点击ok，关闭对话框，并点击finish按钮，myeclipse自动下载插件安装程序，如下图所示：4、下载完插件之后，进入安装画面，如图：选择所要安装的svn插件内容，这里不勾选第二个选项subclipse integrations，点击下一步：选择 “I accept the terms in the license agreements”并点击next，进入下一步：5、直接点击finish即可，进入下一步：开始安装svn插件，进度条如上图所示，安装完成之后，重启myeclipse，这个时候myeclipse的视图中，就出现了“svn repository exploring”视图：6、选择这个视图进入，在左边空白区域，单击右键->new->repository location，进入如下画面：在对话框中输入https:/218.57.135.34/develop/iEOMS， 点击finish按钮，出现如下界面。7、输入用户名和密码（各个小组的用户名密码会通过邮件发给各个组长），点击ok即可看到svn下的目录结构了，如下图所示：右键点击上图中蓝色选择区域，再选择“checkout”，出现如下对话框：选择check out as a project in the workspace 即可创建yotta(改名字为工程名)工程，创建完之后，回到myeclipse视图：即可看到从svn中检出的yotta工程了。第二种方式：1、 将SVN的插件放置在任意一个磁盘都行。例如SVN插件放在C:primetonBPSideeclipsepluginssvn。2、 然后在primetonBPSideeclipselinks目录下新建一个svn.link文件，文件的内容为：path=C:/primeton/BPS/ide/eclipse/plugins/svn注意：这里的path值为svn插件安装的路径以及路径分隔符必须是反斜杠。 3、验证SVN安装成功与否的方法同上。2.2.2.2 ECLIPSE配置2.2.3 Hibernate配置这个大家用的比较多了，不再赘述。3 、BPS服务器配置3.1 服务器地址配置3.2 应用程序相关配置为了能够使得应用程序中的API操作和相关服务器一致，需要在应用程序包的src放一个uddi-address.xml文件；文件内容如下 ，其中红色部分需要和上图中相应的值保持一致。<?xml version="1.0" encoding="UTF-8" standalone="no"?><uddi_address_list> <uddi_address id="default"> <name>localserver</name> <logicName>default</logicName> <type>remote</type> <uddiHost>127.0.0.1</uddiHost> <uddiPort>8080</uddiPort> <uddiAdminPort>6199</uddiAdminPort> <uddiWebContext>default</uddiWebContext> <uddiUserID>bps</uddiUserID> <uddiPassword>000000</uddiPassword> <description> </description> </uddi_address></uddi_address_list>3.3 BPS数据库配置为了使得流程引擎能够正常运转，需要配置BPS的相应的数据库以及应用的用户名密码等。在BPS中引擎对应的数据库配置放在一个XML文件中，具体存在位置如下：<%install_path%>apache-tomcat-5.5.20webappsdefaultWEB-INFprimetonserverworkingdefaultconfig下的user-config.xml文件在文件中有关数据库的描述：<configValue key="C3p0-DriverClass">oracle.jdbc.driver.OracleDriver</configValue> <configValue key="C3p0-Url">jdbc:oracle:thin:10.18.1.5:1521:MYDB</configValue> <configValue key="C3p0-UserName">bps</configValue> <configValue key="C3p0-Password">bps</configValue> C3p0-DriverClass：数据库对应的驱动程序地址C3p0-Url：数据库地址连接串C3p0-UserName：数据用户名C3p0-UserName：数据库密码3.4 配置相关JAR包为了保证程序的正常运行，还需要配置一些JAR包；主要以下向个包需要COPY；一种是BPS相关的JAR包：wlclient.jar、weblogic_bps.jar；这两个包需要copy到<%tomcat_install_path%> commonlib下另一个是和权限有关的jar 包：AuthorityForClient.jar，在登录BPS以及在BPS控制台管理流程时需要用到，需要放置在default应用的lib下：<%tomcat_install_path%>webappsdefaultWEB-INFlib注意：由于每个现场使用的权限系统版本不同，此文件也需要和各现场使用的权限系统版本保持一致3.5 集中权限管理相关配置3.5.1 权限相关配置文件和权限相关的配置文件为AuthorityConfig.xml；在每个应用到权限的程序中都需要此文件，具体放在classes目录下（com）一级；在BPS开发环境中需要在自身应用中放置，也要在引擎的主应用default中放置：具体路径如下：<%tomcat_install_path%>webappsdefaultWEB-INFclasses注意：在不同的现场或环境下，由于权限服务地址的不同，需要修改相应配置。如下所示：3.5.2 BPS接口实现类配置1、文件COPY在应用程序包中将mon.organize包中的所有类放置到default目录下，包路径需要与原来保持一致。2、workspace空间配置相关包路径：组织机构接口实现类：mon.organize.service.WFOMModelImpl权限接口实现类：mon.organize.service.WFOMPermissionImpl3.5.3 工作项验证权限设置为了方便任务处理，使得看到任务的人都可以处理任务，可以通过配置文件进行设置<%tomcate_root%>defaultWEB-INFprimetonserverworkingdefaultworksystemcom.primeton.workflow.coreMETA-INFcontribution.eosinf contribution.eosinf<group name="permission"> <!- 查询流程定义是否校验权限 true 校验 false 不校验 -> <configValue key="is_qry_defs_check_right">true</configValue> <!- 是否校验工作项执行权限 true 校验 false 不校验 -> <configValue key="check_all_workitem_right">false</configValue> </group>4 访问bps workspace和default1、 default为bps客户端，可以用用户名tiger和密码000000登陆。里面是流程信息以及任务的完成情况。访问地址http:/localhost:8080/default2、 bps workspac对流程的监控、业务流程定制以及引擎配置管理。访问地址http:/localhost:8080/workspace/5 环境变更本部分描述当环境变更时，如不同的现场或不同的服务器环境发生了变化，开发环境需要修改的地方。5.1 数据库变更inspur.properies<%tomcatroot%>webappsdefaultWEB-INFprimetonserverworkingdefaultconfigUser-config.xml5.2 权限中间件变更AuthorityConfig.xml当中间件版本不一致时，需要替换AuthorityForClient.jar文件注意：这两个文件在应用程序和BPS default下各有一个