Installing Enterprise Gateway for 64-bit Linux

This page describes how to download and install deviceWISE Enterprise Gateway on a 64-bit Linux system.

The deviceWISE Enterprise Gateway software requires:

Approximately 400 megabytes (MB) of disk space for initial installation, with additional space requirements varying based on the organization's use case.
A recommended minimum of 2 gigabytes (GB) of available memory.
Memory utilization greatly varies based on the application needs, the number of concurrently executing triggers, the number of transport maps, and the size of the data being sent between deviceWISE Enterprise Gateway and the enterprise applications.

Prerequisites

The following is assumed:

You have a Management Portal user ID and password and know how to log on. You need this to download the deviceWISE Enterprise Gateway installer 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 the section titled Running the Installer.
You are familiar with basic Linux tasks and utilities, e.g. cd, ls, tar(1), and others.
You have root access to the Linux computer.

Obtaining the deviceWISE Enterprise Gateway Installer

Log on to the Management Portal, and then click Developer.
The Developer screen appears.
On the Developer screen, click Resources.
From under Index of files, select the appropriate build (if you are not sure, pick the latest available build).
Click OS_Linux.
Click Linux-X64-Generic.
Click Enterprise_Gateway.
Click and download the DWEnterprise_Install.Linux-X64-Generic.XXX.tar.gz installer to your local system (where XXX is the version of deviceWISE Enterprise Gateway you want to download and install).

Running the Installer

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

Copy the DWEnterprise_Install.Linux-X64-Generic.XXX.tar.gz installer to the Linux system using a file transfer utility (e.g. WinSCP on Windows, the scp(1) command line utility, or a traditional FTP utility). Ensure that sufficient space exists in the destination directory on the Linux system. For our example, we will use the /tmp directory.
Log in to the Linux system via the preferred method for your organization (e.g. console, SSH, or Telnet). You must log in as the user root, or obtain root privileges using the specified method for your organization (e.g. sudo(8) or su(1)).
After logging in to the system, change your current directory to the directory in which the installer resides:
```
[root@server ~]# cd /tmp
```
Extract the installer file using the tar(1)utility:
```
[root@server tmp]# tar -xzvf DWEnterprise_Install.Linux-X64-Generic.XXX.tar.gz
```
This will extract the contents of the archive, resulting in the creation of the dwenterprise directory. This directory contains the installation files.

Change into the newly-created dwenterprise directory, and execute the installation script:

[root@server tmp]# cd dwenterprise
[root@server dwenterprise]# /bin/sh devicewise.install

To perform a fully automated install use the now flag.

[root@server tmp]# cd dwenterprise
[root@server dwenterprise]# /bin/sh devicewise.install now

You will be prompted for confirmation to continue the installation. Type yes, and then press the Enter key to continue.
Accept the License Agreement by scrolling down using the appropriate pager key (this is typically the Spacebar on the keyboard), and entering the word yes. Press the Enter key to continue.
When the installation is complete, the deviceWISE Enterprise Gateway software is installed to the /opt/dw directory, and the deviceWISE Enterprise Gateway services are active.
```
[root@centos-x64-01 dwenterprise]# ls -l /opt/dw
total 76
[File Listing Follows...]
```

Managing the deviceWISE Enterprise Gateway Services

The services associated with deviceWISE Enterprise Gateway are installed and will start during the Linux operating system services initialization.

However, if the services require manual intervention for any reason, you can utilize the deviceWISE Enterprise Gateway service control script to start, stop, restart, or check the status of the services. Note that you must be logged on as root to perform these operations.

After logging into the system via SSH, you can execute the deviceWISE service control script with the appropriate command parameter, i.e.:

deviceWISE Service Control

/bin/sh /opt/dw/devicewise [start|stop|restart|status]

Uninstalling deviceWISE Enterprise Gateway

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

The deviceWISE Enterprise Gateway installer contains an uninstall script which may be used to remove the software. If the installer is no longer available on the system, you will need to re-upload the file and extract the contents using the instructions found in the Running the Installer section above. In the following series of steps, we utilize the same file contents previously extracted in the Running the Installer section above.

Log in to the Linux system via the preferred method for your organization (e.g. console, SSH, or Telnet). You must log in as the user root, or obtain root privileges using the specified method for your organization (e.g. sudo(8) or su(1)).
Change into the original installer's extracted dwenterprise directory, then execute the devicewise.remove script:
```
[root@server ~]# cd /tmp/dwenterprise
[root@server dwenterprise]# /bin/sh devicewise.remove
```
You will be asked to confirm the uninstall process. To proceed, enter yes at the prompt to confirm, then press the Enter key to continue.
The deviceWISE Enterprise Gateway services have been stopped, and the software has been uninstalled.

Most components of the deviceWISE Enterprise Gateway software will be removed by the uninstall script. However, some files and directories will remain on the filesystem, consisting mostly of content created at runtime by the software, and your organization's data files generated by using the system.

To completely remove this remaining content, you can recursively delete the /opt/dw directory from the command-line (logged in as the root user):

[root@server ~]# rm -rf /opt/dw

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 deviceWISE Enterprise Gateway Using the deviceWISE Workbench

After 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.