Download  Print this page

HP Xw460c - ProLiant - Blade Workstation User Manual

Remote graphics software 4.2.0 user guide.
Hide thumbs

Advertisement

HP Remote Graphics 4.2.0
User's Guide

Advertisement

Table of Contents

   Related Manuals for HP Xw460c - ProLiant - Blade Workstation

   Summary of Contents for HP Xw460c - ProLiant - Blade Workstation

  • Page 1 HP Remote Graphics 4.2.0 User's Guide...
  • Page 3: Copyrights And Trademarks

    All other product names mentioned herein may be trademarks of their respective companies. Hewlett-Packard Company shall not be liable for technical or editorial errors or omissions contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material. The information in this document is provided “as is”...
  • Page 4 This document contains proprietary information that is protected by copyright. No part of this document may be photocopied, reproduced, or translated to another language without the prior written consent of Hewlett-Packard Company.
  • Page 5 Acknowledgments HP Remote Graphics Software was developed using several third party products including, but not limited to: OpenSSL: This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/). This product includes software written by Tim Hudson (tjh@cryptsoft.com). This product includes cryptographic software written by Eric Young (eay@cryptsoft.com) log4cplus: This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
  • Page 7: Table Of Contents

    Table Of Contents Welcome to HP Remote Graphics Software............1 About Remote Graphics Software............... 3 What is Remote Graphics Software? ..............3 Features ...................... 4 Security Features ..................7 System Requirements..................9 Getting Started with Remote Graphics Software..........13 Installing the Receiver ................. 13 Installing the Sender ...................
  • Page 8 HP Remote Graphics 4.2.0 User's Guide Optimizing Performance................114 Utilities ....................116 Troubleshooting................... 119 Troubleshooting Usage and Performance............119 Known Issues and Limitations..............129 Error Messages ..................138 License and Support..................143 End-user License Agreement ..............143 Contacting HP................... 147 viii...
  • Page 9: Welcome To Hp Remote Graphics Software

    Welcome to HP Remote Graphics Software Welcome to HP Remote Graphics Software (RGS). This document provides a complete overview of the RGS product including the RGS Receiver, RGS Sender, and RGS Enterprise Service.
  • Page 11: About Remote Graphics Software

    About Remote Graphics Software What is Remote Graphics Software? Remote Graphics Software (RGS) is software that allows a user to access the desktop of a remote computer over a standard computer network. The software is conceptually similar to other remote access solutions such as Microsoft Remote Desktop, Symantec pcAnywhere™...
  • Page 12: Features

    HP Remote Graphics 4.2.0 User's Guide Features HP Remote Graphics Software includes the following features: Application transparency: No modification to applications is necessary to access them remotely. Audio follows focus: The RGS Receiver can be configured to enable audio for the session displayed in the Remote Display Window that currently has focus and is muted for all other remote sessions/windows.
  • Page 13 About Remote Graphics Software Image-based remote visualization technology: Proprietary HP image compression/decompression algorithms enable real-time remote visualization that is visually lossless and fast. Interactive remote visualization of 2D and 3D OpenGL graphics are possible using hardware acceleration. DirectX applications are not supported. Logging: The RGS Sender for Windows logs to the Windows Event Log connection status changes such as when a new connection is established,...
  • Page 14 HP Remote Graphics 4.2.0 User's Guide Remote USB: The HP Blade Workstation with RGS Sender supports multiple USB devices connected from an HP Workstation Blade Client. See System Requirements for more details on the supported systems. Screen lock: When the primary user disconnects the desktop of the remote system is locked.
  • Page 15: Security Features

    About Remote Graphics Software Security Features HP Remote Graphics Software has the following features to maintain security: Authentication: When a Receiver attempts to connect to a Sender, user credentials are validated using the native authentication method on the sender system. If the credentials are not authenticated, the connection is closed.
  • Page 16 HP Remote Graphics 4.2.0 User's Guide located in the system tray. On Unix systems, the GUI is an application on the desktop. Simply right-click on the GUI and select "Disconnect All Receivers". Enable/Disable I/O: The Sender GUI can enable or disable mouse and keyboard input for all non-primary users.
  • Page 17: System Requirements

    About Remote Graphics Software System Requirements Sender Feature Supported Components Supported Platforms Microsoft Windows 2000 or XP Professional 32-bit (Intel x86 and x86-64 processor families. AMD x86 and AMD64 processor families.) Microsoft Windows XP Professional x64 Edition (Intel x86-64 processor families. AMD64 processor families.) Red Hat Enterprise Linux WS3 32-bit &...
  • Page 18 HP Remote Graphics 4.2.0 User's Guide Remote USB Remote USB is only supported on an HP Blade Workstation Client when connected to an HP Blade Workstation sender system. 1. Any number of USB devices can be simultaneously connected. 2. HP Remote Graphics Software requires matched versions of the RGS Sender and RGS Receiver systems.
  • Page 19 About Remote Graphics Software Workstations only.) HP-UX 11.0 and 11i V1 HP PA-RISC 2.0 architecture (PA-8500 or later) Supported Graphics Any system graphics Display Settings Supports the following Windows XP Color Quality settings: 16 bit 24 bit 32 bit All Linux or HP-UX Color Quality settings are supported at 1024x768 resolution or higher Remote Audio Microsoft Windows XP Professional 32-bit and 64-...
  • Page 20 HP Remote Graphics 4.2.0 User's Guide Networking Standard TCP/IP. 10/100/1000BASE-T (Gigabit) Ethernet. Full-duplex recommended. Keyboard Locales The following keyboard localizations are supported: U.S. English U.K. English Japanese German French The following keyboard localizations are supported on the HP Blade Workstation Client: U.S.
  • Page 21: Getting Started With Remote Graphics Software

    Getting Started with Remote Graphics Software Installing the Receiver Installation of the HP Remote Graphics Software Receiver is required on all systems that will be connecting to a HP Remote Graphics Software Sender. Installing the RGS Receiver for Windows To begin the installation of the RGS Receiver for Windows login to an account with administrator privileges: 1.
  • Page 22 HP Remote Graphics 4.2.0 User's Guide appropriate senders. This software (based upon ALSA sound libraries and JACK-Audio-Connection-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 (release 4 or greater) already exist on the platform.
  • Page 23 Getting Started with Remote Graphics Software Uninstalling the RGS Receiver Uninstalling the RGS Receiver for Windows: To uninstall the RGS Receiver for Windows use the Windows 2000 or Windows XP Add or Remove Programs feature from the Control Panel. Select Remote Graphics Receiver and click Change/Remove.
  • Page 24: Installing The Sender

    HP Remote Graphics 4.2.0 User's Guide Installing the Sender Installation of the RGS Sender for Windows, Linux and HP-UX is easily done by following the directions specific to each platform in the following sections. Installing the RGS Sender for Windows To install the RGS Sender for Windows, login to an account with administrator privileges: 1.
  • Page 25 Getting Started with Remote Graphics Software First-time installs of the RGS Sender on Blade Workstations require installation via the iLO Remote Console. This requires use of the administrative console in Setup Mode (from the boot BIOS) to complete the RGS Sender installation. After the install completes, return the iLO Remote Console Mode to User Mode.
  • Page 26 HP Remote Graphics 4.2.0 User's Guide EndSection 8. The Sender will be installed to /opt/hpremote/rgsender and will be started automatically when the X Server or system is restarted, provided the appropriate XF86Config/xorg.conf file was correctly modified. 9. The Linux Sender uses the Pluggable Authentication Module ( PAM) for authentication.
  • Page 27 Getting Started with Remote Graphics Software 2. On the menu bar select "Go/Autostart". 3. A new Konqueror window will open. Right click and select "Create New" and choose "Link to Application". 4. A dialog box will open. On the General Tab page, give it a name such as "rgsender".
  • Page 28 HP Remote Graphics 4.2.0 User's Guide 6. On the "Other" tab in this window select the "Skip tasklist" button. 7. On the "State" tab in this window select the "Cycle skip" button and the "Window list skip" button. 8. Click on OK 9.
  • Page 29 Getting Started with Remote Graphics Software HP Remote Graphics Software is not supported the HP-UX 10.20 or HP-UX 11i V2 operating system, and is only supported on PA-RISC 2.0 architecture. HP-UX Sender GUI Installation The Sender GUI will automatically start on HP-UX when the Sender process starts. If you would rather start the GUI on a per-user basis, then edit the /opt/hpremote/rgsender/rgsender.sh file, and add the -noautostartgui option as follows:...
  • Page 30: Creating Unattended Installers

    HP Remote Graphics 4.2.0 User's Guide Creating Unattended Installers Unattended installers can be created for the RGS Receiver and Sender for Windows. Unattended installers are useful when an enterprise needs to install RGS without user interaction. Creating an Unattended Receiver Installer for Windows The RGS Receiver installer is created using InstallShield and normally requires user interaction when run.
  • Page 31: Installing & Enabling Remote Audio

    Getting Started with Remote Graphics Software Installing & Enabling Remote Audio Remote Graphics Software supports remote audio. Refer to the System Requirements section for the list of supported RGS Sender and Receiver operating systems. The Receiver Control Panel enables remote audio. When remote audio is enabled the Sender records and transmits audio to the Receiver for playback.
  • Page 32 HP Remote Graphics 4.2.0 User's Guide Press the Volume button in the Sound recording section in the middle of this window. This brings up the Recording Control window. Many audio device drivers do not show all available inputs by default. The mixer line is often one of the control lines that are not visible by default.
  • Page 33 Getting Started with Remote Graphics Software This brings up another window showing all available controls. The control associated with the mixer is often called “Wave Out Mix”, “Stereo Mix”, or some variation on “Mixer”. The Creative Audigy driver calls this the “What U Hear” control. Make sure this control is enabled similar to the following.
  • Page 34 HP Remote Graphics 4.2.0 User's Guide After you have selected the mixer, the Sender should record audio information and send it to the Receiver. Refer to the Windows RGS Sender Audio Calibration section to improve the audio quality. If you are not getting an audio signal, refer to the Windows Audio Troubleshooting section.
  • Page 35 Getting Started with Remote Graphics Software The next volume control to adjust is the mixer line of the Recording Control. 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 Out Mix.
  • Page 36 HP Remote Graphics 4.2.0 User's Guide Select the Critical Battery Alarm program event and press the play button (the triangle located next to the Browse button). The wav file associated with this event is recorded at near maximum intensity. If you can play this sound without distortion, you should play mosts sounds without distortion.
  • Page 37 Getting Started with Remote Graphics Software Properly configured kernel headers for the running kernel must be available from the directory /lib/modules/<version>/build for proper installation. The example installation script provided only builds/installs for the currently active kernel. The installation and configuration scripts require administrator privileges on the target system.
  • Page 38 HP Remote Graphics 4.2.0 User's Guide 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 the file manually if desired: tar xzf hp_rgs_4_audiosupport.tar.gz As the user root, change directory into the one created by the command above.
  • Page 39 Getting Started with Remote Graphics Software The sample installation script, rgs_audio_support, supports limited customization capabilities for newer source deliveries as they become available. See the script internals for more details.
  • Page 40: Installing And Enabling Single Sign-on

    HP Remote Graphics 4.2.0 User's Guide Installing and Enabling Single Sign-on Installing and Enabling Single Sign-on on Windows Installing RGS Single Sign-on is for experienced users and IT administrators only. Please read all the directions completely before proceeding and exercise caution when installing.
  • Page 41 Create the key as type RGS_SZ (a string type). The full path of the key is HKEY_LOCAL_MACHINE\Software\Hewlett-Packard\Remote Graphics Sender\GinaDllMode 6. Set the value of the GinaDllMode key to the text "HprSso". Confirm the spelling before closing.
  • Page 42 HP Remote Graphics 4.2.0 User's Guide To disable Single Sign-on without the use of the rgadmin tool, delete or rename the value of the GinaDLL registry key. If there is no other custom GINA module on the system, simply removing the GinaDLL key definition from the registry disables Single Sign-on.
  • Page 43: Installing And Enabling Easy Login

    Getting Started with Remote Graphics Software Installing and Enabling Easy Login Installing and Enabling Easy Login on Windows Easy Login is only supported on HP Blade Workstations running the RGS Sender. Installing Easy Login is for experienced users and IT administrators. Please read all the directions completely before proceeding and exercise caution when installing.
  • Page 44 5. Add the GinaDllMode registry key if does not already exist. This can be done through the use of regedit as well. Create the key as type RGS_SZ (a string type). The full path of the key is HKEY_LOCAL_MACHINE\Software\Hewlett-Packard\Remote Graphics Sender\GinaDllMode 6. Set the value of the GinaDllMode key to the text "HprEasyLogin". Confirm the spelling before closing.
  • Page 45 Getting Started with Remote Graphics Software match the string originally discovered in the registry key GinaDLL. Confirm the spelling before closing. 3. Restart the system. When the RGS hprgina.dll is loaded by WinLogon, hprgina loads the chained GINA DLL foogina.dll. The hprgina module then chains all GINA requests to the foogina module.
  • Page 46 HP Remote Graphics 4.2.0 User's Guide GinaDLL key in regedit and then select the Modify entry in the Edit menu. A dialog box appears allowing the value of the key to be changed. Type the name of the custom GINA module in the "Value data:" area. Confirm that the custom GINA module entered actually exists on the system in C:\WINDOWS\system32.
  • Page 47: Installing The Enterprise Service Sdk

    For convenience, the Python installation package python- 2.4.msi is included in the Enterprise Service installation directory (C:\Program Files\Hewlett-Packard\Remote Graphics Enterprise Service). Enabling the Enterprise Service in the Receiver All of the functionality necessary to communicate with the Enterprise Service is in the RGS Receiver.
  • Page 48: Enabling Opengl Applications

    "foo3d.exe". If the executable "foo3d.exe" is installed in the directory "C:\Program Files\foo3d", you will need to manually copy the HP Remote Graphics Software OpenGL32.dll from "C:\Program Files\Hewlett-Packard\Remote Graphics Sender\OpenGL\32-bit" to "C:\Program Files\foo3d". This must be done before the application "foo3d.exe" is started.
  • Page 49 Getting Started with Remote Graphics Software 1. nVidia method: nVidia graphics drivers have extensions that enable remote viewing of OpenGL applications using a Remote Graphics Software. This method requires no user configuration other than making sure the proper nVidia drivers (version 1.0-5336 and beyond) are properly installed on the system.
  • Page 50: Enabling Direct3d Applications On Windows

    HP Remote Graphics 4.2.0 User's Guide Enabling Direct3D Applications on Windows HP Remote Graphics Software will automatically receive updates from Direct3D 8.0 and Direct3D 9.0 applications. Automatic updates are enabled by default during RGS Sender installation. On a Windows’s 64-bit OS (XP Professional x64 Edition), automatic updates are enabled for 32-bit and 64-bit applications.
  • Page 51: Using Remote Graphics Software

    Using Remote Graphics Software Using the Receiver Overview of the Remote Graphics Receiver Receiver Terminology The Receiver is composed of three main components: 1. Control Panel: The main Receiver window that is used to connect and control many Receiver settings. 2.
  • Page 52 Enterprise Service is started, the location of the Enterprise Service is entered on the command-line when starting the Receiver. On Windows, to start the HP Remote Graphics Software Receiver in Enterprise Service Mode: cd "C:\Program Files\Hewlett-Packard\Remote Graphics Receiver" rgreceiver.exe -esdir service1 [service2 ... serviceN] On Linux or HP-UX, execute: /opt/hpremote/rgreceiver/rgreceiver.sh -esdir service1...
  • Page 53 Using Remote Graphics Software Opening and Closing Connections To connect to a Sender using the Receiver: 1. Enter the hostname or IP address of the Sender. 2. Press Enter or select the Connect button to connect. The RGS Receiver Control Panel is used to perform the following tasks: Open a connection: To open a connection to a system, enter the hostname or IP address of the system running the RGS Sender in the Hostname field.
  • Page 54 HP Remote Graphics 4.2.0 User's Guide The RGS Receiver Control Panel contains a status bar at the bottom of the window. The status bar provides information that describes the current state of the RGS receiver. For example, it displays messages that indicate “connection in progress”, “connection succeeded”, and “connection failed.”...
  • Page 55 Using Remote Graphics Software Controlling Receiver Settings Receiver settings are controlled as follows: Via a tabbed set of options accessible by pressing the Advanced button on the Receiver Control Panel. The following groups of options are available: General Options, Audio Options, USB Options, Network Options, Hotkey Options, Logging Options, Statistics Options.
  • Page 56 HP Remote Graphics 4.2.0 User's Guide the Sender. When selected, the Receiver can prompt and send an alternate user domain and password to the Sender. This is advantageous on Sender/Receiver pairs running Windows and Enterprise Service Mode with different connection needs for each session.
  • Page 57 Using Remote Graphics Software The Audio follows focus checkbox modifies the handling of the audio streams when connected to multiple remote systems. Checking the box enables only the audio stream corresponding to the Remote Display Window that currently has the keyboard focus.
  • Page 58 HP Remote Graphics 4.2.0 User's Guide High specifies a sampling rate of 44 KHz which equivalent to CD quality audio. Higher quality settings (sampling rates) require more network bandwidth and can impact the performance of HP Remote Graphics especially over bandwidth- constrained networks.
  • Page 59 Using Remote Graphics Software When the Receiver uses Directory Mode or Enterprise Service Mode with multiple Senders specified, the Select sender drop down box manages which system receives the active Remote USB connection. The example above shows a RGS Receiver setup for directory mode using the Directory File "directory.txt" and the system bl122 selected for Remote USB devices at the next connection.
  • Page 60 HP Remote Graphics 4.2.0 User's Guide The network timeouts control various timeouts that may occur within HP Remote Graphics. Error: Specifies the timeout in seconds used to detect and disconnect an inactive connection. Warning: Specifies the timeout in seconds used to detect and notify the user of a potential network disruption.
  • Page 61 Using Remote Graphics Software Hotkeys Options: Ctrl-Alt-End Hotkey: On some platforms the local host operating-system intercepts the Ctrl-Alt-Delete key sequence and does not forward it to the Receiver. For example, on a Windows system Ctrl-Alt-Del displays a dialog box instead of sending the sequence to the Receiver.
  • Page 62 HP Remote Graphics 4.2.0 User's Guide Some applications require the first key press event to arrive separately from subsequent events to function properly. If this is the case, check the 'Send First Key' option to immediately pass the first key in a hotkey sequence. Setup Mode Hotkey: While in a Remote Display Window, the remote desktop can sometimes completely cover and hide your local desktop.
  • Page 63 Using Remote Graphics Software Up: Specifies a key release. Logging Options: Console logging: enables logging to the console (standard output). This option is only available on Linux and HP-UX. It is not supported on Windows. File logging: enables logging to the specified file. The spinboxes for Max logfile size and Log file backups limit the maximum logfile size and the number of backup logfiles respectively.
  • Page 64 HP Remote Graphics 4.2.0 User's Guide Statistics Options: The statistics tab displays aggregate data for all connected sessions. Total network usage: The combined network bandwidth received from all remote systems per second. Image updates per second: The combined number of image updates per second received from all connections.
  • Page 65 Using Remote Graphics Software sequence defined in the Hotkeys tab) and then pressing the "H" key. The toolbar window appears at the top of the Remote Display Window: The toolbar displays the following controls and information: hostname: the hostname of the remote Sender disconnect button: disconnects the current session CTRL-ALT-DEL button: sends the CTRL-ALT-DEL key sequence to the Sender.
  • Page 66: Setup Mode

    HP Remote Graphics 4.2.0 User's Guide Setup Mode The RGS Receiver enters Setup Mode via a hotkey sequence or button in the Receiver Control Panel. See the hotkeys documentation for more information on accessing Setup Mode with a standard PC keyboard. Note that within a Remote Display Window, the Setup Mode Hotkey may sometimes be the only way to access your local desktop.
  • Page 67: Directory Mode

    Using Remote Graphics Software Directory Mode Starting the Receiver in Directory Mode When the Receiver starts in Directory Mode the Receiver looks up the name and location of a directory file containing the names of users and their assigned systems. The Receiver reads this file to identify the systems assigned to the current user and attempts to automatically connect to them.
  • Page 68 HP Remote Graphics 4.2.0 User's Guide Configuring a directory file for Directory Mode When the Receiver runs in Directory Mode, it requires a properly configured directory file. Normally, the directory file is a common file for an entire group, department, organization, or entire company.
  • Page 69 Using Remote Graphics Software Organizing Displays Directory Mode is usually intended for a system with multiple displays attached. For example, if the Receiver connects to two Senders, then at least two displays should be available on the local system. Each Sender can then display on its own monitor. The Receiver allows the user to easily move and position the Remote Display Window on the local desktop using Setup Mode.
  • Page 70: Enterprise Service Mode

    HP Remote Graphics 4.2.0 User's Guide Enterprise Service Mode Using the Enterprise Service The Enterprise Service (ES) supports assignment of systems to users and management of user settings and properties through a standard network service. The advantages of the Enterprise Service over using Directory Mode are: Using a network service, a centralized database or enterprise directory infrastructure can store systems assigned to a user.
  • Page 71 See Installing the Enterprise Service for more information. Once Python is installed, the user starts the ES as follows: From the command line: python C:\Program Files\Hewlett-Packard\Remote Graphics Enterprise Service\HprEsPrivate.py From the Start menu, select: Start --> Hp Remote Graphics --> Start Enterprise Service...
  • Page 72: Using The Sender

    HP Remote Graphics 4.2.0 User's Guide Using the Sender Controlling Sender Settings: Controlling Settings on Microsoft Windows Sender GUI The Sender for Windows registers an HP Remote Graphics Software icon in the application tray. On Windows the icon animates when Receivers are connected to the Sender.
  • Page 73 Using Remote Graphics Software Controlling Settings on Linux and HP-UX Sender GUI By default, the Sender GUI automatically starts on Linux and HP-UX when the Sender process starts. The Sender GUI displays with the HP Remote Graphics Software icon on the desktop. By right clicking on the icon, the user can select one of the following options: "Remote Keyboard/Mouse -->...
  • Page 74 HP Remote Graphics 4.2.0 User's Guide The Remote Graphics Software Sender on UNIX automatically starts when the X server on the system starts. Starting the Sender process in any other way is not supported. Typing the following command in a terminal emulator will show the Sender's process information: ps -ef | grep rgsender If multiple X servers are running on the system, there will be one Sender running for...
  • Page 75 Using Remote Graphics Software Setting the Windows Sender Process Priority This section describes how to adjust the process priority of the Windows Sender. The default process priority of the Windows Sender is normal. Under some situations, however, increasing the process priority of the Windows Sender may improve interactivity.
  • Page 76 Graphics Sender service. For example, to increase the process priority to high add the “-high” option to the key “ImagePath” as follows: "C:\Program Files\Hewlett-Packard\Remote Graphics Sender\rgsender.exe" -startService -l logSetup –high" 4. Restart the Sender service with the new option. This can be done using the Windows Service Control Manager or re-starting the system.
  • Page 77 Using Remote Graphics Software Note the addition of the “-high” command line option to the end of the command- line. Setting the Sender process priority using PTF The HP Performance Tuning Framework (PTF) can adjust the priority of the Sender without having to use regedit.
  • Page 78 HP Remote Graphics 4.2.0 User's Guide Collaboration Notification The Remote Graphics Sender for Windows displays a notification dialog when non- primary users are connected. The dialog displays a list of domain\usernames representing each user connected to the Sender: Two types of connections to a Sender are possible, primary and non-primary. A primary connection is one where the login credentials match those of the user logged into the desktop of the Sender system.
  • Page 79: Command Line Options

    Using Remote Graphics Software Command Line Options This section describes the options that can be specified on the command line of the Receiver and Sender. In addition, many properties can also be set on the command line. RGS Receiver Command Line Options The Windows Receiver (rgreceiver.exe) or the Linux/HP-UX Receiver (rgreceiver.sh) command line options are: [-directory [file] | -esdir serv1 [serv2 ...
  • Page 80 Graphics Sender service. For example, to increase the process priority to high add the “-high” option to the key “ImagePath” as follows: "C:\Program Files\Hewlett-Packard\Remote Graphics Sender\rgsender.exe" -startService -l logSetup –high" 4. Restart the Sender service with the new option. This can be done using the Windows Service Control Manager or re-starting the system.
  • Page 81 Using Remote Graphics Software turned on, where the logSetup file in the installation directory is set for output to a file named rg.log at INFO debug level. [-v | -ver | -version] prints the Senders's version information. [-h | -help | -?] prints a listing of the various command line options, those that are listed on this page.
  • Page 82: Properties

    HP Remote Graphics 4.2.0 User's Guide Properties Remote Graphics Software has a configuration mechanism that allows specifying many controls. This configuration mechanism is called Properties. Properties are name/value pairs. Properties are created with default values and can enable or disable window borders, set the codec quality, set the audio quality, adjust the connection timeouts, etc.
  • Page 83: Setting Properties On The Command Line

    Using Remote Graphics Software Setting Properties on the Command Line In addition to setting properties in a configuration file, properties can be set on the command line. Properties entered on the command line override all properties set in a configuration file. All properties must begin with a "-" on the command line to be recognized as a valid property.
  • Page 84 HP Remote Graphics 4.2.0 User's Guide verify the users credentials. The default value is "0" - prompting for credentials is off. Rgreceiver.Directory=string Used to set the name and location of the directory to use for determining the Sender systems that are assigned to the current user. This property is only used then the RGS Receiver is in Directory Mode.
  • Page 85 Using Remote Graphics Software Rgreceiver.RecentWindowPositions=0 0 1280 0 This property will set the coordinates of the first Remote Display Window to (0,0), and the second Remote Display Window to (1280, 0). In this example, if each Remote Display Window was at resolution 1280x1024, the first window would show up at the far left of the receiver's display, and the second window would be placed right next to the right edge of the first window, making them appear as one large 2560x1024 display.
  • Page 86 HP Remote Graphics 4.2.0 User's Guide Browser Properties: Rgreceiver.Browser.IsMutable=bool If set to "1", the name of the browser used to display online help, can be changed by the user in the Receiver Control panel. If set to "0", the name of the browser cannot be changed by the user.
  • Page 87 This is the path to the log file. This will only be used if RgReceiver.Log.IsFileLoggerEnabled is set to "1". The default path on Windows is located in the directory where the RGS Receiver is installed, normally C:/Program Files/Hewlett-Packard/Remote Graphics Receiver/rg.log. The default path on Linux or HP-UX is $HOME/.hpremote/rgreceiver/rg.log. Rgreceiver.Log.Level=string There are five logging levels: DEBUG, INFO, WARN, ERROR and FATAL.
  • Page 88 HP Remote Graphics 4.2.0 User's Guide log file. If WARN level is chosen, then all levels from WARN to FATAL will be output. The default value is INFO - all DEBUG output is turned off. Rgreceiver.Log.MaxFileSize=int This sets the maximum size of the log file in kilobytes (Kbytes). The default maximum size is 1024 Kbytes.
  • Page 89: Rgs Sender Properties

    Using Remote Graphics Software Rgreceiver.Usb.IsEnabled=bool If set to "1", remote USB will be enabled. If set to "0", all remote USB will be disabled and no network bandwidth will be consumed for remote USB. This property only applies to HP Blade Workstation Client. Rgreceiver.Usb.ActiveSession=int When the RGS Receiver is in Directory Mode or Enterprise Service Mode, the Receiver can connect to one or more RGS Senders.
  • Page 90 HP Remote Graphics 4.2.0 User's Guide Rgsender.IsDisconnectOnLogoutEnabled=bool If set to "1", the RGS connection will be disconnected when the user logs out. If set to "0", the RGS connection will remain connected to the sender when the user logs out. The default value is 1 - always disconnect when the user logs out. Rgsender.IsSnapToCodecEnabled=bool If set to "1", the HP Codec will be aligned or snapped to tile boundaries.
  • Page 91: How To Collaborate

    Using Remote Graphics Software How to Collaborate The HP Remote Graphics Software allows users to share a desktop with several users simultaneously. For example, a user can allow multiple connections to the same system enabling multiple-desktop collaboration with several users. This feature can be used for a variety of scenarios including classroom, design reviews, and support.
  • Page 92 HP Remote Graphics 4.2.0 User's Guide The user currently controlling the mouse and keyboard is called the floor owner. Only one user (the floor owner) can interact with the desktop at a time. To transition the floor owner, the current owner must not use the keyboard or mouse for a short period of time (0.5 seconds).
  • Page 93: Using Single Sign-on

    Using Remote Graphics Software Using Single Sign-on When RGS Single Sign-on is not installed, users are normally required to authenticate twice when connecting - once to connect from the RGS Receiver to the RGS Sender (RGS connection) and another to log into or unlock the remote desktop (Desktop session).
  • Page 94 HP Remote Graphics 4.2.0 User's Guide If the remote desktop displays either of these two states, then an RGS Single Sign- on connection will work. If the remote desktop state differs from these requirements, Single Sign-on will not work and the user will need to enter their credentials twice. To support Single Sign-on in the RGS Sender, the custom RGS GINA (Graphical Identification and Authentication) module, hprgina.dll, must be installed and loaded by Window's WinLogon process.
  • Page 95: Using Easy Login

    Using Remote Graphics Software Using Easy Login Easy Login is only supported on HP Blade Workstations running Windows XP. If Easy Login is not installed, users are normally required to authenticate twice when connecting - once to connect from the RGS Receiver to the RGS Sender (RGS connection) and another to log into or unlock the remote desktop (Desktop session).
  • Page 96 HP Remote Graphics 4.2.0 User's Guide These two WinLogon states requires the user to type in Ctrl-Alt-Del, the standard WinLogon SAS (Secure Attention Sequence), to enter in their credentials. If the remote desktop displays either of these states with no other RGS connections present, then an Easy Login connection will work.
  • Page 97 Using Remote Graphics Software than logging off before disconnecting the RGS Receiver. A screen saver might also be used to force the desktop to be locked after a certain amount of elapsed time. In this case, UserA would just disconnect the RGS Receiver and let the screen saver kick in to lock the desktop.
  • Page 98 HP Remote Graphics 4.2.0 User's Guide 2. That night UserB connects into UserA's workstation using Remote Desktop Connection. He logs in using an administrator account to update a software package. Once UserB finishes, he disconnects from the Blade Workstation. Since UserB just disconnected and did not logoff, a Remote Desktop or Windows terminal services session remains active.
  • Page 99: Remote Application Termination On Windows

    Using Remote Graphics Software Remote Application Termination on Windows Remote Application Termination (RAT) is only supported on Windows. Network outages or loss of connectivity between a RGS Receiver and Sender can leave a desktop session running without supervision. To safeguard running applications, customer-designed agents can monitor the status of connections to determine if termination of applications is required.
  • Page 100 HP Remote Graphics 4.2.0 User's Guide using the Event Log Service API. Data in the Event Log consists of a Message ID followed by optional data contained in both character string and binary data formats. Binary data provides direct access to data without requiring application parsing. Character strings format the binary data into human-readable messages compatible with the Windows Event Viewer.
  • Page 101 Using Remote Graphics Software RGSENDER_CONNECT A new connection was established with an associated name. If Easy Login is enabled, the name assignment will be deferred until login and the associated name may be “Anonymous”. Event Viewer Message: Connect %1. Strings: %1 = name associated with connection Data: None...
  • Page 102 HP Remote Graphics 4.2.0 User's Guide Strings: None Data: None RGSENDER_SHUTDOWN 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...
  • Page 103 Using Remote Graphics Software RGSENDER_SET_NONPRIMARY 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:...
  • Page 104 HP Remote Graphics 4.2.0 User's Guide Assuming the RGS Sender is properly installed and active, an HPRemote Event Log is created and reflects recent connection activity. By default, the most recent events display first. Clicking any record allows inspection of that event. The next image shows the detail of the 3:00:51 event.
  • Page 105 Using Remote Graphics Software Basic Application Control Agents Basic Windows monitoring agents must have the ability to monitor the HPRemote event log and interpret its events. When the number of primary user connections drops to zero, an agent should execute its actions tied to applications of interest running in the Desktop Session.
  • Page 106 LPCTSTR eventSource: the name of the target event generator, e.g., "rgreceiver" The programming header file, RGSenderEvents.h, is located with the RGS Sender installed software at: C:\Program Files\Hewlett-Packard\Remote Graphics Sender\include\RGSenderEvents.h A simple pseudo-code agent using these functions looks like this: #include <windows.h>...
  • Page 107 Using Remote Graphics Software &dwRead, // number of bytes read &dwNeeded); // bytes in next record if (CloseEventLog(h) == false) ... report error status ... return true; Process event (example: print out event) ============================== if (result) // We only know how to process specific events if (pevlr->EventID == RGSENDER_CONNECT_STATE) // Retrieve the two UINT32 fields of this message // representing primary and non-primary connections.
  • Page 108 HP Remote Graphics 4.2.0 User's Guide // 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 || GetNumberOfEventLogRecords(h, &dwCurrentCount) == false) CloseEventLog(h);...
  • Page 109: Agent Design Issues

    Using Remote Graphics Software monitorEvents(EVENT_SERVER, EVENT_SRC, seconds); ... cleanup agent here or send alerts ..may wish to return status from monitorEvents ... NOTE: The parameter EVENT_SRC above defines the name of an event generator here, not necessarily the Windows Event Log name HPRemote as suggested by external documentation.
  • Page 110 HP Remote Graphics 4.2.0 User's Guide also destroys memory of window placement on the desktop and requires intervention at restart. Selective Environment Shutdown Issues - Partial shutdown of an environment only terminates certain applications of interest. It does not implement a full Desktop Session logout. It selectively protects only the most critical applications requiring oversight and control.
  • Page 111: Additional Safeguard Features For Windows Systems

    Using Remote Graphics Software Concerns - May require redundant networking channel. Requires administrator or operator availability to support. Anticipating User Disconnects and Reconnection Issues - Users must first be warned about the consequences of disconnection. Agents that provide protection for a disconnected session can also provide a nuisance for unsuspecting users if they fail to address protective measures in place for their safety.
  • Page 112 HP Remote Graphics 4.2.0 User's Guide primary user connection. If service restarts are programmed for your environment, this test may be unnecessary. To set the RGS Sender service for automatic restart, you must adjust its Recovery Property through the "Administrative Tools" and "Services" control panel options.
  • Page 113 Using Remote Graphics Software...
  • Page 114: Using Timeouts

    HP Remote Graphics 4.2.0 User's Guide Using Timeouts Various network conditions as well as end-user needs require the ability to specify network warning, error and dialog timeouts. RGS enables relatively fine-grained control over the network and dialog timeout values as well as an innovative form of user notification when a warning timeout expires.
  • Page 115 Using Remote Graphics Software a network cable can be pulled (done often during testing) from its port other failures are possible, too. In some network scenarios, a disruption is transient while in other networks the connectivity loss is more permanent. For example, a network cable can be accidentally pulled and then plugged in again resulting in the network being restored.
  • Page 116 HP Remote Graphics 4.2.0 User's Guide In the network section of the RGS Receiver Control Panel, the warning timeout controls user notification if a potential network issue occurs. Under normal conditions, the RGS Receiver and Sender use sync-pulses to establish connection integrity.
  • Page 117 Using Remote Graphics Software two seconds (two-thousand milliseconds). The default error timeout is thirty seconds (thirty-thousand milliseconds). In a practical example, if a temporary network disruption occurs for less than two seconds, the Receiver does not display a user notification and the user only experiences a brief drop in Remote Display Window interactivity.
  • Page 118 HP Remote Graphics 4.2.0 User's Guide 60 seconds) or greater are not necessarily practical as the connection usually becomes useless and only frustrates the user with a waiting time that tries their patience. In the case of the Sender, the RGS Sender property, Rgsender.Network.Timeout.Error, also defines a required maximum network timeout value independent of Receiver settings.
  • Page 119 Using Remote Graphics Software values than normal steady-state timeouts. Authentication authorization dialogs often require more display time than standard messages and alerts due to their importance. The RGS system supports alternate timeouts for user interaction to separate them from operations such as sending graphics and audio content. This enables usable authentication and authorization experiences as well as more reasonable limits for standard messages and invocations.
  • Page 120 HP Remote Graphics 4.2.0 User's Guide have an associated timeout since it is not an incoming invocation from the Sender to the Receiver. This dialog displays indefinitely until the user responds "OK" or "Cancel" to its requests. The default property for Rgreceiver.Network.Timeout.Dialog and Rgsender.Network.Timeout.Dialog is fifteen thousand milliseconds (15 seconds).
  • Page 121: Remote Graphics And Microsoft Remote Desktop Interaction

    Using Remote Graphics Software Remote Graphics and Microsoft Remote Desktop Interaction Prior to release 4.0, RGS Sender for Windows could not coexist on systems enabled for Windows Remote Desktop connections. At release 4.0, connections made with either HP Remote Graphics or Windows Remote Desktop will work. Simultaneous desktop sharing, however, is not possible.
  • Page 122: Optimizing Performance

    HP Remote Graphics 4.2.0 User's Guide Optimizing Performance This section provides suggestions on how to optimize performance in RGS. Performance Tuning for all platforms: Set the network to operate in Full-Duplex mode To get the best performance, the network between the RGS Sender and RGS Receiver should run in Full-duplex mode.
  • Page 123 Using Remote Graphics Software possible reason for the problems is network performance. If the Sender runs on a Windows operating system, it can be an operating system scheduling issue. Sometimes this can be resolved by increasing the process priority of the Sender.
  • Page 124: Utilities

    Windows Explorer to display the RGS Sender installation folder and locate a program called rgdiag.exe with the RGS icon. On a 32-bit Windows system, this is normally located at: C:\Program Files\Hewlett-Packard\Remote Graphics Sender\rgdiag.exe On a 64-bit Windows system, this is normally located at: C:\Program Files (x86)\Hewlett-Packard\Remote Graphics Sender\rgdiag.exe...
  • Page 125 On a 32-bit Windows system, this is normally located at: C:\Program Files\Hewlett-Packard\Remote Graphics Sender\rgadmin.exe On a 64-bit Windows system, this is located at: C:\Program Files (x86)\Hewlett-Packard\Remote Graphics Sender\rgadmin.exe Double-click the application to launch the RGS Admin tool. This application must be run using an account with Administrator permissions.
  • Page 127: Troubleshooting

    Troubleshooting Troubleshooting Usage and Performance This section covers troubleshooting networking configuration, graphics, cpu, remote audio, and remote USB. Troubleshooting Network Configuration This section describes troubleshooting the network. Image update rate appears slow: Troubleshooting network issues is difficult. Although the HP Remote Graphics Software is capable of excellent performance, if your network does not support the required bandwidth...
  • Page 128 HP Remote Graphics 4.2.0 User's Guide On Linux systems, there are two tools that can be used (mii-tool & ethtool) to configure networking. If the mii-tool does not work for a particular system, use ethtool. Do the following to get and set the network characteristics on Linux: To get the LAN characteristics for interface 0, as root, type: $ /sbin/mii-tool eth0...
  • Page 129 Troubleshooting If you are still not satisfied with your network performance, look at the log files on your network switch (if the Receiver is plugged into one). A significant number of errors on the switch port may signify that the computer or network is not configured correctly.
  • Page 130 HP Remote Graphics 4.2.0 User's Guide Enabling mute on some devices will prevent audio from arriving at the receiver. The Realtek audio device used in the HP xw4300 is known to have this issue. One possible solution when running the 32 bit version of Windows XP is to disable the audio device prior to installing the sender.
  • Page 131 Troubleshooting 2. Verify the JACK and ALSA components are installed and configured properly on the receiver system. To see if the modules are present, as root, type /sbin/lsmod. The modules show up as snd-*-* names. They usually appear by either direct loading or system initialization in the /etc/modules.conf [2.4 kernel] and /etc/modprobe.conf [2.6 kernel].
  • Page 132: Troubleshooting Remote Usb

    HP Remote Graphics 4.2.0 User's Guide With ALSA working, users can validate JACK by performing the following steps: 1. Ensure that the ALSA device is properly configured and can be heard through the desired port, i.e., headphone jack, speaker, etc. 2.
  • Page 133 Troubleshooting verify that HP Remote Virtual USB is listed under Universal Serial Bus Controllers. The following panel shows the HP Remote Virtual USB is properly installed and configured. If the driver is not reported, reinstall the RGS Sender Software on the HP Blade Workstation sender system.
  • Page 134 HP Remote Graphics 4.2.0 User's Guide Enable Remote USB: Verify that the receiver has enabled Remote USB. Make certain that the "Enable Remote USB" box is checked under the USB option tab of the RGS Control Panel as shown below:...
  • Page 135 Troubleshooting Supported USB Devices: Verify that the USB device is supported for remote connection. Not all USB devices are supported by the current version of HP Remote Graphics Software. 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.
  • Page 136 HP Remote Graphics 4.2.0 User's Guide directory. At least two files appear in this directory for a single connected device: a. /proc/devices/usb_remote/devices - File contains a list of recognized devices by the Receiver system. b. /proc/devices/usb_remote/# - If only one USB device is recognized, the "devices"...
  • Page 137: Known Issues And Limitations

    Troubleshooting Known Issues and Limitations This section describes a list of known issues and limitations of the HP Remote Graphics Software. General Issues: Switching Network Interfaces: The Sender does not transition well when switching network interfaces or hopping from one network interface to another. The Sender must be re- started so that it can re-discover the correct interface.
  • Page 138 HP Remote Graphics 4.2.0 User's Guide PC Speaker Sounds Not Working: The Sender will capture all audio information sent through the mixer. This includes most audio alerts, MIDI, Direct Sound and Direct Music. Sounds generated by the PC Speaker are not captured by the sender and will not be transmitted.
  • Page 139 Troubleshooting Rgreceiver.Network.Timeout.Error property so the Receiver disconnected. If this condition persists, then it is likely that network disruptions are exceeding the Receiver’s error timeout value. If this is a network issue and is not resolvable, then the user might consider adjusting the error timeout of the Receiver to reduce Receiver disconnection.
  • Page 140 HP Remote Graphics 4.2.0 User's Guide Increasing the Receiver error dialog timeout doesn’t appear to have an effect and the Receiver still disconnects: Either a network failure results in detecting lost connectivity by the Receiver (resulting in disconnected connections) or the Sender’s timeouts are shorter than the Receiver’s timeouts and the Sender disconnects the Receiver.
  • Page 141 Troubleshooting ?objectID=PSD_WO040917_CW01) for more details on how to resolve this issue. OpenGL Applications Not Starting: Previous versions of HP Remote Graphics required the manual placement of the HP Remote Graphics OpenGL32.dll library into the application's directory. This library may cause some applications to fail on startup. Automatic updates of OpenGL applications are now supported and the HP Remote Graphics OpenGL32.dll library is no longer required.
  • Page 142 HP Remote Graphics 4.2.0 User's Guide command window. If the IP address associated with the Sender ports (listening port 42966) are private, then APIPA is probably at fault. Consult the Microsoft's APIPA WEB site for further information, including how to disable APIPA here(http://www.microsoft.com/resources/documentation/Windows/XP/all/res kit/en-...
  • Page 143 Troubleshooting all desktops. Read the Setup Mode section to learn how to bring the Receiver control panel to the front. Geometry Feedback Window And Performance: Performance of window moves using a HP-UX Sender over a low-bandwidth network connection is slow. This is related to the geometry feedback window placed on top of the window that you are moving.
  • Page 144 HP Remote Graphics 4.2.0 User's Guide Transparent Overlay Windows - Certain applications, primarily 3D applications, create windows in the overlay planes that entirely cover the main application windows that exist in the image planes. These overlay windows are primarily transparent and are used to contain text or other rendered images that should not be drawn into the image planes of the application.
  • Page 145 Troubleshooting work for most systems… but if not, try manually playing with mixer settings via the alsamixer in a terminal window or via your favorite mixer application. JACK Sound Server: JACK is a sound server that interfaces with the ALSA drivers. Once installed and configured on your machine, this is your sound.
  • Page 146: Error Messages

    HP Remote Graphics 4.2.0 User's Guide Error Messages The following table lists the errors that are reported by the HP Remote Graphics Software Receiver. Error Description Connection lost! The RGS Sender has closed the connection. Possible reasons include: 1. The Sender may have explicitly disconnected your connection.
  • Page 147 Troubleshooting ping IP address If no ping reply is received, the Sender is unreachable or is not running. If a ping reply is received, the Sender software may not be running on the remote computer. 2. A Sender is not running on the system you are attempting to reach.
  • Page 148 HP Remote Graphics 4.2.0 User's Guide Directory not found The directory file is not available. Possible reasons or not accessible! include: 1. The directory file name or location has been mistyped. 2. The file has been moved or is no longer available.
  • Page 149 Troubleshooting Error: License The license is invalid for the RGS Sender. Invalid for the sender you are trying to connect Could not create an The Receiver was started in Enterprise Service Mode Enterprise and it could not connect to the RGS Enterprise Directory Session! Service.
  • Page 150 HP Remote Graphics 4.2.0 User's Guide Setup Mode hotkey The Setup Mode hotkey sequence specified using a sequence is invalid. property either on the command-line, property The sequence has configuration file, or RGS Enterprise Service, is been reset to the invalid and has been reset to the default.
  • Page 151: License And Support

    This End-User license Agreement ("EULA") is a legal agreement between (a) you (either an individual or a single entity) and (b) Hewlett-Packard Company ("HP") that governs your use of any Software Product, installed on or made available by HP for use with your HP product ("HP Product"), that is not otherwise subject to a separate...
  • Page 152 HP Remote Graphics 4.2.0 User's Guide Freeware by you shall be governed entirely by the terms and conditions of such license. f. Recovery Solution. Any software recovery solution provided with/for your HP Product, whether in the form of a hard disk drive-based solution, an external media- based recovery solution (e.g.
  • Page 153 License and Support Software Product. HP agrees not to use this information in a form that personally identifies you except to the extent necessary to provide such services. 9. DISCLAIMER OF WARRANTIES. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, HP AND ITS SUPPLIERS PROVIDE THE SOFTWARE PRODUCT “AS IS”...
  • Page 154 HP Remote Graphics 4.2.0 User's Guide © 2003 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. All other product names mentioned herein may be trademarks of their respective companies. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services .
  • Page 155: Contacting Hp

    CH-1217 Meyrin 2 Geneva, Switzerland Phone: (41/22) 780-8111 Open between 9:00 a.m. and 6:00 p.m. local time, Monday through Friday. Asia Pacific Hewlett-Packard Asia Pacific Ltd. Hewlett-Packard Hong Kong Ltd. 19/F, Cityplaza One 1111 King's Road Taikoo Shing Hong Kong Phone: (852) 2599-7777 Open between 9:00 a.m.

Comments to this Manuals

Symbols: 0
Latest comments: