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.
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.
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.
Assumptions for Installation
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".
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:
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.
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.
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:
LICENSEThe content is licensed under Creative Commons CC-BY-SA and the code is licensed under AGPL 3.0.