Installing Asset Gateway for Raspberry Pi 3

This page describes how to download and install the deviceWISE Asset Gateway product on a Raspberry Pi 3 running Raspbian Stretch, a free, custom GNU/Linux distribution available for the Raspberry Pi.

Prerequisites

The following is assumed:

You have a Raspberry Pi 3, prepared as per the following instructions:
- Following the Raspbian Installation Instructions, deploy Raspbian Stretch on your Raspberry Pi 3.
- Depending on your installation method, you may have to expand the root filesystem to provide enough disk space to accommodate the deviceWISE Asset Gateway product. 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 Asset 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 Asset 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 Asset_Gateway directory. Select DWGateway_Install.Linux-ARM-Raspbian.XXX.tar.gz (where XXX is the version of the Asset Gateway software you want to download) and download the file to a temporary location on the computer.

Installing deviceWISE Asset 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.
Copy the installation file to a directory such as /tmp.
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. Please refer to the distribution documentation for details or troubleshooting instructions.

Log on using user = pi and password = raspberry.
At the command prompt, do the following:

>> cd
											/tmpgunzip
											
>> DWGateway_Install.Linux-ARM-Raspbian.XXX.tar.gz
>> tar                                                    -xvf
										DWGateway_Install.Linux-ARM-Raspbian.XXX.tar

cd dwgateway_raspbian
sudo ./dwgateway_raspbian.install

A message and prompt appears asking if you want to continue installing the software.
Type Yes (and press Enter).
A license agreement is displayed.
Page down through the license agreement until the end.
You are asked if you agree with the terms of the license agreement.
Type Yes (and press Enter).
The install file will display information as it executes the installation and will display:
. . . systemd detected, installing deviceWISE services Installation is complete.

The deviceWISE Asset Gateway software has been installed in the /opt/dw directory.

Uninstalling deviceWISE Asset 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 Asset Gateway
```
sudo /bin/sh /etc/software/dwgateway_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 Asset Gateway configuration and to connect the Asset 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.

Install any device driver or extension files that need to be applied to a node using the Packages tab. It is important to have the supported level of the device driver or extension files that match the base run time release level. If there are any questions or concerns, contact your support representative. See Packages for more information on adding device driver and extension files.