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. 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" 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.
- Open the /pentaho/server/data-integration-server/tomcat/webapps/pentaho-di/WEB-INF/web.xml file with a text editor.
- Modify the value of the fully-qualified-server-url element appropriately.
<context-param> <param-name>fully-qualified-server-url</param-name> <param-value>http://localhost:9080/pentaho-di/</param-value> </context-param>
- Save and close the file.
- Start the DI Server.