Installing the CygNet Alarm Manager
This topic describes the system requirements and installation steps required to install the CygNet Alarm Manager (CAM).
System Requirements
The following system requirements support CAM:
- CygNet v9.4 or later, with all patches applied
- Dedicated GRP service for required file storage (see Step 1 below)
- HSS and MSS services required for report scheduling. A separate HSS is recommended for the CAM.
Installation Steps
To install the CAM, you will need to perform the following steps:
- Create a dedicated storage service to store some CAM files.
- Run the AlarmManagementSetup.exe installer as an administrator.
- Configure Version Management to deploy the CAM to clients.
- Configure the CAM Module.
Note: CygNet Studio must have been run at least once on the system before running the CAM setup program. After the setup program has completed, you must make sure that version management runs for CygNet Studio by running "TouchBSS.exe" in the Utilities directory or by some other means.
1. Create a Storage Service
CAM uses a CygNet Group service to store files in a central location so they can be accessed by client or service machines. It’s not required that this GRP service be exclusive to the CAM. We recommend that you do not use the standard GRP service that is installed with a base CygNet installation. If you already have a separate GRP service used for file storage, you can skip this step.
We recommend calling this service STORAGE.
If your system is based on CygNet for Production, you probably already have a STORAGE or GRP_BSS installed.
Steps for adding a new service:
- 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.)
- Copy the required service start-up files to your new Services\XXX folder.
- 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.
- Add the new service to the relevant Address Resolution Service (ARS).
- Using CygNet Explorer, open the ARS, right-click in its service pane, and click New.
- In the New Service dialog box, select the Service Type. See ARS Service Types.
- Type the Site and Service names.
- Type a Description for the service and click OK.
- Add the new service to the Remote Service Manager (RSM).
- Using CygNet Explorer, open the RSM, right-click in its service pane, and click New.
- In the New RSM Entry dialog box, select the new service and confirm or alter its default settings.
- 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.
- Optional: Click Automatic Service Recovery… and configure recovery settings.
- Click OK to save RSM settings.
- Once the service is added to the RSM, right-click its entry in the RSM and click Start.
- Add security settings for the new service. See Implementing Security.
- 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.
- Using Windows Explorer, open your CygNet\Services directory and locate the associated service folder.
- Open the associated service folder, and open the configuration file found there.
- 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.
- Save and close the .cfg file.
- 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.
- Repeat steps a - e for each associated service.
- Now that your new service is installed and added, configure it to suit your needs. See specific service documentation for more information.
2. Install Files
Steps for installing CAM:
-
Obtain the product source files from the CygNet Download Site (login required).
- Extract the source files from the CygNet_Alarm_Manager.zip.
- Right-click the installer, AlarmManagementSetup.exe, and choose Run as administrator to launch the installation wizard.
- Click through the setup screens configuring the services and point scheme.
AlarmManagementSetup.exe will take care of most aspects of setting up the CAM on your system, including uploading the necessary libraries to your CygNet services. To ensure these files are installed on client systems, see the next step.
3. Configure Version Management
The setup program will install "AlarmManagementModule.rsp" in your APPS service, but in order for the reports to work, some other file needs to invoke "AlarmManagementModule.rsp". Typically this is done in the "StudSupp.rsq" file in APPS\SUPPORT. If this file doesn’t exist you will need to create it. See the Version Management section for more information. You may make the required changes in a different file if you wish.
A typical "StudSupp.rsq" file looks like this:
StudSupp.rsq
# Installation specific version management file for CygNet Studio and CygNet Vision
################################################################
################################################################
# Add any custom entries to this file to ensure changes are not
# lost in the next update process.
################################################################
#
[SUPPORT]..\SUPPORT\ProEssGraph.rsp
[SUPPORT]..\SUPPORT\CXEXPORT.DLL <REGISTER>
[SUPPORT]..\Support\ODBC\CygNetODBC.rsp
[SUPPORT]..\Support\CR11\CR11.MSI <SHELLEXECWAIT=/qn /i>
[SUPPORT]..\SUPPORT\CxHMIRsm.OCX <REGISTER>
[SYSTEM]<SYSTEM>\RICHTX32.OCX <INUSENOMSG> <CREATENEW> <REGISTER>
[SUPPORT]..\Support\ReportModule.rsp
[SUPPORT]..\Support\CxXlsxViewer.rsp
The last two line items above are the important ones to include in your StudSupp.rsq file for module to function properly.
4. Configure the CygNet Alarm Manager Module
Using CygNet Studio, open the SITENAME.BSS\M_CAM\CamModuleConfiguration.csf file to configure the CAM. See Configuring the CygNet Alarm Manager Module for more information.


