Video Monitoring
This chapter describes how to view live and recorded video streams from security cameras configured in the Cisco Video Surveillance Manager (Cisco VSM) system. Using Cisco PAM, you can associate these cameras with a door, and then view live and archived video for that door. While viewing live video, you can also invoke a door command, or use the pan, tilt and zoom (PTZ) controls, if available on the camera.
For example, if an alarm occurs, you can view an archived video clip when the alarm occurred, or open a live video stream for a camera associated with the door. Command options in the video player allow you to perform actions such as securing or opening the door.
In addition, the Camera Manager can display multiple live video streams in a grid arrangement, allowing a user to monitor multiple cameras at once.
Tip
•
If a camera is deleted from the Cisco VSM configuration, it is disabled in Cisco PAM, but not removed. We recommend that you do not manually remove or delete cameras from the Cisco PAM configuration. Use the synchronize command to update the camera inventory, if necessary, as described in Managing the Camera Inventory.
•
For more information on Cisco Video Surveillance Manager, go to the Cisco Network-Centric Video Surveillance Products website.
Note
Problems may occur when viewing video from analog cameras that use Cisco Stream Manager IP Gateway Encoder CIVS-SGxx. Contact your Cisco support representative for details.
Contents
•
Enabling Video Monitoring
–
Configuring the Camera Driver
–
Associating Cameras with Doors and Devices
–
Installing the Cisco VSOM Video Client Desktop Application
•
Viewing Video
–
Viewing Live Video in a Grid Arrangement
–
Viewing Video for an Event
•
Defining the Duration of Event Video Recording
•
Managing the Camera Inventory
–
Updating the Camera Inventory
–
Deleting the Cisco VSM Cameras
–
Deleting Individual Cameras
•
Recording Motion Events from Cisco VSM Cameras
Enabling Video Monitoring
To enable video viewing in Cisco PAM, add the camera driver and associate the Cisco VSM cameras with specific doors and devices.
In addition, install the Cisco VSOM Video Client on each workstation. This player includes the ActiveX controls required for event video viewing. Reinstall the player anytime the Cisco VSM server is upgraded.
Complete the following instructions to enable video monitoring:
•
Configuring the Camera Driver
•
Associating Cameras with Doors and Devices
•
PC Workstation Requirements for Live Video Viewing
•
Installing the Cisco VSOM Video Client Desktop Application
Configuring the Camera Driver
Add the VSM Camera Driver to enable video sharing and playback with the Cisco VSM system:
|
|
|
Step 1 |
Select Hardware from the Doors menu. |
|
Step 2 |
Right-click the Driver Manager and select New Cisco VSM Camera Driver |
|
Step 3 |
Enter the driver name in the properties window. For example: Cisco VSM Camera Driver . Note Verify that the Enabled checkbox is selected (default). |
|
Step 4 |
Enter the camera Player Preferences: • Player width: the width of the video player in pixels. • Player height: the height of the video player in pixels. • Maximum player instances: limits the number of simultaneous video players that can be open on the desktop at a time. Enter a number from 1 to 16. Enter a number at least three greater than the number of required screens. This allow pop-up video screens from critical alarms to display, such as from a duress alarm. See also PC Workstation Requirements for Live Video Viewing. • Position: the position on the screen where the video player appears. If the position is set to Center, the video player opens in the center of the screen each time it is launched.
Tip
The VSM Config tab displays VSM server settings. See
Step 7 to enter settings.
|
|
Step 5 |
Click Save and Close to close the window. |
|
Step 6 |
Right-click the VSM Camera Driver and select Start to enable the Cisco PAM video features. Note Verify that the driver status reads Started. |
|
Step 7 |
Enter the Cisco VSM server settings. Note Do not change the database name or port number once they are configured. a. Right-click the Cisco VSM Camera Driver and select Setup Cisco VSM.
Tip
These fields are disabled if the camera driver was previously set up and includes cameras.
b. Enter the Run Frequency (in minutes): the time between Cisco PAM / VSM synchronization. Cameras added or removed from Cisco VSM are updated in Cisco PAM. If the camera inventory changes often, enter a low number. If the inventory changes rarely, enter a high number. The default is 30 minutes. c. Enter the Database name: the name of the Cisco VSM database. The default is bas . d. Enter the Server name: the name or IP Address of the Cisco VSM database server. e. Enter the Port number: the port number for the Cisco VSM database server. The default is 3306 . f. Click OK to save the changes and close the window. |
|
Step 8 |
Right-click the VSM Camera Driver and select Synchronize with Cisco VSM to populate Cisco PAM with the Cisco VSM cameras. |
|
Step 9 |
Verify that the Cisco VSM cameras appear as children of the Camera Driver. If the cameras do not appear, see Updating the Camera Inventory. Note Cameras in Cisco PAM are organized in the same camera groups as Cisco VSM. In Cisco PAM, each camera can only appear in one group. In Cisco VSM, cameras can appear in multiple groups. Note If a camera is deleted from the Cisco VSM configuration, it is disabled in Cisco PAM, but not removed. We recommend that you do not manually remove or delete cameras from the Cisco PAM configuration. Use the synchronize command to update the camera inventory. |
|
Associating Cameras with Doors and Devices
When a camera is associated with a door or device, you can view recorded video clips for the events that occur on that device, or open a live video stream for the camera from event entries. When viewing live video, you can also invoke commands for the door or device.
For example, if you assign a camera to the door configuration Lab 1
, you can right-click an event for that door to view live or recorded video for that door.
To associate a camera with a door or device, do the following:
|
|
|
Step 1 |
Select Devices in Camera View from the Events & Alarms menu, in the Video sub-menu. |
|
Step 2 |
Drag and drop the devices and doors from the left window pane to the cameras listed on the right. You can associate cameras with more than one device, and devices can be associated to more than one camera.
Tip
Be sure to associate cameras only with devices that are in the camera's view.
Note If the correct cameras do not appear, see Updating the Camera Inventory. |
|
Step 3 |
(Optional) You can also associate cameras with devices by editing the camera properties. a. Double-click the camera in the Video or Hardware windows. The Edit - Camera window opens. b. Select the Devices in View tab. c. Check the devices to be associated with the camera. Associated cameras are listed in the far-right table. d. Click Save and Close. |
|
Step 4 |
(Optional) Exit and relaunch the CPAM client to ensure the camera associations appear correctly in the Events window.
Tip
In the main Events window, you can display a Video column to signify if a camera is associated with a door or device. Click
Columns in the menu bar, check the
Video box and click
OK. The Video column displays three dots if a camera is associated with the door or device.
|
|
Tip
For more information about configuring Cisco VSM cameras, see the Cisco Video Surveillance Manager User Guide.
PC Workstation Requirements for Live Video Viewing
Table 13-1 describes the recommended baseline configuration for a monitoring workstation that displays video from Cisco Video Surveillance Manager (VSM) 6.3. A workstation with this configuration was used to determine the recommended maximum video loads. This configuration assumes that the workstation is dedicated to video. Running other software, such as firewalls, antivirus applications, CD/DVD burning utilities, and general-purpose applications will reduce the quality of the user experience.
Table 13-1 Video Surveillance Monitoring Workstation Recommended Baseline Specification
|
|
OS |
Windows XP Professional 32-bit, SP3 |
CPU |
Intel 950 i7 Core - 3.07 GHz |
Memory |
6 GB DDR3 |
Graphics |
NVIDIA GeForce GTX260 896MB PCIe |
Cisco VSOM configuration |
VMR mode enabled |
Browser |
Microsoft Internet Explorer 7 |
Network connection |
Gigabit Ethernet (GigE) network connection required |
Display configuration |
Single monitor |
For related information, see Video Surveillance Monitoring Workstation Recommended Baseline Specification, which is available here:
http://www.cisco.com/en/US/products/ps10818/prod_technical_reference_list.html
Installing the Cisco VSOM Video Client Desktop Application
The Cisco VSOM Video Client includes the ActiveX controls required for event video viewing. Install the player to enable the video features, or anytime the Cisco VSM server is upgraded. When the player is installed, any existing version is automatically deinstalled.
Step 1
Verify that all PC workstations meet the PC Workstation Requirements for Live Video Viewing.
Step 2
Configure the VSM Camera Driver, as described in Configuring the Camera Driver.
Step 3
Highlight the VSM Camera Driver.
Step 4
Click the VSOM Video Client (install link) to open the Cisco VSM download page in a web browser.
Step 5
Enter the Cisco VSM username and password supplied by your systems administrator.
Step 6
Click the link for the VSOM Video Client.
Step 7
Follow the on-screen instructions to save the installation file to your local drive.
Step 8
Double-click the installation file and follow the on-screen prompts to install the VSOM Video Client on your PC.
Viewing Video
You can view multiple live video streams in a grid arrangement, or view live and archived video for an event. When viewing live video, you can invoke commands for the doors and devices associated with the camera.
Tip
You can also right-click the cameras listed under the VSM Camera Driver (in the Hardware module) and select View Live Video.
This section includes the following instructions:
•
Viewing Live Video in a Grid Arrangement
•
Viewing Video for an Event
Viewing Live Video in a Grid Arrangement
The Camera Manager allows you to view multiple video streams in a grid arrangement, and invoke commands for the devices associated with the cameras. For example, you can simultaneously monitor the video streams from four cameras, and manually trigger a command, such as grant door access, for a door associated with a camera.
|
|
|
Step 1 |
Select Camera Manager from the Events & Alarms menu, in the Video sub-menu. |
|
Step 1 |
Click the Layouts menu and select a layout that includes the number of cameras you want to view. |
|
Step 1 |
(Optional) You can also select a pre-defined arrangement. |
|
Step 2 |
Select the cameras for viewing: a. Expand the hardware tree to locate a camera. b. Drag each camera icon onto a window pane to view live video from that camera.
Tip
To remove the camera, click and drag the title bar of the camera screen off the grid.
|
|
Step 3 |
(Optional) Invoke a command for a device associated with a camera. For example, to deny access to a door. a. Click the Device Commands button to show (or hide) the command options. b. Select a Device. c. Select a Command.
Tip
The commands are also available by right-clicking the camera name in the Hardware module.
d. Click Execute. e. If additional options are available, select an option from the pop-up window and click OK. |
|
Step 4 |
(Optional) Operate the pan, tilt, and zoom (PTZ) camera controls, if available. • Click View PTZ to show (or hide) the controls. This option only appears for PTZ cameras. • Use the arrows to pan and tilt the camera view. Use + and - to zoom. • Select a PTZ preset from the Switch to drop-down menu. |
|
Step 5 |
(Optional) Save the camera view as an Arrangement. a. Click Save or Save As to save the current camera layout as an Arrangement. b. Enter the arrangement name and click OK. The layout name appears in the window title bar. |
|
Step 6 |
(Optional) Create or modify additional arrangements using the menu bar controls: • Layout: selects a blank layout to display video from one or more cameras. • Arrangement: selects a previously saved Arrangement of views and cameras. • New: creates a new screen of views and cameras. • Save: saves the current view as an Arrangement. • Save As: saves the Arrangement under a different name. • Delete: deletes the current layout. |
|
Viewing Video for an Event
If a device or door is associated with a camera, and an event occurs for that device, you can view archive video for the event (if an archive feed has been configured for the camera). To define how much video to display before and after events occur, see the "Defining the Duration of Event Video Recording" section. For example, video event archives can begin 30 seconds before the event occurred, and continue 20 seconds after the event occurred. If the archive is not available, an error message appears (for example, if the event video occurred previous to the archive window).
You can also view live video from the camera that captured the event.
Event video includes the following options:
•
View Live Video—view live video from the camera associated with the event.
•
View Event Video—view the video archive for the event.
•
View Live and Event Video—open both live and archive video windows.
•
Show Camera Arrangement— displays all camera arrangements that include the camera associated with the event. If the camera is not included in any camera arrangements, then this option is disabled (grayed out).
Usage Notes
•
In the main Events window, you can display a Video column to signify if a camera is associated with a door or device. Click Columns in the menu bar, select Video, and click OK. The Video column displays three dots if a camera is associated with the door or device. To ensure the stars appear correctly, you must exit and relaunch the CPAM client after associating cameras with a device or door.
•
Beginning with Release 1.3.0, you can assign cameras to a location. The camera location allows you to configure event policies for a group of cameras based on location. For example, you can suppress event and alarm notifications of motion events from cameras in a high traffic area during normal business hours. To assign a location to a camera:
–
Select Camera Manager from the Events & Alarms menu, in the Video sub-menu.
–
Right-click a camera name.
–
Click the Location tab.
–
Select a location from the Hierarchical Location menu.
–
Click Save and Close.
Tip
You can also edit the camera location using the Hardware module. Right-click a camera name and choose Edit. Select the Location tab and choose a Hierarchical Location from the drop-down menu.
Procedure
|
|
|
Step 1 |
Select Events from the Events & Alarms menu. |
|
Step 2 |
(Optional) In the main Events window, display the Video column to signify if a camera is associated with a door or device. a. Click the Columns button in the menu bar. b. Check the Video box. c. Click OK. d. In the main Events window, click the Video column header to sort the events and display the video events at the top of the list.
Tip
The Video column displays three dots if a camera is associated with the door or device.
|
|
Step 3 |
Select a video option from the right-click menu: a. Right-click an event or alarm entry. b. Select a camera from the command menu. c. Select a view option: – View Live Video—view live video from the camera associated with the event. – View Event Video—view the video archive for the event. – View Live and Event Video—open both live and archive video windows. – Show Camera Arrangement—displays all camera arrangements that include the camera associated with the event. If the camera is not included in any camera arrangements, then this option is disabled (grayed out).
Tip
The video and camera options appear only if video is available for that event.
|
|
Step 4 |
(Optional) You can also select the video options from the event detail window. a. Double-click an event or alarm entry. b. In the detail window, click a viewing option: View Live Video, View Event Video, View Live and Event Video, or Show Camera Arrangement.
Tip
The video and camera options appear only if video is available for that event.
|
|
Step 5 |
When viewing recorded event video, use the controls under the video display to fast forward, rewind, pause, or play the clip.
Tip
Press the Rewind or Forward buttons multiple times to increase the speed. You can playback or rewind video at 1x, 2x, 3x, or 4x.
|
|
Step 6 |
When viewing live video, you can use the device commands for an associated device or door, or use the PTZ controls for the camera. Device Commands a. Click Device Commands to show (or hide) the controls. b. Select a device. c. Select a command. d. Click Execute. e. If additional options are available, select an option from the pop-up window and click OK.
Tip
The commands are the same commands available by right-clicking the device in the Hardware module.
PTZ Controls Click View PTZ to show (or hide) the controls. This option only appears for PTZ cameras. • Use the arrows to pan and tilt the camera view. Use + and - to zoom. or • Select a PTZ preset from the Switch to drop-down menu. |
|
Defining the Duration of Event Video Recording
By default, event video is recorded for 5 seconds before the event occurs, and 5 seconds after the event occurs. To change the number of seconds event video is recorded, do the following:
Step 1
Select System Configuration from the Admin menu.
Select the Events/Alarms sub-menu.
Figure 13-1 System Configuration Events/Alarm Window
Step 2
Enter the following:
Length of video to display pre-event |
The number of seconds of video that are included before the event occurred. |
Length of video to display post-event |
The number of seconds of video that are included after an event occurs. |
Step 3
Click Save.
Step 4
Log out and log back in to the Cisco PAM application to activate the changes (select Logout from the Options menu).
Managing the Camera Inventory
•
Updating the Camera Inventory
•
Deleting the Cisco VSM Cameras
•
Deleting Individual Cameras
Updating the Camera Inventory
The list of available Cisco VSM cameras is automatically updated as cameras are added or removed from the Cisco VSM system. In most situations, users do not need to update or manage the camera inventory. However, if the camera list is not accurate, do one of the following, in the order shown:
Tip
•
Entering the Restart, Setup VSOM, or Synchronize with Cisco VSM commands will retrieve the camera inventory, regardless of the configured run frequency. It may take up to a minute to synchronize the inventory. After the initial synchronization, the inventory is updated based on the scheduled run frequency.
•
If a camera is deleted from the Cisco VSM configuration, it is disabled in Cisco PAM, but not removed. We recommend that you do not manually remove or delete cameras from the Cisco PAM configuration. Use the Synchronize with Cisco VSM command to update the camera inventory.
|
|
Revise the time span between automatic synchronization: a. Right-click the Cisco VSM Camera Driver and select Setup Cisco VSM. b. Enter the Run Frequency (in minutes): this defines the time between synchronization. Cameras added or removed from Cisco VSM are updated in Cisco PAM. If the camera inventory changes often, enter a low number. If the inventory changes rarely, enter a high number. The default is 30 minutes. c. Click OK to save the changes and close the window.
Tip
These fields are disabled if the camera driver was previously set up and includes cameras.
|
|
Right-click the Cisco VSM Camera Driver and select Synchronize with Cisco VSM. This command manually synchronizes Cisco PAM with the Cisco VSM inventory. |
|
If the camera inventory is still not correct, restart the camera driver: right-click the Cisco VSM Camera Driver and select Restart. Verify that the driver reset was successful. a. Select Alarms from the Events & Alarms menu, in the Monitoring menu. b. Verify that the following three events are listed as succeeded: – archive data fee – live data feed – camera data feed |
|
If the camera list is still not accurate, continue to the following section: Deleting the Cisco VSM Cameras. |
|
Deleting the Cisco VSM Cameras
In some situations, the camera inventory may need to be deleted (for example, following a Cisco VSM server change). This is necessary only if the camera listing remains incorrect after completing the instructions in Updating the Camera Inventory.
If problems remain, select the camera driver command Delete All Cameras. This command deletes the Cisco PAM cameras and downloads a new, updated list from the Cisco VSM server.
Deleting the cameras does the following in Cisco PAM.
•
Removes the Cisco VSM server configuration.
•
Removes the history of all cameras from the Cisco PAM database.
•
Deletes all events and audit records for the cameras.
•
Deletes the entire camera inventory.
Note
To successfully reset the camera database, you must remove all camera associating in the Camera Manager and Graphic Maps, as described in the following instructions.
To delete all cameras from Cisco PAM and reload the camera inventory from the Cisco VSM server, do the following:
|
|
|
Step 1 |
Remove all camera references from the Camera Manager layout arrangements, and from any Graphic Map. a. Select Camera Manager from the Events & Alarms menu, in the Video sub-menu. b. Select each arrangement, and click and drag the title bar of each camera off the grid.
Tip
You can also delete the arrangement to remove the camera references.
c. Click Save. d. Select Graphic Map Editor from the Admin menu. e. Select any maps that include cameras. f. Right-click each camera icon and select Remove Device Icon.
Tip
You can also delete the entire map to remove the camera references.
g. Click Save. For more information, see the following: • Viewing Live Video in a Grid Arrangement. • Graphic Map Editor, page 10-42. |
|
Step 2 |
Enable the Delete All Cameras command and the Allow deletion of devices with events option in the System Configuration settings. Note The the Delete All Cameras command only appears after you enable it in the System Configuration window. Note The the Delete All Cameras command will fail to complete if you do not enable the Allow deletion of devices with events option. a. Select System Configuration from the Admin menu. b. Select the Cisco Settings sub-menu. c. Select the check-box for Display Delete All Cameras command on the camera driver. d. Select the Miscellaneous sub-menu. e. Select the check-box for Allow deletion of devices with events. This allows cameras with associated events to be deleted from Cisco PAM. f. Click Save. g. To activate the change, stop and then restart the Cisco PAM server. See Using the Web Admin Menus, Commands and Options, page 2-16 for instructions. |
|
Step 3 |
Delete the cameras from Cisco PAM: a. Open the Hardware module. b. Right-click the Cisco VSM Camera Driver. c. Select the Delete All Cameras command. d. Click OK when the warning message appears. All events, alarms and audit messages for the cameras will be deleted. |
|
Step 4 |
Verify that the deletion was successful. • If the action succeeds, all cameras are removed from the camera driver. An event is displayed: "Cisco VSM Camera Driver command Succeeded: Reset Cameras". Continue to Step 5. • If the action fails, some cameras are still displayed under the camera driver. If this occurs, do the following: a. View the event Description and Data fields to locate the issue. —The event is: "Cisco VSM Camera Driver command failed: Reset Cameras". —Open the event to view the event Data and identify the camera(s). For example: "References found; Analog Camera - WV-CP484- Graphic Maps: map1-256map5-2.6MB,B10-3, map4,B28-1, Analog Camera - WV-CP484- Camera Arrangements: one." b. Locate and delete the remaining camera references from Camera Manager and the graphic maps (see Step 1. c. Restart the camera driver to restore the full camera inventory (right-click the Cisco VSM Camera Driver and select Restart). The Delete All Cameras command only works when the complete inventory is present. d. Invoke the Delete All Cameras command again, as described in Step 3. |
|
Step 5 |
After the Delete Cameras command is successful, restart the camera driver: right-click the Cisco VSM Camera Driver and select Restart. |
|
Step 6 |
Verify that the driver reset was successful. a. Select Alarms from the Events & Alarms menu, in the Monitoring menu. b. Verify that the following three events are listed as succeeded: – archive data fee – live data feed – camera data feed |
|
Step 7 |
Re-enter the Cisco VSM server settings: Note Do not change the database name or port number once they are configured. a. Right-click the Cisco VSM Camera Driver and select Setup Cisco VSM. b. Enter the Run Frequency (in minutes): the time between Cisco PAM / VSM synchronization. Cameras added or removed from Cisco VSM are updated in Cisco PAM. If the camera inventory changes often, enter a low number. If the inventory changes rarely, enter a high number. The default is 30 minutes. c. Enter the Database name: the name of the Cisco VSM database. The default is bas . d. Enter the Server name: the name or IP Address of the Cisco VSM database server. e. Enter the Port number: the port number for the Cisco VSM database server. f. Click OK to save the changes and close the window.
Tip
Entering the
Restart,
Setup VSOM, or
Synchronize with Cisco VSM commands will retrieve the camera inventory immediately, regardless of the configured run frequency. After the initial synchronization, the inventory is updated based on the scheduled run frequency.
|
|
Deleting Individual Cameras
To delete individual cameras, do the following:
Tip
See Deleting the Cisco VSM Cameras for information on a single command to delete all cameras.
Step 1
Remove the camera associations (for the camera to be deleted) from the Camera Manager arrangements, and from any Graphic Map.
Tip
You can also delete the entire camera arrangement or graphic map to remove the associations.
Step 2
Enable the Allow deletion of devices with events option in the System Configuration settings.
g.
Select the Miscellaneous sub-menu.
a.
Select the check-box for Allow deletion of devices with events. This allows cameras with associated events to be deleted from Cisco PAM.
b.
Log out and log back in to the Cisco PAM application to activate the changes (select Logout from the Options menu).
Step 3
(Optional) Right click the camera and select Disable. Cameras that were removed from Cisco VSM server are disabled by default. This command is only necessary if you want to remove a camera that is included in the Cisco VSM server inventory.
Step 4
Select All Devices from the Filter menu to display the disabled device.
Step 5
Right click the camera and select Delete.
Tip
If the camera is still associated with Camera Manager arrangements or graphic maps, an error message describes the location of the associations. Remove the associations and issue the
Delete command again.
Step 6
Click OK to confirm that all associated events will be deleted.
Note
See Disabling or Deleting a Device or Door, page 6-19 for more information.
Recording Motion Events from Cisco VSM Cameras
This section includes instructions to record start motion and stop motion events for Cisco VSM cameras in Cisco PAM. When a motion event occurs, the system can optionally open a video pop-up window.
Tip
See the Cisco Video Surveillance Manager User Guide for more information.
Procedure
Step 1
Configure the Camera Driver as described in Configuring the Camera Driver.
Skip to Step 2 if the camera driver is already configured.
Step 2
Install the API license on the Cisco PAM server.
•
The API license allows Cisco VSM to post events to a Cisco PAM URL. If the optional API license is not installed, API requests to the Cisco PAM server return an error.
•
To install the optional license, see the "Overview" chapter of the Cisco Physical Access Control API Reference Guide. See also the "Obtaining and Installing Optional Feature Licenses" section on page 2-42.
•
Skip to Step 3 if the API license is already installed.
Step 3
Verify that Cisco PAM Web Services are enabled:
Note
Skip to Step 4 if Cisco PAM Web Services are already enabled.
a.
Log on to the Cisco PAM Server Administration utility, as described in the "Logging on to the Cisco PAM Server Administration Utility" section on page 2-2.
b.
Select the Monitoring tab and then select Status.
Note
The Status window appears by default. This window also appears when you first log on.
c.
Verify that the Web Service API service is Enabled (Figure 13-2).
Figure 13-2 Web Service API Status
Note
The message Web Services license not applied appears if the API license is not installed. You must purchase and install the API license to record start motion and stop motion events. See Step 2.
Step 4
(Optional) To open a video pop-up window for door events, associate a door with the camera:
a.
Expand the Logical Driver to display the configured doors, as shown in Figure 13-3.
Figure 13-3 Devices in Camera View: Door to Camera Association
b.
Drag and drop a door from the left Devices pane to a camera in the right Cameras pane.
The door is displayed as a child of the camera.
Step 5
Identify and record the Camera ID, as shown in Figure 13-4.
The Camera ID is used in the URL used to call the event, as described in Step 6.
a.
Select Hardware from the Doors menu.
b.
Expand the Camera Driver to display the available cameras.
c.
Right-click a camera and select Edit from the drop-down menu.
d.
Select the CameraConfig tab.
e.
Record the number displayed in the Camera ID field.
Figure 13-4 Locating the Camera ID
Step 6
Add a URL Notification to the motion event using the Cisco Video Surveillance Operations Manager (Cisco VSOM) web-based software.
Note
Only Cisco VSM events configured with URL notifications are sent to Cisco PAM.
a.
Use a PC to log in to the Cisco VSOM web-based software:
–
Start Internet Explorer.
–
Enter the IP address or the host name of the server that is running Cisco VSOM.
–
Enter your username and password.
–
Click OK.
–
The VSOM Operator page appears (see Figure 13-5).
b.
Click Admin to open the Administrator pages.
c.
Click Event to open the event configuration page.
d.
Create a new motion event, or edit an existing event, as described in the "System Management" chapter of the Cisco Video Surveillance Manager User Guide.
e.
Select the Motion Start or Motion Stop tab for the event.
f.
Select the Alerts tab.
g.
Select the Enable URL Notification check box.
h.
Enter the Cisco PAM URL for the motion event in the following format:
http://cpam-ip-addr/acws/services/acvsm/recordCameraEvent?cameraId=number&eventType=type&eventTime=time_value
The URL includes the following parameters:
–
cpam-ip-addr: the IP address of the Cisco PAM server.
–
number: the cameraId number recorded in Step 5. For example: 65
.
–
type: the eventType. For example:CB.MOTION_START
or CB_MOTION_STOP
–
time_value: the eventTime. Enter a timestamp or 0 for the current time.
In the following example, the Camera ID is 65, the Event Type records motion Start events, and the Event Time is "0". An event time of "0" records events for the current time.
http://10.10.10.2/acws/services/acvsm/recordCameraEvent?cameraId=65&eventType=CB.
MOTION_START&eventTime=0
i.
Click Submit to save the changes.
Figure 13-5 Enable URL Notification in the Cisco VSOM Events Configuration Page
Step 7
View the motion events in Cisco PAM Events:
a.
Launch the Cisco PAM software and log in, if necessary.
b.
Select Events from the Events & Alarms menu, under the Monitoring sub-menu.
c.
Sort or search for the event, as described in the "Viewing Events" section on page 10-3.
Figure 13-6 shows an example of a Camera Motion Start event. Double-click the event entry for additional details.
Figure 13-6 Camera Events in Cisco PAM
Triggering Camera Actions and Video Recording in Cisco VSM
Events in Cisco VSM can use a soft trigger to perform an action (such as adjusting a camera PTZ setting). The soft trigger is activated when Cisco VSM receives a URL from an external system, such as CPAM.
For example, when a door is forced open, a Door Forced Open event is generated and a URL is sent to Cisco VSM. Cisco VSM then executes actions based on that URL, such as panning the camera and sending and creating an archive. The process works as follows:
1.
Create a event in Cisco VSM, and choose the Enable Soft Trigger option. A URL used to trigger the event is automatically generated and displayed.
2.
In CPAM, create a URL action using the Cisco VSM URL that was automatically generated when you created the VSM soft trigger.
3.
In CPAM, create an automation rule (Global I/O rule) that triggers the URL action when a door forced open event occurs.
4.
CPAM sends the URL to Cisco VSM.
5.
When Cisco VSM receives the URL, the camera pans and a video archive is created.
Figure 13-7 illustrates this example.
Figure 13-7 Soft Trigger Event in Cisco VSM
Tip
See the Cisco Video Surveillance Manager User Guide for instructions to create Cisco VSM soft triggers.