Reassigning Host Integrator Port TCP Numbers

By default, the Verastream Host Integrator components use the following TCP port assignments. Click a link in the list for information on how to change the port.


Host Integrator Server 9623 - 9630
Log Manager 9640
AADS 9641
Administrative WebStation 9642
Host Emulator 9652
Script Manager 9653 - 9661
Host Integrator web server 8081
Emulated host ports 1090-1099, and 9670, 9671
Event handler java debug port 5005 (or an increment until an available port is found) for the Server version. The Design Tool debug port is 5006 (or an increment until an available port is found).


Changing the Port for Host Integrator Server, Log Manager,

AADS, and Script Manager

If you need to reassign the port numbers used by these Host Integrator components, do the following:

  1. Stop all Host Integrator services.
  2. Create a file named "vhibaseport.properties" and place it in the vhi/etc directory.
  3. Add the following entry to the vhibaseport.properties:

         vhibaseport=n
    
    where "n" is a valid TCP port number.


  4. Modify the port number.
  5. Restart all Host Integrator services.

Once you reassign the vhibaseport, the Host Integrator components will be assigned these TCP ports:

Component TCP Port Assignment
vhibaseport n
Session Server n -> n+16
Logging Utility n+17
AADS Server n+18
Script Manager n+30


Note: If you are using Windows, you must change the port assignments specified in the shortcuts for the Administrative WebStation and Host Emulator. To do so:
  1. Click Start, point to Programs > Attachmate Verastream> Host Integrator, then right-click Administrative WebStation and select Properties.
  2. In the Target box, change "9642" to the port number you reassigned the Administrative WebStation.
  3. Click OK.
  4. Repeat steps 1-3 above for the Host Emulator shortcut.

Note: In certain Java environments, your application may not have access to the vhi/etc/vhibaseport.properties file; In this case you can change the TCP port assignments using a system property from the command line or within your Java application. For example:

  -Dvhibaseport=n

Changing the Port for the Administrative WebStation

To change the tomcat port on a Windows machine for the Administrative WebStation, do the following:

  1. Navigate to the folder \vhi\lib\console\conf and open server.xml. Locate the following text:
  <Service name="Catalina">
       <Connector port="9642" />
  1. Change the string specifying the port (port="9642") to another port, such as 9675.
  2. Stop and restart the Administrative WebStation.

Changing the Port for Host Emulator

To change the tomcat port on a Windows machine for the Host Emulator, do the following:

  1. Navigate to the folder \vhi\lib\hostemul\conf and open server.xml. Locate the following text:
  <Service name="Catalina">
       <Connector port="9652" />
  1. Change the string specifying the port (port="9652") to another port, such as 9685.
  2. Stop and restart the Host Emulator.

Changing the Web Server Port

Port 8081, the default Host Integrator Web Server port, is known to be used by Network Associates' McAfee software (ePolicy Orchestrator "Agent Wake-Up Call" service). You must change either VHI or the McAfee product's configuration to avoid a port conflict.

To change the tomcat port on a Windows machine, do the following:

  1. Open the common.properties file in the <VHI install folder>\lib\webbuilder\common folder, and change this line to match the port number used by your Host Integrator Web Server: servletcontainerport=8081

  2. Navigate to the folder \vhi\tomcat\conf and open server.xml and locate the following text.
  3.     <!-- Define a non-SSL Coyote HTTP/1.1 Connector on port 8081 -->
    <Connector port="8081"
    maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
    enableLookups="false" redirectPort="8443" acceptCount="100"
    debug="0" connectionTimeout="60000"
    disableUploadTimeout="true" />
  4. Change the string specifying the port (port="8081") to another port, such as 8085.
    Note: You only need to change the first instance of port="8081" in server.xml. It's not necessary to change the second instance for proxy.
  5. Stop and restart the Web Server.

Changing Emulated Host Ports

Use Host Emulator Configuration (available from the Start menu) to modify model parameters.

Changing the Event Handler Java Debug Port

By default, the Design Tool or the Session Server starts searching at port 5005 for an available remote debugging port. You can change the starting point for locating an available port. You must restart the Server for the change to take effect.