Dell Wyse ThinOS Version 8.5 Hotfix 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 from Dell Wyse ThinOS release 8.5 Hotfix. Table 1. Newly added INI parameters Reference Description ● PnliteServer=List of {IP address, DNS names or URLs} 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. Continue Lines by using a Space and Backslash Placing a space and backslash ( \) at the end of a line indicates line continuation; that is, the backslash means that the line and the following line are, for the purposes of reading code, the same line. No white space can appear after the backslash; the requirement of white space between parameter entries is maintained by the use of the space before the backslash.
Table 2. 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. $DN Sign-on domain name used. $FIP IP address used in fixed format with 3 digits between separators, for example, 010.020.030.040.
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. This list describes the folder structure, starting with the root directory. Table 3. Folder structure Folder structure Description /wyse/ (Required) The root directory. It stores the wnos folder. /wyse/wnos (Required) The main INI configuration folder. It stores the wnos.ini file, {username}.ini file, $MAC.
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 4. 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 4. 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 4. 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 4. 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 4. 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 4. 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 5. 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 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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. The option Username-Enc specifies AES encrypted username of the file server. The option Password-Enc specifies AES encrypted password of the file server. Use Windows Password_Gen tool to generate the encrypted string.
Table 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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 6. 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 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files Parameter Description AdminMode={no, yes} AdminMode —Default is no. Yes/no option to use the username and the password to obtain a high thin client configuration when the privilege parameter level is set to high (Privilege=high).
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description BootpDisable — Yes/no option to disable BOOTP requests. ThinOS supports both DHCP and BOOTP to obtain the network configurations. In the first two attempts, only DHCP is requested. Then, both DHCP and BOOTP are requested. For some environments, BOOTP requests will delay obtaining the IP from the DHCP server. Set BootpDisable=yes will only perform a DHCP request.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description IconTextColor — Specifies the icon text color in RGB string format that must be enclosed in quotes, where rrr, ggg and bbb are decimal numbers in the range of 0 to 255. Device=DellCmos These INI parameters are applicable to thin clients with Dell standard BIOS.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description and available for Operating system. If no is specified, Operating System cannot detect any devices attached to the rear USB port. USB keyboard and mouse always work in the BIOS setup irrespective of this set ting. USBFrontPort— If yes is specified, devices attached to the front USB port are enabled and avail able for Operating ystem.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description For usage of this feature, there should be a special INI user name like "cmos". The associated ini/cmos.ini should include one line as "Device=DellCmos Action=extract" (Pleaset note: "Device=DellCmos Action=extract" is not suggested to be written in global INI file, like wnos.ini, and it will take no effect if it has been written in global INI file).
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description Ctrl+Alt+Left — Default is yes. Yes/no option to enable Ctrl+Alt+Left Arrow to lock the thin client if the user is logged in with a password. If the user is logged in without a password, this key sequence does not work. Ctrl+Alt+Right — Default is yes. Yes/no option to enable Ctrl+Alt+Right Arrow to lock the thin client if the user is logged in with a password.
Table 7. General Settings: wnos.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description Romanian — Ro Russian — Ru Slovakian — Slovak Slovakian (Qwerty) — sk_q Slovenian — Sloven Spanish — Es Spanish (Mexican) English — La(us) Spanish (Mexican) Localized — La Swedish — Se Turkish — Turk Turkish (QWERTY) — turk_q U.S. International — us_int NOTE: Japanese refers to Japanese Input system (MS-IME2000), not JP.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description For Chinese Simplified, Chinese Traditional, Japanese, and Korean localization, a font file must also be placed under the folder wnos/font in the file server. For example, if you want to specify the system language to be Japanese, you must place a file named Japanese.msg under the folder wnos/locale in the file server, place a file named Japanese.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter [CoreDump={ide, disabled] [EnableNetworkSetup={yes, no}] [DisableNetworkOptions={yes, no}] [EnableSystemPreferences={yes, no, TerminalNameOnly}] Description If None or Low is used, the Network Setup dialog box is disabled. If it is necessary to access this dialog box and the setting None or Low is not saved into NVRAM, remove the network connector and reboot. LockDown — Default isno.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description When using this parameter in a wnos.ini file, it will be saved to NVRAM if EnableLocal is set to yes in the wnos.ini file. EnablePrinterSettings — Default isno. Yes/no option to enable printer configurations when a user Privilege=None. CoreDump — The option CoreDump=disabled will disable the core dump function. EnableNetworkSetup — This option is used to enable and disable the network setup.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description After no mouse and keyboard input in 1 minute, the system will pop up a counter down window to shut down in 30 seconds. You can cancel it. EnablePeripherals—If the optional EnablePeripherals is set with Privilege=none, the specified peripherals tab will be enabled. The value of the option can be a list of any valid value separated with "," or ";".
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description 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 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description 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. VideoLink — Specifies the video link address of the video file. Links with only http are supported. The mp4 video format is supported. VideoSpan — Specifies the video displayed mode in the screen.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Parameter Description S10WDMFlash=flash size Specifies the flash size. This value will be saved into NVRAM and then eported to the WDM server. NOTE: This statement guarantees that all S10 thin clients function with DDC regardless of flash size.
Table 8. Peripheral Settings for 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 Device=audio Specifies the local thin client audio volume. volume={low, middle, high} or {0 to 25} volume — Default is middle. Specifies the volume level.
Table 8. Peripheral Settings for 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 2560x1080, 2560x1440 (U2718Q, UP3216Q) however not limited. User needs to disable DP audio using INI or GUI. This setting only works for terminals with DP audio support (A10Q, D10Q, and U10).
Table 8. Peripheral Settings for 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 optimize=no then the individual settings in width, height, and fps will be used as long as the camera supports them. Disable— When you specify Disable=yes, the device is disabled.
Table 8. Peripheral Settings for 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 set to yes, then the Configuration #1 initializes to HID Prox 608x compatibility and Configuration #2 initializes to RDR-758x Equivalent. ● If set to no, then the card type remains unchanged. DisableInitialization — Default is no. Option disables configurations to the card reader.
Table 8. Peripheral Settings for 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 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.
Table 8. Peripheral Settings for 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 [LocalName=name] Printer — Specifies the LPD printer to configure. [Host= host] LocalName — Specifies the name of the printer. If LocalName is not specified, the Queue name is used.
Table 8. Peripheral Settings for 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 **RepeatDelay={0, 1, 2, 3, 4, 5, 6, 7} Default is 2. Specifies the keyboard delay before repeat in seconds. 0 — 1/5 1 — 1/4 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.
Table 8. Peripheral Settings for 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 The Screen parameter must be placed before the Resolution parameter. For example: screen=1 resolution=1280x1024 refresh=60 rotate=none *Screen={1, 2} Default is 1. Screen — Specifies the monitor for the Resolution parameter.
Table 9. Connection 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 [Shutdown={no, yes}] [Reboot={no, yes}] AutoSignoff —This option can be used to automatically signoff a user when the last opened session is closed. The default value is no. A value ranging from 2 to 60 can be configured.
Table 9. Connection 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 NOTE: The default 0 turns off this parameter and allows the system to wait the system default 120 seconds. If the Speed parameter value is changed, the thin client requires a reboot. WirelessWaitEnet—This option specifies the wait period before the wireless initializes in case of Enet Up.
Table 9. Connection 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 Device=Wireless [Mode={Infrastructure, AdHoc}] [SSID=ssid Channel={1-14}] [WepKey={None, 1-4}] [Key1=k1] Device — Defines the wireless Ethernet device remotely and saves to the local NVRAM. Not all options are needed.
Table 9. Connection Settings: wnos.
Table 9. Connection 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 NOTE: If the EthernetSpeed parameter value is changed, the thin client will require a reboot.
Table 9. Connection 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 PCoIP session, press Ctrl+Alt+F12 key combination to disconnect the session unless FastDisconnect=no is configured. This combined disconnect key is compatible with other platforms such as P25 and Linux.
Table 9. Connection 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 property. The method of browsing selected must match the method provided by the server(s) being accessed. This setting in a wnos.ini file will be saved into NVRAM, if EnableLocal=yes is set in the wnos.ini file.
Table 9. Connection Settings: wnos.
Table 9. Connection 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 [NoSessionTimer=0-480] Specifies that if there is no keyboard or mouse use in the configured time in minutes, it will sign off or shutdown or reboot depending on AutoSignoff= … If NoSessionTimer is set, then when there is an active sessions, use this timer to replace the Inactive value.
Table 9. Connection 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 [disablewmv3={no, yes}] disablejpeg — Default is no. Yes/no option to disable the jpeg codec when playing video. disablewmv1 — Default is no. Yes/no option to disable the wmv1 codec when playing video. disablewmv2 — Default is no.
Table 9. Connection 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 EnableWindowAuthentication — Default is yes. Yes/no option to sign-on with the user’s Windows credentials to predefined broker if the OneSign sign-on fails. AutoAccess — Specifies the corresponding type of broker to automatically start.
Table 9. Connection 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 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.
Table 9. Connection 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 example, if set RequestIconDataCount=0, no icon data will be requested. If set RequestIconDataCount=5, only 5 icons are requested. DefaultSettings — Specifies the default settings for XenApp or XenDesktop. Xen App Default Settings: 1. SignOn=Yes 2.
Table 9. Connection 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 3—sorts in alphabetic with application first. IgnoreDefaultGateway—When the value is Yes, the default gateway of the selected store during Netscaler login is ignored. Always use pnliteserver to continue.
Table 9. Connection 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 The event log file yyy.txt is appended in every boot-up. If the file size is up to 4000 bytes, then the file is cleared and continues to save the log. **Seamless={no, yes} [HideTaskbar={0, 1, 2, 3}] [FullscreenReserved={no, yes}] Seamless — Default is no.
Table 9. Connection 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 description=group1 [groupname=name1] [description=group2] [groupname=name2] SelectGroup — Yes/no option to allow a user to select from a group list on the Log on dialog box during a log in. If yes, the description will display in the group list box.
Table 9. Connection 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 Touch_XYReverse — Default is no. Yes/no option to denote a reversal of the X and Y coordinates which are needed for some touch screens. Touch_type — Default is elo. Specifies the type of touchscreen being used. NOTE: Options must be specified in the order shown.
Table 9. Connection 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 devices are redirected to the server using TCX Virtual USB or ICA or RDP USB redirection. In addition, by default, these devices are set as local devices. NOTE: For example, if you want to use USB disks as a network disk, you can set SessionConfig=all mapdisks=yes VUSB_DISKS=no.
Table 9. Connection 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 the broker. The default value is 0 which retains the same behavior as before, and also disconnects the sessions. If you set a value, for example 30 seconds, broker sign-off waits for 30 seconds for all sessions to finish logoff, then, automatically session logs off.
Table 9. Connection 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 [DisableMMRSeek ={yes, no}] ondesktop— This option specifies the connections that are displayed on the desktop. It enhances ondesktop options for SessionConfig=ICA so that the VDI brokers can work with ondesktop options too.
Table 9. Connection 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 HDXFlashEnableServerSideContentFetching— Default is Disabled, which means the server side fetching content is not enabled. The value enabled is to enable this function. EnableRTME— This option controls the launch of RTME service. The default value is enabled.
Table 9. Connection 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 SessionConfig=PCoIP [USBRedirection={PCoIP, TCX}] [ShowDisconnectMessage={yes, no}] [ShowReconnectMessageTime=seconds] [ResumeTimeout=seconds] [DisableRTAV={yes, no}] SessionConfig — Specifies the PCoIP default settings of the optional connection parameters for all PCoIP sessions.
Table 9. Connection 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 [GracefulReconnTimeout={10 - 100}] [ForceUpdatedNLA={yes, no}] [TsgwWebsock={yes, no}] USBRedirection — Default is TCX . Option to select the channel of USB devices redirection. RDPScreenAlign4 — Default is no. RDPScreenAlign4=yes can force RDP session width to 4 pixels aligned.
Table 9. Connection 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 NetworkCondition—This parameter controls the Blast network condition. The default value is Typical. The following are the values and associated actions: Excellent—Network is very good. Typical—Network is normal. Poor—Network is bad. This parameter impacts the Blast to select UDP or TCP.
Table 9. Connection 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 **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.
IP precedence is older than DSCP. DSCP is compatible with IP Precedence. Table 10.
Table 12. 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 13. ICA connect: options (continued) Option Description 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 13. ICA connect: options (continued) Option Description Encryption={None, Basic, 40, 56, 128, Login-128} Default is Basic. 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.
Table 13. ICA connect: options (continued) Option Description The connection description of the Description option is used as the index key into the local connection table. If a match is found, then the entry is updated. Otherwise, a new entry is created. 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.
Table 13. ICA connect: options (continued) Option Description starts a line, so it can be distinguished from the thin client user sign-on password which does starts a line. NOTE: The Password option is not written into a {username}.ini file by a user. When the New Password check box is selected, the system writes the new, changed password 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.
Table 13. ICA connect: options (continued) Option Description Yes/no option to not auto-connect to local printers when the connection starts. UnmapSerials={no, yes} Default is no. Yes/no option to not auto-connect to local serials when the connection starts. UnmapUSB={no, yes} Default is no. 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.
no (Reconnect=no) contained in the wnos.ini file—so that others who sign in can use their own user profile assuming the administrator has not changed the default values in the wnos.ini file. RDP connect options Table 14. RDP connect options Option Description Autoconnect={0 to 99} Default is 0. 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.
Table 14. RDP connect options (continued) Option Description NOTE: Disablesound=2 only works in RDP sessions and indicates that the remote computer sound should be disabled at the remote computer. Domainname={domain name,$DN} Domain name to use in a Windows network. $DN specifies that the thin client sign-on domain name is used. Maximum of 19 characters are allowed. Fullscreen={no, yes} Default is no. Yes/no option to run the session in full screen.
Table 14. RDP connect options (continued) Option Description Maximum total of local entries is 16. Logon_mode=prompt Specifies one dialog box will pop up to allow a user to enter username, password, and domain before connecting to the RDP session. This can prevent the need to input credentials twice in some cases of server redirection (load balancing). Lowband={no, yes} Default is no.
Table 14. RDP connect options (continued) Option Description RDPAudioQualityMode RDPAudioRecord={no, yes} NOTE: DISCONTINUED. DO NOT USE. Default is no. Yes/no option to specify whether users can record audio to the server. This requires a Windows 7 Server. Rdp_No_Animation={no, yes} Default is no. Yes/no option to disable the Menu and Window animation feature; use yes to disable the feature. Rdp_No_Dragging={no, yes} Default is no.
Table 14. RDP connect options (continued) Option Description Yes/no option to use a smart card login server when the connection starts. TSGWDomainName=[domain] Specifies the TS Gateway Domain for RDP session. TSGWENABLE={no, yes} Default is no. Yes/no option to enable TS gateway. TSGWNAME=[hostname] Specifies the TS Gateway host address. TSGWPassword=[password] Specifies the TS Gateway Password for the RDP session.
Table 14. RDP connect options (continued) Option Description [WyseVDA={no, yes}] Default is no. Yes/no option to enable Wyse Virtual Desktop Accelerator for all RDP sessions.
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 15.
Table 15. 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 15.
Table 15. 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
