Citrix XML service port 8080 conflicting with Tomcat port

Concepts first: What is a Tomcat server?

“Apache Tomcat (or simply Tomcat, formerly also Jakarta Tomcat) is an open source web server and servlet container developed by the Apache Software Foundation (ASF). Tomcat implements the Java Servlet and the JavaServer Pages (JSP) specifications from Sun Microsystems, and provides a “pure Java” HTTP web server environment for Java code to run.” source: Wikipedia

As some of you know, if you have a XenApp server and you decide to install a Tomcat server in the same box (not a good idea by the way) you have a potential issue with sharing the Citrix ctxxmlss port 8080 with the TomCat Server. By default the xml port on a Xenapp server is port 80, but is quite common to change it to port 8080, specially if you are sharing the Web Interface with IIS in the same box. Also older versions of the Citrix licensing Servers use the Tomcat service in Port 8080, so a potential conflict can occur as well.

If that is the case, you need to change the Tomcat default port.

Excerpt from Java Revisited explains the process (note, normally Apache servers are installedin Unix or Linux boxes, so some of the information here only pertains to the Linux/Unix environments, but the overall idea is the same:

“Tomcat default port is 8080 but many times other Java application also uses 8080 like any other web-server Resin or Jetty and starting tomcat may result in already in use: JVM_Bind 8080. In order to avoid this exception you can change default port of tomcat from 8080 to some other port e.g. 8081 or 8082. Though don’t change to tomcat port which is likely to be used by tomcat itself e.g. 8443 is used by tomcat https port. Use port which is most likely to be free. In this tomcat tutorial we will see how to change default port 8080 for http protocol in tomcat and port 8443 port for https protocol in tomcat.
How to change Tomcat default port 8080
Step by step guide to change tomcat default port 8080
Here is step by step guide to change tomcat default port 8080

Step 1:
Find out tomcat server.xml its generally in “C:\Program Files\Apache Software Foundation\Tomcat\conf”. This is tomcat installation directory and could be different on your computer based on tomcat version. But important point is server.xml will be inside conf folder

Step 2:
Tomcat uses Connector element to specify port numbers, just locate the relevant Connector element in Server.xml which is configured to listening on port 8080. You can do this by using UNIX grep command on 8080 or simply find following text:

This Statement is saying that tomcat is listening on 8080 port.

Step 3:
Change default tomcat port from 8080 to 8081 or 8082 in Server.xml file of tomcat

Now tomcat will listen on Port 8082 instead of deafult port 8080.

4. save your changes on server.xml file and restart tomcat web server. It will start listening on port 8082 instead on default port 8080.

5. Type http://localhost:8082 in your browser you should see tomcat start-up page; it means your tomcat server is configured to listen http traffic on 8082 instead of default 8080.

How to change tomcat default port for SSL or https

Now you know how to change tomcat default port 8080 for http traffic you can also change default ssl port 8443 which is used by https protocol. Just find out relevant section of connector element using grep or find command and change the port from 8443 to 8553 or something else.

How to change default SHUTDOWN Port of Tomcat
Tomcat web server has a concept of SHUTDOWN port, this is the port on which tomcat web-server listen for SHUTDOWN signal. This is another cause of Address already in use: JVM_Bind:8005 because sometime other application also listens on same default SHUTDOWN port 8005.
Just like default tomcat port you can also change tomcat SHUTDOWN port and here is a step by step example

Step: 1 Find out SHUTDOWN Section in Server.xml
Use find or grep command to find word “SHUTDOWN” which will bring you to:

Now just change the SHUTDOWN port from 8005 to any other port you want.

Read more:”

More about Servlets:

“Jakarta Tomcat, an Open Source Servlet and JSP container, provides a simple (and free) environment for developing and testing Web applications. Tomcat is the reference implementation for the Servlet API and JSP. It’s not a high-performance Servlet engine, but it is a complete implementation of the Servlet API.

For developers accustomed to GUI-driven Windows applications, installing Tomcat can be frustrating. In this article, I’ll give you a step-by-step procedure to install and configure Tomcat on the Windows platform.

Java Servlets provide a framework for creating Web applications. Servlets are Java classes that use the Servlet API to accept a Request object from the browser and produce a Response object. For those of you familiar with Microsoft’s Active Server Pages (ASP) technology, Java Server Pages (JSP) are similar but they use compiled Java Servlets rather than an interpreted scripting language. Like ASP pages, JSP pages consist of code mixed with HTML. The JSP hosting engine, commonly referred to as a “JSP container,” converts the pages to a Servlet, then compiles and executes them.

The Tomcat engine is a Java program. Before you can run Tomcat, you must have the Java Development Kit (JDK) version 1.2 or later installed on your computer.”
source: by Piroz Mohseni of


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: