Dell Wyse 3000 Assembly instructions

Dell Wyse 3000 Edge MicroServer Installation and
Setup Guide
July 2015

Table of Contents
1. Introduction .......................................................................................... 1-1
About the Dell WYSE 3000............................................................................................... 1-1
2. Installation and Setup .......................................................................... 2-1
Login to the Dell Wyse 3000 device ................................................................................ 2-1
Set Up a Websocket Connection ..................................................................................... 2-2
3. Establishing and Testing a Connection ............................................. 3-8
Connect to the Dell WYSE 3000 via Serial Port .............................................................. 3-8
Connect the Dell WYSE 3000 to the ThingWorx Platform .............................................. 3-9
4. Troubleshooting .....................................................................4-15

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 1-1
1. Introduction
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 Dell WYSE 3000.
About the Dell WYSE 3000
The Dell WYSE3000 is a multi-port x86 Intel-based thin client device, running Windows Embedded
Standard 7. It is manufactured by Dell Inc., and is intended for use as a rapid-connecting specialized
and limited-role device.
Specifications of the device as tested for this guide include an Intel® Celeron® CPU N2807
@1.57Ghz, 4.00GB of RAM, and 16GB of flash memory.
The Edge MicroServer Win32 distribution may be installed on the Dell WYSE 3000, and this guide
will follow the procedure for doing so. This guide will also follow the features involved with
simulating a connection and pushing and pulling data from the Dell WYSE 3000 to the ThingWorx
as a remotething.

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 2-1
2. Installation and Setup
Setup of the Dell WYSE 3000 with an EMS will first require connecting to the Dell Wyse 3000 from a
computer via Ethernet cable and a local DHCP Server. 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.
Login to the Dell Wyse 3000 device
1.
Connect a monitor, mouse, and keyboard
to the device, and power it on.
2.
After the device automatically logs in,
hold down the “shift” key and click Start
> Log off. Continue holding the shift key
until the system asks you to choose an
account to login to.
3.
Choose “Adminstrator”, and log in. The
default password is “DellCCCvdi”.
4.
On the Windows Embedded 7 Desktop,
open the “Networking and Sharing
Center”, and then go to Windows
Firewall.
Disable all Firewalls.

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 2-2
Set Up a Websocket Connection
1.
This section begins by setting up Windows
DHCP server on the ThingWorx host
computer. If you already have this client
set up on your host computer, then skip
ahead to opening up a websocket
connection.
Begin by downloading the DHCP server
installer for Windows from:
http://www.dhcpserver.de/cms/
2.
In Windows, before installing the DHCP
server, open “Network and Sharing
Center”, and then click the link on the left
for “Change Adapter Settings”

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 2-3
3.
Right-Click on “Local Area Connection”,
and choose “Properties”.
4.
Select “Internet Protocol Version 4”, and
then click “Properties”. Click the button
for “Use the following IP address”, and set
a private IP address that starts with
“192.168…”. Subnet Mask may be left as
255.255.255.0
5.
Connect the Dell Wyse 3000 device toyour
computer with an Ethernet cable. Note:
From here on out, you may wish to disable
any connection to another network to

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 2-4
avoid causing IP address conflicts with
other devices on your local network.
6.
Extract the DHCP Serverpackage
downloaded earlier, and run the
“dhcpwiz” executable. Follow the steps in
the wizard to get to the “Network
Interface Cards” screen.
7.
Select “Local Area Connection”, and
confirm that its DHCP setting is disabled
by default.
8.
On the next screen, check “HTTP (Web
Server)” and leave the others unchecked.
Click “Next”.

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 2-5
9.
Set the IP-Pool to a reasonable range
whichcontains yourlocalmachine’sIP
address (chosen earlier). Click Next.
10.
Check “Overwrite Existing File”, then click
“Write INI file”. Click “Next”, then “Finish”.
11.
Open the “dhcpsrv” program as an
Administrator.
12.
Check “Firewall Enabled”, click
“Configure”. Install the service if you have
not yet done so. Finally, click the “Start”
button to begin running the DHCP Server.
Note: If you have an instance of Apache Tomcat or any
other local server running, you should stop it before
clicking “Start” on the DHCP Server.
13.
Open up a browser, and type in
“localhost/dhcpstatus.xml” into the
address bar. The Dell Wyse 3000 should
be detectable and listed as a client, with an
IP address assigned.

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 2-6
14.
Confirm the Dell device’s IP address by
typing “ipconfig” in any command prompt
terminal (open command.exe).
Tip: You can confirm the connection to your host
computer is established by typing “ping 192.168.137.1”
(or similar ip address) from a command prompt window
on the Dell device.
15.
Start Tomcat on the host computer, and
ensure the ThingWorx platform is
accessible.
16.
Download the ThingWorx Edge
MicroserverforWindowspackagefrom
the PTC Support Downloads site.
Get the latest release of the “Win32”
package.
17.
Transfer the MicroServer zip file to the
Dell WYSE.
Tip: You can create a shared folder on the Dell device and
transfer the file over a LAN, or you can move it using a
flash drive.
18.
Open the “config.json” file in
“ \ Mi c ro S erv er \ etc ” , or open ei the r
config.json.complete or
config.json.minimal and save it as
config.json.
Note: Open the config.json.complete, or
config.json.minimal files, and work off of one them, and
Save As “config.json” when finished. It’s recommended
you start with config.json.minimal.
19.
Set the IP address for “ws_servers” to be
“192.168.137.1” and the port to be “80”
(Unless these numbers are different for
your local host ThingWorx computer;
replace them with your actual values)
20.
Set “appKey” to be the value of your
application key, generated in ThingWorx
under “Application Keys”.

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 2-7
21.
Set “encryption” under “ws_connection” to
be “none”.
See the example at right of config.json:
Save and close the config.json file when
finished editing.
22.
Run the “wsems” application under the
MicroServer root directory, by typing
“./wsems”
23.
In the browser on your host computer,
navigate to the ThingWorx platform, and
click “Monitoring”. Here, click “Remote
Things”, and then click on the “Unbound”
tab.
Here, you should see the “MyGateway”
entity here.

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 3-8
3. Establishing and Testing a Connection
Connect to the Dell WYSE 3000 via Serial Port
1.
Connect the host computer to the Dell
device’s serial port using an
appropriateserial-serialorserial-USB
cable.
2.
Open a command prompt window on
the computer, and type “powershell”.
powershell
3.
Identify your computer’s serial port
names by typing the following (at
right):
[System.IO.Ports.SerialPort]::getportnames()
4.
In this guide, the screenshot at right
shows“COM3”asanavailableport.
5.
Type the following two commands to
open the port, replacing “COM3” with
your computer’s port name as
appropriate:
$port= new-Object System.IO.Ports.SerialPort
COM3, 9600, None, 8, one
$port.open()
6.
On the Dell device, repeat the
procedure for opening a port, but
ensure that the correct name is used by
utilizing the “getportnames() command
again. See right for the command
sequence:
powershell
[System.IO.Ports.SerialPort]::getportnames()
$port= new-Object System.IO.Ports.SerialPort
COM3, 9600, None, 8, one
$port.open()
7.
To verify that a connection has been
established, on either the computer or
the Dell device, type the following:
$port.WriteLine(“Hello World”)

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 3-9
8.
On the other computer, receive the
message by typing:
$port.ReadLine()
Connect the Dell WYSE 3000 to the ThingWorx Platform
1.
From the Starter Kit package, place the
following included files in the following
MicroServer directories on the Dell
WYSE 3000:
Place “config.lua” in the Dell’s \etc\
folder.
Place “testTemplate.lua” in the
\etc\custom\templates\ directory.
Place “testSample.lua” in the
\etc\custom\scripts\ directory

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 3-10
2.
Open“testSample.lua”,andchangethe
port numbers listed to those of your
Dell Device’s serial port number:
Save the file when finished.
3.
Run the “wsems” executable under
\ Mi c roS erv er \ , and th en run
“luaScriptResource”inthesame
directory.

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 3-11
The command prompt windows at right
are similar to what you should see after
running “wsems” and
“luaScriptResource”

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 3-12
4.
On the ThingWorx platform on the host
computer, navigate to the ThingWorx
monitor and go to Remote Things again.
Here, you should see two unbound
things listed:
5.
In ThingWorx, create a new Thing
entity named “testThing”, and select
“RemoteThing” as the implementing
Thing Template.
6.
On the General Information page for
thisnewThing,click“Browse”nextto
its identifier field, and select “testit”
from the availablechoices.
Save the testThing entity when
finished.

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 3-13
7.
Click “Properties”, and then select
“Edit” if necessary to re-enter edit
mode.
Next, click “Add My Property”, and
create a new STRING property named
“testValue”.
Click “Done”.
8.
On the Properties page, click “Manage
Bindings”, and then click the “Remote”
tab at the top left of the new window.
Note: If you can’t see the remote things here, verify that the
“wsems” and “luaScriptResource” are both running on the
Dell device, and that the connection is established properly.
9.
Click and drag to add “testScriptDemo”
remote property to the “testValue”
property, and then click Done.

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 3-14
10.
Click “Edit” on the testValue property,
and under “Cache Options” at the right,
change the value to “Fetched from
Remote Every Read”.
11.
Click “Done”, and then “Save”.
12.
On the ThingWorx host computer,
ensure that a serial port connection is
established (see earlier section on
“Connect to the Dell WYSE 3000 via
Serial Port”), open a command prompt
window, and type the following (see
right):
$port.WriteLine(“Hello World”)
13.
On the ThingWorx platform, on the
property page for the “testThing”
Thing, refresh the value for “testValue”.
Its value should have changed to “Hello
World”.
Note: The host computer is acting as both an originating
data injector, for which it sends data to the Dell WYSE via
Serial Port, and as a host ThingWorx server, in which it
receives a value response from the Dell device via websocket
connection.
14.
On the command prompt window on
your host Windows computer, type the
following (on right):
$port.ReadLine()
15.
You should receive a response similar
to the screenshot at right. This
confirms the device’s connectivity.

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 4-15
4. Troubleshooting
Problem
Solution(s)
1.
Can’t assign an IP address to the Dell WYSE
3000 from a connected host computer.
1. On the Dell device, navigate to “Network and Sharing Center”, and click
“Change adapter Settings”. Here, right click on your Local Area
Connection, click “Properties”, and then select Internet Protocol Version
4. Choose “Obtain an IP address automatically.
2. Repeat the above on the host computer, but ensure that instead the
option for obtaining an IP address is a manual IP address within the
domain of the local network you’re establishing with DHCP server, such
as 192.168.137.1.
3. Verify that a connection is established via LAN cable and that both
computers have appropriate drivers installed.
2.
Cannot ping the Dell device from the host
computer / Cannot open a command line on the
Dell Device
1. Ensure the Dell Device’s Windows Firewall is turned off.
2. Verify you are logged into the device as the Adminstrator.
3.
Can’t set up a WebSocket connection by
running the “wsems” application.
1. Try to type “wget YourLaptopIPAddress” to see if you can obtain data
form the server. If not, make sure all Firewalls are disabled on both
computers.
2. Try changing the system clock on the Dell Device to make it match that
of the host computer’s.
4.
Using the Windows Powershell
“[System.IO.Ports.SerialPort]::getportnames()”
command, I am unable to see any available
port names.
1. Verify that the computer is connected to the Dell Device via serial cable.
2. You may need to manually install or re-install Device Drivers for the
Windows Serial Port.
a. Open Device Manager from Control Panel in Windows.
b. Click on “Ports (COM & LPT)”, and click “Action > Add Hardware /
Add Legacy Hardware”
c. Follow the steps in the wizard to manually add serial port (COM)
drivers.
1. Restart your computer and attempt to get port names again.
5.
Receive an error when running
“luaScriptResource. Error says “rserial is “nil””
2. Make sure you have modified the port number in “testSample.lua” in
both places in this file so that it matches your Dell device’s port number.
This may or may not be the same number as your connected host
computer’s.

ThingWorx EMS Setup Guide
for the Dell WYSE 3000
Page 4-16
6.
Can’t update the value of “testScriptDemo” (or
testValue) on the ThingWorx platform after
sending $port.WriteLine from the host
computer.
1. Try manually opening the serial port: a) Close “wsems” and
“luaScriptResource”. b) Open a command line window and open the
serial port, following the steps earlier in this guide to connect via serial
port. c) restart “wsems” and “luaScriptResource”. If the
luaScriptResource runs, then type $port.Close() on the command line
window on the Dell Device to avoid two programs “fighting” to use the
port.
7.
Cannot locate updated files on the Dell Device
after restarting.
1. The device may automatically wipe all new installed software and added
files or folders each time you restart. Backup the files before shutting
down the machine.
8.
Error while attempting to open a websocket
connection.
1. Confirm that the Dell device has access to the internet.
2. Confirm the accuracy of the IP address and port numbers in the
settings.json file.
3. Confirm the appKey authenticity in the settings.json file.
4. Confirm that the ThingWorx platform at the IP address specified in the
settings.json file is up and running.
This guide has been tested for compatibility with the Dell WYSE 3000 and the following ThingWorx
platform and operating system:
ThingWorx Platform Version
OS
ThingWorx 6.0.1
Windows 7, Service Pack 1