Installing Enterprise Gateway for 64-bit AIX

This page describes how to download and install the deviceWISE Enterprise Gateway for 64-bit AIX product on an AIX system.

The deviceWISE Enterprise Gateway for 64-bit AIX 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

The following is assumed:

  • You have IBM AIX 6.1 with Technology Level 6100-07 or higher, or IBM AIX 7.1 with Technical Level 7100-03 or higher.
  • 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 Running the install program.
  • You are familiar with basic AIX commands and have root access to the AIX computer.

Java for 64-bit AIX

Your installation requirements for IBM Java for AIX are:

Before proceeding with the deviceWISE Enterprise Gateway for 64-bit AIX installation, review these Java requirements and deviceWISE installation and update scenarios:

Java requirement

For deviceWISE Enterprise Gateway for 64-bit AIX, the summary of the Backup, Installation and Restore steps is:

  • Your AIX system has the appropriate Service Pack installed, as indicated on https://www.ibm.com/developerworks/java/jdk/aix/service.html

  • Your AIX system must have the JRE 1.8 installed in /usr/java8_64.
    If you installed the JRE 1.8 in a non-default location that is being used by other processes on the AIX system, you can have deviceWISE reference that install location by creating a symbolic link reference in the /usr directory:. For example:
    /usr/java8_64 -> /non-default/path/to/java8/

  • The deviceWISE Enterprise Gateway for 64-bit AIX installer will check for the existence of the /usr/java8_64/jre/bin/java binary before proceeding with the installation.
    If the /usr/java8_64/jre/bin/java binary is not found (or handled by a non-default location symbolic link reference), the installer will display an error message and abort.
  • If you are updating from a release of the of deviceWISE Enterprise Gateway for AIX (a 32-bit product), you can not use the deviceWISE Update Firmware option, you must do a full installation.
    You should:
    • Use the Workbench to do a Back Up of the node's definitions and preserve all configuration changes you have made, such as dwcore.properties file values.
    • Uninstall the current release of deviceWISE Enterprise Gateway for AIX (32 bit product).
    • Make sure IBM Java JRE 1.8 64-bit for AIX is installed in /usr/java8_64
    • Install the new release of deviceWISE Enterprise Gateway for 64-bit AIX.
    • Use the Workbench to do a Restore of the node's definitions.
    • Reapply all configuration changes you have made, such as dwcore.properties file values.
    • Add the required device drivers and extensions using the Workbench -> Administration -> Packages tab.
  • Similarly, once you have installed the deviceWISE Enterprise Gateway for 64-bit AIX product, using the deviceWISE Update Firmware option update to the deviceWISE Enterprise Gateway product (a 32-bit product) is not supported.

Obtaining the Enterprise Gateway for 64-bit AIX install file

Follow these steps to download the Enterprise Gateway for 64-bit AIX 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_AIX.
  5. Select AIX-64bit.
  6. Select Enterprise_Gateway.
  7. Select DWEnterprise_Install.AIX64.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 AIX install program:

  1. Telnet or log on to the target AIX computer as root.
  2. Copy the downloaded DWEnterprise_Install.AIX64.XXX.tar.gz file from the temporary download computer and location into the AIX computer's /tmp directory.
  3. At the command line type:
    /tmp> gunzip DWEnterprise_Install.AIX64.XXX.tar.gz (and press Enter).
    This creates a file with a .tar extension (DWEnterprise_Install.AIX.XXX.tar).
  4. Unpack the created .tar file:
    /tmp> tar -xvf DWEnterprise_Install.AIX64.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 AIX install program from the dwenterprise directory:
    /tmp/dwenterprise> ./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 Enterprise Gateway software should be running.

Starting, stopping, restarting or uninstalling the Enterprise Gateway software

The Enterprise Gateway for 64-bit AIX software runs as AIX services and will normally be started when AIX 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.

Connecting to the Enterprise Gateway using the Workbench

After the Enterprise Gateway for 64-bit AIX 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

Scanning for local or remote nodes