Upgrading Host Integrator in a Linux /UNIX Environment (5.5 to 6.0)

Note: This information applies to upgrades from two prior releases and is included for users migrating directly from version 5.5 to 6.5. You should also review the migration information specific to version 6.5.




If you are upgrading to Verastream Host Integrator 6.0, please read this section to understand how to upgrade your settings and files to in a Linux/UNIX environment. See also the general upgrade notes. For a list of new features, see What's New in Version 6.0.

Overview

In the Linux/UNIX environment, upgrading Host Integrator requires these steps.

  1. Back up the existing files.
  2. Remove the existing installation.
  3. Install all Host Integrator components except the Session Server
  4. Migrate the AADS settings.
  5. Install the Host Integrator Server
  6. Migrate the Administrative WebStation
  7. Migrate the deployment directory.
  8. Start all components and verify the upgrade.

The procedure below assumes the following.

Back up the existing files

  1. Log in as root on your Linux/UNIX machine. Back up the following files from the existing installation:
  2. Copy the usr/vhi/etc directory to a temporary directory. (In this example, the temporary directory is /tmp/vhi.)
     mkdir /tmp/vhi
     cp -r /usr/vhi/etc tmp/vhi
  1. If you are upgrading an Administrative WebStation, look for the console.install file in usr/vhi/lib/java. This file exists only if the Administrative WebStations was run locally in a browser on the machine where the Host Integrator server is installed. If console.install is present, then copy it to /tmp/vhi. If it is no present, skip this step.
  2. Copy the deploy directory, /usr/vhi/deploy, to a location outside of the existing Host Integrator installation directory, such as the following:
cp -r /usr/vhi/deploy tmp/vhi
  1. Before you uninstall the existing Host Integrator components, make a note of the current settings:

Remove the existing installation

Run the Verastream Host Integrator 6.0 setup to uninstall Host Integrator. Answer Yes when you are prompted to remove the existing Verastream Host Integrator Installation.

sh install.sh -clean

Install Host Integrator 6.0 Components except the Session Server

When upgrading in the Linux/UNIX, environment, the AADS must be installed and the AADS settings migrated before the Host Integrator server is installed.

  1. Install version 6.0 into the same directory where the previous version was installed. This example assumes usr/vhi.
  2. Use the command below to install all components except the server.
    sh install.sh -installdir /usr/vhi -components
    aads:apicpp:apijava:help:hostemul:logutils:smonitor:webstation

    The components specified in the command above are:

    aads		AADS server 
    apicpp     	AppConn Connector for C 
    apijava 	AppConn Connector  for Java 
    help 		Product Help 
    hostemul 	Host Emulator 
    logutils 	Log Viewer and Export Utility 
    smonitor 	Session Monitor 
    webstation	Administrative WebStation 
      
  3. Accept the defaults and proceed with the installation. When prompted, do not start the AADS.
  4. When Setup is complete, confirm that all of the components are stopped:
    /usr/vhi/bin/atstart/ -stop all 


Migrate the AADS Settings

  1. To preserve the AADS configuration, copy the saved files that you created above into the new installation directory.
    Note: Some of these files may not exist in your installation.
       cp /tmp/vhi/etc/aads/.bindings /usr/vhi/etc/aads
       cp /tmp/vhi/etc/aads.keystore /usr/vhi/etc/aads
       cp /tmp/vhi/etc/aads/aads.properties /usr vhi/etc/aads
       cp /tmp/vhi/etc/aads/domains/bindings /usr /vhi/etc/aads/domains
       cp /tmp/vhi/etc/aads/servers/bindings /use/vhi/etc/aads/servers
       cp /tmp/vhi/etc/aads/profiles/bindings /usr/vhi/etc/aads/profiles

Install the Host Integrator Server

  1. Start AADS before starting the server:

    /usr/vhi/atstart -start aads
    or
    /usr/vhi/atstart -start all
  2. To install the Verastream Host Integrator 6.0 server, use this command:

    sh install.sh –installdir /usr/vhi –components server 

  1. Do not start the server when prompted. If the server starts before the model files are migrated, errors will be logged.
  2. Restore the session server configuration file:
    cp /tmp/vhi/etc/sesssrvr.config /usr/vhi/etc
  3. If you did not install an Administrative WebStation, skip to Migrate the deployment directory.

Migrate the Administrative WebStation

  1. Restore the Administrative WebStation configuration file:
     cp /tmp/vhi/console.install /usr/vhi/lib/java/console.install
  1. Start the Administrative WebStation:
     /installdir/bin/atstart -start webstation


Migrate the deployment directory

Restore the deployment directory:

     cp -r /tmp/vhi/deploy  /usr/vhi

 

Start all components

  1. Use this command to start all components, including the Host Integrator server:
       /installdir/bin/atstart -start all
  2. At this point, the Host Integrator Server recognizes the original model file/directory structure and upgrade the models in the 6.0 deploy directory.
  3. Open the Administrative WebStation to confirm that your models are activated and confirm or restore the settings that you noted early in this process:


    Note: If you did not install an Administrative WebStation on the Linux/UNIX machine, you can use an Administrative WebStation on a different machine and point to the Linux/UNIX server.

Troubleshooting Upgrades

As of version 5.5, the Session Monitor creates a default security certificate when connecting. This certificate may still be present after uninstalling the previous version of Host Integrator and reinstalling the new version. After the upgrade, the Session Monitor will attempt to use a certificate that is now out of date. When attempting to connect, you'll see messages such as "SSL connection failed. Certificates don't match." To correct this problem, select Remove Directory Server from the Configure menu. You can ignore additional error messages while doing this operation. Next, select Add Directory Server to add it again with an appropriate security certificate.