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.
- 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.
- Use a text editor to open the startup.sh file, which is in the biserver-ee directory.
- 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"
- Save and close the file.
Modifying the JBoss Linux Startup Script
- 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.
- Use a text editor to open the standalone.conf file. The file is located in the bin subdirectory of your JBoss home directory.
- 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.
- 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. - Save and close the file.
Start BA Server
- 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.
- 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.