Adding your SpotterRF server as a tracking system to Security Center - Restricted Security Area Surveillance

RSA Surveillance Integration Guide for SpotterRF Radar Systems

Applies to
Restricted Security Area Surveillance
Last updated
2024-02-12
Content type
Guides > Integration guides
Guides > Plugin and extension guides
Language
English
Product
Restricted Security Area Surveillance

Before you can monitor the restricted areas secured by your SpotterRF radar system in Security Center, you must add each SpotterRF server as a tracking system in Config Tool. If you are using the Inter-System Gateway (IS Gateway), you must first add your server to a driver container in the IS Gateway, and then add the driver container as a tracking system in Config Tool.

Before you begin

What you should know

Procedure

To add your SpotterRF server as a tracking system to Security Center with the IS Gateway:

  1. Log on to the IS Gateway web portal:
    1. Open a web browser and enter the URL https://<GatewayServer>:4242.
      <GatewayServer> is the name or IP address of the server hosting the IS Gateway service. The default port is 4242. Use the port you configured at installation.
    2. Accept the security certificate.
    3. On the logon page, enter the Username and Password and click Sign in.
      The username and password were assigned during the Inter-System Gateway Configuration step of the IS Gateway service installation.
  2. Add a driver container for the tracking system that you want to add to Security Center:
    1. On the homepage of the IS Gateway, click the Container () tab.
    2. Click the button besides the docker engine label, and then click Add driver container.
      IS Gateway web portal - Add Driver Container dialog box.
    3. In the Add Driver Container window that opens, enter the following information:
      Driver
      Select the driver that you want to install.
      Version
      Select the driver version that you want. The latest version is selected by default.
      Label
      Label used to identify this driver container in the list of containers on the left.
      Port
      Port used to communicate with the driver.
      Network adapter
      Select the network adapter used by the driver to communicate with the IS Gateway service.
      Show advanced
      Some drivers require other communication ports to be open. If necessary, click here to add those ports.
    4. Click Add.
      The IS Gateway immediately downloads the required driver container image from the repository. A notification is shown in the upper right corner of the browser page during the download process.
      New driver creation notification in the IS Gateway web portal.

      After the download completes, the new driver container is displayed in the list of containers on the left, under the selected docker engine.

      IS Gateway web portal showing a new driver container.
    5. Start the driver container. To do so, click the button beside the driver container label and click Start.
    NOTE: If you are adding multiple driver containers, make sure that each driver container has a unique port number. This will prevent any port conflicts if multiple driver containers are running at the same time.
  3. Select the driver container corresponding to the tracking system that you want to add to Security Center.
  4. In the Communication section, enter the following information:
    IS Gateway web portal - Communication section in the SpotterRF driver container.
    IP Address
    The IP address of the server that hosts the NetworkedIO's API.
    Port
    The TCP/IP port for remote access that was configured in the NetworkedIO application.
    Username and password
    The administrator-level credentials of the NetworkedIO application.
  5. Click Save.
  6. Add your driver container as a tracking system to Security Center:
    1. From the Config Tool homepage, open the Plugins task.
    2. From the entity tree, select the Restricted Security Area Surveillance plugin role.
    3. Click Add an entity (), and select Tracking system.
      The Add tracking system dialog box opens.
    4. From the Type drop-down, select Inter-System Gateway.
    5. In the Name field, enter a name for your tracking system.
    6. From the Model drop-down, select the driver container you are adding and click Next ().
    7. If applicable, configure the specific settings for your driver and click Next ().
    8. If applicable, import the map from the third-party application and click Finish.
    9. Open the Area view task.
      After a few seconds, your tracking system () should be added to the area view.
  7. In the SpotterRF NetworkedIO application, create a push action script that connects to the driver.
  8. Create RSA zones.
  9. Trigger an intrusion event in a SpotterRF radar zone to confirm that SpotterRF is communicating with the plugin.
    In the Alarm monitoring task, an intrusion detection alarm from the radar is reported.

To add your SpotterRF server as a tracking system to Security Center without the IS Gateway:

  1. From the Config Tool homepage, open the Area view task.
  2. Click Add an entity (), and then select Tracking system.
    The Add tracking system wizard opens.
  3. On the Tracking system information page, enter the following information:
    Type
    Select SpotterRF.
    Name
    Enter a unique name for this tracking system.
  4. On the Communication page, enter the following information:
    Server
    The IP address of the server that hosts the NetworkedIO's API.
    Port
    The TCP/IP port for remote access that was configured in the NetworkedIO application.
    User and password
    The administrator-level credentials of the NetworkedIO application.
  5. Define the connection settings for the RSA HTTP server:
    Listening port
    The HTTP port for this HTTP server. The port number must be unique for each SpotterRF tracking system that is added to Security Center.
    User and password
    Enter a username and password. These case-sensitive credentials are used by the SpotterRF push action script to authenticate to the RSA HTTP server.
    The plugin creates an HTTP server locally for this SpotterRF tracking system. A NetworkedIO push action script will connect to this HTTP server to communicate and push target movements for the SpotterRF radar zones.
  6. Click Refresh connection status () to connect.
  7. Click Next page ().
  8. On the RSA configuration page, enter the following information:
    Import on map
    Select the map that you want to use to display the devices in Security Center.
    Events
    Turn on the custom events that you want to monitor for this tracking system.
    NOTE: You can modify this later on the Properties page of the tracking system.
  9. Click Finish.
    The SpotterRF server and its devices are listed in the Area view entity tree.
  10. In the SpotterRF NetworkedIO application, create a push action script that connects to the RSA HTTP server.
  11. Create RSA zones.
  12. Trigger an intrusion event in a SpotterRF radar zone to confirm that SpotterRF is communicating with the plugin.
    In the Alarm monitoring task, an intrusion detection alarm from the radar is reported.