Calipsa® Digital Watchdog Integration
User Guide
Document number:C6736M
Publication date:03/23
C6736M | 03/23 1
Calipsa® Digital Watchdog Integration User Guide
Table of Contents
Introduction 3
Digital Watchdog Plugin 3
Digital Watchdog Plugin Integration for Windows 3
System Overview 3
Running the Installers 3
The Calipsa Agent Service 3
Network Access 4
Creating a Calipsa Authentication Token 4
Connecting Cameras to Calipsa 5
Configuring Analytics Events generated by DW 6
Configuring Analytics Events detected by a third-part software 7
Completing an HTTPRequest 8
Enabling Desktop Notification 8
Troubleshooting Questions 10
Adding your Monitoring Station SMTP Details 12
Accessing Calipsa Account Settings 12
Editing Global Configuration 12
Inputting Your Credentials 13
C6736M | 03/23 2
Calipsa® Digital Watchdog Integration User Guide
Introduction
This guide covers the steps required to integrate your Digital Watchdog cameras with the Calipsa
platform. Other common integration steps, such as configuring your system to send alarms to your gmail
account are also covered.
Digital Watchdog Plugin
Digital Watchdog Plugin Integration for Windows
This guide walks you through the process of installing and setting up the Calipsa Digital Watchdog Plugin
Integration on your Windows-based machine.
System Overview
Running the Installers
After downloading the fourinstallers, ensure that they are not blocked by Windows or any antivirus
software.
Note: VC_redist.exe install must be run first or the installation will not be successful.
1. Runthe installer VC_redist.exe.
2. Runthe installer Win64OpenSSL-1_1_1m.msi.
3. Run the installer for the Plugin: DWPluginSetup.msi and grant admin access when prompted.
4. Run the Installer for the Agent: DWAgentInstaller.msi and grant admin access when prompted.
Note: Running the plugin installer will invoke a MediaServer and Spectrum restart. Ensure that this is not
a problem before the installation.
The Calipsa Agent Service
l
The agent installer will install a Windows service running in the background that is essential for
alarm processing.
C6736M | 03/23 3
Calipsa® Digital Watchdog Integration User Guide
l
When running this installer, please specify an appropriate name for this service and a TCP port
that is vacant on the machine (the defaults areCalipsaDWAgentServiceInstanceand60000,
respectively).
l
The installation can be verified by looking for both respective entries from the Windows Services
application.
Network Access
l
Please make sure that theport numberchosen on the agent installation (60000 by default) is
accessible by the plugin running in the Media Server and not blocked by any firewall rules.
l
Please ensure that theagent servicehas access to the internet such that it can communicate
over HTTPs withdw.calipsa.ioon the remoteport 443.
l
Please ensure that the plugin running within the Media Server has access to the internet such that
it can communicate over HTTPs withdw.calipsa.ioon the remoteport 443.
l
Please ensure that the plugin running within the Media Server can occupyTCP port55000on the
machine. 55000 thus has to be vacant and firewall rules, etc. have to allow this occupation.
Creating a Calipsa Authentication Token
1. Log into the Calipsa Dashboard.
2. Click Settings.
3. Next to Integration, click ...
4. Click Calipsa API.
5. Click Create New Token, and copy it.
6. In Spectrum, go to System Administration > Plugins > Calipsa False Alarm Filtration.
7. Paste the Token into the Calipsa authentication token text field.
Note: If you have not created a client or a site for this instance of Digital Watchdog in the Calipsa
Dashboard yet, do that now.
8. Under Calipsa Host, enter dw.calipsa.io.
9. Under Calipsa's remote port, enter 443
10. Under Calipsa Client name, enter the client name exactly as it appears in Calipsa.
11. Under Calipsa Site Name, enter the site name exactly as it appears in Calipsa.
12. To forward true alarms from Calipsa to Immix, select the Send alarm emails check box.
13. Enter the Immix Server Address for either IP or FQDN.
14. Enter the Immix Server Port number.
15. If access to the servers requires a username and password, enter the necessary credentials.
16. Click Apply.
C6736M | 03/23 4
Calipsa® Digital Watchdog Integration User Guide
Connecting Cameras to Calipsa
Next we can select which cameras Calipsa is supposed to work on. To do this, the plugin needs to be
enabled for the cameras we want
1. Right-click on the camera.
2. Under Camera Settings, select Plugins.
3. Select the toggle to enable the plugin.
4. Ensure that the Camera stream selected in the drop-down list is set to Secondary.
5. Click Apply. Wait a few seconds for the Connection section to become visible.
6. When it’s visible, check theCheck this to register this camera with Calipsa and the Process
motion events checkboxes.
7. Specify a Motion Throttle value in number of seconds.
Note: TheMotion Throttle value specifies the number of seconds Calipsa waits after a motion event has
occurred before considering a subsequent motion event. This will reduce the number of motion events
sent to calipsa for analysis and will reduce the chance of getting duplicate motion events. Use with
caution and in accordance with the camera sensitivity. Too big of a value can mean missing legitimate
motion events.
C6736M | 03/23 5
Loading...