aviGILon Control Center System User Guide

: June 12, 2024
: aVIGILON

aviGILon Control Center System

aviGILon Control Center System PRODUCT

Product Information

The Avigilon Control Center (ACC) System Integration Guide provides instructions on how to integrate the Avigilon Control Center software with the OnGuard software. This integration allows users to access ACC features through the OnGuard interface, including live and recorded video viewing, video event and analytics viewing, video exporting, and PTZ device control.
Requirements
For More Information
For more information about the procedures outlined in this guide, refer to the following specific software documentation:

Avigilon Control Center Client User Guide
Avigilon Control Center Server User Guide
OnGuard Alarm Monitoring User Guide
OnGuard VideoViewer User Guide
OnGuard Installation Manual

What’s New

Improved compatibility with OnGuard 8.1
Added support for Avigilon ACC SDK 6.14.28.2

Product Usage Instructions

Installation

Note: If you are upgrading the integration, uninstall the previous version from the Gallagher server and all connected clients before installing this version. Camera and event configurations for Avigilon devices will be retained in Gallagher Command Centre.

Servers

Add the LenelS2 Integration NVR licence (ACC6-LENL-ONGRD) to an Avigilon Control Center Server in the Site. The integration will be able to access all cameras in the Site that the server is connected to.
Visit the Avigilon Access Control Integrations page and scroll down to the section titled “Lenel Onguard Video & Event Viewer”.
Download the .zip file corresponding with the server’s Event Viewer version and unzip it.
Install the DirectX® End-User Runtimes included in the .zip file on each LenelS2 server using the Avigilon LenelS2 Integration.
Install the Avigilon LenelS2 executable included in the .zip file on each LenelS2 server running the communications server.

Client

Install the DirectX® End-User Runtimes included in the .zip file on each LenelS2 server using the Avigilon LenelS2 Integration.
Install the Avigilon LenelS2 executable included in the .zip file on the client computers that are running the OnGuard software. This is the same installation package installed on the server.

Checking the Avigilon License

After installing all the required software, follow these steps to check if the Avigilon license was applied correctly:

Open the Avigilon Control Center Client.
Click the Settings icon and select Site Setup.
Click License Management. The License Management dialog box will appear.
The dialog box should display “Integration Support: Yes”. If it does not, the software was not properly licensed.

Avigilon Configuration

Once the required licence and software have been installed, configure the Avigilon cameras for use in the OnGuard software.
All Avigilon camera settings are configured in the Avigilon Control Center Client software. See the Avigilon Control Center Client User Guide for more information.

Assigning Logical IDs to Cameras

In the Avigilon Control Center Client software, assign a logical ID to each camera. The integration software only allows you to access cameras with a logical ID. By default, cameras do not have a logical ID.

In the ACC Client software, right-click a camera in the System Explorer and select Setup.
In the camera Setup tab, click General.
In the General dialog box, enter a Logical ID: for the camera. The logical ID must be unique number.

Adding an Integration User in the Avigilon Control Center Software

To protect the security of the Avigilon Control Center software, add a user in the ACC Client software specifically for connecting the integration. The user you add will be used to connect the ACC system to the Avigilon integration software. See the Avigilon Control Center Client User Guide for more details.
To use all the integration features, the user must be added to a group with the following permissions:

View live images
- Use PTZ controls
- Lock PTZ controls
View recorded images

In the ACC Client software, complete the following steps:

In the Setup tab, select the site then click
In the Groups tab, click Add Group.
In the following dialog box, select to copy the Standard Users group permissions.
In the Edit Group dialog box, give the new group a name then select the recommended permissions for the integration.
Make sure only the required permissions are selected.
Click OK to save the new group.
Select the Users tab then click Add User .
In the Add/Edit User dialog box, enter a Username:.
In the Password area, complete the following fields:
- Password: enter a password for the user.
- Confirm Password: re-enter the password.
- Password never expires: you may want to select this check box so that you do not need to update the ACC software password for the integration.
Select the Member Of tab and select the check box beside the group you created earlier in this procedure.
The other two columns display the permissions linked to the selected group.
Click OK. The user is added to the system.

OnGuard Configuration

After the Avigilon cameras have been configured for use in the OnGuard software, configure OnGuard to interact with the Avigilon Control Center servers and add the Avigilon cameras into the OnGuard software.

Adding Avigilon Servers

Open the OnGuard System Administration software.
Select Video > Digital Video.
Select the Video Recorder tab.
Select Add to configure a new server.
In the Name field, enter a name for the server.
In the Video Recorder Type drop-down list, select Avigilon Control Center.
In the Workstation field, enter the name of the OnGuard server running the communications server.
In the Use IP Address of Video Recorder field, enter the Avigilon server IP address.
Make sure you enter the IP address of the Avigilon Control Center Server that the integration license is installed on or the integration will not work.
In the Port field, enter the Avigilon server port number.
The Port field can be left blank if you are using the default Avigilon port number (38880).
Enter the server’s User Name and Password. Use the Avigilon username and password you created for the integration. For more information, see Adding an Integration User in the Avigilon Control Center Software on page 4.
In the World Time Zone drop-down list, select a time zone.
Click OK to save the settings.
When the Full Download dialog box appears, click OK.
Right-click the added Avigilon video recorder and select Download from the pop-up menu.
When the Monitor Zone Assignment dialog box appears, assign the server to a zone and click OK.
Repeat this procedure for each Avigilon server in your installation.

Note: When adding servers from a site that has two or more servers, only one server from the site should be added.

Adding Individual Cameras

IntheOnGuard System Administration software,selectVideo > Digital VideothenselecttheCameratab.
Click Add.
Enter a Name for the camera and select the server it will use from the Recorder drop down list.
In the Channel field, enter the logical ID you assigned to the camera in the Avigilon Control Center Client software. For more information, see Assigning Logical IDs to Cameras on page 4.
If you want motion alarm events to be displayed, select the Display Motion Detection Alarms check box.
Leave the PTZ controlled by Matrix Switches field empty.
If you have a PTZ camera, the PTZ controls are automatically enabled in the OnGuard software.
Click OK.
Repeat this procedure for each Avigilon camera.

Adding All Cameras on a Server

In the Video Recorder tab, right-click the connected Avigilon server and select Import From Recorder.
In the following dialog box, select all the cameras you want to import.
Note: Only cameras with logical IDs are listed. For more information, see Assigning Logical IDs to Cameras.
- Click a camera on the Available list to add it to the Import list.
- Or, click Select all to add all available cameras to the Import list.
- Click Deselect all to empty the Import list.
When you’ve added all the cameras you want to the Import list, click OK. You will see a confirmation dialog box when all the cameras have imported successfully.
The Camera tab now displays all the imported cameras. If you are importing a PTZ camera, the camera’s configured presets are included with the import.

Testing the Connection

Once the cameras and software have been configured to support the Avigilon LenelS2 integration, test the connection to confirm that the integration was successful.

In the OnGuard System Administration software, select Video > Digital Video > Camera tab.
Select an Avigilon camera then select the Display Video check box.
If the camera is configured correctly, the live video from the camera is displayed.

If the video from the selected camera does not display.

Using the Integration

Once the Avigilon LenelS2 integration has been successfully installed and configured, you can view, record and export video from Avigilon cameras in the OnGuard Alarm Monitoring software and the OnGuard VideoViewer software. The video integration features motion detection, camera loss and analytics event data from the Avigilon Control Center software.
For more information, see the OnGuard Alarm Monitoring User Guide and the OnGuard VideoViewer User Guide.

Troubleshooting

If the following troubleshooting solutions do not resolve the issue, contact Avigilon Technical Support: avigilon.com/support.
Installation Fails
When you run the OnGuard Avigilon Accessory Add-On.msiexecutable file the first time, the installation fails.

Run the OnGuard Avigilon Accessory Add-On.msiexecutable file again.

Installation succeeds the second time.
No Video Display in the System Administration Software
When you test the Avigilon LenelS2 connection in the OnGuard System Administration software, no video appears. The video display box remains blank.
The issue could be a connection problem between the camera and the Avigilon server, or it could be a connection problem between the Avigilon server and the OnGuard software.
To resolve a connection issue between the camera and the Avigilon server, perform the following:

Check if the camera is turned on.
Check that the camera is connected to the same network as the server.
See the sections about connecting and disconnecting cameras in the Avigilon Control Center Client User Guide for other possible solutions.

To resolve a connection issue between the Avigilon server and the OnGuard software, check the following:

Ensure the client computer installation is complete. For more information, see Servers on page 3.
Check that the Avigilon server is turned on.
Check that the Avigilon server is on the same network as the LenelS2 server.
Check that you are connecting to an Avigilon server that is licensed for the integration.
Check that the Avigilon server’s IP address, username and password are entered correctly in the System Administration software.
Check that the necessary RTP ports are opened on the client and server machine firewall.
Open the ACC Admin Tool and go to Settings > Network to check which RTP ports need to be open on the firewall.

No Video Display in the Alarm Monitoring Software
When you attempt to view video from an Avigilon camera in the Alarm Monitoring software, no video is displayed. However, when you test the connection in the System Administration software, video successfully displays.
The OnGuard Communications Server may be down or closed.

To resolve the issue, open the Communications Server. For more information, see the OnGuard Alarm Monitoring User Guide.

Cannot Launch Video from the Web Video Viewer
When you try to access Avigilon video from the OnGuard Web Video Viewer, you see the following error message:
Unable to load video from ‘Avigilon’. Please verify that you can access the recorder from your machine or that your viewer is on the same domain as your recorder.
Check the following:

Check if you can display video in the OnGuard System Administration software. If not, complete this procedure: Adding an Integration User in the Avigilon Control Center Software.
Check if there is a password assigned to the Avigilon user created for the integration. For more information, see Adding an Integration User in the Avigilon Control Center Software. When the Avigilon user does not use a password, the OnGuard System Administration software will still display video from the integration but the OnGuard Web Video Viewer will not.

Video in OnGuard Application is Incomplete or Discolored
Video displayed in the Onguard applications appear clipped, incomplete or shows discoloration.
This issue typically occurs in complex network environments where UDP traffic between LenelS2 and Avigilon server may be blocked.
To test if this is the issue, install the Avigilon Control Center (ACC) Client software on one of the affected systems, then complete the following steps:

In the ACC Client software, login to the site that manages the cameras used in the integration.
Display the affected video.
The video is clipped, incomplete or shows discoloration like in the Onguard applications.
Open the Client Settings dialog box, and select the Site Networking tab.
Select the site that you are logged in to, and change the Connection Type: drop down list setting from LAN to WAN (Secured).
Check the displayed video again.
Video displays correctly, without any of the previously noted issues.

If video displays correctly after you switch to the WAN setting, complete the following steps to resolve the issue:

Create a text file and name it AvigilonLenelIntegrationConfig.cfg.
Enter the following lines into the text file:
Save and close the file.
Close the following OnGuard applications if they are open:
- System Administration
- Video Viewer
- Alarm Monitoring
Open the Windows Services console.
- In the Windows Start menu search bar, enter services.msc.
Locate the LS Client Update service.
Right-click the service and select Stop.
Wait for the service to stop.
Copy the AvigilonLenelIntegrationConfig.cfgfile to the same directory as the integration software on each affected system.
The folder directory is typically C:\Program Files (x86)\OnGuard
In the Windows Services console, restart the LS Client Update service.

Video in the OnGuard applications should now display correctly without issue.
Enable/Disable Avigilon Events in the Alarm Monitoring Software
Avigilon events are enabled by default. If you want to turn off these events:

Create a text file and name it AvigilonLenelIntegrationConfig.cfgor check whether the file already exists in the directory where OnGuard software is installed in the system (the folder directory is typically C:\Program Files (x86)\OnGuard).
Enter the following lines into the text file if you are creating a new file otherwise just add the ConfigItemtags in the file if it already exists:
To enable the events set the value as 1 otherwise set the value as 0 to disable the event.
If the EnableAvigilonEventsflag value is set to 0 then all the Avigilon Events will be disabled irrespective of the values of the EnableMotionEvents, EnableAnalyticsEventsand EnableDigitalInputEventsflag values.
If the EnableAvigilonEventsflag value is set to 1 then it depends on the EnableMotionEvents, EnableAnalyticsEventsand EnableDigitalInputEventsflag values whether these events will be enabled or disabled (enabled if set to 1, disabled if set to 0)
Save and close the file.
Close the following OnGuard applications if they are open:
- System Administration
- Video Viewer
- Alarm Monitoring
Copy the AvigilonLenelIntegrationConfig.cfgfile to the same directory as the integration software on each affected system. The folder directory is typically C:\Program Files (x86)\OnGuard.

Black Screen and Incorrect Date/Time Appears
If black screen and incorrect date/time appears, follow the steps below:

Create a text file and name it AvigilonLenelIntegrationConfig.cfgor check whether the file already exists in the directory where OnGuard software is installed in the system (the folder directory is typically C:\Program Files (x86)\OnGuard).
Enter the following lines into the text file if you are creating a new file otherwise just add the ConfigItemtags in the file if it already exists:
Save and close the file.
Close the following OnGuard applications, if they are open:
- System Administration
- Video Viewer
- Alarm Monitoring
Copy the AvigilonLenelIntegrationConfig.cfgfile to the same directory as the integration software on each affected system. The folder directory is typically C:\Program Files (x86)\OnGuard.