Installing Asset Gateway for Linux

This section explains the steps to download and install the deviceWISE Asset Gateway in a Linux environment.

The following is assumed:

  • You have the Linux computer .
  • 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 Linux computer.

  • When installing and running the 32-bit version of deviceWISE Asset 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.

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

  1. Log on to the Management Portal.
  2. Navigate to Developer >> Resources.
  3. Click on the appropriate build folder(if you are not sure, pick the latest available build. For example: 25.02).
  4. Navigate to OS_Linux>>Linux-X86-Generic>>Asset_Gateway
  5. Click on DWGateway_Install.Linux-X86-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.
  6. Telnet or log on to the target Linux computer as root.
  7. Copy the downloaded DWGateway_Install.Linux-X86-Generic.XXX.tar.gz file from the temporary download computer and location into the Linux computer's /tmp directory.
  8. At the command line enter:
    /tmp>gunzip DWGateway_Install.Linux-X86-Generic.XXX.tar.gz and press Enter.
    This creates a file with a .tar extension (DWGateway_Install.Linux-X86-Generic.XXX.tar).
  9. Unpack the created .tar file:
    /tmp>tar -xvf DWGateway_Install.Linux-X86-Generic.XXX.tar and press Enter
    This creates a directory called dwgateway under the current directory.
  10. At the command line, change to the dwgateway directory:
    /tmp>cd dwgateway and press Enter.
  11. Run the Linux install program from the dwgateway directory:
    /tmp/dwgateway>./dwgateway.install and press Enter.
    A message and prompt appears asking if you want to continue installing the software.
  12. Type Yes and press Enter.
    A license agreement is displayed.
  13. Page down through the license agreement until the end.
    You are asked if you agree with the terms of the license agreement.
  14. Type Yes (and press Enter).
    When the installation is complete, the following directory structure is created: /opt/dw/
    The Asset Gateway software should be running.

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

If the main Asset Gateway component needs 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.

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.

Install any device driver or extension files that need to be applied to a node using the Packages tab. It is important to have the supported level of the device driver or extension files that match the base run time release level. If there are any questions or concerns, contact your support representative. See Packages for more information on adding device driver and extension files.