Difference between revisions of "Web Administration Dashboard"

From RifidiWiki

Jump to: navigation, search
(Deleted Command)
(Prerequisites for Managing Remote Rifidi Servers)
 
(20 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
=Dashboard Vision/Roadmap=
 +
 +
The key components of the enterprise-wide dashboard we added with this release – and how they improve ease of use – are summarized below.
 +
#Edge Server Node Management – Let’s you monitor multiple Rifidi Edge server nodes across the enterprise to see connection states, properties, sensors and applications.
 +
#Sensor Management – Provides an interface to monitor sensors’ state, manage sensors’ properties and dynamically update sensors’ execution.
 +
#Rifidi Application Management – Allows you to monitor application states, manage sensor/reader read zones, and update both out-of-the-box business solutions and custom (via SDK) Rifidi sensor/IoT device properties, providing the foundation for a Rifidi Application marketplace.
 
=Introduction=
 
=Introduction=
The Web Administration Dashboard enables users to manage, monitor and configure Rifidi Servers and Applications.
+
The Web Administration Dashboard enables users to manage, monitor and configure Rifidi Servers, Sensors/Readers and Applications.
  
 
Go to http://localhost:8111/dashboard
 
Go to http://localhost:8111/dashboard
Line 7: Line 13:
 
<br><br>
 
<br><br>
 
[[File:dashboard_wizard_section.png]]
 
[[File:dashboard_wizard_section.png]]
 +
 +
 
==Menu section==
 
==Menu section==
 
The menu is a hierarchical tree component, where all the configured servers are listed, and under each server there are three fixed sections:<br>
 
The menu is a hierarchical tree component, where all the configured servers are listed, and under each server there are three fixed sections:<br>
Line 23: Line 31:
  
 
=Server Management=
 
=Server Management=
 +
 +
==Prerequisites for Managing Remote Rifidi Servers==
 +
Due to browser security enhancements in order to use dashboard to manage remote Rifidi servers please follow these steps
 +
 +
1. Update the following JVM argument in the Rifidi Sever startup script to use the external ip address in place of localhost/127.0.0.1
 +
<pre>
 +
example: -Djava.rmi.server.hostname=192.168.86.58 where 192.168.86.58 is the External IP Address of the device
 +
</pre>
 +
2. Configure the Rifidi servers to run via https/ssl with a trusted signed cert from a CA
 +
<pre>
 +
Steps for this can be found [[Edge_Management#Configuration_.28HTTP_over_SSL.29_-_Available_as_of_version_3.1.1|Rifidi Server Rest SSL Configuration]]
 +
</pre>
 +
 +
3. Go to dashboard using the ssl address: Example: https://192.168.86.58:8183/dashboard/#/
 +
 +
 +
 +
Another less ideal option is to turn off the browser security. Here is an example on how to do so in Chrome.
 +
 +
"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --disable-web-security --user-data-dir="c:/someFolderName"
  
 
==Add Server==
 
==Add Server==
Line 119: Line 147:
  
 
===Create Command===
 
===Create Command===
 +
Creates a command template
 
# Right click on command type node, select 'Create Command Template' and then go to properties editor area<br>[[File:create_command_link.png]]
 
# Right click on command type node, select 'Create Command Template' and then go to properties editor area<br>[[File:create_command_link.png]]
 
# Provide the values for command attributes<br>[[File:create_command.png]]
 
# Provide the values for command attributes<br>[[File:create_command.png]]
Line 124: Line 153:
  
 
===Execute Command===
 
===Execute Command===
 +
Executes a command on a session
 
# Right click on session element where you want to submit the job and then choose 'Submit Job'<br>[[File:execute_command_link.png]]
 
# Right click on session element where you want to submit the job and then choose 'Submit Job'<br>[[File:execute_command_link.png]]
 
# Choose the command type and choose to create a new command instance or select an existing one, set the properties for command instance and set the scheduling options for executing command, and click Submit<br>[[File:execute_command.png]]
 
# Choose the command type and choose to create a new command instance or select an existing one, set the properties for command instance and set the scheduling options for executing command, and click Submit<br>[[File:execute_command.png]]
Line 159: Line 189:
 
==Readzones==
 
==Readzones==
 
===Get Readzones===
 
===Get Readzones===
 +
Option to list the readzones associated with an application group
 
# Click on 'ReadZones' menu element and it will display the readzones belonging to parent application group<br>[[File:readzones_link.png]]
 
# Click on 'ReadZones' menu element and it will display the readzones belonging to parent application group<br>[[File:readzones_link.png]]
  
 
===Add Readzone===
 
===Add Readzone===
 +
To add a readzone definition associated with an application group
 
# Right click on 'ReadZones' node and then choose 'Add Read Zone'<br>[[File:add_readzone_link.png]]
 
# Right click on 'ReadZones' node and then choose 'Add Read Zone'<br>[[File:add_readzone_link.png]]
 
# Set the readzone name and readerID, and optionally provide the antennas, matchPattern and tagPattern, and click on 'Create' button<br>[[File:add_readzone.png]]
 
# Set the readzone name and readerID, and optionally provide the antennas, matchPattern and tagPattern, and click on 'Create' button<br>[[File:add_readzone.png]]
Line 167: Line 199:
  
 
===Delete Readzone===
 
===Delete Readzone===
 +
Deletes a readzone definition
 
# Right click on readzone node to delete and then choose 'Delete Command Template'<br>[[File:delete_readzone_link.png]]
 
# Right click on readzone node to delete and then choose 'Delete Command Template'<br>[[File:delete_readzone_link.png]]
 
# Confirm delete operation<br>[[File:delete_readzone_confirm.png]]
 
# Confirm delete operation<br>[[File:delete_readzone_confirm.png]]
  
 
===Update Readzone properties===
 
===Update Readzone properties===
 +
Updates the properties for a readzone
 
# Click on readzone node to modify and then go to properties editor area<br>[[File:update_readzone_link.png]]
 
# Click on readzone node to modify and then go to properties editor area<br>[[File:update_readzone_link.png]]
 
# Provide the values for readerID, and optionally provide the antennas, matchPattern and tagPattern attributes<br>[[File:update_readzone.png]]
 
# Provide the values for readerID, and optionally provide the antennas, matchPattern and tagPattern attributes<br>[[File:update_readzone.png]]
Line 177: Line 211:
 
==Application Properties==
 
==Application Properties==
 
===Get / Update Group Properties===
 
===Get / Update Group Properties===
 +
List and modify the application group properties
 
# Click on application group node to get / update and then go to properties editor area<br>[[File:update_groupproperties_link.png]]
 
# Click on application group node to get / update and then go to properties editor area<br>[[File:update_groupproperties_link.png]]
 
# Provide the values for application group properties and click on 'Save'<br>[[File:update_groupproperties.png]]
 
# Provide the values for application group properties and click on 'Save'<br>[[File:update_groupproperties.png]]
Line 189: Line 224:
  
 
===Get / Update Application Properties===
 
===Get / Update Application Properties===
 +
List and modify the application properties
 
# Click on application node to get / update and then go to properties editor area<br>[[File:update_appproperties_link.png]]
 
# Click on application node to get / update and then go to properties editor area<br>[[File:update_appproperties_link.png]]
 
# Provide the values for application properties and click on 'Save'<br>[[File:update_appproperties.png]]
 
# Provide the values for application properties and click on 'Save'<br>[[File:update_appproperties.png]]
Line 198: Line 234:
 
===Update  Application  Properties===
 
===Update  Application  Properties===
 
-->
 
-->
 +
=Diagnostic=
 +
==Current Tags View==
 +
# Right click on reader/sensor name <br>[[File:Currenttagsmenu.png]]
 +
# Click on Current tags to view tags on reader <br>[[File:Currenttagsview.png]]

Latest revision as of 12:58, 31 December 2020

Dashboard Vision/Roadmap

The key components of the enterprise-wide dashboard we added with this release – and how they improve ease of use – are summarized below.

  1. Edge Server Node Management – Let’s you monitor multiple Rifidi Edge server nodes across the enterprise to see connection states, properties, sensors and applications.
  2. Sensor Management – Provides an interface to monitor sensors’ state, manage sensors’ properties and dynamically update sensors’ execution.
  3. Rifidi Application Management – Allows you to monitor application states, manage sensor/reader read zones, and update both out-of-the-box business solutions and custom (via SDK) Rifidi sensor/IoT device properties, providing the foundation for a Rifidi Application marketplace.

Introduction

The Web Administration Dashboard enables users to manage, monitor and configure Rifidi Servers, Sensors/Readers and Applications.

Go to http://localhost:8111/dashboard

Dashboard sections.png

Dashboard wizard section.png


Menu section

The menu is a hierarchical tree component, where all the configured servers are listed, and under each server there are three fixed sections:

  1. Sensor Management: Allows call operations related to sensors, such as listing sensors, create a new sensor connection, modify sensor properties, associate sessions to sensors, submit a command on a session
  2. Command Management: Allows create and delete command instances.
  3. App Management: Allows list the applications, start and stop them, modify application properties, group properties. It allows manage readzones, create, modify properties and delete.

Facility floor plan section

It will be available in a future release

Wizard section

When there is the need to create a component by using a wizard, it is displayed in wizard section.

Properties editor section

When a tree element is selected then its properties are displayed in this section, offering the possibility to read or modify them

Server Management

Prerequisites for Managing Remote Rifidi Servers

Due to browser security enhancements in order to use dashboard to manage remote Rifidi servers please follow these steps

1. Update the following JVM argument in the Rifidi Sever startup script to use the external ip address in place of localhost/127.0.0.1

example: -Djava.rmi.server.hostname=192.168.86.58 where 192.168.86.58 is the External IP Address of the device

2. Configure the Rifidi servers to run via https/ssl with a trusted signed cert from a CA

Steps for this can be found [[Edge_Management#Configuration_.28HTTP_over_SSL.29_-_Available_as_of_version_3.1.1|Rifidi Server Rest SSL Configuration]]

3. Go to dashboard using the ssl address: Example: https://192.168.86.58:8183/dashboard/#/


Another less ideal option is to turn off the browser security. Here is an example on how to do so in Chrome.

"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --disable-web-security --user-data-dir="c:/someFolderName"

Add Server

Add a new server connection to rest services

  1. Right click on 'Servers' node and then choose 'Add server'
    Add server link.png
  2. Provide the values for attributes: Display name, IP address, protocol and port where rest services are deployed on that server.
    Add server.png
  3. Click on 'Create' button and confirm
    Add server confirm2.png

Delete Server

Delete a server connection

  1. Right click on server node to delete and then choose 'Delete server'
    Delete server link.png
  2. Confirm delete operation
    Delete server confirm2.png

Update Server Connection Properties

Update connection properties for server

  1. Click on server node to modify and then go to properties editor area
    Edit server link.png
  2. Provide the values for attributes: Display name, IP address, protocol and port where rest services are deployed on that server.
    Modify server.png
  3. Click on 'Save' button and confirm
    Modify server confirm.png

Update Server Auto Refresh settings

Enables or disables the menu auto refresh feature, so web app periodically synchronizes with server to reflect actual state of elements

  1. Click on servers node and then go to properties editor area
    Edit servers link.png
  2. Provide the values for attributes: Enable auto refresh and auto refresh delay.
    Modify servers.png
  3. Click on 'Save' button and confirm
    Modify servers confirm.png

Save Server Configuration

Save config changes made on this server

  1. Right click on server node and then choose 'Save server config'
    Save server link.png
  2. Confirm the save operation
    Save server confirm.png

Save all servers Configuration

Save config changes made on all connected servers

  1. Right click on "Servers" node and then choose 'Save all servers config'
    Save all servers link.png
  2. Confirm the save operation
    Save all servers confirm.png


Sensor Management

Add Sensor Wizard

Steps user through creating sensor, session and command (where applicable).

  1. Right click on 'Sensor Management' node and then choose 'Add Sensor'
    Add sensor link.png
  2. Choose the sensor type and optionally provide the reader id and click Next
    Add sensor readertype selection.png
  3. Set the connection properties for sensor and optionally check if automatically start session, and click Next
    Add sensor set sensor properties.png
  4. Create the command for sensor, choose the command type and choose to create a new command instance or select an existing one, set the properties for command instance and set the scheduling options for executing command, and click Next
    Add sensor create command.png
  5. Review steps summary and confirm
    Add sensor summary.png

Update Sensor Properties

Option to modify sensor properties

  1. Click on sensor node to modify and then go to properties editor area
    Edit sensor link.png
  2. Provide the values for sensor attributes
    Edit sensor.png
  3. Click on 'Save sensor properties' button and confirm
    Edit sensor confirm.png

Delete Sensor

Option to delete a sensor connection

  1. Right click on sensor node to delete and then choose 'Delete Sensor'
    Delete sensor link.png
  2. Confirm delete operation
    Delete sensor confirm.png

Session

Start Session

To start a session on sensor

  1. Click on session node to start and then click on 'Start Session'
    Start session link.png

Stop Session

To stop a session on sensor

  1. Click on session node to stop and then click on 'Stop Session'
    Stop session link.png

Commands

Update Command properties

Allows the updating of properties for a command

  1. Click on command instance node to modify and then go to properties editor area
    Edit command link.png
  2. Provide the values for command attributes
    Edit command.png
  3. Click on 'Save' button and confirm
    Edit command confirm.png

Deleted Command

Deletes a command template

  1. Right click on command node to delete and then choose 'Delete Command Template'
    Delete command link.png
  2. Confirm delete operation
    Delete command confirm.png

Create Command

Creates a command template

  1. Right click on command type node, select 'Create Command Template' and then go to properties editor area
    Create command link.png
  2. Provide the values for command attributes
    Create command.png
  3. Click on 'Create' button and confirm
    Create command confirm.png

Execute Command

Executes a command on a session

  1. Right click on session element where you want to submit the job and then choose 'Submit Job'
    Execute command link.png
  2. Choose the command type and choose to create a new command instance or select an existing one, set the properties for command instance and set the scheduling options for executing command, and click Submit
    Execute command.png
  3. Confirm the operation clicking on 'Submit Job' buton
    Execute command confirm.png



Application Management

Readzones

Get Readzones

Option to list the readzones associated with an application group

  1. Click on 'ReadZones' menu element and it will display the readzones belonging to parent application group
    Readzones link.png

Add Readzone

To add a readzone definition associated with an application group

  1. Right click on 'ReadZones' node and then choose 'Add Read Zone'
    Add readzone link.png
  2. Set the readzone name and readerID, and optionally provide the antennas, matchPattern and tagPattern, and click on 'Create' button
    Add readzone.png
  3. Confirm the readzone creation operation
    Add readzone confirm.png

Delete Readzone

Deletes a readzone definition

  1. Right click on readzone node to delete and then choose 'Delete Command Template'
    Delete readzone link.png
  2. Confirm delete operation
    Delete readzone confirm.png

Update Readzone properties

Updates the properties for a readzone

  1. Click on readzone node to modify and then go to properties editor area
    Update readzone link.png
  2. Provide the values for readerID, and optionally provide the antennas, matchPattern and tagPattern attributes
    Update readzone.png
  3. Click on 'Save' button and confirm
    Update readzone confirm.png

Application Properties

Get / Update Group Properties

List and modify the application group properties

  1. Click on application group node to get / update and then go to properties editor area
    Update groupproperties link.png
  2. Provide the values for application group properties and click on 'Save'
    Update groupproperties.png
  3. Click on 'Save app group properties' button and confirm
    Update groupproperties confirm.png


Get / Update Application Properties

List and modify the application properties

  1. Click on application node to get / update and then go to properties editor area
    Update appproperties link.png
  2. Provide the values for application properties and click on 'Save'
    Update appproperties.png
  3. Click on 'Save app properties' button and confirm
    Update appproperties confirm.png

Diagnostic

Current Tags View

  1. Right click on reader/sensor name
    Currenttagsmenu.png
  2. Click on Current tags to view tags on reader
    Currenttagsview.png
Personal tools