Upgrading Host Integrator in a Linux /UNIX Environment

This section provides information and instructions on how to upgrade your settings and files to Verastream Host Integrator 6.5 in a Linux/UNIX environment.

See also the general upgrade notes. For a list of new features, see What's New in Version 6.5.


Note: These instructions cover the upgrade from version 6.0 to 6.5. To upgrade from 5.5, see the previous version's upgrade instructions.

Overview

To upgrade in a Linux/UNIX environment,follow 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 from the 6.0 installation

  1. Log in as root on your Linux/UNIX machine.

  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. To upgrade an Administrative WebStation:
  2. Copy the deploy directory, /usr/vhi/deploy, to a location outside of the existing Host Integrator installation directory:
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.5 setup to uninstall Host Integrator. When prompted, choose Yes to remove the existing Verastream Host Integrator Installation.

sh install.sh -clean

Install Host Integrator 6.5 Components except the Session Server

In a Linux/UNIX, environment, you must install the AADS and migrate the AADS settings before you install the Host Integrator server.

  1. Install version 6.5 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

    Where:

    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:
    /<installdir>/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/.cert.fingerprint/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/bin/atstart -start aads
    or
    /usr/vhi/bin/atstart -start all

  2. Use this command to install the Verastream Host Integrator 6.5 server:

    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:
  2. /usr/vhi/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:
       /usr/vhi/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.5 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

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.