Add a Gateway

Insert a new gateway into the system.

Add a gateway

Insert a new gateway into the system.

Introduction

The ubiworx broker has 2 ways by which users can add a new gateway to the system. The section bellow explains how to add the details for a new gateway to the system. For information on how to add a new gateway by cloning an existing configuration click here.

Note:

This assumes you have a ubiworx gateway and are ready to connect it to the ubiworx broker If you don’t check out the gateway installation guide.

Prerequisites

In order to add a new gateway the following are required:

A gateway running ubiworx.
The MAC address of the new gateway.

Adding a new gateway:

Go to the home view by clicking in the ubiworx logo or the icon.
In the gateway side navigation click on the Add button under the Configuration section.
Fill in the form (not all fields are mandatory). See the section bellow with details about each field.
Save changes using the button, the changes are saved on the ubiworx broker and will be synced when the gateway connects.

Filling in the form

Fields marked with an asterisk * are mandatory.

General info

Field	Description
Name *	Insert a name for the new gateway.
Unique ID *	Insert a unique ID, this ID needs to be globally unique to your account. Note: this field can NOT be changed once created.
MAC *	Identifies the hardware device being used. If a gateway needs to be replaced, the value in this field can be updated to reflect the new hardware.
Keepalive interval	The number of seconds between each “active” notification. If the ubiworx broker has not received a notification for a period of twice as long as the value in this field, the gateway will be automatically considered to be offline.
Mobile	Indicate if the location of the gateway is constantly changing. For example the gateway is installed in a car, a train.
Latitude	Indicate the location of the gateway.
Longitude	Indicate the location of the gateway.

Configuration

Field	Description
Broker *	The IP address of the device you wish to communicate with for example broker.ubiworx.com
ESSID ID *	The name of the wireless network. If the new gateway is a Client, the name is the ID of the network you want to connect to. If the new gateway is a Access Point, the name is the ID of the network you want to create.
SSID Channel	Indicate the wireless network channel.
WPA/WPA2 passphrase *	The password for the wireless network.
Gateway type *	Indicate if the new gateway is an Access Point or a Client to an access point.
Select parent gateway	If the new gateway is a Client, indicate who is the parent.
DHCP	Indicate if the IP address is dynamically allocated.
Static IP address	Store the static IP number for the new gateway.
Subnet mask	Used to identify the network address on an IP.
DNS server	The IP of the server used to resolve domain names.
Mail server	The server used to send email alerts.
Email alert list	The email address used to receive any alarms triggered in relation to this gateway.
SMS alert list	The phone number used to receive any alarms triggered in relation to this gateway.