核心产品开源项目配置说明

1  背景概述

数通畅联本着分享传递的理念已经将产品家族中的核心产品开源，目的在于满足客户与伙伴的OEM需求，以及为广大IT爱好者的集成工具提供多一种选择，多一种便利。如果需要对产品进行扩展开发或者更深层次的了解产品可以在svn中check out源码。

本文详细介绍BPM、Portal、SMC工程在AEAI DP中配置步骤以及方法，来支持扩展开发，以-d模式启动来支持远程debug调试，debug模式方法可以参考AEAI DP开发平台技术手册（http://pan.baidu.com/s/1gdKlQvD）。另外，由于BPMServer、PortalServer、ESBServer的内部运行机制不建议使用MyEclipse或者Eclipse JavaEE来进行扩展开发。

2  预期读者

• 数通畅联内部员工

• 外部扩展开发人员

3  名词解释

• 用户库：可以导入的jar包，为了满足编译时的需要。

• SVN：SVN是Subversion的简称，是一个开放源代码的版本控制系统。

4  实现思路

创建SVN路径，将工程从SVN上check out下来，配置用户库引用相应的jar包，解决编译出错的问题。设置对应的服务器配置，修改对应的服务器中的配置文件指向开发目录，正确启动服务器，保证程序的正确运行。

5  实现步骤

5.1  AEAI BPM工程

AEAI BPM是以业务流程为中心、帮助企业各业务环节与客户需求对齐的管理方法，用户可以在http://pan.baidu.com/s/1i4zLpcD#path=%252FAEAI%2520BPM下载相关介质以及文档，源码托管于开源中国http://git.oschina.net/agileai/aeaibpm，可以从SVN上check out源码进行二次开发，路径为svn://git.oschina.net/agileai/aeaibpm。

5.1.1    SVN Check Out程序

1.打开设计器点击跳转到界面点击按钮

2.  弹出界面在URL中输入对应的SVN路径，点击Finish，成功后点击SVN路径如下图：

3.  在项目名上右键选择“检出为”

4.  弹出界面点击NEXT可以查看项目地址，之后点击Finish

5. 点击按钮切换到JAVA透视图，检出的工程会出现编译出错的问题如下图：

6.  查看报错信息，问题定位为缺少jar包，下面开始配置用户库引入相应的jar包。

5.1.2    配置用户库

用户库在工程Check Out时已经创建，但是可能会缺少对应的Jar这里只需要对用户库进行配置引入相应的Jar即可。

1.  在工程下右键选择Build Path –Configure Build Path

2. 选择Add Library

3.  选择 User Library点击Next之后点击Finish

4.  选择新创建的用户库点击右侧的Add JARs

5. 另需配置用户库BPM Server 引入（您服务器的地址）\ bpm_server_x86_ Vx.x.x.YYYYMMDD \shared下的jar以及

（您服务器的地址）\ bpm_server_x86_ Vx.x.x.YYYYMMDD \lib下的jsp-api.jar以及servlet-api.jar

6.  用户库创建成功后，刷新应用

7.  修改数据库配置文件

5.1.3    BPM Server设置

1.  解压BPM Server安装介质bpm_server_x86_Vx.x.x.YYYYMMDD.rar；

编辑bpm_server_x86_Vx.x.x.YYYYMMDD\bin目录下，startconfigtoolNaNd文件，设置JDK路径，如图所示：

2.  打开数据库配置，设置连接URL改为数据库名，填写数据库的用户、密码后点击“测试连接”，连接成功后，初始化数据高亮显示，若创建的BPM数据库中没有内容，则点击初始化数据，将自动生成数据表。若数据库已经存在且有内容，不可点击初始化数据，否则将覆盖已有的数据库内容。如图：

3. 双击bin目录下的startup.bat，即可直接启动BPMServer，如图所示：

5.1.4    修改服务器配置文件

1. （您服务器的地址）\bpm_server_x86_ Vx.x.x.YYYYMMDD \conf\Catalina\localhost

2.添加bpm.xml文件如下：docBase属性指向开发目录

3.删除（您服务器的地址）\bpm_server_x86_ Vx.x.x.YYYYMMDD \webapps下预置的bpm工程；

4. 双击bin目录下的startup.bat，即可直接启动BPMServer，如图所示：

5.  浏览器输入http://localhost:7070/访问界面如下：

6. 输入账号admin（密码admin）登陆后界面：

5.2   AEAI Portal工程

Portal是门户集成平台, 可以作为企业的应用中心，或者是企业应用的入口，在统一的界面上聚合现有各业务系统的数据、菜单、界面。 用户可以在http://pan.baidu.com/s/1mgj3SV2下载相关介质以及文档，源码托管于开源中国http://git.oschina.net/agileai/aeaiportal，可以从SVN上check out源码进行二次开发，路径为svn://git.oschina.net/agileai/aeaiportal。

5.2.1    SVN Check Out程序

1.  打开设计器点击跳转到界面点击按钮，弹出界面在URL中输入对应的SVN路径，点击Finish

2. 成功后，点击SVN路径如下图：

3.  在项目名上右键，选择“检出为”

4. 弹出界面点击NEXT可以查看项目地址，点击Finish

5.  点击按钮切换到JAVA透视图，检测出的工程会出现变异出错的问题如下图：

6. 查看报错信息，定位为缺少jar包，下面开始配置用户库引入相应的jar包

5.2.2    配置用户库

用户库在工程Check Out时已经创建，但是可能会缺少对应的Jar这里只需要对用户库进行配置引入相应的Jar即可。

1.  在工程下右键选择Build Path –Configure Build Path

2.  指定设计器的Jre

3. 另需配置用户库Portal Server 引入（您服务器的地址）\portal_server_x86_ Vx.x.x.YYYYMMDD \shared下的jar以及（您服务器的地址）\portal_server_x86_ Vx.x.x.YYYYMMDD \lib下的jsp-api.jar以及servlet-api.jar

4. 用户库创建成功后刷新应用

5.  修改数据库配置信息及开发目录下配置信息

5.2.3    Portal Server设置

1. 解压PortalServer安装介质portal _server_ x86_Vx.x.x.YYYYMMDD.rar；

编辑portal_server _x86_Vx.x.x.YYYYMMDD\bin目录下，startconfigtoolNaNd文件，设置JDK路径，如图所示：

2. 打开数据库配置，设置连接URL改为数据库名，填写数据库的用户、密码后点击测试连接，连接成功后，初始化数据高亮显示，若创建的portal数据库中没有内容，则点击初始化数据，将自动生成数据表。若数据库已经存在且有内容，不可点击初始化数据，否则将覆盖已有的数据库内容。如图：

5.2.4    修改服务器配置文件

1. （您服务器的地址）\portal_server_x86_ Vx.x.x.YYYYMMDD \conf\Catalina\localhost

2.打开对应的xml文件添加属性docBase指向开发工程的webRoot目录

3.删除（您服务器的地址）\portal_server_x86_ Vx.x.x.YYYYMMDD \webapps下预置的portal与portal_portlets工程结果如下

4.  双击bin目录下的startup.bat，即可直接启动PortalServer，如图所示：

5.  浏览器输入http://localhost:8080/portal/login.jsp访问界面如下：

6.  输入账号admin（密码admin）登陆后界面：

5.3   AEAI ESB SMC工程

AEAI ESB是集成各业务系统，实现异构系统的互联互通。 用户可以在http://pan.baidu.com/s/1o6NvxXo下载相关介质以及文档，源码托管于开源中国http://git.oschina.net/agileai/aeaiesb，可以从SVN上check out源码进行二次开发，路径为svn://git.oschina.net/agileai/aeaiesb。

5.3.1    SVN Check Out程序

1.  打开设计器点击跳转到界面点击按钮

2.  弹出界面在URL中输入对应的SVN路径，点击Finish

3. 成功后点击SVN路径，如下图：

4. 在项目名上右键后选择“检出为”

5. 弹出界面点击NEXT可以查看项目地址，点击Finish

6. 点击按钮切换到JAVA透视图，检测出的工程会出现变异出错的问题。查看报错信息，问题定位为缺少jar包，下面开始配置用户库引入相应的jar包。

5.3.2    配置用户库

用户库在工程Check Out时已经创建，但是可能会缺少对应的Jar这里只需要对用户库进行配置引入相应的Jar即可。

1.  在工程下右键选择Build Path –Configure Build Path

2. 指定设计器的jre

3. 创建的用户库soaker

4. 重复步骤1和2点击 User Library 后点击Next

5. 点击弹出界面点击自定义名称后点击OK

6. 选择创建的库，点击右侧的Add JARs添加jar包

7.  引入ESB服务器下的

**（您的ESBServer的目录）\esb_server_x86_ Vx.x.x.YYYYMMDD \shared

**（您的ESBServer的目录）\esb_server_x86_ Vx.x.x.YYYYMMDD \lib下的jsp-api.jar以及servlet-api.jar目录中的jar包，点击OK，选择添加的用户库，点击Finish。

8.  用户库创建成功后，刷新应用解决编译出错的问题如下图：

9.  修改数据库的配置文件及开发目录下配置信息

5.3.3    ESB Server设置

1. 解压ESBServer安装介质esb_server_x86_Vx.x.x.YYYYMMDD.rar；

编辑esb_server_x86_Vx.x.x.YYYYMMDD\bin目录下，startconfigtoolNaNd文件，设置JDK路径，如图所示：

2. 打开数据库配置，设置连接URL改为数据库名，填写数据库的用户、密码后点击测试连接连接成功后，初始化数据高亮显示，若创建的esb数据库中没有内容，则点击初始化数据，将自动生成数据表。若数据库已经存在且有内容，不可点击初始化数据，否则将覆盖已有的数据库内容。如图：

5.3.4    修改服务器配置文件

1.**（您的ESBServer的目录）\esb_server_x86_Vx.x.x.YYYYMMDD \conf\Catalina\localhost

2.添加docBase属性指向开发工程的webRoot目录

3.删除**（您的ESBServer的目录）\esb_server_x86_ Vx.x.x.YYYYMMDD\webapps下预置的SMC工程

4.浏览器输入http://localhost:9090/SMC/访问界面如下

5.admin（密码admin）登录后如下图