Installing Asset Gateway for GateTel EZMoto

This page describes how to download and install the deviceWISE Asset Gateway for GateTel EZMoto product on a GateTel EZMoto system.

The GateTel EZMoto gateways supported include:

  • EzMoto-DG Raspbian

Prerequisites

The following is assumed:

  • You have the GateTel EZMoto system
  • You have an Ethernet cable
  • You have a serial cable
  • You have a Dynamic Host Configuration Protocol (DHCP) server available to assign an IP address to the GateTel EZMoto
  • 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 GateTel EZMoto at its dynamically assigned IP address. The IP address is initially assigned by the DHCP server.
  • 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 GateTel EZMoto system.

Obtaining the Asset Gateway for GateTel EZMoto install files

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

  1. Log on to the Management Portal, and 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 EZMoto.
  5. Select Asset_Gateway.
  6. Select DWGateway_Install.GateTel.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.
  7. Select DWGateway_Install.GateTel.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 GateTel EZMoto will be configured for cellular connection, follow the instructions provided with the hardware to install your SIM card.
The SIM card gets installed in SIM slot A under the left side holder, secured with two 2 mm Allen screws. The left side is when viewing the front panel with the Ethernet connector and the USB connector.
The SIM card metal connectors are positioned up, with the notch to the upper right as it is inserted into the GateTel EZMoto. SIM slot A is the one closest to the front panel.

Running the install program

  1. After the files have been downloaded to your computer, you may have to temporarily change the computer's Ethernet adapter's IP address to allow a direct Ethernet connection from the computer to the GateTel EZMoto. The GateTel EZMoto's default configuration is to be assigned an IP address by a DHCP server.
  2. If your network administrator has the ability to determine the IP address assigned to the GateTel EZMoto, you can proceed with its assigned IP address.
  3. If your environment does not the ability to otherwise determine the assigned IP address, you can do so by connecting your computer to the GateTel EZMoto using a serial cable.
    For example:
    1. Use a serial cable with a 9 pin serial connector on one end and a USB connector on the other end.
    2. Connect the 9 pin serial connector to the GateTel EZMoto and connect the USB connector to your computer. You may have to install a device driver for the USB to serial cable connection to function.
    3. Open a command prompt (shell) over the serial connection to the GateTel EZMoto.
    4. Your computer's settings and the command prompt tool may vary. One example is to use Putty, Connection Type = Serial, Serial line = COM3, Speed = 115200.
    5. Logon using user = pi and password = pi
    6. Type ifconfig to display the Ethernet interface information
    7. The line in the eth0 section similar to:
      inet addr:172.27.9.83  Bcast:172.27.15.255  Mask:255.255.248.0, indicates that the assigned IP address is 172.27.9.83.
  4. Connect the computer's Ethernet port to the GateTel EZMoto using the Ethernet cable.
  5. From the computer, you should be able to ping the GateTel EZMoto at its assigned IP address.
  6. Transfer the downloaded files from the computer to the /tmp directory of the GateTel EZMoto, using any file transfer tool available, such as WinSCP.
    Using the assigned IP address, the port to use is 22, the user is pi and the password is pi.

  7. Using the command prompt (shell) connection over the serial cable, or a new connection over Ethernet, do the following:

    cd /tmp
chmod +x DWGateway_Install.GateTel.XXX.sh  (where XXX is the version of the file you downloaded)
sudo ./DWGateway_Install.GateTel.XXX.sh

  8. The install .sh file will display information as it executes the installation and will display:

    ...
A system reboot is required to complete the installation

The deviceWISE Asset Gateway software has been installed in the /opt/dw directory.

  • Either issue the sudo reboot command to restart the system, or power off and then power on the gateway.
  • When the gateway has restarted, you will be able to connect to it with the Workbench Scan function using the gateway's assigned IP address.

Re-installing

Re-installing the Asset Gateway for Gatetel EZMoto will revert the network configuration information to its default values. If the installation script is executed on a gateway, the network configuration items for the Ethernet adapters, DNS, etc. will need to be reconfigured.

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 (for example: /opt sudo rm -rf dw).

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.