Dell Wyse ThinOS Version 8.5 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. © 2017-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................................................................................................................. 6 About this Guide..................................................................................................................................................................
Summary of revisions The following changes and enhancements have been made to this document since Dell Wyse ThinOS release 8.4.1. ThinOS 8.5 release is intended for platforms with Dell standard BIOS—Wyse 3040 thin client with ThinOS, and Wyse 3040 thin client with PCoIP. Table 1. Newly added INI parameters Reference Description Device=audio New parameters added in Peripheral settings for wnos.ini files, $MAC INI,.
Table 1. Newly added INI parameters (continued) Reference Description [SFIconSortMode={0, 1, 2, 3}] SessionConfig=ICA [DisableReceiverLogo={Yes, No}] [MMRClientFetchDisabled={Yes, No}] [ClientName=_client_name_] VPN=openconnect [Username-enc=encrypted_username_string] [Password-enc=encrypted_password_string] Folder=[folder] DomainList=List of NT domain names [disable={yes/no}] New parameters added in Connection settings for wnos.ini files only.
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 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.
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 4. General Settings: wnos.ini files only (continued) 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. 202 — Enables firmware upgrade only, but displays a window with OK button before the process; displays a status complete window.
Table 4. General Settings: wnos.ini files only (continued) Device=cmos AutoPower=(yes, no) Yes/no option on how the system starts when the power is first applied to the thin client. If set to yes, then the system starts itself without waiting for users to press the power button. 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) 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) [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. There is no minimum length.
Table 4. General Settings: wnos.ini files only (continued) 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. This enables the cache all server files such as INI files, wallpaper, bitmap, font, local messages and so on to the local flash when files are changed in the file server.
Table 4. General Settings: wnos.ini files only (continued) 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. TimeZoneName — Display name sent to the ICA/RDP session such as Eastern Standard Time. DayLightName — Display name for daylight saving time.
Table 5. Peripheral Settings: wnos.ini files only (continued) Parameter Description (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. When DEVICE_SECURITY=black_list is set, the security is mid-level, and customer can add the device which is not present in the list. 3.
Table 6. Connection Settings: wnos.ini files only (continued) 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. The certificates are used to validate server identities by the thin client. Supported files include .crt file on ICA CSG; .cer and .pfx in 802.1x.
Table 6. Connection Settings: wnos.ini files only (continued) [DisableShowDisclaimer=[yes, no] [DisableShowServer=[yes,no] SecurityMode — SecurityMode specifies the security mode for the VMware broker and Amazon Workspace (AWS) broker. It is only valid in case of ConnectionBroker=VMware or ConnectionBroker=AWS. The details is as follows: ● Set SecurityMode=Full to have the Client verify the server's certificate in highest security mode; if any relevant checks error, it will fail to connect to the server.
Table 6. Connection Settings: wnos.ini files only (continued) desktops are displayed. To get your RemoteApp or desktops collection name, do the following: 1. In RDS Server local, go to C:\Users\administrator.RDSS\AppData\Roamin g\Microsoft\Workspaces\{xxxx}\Resource, and check that all your published collection (.rdp file) are listed. 2. Open the specify .rdp file which you want to define in .ini file with notepad and get the collection name from line "loadbalanceinfo:s:tsv://MS Terminal Services Plugin.1.
Table 6. Connection Settings: wnos.ini files only (continued) [PnliteServer={128 to 254}] [DomainList={128 to 254}] [VDIBroker-{248 to 254}] [RapportSecurePort={128-254}] [Discover={yes, no}] [WDMSecurePort={128 to 254}] [WDMFQDN={128-254}] [CCMGroupKey={128-254}] [CCMServer={128-254}] [CCMMQTTServer={128-254}] [CCMCAValidation={128-254}] If you set different value for DisableOption12 from the value in NVRAM, the system will automatically reboot to make the value valid.
Table 6. Connection Settings: wnos.ini files only (continued) If Combined=yes, then the DNS server will combine the DNS server configured by DHCP and the static one. DNS domain will use the value configured by DHCP if static DNS domain is empty. DNSTTL={0-3600} Specifies the Time to Live (TTL) of DNS name caching; the default is from DNS server settings. NOTE: If DNSTTL=0, the DNS hostname in a connection always queries the DNS server to get the IP.
Table 6. Connection Settings: wnos.ini files only (continued) Taskbar — Default is wholescreen. Sets which style is used for the taskbar: wholescreen places the taskbar at the bottom of the entire screen; mainscreen places it at the bottom of the main screen. This is only when SysMode=Classic and has no effect on VDI mode. MonitorAutoDetect — Determines whether or not the system will detect how many monitors are connected. If only one monitor is connected, Span mode will be transferred to Mirror mode.
Table 6. Connection Settings: wnos.ini files only (continued) The optional keyword Username and Password specify the username/password of the file server. When the client fetches the WNOS.INI file from a HTTPS server, ThinOS supports different security modes. The default follows SecurityPolicy and may be one of the three modes. The option SecurityMode specifies these security modes. SecurityMode — Specifies the security level for the file server during client verification of the server certificate.
Table 6. Connection Settings: wnos.ini files only (continued) If set to full, the SSL connection needs to verify server certificate. If it is untrusted, then drop the connection. If set to warning, the SSL connection needs to verify server certificate. If it is untrusted, you may still continue or drop the connection. If set to low, the server certificate will not be checked. The value will be persistent, and the default value of the setting is default.
Table 6. Connection Settings: wnos.ini files only (continued) MMRConfig={VIDEO} [flashingHW={0, 1}] Multifarm={no, yes} This parameter specifies whether to show the “HW” label at the top left corner of video or not when HDX is hardware decoded. The default value is 0. Set flashingHW to 0, if you want to hide HW. Set flashingHW to 1, if you want to show HW. Default is no. Yes/no option to support Citrix multifarm functionality for the wnos.ini files.
Table 6. Connection Settings: wnos.ini files only (continued) Title and ButtonCaption — Specifies the notification window title and button that can be customized.
Table 6. Connection Settings: wnos.ini files only (continued) SecurityMode specifies the SSL certification validation policy. If set to default, it applies SecurityPolicy setting. If set to full, the SSL connection needs to verify server certificate. If it is untrusted, drop the connection. If set to warning, the SSL connection needs to verify server certificate. If it is untrusted, it is up to you to continue or drop the connection. If set to low, the server certificate is not checked.
Table 6. Connection Settings: wnos.ini files only (continued) For example: If you re-name the Wyse 3010 thin client with ThinOS (T10) firmware file from DOVE_boot to DOVE_boot_8.0_037., then you must use platformconfig-="T Class", then add Firmware=DOVE_boot_8.0_037. ThinOS will look on the file server for this exact firmware name. If that defined firmware name is not found, then ThinOS will fall back to the default logic and look for the DOVE_boot firmware.
Table 6. Connection Settings: wnos.ini files only (continued) [DHCPinform={yes, no}] [Discover={yes, no}] If RapportDisable=no, the Rapport agent is enabled and you can discover the WDM server by the following ways: 1. The DHCP option tag values received from standard or WDM proxy DHCP service for vendor class RTIAgent 2. DNS service location record "_wdmserver._tcp" [SecurityMode={default, full, warning, low}] 3.
Table 6. Connection Settings: wnos.ini files only (continued) For example, If you set Reboot=yes time=20:30, the unit reboots on local time 20:30. If you set Reboot=yes time=20:30-4:30, the unit reboots on random time through 20:30 to 4:30. If you set Reboot=yes time=23:00 Wday=Friday,Monday, the unit reboots on local time 23:00 of Friday and Monday. If you set Reboot=yes time=1:00 Idle=10, the unit reboots on 1:00, if there are no sessions.
Table 6. Connection Settings: wnos.ini files only (continued) CACertHash—This is the hash value used to verify certificate authority's certificate. Client will not issue a certificate request to a SCEP server and cannot pass certificate chain checking through a valid certificate authority. EnrollPwd or EnrollPwdEnc—These keywords are used to set the enrollment password from a SCEP administrator.
Table 6. Connection Settings: wnos.ini files only (continued) VDI example: ConnectionBroker=VDM SelectServerList=VDI; Default=test5 description = test4; host = 192.168.0.11; description = test5; host = host2.wyse.com The Default option following "SelectServerList={PNA, VDI}" can specify the default server. The value is one of server description defined after that. After one selects another server and sign off, this default server is selected.
Table 6. Connection Settings: wnos.ini files only (continued) Service=wdm disable={no, yes} Default is no. Yes/no option to disable the WDM service, same as RapportDisable={no, yes}. Service= disable={no, yes} Default is no. Yes/no option to disable the service with this port number. The 80 port is an exception because the WDM is always started before loading the global profile (wnos.ini file).
Table 6. Connection Settings: wnos.
Table 6. Connection Settings: wnos.ini files only (continued) > Lock Terminal. It also disables lock terminal even if set ScreenSaver=minutes; LockTerminal=yes. ExpireTime — Specifies the signon expiration time. The range is 0 to 480 minutes. The default is 0 which means no expiration. If the value is larger than 480, then 480 is set instead. If the value is smaller than 0, then 0 is set instead. After system signon or starting a connection, the expiration time starts counting.
Table 6. Connection Settings: wnos.ini files only (continued) SFZeroButtons—The option keyword SFZeroButtons. if set to yes, displays the buttons (shutdown, login and so on) at the bottom of signon window, such as Zero mode when set StoreFront style. SignonStatusColor—The option specifies the signon status text color in RGB string format (must be enclosed in quotes), where rrr, ggg, and bbb are decimal numbers in the range of 0 to 255. By default, the status text color is gray for ThinOS.
Table 6. Connection Settings: wnos.ini files only (continued) toolbar_no_minimizeall — Default is no. Yes/no option to hide the Home button thus affecting the ability to minimize displayed list of connections. toolbardisablehotkey — Default is no. Yes/no option to disable the CTR+ALT+UP ARROW keyboard shortcut that allows the toolbar to instantly display without a timer. ToolbarEnableOneSession — Default is no. Yes/no option to enable the toolbar when only one session is available.
Table 6. Connection Settings: wnos.ini files only (continued) WarnUnlinkDisabled={yes, no} Default is no. Yes/no option to disable the pop-up warning message when a network has no link for an ICA/ RDP session. WDAService=yes WDA Service always runs in the background. [Priority ={WDM, CCM, “WDM;CCM”, “CCM;WDM”}] Priority—If priority is available, WDA discovers the protocol according to it.
Table 6. Connection Settings: wnos.ini files only (continued) If QuickMode=yes is specified, rapport agent will not block any other process during ThinOS boot up, and boot time of ThinOS will speed up. NOTE: If file server is changed by WDM server, device will reboot automatically to make sure all settings from WDM server take effect. Default is yes. Discover— If Discover=yes is specified, rapport discovers the WDM server information from the DHCP option tag, DNS service location record and DNS host name.
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.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) 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. 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) [BootOrder={PXE, HardDisk, USB}] $PF - Is the name of the platform, including C10, C00, R10, R00, and VL10. [WakeOnLan={yes, no}] $VER - Is the version of the BIOS, such as 1.0B_SPC001(1.0B_SPC001-0407), 1.0B-0407(Zilch), 1.0H_SPC-0T51(R10, R00), 1.19R(VL10).
Table 7. General Settings: wnos.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) No/Disable—The system does not automatically power up; Yes/Daily— The system power ups every day at the time specified in AutoPowerTime; Work day— The system power ups Monday through Friday at the time specified in AutoPow erTime; Days—The system power ups on the days specified in AutoPowerDays; AutoPowerTime—This option specifies the auto power on time, value range of hh is 0 to 23, while mm is 0 to 59.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) NOTE: USB, keyboard, and mouse always work regardless of being specified or not. PXEBootSupport—If yes is specified, device allows operating system to boot from PXE. If no is specified, the operating system cannot boot device from PXE For extract action, CMOS content is saved to file $PF_cmos.$VER $PF—name of Dell BIOS platform, including X10 and A10Q $VER—version of BIOS, like 1.2.2.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) If the FactoryDefault parameter value is changed to yes, the thin client will reboot without notice to the user. *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 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) 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 7. General Settings: wnos.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) Locale= [load={yes | no}] Locale — Specifies the system language. Locale changes the language for the user logon-experience screens only displayed during boot-up and logon and not the configuration or administrator screens. Values include: English, us, French, fr, German, de, Chinese Simplified, gb, Chinese Traditional, b5, Japanese, jp, Korean, ko, Latin, la.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) ** PRIVILEGE=[None, Low, High] Default is high. [LockDown= {no, yes}] Privilege controls operator privileges and access to thin client resources. See also CCMEnable={yes, no}.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) HideConnectionManager=no; however, the user cannot create a new connection or edit an existing connection. EnableNetworkTest — Default is no. Yes/no option to enable the Network Test. EnableTrace — Default is no. Yes/no option to enable trace functionality. The active items are added to the desktop right-click menu in Privilege=Highlevel. ShowDisplaySettings — Default is no.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) right-click the time label in taskbar, nothing is displayed. The Change Date and Time button in System Preference will be invisible. EnableVPNManager—If the optional EnableVPNManager=yes is set with Privilege={none, low}, the VPN Manager setup is enabled. TrapReboot— If the optional TrapReboot=yes is set, client reboots after the execution of the trap.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) [VideoSpan=no] 3- 3 Minutes [Unit=hour] 5 — 5 Minutes [Image=imagefile] 10 — 10 Minutes [PictureTimer={2-60}] 15 — 15 Minutes [PictureOrder=random] 30 — 30 Minutes [PictureCheck=always] The default screen saver value is 10 minutes and the maximization value is 30 minutes.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) If SelectGroup=yes, then the pictures residing in the picture subfolder under the group folder are displayed. For example, /wnos/ini/{group_dir}/picture If group pictures do not exist, global pictures are used. Supported formats include JPG, GIF, PNG and BMP. PictureTimer — Specifies the interval to wait in seconds to display another picture. Default value is 6 seconds.
Table 7. General Settings: wnos.ini files, {username} INI, and $MAC INI Files (continued) GetBiosDT — Default is no. Yes/no option to obtain time from BIOS/CMOS when the timeserver is not available or cannot be contacted. For Example: TimeServer=time.nist.com\TimeFormat=24-hour formatDateFormat=mm/dd/yyyy or TimeServer=time.nist.gov\ TimeFormat=24-hour format\ DateFormat=mm/dd/yyyy WakeOnLAN={yes, no} Default is yes. Wake-on-LAN allows a thin client to be turned on or woken up by a network message.
Table 8. Peripheral Settings for wnos.ini Files, {username} INI, and $MAC INI files (continued) [mic_gain={1~8}] [DPaudio=yes,no] [local_button=yes, no] mic_vol — Default is medium. Option to set volume levels to high, middle or low. high — maximum volume middle — medium volume low — minimum volume Values of 0-25 provide more exact volume level. mic_mute — Default is no. no — no mute yes — mutes audio mic_ boost — This option increases the mic decibels. min_cache — Default is 1.
Table 8. Peripheral Settings for wnos.ini Files, {username} INI, and $MAC INI files (continued) [width={camera supported width}] [height={camera supported height}] [fps={camera supported fps}] [samplerate={0, 1, 2, 3, 4, 5}] [optimize={no, yes}] [Disable={yes, no}] format — Support only for raw video type; format=raw is fixed. width — The width of the resolution that the local camera supports. height — The height of the resolution that the local camera supports.
Table 8. Peripheral Settings for wnos.ini Files, {username} INI, and $MAC INI files (continued) 4 — 3/4 5—1 6—2 7 — No Repeat NOTE: These settings in a wnos.ini file will be saved into NVRAM if EnableLocal=yes is set in the wnos.ini file. Device=Rfideas Device=Rfideas — Specifies the local Rfideas readers. [DisableBeep={yes, no}] DisableBeep — Default is yes. Option disables the beep sound when the card is read.
Table 8. Peripheral Settings for wnos.ini Files, {username} INI, and $MAC INI files (continued) MouseDisable — Default is no. Yes/no option to disabled mouse pointer so that it is shown on the screen. The pointer is enabled if any mouse activity occurs. LpdSpool={0-50} Specifies the size of spool to buffer all the data before sending them to the LPD printer. The range of value is 0 to 10, that is, 0 MB to 10 MB. If the specified value is above the range, then the value is set to 5.
Table 8. Peripheral Settings for wnos.ini Files, {username} INI, and $MAC INI files (continued) ThinPrint server side. The strings PCL5, PS, and TXT are predefined classes. Class can be a string with 7 characters. Enabled — Default is yes. Yes/no option to enable the printer. EnableLPD — Default is no. Yes/no option to enable the LPD service. NOTE: The parameters must be specified in the order shown. Printer={LPD1, LPD2, LPD3, LPD4, LPD5-LPD36} Default is LPD1.
Table 8. Peripheral Settings for wnos.ini Files, {username} INI, and $MAC INI files (continued) EnableLPD — Default is no. Yes/no option to enable the LPD printer. Username — Specifies the username of a user who can use the SMB printer. Password — Specifies the password of a user who can use the SMB printer. Domain — Specifies the domain name of the SMB printer. **RepeatDelay={0, 1, 2, 3, 4, 5, 6, 7} Default is 2. Specifies the keyboard delay before repeat in seconds.
Table 8. Peripheral Settings for wnos.ini Files, {username} INI, and $MAC INI files (continued) Due to processing power requirements, rotate is not recommended and supported on the C class platforms at this time. NOTE: 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) **AutoSignoff={no, yes} Default is no. [Shutdown={no, yes}] AutoSignoff —Yes/no option to automatically sign-off a user when the last opened session is closed. [Reboot={no, yes}] Shutdown — Default is no. Yes/no option to shut down the thin client. If shutdown is set to yes, the ShutdownCounter value is used to control the count-down before the system is turned off. Reboot — Default is no.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) WirelessWaitEnet—This option specifies the wait period before the wireless initializes in case of Enet Up. The default value is 5. Device=vusb [ForceRedirect=DeviceID] [ForceLocal=DeviceID] [Type={TCX, HDX}] [InterfaceRedirect={no, yes}] 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.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) authentication will be selected. If set to ShareKey, shared key authentication will be selected. DisableBand — Default is None. Use to disable 2.4G or 5G 802.11 band. PreferBand —This parameter is used to set the priority of wireless connection band, and select the 2.4G or 5G access point to connect. Default is None. Priority — sets the priority of wireless profiles.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) EthernetSpeed — Specifies the Ethernet Speed to either Auto, 10M HD, 10M FD, 100M HD, or 100M FD. Once specified, it is saved in the non-volatile memory. This parameter can be replaced by the Device and Speed parameters. 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) 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. If the value is set to Signoff, pressing the F12 (default) or the key defined in FastDisconnectKey= statement will disconnect all sessions and return to the signon window.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) IEEE8021X={yes, no} network={wired, wireless} [Profile=ssid] [access={WPA-PSK, WPA2-PSK, WPA-ENT, WPA2-ENT}] [eap={yes, no}] [servervalidate={yes, no}] 1. If IEEE8021X is set to no, then all parameters following it is ignored. 2. If network is not configured, the configuration is ignored. 3.
Table 9. Connection Settings: wnos.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) DisableEcho — If DisableEcho=yes, the system will not reflect the ICMP echo (8) request. In this case, the unit cannot be pinged. **LowBand={no, yes} Default is no. Yes/no option to enable optimization for low speed connections, such as reducing audio quality or decreasing protocol-specific cache size or both. 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.ini files, {username} INI, and $MAC INI files (continued) By default both the ICA and RDP protocols compress their data to minimize the amount of data that needs to traverse the network. This compression can be as much as 50 percent for textbased applications such as Microsoft Word and 40 percent less for graphics applications than the uncompressed data streams.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) [ReconnectFromButton={0, 1, 2}] [AutoConnectList={*/ appname1;appname2; appname3...}] [Timeout=5…300] [CAGRSAAuthMethod={LDAP, RSA}] [CAGAuthMethod={LDAP, RSA, LDAP+RSA, RSA+LDAP}] [RequestIconDataCount={0-65535}] [DefaultSettings={XenApp, XenDesktop}] Each entry with optional port is specified as Name-or-IP:port, where port is optional; if not specified, port 80 is used as the default.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) NOTE: This option replaces CAGRSAAuthMethod. If CAGAuthMethod=RSA which is same as the prior CAGRSAAuthMethod=RSASecurid, an extra passcode field needs to be input except username/password/ domain. If CAGAuthMethod=LDAP, no passcode field is needed. ● CAGAuthMethod={LDAP+RSA, RSA+LDAP} — Used for CAG authentication configuration.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) SmartcardPassthrough — Default is yes. Yes/no option to enable/disable the smartcard pass through mode. StoreFront — Default is no. Yes/no option to support Citrix StoreFront Authentication. The value will be saved into NVRAM. HttpUserAgent—The option will replace the default “CitrixReceiver WTOS/1.0” during Netscaler login. If you are using “WTOS/1.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) 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. Yes/no option to set the default resolution for ICA published applications to Seamless for ICA connection parameters. HideTaskbar — Default is 0.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) [groupname=name2] groupname — The group name is used to identify the group including the directory and file name. If not defined, the description will become the group name. The Default option following "SelectGroup=yes" can specify the default group. The value is one of group description defined after that. After you select another group and sign off, this default group will be selected.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) **SessionConfig=ALL [unmapprinters={no, yes}] [unmapserials={no, yes}] [smartcards={no, yes}] [mapdisks={no, yes}] [disablesound={no, yes, 2}] [unmapusb={no, yes}] [DisksReadOnly={no, yes}] SessionConfig — Specifies the default settings of the optional connection parameters for all sessions. unmapprinters — Default is no. Yes/no option to un-map printers. unmapserials — Default is no.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) Resolution — Default is default. Specifies the session resolution. For example, 640 x 480 and other supported resolutions. Default will set the resolution to the native resolution of the monitor. Setting the resolution to a value smaller than the native resolution of the monitor, will allow the session in Windowed mode. The resolution value cannot be higher than the native resolution. DisableResetVM — Default is no.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) [TosDscp={Default/CS1/CS2/CS3/CS4/CS5/CS6/CS7/ mapdisksunderz — DISCONTINUED. DO NOT USE. AF11/AF12/AF13/AF22/AF23/AF31/AF32/AF33/AF42/AF43/ TosIpPrecedence — Allows you to set IP Precedence in the EF}] TOS fields. [DiskMapTo=a character sequence] TosDscp — Sets IP DSCP in the TOS fields. [SysMenu={remote, local}] DiskMapTo — Specifies to map disks to a character [SessionReliability={no, yes}] sequence.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) AudioQuality — Default is default. Specifies the audio quality of ICA sessions. NOTE: Medium quality is recommended for Speech scenarios. For example: SessionConfig=ICA AudioQuality=high 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}.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) RefreshPopupNotice — This option enables or disables the popup notice during refresh in progress. The default value is yes. DisableReceiverLogo—Hides the CitrixReceiver logo in left top corner in storefront style. The default value is No. MMRClientFetchDisabled — This option disables RAVE client content fetching. The default value is No.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) [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}] NOTE: The EnableVOR parameter is not supported on C or V class. EnableRdpH264— Default is yes. This option enables RDP8.1 h.264 graphics feature.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) VDIBroker=vdi_broker_url [AutoConnectList={*|host1;host2;host3…}] VDIBroker — Specifies the VDI broker server; supports both http and https. If the vdi_broker_url does not start with http or https, the default protocol used is http. For an https connection, only one URL is accepted.
Table 9. Connection Settings: wnos.ini files, {username} INI, and $MAC INI files (continued) [Autoconnect={yes, no}] Server— Specifies the VPN server IP or the VPN server name. The length of the string is limited to 63 characters. [Username-enc=encrypted_username_string] Username— Specifies the login username. The length of the string is limited to 31 characters. [Password-enc=encrypted_password_string] Folder=[folder] Password— Specifies the login password.
Table 11. TOS priority settings (continued) 3.High Immediate 2 10 AF 2 1.Low 2.Medium 3.High Flash 3 11 AF 3 1.Low 2.Medium 3.High Flash Override 4 100 AF 4 1.Low 2.Medium 3.High Critical 5 101 EF NA NA Internetwork Control 6 110 NA NA NA Network Control 111 NA NA NA 7 Table 12.
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) 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) 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 13. 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 13. 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 13. 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 14. 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 14. 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 14. 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 14. 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 14. 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 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