Dell Wyse ThinOS Version 8.6.
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 - 2019 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents 1 Introduction................................................................................................................................. 4 About this Guide.................................................................................................................................................................... 4 Supported platforms...........................................................................................................................................................
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.
at the left margin and placing at least one leading space or tab at the beginning of all (and only) continuation lines makes an INI file easier to read. NOTE: When you require string concatenation, you can use a backslash without a space before or after it to concatenate with the first set of characters from the previous line; for example the strings snow and ball may be concatenated to give snowball. 3. Blank Lines Make Files Easy to Read Using blank lines is recommended for making code easier to read. 4.
Option Value $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.ini. Using it along with the left/right modifier helps to define policy for subnet. For example, include=&Left($FIP,11).ini is specified to include file 010.020.030.ini for subnet 010.020.030.xxx.
Folder structure Description /wyse/wnos Required—The main INI configuration folder. It stores the wnos.ini file, {username}.ini file, $MAC.ini file, firmware, and the following optional folders: • • • • • • • bitmap folder cacerts folder font folder inc folder ini folder locale folder trouble_shoot folder /wyse/wnos/bitmap Optional—The folder where you can place custom images you plan to use.
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 section can only be used in a wnos.ini file; they cannot be used in a {username}.ini file.
Table 3. General Settings: wnos.ini files only Parameter Description AutoLoad={0, 1, 2, 101, 102, 201, 202} [LoadPkg={0, 1, 2}] AutoLoad— Default is 1. Specifies the firmware update mode. The following are the values and associated actions: [AddPkg={pkg1_name, pkg2_name, …}] 0 — Disables checking for image. [DelPkg={pkg1_name, pkg2_name, …}] 1— Enables forced firmware upgrade/downgrade process. This is the default value.
Parameter Description Continued from the previous table... UpgradeOrder—This option is a control mechanism to enable BIOS and firmware upgrade in a specific order. If parameter is set to no, the default order is set to upgrade ThinOS firmware first, and then the BIOS. For the parameter UpgradeOrder you can set a single entity to upgrade or a list in order, (support value—bios and wtos) Example: If AutoLoad=1 and UpgradeOrder=bios—Only the BIOS is upgraded.
Parameter Description WMSEnable={yes, no} WMSEnable — This parameter allows you to enable or disable the Wyse Management Suite Agent. Default is no [Server=server_address[:port] [GroupPrefix=] [GroupKey=] [MQTTServer=[:]] [AdvancedConfig={no, yes}] [Default={no, yes}] [Override={no, yes}] [CAValidation=(yes, no)] [Discover=(yes, no)] [IgnoreMqtt=(yes, no)] Server — Specifies an IP address or URL address for the Wyse Management Suite server.
Parameter Description Continued from the previous table... NOTE: The Groupkey assigned in DCHP option #199 and INI parameter are only used for first time deployment, that is, they only take effect if Wyse Management Suite is currently disabled or if Wyse Management Suite is enabled but group-key is NULL.
Parameter Description Password= Password— Specifies the password as the sign-on password. There is no minimum length. The maximum length is 64 characters. [disable={yes/no}] [encrypt={no, yes}] In wnos.ini this sets as the default password. The system will sign on automatically and not wait for username, password, and domain entries. Disable—If the value is set to yes, the password field in sign-on window is disabled. Default is no. encrypt - The default value is no.
Parameter Description ManualOverride=[no, yes] The parameter ManualOverride allows the end users to keep their personalized settings. The default value is No. [Components={None, display, keyboard, mouse, timezone, network, audio, printer, language, All}] If the value is set to No, personalized setting is not allowed. If the value is set to Yes, the personalized settings are saved in the device component which can be specified through the components option.
Parameter Description TimeZone= TimeZone — Specifies the time zone if the zone is unspecified on the thin client or is used with ManualOverride. Supported zone values s are listed in the System Preference dialog box on the thin client and in TimeZone Parameter: Values. [ManualOverride={no, yes}] [daylight={no, yes}] [start=MMWWDD end=MMWWDD] NOTE: [TimeZoneName=] The TimeZone parameter is dependent on the TimeServer=parameter.
Parameter Description Continued from the previous table... NOTE: To configure daylight saving time for an RDP session, you must enable the Allow Time Zone Redirection function. Use the following guidelines: 1. Run gpedit.msc to open the Group Policy dialog box. 2. Click Computer Configuration in the Local Computer Policy tree, and expand the Administrative Templates folder. 3. Expand the Windows Components folder, and then expand the Terminal Services folder. 4.
Table 4. 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 5. Connection Settings: wnos.ini files only Parameter Description AddCertificate=filename AddCertificate — Specifies a certificate file residing in the subfolder cacerts under the wnos folder to load on platforms with nand flash, or on the memory. The length of the filename, including the trailing period and the file extension, is limited to 64 characters.
Parameter Description ConnectionBroker={default, VMware, Microsoft, Quest, AWS} Default value is default. Specifies the type of VDI broker to use. Default is a 3rd party VDI broker. [IgnoreProfile={yes, no,}] AWS is Amazon Workspace broker. It is only available with PCoIP build. [SecurityMode={Default,Low,Warning,Full}] IgnoreProfile — Default value is no. [EnableVWGateway]={yes, no} Set IgnoreProfile=yes to disable parsing the global setting from the VDI broker.
Parameter Description Continued from the previous table... DisableShowDisclaimer=yes—The option is set to yes to disable popup/prelogon message and automatically accept them without intervention when broker type is VMware View. The default value is no. DisableShowServer=yes—The option is set to yes to disable showing the view server URL in sign-on window and disclaimer window when broker type is VMware View. The default value is no.
Parameter Description DHCPOptionsRemap={no, yes} Default is no. [DisableOption12={no, yes}] DHCPOptionsRemap — Specifies whether or not the following options can be set.
Parameter Description 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. DomainList=List of NT domain names [disable={yes/no}] A list of domain names that will appear in the thin client Sign-on dialog box as options to help users in selecting the domain to sign-on to PNAgent/PNLite servers. Once specified, it is saved in non-volatile memory.
Parameter Description Dualhead={no, yes} Default is no. [ManualOverride={no, yes}] Dualhead — Yes/no option to support a dual-monitor display. Default no sets monitors to mirror mode; yes sets monitors to span mode. [Mainscreen={1, 2}] [Orientation={hort, vert}] [Align={Top|Left, Center, Bottom|Right}] [Taskbar={wholescreen, mainscreen}] [MonitorAutoDetect={yes,no}] [Swap={no, yes}] [EnsureDpIsOn ={yes, no}] ManualOverride — Default is no.
Parameter Description FileServer=List of {IP address, DNS name} FileServer — Specifies the FTP or Web (http://) server IP address or DNS name that is entered into thin client local setup (non-volatile memory); the thin client immediately uses this server to access files. [Username=username] [Password=password] [SecurityMode={Low, Warning, Full, default}] Username — Specifies the username of the file server. Password — Specifies the password of the file server.
Parameter Description HealthCastServer=vip list Specifies a list of VIP addresses with optional TCP port number of HealthCast servers. [LogLevel={0, 1, 2 ,3}] [SecurityMode={default, full, warning, low}] [ClientCertificate=certificate file name] LogLevel—The option LogLevel is for debug purpose; 0 means no log. SecurityMode —Specifies the SSL certification validation policy. If set to default, it will apply SecurityPolicy setting. If set to full, the SSL connection needs to verify server certificate.
Parameter Description Multifarm={no, yes} Default is no. Yes/no option to support Citrix multifarm functionality for the wnos.ini files. If Multifarm=yes, PNAgent/PNLite users are able to authenticate to more than one Citrix farm. MultiHead=[yes, no] [ManualOverride={yes, no}] [Mainscreen={1,2,3,4,5,6}] [Resolution={ddc, width X height}] If you set ManualOverride=yes, the monitor layout can be set by the user configuration if any, otherwise the configuration defined in INI are applied.
Parameter Description NoticeFile=filename NoticeFile — Specifies a legal notification file residing in the home directory folder. The file is displayed in a dialog box and the user is prompted to accept it before the sign-on process continues. [Resizable={no, yes}] [Timeout={0, 10 to 600}] [Title="notice_title"] [ButtonCaption="button_caption"] Resizable — Default is no. Yes/no option to resize the dialog box to fit the text size. Timeout — Default is 0.
Parameter Description OneSignServer=onesign_server A list of host names or IP addresses with optional TCP port number or URLs of Imprivata OneSign servers. It should use https protocol. If OneSignServer="" is defined, then only imprivata virtual channel can work.If DisableBeep is set to yes, then Rfideas reader can be set to mute when a card is tapped. Default is no.
Parameter Description PasswordServer=password_server Specify an ica/rdp server that can be used to log on to modify password when you sign-on with password timeout. [AccountSelfService={yes, no}] [connect={ica, rdp}] [encryption={Basic, 40, 56, 128, Login-128, None}] The PasswordServer statement can specify the connection parameters as described in the Connect statement. If no parameter is specified, it connects with ICA protocol.
Parameter Description Proxy={yes, no} Specifies the proxy settings which are saved in non-volatile memory. If Proxy=no, all proxy settings are cleared and all the followed options are ignored. AppList={ccm;fr;rtme;wms} [Type={Global, http, https, socks5}] [Server=_host_port_] [User=_user_name] [Password=_password_] [Encrypt={yes, no}] 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.
Parameter Description Reboot | shutdown={no, yes} Time=hh:mm Reboot — Yes/no option to enable automatic daily reboot of all ThinOS devices. [-hh:mm] Time — Specifies the time to reboot and must be in a 24-hour format. For example: Reboot=Yes Time=17:30 will reboot all ThinOS devices at 5:30 P.M. daily.
Parameter Description ScepAutoEnroll={yes, no} This option is to allow client automatically get certificates and renew certificates using SCEP protocol.
Parameter Description SelectServerList={PNA, VDI} Allows users to select one PNA or VDI server during logon. For server use the format: [Default=default_desc] list of servers {Server1; Server2; ...ServerN} description = host = [ ] NOTE: There must be “description” and “host” key words on each server. For PNA server options, use the options of the PnliteServer parameter in Connection Settings: wnos.ini files, {username} INI, and $MAC INI Files.
Parameter Description Service=vncd disable={no, yes} Service=vncd disable—Yes/no option to disable the vncd service, same as MaxVncd={0, 1}. [servers=server_list] [HttpPort=_http_port_] [TcpPort=_tcp_port_] Default is no. servers—Use the servers option to limit the valid vncd client site to the IP addresses in the server_list parameter, which contains IPv4 IP or IP range addresses, such as 192.168.1.0/24; 192.168.2.48. If this option is not set, all IP addresses are displayed as valid.
Parameter Description SignOn={yes, no, NTLM} SignOn — Default is yes. Yes/no/NTLM option to enable the sign-on process. If set to NTLM, a user can be authenticated with an NTLM protocol.
Parameter Description Continued from the previous table... LockTerminal — Default is yes. Yes/no option to lock the terminal. If set LockTerminal=no, the function of locking terminal is disabled. It disables the Lock Terminal from a Right Click on the desktop or from clicking the Shutdown option > 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.
Parameter Description Speedbrowser={on, off} Default is on. On/off option to enable the ICA Speed screen Browser Acceleration Function. Sleep=[yes, no] [program=[Sleep, Power off]] [timer=[0, 1, 5, 10, 15, 30, 60, 120, 300, 600] [MaxSleepPeriod]=[0-255]] Sleep—This parameter enables or disables the sleep mode feature. The sleep mode enables the thin client to enter the power-saving state and quickly resumes full power operations without loss of data. The default value is yes.
Parameter Description SysMode={classic, vdi, VMware, Citrix} SysMode — Specifies the Zero interface optimized for VDI or the Classic interface. This value will be remembered across reboots until changed. If not defined and an INI is present, Classic mode is the default. If no INI is present, VDI mode is the default.
Parameter Description TcpTimeOut={1 , 2} Default is 1. Specifies the timeout value of a TCP connection. The number of 30 seconds for the timeout value of a TCP connection. The value must be 1 or 2 which means the connection timeout value is from 1x30= 30 seconds to 2x30= 60 seconds. Values of 3-255 are recognized only for backwards compatibility that is >2 = 60 seconds, however, these values should not be used and the value should be set to 2.
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.
• Connection Settings for wnos.ini files, {username} INI, and $MAC INI files 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 6. General Settings: wnos.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value BootOrder={PXE, HardDisk, USB} BootOrder — Sets the boot order for the BIOS. The boot order must follow these rules: 1. The boot order is a list of these three options separated by a semi-colon (;) or a comma (,). 2. Every option must be used. 3. The options must be different.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Desktop=bitmap file [Layout={tile, center, stretch}] [IconTextColor="rrr ggg bbb"] Desktop — Specifies a bitmap file to be used as wallpaper for the local desktop. This file could be a 4-bit, 8-bit, or 24-bit BMP file or a standard GIF file or a standard JPEG file. The file must be located in the FTP server wnos\bitmap directory. Default is Wyse wallpaper.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Device=DellCmos [CurrentPassword=password] [CurrentPasswordEnc=password encrypted] [NewPassword=password] [NewPasswordEnc=password encrypted] [Audio={yes, no}] [AdminLock={yes, no}] [AutoPower={Disable, Daily, Workday, Days}] These INI parameters are applicable to thin clients with Dell standard BIOS.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... WakeOnLAN—This option allows the thin client to power up from the off state when triggered by special LAN signal.Wakeup from the standby state is unaffected by this setting and must be enabled in the operating system. This feature only works when the thin client is connected to AC power supply.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... After the administrator configured the CMOS on a template unit, the administrator should sign on to the cmos account on ThinOS to get the CMOS content saved to the cmos file on writable File Server wnos directory. Then, the wnos.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value FactoryDefault={no, yes} Default is no. Yes/no option to reset the system settings to factory default. This parameter, when set to yes, is only initialized once for each firmware change; however, you can set to no and then reboot so the option will be initialized again.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table...
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table...
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... NOTE: Japanese refers to Japanese Input system (MS-IME2000), not JP. Russian keyboard is supported for server input; it is not supported to input locally.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value LocaleList= LocaleList — Specifies a list of locale, so that a user can switch the system language as needed. Values include: English, us, French, fr, German, de, Chinese Simplified, gb, Chinese Traditional, b5, Japanese, jp, Korean, ko, Latin, la. All the values will be displayed in the GUI. To view the GUI, click System Preference > General > Locale.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value ** 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}.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... HideConnectionManager — Default is no. Yes/no option to hide the Connect Manager window from view. NOTE: As stated earlier, although the Connect Manager is disabled by default if Privilege=none, the Connect Manager can be enabled by using HideConnectionManager=no; however, the user cannot create a new connection or edit an existing connection.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... DisableChangeDateTime— If the optional DisableChangeDateTime is set, the function of changing date and time locally will be disabled. For example, if you rightclick the time label in taskbar, nothing is displayed. The Change Date and Time button in System Preference will be invisible.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value ResourceURL={yes, no} [Type={Picture, Firmware, Package}] [URL=_url_path_] The resource files have their specified default path in file server, for example, the pictures for Showing Picture screen saver are from the folder /wnos/picture in file server (default), and the bitmap are from /wnos/bitmap.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value **ScreenSaver=value{0, 1, 3, 5, 10, 15, 30} [LockTerminal={0, 1, 2, 3}] [Type={0, 1, 2, 3, 4}] [VideoLink=httplink] [VideoSpan=no] [Unit=hour] [Image=imagefile] [PictureTimer={2-60}] [PictureOrder=random] [PictureCheck=always] [PictureLayout={stretch, tile, center}] [Sleep={0-180}] Screensaver— Specifies to put the thin client in a screensaver state when the time limit for inact
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... 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. If the dual head is in span mode and VideoSpan=yes, it is spanned across all the screens. If VideoSpan=no, it is displayed in the main screen.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value TimeServer=server_list [TimeFormat={24-hour format, 12-hour format}] [DateFormat={yyyy/mm/dd, mm/dd/yyyy, dd/mm/yyyy}] TimeServer — Specifies the SNTP time servers to use for time retrieval. If a time server is not defined, the client CMOS/ BIOS internal clock will be used as a reference. TimeFormat — Default is 24-hour format. Specifies the time format to use.
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.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... DPaudio=[yes, no]— The default option is DPaudio=yes. DP audio may impact display on device with certain screen resolutions such as 1920x1200, 2048x1152, 2048x1280, 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.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Device=camera Specify the ThinOS local camera settings. [format=raw] format — Support only for raw video type; format=raw is fixed. [width={camera supported width}] width — The width of the resolution that the local camera supports.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Device=keyboard Device — Specifies the local keyboard. [numlockoff={no, yes}] numlockoff — Default is no. Yes/no option to turn off the NumLock of the keyboard. [repeatrate={0, 1, 2}] [repeatdelay={0, 1, 2, 3, 4, 5, 6, 7}] [disabledKeys={PrtScn;SysRq}] repeatrate — Default is 1. Specifies the keyboard repeat rate. 0 — Slow 1 — Medium 2 — Fast repeatdelay — Default is 2.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Device=UsbSerial [start=com{1~4}] [com{1~4}=com{5~8}] Specifies the first COM port number that can be used by USBserial port. For example, the first USB-Serial port on a VL10 thin client is COM2 by default, but it can be changed to COM3 with the INI file Device=UsbSerial Start=COM3. 1. Without any ini setting: The COM number registered is related with USB port number.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Device=Mobile TrackpadDisable={yes, no} [CloseLidCharge={No, ShutDown, OffDisplay}] [CloseLidDisCharge={No, ShutDown, OffDisplay}] [BatteryAutoPowerOff={3-20}] Device =Mobile—This option is applicable only to the Wyse 5470 Thin Client. TrackpadDisable={yes, no}—Default value is no. The Yes/No option enables or disables the trackpad.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value MicBoost={no, yes} Default is no. Yes/no option to enable on-board microphone boost. **MouseNewSpeed={1-9} Default is 6. Value specifies the mouse speed within a range of 1 through 9, where 1 is slowest and 9 is fastest. This parameter is the replacement of MouseSpeed from build 7.0.1_07. **MouseSwap={0, 1} 0/1 option to swap the mouse buttons.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Printer={LPD1, LPD2, LPD3, LPD4, LPD5-LPD36} Default is LPD1. [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. [Queue=queue] [PrinterID=window_driver] [Class=classname] [Enabled={no, yes}] Host — Specifies the host name of the printer.
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.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value *Resolution=[DDC, 640X480, 800X600, Default is DDC. 1024X768, 1152X864, 1280X720, Resolution — Specifies the local display resolution. Option DDC can be specified to select default display resolution.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value *Screen={1, 2, 3, 4, 5, 6} Default is 1. Screen — Specifies the monitor for the Resolution parameter. You can configure each monitor with its own resolution; the specific monitor is set with the Screen= option. NOTE: The Screen parameter must be placed before the Resolution parameter.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value **AutoSignoff={no, yes, 2-60} Default is no. [Shutdown={no, yes}] AutoSignoff —This option can be used to automatically sign-off a user when the last opened session is closed. The default value is no. A value ranging from 2 to 60 can be configured. This value represents the number of seconds a session must be active prior to calling AutoSignOff.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value *Device=Ethernet Device — Specifies to use an Ethernet. [Speed={Auto, 10M HD, 10M FD, 100M HD, Speed — Default is auto. Specifies the ethernet speed to either Auto, 10 MHD, 10 M FD, 100 M HD, 100 M FD, or 1000 M. If Speed is set in a wnos.ini file, the Speed statement in the {username}.ini file will be disabled.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Device=vusb [ForceRedirect=DeviceID, fast] [ForceLocal=DeviceID] [Type={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. This parameter has priority over ForceLocal. Device=vusb ForceRedirect=0x07B4,0x0254,0x01,0x01,0x00,fast .
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. For example, you can define Key 1 to have a key of k1 and leave out Key 2 through Key 4. NOTE: See also IEEE8021X={yes, no}.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... DisableWlan— Used to disable the wireless connection. If DisableWlan=EnetUp, and the Ethernet is on while booting, the wireless connection is disabled.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... RoamScanChannelTime—Allows you to set the time the thin client stays on one channel for scanning the surrounding apps. The default value is 2. The RoamScanChannelTime parameter sets the time to 10 times the provided value. The time ranges from 10 ms to 150 ms.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value *EthernetSpeed={Auto, 10M HD, 10M FD, 100M HD, 100M FD, 1000M} Default is auto. 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.
Description Parameter * Global overrides identically-named user profile ** After sign off, user profile returns to global value FastDisconnect={yes, no, Signoff} Default value is no. [CtrlKey={yes, no}] If the value is set to yes, pressing the F12 (default) key or the key defined in FastDiconnectKey= statement will close the active window of the session. If the active window is a seamless window, the action will only close the window.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Hosts= Specifies the file name of the hosts. This file is a simple text file that associates IP addresses with hostnames, one line per IP address. The length of the file name is limited to 63 characters. The file must be placed in file server and can be cached if set MirrorFileServer=yes in the wnos.ini.
Description Parameter * Global overrides identically-named user profile ** After sign off, user profile returns to global value IEEE8021X={yes, no} network={wired, wireless} [Profile=ssid] [access={WPA-PSK, WPA2-PSK, WPA-ENT, WPA2-ENT}] [eap={yes, no}] [servervalidate={yes, no}] [servercheck={yes, no}] [servername={"servername for EAP-TLS, EAP-PEAP, EAPFAST"}] [eaptype={None, EAP-LEAP, EAP-TLS, EAP-PEAP, EAP-FAST}] [leapun={username for EAP-LEAP}] [leappwd={password for EAP-LEAP}] [leappwdEnc={password enc
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value [fastmschaphidedm={yes,no}] Continued from the previous table...
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value **Inactive={0, to 480} (minutes) Default is 0. [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.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value OneSignServer=onesign_server [DisableBeep={no, yes} Specifies a list of host names or IP addresses with optional TCP port number or URLs of Imprivata OneSign servers. NOTE: An https protocol must be used.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value PnliteServer=List of {IP address, DNS names, or URLs} [ReconnectAtLogon={0, 1, 2}] [ReconnectFromButton={0, 1, 2}] [AutoConnectList={*/ appname1;appname2; appname3...
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... Timeout — Specifies the time in seconds where a client will try to establish a connection before reporting that it is unreachable. CAGRSAAuthMethod or CAGAuthMethod — CAGAuthMethod option is used for CAG authentication configuration. NOTE: This option replaces CAGRSAAuthMethod.
Description Parameter * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... 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.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value SaveSysinfo={usb, _proto_, _full_url_} Configure the target clients to save the event logs. [ScardLog=0xF ] full_url—If set as a specified full url name, it is saved into the specified url. Otherwise, it is saved as a file name, such as /wnos/ troubleshoot/{TERMNAME}_LOG_{DATE}_{TIME}.txt.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value **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. Specifies the status of the taskbar when maximizing the seamless window. 0 — Do not hide the taskbar.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value SelectGroup={no, yes} Default is no. [Default=default_desc] 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.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Serial={COM1, COM2, COM3, COM4} [Baud={1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200}] [Parity={None, Even, Odd}] [Stop={1, 1.5, 2}] [Size={5, 6, 7, 8}] [Flow={None, XON/XOFF, CTS/RTS, Both}] [Touch={no, yes}] [Touch_XYReverse={no, yes}] [Touch_type={elo, microtouch, fastpoint}] Serial — Default is COM1. Specifies the local serial ports configuration.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value SessionConfig=ALL [unmapprinters={no, yes}] [unmapserials={no, yes}] [smartcards={no, yes}] [mapdisks={no, yes}] [disablesound={no, yes, 2}] [unmapusb={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.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... 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.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value SessionConfig=ICA [desktopmode={fullscreen, window}] [mapdisksunderz]: DISCONTINUED. DO NOT USE. [TosIpPrecedence={0–5}] [TosDscp={Default/CS1/CS2/CS3/CS4/CS5/CS6/CS7/AF11/ AF12/AF13/AF22/AF23/AF31/AF32/AF33/AF42/AF43/EF}] SessionConfig — Specifies the ICA default settings of the optional connection parameters for all ICA sessions. desktopmode — Default is fullscreen.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... all—display all connections. none—no connections are displayed. desktops—display only the desktop connections. applications — display only applications, the connections are handled as an ondesktop_list. For example, if you set ondesktop=word; excel, then only the applications word and excel are displayed.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... Timeout—This option controls the credential prompt after ICA broker logon was timeout. Session ticket is invalid now. If yes, users have to enter their credential to re-login to launch session, if no, ThinOS will use the default credential to do login in background. The default is yes. NOTE: Other Citrix INI parameters are not listed here.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value SessionConfig=PCoIP [USBRedirection={PCoIP}] [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. USBRedirection — Default is PCoIP. Specifies the channel of USB devices redirection.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value SessionConfig=RDP [MaxBmpCache={128 to 1024}] [EnableNLA]={no, yes}] [ForceSpan={no, yes}] [EnableTSMM={yes, no}] [EnableGFX]={yes, no}] [EnableVOR={yes, no}] [EnableRdpH264]={yes, no}] [EnableRecord={yes, no}] [EnableRFX={yes, no}] [USBRedirection={RDP}] [RDPScreenAlign4={yes,no}] [WallPaper={yes, no}] [Dragging={yes, no}] [Animation={yes, no}] [Theme={yes, no}] [TosIpPrecedence
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value Continued from the previous table... GracefulReconnTimeout—This value is to set a timeout for RDP to reconnect the session if no response is received from server side during this time limit. It avoids the case of RDP session freezing for a long time and not reconnecting due to poor network quality or short time network disconnection. There is no default value for this option.
Parameter Description * Global overrides identically-named user profile ** After sign off, user profile returns to global value TerminalName=name [reboot={yes, no}] User can set a string up to 15 characters as terminal name. It can be configured as system variable like $MAC, $SN or $IP etc. [Capital={yes, no}] If reboot is set to yes and the terminal name is changed, the terminal will reboot.If "TerminalName=$DNS" is set, the system will do reverse DNS lookup to configure the terminal name.
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.
Table 9.
Table 11. TOS priority settings IP precedence (3 bits) DSCP ( 6 bits) Name Useful Name Useful Routine Try as usual NA NA AF11 Big block data NA NA Priority For data traffic Immediate Flash For Voice control data NA NA Flash Override Video streaming NA NA Critical Voice Data EF Interactive Voice NA NA NA NA NA NA Internetwork Control NetworkControl Reserved NOTE: The information in this section is leveraged based on the research on web.
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 Topics: • • • ICA connect options RDP connect options PCoIP connect options ICA connect options Table shown here contains the supported options used for ICA connections (after you use the Connect=ICA parameter/selection).
Option Description AudioQualityMode={0, 1, 2, 3} Default is 0. Specifies the audio quality of a session. 0 – Default 1 – High Quality 2 – Medium Quality 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 auto-starting the session. AppendUsername=1 This enhancement allows user names to display in the title bar of an ICA session at the client side.
Option Description 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. Encryption={None, Basic, 40, 56, 128, Login-128} Default is Basic. Connection security encryption level. The highest level is 128-bit 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.
Option Description LocalCopy={no, yes} Default is no. Yes/no option to save the connection to the local NVRAM. 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.
Option Description Password={password, $SYS_VAR} Password to log-in to the application server. Either a conventional login password or a variable can be used. Maximum of 19 characters are allowed. The value of password is a conventional login password. The value of $SYS_VAR is a system variable found in Table: System variables. NOTE: The application server password is not encrypted; it is strongly recommended not to specify it. The user will be prompted to enter the password when the connection is made.
Option Description SessionReliability={no, yes} Default is no. Yes/no option to enable session reliability. NOTE: ThinOS thin clients do not support UDP browsing to obtain a new configuration about session reliability on the server. The thin client always connects to the default port. UniSession={no, yes} Default is no. Yes/no option to use a unisession. The connection will launch only once at a time. UnmapClipboard={no, yes} Default is no.
For example, in the following case where: Connect=RDP [Option1={0, 1}] [Option2={1, 2, 3, 4}] Since you are using Connect=RDP, then Option 1 and its default value 0 will automatically be used as Option1 has an underlined value (default of 0). You can still use Option 2 if you want to, however, Option 2 is not automatically used with the parameter as Option 2 does not have a default (underlined) value. NOTE: Any option in RDP Connect Options that is used in a {username}.
Option Description Console={no, yes} Default is no. Yes/no option to login to a session in Console mode. NOTE: If Console=yes is set behind the RDP connection, the TimeZone redirection feature will be disabled. Description=string description Connection description. Enclose the string description in quotation marks if there are embedded blanks or single quotes. For quotation marks, use common-practice nesting rules. Maximum of 38 characters are allowed.
Option Description Icon={default, bitmap file} Specifies an icon to appear on the thin client desktop for a connection. Use Icon=default to display a system default icon for a connection. To use an icon other than the default icon, enter the name with extension of the bitmap file; ensure that the file is located in the FTP server wnos\bitmap directory. If Icon= is not specified and the icon is not specified by a PNAgent/PNLite server, no icon is displayed for a connection.
Option Description Password={password, $SYS_VAR} Password to log-in to the application server. Either a conventional login password or a variable can be used. Maximum of 19 characters are allowed. The value of password is a conventional login password. The value of $SYS_VAR is a system variable found in System Variables. NOTE: The application server password is not encrypted; we strongly recommend not to specify it. The user will be prompted to enter the password when the connection is made.
Option Description Reconnect={no, yes, 1 to 3600 (seconds)} Default is no. Controls automatic reconnection to an application after a server disconnection. yes — Use to restart the connection; the default delay time for yes reconnect is 20 seconds. no — Use to prevent reconnection after a disconnect. 1 to 3600 — Use an integer value of 1 to 3600 seconds to restart the connection after the delay you want. For example, use 50 and the automatic reconnection to an application will occur after 50 seconds.
Option Description UnmapPrinters={no, yes} Default is no. Yes/no option to not auto-connect to local printers when the connection. UnmapSerials={no, yes} Default is no. Yes/no option to not auto-connect to local serials when the connection. 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.
Option Description 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. 16m — 24-bits over ICA is only supported by Windows XP and Windows 2003 server. It is not supported by Windows Server 2008 or newer.
Option Description [OnScreen={1-6}] In multi monitors span mode, this value indicates which screen session is on full screen.
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.
Geographic Time Zones Time Zones Name (GMT-07:00) Mountain Time (US & Canada) Mountain (GMT-06:00) Central America" Central America (GMT-06:00) Central Time (US & Canada) Central (GMT-06:00) Guadalajara, Mexico City, Monterrey Central (Mexico) Geographic time zones Time zones name (GMT-06:00) Saskatchewan Canada Central (GMT-05:00) Bogota, Lima, Quito, Rio Branco SA Pacific (GMT-05:00) Chetumal Eastern (Mexico) (GMT-05:00) Eastern Time (US & Canada) Eastern (GMT-05:00) Indiana (East) US
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.
Geographic Time Zones Time Zones Name (GMT+04:00) Yerevan Caucasus (GMT+04:30) Kabul Afghanistan (GMT+05:00) Ashgabat, Tashkent West Asia (GMT+05:00) Ekaterinburg (RTZ 4) Russia TZ 4 (GMT+05:00) Islamabad Karachi Pakistan (GMT+05:30) Chennai, Kolkata, Mumbai, New Delhi India (GMT+05:30) Sri Jayawardenepura Sri Lanka (GMT+05:45) Kathmandu Nepal (GMT+06:00) Astana Central Asia (GMT+06:00) Dhaka Bangladesh (GMT+06:00) Novosibirsk (RTZ 5) Russia TZ 5 (GMT+06:30) Yangon Rangoon Myanmar
Geographic Time Zones Time Zones Name (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 Topics: • • 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.
Domainlist= Privilege= 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 \ Doma
