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端口能夠關閉了.