HP Smart Client Administrator's Guide
© Copyright 2011 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. Microsoft, MS-DOS, Windows, and Windows NT are trademarks of Microsoft Corporation in the U.S. and other countries. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty.
About This Book WARNING! Text set off in this manner indicates that failure to follow directions could result in bodily harm or loss of life. CAUTION: Text set off in this manner indicates that failure to follow directions could result in damage to equipment or loss of information. NOTE: Text set off in this manner provides important supplemental information. If you have comments, feedback, or questions about this guide, please e-mail us at tc_software_docs@hp.com.
iv About This Book
Table of contents 1 Quick Start ....................................................................................................................... 1 Installing HP Smart Client Service ............................................................................................... 2 Standard installation .................................................................................................. 2 Booting client ......................................................................................
Citrix Certificates ..................................................................................... 23 Customized login screen ........................................................................... 23 Screen background customization ............................................... 23 Login dialog customization ......................................................... 30 Saving profiles ........................................................................................................
Windows ................................................................................................ 58 Linux/Unix .............................................................................................. 59 What to look for in System Diagnostics ......................................................................
viii
1 Quick Start If you just want to install HP Smart Client Service and get started, this section will guide you through the following: ● Installing HP Smart Client Service on page 2 ● Booting client on page 3 ● Quick troubleshooting on page 3 NOTE: Microsoft® Internet Information Services (IIS) in Windows® Server and Microsoft .NET Framework 3.5 must be installed before you install HP Smart Client Service. For information on installing IIS, visit http://www.microsoft.com.
Installing HP Smart Client Service Standard installation NOTE: Microsoft IIS and Microsoft .NET Framework 3.5 must be installed before you install HP Smart Client Service. 1. Download the HP Smart Client Service from HP.com. 2. Double-click HPSmartClientService_version number.exe to launch the HP Smart Client Service installation wizard. The InstallShield Wizard dialog box appears. 3. Select the language and click OK.
Booting client If the HP Smart Client Service is enabled and configured to connect clients to a valid remote connection server, the client will auto-configure and boot to a login screen. Users can then enter their credentials to log in to the pre-configured remote connection server. If HP Smart Client Service is not enabled, users will boot to the Demo Mode. For more information, see Client Usage on page 44. Quick troubleshooting Occasionally, everything does not go as planned.
2 Server setup ● How it works on page 4 ● HP Smart Client Service on page 5 ● Using Profile Editor on page 13 ● Automatic intelligence on page 33 ● HP Intelligent Delivery Service on page 41 How it works The HP Smart Client is designed to detect its update server automatically and to configure itself automatically on first boot. This greatly simplifies device installation and maintenance.
HP Smart Client Service ● Supported operating systems on page 5 ● Pre-requisites on page 6 ● Using HP Smart Client Service on page 10 Supported operating systems ● Windows 7 ● Windows 2003 ● Windows 2008 ● Windows 2008 R2 NOTE: The installer is 32-bit only, but it is supported on 32-bit and 64-bit versions of the Windows operating system.
Pre-requisites ● Installing Internet Information Services (IIS) on page 6 ● .NET Framework 3.5 on page 8 Installing Internet Information Services (IIS) IIS must be installed before HP Smart Client Service can be installed. Installing IIS on Windows 7: 1. Click Start and select Control Panel. 2. Click Programs, and then click Turn Windows features on or off. 3. In the Windows Features dialog box, click Internet Information Services. and then click OK. Installing IIS on Windows Server 2003: 6 1.
Installing IIS on Windows Server 2008 or Windows Server 2008 R2 1. Click Start, select Administrative Tools, and then click Server manager. 2. Click Roles in the left pane. 3. In Roles Summary, click Add Roles in the right pane. 4. In the Select Server Roles dialog box, check the Web Server (IIS) check box. 5. Accept the default entries and click Next.
6. In the Confirm Installation Selections dialog box, click Install. 7. When the Installation Succeeded screen appears, click Close to end the installation. .NET Framework 3.5 If you plan to use Windows Server 2008 R2, IIS must be installed before .NET Framework 3.5 is enabled. You do not have to manually install the .NET Framework 3.5 if you have internet access during the installation of HP Smart Client Service. The installation wizard asks you if you would like to install the .NET Framework 3.5.
2. Click Features to display all the installed Features in the right hand pane. If .NET Framework 3.5 is listed, it is installed. 3. If it is not installed, install it using one of the following methods: Through the Server Manager interface: a. In the Server Manager interface, select Add Features to display a list of possible features. b. In the Select Features interface, expand .NET Framework 3.5 Features. c. Select .NET Framework 3.5 and click Next. d.
Using HP Smart Client Service To launch HP Smart Client Service, double-click HPSmartClientService_version number.exe (the HP Smart Client Service installation executable). ● Installing custom setup on page 10 ● Modifying, adding, repairing, or deleting HP Smart Client Service features on page 11 Installing custom setup NOTE: Microsoft IIS and Microsoft .NET Framework 3.5 must be installed before you install HP Smart Client Service. This is a custom installation of HP Smart Client Service. 1.
If you click Install, HP Smart Client Service is installed and the InstallShield Wizard Complete page opens. 12. If you want to launch the Profile Editor, select the check box and click Finish. If not, leave the check box clear and click Finish to exit the wizard. NOTE: The Profile Editor allows you to create and edit configuration files. For more information, see Using Profile Editor on page 13.
3. Repair the installation if you have corrupted or deleted install files. Choose this option to perform a complete reinstallation of the HP Smart Client Service. a. Select Repair, and then click Next. The Maintenance Complete dialog box appears. b. 4. Click Finish. Remove the HP Smart Client Service if you wish to remove all installed features. NOTE: Profiles and packages are not deleted by default. a. Select Remove and click Next.
Using Profile Editor The Profile Editor is used to modify the client profile stored on the Automatic Intelligence server. This profile contains connection information, settings, and files that smart clients will download and use to self-configure. To access the Smart Client Profile Editor: 1. Click Start > Programs > Hewlett-Packard > HP Smart Client Service. 2. Select HP Profile Editor. To load an existing profile.xml file: ▲ Click the profile.
Changing your server/URL This page allows you to configure the connection launched from the clients. ▲ Select a connection type and type the server name or address of the remote connection server in the field. Modifying client settings You can change the default values for numerous client settings such as Audio, Connection Manager, Connection Type, Display, Network, USB, auto-update, entries, keyboard, mouse, printer redirection, time, translation, users, and zero-login.
How to use the tree view To display the tree view: ▲ Expand the root and expand the options whose value you want to change. Changing settings To change a setting: Record volume is changed for this example 1. Expand the root and Audio. 2. Click RecordVolume to select it. 3. In the Values area for RecordVolume, change the value as desired. 4. Click Next.
16 Keyboard Model Layout Variant Brazil [Português do Brasil] abnt2 br wincompat Bulgaria [Български] pc105 bg wincompat Canada [Français Canadien] pc105 ca wincompat Croatia [Hrvatski] pc105 hr wincompat Czech Republic [Český] pc105 cz wincompat Denmark [Dansk] pc105 dk wincompat Finland [Suomi] pc105 fi wincompat France [Français] pc105 fr wincompat Germany [Deutsch] pc105 de wincompat Hungary [Magyar] pc105 hu wincompat Italy [Italiano] pc105 it wincompat
Keyboard Model Layout Variant United States [English], Dvorak pc105 us wincompat-dvorak United States [English], International pc105 us wincompat-intl How to read the side information bar The Information bar is located in the right pane of the Profile Editor screen. When you select an option, information on the setting appears in the Information bar.
Disabling and enabling items 18 ● Disabling icons ● Disabling Configure menu items ● Disabling the Additional Configurations ● Finishing and saving your settings Chapter 2 Server setup
Disabling Configure menu items 1. Expand the zero-login directory. 2. Expand the controls directory in the zero-login directory.
3. Expand the Configure ● menu item or items you would like to disable or enable. i18n— Allows the user to change the current language. ● Keyboard— Allows the user to change the current keyboard layout to a different language, i.e. Spain [Español]. ● Audio— Allows the user to adjust the volume. ● Additional Configuration— Contains more detailed configuration items. Refer to Disabling the Additional Configurations menu items on page 21 for more information. 20 4.
Disabling the Additional Configurations menu items 1. Expand the users directory and the user directory in it. 2. Expand the apps directory in the user directory.
3. Expand the Additional Configuration like to disable or enable. ● menu item or items you would hptc-auto-update— Allows the user to disable or enable automatic updates or to set up a manual configuration of where to get the updates from. ● hptc-date-mgr— Allows the user to change the date and time of the system. ● hptc-display-prefs— Allows the user to change Resolution, Depth, Orientation, and Primary and Secondary Display of the monitor.
Finishing and saving your settings 1. Click the Finish tab. 2. Click Save Profile. (If it is grayed out, then you have changed nothing.) 3. Click Finish. Attaching client files to profile ● Citrix Certificates on page 23 ● Customized login screen on page 23 Citrix Certificates In this example, we will install a cacert that will be used by the Citrix session. 1. Add a file. 2. Import file. 3. Select the desired root certificate. 4. Edit the path: /usr/lib/ICAClient/keystore/cacerts/.
which these files are stored and can be modified to point to custom directories. For instance, the registry key root/zero-login/styledir/view points to the directory containing style elements for the login desktop for VMware View connections, defaulting to /etc/hptc-zero-login/styles/ view. Within a style’s directory, the file bgConfig.rtf specifies the elements in the desktop's background window. Syntax of a bgConfig.rtf file is in a stylesheet-like format with some or all of the elements described below.
color Parameters: RRGGBB 6-digit hex value or rrr,ggg,bbb 0-255,0-255,0-255 form Example: color: ff8800; Default: 255,255,255 (white) Use: Specifies the color of the element. alpha Parameter: 0-255 integer Example: alpha: 127; Default: 255 (fully opaque) Use: Specifies the opacity of the element. 255 is fully opaque; 0 would be fully transparent, rendering the element invisible. Elements are layered over the background in the order they are defined.
context Parameters: [login|desktop|all] Example: context: login; Default: all Use: Specifies that the element should only be shown on the login screen for the protocol, on the desktop screen for the protocol (if any), or on both. Only some protocols (e.g., Citrix XenDesktop) have a desktop screen. Elements The element type is given followed by a left-brace. Attributes follow, one on each line. Finally the element is closed by a right-brace on a single line, e.g.
Custom attributes: ● type Parameter: [linear|radial] Example: type: linear; Default: linear Use: Linear gradients can be either horizontally-oriented or vertically-oriented; coordinates given in colors are a fraction of width or height. Radial gradients are centered on the screen center; coordinates are a fraction of the distance to the screen edge (top and bottom or left and right).
0.5,EEEEEE 0.5,660000 1.0,330000” in a vertical linear gradient would specify a gradient between light grays on the upper half and dark reds on the lower half. ● dithered Parameter: [true|false] Example: dithered: true; Default: false Use: If your gradient is showing signs of color-banding, dithering will eliminate this visual artifact. Dithering is not supported for radial gradients with the ‘squared’ metric. image Use: Specifies an image to overlay over a portion of the background.
Custom attributes: ● text-locale Parameter: localized text Example: text-de_DE: Dieser Text is in Deutsch.; Use: When in the matching locale, this text will be used for the string. Supported are de_DE (German), en_US (English), es_ES (Spanish), fr_FR (French), ja_JP (Japanese), and zh_CN (Simplified Chinese). File encoding is UTF-8. ● text Parameter: default text Example: text: This will be shown on the screen.; Use: If no matching localized text is specified, this text string will be used instead.
Use: If the string would otherwise turn out to be wider than the size given, it is scaled down to fit within the width specified. ● max-height Parameter: size in pixels or in a percentage of screen height Example: max-height: 64; Use: If the text would otherwise turn out to be taller than the size given, it is scaled down to fit the height specified.
As examples of changes, the central frame area might be customized as follows: QFrame#centralFrame { /* Sea green dialog background color */ background-color: rgb(46,139,87); /* Rounded, thicker borders */ border-width: 6px; border-radius: 16px; /* Make sure it is at least 400 pixels wide */ min-width: 400px; } Text for the login header might be customized as follows: LoginArea QLabel#loginHeader { /* Change the login text at the top */ qproperty-text: "Login Here"; color: white; font-size: 16pt; font-weigh
/* Flat gray */ background: rgb(204,204,204); border-radius: 3; color: rgb(102,102,102); font-size: 12pt; } Of course, many more customizations are possible. See the Qt documentation for possibilities. Saving profiles This screen shows the contents of the profile and allows it to be saved. The profile can also be saved by clicking Finish in the Current Profile page of the Profile Editor. Parallel and serial printer porting Parallel and serial printing can be set up in the Profile Editor.
3. Make sure that Local Printer attached to this Computer is selected and that the Automatically detect and install my Plug and Play printer check box is cleared, click Next. 4. In the next window, select a port from the menu. The port you need is in the section of ports labeled TS###, where ### is a number between 000-009, 033-044. The appropriate port depends on your host name and the printer you want to install.
4. Expand the Sites folder. 5. Expand the HP Smart Client Service site. 6. Expand the auto-update folder and its sub folders. Automatic Intelligence directory structure MAC address-based profile This section covers how to create an Automatic Intelligence update profile for a single MAC address and how to place that profile on the HP Smart Client Service so that it will be downloaded by the client. Certain devices require different settings based on locations.
Updating thin clients You have three possible methods of updating: ● Broadcast update on page 35 ● DHCP Tag setup on Windows Server 2003/2008 for Automatic Intelligence update on page 36 ● Manual update on page 39 Broadcast update Broadcast update, the simplest of the three methods, only requires you to plug the thin client into the same network as the update server.
DHCP Tag setup on Windows Server 2003/2008 for Automatic Intelligence update DHCP tagging enables you to specify the thin clients to be updated. This is useful if you want only certain thin clients to run with a particular update; however, if you only have one or two thin clients to update, you may want to consider using Manual update instead. Otherwise, Broadcast update is recommended. NOTE: Your server MUST have the DHCP Role installed in order to use DHCP Tagging.
2. In the left pane, select the Domain to which the thin clients are connected. 3. Right-click IPv4, and then select Set Predefined Options. 4. In the Predefined Options and Values dialog box, click Add. 5.
● In the Name field, type auto-update. ● Select String from the Data type menu. ● Type 137 in the Code field. ● Type HP Automatic Update in the Description field. 6. Verify that the information is correct and click OK. 7. In the Value section, type the update server address in the String field. Example: http://auto-update.domain.com:18287/auto-update 8. Click OK to finish the setup. DHCP Tagging is now ready to update specific thin clients.
Manual update The final method, Manual update, can be used to have a thin client connect to a specific server for updates. This can be useful if you want to test an update on a single thin client before pushing the update to many thin clients or if you have specific updates to be installed on only one or two thin clients. Manual update is a nice substitute for DHCP Tagging, if you only have a couple of thin clients requiring a specific update.
3. In the Server field, type the host name of the update server with the port. The format is: autoupdate.domain.com:18287, where auto-update.com is the host name. 4. 40 In the Path field, type auto-update, and click OK. The thin client is now be able pull updates from the specified server.
HP Intelligent Delivery Service This Windows service listens for broadcasts from client devices on a high level port. When a broadcast is received, HP Intelligent Delivery Service responds with the URL of the Automatic Intelligence server, which the smart client uses to check for client updates. To start and stop the HP Intelligent Delivery Service: 1. Click Start > Program > Administrative Tools > Server Manager. 2. Expand the Configuration tab in the left pane and select Services. 3.
2. In the left pane, expand Diagnostics > Event Viewer > Windows Logs, and then select Application. In the center Application pane are logs of all of the application events. Logs related to the HP Intelligent Delivery Service can be viewed under HP Broadcast Server Win Service.
HP Device Manager The HP Device Manager Agent is software that runs in the background of the thin client. This allows the administrator to select thin clients remotely and to manipulate those thin clients to meet the required business need. For more information on HP Device Manager, refer to the HP Device Manager User Guide at C:\Program Files\HP\HP Device Manager\Doc\User_Guide. If you do not have HP Device Manager downloaded or installed yet, you can download it from http://h20000.www2.hp.
3 Client Usage This hardware and software combination gives the user the power to remotely connect into many servers with different operating systems. This provides the user with a variety of powerful computers from the user’s desk. Very little hardware setup is required: connect an active network cable, a mouse, a keyboard, and a monitor, and then connect a power cord and plug it into a power outlet.
To configure Demo Mode: 1. Click on a connection type. 2. Type the server name or IP address in the appropriate fields. 3. Type in the Server Login and click Log on. Connections ● RDP on page 45 ● ICA on page 45 ● VMware View on page 46 RDP Supported/unsupported features ● Standard ThinPro rdesktop client providing 1.
Supported/unsupported features ● Support XenApp 5/6 and XenDesktop four connections ● Standard ThinPro Citrix ICA 11.122 Linux Client with HDX ● Full 1080p MMR support HDX/Rave ● USBR support via HDX ● Published application support VMware View Supported/unsupported features ● Standard ThinPro HP VMware View 4.5 API client ● Standard ThinPro rdesktop client providing RDP 1.
12. Hover over the Protocols option, and then select either PCoIP or Microsoft RDP. 13. When you have completed your changed, click a Desktop pool to connect to it and click Connect. NOTE: In both PCoIP and RDP, only the full screen display has the clock at the bottom right of the screen.
Control panel The Control Panel button is the button with the wrench icon. The Control Panel menus allow access to many GUI configuration settings. ● Connection button—launches the Select Connection Type screen to access Citrix, RDP, and VMware View. NOTE: The Connection button is disabled by default when using the HP Smart Client Service. This button is enabled only during demo mode. ● Language button—allows you to select a new language.
● Additional Configuration/Mouse button—allows you to change the speed of the mouse, change the button settings to left- and right-handed. ● Additional Configuration/Network Settings/Wired button—allows you to change your network speed and duplex settings. You can also change the connection method from automatic IP discovery to static IP address configuration. ● Additional Configuration/Network Settings/Wireless button—allows you to change duplex settings.
7. To make the printer active, select the Active check box. 8. Click the Create button, now visible within the Window. The default baud rate for the serial printer may not be appropriate for it to work. If it does not print properly or at all, then try these steps to get it to work: 1. To obtain your serial printer’s baud rate, press and hold the FEED button prior to turning the printer on, then turn the printer on and release the FEED button. 2.
Status tab If the network is connected to a valid network, the status tab shows the network settings: IP Address, Gateway, and MAC Address. This Network field displays an X and a message of No network available if no valid network is available. (To set up the network, select Control Panel tool bar/ Additional Configuration/Network Settings.) The Smart Client Service field displays the name of the server, if this option is set up for Smart Client Service to a valid, configured Smart Client Service server.
Network tab The left pane of the Network tab shows the detailed information about your network interface and DNS Settings. This tab displays the Interface Name, State, IP Address, Network Mask, MAC Address, DHCP Server Address, and Interface Statistics. The right pane of the Network tab displays the network default gateway and DNS Settings. You can select multiple network adaptors to view from the Interface name menu.
Net Tools tab The Net Tools tab allows you to run a network diagnostic test: 1. Click System Information > Net Tools. 2. Select the tool: ● Ping ● DNS Lookup ● Trace Route 3. Identify the host and set the diagnostic parameters. 4. Click Start Process. 5. To save the diagnostic archive, click Diagnostic, name the file, and specify a location. 6. Click Save to save the archive and close the dialog box.
System Information tab The System Information tab displays information about your thin client. This tab shows the Platform Model name, Total RAM on the Thin Client, Serial Number, OS Kernel version, OS build ID, and Main software with the version numbers of all installed software. System Logs tab The System Logs tab displays all logs placed on the System, Kernel, X Server, and HP Smart Client Service.
Status icon The fourth button displays an icon corresponding to the state of your smart client. Clicking on the icon will give you a summary of the system state, and you can click the i button for further details. ● Error—a red X—There is a critical error such as lack of a network connection. ● Warning—a yellow triangle—There is a non-critical error such as inability to contact a Smart Client Service. Clicking on the icon clears the warning status.
11. Type Yes and press Enter to proceed. 12. When the reimage process is finished, remove the USB flash drive and press Enter.
Retrieving System Diagnostics ● What is System Diagnostics? on page 57 ● Saving System Diagnostics on page 57 ● Opening System Diagnostics on page 58 ● What to look for in System Diagnostics on page 59 What is System Diagnostics? System Diagnostics takes a 'snapshot' of the thin client that can be used to help solve issues without having to be in front of the thin client itself.
3. Click Diagnostic. The diagnostics file, Diagnostic.tgz, is created. 4. Select the USB flash memory device under /media and click Save to save Diagnostic.tgz to the device. 5. Remove the USB flash memory device from the thin client. 6. Supply Diagnostic.tgz to the person or group that is going to fix your thin client. Opening System Diagnostics Windows 1. Download and install 7-Zip. (You may obtain a free copy of 7–Zip for Windows at http://www.7-zip.org/download.html.) 2.
Linux/Unix 1. Insert a USB flash memory device and copy the saved system diagnostics, Diagnostic.tgz, to the home directory. 2. Open a terminal and browse to the home directory. 3. Type tar xvfz Diagnostic.tgz in the command line. You have now successfully opened your System Diagnostic! What to look for in System Diagnostics ● ● ● The commands folder contains files such as: ◦ dmidecode.txt with information on the BIOS and graphics ◦ dpkg_--list.
