Skip to main content
Pentaho Documentation

Starting BA Server on Linux

Overview

Modify the Tomcat Linux Startup Script

The Tomcat startup script must be modified to include the CATALINA_OPTS variable. CATALINA_OPTS indicates the amount of memory to allocate. It also indicates where Pentaho licenses are installed. 

  1. Make sure the Tomcat web application server is not running by opening a Terminal window and typing ps -A at the prompt. If the server is running, stop it.
  2. Use a text editor to open the startup.sh file, which is in the biserver-ee directory.
  3. Add the java option pentaho.installed.licenses.file to CATALINA_OPTS. You need to modify setting of
    CATALINA_OPTS variable at the end of the file by adding the java option.  See the following example.
export CATALINA_OPTS="-Xms4096m -Xmx6144m -XX:MaxPermSize=256m -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 -Dpentaho.installed.licenses.file=$PENTAHO_INSTALLED_LICENSE_PATH"
  1. Save and close the file.

Modifying the JBoss Linux Startup Script

  1. Make sure the JBoss web application server is not running by opening a Terminal window and typing ps -A at the prompt. If the server is running, stop it.
  2. Use a text editor to open the standalone.conf file. The file is located in the bin subdirectory of your JBoss home directory.
  3. Modify the Xms memory settings in the JAVA_OPTS line to be at least 4096 MB or more, if you have the resources and are concerned with performance. Change the Xmx value to at least 6144 MB.
  4. Add the following options to the JAVA_OPTS line: -Djava.awt.headless=true -Djava.io.tmpdir=/tmp/ -Dpentaho.installed.licenses.file=$PENTAHO_INSTALLED_LICENSE_PATH
    # Specify options to pass to the Java VM.
        if [ "x$JAVA_OPTS" = "x" ]; then
            JAVA_OPTS="-Xms4096m \
            -Xmx6144m \
            -XX:MaxPermSize=256m \
            -Dsun.rmi.dgc.client.gcInterval=3600000 \
            -Dsun.rmi.dgc.server.gcInterval=3600000 \
            <b>-Djava.awt.headless=true \
            -Djava.io.tmpdir=/tmp/ \
            -Dpentaho.installed.licenses.file=$PENTAHO_INSTALLED_LICENSE_PATH
    
    You may need to adjust these settings for your environment. For instance, if you do not have a /tmp/ directory, you may want to change that setting to /var/tmp/ or some other location.
  5. Save and close the file.

Start BA Server

  1. Run the startup script for your web application server by launching one these files.
    • Linux Tomcat: Launch the startup.sh file. The file is in the Tomcat bin directory.
    • Linux JBoss: Launch the standalone.sh file. The file is in the JBoss bin directory.
  2. Open a web browser and enter this URL: http://localhost:8080/pentaho. The User Console Log On window appears. Note that you will be prompted to install a license. Information on how to do that appears in the Set Up BA Server instructions.