HP Remote Graphics Software (RGS) Manuale Utente

HP Remote Graphics Software 7.3User Guide

x

IndexAAdvanced Linux Sound Architecture (Linux only). See Remote AudioAdvanced Video Compression (Windows/Linux only) 28ALSA (Linux only). See Remote

overview 13Setup Mode 18starting an RGS session 15starting in Directory Mode 46toolbar (Mac OS) 17toolbar (Windows/Linux) 16window (Mac OS) 17window (

1 RGS overviewHP Remote Graphics Software (RGS) brings added security, performance, mobility, and collaboration to your workstation deployment. With R

FeaturesRGS includes a variety of features, including the ones described in the table below.NOTICE: Some features are not supported by certain operati

Interoperability between dierent versions of RGSInteroperability is supported between dierent versions of RGS Sender and RGS Receiver only if they h

RGS Sender licensingRGS Sender is included with HP Z workstations and HP ZBook mobile workstations. A separate license purchase is not required for RG

2 Getting startedThe following procedure is a high-level description of how to get started using RGS:1. Install RGS Sender and RGS Receiver.2. Open RG

3 InstallationInstalling RGS Receiver (Windows)The installer wizard for RGS Receiver provides both a Typical and Custom installation type. The Typical

NOTE: This setting controls whether Remote USB components are installed. To change this setting after installation, you must uninstall and reinstall R

Option Description/autoinstallInitiates the installation/agreetolicenseAccepts the license agreement/folder=\"<folder path>\"Species

NOTE: During the installation process, the installer creates a log le named rgsenderInstaller.log in the location specied by the Windows TEMP enviro

© Copyright 2016–2017 HP Development Company, L.P.Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries. Windows is eit

SenderSetup.exe /z"/autoinstall /agreetolicense /folder=\"C:\RGS Sender\""IMPORTANT: Command-line options intended for the MSI ins

Option DescriptionNOTE: The option /noreboot can be used in conjunction with this option.Installing RGS Receiver (Linux)To install RGS Receiver on Lin

sudo installer -pkg HP\ RGS\ Receiver.pkg -target /NOTE: To install RGS Receiver in a location other than the root of the boot volume, enter /Volumes/

4 RGS Receiver overviewOpening RGS ReceiverTo open RGS Receiver on Windows:▲Perform the action below that corresponds to the operating system of the r

RGS Receiver GUI (Windows/Linux)Item Description1 Enter the hostname or IP address of the sender in this eld.TIP: The drop-down list contains recent

Starting an RGS sessionTo start an RGS session:1. On the Home panel of RGS Receiver, enter the hostname or IP address of the sender, and then press th

RGS Receiver toolbar GUI (Windows/Linux)Non-touch GUI (Windows/Linux)Touch GUI (Windows only)NOTE: To disable touch features and force RGS Receiver to

RGS Receiver window GUI (Mac OS)Item Description1 The RGS Receiver toolbar provides easy access to the most frequently used options via the following

Setup Mode (non-touch GUI only)In Setup Mode, transmission of keyboard and mouse input to the sender is suspended. Instead, the keyboard and mouse can

RGS Receiver settingsThis section describes the settings available in RGS Receiver, which are divided into the following categories:●Connection●Perfor

User input syntax keyText that you must enter into a user interface is indicated by fixed-width font.Item DescriptionText without brackets or bracesIt

PerformanceThe performance settings allow you to improve the interactive experience. Typically, these adjustments will be made when working with highl

AudioThe following table describes the settings available in the Audio panel.Setting DescriptionStream audio from Sender Enables the sending of the au

Setting DescriptionNOTE: In addition to transmitting the rst key press to the sender, the key is also still processed by the receiver.Send CTRL-ALT-E

Item DescriptionImage compression Displays the compression ratio of the update stream.In a multi-connection environment, the value is from the RGS Rec

5 RGS Sender overviewRGS Sender overview (Windows)RGS Sender for Windows is comprised of three processes:●rgsendersvc.exe—Runs as a Windows service na

The following table describes the valid command-line options.Command Description-nocollabDisables collaboration-timeout <value>Species the time

RGS Sender event logging (Windows only)In addition to standard logging, RGS Sender logs events. This information is output to a log named HPRemote, wh

6 Using RGS featuresThis chapter discusses the following RGS features and topics:●RGS Advanced Features (Windows/Linux only)●Authentication●Collaborat

RGS Advanced Features (Windows/Linux only)This section discusses RGS Advanced Features:●Advanced Video Compression (Windows/Linux only)●HP Velocity (W

AuthenticationAuthentication methodsThere are three dierent authentication methods available for an RGS connection:●Standard authentication—supported

iv User input syntax key

Using smart card redirectionNOTE: Smart card redirection is supported on Windows-based receivers and Windows-based and Linux-based senders only.On Win

CollaborationRGS enables the primary user to share their desktop session with several users simultaneously. This feature can be used in a variety of c

Click the RGS Sender notication icon in the Windows notication area to open the HP RGS Collaborators window, which allows you to do the following:●V

NOTE: On Mac OS, if the OS setting Displays have separate Spaces is not selected, an RGS Receiver window can span multiple sender monitors. If the RGS

NVIDIA resolution-matching (Windows-based senders with NVIDIA graphics only)NVIDIA resolution-matching provides the following additional features over

9. Click Load. The EDID information will be applied.10. Click OK, and then click Cancel to exit the Manage EDID dialog box.Under the View System Topol

NOTE: Some window managers (such as GNOME) allow you to modify display preferences, which can sometimes result in the creation of the following le:$H

●It uses only a single X screen. The NVIDIA driver conceals all information about multiple display devices from the X server. As far as the X server i

Sender screen blankingRGS Sender, by default, blanks the screen of the sender monitor (if one is connected) so that the desktop session is not visible

Gesture Description1-nger tap Left-click1-nger double tap Double-click1-nger press and drag Left-click and drag2-nger tap Right-click2-nger press

Table of contents1 RGS overview ...

NOTE: A Wacom pen does not respect oor control in a collaboration session. Multiple users attempting to simultaneously provide any kind of input migh

NOTE: Sounds that play through an internal speaker, such as the ToggleKeys sound on Windows, are not captured by RGS.For information on the audio sett

standard naming convention for this control, hence the need to evaluate individual audio devices to determine their suitability for use on Linux.The a

Rgsender.Audio.Linux.DeviceName=plughw:1,0Remote ClipboardRemote Clipboard allows you to cut, copy, and paste data between the receiver and the sender

1. Find the vendor ID and device ID for the USB device (see Determining USB device information (Windows) on page 45).2. Open the Registry Editor and c

The ACL le is implemented in XML format and is accompanied by an XSD (XML Schema Denition) le that denes the XML elements. The default ACL le hpr

USB\VID_1234&PID_5678b. Select Compatible Ids from the drop-down menu. The class, subclass, and protocol are represented by numerical codes and ar

For a local account, using the example user1_computer\user1, the domain name used for Directory Mode would be user1_computer.The following example dir

open -a "HP RGS Receiver" --args -directoryIf a le name is specied after -directory, RGS Receiver uses that le as the directory le. If n

7 Conguration tools and propertiesOn Windows and Linux, RGS Receiver and RGS Sender each include a conguration tool that allows you to modify some o

Audio ...

Using the RGS Receiver Conguration toolTo use the RGS Receiver Conguration tool:1. Navigate to the RGS Receiver installation directory, and start th

Option DescriptionConguration le property (Windows/Linux/Mac OS):Rgreceiver.IsMouseSyncEnabledNumber of recent remote connections listed Sets the nu

Option DescriptionConguration le property (Windows/Linux only):Rgreceiver.ImageCodec.IsH264EnabledAdvanced Video Compression encoding Sets whether A

Option DescriptionRgreceiver.IsGlobalImageUpdateEnabledEnable Match Receiver display resolution by default Enables the Match Receiver display resoluti

Option DescriptionConguration le property (Windows/Linux/Mac OS):Rgreceiver.Network.Timeout.IsMutableEnable the warning dialog for when the RGS conn

Option DescriptionTarget loss rate (10k packet sample) Sets the amount of network loss that HP Velocity will tolerate before adding packet-protection

Option DescriptionConguration le property (Windows only):Rgreceiver.Hotkeys.IsCtrlAltDeletePassThroughEnabledEnable the Setup Mode hotkey sequence E

Option DescriptionConguration le property (Windows/Linux/Mac OS):Rgreceiver.Log.MaxFileSizeActivation (Windows/Linux only)The following table descri

./senderconfigapp.sh2. Congure options as desired.NOTE: See the tables in the following sections for descriptions of each of the options.3. Select Sa

Image and DisplayThe following table describes the options available in the Image and Display panel of the RGS Sender Conguration tool. The correspon

Input ...

Option DescriptionConguration le property (Windows/Linux):Rgsender.Network.Timeout.ErrorListen for RGS connections on all network interfaces When en

Option DescriptionOperational Mode Sets whether HP Velocity should correct network loss (Active Mode) or just monitor it (Monitor Mode).Conguration 

Option DescriptionIMPORTANT: This option should normally remain enabled. When disabled, neither remote users nor local users are notied who is partic

Setting RGS properties manuallyProperty syntaxThe following example shows the RGS property syntax:Rgreceiver.Network.Timeout.Warning=10000In this exam

Other propertiesThis section describes the RGS properties that do not have a corresponding option in the conguration tools and can only be set via th

Property DescriptionWhen enabled, RGS Sender tracks volume changes on the sender side, and RGS Receiver adjusts its volume level automatically in resp

Property DescriptionRgreceiver.Session.<n>.VirtualDisplay.IsPreferredResolutionEnabled1=Enables the preferred resolution properties for session

Property Descriptionencrypted using the Windows command CryptProtectData. See http://msdn.microsoft.com/en-us/library/aa380261(VS.85).aspx for more in

8 Performance optimizationGeneralThe following suggestions apply to all operating systems:●Enable HP Velocity (see HP Velocity (Windows/Linux only) on

3. Right-click the network adapter you want to congure, and then select Properties.4. Click the Advanced tab.5. In the list of properties, locate the

HP Velocity ...

9 TroubleshootingFailed connection attemptsThis section describes the most common issues that cause RGS connection attempts to fail.Receiver checklist

If the IP address associated with the RGS Sender listening port (42966 by default) is private, APIPA is the likely cause. For information about how to

Reconguring network interface binding manuallyTo manually congure which network interface the sender binds to:1. Disable the Listen for RGS connecti

The RGS Receiver window repeatedly dims and displays a connection warning message.Cause SolutionThere are frequent network disruptions between RGS Rec

Graphical issues (Linux)Full-screen crosshair cursorsSome software uses large crosshair cursors that might not display correctly on the receiver. Full

There is no audio on a sender or a receiver with multiple audio devices.Cause SolutionRGS is not using the correct audio device. Disable extra audio d

A Switching between RGS and Remote Desktop Connection (Windows only)You can switch between an RGS session and a Windows Remote Desktop Connection sess

B Creating an agent for remote application termination (Windows only)When an RGS session is unintentionally ended, you might want applications on the

Message ID DescriptionData:UINT32 numPrimaryUINT32 numNonprimaryEvent viewer example:Primary connections: 1. Non-primary connections: 0.RGSENDER_CONNE

Message ID DescriptionRGS Sender shutdown.Strings:NoneData:NoneRGSENDER_SET_PRIMARYEvent ID: 6A connection with an associated name is set as the prima

Appendix B Creating an agent for remote application termination (Windows only) ... 77Viewing the HPRemote

Message ID DescriptionUSB Device Connect:Class=%1, Vendor ID=%2, Product ID=%3, Manufacturer=%4, Product=%5Strings:%1 = USB device class%2 = USB devic

Desktop session logout●Situation—In some circumstances, loss of a primary user connection should trigger a full shutdown of all applications and force

approach can further be dened to exploit redundant network connection support to a remote system to allow user-directed shutdowns to occur.●Benet—Sy

●Take No Action●Restart the Service●Run a Program●Restart the ComputerSample agentThe following sample Windows agent monitors the HPRemote event log a

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

{// Retrieve the two UINT32 fields of this message// representing primary and non-primary connections.unsigned int *pData = (unsigned int *)((LPBYTE)

{... report error status here ...return;}// If an event is added, either the start or count will change.// Get the start and count. Microsoft does not

// We have at least one new event. Print out the last event.dwCurrentIndex = dwNewIndex;if (dwNewIndex){if (processEvent(eventServer, eventSource, dwC

C Uninstalling RGSUninstalling RGS Receiver or RGS Sender (Windows)▲Open the Programs and Features item in Control Panel, and uninstall the entry corr

rpm -q -a | grep -i rgsenderThe package names will be something similar to the following:●rgsender_linux_64-7.3.0-1●rgsender_config_64-7.3.0-1●rgsende