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. © 2018 - 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.
Rules and Recommendations for Constructing the INI Files In general, Dell Wyse ThinLinux files follow currently accepted standard INI file formatting conventions. The INI files consist of Dell Wyse parameters. You can have totally empty INI file or an INI file that has other parameters, and rest of the parameters can be used if you desire, but are not necessary unless you want changes from client and other defaults for example, other can be the default resolution of your monitor.
Option Value $IP IP Address used. $DN Sign-on domain name used. $UN Sign-on name used. $PW Sign-on password used. $TN Terminal name. $PLATFORM Model of the thin client. 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 must need an FTP server to download your INI files and the path to download is specified in the INI page on the thin client.
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 AutoEnroll={yes, no}] ChallengePassword — Certificate Enrollment Challenge Password, it can be obtained from the SCEP Server. NOTE: For HTTPS SCEP certificate we need to import the domain root certificate. Use ImportCerts parameter to do the same. CADN — CA Distinguished Name(Unique name to identify the CA). AutoEnroll — To enable Automatic enrollment of certificates.
Parameter Description contact="" The values set in the Custom info is displayed on the System information page. custom1="" custom2="" If there are spaces in the parameter, place the parameter within double quotes. custom3="" DelayedUpdate.Enable={true, false, yes, no} Default is true DelayedUpdate.Enable parameter enables or disables the updatings. DelayedUpdate.Mode={image} Default is image – updates the image only.
Parameter Description For the parameter ForceDownload, if the value is set to yes, the desktop background wallpaper is downloaded and changed in the local client. For the parameter ForceDownload, if the value is set to no, the desktop background wallpaper does not download. The wallpaper is not changed in the local client. DesktopAppliance={ none, citrix} You can disable or enable the thinuser specific VDI KIOSK theme. Desktop.KeyBinding.Minimize= Default is disabled Desktop.KeyBinding.
Parameter Description EnableGKey={true, false} Default is true EnableGKey option is used to enable G key reset. EnableSsh={yes, no} Default is no, SSH server disabled. You can enable or disable SSH server. EnableTLSRSA=(yes/no) For Citrix only By default, the parameter Enable_TLS_RSA_ is set to Yes. Use this parameter to enable or disable the deprecated cipher suites. EnableRC4MD5=(yes/no) For Citrix only By default, the parameter Enable_RC4-MD5 is set to No.
Parameter Description It is the password used when importing the configurations file from an FTP server. MerlinUpdate.Username= The username used to login the server. MerlinUpdate.Password= Default is base-64 encryption. The password is used to login the server. MerlinUpdate.URL= The URL to the Merlin base. Macro $PLATFORM is automatically appended for Merlin imaging. MicMute={yes, no} Default is no If MicMute is set to yes, then it mutes the microphone volume.
Parameter Description NOTE: If root path is not provided, /wyse is the default. The directory name /wlx2 is appended to the root path entry before use, if /wlx2 folder is not available then /wlx will be the fall back default. SaveMultiMonitorPref={yes, no} This parameter allows you to save the position of a desktop session, and then relaunch it in the same position. SCEPCLIENTCERTSETTINGS=CertName= \ This parameter allows deployment of certificates with SCEP HTTPS protocol.
Parameter Description NOTE: Password string must not contain single quote character. VNCServer.VncPrompt={yes, no} Default is no This parameter is used to enable a popup dialog asking for accepting the incoming VNC connection request. The dialog has the followings: Yes and No button to select. If you do not click on anything, default will be No after Timeout is reached in 120 seconds by default. VNCServer.VNCWarning={yes, no} Default is yes.
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 DisplaySettings=MON1 MON2 MON3 or The string value is in the format of white space separated string construct. The values keywords are case sensitive.
Parameter Description 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. (Optimal resolutions in horizontal placement and MON1 on the left as primary display). DDC Resets all the monitors to default layout and default resolutions – The default layout is all in HORIZONTAL placement, Primary is MON1 and resolutions are optimal.
Parameter Description 1000 - slowest NetworkPrinter= < LPD> For Example: NetworkPrinter=LPD
Parameter Description Front_Usb_Port=[Enable\Disable] This parameter allows you to enable or disable front USB port and same setting is displayed in the BIOS setup menu in Settings & System. The current BIOS password is required to make the changes. BIOS_Password= Rear_Usb_Port=[Enable\Disable] BIOS_Password= This parameter allows you to enable or disable rear USB port and same setting is displayed in the BIOS setup menu in Settings & System.
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 For example: DomainList = dell; SQA; wyse DisableDomain={ True, False} DisableDomain parameter is used to disable the display of a Domain field. The default value depends on the value of the Domain List option. When the Domain List is empty, DisableDomain defaults to yes. Otherwise, it defaults to no. The Domain field does not appear either of the cases.
Parameter Description 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.HideHistory ={yes, no} For Firefox Browser only This parameter disables the history icon from the open menu. The default value is Yes.
Parameter Description 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. ICAComports=
Parameter Description 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. To enable or disable mapping of all the devices listed in the standard mount point. For example, /run/media.
Parameter Description Default is False or No ICAProxyHost=< IP address> For Citrix only. Specifies the firewall server address for the ICA connection. When configuring an alternate address for firewalls and HTTP, SOCKS is used for ICAProxyType, you must provide the proxy server IP address and port. Each entry with optional port is specified as host:port, where :port is optional. If not specified, port depends on the browsing protocol. ICAProxyType={ None, HTTP, SOCKS} For Citrix only.
Parameter Description 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. PAMLoginEnabled option allows the user to set /reset the domain value and allows the user to enable or disable PAM login. Default value is no. PNAgentServer=[:][; [:]] Specifies a list of PNAgent servers or complete URL.
Parameter Description 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. 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.
Parameter Description [CACertificate= WPA&WPA2ENTERPRISE — WPA and WPA2 Enterprise DYNAMICWEP — Dynamic WEP (802.1x) AuthType Notes: AuthType should be OpenSystem or SharedKey when Security is WEP40/128-BITKEY or WEP128-BITPASSPHRASE; For other enterprise securities, AuthType should be 'TLS/LEAP/TTLS/PEAP'. For WPA & WPA2 Enterprise security, only the LEAP authentication type is supported. WEP-KEY Notes: WEP-KEY1 through WEP-KEY4 are optional. WEPKEYINDEX= is optional.
Parameter Description 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\ Connection Settings Parameter Options 29
6 Custom GNOME Settings Parameter Options The following table contains parameters used for configuring Custom GNOME settings where default values are underlined. Table 6. Custom GNOME Settings Parameter Options Parameter Description Custom.Menus= The value of Custom.Menus is a non-quoted string. The menu item which appears in the Settings App (in English) is used as the NAME.
Parameter Description 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. yes: Date and Time icon is enabled on Taskbar in user mode. no: Date and Time icon is disabled on Taskbar in user mode. Custom.Taskbar.
7 Connect Parameter Options This section provides the options that you can use for the Connect parameter in the following supported connections: • • • • • • • • Browser Connect Options Custom Connect Options Citrix Connect Options RDP Connect Options SSH Connect Options VMware View Connect Options VNC Viewer Connect Options Ericom PowerTerm Connect Options Topics: • • • • • • • • Browser Connect Options Custom Connect Options Citrix Connect Options RDP Connect Options SSH Connect Options VMware View Conn
Option Description 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. LocalCopy={no, yes} Default is no. You can use the local copy of the ini file. Mode={kiosk, normal} Default is normal.
Option Description Specifies a command to execute. For xterms, it is recommended to use the -ls option, because it is a login shell. Description= Default is none Connection description provides a connection name for the Desktop icon and the Connection Manager. CAUTION: The text must be enclosed in quotation marks, if it contains spaces or punctuation characters. These characters are not allowed & ‘“$?!|;()[]{}\ Icon= Specifies an icon to appear on the local desktop or Connection Man
LowBand=Yes \ LocalCopy=no Example: Published application connection connectionCONNECT=ICA \ BrowserIP=192.168.1.2 \ Application="Desktop" \ Description="ICA_Desktop " \ AutoConnect=Yes \ Reconnect=Yes \ Encryption=128 \ Colors=16m \ Fullscreen=No \ Resolution=1280x1024 \ Username=$UN \ Password=$PW \ Domainname=$DN \ Alternate=Yes \ LowBand=Yes \ LocalCopy=no Example: Storefront Connection: Connect=ICA \ Application="win81" \ Browserip=hostname.domain.com \ Description="Store-Xendesk7" \ AutoConnect=no \ H
Table 9. Citrix Connect Parameter Options Options Description Application= Specifies the name of the published application to be launched. The names of the applications to be published can be configured by the administrator. It is a mandatory option for launching PA and Storefront connections. For Example: Notepad AutoConnect={yes, no} Default is no.
Options Description Enable this parameter for a specific connection if the setting parameter pertaining to that connection needs be stored in the registry permanently, if enabled the settings parameter will be stored across system reboot. LowBand={yes, no} Default is no. To enable optimization for low-speed connections, such as reducing audio quality or decreasing protocol-specific cache size. NoReducer={yes, no} Default is yes. You can enable or disable the compression during the session.
Options Description Seamless option is applicable only for Published Application and Storefront connections. SmartCard={ Yes,no} Default is no. When set to yes, this option enables logging into the Citrix Server with a Smart Card PIN. This parameter is not applicable for PA connections. SmartCardType={ GEMALTODOTNET, CAC, PIV} Specifies the type of the smart card you are using to make the connection to the Storefront Server.
Drives=k=floppy \ Sound=off \ LocalCopy=Yes \ UseRDGateway=Yes \ RDServer=192.168.1.2 \ SameLoginForRD= Yes \ RDUserName=$UN \ RDPassword=$PW\ RDDomainName=$DN Table 10. RDP Connect Parameter Options Options Description Application= Specifies the remote application that you want to launch through RDP AutoConnect={no, yes} Default is no This option is used to start a connection automatically at sign-on. Colors={ 4b,32k,64k,16m } Default is 4b. Specifies the session color mode.
Options Description EnableH264={yes,no} Default is Yes. NOTE: Use this option when connecting to a server with data encryption between the communication of the server and the client. EnableUDP={Yes,No} Default is Yes. ForwardPrinters={yes, no} Default is yes. Yes/no option to enable the forwarding and use of all available printers to or with the RDP session. Any direct RDP connection is supported (not supported through VMware View broker).
Options Description $MAC — MAC address $IP — IP Address $DN — Sign-on domain name $UN — Sign-on name $PW — Sign-on password $TN — Terminal name Ping={yes,no} Default is no. Ping option is used to enable ping. For non-published application connections, a ping (ICMP) is sent to the host server prior to connecting to verify that the host is reachable. RDDomainName= Specifies the RD Domain name to use for the RD Gateway Login.
Options Description UseRDGateway={yes,no} Default is yes. UseRDGateway option is used to enable RD gateway. Username={, $SN, $MAC, $IP, $DN, $UN, $PW, $TN} Default is none. Specifies the name required to log in to the RDP server. Either a conventional login name or a variable can be used.
Option Description Description= Connection description provides a connection name for the Desktop icon and the Connection Manager. CAUTION: The text must be enclosed in quotation marks if it contains spaces or punctuation characters. These characters are not allowed & ‘ “ $ ? ! | ; ( ) [ ] { } \ Host= Default is none Specifies the server name or IP address to connect. NOTE: This option is mandatory.
useSSL=Yes \ Interactive=No \ Securemode=donotverify \ Fullscreenmode=Yes \ Disableconnectonce=Yes \ Username=$UN \ Password=$PW \ Domainname=$DN \ Ping=Yes \ Protocol=PCoIP \ Application=Calculator Table 12. 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.
Option Parameter EnableH264={yes,no} Specifies whether H.264 decoding should be enabled in the session. Default is yes. Fullscreenmode={no, yes} Default is no. This option enables full screen mode and when selected it disables the Desktopsize option. EnableMMR={yes,no} Default is no. Enable/disable MMR in VMWare View connection settings. Host= Default is none Specifies the server name or IP address to connect. NOTE: This option is mandatory.
Option Parameter You can enable the ping using Ping parameter. For non-published application connections, a ping (ICMP) is sent to the host server prior to connect, to verify that the host is reachable. Port= Default is 443. Specifies a different port number other than default 443 for SSL connection. Protocol={PCOIP, RDP, Blast} Default is PCoIP. Specifies the protocol to use. Reconnect={no, yes} Default is no.
Option Parameter later is !aNULL:kECDH+AES:ECDH+AES:RSA +AES:@STRENGTH. The default value for Horizon Client 3.4 and earlier is AES:! aNULL:@STRENGTH. sslProtocolString This parameter configures the cipher list to restrict the use of certain cryptographic protocols before establishing an encrypted SSL connection. The default value for Horizon Client 3.5 and later is TLSv1.0:TLSv1.1:TLSv1.2. The default value for Horizon Client 3.4 and earlier is TLSv1.0:TLSv1.1.
Options Description The following characters are not allowed: & ‘ “ $ ? ! | ; ()[]{}\ FullScreen={ yes, no} Default is no. VNC session will run at full screen, if FullScreen is set to yes. Host= [;...] Specifies a host or lists of host values. The thin client attempts to connect to the next server on the list if the current one fails. The list items must be separated by semicolons or commas. NOTE: This parameter is mandatory.
Ericom PowerTerm Connect Options The following table contains the supported options you can use for Ericom PowerTerm Connect, where default values are in bold: Example: CONNECT=Ericom_Powerterm \ Description="Ericom_Test" \ Host=192.168.0.2 \ 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
Options Description Host= [; .....] Mandatory option Specifies the host. The thin client attempts to connect to the next server on the list if the current one fails. To separate the list items, use semicolons or commas. Icon= Specifies an icon to appear on the thin client desktop for this connection. The file must be located in the server wlx2/bitmap directory. If not specified, the default icon is displayed. A PNG, JPEG, or GIF may be used.
8 Printer Parameters Option This appendix provides the options that you can use for the following supported printer parameters: • • • • • Printer JetDirectPrinter NetworkPrinter PrinterURI SMBPrinter Topics: • • • • • 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.
JetDirectPrinter The Following Table contains the supported options you can use for the JetDirectPrinter parameter where defaults are in bold: NOTE: The JetDirectPrinter command line defines a printer served an HP JetDirectprint server. Table 16. JetDirectPrinter Parameter Options Options Description Default={yes, no} Default is yes Description= Not used internally.
Options Description between 1 and 16 characters, starting with a letter and composed entirely of letters, digits, underscores, and dashes. NOTE: This parameter is mandatory PPD= It directly specifies a Postscript Printer Definition filename for use, as a local printer driver. PrinterID= Identifies the printer for the purpose of choosing a Windows printer driver. For example, Brother MFC-420CN Printer.
SMBPrinter The following table contains the supported options you can use for the SMBPrinter parameter where default values are in bold: Table 19. SMBPrinter Parameter Options Option Description Default={yes ,no} Default is yes Description= Not used internally. domain= string It provides domain to SAMBA server. Enable={yes, no} Default is yes ModelID= It identifies the printer for the purpose of choosing a Linux printer driver.
9 TimeZone Parameter Values The following table contains the supported values that you can use for the TimeZone parameter. Table 20. 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 21. 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 Galician Spanish Es German (Germany) German de Belgian be English(International AltGr dead keys) us+altgr-intl German- Austria at German- Switzerland ch Italian(Switzerland) it Italian(Italy) it Japanese Japanese jp Korean Hangul ko Itali
Language Keyboard layout Values Serbian( Serbia) rs Slovak sk Slovenian si Spanish (Spain) Spanish es Spanish-Latin America latam Spanish (Argentina) Spanish es Spanish (Bolivia) Spanish(Latin America) latam Spanish (Chile) Spanish (Colombia) Spanish (Costa Rica) Spanish (Cuba) Spanish (Dominican Republic) Spanish (Ecuador) Spanish (El Salvador) Spanish (Guatemala) Spanish (Honduras) Spanish (Mexico) Spanish (Nicaragua) Spanish (Panama) Spanish (Paraguay) Spanish (Peru) panish (Puerto Ri
Language Keyboard layout Values Yoruba ng+yoruba Yakut ru+sah Wolof sn Keyboard layouts and Parameter Values 61
