Lenel OnGuard: OpenAccess

Have more questions? Submit a request

Lenel OnGuard: OpenAccess

https://uploads-ssl.webflow.com/60f7f1c596ca46153e84496a/611bd0ca6c5dc53e52102a06_lenel_onguard_logo-removebg-preview-p-500.png

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.

OnGuard_OpenAccess_Server_Layout__Ops_Version_.png

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:

  1. SureView Device Server
    A configured SureView Device Server with the "OnGuard OpenAccess Device" and "OnGuard OpenAccess Receiver" integrations installed
  2. Lenel License
    You must have the following license attached to your OnGuard instance, you should obtain this through your LenelS2 representative: IPC-011-SURVW01
  3. 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
    Lenel-MonitoringPreReq.png
  4. 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"

Device Setup

mceclip4.png

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.

No Grouping
Each alarm comes in seperately into individual events

By Area
Alarms for the same Area get grouped into the same event

By Response (Recommended)
Alarms for the same alarm point/door get grouped together

mceclip0.png

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
PanelName=myPanel% would match any panels with a name that starts with "myPanel"

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:

image__1_.png

0 = Event publishing disabled

1 = Event publishing enabled

No Results = Event publishing enabled

Articles in this section

Was this article helpful?
1 out of 1 found this helpful
Share

Comments

0 comments

Please sign in to leave a comment.