The Pre-Configured Install is designed to run standalone on a single machine using http://localhost:8080/pentaho as the base URL. If you do not need access to the server from other computers, you can skip the "Running as a server" step.
Running as a server
To allow other computers to access the Pentaho BI Platform, the base URL must be set in the
- Locate the
web.xmlfile, its default location is:
web.xmlin an XML or text editor.
- Set the
param-valueof the context parameter
base-urlwith the URL for the server. The URL should have the DNS Name or IP address of the machine, the port default
8080and the context
pentaho. If you want to change the port that the server uses, see the Advanced Install Guide.
The final result should look like:
Beginning with Pentaho BI Server 1.6-RC2 and later, an extra step is required in order to access the server from other hosts. Set the JBoss bind address by editing
sh). Add the
-b parameter. More documentation for this parameter can be found on the JBoss wiki.
Or you could also add the -D parameter: in the above snippets, replace the "-b myserver.pentaho.org" for "-Djboss.bind.address=YOUR.IP.GOES.HERE". This will change JBoss binding address and you will need to edit only web.xml to point to the same IP. However, this is a quick & dirty fix, for it breaks the shutdown scripts. As you can simply kill the server, it might help when a fast fix is needed to help things get going.
If you added the
-b parameter to
start-pentaho.(bat|sh), you'll also need to make the following modification to