Installing Asset Gateway for MultiTech OCG/Conduit

This page describes how to download and install the deviceWISE Asset Gateway for MultiTech product on a MultiTech gateway.

The MultiTech MultiConnect Conduit models supported include:

MTCDT-H5

The MultiTech OCG-D models supported include:

MTCDP-H5

Discontinued gateways:

MTCDP-H4 (Discontinued and no longer supported beginning with the 19.1.7 release)
MTCDP-EV2 (Discontinued and no longer supported beginning with the 19.1.7 release)

The installation files for the OCG models and the Conduit models are different.

Prerequisites

The following is assumed:

You have the MultiTech gateway.
You have an Ethernet cable.
You have a computer, such as a laptop, that can be used to log on to the Management Portal and can have its IP address changed to allow a direct Ethernet cable connection to the MultiTech gateway at its factory default IP address.
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 MultiTech gateway.

Conduit firmware level

A Multitech firmware v3.3.6 fix is available for a network communication problem seen during deviceWISE testing.

The MultiTech information for updating the Conduit firmware is available at: http://www.multitech.net/developer/software/mlinux/using-mlinux/flashing-mlinux-firmware-for-conduit/
The MultiTech Conduit firmware files are available at: http://www.multitech.net/mlinux/images/3.3.6/mtcdt/

Obtaining the Asset Gateway for MultiTech install files

Follow these steps to download the Asset Gateway for the MultiTech install files:

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 MultiTech
- If you have a MultiTech OCG-D model
  - Select OCG
  - Select Asset_Gateway
  - Select DWGateway_Install.Linux-ARM-MultiTech.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 the computer.
  - Select DWGateway_Install.Linux-ARM-MultiTech.XXX.sh (where XXX is the version of the Asset Gateway software you want to download) and download the file to the same temporary location.
- If you have a MultiConnect Conduit model
  - Select Conduit
  - Select Asset_Gateway
  - Select DWGateway_Install.Linux-ARM-MultiTech-Conduit.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 the computer.
  - Select DWGateway_Install.Linux-ARM-MultiTech-Conduit.XXX.sh (where XXX is the version of the Asset Gateway software you want to download) and download the file to the same temporary location.

Inserting a cellular SIM card

If the MultiTech gateway will be configured for cellular connection, follow the instructions provided with the hardware to install your SIM card.
The SIM card gets installed behind the panel with the SIM label. The SIM card metal connectors are positioned down, with the notch to the lower right as it is inserted into the MultiTech gateway.

The EV2 model uses a CDMA cellular modem and does not require a SIM card.

Running the install program

After the files have been downloaded, to allow a direct Ethernet connection from the computer to the MultiTech gateway, temporarily change the computer's:
- IP address for the Ethernet adapter to 192.168.2.2
- Network mask for the Ethernet adapter to 255.255.255.0.
Connect the computer's Ethernet port to the MultiTech gateway using the Ethernet cable.
From the computer, you should be able to ping the MultiTech gateway at IP address 192.168.2.1.
Transfer the downloaded files from the computer to the /tmp directory of the gateway, using any secure file transfer (SFTP) tool available, such as WinSCP.
The default IP address is 192.168.2.1, the default root password is root.
Open a command prompt (shell) on the MultiTech gateway with a SSH client program, such as available in PuTTY.
The default IP address is 192.168.2.1, the default root password is root.
Log on as root, and then do the following:

If you have a MultiTech OCG-D model

cd /tmp
chmod +x DWGateway_Install.Linux-ARM-MultiTech.XXX.sh  (where XXX is the version of the file you downloaded)
./DWGateway_Install.Linux-ARM-MultiTech.XXX.sh

If you have a MultiConnect Conduit model

cd /tmp
chmod +x DWGateway_Install.Linux-ARM-MultiTech-Conduit.XXX.sh  (where XXX is the version of the file you downloaded)
./DWGateway_Install.Linux-ARM-MultiTech-Conduit.XXX.sh

The install .sh file will display information as it executes the installation and will display
```
...
Installation is complete.
DW: cleaning up installation files
```

The deviceWISE Asset Gateway software has been installed in the /opt/dw directory and is using the default IP address of 192.168.2.1.

Uninstalling the Asset Gateway software

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.

Next steps

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, cellular connection configuration, and to connect the Asset Gateway to the M2M Service.

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.