Platform Version
December 12, 2005
Copyright © 2005 Pentaho Corporation. Redistribution permitted. All trademarks are the property of their respective owners.
For the latest information, please visit our web site at www.pentaho.org
1 下载Pentaho BI 平台
1.1 下载站点
Pentaho BI 平台可以自由下载:
l 使用一个web 浏览器,浏览到这个网页:http://www.sourceforge.net/projects/pentaho
l 点击 Files。
l 选择满足你的需要的包。如果你不确定,以下章节会帮助你确定哪个下载适合你。
l 选择你想从哪里下载。如果你比较狂热,可从一些外国站点下载,例如 Russia 或China。如果你住在 Russia 或 China,可从 North Carolina 的一些站点下载。你可能没时间到处玩,但是至少你的下载可环球旅行。
2 预配置安装包
预配置安装包是一个完整的服务器安装,设计来允许你评估Pentaho BI 平台的一些特征。它包含一个预配置的应用程序服务器/web服务器,预配置的预先生成的应用程序数据库, sample 数据和全功能的samples。也有一个包含了JRE (仅限于Windows) 的预配置安装版本。
如果你选择了预配置安装包,你需要下载《快速启动指南》,也可从http://www.sourceforge.net/projects/pentaho下载,它将指导你进行简单的安装,配置和运行平台samples。
3 J2EE Deployment Distribution
J2EE Deployment Distribution 是一个包,允许你为某种应用程序服务器构造多种不同的web应用程序archives和/或企业应用程序。
到目前为止,我们有构造以下archives (通过Ant targets)的脚本:
l Tomcat 5.0 .war 文件
l JBoss
l JBoss
可在SourceForge 上找到这个包,其名为 pentaho_j2ee_deployments-<version>.zip。有关如何从SourceForge 下载我们的包,请参考下载Pentaho BI 平台一节。
如果你想将平台配置到以上列出的应用程序服务器中的一个,就下载这个包。这也是一个好的起点,如果你想将之配置到一个没有列出的应用程序服务器时。你需要的所有Pentaho 文件均存在于这个包中,你所需要做的就是编写你自己的Ant target,并添加你的环境必需的配置文件。
我们有一个预配置的JBoss 应用程序服务器,其中已经为你设置和配置好了每件事物(参考之前的章节)。如果想尽快省力的配置运行,我们推荐使用预配置安装包。如果想在自己的环境中设置平台,可选择使用J2EE Deployment Distribution。
注意:我们主要的应用程序服务器测试环境是 JBoss
3.1 额外要求
除了 pentaho_j2ee_deployments-<version>.zip,你需要下载以下的包:
l pentaho_data-<version>.zip:用于samples 和测试实例的 Hypersonic 数据库。
l pentaho_solutions-<version>.zip:Samples 和测试实例包括所有必须的资源。
你也将需要确保你已经有:
l 这个下载需要已经安装了一个 Java SDK 或 JRE。Pentaho BI 平台已在 Java SDK 1.4上构建和测试过,可用于很多平台 http://java.sun.com/j2ee/1.4/download.html#sdk。
l 确保环境变量 JAVA_HOME 指向 JDK 被安装的目录。
l 这个下载也需要安装了 Apache Ant,开放源码的基于 Java 的构建工具。你将需要 Ant 的
l 确保 Ant 的bin 目录在你的系统 path 上可用。
这一节描述外围内容的(数据和sample solutions)手动配置,这是必需的,如果你想使用一个配置设置 sample solutions,而不是使用我们提供的预配置安装的话。
我们建议你在将平台配置到你的应用程序服务器之前,调整 solutions 和数据库。一些应用程序服务器需要在配置期间,数据库是 alive 的,否则配置可能失败。
3.1.1 配置数据库
l 解压 pentaho_data-<version>.zip。
l 在资源浏览树的根目录,你应能见到一个 startup 和 shutdown 脚本。
l 为启动数据库服务器,运行 start-hypersonic (.bat 用于Windows,.sh 用于 *nix) 脚本。
l 为停止数据库服务器,运行stop-hypersonic (.bat 用于 Windows,.sh 用于 *nix) 脚本。
3.1.2 配置Sample Solutions
l 这很重要!将 pentaho_solutions-<version>.zip 解压到一个目录,它是你的应用程序服务器的根目录的一个同级目录。
l 只要 pentaho-solutions 目录如上所述被配置为应用程序服务器的同级目录,web 应用程序不需要做任何配置上的改变就可以找到 pentaho-solutions。
l 如果应用程序不能找到sample solutions,你可以输入一个配置参数指向他们。
n 抽取 web.xml 文件(从 .war)
n 查找值为 solution-path 的<param-name> 元素。
n 直接在<param-name>元素后,输入一个<param-value> 元素,将它的值设置为pentaho-solutions 目录的绝对路径。
n 实例:<param-value>d:/pentaho/pentaho-solutions</param-value>
n 重新构建 .war 文件。
3.1.3 Deployment
为配置 Pentaho BI 平台,首先,你必须有一个 J2EE 兼容的 archive 文件,它包含平台的所有文件和资源。我们提供了 pentaho_j2ee_deployments-<version>.zip 帮助构建一些最常使用的 archives。