Installing Enterprise Gateway for Linux

This page describes downloading and installing the deviceWISE Enterprise Gateway on a Linux system.

The deviceWISE Enterprise Gateway for Linux requires:

  • Approximately 300 megabytes (MB) of disk space.
  • A recommended minimum of 1 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 the Enterprise Gateway and the enterprise applications.
    The Transaction Server is started with the min/max heap size of 128M/512M. Based on that the recommended physical RAM should be 1G.

Prerequisites

When installing and running the 32-bit version of deviceWISE Enterprise Gateway for Linux on a 64-bit Linux distribution such as CentOS 7, you must install the 32-bit glibc compatibility library for your distribution. For example, in CentOS 7 you must install the glibc.i686 package:

# yum install glibc.i686

For other Linux distributions, refer to the distribution documentation for more details.

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 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 support 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 Linux computer.

Obtaining the Enterprise Gateway for Linux install file

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

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

Running the install program

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

  1. Telnet or log on to the target Linux computer as root.
  2. Copy the downloaded DWEnterprise_Install.Linux-X86-Generic.XXX.tar.gz file from the temporary download computer and location into the Linux computer's /tmp directory.
  3. At the command line type:
    /tmp>gunzip DWEnterprise_Install.Linux-X86-Generic.XXX.tar.gz (and press Enter).
    This creates a file with a .tar extension (DWEnterprise_Install.Linux-X86-Generic.XXX.tar).
  4. Unpack the created .tar file:
     /tmp>tar -xvf DWEnterprise_Install.Linux-X86-Generic.XXX.tar (and press Enter)
    This creates a directory called dwenterprise under the current directory.
  5. At the command line, change to the dwenterprise directory:
    /tmp>cd dwenterprise and press Enter
  6. Run the Linux install program from the dwenterprise directory:
    /tmp/dwenterprise> ./devicewise.install and press Enter.

    To perform a fully automated install use the now flag.

    /tmp/dwenterprise> ./devicewise.install now

  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 Enterprise Gateway software should be running.

Starting, stopping, restarting or uninstalling the Enterprise Gateway software

The Enterprise Gateway for Linux software runs as Linux services and will normally be started when Linux is started.

If the main Enterprise Gateway components need to be started or stopped for some reason, there is a shell script available to control the services.

You must be logged on as root.

Go to the /opt/dw directory and type:

/opt/dw> ./devicewise [start|stop|restart|status]

To uninstall or remove the product:

  • You may want to do a node Back Up before uninstalling the product to capture the current application definition and system configuration information.
  • Go to the /opt directory and remove the dw directory.

Linux firewall configuration

The deviceWISE Enterprise Gateway for Linux may need Linux operating system permission to access enterprise applications and to connect with the deviceWISE Workbench.

The Linux firewall configuration varies with the different versions of Linux, but the main topic to discuss and configure with your network administrator is allowing the deviceWISE Core to communicate through the Linux firewall.

Protocol:Port

Description

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

Connecting to the Enterprise Gateway using the Workbench

After the Enterprise Gateway for Linux 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.

Related Topics Link IconRelated Topics