Installing Enterprise Gateway for Raspberry Pi

This page describes how to download and install the deviceWISE Enterprise Gateway product on a Raspberry Pi 2 Model B running Raspbian "jessie", a free, custom GNU/Linux distribution available for the Raspberry Pi:

https://www.raspberrypi.org/downloads/raspbian/

Prerequisites

The following is assumed:

Install Java 8 Runtime.
You have a Raspberry Pi 2 Model B, prepared as per the following instructions:
- Following the Raspbian Installation Instructions, deploy Raspbian "jessie" on your Raspberry Pi 2 Model B.
- Depending on your installation method, you need to expand the root filesystem to provide enough disk space to accommodate deviceWISE. Use the raspi-config utility to perform the disk expansion. For more information, see the "Expand filesystem" section in the following document: https://www.raspberrypi.org/documentation/configuration/raspi-config.md
You have an Ethernet cable
You have a computer, such as a laptop, that can be used to log on to the Management Portal and can have its IP address changed to allow a direct Ethernet cable connection to the Raspberry Pi at it's assigned IP address
You have a Management Portal user ID and password and know how to log on. You need this to download the Enterprise Gateway installation file from the Management Portal.
If you need a Management Portal account, see Creating the deviceWISE Cloud account.
If you received the installation files from your support representative, you can skip the download steps and proceed with "Installing deviceWISE Enterprise Gateway Software".

Obtaining deviceWISE Gateway Software for Raspberry Pi

Log on to the Management Portal, and select Developer. The Developer menu appears.
From the Developer menu, select Resources.
From under Index of files, select the appropriate build (if you are not sure, pick the latest available build).
Select RaspberryPi.
Select Raspbian.
Locate the Enterprise_Gateway directory. Select DWEnterprise_Install.Linux-ARM-Raspbian.XXX.tar.gz (where XXX is the version of the Enterprise Gateway software you want to download) and download the file to a temporary location on the computer.

Installing deviceWISE Enterprise Gateway Software

Copy the installation file to the Raspberry Pi device using the secure copy program scp(1), or an SCP-capable client such as WinSCP.
After copying the file to the Raspberry Pi, log on to the Raspberry Pi using ssh(1) or an SSH client program such as PuTTY. By default, you can use the username "pi" with the default password "pi".
From within the Raspberry Pi SSH session console, change directories to the directory to which you copied the installation file. Extract the file, then change directories to the extracted contents directory.
Installation is achieved by running the deviceWISE *.install file located in the directory, after confirming the install and agreeing with the software license. The installation file is named: dwenterprise_raspbian.install

The following transcript demonstrates installation of deviceWISE Enterprise Gateway version 16.1.4-002 on a Raspberry Pi configured with the IP address 192.168.1.58:

Installation Example

bgooch@centos-7-x64[/home/bgooch]$ scp DWEnterprise_Install.Linux-ARM-Raspbian.16_1_4-002.tar.gz pi@192.168.1.58:/tmp/
pi@192.168.1.58's password:
DWEnterprise_Install.Linux-ARM-Raspbian.16_1_4-002.tar.gz                                                                        100% 32243KB   6.0MB/s   00:00
bgooch@centos-7-x64[/home/bgooch]$ ssh pi@192.168.1.58
pi@192.168.1.58's password:
The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.
Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
Last login: Sat Dec 19 03:21:56 2015 from 192.168.1.10
pi@raspberrypi:~ $ cd /tmp
pi@raspberrypi:/tmp $ tar -xzf DWEnterprise_Install.Linux-ARM-Raspbian.16_1_4-002.tar.gz
pi@raspberrypi:/tmp $ cd dwenterprise_raspbian/
pi@raspberrypi:/tmp/dwenterprise_raspbian $ sudo ./dwenterprise_raspbian.install
Copyright 2007-2016 by Telit IoT Platforms, LLC. All Rights Reserved.
This installation script will install the deviceWISE Enterprise Gateway for Raspberry Pi
software version 16.1.4 on your system.
Do you wish to continue? yes
...
Updating file permissions...
Running post-install commands...
Starting deviceWISE Enterprise Gateway for Raspberry Pi daemon...
Installation is complete.

Uninstalling deviceWISE Enterprise Gateway Software

To uninstall or remove the product:

You may want to do a node Back Up, using the Workbench, before uninstalling the product to capture the current application definition and system configuration information.
Log on to the device using the SSH client of your choice.
Stop the deviceWISE service:
Stopping deviceWISE
```
sudo /opt/dw/devicewise stop
```
After the deviceWISE service has stopped, run the uninstall script:
Uninstalling deviceWISE Enterprise Gateway
```
sudo /bin/sh /etc/software/dwenterprise_raspbian.remove
```
After the uninstall script completes, you may remove the deviceWISE directory from the filesystem:
Removing the deviceWISE Application Directory
```
sudo rm -rf /opt/dw
```

Next steps

If you are following the steps in the Getting Started with Gateways guide, you can continue with the tasks described in Installing the Workbench to perform the initial Enterprise Gateway configuration and to connect the Enterprise Gateway to the deviceWISE Cloud.

If you are not following the steps in the Getting Started with Gateways guide and need to install the Workbench, you can continue with the tasks described in Installing the Workbench software.

If the Workbench is already installed, see The Workbench in the Gateway Developer's Guide and Reference for information on using the Workbench and the deviceWISE features that it can access.