Installing Enterprise Gateway for Rockwell ControlLogix Compute Module

This page describes how to download and install the deviceWISE Enterprise Gateway on a Rockwell ControlLogix Compute Module.

Prerequisites

The following is assumed:

You have the Rockwell ControlLogix Compute Module hardware.
- 32-bit: 1756-CMS1C1
- 64-bit: 1756-CMS1D1
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 Rockwell ControlLogix Compute Module.
You can execute processes on the Rockwell ControlLogix Compute Module as the root user.

Obtaining the Enterprise Gateway for Rockwell ControlLogix Compute Module Installer

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 Rockwell.
Select ControlLogix.
For the 1756-CMS1D1, select Linux-X64-Generic. For the 1756-CMS1C1, select Linux-X86-Generic.
Select Enterprise_Gateway.
Select DWEnterprise_Install.Rockwell.ControlLogix.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.Rockwell.ControlLogix.XXX.tar.gz file to the Rockwell ControlLogix Compute Module's /tmp directory as the user root.
Using an SSH client, log in to the Rockwell ControlLogix Compute Module unit as the user root.
Change directory to /tmp:
```
# cd /tmp
```
Decompress the archive file via the tar(1) command:
```
# tar -zxf DWEnterprise_Install.Rockwell.ControlLogix.XXX.tar.gz
```
This creates a directory with the name dwenterprise_rockwell_controllogix within the /tmp directory.
Change directory to /tmp/dwenterprise_rockwell_controllogix directory:
```
# cd /tmp/dwenterprise_rockwell_controllogix
```
Execute the deviceWISE Enterprise Gateway installation script:
```
# sudo ./dwenterprise_rockwell_controllogix.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 disable dwtransaction.service
# systemctl daemon-reload
# find /etc/systemd -name "devicewise.service" | xargs rm -f
# find /etc/systemd -name "dwtransaction.service" | xargs rm -f

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.