OFBIZ2.0精简版本安装手册

OFBIZ2.0精简版本应用概论 —— 安装配置篇

OFBIZ2研究 ——中科学院软件所 互联网软件技术实验室 软件工程组

雷辉 （leihui@intec.iscas.ac.cn）  [2003-4-28]

1                  运行环境的安装配置

OFBIZ是WWW.SOURFORGE.ORG上最著名的开源项目之一，我们目前研究的是OFBIZ2.0，要了解OFBIZ的详细信息，请参见：http://sourceforge.net/projects/ofbiz/。

1.1        TOMCAT4.1.18 + MYSQL4.0 + ANT1.5.2 + OFBIZ2.0 + J2SE1.4.1

OFBIZ既可以运行在一个单独的Servlet引擎（如Tomcat4.0）上，也可以运行在一个完整的J2EE容器中（如weblogic，JBoss & Tomcat）。

某种程度上，需要一个完整的J2EEJ2EE应用服务器，因为需要提供JNDI，EJB，JMS，JTA，Conntection Pooling，以及其它服务、资源运行的容器。如果没有这些，OFBIZ的功能就会受到某种限制。

OFBIZ目前兼容绝大多数的J2EE应用服务器，而且立志做到更好的兼容。

Tocamt4.1.18是OFBIZ2.0版本的缺省web服务器，但是如果要用到EJB、JTA等部分就需要配置一个APP服务器，如JBOSS或Weblogic或其它J2EE应用服务器。

下面的组合是：

TOMCAT4.1.18 + MYSQL4.0 + ANT1.5.2 + OFBIZ2.0 + J2SE1.4.1

本简化版本已经按上述环境配置好了，可以直接使用。

1.1.1 JVM

OFBIZ2.0的运行和维护需要J2SE1.3.1或J2SE1.4.1以上版本的支持。目前我们选择J2SE1.4.1。

下载地址：http://java.sun.com/j2se/1.4.1/download.html。

J2SE1.4.1的介绍网址：http://java.sun.com/j2se/1.4.1/index.html 。

安装路径：d:/bin/gpl/J2SE1.4.1。

1.1.2 web Server

Tomcat4.1.18，目前ofbiz在Tomcat4.1.18上完整测试过。

下载地址：http://jakarta.apache.org/tomcat/index.html 。

安装路径：d:/bin/gpl/ofbiz2.0/tomcat4.1.18

1.1.3 ANT

ANT是一个强大的针对Java程序的编译、打包、部署、配置工具。

目前最新版本是1.5.2，下载网址：http://ant.apache.org/bindownload.cgi 。

安装路径：d:/bin/gpl/ant1.5.2。

1.1.4 MYSQL4.0

MYSQL4.0是一个更快、更强、初句事务管理功能的Mysqls数据库的最新版本，详细情况见www.mysql.com）。下载后直接安装即可，

下载网址：http://www.mysql.com/downloads/mysql-4.0.html

安装路径：d:/bin/gpl/mysql4.0.

1.1.5 OFBIZ2.0

下载OFBIZ2.0精简版本，网址:http://www.cnsqabsw.net.cn：教育培训：课件下载。直接把ofbiz-limit.zip解压即可。

或者：http://www.cnsqa.com/down.html ——>“OFBIZ精简版本源程序.rar”

安装路径：d:/bin/gpl/ofbiz2.0/ofbiz。注意一定要和tomcat4.1.18在一个目录下。

 

1.1.6 环境变量配置

1、  JAVA_HOME=d:/bin/gpl/J2SE1.4.1。

2、  CATALINA_HOME= d:/bin/gpl/ofbiz2.0/tomcat4.1.18

3、  OFBIZ_HOME=d:/bin/gpl/ofbiz2.0/ofbiz

4、  ANT_HOME=d:/bin/gpl/ant1.5.2

5、  CLASSPATH=%JAVA_HOME%/lib/tools.jar

6、  PATH=%JAVA_HOME%/bin; %ANT_HOME%/bin。

上述环境变量如果原来就有，则无须重复定义，直接使用即可。

1.2        系统运行

1.2.1 编译、打包、部署

从控制台进入OFBIZ2.0的安装目录D:/bin/gpl/OFBIZ2.0/ofbiz，执行如下命令：

1、  ant clean 。清空所有系统编译产生的临时文件。

2、  ant install 。部署运行环境。

3、  ant [回车]。即可把OFBIZ部署到Tomcat4.1.18下。

4、  ant deploy：与单独键入“ant”效果一样，即对整个应用系统进行编译、联接、打包和部署。

 

1.2.2 启动OFBIZ

在部署的过程中，OFBIZ的启动文件已经自动部署到%CATALINA_HOME%/bin目录下，可以运行该目录下的ofbiz.bat（Linux下为ofbiz.sh）来启动、关闭OFBIZ，具体命令如下：

运行ofbiz：ofbiz run。前台运行

运行ofbiz：ofbiz start。后台运行

停止ofbiz：ofbiz stop。和手工“Ctrl-C” 效果差不多，只是粗暴了些。

 启动起来后，如果没有什么错误，就意味着系统已经自动创建了基于MYSQL的ofbiz数据库，并且可以正常工作了。

1.2.3 初始化

1、    首先需要运行http://localhost:8080/webtools/control/main或

1、http://localhost:8080/webtools/control/install来装载缺省数据，只有缺省数据载入系统了，系统才可正常运行。

2、    数据装载完后，缺省的系统管理员帐号是：admin,ofbiz（位于基础数据表SecurityData.xml中）。

3、    系统的安装配置、维护管理都利用强大的webtools工具来实现，应用地址：http://localhost:8080/webtools/control 。

4、    The default group name for all of the default entities in OFBiz is "org.ofbiz.commonapp", 在初始装载数据时，用org.ofbiz.commonapp装载它就可以了。

1.2.4 系统主要功能

1、  系统目录结构说明

遵循上述系统架构，OFBIZ2.0的应用系统目录结构如下图（图1-4）示：

Commonapp：OFBIZ提供的一个基于OFBIZ内核的应用，是一个比其它应用更低一层的应用，它提供了维护其它应用正常运行的方式，所有其它应用（包括你以后开发的自己的应用）都是在它的基础上进行构建、发布和维护，而且关于OFBIZ系统中web框架、实体引擎、服务引擎的配置文件，也都存在于目录中。

Content：OFBIZ提供的一个基于OFBIZ内核的应用，主要用来提供“内容”的管理和维护，所谓“内容”就是你通过动态的方式发布在该应用系统中的所有数据。在OFBIZ的设计框架中位于第3层。

Core：OFBIZ的内核程序目录，提供了支持Web框架、实体引擎、服务引擎等功能的核心代码，在OFBIZ的设计框架中位于第2层。

Lib：OFBIZ用到的一些JAR文件，用来支持系统的编译、部署和运行。

Partymgr：OFBIZ提供的一个基于OFBIZ内核的应用，已经成型，提供给应用系统用来管理其系统帐号（用户）。在OFBIZ的设计框架中位于第3层。

Setup：OFBIZ提供在各种环境组合的情况下进行编译、打包、部署应用的配置文件或需要的资源文件。

Webtools：OFBIZ提供的一个基于OFBIZ内核的核心应用，用来辅助core和commonapp完成对内核系统和应用系统的维护和管理，如系统缓存管理，和实体、服务引擎有关的实体和服务的定义和维护，基础数据的加载、导出、导入等。

1.2.5 访问

如系统安装成功，访问其示例应用：http://localhost:8080/**，“**”为示例应用名称，如访问commonapp，则键入：http://localhost:8080/commonapp。

如访问partyMgr，则键入：http://localhost:8080/partymgr。

1.3        总结

以上只是在TOMCAT下整合了OFBIZ2.0，如果要把OFBIZ置于J2EE应用服务器之下，则还需要整合JBOSS3.0.6。因为OFBIZ目前只是使用了主要的J2EE组件和服务，包括Servlet 2.3，JSP1.2和利用JDBC XA Wrapper and Connection Pool 实现了的JTA。服务于前两个组件的容器有Tomcat4X就可以了，支持JTA服务需要安装一个应用服务器（如JBOSS），目前暂时不用，先用JDBC API 直连的方式访问数据库。

OFBIZ2.0只需要一个Tomcat就能满足大部分的应用需求，且工作的很好（主要指性能上），如果应用的规模大到一定程度上时，需要提供支持EJB，JMS， JNDI，JTA等服务的机制时，可以考虑使用应用服务器JBOSS或Weblogic，即建立：Tomcat4.1.18 + Mysql4.0 + OFBIZ2.0+其它工具组件的Free组合或Weblogic7X + Oracle9i + OFBIZ2.0+其它工具组件的非Free组合。

本文旨在抛砖引玉，能让更多的Web应用开发者从中收益，是开源的本意，也是我们的责任和研究理念。

 

中国科学院软件所互联网软件技术实验室成立于1998 年，是软件所的直属研究开发部门，具有一支以系统支撑软件技术、数字化技术、软件工程和软件质量保证技术、Internet 技术为主要研究领域的科研开发队伍。笔者所在的开发团队从2001 年就开始跟踪和使用J2EE/XML技术，并在OFBIZ1.0 的基础上实现了北京软件产业基地公共技术支撑体系——综合服务管理平台（www.bsw.net.cn）。从今年2 月份开始成立研究小组，跟踪和研究基于基于OFBIZ2.0.0 的通用Web 应用系统开发框架。

该简化的版本已经经过测试，如果感兴趣的话，可以和本人或研究小组联系，以索取简化版本的源码。

联系方式：leihui@intec.iscas.ac.cn。雷辉