Upgrading Host Integrator from 6.x to 7.x on UNIX/Linux

This technical note provides detailed steps to migrate Verastream Host Integrator (VHI) from version 6.x to version 7.0 or higher on a Linux, Solaris, or AIX system. The upgrade process includes backing up files, removing the existing installation, installing version 7.x, migrating the existing configurations and host application models, and migrating Web Builder projects.

Note: If you already have version 7.0 installed and are upgrading to version 7.1, see KB 7021582 instead. If you already have version 7.1 installed and are upgrading to version 7.1.1142 (Service Pack 1) or higher, see KB 7021586 instead.

Use the following procedure to upgrade Verastream Host Integrator (version 6.5 or 6.6) to version 7.0 or higher on a Linux, Solaris, or AIX system. Note: If you are using Java web service or web application projects generated in Web Builder, see also Web Project Migration.

1. Make a note of your existing installation directory:

2. Log into Administrative WebStation:
   1. In a web browser, open <vhi>/bin/VHI_Administrative_WebStation_Login.html on the local system, or http://<hostname>:9642/apptrieve from a remote system.
   2. Log in as a user in the Administrator profile if security is enabled; otherwise use blank credentials.
3. Make a note of any non-default configuration for the following items. Since custom security and LDAP settings are not migrated, you will need to manually restore them later (in step 11c below).

Location in Left Navigation Tree	Default Value
Security > Profiles > Administrator > Actual Group	***** NONE *****
Security > Profiles > Developer > Actual Group	***** NONE *****
Security > Profiles > User > Actual Group	***** NONE *****
Security > Domains	Security is unchecked
Security > Servers	Security is unchecked
Directory Services > LdapAuthentication	Enabled is unchecked
Servers > [server name] > Server Configuration > Server Properties	Model Debug Messages Directory is <vhi>/etc/reports
Servers > [server name] > Server Configuration > Logging Options	Log Storage Directory is <vhi>/etc/logs/server

4. Back up your existing files
   1. Create a temporary directory:

2. Copy the existing deployed models (including any event handler code):

3. Copy the directory containing session server configuration file, plus model debug messages and session server log (in default locations):

4. If you are using SSL encryption for host connections, and the host requires a client certificate, back up your certificate.pem file:

5. Uninstall the previous version:

6. Install version 7.x by expanding the downloaded .tar file (with tar xvf) and/or running the installer file (for example, sh linux/vhisrv-7.1.1142-prod-linux).

7. After installation completes, stop the Host Integrator services:

8. Migrate the files backed up in step 4 above:
   1. Copy the deployed models and session server configuration:

2. Copy the model debug messages and session server log (if you were using the default locations as identified in step 3 above):

3. If you are using SSL encryption for host connections, and the host requires a client certificate, copy your certificate.pem file:

9. Using a text editor, carefully edit the sesssrvr.config file in your /opt/attachmate/verastream/hostintegrator/etc directory. If your Model Debug Messages Directory and/or Log Storage Directory were in default locations, change lines referencing the old version 6.x directory to the new version 7.x directory.

10. Start the Host Integrator services:

11. Restore previous settings and verify successful migration:
    1. Run Administrative Console.

2. Connect to the management server and log in with the user name “admin” and the administrative password created during installation (step 6).
3. Restore any custom security and LDAP settings that were noted in step 3.

Configuration Item	Location in Administrative Console
Local groups for security profile authentication	Management > Directories > Properties > Enable OS Groups
LDAP directory for security profile authentication	Management > Directories > Add Directory
Administrator security profile	Management > Authorization > Administrator > Add Members
Developer security profile	Management > Authorization > Developer > Add Members
User security profile	Management > Authorization > User > Add Members
Session server security	Host Integrator > Session Server Explorer > Servers > [server name] > Properties > General > Security > Enable Security

Note: For information about compatibility settings for VHI, see the "Compatibility Settings for Host Integrator Upgrades" topic in the VHI User Guide. For example, in VHI 7.6, see http://docs2.attachmate.com/verastream/vhi/7.6sp1/en/topic/com.attachmate.vhi.help/html/reference/compatibility_switches.xhtml.

Web Project Migration

Server Kit versions 7.0 through 7.1.2026 do not include Apache Tomcat and Axis. If you previously generated a Java web service project (or Java web application project) with Web Builder and deployed it to your Linux/UNIX system, choose one of the following alternatives:

• Modify your applications to reference the new automatic web service functionality embedded in the session server. This option is recommended due to significant enhancements, such as no longer needing to re-generate and re-deploy projects after model changes.

-OR-

• Upgrade to Server Kit version 7.5, which does include VHI Web Server for HTML5 and Java applications generated in Web Builder.

-OR-

• Install your own separate instance of Tomcat and Axis, and then re-deploy your project.

Legacy KB ID

This article was originally published as Attachmate Technical Note 10094.