easyopen - User Monitor

easyopen - User Monitor
Brand: Coastform
Product Code: SW-EUM
Availability: Pre-Order
Price: £0.00
Exc.VAT: £0.00
Qty:     - OR -   Add to Wish List
Add to Compare

User Monitor for easyOpen Access Control
Live Data Feed of Username and Photo to a Web Browser

When a user presents their tag to a door reader, the access control system logs the details of that event into its database. The easyOpen User Monitor (EUM) automatically picks up the user activity and makes the information available for viewing in one or more web browsers running on the same local network (LAN) as the access control system, and any browser windows currently connected to EUM are automatically updated in real time.

Features

  • Open source software
  • Display platform - web browser running on: Unix/Linux, Windows, Mac, i-Pad, Android-tablet, smartphone (via WiFi)
  • One or more (unlimited) web browsers can display the live feed - anywhere in your building/on the same LAN
  • Displayed data includes username and photo by default
  • Displayed data can be easily changed
  • Display formatting can be easily changed
  • Display automatically updates each time a user presents their tag to open a door
  • The user data automatically updates in each and every browser displaying the live feed

Any number of web browsers may be used to display the data, but they must be running on the same local network as the access control system. Remote display across the internet is not supported. If you need real-time remote monitoring, from anywhere in the world, use the instant messaging (IM) service built into Access Manager.

Two main features of the easyOpen User Monitor are that it is open-source and it uses web browsers to display the data. Open-source means that if you want to change the information that is displayed, you can. By editing the simple Python script you can extract any information from the database and have it displayed in remote web browsers.

Using web browsers to display the data allows the data formatting to be readily changed and allows easyOpen User Monitor to take advantage of the full data-rendering and graphics potential of modern web browsers. The data is formatted using HTML together with a little CSS, allowing you to change the format simply be editing a web page. The data receiver is nothing more than simple javascript to receive the data and forward it to the correct location on the web-page.

Coastform makes easyOpen User Monitor available free of charge, but does not provide free support. If you need to display different data or change the formatting and can figure out how to do that yourself, please go ahead, the download zip contains the source code and the license allows you to do that. Alternatively, if you need support, you can request Coastform to create a bespoke solution for you on a contract basis.

Download...

Assumptions for Installation

  1. easyOpen Access Manager is already installed, and setup to use a Firebird database; (The easyOpen User Monitor can only be used when the database server is Firebird)
  2. The rest of this installation will assume the database is called "eum.fdb"
  3. The PC needs an internet connection for the installation process. Many of the dependencies are downloaded and installed directly from the internet.
  4. The installation procedure must be conducted from an administrator account
  5. The Firefox web-browser is recommended. The easyOpen User Monitor has been tested using Firefox, but other modern browsers should also work.

Installation

  1. Install Visual C++ 2008 Express Edition , which is available from Microsoft's download site. This exact version is needed to be compatible with Python 2.7, and is used to compile some extensions once downloaded to your PC.
  2. Install Python (version 2.7) IMPORTANT! - Select the option "Add Python.exe to Path" at the start of the installation.
  3. Ensure all Windows updates have been applied after the above two installations. Reboot the PC.
  4. Using Windows Explorer, navigate to the folder where eum.fdb (your Access Manager database) is located. Save EUM.zip in that folder and unzip it, preserving the folder structure. For example, if your eum.fdb is located at C:\EAM_Databases, your folder structure after unzipping should be something like this:
    C:\EAM_Databases
    |   eum.fdb
    |   LICENSE
    |
    \---.crossbar
    |      |
    |      config.json
    |
    \---web
    |      |
    |      eousermon.js
    |   
    \---eum
    |      |
    |      eum.py
    |   

    Note that many of the files have been omitted for clarity from the above example folder structure.
  5. Run ptest.bat. A console window should open and display a line like this (although the last digit of the version may be different):
    Python 2.7.8
    If the response is similar to the above line press a key to close the console window. Otherwise your PC may require rebooting, but in most cases this happens if the option "Add Python.exe to Path" was not selected when Python was installed. Reinstall Python or reboot the PC as necessary and try this step again.
  6. Main installation: Run install.bat. A console window should appear while the main installation progresses. The installation may take several minutes. Once complete, and "Press any key to continue . . ." is displayed, press a key to dismiss the console window.

Changing the configuration

If your database is called something other than "eum.fdb", you will need to edit the configuration file, config.json, located in the folder .crossbar, a sub-folder created when you unzipped EUM.zip. Open config.json in your favourite text editor (eg notepad) and change "eum.fdb" to the name of your database. "eum.fdb" is located a few lines up from the bottom of the file. Note that the full default entry for the database pathname is "../eum.fdb", indicating the database is located in the parent folder of .crossbar; This path is relative to the location of the config.json file. If you prefer, you can specify a full pathname here of the form "C:\some-folder\mydatabase.fdb".

Testing/Operation

Run the easyOpen User Monitor (easyopen-user-mon.bat). A console window should appear, generating some text output as it initialises. This window remains open indefinitely while easyOpen User Monitor is running.

Open Firefox; If this is done on the same PC as where easyOpen User Monitor is running, enter into this URL into the browser address bar: localhost:8080 otherwise enter this URL: EumName:8080 replacing "EumName" with the name of the computer where easyOpen User Monitor is running. The name of the computer can be found as follows:

Windows 7

  • Click the Start icon
  • Right click on Computer
  • Select Properties
  • Your computer's name is listed under Computer Name

Windows 8

  • From the Windows 8 Start Page select Desktop
  • Press the Windows key + X to bring up the menu in the bottom left hand corner
  • Select System
  • Your computer's name is listed under Computer Name

If the easyOpen User Monitor is working properly, a web page with a green background should be displayed showing a person's name and a time or, initially, "Name (Presence unknown)" and "At: Time", as shown below.

No image No image

Start Access Manager and present a user's tag at a reader where it is authorised. The easyOpen User Monitor web-page should automatically update with information about the user, their name, their picture (if the database has been setup with a picture of the user), and the time the tag was used at the reader.

Troubleshooting

If the web page is viewed before the easyOpen User Monitor is running it will most likely display a warning that the browser failed to connect to the server. Once easyOpen User Monitor is running, simply refresh the web page (F5) to re-connect.

There could be a number of reasons why the easyOpen User Monitor does not update when a tag is presented, as follows:

  • The name of the database is wrong in the configuration file. Check the output in the easyOpen User Monitor console window for the database pathname, and see Changing the configuration above
  • Access manager is not running; Access Manager must be running to receive the event information from the door controllers and pass it on to easyOpen User Monitor
  • The tag is not authorised at the reader. Using Access Manager ensure the corresponding user is authorised against the door associated with the reader where the tag is being presented

LICENSE

The content is licensed under Creative Commons CC-BY-SA and the code is licensed under AGPL 3.0.

Write a review

Your Name:


Your Review: Note: HTML is not translated!

Rating: Bad           Good

Enter the code in the box below: