Administrators Guide Wyse Enhanced Ubuntu Linux ® Products: T50 Issue: 022412 PN: 883840-51 Rev.
Copyright Notices © 2012, Wyse Technology Inc. All rights reserved. This manual and the software and firmware described in it are copyrighted. You may not reproduce, transmit, transcribe, store in a retrieval system, or translate into any language or computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual or otherwise, any part of this publication without express written permission.
Regulatory Compliance for Thin Clients Basic EMC and Safety Requirements Wyse appliances are compliant with the regulatory requirements in the regions listed below. U.S.A.—FCC Part 15 (class B), cUL 60950 Canada—IC ICES-003, CAN/CSA-C22 No.
This page intentionally blank.
Contents 1 Introduction 1 About this Guide 1 Finding the Information You Need in this Guide Wyse Technical Support 1 Related Documentation and Services 1 Wyse Online Community 2 2 1 Getting Started: Quickly Learning the Basics 3 Logging In 3 Using Your Home Screen 4 Home Screen Keyboard Shortcuts 6 Configuring Thin Client Settings and Connections 6 Connecting to Network and Session Services 7 Connecting to a Printer 7 Connecting to a Monitor 7 Locking, Logging Out, Shutting Down, Restarting, and Suspend
vi Contents Import Certificates 24 Adding Certificates from a Remote Server 24 Adding Certificates from a Local Device 25 INI Source Settings 25 Keyboard 27 Language Support 27 Mixer 28 Mouse 29 Network Connections 29 Network Proxy 30 Power Manager 30 Printers 31 Installing a Network Printer 32 Installing a Local Printer 33 Screensaver 34 TCX Audio 34 TCX USB Virtualizer 35 User Administration 36 VNC Server 37 WDM 37 4 Configuring Connections 39 Custom 40 Application 40 Auto Reconnect 40 ICA 41 Network
vii Contents VNC Viewer 51 Network 51 Connection 51 Window 51 Login 51 Web Browser 52 Network 52 Window 52 Auto Reconnect 52 A Central Configuration: Automating Configurations 53 How INI Files are Employed 53 How to Set Up Automatic Configuration 54 Step 1: Prepare the Root Directory and Folder Structure on the Server Step 2: Direct the Thin Client to the Server 56 Using DHCP 56 Manually Configuring the Server Location 58 Step 3: Reboot the Thin Client 58 54
viii Contents This page intentionally blank.
1 Introduction Wyse® Enhanced Ubuntu™ Linux combines the security, flexibility, and market-leading usability of Ubuntu™ (trademark of Canonical Group Limited) with Wyse’s cloud computing optimizations in management and user experience. It is ideal for organizations that want to run server-based, Web-based, or local applications (including legacy applications) without the deployment and security concerns of a non-standard Linux distribution.
2 Chapter 1 Reference Guide: Wyse ® Enhanced Ubuntu™ Linux INI Files is intended for administrators of Wyse thin clients running Wyse Enhanced Ubuntu Linux. It provides the detailed information you need to help you understand and use the Wyse Enhanced Ubuntu Linux INI files. It contains information on the different INI files you can use and the rules for constructing the files. It also provides the parameter details you need (with working examples) to get the most out of your INI files.
2 Getting Started: Quickly Learning the Basics Use the following information to quickly learn the basics and get started using your thin client: • "Logging In" • "Using Your Home Screen" • "Configuring Thin Client Settings and Connections" • "Connecting to Network and Session Services" • "Connecting to a Printer" • "Connecting to a Monitor" • "Locking, Logging Out, Shutting Down, Restarting, and Suspending" • "Additional Getting Started Details" Tip While it can be used in environments witho
4 Chapter 2 Using Your Home Screen The Wyse Enhanced Ubuntu Linux Home screen is designed for efficiency and usability. Use the following guidelines (depending on user privilege, some options may not be available for use): Tip Each icon has a pop-up description for easy identification. Table 1 Menu bar icons Icon Home What It Does Displays your Home screen (useful when many windows are open and you want to quickly access your Home screen).
Getting Started: Quickly Learning the Basics Table 1 5 Menu bar icons, Continued Icon System Information Quit What It Does Opens the System Information dialog box. Use this dialog box to view system information about the thin client (see "Viewing System Information"). Opens the Shutdown dialog box. Use this dialog box to lock, logout, shutdown, restart, or suspend your thin client (see "Locking, Logging Out, Shutting Down, Restarting, and Suspending").
6 Chapter 2 Home Screen Keyboard Shortcuts Depending on the type of application window you are using (full screen, standard, or seamless), you can use shortcut keys (see Table 2) to manage windows. Note that you can also define shortcuts for launching applications (see "Keyboard"). Tip The shortcut keys Alt+DownArrow (allows you to switch windows using a dialog box) and Alt+Ctrl+DownArrow (minimizes or maximizes all windows) are useful for navigating multiple remote sessions without having to log out.
Getting Started: Quickly Learning the Basics 7 Connecting to Network and Session Services Use the Network Manager icon, located on the right side of the Menu bar, to display information about the status of your network connection and to connect or disconnect. Use the following guidelines: • Click the Network Manager icon to display the Wired Network and Wireless Network menus. For example you can click the Network Manager icon, and then select an available wired or wireless network to use.
8 Chapter 2 Locking, Logging Out, Shutting Down, Restarting, and Suspending After using your thin client, you can click the Quit icon and select one of the following (depending on user privilege, some options may not be available for use): • Lock - Locks your thin client (display is blank after you click the icon). To unlock your thin client, move the mouse, enter your credentials, and then click Unlock. • Logout - Logs you out of your session (however, the thin client continues to run).
Getting Started: Quickly Learning the Basics 9 Using Wyse Terminal Clicking the Terminal icon on the Home screen opens the Wyse Terminal emulator window. Wyse Terminal allows you access to a text terminal and all its applications such as command line interfaces (CLI) and text user interface applications. You can click the Window menu (upper left window icon in the terminal window) to open and use available menu options.
10 Chapter 2 Enhancing Your Experience with Wyse Software Wyse provides several software products that are specifically designed to enhance your thin client experience. Wyse Thin Computing Software is available on the Wyse Web site at: http://www.wyse.com/products/software.
Getting Started: Quickly Learning the Basics • Datacenter Consolidation • Desktop Cloud Computing • Remote Off-Shore Desktop Computing 11
12 Chapter 2 This page intentionally blank.
3 Configuring System Settings Clicking the System Settings icon in the Menu bar displays the following System Settings options that you can configure locally on a thin client using dialog boxes (depending on user privilege level, some dialog boxes and options may not be available for use): Tip While it is not recommended to use dialog boxes for configuring thin client system settings, they are available in case you want to temporarily override central default configurations or you do not have the option to
14 Chapter 3 Accessibility Use the Accessibility dialog box (click Accessibility) to set Sticky Keys, Slow Keys, and Bounce Keys options. Appearance Use the Appearance dialog box (click Appearance) to customize your Home screen (Style, Icons, and Fonts).
Configuring System Settings Background Use the Background dialog box (click Background) to customize your desktop background. Tip PNG files are recommended for most single monitor setups. However, on dual-monitor setups, a JPG file is recommended (as there is some color variance due to Y-Cable or DVI/VGA output when using PNG files).
16 Chapter 3 Date & Time Use the Date/Time Properties dialog box (click Date & Time) to set Date & Time and Time Zone options. After configuring, be sure to click OK. Use the Date and Time tab to: • Synchronize with a Network Time Protocol (NTP) server - Enter the IP Address or hostname of the NTP server (the current NTP server is shown) to synchronize the clock time and date of the thin client. You can also use Add, Edit, and Delete to manage your list of NTP servers available.
Configuring System Settings 17 Device Settings Use the Device Settings dialog box (click Device Settings) to set the parameters of your device (Terminal Name, Hosts, and Ethernet Speed). After configuring, be sure to click OK. Terminal Name Use the Terminal Name tab to obtain the device name: • Contact DHCP server - Obtains the name from the DHCP server. • Derive from MAC address - Generates the name from the device MAC address. • Use the following name - Allows you to manually enter a name.
18 Chapter 3 Ethernet Speed Use the Ethernet Speed tab to select the Ethernet speed. Tip It is recommended to use Auto-Detect in a 1 GB network. Diagnostics Use the Diagnostics dialog box (click Diagnostics) to select and use a diagnostic tool: • Ping - Enter or select a destination from the Destination list and click Ping. • Trace Route - Enter or select a destination from the Destination list and click Trace Route (diagnostic information appears on the Trace Route tab).
Configuring System Settings 19 Display Use the Display Preferences dialog box (click Display) to set the monitor display preferences (Primary Display Output, Resolution, Refresh Rate, and Rotation). For most monitors, resolution is obtained automatically from the monitor. After configuring, be sure to click Apply. Tip Dual Monitors - When using a DVI to DVI/VGA splitter with VGA and DVI monitors at the same time, note that the VGA monitor will be the primary monitor.
20 Chapter 3 ICA Global Settings Use the ICA Settings dialog box (click ICA Settings) to configure the common settings you want for all ICA connections (ICA Global Settings). After configuring, be sure to click OK. Network Use the Network tab to configure the servers and reconnection settings. Use the following guidelines: • PN Agent Server - Enter the PN Agent Server you want to use (this can be a list of servers with each server separated by a semi-colon).
Configuring System Settings 21 Drive Mapping Use the Drive Mapping tab to map drives on the server to devices on the thin client, and to view and manage (add, edit, and delete) the list of current drives (including drive information) mapped on the thin client. Adding Drives 1. Click Add to open the ICA Drive Map dialog box. 2. Select a drive letter (A to Z) from the Drive Letter list. 3. To enable or disable reading and writing for the drive, select or clear the Enable Read and Enable Write check boxes.
22 Chapter 3 Hotkeys Use the Hotkeys tab to map hotkeys on the thin client (select a Hotkey option using the Hotkey lists for each function you want). Display Use the Display tab to set: • Scroll Adjustment - If you encounter over-scrolling when using certain published applications, increase the adjustment by 100 until the display improves (maximum scroll adjustment is 1000).
Configuring System Settings 23 Firewall Use the Firewall tab to set the firewall options on the thin client: • Automatically detect proxy - Detects proxy servers automatically. • Use Alternate Address for Firewalls - Enables connections behind a firewall • Proxy Type - Select a Proxy Type from the list and if necessary (Secure (HTTPS) or SOCKS, enter the Proxy Address and Port). Trusted Server Configuration Use the Trusted Server Configuration tab to set and enforce the trusted server configuration.
24 Chapter 3 Import Certificates Use the Import Certificates dialog box (click Import Certificates) to import and manage (add and delete) ICA Digital Certificates as described in "Adding Certificates from a Remote Server" and "Adding Certificates from a Local Device." Adding Certificates from a Remote Server Use the following guidelines (certificate files you add from a remote server must end with the extension .crt, and be DER-encoded or Base64-encoded): 1.
Configuring System Settings 25 Adding Certificates from a Local Device 1. In the Import Certificates dialog box, click Add to open the Add Certificate dialog box. 2. Select the Local Server option, and then click Next to open the Open File dialog box. 3. Use the folders and command buttons to find and select the certificate you want to use. INI Source Settings Use the INI Settings dialog box (click INI Settings) to direct the thin client to the source (server location) of INI files.
26 Chapter 3 Use the following guidelines: • Do not use INI files - Use this option when you want to use only locally configured settings (using the thin client dialog boxes available) and do not want to use available INI files on the network or local INI files.
Configuring System Settings 27 Keyboard Use the Keyboard dialog box (click Keyboard) to select Behavior (repeat key and cursor blinking options), Application Shortcuts (add/remove shortcuts for launching applications and reset to defaults options), and Layout (keyboard models and layout options). Tip For information on available Home screen keyboard shortcuts, see "Home Screen Keyboard Shortcuts.
28 Chapter 3 Mixer Use the Mixer dialog box (click Mixer) to configure Playback (Master system sounds) volume and other available controls. Select the Sound Card option you want and use the Select Controls dialog box (click Select Controls) to select the check boxes of the audio controls you want visible (tabs) in the Mixer dialog box (available for configuration).
Configuring System Settings 29 Mouse Use the Mouse dialog box (click Mouse) to select Devices (button order, feedback, and reset to defaults options) and Behavior (drag-and-drop and double-click options) mouse preferences. Network Connections Use the Network Connections dialog box (click Network Connections) to configure the settings you want for supported network connections.
30 Chapter 3 Network Proxy Use the Network Proxy Preferences dialog box (click Network Proxy) to configure the Proxy Configuration and Ignored Hosts options you want for supported network connections. Use the Proxy Configuration and Ignored Hosts tabs to view and manage proxy settings and list of hosts to ignore (information provided by your network administrator) for the network connections configured on the thin client (experienced users only).
Configuring System Settings 31 Printers Use the Printers dialog box (click Printers) for printer related tasks. Tip While this section provides an overview of printer related guidelines to use, see "Installing a Network Printer" and "Installing a Local Printer" for detailed procedures. For full details on Linux printing, refer to CUPS documentation.
32 Chapter 3 Jobs: · Manage Jobs - Change printer job options (click Administration tab > Manage Jobs). Server: · Edit Configuration File - Change the server configuration file (click Administration tab > Edit Configuration File). · View Access Log - View the access log to the server (click Administration tab > View Access Log). · View Error Log - View the error log to the server (click Administration tab > View Error Log).
Configuring System Settings 33 Installing a Local Printer Connect the printer cable to your thin client and use the following guidelines: 1. Click Administration tab > Add Printer to open the Add Printer wizard. 2. Be sure the USB printer you connected to your thin client is selected and click Continue. Tip You can use the Serial Port # 1 and Serial Port # 2 options as needed for your local serial port printers. 3. Select the option with which you want to obtain your printer driver and click Continue. 4.
34 Chapter 3 Screensaver Use the Screensaver Preferences dialog box (click Screensaver) to Display Modes (select screen saver theme settings) and Advanced (display power management) settings. Tip Press the Power button to wake the computer from standby or sleep mode.
Configuring System Settings 35 TCX USB Virtualizer Use the TCX USB Virtualizer Configuration Utility dialog box (click TCX USB Virtualizer) to view and manage (add, edit, and delete) the list of current device classes (on the Configuration tab) and to view the list USB devices enabled or denied for use on the thin client (on the USB Devices tab). You can deny a device class, but still permit a USB device in that class to be used, by adding it to the Devices list of the Configuration tab.
36 Chapter 3 User Administration Use the User Administration dialog box (click User Administration) to view and edit passwords for all users (built-in defaults) and to enable automatic login for a user (automatically log in a user at system start up). In addition, you can manage SSH root User password and login (using the SSH root User tab).
Configuring System Settings 37 VNC Server Use the VNC Server Settings dialog box (click VNC Server) to enable and disable the VNC server, and to use and change the server password. Tip The VNC server is enabled by default. WDM Use the WDM Agent Configuration dialog box (click WDM) to configure the Wyse Device Manager server location. Tip It is recommended that after configuring, you reboot the thin client. To configure the WDM server location: 1. Enter the WDM Server IP address. 2.
38 Chapter 3 This page intentionally blank.
4 Configuring Connections This chapter provides instructions on configuring and adding connections to your Home screen for use (to access the enterprise server environment available to the thin client). Tip While it is not recommended to use dialog boxes for configuring connections for thin client use, they are available in case you want to temporarily override central default configurations in some cases or you do not have the option to set up central configuration (smaller environments).
40 Chapter 4 Custom Use the Custom Connection Configuration dialog box (click Custom) to set custom connection configurations. After configuring, be sure to click OK. Application Use the Application tab to configure: • Description - Enter the description. • Command Line - Enter the command line for the program on the server. • Run in terminal window - Runs the application in a terminal window (use with applications that require a terminal window such a console program).
Configuring Connections 41 ICA Use the Citrix ICA Client Settings dialog box (click ICA) to set ICA connection configurations. After configuring, be sure to click OK. Tip When using multiple ICA connections, you can use the ICA Connection Center to manage open ICA connections. For information on using multiple ICA connections, refer to the Wyse Knowledge Base on the Wyse Web site.
42 Chapter 4 Connection Use the Connection tab to configure the connection settings: • Enable compression - Enables compression. • Low bandwidth - Enables low-bandwidth optimization. • Enable sound - Enables sound. • Ping before connect - Pings the connection to see if it is reachable before the connection is attempted. • Enable Middle Button Paste - Enables middle button paste for the mouse. • Encryption - Select an encryption type (default is Basic).
Configuring Connections Firewall Use the Firewall tab to configure an alternate address for firewalls: • Automatically detect proxy - Select to automatically detect the proxy type. • Use Alternate Address for Firewalls - Select Yes to use an alternate address for firewalls. • Proxy Type - Select a proxy type. • Proxy Address and Port - If you select Secure (HTTPS) or SOCKS as the Proxy Type, you must enter the Proxy Address and Port. Tip Published applications do not support Firewall functions.
44 Chapter 4 RDP Use the Remote Desktop Protocol (RDP) Configuration dialog box (click RDP) to set RDP connection configurations. After configuring, be sure to click OK. Network Use the Network tab to configure the network settings: • Description - Enter a name/label for the connection. • Server - Enter a server name or IP address. • Ping Before Connect - Pings the connection to see if it is reachable before the connection is attempted.
Configuring Connections 45 Experience Use the Experience tab to configure the experience settings for a user desktop: • Speed Level - Select a speed level to describe the network connection. • Menu and window animation - Enables menu and window animation. • Show contents of window while dragging - Shows the window content when the user drags the window on screen. • Desktop Background - Displays the desktop background.
46 Chapter 4 • Connect automatically after login - Enables an automatic connection after successful login to the thin client. Tip The User Name, Password, and Domain fields are optional. If you leave any of these fields blank, interactive login is required (users must enter the information at login time).
Configuring Connections 47 Device Mapping Use the Device Mapping tab to map devices to ports on the thin client, and to view and manage (add and delete) the list of current devices (including device information) mapped on the thin client. Adding Devices 1. Click Add to open the Add Port Mapping dialog box. 2. Select a port from the Port list. 3. Select the directory of the device to access from the Device list. 4. Click OK to add the device to the list of available devices.
48 Chapter 4 SSH Use the SSH Configuration dialog box (click SSH) to set SSH connection configurations. After configuring, be sure to click OK. Tip X forwarding/tunneling is automatic and allows you to execute remote X applications. Network Use the Network tab to configure the network settings: • Description - Enter a name/label for the connection. • Host - Enter a host name or IP address. • Remote Username - Enter a username. • Remote Command - Enter the command to execute on the server.
Configuring Connections 49 VMware View Open Client Use the VMware View Client Settings dialog box (click VMware View Open Client) to set VMware View Client connection configurations. After configuring, be sure to click OK. Network Use the Network tab to configure the network settings: • Description - Enter a name/label for the connection. • Host - Enter the VMware View Server location (either host name, a full URL including the root path, or an IP Address). • Port - Enter the port of the host.
50 Chapter 4 Drive Mapping Use the Drive Mapping tab to map share names on the server to USB mass storage devices attached to the thin client, and to view and manage (add, edit, and delete) the list of current server share names (including drive information) mapped on the thin client. Adding Share Names 1. Click Add to open the Drive Map dialog box. 2. Enter a Share Name. 3. Select a Drive Type (USB Floppy, USB CDROM, USB Disk or Memory Stick, or Local or Mounted Disk). 4.
Configuring Connections 51 VNC Viewer Use the VNC Viewer Settings dialog box (click VMware Viewer) to set VNC Viewer connection configurations. After configuring, be sure to click OK. Network Use the Network tab to configure the network settings: • Description - Enter a name/label for the connection. • Host - Enter a host name or IP address.
52 Chapter 4 Web Browser Use the Web Browser Configuration dialog box (click Web Browser) to set Web Browser connection configurations. After configuring, be sure to click OK. Network Use the Network tab to configure the description and URL (optional if you want the browser to open to a particular Web page each time you connect). If you want the browser to launch automatically after system startup, select the Auto Connect check box.
A Central Configuration: Automating Configurations This appendix describes how to set up your environment to provide your thin clients running Wyse Enhanced Ubuntu Linux with automatic configurations in three simple steps. It includes: • "How INI Files are Employed" • "How to Set Up Automatic Configuration" Tip Wyse thin clients do not require device management software. They are configured to obtain their IP address, as well as the location of configuration instructions, from a DHCP server.
54 Appendix A How to Set Up Automatic Configuration For a Wyse thin client running Wyse Enhanced Ubuntu Linux to successfully access INI files and configure itself from a server, you must set up the server with the correct folder structure (where the INI files and other files are located), direct the thin client to the server, and then reboot or start the thin client.
Central Configuration: Automating Configurations 55 Be sure to create/activate the two required MIME Types (.ini and .) under IIS (on a per site basis) to enable downloading. Also be sure your Web server can identify the file types used by Wyse thin clients. To create/activate the .ini MIME Type: 1. On your IIS server, use the File Types menu to add a New Type. 2. In the File Type dialog box, enter the Associated extension .ini and Content type (MIME) text/plain. 3. Click OK to apply the settings.
56 Appendix A Step 2: Direct the Thin Client to the Server After you set up the folder structure and populate it with the correct files, you must then direct the thin client to the location of the server by one of the following ways: • DHCP (see "Using DHCP") • Manual direction (see "Manually Configuring the Server Location") Tip Using DHCP is strongly recommended.
Central Configuration: Automating Configurations Table 3 57 DHCP Option Tags, Continued Option Description Notes 12 Host Name/Terminal Name Optional string. The host name or terminal name to be set. 15 Domain Name Optional but recommended. See Option 6. 28 Broadcast Address Optional. 44 WINS servers IP Address Optional. 51 Lease Time Optional but recommended. 52 Option Overload Optional. 53 DHCP Message Type Recommended. 54 DHCP Server IP Address Recommended.
58 Appendix A Table 3 DHCP Option Tags, Continued Option Description Notes 184 Server Username Optional string. Username to use when authenticating to the server specified in Option 161. 185 Server Password Optional string. Password to use when authenticating to the server specified in Option 161. 186 Wyse Device Manager (WDM) Optional binary IP address or FQDN of the WDM server. This option can specify up to one Wyse Device Manager server.
Central Configuration: Automating Configurations This page intentionally blank.
Administrators Guide Wyse® Enhanced Ubuntu Linux Issue: 022412 Written and published by: Wyse Technology Inc.
