Attachmate Worldwide  |   Contact Us  |   NetIQ.com
Home » Support » Solution Library

Technical Notes

Manually Starting and Stopping VHI Services
Technical Note 10004
Last Reviewed 11-Sep-2008
Applies To
Verastream Host Integrator version 6.0 or higher
Summary

This technical note explains the Verastream Host Integrator (VHI) services startup sequence and details how to manually start and stop the VHI services, if necessary.

Verastream Host Integrator Services

There are six VHI services. The first three services are required for basic VHI functionality, the last three are optional for basic functionality, but are required to provide specific additional functionality.

  • AADS (Authentication Authorization and Directory Services) - [Required] Provides security and directory services for Host Integrator installations. For more information on this component, see Technical Note 10060.
  • Log Manager - [Required] Coordinates all VHI logging activities for AADSes and Session Servers. For more information on configuring and using logging, see Technical Note 40032.
  • Session Server - [Required] Runtime engine that loads deployed models, connects to host systems, and services requests from client connectors and web applications.
  • Web Server - [Optional] Serves web pages generated by the VHI Web Builder. This service is installed with the Windows Development Kit only. (To create a VHI Web Server service with a Windows Server Kit, see Technical Note 10067. To start the VHI Web Server on UNIX/Linux, see Technical Note 40024.)
  • Host Emulator - [Optional] A browser-based tool that enables you to run 3270 and 5250 models created with the VHI Design Tool without having a live connection to a host.
  • Administrative WebStation - [Optional] Enables administrators to view and configure VHI Servers, Security, and Domains from a web browser.

For information on checking the status of services, see Technical Note 10054.

Starting VHI Services

In Windows:

VHI services are automatically started at Windows startup; however, if you need to manually start VHI services, use the installed shortcuts:

For VHI 6.5 or higher: click Start > Programs > Attachmate Verastream > Host Integrator > Services > Start All.

For VHI 6.0: click Start > Programs > AttachmateWRQ Verastream > Host Integrator > Services > Start All.

Note: If you start the services individually, follow the The Startup Sequence noted below.

The shortcuts run <VHI>\bin\atstart commands. Instead of using the installed shortcuts, you can use the Windows NET START command or Services console to start services individually.

In UNIX/Linux:

VHI services must be manually started (unless the system administrator configures the UNIX/Linux system to automatically load the services on system startup).

To start all VHI services in the correct sequence (including optional services), navigate to the /usr/vhi/bin directory and enter the following command:

atstart -start all

This command starts all of the installed VHI services in the correct sequence.

The atstart command can also be used to start individual services. To view the available command options, use the following command:

atstart -help

Note: If you start services individually, follow The Startup Sequence noted below.

The Startup Sequence

VHI services must be started in the following order:

  1. Verastream Host Integrator Log Manager
  2. Verastream Host Integrator Directory Server (AADS)
  3. Verastream Host Integrator Session Server
  4. Any of the optional services required for the desired functionality:
- Verastream Host Integrator Web Server
- Verastream Host Integrator Administrative WebStation
- Verastream Host Integrator Host Emulator

Stopping the VHI Services

In Windows:

If you need to manually start VHI services, use the installed shortcuts:

For VHI 6.5 or higher: click Start > Programs > Attachmate Verastream > Host Integrator > Services > Stop All.

For VHI 6.0: click Start > Programs > AttachmateWRQ Verastream > Host Integrator > Services > Stop All.

Note: If you manually stop the services individually, follow The Shutdown Sequence noted below.

The shortcuts run <VHI>\bin\atstart commands. Instead of using the installed shortcuts, you can use the Windows NET STOP command or Services console to stop services individually.

In UNIX/Linux:

Use the following command to manually stop VHI services in the correct sequence:

atstart –stop all

Note: If you stop the services individually, follow The Shutdown Sequence noted below.

The Shutdown Sequence

VHI services must be stopped in the following order, which is the reverse of the startup sequence:

  1. Any of the optional services running:
- Verastream Host Integrator Web Server
- Verastream Host Integrator Administrative WebStation
- Verastream Host Integrator Host Emulator
  1. Verastream Host Integrator Session Server
  2. Verastream Host Integrator Directory Server (AADS)
  3. Verastream Host Integrator Log Manager
Related Technical Notes
10054 How to Verify Verastream Servers are Running
10060 What is Verastream AADS?
10067 Running Host Integrator Server Kit Web Server as a Windows Service
10078 Debug Output for Verastream Host Integrator Service Startup
40024 Deploying a Verastream Web Service Project to a Linux/UNIX Server
40032 Verastream Host Integrator Server Logging
40999 Verastream Host Integrator Technical Notes

Did this technical note answer your question?

Yes    No    Somewhat     Not sure yet

Additional comments about this tech note:

Need further help? For technical support, please contact Support.