Open

Features

Video Integration

• Manage and view 3VR VMS servers and 3VR cameras

• C•CURE Communication Loss alarms for 3VR VMS servers and 3VR cameras

• C•CURE Video Camera Alarms: Normal, Motion, Analytics, Alarm

• Video Overlays

• Video Snapshots

• Video Export

• PTZ Controls and Presets

Event Integration: C•CURE to 3VR

• C•CURE Action Integration creates events based on C•CURE Actions on the 3VR VMS server

• 3VR Mappings tool enables automatic C•CURE Event and Action creation

Event Integration: 3VR to C•CURE

• 3VR Alert Integration imports alerts from the 3VR VMS server into C•CURE

Limitations

C•CURE Demand Recording

• Starting and stopping demand recording via the Software House interface is not supported in the integration. The 3VR VMS server will automatically record video during this period if there is motion or if continuous recording is enabled. Continuous recording can be enabled using the 3VR System Manager application.

Playing Exported Video

• Exported video may not always play correctly in Windows Media Player. For best performance, VLC player should be used

Event Creation

• If the “Map to 3VR Camera” event is triggered by another event, a 3VR “CCure Event” will not be created on the 3VR VMS server

Event Metadata

• CCure events in 3VR OpCenter may not always have metadata populated in the event details. The amount of metadata populated depends on the type of device that triggered the event in the Software House C•CURE 9000 system

Video Playback

• The 3VR-C•CURE 9000 video integration supports up to 64 simultaneous video streams with a system meeting the minimum system requirements listed on the following page. More cameras may be viewed if hardware that exceeds the minimum system requirements is used

• For the best video performance, video should be displayed using DirectX. This requires that the system have DirectX and a discrete graphics card installed. Video is still available in GDI but the level of performance is lower. Note that typically if you are using remote desktop to access a remote machine, the video will not run in DirectX mode

Audio Playback

• Audio playback is not currently supported in the 3VR-C•CURE 9000 integration

Minimum System Requirements

The 3VR integration has no additional hardware or software requirements beyond the minimum specifications of the Software House C•CURE 9000 system. These specifications are listed on this page.

C•CURE 9000 SERVER

Recommended Hardware And Software

C•CURE 9000 Client Workstation

Recommended Hardware and Software

Other Requirements

• 3VR VisionPoint™ VMS version required: 7.2

• C•CURE versions supported: 2.10

• 3VR Data Integration Plug-In license must be obtained from 3VR Inc. Contact your 3VR sales representative to purchase

• A CC9000-3VR license must be obtained from Software House. Contact your Software House sales representative to purchase

Preparing 3VR VMS Server for C•CURE Integration

Enabling Web Services

The C•CURE integration uses 3VR’s web services feature to connect to the 3VR VisionPoint™ VMS server. Before installing the integration software, you should enable this feature on each unit that will transmit or receive data from C•CURE:

1. Launch 3VR System Manager.

2. In the Configure panel, right-click the name of the VMS server and select Start Web Services from the menu.

3. Click OK to confirm.R

Creating 3VR User Account for C•CURE Integration

Remember to give the C•CURE system login information for an Integrator-level 3VR user account with access to all the VMS servers you plan to use in your integration. We recommend that you create a new user for this purpose. Use the following steps to create a new user account that will be reserved for the C•CURE integration:

1. In 3VR System Manager, click the Accounts tab.

2. Click New.

   Open

   

3. In the New User dialog, configure the details of the new user account that will be used for the C•CURE integration:

   • First Name: enter some text for the first name, such as “C-Cure” (or leave blank)

   • Last Name: enter some text for the last name, such as “User” (or leave blank)

   • User Name: enter a descriptive user name, such as CCureIntegration

   • Password: create a password for the new user account, the retype the password

   • Role: select Integrator from the drop-down menu

   • Auto Sign Out: select Disabled from the drop-down menu

4. Verify that Expire password at a given date and time is not checked.

5. Verify the Authorized Regions and Appliances panel gives this user account access to all 3VR VMS servers that will be used in C•CURE integration.

6. Click Save to create the new user account.

Configuring NTP Server Information

The 3VR VMS server and C•CURE machine must be set to the same date and time in order for the integration to successfully correlate data from both systems. The easiest way to ensure this requirement is met is to configure both machines to sync with the same NTP (Network Time Protocol) server.

Use the following steps to configure this setting on each system:

VMS Server NTP Server Configuration

1. Launch 3VR System Manager.

2. In the Configure panel, select the name of the VMS server in the left-hand panel to view the system settings.

3. Click Common Operations, then click Date and Time Settings.

4. Click ¤ Automatically set time from a remote server.

5. Type the address of the NTP server in the NTP Server box.

6. Click Test Connection and verify that the connection to the NTP server is succesful.

7. Click Save.

8. Click OK in the Confirm Changes dialog box. System Manager will close.

C•CURE 9000 NTP Server Configuration

Consult your C•CURE 9000 documentation for assistance configuring the C•CURE system date and time settings. The C•CURE system should be set to sync with the NTP server address entered in above NTP Server Configuration .

Installing 3VR Integration Software on C•CURE System

1. Log on to the Software House C•CURE system with a user account with administrative access.

2. Double-click the 3VR_C•CureInstaller-Release-7.0.0.98811-final.exe file to launch the InstallShield Wizard.
   It may be necessary to right-click the .exe and select Run as administrator.

3. The C•CURE integration requires the Microsoft .NET Framework 4.0 to function.

4. Click Install to proceed.

5. At the Install Shield Wizard Welcome screen, click Next >.

6. At the Custom Setup screen, specify which component of the integration to install. By default, both components are selected.

   1. Server

      1. If the current machine is the C•CURE server, this should be selected

      2. If it is a C•CURE client PC, click the drop-down arrow and select This feature will not be installed

   2. Client

      1. If the current machine is the C•CURE server and it does not have client software also installed, click the drop-down arrow and select This feature will not be installed

      2. If it is a C•CURE client PC, this should be selected

7. Click Next >.

8. If the Server component was selected in step 5, the Database Server screen will appear. Specify the following:

   • The location of the C•CURE database server

   • How to connect to the database. If not using Windows authentication credentials, select Server authentication using the Login ID and password below and enter the user name and password to use to connect to the database

   • The name of the C•CURE database catalog

9. Click Next >.

10. Click Install to install the software.

11. When installation is complete, click Finish to close the wizard.

Enabling and Starting 3VR Integration Driver

After installing the 3VR C•CURE integration software, use the following steps to enable the 3VR Integration Driver:

1. Launch the C•CURE 9000 Server Configuration Application.

2. In the Services tab, confirm that the Crossfire Server Component Framework is running. If it is stopped, click Start Service to restart it.

3. Click the Server Components tab.

4. Locate the 3VRVideoServerComponent.

5. Click the box labeled Enabled to check it, then click Start Service.

6. Verify that this component’s Status changes to Running.

Video Integration

About Video Integration

3VR’s C•CURE Video Integration allows live and stored video from the 3VR VMS server to be viewed through the C•CURE Administration and Monitoring Workstation application. Use the steps in this section to configure the integration of one or more VMS servers and the cameras connected to those servers.

Managing 3VR VMS Servers

Adding New VMS Server

Use the following steps to add a new 3VR VMS server to C•CURE for video integration:

1. In C•CURE Administration Workstation, click the Video tab in the left-hand panel.

2. Expand the video tree to the location where you wish to create the 3VR VMS server. Typically this will be under the “CompanyName” folder.

3. Right-click this folder and select 3VR Server > New.

Editing Existing VMS Servers

1. In C•CURE Administration Workstation, click the Video tab in the left-hand panel.

2. Expand the video tree to the location of the 3VR VMS Server you wish to edit

3. Double-click the VMS server name (or right click and select Edit) to open the VMS server for editing.

Configuring 3VR VMS Server Settings

The following settings may be configured for each VMS server integrated with C•CURE:

a. Name – The name of the 3VR VMS server. This name will be used to identify the VMS server in the C•CURE system, and does not have to match the display name assigned to the VMS server in 3VR System Manager.

b. Description – A description of the 3VR VMS Server.

c. Enabled – This check box enables or disables the 3VR VMS Server.

In the General Tab:

d. Time Zone – This is the Time Zone of the 3VR VMS server. To configure the Time Zone, click the ... button and select the time zone where the 3VR VMS server is installed from the list.

e. User Name and Password – The user name and password of the 3VR user account created in Creating 3VR User Account for C•CURE Integration topic section.

f. IP Address – The IP Address of the 3VR VMS server.

g. Connect button – This is used to connect the 3VR VMS server. After a successful connection attempt, the Online check box will become checked and the Import Cameras button will become enabled.

h. Import Cameras – Clicking this button will automatically import all enabled analog and IP cameras on the VMS server into C•CURE.

i. Poll Period – This is the interval at which the server is polled for connection information for this VMS server and its cameras.

In the Alarms tab, you may optionally configure an alarm for the current VMS server:

j. Click the Add button to add a new alarm for the VMS server.

k. When the alarm has been added, click the Property column, then click the ... button and select Video Server Alarm.

l. Select an option from the Value drop-down:

• Online: This alarm is activated when the connection to the 3VR VMS server is lost.

• Offline: This alarm is activated when the connection to the 3VR VMS server is regained.

m. Refer to the C•CURE documentation for information about the Action, Details, and Schedules columns.

n. Refer to the C•CURE documentation for assistance configuring the State Images tab.

o. To save, click Save and Close.

Managing 3VR Cameras

Adding a New Camera

Use the following steps to add a new camera to a 3VR VMS server in C•CURE Administration Workstation.

1. Select the Video tab.

2. Navigate to the 3VR VMS server.

3. To add a new camera, right-click the VMS server name and select 3VR Camera > New.

Editing an Existing Camera

If cameras were automatically imported during VMS server configuration (step 7.2.3) they will already be listed under the VMS server name in the Video tab. Use the following steps to view and/or edit the settings of an existing camera:

1. Select the Video tab.

2. Navigate to the 3VR VMS server.

3. Click the arrow to the left of the VMS server name to expand the list of cameras that have been imported or added to the VMS server.

4. Double-click a camera (or right-click and select Edit) to open the camera for editing.

Editing 3VR Camera Settings

The following settings may be configured for each 3VR camera integrated with C•CURE:

a. Name – The name of the 3VR camera. This name will be used to identify the camera in the C•CURE system, and does not have to match the name assigned to the camera in 3VR System Manager.

b. Description – A description of the camera.

c. Enabled – This check box enables or disables the camera.

In the General tab:

d. Camera Type – This is the type of camera. Select Fixed for a standard camera or Dome for a PTZ camera.

e. Number – The display number of the camera.

f. Video Viewer – Displays the current video feed from the camera. This requires the 3VR VMS server to be enabled and connected.

In the Alarms tab, you may optionally configure an alarm for the current camera:

g. Click the Add button to add a new alarm for the camera.

h. When the alarm has been added, click the Property column, then click the ... button and select either Video Camera Alarm or Video loss.

i. A Video Camera Alarm is activated when a particular type of video is recorded. The following options are available in the Value drop-down menu:

• Normal – This alarm is activated when a camera returns to normal from one of the next three states.

• Motion – This alarm is activated when motion is detected on a camera. Note that 3VR records motion-based video by default, and therefore a motion alarm will receive numerous alarms.

• Analytics – This alarm is activated whenever an Alert Watch occurs (see section 8.3 for more information).

• Alarm – This alarm is activated whenever a 3VR Alarm Event occurs.

j. A Video loss alarm is activated when the system detects that the camera is no longer recording. The following states are possible for the Value check box:

• Checked – The alarm will be activated when the video feed is lost on a 3VR camera

• Unchecked – The alarm will be activated when the video feed is regained on a 3VR camera

k. Refer to the C•CURE documentation for information about the Action, Details, and Schedules columns.

l. Refer to the C•CURE documentation for assistance configuring the State Images tab.

m. To save, click Save and Close.

Watching 3VR Video in C•CURE Administration Workstation

Viewing a 3VR Camera

Use the following steps view the video from a 3VR camera in C•CURE Administration Workstation:

1. Click the Video tab in the left-hand panel.

2. In the video tree, navigate to the VMS server with the camera that you wish to view.

3. Click the arrow to the left of the VMS server name to expand the list of cameras.

4. Right-click the camera you wish to view and select one of the following options:

   • View – Opens the camera in a new tab.

   • Popup view – Opens the camera in a pop-up window.

   • View in current tab – Opens the camera in the current tab.

Camera View Options

The following options are available when viewing video from both fixed and PTZ cameras:

• To save the current frame as an image file, select Snapshot and click the Save button. In the resulting dialog, provide a file name for the image and click Save.

• To save the current frame as an image file, select Snapshot and click the Save button. In the resulting dialog, provide a file name for the image and click Save.

• Time Range – Specify the start and end date and time of the stored video you wish to view

• Play – Play back the stored video

• Stop – Stop playing back the stored video

• Pause – Pause the stored video

• Rate – Change the rate of video playback

PTZ Camera Controls

The following controls are only visible if the 3VR camera is set to the Dome camera type:

Event Integration

About Event Integration

The event portion of the integration is designed to allow two way passing of events between the 3VR VMS server and the C•CURE system, such that:

• Access control events occurring in the C•CURE system, such as a door force event, appear as C•CURE event cards in OpCenter with data from the C•CURE system appended to video recorded by 3VR (Refer Creating C•CURE Events in 3VR OpCenter for more information).

• Alerts configured in 3VR OpCenter, such as a watched face or license plate, generate Journal Messages and activate Analytics triggers in C•CURE whenever a 3VR event occurs that triggers the alert (see section Sending 3VR Alerts to C•CURE).

Creating C•CURE Events in 3VR OpCenter

The creation of events in VisionPoint™ VMS with data from the C•CURE system is based on the “Map to 3VR Camera” C•CURE action. This action is used to “map”, or link, a C•CURE device to a 3VR camera. This is required so that we can specify the 3VR camera on which to generate C•CURE event cards within VisionPoint™ VMS. The selected camera ideally should overlook the C•CURE device.

There are two ways to configure events that will trigger the “Map to 3VR Camera”action:

• Use the Mappings tool to automatically generate a C•CURE event with the action predefined (see section Automatically Create C•CURE Events Using 3VR Mappings).

• Manually add the action to an existing or new C•CURE event from the event’s configuration dialog (see section Adding the “Map to 3VR Camera” Action to a C•CURE Event).

Automatically Create C•CURE Events Using 3VR Mappings

Mappings allow the user to automatically create a set of the most common C•CURE alarms quickly and easily. In most scenarios, we recommend using this automatic option over manually configuring a “Map to 3VR Camera” action as described in Adding the “Map to 3VR Camera” Action to a C•CURE Event.

With Mappings, the user selects the C•CURE device and camera that should be mapped, and the software will automatically perform the following tasks:

1. Add Admit, Reject, and Door triggers to the C•CURE door selected in the Mapping dialog.

2. Associate these triggers with a new C•CURE event.

3. Add a “Map to 3VR Camera” action to the new C•CURE event that points to the camera selected in the Mapping dialog.

Use the following steps to create a new mapping:

1. In C•CURE Administration Workstation, click the 3VR tab in the left-hand panel.

2. Right-click Mappings and select New Mapping.

3. Edit the settings of the Mapping as follows:

   1. Name – The name of the Mapping.

   2. Description – A description of the Mapping.

   3. Enabled – This enables or disables the Mapping. Disabling the Mapping will also disable the associated event so no event will be created.

   4. Controller – This is the controller under which the door belongs.

   5. Door – The door to watch for access events.

   6. Appliance – The 3VR VMS server on which the C•CURE event will be created.

   7. Camera – The 3VR camera on which the C•CURE event will be created.

   8. Save and Close – Saves your changes and closes the dialog.

Adding the “Map to 3VR Camera” Action to a C•CURE Event

Use the following steps to manually add a “Map to 3VR Camera” action to an event in the C•CURE system:

1. In C•CURE Administration Workstation, click the Configuration tab in the left-hand panel.

2. Select Event from the drop-down menu at the top of the Configuration tab.

3. Click New to create a new C•CURE event, or to edit an existing event, click the green right arrow icon and then select the event from the list that will populate in the right-hand panel.

4. In addition to the standard event settings such as Name and Description, the following settings must be configured to send the C•CURE event to the 3VR VMS server:

In the General tab:

a. Armed – Should be checked.

In the Action tab:

b. Click the Add button to add a new alarm for the camera.

c. Select Map to 3VR Camera from the Action drop-down menu.

d. Click the ... button next to Server and select the 3VR VMS server to which you wish to send the event.

e. Click the ... next to Camera and select the 3VR camera that should be mapped to the event.

f. Click Save and Close to save the event configuration.

3VR Event Generation Settings

The settings in the Mapping Settings dialog affect the generation of C•CURE events in OpCenter. To access this dialog:

1. In C•CURE Administration Workstation, click the 3VR tab in the left-hand panel.

2. Click Edit Settings.

3. Edit the following settings as desired:

   1. Event Start Time Delta – This is the amount of time before the C•CURE event which to include (Default: 15 seconds).

   2. Event End Time Delta – This is the amount of time after the C•CURE event which to include. (Default: 5 seconds)

   3. Search Start Time Delta – This is the amount of time before the event time of the 3VR C•CURE Event” for which to search for image comparison images (Default: 10 seconds).

   4. Search End Time Delta – This is the amount of time after the event time of the 3VR C•CURE Event for which to search for image comparison images (Default: 10 seconds).

   5. Save and Close – Saves your changes and closes the dialog.

Enabling Demand Video and Image Buffering in 3VR System Manager

The following steps must be performed for each 3VR VMS server that will receive events from the C•CURE system:

1. In the Configure panel of System Manager, click the plus sign next to the VMS server name in the left-hand panel.

2. Click the plus sign next to Cameras to display the list of cameras on the VMS server.

3. For each camera that will receive events:

   1. Select the camera to view its settings.

   2. Change the Allow Demand Image Buffering setting to Yes (On).

   3. Change the Allow Demand Video Recording setting to Yes (On).

   4. Click Save.

Verifying Successful Event Generation

After the event integration has been configured, use the following steps to verify that the C•CURE integration is correctly generating events in OpCenter:

1. In 3VR OpCenter, click the Monitor tab to go to the Monitor panel.

2. Click camera numbers to select the cameras mapped to C•CURE events.

3. Click the arrow below the camera selector to open the event type drop-down menu.

4. Select [√]CCure Event.

5. Click OK.

6. Recent events created on the 3VR VMS server by the C•CURE integration will appear in the Monitor panel.

These events are of the type “CCure Event” and have following data:

Sending 3VR Alerts to C•CURE

This section discusses the passing of 3VR Events with Alerts to the C•CURE system.

About Alert Watch

The Alert Watch is designed to watch for 3VR Events with Alerts and bring that functionality into the C•CURE application. When a 3VR Event with an Alert that is monitored by an active Alert Watch occurs, a C•CURE Journal Message will be created with the format:

3VR Alert ([alert name]) occurred on Appliance ‘[VMS server name]’, Camera ‘[camera name]’.

In addition, whenever the C•CURE integration receives notification from an Alert Watch, it will activate any video camera alarms of type Analytics that have been established for the corresponding camera.

Adding a New Alert Watch

Use the following steps to view and/or edit the settings of an existing Alert Watch.

1. Select the 3VR tab.

2. To add a new Alert Alert Watch, right-click Alert Watches and select New Alert Watch.

Editing an Existing Alert Watch

Use the following steps to view and/or edit the settings of an existing Alert Watch.

1. Select the 3VR tab.

2. Click the plus sign to the left of the VMS server name to display the VMS server’s existing Alert Watches.

3. Double-click the Alert Watch (or right-click and select Edit) to open it for editing.

Editing Alert Watch Settings

1. Name – The name of the Alert Watch.

2. Description – A description of the Alert Watch.

3. Enabled – This enables or disables the Alert Watch.

4. Appliance – The 3VR VMS server on which to watch for an alert with the Alert name specified in (e).

5. Alert – This is the name of the 3VR alert to watch. Whenever a 3VR alert with this name occurs on the 3VR VMS server selected in the previous field, the Alert Watch will write to the C•CURE Journal. In addition, if there is an Analytics Alarm configured on the 3VR camera on which the alert occurred, the analytics alarm will also be triggered.

6. Save and Close – Saves your changes and closes the dialog.

Verifying Successful Alert Watch Configuration

Use the following steps to verify that the Alert Watch has been correctly configured:

1. Configure a test alert in 3VR OpCenter. This should be an alert that is easily triggered (e.g. create an alert for any motion on a camera that is physically accessible to you).

2. Configure an Alert Watch for the test alert as outlined in Installing 3VR Integration Software on C•CURE.

3. Trigger the alert (e.g., walk in front of the camera selected in step 1).

4. Open the OpCenter Monitor panel and verify that an Alert Event was created by your test.

5. In C•CURE Administration Workstation, click the Options & Tools tab.

6. Select Journal and click Run.

7. In the Dynamic View - Journal View window, verify that a “3VR Alert” journal message appears for the Alert Event” generated by your test.

Appendix: A

Checking 3VR Integration Software Version

Use the following steps to check what version of the 3VR Integration Software is currently installed on the C•CURE system:

1. In C•CURE Administration Workstation, click the 3VR tab.

2. Click Settings.

The version number will appear at the bottom of the Mapping Settings dialog.

Appendix: B

General Connection Troubleshooting

Use the following steps to troubleshoot the connection between the VMS server and the C•CURE system.

• Double-check the login information and 3VR VMS server IP address

• Verify that web services is enabled on the 3VR VMS server, refer Enabling Web Services for more information

• Open up the command prompt on the C•CURE machine and ping the IP address of the 3VR VMS server

Troubleshooting the 3VR-C•CURE Integration

If the 3VR VMS server and the C•CURE system are successfully connected but the event or video integration is not functioning correctly, troubleshoot with the following steps:

• Verify that the ThreeVRVideoServerComponent driver has been enabled and started in the Server Configuration Application (see Enable and Start 3VR Integration Driver for more information).

• Verify that the database connection strings are correct.

  1. Launch the C•CURE 9000 Server Configuration Application.

  2. Select the Database Connections tab.

  3. Click the Test Database Connections button.

  4. If the test does not pass, verify that the entries for the following are correct:

• ThreeVR.NextGenConnectionProgram.Common.VideoObjects

• ThreeVR.SoftwareHouseIntegration.Objects.Action

• ThreeVR.SoftwareHouseIntegration.Objects

The value for Data Source in each connection string should be the SQL Server.

Video Retrieved Is From the Wrong Time

• Verify that the Software House C•CURE 9000 system and the 3VR VMS server are time synced (see Configuring 3VR VMS Server Settings for more information).

C•CURE Events in 3VR OpCenter Only Show Partial Video

• Verify that the 3VR camera on which the C•CURE event was created has the Allow Demand Image Buffering and Allow Demand Video Recording settings enabled.

Accessing 3VR Integration Logs

During the course of troubleshooting, 3VR Technical Support may request log files from the 3VR integration software. These files may be copied and sent to 3VR with the following steps:

1. Open Windows Explorer and type %appdata%\3VR into the location bar.

2. Copy the following files to another location on the system (e.g., the desktop):

   • SWH/video.log – contains messages related to video playback and user interface.

   • SWH/event.log – contains messages related to C•CURE Event creation on the 3VR VMS server.

   • VideoAPI/VideoApi.log – contains messages related to the 3VR Video API.

3. Send the log files to 3VR via the web at uploadlogs.3vr.com (user name: techrep, password: 3MeDeee).

Appendix: C

Upgrading 3VR Integration Software

If 3VR has released a new version of the C•CURE integration, use the following steps to upgrade the integration software installed on the C•CURE 9000 machine:

1. Double-click 3VR_C•CureInstaller-1.2.1.xx.exe to begin the upgrade process.

2. The Install Shield wizard will notify you of the upgrade.

3. Click Yes to proceed.

4. At the Install Shield Wizard Welcome screen, click Next.

5. Wait while the upgrade is in progress.

6. When the upgrade is complete, click Finish to exit the wizard.