ERP 2.50:Openbravo ERP installation/zh cn

概述

本文讲述 怎样安装Openbravo ERP.

在开始之前, 请 确认 你已经 准备好 Openbravo 的安装环境, 即:

• PostgreSQL 或 Oracle 数据库
• Sun Java开发包 (JDK)
• Apache Tomcat
• Apache Ant

以及阅读相应版本的 说明书 .

Openbravo ERP可以采用两种不同的安装方式:

• 一种是较快的采用命令行方式, 检出并 编译Subversion源代码.
• 一种是较慢的采用图形界面风格, 下载Bitrock安装包.

许可证

Openbravo ERP is licensed under the Openbravo Public License Version 1.1:

The contents of this file are subject to the Openbravo Public License Version 1.1 (the "License"), being the Mozilla Public License version 1.1 with a permitted attribution clause; you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.openbravo.com/product/legal/license/.

Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License.

The Original Code is Openbravo ERP. The Initial Developer of the Original Code is Openbravo SLU. All portions are Copyright (C) 2001-2008 Openbravo SLU. All Rights Reserved.

Subversion中的源代码

为了从Openbravo Subversion仓库检出Openbravo ERP的源代码，你必须安装 Subversion (SVN)版本控制客户端软件.

一旦Subversion客户端安装完成，转到你想存放最新代码的目录并键入下列命令：

svn co https://dev.openbravo.com/svn/openbravo/tags/r2.40 openbravo-240

转到openbravo-240目录和configure Openbravo.properties 和log4j.lcf 文件，可以使用(向导) 在config/setup-tool目录的图形向导:

• Linux: setup-properties-linux.bin
• Windows: setup-properties-windows.exe

注意这些命令都可以在命令行执行，不必有图形界面，这时自动检测的。

编译前，请检查Openbravo.properties和log4j.lcf文件(在config 目录里)是否已经正确配置好了。如果没有，手工做以下。

从*.xml文件创建数据库并键入下列命令单步安装Openbravo ERP:

ant install.source

最后, 把openbravo.war文件部署到Apache Tomcat相关目录下(通常是webapps)，可以使用下列命令：

ant deploy

如果使用PostgreSQL数据库，在使用Openbravo ERP前，有必要用下列命令清除数据库：

vacuumdb -f -z -h 主机名 -d 数据库名 -U 用户名

把主机名换成实际数据库主机名，数据库名换成数据库名(缺省为openbravo), 以及用户名换成数据库用户(缺省为tad).

Bitrock 安装程序

下载最新 Openbravo ERP安装程序.

• Windows系统, 双击它。
• Linux系统, 做下列操作：

chmod +x OpenbravoERP_2.40-linux-installer.bin
./OpenbravoERP_2.40-linux-installer.bin

安装助手会跳出来(向导)：

阅读并接受Openbravo 公共许可证，版本1.1，然后再继续安装流程。

点击Forward按钮如果同意这份许可证的话。

指定Openbravo ERP的安装目录。

点击Forward按钮后，选择附件目录。

选择安装类型:

• 完全安装包括数据库和应用程序。
• 分布式安装只选择要装得部件。

完全安装有两个选项：

• 标准:创建数据库并安装应用程序。这是最快的安装方式，建议使用这种安装模式。
• 开发:创建数据库，编译应用然后产生安装文件。这个过程较慢，但建议开发员使用。

提供Java开发包（JDK）的安装目录'。

如果JDK正确安装的话, 安装程序可以自动识别目录结构。

提供Apache Ant安装的完整路径。

如果Apache Ant正确安装的话，安装程序可以自动辨识路径。

提供Apache Tomcat的安装路径。

如果Apache Tomcat正确安装的话，安装程序可以自动辨认其路径结构。

要使用哪种数据库。

当前，支持Oracle和PostgreSQL数据库。

提供数据库安装的全路径。

PostgresSQL的psql, vacuumdb和pg_restore路径，对Oracle来说是imp, sqlplus的路径。

安装过程中要提供数据库参数以备连接之用。安装期间，数据库必须在运行状态，要验证数据库密码。需要有下列参数：

• 数据库主机: 数据库服务运行机的IP地址或主机名。
• 数据库端口: 数据库服务的监听端口(缺省情况, 5432对PostgreSQL，1521对Oracle)。

点击Forward按钮，如果用Oracle数据库，要求输入SID (Oracle系统标识)和TNS (Transparent Network Substrate)。

下一个窗口，如果用PostgreSQL数据库的话。

对postgres管理员用户两次敲入密码。如果过用Oracle数据库，两次敲入system用户密码。实际上， Openbravo ERP要管理员权限来创建数据库元素。

如果用PostgreSQL:

提供装载Openbravo ERP数据模型的数据库名。键入数据库用户名和密码，给Openbravo ERP的数据对象。

给出一个上下文命名。

这会被用来从Tomcat进入Openbravo ERP：http://<ip_address>:<port>/<context_name>

下一步, 选择想要的时间日期格式：

最后，选择是否要装例程数据(BigBazaar)：

两次点击Forward，完成Openbravo ERP安装。

标准安装大概要10-30分钟，开发模式大概要30-90，这有赖于安装Openbravo ERP的机器性能了。

运行Openbravo ERP

两种情况下, 都要重启Tomcat服务来完成安装过程。

这里, 你应该在Apache Tomcat的webapps目录中发现(Windows的C:\Apache Software Foundation\Tomcat5.5\webapps\或C:\Tomcat5.5\webapps\ 以及Linux的/var/lib/tomcat5.5/webapps/):

• your_context_name.war文件.

如果不是这样:

• 停止Tomcat服务。
• 把your_context_name.war文件从lib复制。
• 放到Apache Tomcat的webapps目录
• 再次启动Tomcat服务。

从浏览器登录Openbravo ERP，敲入正确URL, 例如, http://localhost:8180/openbravo/.

检查your_context_name目录是否已经在Apache Tomcat的webapps中被创建。

http://hostname:port/context_name

http://localhost:8080/openbravo

在用户框内输入 Openbravo并在密码输入openbravo，然后点击登录Login按钮。

恭喜! 你已经成功安装了Openbravo ERP：)

安装后配置

安装Openbravo ERP之后，还有些参数要定制，这样Openbravo ERP就可以适用于你的国家或地区了。

本地化的安装

把Openbravo ERP转化成你的母语总是件有趣的事情 :)

配置缺省日期和时间格式

改变Openbravo ERP的时间日期格式，只要运行在config/setup-tool目录下的工具就行了.

一旦改变完成，重新编译部署Openbravo ERP就可以了:

ant compile.complete
ant war
ant deploy

配置缺省数字格式

修改 config目录下的Format.xml文件可以改变缺省的数字格式。 对每个类别都修改decimal="." grouping=","。做完之后必须重启Tomcat服务，然后报表会显示你所期望的结果。

已知问题

下面是一些安装Openbravo ERP过程中的已知问题。还可以找到另一些Openbravo安装环境问题。

Windows下Tomcat的热部署问题

在Windows下Tomcat有个已知问题。 Openbravo ERP可以支持openbravo.war在Tomcat的热部署，但在Windows经常会有文件锁住的问题。Windows不允许Tomcat卸除已部署的包因为操作系统会锁住那些文件。Tomcat有预防锁的机制，在Tomcat 5.5和6.0里，这个机制缺省是关闭的。只要在%CATALINA_BASE%\conf\context.xml文件里编辑一下。找到<context>并添加下列两个属性就行了：

<context antiJARLocking="true" antiResourceLocking="true" />

Jasper报表的问题

编译源代码时, 应用服务器要有互联网连接以便成功编译*.jrxml文件。如果没有，Jasper报表就不能正确工作。

Windows下，防火墙会阻挡Jasper报表的编译，所以要暂时关闭他们。

这些.jrxml文件头看上去如下：

<?xml version="1.0" encoding="UTF-8"  ?>
<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN" "http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">

如果应用服务器没有互联网连接，那就会有些问题，尽管看起来编译好像是成功的。调用报表时，就会得到如下的错误：

org.xml.sax.SAXParseException: Premature end of file.

如果修改所有的jrxml文件(到58行)并删除这一行（调用互联网连接的），

<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN" "http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">

便亦不会报错，但翻译会错，在应用程序里调用报表时，你会得到下列错误信息：

Language "null" not supported by this report compiler. Expecting "java" instead.

这样, 这个问题的最终解决方案就是替换这一行：

<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN" "http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">

换成

<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN" "/tmp/jasperreport.dtd">

所有58个 .jrxml文件，以避免与前一个URL冲突，然后编译，然后应用可以正常运行。

运行Jasper报表时的链接错误

在有些Linux的发行版中，使用Java SDK 1.5.0_13或1.5.0_15同时Tomcat以守护进程运行[jsvc]会有些问题。当加载Jasper报表时，会有报错找不到类库。最简单的办法就是修改/etc/init.d/tomcat脚本，加上LD_LIBRARY_PATH的导出，这里有(libawt.so)库。

例如:

LD_LIBRARY_PATH=/usr/lib/jvm/java-1.5.0-sun-1.5.0.13/jre/lib/i386/
export LD_LIBRARY_PATH

在Ubuntu有一个捷径，对所有1.5的字版本使用(如 1.5.0_13和1.5.0_15)。它使用符号链接自动指向正确的目录：

LD_LIBRARY_PATH=/usr/lib/jvm/java-1.5.0-sun/jre/lib/i386/
export LD_LIBRARY_PATH

Jasper报表环境变量

为了让JasperReports工作起来, 要对一些环境变量参数做点修改，如CATALINA_OPTS的参数-Djava.awt.headless=true。CATALINA_OPTS项中应有类似CATALINA_OPTS ="-server -Xms384M -Xmx512M -Djava.awt.headless=true"的内容。

Internet Explorer 6的问题

主要问题是IE6不支持PNG格式的alpha通道。IE7和Mozilla Firefox都支持。

解决方案一: 把PNG图像换成GIF。

• 不可能把所有的PNG都换成，因为PNG每个像素都有alpha通道，但GIF不是。GIF只支持到256色，这还不是最大的问题。如果用GIF，你要么定义全透明，要么没有透明度。灰度就没法实现了。

解决方案二：避免使用透明化

• 这就意味着叠加的图像就不行了。例如，图表和工具框，有正方形背景，按下去又会变化。这很好实现，如果有透明叠加的话。但如果没有这种透明性，我们就要有三种图标，对所有的背景都有三种情况，有很多图标要修改。
• 问题不仅仅是要重新创作所有的图标，针对每一种背景，问题还在于要重新编写所有的HTML和CSS文件。

解决方案三：过滤器

• 显示透明的PNG也不是完全不可能，对IE6，甚至对IE5.5也可以显示。有一种过滤器的机制可以用来处理这种情况，可以用JavaScript来实现。
• http://www.twinhelix.com/css/iepngfix/demo/ 和 http://redvip.homelinux.net/varios/explorer-png.html 有一些相关的例子。

我们尝试了好几种过滤器的方法，但不彻底改变css和html文件就没有什么好的效果。

唯一的解决方法就是创建一个只含gif 图像的界面, 代价就是丢失界面质量。可以看看 如何让创建一个新的界面风格。

你可以选择安装Mozilla Firefox或更新到IE7 (如果你是WindowsXP的忠实用户的话)。

Openbravo ERP常见问题

Openbravo ERP常见问题(FAQ).

小结

Openbravo ERP应该不会再有什么问题了，如果还有的话那可能以前安装过 Openbravo环境。

帮助和支持

任何有有关Openbravo ERP安装的问题疑惑，把它们递交到Openbravo帮助论坛或加入Freenode的 #openbravo IRC 通道。

专业支持，请参见Openbravo支持服务或Openbravo在线注册.

测试

测试，只是测试