Technote

Instructions for deploying Wyse

Thin OS (WTOS) with WDM 4.7.2

A Technote by
Systems Engineering
May 2009
Wyse Product Support

Summary

This is a simple guide outlining the setting up of WDM 4.7.2 to deploy Wyse Thin OS via
Default Device Configuration (DDC). In this example we will deploy two configurations
for V10L terminals with 128MB of flash.

Audience

Customer

Affected Products

Wyse Thin OS > 6.2.X

Wyse Device Manager 4.7.2

Technote WTOS DDC WDM 4.7.2 Page 2 of 17

Wyse Product Support
Step by Step Setup:

1. Set up the network DHCP server to deploy option tags 186 (and 190, 192 if
different port than standard or HTTPS is used) to the terminal device. Note that
no other Wyse specific option tags will be needed (such as 161 or 162). See
apendix 1 for an example of the set up of this option tag on a Windows server.

2. In the WDM console go to Configuration Manager and click Preferences >

Wyse Thin OS and tick the “Enable Return FTP/INI At Checkin”.

Technote WTOS DDC WDM 4.7.2 Page 3 of 17

Wyse Product Support
3. While still in Preferences from under the Device Manager – DDC tab tick the
“Enable Default Device Configuration” box and select “Upon Checkin”.

Technote WTOS DDC WDM 4.7.2 Page 4 of 17

Wyse Product Support
4. While still in Preferences from under the Scheduling tab make sure that the
“Imaging Option” is set to “Wisard”.

5. Set up the two packages to be deployed (see apendix 2 for example scripts). In
our example edit the .RSP file to reflect the amount of available flash on the
terminal. This is important as WDM uses flash size to deploy images, so check in
the device console to see what size is on your device and set the IMAGESIZE=
parameter to suit. Generally these are the settings:
1200LE - IMAGESIZE=0
1125SE – IMAGESIZE=16
S10 - IMAGESIZE=16
V10L – IMAGESIZE=128
All WTOS configuration files are located in the Regroot of the WDM Package
with the full path (example for package sales.rsp: sales/wnos )

Technote WTOS DDC WDM 4.7.2 Page 5 of 17

Wyse Product Support
6. After the WDM packages are built, import them into the Package Manager by
right clicking and selecting new. Select option one (register a package from a
Script file) and browse to the first package. This will need to be done for all
packages.

7. Set up a view for WDM. DDC will apply the configurations based on a view so
this is an important step. In our example we will be targeting devices in the two
groups “sales” and “support”. Go to Configuration Manager – Groups right click
and select new > Group and create a new group “businessgroup”.

Technote WTOS DDC WDM 4.7.2 Page 6 of 17

Wyse Product Support
Go to Configuration Manager – Views right click and select new > View and in
View Name call it ‘Businessgroup’, click in View Level 1 and select
“businessgroup” from the drop down box.

Technote WTOS DDC WDM 4.7.2 Page 7 of 17

Wyse Product Support
This is a simple example and many nested and custom groups can be created. In
Device-Manager switch to the new created view Businessgroup. Make sure that
you pre-create the groups “Sales” and “Support” in this new view in Device
Manager before you continue.

Technote WTOS DDC WDM 4.7.2 Page 8 of 17

Wyse Product Support
8. We are now ready to set up DDC. In Configuration Manager right click the
Default Device Configuration node and select new. Fill out the options as
shown and select for each group the WDM package from the OS image drop
down box. We will be applying the package Support to group Support and the
package Sales to group Sales.

9. In Device Manger select the view “Businessgroup” and move your V10L into the
group Sales. Finally reboot the terminal and the image/configuration should
deploy.

Technote WTOS DDC WDM 4.7.2 Page 9 of 17

Wyse Product Support
Appendices 1

Configure the DHCP Server

Configure the following option tag values on your DHCP server:

Option tag 186 - IP address of your WDM server (for example, 192.168.1.10). The
value should be in 4-byte IP address format.

Option tag 190 - Secure port number to which WDM server listens (for example,
port 443). The value should be in word format (value = 0x01bb) or 2-byte array format
(value = 0x01 0xbb).

Option tag 192 - Non-secure port number to which WDM server listens (for example,
80). The value should be in either byte format (value = 0x50), word format (value =
0x0050), or 2-byte array format (value= 0x00 0x50).

Note: Some old agents use option tag 187 for the WDM non-secure port number.
The value of this option tag, when embedded within vendor class-specific
information (option 43), was interpreted the same way as option tag 192. If
option tag 192 is not supplied, the new Boot Agent will accept option tag 187
for legacy support only. It is recommended that the DHCP server use option
tag 192.
The WDM server and the DHCP server should not be running on the same
machine.
Please consult your DHCP server manual for DHCP option value
configuration details.

Technote WTOS DDC WDM 4.7.2 Page 10 of 17

Wyse Product Support
Follow these steps to configure the WDM server IP address and port option values
on a Windows DHCP server:

1. Open the DHCP management wizard, select the DHCP server to be configured, right
click the server name, and select Set Predefined Options.

Technote WTOS DDC WDM 4.7.2 Page 11 of 17

Wyse Product Support
2. The Select Predefined Options and Values window appears.

3. On the Predefined Options and Values screen, click the Add button. The Option Type
window appears.

4. In the Option Type window, enter the required information:

• Name - WDM Server
• Code - 186
• Data Type - IP Address
• Description (optional) - Enter desired information, or nothing

Technote WTOS DDC WDM 4.7.2 Page 12 of 17

Wyse Product Support
5. Click OK.

6. Repeat Steps 3 and 4 for the WDM Server port, with these changes:
• Name - WDM Server Secure Port
• Code - 190
• Data Type – Word

7. Repeat Steps 3 and 4 for the WDM Server port, with these changes:
• Name - WDM Server Port
• Code - 192
• Data Type - Byte or Word

8. Click OK.

Technote WTOS DDC WDM 4.7.2 Page 13 of 17

Wyse Product Support
9. From the DHCP management wizard, select Scope Options (from the target DHCP
Server Scope, as shown in Figure 74), right click, and select Configure Options.

10.In the list of Available Options, check option number 186, and enter the IP address of
the WDM server.
11.In the list of Available Options, check option number 190, and enter the port number
at
which your WDM server listens for secure communication.
12.In the list of Available Options, check option number 192, and enter the port number
at
which your WDM server listens.

13.Click OK.

Technote WTOS DDC WDM 4.7.2 Page 14 of 17

Wyse Product Support

14.Confirm that options 186, 190 and 192 are listed with proper values under the target
DHCP server and scope.

Technote WTOS DDC WDM 4.7.2 Page 15 of 17

Wyse Product Support

Appendices 2

Sales.rsp

[Version]
Number=Sales
Description=DDC WTOS-Configuration for Sales Group
OS=BL
Category=Images
USE_PXE=NO
ImageSize=128

[Script]

Support.rsp

[Version]
Number=Support
Description=DDC WTOS-Configuration for Support Group
OS=BL
Category=Images
USE_PXE=NO
ImageSize=128

[Script]

Technote WTOS DDC WDM 4.7.2 Page 16 of 17

Wyse Product Support

Limitation of Liability
IN NO EVENT SHALL MANUFACTURER, MANUFACTURER'S SUPPLIERS, ANY THIRD-
PARTY PRODUCER, OR ANY OTHER PARTY THAT HAS BEEN INVOLVED IN THE
CREATION, PRODUCTION, OR DELIVERY OF THE DOCUMENT BE LIABLE FOR ANY
DIRECT, CONSEQUENTIAL, INCIDENTAL, INDIRECT, OR SPECIAL DAMAGES,
INCLUDING WITHOUT LIMITATION LOST PROFITS OR LOSSES RESULTING FROM
BUSINESS INTERRUPTION OR LOSS OF DATA, REGARDLESS OF THE FORM OF
ACTION OR LEGAL THEORY UNDER WHICH THE LIABILITY MAY BE ASSERTED, EVEN
IF ADVISED OF THE POSSIBILITY OR LIKELIHOOD OF SUCH DAMAGES.

THIS DOCUMENT IS PROVIDED "AS IS" WITH NO WARRANTIES WHATSOEVER,

INCLUDING ANY WARRANTY OF MERCHANTABILITY, FITNESS FOR ANY PARTICULAR
PURPOSE, OR ANY WARRANTY OTHERWISE ARISING OUT OF ANY PROPOSAL,
SPECIFICATION OR SAMPLE. MANUFACTURER DOES NOT WARRANT THAT THE
INFORMATION CONTAINED IN THE DOCUMENT OR ANY SOFTWARE REFERRED
THEREIN WILL MEET YOUR REQUIREMENTS OR THAT THE OPERATION WILL BE
UNINTERRUPTED OR ERROR FREE. SOME JURISDICTIONS DO NOT ALLOW THE
LIMITATION OR EXCLUSION OF LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL
DAMAGES, SO THE ABOVE LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU.

If you have an technical enquiry please use the online knowledge portal at
http://www.wyse.com/serviceandsupport/support/askwyse.asp or contact the
numbers mentioned below.

Wyse Technology Inc. Wyse Sales: Or send email to:

3471 North First Street 800 GET WYSE sales@wyse.com
San Jose, CA 95134-1801 (800 438 9973)

International Sales: Visit our websites at: Wyse Customer

Australia 61 2 9319 3388
France 33 1 39 44 63 85
Germany 49 89 460099 26
Taiwan 886 3 577 9261
UK 44 118 982 8335
United States 408 473 1200
http://www.wyse.com.au Service Center:
http://www.wyse.fr 800 800 WYSE
http://www.wyse.de (800 800 9973)
http://www.wyse.com.tw
http://www.wyse.co.uk
http://www.wyse.com

© 2009 Wyse Technology Inc. All rights reserved. This material is copyrighted. You may not
reproduce, transmit, transcribe, store in a retrieval system, or translate into any language or
computer language, in any form or by any means, electronic, mechanical, magnetic, optical,
chemical, manual or otherwise, any part of this publication without express written permission.
Wyse, WY, and WyseWorks are registered trademarks, and the Wyse logo, Winterm logo, Wyse,
and Winterm are trademarks of Wyse Technology Inc. ICA is a registered trademark and MetaFrame
is a trademark of Citrix Systems Inc. Rapport is a registered trademark of Rapport Technologies,
Inc., a division of Wyse Technology Inc. Microsoft, Windows, and Windows NT are registered
trademarks of Microsoft Corporation. Other product names mentioned herein are for identification
purposes only and may be trademarks and/or registered trademarks of their respective companies.
09/04 880924-45 Rev. A

Technote WTOS DDC WDM 4.7.2 Page 17 of 17