Running as a Windows Service

Enterprise RTView®
User Guide

It is possible to run the Data Server, Display Server and Historian in the background as Windows Services. These services run using JavaService version 2.0.10, which is licensed under the Lesser GPL and is available for download from http://forge.objectweb.org/projects/javaservice/. NOTE: These applications are available as Windows Services on Windows 2003 Server and Windows XP only. They are not supported on 64-bit systems.

Note that a Windows Service is run as a local system service. Therefore, if you will be using ODBC connections for the Historian or an SQL data source, you will need to set these as system data sources, rather than user data sources. Additionally it is not possible to install an application as a Windows Service if Enterprise RTView is being run off a networked drive, it must be installed on your local system.

Install and Start Application as a Windows Service

Once an Enterprise RTView application is installed as a Windows Service, you can start, stop and configure it in the Windows Services dialog. To install and start one of these applications as a Windows Service, select Start-->Programs-->Enterprise RTView--> GMS Command Prompt and in the command window use the following syntax:

install_service appName -service:service_name -dir:startup_directory

The following arguments are supported for install_service:

Argument	Description
appName	Required. Must be dataserver, displayserver or historian.
-service	Required. Specify the name to use for this service. This name will be displayed in the Windows Services dialog. Example: -service:MyService NOTE: If the service name contains spaces, enclose the entire argument in quotes: "-service:my service".
-dir	Required. Specify the full path to the directory where the application should run. This should be the project directory that contains all files necessary (.rtv, configuration, etc.) to run the application. Example: -dir:c:\myproject NOTE: If the directory name contains spaces, enclose the entire argument in quotes: "-dir:c:\my dir".
-out	Optional. Specify the full path and file name for the out log file. If not specified, the out log will be written to the -dir specified and named appNamed_out.log. Example: -out:c:\logs\ds_out.log
-err	Optional. Specify the full path and file name for the err log file. If not specified, the err log will be written to the -dir specified named appNamed_err.log. Example: -err:c:\logs\ds_err.log
-overwritelogs	Optional. Overwrite err and out log files each time the service restarts. If not specified, new data is appended to existing log files.
-manualStart	Optional. Set the service startup type to manual. The service will still start when it is installed, but will not automatically start on system startup. If not specified, the service startup type will be auto.

Stop and Uninstall Application as a Windows Service

To stop and uninstall, select Start-->Programs-->Enterprise RTView--> GMS Command Prompt and in the command window use the following syntax:

uninstall_service appName -service:service_name

NOTE: If the service name contains spaces, enclose the entire argument in quotes: "-service:my service".

Enterprise RTView contains components licensed under the Apache License Version 2.0.

JMS, JMX and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. They are mentioned in this document for identification purposes only.

SL, SL-GMS, GMS, Enterprise RTView, SL Corporation, and the SL logo are trademarks or registered trademarks of Sherrill-Lubinski Corporation in the United States and other countries. Copyright © 1998-2009 Sherrill-Lubinski Corporation. All Rights Reserved.