Pentaho BI安装及配置手册
安装
下载
资源说明
准备工作
注:由于Pentaho BI服务器默认是从自带的Tomcat中启动的,如果机器上本来就安装了Tomcat,并设置了相关环境变量,就有可能启动Pentaho BI时会启动之前安装的Tomcat。
运行
注意:
Pentaho BI在登录时默认可能列出用户列表,或者显示示例用户的用户名和,如下:
需要将biserver-ce\pentaho-solutions\system\pentaho.xml文件里的配置为如下才可以避免:
配置
JVM参数
为了优化性能,一般需要调整JVM参数。
修改文件biserver-ce\start-pentaho.bat:
通常-Xmx参数取值不超过物理内存的1/2,-Xms取值最好不要低于-Xmx的1/2。不过,不同生产环境的差异性太大,建议用户能够在生产前进行严格的压力及调优测试,并灵活调整JVM参数。
日志输出策略
Pentaho BI服务器默认采用Log4j记录各种日志。
配置文件位于biserver-ce\tomcat\webapps\pentaho\WEB-INF\classes\log4j.xml
可根据需要修改日志输出策略。
Tomcat参数
为提高BI 服务器的并行吞吐能力,除了调整JVM参数外,还需要调整Tomcat参数。
配置文件位于biserver-ce\tomcat\conf\server.xml
通常,我们需要调整maxThreads、minSpareThreads、maxSpareThreads、acceptCount等参数取值。大部分情况下,可以考虑将它们的取值设置成默认的2倍左右,即maxThreads设置成300、minSpareThreads设置成50、maxSpareThreads设置成150、acceptCount设置成200。
报表发布密码设置
设置完发布密码,可直接将report-design程序设计的报表发布到服务器上。
参见:https://www.wendangku.net/doc/575035794.html,/display/Reporting/8.+Publishing+a+Report
数据库迁移到Oracle
默认数据库为HSQLDB,用biserver-ce\data\start_hypersonic.bat可启动。
由于HSQLBD不能支撑真实企业应用,所以生产环境必须替换,这里以迁移到Oracle为例。
1. 拷贝驱动
将Oracle JDBC驱动拷贝到biserver-ce\tomcat\webapps\pentaho\WEB-INF\lib或
biserver-ce\tomcat\common\lib目录,供Pentaho BI服务器访问Oracle 10g数据库使用。
将Oracle JDBC驱动拷贝到administration-console\jdbc目录,否则用户不能够正常使用Pentaho管理控制台。
2. 初始化Oracle10g数据库
依次执行biserver-ce\data\oracle10g\下SQL脚本集合。
我使用的版本某些脚本语法上有误,主要是ALTER TABLE语法,所以需要注意修改下。
3. 修改context.xml
文档位置:biserver-ce\tomcat\webapps\pentaho\META-INF\context.xml
4. 启用Oracle配置文件
打开biserver-ce\pentaho-solutions\system\hibernate中的hibernate-settings.xml配置文件,并启用oracle10g.hibernate.cfg.xml配置文件,配置示例如下。
5. 调整oracle10g.hibernate.cfg.xml
biserver-ce\pentaho-solutions\system\hibernate中的oracle10g.hibernate.cfg.xml配置文件也需要调整一下,比如connection.url(jdbc:oracle:thin:@localhost:1521:ORCL)、https://www.wendangku.net/doc/575035794.html,ername(hibuser)、connection.password(password)等。
6. 修改spring配置文件
位于
biserver-ce\pentaho-solutions\system\applicationContext-spring-security-hibernate.properties,下面给出了配置示例。
7. quartz.properties属性文件
修改位于biserver-ce\pentaho-solutions\system\quartz目录的quartz.properties属性文件。当Quartz采用Oracle存储各种调度信息时,开发者需要启用如下实现类,即将默认的
8. 不激活hibernate和quartz数据库(可选)
用户可以考虑不激活hibernate和quartz数据库,即在biserver-ce\data\start_hypersonic.bat 中将下面列出的后两行内容删除掉。
Pentaho管理控制台
更改admin密码
administration-console\resource\config\login.properties
属性文件存储了admin/password帐号信息,以及admin所属角色集合。此时,password被进行了加密处理。
Pentaho管理控制台运行在Jetty Web容器中,而上述密文信息正是借助Jetty的实用类生成的,下面给出了操作示例。用户可以根据自身情况设定各自的系统管理员帐号信息。
启用HTTPS
将administration-console\resource\config\console.properties文件中改为如下:
启用HTTPS后访问地址变为如下:
https://localhost:8043/
注意,Pentaho管理控制台提供的默认服务器证书已经过期,它存储在
administration-console\resource\config目录的keystore中。