PentahoBI的安装及配置手册

PentahoBI安装及配置手册安装下载下载列表套件的大部分组成部分比如PentahoBI平台、报表设计器、KettleETL工具等引擎资源说明biserver-manual-ce-x.x.x.stable.zip自定义安装PentahoBI平台，资深用户可能会使用到这一工件biserver-ce-.x.x.x.stable.zip内置了PentahoBI服务器及管理控制台的Windows版本，当然解压后可以同样用在其他OS中biserver-ce-x.x.x.stable.tar.gz内置了PentahoBI服务器及管理控制台的非Windows版本，比如Linux，当然解压后可以同样用在其他OS中biserver-ce-x.x.x.stable-javadoc.zipPentahoBI平台对应的API规范bi-platform-x.x.x.stable-sources.zipPentahoBI平台对应的Java源码准备工作1.解压biserver-ce-x.x.x.stable.zip，有如下目录：biserver-cePentahoBI服务器administration-consolePentaho管理控制台2.设置JAVA_HOME，以使用系统安装的JDK。注：由于PentahoBI服务器默认是从自带的Tomcat中启动的，如果机器上本来就安装了Tomcat，并设置了相关环境变量，就有可能启动PentahoBI时会启动之前安装的Tomcat。运行启动及访问PentahoBI服务器Pentaho管理控制台启动biserver-ce\start-pentaho.batadministration-console\start-pac.bat停止biserver-ce\stop-pentaho.batadministration-console\stop-pac.bat默认服务器TomcatJetty网址://localhost:8099帐户/密码joe/passwordadmin/password注意：PentahoBI在登录时默认可能列出用户列表，或者显示示例用户的用户名和，如下：需要将biserver-ce\pentaho-solutions\system\pentaho.xml文件里的配置为如下才可以避免：配置JVM参数为了优化性能，一般需要调整JVM参数。修改文件biserver-ce\start-pentaho.bat：setCATALINA_OPTS=-Xms256m-Xmx768m-XX:MaxPermSize=256m-Dsun.rmi.dgc.client.gcInterval=3600000-Dsun.rmi.dgc.server.gcInterval=3600000通常-Xmx参数取值不超过物理内存的1/2，-Xms取值最好不要低于-Xmx的1/2。不过，不同生产环境的差异性太大，建议用户能够在生产前进行严格的压力及调优测试，并灵活调整JVM参数。日志输出策略PentahoBI服务器默认采用Log4j记录各种日志。配置文件位于biserver-ce\tomcat\webapps\pentaho\WEB-INF\classes\log4j.xml可根据需要修改日志输出策略。Tomcat参数为提高BI服务器的并行吞吐能力，除了调整JVM参数外，还需要调整Tomcat参数。配置文件位于biserver-ce\tomcat\conf\server.xml示例：Connectorport=8080maxHttpHeaderSize=8192maxThreads=150minSpareThreads=25maxSpareThreads=75enableLookups=falseredirectPort=8443acceptCount=100connectionTimeout=20000disableUploadTimeout=true/通常，我们需要调整maxThreads、minSpareThreads、maxSpareThreads、acceptCount等参数取值。大部分情况下，可以考虑将它们的取值设置成默认的2倍左右，即maxThreads设置成300、minSpareThreads设置成50、maxSpareThreads设置成150、acceptCount设置成200。报表发布密码设置pentaho的发布密码位于pentaho-solutions/system中的publisher_config.xmlpublisher-configpublisher-passwordpassword/publisher-password/publisher-config设置完发布密码，可直接将report-design程序设计的报表发布到服务器上。参见：数据库迁移到Oracle默认数据库为HSQLDB，用biserver-ce\data\start_hypersonic.bat可启动。由于HSQLBD不能支撑真实企业应用，所以生产环境必须替换，这里以迁移到Oracle为例。1.拷贝驱动将OracleJDBC驱动拷贝到biserver-ce\tomcat\webapps\pentaho\WEB-INF\lib或biserver-ce\tomcat\common\lib目录，供PentahoBI服务器访问Oracle10g数据库使用。将OracleJDBC驱动拷贝到administration-console\jdbc目录，否则用户不能够正常使用Pentaho管理控制台。2.初始化Oracle10g数据库依次执行biserver-ce\data\oracle10g\下SQL脚本集合。我使用的版本某些脚本语法上有误，主要是ALTERTABLE语法，所以需要注意修改下。3.修改context.xml文档位置：biserver-ce\tomcat\webapps\pentaho\META-INF\context.xml示例如下：?xmlversion=1.0encoding=UTF-8?Contextpath=/pentahodocbase=webapps/pentaho/Resourcename=jdbc/Hibernateauth=Containertype=javax.sql.DataSourcefactory=org.apache.commons.dbcp.BasicDataSourceFactorymaxActive=20maxIdle=5maxWait=10000username=hibuserpassword=passworddriverClassName=oracle.jdbc.driver.OracleDriverurl=jdbc:oracle:thin:@localhost:1521:pentahovalidationQuery=select*fromdual/Resourcename=jdbc/Quartzauth=Containertype=javax.sql.DataSourcefactory=org.apache.commons.dbcp.BasicDataSourceFactorymaxActive=20maxIdle=5maxWait=10000username=pentaho_userpassword=passworddriverClassName=oracle.jdbc.driver.OracleDriverurl=jdbc:oracle:thin:@localhost:1521:pentahovalidationQuery=select*fromdual//Context4.启用Oracle配置文件打开biserver-ce\pentaho-solutions\system\hibernate中的hibernate-settings.xml配置文件，并启用oracle10g.hibernate.cfg.xml配置文件，配置示例如下。config-filesystem/hibernate/oracle10g.hibernate.cfg.xml/config-file5.调整oracle10g.hibernate.cfg.xmlbiserver-ce\pentaho-solutions\system\hibernate中的oracle10g.hibernate.cfg.xml配置文件也需要调整一下，比如connection.url（jdbc:oracle:thin:@localhost:1521:ORCL）、connection.username（hibuser）、connection.password（password）等。6.修改spring配置文件位于biserver-ce\pentaho-solutions\system\applicationContext-spring-security-hibernate.properties，下面给出了配置示例。jdbc.driver=oracle.jdbc.driver.OracleDriverjdbc.url=jdbc:oracle:thin:@localhost:1521:pentahojdbc.username=hibuserjdbc.password=passwordhibernate.dialect=org.hibernate.dialect.Oracle10gDialect7.quartz.properties属性文件修改位于biserver-ce\pentaho-solutions\system\quartz目录的quartz.properties属性文件。当Quartz采用Oracle存储各种调度信息时，开发者需要启用如下实现类，即将默认的org.quartz.impl.jdbcjobstore.StdJDBCDelegate被替换成OracleDelegate。org.quartz.jobStore.driverDelegateClass=org.quartz.impl.jdbcjobstore.oracle.OracleDelegate8.不激活hibernate和quartz数据库（可选）用户可以考虑不激活hibernate和quartz数据库，即在biserver-ce\data\start_hypersonic.bat中将下面列出的后两行内容删除掉。%_PENTAHO_JAVA%-cp%tempclasspath%org.hsqldb.Server-database.0hsqldb\sampledata-dbname.0sampledata-database.1hsqldb\hibernate-dbname.1hibernate-database.2hsqldb\quartz-dbname.2quartzPentaho管理控制台更改admin密码administration-console\resource\config\login.properties属性文件存储了admin/password帐号信息，以及admin所属角色集合。此时，password被进行了加密处理。Pentaho管理控制台运行在JettyWeb容器中，而上述密文信息正是借助Jetty的实用类生成的，下面给出了操作示例。用户可以根据自身情况设定各自的系统管理员帐号信息。D