HP T5720 - Compaq Thin Client Quick start guide

1
Using the HP DHCP Settings Update Client
.
HP Compaq Thin Clients t5700
Table of
Contents
Table of Contents ...................................................................................................... 1
Abstra t.................................................................................................................... 2
Introdu tion .............................................................................................................. 2
Server Requirements ................................................................................................. 2
DHCP Server Requirements.............................................................................................. 2
FTP Server Requirements ................................................................................................. 2
Pro ess Flow Diagram............................................................................................... 3
Understanding the Pro ess Flow....................................................................................... 3
Version Che king...................................................................................................... 4
Version Che king Flow hart............................................................................................. 5
Control Panel Options ............................................................................................... 6
Administrative Applet......................................................................................................6
User Applet .................................................................................................................... 6
Best Pra ti es............................................................................................................ 7
Command Line Syntax .............................................................................................. 8
Input File Parameters ................................................................................................ 8
[Display].............................................................................................................8
[GUIUnattended]..................................................................................................9
[Userdata].........................................................................................................13
[Internet]...........................................................................................................14
[XpePrep] .........................................................................................................15
Sample .INI File ...................................................................................................... 16
November 2003
HP Thin Clients
Software
Instru tions

Using the HP DHCP Settings Update Client
2
Abstra t This paper provides instru tions for using HP DHCP Settings Update Client.
Introdu tion The HP DHCP Settings Update Client is a utility that allows an IT Administrator to apply
settings to an HP XP Embedded operating system. The settings are applied through an
.INI file that uses a subset of parameters from Mi rosoft's sysprep.inf as well as several
XPe/HP-spe ifi keys. XPePrep an run by spe ifying a lo al .INI file to be pro essed, or
it an be used in onjun tion with DHCP and FTP servers to automati ally apply settings
a ross multiple lients on a network.
Server
Requirements
The following se tions provide a list of requirements for the DHCP Server and the FTP
Server.
DHCP Server
Requirements
! Option 171 should ontain a string value spe ifying an FTP server name. This
an also be an IP address, but must still be spe ified as a string (for example,
123.12.34.255).
! Option 172 should ontain a String value spe ifying the path and filename for
the input answer file. This should be in the format of folder/filename.ini. If
the file is lo ated on the top dire tory, then only the filename is required.
For example, if the answer file were stored in ftp://myserver/myfolder/xpeprep.ini,
then DCHP option 171 should ontain the string myserver and DHCP option 172
should ontain the string myfolder/xpeprep.ini.
If one of these values is hanged on the DHCP server after lients have been updated,
any lients needing the new strings will either need to be rebooted or have the Mi rosoft
DHCP Client Servi e restarted. This is be ause DCHP options are a hed lo ally on the
lient to in rease performan e. However, this also prevents the lient from seeing
hanges made on the server. Rebooting the lient will ause the a he to be refreshed to
ontain the new values. Restarting the DHCP servi e will lear the a he so that requests
will go to the server instead of the a he.
FTP Server
Requirements
The FTP server must have a folder spe ified by DHCP option 172 that allows anonymous
read a ess or the server should have anonymous read a ess to the default folder (if no
folder is spe ified). Client input files should be pla ed in this folder.

Using the HP DHCP Settings Update Client
3
Pro ess Flow
Diagram
The following diagram illustrates the pro ess flow:
Understanding the
Pro ess Flow
The following steps explain the pro ess shown in the above flow hart:
1. The system boots and laun hes the lient from the Run key in the lo al ma hine
registry or the user laun hes the lient from ommand line, or by running Update
Now from the lient’s Control Panel applet.

Using the HP DHCP Settings Update Client
4
2. The lient he ks if a file was spe ified in the ommand line (e.g.,
xpeprep\test.ini). If the file is found, the lient will he k the SettingsVersion
value and then pro ess the file if needed. The following steps are performed:
a. Delete the input file.
b. Pro ess the CommitEW option.
. The lient exits using the spe ified shutdown option.
3. The lient looks for c:\xpeprep.ini. If the file is found, the lient will he k the
SettingsVersion value and then pro ess the file if needed. The following steps are
performed:
a. Delete c:\xpeprep.ini.
b. Pro ess the CommitEW option.
. The lient exits using the spe ified shutdown option.
4. If the file is not found, the lient he ks the DHCP settings. If DHCP is enabled and
the DHCP server an be rea hed, the lient will loop. It will try to onta t the DHCP
server for the FTP server and file path options based on the number of retries
spe ified. On e the DHCP server has responded with the server and path names, the
user will get the file from the FTP server and store it lo ally as c:\xpeprep.ini. The
lient will he k the SettingsVersion value, and then pro ess the file, if needed.
The following steps are performed:
a. Delete c:\xpeprep.ini.
b. Pro ess the CommitEW option.
. The lient exits using the spe ified shutdown option.
If all other steps have failed, the lient exists.
Version
Che king
The lient must maintain user and system-level settings versions. This level of revision
ontrol is ne essary be ause all settings are applied to all users ex ept for Internet proxy
settings. If a version of the settings has been applied to the system, ea h new user will
also pro ess the same file (if DHCP-based) and apply the proxy settings (if any). If no
user-level pro essing is required (in other words, no [Internet] se tion), then EWF will
not be ommitted and the shutdown option will not be pro essed.

Using the HP DHCP Settings Update Client
5
Version Che king
Flow hart
Version he king an be illustrated by the following flow hart:
Check for [HKLM\
Software\HP]
SettingsVersion
Compare File and
SystemVersions
Exists Process all file
options
Doesn’t Exist
Process all file
options
FileVersion = 0
Process all file
options
FileVersion > MachineVersion
Check for [HKCU\
Software\HP]
SettingsVersion
FileVersion<=MachineVersion
Process [Internet]
options only
Doesn’t Exist
Compare File and
User Versions
Exists Process [Internet]
options only
FileVersion > User Version
Exit No-opFileVersion<= User Version

Using the HP DHCP Settings Update Client
6
Control Panel
Options
The HP DHCP Settings Update Client an also be onfigured and/or run from the
Control Panel. There are two modes of operation for this Control Panel applet:
! Administrative mode: Administrative mode an only be a essed from the
Administrator a ount and allows onfiguration.
! Manual updates: All other users an request a manual update (if available)
using this applet.
To sele t the mode of operation, go to Control Panel and sele t Switch to Classic
View or Other Control Panel Options from the left pane. Sele t the i on labeled
“HP DHCP Settings Update Client”.
Administrative
Applet
User Applet

Using the HP DHCP Settings Update Client
7
Best Pra ti es HP re ommends the following best pra ti es when onfiguring the HP DHCP Settings
Update Client.
Best Pra ti e Explanation
If you apply a omputer name hange,
the Shutdown option in XpePrep
should equal Shutdown or Reboot,
and the CommitEW option should be
set to Yes.
Changing the omputer name requires a
reboot in order to take effe t. If you
apply a omputer name hange and do
not ommit the hange to the EWF
prote ted volume, the name hange will
be lost during the reboot.
If you sele t Yes for CommitEW , the
Shutdown option should be set to
Reboot or Shutdown.
Data in the EWF overlay is not ommitted
to the prote ted volume until the system
shuts down. Any hanges made to the
system after the HP DHCP Settings
Update Client runs (and ommits the EWF
overlay) will be saved.
If you sele t No for CommitEW , then
you should not set the Shutdown option
to Reboot or Shutdown. The
re ommended setting is None.
If the EWF Overlay is not ommitted to
the prote ted volume, then the lient will
not preserve the SettingsVersion. This
will ause the lient to pro ess the
settings and apply the Shutdown option
every time a user logs in. This would put
the system in an endless loop of booting,
logging-in, and rebooting.
If you do not spe ify a
SettingsVersion, or the
SettingsVersion is set to 0, then you
should not set the Shutdown option to
Reboot or Shutdown. The
re ommended setting is None.
Not spe ifying the SettingsVersion, or
setting it equal to 0 will ause the lient
to always apply the settings and pro ess
the Shutdown option. This would put the
system in an endless loop of booting,
logging-in, and rebooting.
If you hange the password on the
Administrator a ount, then the omputer
name hanges will only be applied
when users with administrative privileges
logon to the ma hine.
Changing the omputer name requires
administrative a ess. The lient
depends on impersonating the
Administrator a ount in order to apply
omputer name hanges when running
as a “Guest” user. For se urity reasons,
a method of ommuni ating a password
hange to the lient has not been
established.
In order to pro ess the CommitEW or
Shutdown options, other settings must be
spe ified.
These options will not be pro essed
unless other settings have been
spe ified. This is done to ensure that
there are no unne essary reboots or
writes to the flash storage media.

Using the HP DHCP Settings Update Client
8
Command Line
Syntax
For lo al file-based pro essing, use the following ommand line syntax:
C:\Windows\XPePrep.exe <path to .ini file>
For example: C:\Windows\XPePrep.exe c:\xpeprep.ini.
You must spe ify the full path to the .INI
.INI.INI
.INI file. This ommand line annot be a relative
path.
For DHCP FTP-based pro essing, use the following ommand line syntax:
C:\Windows\XPePrep.exe
Input File
Parameters
The following tables list input file parameters for [Display], [GUIUnattended],
[Userdata], [Internet], and [XpePrep].
[Display]
Setting Des ription
BitsPerPel = INT This setting spe ifies olor depth in bits
per pixel. Possible values ould be
4,8,16,24,32 depending on video
driver/monitor support.
This setting will be ignored if not
spe ified.
Vrefresh = INT This setting spe ifies refresh rate in Hertz
of the display adapter. Possible values
ould be 0, 65, 70, 72, et . depending
on the monitor/video adapter.
Xresolution = INT This setting spe ifies horizontal
resolution of the display.
This setting will be ignored if not
spe ified.
Yresolution = INT This setting spe ifies verti al resolution of
the display.
This setting will be ignored if not
spe ified.
If the system has multiple monitors, the same settings will be applied to all monitors.
Spe ifying a setting that the monitor and/or graphi s ard does not support will ause
the devi e to not operate.

Using the HP DHCP Settings Update Client
9
[GUIUnattended]
Setting Des ription
TimeZone = INT This setting will be ignored if not
spe ified.
The following table lists the numeri values orresponding to the time zones.
Index Time Zone Display
000 Dateline Standard Time
(GMT-12:00)
International Date Line
West
001 Samoa Standard Time (GMT-11:00) Midway
Island, Samoa
002 Hawaiian Standard Time (GMT-10:00) Hawaii
003 Alaskan Standard Time (GMT-09:00) Alaska
004 Pa ifi Standard Time
(GMT-08:00) Pa ifi Time
(US and Canada);
Tijuana
010 Mountain Standard Time (GMT-07:00) Mountain
Time (US and Canada)
013 Mexi o Standard Time 2 (GMT-07:00) Chihuahua,
La Paz, Mazatlan
015 U.S. Mountain Standard
Time (GMT-07:00) Arizona
020 Central Standard Time (GMT-06:00) Central
Time (US and Canada)
025 Canada Central Standard
Time
(GMT-06:00)
Saskat hewan
030 Mexi o Standard Time
(GMT-06:00)
Guadalajara, Mexi o
City, Monterrey
033 Central Ameri a Standard
Time
(GMT-06:00) Central
Ameri a
035 Eastern Standard Time (GMT-05:00) Eastern
Time (US and Canada)
040 U.S. Eastern Standard
Time
(GMT-05:00) Indiana
(East)
045 S.A. Pa ifi Standard
Time
(GMT-05:00) Bogota,
Lima, Quito
050 Atlanti Standard Time (GMT-04:00) Atlanti
Time (Canada)
055 S.A. Western Standard
Time
(GMT-04:00) Cara as, La
Paz
056 Pa ifi S.A. Standard
Time (GMT-04:00) Santiago

Using the HP DHCP Settings Update Client
10
060 Newfoundland Standard
Time
(GMT-03:30)
Newfoundland
065 E. South Ameri a
Standard Time (GMT-03:00) Brasilia
070 S.A. Eastern Standard
Time
(GMT-03:00) Buenos
Aires, Georgetown
073 Greenland Standard Time (GMT-03:00) Greenland
075 Mid-Atlanti Standard
Time (GMT-02:00) Mid-Atlanti
080 Azores Standard Time (GMT-01:00) Azores
083 Cape Verde Standard
Time
(GMT-01:00) Cape Verde
Islands
085 GMT Standard Time
(GMT) Greenwi h Mean
Time : Dublin, Edinburgh,
Lisbon, London
090 Greenwi h Standard Time (GMT) Casablan a,
Monrovia
095 Central Europe Standard
Time
(GMT+01:00) Belgrade,
Bratislava, Budapest,
Ljubljana, Prague
100 Central European
Standard Time
(GMT+01:00) Sarajevo,
Skopje, Warsaw, Zagreb
105 Roman e Standard Time
(GMT+01:00) Brussels,
Copenhagen, Madrid,
Paris
110 W. Europe Standard Time
(GMT+01:00)
Amsterdam, Berlin, Bern,
Rome, Sto kholm, Vienna
113 W. Central Afri a
Standard Time
(GMT+01:00) West
Central Afri a
115 E. Europe Standard Time (GMT+02:00) Bu harest
120 Egypt Standard Time (GMT+02:00) Cairo
125 FLE Standard Time
(GMT+02:00) Helsinki,
Kyiv, Riga, Sofia, Tallinn,
Vilnius
130 GTB Standard Time (GMT+02:00) Athens,
Istanbul, Minsk
135 Israel Standard Time (GMT+02:00) Jerusalem
140 South Afri a Standard
Time
(GMT+02:00) Harare,
Pretoria
145 Russian Standard Time (GMT+03:00) Mos ow,
St. Petersburg, Volgograd
150 Arab Standard Time (GMT+03:00) Kuwait,
Riyadh

Using the HP DHCP Settings Update Client
11
155 E. Afri a Standard Time (GMT+03:00) Nairobi
158 Arabi Standard Time (GMT+03:00) Baghdad
160 Iran Standard Time (GMT+03:30) Tehran
165 Arabian Standard Time (GMT+04:00) Abu
Dhabi, Mus at
170 Cau asus Standard Time (GMT+04:00) Baku,
Tbilisi, Yerevan
175 Afghanistan Standard
Time (GMT+04:30) Kabul
180 Ekaterinburg Standard
Time
(GMT+05:00)
Ekaterinburg
185 West Asia Standard Time (GMT+05:00) Islamabad,
Kara hi, Tashkent
190 India Standard Time
(GMT+05:30) Chennai,
Kolkata, Mumbai, New
Delhi
193 Nepal Standard Time (GMT+05:45) Kathmandu
195 Central Asia Standard
Time
(GMT+06:00) Astana,
Dhaka
200 Sri Lanka Standard Time (GMT+06:00) Sri
Jayawardenepura
201 N. Central Asia Standard
Time
(GMT+06:00) Almaty,
Novosibirsk
203 Myanmar Standard Time (GMT+06:30) Rangoon
205 S.E. Asia Standard Time (GMT+07:00) Bangkok,
Hanoi, Jakarta
207 North Asia Standard Time (GMT+07:00)
Krasnoyarsk
210 China Standard Time
(GMT+08:00) Beijing,
Chongqing, Hong Kong
SAR, Urumqi
215 Singapore Standard Time (GMT+08:00) Kuala
Lumpur, Singapore
220 Taipei Standard Time (GMT+08:00) Taipei
225 W. Australia Standard
Time (GMT+08:00) Perth
227 North Asia East Standard
Time
(GMT+08:00) Irkutsk,
Ulaan Bataar
230 Korea Standard Time (GMT+09:00) Seoul
235 Tokyo Standard Time (GMT+09:00) Osaka,
Sapporo, Tokyo
240 Yakutsk Standard Time (GMT+09:00) Yakutsk
245
A.U.S. Central Standard
(GMT+09:30) Darwin

Using the HP DHCP Settings Update Client
12
Time
250 Central Australia
Standard Time (GMT+09:30) Adelaide
255 A.U.S. Eastern Standard
Time
(GMT+10:00) Canberra,
Melbourne, Sydney
260 E. Australia Standard
Time (GMT+10:00) Brisbane
265 Tasmania Standard Time (GMT+10:00) Hobart
270 Vladivostok Standard
Time
(GMT+10:00)
Vladivostok
275 West Pa ifi Standard
Time
(GMT+10:00) Guam, Port
Moresby
280 Central Pa ifi Standard
Time
(GMT+11:00) Magadan,
Solomon Islands, New
Caledonia
285 Fiji Islands Standard Time
(GMT+12:00) Fiji Islands,
Kam hatka, Marshall
Islands
290 New Zealand Standard
Time
(GMT+12:00) Au kland,
Wellington
300 Tonga Standard Time (GMT+13:00) Nuku'alofa

Using the HP DHCP Settings Update Client
13
[Userdata]
Setting Des ription
ComputerName = String or “*” If “*” is spe ified, then a random name
will be generated using either the first
four hara ters of the Registered
Owner's name, or the string spe ified in
ComputerNameSeed (see below)
with a random number added to the
end.
This setting will be ignored if not
spe ified.
ullName = String This name will populate the Registered
Owner's name that is shown on the
system properties dialog box.
Note that this is not the name of a user
a ount.
This setting will be ignored if not
spe ified.
OrgName = String This will populate the Registered
Organization name that is shown on the
system properties dialog box.
Note that this is not the name of a
domain or user group.
This setting will be ignored if not
spe ified.
ComputerNameSeed = String If the ComputerName setting is “*”,
this string an be used as a base to a
random omputer name. For example, if
you spe ify "Widget" as the
ComputerNameSeed, then an
example omputer name would be
"Widget-18342"
This setting will be ignored if not
spe ified.

Using the HP DHCP Settings Update Client
14
[Internet]
Setting Des ription
AutoConfigUrl = String This setting spe ifies the URL of an IE
onfiguration file.
Blank if not spe ified.
HttpProxy = String in the form of
server:port
This setting spe ifies address and port of
HTTP proxy server. If you want to use the
same settings for all proto ols, only
spe ify this setting and do not in lude
the other proxy setting in this file
(tpProxy, SecureProxy,
GopherProxy, SocksProxy).
tpProxy = String in the form of
server:port
This setting spe ifies address and port of
FTP proxy server. Only spe ify this value
if you do not want to use the same
setting for all proto ols.
SecureProxy = String in the form of
server:port
This setting spe ifies address and port of
se ure (HTTPS) proxy server. Only
spe ify this value if you do not want to
use the same setting for all proto ols.
GopherProxy = String in the form of
server:port
This setting spe ifies address and port of
Gopher proxy server. Only spe ify this
value if you do not want to use the same
setting for all proto ols.
SocksProxy = String in the form of
server:port
This setting spe ifies address and port of
So ks proxy server. Only spe ify this
value if you do not want to use the same
setting for all proto ols.
AutoDetectSettings = Yes/No This setting spe ifies allows auto-
onfiguration of proxy settings.
UseScript = Yes/No This setting onfigures Internet Explorer
to use a s ript for proxy
auto onfiguration. If a s ript is spe ified
in the AutoConfigURL setting, this
setting will default to Yes and be
ignored.
UseProxy = Yes/No This setting enables/disables a proxy
server. If a proxy server is spe ified for
any proto ols, this setting will be
ignored and defaulted to Yes.
BypassList = String This setting provides a semi olon-
separated list of addresses to be ignored
by the proxy server.
Homepage = String This setting assigns a URL to use as the
default home page. This setting will be
applied to all users.

Using the HP DHCP Settings Update Client
15
[XpePrep]
Setting Des ription
Shutdown = Shutdown/Reboot/
Prompt/None
This setting spe ifies the shutdown a tion
to take when omplete.
Default is Prompt.
SettingsVersion = INT Assign a positive integer that spe ifies
the version number of the settings that
will be maintained and ompared to
prevent overwriting hanges. For
example, if you apply
SettingsVersion equal to 2, the next
time you apply hanges you will need to
update the SettingsVersion parameter
to a value greater than 2. Spe ify 0 or
leave this key out to apply settings
regardless of the previous version. For
information on using this setting, please
see the Best Pra ti es se tion of this
do ument.
CommitEW = Yes/No This setting onditionally ommits the
EWF Overlay to the prote ted volume.
This allows settings to be persistent
a ross reboots. For information on using
this setting, please see the Best Pra ti es
se tion of this do ument.

Using the HP DHCP Settings Update Client
16
Sample .INI File [Display]
BitsPerPel=32
Vrefresh=75
Xresolution=1280
Yresolution=1024
[GUIUnattended]
TimeZone=20
[UserData]
FullName=HP TM8700 Series
OrgName=HP Thin Clients
ComputerName=*
ComputerNameSeed=HPTC
[Internet]
AutoConfigUrl=http://auto onfig.my ompany. om
HttpProxy=proxy.my ompany. om:8080
Se ureProxy=proxy.my ompany. om:1010
FtpProxy=proxy.my ompany. om:2020
GopherProxy=proxy.my ompany. om:3030
So ksProxy=proxy.my ompany. om:4040
AutoDete tSettings=Yes
UseS ript=No
BypassList=*. ompaq;*.hp
Homepage=http://www.hp. om
[XPePrep]
CommitEWF=Yes
Shutdown=None
SettingsVersion=1
Mi rosoft, MS-DOS, Windows, and Windows NT are trademarks of Mi rosoft Corporation in the U.S. and
other ountries.
© 2003 Hewlett-Pa kard Development Company , L.P.
The information in this do ument is subje t to hange without noti e.
The only warranties for HP produ ts and servi es are set forth in the express warranty statements
a ompanying su h produ ts and servi es. Nothing herein should be onstrued as onstituting an additional
warranty. HP shall not be liable for te hni al or editorial errors or omissions ontained herein.
11/2003
P/N 355754-001