1、Pentaho BI 安装及配置手册安装下载下载列表http:/ Pentaho BI 套件的大部分组成部分比如 Pentaho BI 平台、报表设计器、 Kettle ETL 工具等http:/ Mondrian OLAP 引擎资源说明biserver-manual-ce-x.x.x.stable.zip 自定义安装 Pentaho BI 平台,资深用户可能会使用到这一工件biserver-ce-.x.x.x.stable.zip 内置了 Pentaho BI 服务器及管理控制台的 Windows 版本,当然解压后可以同样用在其他 OS 中biserver-ce-x.x.x.stable.t
2、ar.gz 内置了 Pentaho BI 服务器及管理控制台的非 Windows版本,比如 Linux,当然解压后可以同样用在其他 OS中biserver-ce-x.x.x.stable-javadoc.zip Pentaho BI 平台对应的 API 规范bi-platform-x.x.x.stable-sources.zip Pentaho BI 平台对应的 Java 源码准备工作1. 解压 biserver-ce-x.x.x.stable.zip,有如下目录:biserver-ce Pentaho BI 服务器administration-console Pentaho 管理控制台2.
3、设置 JAVA_HOME,以使用系统安装的 JDK。注:由于 Pentaho BI 服务器默认是从自带的 Tomcat 中启动的,如果机器上本来就安装了Tomcat,并设置了相关环境变量,就有可能启动 Pentaho BI 时会启动之前安装的 Tomcat。运行启动及访问Pentaho BI 服务器 Pentaho 管理控制台启动 biserver-cestart-pentaho.bat administration-consolestart-pac.bat停止 biserver-cestop-pentaho.bat administration-consolestop-pac.bat默认服务
4、器 Tomcat Jetty网址 http:/localhost:8080/pentaho http:/localhost:8099帐户/ 密码 joe/password admin/password注意:Pentaho BI 在登录时默认可能列出用户列表,或者显示示例用户的用户名和,如下:需要将 biserver-cepentaho-solutionssystempentaho.xml 文件里的配置为如下才可以避免:配置JVM 参数为了优化性能,一般需要调整 JVM 参数。修改文件 biserver-cestart-pentaho.bat:set CATALINA_OPTS=-Xms256m
5、 -Xmx768m -XX:MaxPermSize=256m -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000通常-Xmx 参数取值不超过物理内存的 1/2,-Xms 取值最好不要低于-Xmx 的 1/2。不过,不同生产环境的差异性太大,建议用户能够在生产前进行严格的压力及调优测试,并灵活调整 JVM 参数。日志输出策略Pentaho BI 服务器默认采用 Log4j 记录各种日志。配置文件位于 biserver-cetomcatwebappspentahoWEB-INFclasses
6、log4j.xml可根据需要修改日志输出策略。Tomcat 参数为提高 BI 服务器的并行吞吐能力,除了调整 JVM 参数外,还需要调整 Tomcat 参数。配置文件位于 biserver-cetomcatconfserver.xml示例:通常,我们需要调整 maxThreads、minSpareThreads、maxSpareThreads 、acceptCount 等参数取值。大部分情况下,可以考虑将它们的取值设置成默认的 2 倍左右,即 maxThreads 设置成 300、minSpareThreads 设置成 50、maxSpareThreads 设置成 150、acceptCoun
7、t 设置成200。报表发布密码设置pentaho 的发布密码位于 pentaho-solutions/system 中的 publisher_config.xml password设置完发布密码,可直接将 report-design 程序设计的报表发布到服务器上。参见:http:/ 数据库迁移到 Oracle默认数据库为 HSQLDB,用 biserver-cedatastart_hypersonic.bat 可启动。由于 HSQLBD 不能支撑真实企业应用,所以生产环境必须替换,这里以迁移到 Oracle 为例。1. 拷贝驱动将 Oracle JDBC 驱动拷贝到 biserver-ceto
8、mcatwebappspentahoWEB-INFlib 或 biserver-cetomcatcommonlib 目录,供 Pentaho BI 服务器访问 Oracle 10g 数据库使用。将 Oracle JDBC 驱动拷贝到 administration-consolejdbc 目录,否则用户不能够正常使用Pentaho 管理控制台。2. 初始化 Oracle10g 数据库依次执行 biserver-cedataoracle10g下 SQL 脚本集合。我使用的版本某些脚本语法上有误,主要是 ALTER TABLE 语法,所以需要注意修改下。3. 修改 context.xml文档位置:b
9、iserver-cetomcatwebappspentahoMETA-INFcontext.xml示例如下:4. 启用 Oracle 配置文件打开 biserver-cepentaho-solutionssystemhibernate 中的 hibernate-settings.xml 配置文件,并启用 oracle10g.hibernate.cfg.xml 配置文件,配置示例如下。system/hibernate/oracle10g.hibernate.cfg.xml5. 调整 oracle10g.hibernate.cfg.xmlbiserver-cepentaho-solutionssy
10、stemhibernate 中的 oracle10g.hibernate.cfg.xml 配置文件也需要调整一下,比如 connection.url(jdbc:oracle:thin:localhost:1521:ORCL) 、connection.username(hibuser) 、connection.password (password)等。6. 修改 spring 配置文件位于 biserver-cepentaho-solutionssystemapplicationContext-spring-security-hibernate.properties,下面给出了配置示例。jdbc
11、.driver=oracle.jdbc.driver.OracleDriverjdbc.url=jdbc:oracle:thin:localhost:1521:pentahojdbc.username=hibuserjdbc.password=passwordhibernate.dialect=org.hibernate.dialect.Oracle10gDialect7. quartz.properties 属性文件修改位于 biserver-cepentaho-solutionssystemquartz 目录的 quartz.properties 属性文件。当 Quartz 采用 Orac
12、le 存储各种调度信息时,开发者需要启用如下实现类,即将默认的org.quartz.impl.jdbcjobstore.StdJDBCDelegate 被替换成 OracleDelegate。org.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.oracle.OracleDelegate8. 不激活 hibernate 和 quartz 数据库(可选)用户可以考虑不激活 hibernate 和 quartz 数据库,即在 biserver-cedatastart_hypersonic.bat中将下面列出的后
13、两行内容删除掉。“%_PENTAHO_JAVA%“ -cp %tempclasspath% org.hsqldb.Server-database.0 hsqldbsampledata -dbname.0 sampledata-database.1 hsqldbhibernate -dbname.1 hibernate-database.2 hsqldbquartz -dbname.2 quartzPentaho 管理控制台更改 admin 密码administration-consoleresourceconfiglogin.properties属性文件存储了 admin/password 帐
14、号信息,以及 admin 所属角色集合。此时,password 被进行了加密处理。Pentaho 管理控制台运行在 Jetty Web 容器中,而上述密文信息正是借助 Jetty 的实用类生成的,下面给出了操作示例。用户可以根据自身情况设定各自的系统管理员帐号信息。D:administration-consolejava -cp lib/jetty-6.1.2.jar;lib/jetty-util-6.1.9.jarorg.mortbay.jetty.security.Password admin passwordpasswordOBF:1v2j1uum1xtv1zej1zer1xtn1uvk1v1vMD5:5f4dcc3b5aa765d61d8327deb882cf99CRYPT:advwtv/9yU5yQ启用 HTTPS将 administration-consoleresourceconfigconsole.properties 文件中改为如下:console.ssl.enabled=true启用 HTTPS 后访问地址变为如下:https:/localhost:8043/ 注意,Pentaho 管理控制台提供的默认服务器证书已经过期,它存储在 administration-consoleresourceconfig 目录的 keystore 中。