Service Management

Services > Service Management

Service Management

Service management and control in CygNet is handled by the Remote Service Manager (RSM) service.

See the following topics for more information about using and interacting with the RSM:

View general Service Management information
View RSM Service Configuration File Keywords
Use the CygNet Host Manager to:

Configure Service Startup and Shutdown Order
Back up the RSM
Configure Automatic Service Recovery
View security information for the RSM, including information about the RSM Password
Configure and visualize CygNet Redundancy
View the Audit Levels for the RSM
View scripting interfaces the RSM:
- CygNet .NET API for interfacing with the RSM. Includes CygNet.API.ServiceManager and CygNet.Data.ServiceManager
- CxHmiRsm API for interfacing with the RSM using COM and ActiveX libraries. Includes CygNet RSM View Control, CxRsmCtl, and CxRsmEditor

Use RSM command line utilities:
- RSM Control Services — controls services on a host (start, stop, restart, or report service status)
- RSM Get File — gets files from the machine running the specified RSM

Service Control Status

When an RSM is started, all services are restored to their previous operational state. When an RSM is stopped, all services running under its control are stopped. The following table describes the Status values for any service displayed in the RSM service pane of CygNet Explorer.

Control Status	Description
Defined	The service has been added to the RSM but has not been started by the RSM.
Ready	A transitional state to "Starting".
Starting	A transitional state from "Ready" to "Running".
Start Failed	The start attempt failed.
Misconfigured	The Site.Service specified in the service definition does not match the configuration file (.cfg).
Running	The service is operational and running.
Running on a different domain	The service is operational and running on a domain that is different to the domain of the client. See Configuring Redundancy for more information.
Failed	The service was stopped by a means other than the RSM (for example, a stop command was issued from the service screen).
Stopping	A transitional state from "Running" to "Stopped".
Stopped	The service is stopped.

Note: Be careful not to confuse the RSM control status of a service with the ARS operational status.

System Service

Since the RSM is the one service used to control other services, it is the only service that will appear in the Services window when running CygNet as operating system services. It can also be configured to be the only service that shows on the task bar when running CygNet as processes.

Services Base Directory

The base directory where your CygNet services are located is defined by the RSM_BASE_DIR RSM keyword. This keyword defines the absolute path to the CygNet\Services folder. When a service is added to the RSM, the path to the service’s data and executable folders must be defined relative to this base directory. This information is required by the RSM is used to start and stop other services.

Configuring Service Startup Order