Remote access

For security purposes, Pentaho is not accessible over the network by default. It is bound to the local machine (localhost), but you can opt to bind it to a network address to have it available externally.

Assume you have Pentaho installed on a system with address "myhost.example.com" and you want remote hosts to be able to access it (you can use an IP address instead).

web.xml

Firstly, you need to edit your web.xml file, normally found in ${pentaho}/jboss/server/default/deploy/pentaho.war/WEB-INF/

Find the section that looks like this:

<context-param>
    <param-name>base-url</param-name>
    <param-value>http://localhost:8080/pentaho/</param-value>
  </context-param>

Change it to look like this:

<context-param>
    <param-name>base-url</param-name>
    <param-value>http://myhost.example.com:8080/pentaho/</param-value>
  </context-param>

start-pentaho.sh

{pentaho}/start-pentaho.sh should be modified to bind JBoss on the desired address.

Find this part:

if [ "$?" = 0 ]; then
      cd jboss/bin
      sh run.sh
    fi

And modify it like so:

if [ "$?" = 0 ]; then
      cd jboss/bin
      sh run.sh -b 0.0.0.0
    fi

Using "0.0.0.0" will bind JBoss (Pentaho) to all local addresses. If you prefer, you can instead use a specific address (e.g. myhost.example.com, 192.168.0.10).

stop-pentaho.sh

A similar change must be made to the Pentaho stop script. It is located at ${pentaho}/stop-pentaho.sh

Find this part:

cd jboss/bin
./shutdown.sh -S

Change it to this:

cd jboss/bin
./shutdown.sh -S -s myhost.example.com

Resources

• http://wiki.pentaho.com/display/PentahoDoc/Deployment+Configuration
• http://www.csoft.net/docs/jboss.html
• http://wiki.jboss.org/wiki/JBossRunParameters