Multitech Conduit Assembly instructions

MultiTech Conduit Edge Microserver

Installation and Setup Guide

Version [1.0]

MultiTech Conduit Edge SDK Installation and Setup Guide

Introduction ................................................................................................................................ 1

About the DEVICE................................................................................................................... 2

Initial Setup ................................................................................................................................. 2

Connect the MultiConnect Conduit to a Local Computer ........................................................... 2

Install the ThingWorx Edge C-SDK .......................................................................................... 3

Configuration and Setup ............................................................................................................. 5

Configure the MultiConnect Device.......................................................................................... 5

Verify the Connection on the Platform ...................................................................................... 6

Troubleshooting.......................................................................................................................... 7

Compatibility ............................................................................................................................... 8

Document Revision History ......................................................................................................... 8

Introduction

MultiTech Conduit Edge SDK Installation and Setup Guide

The Edge MicroServer is a powerful component of the ThingWorx architecture. The Edge MicroServer

allows for the rapid deployment of connections between the ThingWorx platform and an associated

data reporting device, with minimal design requirements on the part of the user.

The Edge MicroServer provides an “always-on” connection to the platform, and it opens a local web

server that interacts with the REST API available on the platform.

This document provides installation and usage instructions for setting up the Edge MicroServer with the

MultiTech MultiConnect Conduit device.

About the DEVICE

The MultiConnect Conduit is a multi-port programmable gateway device manufactured by

MultiTechCorporation. It uses an open Linux environment to enable M2M connectivity using various

wireless interfaces.

The Edge MicroServer Linux distribution may be installed on the MultiConnect, and this guide will follow

the procedure for doing so.

Initial Setup

Setup of the DEVICE with an EMS will first require inserting an activated and valid SIM card in the

MultiConnect Device.

Please note that this guide was written for a computer running Microsoft

Windows.

Refer to the Troubleshooting section of this guide for help with frequently asked questions.

Connect the MultiConnect Conduit to a Local Computer

Follow MultiTech’s online setup guide to

complete the initial setup of your device,

including inserting a SIM card. Visit the

URL at right:

http://www.multitech.net/developer/wp-

content/uploads/2015/05/Conduit.pdf

Connect the MultiConnect to a computer

using a standard Ethernet cable. Connect

a power source to the MultiConnect

device.

INSERT PICTURES IN THIS COLUMN

MultiTech Conduit Edge SDK Installation and Setup Guide

Install the ThingWorx Edge MicroServer

Included in this Starter Kit are two packages you will need to install on the MultiConnect Device to get

started using the ThingWorx Edge MicroServer (EMS). Locate the following two files in this package:

•

thingworx-ems_5.2.0.15-r0.1_arm926ejste.ipk

•

thingworx-ems-lua_5.2.0.15-r0.1_arm926ejste.ipk

Assign your computer’s Ethernet Adapter

device to an IP address on the same IP

range as that of the MultiConnect device.

Note that the MultiConnect device’s

default IP address is 192.168.2.1

A recommended IP address for your

computer is 192.168.2.xx in this case,

where xx is any valid number in range,

such as 30.

Connect to the device via SSH using a

client such as PuTTY or Cygwin for

Windows.

Connect to the device at 192.168.2.1,

(default port 22), using the username

“root” and password “root”.

Note that these are the default credentials

for the device.

At this point, you should be logged into

the device as an administrative user (your

connection terminal should look like the

window in the previous screenshot).

MultiTech Conduit Edge SDK Installation and Setup Guide

Using a utility such as WinSCP, or a simple

scp command, copy the files to the

MultiConnect device under a directory

such as /opt/thingworx/.

Note that you may have to create the

thingworx directory or another suitable

location for the files.

Once these files are copied, run the following commands using the Open PacKaGe utility:

opkg install thingworx-ems_5.2.0.15-r0.3_arm926ejste.ipk

opkg install thingworx-ems-lua_5.2.0.15-r0.1_arm926ejste.ipk

Note:

If your device does not have the Open PacKaGe utility, contact the manufacturer for instructions on

installing it.

If your installation completes successfully, you should see a result similar to the following for each install:

Locate the “wsems” executable file. It may

stalled

under

the

bin

direc

If it is, copy it to the same top-level

directory as your EMS install. In our case,

this was the same directory as the location

of our two .ipk files:

MultiTech Conduit Edge SDK Installation and Setup Guide

Configuration and Setup

Configure the MultiConnect Device

On the MultiConnect, navigate to the

thingworx installation directory, and

then navigate to the /etc/ directory.

Your working directory should now

be something similar to:

x/et

Locate the “config.json” file.

You will need to modify the

connection parameters in this file so

that they match the connection

parameters of your ThingWorx

instance.

Note: For additional guidance and examples on setting a

configuration file, please refer to

http://support.ptc.com/cs/help/thingworx_hc/thingworx_6.0_hc/

and follow the guide section entitled “ThingWorx WebSocket-

based Edge MicroServer (WSEMS)”

The

config.json.complete

file is also

available in this install directory for

reference.

Edit the config.json so that it

resembles the file at right (text

included for your convenience), but

fill in your specific information.

{

"http_server": {

"host": "127.0.0.1",

"port": 8000

"ws_servers": [{

"host": "192.168.2.30",

"port": 80

}],

"appKey": "YOUR APPKEY HERE",

"resource": "/Thingworx/WS",

"logger": {

"level": "DEBUG"

"auto_bind": [{

"name": "MyGateway",

"gateway": true

}],

"ws_connection":{

"encryption": "none",

"verbose": true,

"msg_timeout": 1000

}

Save and close the config.json file.

Verify that the “wsems” executable is

located in the top level “thingworx”

folder. (/opt/thingworx)

MultiTech Conduit Edge SDK Installation and Setup Guide

Verify the Connection on the Platform

On your ThingWorx platform, navigate to the

“Monitoring” drop-down at the top-right of

the Composer, choose “subsystems”, and

then click “WS Communications” and

“Refresh Now”. You should see an active

websocket listed.

Verify that the “wsems” file is

executable by typing chmod 777

wsems.

Run the executable by typing the

following command:

./wsems

Verify that the executable is running

and in an idle state. You should see a

console similar to the screenshot at

right if it is running correctly.

Most important are the “Successfully

connected” and “Sending Ping”

responses.

Refer to the Troubleshooting section

for assistance with problems

encountered at this stage.

MultiTech Conduit Edge SDK Installation and Setup Guide

Troubleshooting

Problem

Solution(s)

I cannot connect to the MultiConnect device

from my local computer.

1. Ensure that your Ethernet Adapter is active in Windows, and that the IP

address is configured manually. Choose an IP address on the same

range as that of the MultiConnect Device.

2. Reset the MultiConnect Device by holding the RESET button on the

front for 5 seconds, while it is powered on, and then try again.

3. See the Quick Start Guide for more assistance.

The included EMS and lua packages will not

install with Open PacKaGe utility.

1. Verify that your Open PacKaGe utility is installed on the device.

2. Ensure that you are running the command from the same directory as

the location of the two .ipk files.

3. Try installing the files on a different directory on the device.

You can verify that the connected websocket

is the one configured from the MultiTech

device by checking the “Remote Things” and

then the “Unbound” tab at the top right. You

should see a device listed with the same

identifier as that listed in your config.json file.

At this point, your MultiConnect device is

connected to the ThingWorx Platform.

MultiTech Conduit Edge SDK Installation and Setup Guide

4. Check the version number (r0.3 versus r0.1) of the package. Correct

your install command to reference the version number of the package

that you are installing. Verify that the rest of the command was typed

correctly.

The wsems fails to connect to the ThingWorx

Platform.

1. Verify that the MultiConnect device has a valid internet connection. Type

“ping 8.8.8.8” or similar and look for a response.

2. Verify that the wsems is executable. Read the error messages it reports

to figure out if you have a problem with your installation.

3. Double-check the configuration parameters in config.json and verify that

they are correct. Look for syntax errors. Start from the example text

provided in this guide, under “Configure the MultiConnect Device”.

4. If all else fails, try first to connect to a ThingWorx Platform instance

located on the local machine connected to the device, rather than over

the internet.

I cannot locate the wsems file.

1. Included in this package is a wsems executable, which you can copy to

your device for installation purposes.

Compatibility

This guide has been tested for compatibility with the DEVICE and the following ThingWorx platform and

operating system:

ThingWorx Platform Version

ThingWorx 6.0.1

Windows 7, Service Pack 1

Document Revision History

Revision Date

Version

Description of Change

August 12, 2015

1.0

Initial Release

MultiTech Conduit Edge SDK Installation and Setup Guide

Other manuals for Conduit

Table of contents

Other Multitech Gateway manuals

Multitech

Multitech MultiVOIP MVP200 User manual

Multitech

Multitech MultiVOIP 400 MVP400 User manual

Multitech

Multitech MultiVOIP 100 (MVP110 User manual

Multitech

Multitech MultiConnect Conduit MTCDT Installation instructions

Multitech

Multitech MultiVOIP GSM SIP-to-Cellular Gateways... User manual

Multitech

Multitech MultiVOIP MVP110 User manual

Multitech

Multitech MultiVOIP 200 MVP200 User manual

Multitech

Multitech MultiVOIP MVP120 User manual

Multitech

Multitech MultiConnect MT100EOCG-G2 Instruction Manual

Multitech

Multitech MultiVOIP MVP100GK Gatekeeper User manual

Multitech

Multitech MultiVOIP MVP130-AV-FXS User manual

Multitech

Multitech MULTIVOIP MVP-210 Manual

Multitech

Multitech MTCAP-LAP3-915-001 User manual

Multitech

Multitech MultiConnect Conduit IP67 Base Station User manual

Multitech

Multitech VoIP User manual

Multitech

Multitech Conduit AP MTCAP-L4E1 User manual

Multitech

Multitech MultiVOIP 100 MVP120 User manual

Multitech

Multitech MultiConnect Conduit User manual

Multitech

Multitech MultiVOIP 400 MVP400 User manual

Multitech

Multitech Conduit AP User manual

Multitech

Multitech MultiVOIP GSM SIP-to-Cellular Gateways... User manual

Multitech

Multitech Conduit MTCDT-246L-US-EU-GB Installation instructions

Multitech

Multitech OneBox Smart Building User manual

Multitech

Multitech E1 User manual

Popular Gateway manuals by other brands

LST

LST M500RFE-AS Specification sheet

Kinnex

Kinnex Media Gateway quick start guide

2N Telekomunikace

2N Telekomunikace 2N StarGate user manual

Mitsubishi Heavy Industries

Mitsubishi Heavy Industries Superlink SC-WBGW256 Original instructions

ZyXEL Communications

ZyXEL Communications ZYWALL2 ET 2WE user guide

Telsey

Telsey CPVA 500 - SIP Technical manual

RTA

RTA 460A-NNA4 Product user guide

Shaw

Shaw Gateway HDPVR user manual

ABB

ABB VSN900 Commissioning manual

Commander

Commander Pulse owner's manual

2N Telekomunikace

2N Telekomunikace ATEUS EasyGate 501309E manual

NETGEAR

NETGEAR C6300BD installation guide

Amit

Amit CDW531AM user guide

HMS

HMS Netbiter EasyConnect EC150 user manual

Huawei

Huawei EchoLife HG620 user guide

AT&T

AT&T U-verse 3801 Replacement self-installation guide

Logic IO

Logic IO RTCU MX2 turbo Technical manual

Suttle

Suttle MediaMAX MXM-521 installation instructions