Gateway configuration

Gateway dashboard

The gateway dashboard displays a list of all available gateways and permit you to manage them and display the information that they have collected.

This is the main application view and you can return to this view from any section of the app by clicking on the ubiworx logo in the top navigation bar.

To view the sensors and actuators associated with a gateway just click on the gateway name.

list of ubiworx gateways

List of ubiworx gateways

Column
Description
STATUS
Indicates if the gateway is still active or not. A
gateway is considered to be offline if the last time the
ubiworx broker has received any information from the
gateway is two times longer then the keep alive interval
specified in the gateway configuration settings.
NAME
Displays the gateway name and when clicked it navigates
to the sensors dashboard view for
the selected gateway.
LAST CONNECTION
The last time the ubiworx broker has received an active
notification from the gateway.
ACTIONS
Info: open a window that gives you more detail about the gateway.
Edit: open the edit gateway page.
Manage: permit to manage the software installed on the gateway.
Clone: permit to create a copy of the gateway.
Checkbox
Select one of multiple gateways to manage.

The search box allows users to filter the list of gateways based on the values they type in. The filter works by searching all the columns present in the view.

Add a new gateway

  1. Go to the ubiworx broker dashboard https://broker.ubiworx.com.
  2. Click on the add button add on the bottom of the GATEWAYS table.
  3. Fill in the form, the most important field are the Name and Unique ID fields, the others are optional.
  4. Save changes using the Save and sync button.

After doing this, the changes are saved on the ubiworx broker and will be synced when the gateway connects.

NEXT: Go to the install ubiworx on your gateway section to connect your gateway.

Note

For more information about gateway parameters go to the Gateway parameters List.

Edit gateway

The edit gateway feature allows users to edit the configuration values of a gateway.

  1. Go to the ubiworx broker dashboard https://broker.ubiworx.com.
  2. In the table click on the small pencil icon pencil near the gateway that you want to edit.
  3. Amend the required fields.
  4. Click on the Save & Sync button to save and apply the changes.

Warning

Any of the configuration fields can be edited except for the gateway Unique ID.

Clone gateway

The clone feature provides users with the possibility to quickly add new gateways to the system copying all the settings from a similar gateway. The new gateways will have the same configuration values as the original.

  1. Go to the ubiworx broker dashboard https://broker.ubiworx.com
  2. In the table click on the clone icon clone near the gateway that you want to clone.
  3. Insert a NEW device name and a NEW unique ID.
  4. Complete the operation clicking on the clone button.

After that the changes are saved on the ubiworx broker and will be synced when the gateway connects.

Note

The clone feature adds a new gateway to the system. To replace a faulty gateway please use the edit feature and update the details with the replacement gateway details. See the edit gateway documentation.