|
|
|
Running Host Integrator Server Kit Web Server as a Windows Service
Technical Note 10067
Last Reviewed 14-Mar-2008
Applies To
Verastream Host Integrator version 5.5 or higher
Summary
Technical Note 10067
Last Reviewed 14-Mar-2008
Applies To
Verastream Host Integrator version 5.5 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.
Version 6.x
Host Integrator version 6.x 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 (as described in this technical note between March 10 and 14, 2008), then first remove it by entering the following commands in a Command Prompt window:
cd \Program Files\VHI\tomcat\binservice.bat remove- In a Command Prompt window, run the following:
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 with Version 6.x
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.
Version 5.5
Host Integrator version 5.5 includes Tomcat version 4.x. In a Server Kit installation, if you wish to configure the VHI Web Server to run as a Windows service, follow the steps below.
- Download TomcatService.zip and unzip it.
- If VHI is installed to a directory other than the default C:\Program Files\VHI, then edit the InstallTomcatService.bat and UninstallTomcatService.bat files to change the value of the VHI_HOME variable. Use the DIR command at the Command Prompt to determine the folder name 8.3 equivalent.
- Run InstallTomcatService.bat. The Windows service "Verastream Tomcat Service" is created.
Note: In the future, the service should be removed before uninstalling the VHI Server Kit. To remove the Tomcat service from the operating system Services, run UninstallTomcatService.bat.
Running the Service with Version 5.5
The Tomcat service can be started and stopped in Control Panel > Administrative Tools > Services, or by using the NET START and NET STOP commands.
Note: The Tomcat service cannot be started or stopped by using the Services shortcuts installed in the Host Integrator programs folder (as described in Technical Note 10004).
If the service fails to start, see also Technical Note 10039 regarding conflicts on the Tomcat service port 8081.
