Skip to main content
Hitachi Vantara Lumada and Pentaho Documentation

Changing Ports and URLs


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. If you are unable to open these ports, or if you have port collisions with existing services, refer to Change Service Port Numbers for instructions on how to change them.

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" 
               redirectPort="9443" />
    <!-- A "Connector" using the shared thread pool-->
    <Connector URIEncoding="UTF-8" executor="tomcatThreadPool"
               port="9080" protocol="HTTP/1.1" 
               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. Open the /pentaho/server/data-integration-server/tomcat/webapps/pentaho-di/WEB-INF/web.xml file with a text editor.
  3. Modify the value of the fully-qualified-server-url element appropriately.
  4. Save and close the file.
  5. Start the DI Server.
The DI Server is now configured to reference itself at the specified URL.