Dell Wyse ThinOS Version 8.5.1 INI Reference Guide February 2021 Rev.
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2018-2021 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents Summary of revisions............................................................................................................................................................... 4 Chapter 1: Introduction................................................................................................................. 5 About this Guide..................................................................................................................................................................
Summary of revisions The following changes and enhancements have been made to this document since Dell Wyse ThinOS release 8.5.1. Table 1. Newly added INI parameters Reference Description ● Device=Wireless New parameters added in Connection settings for wnos.ini files, {username} INI and $MAC INI files.
1 Introduction Thin clients running Dell Wyse ThinOS firmware are designed solely for optimal thin client security and performance. These extremely efficient purpose-built thin clients are virus and malware-resistant and offer ultra-fast access to applications, files, and network resources within Citrix, Microsoft, VMware and Dell vWorkspace environments, and other leading infrastructures.
2 Getting Started: Learning INI File Basics In this chapter you will learn how to construct and use the supported INI files. It includes: ● Downloading and Using Sample INI Files ● Supported INI Files You can Construct ● Rules and Recommendations for Constructing the INI Files ● Placing the INI Files into the Folder Structure on the Server After you become familiar with the INI file basics, you can refer to the parameter details you need in the other chapters and appendixes of this guide.
Working with wnos.ini files A wnos.ini file contains the global parameters you want that will affect all thin clients accessing the server. Parameters in both Connection Settings: wnos.ini files only, and Connection Settings: wnos.ini files, {username} INI, and $MAC INI Files can be used in a wnos.ini file. NOTE: Parameters in Connection Settings: wnos.ini files only can only be used in a wnos.ini file; they cannot be used in a {username}.ini file. Working with $MAC.ini Files A $MAC.
Global connect parameters should be listed before other connect parameters in a wnos.ini file. 2. Connect is the Only Required Parameter As stated earlier, if you are using an INI file, the only parameter you must use is the Connect parameter. Any of the rest of the parameters can be used if you desire, but are not necessary unless you want changes from client and other defaults. 3. Continue Lines by using a Space and Backslash Placing a space and backslash ( \) at the end of a line indicates line continuat
System variables The following table contains the system variables you can use with some options of the connect parameter: Table 3. System variables Option Value $SN Serial number used. $MAC MAC address used. $IP IP Address used. $IPOCT4 The fourth octet of IP Address, for example, if IP is 10.151.120.15, then the fourth octet is 15. $TN Terminal name. $PF Platform name—The first part of image name xxx_wnos, for example, R10L. $UN Sign-on name used. $PW Sign-on password used.
Placing the INI files into the folder structure on the server If you have set up your environment to provide your thin clients running ThinOS with automatic updates and configurations as described in ThinOS Administrator’s Guide, you can use the following folder structure on your server under the C:/inetpub/ ftproot folder, for FTP or C:/inetpub/wwwroot folder, for HTTP or HTTPS and place your INI files and other necessary files inside the structure as noted.
3 Parameters for wnos INI files only This chapter provides the supported parameters that you can use in a wnos.ini file. NOTE: For information to help you construct and use the supported INI files, see Getting Started Learning INI File Basics. Parameters in Connection Settings for wnos.ini Files Only can only be used in a wnos.ini file; they cannot be used in a {username}.ini file.
Table 5. General Settings: wnos.ini files only (continued) Parameter Description 102 — Enables firmware upgrade, but displays a window with OK or Cancel button before the process with a note of the version to upgrade; displays a status complete window. 201 — Enables firmware upgrade or downgrade process, but displays a window with OK button before the process; displays a status complete window.
Table 5. General Settings: wnos.ini files only (continued) Parameter Description or Yes/no option on how the system starts when the power is first applied to the thin client. Device=cmos AutoPower=(yes, no) If set to yes, then the system starts itself without waiting for users to press the power button. In cases where power was lost unexpectedly and if the thin client was shut down properly before power was lost unexpectedly, when the power is restored, the thin client will be powered.
Table 5. General Settings: wnos.ini files only (continued) Parameter Description Override — Default is no. Yes/no option to allow a groupkey from the INI file to override the previous groupkey. If Override=yes is specified, the groupkey from the INI file will override the previous groupkey. The Groupkey can technically be applied in many places. You can configure the group key in order of priority, that is, if #1 is defined it will override #2. Groupkey priority policy is listed below: 1.
Table 5. General Settings: wnos.ini files only (continued) Parameter Description [disable={yes/no}] Display—If the value is set to yes, the username field in signon window will be displayed. By default the value is set to no and the field will be obscured with asterisks (*). disable— If the value is set to yes, the user name field in sign-on window is disabled. Password= [disable={yes/no}] [encrypt={no, yes}] Password— Specifies the password as the sign-on password.
Table 5. General Settings: wnos.ini files only (continued) Parameter Description on how to terminate Include. <{username}.ini> Loads / wnos/inc/{username}-address.ini. The file name does not include the symbol : in the {username} address. See also the Exit parameter for information on how to terminate Include. MirrorFileServer={no, yes} Default is no. Yes/no option to enable the cache all server files functionality.
Table 5. General Settings: wnos.ini files only (continued) Parameter Description WW = Week of the Month. Values are 01 to 05 for the week of the month, 05 is the last week. For example, 01 = 1st week, 05 = the last week of the month. DD = Day of the week. Values are 01 to 07 for the day in the week from Monday to Sunday. For example, 01 = Monday, 07 = Sunday. NOTE: For the 2013 year, DST dates are Sunday, March 10, 2:00am and ends Sunday, November 3, 2:00am.
Table 6. Peripheral Settings: wnos.ini files only Parameter Description DEVICE_SECURITY=white_list/black_list 1. When DEVICE_SECURITY=white_list is set, the security is in high level, and you need to add all the devices (on board devices including Wyse 3020 thin client with ThinOS (T10D)'s netcard, and internal hub) to the list that you want to use, and all other devices are denied when the device is plugged-in. 2.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description including the trailing period and the file extension, is limited to 64 characters. AddCertificate must be used when configuring the Citrix Secure Gateway PNAgent Interface (PNAgent/Lite servers) in the Network Setup dialog box. Adding certificates are required if the user CSG environments use certificate agents that are not covered by the builtin certificates.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description [ConnectionType]={Default, All, RDP, PCoIP, Blast} Set IgnoreProfile=yes to disable parsing the global setting from the VDI broker. It is only valid in the case of ConnectionBroker=default. [EnableVDMCredSSP]={yes, no} [RDCollections={*collect1, collect2,...}] [DisableShowDisclaimer=[yes, no] [DisableShowServer=[yes,no] [EnableUnauthenticatedAccess]={yes,no} [Host={broker_url}] [AutoConnectList={*|host1;host2;host3...
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description RDCollections—The option specifies the collections for Microsoft RD broker. Only the applications and desktops within the specified collections are displayed. The value can be a list separated by ',' or ';' and can use wildcard "*" to match the string. If the parameter is not set, all the applications and desktops are displayed. To get your RemoteApp or desktops collection name, do the following: 1.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description reboot — After 5 seconds, the system reboots. shutdown — After 5 seconds, the system shuts down. DHCPOptionsRemap={no, yes} Default is no. [DisableOption12={no, yes}] DHCPOptionsRemap — Specifies whether or not the following options can be set.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description This is a vendor-specific information. If ParseVendorInfo is set to no and 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. DisableDomain={no, yes} Default is no. Yes/no option to disable the drop-down domain list in the PNAgent/PNLite Sign-on dialog box.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description Dualhead=yes ManualOverride=yes Mainscreen=1\Orientation=hort Taskbar=mainscreen NOTE: If using, be sure the ManualOverride option is the first option used after the Dualhead parameter position in the statement. Mainscreen — Sets which screen is used as the main screen. When using a DVI to DVI and VGA cable, the DVI connected monitor will be the default mainscreen=1. Orientation — Default is hort.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description If EnableRAVE=no or this parameter is not present, the TCX Multimedia will be used for all media files. If EnableRAVE=yes, RAVE will be used only for media files it supports. EnableRAVE=yes is ignored unless a valid TCX Multimedia license is used.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description 3. Certificate verification passes 4. CN and SAN on the certificate matches the DNS naming For Example: FileServer=https://10.151.122.66:444 SecurityMode=warning. Username-Enc specifies the AES encrypted username of the file server. Password-Enc specifies the AES encrypted password of the file server. Use Windows Password_Gen tool to generate the encrypted string.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description seconds; System will automatically sign off, reboot or shutdown based on the setting of AutoSignoff. LongApplicationName={no, yes} Default is no. Yes/no option to display all 38 characters in a desktop icon name. If LongApplicationName=no, then icons will display up to 19 characters; any over 19 characters and the last three characters will be “…”. MaxVNCD={0, 1} Default is 0.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description description="Floor 3" host=10.1.1.30 \ description=""Floor 1" host=10.2.2.60 \ description="All Users" host=10.3.3.90 NOTE: The SelectServerList takes precedence over PNAgentServer. The PNA server description or name can be displayed on the signon window so that the user knows which and what server is logging on. See also SelectServerList={PNA, VDI} in Connection Settings for wnos.ini Files Only.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description If AutoAccess is defined, then auto launch the corresponding type of broker. Otherwise, get the broker type from the Imprivata Server setting of computer and user policy. If none of them is defined, then launch the first available broker server from the Imprivata server. If AutoAccess=LOCAL is set, then launch the broker from the ThinClient setting; the broker getting from the Imprivata Server is ignored.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description If Connect parameters do not follow AccountSelfService=yes, this password server will be the account self-service server of Citrix and clicking the icon will use Citrix protocol to unlock or change password for an account. If Connect parameters follow AccountSelfService=yes, clicking the icon launches a session to change password for an account.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description [Server=_host_port_] If Proxy=yes, the option AppList must be followed. It specifies which applications are applied to connect through proxy. WMS, CCM, FR, and RTME are supported. The application name is separated with semicolon. [User=_user_name] [Password=_password_] [Encrypt={yes, no}] NOTE: Wyse Management Suite is the successor to Cloud Client Manager (CCM).
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description Discover— If Discover=yes is specified, rapport discovers the WDM server information from DHCP option tag, DNS service location record and DNS host name. If the WDM server is discovered, the WDM server User Interface (UI) is protected on the device. The default value is yes. SecurityMode specifies the SSL certification validation policy. If set to default, SecurityPolicy setting is applied.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description RegisterWINS=yes Forces the thin client to register itself with a Microsoft WINS server. ScepAutoEnroll={yes, no} This option is to allow client automatically get certificates and renew certificates using SCEP protocol.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description enrollment password from a Windows SCEP server. In this case, the ScepUser, ScepUserDomain, ScepUserPwd (or ScepUserPwdEnc, in encrypted form instead of plan-text) are used to specify the SCEP administrator's credential, and ScepAdminUrl must be set correctly to specify the corresponding SCEP admin web page's URL.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description disable — Default is no. Yes/no option to disable the services. Disable must follow the Service parameter. Service=snmpd disable={no, yes} Default is no. [community= [encrypt={yes, no}]] Service=snmpd disable — Yes/no option to disable the snmpd service.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description SecurityPolicy={full, warning, low} Specifies the global security mode for SSL connection. If application SecurityMode is default, application applies the setting. [SecuredNetworkProtocol={yes, no}] [TLSMinVersion]={1,2,3}] [TLSMaxVesion={1,2,3}] [DNSFileServerDiscover={yes, no}] [TLSCheckCN=[yes, no]] If set to full, the SSL connection needs to verify server certificate. If it is untrusted, connection is dropped.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description [DisableGuest={no, yes}] MaxConnect — Default is 216. Maximum number of connections allowed to be specified in the wnos.ini file and {username}.ini file added together. The range allowed for MaxConnect is 100 to 1000. The default maximum is 216 entries.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description Up to 1 Level icon on top. Clicking the icon will display the up one level folder contents. IconGroupLayout — Default is vertical. Configures the direction of the icongroup on the desktop. PasswordVariables — Default is no. Yes/no option to support variable mapping ($TN, $UN etc) for a password. LockTerminal — Default is yes. Yes/no option to lock the terminal.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description For example, if the sign on user is user_111 in a domain, and the user_111 belongs to group domain user and group tc_grp1_ad, the option is configured as AdGroupPrefix=tc_grp1. If the configuration file adgroup/ tc_grp1_ad.ini is available, it will be loaded. ClearUser—The option keyword ClearUser, if set to yes, clears the username when login fails, and if set to no, retains username entered after login failure.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description Toolbardisablemouse — Default is no. Yes/no option to disable the Zero toolbar from automatically displaying once you pause the mouse pointer on the left side of the screen for a specified amount of time. toolbarclick — Default is no. Yes/no option to pop up the toolbar only if clicking on the left-most side of the screen.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description encrypted password, you must set encrypt to yes. For example: VncPassword= encrypt=yes If you are using a plain text password, you must set encrypt to no. For example: VncPassword= encrypt=no See also MaxVNCD in Connection Settings: wnos.ini files only to enable VNC shadowing. See also VNCPrompt in Connection Settings: wnos.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description WDMFlash=flash_size The specified value will be saved into NVRAM, and then reports to the WDM server. This statement ensures that all the units would function with DDC regardless of flash size. This statement is valid for all platforms and replaces the previous S10 WDM Flash statement. WDMService={yes, no} Default is yes. [DHCPinform={no, yes}] WDMService — Yes/no option to disable the WDM agent.
Table 7. Connection Settings: wnos.ini files only (continued) Parameter Description WINSServer=server_list Specifies the WINS server address. The WINSserver is an IP list separated by ";" or ",", with a maximum list size of 2. AutoSelectSingleCert={yes, no} When HTTPS is configured to verify client certificate, one window pops up for user to select the client certificate.
4 Parameters for wnos INI, {username} INI, and $MAC INI files This chapter provides the supported parameters that you can use in a wnos.ini file, a {username}.ini file, and in a $MAC.ini file. For information to help you construct and use the supported INI files, see Getting Started: Learning INI File Basics To increase usability such as relation to thin client dialog box equivalents, the supported parameters are separated into the following categories: ● General Settings for wnos.
General settings for wnos.ini files, {username} INI, and $MAC INI files The following table contains the parameters used for configuring general settings. The underlined values are defaults. Table 8. General Settings: wnos.
Table 8. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value If the first boot order is not HardDisk, the system restart will boot from the BIOS setting. BootpDisable={no, yes} Default is no. BootpDisable — Yes/no option to disable BOOTP requests. ThinOS supports both DHCP and BOOTP to obtain the network configurations.
Table 8. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value For center, the image is placed in the center of the desktop without image size change. For tile, the image is replicated across the desktop. For stretch, the image is modified to fill the desktop. NOTE: The MirrorFileServer parameter also supports the DeskColor parameter.
Table 8. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value ACRecovery— This option specifies how the system behaves when AC power is restored after an AC power outage. ● PowerOff—System stays off after AC power is restored. ● PowerOn—System powers on after AC power is restored.
Table 8. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value $VER—version of BIOS, like 1.2.2. With ThinOS log, CMOS, extract to $PF_cmos.$VER For restore action, CMOS content is updated from file $PF_cmos.$VER With a syslog, CMOS: restore from $PF_cmos.$VER The file is strongly checked and protected from corruption.
Table 8. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value *Include=path/filename For {username}.ini file only. Specifies to include another INI file at the position of this parameter. Only one level of including is allowed (no nesting) and only for a {username}.ini file.
Table 8. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Arabic (Algeria) — Ar_alg Arabic (Morocco) — Ar_mor Arabic (Tunisia) — Ar_tun Arabic (Oman) — Ar_oma Arabic (Yemen) — Ar_yem Arabic (Syria) — Ar_syr Arabic (Jordan) — Ar_jor Arabic (Lebanon) — Ar_leb Arabic (Kuwait) — Ar_kuw Arabic (U.A.E.
Table 8. General Settings: wnos.
Table 8. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value gb (Simplified Chinese) b5 (Traditional Chinese) ko (Korean) la (Spanish Mexican) By default, with the above keyboard languages, the system will update the standard image according to the suffixes with the language code.
Table 8. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value All the values will be displayed in the GUI. To view the GUI, click System Preference > General > Locale. Be sure to place the necessary files, for example German.msg, Japanese.msg, Japanese.fnt, and so on under the correct folders as described in the Locale parameter description.
Table 8. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value [TrapReboot={yes, no}] ● If LockDown=yes, then the privilege is saved in permanent registry. [EnableCancel={yes, no}] ● if LockDown=no, then the privilege level is set to the default high in the permanent registry.
Table 8. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value DisableNetworkOptions — This option is used to enable and disable the network options.
Table 8. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value option can be a list of any valid value separated with "," or ";". For Camera, Touchscreen and Bluetooth, they can be enabled only, if the devices are available. For example, Privilege=none lockdown=yes EnablePeripherals=mouse,audio,camera,bluetooth, then mouse and audio tab will be enabled.
Table 8. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value URL—This option specifies a new URL of the resources. User and Password—These options specify the credentials of the new resource URL. Encrypt—This option specifies whether or not the password is encrypted. For example, ResourceUrl=yes type=picture url=ftp://10.xxx.xxx.
Table 8. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value 0 — Blank the Screen 1 — Flying Bubbles 2 — Moving Image 3 — Showing Pictures 4 — Playing Video If the value is set to Type=None, and the parameter LockTerminal is set to a non-zero value, the unlocking window is displayed when the screen saver times out.
Table 8. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value **ShutdownCount={0 to 60} (seconds) or **ShutdownCounter={0 to 60} (seconds) ShutdownCount or ShutdownCounter — Specifies the number of seconds to count down before the shutdown sequence starts upon using the thin client power button when there are active sessions.
Peripheral settings for wnos.ini files, {username} INI, and $MAC INI files The following table contains the parameters used for configuring peripheral settings such as keyboard, monitor, mouse, printers and bluetooth devices. The underlined values are default values. Table 9. Peripheral Settings for wnos.
Table 9. Peripheral Settings for wnos.ini Files, {username} INI, and $MAC INI files (continued) playback — You can set a playback device name. record — You can set the record device name. mic_gain_device— Specify the device name on which you want the mic gain. mic_gain—Enhances the mic gain by number of times the specified value. The default value is 1. DPaudio=[yes, no]— The default option is DPaudio=yes.
Table 9. Peripheral Settings for wnos.ini Files, {username} INI, and $MAC INI files (continued) optimize=yes, then 320 x 240 at 10 fps will be used for the local camera settings regardless of the individual settings in width, height, and fps; as long as the camera supports the 320 x 240 at 10 fps. If optimize=yes and the camera does not support the 320 x 240 at 10 fps settings, an error will be present in the Event Log of ThinOS.
Table 9. Peripheral Settings for wnos.ini Files, {username} INI, and $MAC INI files (continued) [DisableKeystroke={yes, no}] [SetCardType={yes, no} Configuration1={*} Configuration2={*} ] [DisableInitialization={yes, no}] [DisableLed={yes, no} DisableBeep — Default is yes. Option disables the beep sound when the card is read. DisableKeyStroke — Default is yes. Option disables the keyboard movements and key strokes. SetCardType — Default is no. Used only for pcProx Plug readers.
Table 9. Peripheral Settings for wnos.ini Files, {username} INI, and $MAC INI files (continued) If LpdSpool=0, the function is disabled, otherwise the function is enabled. LPTPortBind={yes, no} LPTPortBind — Default is Yes. Specifies the LPT bind to the USB Port Policy. If set to Yes, then the registered port follows the following binding policy: LPT1 from USB ports 1/3/5/7 and LPT2 from USB posts 2/4/6. If set to No, then the LPT port plugged in first is LPT1 followed by LPT2, and so on.
Table 9. Peripheral Settings for wnos.ini Files, {username} INI, and $MAC INI files (continued) [Host= host] [Queue=queue] [PrinterID=window_driver] [Class=classname] [Enabled={no, yes}] LocalName — Specifies the name of the printer. If LocalName is not specified, the Queue name is used. Host — Specifies the host name of the printer. Queue — Specifies the queue name of the printer. PrinterID — Specifies the windows driver to use for the printer. If not specified, the default Generic/Text Only is used.
Table 9. Peripheral Settings for wnos.ini Files, {username} INI, and $MAC INI files (continued) 2 — 1/3 3 — 1/2 4 — 3/4 5—1 6—2 7 — No Repeat **RepeatRate={0, 1, 2} Default is 1. Specifies the keyboard repeat rate. 0 — Slow 1 — Medium 2 — Fast *Resolution=[DDC, 640X480, 800X600, Default is DDC. 1024X768, 1152X864, 1280X720, Resolution — Specifies the local display resolution. Option DDC can be specified to select default display resolution.
Table 9. Peripheral Settings for wnos.ini Files, {username} INI, and $MAC INI files (continued) NOTE: The Screen parameter must be placed before the Resolution parameter. For example: screen=1 resolution=1280x1024 refresh=60 rotate=none Connection Settings for wnos.ini files, {username} INI, and $MAC INI files The following table contains the parameters (and their options) used for configuring connection settings. Table 10. Connection Settings: wnos.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) Yes/no option to clear the TSCAL license stored in the nonvolatile memory. It can be replaced by FixLicense=clean. Connect={ICA, RDP} Connect — Connection protocol. Follow the ICA option list, see ICA Connect Options or RDP option list, see RDP Connect Options. Any options you use for your connection must be on the same logical line; \can be used for line continuation, see Rules and Recommendations for Constructin
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) Device=vusb [ForceRedirect=DeviceID, fast] [ForceLocal=DeviceID] [Type={TCX, HDX}] [InterfaceRedirect={no, yes}] [TCXDVCdefault={yes, no}] Device — Specifies the ID of a local USB device that is not redirected by default. ForceRedirect — Specifies a forced redirect of the local USB device to the server. This parameter has priority over ForceLocal. Device=vusb ForceRedirect=0x07B4,0x0254,0x01,0x01,0x00,f ast.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) [DisableN={no, yes}] [DisableWlan={yes, no, EnetUp}] [RoamScanChannelTime={1-15}] [RoamScanChannelProbes={1-4}] The RoamSensitive parameter is also used to enable wireless roaming. If it is not configured in the INI file, roaming will never be launched even if the signal is lower than -80dbm, unless it totally loses a wireless signal.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) DISABLETSGW NOTE: DISCONTINUED. DO NOT USE. See TSGWENABLE **EnableLocal={no, yes} Default is no. [HideDefault={no, yes}] Yes/no option to enable locally configured entries to show in the Connect Manager list. When connections defined in local NV-RAM are displayed in the Connect Manager, they are marked with an asterisk. If EnableLocal=yes is in a wnos.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) fastconnect=yes \ key=F1 ctrl=no alt=no connect=ica list="Excel 2013" title="*Excel*" \ key=F2 ctrl=yes alt=no connect=ica list="XA76-2008R2*". When you press F1, the application Excel 2013 is launched. If there is a seamless window which matches the title *Excel* in this session, the seamless window is brought to the foreground, else it is launched. When you press Ctrl+F2, the desktop XA76-2008R2* is launched.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) - When moving a mouse cursor over the PN icon, the connected PN servers do not display. Hosts= Specifies the file name of the hosts. This file is a simple text file that associates IP addresses with hostnames, one line per IP address. The length of the file name is limited to 63 characters. The file must be placed in file server and can be cached if set MirrorFileServer=yes in the wnos.ini.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) [peapmschappwdEnc={password encrypted for EAP-PEAP/ EAP-MSCHAPV2}] [peapmschapdm={domain for EAP-PEAP/ EAP-MSCHAPV2}] [peapmschaphidedm={yes,no}] [peapsinglesignon={yes, no}] [peapgtcun={username for EAP-PEAP/ EAP-GTC}] [peapgtcpwd={password for EAP-PEAP/ EAP-GTC}] [peapgtcpwdEnc={password for encrypted for EAP-PEAP/ EAP-GTC}] 11.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) The following example describes wildcard server validation:IEEE8021X=yes network=WIRED access=WPA2-ENT servervalidate=yes eap=yes eaptype=EAP-FAST servercheck=yes servername=w2k8ACS-64.sqawirelsess.com fastmschapdm=EAPMSCHAPV2 fastgtcun=sqawirless2 fastmschappwd=123! @#qwe wiredreset is used to reset MII when authenticate cancel occurs. This option is only for wired-network and is disabled by default.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) disablepcm — Default is no. Yes/no option to disable the pcm codec when playing audio. MMRCodecConfig=VIDEO [disablempeg1={no, yes}] [disablempeg2={no, yes}] [disablejpeg={no, yes}] [disablewmv1={no, yes}] [disablewmv2={no, yes}] [disablewmv3={no, yes}] MMRCodecConfig — Only for platforms with TCX Multimedia. Specifies the video to allow the disabling of the various codec options when playing video.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) TaptoLock — Default is 2. Only active when KioskMode=yes. Specifies tap to lock. If TapToLock=0, then tap a card to lock terminal is disabled. If TapToLock=1 (Tap to lock), then use the proximity card to lock the terminal. If TapToLock=2 (Tap over), then lock the terminal and log in a different user. EnableWindowAuthentication — Default is yes.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) ReconnectAtLogon — Specifies the reconnection function at log in. Default is 0 — disables the option. 1 — reconnects to disconnected sessions only. 2 — reconnects to active and disconnected sessions. ReconnectFromButton — Specifies the reconnection function from the reconnect command button. Default is 0 — disables the option. 1 — reconnects to disconnected sessions only.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) 1. SignOn=Yes 2. PnliteServer= RequestIconDataCount=20 3. desktopcolordepth=32 4. LongApplicationName=yes 5. sessionconfig=ica progressivedisplay=yes ondesktop=yes 6. device=audio volume=high 7. Seamless=yes FullscreenReserved=yes 8. sessionconfig=all mapdisks=yes 9. Enabled by default: Disks, Serials, Sound 10. Disabled by default: USB, Printers, Smart Cards Xen Desktop Default Settings: 1. SignOn=Yes 2.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) CAGExternal—This value allows CAG login with external network mode directly without check beacons and reduces login time. DisableSFInit—This value disables storefront initialization process when you turn on the thin client. This is because, the storefront initialization process takes time to start which is not required during logon.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) will be saved into NVRAM if EnableLocal=yes is set in the wnos.ini file. NOTE: ● When set Seamless=yes HideTaskbar=2, it removes the auto-hide taskbar function but it reports the full resolution to the ICA server in a similar way to HideTaskbar=1. ● When set Seamless=yes HideTaskbar=3, the maximized size does not cover the taskbar, but the session size on the server side is reported as the fullscreen size.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) description="SQA team" groupname=sqa \ description="guest" Group 1: Description="Dev team" groupname=dev The file \wnos\ini\dev\dev.ini must be created in the file server. In the dev.ini, the broker, domain list, or connections can be defined for the dev team. Group 2: .Description="Sus team" The file \wnos\ini\Sus team\Sus team.ini must be created in the file server. In the Sus team.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) [UnmapClipboard={no, yes}] [DefaultColor={0,1,2}] [VUSB_DISKS={yes, no}] [VUSB_AUDIO={yes, no}] [VUSB_VIDEO={yes, no}] [VUSB_PRINTER={yes, no}] [FullScreen={no, yes}] [Resolution={default, vga_resolution}] DisksReadOnly — Default is no. Yes/no option to mount mass storage disks as read-only. MouseQueueTimer — Specifies the default queue timer of a mouse event in an ICA or RDP session (in 1/100 of a second).
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) WyseVDAServerPort — Sets Wyse VDA Server Port for a ThinOS VDA client. The default port is 3471. The port range must be from 1029 to 40000. For example, WyseVDAServerPort=3000, sets VDA server port to 3000 and the client will connect to the VDA server using this port. FontSmoothing — Default is yes. Set no to disable font smoothing. AutoConnect — Default is yes. Set no to disable auto connect function.
Table 10. Connection Settings: wnos.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) USBRedirection — Default is ICA|HDX. Option to select the channel of usb devices redirection. This option is recommended to replace the older setting device=vusb type={TCX, HDX}. ZLKeyboardMode — Specifies to accelerate the display of the input text on the client device over a high latency connection.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) MMRClientFetchDisabled — This option disables RAVE client content fetching. The default value is No. ClientName can specify the client name for ICA session, the default is terminal name. It can use system variable. For example, SessionConfig=ICA ClientName=$mac NOTE: The mac address includes a special character ':'. This may cause the following issue.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) [Animation={yes, no}] [Theme={yes, no}] [TosIpPrecedence={0-5}] [TosDscp={Default/CS1/CS2/CS3/CS4/ CS5/CS6/CS7/AF11/AF12/AF13/AF22/AF23/ AF31/AF32/AF33/AF42/AF43/EF}] [AutoDetectNetwork={yes, no}] [TSGWEnable={yes, no}] [GracefulReconnTimeout={10 - 100}] [ForceUpdatedNLA={yes, no}] [TsgwWebsock={yes, no}] NOTE: The EnableVOR parameter is not supported on C or V class. EnableRdpH264— Default is yes.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) SessionConfig=Blast [EnableH264={yes,no}] [NetworkCondition={ Excellent,Typical, Poor }] [EnableH264={yes,no}] —This parameter controls the Blast H264 feature on the supported platforms. The default value is yes. The value yes enables H264 and the value no disables H264. This works on Blast H.264 supported platforms only. NetworkCondition—This parameter controls the Blast network condition.
Table 10. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) Only this setting can enable the Virtual Center functions. **VNCPrompt={no, yes} Default is yes. [{Accept, Reject}={10 to 600} (seconds)] VNCPrompt — Yes/no option to enable a VNC shadowing prompt to a user.
Table 11.
Table 13. TOS priority settings IP precedence (3 bits) DSCP ( 6 b Name Useful Name Routine Try as usual NA Priority AF11 For data traffic Immediate NA Flash For Voice control data NA Flash Override Video streaming NA Critical Voice Data EF Internetwork Control NetworkControl NA Reserved NA NA NOTE: The information in this section is leveraged based on the research on web. Specific priority designs must be arranged by network architect.
A Connect Parameter: Options This appendix provides the supported options for the Connect parameter in the following supported connections: ● ICA Connect Options ● RDP Connect Options ICA connect options Table shown here contains the supported options used for ICA connections (after you use the Connect=ICA parameter/ selection).
Table 14. ICA connect: options (continued) 3 – Low Quality Autoconnect={0 to 99} Default is 0. Use for automatically starting a session after you sign in, if sign-on is enabled. The value of 0 – 99 is the delay in seconds before autostarting the session. AppendUsername=1 This enhancement allows user names to display in the title bar of an ICA session at the client side. Browserip=list of browsers List of IP addresses or DNS registered names to specify ICA browsers.
Table 14. ICA connect: options (continued) Connection security encryption level. The highest level is 128bit security (Login-128 option is 128 bit encryption for login only).The lowest is None. NOTE: The server must support the specified level of encryption or the connection will fail. Fullscreen={no, yes} Default is no. Yes/no option to run the session in full screen. If Fullscreen=no then the session runs in a windowed screen.
Table 14. ICA connect: options (continued) Maximum total of local entries is 16. Logon_mode={local-user, smartcard, user-specified} Default is local-user. Specifies how users authenticate to the selected application set or ICA connection. Lowband={no, yes} Default is no. Yes/no option to enable optimization for low speed connections such as reducing audio quality and/or decreasing protocol-specific cache size. Mapdisks={no, yes} Default is no.
Table 14. ICA connect: options (continued) into the {username}.ini file with encryption. This password is then checked against the sign-on password with encryption to determine whether sign-on is successful. Password-enc=an encrypted password Specifies an encrypted string as a password for a connection. Reconnect={no, yes, 1 to 3600 (seconds)} Default is no. Controls automatic reconnection to an application after a server disconnection.
Table 14. ICA connect: options (continued) Yes/no option to not auto-connect to local USB devices (Virtual USB) when the connection starts. Username=[username, $SYS_VAR] Username to log-in to the application server. Either a conventional login username or a variable can be used. Maximum of 31 characters are allowed. The value of username is a conventional login username. The value of $SYS_VAR is a system variable found in System variables.
Table 15. RDP connect options (continued) Use for automatically starting a session after sign-on, if signon is enabled. The value of 0-99 is the delay in seconds before auto-starting the session. Colors={256, 32k, 64k or high, 16m, true} Default is high. Session color mode. For faster display performance, use 256 colors for the session. ● 256 is 8-bits ● 32k is 15-bits ● 64k or high is 16-bits ● 16m is 24-bits ● true is 32-bits NOTE: ● 64k is the same value as high.
Table 15. RDP connect options (continued) Fullscreen={no, yes} Default is no. Yes/no option to run the session in full screen. If Fullscreen=no then the session runs in a windowed screen. NOTE: Fullscreen=Yes and DualHead=Yes will result in Span Mode when connecting to a Windows server 2003 or a Windows XP Pro Client. Fullscreen=Yes and DualHead=Yes will result in Extended mode when connecting to a Windows Server 2008 (any version) and to a Windows 8 or above desktop.
Table 15. RDP connect options (continued) Mapdisks={no, yes} Default is no. Yes/no option to auto-connect and map any connected USB flash drive upon connection start. NoReducer={no, yes} Default is no — Enables compression. Yes/no option to turn off compression. To turn off compression, enter yes. Used here is an option of the Connect statement. It sets the value of NoReducer only for this specified connection.
Table 15. RDP connect options (continued) Yes/no option to disable the Show content when dragging a window feature; use yes to disable the feature. Rdp_No_Fontsmoothing={no, yes} Default is no. Yes/no option to disable the Font smoothing feature; use yes to disable the feature. Rdp_No_Theme={no, yes} Default is no. Yes/no option to disable the Theme feature; use yes to disable the feature. Rdp_No_Wallpaper={no, yes} Default is no.
Table 15. RDP connect options (continued) TSGWUsername=[username] Specifies the TS Gateway Username for RDP session. TSGWUsername-enc=[encrypted-username] Specifies the encrypted TS Gateway Username for RDP session. TSGWUSESAMEINFO={no, yes} Default is no. Yes/no option to apply RDP connection credential to Gateway credential. UniSession={no, yes} Default is no. Yes/no option to use a unisession—a connection will launch only once at a time. UnmapClipboard={no, yes} Default is no.
B TimeZone Parameter: Values Using the TimeZone parameter, Table “TimeZone Parameter: Values” contains the zone value options that can be used. For Example: TimeZone="GMT - 08:00" ManualOverride=Yes Daylight=Yes \ Start=030207 End=110107 TimeZoneName=Pacific \ DaylightName=Pacific Remember to use quotation marks (" ") since the option includes spaces. The example above uses the " \" to break a single continuous line into multiple likes for easier reading with no" \" on the last line of the parameter.
Table 16.
Table 16. TimeZone Parameter: Values (continued) Geographic Time Zones Time Zones Name (GMT) Monrovia, Reykjavik Greenwich (GMT+01:00) Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna W. Europe (GMT+01:00) Belgrade, Bratislava, Budapest, Ljubljana, Prague Central Europe (GMT+01:00) Brussels, Copenhagen, Madrid, Paris Romance (GMT+01:00) Sarajevo, Skopje, Warsaw, Zagreb Central European (GMT+01:00) West Central Africa W.
Table 16.
Table 16. TimeZone Parameter: Values (continued) Geographic Time Zones Time Zones Name (GMT+10:00) Canberra, Melbourne, Sydney AUS Eastern (GMT+10:00) Guam, Port Moresby West Pacific (GMT+10:00) Hobart Tasmania (GMT+10:00) Magadan Magadan (GMT+10:00) Vladivostok, Magadan (RTZ 9) Russia TZ 9 (GMT+11:00) Chokurdakh (RTZ 10) Russia TZ 10 (GMT+11:00) Solomon Is.
C Best Practices: Troubleshooting and Deployment Examples This appendix contains the following best practices information: ● Troubleshooting INI Files ● Examples: Basic Deployments Troubleshooting INI Files General recommendations when encountering INI parameter usage problems and errors include: ● Check for spelling and format mistakes. ● Use the following process: 1. Restart the thin client. 2. Check thin client system information: for example, the Event log. 3.
VMware View Broker Deployment Autoload=1 ConnectionBroker=VMware VDIBroker=https://ViewServerAddress TimeServer=IPAddress TimeFormat="12-hour format" DateFormat=mm/dd/yyyy TimeZone='GMT - 05:00' ManualOverride=No Daylight=Yes Start=030207 End=110107 TimeZoneName=Eastern DaylightName=Eastern Microsoft Terminal Services/Remote Desktop Service Deployment Autoload=1 Signon=no Seamless=yes Connect=RDP \ Host=IP or Name of MS RDS server \ Description="Description" \ Username=Username \ Domainname=Domain \ Passwor