Installing and Deleting Services

The following procedures explain how to install and add a single new service to an existing system, and they explain how to delete a single service from an existing system.

If you are upgrading an existing CygNet system and do not already have the desired service installed on your host, you must manually install and add the service in order for it to become available. If you do not already have the service installed, performing an upgrade does not automatically install it, even though its files are included in the upgrade source files. Once you've manually installed and added the service to your existing system, future system upgrades will upgrade the service.

This procedure focuses on how to install a single instance of a service, but in some cases you can install and add multiple new services in a similar way. See service-specific documentation for more details about installing multiple kinds of the same service on a site.

If you are installing a service to a new machine, make sure that you perform the following steps, whenever relevant:

• Acquire a license to run the new service on the new machine.
• Install MSXML6 on the machine.
• Copy DCLND.dll to the CygNet\Support folder or DCLND64.dll to the CygNet\Support64 folder.
• Add a Remote Service Manager (RSM) to your new machine and site so that you can control the new service(s) from CygNet Explorer.
• If you are adding a UIS, you must add a correlating DDS. A UIS and a DDS always have a 1:1 relationship.
• If you are adding a UIS, you must create a Support folder, and you must add and register the relevant drivers.

Although all CygNet services may be installed at once during a fresh installation, the procedure below does not apply to such a scenario.

For a fresh CygNet Software installation, services are selected by default in the CygNetSCADAServicesSetup.exe. See theCygNet v9.8 Quick Start for more information. Or contact CygNet Support to access resources to assist with initial CygNet Software installation.

Naming Services

CygNet naming standards for service names are as follows:

Component	Valid Character Set	Limits
Service	A B C D E F G H I J K L M N O P Q R S T U V W X Y Z (uppercase) 0 1 2 3 4 5 6 7 8 9 $ (dollar sign), ! (exclamation point), and _ (underscore)	8 character limit No spaces

Installing and Adding Services

To Install and Add a Service

1. Using Windows Explorer, open your CygNet\Services directory and create a new service folder there. (Optionally, create two new folders on different drives: one for executables and one for data.)
2. Copy the required service start-up files to your new Services\XXX folder.
3. Edit the service .cfg file in one of the following two ways:
   • Use the Config File Manager.
   • Use a text editor to manually edit the file. For instance, replace relevant instances of XXX with the correct site name for the service. See also Configuration File Keywords.
4. Add the new service to the relevant Address Resolution Service (ARS).
   1. Using CygNet Explorer, open the ARS, right-click in its service pane, and click New.
   2. In the New Service dialog box, select the Service Type. See ARS Service Types.
   3. Type the Site and Service names.
   4. Type a Description for the service and click OK.
5. Add the new service to the Remote Service Manager (RSM).
   1. Using CygNet Explorer, open the RSM, right-click in its service pane, and click New.
   2. In the New RSM Entry dialog box, select the new service and confirm or alter its default settings.
   3. Optional: If the service executable and data folders are not under the same Services folder, type their directory paths in the Executable and Data fields respectively.
   4. Optional: Click Automatic Service Recovery… and configure recovery settings.
   5. Click OK to save RSM settings.
6. Once the service is added to the RSM, right-click its entry in the RSM and click Start.
7. Add security settings for the new service. See Implementing Security.
8. Associate other services with the new service. Which service(s) you associate depends on the service(s) involved. See specific service documentation for more information.
   1. Using Windows Explorer, open your CygNet\Services directory and locate the associated service folder.
   2. Open the associated service folder, and open the configuration file found there.
   3. Go to the Associated Services section of the .cfg file and either un-comment-out the service entry or add a service entry in the same format as other associated services.
   4. Save and close the .cfg file.
   5. In CygNet Explorer, go to the RSM, locate the affected associated service in the service pane, right-click it, and click Restart. This completes the association process.
   6. Repeat steps a - e for each associated service.
9. Now that your new service is installed and added, configure it to suit your needs. See specific service documentation for more information.

Deleting Services

To Delete a Service

1. Using CygNet Explorer, go the relevant RSM, right-click the service you want to delete, and click Service Control > Stop.
2. In the same RSM, right-click the service you want to delete and click Delete.
3. Using CygNet Explorer, go the relevant ARS, right-click the service you want to delete, and click Delete.
4. Using Windows Explorer, delete the service's folder from your CygNet > Services directory, and then delete any applicable back-up files and/or folders.
5. Depending on the service deleted and your goals, there might be additional items to delete in your CygNet system. For instance, records related to the deleted service might be stored in associated services; these old records might need to be deleted as well.