Installing Enterprise Gateway for Dell Edge with Ubuntu Server (Discontinued)

This page describes how to download and install the deviceWISE Enterprise Gateway on a Dell Edge Gateway 5000 running Ubuntu Server.

The Dell Edge gateways supported include:

Dell Edge Gateway 5000 with Ubuntu Server 16.04 LTS

Prerequisites

The following is assumed:

You have the Dell Edge Gateway 5000 hardware running Ubuntu Server 16.04 LTS.
You have a Management Portal user ID and password and know how to log on. You need this to download the Enterprise Gateway installation files 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 Telit representative, you can skip the download steps and proceed with the instructions contained in the Running the Installation Script section of this document.
You are familiar with basic Linux commands and have administrative access to the Dell Edge Gateway 5000.
The Ubuntu Server administrative account has permission to execute processes as the user root, either directly or via the sudo(1) program.

Configuring the Dell Edge Gateway 5000 running Ubuntu Server

For information regarding setup and configuration of Ubuntu Server, please refer to the Official Ubuntu Documentation website.

Please refer to the Dell Edge Gateway 5000 Series Installation and Operation Manual for information regarding setup and configuration of the Dell Edge Gateway 5000 hardware.

Obtaining the Enterprise Gateway for Linux install file

The Dell Edge Gateway 5000 is installed using the deviceWISE Enterprise Gateway for Linux 64-bit installation files.

Follow these steps to download the Enterprise Gateway for for Linux install file:

Log on to the Management Portal, and then 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 OS_Linux.
Select Linux-X64-Generic.
Select Enterprise_Gateway.
Select DWEnterprise_Install.Linux-X64-Generic.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 your computer.

Running the Installation Script

This section provides instructions on copying and extracting files contained in the deviceWISE product distribution file, and the execution of the deviceWISE installation script.

Using an SCP or SFTP client, copy the DWEnterprise_Install.Linux-X64-Generic.XXX.tar.gz file to the Dell Edge Gateway 5000's /tmp directory using your Ubuntu Server administrative user account.
Using an SSH client, log in to the Dell Edge Gateway 5000 unit using your Ubuntu Server administrative user account.
Change directory to /tmp:
```
# cd /tmp
```
Decompress the archive file via the tar(1) command:
```
# tar -zxf DWEnterprise_Install.Linux-X64-Generic.XXX.tar.gz
```
This creates a directory with the name dwenterprise within the /tmp directory.
Change directory to /tmp/dwenterprise directory:
```
# cd /tmp/dwenterprise
```
Execute the deviceWISE Enterprise Gateway installation script:
```
 # sudo ./devicewise.install
```
When prompted by the installer, you must accept the EULA to proceed. Using the PAGE DOWN key or the SPACEBAR on the keyboard, scroll through the license until you are prompted to confirm agreement with the license.
Proceed by entering the word yes and then pressing the ENTER key on the keyboard.
deviceWISE Enterprise Gateway will not begin installing the /opt/dw path.
Upon installation completion, deviceWISE Enterprise Gateway automatically starts. Additionally, deviceWISE Enterprise Gateway will start-up automatically upon boot-up of the operating system.

Starting, Stopping, or Restarting the deviceWISE Enterprise Gateway Software

Example Use of the systemctl(1) Utility

# systemctl [status|start|stop|restart] devicewise

Calling the Service Management Script Directly

Invoking the deviceWISE init Script Directly

# /opt/dw/devicewise [status|start|stop|restart]

Uninstalling the deviceWISE Enterprise Gateway Software

NOTE: You may want to do a node Back Up before uninstalling the product to capture the current application definition and system configuration information.

First, stop the deviceWISE service using one of the previously documented methods (see section titled: Starting, Stopping, or Restarting the deviceWISE Enterprise Gateway Software).

Remove the deviceWISE directory from the filesystem:

Removing the deviceWISE directory

# rm -rf /opt/dw

Remove the deviceWISE service from the systemd manager:

Removing the deviceWISE systemd service

# systemctl disable devicewise.service
# systemctl daemon-reload
# find /usr/lib/systemd -name "devicewise.service" | xargs rm -f

Linux Firewall Configuration

In order to access the deviceWISE Enterprise Gateway services using the deviceWISE Workbench, you may be required to implement the following change to your system's firewall policy, including intermediate network devices which may reside in the network path of the server and the system from which you will be accessing the server using the deviceWISE Workbench.

Allow traffic to flow bidirectionally through the associated interfaces and network path between your server and the system from which you will be accessing the deviceWISE Enterprise Gateway services:

Protocol:Port	Description
TCP:4012	Primary communication between the Workbench and the node.
UDP:4009	Workbench to node Scan and status information.

Linux firewall configuration varies among distributions and versions of Linux, so please refer to your system's documentation and confer with your organization's network administration team when applying these policy changes.

Connecting to the deviceWISE Enterprise Gateway Using the deviceWISE Workbench

After the deviceWISE Enterprise Gateway is installed, you can connect to it using the Workbench to begin the configuration and application development tasks. For information on installing the Workbench and connecting to nodes, see 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.