Changing Host Integrator Port TCP Numbers

NOTE:   See Host Integrator Port TCP Numbers for the default port number assignments used by Host Integrator components.

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 to the vhibaseport.properties file: 
         vhibaseport=n
    where "n" is a valid TCP port number.


  4. Modify the port number.

  5. Restart all Host Integrator services.

After you reassign the VHI base port, the Host Integrator components are 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

If you are using Windows...

You must change the port assignments specified in the shortcuts for the Administrative WebStation and Host Emulator.

  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 and click OK.

  3. Repeat steps 1-3 above for the Host Emulator shortcut.

In some Java environments...

Your application may not have access to the vhi/etc/vhibaseport.properties file. If this is the 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:

  1. Open the folder \vhi\lib\console\conf.

  2. Open server.xml
    3. and locate the following text:
    <Service name="Catalina">
    <Connector port="9642" />
  3. Change the port number (port="9642") to another valid port, such as 9675.

  4. 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:

  1. Open the folder \vhi\lib\hostemul\conf.

  2. Open server.xml
    3. and locate the following text:
    <Service name="Catalina">
    <Connector port="9652" />
  3. Change the port number (port="9652") to another valid port, such as 9685.

  4. Stop and restart the Host Emulator.

Changing the Web Server Port

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

To change the Tomcat port on a Windows machine:

  1. In the <VHI install folder>\lib\webbuilder\common directory, open common.properties.

  2. Change this line to match the port number used by your Host Integrator Web Server: servletcontainerport=8081

  3. Navigate to the folder \vhi\tomcat\conf, open server.xml and locate: 
        <!-- 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 port (port="8081") to another valid 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.

 

 

 

 

  Attachmate