Multitech Conduit Instructions de montage

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

Autres manuels pour Conduit

Table des matières

Autres manuels Multitech Porte

Multitech

Multitech CallFinder CF100FX2 Manuel utilisateur

Multitech

Multitech MultiVOIP 400 MVP400 Manuel utilisateur

Multitech

Multitech Conduit AP Manuel utilisateur

Multitech

Multitech MULTIVOIP MVP-130FXS Manuel utilisateur

Multitech

Multitech MultiVOIP MVPFX2-2 Manuel utilisateur

Multitech

Multitech MultiVOIP MVP200 Manuel utilisateur

Multitech

Multitech RouteFinder RF550VPN Manuel utilisateur

Multitech

Multitech MULTIVOIP MVP-210 Manuel utilisateur

Multitech

Multitech MULTIVOIP MVP-410ST Manuel utilisateur

Multitech

Multitech MultiVOIP 800 MVP800 Manuel utilisateur

Multitech

Multitech E1 Manuel utilisateur

Multitech

Multitech MultiConnect Conduit MTCDT-LAP3 Instructions d'installation

Multitech

Multitech MultiVOIP 200 MVP200 Manuel utilisateur

Multitech

Multitech MultiVOIP MVP100GK Gatekeeper Manuel utilisateur

Multitech

Multitech MULTIVOIP MVP-210 Manuel utilisateur

Multitech

Multitech 410 Manuel utilisateur

Multitech

Multitech MultiVOIP MVPGK1 Gatekeepers Manuel utilisateur

Multitech

Multitech MultiVOIP MVP210-SS Manuel utilisateur

Multitech

Multitech MultiConnect Conduit Manuel utilisateur

Multitech

Multitech MultiVOIP MVP2400 Manuel utilisateur

Multitech

Multitech MultiVOIP MVP120 Manuel utilisateur

Multitech

Multitech Conduit 300 Series Instructions d'installation

Multitech

Multitech CallFinder CF100FX2-G Manuel utilisateur

Multitech

Multitech MultiVOIP MVP210-FX Manuel utilisateur

Manuels Porte populaires d'autres marques

LST

LST M500RFE-AS Manuel utilisateur

Kinnex

Kinnex Media Gateway Manuel utilisateur

2N Telekomunikace

2N Telekomunikace 2N StarGate Manuel utilisateur

Mitsubishi Heavy Industries

Mitsubishi Heavy Industries Superlink SC-WBGW256 Manuel utilisateur

ZyXEL Communications

ZyXEL Communications ZYWALL2 ET 2WE Manuel utilisateur

Telsey

Telsey CPVA 500 - SIP Manuel utilisateur

RTA

RTA 460A-NNA4 Fiche technique

Shaw

Shaw Gateway HDPVR Manuel utilisateur

ABB

ABB VSN900 Guide de démarrage rapide

Commander

Commander Pulse Manuel utilisateur

2N Telekomunikace

2N Telekomunikace ATEUS EasyGate 501309E Manuel utilisateur

NETGEAR

NETGEAR C6300BD Manuel utilisateur

Amit

Amit CDW531AM Manuel utilisateur

HMS

HMS Netbiter EasyConnect EC150 Manuel utilisateur

Huawei

Huawei EchoLife HG620 Manuel utilisateur

AT&T

AT&T U-verse 3801 Manuel d'utilisation et d'entretien

Logic IO

Logic IO RTCU MX2 turbo Manuel utilisateur

Suttle

Suttle MediaMAX MXM-521 Manuel utilisateur