Installing on Windows

There are two installation options available when installing for the first time; Typical or Custom.

Install steps

1. Download the product from the download site, following the instructions to start the Host Integrator setup program.

2. Run the install setup, read and accept the license agreement, click Continue and then select an installation type; Typical or Custom.

   • Typical - All components are installed and configured to the local machine using the default configuration values.. All services will be automatically started when the install is complete and the session server will be registered with the management server.

     The default installation directory is: C:\Program Files\RocketSoftware\Verastream

     Specify a password for the administrative account of the management server. For example, admin. This password is important. You need this password when you first log in to the Administrative Console.

   • Custom - If you select Custom, you can select an installation directory, choose the components you want to install, join an existing installation, or configure advanced installation options available from the tabbed menu pages.

     To install a Host Integrator Server without installing a management server, you must join an existing installation, which supports failover and load distribution.

     To do this, you need to supply the necessary credentials, the existing server address, and port number. Login credentials include either the user name and password created when the first server was installed or the credentials of a user added to the administrator profile in the Administrative Console.

     You can also register a management server with an existing installation forming a management server cluster. When you combine this option with the registration of the session server, you attain automatic replication to the management server cluster.

3. Click Install Now to continue the installation. By default, all services start automatically.

About Windows services

The Management Server, Log Manager, Session Server, Web Server, and Host Emulator are installed as Windows services. For example, Management Server is listed as Verastream Host Integrator Management Server in the Services panel available from the Windows Control Panel. You can modify the Stop and Start settings for these services there.

Host Integrator servers and Host Emulators can be started from the Administrative Console.

Creating an unattended Windows install file

1. To install VHI silently, you can specify all necessary installation and configuration options in a separate file.
2. From the root of the CD, locate and open the setup.ini file.
3. Depending on whether you want to join an existing management server cluster, add the appropriate code to the end of the file.
4. To do an independent install:
   • [VHI]
   • JoinExisting=0
   • MgmtAddress=localhost
   • MgmtUsername=admin
   • Password=secretpassword

5. To join an existing installation:

   • [VHI]
   • JoinExisting=1
   • MgmtAddress=<address of management server>
   • MgmtUsername=<user name existing installation>
   • Password=<password of management server>

6. After you save the file, from the command line run setup/install.

   You can add these options:

   Option	Command
   Run in unattended mode displaying only the progress bar without a Cancel button.	/passive
   Run in quiet mode which requires no user interaction.	/quiet
   Optional. Specify the components you want to install. These are described on the component install panels.	ADDLOCAL=componentID, componentID, componentID For example, setup /install ADDLOCAL=HostIntegrator, COMConnector, Server

If necessary, you can change the installation location during a silent install using the property, INSTALLDIR. The value must be quoted if it contains spaces.

For example: setup /install INSTALLDIR="C:\Program Files\RocketSoftware\Verastream"

Removing Host Integrator from Windows

Use the Add/Remove Programs option from the Windows Control Panel.

If you want to remove a session server with security enabled, you will be prompted to supply a User ID and password. The credentials must be those that you specified in the Administrator profile in the Administrative Console when the server was registered.

The uninstall program removes all installed Host Integrator components, but does not remove log files, user-supplied model files, or Web Builder projects.

Adding or removing Host Integrator Components in Windows

1. If you installed from the download site, follow the procedures described in the download instructions to start the Host Integrator setup program.

2. To start the installation program, click Start > Run, type the path to the installation program (for example, D:\Setup.exe), and then click OK.

3. When the maintenance screen displays, select Modify from the available options. Click Continue.

4. From the Select Components screen specify the components you want to add or remove. Components that are currently installed are selected. Clear the check box to remove a component. Continue to use the check boxes to specify the components you want to add or remove, and then click Continue.

5. If Setup is adding or removing a Host Integrator Session Server with security enabled from an existing installation, it will prompt you for the user ID and password for an Administrator found in the Authorization panel of the Administrative Console with which the management server is registered. Enter the user ID and password that belongs to the administrator specified in the Authorization panel of the Administrative Console, click Continue.

6. As Setup adds and removes components, it may encounter a locked file. To ensure that you have no unnecessary files remaining on your machine after the installation completes you may be prompted to re-start the computer.