Dell Wyse ThinLinux Version 2.2 Administrator’s Guide December 2020 Rev.
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2019 - 2020 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents Chapter 1: Introduction................................................................................................................. 6 About this guide................................................................................................................................................................... 6 What is new in ThinLinux 2.2.1.04—Maintenance Release 4................................................................................... 6 What is new in ThinLinux 2.2.1.
Original Equipment Manufacturer branding...........................................................................................................51 Configuring universal access.................................................................................................................................... 53 Chapter 4: Configuring Connections locally ................................................................................ 56 Configuring and managing the browser connections.......................
Setting up the automatic configurations and updates............................................................................................ 114 Preparing the root directory and folder structure on the server....................................................................114 Directing the thin client to the server................................................................................................................... 115 Appendix B: DHCP options tags.........................................
1 Introduction Wyse ThinLinux 2.x combines the security, flexibility and market-leading usability of Ubuntu Linux with Dell's optimizations in management and user experience. It is ideal for organizations that want to run server-based, web-based, or local applications without the deployment and security concerns of a non-standard Linux distribution. About this guide This guide is intended for administrators of thin clients running Dell Wyse ThinLinux.
What is new in ThinLinux 2.2.1.00 Added support for the Wyse 5470 Thin Client. What is new in ThinLinux 2.2.0.01—Maintenance Release 1 ● Added support for Citrix HDX RealTime Media Engine (RTME) version 2.8. ● Added support for VMware Horizon View Client version 5.0. ● Changes to the Login and Experience tabs of the VMware connection UI. See Configuring and managing VMware connections. ● Changes to the Manage VNC UI. See, Setting the VNC server preferences. What is new in ThinLinux 2.2.0.
2 Getting started Use the following information to learn the basics and get started using your thin client: ● Logging in to your thin client device ● Using your ThinLinux desktop ● Configuring thin client settings and connections ● Viewing system information ● BIOS settings Logging into your thin client device On your initial configuration, Dell recommends that you connect by using a wired connection by plugging in the network connected Ethernet cable to your thin client.
Figure 1. Application overview screen ● Application Icons—To access the application icons, click the dots on the lower-right corner of the screen. You can start the application by clicking a particular application icon. If there are more application icons, the icons are displayed on multiple pages. ● Taskbar—The taskbar is displayed at the bottom of the Application overview screen (ThinLinux desktop).
Using the taskbar Use the taskbar to view the time, configure the volume settings, view system information, view network information, shut down the thin client, view keyboard settings, and switch to desktop screen. The taskbar consists of quick launch icons and taskbar buttons: ● Show Desktop—Click this button to switch between the Desktop view screen and Application Overview Screen. ● Power—Use this button to shut down, restart, or suspend your thin client.
￭ BIOS Version ○ Custom Info ￭ Location ￭ Contact ￭ Custom 1 ￭ Custom 2 ￭ Custom 3 ● Network tab—Displays network information such as: ○ Network Device—eth0 and wlan0 ○ Interface Information ￭ MAC address ￭ Network Speed ￭ Maximum Transmission Unit (MTU) ○ IP Information ￭ IP Address ￭ IPv6 Address ￭ Subnet Mask ￭ Gateway ￭ Domain ￭ Primary DNS ￭ Secondary DNS ￭ DHCP Server ￭ Lease ￭ Elapsed ● Packages tab—The packages tab displays the add-ons.
3 Configuring thin client settings locally This chapter contains information to help you set up your thin client hardware, look and feel, and system settings. client settings, The default password is admin. To 1. 2. 3. configure the thin client settings, do the following: Click the Switch to Admin button to enter into the Admin mode. Enter the default password in the displayed window. Click the Settings icon on the desktop. The System Settings page is displayed.
Changing system settings On the System Settings page, click the System icon. The following tabs are displayed on the left pane of the System Settings page. ● ● ● ● ● ● ● ● ● Addons Custom Info Date and Time Desktop Appliance Display Language Other Settings Power Update Settings Configuring the addons The Add-ons page enables you to install and remove Add-ons from INI server. As a prerequisite, you must configure the location of add-ons on the Manager INI Configuration page.
4. Click Save to save the changes. NOTE: To remove an add-on, click the x icon, select the add-ons that you want to remove, and click Remove Add-ons. Setting the custom information The Custom Info page enables you to set the device details. Figure 4. Custom Information To set the custom details for your thin client, do the following: 1. In the Location field, enter the device location. 2. In the Contact field, enter the contact details of the concerned authority. 3.
NOTE: By default, the Date and Time screen is available only in Admin mode Figure 5. Date and time settings 2. To configure the Date and Time settings manually when the Set Time Automatically switch is in OFF position. a. Click the date field and select the year, month and date. Any changes performed in the date field such as, the time format is selected as 24 Hours or an additional AM/PM format, is displayed at the top of screen. The time field consists of Hour and Minute drop-down list. b.
NOTE: ● The Up arrow is enabled when the particular NTP server can be moved to the top in the NTP Server list and it is disabled when the particular NTP server is listed at the top of the NTP Server list. ● Click Down arrow to change the order of the particular NTP by moving it down in the list. ● The Down arrow is enabled when the particular NTP server can be moved down in the NTP Server list and it is disabled when the particular NTP server is listed at the bottom of the NTP Server list. 4.
3. Select the type of Citrix Server. Citrix server, Protocol and Storename can be configured from the Change global settings page. Go to All connections page, select the Citrix option and then select the Change global settings option to configure the Citrix settings. For more settings for Applications or Desktops, go to All connections page, select Citrix option and then select Change global settings option to configure the Applications or Desktops settings. 4. Click Save.
Figure 8. Authentication screen If the logon authentication fails, you are prompted with a screen. Click try again to query the server again. NOTE: You can break kiosk mode and enter into admin mode at any point of time by using the shortcut key. The shortcut key is Ctrl + Alt + Shift + F11. b. After the successful login, you can add the required applications or desktops from the left + button. c. Click the application or desktop to start it. You are prompted with an error if there as an error message. d.
Figure 10. Citrix connection center Customizing the display By default, the Customize your display screen is available in both user mode and admin mode. Any changes to display preferences are saved and available for the built-in user named thinuser. In a Dual-display configuration, if both displays are connected, then by default, the displays are in the extended mode. The primary display is on the left (display 1), and the secondary display is on the right (display 2).
Figure 11. Display settings 2. To set a common resolution for all the connected displays, click the ON/OFF button. 3. From the Resolution drop-down list, select the preferred resolution. 4. From the Rotation drop-down list, select the rotation. ● ● ● ● Normal Right Left Upside-down 5. To enable the screen mirroring for secondary displays in a multi display configuration, click the ON/OFF button. 6. To enable the Set as primary option, click the ON/OFF button.
NOTE: To turn off a display, select a display from the display grid, and click the Display OFF button. Ensure that you arrange all the active displays first and move all the inactive displays to the end of the layout. 3. To enable the Set as primary option, click the ON/OFF button. This option enables you to set the selected display as the primary display. 4. To set a common resolution for all the connected displays, click the ON/OFF button. 5.
Figure 13. Vertical layout ● 3 screens per column—Enables you to drag the applet window from the primary display to the rest of the displays as described in the following table. For example, you can drag the applet window from PM1 to M2 horizontally, or to M3 vertically.
Figure 14. 3 Screens Per Column Layout Table 2.
Figure 15. 2 screens per column Table 3. 2 screens per column Applet window placement at display Traverse horizontally to display Traverse vertically to display Primary display (display 1) Display 2 Display 4 Display 2 Display 3, Primary display (display 1) Display 5 Display 3 Display 2 Display 6 Display 4 Display 5 Primary display (display 1) Display 5 Display 4, Display 6 Display 2 Display 6 Display 5 Display 3 NOTE: ● You cannot drag the applet window diagonally across displays.
Figure 16. Language settings Other settings The Other Settings page enables you to enter the hostname of the thin client to add or delete the additional entries to the /ect/hosts file in the device. Any changes that are made through Other Settings screen are saved and preserved over reboots for the built-in thinuser. The Other Settings screen is available only in admin mode.
Figure 17. Other settings To configure the other settings, do the following: 1. In the Source section, configure one of the following options: ● Contact DHCP server—If you set the hostname of the thin client by selecting the DHCP server option, the hostname is set to the standard host-name tag received from the DHCP server. If the DHCP server does not provide the hostname tag, the device retains the previously set hostname.
b. Click the Add option, and update the default data. 3. In the Hide Desktop icons section, configure any of the following options: NOTE: These options are applicable for user mode only. ● Firefox Web Browser—Click the ON/OFF button to enable or disable this option. If you enable this option, the Mozilla Firefox web browser icon is not displayed on the desktop. ● Google Chrome—Click the ON/OFF button to enable or disable this option.
2. From the Auto Lock Screen after Turn off screen drop-down menu, select the time to lock the thin client automatically after the display is turned off. 3. From the Suspend System Setting drop-down menu, select the time in seconds to suspend the thin client after the specified idle time. This option enables your device to enter the S3 power state (low-power), and quickly resume your work without rebooting the device. NOTE: By default, the idle time is set to 15 minutes.
Figure 19. Delayed update settings Execute Preserve User Setting—Use this option to retain the previous settings after you upgrade the ThinLinux build to the latest version. To enable the preserve user settings, click the link. This option is supported only when imaging is performed using the USB Imaging tool. Peripherals On the System Settings page, click the Peripherals icon. The following tabs are displayed on the left pane of the System Settings page.
Figure 20. Bluetooth settings 2. After the Bluetooth is enabled, click Save. On the upper-right corner of the screen, the Bluetooth Enabled notification is displayed for a few seconds. 3. Click the Bluetooth icon to start searching for Bluetooth devices. The thin client searches and lists the Bluetooth devices that are discoverable. NOTE: If the Bluetooth ON/OFF button is disabled, the device does not support the Bluetooth functionality. 4. Click the Bluetooth device from the list. 5.
NOTE: By default, the Keyboard screen is available in both User mode and Admin mode. Any changes made through Keyboard preferences screen is saved and preserved over reboots for the built-in thinuser Figure 21. Keyboard preferences 1. Click the ON/OFF button to disable or enable the Key presses repeat when held down option after you log in to the session. 2.
Figure 22. Mouse and touch pad settings The Mouse and Touchpad settings page enables you to set the mouse and touch pad preferences. 1. Click Right or Left to set the primary button of the mouse or touchpad. 2. Move the slider to the left to increase the speed of the pointer when double-clicked or move the slider to the right to decrease the length of double-clicked. 3.
Figure 23. Printers - localhost 1. Click the printer icon. The Printers - localhost dialog box is displayed. 2. Click the Add button to include a new printer. The New Printer window is displayed. You can configure the printer type based on your preference. NOTE: If a USB printer is connected, then it is displayed by default. The printer is not found if wrong address is provided or the USB is not attached. 3.
NOTE: You can click Print Test Page to test the printer. 8. Right-click the printer icon, and click Properties. 9. Configure the following tabs based on your printing preference: ● Settings—Use this tab to configure the location, device URL, model, and printer state. ● Policies—Use this tab to configure the printer state, error policy, operation policy, starting banner, and ending banner. ● Access Control—Use this tab to set the printing privileges to users.
Figure 25. Sound output a. From the output devices list, select a device for sound output. The default audio output is the Analog Output. b. Based on the channels available for the selected output device and profile, move the Balance slider to adjust the sound balance. c. From the drop-down list, select an audio profile. d. Click Test Speakers. A dialog box is displayed. You can test the speaker by playing sample wave files. 4. Click the Input tab, and do the following: Figure 26.
a. From the input devices list, select a device for sound input. The default audio input is the Analog Input. b. Move the Input Volume slider to adjust the input or Mic volume. Click the ON/OFF button to enable or disable the input volume. The Input level bar displays the input volume peak level. 5. Click the Sound Effects tab, and do the following: Figure 27. Sound effects a. From the alert sound list, select an alert sound theme. b. Move the Alert Volume slider to adjust the volume level of alert sounds.
Figure 28. Applications Managing the USB ports and devices The USB Manager page enables you to configure and manage the USB ports and devices that are connected to your thin client. To configure the USB port and device settings, do the following: 1.
Figure 29. USB Manager ● Enable USB Boot Support—Click the ON/OFF button to enable or disable the USB boot setup. If this option is enabled, you can use a USB storage device to boot the operating system. ● Enable Exernal USB Ports—Click the ON/OFF button to enable or disable the external USB ports. If the USB port is disabled, the operating system cannot detect the device that is attached to this port. ● BIOS Password—Enter the BIOS password.
○ Disable all USB Devices ○ Disable by USB Class ● Disable by USB Class—Click the ON/OFF button to enable or disable this option. If this option is enabled, you must configure any of the following options: ○ Disable Video Devices—Click the ON/OFF button to enable or disable this option. If this option is enabled, the operating system does not detect the video devices that are connected to the thin client. ○ Disable Storage Devices—Click the ON/OFF button to enable or disable this option.
Figure 30. Wi-Fi Settings 3. To connect to Wi-Fi connection, select the preferred wireless SSID from the list displayed. 4. Click the Connect to Hidden Wi-Fi Network button. The Connect to Hidden Wi-Fi Network window is displayed.
Figure 31. Hidden Wi-Fi Network 5. Enter the name and security details of the hidden network that you want to connect to. Table 4. Hidden network Parameter Description Network name Enter the preferred network name. Wi-Fi security From the drop-down list, select the security type. 6. On the Network page, click the History button to view the previous Wi-Fi connections and details. Configuring wired network connection settings To configure the wired connection settings, perform the following steps: 1.
● ● ● ● IPv6 Address Hardware Address Default Route DNS 4. Click the Security tab to configure the 802.1x security settings. a. Click the ON button to enable the 802.1x Security for your network connection. b. From the Authentication drop-down list, select the type of authentication you want to set for your network connection. The available options are: ● TLS ● Protected EAP (PEAP) You must configure TLS and PEAP using the INI parameters only.
Table 5. Automatic (DHCP) (continued) Parameter Description Metric Specifies the Metric value for the network connection. Use this connection only for resources on its network Select this check box, if you want to allow the wired connection only for resources on its network. d. If Manual option is selected, you must specify the IP address, Netmask IP and Gateway IP along with the parameters mentioned in the Automatic (DHCP) table. e.
Adding a network connection NOTE: Adding additional wired Ethernet connections is allowed but the added interface is not used in any of the ThinLinux features. To add a new network connection, complete the following tasks: 1. On the lower-left corner of the page, click the + icon. The Add Network Connection dialog box is displayed. The following options are listed for you to configure. ● VPN ● Bond ● Team ● Bridge ● VLAN 2. Click VPN to add a VPN network connection.
Ordered Click List AddNumber to add an 5 IP address. After an IP is added, Netmask, Gateway and Metric specific to that IP are displayed. Ordered SelectList theNumber check box 5 if you want to ignore the automatically obtained routes. Ordered SelectList thisNumber check box 5 if you want to use your connection only for resources on that particular network. ● If Automatic (DHCP) addresses only method is selected, you must configure the following options: i.
5. Click Bridge to add and configure the bridge network connection for your thin client. a. Click the Bridge tab, and configure the following options: i. Interface name — Type the name for your network interface. ii. Bridged connections — The number of bonded connections that are set up are listed here. To add a new bond connection, click the Add button and select the type of connection you want to create. The available options are Ethernet, Wi-Fi, and VLAN. iii.
NOTE: EAP-TLS security requires client side and server side certificates for mutual authentication. Every user and client, including the authentication server that participates in EAP-TLS, must have at least the following two certificates: ● Client certificate signed by the certificate authority (CA). ● Copy of the CA root certificate. NOTE: Dell recommends you to set INI values for all the 802.
be sure that the CA certificate name is correct in the 802.1x INI parameter. For more information, see Dell Wyse ThinLinux INI Guide. ● If you are using CA certificate for 802.1x authentication, then use the ImportCerts INI parameter to import CA certificates into the device. Ignoring CA certificate is considered as the default option, if the CA certificate name is not included in the 802–1x INI configuration. ● Domain List INI parameter is required to display the available domains on the GDM login screen.
● Set the same password for all machine/host name accounts to be created. ● The INI parameter should contain a MachinePassword Field that can be used for authentication. To authenticate 802.1x using Machine name (Host name): 1. Turn on your thin client device. Once the INI is downloaded to the thin client and all the 802.1x parameters for machine PEAP authentication are retrieved from the INI server, the authentication starts in the background.
● When a user restarts the device, the thin client will again move to the Guest VLAN by sending an EAPOL logoff to switch and disable the 802.1x configuration at the Network Connections applet. This is an example of the INI configuration for 802.1x TLS Machine authentication. Enable802=yes Authentication=TLS PromptPassword=no CACertificate=scep UserCertificate=scep PrivateKey=scep PrivateKeyPassword=ZG90MXg= AuthMode=Machine EAP TLS User authentication To authenticate 802.1x: 1.
Figure 32. Desktop wallpaper 1. Click Add image to load a desktop wallpaper from the USB drive. The wallpapers are listed on the screen. 2. Select a wallpaper for your desktop. 3. From the Style drop-down list, select a fit option. 4. From the Color drop-down list, select a color for your desktop. Use the desktop INI parameters to download a wallpaper to the thin client forcibly. For more information, see the Dell Wyse ThinLinux INI Reference Guide at www.dell.com/support.
Figure 33. OEM branding - Remote server ● USB device—Select this option, and navigate to browse the file from the USB drive. Figure 34.
2. Click Brand Device. The thin client restarts, and the device branding is customized based on your requirement. Configuring universal access The Universal Access page allows you to configure the display settings, audio settings, typing settings and pointer settings. The Universal Access Menu allows you to improve the look and feel of the desktop. 1. Click the desktop icon on the Universal access page. 2. Click the ON/OFF button to enable or disable the option.
Figure 36. Universal access Seeing The Seeing tab enables you to configure the display settings. 1. Click the ON/OFF button to enable or disable the High contrast option. If enabled, the contrast is increased and you can see the difference instantly. 2. Click the ON/OFF button to enable or disable the Large text option. If enabled, the text size is increased and you can see the difference instantly. 3. Click the ON/OFF button to enable or disable the zoom option.
4. Click the ON/OFF button to enable or disable the Screen Reader option. If enabled, the screen reader reads the displayed text as you move the text. 5. Click the ON/OFF button to enable or disable the Sound Keys option. If enabled the beep sound when number lock or caps lock is clicked is turned ON. Hearing This section allows you to configure the Audio alerts by providing an visual indication. 1. Click Visual Alerts to configure the visual effects. 2.
4 Configuring Connections locally On ● ● ● ● ● ● ● ● the System Settings page, click the Connections icon. The Connections page contains the following tabs: Browser Citrix Custom Ericom PowerTerm RDP SSH VMware VNC Viewer NOTE: The description names for all the connections cannot be edited once you create the connection. Configuring and managing the browser connections The Browser Connections page enables you to create and manage Firefox browser connections for your thin client. Figure 37.
Figure 38. Browser connection login settings 2. In the Login tab, enter the URL address of the browser connection you want to connect to. 3. Enter the name of the Browser connection for which you have specified the URL address. 4. Click the ON/OFF button to enable or disable the auto-connect option after you log in to the session. 5. Click the ON/OFF button to enable or disable the auto-reconnect option after you disconnect from the session.
Figure 39. Browser connection experience settings a. From the drop-down list, select the window resolution you want to set for your Browser window. b. Click the Kiosk button to enable the Kiosk mode for your browser. NOTE: When the Kiosk is Enabled, you cannot change window resolution. 7. Click Save to save the changes. The browser connection created by you is displayed in the Browser Connections list. To manage a Browser connection: 1. Hover the mouse over a particular browser connection name.
Figure 40. Firefox settings Table 7. Mozilla Firefox settings Parameter Description Hide Bookmark Click the ON/OFF button to enable or disable this option. If this option is enabled, the bookmark bar is not displayed on the web page. By default, this option is enabled. Hide Downloads Click the ON/OFF button to enable or disable this option. If this option is enabled, the downloaded items are is not displayed on the web page. By default, this option is enabled.
Table 7. Mozilla Firefox settings (continued) Parameter Description Disable About:Add-ons Click the ON/OFF button to enable or disable this option. If this option is enabled, the Add-ons Manager tab is disabled and you cannot configure the add-ons. By default, this option is enabled. Disable About:Preferences Click the ON/OFF button to enable or disable this option. If this option is enabled, the Preferences\Settings Editor is disabled and you cannot configure the Firefox preferences.
Configuring the server connection type If Server is selected as the Connection type, the following options must be configured in the Login tab. Figure 41. Citrix connection login settings Table 9. Server Parameter Description Browsing Protocol From the drop-down list, select your preferred Browsing Protocol. Citrix Server Enter the specific Citrix Server. Username Enter the Username of the server. Password Enter the Password of the server.
Table 9. Server (continued) Parameter Description When disconnect, reconnect Select the time duration in seconds to delay the reconnection attempt after a disconnection occurs. Smartcard login Click the ON button to enable smart card login to the thin client. The User Name, Password, and Domain are not required. NOTE: Smart Card Login is applicable only for Server and Storefront Connections Smartcard type This field is enabled when you select Smart Card Login.
Figure 42. Citrix connection experience settings Table 11. Experience Parameter Description Windows resolution Select the Windows resolution that you want to use on your monitor. The available resolutions are: Default 640 X 480 800 X 600 1024 X 768 1280 X 1024 1600 X 1200 Full Screen Colors Specifies the number of colors to display for each pixel. Select the session color mode to get the faster display performance on your monitor.
Table 11. Experience (continued) Parameter Description RC5 (40-bit) RC5 (56-bit) RC5 (128-bit) NOTE: ● The highest level is 128-bit security and the lowest level is Basic. ● Only Basic, and RC5 128-bit support Citrix XenDesktop 7.15. RC5 40-bit, and RC5 56-bit support Citrix XenDesktop 7.15 and earlier versions. RC5 40-bit and RC5-56 bit support has been deprecated since XenDesktop 7.9. Enable middle button paste login Click the ON/OFF button to enable or disable this option.
Figure 43. Citrix global login settings a. Enter the Citrix server. b. From the drop-down list, select the required browsing protocol. The available options are: ● TCP/IP + HTTP server location ● TCP/IP ● SSL/TLS + HTTPS server location c. Enter the store name. d. Click Show Advance Settings to view and configure the advanced options. i. Click the ON/OFF button to enable or disable the Use Alternate address for firewall option. If enabled, an alternate address can be used for firewall configuration. ii.
Figure 44. Citrix global experience settings a. Click the ON/OFF button to enable or disable the Application Reconnection option. If enabled, the connection is automatically re-established after you disconnect from the session. b. Select the Windows resolution you can use to get the best display on your monitor. c. If you come across over-scrolling when using certain published applications, increase the adjustment by 100 until the display improves. NOTE: The maximum scroll adjustment is 1000. d.
Figure 45. Drive mapping a. Drive Mapping: ● Dynamic Mapping—Dynamic client drive mapping enables virtual desktops to access mass storage devices, such as USB flash drives, configured on the endpoint. The virtual (not local) desktop is responsible for controlling USB drives and displaying them in the user interface. When a USB drive is connected to an endpoint, it is automatically mounted and freely accessible. USB drives accessed using dynamic client drive mapping are treated as network drives.
Figure 46. Dynamic mapping ● Mapping all devices—This option is same as Dynamic mapping but the you will be given an option to select the drive letter and read-write permissions for the drives. When this option is enabled all the usb storage devices which are mounted on /run/media/ will be mapped to the Citrix session. You are provided the option to choose the drive letter and read or write permissions for the drives which have been mounted on to the thin client.
Figure 47. Mapping all devices ● Mapping a single device—Unlike the previous two options, this option enables you to select an individual device that should be redirected to the session. The device name lists all the devices that has been successfully mounted on to the thin client. You will be able to select a drive letter and read-write permission for individual drives that redirect to the session.
Figure 48. Mapping a device To add a COM port, complete the following task: a. Click Add. b. From the COM Port list, select a COM port—1 to 4. c. Select a device from the device list. To delete a COM port, click the X icon next to the COM port that you want to delete. 5. Click Save to save the changes. Managing PAM login 1. Click PAM Login. The Manage PAM Login Settings page is displayed. The PAM login page displays the settings that are used for PNAgent server connection.
Citrix Workspace App ThinLinux supports Citrix Workspace App on both on-premises and cloud environments. Citrix Workspace App enables you to access all your virtual apps, desktops, and other Citrix products from a single workspace UI. For more information about Citrix Workspace App, see the Citrix documentation at docs.citrix.com. Configuring and managing the custom connections The Custom Connections page enables you to create and manage the Custom connection based on shell commands.
Figure 50. Custom connection experience settings a. Click the ON/OFF button to enable or disable the Run in terminal window option. 5. Click Save to save the changes. Configuring and managing the Ericom PowerTerm connections The Ericom PowerTerm connections page enables you to create and manage the Ericom PowerTerm connections. To configure the Ericom PowerTerm Connection Settings, complete the following task: 1. Click the + icon to add a new Ericom PowerTerm Connection.
Figure 51. Ericom PowerTerm login settings Figure 52.
Table 12. Ericom PowerTerm login settings Parameter Description Connection type On the Connection Type page, click the Network or Serial Port radio button depending upon the requirement. By default, the Network option is selected. Serial Port radio button is disabled if the application does not detect any active serial ports. Host Enter the Ericom server host’s IP or FQDN address in the Host field. This field is hidden, if the connection is through Serial Port.
Figure 53. Ericom PowerTerm experience settings Table 13. Ericom PowerTerm Experience Settings Parameter Description Window size Select the desired terminal window size from the drop-down list in the Window Size field. Show menu Click the ON/OFF button to enable or disable this option. It enables the top menu option on the Ericom PowerTerm window. Show toolbar Click the ON/OFF button to enable or disable this option. It enables the toolbar option on the Ericom PowerTerm window.
Figure 54. Ericom PT — PowerTerm Interconnect Configuring and managing RDP connections The RDP connections page enables you to create and manage the RDP connection. The main RDP page has options to create an RDP connection and modify existing connections. To configure the RDP settings, complete the following tasks: 1. Click the + icon to add a new RDP Connection. The RDP Connections page is displayed. 2. Enter the name of the RDP connection. 3.
Figure 55. RDP login settings Table 14. RDP login settings Parameter Description Server Enter the IP address or FQDN of the RDP server to which you want to establish a connection. Username Enter the Username to log in to the RDP Server. Password Enter the Password to log in to the RDP Server. Domain Enter the Domain to log in to the RDP Server.
Table 14. RDP login settings (continued) Parameter Description NOTE: An RD Gateway server is a type of gateway that enables authorized users to connect to remote computers on a corporate network from any computer with an Internet connection. An RD Gateway server enables Remote Desktop connections to a corporate network from the Internet without having to set up virtual private network (VPN) connections. Ask your network administrator whether you need to specify an RD Gateway server.
Table 14. RDP login settings (continued) Parameter Description UDP connectivity is available. If the UDP networking is blocked, the RDP client uses TCP networking. Disable this option to use TCP networking. 4. The following options can be configured in the Experience tab. Figure 56. RDP experience settings Table 15. RDP Experience Settings Parameter Description Window Resolution Select the Windows resolution you can use to get the best display on your monitor.
Table 15. RDP Experience Settings (continued) Parameter Description High Color (16-bit) True Color (24-bit) Best Quality (32-bit) Speed Level Select a speed level to describe the network connection. ● Modem ● Broadband ● LAN ● Custom Sounds Select the relevant option from the drop-down list. You can choose to redirect the audio on the remote session to the local device, or not allow the audio to play on the remote session on the local device, or leave the audio playing on the remote session.
Table 15. RDP Experience Settings (continued) Parameter Description Show window content while dragging Subsampling Enables low-bandwidth optimization. NT4 Compatible Click the ON/OFF button to enable or disable this option. 5. Configure the following tasks in the Peripherals tab. Figure 57.
Configuring and managing the SSH connections The SSH connections page enables you to create and manage the SSH connections. The main SSH connections page has options to create an SSH connection. To configure the SSH connection, complete the following task: 1. Click the + icon to add a new SSH Connection. The SSH Connections page is displayed. 2. Enter the name of the SSH connection. Figure 58. SSH connection settings 3. Enter the IP address or FQDN of the SSH server that you want to connect. 4.
The VMware Connections page is displayed. 2. Enter the name of the VMware connection. 3. Configure the following options in the Login tab. Figure 59. VMware connection login settings Table 16. Login Parameter Description Host Enter the hostname or IP address or FQDN of the Horizon of the VMware View Server. Port Enter the port number of the host. Protocol From the drop-down list, select the specific protocol.
Table 16. Login (continued) Parameter Description Username with Domain Click the ON/OFF button to enable or disable this option. If enabled, specify the domain along with user name. Unauthenticated Access Click the ON/OFF button to enable or disable this option. If enabled, specify the unauthenticated access username. Password and domain credentials are not required. Enable interactive mode Click the ON/OFF button to enable or disable this option.
Figure 60. VMware connection experience settings Table 17. Experience Parameter Description Windows resolution Select the Windows resolution that you want to get the best display on your monitor. The available resolutions are: Use All Monitors Full Screen Large Screen Small Screen 1024 X 768 800 X 600 640 X 480 AutoReconnect after disconnect Click the ON/OFF button to enable or disable this option. If enabled, the connection is automatically reestablished after you disconnect from the session.
Table 17. Experience (continued) Parameter Description Enable fullscreen Click the ON/OFF button to enable or disable this option. Select this option to view the remote session in full screen mode in all the monitors. Disable fullscreen drop-down menu bar Click the ON/OFF button to enable or disable this option. Select this option to disable the drop-down menu bar in the full screen mode. Disable exit on the disconnect Click the ON/OFF button to enable or disable this option.
Figure 61. VMware connection peripherals settings Table 18. Peripherals Parameter Description Click the ON/OFF button to enable or disable this option. Automatically Connect USB when inserted Select this option if you want to automatically connect your USB drive to the thin client after you plug-in the USB drive. Automatically Connect USB at Startup Click the ON/OFF button to enable or disable this option.
3. The following options must be configured in the Login tab. Figure 62. VNC viewer login settings Table 19. VNC viewer login settings Parameter Description Host Enter the IP address or FQDN of the VNC server which you want to connect. Password Enter the password to log in to the remote VNC Server. Auto-connect after login Click the ON/OFF button to enable or disable this option. If enabled, the connection is automatically connected after you log in to your thin client. 4.
Figure 63. VNC viewer experience settings Table 20. VNC viewer experience settings Parameter Description Colors Specifies the number of colors to display for each pixel. Select the session color mode to get the faster display performance on your monitor. The available options are:\ ● True color (full color) ● 8 colors (very low) ● 64 colors (low) ● 256 colors(medium) JPEG quality From the drop-down list, select the preferred value.
Table 20. VNC viewer experience settings (continued) Parameter Description View only Click the ON/OFF button to enable or disable this option. If enabled, the connection is in view-only mode. Mouse and keyboard input to the remote machine is disabled. 5. Click Save to save the changes. Starting VDI session without login credentials To start a VDI session without entering the login credentials, do the following: 1. Create a VDI connection with the following values: ● Set the username as $UN.
5 Security settings On the System Settings page, click the Security icon. The following tabs are listed on the left pane of the System Settings page. ● Accounts ● Certificates ● Firewall ● SSH Server ● VNC Managing the accounts settings The accounts management page is available in the admin mode only. Figure 64. Accounts settings To manage the account settings, configure the following options: 1. Auto Login—Click the ON/OFF button to enable or disable the Auto Login option.
5. Click Save. 6. When prompted, enter the root password, and click OK. Figure 65. Root password Managing the certificates 1. Click the + icon to import a new certificate. The Import Certificate page is displayed. 2. Select the preferred Import Source option. ● Remote Server ● Local Devices a. Remote server Figure 66. Import certificates remote server i. 92 If you select Remote server option, the remote server information is displayed.
i. Enter the Importing server URL. The supported protocols are ftp, http, and https. ii. Browse the required Certificate File. iii. Click the ON/OFF button to enable or disable the Sever from default registry option. ii. User Anonymous: Click the ON/OFF button to enable or disable this option. If disabled, enter the Username and password required for the server. b. Local Devices Figure 67. Import certificates local device i. Click the Browse tab and navigate to the certificate that you want to use. ii.
Figure 68. Firewall settings To configure the firewall settings on your thin client, do the following: 1. To enable firewall, click the ON/OFF button. 2. Type the firewall configuration script in the text box. For example, the following iptables commands can be used to disable ping from the thin client or to the thin client: /sbin/iptables -A OUTPUT -p icmp --icmp-type 8 -j DROP /sbin/iptables -A INPUT -p icmp --icmp-type 8 -j DROP 3. Click Save. 4. When prompted, click Restart.
Figure 69. Manage SSH Configure the following options: 1. Click the ON/OFF button to enable the Enable SSH option. If enabled, the SSH server starts working. 2. Click the ON/OFF button to enable or disable the Enable SSH Root Login option. When the Enable SSH option is enabled, the Enable SSH Root Login option is not enabled automatically. 3. Click Save to save the changes. Setting VNC server preferences Use the VNC server page to configure the VNC server preferences.
Figure 70. VNC server preferences To configure the VNC server preferences: 1. Click the ON/OFF button to enable or disable the Enable VNC option. 2. Click the ON/OFF button to enable or disable the confirmation for accessing each VNC connection option. 3. In the Require the user to enter this password field, enter the password. You can enter a maximum eight characters. 4. Click the ON/OFF button to enable or disable the option to show the VNC access warning at the start of the connection. 5.
6 Additional management configurations On the System Settings page, click the Management icon. The following tabs are listed on the left pane of the System Settings page. ● Active Directory ● Configuration ● HAgent ● INI ● Logs and Tools ● SCEP ● Wyse Device Agent Active Directory ThinLinux enables you to securely connect to the work domain using the Active Directory credentials. Active Directory enables an administrator to enable or disable the user authentication to specific domains.
1. In the Domain Name field, enter the FQDN of the domain. 2. In the User Name field, enter the name of the user who has the relevant permission to add a computer account to Active Directory. 3. In the Password field, enter the password for the domain. 4. In the OU field, enter the name of the organizational unit that is associated with the thin client's domain membership. This is an optional step. 5. Click Join.
i. If you select Remote server option, the remote server information is displayed. Enter the Importing file URL. The supported URLs are ftp, http, and https. ii. Click the ON/OFF button to enable or disable the Use Anonymous option. If disable, enter the Username and password required for the server. iii. Click Import to import the configuration. b. USB Device Figure 73. Import configuration - USB device i. Click the Browse tab. NOTE: You must insert the USB device to import the files. ii.
A warning message is displayed. If you click OK, the system is automatically restarted. Resetting to factory defaults affects only configuration, it will not uninstall or reinstall add-ons that are different than the factory image. HAgent WDM is a device management solution which helps you to manage cloud clients securely from remote infrastructure.
Table 21. Wyse Device Manager Server (continued) Parameter Description Auto Device Discovery is in OFF state. When this option is in ON state, then the clients are discoverable using DNS SRV record lookup. DHCP option Tags Click the ON/OFF button to enable or disable this option. This option will take effect if Enable Auto Device Discovery is in OFF state. When this option is in ON state, then the clients are discoverable using DHCP options Tags.
2. From the drop-down list, select your preferred configuration source. ● Select the Local only source as configuration source. The INI configuration is stored locally on the device. ● Select the Server only source as configuration source, and do the following: a. Click the ON/OFF button to enable or disable the specify server details manually option. b. If enabled, enter the server URL, rootpath, and INI file download path for the secure server.
Figure 76. Logs You can choose one of the following options to export logs: ● If you select the Remote server option, do the following: a. Enter remote file server URL in Export server URL input box. b. Enter your credentials if Use anonymous switch button is not enabled. ● If you select the USB Drive option, do the following: a. Click the Browse tab. The File browser dialog box is displayed. Select a directory from listed USB drive. b. Click Export to export the logs. Table 22.
Table 22. Logs (continued) Log name Description server_parse_ini.log Contains a record of events related to parsing an INI file. configDisplay.log Contains a record of events related to display configurations. Xorg.log Contains a record of events related to the Xorg server. hagent.log Contains a record of events related to HAgent for Wyse Device Manager (WDM). 802-1x.log Contains a record of events related to 802-1.x authentication. SCEP-client.
Figure 78. wlx.ini 5. Click the Registry tab to view contents of device registry. You can navigate through different types of registry by choosing appropriate ones from the Registry drop-down list.
Figure 79. Registry The available options are: ● Temporary—To view contents of temporary registry ● Save—To view contents of save registry ● Permanent—To view contents of permanent registry Select the Registry option from the drop-down list and the contents of the device registry selected by you are displayed. SCEP configuration management The Simple Certificate Enrollment Protocol (SCEP) is a protocol that allows you to securely issue certificates to network devices in a scalable manner.
Figure 80. SCEP configuration 2. Enter the Certificate name, Server URL, Challenge password, and CA Distinguished name. NOTE: The server URL can be either an http or https link. 3. Click Save to save the changes. 4. Select the certificate and click Enroll. Wyse Device Agent Wyse Device Agent (WDA) on the ThinLinux device supports only the features of Wyse Management Suite. Wyse Device Agent is for configuring the client settings and registering a ThinLinux device into Wyse Management Suite.
Figure 81. Wyse Device Agent 1. In the WMS Server input box, enter the URL of Wyse Management Suite server. 2. In the Group Token input boxes, enter your group registration key to manage your ThinLinux device. This is a unique key for registering your thin client device. Thin clients can be directly registered to Groups directly and must have a Group Registration Key enabled to perform this action. 3. Click the ON/OFF button to enable or disable the Validate server certificate option.
● Using INI parameter—You can use the following INI parameters to direct the thin client to the Wyse Management Suite server: CCMEnable={yes,no} CCMServer= GroupRegistrationKey= NOTE: When INI discovery method is used for registering the device, if you want to unregister the device, you must delete the INI parameters and restart the device first and then unregister the device. Else you have to perform the unregister process twice.
7 Viewing XTerm XTerm is the standard terminal emulator for the Xterm Window System. Use the terminal emulator window for X to access a text terminal and all its applications such as command line interface (CLI) and text user interface applications. NOTE: By default, XTerm is available only in Admin mode. To use the Xterm option: 1. On the Application overview screen, click Xterm. The terminal emulator window is displayed. 2. Type help and press Enter to display a verbose message describing XTerm options.
8 Imaging solutions ThinLinux Imaging is supported through Dell Wyse Management Suite and Dell Wyse USB Imaging Tool. For more information about the Merlin image installation using Dell Wyse USB Imaging Tool, see the latest Dell Wyse USB Imaging Tool User's Guide at www.downloads.dell.com/wyse. Merlin Imaging from file server To create and use merlin.rsp and imaging files to perform Merlin imaging on device from File Server, complete the following task: 1.
9 Password encoding By default, passwords in INI parameters use base-64 encoding. Dell recommends that you use the AES encoded password for high security purpose. An AES encoded password is generated using the iniencrypt tool on thin clients running ThinLinux version 2.1.0.01 or later. ThinLinux supports the following two password encoding methods for all the passwords in Connections and Global settings that are used in the INI parameters: ● Base64 password encoding, see Base64 passcode encoding.
A Central configuration—Automating updates and configurations This appendix describes how to set up your environment to provide your thin clients running Dell Wyse ThinLinux with automatic updates and configurations. NOTE: Dell thin clients do not require device management software. They are configured to obtain their IP address, as well as the location of firmware and configuration instructions, from a DHCP server.
Setting up the automatic configurations and updates For a Dell thin client running Dell Wyse ThinLinux to successfully access INI files and update itself from a server, you must set up the server with the correct folder structure where the INI files and other update files are located, direct the thin client to the server, and then reboot or start the thin client.
Directing the thin client to the server After you set up the folder structure and populate it with the correct files, Dell recommends that you use DHCP to direct the thin client to the location of the server. To direct the thin client to the server: Using DHCP—When using DHCP to direct the thin client to the location of the server, information about the server and root directory is obtained from the following DHCP options: a. 161—The server. b. 162—Root path to the server-ftp/http/https.
B DHCP options tags Use the guidelines shown in the Table when creating and adding the DHCP options. Table 24. DHCP options tags Option Description Notes 1 Client identifier Always sent. 2 Time Offset Optional. 3 Router Optional but recommended. It is not required unless the thin client must interact with servers on a different subnet. 6 Domain Name Server (DNS) Optional but recommended. 12 Host Name/Terminal Name Optional string. The host name or terminal name to be set.
Table 24. DHCP options tags (continued) Option Description Notes this example, the correct string value for this DHCP option is /wyse. On a Linux server, an FTP user-based directory might be /home/test/wyse. In this example, if the FTP user is test, then the FTP root path is /wyseand not the full path (/home/test/wyse). This value should use URL path notation. NOTE: URL path notation-Start with a forward slash, /, and use a forward slash as folder separators.
C Data recovery imaging Use the operating system reinstall option to restore the system to its original factory settings. During the process, the device uses the hard drive partition for data recovery imaging. To perform data recovery imaging: 1. Restart the thin client. The thin client boots up and Dell logo is displayed for a short time. 2. During this period, keep pressing the Esc key. The GRUB menu is displayed. 3. Select Reinstall operating system and press Enter. 4.
