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

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 �CConfigure 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 �CConfigure 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 �CConfigure 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）登录后如下图