Skip to main content
Pentaho Documentation

Changing Ports and URLs

Overview

Information related to the URL and Ports.

List of Server Ports Used by PDI

The port numbers below must be available internally on the machine that runs the DI Server. The only exception is SampleData, which is only for evaluation and demonstration purposes and is not necessary for production systems. 

Service Port Number
Data Integration Server 9080
H2 (SampleData) 9092
Embedded BA Server (Jetty) 10000

Change Service Port Numbers

DI Server (Tomcat)

Edit the /pentaho/server/data-integration-server/tomcat/conf/server.xml file and change the port numbers in the section shown below.

<!-- A "Connector" represents an endpoint by which requests are received
         and responses are returned. Documentation at :
         Java HTTP Connector: /docs/config/http.html (blocking & non-blocking)
         Java AJP  Connector: /docs/config/ajp.html
         APR (HTTP/AJP) Connector: /docs/apr.html
         Define a non-SSL HTTP/1.1 Connector on port 9080
    -->
    <Connector URIEncoding="UTF-8" port="9080" protocol="HTTP/1.1" 
               connectionTimeout="20000" 
               redirectPort="9443" />
    <!-- A "Connector" using the shared thread pool-->
    <!--
    <Connector URIEncoding="UTF-8" executor="tomcatThreadPool"
               port="9080" protocol="HTTP/1.1" 
               connectionTimeout="20000" 
               redirectPort="9443" />
Note: You may also have to change the SSL and SHUTDOWN ports in this file, depending on your configuration.

Next, follow the directions in Change the DI Server URL to accommodate for the new port number.

Embedded BA Server (Jetty)

This server port is hard-coded in Pentaho Data Integration and cannot be changed. If port 10000 is unavailable, the system will increment by 1 until an available port is found.

Change the DI Server URL

Explains how to change the DI Server URL.

You can change the DI Server hostname from localhost to a specific IP address, hostname, or domain name by following these instructions. This procedure is also a requirement if you are changing the DI Server port number.

  1. Stop the DI Server through your preferred means.
  2. Navigate to the /pentaho/server/data-integration/pentaho-solutions/system directory and open the server.properties file with any text editor.
  3. Modify the value of the fully-qualified-server-url element appropriately.
    fully-qualified-server-url=http://localhost:9080/pentaho-di/
    
  4. Save and close the file.
  5. Start the DI Server.
The DI Server is now configured to reference itself at the specified URL.

If you recently upgraded to Pentaho 6.0, you may need to remove the <context-param> entry for the fully-qualified-server-url from the /tomcat/webapps/pentaho/WEB-INF/web.xml. If so, restart the BA server after removing it.