dram.me

OFBiz系统安装配置

OFBiz的安装相对简单,这里做简要说明。

配置数据库

OFBiz内置有Derby数据库,可作为开发测试用,如果要生产使用,首先需要配置数据库。具体配置文件在framework/entity/config/entityengine.xml,以下以PostgreSQL为例。

  1. 创建ofbiz数据库;
  2. 创建ofbiz用户,密码设置为ofbiz;
  3. 将ofbiz所有者调整为ofbiz;
  4. 这里下载PostgreSQL JDBC插件,存放到ofbiz-framework/lib目录;
  5. 调整entityengine.xml中name属性为default的delegator,将localderby调整为localpostgres

编译

在完成数据库配置后,执行以下命令完成系统编译:

./gradlew jar

初始化

首先创建initial.xml文件,内容如下:

<entity-engine-xml>
  <Party partyId="admin" partyTypeId="PERSON" statusId="PARTY_ENABLED"/>
  <PartyRole partyId="admin" roleTypeId="CAL_OWNER"/>
  <UserLogin userLoginId="admin" partyId="admin" currentPassword="{SHA}47ca69ebb4bdc9ae0adec130880165d2cc05db1a" lastLocale="en"/>
  <UserLoginSecurityGroup groupId="SUPER" userLoginId="admin" fromDate="2001-01-01 12:00:00.0"/>
  <UserPreference userLoginId="admin" userPrefTypeId="VISUAL_THEME" userPrefGroupTypeId="GLOBAL_PREFERENCES" userPrefValue="FLAT_GREY"/>
</entity-engine-xml>

之后执行以下命令完成初始化:

java -jar build/libs/ofbiz.jar -l readers=seed -l file=initial.xml

运行

完成上述配置后,执行以下命令启动服务:

java -jar build/libs/ofbiz.jar

如果是用于开发,可以用./gradlew ofbiz启动。

服务启动后,可以通过https://localhost:8443/webtools访问。至于其他的命令参数,可以通过java -jar build/libs/ofbiz.jar --help查询。

配置

  • 允许HTTP访问

    OFBiz默认禁止HTTP访问,调整framework/webapp/config/url.properties中的no.httpport.https.enabled属性可以启用。

  • 禁用输入检查

    OFBiz默认对用户输入有严格的检查,通过调整framework/base/config/owasp.properties中的sanitizer.enable属性可以放宽限制。

  • 服务Host域名

    OFBiz默认对服务域名有限制,可以通过framework/security/config/security.properties中的host-headers-allowed属性调整。

  • 禁用externalLoginKey

    为支持在应用之间切换时保持会话,OFBiz默认通过在URL中追加externalLoginKey参数实现。可以通过framework/security/config/security.properties中的security.login.tomcat.ssosecurity.login.externalLoginKey.enabled调整为Tomcat的SSO机制。