Verastream Host Integrator Web Builder Port Conflict

Verastream Host Integrator Web Builder Port Conflict
Technical Note 10039
Last Reviewed 11-Sep-2008
Applies To
Verastream Host Integrator version 5.5 or higher
Summary

This technical note explains how to identify and resolve port conflicts with the Verastream Host Integrator (VHI) Web Server (used by Web Builder in the Development Kit).

Symptoms

You may have a port conflict if any of the following symptoms occur:

The VHI Web Server service fails to start. (The operating system shows the service is not started, even though you have attempted to start it.)
In the <VHI install path>\tomcat\logs directory, the file catalina_log.<date>.txt contains the text:

Error creating server socket: java.net.BindException: Address already in use

When you build your web project with VHI Web Builder, you see java.io.FileNotFoundException errors, such as the following sample:

Retrieving model metadata from VHI
Writing project description file
Generating JavaBeans source code
Compiling JavaBeans source code
Creating JavaBeans jar file
Building web application
Building web application configuration
Deploying web application
Error communicating with app server
java.io.FileNotFoundException: http://localhost:8081/manager/remo
ve?path=/sewCICSAcctsDemo
    at sun.net.www.protocol.http.HttpURLConnection.getInputStream(
    Unknown Source)
    at com.wrq.vhi.builder.process.TomcatManager.sendCmd(TomcatMan
    ager.java:429)
    at com.wrq.vhi.builder.process.TomcatManager.remove(TomcatMana
    ger.java:245)
    at com.wrq.vhi.builder.Main.deploy(Main.java:180)
    at com.wrq.vhi.builder.Main.process(Main.java:123)
    at com.wrq.vhi.builder.ui.Worker.run(StatusDialog.java:286)
    at java.lang.Thread.run(Unknown Source)
Error communicating with app server
java.io.FileNotFoundException: http://localhost:8081/manager/inst
all?path=/sewCICSAcctsDemo&war=file:C%3A%5CProgram+Files%5CVHI%5C
lib%5Cbuilder%5C..%5C..%5Ctomcat%5Cwebapps%5CsewCICSAcctsDemo
    at sun.net.www.protocol.http.HttpURLConnection.getInputStream(
    Unknown Source)
    at com.wrq.vhi.builder.process.TomcatManager.sendCmd(TomcatMan
    ager.java:429)
    at com.wrq.vhi.builder.process.TomcatManager.install(TomcatMan
    ager.java:239)
    at com.wrq.vhi.builder.Main.deploy(Main.java:184)
    at com.wrq.vhi.builder.Main.process(Main.java:123)
    at com.wrq.vhi.builder.ui.Worker.run(StatusDialog.java:286)
    at java.lang.Thread.run(Unknown Source)
Precompiling JSP's
Finished

When you attempt to run your web project created with VHI Web Builder, you see a 404 file not found error message.
When you open http://localhost:8081 (or http://<hostname>:8081 if VHI is installed on a different system), you see a non-Tomcat welcome page. You should see a welcome page similar to the following (Tomcat version varies depending on the VHI version installed):

Figure 1—Tomcat welcome page

Explanation

VHI installs an instance of the Apache Jakarta Tomcat web server, which is configured to run at TCP port 8081 by default. Java projects created with VHI Web Builder run under the Tomcat servlet runner.

There can, however, be other software already running at this port. For example, Network Associates' McAfee software (for anti-virus and network security) runs a web server on port 8081 by default for its "Agent Wake-Up Call" service.

If port 8081 is already in use, the VHI Web Server is not able to start. When attempting to deploy or run a web project, the URL file path is not found in the web server used by the third-party software, resulting in a "file not found" error.

Recommended Solution

Use the following steps to change the VHI Web Server port 8081 to a different unused port number. (In the steps below, nnnn represents an unused port number.)

In the <VHI install path>\lib\webbuilder\common directory, open the common.properties file in a text editor. Change the following line to an unused port number:

servletcontainerport=nnnn

In the <VHI install path>\tomcat\conf directory, open the server.xml file in a text editor.

Version 6.0 or higher: Locate the following lines and change the port= value to the unused port number:


<Connector port="nnnn" maxThreads="150" minSpareThreads="25"
    maxSpareThreads="75" enableLookups="false" redirectPort="8443"
    acceptCount="100" debug="0" connectionTimeout="60000"
    disableUploadTimeout="true" />

Version 5.5: Locate the following lines and change the port= value to the unused port number:


<Connector className="org.apache.catalina.connector.http.HttpConnector"
    port="nnnn" minProcessors="5" maxProcessors="75"
    enableLookups="true" redirectPort="8443"
    acceptCount="10" debug="0" connectionTimeout="60000"/>

Note: Only the first (non-proxy) "port=" instance needs to be changed.

Restart the VHI Web Server.

Version 6.5 or higher: click Start > Programs > Attachmate Verastream > Host Integrator > Services > Web Server > Restart Web Server.

Version 6.0: click Start > Programs > AttachmateWRQ Verastream > Host Integrator > Services > Web Server > Restart Web Server.

Version 5.5: click Start > Programs > WRQ Verastream > Host Integrator > Services > Web Server > Restart Web Server.

Alternative Solution

An alternative solution is to change the port number used by your other software. Refer to the documentation for your third-party software.

10004	Manually Starting and Stopping VHI Services
40012	Ports Used by Verastream Host Integrator
40999	Verastream Host Integrator Technical Notes

Did this technical note answer your question?

Need further help? For technical support, please contact Support.

Home » Support » Solution Library
Technical Notes

Technical Notes

Symptoms

Explanation

Recommended Solution

Alternative Solution

Did this technical note answer your question?

Additional comments about this tech note: