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. The default HTTP and HTTPS ports (without offset) of a WSO2 product are 9763 and 9443 respectively. 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 is 0.
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
- Set the Ports section of
<PRODUCT_HOME>/repository/conf/carbon.xml as follows:
Usually, when you offset the port of the server, all ports it uses are changed automatically. However, there are few exceptions as follows in which you have to change the ports manually according to the offset as described below.
Changing the ports in the SSO IDP configuration
After applying a port offset update the port values accordingly in all instances of the value of the
> element in the
<GREG_HOME>/repository/conf/identity/sso-idp-config.xml file as shown in the below example configuration which is applicable if you set a port offset of 3