Changing the Default Ports¶
When you run multiple WSO2 products, multiple instances of the same product, or multiple WSO2 product clusters on the same server or virtual machines (VMs), you must change their default ports with an offset value to avoid port conflicts. Port offset defines the number by which all ports defined in the runtime such as the HTTP/S ports will be changed. For example, if the default HTTP port is 9763 and the port offset is 1, the effective HTTP port will change to 9764. For each additional WSO2 product instance, you set the port offset to a unique value.
Setting a port offset¶
The default port offset value is 10. There are two ways to set an offset to a port:
- Pass the port offset to the server during startup. The following
command (on MacOS) starts the server with the default port incremented by 3:
deployment.tomlfile (stored in the
<MI_HOME>/confdirectory) and add the port offset as follows:
[server] offset = 3
When you set the server-level port offset as shown above, all the ports used by the server will change automatically.
Default Ports of WSO2 Micro Integrator¶
This page describes the default ports that are used for WSO2 Micro Integrator when the port offset is 0.
Passthrough transport ports¶
Listed below are the default ports that are used in WSO2 Micro Integrator when the port offset is 10.
- 8290: HTTP Passthrough transport
- 8253: HTTPS Passthrough transport
Management API port¶
The Management API of WSO2 Micro Integrator is an internal REST API, which is used to obtain administrative information of the server instance. The default port of the Management API used in WSO2 Micro Integrator when the port offset is 10:
- 9164: HTTPS Internal API port
The Management API port can be configured in the
deployment.toml file (stored in the
<MI_HOME>/conf directory) as shown below.
[mediation] internal_http_api_enable = true internal_https_api_port = 9154
Certain ports are randomly opened during server startup. This is due to specific properties and configurations that become effective when the product is started. Note that the IDs of these random ports will change every time the server is started.
- A random TCP port will open during server startup because of the
-Dcom.sun.management.jmxremoteproperty set in the server startup script. This property is used for the JMX monitoring facility in JVM.
- A random UDP port is opened at server startup due to the log4j
SyslogAppender), which is configured in the