Opentaps 1.5.0安装配置笔记（附ant命令源码安装）及ofbiz 12.04.02安装特别注意事项

1,数据库新建及授权
mysql> create database opentapsERP;
Query OK, 1 row affected (0.03 sec)

开始设置localhost在我自己的机器中出现拒绝访问,查看错误提示后发现为opentaps指定为127.0.0.1登录
mysql> grant all privileges on opentapsERP.* to 'opentaps'@'127.0.0.1' identified by 'opentaps_ERP_0209' ;
Query OK, 0 rows affected (0.11 sec)

mysql> flush privileges;
Query OK, 0 rows affected (0.13 sec)

mysql> exit

2，解压移动至安装目录
[root@localhost software]# unzip opentaps-1.5.0.zip
[root@localhost software]# mv opentaps-1.5.0 /usr/local/
[root@localhost software]# cd /usr/local/opentaps-1.5.0/

3，修改数据库连接配置
[root@localhost opentaps-1.5.0]# cd framework/entity/config/
[root@localhost config]# vim entityengine.xml
在<delegator name="default"...>下的"datasource-name"把属性从"localderby"改为"localmysql"，如下所示：
<delegator name="default" entity-model-reader="main" entity-group-reader="main" entity-eca-reader="main" distributed-cache-clear-enabled="false">
<group-map group-name="org.ofbiz" datasource-name="localmysql"/>
<group-map group-name="org.ofbiz.olap" datasource-name="localderbyolap"/>
<group-map group-name="org.ofbiz.tenant" datasource-name="localmysqltenant"/>
<group-map group-name="org.opentaps.analytics" datasource-name="analytics"/>
<group-map group-name="org.opentaps.testing" datasource-name="testing"/>
</delegator>

修改<datasource name="localmysql"...>段中数据信息
修改jdbc-uri连接信息，主要是更改数据库把数据库从ofbiz改成opentapsERP：
jdbc:mysql://127.0.0.1/ofbiz?autoReconnect=true&useOldAliasMetadataBehavior=true 改为
jdbc:mysql://127.0.0.1/opentapsERP?autoReconnect=true&useOldAliasMetadataBehavior=true

修改数据库用户名及密码为自己的数据库信息：
jdbc-username="opentaps"
jdbc-password="opentaps_ERP_0209"

修改数据库字符集为UTF8：
character-set="utf8"
collate="utf8_general_ci"

完整信息如下所示：
<datasource name="localmysqltenant"
helper-class="org.ofbiz.entity.datasource.GenericHelperDAO"
field-type-name="mysql"
check-on-start="true"
add-missing-on-start="true"
check-pks-on-start="false"
use-foreign-keys="true"
join-style="ansi-no-parenthesis"
alias-view-columns="false"
drop-fk-use-foreign-key-keyword="true"
table-engine="InnoDB" --特别提示：如果使用table-type为主参数时，mysql5.5.33指定sql时报错
character-set="utf8"
collate="utf8_general_ci">
<read-data reader-name="seed"/>
<read-data reader-name="seed-initial"/>
<read-data reader-name="demo"/>
<read-data reader-name="ext"/>
<inline-jdbc
jdbc-driver="com.mysql.jdbc.Driver"
jdbc-uri="jdbc:mysql://127.0.0.1/opentapsERP?autoReconnect=true&useOldAliasMetadataBehavior=true"
jdbc-username="opentaps"
jdbc-password="opentaps_ERP_0209"
isolation-level="ReadCommitted"
pool-minsize="2"
pool-maxsize="250"
time-between-eviction-runs-millis="600000"/><!-- Please note that at least one person has experienced a problem with this value with MySQL
and had to set it to -1 in order to avoid this issue.
For more look at http://markmail.org/thread/5sivpykv7xkl66px and http://commons.apache.org/dbcp/configuration.html--> <!-- <jndi-jdbc jndi-server-name="localjndi" jndi-name="java:/MySqlDataSource" isolation-level="Serializable"/> -->
</datasource>

把改好的<datasource name="localmysql"...</datasource>复制一份为<datasource name="localmysqltenant",这个复制方法可以用vim,在正常模式下移动光标到要开始复制的地方，按30yy，到结束的地方按p，把复制的30行粘到后面.

4,修改程序运行时占用内存参数，因为虚拟机使用的系统内存较少，如果内存大于2G可使用默认内存配置，修改后如下。
[root@localhost opentaps-1.5.0]# cat build.properties
memory.initial.param = -Xms256M
memory.max.param = -Xmx512M
permmemory.max.param = -XX:MaxPermSize=256M
memory.maxpermsize.param = -XX:MaxPermSize=256M
javadoc.maxmemory = 256M
pos.memory.max.param = -Xmx256M

5,进入主程序目录，编译运行
ant命令安装
下载ant命令包并解压
[root@localhost software]# wget http://mirrors.hust.edu.cn/apache//ant/source/apache-ant-1.9.3-src.tar.gz [root@localhost software]# tar -zxvf apache-ant-1.9.3-src.tar.gz
[root@localhost software]# cd apache-ant-1.9.3
下载ant的junit支持包并放入指定目录
[root@localhost apache-ant-1.9.3]# wget http://dl.shiguanglu.com/jarfiles/j/junit/junit-4.10.jar.zip [root@localhost apache-ant-1.9.3]# unzip junit-4.10.jar.zip
[root@localhost apache-ant-1.9.3]# mv junit-4.10.jar junit.jar
[root@localhost apache-ant-1.9.3]# mv junit.jar lib/optional/

在解压主目录运行build.sh命令编译生成ant命令：
[root@localhost apache-ant-1.9.3]# ./build.sh
如出现提示"Warning: JAVA_HOME environment variable not set."...,在build.sh和bootstap.sh脚本的最开始位置添加 JAVA_HOME设置。

拷贝主目录中生成的dist目录下的lib和bin目录到系统程序目录下
[root@localhost apache-ant-1.9.3]# mkdir -p /usr/local/apache-ant-1.9.3/
[root@localhost apache-ant-1.9.3]# cp -r dist/* /usr/local/apache-ant-1.9.3/

配置ANT_HOME到/etc/bashrc：
ANT_HOME=/usr/local/apache-ant-1.9.3
PATH=$MYSQL_HOME/bin:$JAVA_HOME/bin:$ANT_HOME/bin:$PATH

运行编译命令生成openstaps：
ant run-install
出现build.xml于510行错误提示代码99，运行如下命令
ant run-install-seed 用于安装迁移数据库数据
当出现BUILD SUCCESSFUL 时再执行：
ant run-install
出现BUILD SUCCESSFUL表示安装完成。

6,配置启动并添加系统自启动
修改startofbiz.sh文件
添加
#chkconfig: 345 97 79

修改内存
MEMIF="-Xms256M -Xmx512M -XX:MaxPermSize=512M"

启动opentaps
./startofbiz.sh

7,登录 http://192.168.8.110:8080/opentaps 用户名密码：admin/opentaps

8，添加随系统启动
如果需要让程序随系统启动而启动则把startofbiz.sh的完整路径追加到/etc/rc.local文件中
或是在startofbiz.sh中添加：

#chkconfig: 345 97 79 --使之可以添加到chkconfig启动管理中。然后copy到/etc/init.d/下,然后用chkconfig命令管理启动等级。

Ofbiz安装思路与Opentaps雷同，但需要注意如下几点：
1，手动安装mysql jdbc的jar驱动程序包
到http://dev.mysql.com/downloads/connector/j/ 更新JDBC驱动，将mysql的jdbc驱动jar包copy到${ofbiz-install-dir}/framework/entity/lib/jdbc 目录下。

2，编译安装导入数据注意
新版本中ant run-install 命令已经改为ant load-demo，如果运行ant run-install 会给出提示运行新的命令导入数据库及安装

3, tools/startofbiz.sh启动文件配置修改
取消倒数第二行注释并添加 cd "$OFBIZ_HOME" 命令，完整如下：
cd "$OFBIZ_HOME" && $JAVA $VMARGS -jar ofbiz.jar $* >>$OFBIZ_LOG 2>>$OFBIZ_LOG& --此为后台方式 启动程序。
并注释掉最后一行的默认启动方式：
#(cd "$OFBIZ_HOME" && exec "$JAVA" $VMARGS -jar ofbiz.jar "$@") --该命令在程序启动后，以前台方式运行，如果前端命令行窗口中断或关闭，则程序停止运行。