Running Railo/Tomcat alongside an existing Tomcat/Apache server

The application service behind Intranet Connections is Railo/Tomcat and is installed using the default values for the connection ports. If those ports are already in use by another application service such as a standalone Tomcat/Apache instance, the Railo service will fail to start or serve properly, resulting in the intranet site not working. The error would be something like the following:


The default ports that Railo/Tomcat uses are: 8005, 8009, 8888 and 8443.

To see if these ports are in use on your server, you can use netstat to see which ports are open and listening for which processes.  Simply run the following command in a command prompt window:

netstat -aon | more


In the example above you can see the machine is actively listening on ports 8005, 8009, and 8888.  You can see the process ID and then using Task Manager identify what process has these ports open:


If you find that you have conflict, please follow these steps to remedy the situation:

1) Stop the Railo Service

Make sure that Railo has been stopped:

  1. Open the start menu
  2. Search for services.msc
  3. Find and stop the Railo Server if it's running

2) Update Railo Tomcat Ports

Navigate to the Railo Tomcat configuration folder which by default is under "C:\railo\tomcat\conf".

After making a copy/backup of the "server.xml" file, open it in a text editor and change the "port" and "redirectPort" attributes in the following elements to open ports (you can possibly change the 8xxx to 9xxx after making sure those ports are not in use by another process, e.g. change 8005 to 9005 and 8443 to 9443):

  • <Server port="8005" shutdown="SHUTDOWN">
  • <Connector port="8888" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />

  • <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

To check which ports are currently in use

3) Update the Boncode AJP Port

Once you've finished updating the Railo/Tomcat ports, you need to update the associated Boncode AJP port to use the same port that you configured for the "AJP/1.3" protocol (8009 by default) in "server.xml".

To do so, navigate to "C:\Windows", open the "BonCodeAJP13.settings" file in a text editor, and update the "Port" value.

4) Start the Railo Service

To start the Railo service:

  1. Open the start menu
  2. Search for services.msc
  3. Find and start Railo Server
Have more questions? Submit a request


Article is closed for comments.