Using Commands to Deploy a Model Package

Host Integrator provides deployment commands that you can use from the command line or in a script to deploy a model to multiple servers. With this capability you can combine model files with any event handler files they use, and also with configuration information that tells a Host Integrator Server how to provide access to the model (for example, via a session pool of a certain size, or by using specific requests for a new session).

For information on what a model package is, see About Model Packages.

How to Create a Model Package

To create a model package for deployment, the only item you must have is a model file. If your model uses event handlers, then the event handler .JAR files must also be present. If you're using session pools, or if your model uses model variable lists, you will also need to create configuration descriptor .xml files.

For each model that you intend to deploy using the new deployment commands, do the following:

  1. Create a model.

  2. Optional: Create event handler .JAR files.

  3. Optional: Write descriptors: either just a configuration descriptor or a configuration descriptor and a model variable list descriptor. A configuration descriptor is required if you want to use session pools, or if you have multiple configuration targets. A variable list descriptor is required if your model uses one or more model variable lists. Because model variable lists contain model variable values for all sessions in a session pool, you cannot have a model variable list descriptor file unless you also have a configuration descriptor file.

    Note: If you're upgrading from a 5.0 version (rather than a 5.5 version) of Host Integrator, you may have a significant amount of model or session pool configuration information in the Administrative WebStation. If you want to update a model without affecting existing configuration information, do not include descriptor files in your model package. See Upgrading from Verastream Host Integrator 5.0 to 6.0 for more information on upgrading.

  4. Use the packagemodel command to create a model package. On a Windows machine, you can open a command window set to the appropriate path from the Start menu: click Start > Programs > Attachmate Verastream > Host Integrator > Deploy Models.

    You can find information about the location of this command and its target by right-clicking the Deploy option on the Start mention and then selecting Properties. You can change these settings if necessary.

How to Deploy a Model Package

  1. Use the activatemodel command to activate the model. To deactivate an activated model, use the deactivatemodel command. On a Windows machine, you can open a command window set to the appropriate path from the Start menu: click Start > Programs > Attachmate Verastream > Host Integrator > Deploy Models.

  2. If your integration solution includes a web application created with Verastream's Web Builder, you must also deploy the web application files. See Deploying a Verastream Web Application for more information.