Installing Asset Gateway for Dell Edge (Discontinued)

This page describes how to download and install the deviceWISE Asset Gateway on a Dell Edge gateway.

The Dell Edge gateways supported include:

• Dell Edge Gateway 5000 with WindRiver Linux 7.

Prerequisites

The following is assumed:

• You have the Dell Edge gateway.
• You have a Management Portal user ID and password and know how to log on. You need this to download the Asset 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 Running the install program.
• You are familiar with basic Linux commands and have root access to the Dell Edge gateway.

Configuring the Dell Edge gateway

Intel ® IoT Gateway Software Suite WindRiver® Linux 7

The Dell Edge gateway should be configured using the web-based UI supplied by the vendor. The web-based UI is available upon installation of WindRiver Linux 7 via HTTP  on TCP port 80.
Use a web browser and enter the IP address of your Dell Edge gateway.

LuCI Web Interface

Alongside the web UI provided by the Intel ® IoT Gateway Software Suite WindRiver® Linux 7 environment, the configuration utility LuCIis provided to perform many of the administrative configuration tasks. LuCI is available vi HTTPS running on TCP port 443.
Use a web browser and enter https://the IP address of your Dell Edge gateway.

For more information regarding setup and configuration of Wind River Linux, please visit the Wind River Linux Getting Started, 7.0 website.

Obtaining the Asset Gateway for Linux install file

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

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

1. Log on to the Management Portal, and then select Developer.
   The Developer menu appears.
   
2. From the Developer menu, select Resources.
   
3. From under Index of files, select the appropriate build (if you are not sure, pick the latest available build).
   
4. Select OS_Linux.
   
5. Select Linux-X64-Generic.
   
6. Select Asset_Gateway.
   
7. Select DWGateway_Install.Linux-X64-Generic.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 your computer.

Running the install program

Follow these steps to extract and run the Linux install program:

1. Telnet or log on to the target Dell Edge gateway as root.
   
2. Copy the downloaded DWGateway_Install.Linux-X64-Generic.XXX.tar.gz file from the temporary download computer and location into the Dell Edge gateway's /tmp directory.
   
3. At the command line type:
   /tmp>gunzip DWGateway_Install.Linux-X64-Generic.XXX.tar.gz (and press Enter).
   This creates a file with a .tar extension (DWGateway_Install.Linux-X64-Generic.XXX.tar).
   
4. Unpack the created .tar file:
    /tmp>tar -xvf DWGateway_Install.Linux-X64-Generic.XXX.tar (and press Enter)
   This creates a directory called dwgateway under the current directory.
   
5. At the command line, change to the dwgateway directory:
   /tmp>cd dwgateway (and press Enter)
   
6. Run the Linux install program from the dwgateway directory:
   /tmp/dwgateway>./devicewise.install(and press Enter).
7. A message and prompt appears asking if you want to continue installing the software.
   Type Yes (and press Enter).
   
8. A license agreement is displayed.
   Page down through the license agreement until the end.
   
9. You are asked if you agree with the terms of the license agreement.
   Type Yes (and press Enter).
   
10. When the installation is complete, the following directory structure is created:
    /opt/dw/
    The Asset Gateway software should be running.

Starting, Stopping, or Restarting the deviceWISE Asset Gateway Software

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

Calling the Service Management Script Directly

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

Uninstalling the deviceWISE Asset 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 Asset Gateway Software).

Remove the deviceWISE directory from the filesystem:

# rm -rf /opt/dw

Remove the deviceWISE service from the systemd manager:

# 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 Asset 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 Asset Gateway services:

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.

Asset Gateway for Dell Edge gateway limitations

The Dell Edge gateway is installed using the deviceWISE Asset Gateway for Linux 64-bit installation files. The following limitations exist:

• The Administration -> Network Management tab should not be used to configure the network interface. Use the Dell provided web interface to configure the gateway's network adapter and DNS server parameters. For example: https://the IP address of your Dell Edge gateway. Use the Network menu item, then the Interfaces option for WAN eth0 to set the network configuration for the Ethernet port labeled "1" on the Dell Edge gateway.
• The Administration -> Node Administration tab does not display Disk Usage information.
• deviceWISE cellular modem features are not supported: Administration -> Cellular Configuration and Cellular Advanced Configuration tabs, trigger cellular actions, and trigger cellular events.

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 LAN settings 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.