Reference Guide Wyse ThinOS™ INI Files Issue: 061709 PN: 883922-01 Rev.
ii Copyright Notices © 2009, Wyse Technology Inc. All rights reserved. This manual and the software and firmware described in it are 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.
Contents 1 Introduction 1 About this Guide 1 Organization of this Guide 1 Wyse Technical Support 2 Related Documentation and Services Wyse Online Community 3 2 2 Understanding WTOS INI Files 5 About WTOS INI Files 5 Working with wnos.ini Files 5 Working with {username}.ini Files 5 Rules and Recommendations for Constructing WTOS INI Files Downloading and Using Sample User INI Files 11 3 WNOS INI Only Parameters 13 Parameters for wnos.
iv Contents This page intentionally blank.
1 Introduction Wyse® thin clients using Wyse ThinOS™ (WTOS) are highly optimized thin clients that provide ultra-fast access to applications, files, and network resources made available on machines hosting Citrix™ ICA and Microsoft™ RDP session services. Locally installed software permits remote administration of the thin clients and provides local maintenance functions.
2 Chapter 1 Chapter 4, "WNOS INI and {username} INI Parameters," provides the supported parameters that you can use in a wnos.ini file and in a {username}.ini file. Appendix A, "ICA and RDP Connection Parameters," provides the supported parameters that you can use for ICA and RDP connections. Wyse Technical Support To access Wyse technical resources, visit http://www.wyse.com/support. If you still have questions, you can submit your questions using the Wyse Self-Service Center (on the Wyse.
Introduction 3 Wyse Online Community Wyse maintains an online community where users of our products can seek and exchange information on user forums. Visit the Wyse Online Community forums at: http://community.wyse.com/forums/.
4 Chapter 1 This page intentionally blank.
2 Understanding WTOS INI Files This chapter contains the basic information you need to help you understand and use the WTOS INI files. It contains information on the different WTOS INI files you can use and the rules and recommendations for constructing the files. In addition, this chapter contains information on WTOS sample INI files that you can download and modify to quickly get your file server up and running for your thin client environment.
6 Chapter 2 precedence of one variable over another, refer to the parameter notations in Table 3, "Parameters for wnos.ini files and {username}.ini files,"). Caution If both PNAgent/PNLite and a user profile are being used in the environment, the username must be defined in the Windows domain to be used, and the password used must be the same for both the Windows domain and the user profile.
Understanding WTOS INI Files 7 2. Mandatory Parameters As stated earlier, parameters can be entered as necessary for reference, but are not mandatory unless changes from defaults are required or the parameter is noted as required in the tables. For example, the Connect= parameter is mandatory. 3.
8 Chapter 2 5. Use of Number Signs As stated earlier, number signs (#) indicate the start of a comment. Comments can begin anywhere on a line. Everything between the # and the End of Line is ignored. In the following example, #ICA connect parameter for connection 1 is commented and will not be read. Reading starts at the next line (in this example, at the connect=ica statement): #ICA connect parameter for connection 1 connect=ica \ Description="Citrix45" \ host=10.1.1.
Understanding WTOS INI Files Figure 2 9 Network Setup dialog box 10.{username}.ini Files must be Write-Enabled All {username}.ini files must be write-enabled to allow the thin client to place the encrypted user passwords in the files. Note For {username}.ini Files Only - If the Password parameter is present in the {username}.ini file, it must be the first parameter in the file. The Password parameter is created and updated by the thin client; it is not inserted by the administrator.
10 Chapter 2 Placing the include=$mac.ini statement on last line of the wnos.ini file to verify that all parameters are processed properly for terminal-specific settings is recommended. For example: KeySequence=yes Ctrl+Alt+Del=no Ctrl+Alt+Down=no Ctrl+Alt+Up=no include=$mac.ini Your global settings continue to be included in wnos.ini after the include statement and terminal-specific settings are included in the include files, as shown in Figure 3. Figure 3 Global settings in the wnos.
11 Understanding WTOS INI Files Table 1 System Variables Parameter Value $SN Serial number used. $MAC MAC address used. $IP IP Address used. $UN Sign-on name used. $PW Sign-on password used. $TN Terminal name. $DN Sign-on domain name used. $WPUN PEAP/MSCHAPv2 username used (802.1x dependent). $WPPW PEAP/MSCHAPv2 password used (802.1x dependent). &Right($xx, i) or &Left($xx, i) Specifies whether the variable is to be read from left or right. The $xx is any of the above parameters.
12 Chapter 2 This page intentionally blank.
3 WNOS INI Only Parameters This chapter provides the supported parameters that you can use in a wnos.ini file. Parameters for wnos.ini Files Only Table 2 contains the supported parameters you can use in wnos.ini files. Parameters with bold values (defaults) are required parameters for a wnos.ini file (those parameters without bold values are optional). Caution Parameters in Table 2 can only be used in a wnos.ini file; they cannot be used in a {username}.ini file. Table 2 Parameters for wnos.
14 Table 2 Chapter 3 Parameters for wnos.ini files only , Continued Parameter Description AutoPower={no, yes} Yes/no option on how the system starts when the power is first applied to the thin client. If set to yes, then the system starts itself without waiting for users to press the power button (only in cases where the power was lost unexpectedly; if the thin client was shut down properly before power was lost unexpectedly, when the power is restored, the thin client will remain powered off).
WNOS INI Only Parameters Table 2 15 Parameters for wnos.ini files only , Continued Parameter Description DHCPVendorID=vendor [ParseVendorInfo={no, yes}] DHCPVendorID — Specifies the VendorID used for DHCP. ParseVendorInfo — Yes/no option to specify whether or not WTOS will interpret DHCP option 43 (vendor-specific information). If the DHCPVendorID is also used with this parameter, you must set ParseVendorInfo=yes and then reboot the thin client twice. Maximum of 26 characters are allowed in a string.
16 Table 2 Chapter 3 Parameters for wnos.ini files only , Continued Parameter Description FileServer=List of {IP address, DNS name} [Username=username] [Password=password] FileServer — Specifies the FTP server IP address or DNS name that is entered into thin client local setup (non-volatile memory); the thin client immediately uses this server to access files. Username — Specifies the username of the file server. Password — Specifies the password of the file server.
WNOS INI Only Parameters Table 2 17 Parameters for wnos.ini files only , Continued Parameter Description RegisterWINS=yes Forces the thin client to register itself with a Microsoft WINS server. RootPath=FTP root path This FTP root path is entered into thin client local setup (non-volatile memory). The thin client immediately uses this path to access files. The directory name \wnos will be appended to the FTP root path entry before use.
18 Table 2 Chapter 3 Parameters for wnos.ini files only , Continued Parameter Description SignOn={yes,no, NTLM} [MaxConnect=max] [ConnectionManager={maximize, minimize, hide}] [EnableOK={no, yes}] [DisableGuest={no, yes}] [DisablePassword={no, yes}] [LastUserName={no, yes}] [RequireSmartCard={no, yes}] [SCRemovalBehavior= {0, 1}] SignOn — Yes/no/NTLM option to enable the sign-on process. If set to NTLM, a user can be authenticated with an NTLM protocol.
WNOS INI Only Parameters Table 2 19 Parameters for wnos.ini files only , Continued Parameter TCXLicense= Description Activates the TCX Multimedia software where is the license key. The TCX license key is encrypted into a 5x5 key (xxxxx-xxxxx-xxxxx-xxxxx-.xxxx), where x is the character 0-9, a-z, or A-Z (lower- and uppercase letters are treated the same). More than one license key can be accepted at the same time. With one identifier (TCX license), delimit different keys by using a comma.
20 Table 2 Chapter 3 Parameters for wnos.ini files only , Continued Parameter Description TimeZone=zone [ManualOverride={no, yes}] [daylight={no, yes}] [start=mmwwdd end=mmwwdd] [TimeZoneName=timezonename] [DayLightName=daylightname] TimeZone — Specifies the time zone if the zone is unspecified on the thin client or is used with ManualOverride.
4 WNOS INI and {username} INI Parameters This chapter provides the supported parameters that you can use in a wnos.ini file and in a {username}.ini file. Parameters for wnos.ini Files and {username}.ini Files Table 3 contains the supported parameters you can use in wnos.ini files and {username}.ini files. Parameters with bold values (defaults) are required parameters for a wnos.ini file or a {username}.ini file (those parameters without bold values are optional).
22 Table 3 Chapter 4 Parameters for wnos.ini files and {username}.
WNOS INI and {username} INI Parameters Table 3 23 Parameters for wnos.ini files and {username}.ini files , Continued Parameter * Global overrides identically-named user profile ** After sign off, user profile returns to global value Description **Desktop=bitmap file [Layout={center, tile}] Desktop — Specifies a bitmap file to be used as wallpaper for the local desktop. This file could be a 4-bit, 8-bit, or 24-bit BMP file or a standard GIF file or a standard JPEG file.
24 Table 3 Chapter 4 Parameters for wnos.ini files and {username}.
WNOS INI and {username} INI Parameters Table 3 25 Parameters for wnos.ini files and {username}.ini files , Continued Parameter * Global overrides identically-named user profile ** After sign off, user profile returns to global value Description **DisableMouse={no, yes} or MouseDisable={no, yes} DisableMouse — Yes/no option to disabled mouse pointer so that it is shown on the screen. The pointer is enabled if any mouse activity occurs.
26 Table 3 Chapter 4 Parameters for wnos.ini files and {username}.ini files , Continued Parameter * Global overrides identically-named user profile ** After sign off, user profile returns to global value Description KeySequence={no, yes} [Ctrl+Alt+Del={no, yes}] [Ctrl+Alt+Up={no, yes}] [Ctrl+Alt+Down={no, yes}] [Ctrl+Alt+Left={no, yes}] [Ctrl+Alt+Right={no, yes}] KeySequence — Yes/no option to enable the combined keys options. Ctrl+Alt+Del — Yes/no option to enable Ctrl+Alt+Del to lock the thin client.
WNOS INI and {username} INI Parameters Table 3 27 Parameters for wnos.ini files and {username}.
28 Table 3 Chapter 4 Parameters for wnos.ini files and {username}.ini files , Continued Parameter * Global overrides identically-named user profile ** After sign off, user profile returns to global value Description **LowBand={no, yes} Yes/no option to enable optimization for low speed connections (on all connections), such as reducing audio quality and/or decreasing protocol-specific cache size. This setting in a wnos.ini file will be saved into NVRAM if EnableLocal=yes is set in the wnos.ini file.
WNOS INI and {username} INI Parameters Table 3 29 Parameters for wnos.ini files and {username}.ini files , Continued Parameter * Global overrides identically-named user profile ** After sign off, user profile returns to global value Description NetworkPrinter=host/queue [PrinterID=Window driver name] [Enabled={no, yes}] NetworkPrinter — Specifies the configuration for the network (LPD) printer in the same way as described for the Printer Setup dialog box in the WTOS Users Guide.
30 Table 3 Chapter 4 Parameters for wnos.ini files and {username}.ini files , Continued Parameter * Global overrides identically-named user profile ** After sign off, user profile returns to global value Description Printer={COM1, COM2, LPT1, LPT2} [Name=name] [PrinterID=window_driver] [Class=classname] [Enabled={no, yes}] [EnableLPD={no, yes}] Printer — Specifies the local printer to configure. Name — Specifies the name of the printer and is required.
WNOS INI and {username} INI Parameters Table 3 31 Parameters for wnos.ini files and {username}.
32 Table 3 Chapter 4 Parameters for wnos.ini files and {username}.ini files , Continued Parameter * Global overrides identically-named user profile ** After sign off, user profile returns to global value Description **Reconnect={no, yes} Yes/no option to enable automatic reconnection to an application after a server disconnection. This setting in a wnos.ini file will be saved into NVRAM if EnableLocal=yes is set in the wnos.ini file.
WNOS INI and {username} INI Parameters Table 3 33 Parameters for wnos.ini files and {username}.ini files , Continued Parameter * Global overrides identically-named user profile ** After sign off, user profile returns to global value Description **ScreenSaver={0, 1, 5, 10, 15, 30, 60, 120, 180} [LockTerminal={0, 1, 2}] [Type={0,1, 2}] [Image=imagefile] Screensaver — Specifies to put the thin client in a screensaver state when the time limit for inactivity (delay before starting) is reached.
34 Table 3 Chapter 4 Parameters for wnos.ini files and {username}.ini files , Continued Parameter * Global overrides identically-named user profile ** After sign off, user profile returns to global value Description **Seamless={no, yes} [HideTaskbar={0, 1, 2, 3}] [FullscreenReserved={no, yes}] Seamless — Yes/no option to set the default resolution for ICA published applications to Seamless for ICA connection parameters.
WNOS INI and {username} INI Parameters Table 3 35 Parameters for wnos.ini files and {username}.
36 Table 3 Chapter 4 Parameters for wnos.ini files and {username}.
A ICA and RDP Connection Parameters This appendix provides the supported parameters that you can use for ICA and RDP connections. Parameters for ICA and RDP Connections Table 4 contains the supported parameters you can use for ICA and RDP connections (after Connect=ICA or Connect=RDP). Parameters with bold values (defaults) are required parameters for an ICA or an RDP connection (those parameters without bold values are optional). Note Any parameter in Table 4 that is used in a {username}.
38 Table 4 Appendix A Parameters for ICA and RDP connections , Continued Parameter *** Required Description Colors={256, 32k, 64k or high, 16m, true} Session color mode. For faster display performance, use 256 colors for the session. NOTE: 64k is the same value as high. Older ICA servers may not support the 32k mode. In this case, the thin client will negotiate with the server and run the session in the 256 color mode (high colors in ICA requires that the server be running MetaFrame 1.8 FR2 or higher).
ICA and RDP Connection Parameters Table 4 39 Parameters for ICA and RDP connections , Continued Parameter *** Required Description Icon={default, bitmap file} Specifies an icon to appear on the thin client desktop for a connection. Use Icon=default to display a system default icon for a connection. To use an icon other than the default icon, enter the name (with extension) of the bitmap file (ensure that the file is located in the FTP server wnos\bitmap directory).
40 Table 4 Appendix A Parameters for ICA and RDP connections , Continued Parameter *** Required Description Rdp_No_Theme={no, yes} RDP Only. Yes/no option to disable the Theme feature (use yes to disable the feature). Rdp_No_Wallpaper={no, yes} RDP Only. Yes/no option to disable the Wallpaper feature (use yes to disable the feature). Reconnect={no, yes, 1 to 3600 (seconds)} Controls automatic reconnection to an application after a server disconnection.
ICA and RDP Connection Parameters Table 4 Parameters for ICA and RDP connections , Continued Parameter *** Required Description Username-enc= an encrypted username Specifies an encrypted string as a username for a connection. [WyseVDA={no, yes}] Yes/no option to enable Wyse Virtual Desktop Accelerator for all ICA and RDP sessions. [Introduced in build 6.4.
42 Appendix A This page intentionally blank.
43 Figures 1 2 3 4 Directory structure of the WNOS Home Directory Network Setup dialog box 9 Global settings in the wnos.
44
45 Tables 1 2 3 4 System Variables 11 Parameters for wnos.ini files only 13 Parameters for wnos.ini files and {username}.
Reference Guide Wyse ThinOSTM INI Files Issue: 061709 Written and published by: Wyse Technology Inc.