Honeywell EBI Documentation

1.propósito #

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.Pressupostos #

Este documento faz algumas suposições:

  1. O leitor está familiarizado com os sistemas e terminologia XPressEntry. A configuração básica e o uso de XPressEntry podem ser encontrados no manual principal do XPressEntry
  2. O leitor tem uma compreensão básica do 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.Instalação #

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.Configuração do Sincronizador do Gerenciador de Dados XPressEntry #

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 Ativar Sincronização #

Na página principal do XPressEntry, vá para XPressEntry / Settings (CTRL + S)


xpressentry synchronization honeywell ebi

3.2.Guia Gerenciador de dados #

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.Update Frequency #

Defina a frequência de atualização para quantas vezes quiser que o sistema atualize. Observe que apenas uma atualização pode ser executada de cada vez e, se esse valor for muito baixo, o sistema tentará constantemente atualizar (isso nem sempre é um problema).

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.Nível de Log #

Selecione o nível de registro desejado. Ao configurar o sistema, o SQL é o nível de registro sugerido. Quando o sistema estiver ativo e funcionando conforme desejado, CRITICAL deve ser o nível de registro padrão.

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.Outros campos #

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.Configurar dados 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.Permitir edição de dados externos #

Se você quiser editar esses dados por qualquer motivo depois de sincronizado, faça isso com a configuração na guia principal:


xpressentry settings allowing editing of external data

4.2.Leitores #

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.

Existem dois tipos de leitores no XPressEntry, leitores físicos e lógicos.

4.2.1.Leitores Físicos #

Um leitor físico no sistema XPressEntry é um dispositivo portátil ou outro dispositivo configurado para se comunicar com o servidor. Ele é identificado exclusivamente pelo campo GUID do dispositivo.
Muitas vezes, um leitor físico terá um nome longo / sem sentido como: 570069006E00430045000000-00-008703124863. Esses leitores estão usando o GUID como o nome padrão para o dispositivo depois que eles são sincronizados.

4.2.2.Leitores Lógicos #

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


xpressentry reader name

4.2.3.Mesclando Leitores Físicos / Lógicos #

Nota: Este processo é irreversível!
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. Pressione "Executar Mesclar".

Se você não conhece o GUID do leitor exato que está mesclando, o GUID do leitor está disponível no dispositivo portátil na página Configuração, na guia "Mais".

4.3.Perfis de Leitor #

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.portas #

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.

Usuários “Entrando” uma porta estão saindo da Zona Inicial -> End Zone. Usuários que “saem” de uma porta partem da End Zone -> Start Zone

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.Zonas #

XPressEntry tem dois tipos de zonas. As zonas "externas" são usadas para reunir e representar a área fora do local em que a XPressEntry está rastreando. Todas as outras zonas são consideradas parte do sistema. Ocupações só são rastreadas para usuários que estão em zonas não externas.

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

Sugerir Editar