HP Remote Graphics Software 7.0User Guide
Directory file format ... 61Star
Table 9-8 Hotkey properties (continued)0=Only the local computer will process a Ctrl+Alt+Delete sequence. (default).Rgreceiver.Hotkeys.IsGameModeEnab
Table 9-10 Logging properties (continued)ERROR=Enables logging for output type ERROR and anything more serious (FATAL).FATAL=Enables logging for only
Table 9-13 Auto-launch properties (per-session) (continued)1=The RGS Receiver will attempt to auto-launch the connection for session number n using s
Clipboard properties (per-session)NOTE: For global clipboard properties, see Clipboard properties on page 88.Table 9-15 Clipboard properties (per-ses
Table 9-16 RGS Sender properties (continued)Comparitron=This method uses the system's CPU to compare one full screen to a previous full screen.
Table 9-16 RGS Sender properties (continued)3=HP Velocity operates in Active mode (default).1=HP Velocity operates in Monitor mode.0=HP Velocity is d
Table 9-16 RGS Sender properties (continued)Rgsender.IsClassicEasyLogonEnabled1=For Windows, this enables multiple users to connect to a locked deskt
A Supported hardware and softwareRGS support matrixTable A-1 RGS support matrix Windows 7Professional, EnterpriseWindows 8.1Pro, EnterpriseRHEL 5.9,
Advanced Video Compression requirementsTable A-2 Advanced Video Compression requirementsRemote computer (RGS Sender) Local computer (RGS Receiver)CPU
IMPORTANT: The Linux virtual audio driver is the only supported audio device for RHEL 6. Hardware audiodevices are not supported.NOTE: The Linux virtu
Network properties ... 86Hotkey properties ...
21. Swedish22. Swiss French23. Swiss German24. Turkish Q25. United Kingdom26. United Kingdom Extended27. United States—International28. U.S.Applicatio
B TroubleshootingThis appendix provides suggestions on troubleshooting potential issues with RGS and also lists the RGS errormessages and their possib
you to specify timeout values that, if exceeded, will cause the RGS Receiver to take specific actions, such asdisplaying a warning dialog or closing t
and the maximum of{ Rgsender.Network.Timeout.Error AND Rgsender.Network.Timeout.Dialog }For example, if the RGS Sender error timeout property is 30 se
●When connecting to the remote computer, the authorization dialog is not displayed long enough forthe user to respond to it—This is likely caused by t
●No audio on the RGS Receiver on Windows—Verify that your local computer audio device is working.The volume control slider on the RGS Receiver plays a
Remote Clipboard entries in the log files have the text below preceding the Remote Clipboard information. Inparticular, the string “(format filter)” i
To further verify your connections, recognized devices on the local computer appear in the Proc file systemunder the /proc/devices/usb_remote director
Table B-2 RGS Receiver error messages (continued)●The RGS Sender service/daemon may have been stopped,restarted, or killed.●The RGS Sender system may
Table B-2 RGS Receiver error messages (continued)Setup Mode hotkey sequence too short. The key sequence specified by the user is too short.Setup Mode
Appendix C HP support ...
CHP supportObtaining HP supportIf you encounter an issue that requires support, please do the following prior to contacting HP for assistance:●Be in f
IndexAadvanced performance features,activation 13Advanced Video Compressionactivation 13description 45enabling 34requirements 96application support 98
propertiesRGS Receiver 82RGS Sender 91setting in a configuration file 81setting on the command line 81syntax 81RRemote application terminationoverview
1 Getting started in WindowsThe chapter provides a quick guide for Windows users to install and use HP Remote Graphics Software (RGS)in common scenari
2RGS overviewThis chapter discusses the following topics:●Typical RGS deployment●User interface overview●RGS features●RGS Sender and RGS Receiver inte
Typical RGS deploymentRGS is the collaboration and remote desktop solution for serious workstation users and their mostdemanding applications. All app
User interface overviewRGS Receiver Control Panel1 In this field, enter the hostname or IP address of the remote computer running the RGS Sender. You
Remote Display WindowNOTE: The Remote Display Window might look slightly different on touch displays.1 The Remote Display Window toolbar provides easy
Remote Display Window toolbarNon-touch displaysTouch displays1 Sets the image quality and the amount of compression. Higher image quality reduces the
RGS featuresThe following tables describe many of the RGS features that are designed to optimize functionality,performance, and security.Table 2-1 RG
© Copyright 2014 Hewlett-PackardDevelopment Company, L.P.Microsoft, Windows, and Windows Vista aretrademarks of the Microsoft group ofcompanies.Confid
Table 2-2 RGS performance features (continued)Feature DescriptionSee Advanced performance features on page 45 for more information.Selective screen u
RGS Sender and RGS Receiver interoperabilityRGS provides interoperability between an RGS Sender and RGS Receiver that have the same primary versionnum
Multi-monitor configurationsNOTE: Advanced Video Compression is not supported on multi-monitor configurations.Many computers have a frame buffer that
In normal operation, users are required to authenticate twice when establishing an RGS connection from alocal computer to a remote computer. The two s
3 Installing and activating RGSThis chapter describes the following aspects of installing RGS:●Installing RGS on Windows●Installing RGS on LinuxInstal
NOTE: The "auto" option described in Auto-remoting on page 55 alters the behavior you selectduring installation. It will re-enumerate any de
ReceiverSetup.exe /z"/autoinstall /agreetolicense"If you need to include a double quote as part of a parameter (such as for a folder path),
Table 3-1 RGS Receiver installation command line options (continued)Command DescriptionExample: /proxy=123.456.78.90:4321/wanimprovementInstalls HP V
Manual installation of the RGS Sender on WindowsTo install the RGS Sender on Windows:IMPORTANT: Be sure you are logged in to an account with administr
If you need to include a double quote as part of a parameter (such as for a folder path), then you shouldprecede each of those double quotes with a ba
AcknowledgmentsHP Remote Graphics Software was developed using several third party products including, but notlimited to:OpenSSL: This product include
Table 3-2 RGS Sender installation command line options (continued)Command Description/rgslicensefile=\"<ファイル名>\"Example: /rgslicensef
Installing the RGS Receiver on LinuxNOTE: The Linux RGS Receiver is available in both 32-bit and 64-bit versions. The Xlib version 1.1.5 is notsupport
Installing the RGS Sender on LinuxNOTE: The Linux version of the RGS Sender can only be installed on the computers and Linux operatingsystems shown in
If you choose not to use the automatic customization, perform the following steps:1. Add the "rge" extension to the X Server configuration f
Uninstalling the RGS Sender on LinuxTo uninstall the RGS Sender on Linux:1. Log in as root.2. If the default install.sh was used, then the following c
4 Pre-connection checklistEstablishing an RGS connection from an RGS Receiver to an RGS Sender requires that the local and remotecomputers be in the c
1. If using Advanced Video Compression, make sure that the remote computer system meets therequirements described in Advanced Video Compression requir
For Linux systems with multiple network interfaces, each IP address must be listed in the /etc/hostsfile, for example:192.168.89.122 blade2 blade2.dat
Reconfiguring network interface binding manuallyTo manually configure which network interface the remote computer binds to:1. Set the property Rgsende
The RGS Sender listens on port 42966 by default, but the port number can be changed using theRgsender.Network.Port property as described in RGS proper
iv Acknowledgments
5 Using the RGS ReceiverThis chapter discusses the following topics:●Starting the RGS Receiver●Creating an RGS connection●Using touch features (Window
Creating an RGS connectionNOTE: Before attempting to connect to a particular remote computer for the first time, HP recommendsthat you verify that the
Using touch features (Windows 8 only)RGS supports the following touch features:●Gestures—See Table 5-2 RGS touch gestures on page 30 for more informat
Setup Mode (non-touch displays only)If the Remote Display Window is configured to cover the entire local monitor and also has its title bar andborders
6 RGS Receiver Control Panel settingsThis chapter discusses the advanced settings available in the RGS Receiver Control Panel:●Connection settings●Per
Connection settingsThe following table describes the settings available in the Connection tab.Table 6-1 Connection settingsSetting DescriptionPrompt
Performance settingsThe performance settings allow you to improve the interactive experience. Typically, these adjustments willbe made when working wi
Gesture settings (Windows 8 only)NOTE: The Gestures tab is only available if the local computer is running Windows and has a touch display.You can use
Network settingsThe following table describes the settings available in the Network tab.Table 6-4 Network settingsSetting DescriptionError Sets the t
Table 6-5 Hotkey settings (continued)Setting DescriptionKey Repeat Enables the processing of key repeats for when the Shift key is held down.By defau
About this guideThis guide uses the following styles to distinguish elements of text:Style Definition<variable>Variables or placeholders are enc
Table 6-6 Logging settingsSetting DescriptionEnable message logging Enables logging.Log file path Specifies the path of the log file.Log level Determ
7 Using the RGS SenderThis chapter discusses the following topics:●Starting and stopping the RGS Sender on Windows●Starting the RGS Sender on Linux●RG
Table 7-1 RGS Receiver command line options (Windows) (continued)NOTE: This option sets the value of the propertyRgsender.Network.Timeout.Error and o
The options are described in the following table.Table 7-2 RGS Receiver command line options (Linux)-v | -ver | -versionDisplays the RGS Sender versi
C:\Program Files\Hewlett-Packard\Remote Graphics Sender\rgdiag.exeTIP: For 64-bit systems, use Program Files (x86).Using the RGS Admin Tool (Windows o
8 Advanced RGS featuresThis chapter discusses the following topics:●Collaboration●Optimizing RGS performance●Display resolution and layout matching●Re
CollaborationRGS enables the primary user to share their desktop session with several users simultaneously. This featurecan be used in a variety of co
The primary user can disable collaborator input using the RGS Sender GUI. Authorized local users will still beable to view the primary user’s desktop
NOTE: These features will be activated during the first RGS connection, and this activation will requireInternet access. Please make sure your proxy s
1. Open Device Manager in the Windows Control Panel.2. Expand Network adapters.3. Right-click the network adapter you want to configure, and then sele
vi About this guide
●Blade workstation—If the sending computer is a blade workstation, then its NVIDIA driver exposes alldisplay outputs the operating system as if they h
1. Open the NVIDIA Control Panel and click Change Resolution.2. Click Customize.NOTE: The first time you do this you might see a warning—accept it.3.
Scenario 1: All receiving computers have the same configurationIf all receiving computers have the same configuration, then using the Virtual entry un
Option "MetaModes" "DFP-0: 1920x1200 +0+0, DFP-1: 1920x1200 +1920+0; DFP-0: 1920x1200 +0+0, DFP-1:NULL"SubSection "Display&qu
Table 8-1 Windows RGS audio data paths (continued)1. An application on the remote computer generates audiooutput.2. If an audio device is installed,
cat /proc/asound/devicesFrom this, you will see a list of the audio devices and it will look something like this:0: [ 0] : control1: : sequencer8: [ 0
Unsupported PCI audio devices are known to allow capture of application generated audio. The names of thecontrols that need to be adjusted are not con
Local/Remote USB overviewThis section describes Remote USB behavior if you have selected the USB devices are Local/Remote optiondescribed in Manual in
4. In the key created in Step 3, create a string value (REG_SZ) named Mode:HKLM\System\CurrentControlSet\Services\hprpusbh\Parameters\Device\Vid_1234&
Unique smart card handlingSmart card readers are handled in a unique manner, as follows:●Both the sending and receiving computers should be running Wi
Table of contents1 Getting started in Windows ...
Remote USB Access Control ListRGS supports a per-remote computer Access Control List (ACL) file that specifies which USB devices areallowed to be remo
Rules may contain filters based on the 11 parameters listed previously. These parameters are repeatedbelow along with the name of the filter element.1
●Go to the Control Panel and select System.●Select the Hardware tab.●Select Device Manager.2. Double-click the Universal Serial Bus Controllers3. Doub
Using RGS in Directory Mode (non-touch displays only)Directory Mode enables the local user to automatically open connections to multiple remote comput
●Local user sally is assigned remote computers RC_1, RC_2, and RC_3●Local user joe is assigned remote computers RC_4 RC_5, and RC_6If the domain name,
Figure 8-1 Remote Display Window selection dialogTo display the selection dialog, press the Tab key while in Setup Mode—again, Setup Mode must have b
RGS may not be suitable for full screen games. The techniques used by games to quickly draw to the screenwill often prevent RGS from being able to ext
Additional information on event loggingFor additional information on Windows event logging, search Microsoft Developer Network (MSDN) athttp://msdn.mi
Table 8-3 RGS Sender events logged in the HPRemote log (continued)Message ID DescriptionRGSENDER_CONNECTEventID: 4A new connection was established wi
Table 8-3 RGS Sender events logged in the HPRemote log (continued)Message ID DescriptionStrings:NoneData:NoneRGSENDER_SET_PRIMARYEventID: 6A connecti
Installing RGS on Linux ...
Table 8-3 RGS Sender events logged in the HPRemote log (continued)Message ID DescriptionRGSENDER_USB_CONNECT_DEVICEEventID: 9A new USB device was con
Agent design issuesDesigning an agent to provide Remote Application Termination requires consideration of a number of issuesin order to minimize data
Administrator alerts●Situation—Instead of shutting down an environment, an agent can be designed to alert anadministrator or operator to determine the
In designing the agent, you should consider whether or not to check for the existence of a running RGSSender service as an indication of a sufficient
C:\Program Files\Hewlett-Packard\Remote Graphics Sender\include\RGSenderEvents.h#include <windows.h>#include <stdio.h>#include "RGSen
if (CloseEventLog(h) == false){... report error status ...return true;}// Process event (example: print out event) ==============================if (r
DWORD dwCurrentCount;DWORD dwNewIndex;int waitedFor;// This function will monitor the log for the specified number of// seconds. If seconds is less th
dwNewIndex = 0;}else{dwNewIndex = dwCurrentStart + dwCurrentCount - 1;}// If the new index is different than the current, update the current// and pro
... may wish to return status from monitorEvents ...}Interoperability of RGS and Microsoft Remote DesktopConnectionThis section discusses interoperabi
authenticated, the connection is closed. On Windows, authentication uses NTLM or Kerberos. On Linux,authentication uses the Pluggable Authentication M
Setting the RGS Sender process priority (Windows only) ... 41Using the
●The HP personal workstations also block input from a directly connected keyboard and mouse whenmonitor blanking is occurring. When keyboard or mouse
installation. Reconfiguring the X Server to serve 24-bit (or 32-bit) default visuals, and restarting the X Serverwill usually fix the black or blank c
9 RGS propertiesRGS properties provide you with another way to customize RGS settings. Some properties correspond tosettings that are also available i
Property syntaxThe following example shows the RGS property syntax:Rgreceiver.Network.Timeout.Warning=10000In this example, the name of the property i
Windows: rgreceiver.exe -Rgreceiver.Network.Timeout.Warning=10000Linux: rgreceiver.sh -Rgreceiver.Network.Timeout.Warning=10000NOTE: Properties of the
Table 9-1 Remote Display Window properties (continued)0=The image quality slider is disabled and cannot be adjusted by a user.Rgreceiver.ImageCodec.Q
Table 9-1 Remote Display Window properties (continued)1=The RGS Receiver will display a warning that disconnecting an RGS connection will not automat
Browser propertiesTable 9-3 Browser propertiesRgreceiver.Browser.IsMutableNOTE: This property only applies to Linux.1=A user can use the RGS Receiver
USB propertiesTable 9-6 USB propertiesRgreceiver.Usb.IsMutable1=A user can modify the Remote USB settings in the RGS Receiver Control Panel (default)
Table 9-7 Network properties (continued)0=HP Velocity is disabled.NOTE: See HP Velocity documentation for more information.Rgreceiver.Network.HPVeloc
Comentários a estes Manuais