Lenel OnGuard: OpenAccess
The following is a system-to-system integration that requires an integration license and may require additional support than a standard SureView integration.
The configuration of the integration in SureView is simple and follows a standard set of functionality that is exposed by the SureView API and in this document. However these advanced systems have a wide variety of custom settings that can affect the performance of this integration. As such it’s important to budget for professional services from the SureView support team to assist in configuring your system to work with SureView and also to tailor the integration if needed to your unique custom setup. Please contact your sales representative for details about our professional services.
Information
- Manufacturer: Lenel/S2 (+1 (585) 248-9720 x4 | (800) 631-6046). Technical support: oaaptechnical@honeywell.com
- Product: OnGuard 8.2, OnGuard 8.1, OnGuard 7.6, OnGuard 7.5
-
Type: Access Control - Alarm Receiver
Supported Features
The OnGuard OpenAccess integration supports the following features:
- Alarms
- Door Pulse
- System Synchronization
Supported Lenel OnGuard OpenAccess Versions
- OnGuard 7.5
- OnGuard 7.6
- OnGuard 8.1
- OnGuard 8.2
Components and Communication
From |
To |
Port |
Use |
Device Server |
OpenAccess Server |
8080 TCP |
Sync, Door Control, Alarms |
Prerequisites
SureView Device Server Setup
Your Ops Device Server will be configured by your SureView representative in a remote or guided session. Speak with them to arrange a time where this connection can be established.
Configuration
The following are the steps required to configure Lenel to work with the Sureview.
Before you begin
Before you configure your Lenel system to work with Sureview make sure you have the following:
-
SureView Device Server
A configured SureView Device Server with the "OnGuard OpenAccess Device" and "OnGuard OpenAccess Receiver" integrations installed -
Lenel License
You must have the following license attached to your OnGuard instance, you should obtain this through your LenelS2 representative: IPC-011-SURVW01 -
Lenel Features
Your OnGuard system must have the "Monitor" feature available for it to be capable of passing alarms to the integration. Contact your Lenel representative if you do not have this feature -
OnGuard User Permissions
OpenAccess requires an internal OnGuard account. The OnGuard user account used by the integration must have at least the following permissions in OnGuard:-
System Permissions:
- Under "Access control hardware": "Query" on "Access Panels", "Readers", and "Alarm Panels"
- Under "Access control": "Query" on "Segments"
-
Monitor Permissions:
- Under "Control": "Open doors"
-
Under "Control": "Relay and reader outputs"
-
System Permissions:
Device Setup
Note: Lenel is an advanced integration and must be configured using the using advanced "Device Setup" page and the "Device Configuration" feature
Connection details for the OpenAccess integration are as follows:
Field |
Value |
Title | The friendly name of the Lenel Server you are connecting to |
Area | The Area/site that the Lenel panels/doors will be added to |
Type | Select "OnGuard OpenAccess Panel" |
Host |
Local IP address or host of the OnGuard server hosting the OpenAccess service (from the perspective of the SureView Device Server) |
Port |
The port the OpenAccess service is running on. default = 8080 |
Username |
The username of the OnGuard account that has the access described above. |
Password |
The password of the OnGuard account that has the access described above. |
PanelID | Matching Panel details for "Get Config" SegmentID=xxx, SegmentName=xx, PanelID=xxx or PanelName=xxx. Note: If no parameter is provided Get Config will return all panels (See parameters section for more detail) |
Alarm Grouping |
How you would like to group incoming alarms. |
Device Parameter"PanelID"
The device parameters allow you to set specific groupings of cameras to capture as well as adjust connection preferences.
The list of available parameters are listed in the table below
Parameter |
Example |
Description |
PanelID= |
PanelID=12345 |
Used with the "Get Config" feature to automatically configure the devices that matches against the provided PanelD. |
PanelName=
|
PanelName=myPanelName or PanelName=myPanel%
|
Used with the "Get Config" feature to automatically configure the devices that matches against the provided panels name. You can use the % symbol for wildcard matching. for example |
SegmentID= | SegmentID=12345 |
Used with the "Get Config" feature to automatically configure the panels that matches against the provided SegementID |
SegmentName= | SegmentName=mySegmentName |
Used with the "Get Config" feature to automatically configure the panels that matches against the provided Segment Name |
business_event_class | business_event_class eq 'hardware_event' and access_granted_entry_made eq false | Used within the "Get Config" feature to allow filtering of alarm at an integration level, allowing you to filter out alarms that you don't wish to see from the system. |
(blank) |
If no Parameter is provided then the "Get Config" feature will automatically return all available panels across the entire Lenel OnGuard system. |
Troubleshooting
Lenel Performance Issue Causing Delayed Alarms
Lenel's OpenAccess component has a known issue where it can be delayed when sending alarms, sometimes in the order of hours after they actually occurred.
Lenel has advised that any customer experiencing the issue must raise it with Lenel Technical Support at oaaptechnical@honeywell.com to receive assistance (unfortunately it cannot come from SureView - Lenel requires that it comes from the customer with the Lenel contract)
It is also possible to monitor the Lenel OpenAccess message queue on your server at http://localhost:15672/#/ to see how many events are queued, notably in the event_subscription_events and internal_hardware queues.
NOTE: if you have not already you will first need to run the following commands via the "RabbitMQ Command Prompt" from the Start menu of your Lenel server to enable the web interface, add a user for you to log in with, and grant it permissions:
rabbitmq-plugins enable rabbitmq_management
rabbitmqctl add_user 'SomeUserName' 'SomePassword'
rabbitmqctl set_user_tags 'SomeUserName' monitoring
As of 2025-05-06 Lenel are tracking this as "SF-07072" and have supplied a v8.2.524.126 patch to update the Lnl.OG.BusinessLayer.dll, Lnl.OG.DataAccessLayer.dll, and Lnl.OG.EventContextProvider.Server.dll files
Why is Get Config only returning panels marked as "Is Online"?
By default, Sureview will only detect Panels that are marked as online. It is possible to ignore this and bring all panels in regardles of being marked as online or offline. Please ask SureView to add the following configuration key to the DeviceWorker.exe.config file: <add key="IgnoreOfflinePanels" value="false"/>
I can connect to Open Access and pull panel information, but I'm not receiving any alarms
Ensure that the following OnGuard services are running on the Open Access Server
- LS Communication Server
- LS Event Context Provider
- LS Web Event Bridge
- LS Web Service
- LS OpenAccess
If they are, and you're still not receiving events, confirm that event publishing is enabled by running the following query against the Open Access Database:
0 = Event publishing disabled
1 = Event publishing enabled
No Results = Event publishing enabled
Comments
0 commentsPlease sign in to leave a comment.