Installing Asset Gateway for Cypress CTM-200

This page describes how to download and install the deviceWISE Asset Gateway for Cypress CTM-200 product on a Cypress CTM-200 gateway.

The Cypress models supported include:

  • CTM-200

Prerequisites

The following is assumed:

  • You have the Cypress CTM-200 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 Cypress CTM-200 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 file from the Management Portal.
    If you need a Management Portal account, see Creating the deviceWISE Cloud account.
    If you received the installation file from your support representative, you can skip the download steps and proceed with Inserting a cellular SIM card.
  • You are familiar with basic Linux commands and have root access to the Cypress CTM-200 gateway.

Obtaining the Asset Gateway for Cypress CTM-200 installation file

Follow these steps to download the Asset Gateway for the Cypress CTM-200 installation 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 Cypress
  5. Select Asset_Gateway
  6. Select DWGateway_Install.Linux-ARM-Cypress-CTM-200.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.

Inserting a cellular SIM card

If the Cypress CTM-200 gateway will be configured for cellular connection, follow the instructions provided with the hardware to install your SIM card.

The SIM cards may be uniquely assigned to a specific gateway.

Make sure you have the appropriate APN for your SIM card and cellular provider.
For example: ils.gw12.vzwentp.

Using the Cypress CTM-200 Web Interface program

  1. After the installation file has been downloaded, to allow a direct Ethernet connection from the computer to the Cypress CTM-200, temporarily change the computer's:
    • IP address for the Ethernet adapter to 192.168.1.2
    • Network mask for the Ethernet adapter to 255.255.255.0.
  2. Connect the computer's Ethernet port to the Cypress CTM-200 LAN0 port using the Ethernet cable.
  3. From your computer, you should be able to ping the Cypress CTM-200 at IP address 192.168.1.1.
  4. Use a web browser to access the Cypress CTM-200 at its default IP address by entering 192.168.1.1 into the address field of your web browser.
    Note: You may be asked about a security certificate mismatch when accessing the Cypress CTM-200 Web Interface for the first time. To continue, accept  the mismatch and proceed.
  5. When prompted, enter the credentials for the Web Interface:
    User Name = admin
    Password = Chameleon
  6. The Cypress CTM-200 Web Interface is used to perform several Cypress CTM-200 configuration tasks, including:
    • Cypress CTM-200 firmware update
    • IP address, subnet mask, default gateway and DNS settings
    • Mobile WAN (cellular) configuration settings
    • Wifi, DHCP and other features depending on your network environment.

Updating the Cypress CTM-200 firmware

The firmware of the Cypress CTM-200 system must be at level 2.5.0.5389-113 or higher. For more information or access to the firmware update file, contact the support group at Cypress.
For example, the file name for firmware level 2.5.0.5389-113 should be ctm200-v5389-fs.tar.

The firmware level is displayed in the Cypress CTM-200 Web Interface -> Dashboard -> Firmware Version parameter.

If you need to update the firmware, that is accomplished using the Cypress CTM-200 Web Interface -> System -> Firmware Upgrade option.
Browse for the location of the firmware update file and then select Install Firmware.

Running the install program

After configuring the Cypress CTM-200 using the Web Interface, continue with the following steps to install the deviceWISE Asset Gateway for Cypress CTM-200 product.

  1. Transfer the downloaded installation file from the computer to the /dev/shm directory of the gateway, using any secure file transfer (SFTP) tool available, such as WinSCP.
    The default IP address is 192.168.1.1, the default admin password is Chameleon.
  2. Open a command prompt (shell) on the Cypress CTM-200 gateway with a SSH client program, such as available in PuTTY.
    The default IP address is 192.168.1.1, the default admin password is Chameleon.

  3. Log on and then do the following:

    cd /dev/shm
gunzip DWGateway_Install.Linux-ARM-Cypress-CTM-200.XXX.tar.gz
tar -xvf DWGateway_Install.Linux-ARM-Cypress-CTM-200.XXX.tar
cd dwgateway_cypress_ctm200
./dwgateway_cypress_ctm200.install
Do you wish to continue? Y
A license agreement is displayed, scroll through the agreement
Do you agree with the terms of this license? Y

  4. The install file will display information as it executes the installation and will display

    ...
info: starting deviceWISE Asset Gateway...
Installation is complete.

The deviceWISE Asset Gateway for Cypress CTM-200 software has been installed in the /opt/dw directory and is using the default IP address of 192.168.1.1.

Cypress CTM-200 network watchdog process

Network watchdog process

The Cypress CTM-200 operating system has a network watchdog process that can be configured at the operating system command line level.

This network watchdog process may interfere with deviceWISE network communication over the LAN Ethernet connection. For more information, contact the support group at Cypress.

A series of commands that can be issued at the operating system command line level to disable the network watchdog processing is listed below.

For the netwd command, set the 5th parameter to 0 (m = max time with no network connection before power cycling). For example:

cmd netwd 0 1 8.8.8.8 10 0

cmd save

cmd pwr mode 2

Uninstalling the Asset Gateway software

To uninstall or remove the product:

  • You may want to do a node Back Up using the Workbench 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 configuration settings, 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.