Starting the BI Server At Boot Time On Linux

Skip to end of metadata
Go to start of metadata

You can start and stop the BI Server using the scripted commands start-pentaho.sh and stop-pentaho.sh which are located in /biserver-ce directory by default.  To have the BI Server start automatically during boot time, we need to modify these two scripts and create a startup script called pentaho.  All configurations here were tested on Ubuntu 8.10 64-bit.

When modifying start-pentaho.sh we need to accomplish two things.  First we need to make sure all directory changes are appropriate.  Second, we need to make sure to add an "&" at the end of the start_hypersonic.sh line.  If we forget to add an "&" sign at the end of the command, the system will run the script and wait for it to quit.  During boot we would like for the service to start via script and not hold the system up in any way. 

The following script assumes that BI Server is installed in /biserver-ce and that administrative-console is installed at /administration-console.

/biserver-ce/start-pentaho.sh should read as follows:

#!/bin/sh
### ====================================================================== ###
##                                                                          ##
##  Pentaho Start Script                                                    ##
##                                                                          ##
### ====================================================================== ###

if [ -e promptuser.sh ]; then
  sh promptuser.sh
  rm promptuser.sh
fi
if [ "$?" = 0 ]; then
  cd data
  sh start_hypersonic.sh &
  cd ..
  cd tomcat/bin
  export CATALINA_OPTS="-Xms256m -Xmx768m -XX:MaxPermSize=256m -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000"
  sh startup.sh
fi

Next, your /biserver-ce/stop-pentaho.sh should read as follows:

#!/bin/sh
### ====================================================================== ###
##                                                                          ##
##  Pentaho Stop Script                                                     ##
##                                                                          ##
### ====================================================================== ###

cd data
sh stop_hypersonic.sh &
cd ..
cd tomcat/bin
sh shutdown.sh






We will now go to create the appropriate startup script to start and stop the BI Server and administrative console in /etc/init.d

create a file called pentaho in /etc/init.d by typing the following:

sudo nano /etc/init.d/pentaho

Some of the fine points to notice about the script below is that in it we define the JAVA_HOME and JRE_HOME variables.  During boot we have no guarantees that any environment variables will have been set by the time our script runs.  We define them here so the BI Server will start.  According to the documentation for BI Server v2.x and BI Server 3.x-RCX Sun's Java 1.5 is the only reliable way to go. 

We add the following text to the file:

#!/bin/bash
### BEGIN INIT INFO
# Provides: start-pentaho stop-pentaho
# Required-Start: networking mysql
# Required-Stop: mysql
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Description: Pentaho BI Platform
### END INIT INFO
export JAVA_HOME="/usr/lib/jvm/java-1.5.0-sun"
export JRE_HOME="/usr/lib/jvm/java-1.5.0-sun/jre"

start(){
if [ "$1" == "adm" ];then
        echo "Iniciando aplicacao administration-console"
        cd ../administration-console
       ./start-pac.sh > /tmp/pentaho_console.out 2>&1 &

else
        echo "Iniciando aplicacao biserver"
        ./start-pentaho.sh > /tmp/pentaho.out 2>&1
fi

echo "ok"

}

stop(){
echo "recebi: $1"

if [ "$1" == "adm" ];then
        echo "Finalizando aplicacao administration-console"
        cd ../administration-console
        ./stop-pac.sh
else
        echo "Finalizando aplicacao biserver"
        ./stop-pentaho.sh
fi

echo "ok"
}


case "$1" in
start)
        start $2
        ;;
stop)
        stop $2
        ;;
*)
        printf "\nUsage: $0 \n
                start | stop            : Inicia ou finaliza a aplicacao biserver\n
                start adm | stop adm    : Inicia ou finaliza o administration console\n\n"
        ;;
esac
exit 0

Please note:

If you would like the scripts to run as a background task when the server starts up instead of launching in a terminal window, append an "&" to the end of the script name.  So, in the above code:

 cd /biserver-ce
/biserver-ce/start-pentaho.sh&
cd /administration-console
/administration-console/start.sh&




Now we need to make pentaho executable and add it to the startup and shutdown runlevels.

To make our new script executable by the system we run the following command

sudo chmod +x /etc/init.d/pentaho

Finally, we add the pentaho script to the system startup and shutdown runlevels by issuing the following command.

sudo update-rc.d pentaho defaults

The Pentaho BI Server, Sample Database (Hypersonic), and administration console will now start at boot time and shut down when the system restarts or stops.

Labels

biserver biserver Delete
start start Delete
automatically automatically Delete
boot boot Delete
ubuntu ubuntu Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Jun 08, 2010

    Pradesh Chanderpaul says:

    On some systems, you will use chkconfig instead of update-rc.d chkconfig penta...

    On some systems, you will use chkconfig instead of update-rc.d

    chkconfig pentaho on