Pentaho 3.7.0 Linux and MySQL

Embed Size (px)

Citation preview

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    1/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    2/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Table of Contents

    Table of ContentsIntroduction

    LicenseDonateYou can donate to my PayPal account by clicking here. AboutThe CommunityThanks

    Getting StartedInstalling and Configuring JavaInstalling and Configuring MySQL 5.x ServerDeploying the Platform

    Packaged Apache-Tomcat ServerExisting Apache-Tomcat ServerMySQL Java Connectorwebapps

    SQL Script PackConfiguring the Databases

    Extract the MySQL 5.x SQL Script PackLoad the SQL scripts

    Configuring JDBC SecurityapplicationContext-spring-security-jdbc.xmlapplicationContext-spring-security-hibernate.properties hibernate-settings.xmlmysql5.hibernate.cfg.xml (optional)

    Configuring Hibernate and QuartzConfiguring Apache-Tomcat Server

    solution-pathfully-qualified-server-urlDisable HSQL Database StartupTrustedIpAddrsOther Parameters

    Configuring SMTP (mail server)Configuring PublishingConfiguring the Administration ConsoleStarting the Business Intelligence PlatformStarting the Administration Console

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    3/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Introduction

    License

    This work is licensed under aCreative Commons Attribution 3.0 Australia License.

    Donate

    This tutorial is accessed by thousands on a monthly basis, from most of the feedback many found itextremely helpful! But contrary to belief I do not work for Pentaho and all of this work is voluntary, soeven $1 can help me with producing bigger and better tutorials!

    You can donate to my PayPal account by clicking here.

    About

    To use this guide It is assumed that readers have intermediateto advancedknowledge in their setup ofchoice and basic knowledge of Pentaho (although it is not needed). The following operating systems anddatabases are supported:

    Windows MySQL 5.x PostgreSQL 8.x.x Oracle 10g & 11g

    Linux * MySQL 5.x* PostgreSQL 8.x.x Oracle 10g & 11g

    * This tutorial is for Linux and MySQL 5.x setup.

    The Community

    Don't forget about the other hardworking projects which are part of the Pentaho community and alsodeserve a donation:

    PAT (Pentaho Analysis Tool)An alternative to Pentaho's current OLAP analyser tool, JPivot.

    CDF (Community Dashboard Framework)A framework for building dashboards within Pentaho's Business Intelligence Server User Console.

    CBF (Community Build Framework)

    http://creativecommons.org/licenses/by/3.0/au/http://creativecommons.org/licenses/by/3.0/au/http://creativecommons.org/licenses/by/3.0/au/https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=10967601https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=10967601http://code.google.com/p/pentahoanalysistool/http://code.google.com/p/pentahoanalysistool/http://code.google.com/p/pentaho-cdf/http://code.google.com/p/pentaho-cdf/http://wiki.pentaho.com/display/COM/CBF+-+Community+Build+Frameworkhttp://wiki.pentaho.com/display/COM/CBF+-+Community+Build+Frameworkhttp://wiki.pentaho.com/display/COM/CBF+-+Community+Build+Frameworkhttp://code.google.com/p/pentaho-cdf/http://code.google.com/p/pentahoanalysistool/https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=10967601http://creativecommons.org/licenses/by/3.0/au/
  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    4/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Is an ant build.xml file script and alternate way to setup and deploy Pentaho based applications

    CDA (Community Data Access)

    A data access layer forCDF (Community Dashboard Framework).

    Thanks

    Thanks to the following blogs, individuals, companies and groups:

    ##pentaho & ##pentaho.patIRC channels found onFreenode(Pentaho and Pentaho PAT).

    Pentaho Wiki&Pentaho ForumsThe first place any new user to Pentaho should look.

    Open Source Business IntelligenceProvided a working copy of the sample database for MySQL.

    BizcubedProvided a working copy of the sample database for PostgreSQL - they are also Australian!

    Pentaho Solutions: Business Intelligence and Data Warehousing with Pentaho and MySQL A book by Roland and Jos van Dongen.

    http://pedroalves-bi.blogspot.com/2010/01/cda-community-data-access.htmlhttp://pedroalves-bi.blogspot.com/2010/01/cda-community-data-access.htmlhttp://code.google.com/p/pentaho-cdf/http://code.google.com/p/pentaho-cdf/http://code.google.com/p/pentaho-cdf/http://freenode.net/http://freenode.net/http://freenode.net/http://wiki.pentaho.com/http://wiki.pentaho.com/http://www.pentaho.com/forumshttp://www.pentaho.com/forumshttp://www.pentaho.com/forumshttp://osbi.nl/http://osbi.nl/http://www.bizcubed.com.au/http://www.bizcubed.com.au/http://www.amazon.com/Pentaho-Solutions-Business-Intelligence-Warehousing/dp/0470484322http://www.amazon.com/Pentaho-Solutions-Business-Intelligence-Warehousing/dp/0470484322http://www.amazon.com/Pentaho-Solutions-Business-Intelligence-Warehousing/dp/0470484322http://www.bizcubed.com.au/http://osbi.nl/http://www.pentaho.com/forumshttp://wiki.pentaho.com/http://freenode.net/http://code.google.com/p/pentaho-cdf/http://pedroalves-bi.blogspot.com/2010/01/cda-community-data-access.html
  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    5/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Getting Started

    Installing and Configuring Java

    The Pentaho BI Platform requires a JVM (Java Virtual Machine) to be installed on your PC or server. Tocheck if Java is already installed issue the following command (seen in bold) at the terminal prompt:

    user@terminal:~# java -versionjava version "1.6.0_13"Java(TM) SE Runtime Environment (build 1.6.0_13-b03)Java HotSpot(TM) Client VM (build 11.3-b02, mixed mode, sharing)

    If a similar output (seen above) is displayed Java is already installed. If not, to install Java on Linux issuethe following commands (seen in bold):

    Ubuntu

    user@terminal:~# sudo apt-get install sun-java6-jdk sun-java6-jre

    Fedorauser@terminal:~# sudo su install sun-java6-jdk sun-java6-jre

    The next step is to check if the JAVA_HOME environment variable is setup correctly, issue the followingcommand (seen in bold) at the terminal prompt:

    user@terminal:~# echo $JAVA_HOME/usr/lib/jvm/java-6-sun

    If a similar output (seen above) is displayed the JAVA_HOME environment variable is already setup. To

    setup the JAVA_HOME environment variable add this line to the bottom of the /etc/environment file:

    JAVA_HOME="/usr/lib/jvm/java-6-sun"

    The CATALINA_OPTS environment variable should also be set to tell the Apache-Tomcat server to usemore than the default memory, to do this also add the following line to the bottom of the/etc/environment file:

    CATALINA_OPTS="-Xms256m -Xmx768m -XX:MaxPermSize=256m -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000"

    From now on every time the PC or server is started/restarted the JAVA_HOME and CATALINA_OPTSenvironment variables will be set automatically.

    Installing and Configuring MySQL 5.x Server

    Click here for guides forUbuntuandFedora.

    Deploying the Platform

    http://www.howtogeek.com/howto/ubuntu/install-mysql-server-5-on-ubuntu/http://www.howtogeek.com/howto/ubuntu/install-mysql-server-5-on-ubuntu/http://www.howtogeek.com/howto/ubuntu/install-mysql-server-5-on-ubuntu/http://fedorasolved.org/Members/opsec/installing-configuring-mysql-serverhttp://fedorasolved.org/Members/opsec/installing-configuring-mysql-serverhttp://fedorasolved.org/Members/opsec/installing-configuring-mysql-serverhttp://fedorasolved.org/Members/opsec/installing-configuring-mysql-serverhttp://www.howtogeek.com/howto/ubuntu/install-mysql-server-5-on-ubuntu/
  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    6/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    You are able to deploy the platform in many different ways but in this guide I will explain how to deploy itwith the packaged Apache-Tomcat server (comes with the Pentaho BI Server installation file) or with anexisting Apache-Tomcat server.

    Packaged Apache-Tomcat Server

    You will need to first download the pentaho-ce-3.7.x.stable.tar.gz file from thePentahoSourceforge projects page- this file contains all the files/packages needed for setting up our platform.After downloading extract its contents into a directory you would like to store the Pentaho BI Server - inthis example I have chosen /opt/pentaho/.

    To extract the file and move it the /opt/pentaho/ directory issue the following commands (seen inbold) at the terminal prompt:

    user@terminal:/home/pentaho/tmp/# sudo tar xvzf pentaho-ce-3.7.0.stable.tar.gzuser@terminal:/home/pentaho/tmp/# sudo mkdir /opt/pentahouser@terminal:/home/pentaho/tmp/# sudo mv ./biserver-ce /opt/pentaho

    user@terminal:/home/pentaho/tmp/# sudo mv ./administration-console/opt/pentaho

    The following directories should be visible after you have extracted the TAR file and moved its contents:

    opt/|-- pentaho| |-- adminstration-console| |-- biserver-ce

    Existing Apache-Tomcat Server

    If you would like to deploy the Pentaho BI Platform on an existing Apache-Tomcat server first extract thecontents of the pentaho-ce-3.7.x.stable.tar.gz file found on thePentaho Sourceforge projectspage. After downloading extract its contents into a directory you would like to store the Pentaho BI Server- in this example I have chosen /opt/pentaho/.

    To extract the file and move it the /opt/pentaho/ directory issue the following commands (seen inbold) at the terminal prompt:

    user@terminal:/home/pentaho/tmp/# sudo tar xvzf pentaho-ce-3.7.0.stable.tar.gzuser@terminal:/home/pentaho/tmp/# sudo mkdir /opt/pentahouser@terminal:/home/pentaho/tmp/# sudo mv ./biserver-ce /opt/pentahouser@terminal:/home/pentaho/tmp/# sudo mv ./administration-console/opt/pentaho

    The following directories should be visible after you have extracted the TAR file and moved its contents:

    opt/|-- pentaho| |-- adminstration-console| |-- biserver-ce| |-- pentaho-solutions| |-- tomcat| |-- common| `-- lib

    http://sourceforge.net/projects/pentaho/http://sourceforge.net/projects/pentaho/http://sourceforge.net/projects/pentaho/http://sourceforge.net/projects/pentaho/http://sourceforge.net/projects/pentaho/http://sourceforge.net/projects/pentaho/http://sourceforge.net/projects/pentaho/http://sourceforge.net/projects/pentaho/http://sourceforge.net/projects/pentaho/http://sourceforge.net/projects/pentaho/http://sourceforge.net/projects/pentaho/http://sourceforge.net/projects/pentaho/
  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    7/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    | `--mysql-connector-java-5.0.7.jar(optional)| |-- webapps| `--pentaho| `--pentaho-styles

    | `-- sw-stylesThe files and directories in bold (seen above) will need to be moved to your existing Apache-Tomcatinstallation.

    MySQL Java Connector

    If you already have Apache-Tomcat working with MySQL then you won't need to copy the mysql-connector-java-5.0.7.jar file to your tomcat's /common/lib directory. If not to copy the mysql-connector-java-5.0.7.jar issue the following command (in bold) at the terminal prompt:

    Ubuntuuser@terminal:~#/ sudo cp /opt/pentaho/biserver-ce/tomcat/common/lib/mysql-connector-java-5.0.7.jar

    /opt/tomcat/common/lib

    Fedorauser@terminal:~#/ su cp /opt/pentaho/biserver-ce/tomcat/common/lib/mysql-connector-java-5.0.7.jar/opt/tomcat/common/lib

    webapps

    You will need to copy all the directories under the /opt/pentaho/biserver-ce/tomcat/webapps/

    directory to the webapps/ directory under your existing Apache-Tomcat installation.

    To do so make sure you have stopped your Apache-Tomcat server then issue the following command (in

    bold) at the terminal prompt:

    Ubuntuuser@terminal:~#/ sudo cp /opt/pentaho/biserver-ce/tomcat/webapps/opt/tomcat/

    Fedorauser@terminal:~#/ su cp /opt/pentaho/biserver-ce/tomcat/webapps/opt/tomcat/

    Where /opt/tomcat/webapps/ is the location of your Apache-Tomcat webapps directory. You havejust moved all the webapps which are needed by the Pentaho BI Platform (sw-styles is optional).

    The last step is to move the pentaho-solutions directory into the /pentaho/ directory or any other location

    which you would like to store all your pentaho solutions and configuration files. To move the pentaho-solutions folder to the pentaho directory issue the following command (in bold) at the terminal prompt:

    Ubuntuuser@terminal:~#/ sudo mv /opt/pentaho/biserver-ce/pentaho-solutions/opt/pentaho/

    Fedora

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    8/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    user@terminal:~#/ su mv /opt/pentaho/biserver-ce/pentaho-solutions/opt/pentaho/

    One more step will need to be done to make sure Pentaho knows the new location of the pentaho-solutions directory which will be covered in the "Configuring Apache-Tomcat" section.

    The new structure of the pentaho-solutions and existing Apache-Tomcat directory looks like this:

    opt/| |-- pentaho| `-- pentaho-solutions| |-- tomcat| `-- webapps

    You can now safely remove any other files that came with the original Pentaho BI Platform (only underthe biserver-ce\ folder).

    SQL Script Pack

    A SQL Script Pack is a set off SQL scripts which will configure all the necessary databases. To downloadthe SQL Script Pack forMySQL 5.x clickhere.

    http://docs.google.com/leaf?id=0B9Jmocc0fj_EN2MyZjc4ZjEtNzFkNC00NzIzLTljZTctZjIzZWQ1NjU3MzJk&hl=enhttp://docs.google.com/leaf?id=0B9Jmocc0fj_EN2MyZjc4ZjEtNzFkNC00NzIzLTljZTctZjIzZWQ1NjU3MzJk&hl=enhttp://docs.google.com/leaf?id=0B9Jmocc0fj_EN2MyZjc4ZjEtNzFkNC00NzIzLTljZTctZjIzZWQ1NjU3MzJk&hl=enhttp://docs.google.com/leaf?id=0B9Jmocc0fj_EN2MyZjc4ZjEtNzFkNC00NzIzLTljZTctZjIzZWQ1NjU3MzJk&hl=en
  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    9/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Configuring the Databases

    Extract the MySQL 5.x SQL Script Pack

    After downloading the SQL Script Pack for MySQL 5.x you will need to extract the files into a temporarylocation. These are the five SQL scripts which should be visible after the pack has been extracted:

    1_create_repository_mysql.sql

    Creates the Hibernate database2_create_quartz_mysql.sql

    Creates the Quartz database3_create_sample_datasource_mysql.sql Loads the sample data data source into the Hibernate database

    4_load_sample_users_mysql.sql Creates all the sample users and roles into the Hibernate database

    5_sample_data_mysql.sqlCreates the sample data database

    You must load the above scripts in the order they are listed. Load these SQL scripts using yourfavourite MySQL front end tool i.e. MySQL console, Navicat Lite, phpMyAdmin etc (in this section I willshow you how to load the SQL scripts using the MySQL console).

    Load the SQL scripts

    Before you start make sure that you place all your SQL scripts in the directory which you will be logginginto the MySQL console, in this example that is /home/pentaho/tmp/.

    Launch a terminal instance and login into MySQL:

    user@terminal:/opt/biserver-ce/tmp# mysql -u [your_username] -p[your_password]

    Issue the following commands found in bold one after the other:

    mysql> source 1_create_repository_mysql.sql;...outputmysql> source 2_create_quartz_mysql.sql;...outputmysql> source 3_create_sample_datasource_mysql.sql;...outputmysql> source 4_load_sample_users_mysql.sql;

    ...output

    mysql> source 5_sample_data_mysql.sql;...output

    Now run the following command (in bold) to see if you have successfully created the hibernate,

    quartz and sampledata databases:

    mysql> show databases;Just for reference here are the databases and tables which should of been created after loading thecontents of the MySQL 5.x SQL Script pack:

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    10/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    hibernate* authorities datasource

    granted_authorities users

    quartz qrtz_blob_triggers qrtz_calendars qrtz_cron_triggers qrtz_fired_triggers qrtz_job_details qrtz_job_listeners qrtz_locks qrtz_paused_trigger_grps qrtz_scheduler_state qrtz_simple_triggers qrtz_trigger_listeners qrtz_triggers

    sampledata customer_w_ter customers department_managers dim_time employees offices orderdetails

    orderfact orders payments products quadrant_actuals trial_balance

    * Hibernate will create new tables into the hibernate database after Pentaho BI Platform has started for the first time.

    NOTE

    If you have problems when running the5_sample_data_mysql.sqlscripts with timestamps

    you will need to replace all occurances of00.000000000 with 00.000000- this is an issue withMySQL timezones and timestamps.

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    11/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Configuring JDBC Security

    This section describes how to configure the Pentaho BI Platform JDBC security to use a MySQL server,this means the Pentaho BI Platform will now point to the hibernate database on the MySQL server

    instead of the packaged HSQL database.

    NOTE

    If you already have a user which you prefer to have access to thehibernate database instead of

    the default userhibuser, you will need to modify all occurances ofhibuser/passwordin thissection.

    applicationContext-spring-security-jdbc.xml

    This file is located under the pentaho-solutions/system/ directory.

    Once the file has opened locate this snippet of code:

    Make changes to the highlighted sections so that the section of code looks similar to this:

    applicationContext-spring-security-hibernate.properties

    This file is located under the pentaho-solutions/system/ directory.

    Once the file has opened locate this snippet of code:

    jdbc.driver=org.hsqldb.jdbcDriver

    jdbc.url=jdbc:hsqldb:hsql://localhost:9001/hibernate jdbc.username=hibuserjdbc.password=password

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    12/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    hibernate.dialect=org.hibernate.dialect.HSQLDialect Make changes to the highlighted sections so that the section of code looks similar to this:

    jdbc.driver=com.mysql.jdbc.Driver

    jdbc.url=jdbc:mysql://localhost:3306/hibernate

    jdbc.username=hibuserjdbc.password=passwordhibernate.dialect=org.hibernate.dialect.MySQLDialect

    hibernate-settings.xml

    This file is located under the pentaho-solutions/system/hibernate/ directory.

    Once the file has opened locate this snippet of code:system/hibernate/hsql.hibernate.cfg.xml

    Make changes to the highlighted section so that the section of code looks similar to this:

    system/hibernate/mysql5.hibernate.cfg.xml

    mysql5.hibernate.cfg.xml (optional)

    This file is located under the pentaho-solutions/system/hibernate/ directory.

    You do not need to make any changes to this file if you would like to use the default user hibuser (which

    was created with the 4_load_sample_users_mysql.sql file). However, if you would like to specifyyour own user find and change the following two lines of code:

    hibuser

    passwordMake changes to the highlighted sections to a username and password of your choice.

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    13/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Configuring Hibernate and Quartz

    Hibernate and Quartz need to specifically use the hibernate and quartz databases which werecreated on the MySQL server. To do so modifications need to be made to the context.xml file which is

    located in the /tomcat/webapps/pentaho/META-INF/ directory.

    NOTE

    If you already have a user which you prefer to have access thehibernate database instead of

    the default userhibuser, you will need to modify all occurances ofhibuser/password in this

    section.This also applies to thepentaho_user/password used to connect to the Quartzdatabase.

    Once the file has opened the following piece of code should be visible:

    Make changes to the highlighted sections so that the section of code looks similar to this:

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    14/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    maxWait="10000" username="pentaho_user" password="password"driverClassName="com.mysql.jdbc.Driver"url="jdbc:mysql://localhost:3306/quartz"validationQuery="select 1"/>

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    15/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Configuring Apache-Tomcat Server

    To configure the settings of the Apache-Tomcat server for your Pentaho BI Platform most of the changesare done inside the web.xml file which is located under the /tomcat/webapps/pentaho/WEB_INF/

    directory. You are able to configure the following items (and more) for the Pentaho BI Platform:

    pentaho-solutions location URL Disable HSQL database startup TrustedIpAddrs (optional - for the administration console and if you are accessing the server

    remotely)

    If you are happy with the following settings for your Pentaho BI Platform server you will not need to makeany changes to this file:

    pentaho-solutions/ directory located under the /opt/biserver-ce/ directory Visithttp://localhost:8080/pentahoURL to launch the Pentaho BI Platform

    solution-path

    The solution-path parameter lets the Pentaho BI Platform know where to locatethe pentaho-solutions directory. By default this is set to /opt/biserver-

    ce/pentaho/ directory.

    If you have decided to use an existing Apache-Tomcat server (or have moved yourpentaho-

    solutions directory) you will need to point this to where you have placed yourpentaho-solutionsdirectory. In this example my pentaho-solutions directory is under the /opt/pentaho/ directory,now my solution-path code snippet looks like this:

    solution-path /opt/pentaho/pentaho-solutions/

    fully-qualified-server-url

    If you are happy with visiting the URLhttp://localhost:8080/pentahoto access Pentaho's BI Platform youwill not need to change this parameter, however if you would like others to access the site (remotely or on

    a network) you will need to make changes to this parameter.

    Open up the file and locate this line of code:http://localhost:8080/pentaho/

    Make changes to the highlighted section to your PC or server's domain or IP address so it looks similar tothis:

    http://www.prashantraju.com:8080/pentaho/ orhttp://192.168.1.10:8080/pentaho/

    http://localhost:8080/pentahohttp://localhost:8080/pentahohttp://localhost:8080/pentahohttp://localhost:8080/pentahohttp://localhost:8080/pentahohttp://localhost:8080/pentahohttp://localhost:8080/pentahohttp://localhost:8080/pentaho
  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    16/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Disable HSQL Database Startup

    By default with 3.7 HSQL database starts up automatically - to prevent this from happening locate thefollowing snippets of code:

    hsqldb-databases sampledata@../../data/hsqldb/sampledata,hibernate@../../data/hsqldb/hibernate,quartz@../../data/hsqldb/quartz

    org.pentaho.platform.web.http.context.HsqldbStartupListener

    You can either remove the above snippets or comment it out, if you are commenting it out it will looksimilar to this:

    TrustedIpAddrs

    If you want to access your Tomcat-Apache server remotely - so in the above step you have not specifiedlocalhost or127.0.0.1 for the base-url parameter - you will need to add your Tomcat-Apacheserver's IP address to this list.

    Open up the file and locate this line of code:

    TrustedIpAddrs 127.0.0.1

    Make changes to the highlighted section add your PC or server's domain or IP address so it looks similarto this:

    TrustedIpAddrs

    127.0.0.1,[your_ip_address]This will allow the Pentaho Administration Console to 'ping' the server to see if it is up or down - you donot need to do this if you are hosting your server locally.

    Other Parameters

    You can also change the local language and country under the web.xml file, the changes to theseparameters are self explanatory.

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    17/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    18/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Configuring SMTP (mail server)

    To configure the Pentaho BI Platform to use a SMTP server (mail server) to use for emailing reports etc.you will need to make modifications to the /pentaho-solutions/system/smtp-

    email/email_config.xml file.

    Here are the available parameters that can be configured for SMTP support:

    mail.smtp.host This is the address of your SMTP email server for sending email e.g. smtp.gmail.com

    mail.smtp.port This is the port of your SMTP email server e.g. for GMail this is 587

    mail.transport.protocol The transport for accessing the email server. Usually this is smtp e.g. for GMail this is

    smtps

    mail.smtp.starttls.enable

    If you SMTP server uses TTLS authentication set this to true e.g. for GMail this is true mail.smtp.auth

    Set to true if the email server requires the sender to authenticate mail.smtp.ssl

    This is true if the email server requires an SSL connection e.g. for GMail this is true mail.debug

    Output debug information from the JavaMail API mail.pop3

    Not being used. mail.from.default

    The from address that emails from the Pentaho BI Platform e.g. [email protected] mail.userid

    The userid that is used when authenticating with the SMTP server, mail.smtp.auth mustbe set to true.

    mail.password The password that is used when authenticating with the SMTP server, mail.smtp.auth must

    be set to true.

    Here is an example of a smtp-email.xml file configured for GMail:

    smtp.gmail.com587

    smtpstruetruetruefalse

    [email protected]@gmail.com

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    19/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    password

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    20/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Configuring Publishing

    By default publishing is not enabled, to enable it you will need to specify a password which will need to beused when publishing. To get started you will need to edit the publisher_config.xml file located

    under the /pentaho-solutions/system/ directory, once open locate the following snippet of code:

    Enter a password between the publisher-password tags (this password will be the same for all users)so the snippet of code looks similar to the example below (in this example the publisher password ispublishthis):

    publishthis

    From now on when any user tries to publish content to Pentaho BI Platform they will need to specify thispassword.

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    21/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Configuring the Administration Console

    By default no configuration is needed when setting up Pentaho's Administration Console (PAC) withMySQL 5.x.

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    22/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Starting the Business Intelligence Platform

    The Pentaho BI Platform is a webapp on the Apache-Tomcat server. To start Apache-Tomcat you willneed to run the startup.sh file which is located under the /opt/pentaho/biserver-

    ce/tomcat/bin folder:

    user@terminal:/opt/pentaho/biserver-ce/tomcat/bin# startup.shUsing CATALINA_BASE: /opt/pentaho/biserver-ce/tomcatUsing CATALINA_HOME: /opt/pentaho/biserver-ce/tomcatUsing CATALINA_TMPDIR: /opt/pentaho/biserver-ce/tomcat/tempUsing JRE_HOME: /usr/lib/jvm/java-6-sun

    Now you should be able to visithttp://localhost:8080/pentahoorhttp://[your_domain_or_ip]:8080/pentaho . If the Pentaho BI Platform has started successfullyyou should see the following welcome screen:

    http://localhost:8080/pentahohttp://localhost:8080/pentahohttp://localhost:8080/pentahohttp://localhost:8080/pentaho
  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    23/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    After logging in try and run a sample report from the Steel Wheels solution folder:

  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    24/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux

    Page 1 of 1

    Starting the Administration Console

    To start the Administration Console you will need to run the start-pac.sh file which is located underthe opt/pentaho/administration-console/ folder:

    user@terminal:/opt/pentaho/administration-console# start-pac.shDEBUG: Using JAVA_HOMEDEBUG: _PENTAHO_JAVA_HOME=/lib/jvm/java-6-sun/DEBUG: _PENTAHO_JAVA=/lib/jvm/java-6-sun/2010-01-05 16:27:17.824::INFO: Logging to STDERR viaorg.mortbay.log.StdErrLog05/01/2010 4:27:18 PM org.pentaho.pac.server.JettyServer startServerINFO: Console is starting2010-01-05 16:27:18.118::INFO: jetty-6.1.22010-01-05 16:27:38.672::INFO: Started SocketConnector @ 0.0.0.0:809905/01/2010 4:27:38 PM org.pentaho.pac.server.JettyServer startServerINFO: Console is now started. It can be accessed usinghttp://D119940:8099 or http://161.117.117.40:8099

    Now you should be able to visithttp://localhost:8099/or the other two address's specified in your output(highlighted above). You will be prompted for a Username and Password which by default are "admin"and "password". If you have successfully started and logged into the administration console you shouldsee the following welcome screen:

    http://localhost:8099/http://localhost:8099/http://localhost:8099/http://localhost:8099/
  • 7/31/2019 Pentaho 3.7.0 Linux and MySQL

    25/25

    Pentaho Business Intelligence Suite 3.7A guide to getting started with MySQL 5.x and Linux