|
|
|
Running Host Integrator Server Kit Web Server as a Windows Service
Technical Note 10067
Last Reviewed 17-Jun-2010
Applies To
Verastream Host Integrator version 6.0 or higher
Summary
Technical Note 10067
Last Reviewed 17-Jun-2010
Applies To
Verastream Host Integrator version 6.0 or higher
Summary
The Verastream Host Integrator (VHI) Server Kit for Windows installs the VHI Web Server (Apache Tomcat), but it is not configured to run as a Windows service. This technical note explains how to configure the VHI Web Server from the Server Kit to run as a Windows service.
Understanding the VHI Web Server
The VHI Web Server (Apache Tomcat) is used by the Development Kit Web Builder to create and run web application and web service projects. The Development Kit setup installs the VHI Web Server to run as a Windows service (named "Verastream Host Integrator Web Server") so it starts automatically when Windows starts.
The Server Kit setup also installs the VHI Web Server, but does not configure it to run as a Windows service, since typically a production server has its own web server. A web server is required to run web application and web service projects created by Web Builder.
Configuration steps vary depending on your version of Tomcat included with Host Integrator.
Configuring VHI to Run as a Windows Service
Host Integrator includes Tomcat version 5.x. In a Server Kit installation, to configure the VHI Web Server to run as a Windows service, follow the steps below.
- If you previously installed the "Apache Tomcat" service, then first remove it by navigating to the tomcat\bin directory and running service.bat remove.
- In a Command Prompt window, run the following:
In version 7.0:
cd \Program Files\Attachmate\Verastream\HostIntegrator\binatstart_server.exe -install webserverIn version 6.x:
cd \Program Files\VHI\binatstart.exe -install webserverThe service will be displayed in Services with the name "Verastream Host Integrator Web Server" and it will run with the proper CLASSPATH.
Running the Service
Start the service using any of the methods described in Technical Note 10004.
If the service fails to start, see also Technical Note 10039 regarding conflicts on the Tomcat service port 8081.
