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 your components in this order:
Review these upgrade issues:
This section briefly describes each component and explains how to migrate its settings to Host Integrator version 6.5.
You must upgrade your AADSs to version 6.5 before you install Host Integrator 6.5 Administrative WebStations or servers. The Host Integrator 6.5 Setup program can detect the presence of a 6.0 AADS and back up and upgrade its configuration to AADS 6.5. More Information...
Upgrade your Administrative WebStations after you upgrade AADS. Because the Administrative WebStation is not compatible with an AADS of a different version, you should keep at least one 6.0 version of the Administrative WebStation if you plan to keep a 6.0 AADS. The Host Integrator 6.5 Setup program can detect the presence of version 6.0 Administrative WebStations and back up and upgrade its configuration to version 6.5. More Information...
Upgrade your Host Integrator Session Servers to version 6.5 after you upgrade your AADSs and Administrative WebStations. The Host Integrator 6.5 Setup program can detect the presence of 6.0 servers and back up and upgrade their configurations to version 6.5. More Information...
Your deployed 6.0 models will continue to function on a 6.5 Session Server. No manual upgrade is required.
To upgrade a model, open and save a 6.0 model in the Design Tool. Once you convert a model file to version 6.5, it can no longer be loaded on a 6.0 server. Save the model only after you have verified that it behaves as you expect. For example, in certain cases it may be necessary to delete a pattern and re-add it. You should also verify that other aspects of the model, such as operations, recordsets, and procedures, behave correctly before you save the model.
Changes in Host Integrator that could affect your model upgrade are disabled in a series of compatibility settings. More information...
It is recommended that you install the new AppConn connector files on machines running client applications. You may be able to continue to use the old connector; however, if you see an "Undefined error message," this indicates that a connector upgrade is required. The error message may also include an error number that can provide further information. Open the error messages topic and look for the listed error number.
If you install the 6.5 AppConn connector on machines running client applications, allow the Setup program to complete the installation and create registry entries (if necessary). In general, your current client applications will work seamlessly with 6.5 models and servers because the support libraries you link to will be updated by Setup. Be aware that the 6.5 API may contain new methods, so upgrading your client code is to your advantage.
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:
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.
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.
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.
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.
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.
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.
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.