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" />
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.
- Stop the DI Server through your preferred means.
- Navigate to the /pentaho/server/data-integration/pentaho-solutions/system directory and open the server.properties file with any text editor.
- Modify the value of the fully-qualified-server-url element appropriately.
fully-qualified-server-url=http://localhost:9080/pentaho-di/
- Save and close the file.
- Start the DI Server.
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.