Page History

...

Changing the default port numbers

INLINE

The ExcerptAs we briefly mentioned earlier, the <GERONIMO_HOME>/var/config/config-substitutions.properties file lets you specify a totally new set of ports as well as to and define an automatic port offset for when you run multiple servers (or instances of the same server). This file also allows you to set some cluster related parameters such as clusterName, clusterNodeName, etc. Visit the Clustering configuration for more details on how to configure a web application cluster in Geronimo

...

For example, an entry such as hostName=localhost can be overridden by an environment variable or system property org.apache.geronimo.config.substitution.hostName=foo.

Although this section is focusing on the changing these settings by updating a properties file, there is an alternative way by using the Geronimo Administration Console administrative console which is explained in more detail under the Configuring and administeringthe Web Container section. However, if you have port conflicts at start up time the Geronimo Administration Console administrative console will not be available, so we have to focus on configuring the config-substitutions.properties file by choosing a new PortOffset value (the default is 0).

The following example shows the config-substitutions.properties file for the Tomcat distribution of Geronimo. The file provided with the Jetty distribution is nearly identical. Changes to the file should be made when the server is stopped.

...

...

There are a number of reasons why you may might want to use other port numbers than those provided by default. Most common startup problems are in fact associated with port conflicts, you . You can use monitoring utilities like Active Ports that will quickly tell you what application /or process is using what port so you can customize Geronimo's ports accordingly. Of course On Unix-like platforms, you can always use something like netstat -nab nao | grep -i list to get the ports in use along with what application is holding that port. Alternatively, you can use netstat -nab on a Windows platform.