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.
The default port offset value is 0.
Setting port offset for the server
There are two ways to set an offset to a port:
- Pass the port offset to the server during startup. The following command starts the server with the default port incremented by 3
:./wso2server.sh -DportOffset=3 - Set the Ports section of
<PRODUCT_HOME>/repository/conf/carbon.xmlas follows:<Offset>3</Offset>
Usually, when you offset the port of the server, all the ports used by the server are changed automatically. See the administration guide for the Carbon platform for information on all the ports available for all WSO2 products including WSO2 AS.