SkyPoint Alarm Integration
Add-On
Using OnGuard Alarms to create events in
SkyPoint
Also called ‘SkyPoint V0’
Unauthorized Reproduction Prohibited
1
CR4400 - M00.00 (SkyPoint V0)
Topics





Introduction and Overview
Specifications and Prerequisites
User Permissions
Installation and Configuration
SkyPoint View Application
Unauthorized Reproduction Prohibited
2
CR4400 - M00.00 (SkyPoint V0)
SkyPoint Alarm Integration Add-on
 Introduction
 Used to send OnGuard Alarms to SkyPoint so that
actions/responses in the SkyPoint environment can be
automated based on the alarms
 Overview
 Configuration indicates which alarms will be sent to
SkyPoint and specifies the SkyPoint Receivers (NetDVMS)
to handle the events from OnGuard
Unauthorized Reproduction Prohibited
3
CR4400 - M00.00 (SkyPoint V0)
Specifications
 This add-on should be installed on the OnGuard server
 Similar to other OnGuard services, the
“LS_SkyPoint.AlarmService” can be installed on other
servers to distribute the workload on larger systems
 The minimum hardware requirements are the same for
the add-on as they are for OnGuard:
 Pentium IV Processor
Note: If the add-on is not installed on the same
 1 GB RAM
computer that has the DataConduIT service
 DVD-ROM
running, you must configure DataConduIT for
use from a remote computer.
 USB Port
For more information, refer to the DataConduIT
 1024x768 color display
User Guide.
 6 GB of available space
Unauthorized Reproduction Prohibited
4
CR4400 - M00.00 (SkyPoint V0)
Prerequisites
 Several prerequisites are required to support this
integration
 OnGuard 2009 (6.3.249) Hot Fix 1 or later
 .NET Framework 3.5 SP1 or later
 A DataConduIT connection (properly installed)
 A Windows account that has permission to connect to
DataConduIT to run the integration service
 The following services must be running:



LS DataConduIT service
LS Linkage Server service
LS Application Server service
Unauthorized Reproduction Prohibited
5
CR4400 - M00.00 (SkyPoint V0)
Configuration
 Each component of the integration must be properly
configured
 SkyPoint Alarm Integration add-on application
 System Administration in OnGuard system
 NetDVMS Administrator in SkyPoint system
Unauthorized Reproduction Prohibited
6
CR4400 - M00.00 (SkyPoint V0)
Users and User Permissions
 Users and user permissions are managed separately
from within the OnGuard and SkyPoint systems
 The user that handles the configuration of the alarms in
System Administration must have permission in the
OnGuard system to create custom alarms
 The user that configures/monitors the actions to be
performed in SkyPoint when the alarms are received will
have to have those permissions set in SkyPoint
Unauthorized Reproduction Prohibited
7
CR4400 - M00.00 (SkyPoint V0)
User Access
 You can simplify things by
running the same user for:





Access to SQL Server
Single Sign-On to OnGuard
LS Application Server
LS DataConduIT Service
LS Skypoint.AlarmService
Unauthorized Reproduction Prohibited
8
CR4400 - M00.00 (SkyPoint V0)
Installation
 Extract the .zip file to a new directory on your hard drive
 SkyPointAlarmIntegration.PDF is the user manual
 Double-click the setup.exe file to begin the installation
 Follow the prompts (standard installation options)
 Open Windows Services and configure credentials for the
Windows user that will run the LS SkyPoint.AlarmService
 Link the Windows user running the
LS_SkyPoint.AlarmService to an OnGuard user in System
Administration
 For more information, refer to the Users Folder chapter >
Users Form (Directory Accounts Sub-tab) section of the
System Administration User Guide
Unauthorized Reproduction Prohibited
9
CR4400 - M00.00 (SkyPoint V0)
Things that should already be installed
 Support for LS Application Server Service
 Running on Account with permission to the database
 LS DataConduIT Service
 Running on Account with permission to the database
 LS Linkage Server
 Configured to run from System Administration
 Test if you can run Web-based AAM
 This will ensure your Application Service is configured
properly

If you cannot run Web-based AAM, refer to the OnGuard
installation guide


Database Authentication for Web Applications
Configuring the Web Application Server
Unauthorized Reproduction Prohibited
10
CR4400 - M00.00 (SkyPoint V0)
OnGuard Configuration
 Consists of two parts:
 DataConduIT Source configuration


Done once to setup the DataConduIT Sources
OnGuard Alarm configuration

Updated anytime a new OnGuard Alarm is needed
Note: See the SkyPoint Alarm Integration guide for more information on OnGuard
configuration.
Unauthorized Reproduction Prohibited
11
CR4400 - M00.00 (SkyPoint V0)
DataConduIT Source Configuration
 From the Additional Hardware menu, select DataConduIT
Sources
 On the DataConduIT Sources tab, add a new
DataConduIT source.
 On the DataConduIT Devices tab, add a new
DataConduIT device.
 On the DataConduIT Sub-Devices tab, add a new
DataConduIT sub-device.
Note: The names of the DataConduIT source, device, and sub-device can be anything
you choose, however these names must also be used during the add-on configuration.
Unauthorized Reproduction Prohibited
12
CR4400 - M00.00 (SkyPoint V0)
OnGuard Alarm Configuration
 OnGuard Alarms that will be passed to SkyPoint require a
‘suffix’ be added to the alarm name
 This means you can create new custom alarms
(recommended) or modify an existing alarm


Make sure the ‘suffix’ appears in the alarm name
Restart the LS DataConduIT service after alarm
configuration is complete
Note: The LS DataConduIT service must be restarted whenever alarms are added or
modified.
Note: This suffix can be anything as long as it is used consistently and entered during
the add-on configuration.
Unauthorized Reproduction Prohibited
13
CR4400 - M00.00 (SkyPoint V0)
SkyPoint Integration (SkyPoint.View.exe)
 Log in using a valid OnGuard user account
 Be patient, the directory window takes a few extra seconds to fill
initially
SkyPoint Administration Application
Unauthorized Reproduction Prohibited
14
CR4400 - M00.00 (SkyPoint V0)
Administration Application
Unauthorized Reproduction Prohibited
15
CR4400 - M00.00 (SkyPoint V0)
Configuration
Unauthorized Reproduction Prohibited
16
CR4400 - M00.00 (SkyPoint V0)
 On the Configuration tab, configure the following
options:
 Select the ‘Debug’ check box if you want to include debug
messages in the log file
 Select the ‘Encrypt Configuration’ check box if you want to
encrypt the configuration file when it is saved
 The Custom Alarm Suffix field specifies the suffix that
will be used to indicate which OnGuard alarms should be
sent to SkyPoint
 Select the ‘Remove Suffix From SkyPoint Alarm’ check
box if you do not want the suffix to be displayed in
SkyPoint
Unauthorized Reproduction Prohibited
17
CR4400 - M00.00 (SkyPoint V0)’
 The Custom Alarm Database Check tells the system to go
beyond alarms containing the suffix, and select any
custom alarms in the OnGuard System
 Custom Alarms are defined as alarms whose database ID
starts at 100000
Unauthorized Reproduction Prohibited
18
CR4400 - M00.00 (SkyPoint V0)
 Custom Alarm Database Check tells the system to select
any custom alarms in the OnGuard System
 ‘Custom’ Alarms are alarms whose database ID starts at
100000
 The Database Connection String is used to connect to
the database
 Use the Event age field to specify the time to wait before
sending another query to the database to see if an event
exists in the system
Note: There is a delay between when the
DataConduIT gets the event and the
event appears in the database.
Unauthorized Reproduction Prohibited
19
CR4400 - M00.00 (SkyPoint V0)
Alarms Table in SQL
Unauthorized Reproduction Prohibited
20
CR4400 - M00.00 (SkyPoint V0)
DataConduIT Credentials
 Server, Username, and Password
 Configure the following options:

Only if the LS DataConduIT service is running on a different
computer, specify the location of the service in the Server
field and the credentials for the service in the Username and
Password fields
If the service is running on the local computer and using
an account linked to an OnGuard user these fields MUST
be left blank.
 Specify the DataConduIT source, device, and sub-device
with the same names as those configured in OnGuard

Unauthorized Reproduction Prohibited
21
CR4400 - M00.00 (SkyPoint V0)
Unauthorized Reproduction Prohibited
22
CR4400 - M00.00 (SkyPoint V0)
 On the Events Export tab:


Click [Build Events]
Save Events.ini
 Browse to the NetDVMS
directory on the Receiver


If you save over the
original file, the new
events will append
Delete and Replace to
start with a new file
NOTE: A Database Connection String
is required to perform the Event Build
function
Unauthorized Reproduction Prohibited
23
CR4400 - M00.00 (SkyPoint V0)
SkyPoint Receiver Configuration
 SkyPoint Receivers configure the NetDVMS recorder
targets for the OnGuard alarms
 On the Receiver Details tab, click [+] to create a new entry
 Each receiver requires a Name, IP Address, and Port

Repeat this step for each additional SkyPoint receiver you
want to add
The ‘Port’ MUST
match the Alert Port
configured on the
NetDVMS Recorder
Default = 1234
Unauthorized Reproduction Prohibited
24
CR4400 - M00.00 (SkyPoint V0)
 Once the configuration is complete, start the LS SkyPoint
AlarmService
Note: The LS DataConduIT and LS SkyPoint AlarmService must be restarted whenever
a change is made to the configuration or whenever custom alarms are added to
OnGuard
Unauthorized Reproduction Prohibited
25
CR4400 - M00.00 (SkyPoint V0)
NetDVMS Administrator Event Configuration
 Make sure the Events.ini file created in the SkyPoint
Integration application is in the NetDVMS installation
folder
 Configure actions in NetDVMS Administrator for SkyPoint
to perform when OnGuard alarms are received
 Start NetDVMS Administrator
 Click [Generic Events] OnGuard events should appear in
the listing window.
 Note: Refer to the NetDVMS documentation for more
information on configuring alarms to push video.
Unauthorized Reproduction Prohibited
26
CR4400 - M00.00 (SkyPoint V0)
Unauthorized Reproduction Prohibited
27
CR4400 - M00.00 (SkyPoint V0)
SkyPoint Push Monitor Configuration
 Configure a layout for the SkyPoint client that includes
push monitor cells
 If you create multiple cells in the same view/layout, they
will all use the same port/password values
Note: For more information, refer to the SkyPoint documentation
Unauthorized Reproduction Prohibited
28
CR4400 - M00.00 (SkyPoint V0)
 All needed services should be Started and Automatic
 Default settings are below
Unauthorized Reproduction Prohibited
29
CR4400 - M00.00 (SkyPoint V0)
Log Files
 There are two log files that may be available if there are
issues:
 SkyPoint.AlarmService.log



Details the performance of the service
In debug mode this file gets large very quickly
SkyPoint.View.log

Records issues with the View Application
 Both files are located in the logs directory
 “C:\Program Files\OnGuard\logs” directory

Unless they have been specifically moved
Unauthorized Reproduction Prohibited
30
CR4400 - M00.00 (SkyPoint V0)
SkyPoint.View.exe.config
 If you have not encrypted the configuration file, you can
view it in the install directory
 The ‘endpoint address’ needs to be set to the IDVM server
location

Change the IP to be the IP of the IDVM web Server
Unauthorized Reproduction Prohibited
31
CR4400 - M00.00 (SkyPoint V0)
Each time you add NEW Alarms
 After the initial configuration is finished you may want to add
additional events to the SkyPoint Receiver
 The following steps should be used to add additional events
 In System Administration, configure a new custom alarm or
modify an existing alarm




Include the SkyPoint suffix defined in the SkyPoint
Administration application.
Restart the LS DataConduIT and LS SkyPoint AlarmService
services
In the SkyPoint Administrator application, build the Events.ini file
and save it to the NetDVMS Recorder
In the NetDVMS Administrator, configure actions for SkyPoint to
perform when the OnGuard alarms are received
Unauthorized Reproduction Prohibited
32
CR4400 - M00.00 (SkyPoint V0)
Troubleshooting
 If you experience issues using the SkyPoint
Administrator application:
 Verify that the LS DataConduIT, LS Linkage Server, LS
Application Server, and LS SkyPoint AlarmService
services are running
 Check the connection to the Application Server
 Try running the LS DataConduIT and LS SkyPoint
AlarmService services with the same account
 Check the SkyPoint.AlarmService.log and
SkyPoint.View.log files for errors

These files are located by default at C:\Program
Files\OnGuard\logs\
Unauthorized Reproduction Prohibited
33
CR4400 - M00.00 (SkyPoint V0)
The End
Thank you for your time!
Unauthorized Reproduction Prohibited
34
CR4400 - M00.00 (SkyPoint V0)