HP ProLiant xw2x220c Remote Graphics Software 5.3.0 User Guide
HP ProLiant xw2x220c - Blade Workstation Manual
View all HP ProLiant xw2x220c manuals
Add to My Manuals
Save this manual to your list of manuals |
HP ProLiant xw2x220c manual content summary:
- HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 1
HP Remote Graphics Software 5.3.0 User Guide Part number: 391829-409 Eighteenth edition: September 2009 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 2
to change without notice. 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. HP shall not be liable for technical or editorial errors - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 3
is used in the HP Remote Graphics Software Receiver for Linux. Jack Audio Connection Kit (JACK): JACK is a low-latency audio server, written for POSIX (http://www.apache.org/). Portions of this software were originally based on the following: software copyright (c) 1999, IBM Corporation, http - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 4
RGS features ...14 1-4 Additional RGS features...14 1-5 Tabloid-size page ...15 1-6 Obtaining HP technical support ...15 1-6-1 Software Service Strategy for Non-HP Hardware 15 2 RGS overview 2-1 Supported computers and operating systems 18 2-2 RGS version numbering ...19 2-3 RGS licensing...19 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 5
binding on the Sender ...76 4-3-1 Manual NIC reconfiguration 76 4-3-2 NIC reconfiguration Supported remote USB devices 110 6-3-5 Remote USB Access Control List 111 6-3-6 Determining USB device information 113 6-3-7 Troubleshooting log to detect clipboard problems 130 6-7 Receiver and Sender - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 6
11-4 Configuring your network for optimal performance 177 12 Troubleshooting RGS 12-1 Potential RGS issues and troubleshooting suggestions 179 13 RGS error messages 13-1 Receiver error messages 180 Appendix A: Using RGS with HP VDI A-1 VMware ESX networking considerations 184 Contents 6 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 7
RGS Sender on the virtual machine 187 A-3 Using RGS with dynamic HP VDI (based on VMware View 187 A-3-1 Create a new virtual machine 188 A-3-2 modes available with VDI 189 A-7 Using HP Session Allocation Manager with HP VDI 189 Appendix B: USB devices supported by RGS Appendix C: Linux remote - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 8
Features of HP RGS ...14 Figure 2-1 Computers and operating systems that support RGS 5.3.0 Computer 24 Figure 2-10 Sharing between workstations ...25 Figure 2-11 Standard Login process Sender GUI ...56 Figure 3-10 The Remote Graphics Sender service 57 Figure 3-14 3D Updates tab...58 Figure 3-15 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 9
key 108 Figure 6-15 After remote attachment of the USB drive key 108 Figure 6-16 Dynamically moving USB devices to another Remote Computer 109 Figure 6-17 Checkbox to enable Remote USB 115 Figure 6-18 HP Remote Virtual USB driver 116 Figure 6-19 Enable installation of remote USB 116 Figure - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 10
36 Table 2-2 Linux RGS audio data paths...38 Table 10-1 RGS Sender events logged in the HPRemote log 167 Table 12-1 Potential RGS issues and troubleshooting suggestions 179 Table A-1 VMware ESX versions that support RGS 183 Table A-2 VMware View versions that - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 11
desktop experience. HP RGS supports a broad range of client virtualization technologies including multi-user virtual desktop infrastructure (VDI) solutions, blade PCs, blade workstations, desktop PCs, mobile PCs and workstations. IMPORTANT: Beginning at RGS 5.2.0, HP implemented licensing for - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 12
supported on Linux-based Remote Computers. IMPORTANT: • For a version of the HP RGS 5.3.0 User Guide that may be more current than this document, visit the HP website www.hp.com/support HP ProLiant xw460c Blade Workstation keyboard & mouse inputs HP Compaq t5720 Thin Client The blade workstation - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 13
Receiver Local Computer Remote User (if present) HP ProLiant xw460c Blade Workstation keyboard & mouse inputs Local User HP Compaq t5720 Thin Client The Sender and Receiver provide the primary user's desktop is described in detail in this guide. Introduction to HP Remote Graphics Software 13 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 14
the applications running on the Remote Computer. Local Computer #1 Remote Computer TCP/IP network HP ProLiant xw460c Blade Workstation Local Computer #2 • Application transparency-HP RGS supports application transparency, which enables applications to be run on the Remote Computer, and accessed - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 15
an HP blade workstation running Windows features. 1-5 Tabloid-size page This guide contains a tabloid-size page that troubleshoot the problem with the service technician. For a listing of all worldwide technical support phone numbers, visit www.hp.com/support, select your region, and click Contact HP - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 16
products 1-6-2 Other RGS Documents Other RGS documents such as the HP Remote Graphics Software Licensing Guide and the HP Remote Graphics Software RGS Session Information Interface Specification can be found at: http://www.hp.com/support/rgs_manuals Introduction to HP Remote Graphics Software 16 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 17
• RGS connection topologies • One-to-one • Many-to-one • One-to-many • RGS operating modes • Multi-monitor configurations • Remote USB operation • Supported keyboards • Security features This chapter provides an overview of each of these features. For a description of new features and other late - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 18
Vista Business, Ultimate and Enterprise 32-bit, 64-bit RHEL V4 (update 5 or later) V5 (update 2 or later) 64-bit Blade Clients HP Blade Workstations X X HP only HP Blade PCs 32-bit only 32-bit, non-aero only VDI Servers 32-bit hosted desktop 32-bit, non-aero only Desktops Personal - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 19
applies only to the RGS Sender. For detailed information on RGS licensing, see the HP Remote Graphics Software Licensing Guide, available at www.hp.com/support/rgs_manuals. Two types of licenses are supported by the RGS Sender: • Local license file-With local licenses, each system running the - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 20
license- This RGS product runs on all RGS supported platforms, including: notebooks, desktop PCs, mobile workstations, personal workstations and HP blade workstations. In addition, this key will also run on VMware VDI and HP Blade PC platforms that are supported by the RGS VDI license key. All RGS - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 21
to its default size by RGS. Full-screen DirectDraw applications are not supported (however, DirectDraw applications in a Window may work, and should be qualified individually). On Remote Computers running Linux, OpenGL-based applications can only be remoted if the Remote Computer is using NVIDIA - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 22
is optional on the Remote Computer. For example, if the Remote Computer is a Personal Workstation, a monitor (plus a keyboard and mouse) would typically be attached. If the Remote Computer is an HP ProLiant Blade Workstation, it is not possible to attach a monitor to view the primary (NVIDIA) frame - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 23
Figure 2-6 Addition of scroll bars if the Remote Display Window is resized smaller Remote Computer (Sender) Local Computer (Receiver) Scroll bars are created if the Remote Display Window is resized smaller than when it was originally created. NOTE: RGS does not provide a scale-to-fit capability - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 24
the audio follows focus option. 2-8-4 One-to-many connection RGS also supports a one-to-many connection, allowing the frame buffer of a Remote Primary User (logged into Remote Computer) If the Remote Computer is a blade workstation, it will typically not have a monitor connected to it. The above - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 25
from the Remote Computer. This, however, doesn't have to be the case. RGS works equally well sharing between workstations (see Figure 2-9). Figure 2-9 Sharing between workstations Remote Computer Local User 1 (viewing primary user's desktop session) Primary User is logged into the computer using - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 26
Login RGS supports two additional login methods on certain Windows-based Remote Computers. These login methods are currently only supported on Windows two factors to consider are: • If Single Sign-on is used with HP Session Allocation Manager (SAM), the user will only need to enter their credentials - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 27
Mode is described in Chapter 7, "Using Directory Mode." NOTE: Prior to RGS 5.2.0, RGS supported a third operating mode-Enterprise Service Mode. Enterprise Service Mode was based on the creation of a network service which specified which Remote Computers the RGS Receiver should connect to. Enterprise - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 28
2-12 Multi-monitor configurations Many computers have a frame buffer that is larger in size (as measured in horizontal pixels by vertical pixels) than what can be displayed on a single monitor. In these situations, the default operation is that a portion of the frame buffer is used, allowing the - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 29
disabled overlay surfaces, it may display incorrectly. If this is the case, check to see if your OpenGL application provides a mechanism for the user to manually disable the use of overlay surfaces. RGS overview 29 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 30
to reduce the network bandwidth requirements-this enables RGS to be used on standard networks. Image decompression is performed on the Local Computer. RGS supports setting of the Image quality on a per-Receiver basis. Image quality is adjusted using the slide bar in the Remote Display Window Toolbar - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 31
remote USB, which allows USB devices connected to the Local Computer (local USB devices) to be attached to a Remote Computer. Remote USB is supported on Remote Computers running Windows, and enables the Remote Computer to have direct access to the local USB devices as if they are connected directly - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 32
an RGS connection (see Figure 2-19). IMPORTANT: In addition to the general default settings for remote USB configurations, RGS 5.2.6 and higher releases support auto-remote and auto-return of user-specified USB devices when using Windows on both the sender and receiver platforms. Auto-remote allows - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 33
Figure 2-19 USB device accessibility for the setting "USB devices are Local/Remote" USB devices are Local/Remote These devices will only be locally accessible (never remotely) because they were plugged in while no RGS connection was established. Device #3 will be remotely accessible because it - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 34
Figure 2-20 Smartcard reader accessibility pre- and post-RGS connection for settings "USB devices are Remote" or "USB devices are Local/Remote" Smartcard reader will be locally accessible. USB devices are Remote or USB devices are Local/Remote smartcard reader smartcard plugged in plugged in - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 35
and Enterprise 32-bit, 64-bit X X X X Embedded Linux HP ThinPro GT HP Blade WS Client HP Blade WS Client HP ThinPro Sender Remote USB Support Matrix HP Blade Workstations HP Blade PCs VDI Servers Personal Workstations Mobile Workstations Desktop PCs Notebook PCs Windows XP Professional SP1, SP2 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 36
Remote Computer also using Microsoft Windows XP. Remote microphone is not supported on Microsoft Windows Vista. Figure 2-22 shows the RGS audio subsystem microphone b RGS Audio Player c HP Remote Microphone virtual device d Application 1 3 2 audio device HP Remote Audio virtual device 4 5 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 37
no audio device (such as with a blade Audio Recorder captures the selected microphone workstation), the HP Remote Audio virtual source. device is USB driver-see Appendix B 8. The audio device drives an audio output device, for the supported microphones. See the previous section such as a - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 38
in Figure 2-22 are retained below, but partially obscured if not supported on Linux. Figure 2-23 RGS audio subsystem on Linux Linux Remote remote USB microphone b RGS Audio Player c HP Remote Microphone virtual device d Application 1 3 2 audio device HP Remote Audio virtual device 4 5 RGS - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 39
supported on blade workstations. USB devices are Remote: Beginning at RGS 5.2.0, certain USB microphones can be mounted to the Remote Computer using the 3. The HP Remote Audio virtual device is not supported . 8. The audio device drives an audio output device, such as a speaker. RGS overview 39 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 40
manner as other USB devices. See Appendix B for a list of supported USB microphones (listed under Sound recording devices). To remotely attach USB directly by the Remote Computer. Figure 2-19 shows these two cases. HP recommends using the audio access method introduced at RGS 5.2.0, whereby the - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 41
) V5 (update 2 or later) 32-bit, 64bit HP xw and z series HP ThinPro GT HP Blade WS Client HP Blade WS Client HP ThinPro Sender Audio Support Matrix Blade Clients HP Blade Workstations HP Blade PCs VDI Servers Desktops Personal Workstations Mobile Workstations Desktop PCs Notebook PCs Windows XP - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 42
simplicity, the phrase "cut and paste" is used subsequently to refer to both cut and paste as well as copy and paste. At RGS 5.2, support was added for cut and paste between two Remote Display Windows (see Figure 2-25). Figure 2-25 Remote Clipboard operation Remote Display Window #1 Local Window - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 43
, it must be enabled during both the Sender and Receiver installations on Microsoft Windows (see Figure 2-26). See "Manual installation of the Receiver on Windows" and "Manual installation of the Sender on Windows" for further information on Remote Clipboard installation. Figure 2-26 Enabling Remote - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 44
user desktop sessions to run as separate virtual machines, while sharing the underlying physical hardware resources such as CPU, memory, networking, and storage. For information on VDI, visit www.hp.com/go/vdi. For information on installing and using RGS in the VDI environment, see Appendix A: Using - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 45
when connected to a Linux Sender: 1. French 2. German 3. Japanese 4. Norwegian 5. Swedish 6. United Kingdom 7. U.S. English The following keyboard localizations are supported when connected to a Windows Sender: 1. Belgian French 2. Canadian French 3. Chinese (Simplified) - US Keyboard 4. Chinese - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 46
the primary user has disconnected. This feature is supported on Windows. On Linux, this feature is supported on the Gnome, KDE, and CDE desktop enabled: If the iLO remote console is enabled on a HP Blade Workstation, connections to the blade using RGS are denied. • Disconnect all: All Receivers can - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 47
Graphics Software Licensing Guide at www.hp.com/support/rgs_manuals for detailed information. NOTE: The RGS Sender is configured to start when the Sender computer boots (or, in the case of Linux, also when the X server starts. The RGS Receiver can be started from a command line. However, because - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 48
3. During the installation, the Remote USB Configuration dialog is displayed (see Figure 3-1 and Section 2-16, "Remote USB overview"). Additional information can be viewed by selecting I'm not sure, I want more information, and clicking Next. Select the USB configuration option that meets your needs - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 49
NOTE: Selecting "Yes" will cause the hprclipboard.dll library to be installed with the RGS Receiver. If you select "No", this DLL won't be installed and you won't be able to use Remote Clipboard. To enable Remote Clipboard later, you would need to reinstall the RGS Receiver, and select "Yes" in the - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 50
Removes the user specific Receiver settings from the registry. /viewlicense Displays the EULA (End User License Agreement) for use of this software. /help Display usage text. Installing RGS 50 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 51
Receiver installation log file Installation of the Receiver creates an installation log file. This log file can be viewed by the user to obtain details about what operations were performed, and view any errors that occurred during the installation process. When Setup.exe for the RGS Receiver is run, - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 52
a non-supported computer will prevent an RGS connection from being established. This section covers the following topics: • Manual installation of the -click Setup.exe to start the Sender installation, and follow the instructions on the screen. 3. During the installation, the Remote Graphics Sender - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 53
. However, the dialog shown in Figure 2-3 will be displayed in the Remote Display Window. Installation of the license file is described in detail in the HP Remote Graphics Software Licensing Guide, available at www.hp.com/support/rgs_manuals. Installing RGS 53 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 54
, RDP interoperability, and Easy Login settings) that might prevent a remote connection. If the tool detects a problem, the dialog of Figure 3-6 is displayed, allowing you to run the tool manually. Figure 3-7 shows the output generated by the tool. Figure 3-7 Output of the RGS Diagnostics Tool The - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 55
whether this failure would prevent connections, and how to fix the problem, click on the Multiple Sessions test title to display its details service with Windows. rgsender.exe supports the following options passed to it via registry parameters to rgsendersvc.exe (see the registry editing instructions - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 56
with the new option. This can be done using the Windows Service Control Manager (see "Manually starting and stopping the Sender on Windows") or by re-starting the computer. The Sender GUI on Windows The Windows Sender displays the HP Remote Graphics Software icon in the application tray. On Windows - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 57
frequent access to the CPU, and improves the update service start up parameters in the Windows Registry. (see the regedit instructions in the Starting the Sender on Windows section) • Use HP Performance Tuning Framework (PTF) to configure Windows Sender priority (available only on HP Workstations - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 58
3D Updates tab IMPORTANT: RGS versions prior to RGS 4.0 required the manual placement of the RGS OpenGL32.dll library into the application directory for fail on startup. Because automatic updates of OpenGL applications are now supported, the OpenGL32.dll library is no longer required, and should be - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 59
The GINA Setup tab on the rgadmin tool can be used to enable Single Sign-on and Easy Login (see Figure 3-11). When rgadmin is brought up, it reports the current status of Single Sign-on and Easy Login. To change the status, check the desired radio button. After clicking Apply, you'll be requested to - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 60
and IT administrators only. Please read all directions completely before proceeding, and exercise caution when installing. Single Sign-on is only supported on HP blade workstations running the RGS Sender. The RGS shared library, hprgina.dll, enables Single Sign-on. The file hprgina.dll is a GINA - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 61
Single Sign-on IMPORTANT: The rgadmin tool is only installed and supported on Windows XP. The rgadmin tool can be used to enable operating system are being modified. To manually enable Single Sign-on, perform the following steps: 1. Install the Sender on the HP workstation. If the RGS Sender is not - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 62
logon: Do not require CTRL-ALT-DEL" must be disabled to support Single Signon. This can be set in the Windows "Local Security rgadmin tool to disable Single Sign-on is preferred over the manual method, described next. 2. Manually disabling Single Sign-on To disable Single Sign-on without using the - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 63
and exercise caution when installing. Easy Login is only supported on HP blade workstations running the RGS Sender. The RGS shared library, hprgina Easy Logon is preferred over the manual method, described next. 3. Manually enabling Easy Login Although the manual method is not the preferred method - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 64
and click Apply. Using the rgadmin tool to specify a custom GINA module is preferred over the manual method, described next. 3. Manually enabling hprgina.dll to load a custom GINA module To manually enable the hprgina.dll module to load a custom GINA module, create a new registry key, ChainedGinaDLL - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 65
logon: Do not require CTRL-ALT-DEL" must be disabled to support Easy Login. This can be set in the Windows "Local Security the rgadmin tool to disable Easy Login is preferred over the manual method, described next. 2. Manually disabling Easy Login To disable Easy Login without using the rgadmin - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 66
is "msgina.dll", can only be specified if /el is used. /rgslicenseserver= The license to run the RGS Sender is acquired from a license server listening on the specified port and host. The port/host must be in the form of port@host. The port and the trailing "@" are optional - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 67
by specifying the option as "/rgslicensefile=", in which case the Sender will be installed without a license, and the license file can be manually copied to the install folder at a later time. Only one of /rgslicenseserver= or /rgslicensefile= may be specified. If neither /rgslicenseserver= or - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 68
from appropriate Senders. This software (based upon ALSA sound libraries and JACK-AudioConnection-Kit libraries) must be built and installed on the target system as a part of the install.sh script. The install script assumes a supported set of ALSA sound libraries from HP or Red Hat Enterprise Linux - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 69
Linux Receiver, the audio component uses the JACK sound server API. JACK is a lowlatency sound server that works in conjunction with the ALSA sound drivers sound libraries must be HP-supported or Red Hat Enterprise Linux (release 4 or greater) versions for best results. Manual installation of prior - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 70
the RGS install.sh script in /opt/hpremote or may be utilized for manual installations / RPM package building. The install process requires a locally writable directory in which to build. Locate the support bundle in an appropriate directory before installation. Use the following command to unpack - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 71
Sender licensing on Linux, see the HP Remote Graphics Software Licensing Guide, available at www.hp.com/support/rgs_manuals. To install the Sender on server will be modified to load the rge extension in the "Modules" section. If a different X server configuration is used, that file must be manually - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 72
manually HP ProLiant Blade Workstation, the blade workstation needs to be rebooted into User Mode after Sender installation is complete. For information on selecting User Mode, refer to the document Administrator's Guide for Linux on HP ProLiant Blade Workstations, available at www.hp.com/support - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 73
in the previous section. The Sender cannot be started manually. Proper configuration and startup of the Sender can be verified by examining the X server log file (Xorg.0.log). The log file will show remove both packages, and then apply the new software rpms for supported results. Installing RGS 73 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 74
also be used as a troubleshooting aid. If a connection attempt fails, the checklists below can be used to help diagnose the problem. NOTE: The port used on RGS licensing, see the HP Remote Graphics Software Licensing Guide, available at www.hp.com/support/rgs_manuals. NOTE: The Sender licensing - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 75
was started, you'll need to restart the Sender service/daemon. • NIC binding-If the Remote Computer has do not reliably support outside connections-Users who manually start X desktops the Sender computer is unable to connect to a DHCP server. Because the private IP addresses are not visible to - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 76
. Methods 1 and 2 are described in the next two sections. 4-3-1 Manual NIC reconfiguration The RGS Sender binds to the first NIC detected during booting 4-1). Figure 4-1 Viewing NICs 2. Double-click each LAN icon and the Support tab, which displays the NIC IP address (see Figure 4-2). While this - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 77
a connection from the RGS Receiver to the blade workstation, enter a hostname or IP address in the HP Remote Graphics Receiver box. If you enter a IP address (instead of hostname) in the HP Remote Graphics Receiver box. • Reconfigure your DHCP and DNS servers so that the hostname resolves to the IP - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 78
Figure 4-5 Restarting the RGS Sender 4-3-2 NIC reconfiguration using the NIC binding properties At RGS 5.1, several new Sender properties were added to allow the administrator to configure which NIC(s) the RGS Sender will listen to for connection requests. For a description of these properties, - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 79
through a firewall. To take advantage of this feature, the Sender and Receiver firewalls must both support NAT (Network Address Translation). In addition, the Sender firewall must support port forwarding (see Figure 4-7). Figure 4-7 RGS operation through a firewall NAT source IP: port dest IP - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 80
HP recommends that you verify that the Remote and Local Computers satisfy the checklist in Chapter 4, "Pre-connection checklist." The checklist in Chapter 4 can also be used as a troubleshooting start menu From command line The RGS Receiver supports the following command line options for the Windows - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 81
After the Receiver starts, you'll see the Receiver Control Panel (see Figure 5-2). Figure 5-2 Receiver Control Panel To create an RGS connection, enter the hostname or IP address of the Remote Computer in the Hostname dialog box, and press Enter or click Connect. NOTE: At RGS 5.2.5, the capability - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 82
For information on Sender licensing, see the HP Remote Graphics Software Licensing Guide, available at www.hp.com/support/rgs_manuals. IMPORTANT: On Linux, The Receiver failed." The status bar can be useful in diagnosing connection problems because it also displays the general reason for a connection - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 83
NOTE: In Normal Mode, only a single Remote Display Window can be displayed on the Local Computer. Displaying multiple Remote Display Windows on the Local Computer requires using Directory Mode (see Chapter 7, "Using Directory Mode"). Setup Mode can be activated in two ways: • By clicking the Setup - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 84
Directory Mode). Figure 5-5 Remote Display Window selection dialog The Remote Display Window selection dialog is only displayed in Directory Mode-this is the mode that supports multiple Remote Display Windows. Using RGS 84 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 85
in a manner to better preserve their visual quality, but at the possible expense of higher network bandwidth and/or lower image update rates. HP recommends that you experiment with different settings of the image quality slide bar and the Boost checkbox to find the optimal settings for your - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 86
to the Remote Computer. Monitor blanking is supported on all Windows computers that support gamma. On these computers, the default behavior logs out. Below are several additional details on monitor blanking on HP xw Personal Workstations: • The one element on the monitor that does not go blank - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 87
used to adjust only the Receiver window will provide the best results. 5-2-3 Black or blank connection session with the Linux Sender Connection to an X server that is configured with less than 24-bit or 32-bit default visuals (depending on the graphics device) will cause the Linux Sender to generate - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 88
"Establishing an RGS connection using Standard Login." • Easy Login-supported on Windows XP Professional Senders on HP blade workstations • Single Sign-on-supported on Windows XP Professional Senders on HP blade workstations and HP personal workstations. For an overview of Single Sign-on and Easy - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 89
local user Figure 5-10 Local user Standard Login process and primary user flowchart attempt to log in using Standard Login Attempt to connect to Remote Computer Windows-to-Windows connection AND local user credentials match any credentials on Remote Computer ? RGS authentication dialog N " - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 90
or the locked screen dialog. Figure 5-11 Easy Login process local user attempt to log in using Easy Login • Remote Computer must be an HP blade workstation • Remote Computer must be running Windows • Easy Login must be enabled on the Remote Computer • No other RGS connection can exist is another - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 91
authentication. Figure 5-12 Single Sign-on process local user attempt to log in using Single Sign-on • Remote Computer must be an HP personal or blade workstation • Remote Computer must be running Windows • Single Sign-on must be enabled on the Remote Computer • No other RGS connection can exist - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 92
5-4 Changing your password In RGS 5.0 and earlier, attempting to make a connection with an expired password would generate an Authentication failed! error message. In this situation, the user would either need direct access to the Remote Computer to change the password, or would need to call IT to - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 93
a variety of collaborative scenarios including classroom instruction, design reviews, and technical support. 5-5-1 Creating a collaboration session A User (logged into Remote Computer) If the Remote Computer is a blade workstation, it will typically not have a monitor connected to it. The - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 94
Receivers are connected. On Linux, the Sender GUI is present on the desktop and displays connection status. All Receivers can be easily disconnected from the HP Remote Graphics icon located in the system tray or from the Sender GUI by right-clicking on the icon or GUI. This is useful when - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 95
All non-primary users can be disconnected using the Sender GUI. Figure 5-19 shows the Windows Sender GUI selection that can be used to disconnect non-primary users. Figure 5-19 Windows Sender GUI to disconnect non-primary users Prior to RGS 5.2.0, the collaboration notification dialog could not be - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 96
6 Advanced capabilities This chapter discusses the many advanced capabilities of RGS. Click on the Advanced>>> button in the Receiver Control Panel to display the tabs shown in Figure 6-1. Figure 6-1 Tabs to access advanced RGS capabilities The capabilities available under each of these tabs will be - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 97
6-1 General options The options available under the General tab are shown in Figure 6-2. Figure 6-2 General tab options The options available under the General tab are: • Prompt for username and password-In certain scenarios (such as silent authentication as described in Section 5-3-1, "Standard - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 98
6-2 Remote audio operation For an overview of remote audio, see Section 2-17, "Remote audio overview." Before describing the RGS audio capabilities available under the Receiver Control Panel Audio tab, Sender audio configuration and calibration are described. 6-2-1 Configuring audio on the Microsoft - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 99
Microphone virtual device Data path for microphone input from the Local Computer Application HP Remote Audio virtual device audio device Installed in HP Personal Workstations, not installed in blade workstations RGS Audio Recorder Data path for audio playback on the Local Computer Audio - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 100
The HP Remote Audio device has only the mixer available in the recording control panel and the volume level for this line cannot be adjusted. If an - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 101
Receiver. See the following section to improve the audio quality. If you are not receiving an audio signal, refer to the Windows Audio Troubleshooting section. 6-2-2 Calibrating audio on the Microsoft Windows XP Professional Sender The audio signal captured by the Sender is modified by two different - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 102
The next volume control to adjust is the mixer line in the Recording Control window. The name of this line varies with different audio devices. See the Windows Sender Audio Installation section for information on how to determine the name of this control. For our example, the control is called Wave - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 103
change when mute is enabled. Enabling mute on some devices will prevent audio from arriving at the Receiver. The Realtek audio device used in the HP xw4300 has this issue. One possible solution when running the 32 bit version of Windows is to disable the audio device prior to installing the - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 104
6-2-4 Using audio The audio controls in the Receiver Control Panel are shown in Figure 6-11. Figure 6-11 Audio controls Microphone Button: Click to enable and disable microphone input from the Local Computer to the Remote Computer. audio playback volume control Speaker Button: Click to enable and - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 105
priority CPU intensive tasks may disrupt the audio stream. The Windows Task Manager may help you identify such a task. Another possible problem may device that is registered as the default audio device. The Sender is a service that is running in a different context. If you have multiple audio devices - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 106
, see Section 2-16, "Remote USB overview." This section provides an example of using remote USB. A USB drive key is plugged into the Local Computer, and remote USB is used to attach the drive key to a Remote Computer. This example assumes the Receiver was installed with the remote USB configuration - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 107
Remote Computer. When enabled, USB devices plugged into the Local Computer appear to the Remote Computer as locally attached devices. Because remote USB supports hot plug connections, it is not necessary to disable remote USB before plugging or unplugging USB devices on the Local Computer. • Select - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 108
the Local Computer before the remote USB attachment is made. Figure 6-14 Prior to remote attachment of the USB drive key Remote Computer Local Computer To connect the USB drive key to a Remote Computer in Directory Mode, perform the following steps: 1. Click the USB tab on the Receiver Control - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 109
experienced personnel. Because an incorrect Registry setting can cause serious problems, you should always make a backup of the Registry numbered 0 thru 31. This allows support of up to 32 auto-remoted USB devices. HKLM\System\CurrentControlSet\Services\hprpusbh\Parameters\AutoDevice\ 3. In the - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 110
Value and set its value to 1: HKLM\System\CurrentControlSet\Services\hprpusbh\Parameters\NoAutoDevice This will disable auto-remoting without having to set NoAutoDevice to 0 or remove the NoAutoDevice DWORD. 6-3-4 Supported remote USB devices HP has tested a number of USB devices to verify they work - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 111
ACL file, which resides on the Remote Computer, supports allowing/denying USB device attachments based on the following nine USB descriptor fields: 1. Device > Allow all USB devices (HP default) The following example ACL file - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 112
be reliable. Device vendors are not required to add data to these fields, and many do not. Before deploying a solution that depends on a string-based filter, ensure that the devices you wish to use implement the appropriate device strings. • IP address of the Local Computer-peerAddress • The domain - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 113
6-3-6 Determining USB device information This section describes how to obtain several of the most-used USB device parameters. Determining USB device information for Windows To obtain the Vendor ID and the Product ID for a USB device on Windows, perform the following steps: 1. Open the device manager - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 114
hosted at: www.usb.org/developers/defined_class 6-3-7 Troubleshooting remote USB If you have problems connecting a remote USB device from a Local Computer to a Remote Computer, the following checklist may help identify the problem. Computers supporting remote USB Ensure that both the Remote Computer - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 115
Enable Remote USB Verify that Remote USB is enabled under the USB option tab of the Receiver Control Panel (see Figure 6-17). Figure 6-17 Checkbox to enable Remote USB Advanced capabilities 115 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 116
Remote Virtual USB is listed under Universal Serial Bus Controllers (see Figure 6-18). Figure 6-18 HP Remote Virtual USB driver If the HP Remote Virtual USB driver is not reported, reinstall the RGS Sender software. During installation, verify that the Remote USB box is checked in the Configuration - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 117
USB device drivers and program support Verify that the device drivers and programs required by the device are installed and available on the Sender system. Many USB devices require manufacturer-supplied - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 118
Figure 6-20. Figure 6-20 Options available under the Network tab RGS supports three classes of user-settable timeouts: 1. Receiver network timeout properties-After Network over-subscription, resulting in congestion and packet loss • CPU utilization by other processes and tasks, starving the TCP/IP - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 119
the TCP/IP network stack is able to detect and resolve network errors, such as a transmitted packet not being acknowledged. However, if a more serious problem occurs, such as a network cable being unplugged from the Local Computer, the TCP/IP stack will notify the RGS Receiver of a network exception - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 120
being detected by the Receiver. Figure 6-22 Receiver timeout sequence • TCP/IP stack may detect & resolve problems. • Network disruption may not be noticeable. • Serious network problems may cause the RGS connection to close. 2 0 seconds sync pulses stop being detected by the Receiver network - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 121
Sender network timeout The RGS Sender supports the Sender error timeout property, Rgsender.Network.Timeout.Error. timeout expires, the Sender will not send image updates to other Receivers (if the Server is serving multiple Receiver connections). This will impact the interactivity of other users for - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 122
the network connectivity between the Receiver and Sender was temporarily lost. Other possible problems include: • The Sender unexpectedly terminated. • The Remote Computer experienced a failure • The Remote Computer CPU utilization prevented the Sender from making progress, • The length of this - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 123
. If the Sender times out, the Receiver will also time out (based on its Rgreceiver.Network.Timeout.Dialog property) because no authorization reply will be The 15 second Receiver and Sender dialog timeouts should support most authorization and authentication scenarios. For more complex scenarios - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 124
6-5 Hotkeys Hotkeys are key sequences that cause special action to be taken by the Receiver. Such key sequences are processed by the Receiver, and are not sent to the Remote Computer. However, a hotkey sequence may initiate some type of interaction with the Remote Computer. The Receiver Control - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 125
space bar-this activates Setup Mode. You will remain in Setup Mode until you release the Shift key. • Additional hotkeys-The following hotkeys are also supported; these hotkeys can be entered as either upper case or lower case: "H"-Toggles the Remote Display Window Toolbar on and off (see Section - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 126
installed by default and is enabled or disabled via a toggle in the Receiver's controls. Both cut and paste, and copy and paste, are supported in the following scenarios at RGS 5.3.0: Between a Local Window and a Remote Display Window (in both directions)-The Remote Computer may be running Windows - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 127
6-6-1 Remote Clipboard data transfers Figure 6-25 shows the data transfer that occurs when a cut and paste is performed using Remote Clipboard. In this example, the cut occurs from within the Remote Computer application (as initiated from the Remote Display Window), and the paste occurs into the - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 128
As we've seen, the terms "Remote Computer" and "Local Computer" have very specific meanings in the context of RGS. In the context of Remote Clipboard, however, we use terms that are centric to each computer involved in a Remote Clipboard operation. If a cut and paste is being performed from Computer - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 129
a cut is performed within Microsoft Word, one of the clipboard formats supported by Word is ASCII text. This allows a paste into, for example links will no longer point to a valid location. There are other potential problems, such as links to websites. Consider the act of cutting and pasting from - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 130
in XML (Extensible Markup Language) format. This format is supported by other applications as well. The Remote Clipboard system uses connection (session) is established. 6-6-3 Using the RGS log to detect clipboard problems As described in the next section, "Receiver and Sender logging," both the - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 131
To demonstrate use of the RGS logs to view Remote Clipboard information on the Receiver and Sender computers, an example is presented in which a copy and paste is performed from a Sender computer to a Receiver computer. The steps in this example are: 1. Set the Rgreceiver.Clipboard.FilterString - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 132
Now that the filter string has been sent from the Receiver to the Sender, we'll switch to the Remote Clipboard nomenclature of Figure 6-28. Figure 6-31 shows the Remote Clipboard log entries as the cut and paste is performed. Figure 6-31 Remote Clipboard log entries for cut and paste sending - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 133
6-7 Receiver and Sender logging Both the RGS Receiver and the RGS Sender have the ability to log various types of information to files during their operation. Receiver logging can be enabled from the Receiver Control Panel, while Sender logging is controlled by a file on the RGS Sender. Both types - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 134
6-7-2 Sender logging RGS Sender logging is not controlled by a GUI-instead, Sender logging is controlled by a particular file on the RGS Sender. In Section 3-1-2, "Installing the Sender on Windows," the following command line option for Rgsender.exe is described: -l logSetupFile-Specifies the " - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 135
6-8 Statistics The options available under the Statistics tab in the Receiver Control Panel are shown in Figure 6-34. Figure 6-34 Options available under the Statistics tab The Statistics tab displays aggregate data for all connected sessions. • Total network usage (Mbits/sec)-The combined network - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 136
the local user to automatically open connections to multiple Remote Computers based on the computers assigned to each user. When the user for any number of users. HP recommends that you save the directory file on a readily-accessible network file share or mapped drive so that each RGS Receiver can - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 137
7-1-2 Starting the Receiver in Directory Mode Before attempting a connection in Directory Mode for the first time, HP recommends that you verify that RGS can connect to each computer individually in Normal Mode (see Section 5-1, "Using RGS in Normal Mode"). As noted in - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 138
is highlighted with a red border. The Remote Display Window selection dialog is only displayed in Directory Mode-this is the mode that supports multiple Remote Display Windows. While the Remote Display Window selection dialog is active, navigate between windows (thumbnails) by: • Pressing TAB to - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 139
8 RGS properties RGS allows the user to specify many properties of the RGS connection, both on the Sender and Receiver. By specifying properties, the user can modify RGS characteristics such as: • Display of borders on the Remote Display Window • Codec quality • Audio quality • Connection timeouts - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 140
8-3 Setting properties on the command line Properties can also be set on the command line when the Receiver and Sender are started. Property values entered on the command line override any properties set with other methods. All properties must begin with a "-" on the command line to be recognized as - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 141
, per-session properties can be specified for each Remote Display Window displayed by the Receiver. 8-5-1 Receiver property hierarchy RGS supports the following hierarchy of methods to set the Receiver properties (see Figure 8-1). Figure 8-1 Receiver property hierarchy Highest Properties set - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 142
8-5-2 Receiver property groups RGS supports the following groups of Receiver properties. Click on each group name to view the descriptions of the properties in the group. • Per-receiver properties • General - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 143
• Remote Clipboard properties group (see below for the per-session Remote Clipboard property) • Rgreceiver.Clipboard.IsMutable • Rgreceiver.Clipboard.IsEnabled • Rgreceiver.Clipboard.FilterString • Logging properties group • Rgreceiver.Log.IsMutable • Rgreceiver.Log.IsFileLoggerEnabled • Rgreceiver. - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 144
In Figure 8-2, the Receiver is started with the command line option -Rgreceiver.Network.Timeout.Error.IsMutable=0, which prevents the user from changing the value of the network timeout error property. Figure 8-2 The Receiver timeout error IsMutable property is set to 0 Because the Receiver timeout - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 145
the resolution of the Remote Computer to the same full-screen resolution of the Local Computer. If the Local Computer display resolution is not supported by the Remote Computer, the connection occurs at the existing Remote Computer (Sender) resolution, and a warning dialog is issued to the user. The - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 146
Rgreceiver.IsMatchReceiverPhysicalDisplaysEnabled=bool (0) Rgreceiver.IsMatchReceiverPhysicalDisplaysEnabled.IsMutable=bool (1) If the following conditions are met: 1. This property is enabled. 2. Rgreceiver.IsMatchReceiverResolutionEnabled is enabled (see previous property). 3. Rgreceiver.Session - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 147
is no green component. • The blue component is 0x00. There is no blue component. NOTE: The following property, while supported, has been deprecated. HP recommends that the subsequent properties, Rgreceiver.IsGlobalImageUpdateEnabled and its associated IsMutable property, be used instead. Rgreceiver - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 148
value to 0 (disabling global image updates) is usually best for large Remote Display Windows (5120 x 1024 resolution) that display mostly text based applications. The default value is 0-global image updates are disabled. NOTE: The following property was added in the RGS 5.1.3 release to enable - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 149
of outstanding requests may be beneficial in some cases depending on the number and types of updates occurring. In high-latency network environments, HP recommends that you characterize RGS performance for different values of the Rgreceiver.MaxImageUpdateRequests property. RGS properties 149 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 150
both the RGS Sender and Receiver be version 5.2.5 or later. This feature is supported only on Sender computers running Windows, while the Receiver computer can be running either the Windows Receiver, the Help system is based on a CHM file, which is displayed by the hh.exe program. RGS properties 150 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 151
8-5-5 Receiver audio properties Rgreceiver.Audio.IsMutable=bool (1) If set to 1, the user will be able to modify all audio controls in the RGS Receiver. If set to 0, none of the audio controls can be modified by the user. The default value is 1-the audio controls can be modified by the user. - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 152
Rgreceiver.Usb.ActiveSession=int (0) Rgreceiver.Usb.ActiveSession.IsMutable=bool (1) When the Receiver is in Directory Mode, the Local Computer can connect to one or more Remote Computers. This property specifies the Remote Computer that the local USB devices are attached to. To have all local USB - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 153
Rgreceiver.Hotkeys.IsSendFirstKeyInSequenceEnabled=bool (0) Rgreceiver.Hotkeys.IsSendFirstKeyInSequenceEnabled.IsMutable=bool (1) When enabled, the first key in the hotkey sequence is sent to the Remote Computer. The default value is 0-don't send the first key in the hotkey sequence. Rgreceiver. - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 154
This property is for advanced users only. The property string should be changed from its default value only if Remote Clipboard doesn't support the clipboard format required by your application. For more information on clipboard formats, see the Microsoft Developer Network article Clipboard Formats - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 155
/rg.log. The default path on Linux is $HOME/.hpremote/rgreceiver/rg.log. Rgreceiver.Log.Level=string ("INFO") Rgreceiver.Log.Level.IsMutable=bool (1) RGS supports five logging levels: DEBUG, INFO, WARN, ERROR, and FATAL. If DEBUG is chosen, all level of output from DEBUG to FATAL will be output - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 156
8-5-13 Windows placement and size properties As described previously, these properties are per-session (per-connection) properties. If, for example, the Receiver connects to two Remote Computers, these properties can be used to specify the properties of each of the two Remote Display Windows on the - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 157
in the rgsenderconfig file. Similarly, an rgsenderconfig file property can override a Sender default property. The Sender, unlike the Receiver, does not support archive file properties because the Sender does not provide a user interface that allows its properties to be modified. Sender command line - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 158
when the user logs out. The default value is 1-always disconnect when the user logs out. Rgsender.IsSnapToCodecEnabled=bool (1) If set to 1, the HP Codec will be aligned or snapped to tile boundaries. This will avoid persistent visual artifacts at the expense of potentially increased bandwidth usage - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 159
is only enabled on a blade workstation. To enable Easy Login functionality on a standalone workstation, this property value can X server extension to detect display changes. Microsoft Vista and later is forced to Basic mode. Aero mode is not supported. • "Comparitron" method uses the system's CPU to - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 160
and Receiver interoperability for more details. 8-6-3 Sender microphone property Rgsender.Mic.IsEnabled=bool (1) This property is new with RGS 5.1.3, and is only supported on the Windows Sender. If set to 1, remote microphone is enabled (on/unmuted). If set to 0, remote microphone is disabled (off - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 161
8-6-4 Sender network timeout properties Rgsender.Network.Timeout.Error=int (30000) The timeout in milliseconds used to detect and disconnect an inactive connection. The default value is 30,000 milliseconds (30 seconds). See Section 6-4, "Network timeouts," for more details. Rgsender.Network.Timeout. - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 162
Rgsender.Network.AllowIpAddressSubnet=string (all IP addresses) This property is used to specify the range of IP addresses that the Sender will listen on for an RGS connection request from the Receiver. A NIC must be enabled, and its IP address must be in the range specified by this property, in - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 163
9 Sender event logging on Windows The RGS Sender on Windows supports event logging. Event logging provides information useful for troubleshooting connection problems, and can also be used to automatically terminate applications on the Sender in case the connection is lost between the Sender and the - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 164
connection data (in this case, the number of primary and nonprimary connections) in byte and word formats. Chapter 10 provides more details on the supported data formats. To copy the details of an event to the Clipboard, click the highlighted button in Figure 9-2. By doing a paste into, for example - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 165
Sender IP address hostname port number 9-2 Usages of the HPRemote log The HPRemote log has several important usages: • Troubleshooting-The HPRemote log can be used to aid troubleshooting of connection issues between the RGS Sender and Receiver. If you're unable to view the HPRemote log because - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 166
9-3 Additional information on event logging For additional information on Windows event logging, search Microsoft Developer Network (MSDN) as shown in Figure 9-4. Clicking on the first search result will typically display the page shown. Figure 9-4 MSDN event logging information Search criteria: - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 167
10 Remote Application Termination This chapter describes how to create a Windows agent on the Sender that provides Remote Application Termination. "Remote application" refers to user applications that are running on the Remote Computer (Sender). The sample agent described in this chapter is designed - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 168
EventID: 6 Reference event registered to aid in interpretation of the event log by Event Viewer. Signifies proper shutdown of the RGS Sender service. Event Viewer Message: RGS Sender shutdown. Strings: None Data: None A connection with an associated name is set as the primary connection. Event - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 169
RGSENDER_SET_NONPRIMARY EventID: 7 A connection with an associated name is assigned to a non-primary status. This may happen as a result of a logout. Event Viewer Message: Set %1 as non-primary connection. Strings: %1 = name associated with connection Data: None Event Viewer Example: Set MYDOMAIN\ - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 170
strings must be defined in the function call: • LPCTSTR eventServer: if string is defined as "\\\\yourservername", then the log is stored on a remote server - if the string is empty (NULL), then the log is stored locally (note that four backlashes compiles to two in a string constant). • LPCTSTR - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 171
// Set the pointer to our buffer. Strings and data will get appended // to the EVENTLOGRECORD structure. pevlr = (EVENTLOGRECORD *) &bBuffer; // Read the event specified by dwEventNum result = ReadEventLog(h, // event log handle EVENTLOG_SEEK_READ | // start at specific event - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 172
// If an event is added, either the start or count will change. // Get the start and count. Microsoft does not specify what // reasons these functions could fail, so we cannot ensure // success. Check the return value. if (GetOldestEventLogRecord(h, &dwCurrentStart) == false || - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 173
Shutdown of a remote session frees the workstation for connection by other users. This amount of time can be returned to a remote server pool. • Issue-Potentially more complicated to implement. Can releases for greater support flexibility. Independent agent design supports unit testing and decouples - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 174
loss. General agent design guidelines In developing an agent, HP recommends following these guidelines: • The agent should externally log • Restarting the RGS Sender service can support RGS reconnection with a RGS Receiver client (unless a system error prevents the RGS service from restarting). • In - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 175
Microsoft Remote Desktop Recovery If the RGS Sender becomes unavailable and the Receiver can no longer connect to the Sender, a Windows system with Remote Desktop services enabled can access the Remote Computer to diagnose the issue. Remote Application Termination 175 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 176
and animated cursors very well, this typically requires more network bandwidth and CPU resources. • Set the Remote Computer desktop background to a solid color Lower the Sender display resolution-RGS is an image-based remote visualization technology. Therefore, lowering the Sender display resolution - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 177
java SomeApp 11-3 Troubleshooting graphics performance The dominant factor impacting performance on Auto Detect entry in the Value box. If you want to hard-code the speed and duplex, always choose the fastest link your network can support, and always choose full duplex. • Configuring the NIC on Linux - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 178
or network is not configured correctly. Work with your IT organization to optimize your computer and network configuration. Optimizing RGS performance 178 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 179
Receiver, verify that audio has been installed correctly as described in Section 3-23, "Installing audio on the Linux Receiver." • See the troubleshooting suggestions in Section 6-25, "Potential audio issues." Remote USB doesn't work • Verify that USB has been correctly configured during Receiver - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 180
closed, or temporarily disrupted. 6. The Sender service/daemon may have been stopped, restarted, or Linux computer, the X Server may have been stopped or re-started. 9. The Sender or X Server may have experienced a failure appropriately. Please consult the User's manual and README.txt for the latest - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 181
not found in directory! The username of the current user of the HP Remote Graphics Software Receiver is not found in the directory file. Possible entered in the directory. If the directory file is on a shared drive with restrictive permissions, consult an IT specialist to add the proper entry. - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 182
is accessible on your network and that the Remote Graphics Sender service has been started and is listening on a pubic IP address and is not blocked by a firewall. The iLO remote console is enabled on the HP Blade Workstation. The Blade must be configured in User Mode before connections are allowed - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 183
desktop operating systems that support RGS are Windows XP Professional SP2 and Windows XP Professional SP3. • Virtual machine-A virtual machine (VM) is the combination of VMware ESX and a virtual desktop. The RGS Sender runs on the virtual machine. • Static HP VDI-Static HP VDI is the one-for - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 184
RGS traffic. These NICs should not be used for service console, NFS, iSCSI, or VMotion. General VM topology requires it. A-2 Using RGS with static HP VDI Static HP VDI is a one-for-one replacement of a ESX configuration file for the virtual machine to support RGS. 3. Install and configure the RGS - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 185
modified to support RGS and USB devices over the RGS communication channel. Most values in this file can be set using the Virtual Center GUI. However, a few values must be set by manually editing Advanced line item. Figure A-1 Virtual Infrastructure Client GUI Appendix A: Using RGS with HP VDI 185 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 186
is recommended that you do this by manually editing the .vmx file. The Configuration the virtual machine. RGS requires the presence of HP-specific SMBIOS records to become active. This for the virtual machine use. This is required to support remote USB functionality for RGS. This value can only be - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 187
the RGS Sender installer. 2. Follow the Sender installer on-screen instruction and select the options appropriate for your environment. A-3 Using RGS with dynamic HP VDI (based on VMware View) In this document, dynamic HP VDI is based on using the VMware View manager. The following steps assume you - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 188
. b. The initial release of VMware View 3.1 that supports RGS 5.2.5 does not support RGS Single Sign-on or Easy Login; do not install executable. 2. Install according to View Agent installation instructions. A-3-4 Install the RGS Receiver and View Client on the Appendix A: Using RGS with HP VDI 188 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 189
to properly support RGS in the HP VDI HP Session Allocation Manager (SAM) 2.1 or later can be used to manage RGS connections from client computers to virtual desktop sessions, provided that the HP SAM Registration Service is installed within the virtual desktop. For information on SAM, visit www.hp - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 190
supersedes the separate USB supported devices document. This appendix lists the client-attached USB devices that can be accessed by the RGS Sender. Two types of client computers are listed: • HP Blade Workstation Clients, such as the HP dc73 Blade Workstation Client. • Clients based on Windows XP - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 191
Devices Bloomberg CTB100 US/UK Bloomberg SEA100 US/UK Bloomberg FRE100 US/UK HP Blade Workstation Clients RGS 4.0.0 RGS 5.0 RGS 5.2 Clients based on Windows XP and Windows XPe RGS 5.0 RGS 5.0 RGS 5.2 Notes Support for audio was added at RGS 5.2.0 Table B-3 Trader keypads USB Devices CA Designs - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 192
on Windows XP and Windows XPe RGS 5.0 RGS 5.0 RGS 5.0 Notes Table B-9 Hard drives USB Devices HP Personal 500GB SimpleTech 80GB HP Blade Workstation Clients RGS 5.0 RGS 5.0 Maxtor 300GB OneTouch III RGS 5.0 Clients based on Windows XP and Windows XPe RGS 5.0 RGS 5.0 RGS 5.0 Notes This device - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 193
USB Devices HP Blade Workstation Clients Adaptec USB 2.0 enclosure for IDE hard drives RGS 5.0 Clients based on Windows XP and Windows XPe RGS 5.0 Notes The enclosure works, but the behavior can differ depending on the drive used inside the enclosure. Appendix B: USB devices supported by RGS - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 194
2-17-1, "Remote audio on Windows" for further details). USB Devices Philips SpeechMike Pro Plus Logitech USB Desktop Microphone 980186-0403 HP Blade Workstation Clients RGS 5.2 RGS 5.2 Clients based on Windows XP and Windows XPe RGS 5.2 RGS 5.2 Notes Appendix B: USB devices supported by RGS 194 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 195
Table B-19 Character input devices USB Devices Elan Crystal Touch Pen Pad HP Blade Workstation Clients RGS 5.2 Clients based on Windows XP and Windows XPe RGS 5.2 Notes Appendix B: USB devices supported by RGS 195 - HP ProLiant xw2x220c | Remote Graphics Software 5.3.0 User Guide - Page 196
Linux remote audio device support As shown in Figure 2-23, an audio device is required to be installed in Linux-based Remote Computers in -card model numbers) that are known to work on Linux-based HP xw Personal Workstations operating as Remote Computers: SoundBlaster Audigy 4 - SB0660 SoundBlaster
HP Remote Graphics Software 5.3.0 User Guide
Part number: 391829-409
Eighteenth edition: September 2009