Question: How do we avoid a JBOSS port conflict between applications such as caArray and caTissue Suite?

Topic: caArray Installation and Upgrade

Release: caArray 2.x

Date entered: 07/13/2009

Details about the Question

After installing caTissue Suite (v1.1) on the same server that has geWorkbench, caGWAS, and caArray installed, caArray crashed.

Answer

The problem in question was due in part to conflicts between caTissue and caArray. This issue is not specific to caArray since other applications using JBoss server might have the same conflict with caTissue Suite. This conflict will arise only if the following two conditions are both met: (1) a user installs caArray or another caBIG® application first then installs caTissue; and (2) the user changes the ports for caTissue manually and one of the ports for caTissue was already used by caArray or the other caBIG® application.

How to avoid the port conflict

The following options could be helpful to avoid the potential port conflict among the different applications installed:

Option 1: Keep the default port settings of the applications

If a user kept the default setting of the ports regardless of the order of the installation, caTissue Suite and caArray would install without problems.

Option 2: Install caTissue first, change caTissue's default Port settings, and install caArray

The caArray installer can detect the port availability on the server. If the user needs to use different port numbers other than the ones picked by the caTissue installer, the user needs to first install caTissue, modify its default port settings, and then install the caArray application using a set of ports that are not used by caTissue.

Option 3: Use only the available port

If any port number has to be changed after the installation of both caArray and caTissue, the user will need to make sure to use a free port number by verifying the port availability.

How to check the port availability on the server?

The user may check the availability of a port number with the netstat command below:

• For a Linux/Unix/Mac environment:

  Code Block
  netstat --ano \| grep <<portNumber>>

  For example, use netstat --ano | grep <<portNumber>> for each required port (replacements for one or more of the following- 8080, 8009, 8443, 8083, 1099, 1098, 4444, 4445, 8093, 0, 1100, 1162, 3528, and 3529). If a process is listening to a customized port, choose another port and retry netstat until no conflict is returned. Use the final list of the customized ports to deploy caBIG tools.
• For a Windows environment, use the netstat command below to return all the port numbers that are already been used:

  Code Block
  netstat --ano

How to reconfigure the port number to solve the port conflict

The procedure below shows how to re-configure the JBoss 4.2.2.GA for caTissue 1.1 Suite from 3XXXX ports to 5XXXX ports to avoid collision with caArray 2.2.1:

...

A. InvokerURLSuffix from 38080 to 58080 for <attribute name="InvokerURLSuffix">:38080/invoker/EJBInvokerServlet</attribute>
B. InvokerURLSuffix from 38080 to 58080 for <attribute name="InvokerURLSuffix">:38080/invoker/JMXInvokerServlet</attribute>
C. InvokerURLSuffix from 38080 to 58080 for <attribute name="InvokerURLSuffix">:38080/invoker/readonly/JMXInvokerServlet</attribute>

Have a comment?

Please leave your comment in the caArray End User Forum.

...