Upgrading from Host Integrator 6.0 to 6.5

If you are upgrading to Verastream Host Integrator 6.5 from 6.0, please read this section fully to understand how to upgrade your settings and files to version 6.5. See What's New in Version 6.5 for a list of new features. See Linux/UNIX upgrade notes if you have Host Integrator servers for these platforms.

Although the Setup program will detect and save your current configuration, and migrate its settings to version 6.5, always review your configuration after upgrading to verify that the migration was successful.

Upgrading from 5.5

These instructions also apply if you are upgrading from Host Integrator version 5.5 to version 6.5. See the following topics for additional details related to this upgrade path:

What's New in Version 6.0

Upgrading from Version 5.5 to version 6.0

Upgrade Sequence

Upgrade your components in this order:

  1. Authentication, Administration, and Directory Services (AADS)
  2. Administrative WebStation
  3. Host Integrator Session Servers
  4. Host application models
  5. Client applications

Review these upgrade issues:

Component Migration

This section briefly describes each component and explains how to migrate its settings to Host Integrator version 6.5.

Upgrading AADS, Administrative WebStations, and Host Integrator Servers

Under Windows, the Setup program will detect the presence of AADS, Host Integrator Session Servers, and Administrative WebStations and offer to backup the configuration information. To upgrade Host Integrator AADS and Servers from version 6.0 to 6.5 under Windows, follow the steps below. The instructions for upgrading Linux/UNIX components include additional steps for this release.


To upgrade AADS and Host Integrator Session Servers on a Windows system:

  1. Log in to Windows with Administrative privileges and close all running applications.

  2. Insert the Host Integrator product CD into your CD-ROM drive or locate your e-delivery folder.
  3. If you are uninstalling from another machine on the network and using the CD, you must map a drive to the Host Integrator product CD.

  4. To start the Setup program, click Run on the Start menu, type or browse to the path to the installation program (for example, D:\Setup.exe), and then click OK.
  5. The Setup program evaluates your system for the presence of any 6.0 components and lists these in the Legacy Component Migration dialog box. Click Next.

  6. Select the components whose settings files will be backed up and migrated to version 6.5 and then click Next.

  7. Select a backup directory where the settings files to be migrated will be saved and then click Next.

  8. Save the settings files for the components you selected and then click Exit.

  9. Use Add/Remove Programs from the Control Panel to uninstall Verastream Host Integrator version 6.0.

  10. Install Verastream Host Integrator version 6.5.
  11. For each group of 6.0 settings that you selected to upgrade, the Host Integrator 6.5 Setup program will detect the presence of the backed up files and ask if you want to restore the settings for your 6.5 installation. Follow the prompts.

    Any model you open and save in the Design Tool will be automatically upgraded to 6.5. Deployed models from earlier versions will also continue to function after the Host Integrator server is upgraded to 6.5.

Web Builder Projects

You can maintain projects created in earlier versions of Web Builder. Some earlier options are no longer available for creating new projects. Instead of .NET and Java procedure-based or screen-based Web applications, you can create .NET or Java Web applications that incorporate the functionality of screen-based or procedure-based project types.

.NET 1.1 Projects

Verastream Host Integrator now supports projects using a .NET 2.0 framework. If you have a project created with a .NET 1.1 and Visual Studio version 2003, you can continue to build and deploy it.

.NET Error Message "Type Library not registered"

If you have an existing .NET project (such as C# Web service) used with a prior version of Verastream AppConn for COM (appconn.dll), after upgrading to version 6.5, the Microsoft Visual Studio .NET development environment may show the appconnlib reference is invalid and/or the type library is not registered (even though no runtime incompatibility occurs with the 6.0 connector used with a 6.5 server). To allow your project to re-compile, delete the invalid reference and re-add the COM reference to appconncom.dll (now named Attachmate Verastream Host Integrator 6.5 in the list of COM libraries).

Web Builder and _HIDE, _SHOW model strings

In previous versions, Web Builder used the naming convention of _SHOW or _HIDE appended to rejuvenation (screen-based) models with attributes, recordsets, or procedures to control the display of these elements. These naming conventions are no longer applicable. In version 6.5, you can control the display of these elelments by selecting that option on the Project Properties dialog box in Web Builder. You can continue to use existing models.

New Settings and Requirements

Compatibility Settings for Previous Versions

When you open a model created in an earlier version of the Design Tool, you'll see the following message, "This model was created with a prior version of the Verastream Host Integrator." The compatibility settings described below are enabled to allow your models to maintain the same behavior as they had in an earlier version of Host Integrator.

Review the compatibility settings and consider disabling these settings in order to take full advantage of current product functionality. In most cases, you will not see any changes in the behavior of your model. If you notice a change, use the guidelines included in the settings descriptions to make any necessary modifications. You can also re-enable a compatibility setting at any time. To view compatibility settings, select View Settings from the Settings menu, then open the Compatibility category.