ofbiz安装指南 (hsql/mysql/oracle+tomcat/apache)

1、ofbiz 用自身数据库安装

1. 由 binary 安装:

由 binary 安装很是简单, 如下是安装方法:

下载ofbiz-2.0-beta1-complete.tar.gz, 注意不是ofbiz-2.0-beta1.tar.gz.
tar xvzf ofbiz-2.0.beta1-complete.tar.gz
cd tomcat/bin
./ofbiz.sh start
galeon http://localhost:8080/webtools

2. 由 CVS 安装:

由 CVS 安装要稍微复杂一些. 因为 ofbiz 的更新很是快, 因此由 CVS 安装将得到最新功能. 如下是安装方法:

mkdir ofbiz
ln -s /PATH-TO-TOMCAT tomcat
cd ofbiz
export CVSROOT=:pserver:anonymous at cvs dot ofbiz.sourceforge.net:/cvsroot/ofbiz
cvs login
cvs co catalog
cvs co commonapp
cvs co core
cvs co ecommerce
cvs co lib
cvs co ordermgr
cvs co partymgr
cvs co setup
cvs co website
cvs co webtools
cvs co workeffort
cp setup/ofbiz/build.xml .
cp setup/ofboz/updateall.sh .
export CATALINA_HOME=PATH-TO-TOMCAT
export OFBIZ_HOME=`pwd`
ant
ant install
建立 postgreSQL 用户 ofbiz, 口令 ofbiz
createdb -E EUC_CN ofbiz
cd ../tomcat/bin
./ofbiz.sh start
galeon http://localhost:8080/webtools

2、安装ofbiz+tomcat+oracle

这个文章描述的是安装ofbiz在oracle+tomcat环境
ofbiz2.11提供的缺省的web server是jetty,因为我比较习惯tomcat，所以打算把他转移到tomcat上来。
ofbiz2.11提供的却省的数据库是hsql的，用webtools，转移他的数据库是很是方便的，这里我介绍如何按装到oracle中，
一样的方法我也在mysql中测试经过了。

1。下载ofbiz2.11


能够经过www.ofbiz.org下载，不......代理，也能够直接到http://sf.net上面查找ofbiz项目下载。
2。下载tomcat


建议使用tomcat4.1.24,曾经在网上看到过有人介绍tomcat.4.1.7以前的版本运行ofbiz时，taglib的处理很是慢，
以后的版本就没有这个问题了。tomcat能够到www.apache.org处下载。
3。安装oracle


理论上数据库能够是任何支持jdbc的数据库，我使用的是oracle8.17.
3.1 创建oracle表空间
    create tablespace ofbiz
    datafile 'd:\orant\oradata\ofbiz.dbf' size 2m
    autoextend on next 2m maxsize unlimited;
3.2 创建用户
    create user ofbiz
    identified by ofbiz
    default tablespace ofbiz;
   
    grant connect,resource to ofbiz;
   
    测试用户
    connect ofbiz/ofbiz;

4。安装ofbiz



4.1 设置环境变量
    JAVA_HOME
    ANT_HOME
    CATALINA_HOME
    OFBIZ_HOME
   
4.2    自动安装
    ofbiz 已经准备了一个ant脚本，它能够自动安装ofbiz到。
    在OFBIZ_HOME中有一个build.xml,执行ant install便可。
    可是这个自动脚本有的时候执行时会出错！若是出错，请看4。3手工安装。
   
4.3 手工安装
    4。3。1
        复制OFBIZ_HOME\commonapp\etc\目录下面的全部文件到CATALINA_HOME\share\classes中。
        复制OFBIZ_HOME\commonapp\lib\目录下*.jar到CATALINA_HOME\share\lib中。
        复制OFBIZ_HOME\core\lib\目录下*.jar到CATALINA_HOME\share\lib中。
        复制OFBIZ_HOME\lib\目录下*.jar到CATALINA_HOME\share\lib中。
            注意OFBIZ_HOME\lib\中的jar文件是按目录分门别类存放的，复制到CATALINA_HOME\share\lib须要去掉全部目录，把 全部jar都放到lib目录下。
    4。3。2
        编辑CATALINA_HOME\share\classes\entityengine.xml
        查找
        <datasource name="localoracle"
                helper-class="org.ofbiz.core.entity.GenericHelperDAO"
                field-type-name="oracle"
                check-on-start="true"
                add-missing-on-start="true"
                join-style="theta-oracle">
            <sql-load-path path="commonapp/db" prepend-env="ofbiz.home"/>
            <sql-load-path path="ecommerce/etc" prepend-env="ofbiz.home"/>
            <inline-jdbc
                    jdbc-driver="oracle.jdbc.driver.OracleDriver"
                    jdbc-uri="jdbc:oracle:thin: at 127 dot 0.0.1:1521:ofbiz"
                    jdbc-username="ofbiz"
                    jdbc-password="ofbiz"
                    isolation-level="ReadCommitted"/>
        </datasource>
        将jdbc部分改为对应的参数。
       
        查找
            <delegator name="default" entity-model-reader="main"......>
                    <group-map group-name="org.ofbiz.commonapp" datasource-name="localhsql"/>
                </delegator>
        改为
            <delegator name="default" entity-model-reader="main"......>
                    <group-map group-name="org.ofbiz.commonapp" datasource-name="localoracle"/>
                </delegator>
    4.3.3
        复制OFBIZ_HOME\setup\catalina41\bin中的ofbiz.bat到CATALINA_HOME\bin中
        复制OFBIZ_HOME\setup\catalina41\conf中的server.xml到CATALINA_HOME\conf中
            注意，这里的server.xml也能够不复制，这里面就是配置ofbiz的Context，手工更新到server.xml中便可
            另外注意，ofbiz默认ofbiz和tomcat在一个目录下，所以在server.xml中，他的context路径都是用的相对路径
            例如
            <Context path="/content" docBase="../../ofbiz/content/webapp" debug="0" reloadable="true">
       
        在OFBIZ_HOME\setup\catalina41\bin\runofbiz.bat
        内容以下：
            ofbiz.bat run
           
5.0 运行runofbiz.bat

    他首先调用ofbiz.bat设置环境变量，而后启动tomcat.
    启动tomcat的时候，ofbiz的DatabaseUtils会检查数据库中是否已经存在系统的表，没有就会自动建立的，通常的建立过程不会出错误 的。
    若是有错误产生，请察看CATALINA_HOME\logs中的日志文件，通常都是少某个jar,看到少哪一个到OFBIZ_HOME中找到后复制到 CATALINA_HOME\share\lib中

6.0 若是创建表都一切顺利就能够打开IE，而后输入URL

    http://localhost:8080/webtools/control/main
   
    记住要先用webtools导入数据，不然你不能用admin/ofbiz登录的！
    在这里 http://localhost:8080/webtools/control/install
    直接点Load Data按钮
    执行完毕后
    到这里
    http://localhost:8080/webtools/control/checkLogin/install
    用admin/ofbiz登录，登录成功证实安装完毕，不成功就察看一下日志文件。


在4。3。2步中，若是要安装到其余的数据库，能够修改其余数据库的jdbc链接配置，ofbiz为大部分支持jdbc的数据库提供的例子。
一样的方法也能够实施ofbiz到resin中,不过没有测试!:)

测试环境
SERVER : PII 300 , 512M
         PIII733 , 256M
windows 2000 advance server
ofbiz 2.11
oracle 8.1.7
mysql 4.0 max
tomcat 4.1.24

3、OFBIZ+TOMCAT+MYSQL安装与配置

ofbiz2.11提供的缺省的web server是jetty,咱们打算把他转移到tomcat上来。ofbiz2.11提供的缺省的数据库是hsql的，用webtools，转移他的数据 库是很是方便的，这里咱们介绍如何安装到mysql中 。

我认为不要问为何要这么装，在你用本文的方法安装两遍后，一切你都明白了。



1下载ofbiz2.11
能够经过www.ofbiz.org下载，也......�查找ofbiz项目下载。



2下载并安装tomcat
建议使用tomcat4.1.18之后的版本,曾经在网上看到过有人介绍tomcat.4.1.7以前的版本运行ofbiz时，taglib的处 理很是慢，以后的版本就没有这个问题了。tomcat能够到www.apache.org处下载。



3 安装Mysql

主要是创建表空间和创建用户。



4安装ofbiz



4.1设置环境变量
JAVA_HOME
ANT_HOME
CATALINA_HOME
OFBIZ_HOME



4.2复制classes和jar文件

复制OFBIZ_HOME\commonapp\etc\目录下面的全部文件到CATALINA_HOME\share\classes中。
复制OFBIZ_HOME\commonapp\lib\目录下*.jar到CATALINA_HOME\share\lib中。
复制OFBIZ_HOME\core\lib\目录下*.jar到CATALINA_HOME\share\lib中。
复制OFBIZ_HOME\lib\目录下*.jar到CATALINA_HOME\share\lib中。
注意OFBIZ_HOME\lib\中的jar文件是按目录分门别类存放的，复制到CATALINA_HOME\share\lib须要去掉全部 目录，把全部jar都放到lib目录下。



4.3编辑CATALINA_HOME\share\classes\entityengine.xml文件

找到以下文字：

<datasource name="localmysql"

            helper-class="org.ofbiz.core.entity.GenericHelperDAO"

            field-type-name="mysql"

            check-on-start="true"

            add-missing-on-start="true"

            use-foreign-keys="false"

            join-style="theta-oracle">

        <sql-load-path path="commonapp/db" prepend-env="ofbiz.home"/>

        <sql-load-path path="ecommerce/etc" prepend-env="ofbiz.home"/>

        <inline-jdbc

                jdbc-driver="org.gjt.mm.mysql.Driver"

                jdbc-uri="jdbc:mysql://127.0.0.1/ofbiz"

                jdbc-username="root"

                jdbc-password="gg"

                isolation-level="Serializable"/>      

</datasource>

编辑相应的配置 。

查找
<delegator name="default" entity-model-reader="main"......>
<group-map group-name="org.ofbiz.commonapp" datasource-name="localhsql"/>
</delegator>
改为
<delegator name="default" entity-model-reader="main"......>
<group-map group-name="org.ofbiz.commonapp" datasource-name="localmysql"/>
</delegator>



4.4 复制可执行程序

复制OFBIZ_HOME\setup\catalina41\bin中的ofbiz.bat到CATALINA_HOME\bin
复制OFBIZ_HOME\setup\catalina41\conf中的server.xml到CATALINA_HOME\conf中
注意，这里的server.xml也能够不复制，这里面就是配置ofbiz的Context，手工更新到server.xml中便可
另外注意，ofbiz默认ofbiz和tomcat在一个目录下，所以在server.xml中，他的context路径都是用的相对路径
例如
<Context path="/content" docBase="../../ofbiz/content/webapp" debug="0" reloadable="true">



4.5 启动
在OFBIZ_HOME\setup\catalina41\bin\runofbiz.bat
内容以下：
ofbiz.bat run

用该命令启动

它首先调用ofbiz.bat设置环境变量，而后启动tomcat.
启动tomcat的时候，ofbiz的DatabaseUtils会检查数据库中是否已经存在系统的表，没有就会自动建立的，通常的建立过程不会 出错误的。
若是有错误产生，请察看CATALINA_HOME\logs中的日志文件，通常都是少某个jar,看到少哪一个到OFBIZ_HOME中找到后复 制到CATALINA_HOME\share\lib中

4、Apache+OFBiz

OFBiz提供了AJP功能, 咱们可使用apache mod_jk来进行整合.

例如, ofbiz的http端口为8080, AJP端口为8109, ofbiz的主机名为local.ofbiz.org, 要经过apache 80访问到ofbiz的mysite, 须要进行如下配置:

修改windows/system32/drivers/etc/hosts文件, 增长
127.0.0.1    local.ofbiz.org

把mod_jk.so放到modules目录下面, 注意jk模块和apache须要版本匹配才行

在conf目录下面增长workers.properties
#Add your workers here. If you add an additional worker name, add it to this list
worker.list=ajpofbiz

#This worker is for the ofbiz instance
worker.ajpofbiz.type=ajp13
worker.ajpofbiz.host=127.0.0.1
worker.ajpofbiz.port=8109
worker.ajpofbiz.lbfactor=1
worker.ajpofbiz.cache_timeout=600
worker.ajpofbiz.socket_keepalive=1
worker.ajpofbiz.socket_timeout=300

在htdocs下面建立一个ofbiz目录, 增长index.html文件, 其内容为重定向到local.ofbiz.org/mysite/control/main

修改httpd.conf, 增长
LoadModule jk_module modules/mod_jk.so
JkWorkersFile "D:/Apache Group/Apache2/conf/workers.properties"
JkLogFile "D:/Apache Group/Apache2/logs/mod_jk.log"
JkLogLevel info

NameVirtualHost local.ofbiz.org:80
<VirtualHost local.ofbiz.org:80>
ServerName local.ofbiz.org
DocumentRoot "D:/Apache Group/Apache2/htdocs/ofbiz"
ErrorLog logs/error.log
DirectoryIndex index.html index.htm index.jsp index.php
JkMount /* ajpofbiz
CustomLog logs/access.log combined
FileETag none
</VirtualHost>

启动apache和ofbiz, 访问http://local.ofbiz.org, 应该能够看到mysite的内容了.

此外, 因为使用的仅仅是AJP, ofbiz自身的8080端口能够关闭了.