Honeywell EBI Documentation

1.Objectif #

This document is intended to instruct the user on how to synchronize an XPressEntry mobile access control system with a Honeywell EBI access control system.

This will allow XPressEntry to have a copy of the Cardholders and Cards and their access privileges from EBI. Activity records cannot be pushed back into EBI at this time.

1.1. Hypothèses #

Ce document émet quelques hypothèses:

  1. Le lecteur est familiarisé avec les systèmes et la terminologie XPressEntry. La configuration de base et l’utilisation de XPressEntry se trouvent dans le manuel principal de XPressEntry.
  2. Le lecteur a une compréhension de base de Microsoft SQL Server Management Studio.
  3. The Honeywell EBI installation is administered by someone with knowledge and access to SQL Server commands.
  4. Honeywell EBI includes the Cardholder Services module.

1.2. Installation #

We will not cover installation of either XPressEntry or Honeywell EBI here. Refer to the appropriate manual to get that set up.

2.EBI Setup and SQL Server #

2.1. EBI Server Version #

In order for the XPressEntry integration with Cardholder Services to work properly, EBI needs to be using at least version 410.2 and have the following patch or equivalent installed: Version: Server_R410_2_SP1_ISR159842_Cardholder_Services_Update.exe

2.2. Is EBI Running #

For Cardholder Services to function properly, the EBI server has to be running. It should look something like this:


ebi server

2.3. Test Harness #

The Cardholder Services installation comes with a Test Harness application to check functionality. It is typically located at:
C:\Program Files (x86)\Honeywell\Server\user\CardholderServicesTestHarness.exe
Usage of the test harness is not covered here, but if you can “Get All Types” on the Cardholders tab, you are communicating with EBI through Cardholder Services correctly.

2.4. SQL Scripts #

The EBI install should come with two SQL Scripts to enable the Users location and Zones as well as access rights / zones as UserTables through Cardholder Services. These files are named and should have been made available with the updated patch from Honeywell.

These scripts should be run on the EBI database by the SQL Server administrator.

3.Configuration du synchroniseur XPressEntry Data Manager #

XPressEntry and EBI communicate through the EBI Cardholder Services interface. From the XPressEntry side, this done by a module called Data Manager. This section will describe how to set up and get the Data Manager running for EBI.

3.1. XPressEntry Activer la synchronisation #

Dans la page principale de XPressEntry, accédez à XPressEntry / Settings (CTRL + S).


xpressentry synchronization honeywell ebi

3.2. Onglet Gestionnaire de données #

From the Settings Page Select the Data Manager Tab. When it is empty it looks like this:


xpressentry set up honeywell ebi

From the ‘Type’ Combo Box, select “Honeywell EBI”.


xpressentry set up type honeywell ebi

3.2.1. Fréquence de mise à jour #

Définissez la fréquence de mise à jour sur autant de fois que vous souhaitez que le système se mette à jour. Notez que seule une mise à jour peut être exécutée à la fois et si cette valeur est très basse, le système essaiera constamment de le mettre à jour (ce n'est pas toujours un problème).

For EBI Installations, we want to set both the Activity Update Frequency and the Full Sync Update frequency. Activity Update will fill the locations of the users in EBI at the given frequency. Full Sync will do the rest of the updates. Partial Synchronization is not used with EBI.

3.2.2. Niveau de journalisation #

Sélectionnez le niveau de journalisation souhaité. Lors de la configuration du système, SQL est le niveau de journalisation suggéré. Une fois que le système est opérationnel et fonctionnel à votre guise, CRITICAL doit être le niveau de journalisation par défaut.

3.2.3. Activity Synchronizing #

Activity Synchronizing is not done with EBI at this time and these checkboxes will have no effect when you have EBI selected and set up.

3.3. Honeywell EBI Setup Page #

Press the “Setup Data Manager” button to get the EBI specific setup screen.


honeywell ebi data manager set up

The first thing to do from this page is fill in the primary EBI server which has Cardholder Services running.

3.3.1. Important Fields #

There are 3 important fields to fill out on this page:

  1. Primary Server – the name or IP address of the primary EBI server
  2. Username – A valid administrator on the EBI server
  3. Password – The password for that user.

These credentials should be supplied by your EBI administrator.

Once you’ve filled out the basic information, the button: “Get Server Information” or “Test Connect” will attempt to connect to the server.
Redundancy information will be automatically filled out if you press the “Get Server Information” button. If your connection fails, check the text box at the bottom of the screen for information on the failure.

3.3.2. Autres domaines #

Compare Transit Date – should be checked. It will compare the Users/Zones TRANSIT_DATE field from EBI with the last scan date in XPressEntry. The later date will be applied as the user current location.

User Tables – These fields should not change from the defaults unless the SQL Server Administrator specifies a change.

When you are done with this step, press OK to send the setup information back to XPressEntry Data Manager.

IMPORTANT: You MUST press the “Save and apply settings”button for any data manager changes to take effect!

After you’ve saved, you can press the “Full Sync Now”button to synchronize XPressEntry with EBI. Make sure you’ve set the synchronization update frequency on the main Data Manager tab.

When the Data Manager is setup and running with EBI, it should look something like this:


xpressentry set up page save and apply

4.Configurer les données XPressEntry #

Once the EBI System is set up and synchronizing, you will see the EBI data represented in XPressEntry under the Add/Edit Info tab. Data which is imported from EBI cannot be changed by default and is grayed out / read-only.

4.1. Autoriser l'édition de données externes #

Si vous souhaitez pouvoir modifier ces données pour une raison quelconque après leur synchronisation, vous pouvez le faire avec le paramètre de l'onglet Paramètres principaux:


xpressentry settings allowing editing of external data

4.2. Lecteurs #

Readers for EBI Synchronization are strictly an XPressEntry entity. You can set up your readers to have one or many different configurations at a given time. This is done by selecting a Reader Profile for the reader.

Il existe deux types de lecteurs dans XPressEntry, les lecteurs physiques et logiques.

4.2.1. Lecteurs physiques #

Un lecteur physique dans le système XPressEntry est un ordinateur de poche ou un autre périphérique configuré pour communiquer avec le serveur. Il est identifié de manière unique par le champ GUID du périphérique.
Très souvent, un lecteur physique aura un nom long / absurde comme: 570069006E00430045000000-00-008703124863. Ces lecteurs utilisent le GUID comme nom par défaut pour le périphérique une fois qu'ils sont synchronisés.

4.2.2. Lecteurs logiques #

Logical readers are readers in the system which are usually placeholders for physical readers.


xpressentry reader name

4.2.3. Fusion de lecteurs physiques / logiques #

Note: Ce processus est irréversible!
To merge the logical and physical readers do the following:

  1. Select the Logical Reader from the Add/Edit Info Readers tab
  2. Under “Merge with Physical Reader”, select the physical reader as identified by its name (typically the GUID) from the drop-down list “Reader Name”.
  3. Appuyez sur «Effectuer la fusion».

Si vous ne connaissez pas le GUID du lecteur exact que vous fusionnez, le GUID du lecteur est disponible sur le périphérique de poche sur la page de configuration sous l'onglet «Plus».

4.3. Profils de lecteur #

All readers in the XPressEntry system need a reader profile set up for them. These can be shared across readers with identical responsibilities. See the main XPressEntry manual for more information.

4.4. Portes #

Doors are portals from one zone to a different zone. They are a logical way to move from one zone to another. They are primarily used by XPressEntry for handhelds in Entry/Exit mode.

Les utilisateurs «entrant» dans une porte partent de la zone de démarrage -> zone de fin. Les utilisateurs "sortant" d'une porte partent de la zone d'extrémité -> Zone de démarrage

When using XPressEntry for Entry/Exit mode, you should set up XPressEntry to have at least one door and make sure the zones make sense for the EBI integration. If you’ve already synchronized the activities from EBI, you should see the EBI zones here.

4.5. Zones #

XPressEntry a deux types de zones. Les zones «extérieures» sont utilisées pour rassembler et représenter la zone située en dehors de l'emplacement suivi par XPressEntry. Toutes les autres zones sont considérées comme faisant partie du système. Les occupations ne sont suivies que pour les utilisateurs situés dans des zones non extérieures.

As explained below, all zones are coming directly from EBI. The Groups are the same as the Behavior Models in EBI. This information can all be verified in XPressEntry, but it is set in the EBI system.


xpressentry zones honeywell ebi

Suggérer Modifier