HP Remote Graphics Software (RGS) User Manual

HP Remote Graphics Software User Guide5.4.0

8.6.7 Sender clipboard property ... 1809 Sender event logging on Windows ...

requests on network interface 1 (corresponding to Local Area Connection 4), even though networkinterface 1 is the second network interface in binding

NOTE: The port used by the RGS Receiver is assigned by the Local Computer OS and can vary. TheRGS Sender listens on TCP/IP port 42966. At RGS 5.2.5, t

5Using RGSThis chapter describes how to use RGS to establish a connection from a Local Computer to a RemoteComputer, including:●Using RGS in Normal Mo

The RGS Receiver supports the following command line options for the Windows executable,rgreceiver.exe, and the Linux executable, rgreceiver.sh:[-conf

NOTE: At RGS 5.2.5, the capability was added to specify the port number used by the RGS Sender.The default Sender port number is 42966. The Sender por

In Normal Mode, the Local Computer can connect to only one Remote Computer at a time, asdescribed in One-to-one connection on page 16 If an attempt is

interact with the Remote Display Window on the Local Computer. In Setup Mode, you can perform anumber of operations, including:●Move a borderless Remo

The default hotkey sequence can be changed using the Hotkeys tab in the Receiver Control Panel (seeHotkeys on page 135). As long as the Shift key is h

●CTRL-ALT-DEL button—Sends the CTRL-ALT-DEL key sequence to the Remote Computer. Somekey sequences, such as CTRL-ALT-DEL, are trapped by the Local Com

display the login dialog on the Local Computer. The Remote Computer monitor will remain blankwhile this occurs but the monitor will exit its powersave

A.3.2 Install the RGS Sender on View Master/Parent VM and modify theconfiguration file to optimize for VMware View environment ...

/usr/contrib/bin/X11xprop -root -remove _SGI_CROSSHAIR_CURSOR/usr/contrib/bin/X11xprop -root -remove _HP_CROSSHAIR_CURSORThis will force the applicati

5.3 RGS login methodsRGS provides three methods for the local user to log into a Remote Computer:●Standard Login—supported on Windows and Linux Sender

See the tabloid page (the last page of the PDF version) of this guide for a diagram of the Standardlogin process.5.3.2 Easy LoginThe Easy Login flowch

5.3.3 Single Sign-onThe Single Sign-on flowchart is shown in Figure 5-11 Single Sign-on process on page 97. If theSingle Sign-on conditions are met, t

Starting at RGS 5.1, you can change an expired password from the RGS Receiver. If you enter anexpired password, you will see a dialog stating that the

interact with the primary user’s desktop (see Figure 5-14 Multiple local users can view and interact withthe primary user's desktop on page 99).F

Figure 5-16 Primary user dialog to authorize a local user to connect to the primary user’s desktopThe different cases for establishing a collaborativ

When the collaboration notification dialog is displayed, it indicates there are multiple connections tothe Remote Computer desktop. Primary and collab

6 Advanced capabilitiesThis chapter discusses the many advanced capabilities of RGS. Click on the Advanced>>> button inthe Receiver Control P

6.1 General optionsThe options available under the General tab are shown in Figure 6-2 General tab optionson page 103.Figure 6-2 General tab optionsT

List of tablesTable 2-1 Computers and operating systems that support RGS 5.4.0 ... 10Table 2-2 Co

single Sender physical display resolution of 2560x1024. If that fails, an error is reported to thelocal user.For information on the properties associa

possible with the current RGS protocol. See Application support on page 14 for the official descriptionof supported applications.6.4 Remote audio oper

Figure 6-4 Microphone device selection and audio playback device selection on the SenderNOTE: Remote Microphone can be enabled/disabled using the Rgs

To select the mixer as the input line, click the Volume button in the Sound recording section of Figure6-3 Sound and Audio Devices Properties dialog o

Figure 6-6 Recording Control Properties dialogPress the OK button and the Recording Control window should now have the mixer line as one of thecontro

6.4.2 Calibrating audio on the Microsoft Windows XP ProfessionalSenderThe audio signal captured by the Sender is modified by two different device driv

Figure 6-9 Recording Control dialogThe best sound to play to calibrate your audio device is a low frequency sound with high amplitude. Bydefault, Win

Figure 6-10 Sound and Audio Devices Properties dialogSelect the Critical Battery Alarm program event, and press the play button (the triangle located

6.4.3 Configuring audio on Microsoft Windows Vista and Windows7 SenderWhen a connection is established between a Receiver and Sender, an audio session

6.4.5 Using audioThe audio controls in the Receiver Control Panel are shown in Figure 6-12 Audio controlson page 113.Figure 6-12 Audio controlsThe Sp

List of figuresFigure 1-1 Typical RGS configuration ...

The options available under the Audio tab are:●Audio follows focus—This checkbox determines how audio is handled when the Receiver isconnected to mult

●Audio not continuous—Low bandwidth connections can cause discontinuities in the audio stream.Reducing the quality and turning off stereo may improve

configuration during Receiver installation —USB devices are Local or Remote on page 116. For adiscussion of the USB installation options, see Installi

The USB options are:●Enable Remote USB—This checkbox can be used to dynamically (during an active RGSconnection) enable or disable USB connections to

6.5.2 USB session switchingNew with RGS 5.1.3 is the ability to dynamically move USB devices from one Remote Computer toanother. This enables USB devi

To specify auto-remoting of a particular USB device, perform the following steps:1.Get the vendor id and device id for your usb device using the follo

devices are denied attachment. The ACL file, which resides on the Remote Computer, supportsallowing/denying USB device attachments based on the follow

Rules may contain filters based on the 11 parameters listed previously. These parameters are repeatedbelow along with the name of the filter element.1

6.5.6.1 Determining USB device information for WindowsTo obtain the Vendor ID and the Product ID for a USB device on Windows, perform the following st

that contain most of the registered Vendor IDs and Device IDs. There are different documents thatcontain the different registered classes and subclass

Figure 3-11 3D Updates tab ... 60Figure 3

6.5.6.4.5 Enable Remote USBVerify that Remote USB is enabled under the USB option tab of the Receiver Control Panel (see Figure6-18 Checkbox to enable

6.5.6.4.6 HP Remote Virtual USB DriverVerify that the HP Remote Virtual USB driver is installed and active on the Remote Computer. Open theWindows Dev

Figure 6-20 Enable installation of remote USB6.5.6.4.7 USB device drivers and program supportVerify that the device drivers and programs required by

6.6 Adjusting Network timeout settingsThe options available under the Network tab in the Receiver Control Panel are shown in Figure 6-21Options availa

6.6.1 Network timeoutsRGS uses TCP/IP over a standard computer network to transmit data. Although TCP/IP is a reliabletransport mechanism, it does not

timeout properties are specified in milliseconds. Figure 6-22 Receiver Control Panel on page 129shows the default Receiver timeout periods and the cor

Figure 6-23 Receiver timeout sequenceAfter the Receiver warning timeout property has been exceeded (two seconds, in this case), theReceiver Remote Di

have a dialog to set this property. The Sender error timeout property is independent of the Receivertimeout properties. For legacy reasons, the Sender

◦The Remote Computer CPU utilization prevented the Sender from making progress,◦The length of this connectivity loss exceeds the Receiver’s error time

computer determines that network connectivity is lost and an error returns by the network stack tothe Receiver, then the connection will disconnect so

Figure 6-12 Audio controls ... 113Figure

The Sender dialog timeout property, Rgsender.Network.Timeout.Dialog, can only be set using thergsenderconfig file and from a command line—there is no

6.7 HotkeysHotkeys are key sequences that cause special action to be taken by the Receiver. Such key sequencesare processed by the Receiver, and are n

The options available under the Hotkeys tab are:●Send CTRL-ALT-END key sequence as CTRL-ALT-DEL: On some computers, the operatingsystem will intercept

◦“C”—Closes the Remote Display Window, which terminates the RGS connection◦“G”—Toggles “Game Mode.” Game Mode enables relative cursor movements instea

applications, you will need to perform cut or copy actions by Highlighting the text of interest andselecting the Cut or Copy action normally found in

the clipboard data is transferred from the Remote Computer clipboard to the Local Computer clipboard,and then pasted into the Local Computer applicati

computer or paste computer. Figure 6-27 Cut and paste computer nomenclature on page 140 showsthis nomenclature. When discussing Remote Clipboard opera

Figure 6-28 Cutting and pasting between Remote and Local Computers6.8.2 Remote Clipboard filteringWhen a cut is performed, applications typically sto

filtering of cut and paste data on page 142, which expands on Figure 6-27 Cut and paste computernomenclature on page 140 to show receiving-side filter

●Object Descriptor—OLE2 object descriptor●Link Source Descriptor—Link to OLE2 object●HTML Format—Text is in Hypertext Markup Language format●Rich Text

xvi ENWW

To demonstrate use of the RGS logs to view Remote Clipboard information on the Receiver and Sendercomputers, an example is presented in which a copy a

Figure 6-32 Remote Clipboard log entries for cut and pasteNOTE: If the clipboard on either the Local or Remote Computer already contains content at t

enabled and the location/name of the log file(see Figure 6-33 Options available under the Logging tabon page 146).Figure 6-33 Options available under

Unless this command line option is used to change the logSetup file, the default logSetup file in theSender installation folder (C:\Program Files\Hewl

6.10 StatisticsThe options available under the Statistics tab in the Receiver Control Panel are shown in Figure 6-35Options available under the Statis

7 Using Directory ModeDirectory Mode enables the local user to automatically open connections to multiple Remote Computersbased on the computers assig

worldwide joe RC_4 RC_5 RC_6In the next example, the directory file specifies the Remote Computers for users Sally and Joe in astandalone or WORKGROUP

Figure 7-2 The Receiver Control Panel in Directory ModeAfter clicking Connect All, you’ll need to independently authenticate and log into each Remote

●Clicking directly on a thumbnail.●Double clicking the mouse on a thumbnail (this will also immediately close the selection dialog).When the initial S

8 RGS propertiesRGS allows the user to specify many properties of the RGS connection, both on the Sender andReceiver. By specifying properties, the us

1 Introduction to HP Remote GraphicsSoftwareThis guide provides information that you will need to install, configure, and use HP Remote GraphicsSoftwa

The configuration files contain property name/value pairs, with only one property per line. Empty lines(containing only whitespace characters) are ign

8.5 RGS Receiver propertiesThis section describes the Receiver properties. RGS supports two types of Receiver properties:●Per-Receiver properties—The

8.5.1.5 Receiver default propertiesThe Receiver has a set of default properties that are built into the Receiver. These are identical to theproperty v

●Microphone property group◦Rgreceiver.Mic.IsEnabled●USB properties group◦Rgreceiver.Usb.IsMutable◦Rgreceiver.Usb.ActiveSession◦Rgreceiver.Usb.IsEnable

◦Rgreceiver.Log.MaxFileSize◦Rgreceiver.Log.NumBackupFiles●Image codec properties group◦Rgreceiver.ImageCodec.IsMutable◦Rgreceiver.ImageCodec.Quality◦R

property is true, the user is allowed to interactively change the associated property, that is, theRgreceiver.Network.Timeout.Error property.NOTE: For

Rgreceiver.IsBordersEnabled=bool （default=1）Rgreceiver.IsBordersEnabled.IsMutable=bool （default=1）If set to 1, the borders on the Remote Display Windo

Rgreceiver.IsMatchReceiverResolutionEnabled.IsMutable=bool （1）If this property is enabled, the Local Computer (Receiver) will attempt to set the resol

●Rgreceiver.Session.<N>.RemoteDisplayWindow.Y = 0●Rgreceiver.Session.<N>.VirtualDisplay.PreferredResolutionWidth = 1280●Rgreceiver.Session

The default value of the warning color is 0x80b40000, representing the following:●The alpha component is 0x80 (128 decimal. This is 50% transparent.●T

Chapter 7: Using Directory Mode on page 149—Establishing RGS connections using DirectoryMode is described in this chapter.Chapter 8: RGS properties on

Figure 8-5 Prior to RGS 5.1.3, only one image update would be in-process at any timeThe Rgreceiver.MaxImageUpdateRequests property was added to enabl

issuance of image update request #4. Also, TCP will temporarily block the Sender from sending furtherdata if the Receiver network buffer becomes full.

This property was added with RGS 5.4.0 and allows the user to disable the Remote Display WindowToolbar functionality. When the Rgreceiver.IsMenubarEna

Rgreceiver.Audio.IsInStereo=bool （1）Rgreceiver.Audio.IsInStereo.IsMutable=bool （1）If set to 1, stereo is enabled, and both the left and right channels

This property was added with RGS 5.4.0 and allows the user to disable a visual notification when thenetwork has timed out. When the Rgreceiver.Network

Rgreceiver.Hotkeys.IsSendFirstKeyInSequenceEnabled=bool （0）Rgreceiver.Hotkeys.IsSendFirstKeyInSequenceEnabled.IsMutable=bool （1）When enabled, the firs

This is a per-session property. If set to 1, Remote Clipboard is enabled for the session N RemoteDisplay Window. In order for Remote Clipboard operati

If set to 1, the logging settings in the Receiver Control Panel can be changed by the user. If set to 0, theuser will not be able to change any of the

Rgreceiver.ImageCodec.Quality=int （65）Rgreceiver.ImageCodec.Quality.IsMutable=bool （1）This property sets the image quality in the Remote Display Windo

Rgreceiver.Session.<N>.Username=stringThe username as a utf8 encoded string, to use if automatically connecting on start-up.Rgreceiver.Session.&

1.1 Typical RGS configurationFigure 1-1 Typical RGS configuration on page 3 shows a typical RGS configuration, consisting of ablade workstation and a

This property and the above property specify the preferred resolution of the Remote Display Window(in pixels). This resolution is communicated to the

8.6.1 Sender property groups RGS supports the following groups of Sender properties:●General properties group◦Rgsender.IsRdpLogoutDetectionEnabled◦Rgs

8.6.2 Sender general properties Rgsender.IsRdpLogoutDetectionEnabled=bool （1）This property only applies to the Windows versions of the RGS Sender.When

Rgsender.IsBlankScreenAndBlockInputEnabled=bool （1）If set to 1, this property enables monitor blanking on certain Remote Computers when a primary user

Introduced at RGS 5.2.0, this property allows the user to enable or disable display of the collaborationnotification dialog (see Collaboration notific

This property is used by the Sender remote USB code while monitoring the ACL file(hprDefaultUsbAcl.xml). If this file disappears or otherwise becomes

Rgsender.Network.Port=int (42966)This property controls the port used for communications with the RGS Sender. If this property is notspecified, the Se

9 Sender event logging on WindowsThe RGS Sender on Windows supports event logging. Event logging provides information useful fortroubleshooting connec

NOTE: The HPRemote log allows you to implement a capability called Remote ApplicationTermination. Remote Application Termination enables applications

Figure 9-3 Reporting of the Local Computer IP address, port number and hostname when aconnection is made to the SenderENWWThe HPRemote log183

© Copyright 2010 Hewlett-PackardDevelopment Company, L.P.The information contained herein is subjectto change without notice. The onlywarranties for H

1.2 RGS Sender and ReceiverFigure 1-2 RGS Sender and Receiver on page 4 shows the two primary RGS software components,the RGS Sender and RGS Receiver.

9.2 Usages of the HPRemote logThe HPRemote log has several important usages:●Troubleshooting—The HPRemote log can be used to aid troubleshooting of co

9.3 Additional information on event loggingFor additional information on Windows event logging, search Microsoft Developer Network (MSDN)as shown in F

10 Remote Application TerminationThis chapter describes how to create a Windows agent on the Sender that provides Remote ApplicationTermination. “Remo

Table 10-1 RGS Sender events logged in the HPRemote log (continued)RGSENDER_CONNECT_STATEEventID: 3The connection state consists of zero or more prim

Table 10-1 RGS Sender events logged in the HPRemote log (continued)RGSENDER_DISCONNECTEventID 5NOTE: Parameter %2 is new in the RGS 5.1.5 release.A r

Table 10-1 RGS Sender events logged in the HPRemote log (continued)RGSENDER_SET_PRIMARYEventID: 6A connection with an associated name is set as the p

Table 10-1 RGS Sender events logged in the HPRemote log (continued)RGSENDER_USB_CONNECT_DEVICEEventID: 9A new USB device was connected to the Sender

10.3 Agent design issuesDesigning an agent to provide Remote Application Termination requires consideration of a number ofissues in order to minimize

10.3.3 Wrapping applications of interest● Situation—Agents can be launched that supervise only specific applications in a givenenvironment. Tying agen

●Expect the unexpected—where possible, limit your actions to those areas you are certain of theoutcomes to minimize loss of data and productivity.●Alw

NOTE: Local user refers to the person physically located at the Local Computer. Remote user refers tothe person physically located at the Remote Compu

10.4 Sample AgentThe sample Windows agent presented below monitors the HPRemote event log and interprets its events.Comments are included in the agent

{HANDLE h;EVENTLOGRECORD *pevlr;BYTE bBuffer[BUFFER_SIZE];DWORD dwRead, dwNeeded;BOOL result;// Open, read, close event log ==========================

if (pevlr->EventID == RGSENDER_CONNECT_STATE){// Retrieve the two UINT32 fields of this message// representing primary and non-primary connections.

// Open, read status of log, close event log =========================if ((h = OpenEventLog(eventServer, eventSource)) == NULL){... report error statu

// If the new index is different than the current, update the current// and process the current event. Otherwise, we sleep for a while.if (dwNewIndex

10.5 Additional features for Windows systemsThe following optional procedures for the RGS Sender service can improve the reliability of your remoteage

◦Run a Program◦Restart the ComputerFigure 10-1 Remote Computer Sender recovery options10.5.2 Microsoft Remote Desktop RecoveryIf the RGS Sender becom

11 Optimizing RGS performanceThis chapter provides suggestions on optimizing RGS performance, including optimizing the RemoteComputer display settings

●Select the Desktop tab and select Customize Desktop.●On the Web tab, check Lock desktop items.2.Sender process priority—Occasionally, an activity suc

11.4 Configuring your network for optimalperformanceRGS depends on low network latency and reasonably high network bandwidth. There are severalmethods

●HP compression/decompression algorithms—Proprietary, high-performance HP imagecompression/decompression algorithms enable real-time remote visualizat

If you are not satisfied with your network performance, look at the log files on your network switch (ifthe Local Computer is connected to one). A sig

12 Troubleshooting RGSThis chapter provides suggestions on troubleshooting potential issues with RGS. Refer also to RGS errormessages on page 206 whic

13 RGS error messagesThis chapter lists the error messages reported by the RGS Receiver, and describes potential reasons forthe error messages.13.1 Re

Directory not found or not accessible! The directory file is not available. Possible reasons include:●The directory file name or location has been mis

Connection denied! The iLO remote console is enabled. The iLO remote console is enabled on the HP BladeWorkstation. The Blade must be configured in Us

A Appendix A: Using RGS with HPVDIThis appendix describes how to use RGS with the HP Virtual Desktop Infrastructure (VDI) solution. UsingRGS with HP V

ESX 3.0.2 RGS 5.2 and newer. Note that, unlike the other versions ofVMware ESX, this version of VMware ESX requires RGS 5.2or newer.ESX 3.0.2 Update1

A.2 Using RGS with static HP VDIStatic HP VDI is a one-for-one replacement of a desktop computer by a virtual machine directlyconnected to a user on a

display the machine's properties. To edit the configuration parameters, click the Options tab and selectthe Advanced line item.Figure A-1 Virtua

Figure A-2 Configuration parameters dialogNOTE: Not all configuration parameters can be added using the dialog shown above. Please seeVMware View doc

The tabloid page is included to permit a complex diagram (the diagram on the last page) to bedocumented on a single page while maintaining readability

This parameter tells the VMware virtual VGA device driver the maximum height of screen to support.This value may be set by GUI or by directly editing

A.3 Using RGS with dynamic HP VDI (based onVMware View)In this document, dynamic HP VDI is based on using the VMware View manager. The following steps

NOTE: Ensure that you remove the “#” from all lines you wish to activate in the rgsenderconfigfile.5.Save the rgsenderconfig file. Restart the RGS Sen

A.5 Disabling the RGS warning popupRGS alerts the user when the main console is still viewable. The hardware feature used for screenblanking is not av

B Appendix B: USB devices supportedby RGSNOTE: Prior to RGS 5.2.0, this list of USB devices was maintained in a separate document availableat http://w

Table B-1 PDA devices (continued)Blackberry 7230 RGS 3.0 RGS 5.0 Desktop Manager 3.6RGS 5.0RGS 5.0Desktop Manager 4.0Blackberry 7100g RGS 3.0 RGS 5.0

Table B-3 Trader keypads (continued)RBS Greenwich CapitalgSpeedRGS 4.2.0 RGS 5.0Brokertech model 1 RGS 4.2.0 RGS 5.0Table B-4 Security devicesUSB De

Table B-6 USB keys (continued)PNY 1G RGS 5.0 RGS 5.0Geek Squad 0.5 G RGS 5.0 RGS 5.0Cruzer Mini 4G RGS 5.0 RGS 5.0Lexar JumpDrive 256M RGS 5.0 RGS 5.

Table B-10 Floppy drivesUSB Device HP Blade WorkstationClientsClients based onWindows XP andWindows XPeNotesHP 3.5 inch RGS 5.0 RGS 5.0Table B-11 Pr

Table B-13 Human Interface Devices (continued)USB Devices HP Blade WorkstationClientsClients based onWindows XP andWindows XPeNotesHP Spaceball 5000

1.8 Other RGS DocumentsOther RGS documents such as the HP Remote Graphics Software Licensing Guide can be found at:http://www.hp.com/support/rgs_manua

Table B-16 HeadsetsUSB Devices HP Blade WorkstationClientsClients based onWindows XP andWindows XPeNotesPlantronics USB Audio 470HeadsetRGS 5.2 RGS 5

C Appendix C: Linux remote audiodevice supportAs shown in Figure 2-21 RGS audio subsystem on Linux on page 34, an audio device is required to beinstal

isanotheruser alreadylogged into theRemote Computer(the primaryuser)?Nhaslocal userlogged in?NYNYYhasanother userlogged in?NYdo thecredentials oflocal

IndexAAdvanced capabilities 102Auto Launch 104Auto Launch sessionproperties 172CCollaborating 98DDirectory Mode 21, 149EEasy Login 96error messages 20

2 RGS overviewBefore exploring how to use RGS, it’s important to first understand the required system environmentsand security features used and suppo

Table 2-1 Computers and operating systems that support RGS 5.4.0ReceiverSupport MatrixWindows XPe/WESWindows XPProfessionalSP1, SP2, SP332-bit, x64Wi

Table 2-2 Computers and operating systems that support RGS 5.4.0Sender Support Matrix Windows XPProfessional SP1, SP2,SP3 32-bit, x64Windows Vista Bu

2.2 RGS version numberingThe RGS version (for example, version 5.4.0) contains the following three numbers:1.Version major number2.Version minor numbe

connect to an RGS Sender. In licensing terminology, a floating license is checked-out when aconnection is established to the RGS Sender, and is checke

AcknowledgmentsHP Remote Graphics Software was developed using several third party productsincluding, but not limited to:OpenSSL: This product include

NOTE: Except for the 60-day HP RGS Desktop Trial Edition, the above RGS products neverexpire once they are installed and licensed.When you purchase RG

2.7 Networking supportRGS uses TCP/IP over a standard computer network, and supports Ethernet connection speeds of10/100/1000BASE-T (Gigabit). The RGS

The monitor itself is optional on the Remote Computer. For example, if the Remote Computer is aPersonal Workstation, a monitor (plus a keyboard and mo

Figure 2-5 Addition of scroll bars if the Remote Display Window is resized smallerNOTE: RGS does not provide a scale-to-fit capability to allow the c

The many-to-one connection capability allows implementation of a virtual KVM (keyboard, video, andmouse) switch. The virtual KVM switch emulates the f

Figure 2-8 Sharing between workstationsIn Figure 2-8 Sharing between workstations on page 19, the primary user is directly logged into theRemote Comp

If another user is already logged into the Remote Computer, the second authentication step is replacedby an authorization step, in which the currently

For example, a 3rd party fingerprint reader will typically install a custom GINA module. TheGINA module will allow the user to be authenticated throug

Computer, which, for this particular Remote Computer, requires two monitors to display the Windowsdesktop.Figure 2-11 Remote Computer frame buffer re

Figure 2-13 Each Remote Display Window can be positioned to occupy a single monitorAs always, each Remote Computer (Sender) frame buffer is displayed

iv Acknowledgments ENWW

this enables RGS to be used on standard networks. Image decompression is performed on the LocalComputer.RGS supports setting of the Image quality on a

In Figure 2-15 Remote Computer can access the local USB devices on page 24, two USB devices areconnected to the Local Computer. Using RGS, the local U

NOTE: The Remote USB configuration cannot be changed after installation of the Sender andReceiver—to select a different USB configuration option, the

NOTE: In addition to the general default settings for remote USB configurations, RGS 5.2.6 andhigher releases support auto-remote and auto-return of u

devices, as described above. With RGS 5.3.0, smartcard readers are now handled in a uniquemanner, as follows:●Unique smartcard handling requires, on t

●If a smartcard reader is plugged in after an RGS connection is established, it will be availableremotely.●If there is a break in the RGS connection,

Table 2-3 Receiver Remote USB SupportReceiver RemoteUSB SupportMatrixWindows XPe/WES Windows XPProfessional SP1,SP2, SP3 32-bit,x64Windows VistaBusin

Table 2-4 Sender Remote USB SupportSender Remote USB SupportMatrixWindows XP Professional SP1,SP2, SP3 32-bit, x64Windows Vista Business,Ultimate and

2.17.1 Remote audio on WindowsRGS on Windows supports remote audio, allowing audio generated by the application on the RemoteComputer to be captured a

Table 2-5 Windows RGS audio data pathsAudio Playback from the Remote Computer to theLocal ComputerSending of microphone audio from the LocalComputer

Table of contents1 Introduction to HP Remote Graphics Software ... 11.1 Typical RGS c

2.17.2 Remote audio on LinuxRGS on Linux also supports remote audio, allowing audio generated by the application on the RemoteComputer to be captured

Table 2-6 Linux RGS audio data pathsAudio Playback from the Remote Computer to theLocal ComputerSending of microphone audio from the LocalComputer to

To remotely attach USB microphones to the Remote Computer, either of these Remote USBConfiguration settings can be selected:●USB devices are Remote●US

Table 2-7 Computers and operating systems that support RGS audio (continued)Receiver AudioSupport MatrixWindows XPe/WESWindows XPProfessionalSP1, SP2

Table 2-8 Computers and operating systems that support RGS 5.4.0Sender Audio SupportMatrixWindows XPProfessional SP1, SP2,SP3 32-bit, x64Windows Vist

Figure 2-22 Remote Clipboard operationCut and paste are supported in the following scenarios.1. Between a Local Window and a Remote Display Window (i

Figure 2-23 Enabling Remote Clipboard during Sender and Receiver installation on MicrosoftWindows systems.For details on using Remote Clipboard, see

2.19 Interoperability of RGS and Microsoft RemoteDesktop ConnectionThis section discusses interoperability considerations for RGS and Microsoft Remote

Computer cannot utilize wake-on-LAN in an attempt to power-up in order to respond to a connectionrequest from the Local Computer—the Remote Computer m

21.Swedish22.Swiss French23.Swiss German24.Turkish Q25.United Kingdom26.United Kingdom Extended27.United States-International28.US2.23 RGS security fe

2.17.1 Remote audio on Windows ... 322.17.2 Remote audio on Linux ...

●Disconnect Everyone: All Receivers can be easily disconnected using the Sender GUI. This isuseful when hosting a collaboration session, such as in a

3 Installing RGSThis chapter describes the following aspects of installing RGS:●Installing the RGS Receiver on Windows●Installing the RGS Sender on Wi

3.During the installation, the Remote USB Configuration dialog is displayed (see Figure 3-1 ReceiverRemote USB configuration dialog on page 46 and Rem

4. If USB devices are Remote or USB devices are Local/Remote is chosen on WindowsVista or Windows 7, the following certificate installation dialog wil

5.The Remote Clipboard Configuration dialog is displayed next (seeFigure 3-3 Remote ClipboardConfiguration dialog on page 48 and Remote Clipboard over

3.1.1.2.1 UsageSetup.exe /autoinstall /agreetolicense [/folder=<folder>][/usb=local | /usb=remote | /usb=localRemote][/clipboard][/noreboot][/re

/usb=remote Install USB in Remote Mode. The system will automatically restart after the install completes./usb=localRemote Install USB in Local/

3.1.1.4 Uninstalling the RGS Receiver on WindowsTo uninstall the RGS Receiver, use the Windows Add or Remove Programs feature from the ControlPanel. S

●Enable Remote Clipboard—Check this box if your Local Users will need RemoteClipboard capability. For further information, see Remote Clipboard overvi

4.On Windows Vista and Windows 7, the following dialog for installing the RGS driver certificate ispresented. Installation of the certificate is requi

3.1.2.12.3 3. Manually enabling hprgina.dll to load a customGINA module ... 67

5.If you are installing the Sender on HP blade workstations or HP personal workstations runningWindows XP Professional, you will be presented with a d

6.Next, the Sender installer will prompt you for the Sender license. If you have a Sender license file,click the appropriate radio button, click Next,

dialog Figure 3-8 Output of the RGS Diagnostics Tool on page 56 shows the output generated by thetool.Figure 3-8 Output of the RGS Diagnostics ToolTh

stopped, started, or resumed. Additionally, the properties of the service can be controlled such as thestart-up type, and the recovery mode.Figure 3-9

-timeout value—The timeout in milliseconds used to detect and disconnect an inactive connection. Thisoption sets the property Rgsender.Network.Timeout

3.1.2.5 The Sender GUI on WindowsThe Sender displays the HP Remote Graphics Software icon in the application tray. The icon animateswhen Receivers are

CAUTION: Adjusting the process priority of the Sender to a level higher than –normal can causeother normally privileged processes to receive fewer CPU

The GINA Setup tab on the rgadmin tool can be used to enable Single Sign-on and Easy Login (seeFigure 3-12 Dialog to enable or disable Single Sign-on

on or Easy Login on page 62). If Single Sign-on is enabled, the computer must be restarted beforeSingle Sign-on is operational.Figure 3-13 The dialog

Figure 3-14 Using the rgadmin tool to enable Single Sign-on3.1.2.9.3 Manually enabling Single Sign-onAlthough the manual method is not the preferred

5.5 Collaborating ... 985.5.1 Creating

4.Set the value of the GinaDLL key to the text "hprgina.dll". Confirm the spelling before closing.Figure 3-15 Addition of the GinaDLL key to

CAUTION: If the value of the GinaDLL key contains the name of a custom GINA DLL, and the filedoes not exist in C:\WINDOWS\system32, the computer will

3.1.2.11.3 3. Manually enabling Easy LoginAlthough the manual method is not the preferred method to enable Easy Login, it is provided so thatadministr

GINA module rather than the default msgina.dll as described above. There are three ways to enablethe hprgina.dll module to load a custom GINA module:3

3.1.2.13 Disabling Easy LoginThere are two methods to disable Easy Login:3.1.2.13.1 1. Using the rgadmin tool to disable Easy LoginThe rgadmin tool sh

3.1.3.1 UsageSetup.exe /autoinstall /agreetolicense [/folder=<folder>][/usb][/remotemic][/clipboard][/sso | [/el [/gina=<filename>]]][/rgs

/usb Enable remote USB./remotemic Enable remote microphone./clipboard Enable remote clipboard./sso Enable Single Sign-on, only one of /sso

/noreboot Do not reboot the system when the setup requires a reboot to complete./removesettings Removes the user specific Sender settings from t

3.2 Installing RGS on LinuxThis section describes how to:●Install and uninstall the RGS Receiver on Linux●Audio requirements for the Linux Receiver●In

RGS Receiver installer is the version that is expected to be started by the script in /opt/hpremote/rgreceiver/hprgsaudio. A different version may req

6.8.2 Remote Clipboard filtering ... 1416.8.3 Using the RGS log to detect cl

5.If you choose not to use the customization described in step 5, or have a different configurationfile that needs to be updated, perform the followin

auth optional /lib/security/pam_custom.18.8. The RGS Sender will not accept remote connections when a DNS name inquiry does notresolve to a valid/acti

3.2.4.2 Uninstalling the Sender on LinuxTo uninstall the RGS Sender on Linux, perform the following steps:1.Log in as root.2.If the default install.sh

4 Pre-connection checklistEstablishing an RGS connection from a Receiver to a Sender requires that the Local and RemoteComputers be in the correct sta

4.2 Remote Computer (Sender) checklistModification and verification of the Sender state can be performed either by connecting a keyboard,mouse, and mo

restarting the Sender. This topic is expanded considerably in Network Interface binding on theSender on page 79 .8. Linux Sender machine name and IP a

There are four methods to deal with multiple network interfaces:1.Allow the Sender to listen on all network interfaces and dynamically add and remove

2.Double-click each LAN icon and the Support tab, which displays the network interface IP address(see Figure 4-2 Network Interface IP addresses on pag

Figure 4-4 Advanced Settings dialogThe arrows to the right of the Connections box in Figure 4-4 Advanced Settings dialogon page 82 can be used to cha

●Use the Nslookup command to determine the IP address that the hostname resolves to. Then,using the arrow buttons to the right of the Connections box