Environment
Situation
If you have mismatched Verastream Host Integrator (VHI) versions in your environment, you may encounter an error when attempting to deploy models to a remote server.
A typical scenario in which you may see the following errors is when running 32-bit Development Kit (version 7.1.x) to deploy a model to a 64-bit session server (version 7.5). The error message that displays depends on the method you use to deploy a model.
Using activatemodel
When attempting to deploy a model using the activatemodel command, it may fail with the following errors:
Cannot establish management session with VHI server 'myremoteservername'
Connection not allowed to this version of product.
Using Design Tool
When attempting to deploy a model using Design Tool, it may fail with the following error:
Resolution
Generally, to avoid compatibility issues, all systems in your installation environment (development, test, or production) should run the same version of Verastream Host Integrator components.
Workaround
If the session server is running a newer version, it has backward compatibility to run models created by older versions of Development Kit. To deploy your model to a newer server, complete the following steps:
- On the older Development Kit system, create a model package (.zip file) with the packagemodel command.
For more information about using the packagemodel command, see http://docs2.attachmate.com/verastream/vhi/7.5/en/topic/com.attachmate.vhi.help/html/reference/deploy_packagemodel.xhtml.
- Copy the .zip file to a system running the newer version of VHI.
- Deploy the model package to the newer session servers using the activatemodel command.
For more information about using the activatemodel command, see http://docs2.attachmate.com/verastream/vhi/7.5/en/topic/com.attachmate.vhi.help/html/reference/deploy_activatemodel.xhtml.
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.6/en/topic/com.attachmate.vhi.help/html/reference/compatibility_switches.xhtml.
Note: This workaround is not supported if the model is created by a Development Kit version that is newer than the session server version, due to incompatibilities caused by new settings. Attempting to deploy to an older server can result in the following error:
[2756] Verastream <server version> cannot load models or
configurations from later versions of the product. Please use version
<model version> or newer to load this file.