Introduction

This section includes a step-by-step guide on how to add a new gateway to the system and how to replace a faulty gateway. Use the steps described bellow if you wish to add a new Raspberry Pi board to the system or if an existing Raspberry Pi board needs replacing.

Note:

Steps that require more details will include links to the appropriate sections in this documentation.

Prerequisites

In order to add or replace a gateway the following items are required:

• New Raspberry Pi board
• Debian based OS installed on the board

raspbian is the recommended Debian based OS for the Raspberry Pi. For download and installation instructions visit raspbian.

Add a new gateway

1. Log into the ubiworx interface and click on the Add button in the left navigation menu. To go directly to the Add gateway form click here.
2. Fill in the form, detailed instruction on how to fill in the form can be found here.
3. You should be able to see your newly created Gateway in the dashboard.
4. Note your vendor ID and your gateway ID for later use. Your vendor ID can be found by clicking on your username in the upper right corner. For viewing the gateway ID, go back to the dashboard and lookup its ID in the ID column.

Install ubiworx

1. Login to your Raspberry as root or execute all following commands with root privileges.
2. Download the apt authentication key from the official ubiworx server by executing

wget http://ubiworx.com/gpg.key -O - | apt-key add -

3. Add the official ubiworx package repository to your sources.list.

echo "deb http://ubiworx.com/debian wheezy non-free" >> /etc/apt/sources.list

4. Update your package index.

apt-get update

5. Install ubiworx using apt-get. During the installation you will be asked for your vendor ID and gateway ID (device ID). Enter your notes from Add a new gateway.

apt-get install ubiworx-lite

6. Start ubiworx and see your gateway going green on the webinterface.

/etc/init.d/ubiworx start

Note:

Your gateway will now automatically connect to the Emutex cloud and fetch the settings you entered there. Your sensors will start reporting after the automatic configuration step has finished.