Dell Wyse ThinLinux 2.
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. © 2019 - 2020 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 Dell Technical Support........................................................................................................................................................
1 Introduction Dell Wyse ThinLinux from Dell simplifies the user management paradigm with elegant application icons and comes with a single built-in user to enhance user experience along with having the benefits of a single-operating system. ThinLinux software combines the security, flexibility and market-leading usability of Linux Enterprise with Dell’s thin computing optimizations in management.
2 Getting Started and Learning INI File Basics In this chapter you can learn how to construct and use the supported INI files. It includes the following details: • • • 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.
1. Global Connect Parameters First. Global connect parameters should be listed before other connect parameters in a wlx.ini file. 2. Connect is used for creating the VDI connection and is not mandatory. As stated earlier, You can totally have empty INI file or an INI file that has other parameters. 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.
NOTE: If Auto Login in enabled then $PW returns null, so with auto logins enabled do not use $PW as value for any parameter. Placing the INI files into the folder structure on the server You require either an FTP or HTTP/HTTPS server to download your INI files and the path to download is specified in the INI page on the thin client. Under the C:/ inetpub/ftproot folder for FTP or C:/inetpub/wwwroot folder for HTTP/HTTPS and place your INI files.
3 General settings parameter options The following table contains parameters used for configuring the general settings where default values are in bold. Table 3. General Settings Parameter Options. Parameter Description ActiveDirectoryServer= Active Directory Server IP used for Domain Login to the clientDomain Login of the client. For example, ActiveDirectoryServer=192.xxx.xxx.xxx AddtoEtcHosts= "ip1 FQDN1 aliases1; ip2 FQDN2 aliases2; ...
Parameter Description SCEPCLIENTCERTSETTINGS=CertName URL ChallengePassword CADN AutoEnroll=yes WMSEnable={yes ,no} WMSEnable. Default is Yes. WMSServer= It is used to enable or disable the Wyse Device agent. GroupRegistrationKey= WMSServer CAValidation ={yes ,no} Enter the URL of the Wyse Management Suite server you want to connect to. Default=yes MQTTServer Enter the IP Address or the FQDN of the MQTT server.
Parameter Description custom3="" DelayedUpdate.Enable={true, false, yes, no} Default is true DelayedUpdate.Enable parameter enables or disables the updatings. DeskColor= [{solid | horizontal-gradient | vertical- Specifies the desktop background color where and gradient}] can be one of the following values: • • • • RGB color specification in the form commonly used in HTML (rrggbb). A color name from the /usr/share/X11/rgb.
Parameter Description Desktop.KeyBinding.Minimize= Default is disabled Desktop.KeyBinding.Move= Default is disabled Desktop.KeyBinding.Resize= Default is disabled Desktop.KeyBinding.ShowDesktop= Default is Down Desktop.KeyBinding.SwitchWindows= Default is Down Desktop.KeyBinding.ToggleFullscreen= Default is Up Desktop.KeyBinding.ToggleMaximized= Default is F10 Desktop.KeyBinding.
Parameter Description This parameter allows an administrator to enable or disable authentication against a domain, to require the thin client to formally join the domain, and to configure other domain parameters, such as the name of the administrator group. Domainjoin.ou It specifies the organization unit within Active Directory to which an administrator can assign Group Policy settings. EnableGKey={true, false} Default is true EnableGKey option is used to enable G key reset.
Parameter Description It specifies the complete URI (server URL and file full path) of the configuration files to import. ImportConfig.UID= Default is none. It is the User ID used when importing the configurations file from an FTP server. ImportConfig.Password= Default is none It is the password used when importing the configurations file from an FTP server. MerlinUpdate.URL= This parameter specifies the URL to the directory where the Merlin image is placed.
Parameter Description reboot or restart: Reboots the devices. ProgressUpdateInterval=<10–60> Default is 20 The interval specified for sending image upgrade status to WDM server. Value less than 10 will be rounded to 10 and Value greater than 60 will be rounded to 60. PasswordEncryptionCode={0, 1, 2} Default value is 1 Specifies the desired password encryption algorithm in INI. This parameter must be place at least before the first password used in the wlx.ini file.
Parameter Description SuspendSystem=<0 to 5 hour> Default is 15 minutes. This option enables your device to enter a low-power state, and enables you to quickly resume your work without rebooting the device. TimeFormat= Default is 12h Specifies the system time format. The following are the formats: • • VNCServer.DisableVNC={yes, no} 24, 24h, 24-hour, 24-hour format. 12, 12h, 12-hour, 12-hour format. Default is yes You can disable or enable the VNC Server. VNCServer.
4 Peripheral Settings Parameter Options The following table contains parameters used for configuring peripheral settings such as keyboard, monitor, mouse, and printer. Table 4. Peripheral Settings Parameter Options Parameter Description DisableBluetooth={yes, no} Default is yes. This parameter allows you to enable or disable the Bluetooth function on your thin client.
Parameter Description MON1 primary rotate-left 1920x1080 MON2 1920x1200 MON3 1920x1200 rotate-left, rotate-normal, and rotate-right are supported as legacy parameters. These parameters rotate the framebuffer for monitors that do not actually support rotation. Specifying these parameters requires monitors to be physically rotated. For monitors that support rotation, these parameters are not necessary. This key value is to reset both monitors to default settings.
Parameter Description Example for two displays • DisplaySettings=MON1 1920x1080 on-left MON2 1920x1200 on-right DisplaySettings=MON1 primary 1920x1080 on-left MON2 1920x1200 on-right DisplaySettings=MON1 1920x1080 on-left MON2 primary 1920x1200 on-right Example for three displays DisplaySettings=MON1 primary rotatenormal 1400x1050 on-right MON2 rotatenormal 1920x1080 on-right MON3 rotatenormal 2048x1080 • • To specify display resolutions with a refresh rate, use the 1920x1080@60 format.
Parameter Description This setting is valid only when Keyboard.Repeat is enabled (true). Keyboard.layouts= For example: Keyboard.layouts=fr (for french). For information about the values that you can use for the Keyboard.layouts parameter, see Keyboard Layouts Parameter: Values. Printer={USB or URI} Specifies the USB for local USB printer. Only one USB printer can be supported. The USB printer will not be configured if it is not attached.
5 Connection Settings Parameter Options The following table contains parameters used for configuring connection settings where default values are in bold. Table 5. Connection Settings Parameter Option Parameter Description Connect={BROWSER, Custom, Citrix, RDP, SSH, VMWARE_VIEWCLIENT, VNC_VIEWER, Ericom_Powerterm} Connection protocol. Connect Parameter Options section describes these connect options: Chrome.
Parameter Description DomainList=< String values separated by semicolon> A list of domain names that will appear in the login dialog box as options to help users in selecting the domain to log in to PNAgent or Active Directory servers. Be sure to enclose in quotation marks if spaces are included. For example: DomainList = dell; SQA; wyse DisableDomain={ True, False} DisableDomain parameter is used to disable the display of a Domain field.
Parameter Description The default value is Yes. If the parameter value is set to Yes the bookmark icon is disabled. If the parameter value is set to No the bookmark icon is enabled. Firefox.HideSearchBar ={yes, no} For Firefox Browser only This parameter disables the search icon from the toolbar menu. The default value is Yes. If the parameter value is set to Yes the search icon is disabled. If the parameter value is set to No the search icon is enabled. Firefox.
Parameter Description H264Enabled={yes, no} For Citrix only. Default is yes . You can enable H264 compression from server to client. This will enable h264 encoding for media packets which are received from server. This enables the better performance for multimedia redirection and webcam redirection. CitrixBrowsing={ udp, http, https} For Citrix only. Default is http. Specifies the default browsing protocol. This setting can be overridden by the HttpBrowsing= {yes, no, ssl} in each connection property.
Parameter Description To map drives on the server to USB mass storage devices attached to the thin client, where: drive letter= A to Z device name= usbstorage-x and cdrom-x, where x=0,1,2 and so on. rw= read/write ro= read only basedir= an optional directory on the USB device to use. ICADynamicDriveMapping={yes, no} For Citrix only. To enable or disable mapping of a single device based on the device name Default value is no. ICADynamicFolderMapping={yes, no} For Citrix only.
Parameter Description This parameter requires two thin client reboots. If this parameter is set ,then video is extracted by using the client rendering capabilities(encoding and decoding). ICAMultistream={True, False, yes, no} To enable multiple streams to be used when connecting to a multistream ICA enabled server, you must ensure this parameter is set to True or Yes. Default is False or No ICAProxyHost=< IP address> For Citrix only. Specifies the firewall server address for the ICA connection.
Parameter Description yes: In a Unix environment, a middle mouse performs the same paste function as the Ctrl+V keystroke combination in the Windows. no: Disables the middle button paste, when used in the wlx.ini file with ICA v.10. NETWORK.ETH0.MTU={ Any positive integer} Default is System assigned automatically Specifies the network card’s maximum transmission unit size. PAMLoginEnabled={yes, no} For Citrix only.
Parameter Description UDPAudioPortLow={yes, no} For Citrix only. Default is 16500. This parameter is used to configure UDP port range for real time audio data packet exchange. UseLastDomainName={true, false} Default is False If this ini parameter is set, then in the GDM login window, the username field is populated with the previous logged in domain username value. This ini parameter is valid only for domain login and not for local user login. UseLastLoginName={True, False} Default is False.
Parameter Description [Wep-Key4=] WEP40/128-BITKEY — WEP 40/128-bit Key [WepKeyIndex=] WEP128-BITPASSPHRASE — WEP 128-bit Passphrase [InnerAuth={MSCHAPv2, MD5,GTC}] LEAP — leap [PeapVersion={Auto, 0, 1}] WPA&WPA2PERSONAL — WPA and WPA2 personal [CACertificate= WPA&WPA2ENTERPRISE — WPA and WPA2 Enterprise DYNAMICWEP — Dynamic WEP (802.
Parameter Description SSID=Wyse Security=leap \ Mode=Infrastructure \ Username=admin \ Password=1234567890 \ AuthType LEAP example: WLAN=wlan6 SSID=ACS \ Security=wpa&wpa2enterprise \ Mode=Infrastructure \ AuthType=leap \ Username=linux\ Password=linux\ AuthType PEAP example: WLAN=W2EN \ SSID=W2EN \ Security=wpa&wpa2enterprise \ Username=peap \ Password=peap \ AuthType=peap \ InnerAuth=mschapv2 \ PeapVersion=Auto \ CACertificate=/etc/certificate/rootcer.cer\ 802.
Parameter Description [PeapVersion={Auto, 0, 1}] Default is Auto. This option enables you to select the PEAP protocol version. Is802DirectEnabled=[yes, no] Default is no. This option enables the 802.1x authentication from the GDM login screen. Dell recommends that you specify a value for this parameter. If the value is not set in the registry, it is considered as false or no.
6 Custom GNOME Settings Parameter Options The following table contains parameters used for configuring Custom GNOME settings where default values are underlined. Table 7. Custom GNOME Settings Parameter Options Parameter Description Custom.HideQuickStart={yes, no} Default is no. This parameter allows you to hide the Quick Start application from the ThinLinux desktop. Custom.Menus= The value of Custom.Menus is a non-quoted string.
Parameter Description no: Activities icon is disabled on Taskbar in user mode. Custom.Taskbar.AllowAudioIcon={yes, no} Default is yes Customizes the Audio Volume icon to be enabled or disabled in user mode. yes: Audio Volume icon is enabled on Taskbar in user mode. no: Audio Volume icon is disabled on Taskbar in user mode. Custom.Taskbar.AllowDateTimeIcon={yes, no} Default is yes Customizes the Date and Time icon to be enabled or disabled in user mode.
7 Connect Parameter Options This section provides the options that you can use for the connect parameter in the supported connections. Browser Connect Options The following table contains the supported options you can use for Browser connections where default are in bold: Example: Browser connect options CONNECT=BROWSER \ Description="XenDesktop" \ URL=http://10.140.155.31 \ Resolution=FullScreen \ AutoConnect=1 \ Mode=kiosk \ LocalCopy=no Table 8.
Option Description no or 0 — (default) Disables the Enable Auto Reconnect check box. ReconnectSeconds= Default is 30. Specifies the amount of time in seconds (default is 30) to wait before automatic reconnection to an application server after a disconnection. Requires Reconnect = yes or 1 Resolution={ default, maximized,640x480, 800x600, 1024x768, 1280x1024, 1600x1200} Default is default. URL= Specifies the starting URL. Specifies the connection window size.
Option Description Reconnect={no, yes} Default is no Reconnect option is used to automatically reconnect to an application server after a disconnection. ReconnectSeconds= Default is 30 Specifies the amount of time in seconds to wait before automatic reconnection to an application server after a disconnection. It requires, Reconnect= yes or 1. Runinterminal= {yes, no} Default is no. This option can be used to run the custom command with a new instance of Xterm.
Domainname=$DN \ Alternate=Yes \ LowBand=Yes \ LocalCopy=no Example: Storefront Connection: Connect=ICA \ Application="win81" \ Browserip=hostname.domain.com \ Description="Store-Xendesk7" \ AutoConnect=no \ HttpBrowsing=ssl \ StoreName=Store \ StoreFront=yes \ FullScreen=yes \ AutoConnect=no \ Reconnect=10 Example — Smart Card Enabled to Storefront connection when smart card enabled: Connect=ICA \ Application=win7 \ StoreName=Store \ StoreFront=Yes\ BrowserIP=192.168.1.2 \ Description=smartcard_test \ User
Options Description Colors={256, 64k, 16m} Default is 64k. Specifies the session color mode. For faster display performance, use 256 colors. Description= Connection description provides a connection name for the Desktop icon and the Connection Manager. CAUTION: The text must be enclosed in double quotation marks, if it contains spaces or punctuation characters. These characters are not allowed: &‘ “ $?!|; ()[]{}\ DomainName= This parameter specifies the domain name.
Options Description $IP — IP Address $DN — Sign-on domain name $UN — Sign-on name $PW — Sign-on password $TN — Terminal name NOTE: The application server password is not encrypted. The user is prompted to enter the password when the connection is made. This application server password directive never starts a line, so it can be distinguished from the thin client user sign-on password which starts a line. Ping={yes, no} Default is yes. This option is used to enable ping.
Options Description Username={, $SN, $MAC, $IP, $DN, $UN, $PW, $TN} Specifies the name required to log in to the application server. Either a conventional login name or a variable can be used.
Options Description This option is used to start a connection automatically at sign-on. Colors={ 256,32k,64k,16m,4b } Default is 4b. Specifies the session color mode. For faster display performance, use 256 colors. Command= Default is none. Specifies a command to execute remotely.
Options Description Icon= Specifies an icon to appear on the thin client desktop for this connection. The file must be an XPM file located in the FTP server wlx2/bitmap directory. If not specified, the default icon is displayed. LocalCopy={no, yes} Default is no. The LocalCopy option is used to save this connection in the local permanent registry. LowBand={no, yes} Default is no LPTports=LPTx={LPTy,USBLPz},LPTx=...
Options Description RdpClipboard={yes,no} Default is yes. RdpClipboard option is used to enable the clipboard in an RDP session. RDServer= Specifies the RD Gateway host address RDUsername= Specifies the RD Username to use for RD Gateway Login Reconnect={no, yes} Default is no. Reconnect option is used to automatically reconnect to an application server after a disconnection. ReconnectSeconds=<1 to 3600> Default is 30.
Options Description $UN — Sign-on name used $PW — Sign-on password used $TN — Terminal name Smartcard={no, yes} Default is no. Yes/no option is used to enable Smart Card Authentication. Speed_level={Broadband/LAN/Modem/Custom} Default value is LAN. Handles the performance based on bandwidth. SSH Connect Options The following table contains the supported options you can use for SSH connections where defaults values are in bold: Example: CONNECT=SSH \ Description="SSH_Connection" \ Host=192.168.1.2 \ Re
Option Description LocalCopy={no, yes} Default is no. LocalCopy option is used to save the connection in the local permanent registry. Reconnect={no, yes} Default is no Reconnect option is used to automatically reconnect to an application server after a disconnection. ReconnectSeconds= Default is 30 Specifies the amount of time in seconds (default is 30) to wait before automatic reconnection to an application server after a disconnection. Reconnect=yes or 1 is required.
Table 13. VMware View Connect Parameter Options Option Parameter Application= Use the published application name in non-interactive mode. AutoConnect={no, yes} Default is no AutoConnect option is used to start a connection automatically at sign-on. Description= Default is none Connection description provides a connection name for the Desktop icon and the Connection Manager.
Option Parameter Icon= Specifies an icon to appear on the local desktop or Connection Manager. The file must be located in the server wlx2/bitmap directory. If not specified, the default icon is displayed except in the case of a published application. A PNG, JPEG or GIF may be used. XPM is permitted for backward compatibility. Interactive={yes, no} Default is yes. Interactive option is used to enable interactive connection mode. LockServerURLField={yes,no} Default is yes.
Option Parameter Reconnect={no, yes} Default is no. Reconnect option is used to automatically reconnect to an application server after a disconnection. ReconnectSeconds= Default is 30. Specifies the amount of time in seconds (default is 30) to wait before automatic reconnection to an application server after a disconnection. Reconnect=yes is required. SecureMode={neverconnect, warnbefore, donotverify} Default is warnbefore.
Option Parameter The default value for Horizon Client 3.4 and earlier is TLSv1.0:TLSv1.1. VNC Viewer Connect Options The following table contains the supported options you can use for VNC Viewer connections where default values are in bold: Example: CONNECT=VNC_VIEWER \ Description="VNC_Connection" \ Host=192.168.0.2 \ Color=True_Color \ AutoConnect=Yes \ Password=xyz \ Fullscreen=Yes \ LocalCopy=No Table 14. VNC Viewer Connect Parameter Options Options Description AutoConnect={yes, no} Default is no.
Options Description NOTE: This parameter is mandatory. Icon= Specifies an icon to appear on the local desktop or Connection Manager. The file must be located in the server wlx2/bitmap directory. If not specified, the default icon is displayed except in the case of a published application. A PNG, JPEG or GIF may be used. XPM is permitted for backward compatibility. JpegQuality= Default is 8 JPEG Quality levels are, 0 = Low and 9 = High. LocalCopy= {yes, no} Default is no.
AutoConnect=Yes \ Reconnect=Yes \ ReconnectSeconds=30 \ Filename=RemoteConfigurationFileName \ Filepath=wyse/WLX2/RemoteConfigurationFilePath \ Terminal=WY50 \ TermName=Wyse 50 terminal \ Resolution=1280x1024 \ Fullscreen=No \ DeviceID=Wyse50 \ Echo=No \ UIConfig=menu Table 15. Ericom PowerTerm Connect Parameter Options Options Description AutoConnect={no, yes} Default is no. Yes/no option allows you to start a connection automatically at sign-on.
Options Description LocalCopy={no, yes} Default is no. LocalCopy option allows you to save the connection in the local permanent registry. Phone= For serial connection only. Specifies the modem dial-up number. Port= {COM1, COM2...} For serial connection only. Default is COM1. Designates the connection serial port. Reconnect={no, yes} Default is no. Yes option allows you to automatically reconnect to an application server after a disconnection.
8 Printer Parameters Option This appendix provides the options that you can use for the following supported printer parameters: • • • • • Printer JetDirectPrinter NetworkPrinter PrinterURI SMBPrinter Printer The following table contains the supported options you can use for the Printer parameter, where defaults values are underlined. NOTE: The Printer command line defines a locally attached printer connected through the noted interface. Table 16.
Table 17. JetDirectPrinter Parameter Options Options Description Default={yes, no} Default is yes Description= Not used internally. Enable={yes, no} Default is yes ModelID= Identifies the printer for the purpose of choosing a Linux printer driver. For example, Dell B5465dnf Laser MFP. Name= It provides both the name that is given in the local printers list and the internal name of the local print queue.
Options Description PrinterID= Identifies the printer for the purpose of choosing a Windows printer driver. For example, Brother MFC-420CN Printer. Specify this parameter if you are forwarding the printer access to a Citirx or RDESKTOP connection. Queue= It provides printer queue on the server. PrinterURI The following table contains the supported options you can use for the PrinterURI parameter where defaults values are in bold: Table 19.
Option Description Enable={yes, no} Default is yes ModelID= It identifies the printer for the purpose of choosing a Linux printer driver. For example, Dell B5465dnf Laser MFP. Name= It provides both the name that is given in the local printers list and the internal name of the local print queue. The name must be between 1 and 16 characters, starting with a letter and composed entirely of letters, digits, underscores, and dashes.
9 TimeZone Parameter Values The following table contains the supported values that you can use for the TimeZone parameter. Table 21. TimeZone Parameter Options Option Values Date_time.TimeZone= Africa Or TimeZone The following values must be preceded with Africa/. For example, Africa/Abidjan is the value for the Abidjan time zone. Abidjan, Accra, Algiers, Bissau, Cairo, Casablanca, Ceuta, El_Aaiun, Johannesburg, Khartoum, Lagos, Maputo, Monrovia, Nairobi, Ndjamena, Tripoli, Tunis, Windhoek.
Option Values The following values must be preceded with Asia/. For example, Asia/ Amman is the value for the Amman time zone.
10 Keyboard layouts and Parameter Values The following table contains the values that you can use for the Keyboard.layouts parameter to designate the keyboard type. Table 22. Keyboard.
Language Keyboard layout Values Dzongkha Dzongkha bt English (Antigua and Barbuda) English-Cameroon Multilingual (qwerty) cm+qwerty English (Australia) English-Cameroon cm English-Ghana gh English-India, with Rupee Sign in+eng English-Mail, US Macintosh mt+us-mac English -Mail, US international ml+us-int English- Nigeria ng English- South Africa za English- UK gb English- US za Filipino ph Irish le Serbo-Croatian(us) us+hbs English-Cameroon Multilingual (qwerty) cm+qwerty
Language Keyboard layout Values French fr French-Belgian be French-English-International AltGR Deadkey altgr+intl French-Canada ca French-Doemocratic Republic of the Congo cd French-Guinea gn French-Mali, alternative ml+fr-oss French-Switzerland ch+fr ch+fr_nodeadkeys—Enables you to set the French-Swiss keyboard layout and disable the dead keys on the keyboard.
Language Russia (Russian Federation) Russian(Ukraine) Keyboard layout Values Romanian (Germany) md Russian ru Russian-Georgia ge+ru Russian-Kazhagstan with Kazhag kz+ruskaz Russian-US ponetic us+rus Serebian-Russia ru+srp Russian ru Russian-Georgia ge+ru Russian-Kazhagstan with Kazhag kz+ruskaz Russian-US ponetic us+rus Serebian-Russia ru+srp Serbian( Serbia) rs Slovak sk Slovenian si Spanish (Spain) Spanish es Spanish-Latin America latam Spanish (Argentina) Spanish e
Language Keyboard layout Values Thai th Turkish tr Uighur cn+ug Uyghur cn+ug Uzbek uz Uzbek(Latin) uz+latin Uzbek(Afghanistan) af+uz-olpc Vietnamese vn Yoruba ng+yoruba Yakut ru+sah Wolof sn 62 Keyboard layouts and Parameter Values