HP xw4400 User Manual

HP Remote Graphics 4.2.0
User's Guide
Copyrights and trademarks
© Copyright 2003 - 2006 Hewlett-Packard Development Company, L.P.
The HP Remote Graphics Sender for Windows uses Microsoft Detours Professional
2.0. Detours is Copyright 1995-2004, Microsoft Corporation. Portions of the Detours package may be covered by patents owned by Microsoft corporation.
Microsoft, MS-DOS, Windows, Windows NT, Windows 2000, Windows XP, and DirectX are registered trademarks or trademarks of Microsoft Corporation in the U.S. and other countries.
Intel, Pentium, Intel Inside, and Celeron are registered trademarks of Intel Corporation or its subsidiaries in the U.S. and other countries.
Java is a trademark or registered trademark of Sun Microsystems, Inc. AMD and AMD64 are trademarks of Advanced Micro Devices, Inc. OpenGL is a registered trademark of Silicon Graphics, Inc. Red Hat and Enterprise Linux are registered trademarks of Red Hat, Inc. Linux is the registered trademark of Linus Torvalds in the United States and other
countries. InstallShield® is a registered trademark and service mark of Macrovision Corporation
and/or Macrovision Europe Ltd. in the United States and/or other countries. Symantec and the Symantec logo are U.S. registered trademarks of Symantec
Corporation. pcAnywhere is a trademark of Symantec Corporation. ZeroC, Ice, and Internet Communications Engine are trademarks of ZeroC, Inc. CORBA is a trademark or registered trademark of the Object Management Group,
Inc. Audigy is a trademark of Creative Technology Ltd. in the United States and/or other
countries. Python and PyCon are trademarks or registered trademarks of the Python Software
Foundation. 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” without warranty of any kind, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose, and is subject to change without notice. The warranties for HP products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.
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.
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/). log4cplus is available from http://log4cplus.sourceforge.net/
Advanced Linux Sound Architecture (ALSA): ALSA provides audio and MIDI functionality to the Linux operating system. ALSA is released in source code format under the GNU LESSER GENERAL PUBLIC LICENSE Version 2.1, February 1999. ALSA is used in the HP Remote Graphics Software Receiver for Linux.
Jack Audio Connection Kit (JACK): JACK is a low-latency audio server, written for POSIX conformant operating systems such as GNU/Linux and Apple's OS X. JACK is released in source code format under the GNU LESSER GENERAL PUBLIC LICENSE Version 2.1, February 1999. JACK is used in the HP Remote Graphics Software Receiver for Linux.
Libsndfile: Libsndfile is a C library for reading and writing files containing sampled sound (such as MS Windows WAV and the Apple/SGI AIFF format) through one standard library interface. Libsndfile is released in source code format under the GNU LESSER GENERAL PUBLIC LICENSE. Libsndfile is used in the HP Remote Graphics Software Receiver for Linux.
Where required, related source code and licenses are re-distributed with HP Remote Graphics Software.
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................................................................................... 16
Creating Unattended Installers......................................................................22
Installing & Enabling Remote Audio............................................................... 23
Installing and Enabling Single Sign-on........................................................... 32
Installing and Enabling Easy Login.................................................................35
Installing the Enterprise Service SDK............................................................. 39
Enabling OpenGL Applications....................................................................... 40
Enabling Direct3D Applications on Windows....................................................42
Using Remote Graphics Software .....................................................................43
Using the Receiver ...................................................................................... 43
Directory Mode ...........................................................................................59
Enterprise Service Mode...............................................................................62
Using the Sender ........................................................................................ 64
Command Line Options................................................................................ 71
Properties .................................................................................................. 74
How to Collaborate......................................................................................83
Using Single Sign-on ................................................................................... 85
Using Easy Login......................................................................................... 87
Remote Application Termination on Windows.................................................. 91
Using Timeouts......................................................................................... 106
Remote Graphics and Microsoft Remote Desktop Interaction .......................... 113
vii
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
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.
1
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™ and others.
Remote Graphics Software is composed of three major software components:
1. RGS Sender is a software application that runs as a service or background process on a remote computer and transmits graphics updates, audio, and USB data to one or more RGS Receivers. The Sender receives keyboard events, mouse events, and USB data from the Receiver, and processes them locally.
2. RGS Receiver is a software application that runs on a local computer or thin­client. The Receiver establishes a connection to one or more Senders, requests graphics updates from the Sender, and displays the desktop of the remote computer inside a window on the local system. Keyboard and mouse events in the Remote Display Window are transmitted to a Sender. USB data is also transmitted and received from the Sender. The Receiver connects to the RGS Enterprise Service if enabled.
3. RGS Enterprise Service is an optional software component that runs as a service or daemon on a remote computer. The Enterprise Service (ES) manages centralized system lookup and user enterprise properties for the RGS Receiver over a standard computer network. The Enterprise Service is delivered as a Software Development Kit (SDK).
3
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.
Collaboration: Multiple users can simultaneously connect to the same
Sender. This allows several users to view and interact with the same desktop. For example, several users at different remote locations can simultaneously view 3D OpenGL applications using a RGS Receiver.
Collaboration Notification: The RGS Sender displays a collaboration
notification dialog when one or more non-primary connections are active. The dialog displays the users currently connected to the Sender. This provides a reminder to the user that multiple connections to the desktop exist. Individual users can be disconnected using the collaboration notification dialog. See Collaboration Notification for more details.
Directory Mode: Directory Mode enables the Receiver to locally lookup pre­assigned systems for a user from a file.
Direct3D: Direct3D 8.0 and Direct3D 9.0 applications are supported.
Remote access users and remote collaborators can easily interact with Direct3D applications running on a remote desktop. Direct3D applications run using the full power of the graphics adapter. See Enabling Direct3D Applications on Windows for further information.
Disconnect primary or non-primary users: The RGS Sender desktop GUI
provides the ability to selectively disconnect either non-primary users or all users (both primary and non-primary).
Easy Login: Enables fewer authentication steps when connecting to an HP
Blade Workstation running Windows XP Pro. See Using Easy Login for more details.
Enterprise Service Mode: The Remote Graphics Software Enterprise Service
enables a customer to integrate remote graphics into their enterprise directory infrastructure to support assignment of systems to users as well as managing user settings and properties. The Enterprise Service enables roaming usage. Users can work from any location on the network and easily access their assigned systems and settings without re-entering them. The Remote Graphics Software Enterprise Service also allows IT organizations to easily manage user system assignment with their current enterprise directory infrastructure.
Hotkeys: The RGS Receiver supports setting user-defined hotkeys for
entering Setup Mode as well as other operations.
4
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, when a disconnect occurs, the user that is assigned to a connection, and whether that user is a primary or non-primary user.
Multi-head Display: Single-headed receivers can view multi-headed
senders. Multi-headed receivers can view single-headed senders. Multi­headed receivers can view multi-headed senders. The view can expand to contain the entire area on the receiver's desktop. This gives the user the impression of direct connection and full utilization of the sender's desktop.
Multi-platform support: Senders and Receivers are supported on Microsoft
Windows, Linux and HP-UX systems. See System Requirements for more details.
Network Connection Warning Notification: The RGS Receiver visually warns
the user when network connectivity between a Receiver and Sender is potentially lost. If network connectivity recovers, normal operation should continue. See Network Options and Using Timeouts for more details.
OpenGL 3-D OpenGL applications are supported. Remote access users and remote collaborators can easily interact with 3-D applications running on a remote desktop. 3-D applications run using the full power of the graphics adapter. See Enabling OpenGL Applications for further information. :
Properties: The RGS Receiver and Sender provide an easy to use public
interface that allows users and administrators to specify properties either on the command-line, a configuration file, or using the RGS Enterprise Service. See Properties for more details.
Remote Application Termination (RAT): Network outages or loss of
connectivity between a 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. Remote Application Termination is only available with the RGS Sender for Windows. See Remote Application Termination on Windows for more details.
Remote Audio: Smooth, continuous, low-latency, high-quality remote audio is possible from RGS Senders to RGS Receivers. See System Requirements for more details on the supported systems.
Remote & Local Cursor Tracking: In a collaboration session (multiple users
connected to the same remote desktop) the shape of the local hardware cursor is modified for the floor owner (the user that is currently in control
of the mouse and keyboard). For the other remote users, the local cursor is
left unchanged and a remote cursor is displayed in the Remote Display Window.
5
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.
Single Sign-on: Enables fewer authentication steps and automatic login
and unlocking of the desktop when connecting to a HP Blade Workstation running Windows XP Pro. Activation of RGS Single Sign-on requires enabling the RGS Sender for Windows GINA module (hprgina.dll) which
can be selected during installation.
Status Bar: A status bar in the RGS Receiver Control Panel provides status
notification such as connecting, authenticated, authorizing, and connected messages. The banner in the RGS Control Panel also animates when a connection is in progress.
Stateless client: Connections are completely stateless. No data is
persistently stored in the Receiver.
Timeout Configuration: Network and dialog timeouts can be controlled to
meet various network and user requirements. See Network Options and
Using Timeouts for more details.
Virtual KVM: A single Receiver can establish multiple remote connections to
several remote systems simultaneously when run in Directory or Enterprise Service Mode. Virtual KVM (V-KVM) emulates the functionality of a KVM switch in software to provide a convenient method to map workstations to specific displays and switch between them. This feature emulates the capabilities found in a physical KVM switch by allowing the user to easily switch between remote session by "raising" the selected Remote Display Window in a manner similar to the "alt-tab" capability provided in Windows. The receiver can also switch audio between active sessions as described in the Controlling Receiver Settings section using the audio follows focus option.
6
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. On Windows operating systems authentication uses NTLM or Kerberos. On UNIX (Linux and HP-UX) authentication uses the Pluggable Authentication Module (PAM).
Authorization: Multiple connections to the same Sender are only allowed if the
user logged into the desktop of the Sender system (primary user) allows the connection. When a non-primary user attempts to connect to a Sender an authorization dialog is displayed on the desktop of the remote system that asks whether the user should be allowed to connect.
Automatic Desktop Locking: The desktop of the Sender system locks when
the primary user disconnects. This prevents non-primary users from being able to interact with a remote session after the primary user has disconnected.
This feature is supported on Windows systems, and on Linux and HP-UX, this feature is supported on the Gnome, KDE, and CDE desktop environments.
Automatic Disconnect: On Linux and HP-UX systems all Receivers will disconnect when the primary user disconnects. This prevents non-primary users from interaction with a remote session after the primary user disconnects.
Automatic Disconnect of non-primary users on Login: All non-primary users
are disconnected when a login event occurs. Only the primary user remains connected when the desktop of the remote computer is logged in.
Automatic Disconnect on Log Off: All Receivers are disconnected when the
primary user logs off of the remote desktop. This can be disabled by setting the "IsDisconnectOnLogoutEnabled" sender property to "0". See Sender Properties for more information.
Connection Status: On Windows a desktop icon in the application tray
animates when other users are connected. Likewise, on Linux and HP-UX the Sender GUI animates.
Collaboration notification: See Features.
Connections are not allowed when an iLO remote console is enabled: If the
iLO remote console is enabled on a HP Blade Workstation, connections to the blade using RGS are denied.
Disconnect All: All Receivers can be easily disconnected using the Sender GUI.
This is useful when hosting a collaboration session, such as in a classroom environment, and the session ends. On Windows system, the GUI is an icon
7
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.
Single user connection: A user, identified by a username, is only allowed one
connection to a RGS Sender. If the same username connects more than once to a Sender, the previous connection drops and the new connection continues on. If several users attempt to share a username, only one connection is active at a time.
SSL encryption: SSL securely encrypts all data transmitted between a
Receiver and Sender pair.
8
About Remote Graphics Software
On Windows, video overlay planes, DirectX and
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 & 64-bit (Intel x86 and x86-64 processor families. AMD x86 and AMD64 processor families. HP Personal Workstations only.)
HP-UX 11.0 and 11i V1 HP PA-RISC 2.0 architecture (PA-8500 or later)
Supported Graphics Windows & Linux:
Any graphics adapter (nVIDIA, ATI, Matrox)
HP-UX:
HP Visualize fx5, fx10
ATI FireGL-UX, FireGL T2-128p
FireGL X1-256p, FireGL X3-256
Display Settings Supports the following Display Settings:
32 bit at 1024x768 resolution or higher
full-screen exclusive mode access not supported.
On Windows, OpenGL overlay planes are not supported.
Remote Audio Microsoft Windows XP Professional 32-bit and 64-
bit
Microsoft Windows 2000 Professional
9
HP Remote Graphics 4.2.0 User's Guide
Not all USB devices are supported. Refer to the
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. For example, RGS Sender and Receiver at version 4.0 work together. If they are both version 3.1, they will work together. Versions 3.1 and 4.0 in any combination will not work together.
3. HP Blade Workstation documentation for more details.
Easy Login HP Blade Workstation running Microsoft Windows XP
Professional 32-bit.
Remote Application Termination
Collaboration Notification
Networking Standard TCP/IP.
Microsoft Windows 2000 Professional or XP Professional 32-bit and 64-bit.
Microsoft Windows 2000 Professional or XP Professional 32-bit and 64-bit.
10/100/1000BASE-T (Gigabit) Ethernet.
Full-duplex recommended.
Receiver
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.)
HP Compaq t5720 Thin Client with Microsoft
Red Hat Enterprise Linux WS3 32-bit & 64-bit
10
Windows XP Embedded (SP2)
(Intel x86 and x86-64 processor families. AMD x86 and AMD64 processor families. HP Personal
About Remote Graphics Software
to the
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-
bit
Microsoft Windows 2000 Professional
HP Compaq t5720 Thin Client with Microsoft
Windows XP Embedded (SP2)
Linux 32-bit & 64-bit
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. For example, RGS Sender and Receiver at version 4.0 work together. If they are both version 3.1, they will work together. Versions 3.1 and 4.0 in any combination will not work together.
3. Not all USB devices are supported. Refer HP Blade Workstation documentation for more details.
11
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. English
U.K. English
German (ABD)
Italian (ABH)
French (ABF)
Spanish (ABE)
International keyboard (ABZ)
Swedish
Finnish
Danish,
German Swiss
French Canadian
Norwegian.
Enterprise Service
Feature Supported Components
Operating System Microsoft Windows XP Professional 32-bit & 64-bit
Microsoft Windows 2000 Professional
12
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. Insert the HP Remote Graphics Software CD and in Explorer change to the directory win32\receiver on your CD-ROM drive.
2. Double-click or select Setup.exe to start the installer.
3. Follow the instructions on the screen.
The installer will add a menu item folder to the Programs folder called HP Remote Graphics. In this folder will be two items:
Receiver
Receiver -directory
Unattended Installations
If you need to install the Windows RGS Receiver on several systems, please refer to Creating Unattended Installers.
Installing the RGS Receiver for Linux
To install:
1. Login as root.
2. Insert the HP Remote Graphics Software CD and mount the CD, if it is not automatically mounted.
3. Go to the mount point of the CD, which is usually /mnt/cdrom and change directories to lin32/receiver.
4. Execute the following command:
./install.sh
Note: If remote audio is installed the HP Remote Graphics Software requires
certain audio support utilities be available for remote audio support from
13
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. Only the JACK-Audio-Connection-Kit is built during install and it requires ALSA sound library support.
Note: The files contained within hp_rgs_4_audiosupport.tar.gz can also be
built and configured for RPM package creation. See script rgs_audio_support for details.
5. The Receiver will be installed into /opt/hpremote/rgreceiver. To start the Receiver, execute the following command:
/opt/hpremote/rgreceiver/rgreceiver.sh
To start the Receiver in directory mode, execute the following command:
/opt/hpremote/rgreceiver/rgreceiver.sh -directory
6. Optionally, add the directory /opt/hpremote/rgreceiver to your PATH environment variable.
7. Refer to Installing & Enabling Remote Audio to complete the Receiver installation.
Installing the RGS Receiver for HP-UX
To install:
1. Login as root.
2. Insert the HP Remote Graphics Software CD and mount the CD.
3. Go to the mount point of the CD, which is usually /mnt/cdrom and change directories to hpux-pa/receiver.
4. Execute the following command:
./install.sh
5. The Receiver will be installed into /opt/hpremote/rgreceiver. To start the Receiver, execute the following command:
/opt/hpremote/rgreceiver/rgreceiver.sh
To start the Receiver in directory mode, execute the following command:
/opt/hpremote/rgreceiver/rgreceiver.sh -directory
6. Optionally, add the directory /opt/hpremote/rgreceiver to your PATH environment variable.
14
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.
Uninstalling the RGS Receiver for Linux:
To uninstall the RGS Receiver for Linux find the name of the RedHat RPM package for the Remote Graphics Receiver, by typing:
rpm -q -a | grep -i rgreceiver
If the Receiver is installed on the system, you will see rgreceiver_linux_32-4.0-0 or a similar Receiver package. To remove the Receiver's RPM package, become root and type:
rpm -e --allmatches rgreceiver_linux_32
Uninstalling the RGS Receiver for HP-UX
To uninstall the RGS Receiver for HP-UX, become root and type:
/usr/sbin/swremove rgreceiver_hpux_pa
15
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. Insert the HP Remote Graphics Software CD and change to the directory win32\sender on your CD-ROM drive.
2. Double-click or select Setup.exe to start the installer.
3. Follow the instructions on the screen.
NOTE: The Remote Graphics Diagnostic tool runs during installation to detect
common setup issues (Windows XP firewall settings, Guest Account security policies, RDP interoperability, Easy Login configuration, etc). The tool will only display a window if it detects a potential problem. Use the tool anytime after installation to determine installation problems. See Utilities for more details.
4. You will be prompted to restart the system after the installation is complete. Select yes when asked to restart the system.
The Sender is installed as a Windows Service. In fact, this is necessary to enable some features, such as the ability to send Ctrl-Alt-Del key sequences and also
view locked screens. Additionally, installing the Sender as a service allows the Microsoft Windows operating system to automatically start the Sender when the system is started.
NOTE: To enable OpenGL applications see Enabling OpenGL Applications for more
details.
NOTE: To enable remote audio see Installing & Enabling Remote Audio for more
details.
Installing the RGS Sender on HP Blade Workstations
The RGS Sender for Windows installer setup.exe will automatically upgrade software versions prior to 4.0.0 when run. Upgrading the Sender is possible while connected to a HP Blade Workstation. After completing the upgrade restart the system when prompted. This will disconnect the current RGS connection and require a reconnect after the Blade Workstation restarts.
16
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. Please refer to the HP Blade Workstation iLO documentation for further details about the iLO administrative console.
Installing the RGS Sender and Remote Desktop
Using Microsoft Remote Desktop to remotely install the RGS Sender for Windows is not supported. If attempted, the installation process displays an error message and stops the installation process. If installing the RGS Sender on a HP Blade Workstation, use the iLO Remote Console Mode in Setup Mode (from the boot BIOS) instead.
Unattended Installations
If you need to install the Windows RGS Sender on several systems, please refer to Creating Unattended Installers.
Installing the RGS Sender for Linux
Linux Sender Installation
1. Login as root.
2. Insert the HP Remote Graphics Software CD and mount the CD, if it is not automatically mounted.
3. Go to the mount point of the CD, which is usually /mnt/cdrom and change directories to lin32/sender.
4. Execute the following command:
./install.sh
5. The Sender will be installed to /opt/hpremote/rgsender.
6. Add the "rge" extension to the X Server configuration file. Edit the /etc/X11/XF86Config, /etc/X11/XF86Config-4 or the appropriate XF86Config file on your system for XFree86 X servers. Edit the xorg.conf file for X.Org X Servers. In the Modules section of this file, add the following line:
Load "rge"
7. The Module section should read as follows:
Section "Module"
... Load "rge" ...
17
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. If you are using the GNOME Desktop Manager or KDE Desktop Manager you must manually add the following lines to the files /etc/pam.d/gdm,
/etc/pam.d/kde, and /etc/pam.d/xdm:
session optional pam_rg.so
10.If another desktop manager, such as Enlightenment, is being used then you will need to make similar changes to the PAM configuration file used by it. You should consult your Linux and Desktop Manager documentation for further information.
11.If the PAM system has been configured to use custom PAM authentication modules then you may need to manually configure the PAM module that is used by the RGS Sender. You should consult your Linux documentation when configuring PAM.If you are using a custom PAM authentication module called “libpam_custom.1” you may need to edit the PAM configuration file "/etc/pam.d/rgsender” to specify the PAM authentication module to be used by the RGS Sender. For example, you may need to add the following to the file "/etc/pam.d/rgsender”.
auth optional /lib/security/pam_custom.1
12.The default on RedHat Linux is to bind the machine name to the loopback interface in the /etc/hosts file. The RGS Sender will not accept remote connections with this configuration. Edit the /etc/hosts file and bind the machine name to its proper IP address as follows:
127.0.0.1 localhost localhost.localdomain
88.1.89.122 blade2 blade2.bigmoney.com
Linux Sender GUI Installation
The Sender GUI will automatically starts on Linux when the Sender process starts. If you prefer to start the Sender GUI on a per-user basis, then edit the file /opt/hpremote/rgsender/rgsender.sh, and add the -noautostartgui command line option as follows
exec ./rgsender $* -noautostartgui -l logSetup
and then proceed to follow the directions below.
KDE RedHat GUI setup
To section describes how to manually start the Sender GUI when KDE is the desktop manager.
1. Open the Konqueror file manager (the desktop icon that is named "Home").
18
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".
5. On the Execute Tab page, add the following in the Command text edit box :
/opt/hpremote/rgsender/rgsender_gui.sh
6. Click the "OK" button to save the changes.
7. Logout and log back in and you should see the RG Sender GUI.
GNOME RedHat Enterprise GUI setup
To section describes how to start the Sender GUI when Gnome is the desktop manager.
1. Open the Nautilus file manager (the desktop icon that is named "Start Here")
2. Select the "Preferences" icon.
3. Select the "Session" icon.
4. Select the "Session Properties & Startup Programs" icon. A new dialog window will open.
5. Select the "Startup Programs" Tab in the new dialog window
6. Click the "Add" button. A new dialog window will open.
7. In the "Startup Command" text edit box in the new dialog window enter:
/opt/hpremote/rgsender/rgsender_gui.sh --display :0.0
8. Select the "OK" button.
9. Select the "Apply" button.
10.Logout and log back in and you should see the RG Sender GUI.
Optionally, you can also setup Gnome so the icon does not show up on the task bar ­the following instructions do not apply for RedHat Enterprise Edition systems.
1. Go back to the Nautilus file manager, select "Preferences" and then select "Sawfish window manager."
2. Select "Matched Windows". A new dialog window will open.
3. Click the "Add" button. A new dialog window will open.
4. In the "Matchers" window select the down arrow button and select "Name" in the left text edit window.
5. In the corresponding text edit window on the right enter the following "rgsender_gui"
19
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. Click on OK
10.Logout and log back in and you should not see the rgsender_gui listed in the task bar although you should see the icon on the desktop.
Installing the RGS Sender for HP-UX
HP-UX Sender Installation
1. Login as root.
2. Insert the HP Remote Graphics Software CD and mount the CD.
3. Go to the mount point of the CD, which is usually /mnt/cdrom, and change directoryies to hpux-pa/sender.
4. Execute the following command:
./install.sh
5. The Sender will be installed to /opt/hpremote/rgsender and will be started automatically when the X Server or system is restarted.
6. The HP-UX Sender uses the Pluggable Authentication Module (PAM) for authentication. Add the following lines to the file /etc/pam.conf:
gdm session optional /usr/lib/security/libpam_rg.1 dtlogin session optional /usr/lib/security/libpam_rg.1
7. If the PAM system has been configured to use custom PAM authentication modules then you may need to manually configure the PAM module that is used by the RGS Sender. You should always consult your HP-UX documentation when configuring PAM. If you are using a custom PAM authentication module called “libpam_custom.1” then you may need to edit the PAM configuration file “/etc/pam.conf” to specify the PAM authentication module to be used by the RGS Sender. For example, may need to add to the file “/etc/pam.conf” the following:
rgsender auth optional /usr/lib/security/libpam_custom.1
NOTE: The system must contain the December 2002 or newer X server
patches. HP-UX 11.0 requires X server patch PHSS_26637 or newer. HP­UX 11.11 requires X server patch PHSS_26638 or newer.
The system must also contain the September 2004 OpenGL patch (PHSS_30882) or newer for proper 3D OpenGL operation.
20
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:
exec ./rgsender $* -noautostartgui -l logSetup
Uninstalling the RGS Sender
Uninstalling the RGS Sender for Windows: To uninstall the Windows Sender use the Windows 2000 or Windows XP Add or
Remove Programs feature from the Control Panel. Select Remote Graphics Sender and click Change/Remove.
Uninstalling the RGS Sender for Linux:
To uninstall the Linux Sender find the name of the RedHat RPM package for the Remote Graphics Sender, by typing:
rpm -q -a | grep -i rgsender
If the Sender is installed on the system, you will see rgsender_linux_32-4.0-0 or something similar. To remove the Sender's rpm package, become root and type:
rpm -e --allmatches rgsender_linux_32
Uninstalling the RGS Sender for HP-UX:
To uninstall the HP-UX Sender, become root and type:
/usr/sbin/swremove -x autoreboot=true rgsender_hpux_pa
21
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. To create unattended installers for the RGS Receiver install the RGS Receiver by creating an installation script with the following commands:
1. First install the RGS Receiver by running the Setup.exe for the RGS Receiver with the /r (record mode) and /f1 ("ef-one", alternative response filename) flags. For example:
Setup.exe /r /f1"C:/TEMP/ReceiverInstall.iss"
This creates the InstallShield response file ReceiverInstall.iss which can be used for unattended installs on other systems.
2. Install the RGS Receiver on other systems using the /s (silent mode) flag and the response file created in the previous step. For example:
Setup.exe /s /f1"C:/TEMP/ReceiverInstall.iss"
Creating an Unattended Sender Installer for Windows
The RGS Sender installer is created using InstallShield and normally requires user interaction when run. To create unattended installers for the RGS Sender install the RGS Sender by creating an installation script with the following commands:
1. Install the RGS Sender by running the Setup.exe for the RGS Sender with the /r (record mode) and /f1 ("ef-one", alternative response filename) flags. For example:
Setup.exe /r /f1"C:/TEMP/SenderInstall.iss"
This creates the InstallShield response file SenderInstall.iss which can be used for unattended installs on other systems.
2. Install the RGS Sender on other systems using the /s (silent mode) flag and the response file created in the previous step. For example:
Setup.exe /s /f1"C:/TEMP/SenderInstall.iss"
22
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. Audio controls in the Receiver Control Panel allow you set the audio volume, quality, and stereo/mono format. Note that audio quality and stereo settings will affect your overall network usage and bandwidth.
The following sections assume the Remote Graphics Software is installed.
Installing Audio on a Receiver for Windows
The Receiver uses the default audio device. If you do not have an audio device installed or if it is currently disabled, the audio controls in the receiver are disabled.
Note: The audio controls in the Receiver Control Panel can be disabled by setting properties in the Receiver if the administrator does not want to allow the user to modify the audio settings.
Installing and Calibrating Audio on a Sender for Windows
Installing Audio on a Sender for Windows
The RGS Sender records from the audio device mixer and sends this information to the receiver. If an audio device is not detected during installation, the HP Remote Audio device will be installed. The HP Remote Audio device has only the mixer available in the recording control panel and the volume level for this line cannot be adjusted. If an audio device is detected during installation, an attempt is made to select the mixer as the recorder input. Due to wide variations in naming and volume levels, it is likely that the mixer line will need to be selected by hand.
To select the mixer as the input line, open the Sounds and Audio Devices control panel. You can find this by opening the Windows Control Panel in the Start menu. The following picture shows an example of a Control Panel with the Audio tab selected.
23
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. To make it visible, click on the Options item in the menu and then click on the Properties item as shown in the following picture.
24
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.
Press the OK button and you should see that the Recording Control window now has the mixer line as one of the controls. Make sure this item is selected and that the volume level is not at the bottom. The following picture shows an example of a selected mixer line.
25
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.
Calibrating Audio on a Sender for Windows
The audio signal captured by the sender is modified by two different device driver volume controls and then the master volume level is artificially inserted into the signal. If these volume controls are too low, you might hear the audio signal. If they are too high, the signal may be distorted. This section describes a technique to hand tune the controls to reduce the amount of distortion. These operations should be performed while connected to the sender through the receiver.
The Wave line of the Volume Control is the first volume control to impact the audio signal outside of the application that generates the signal. Setting this value to the maximum level gives you the most resolution in your audio signal. The following image shows an example of this control at its maximum level.
26
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. Adjust this volume control while playing a sound. At higher levels, the audio signal gets clamped and the signal becomes distorted. Decrease the level until the sound becomes clear. On some devices, the mixer volume control does not go to zero. In this case, the Wave line of the Volume Control will need reduction. The following image demonstrates the Wave Out Mix level needed to eliminate distortion. Note that this is in the Recording Control.
The best sound to play to calibrate your audio device is a low frequency sound with high amplitude. By default, Windows assigns a program event that meets these requirements. To play this sound, open up the Sound and Audio Devices control panel and click on the Sounds tab as shown in the following windows.
27
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. Some media applications modify their audio signal prior to sending it to the audio device. The Windows Media Player may appear to distort some audio files. This is due to signal modification by some kind of enhancement such as an equalizer.
Installing Audio on a Receiver for Linux
If you install audio on a Receiver for Linux the audio component uses the JACK sound server API. JACK is a low late ncy sound server that works in conjunction with the
ALSA sound drivers to mix and direct audio on your system. It runs as a daemon in the background and acts as a “patch bay” for audio connections and applications that use the JACK interface.
For reliable audio support with the Receiver for Linux, the bundled versions of the ALSA sound libraries and JACK Audio Connection Kit software must be built and installed. Versions of ALSA prior to the version provided with the installer may yield unsupportable results. Removal of these previous versions is advised prior to reinstallation of ALSA software.
If multiple audio devices are installed in a system, administrators should identify the target audio system prior to installing the included ALSA software.
28
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. If you cannot become root on your system, ask an administrator for assistance.
Once ALSA and JACK are installed and correctly configured, you are ready to use remote audio with the RGS Receiver for Linux.
Audio Requirements
For reliable audio support with the Receiver for Linux, the bundled version of the JACK Audio Connection Kit software must be built and installed. ALSA sound libraries must be HP-supported or Red Hat Enterprise Linux (release 4 or greater) versions for best results. Manual installation of prior ALSA libraries may yield unpredictable results on older releases of Linux. Do not mix versions of ALSA software.
If multiple audio devices are installed in a system, administrators should identify the target audio system prior to installing the included ALSA 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. If you cannot become root on your system, ask an administrator for assistance.
System Preparation
It is recommended to remove all previously installed versions of JACK before installation. If the RPM package manager was utilized, then the packages are located by:
rpm -qa | grep -i jack
Removal by RPM involves utilizing the above search results with:
rpm -e --nodeps --allmatches {pkg-name}
The install script rgs_audio_support may detect residual directories from previous installations. Respond as prompted during installation.
Customized Installation
The following remote audio installation for Linux process is used when the RGS Receiver is installed (through the ./install.sh script). For those installations that require customization or wish to use other features from the rgs_audio_support script, here are additional details for its use.
The audio support bundle ships as hp_rgs_4_audiosupport.tar.gz. It is accessed by the RGS install.sh script in /opt/hpremote or may be utilized for manual installations / RPM package building.
29
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. It will contain important files such as:
README.txt - basic instructions and file manifest
rgs_audio_support - shell installation script for ALSA/JACK libraries
alsa-*.tar.bz2 - recent validated tar archives from the ALSA project
(provided only for open source requirements and legacy installations) -
http://alsa-project.org
jack-*.tar.gz - recent validated tar archives from the JACK-Audio­Connection-Kit project - http://jackit.sourceforge.net
libsndfile-*.tar.gz - recent validated tar archives from the libsndfile project (JACK dependency) - http://www.mega-nerd.com/libsndfile
The sample installation script, rgs_audio_support, offers three installation scenarios:
1. install - This command unpacks all tar archives into a local build directory in the current directory [ ./localroot ], configures, builds, and installs the required ALSA/JACK libraries appropriate for the host system and active kernel. It is a good choice for local installations or system development. A
system reboot is recommended for best results.
2. remove - This command removes and un-configures an installation provided by the above install command.
3. build_rpms - This command runs an install command first and then attempts to create a compatible set of binary RPMs for installation on matched system configurations. This will greatly reduce the work of enterprise administrators duplicating this install process across multiple nodes. After a successful build, the following files are created:
./RPMS/*.rpms - binary RPMs copied from /usr/src/redhat/RPMS
./RPMS/RGS_audio_install.sh - customized install and configuration
script to associate with RPMs
Note: The build log created by this script is located in /var/log/hpaudio.log Note: The install command does not yield results visible by the RPM package
manager, rpm. The rpm database is not updated nor will inquiries with rpm -q report the installation. Only installations performed with the results of build_rpms
are manageable by the rpm command.
30
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.
31
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.
The RGS shared library, hprgina.dll, enables Single Sign-on. The file hprgina.dll is a GINA (Graphical Identification and Authentication) module that is loaded by the Window's WinLogon.exe process. There are three ways to install and enable RGS Single Sign-on.
1. Install time:
The hprgina.dll can be installed and enabled during the RGS Sender installation. This is the preferred method and is the safest and easiest way to enable RGS Single
Sign-on. The default during installation is to not enable Single Sign-on. The user must answer two questions before Single Sign-on is properly enabled. If enabled, the system must be rebooted before RGS Single Sign-on is operational.
2. Using the rgadmin Tool:
The RGS Rgadmin Tool can be used to enable or disable the hprgina.dll. The rgadmin tool can also be run from the command line with the proper options to
enable or disable the GINA module. This method is preferred over the manual method.
3. Manual Method:
Although this is not the preferred method to enable RGS Single Sign-on, it is here so that administrators will know exactly what parts of the system are modified. To manually enable WinLogon to load the hprgina module, do the following steps in the exact order listed:
1. Install the RGS Sender on the HP Workstation. If the RGS Sender is not installed or installs with errors, DO NOT perform the remaining steps. Doing so puts the system in a state that requires a complete re-installation of the operating system.
2. After the RGS Sender is installed confirm that the hprgina.dll exists in the
C:\WINDOWS\system32 directory. The RGS Sender installer copies hprgina.dll into the system32 directory directly. If it does not exist, DO
NOT perform the remaining steps. Doing so puts the system in a state that requires a complete re-installation of the operating system.
3. Add the GinaDLL registry key if it does not already exist. This can be done through the use of regedit, the Windows Registry Editor. Create the key as type REG_SZ (a string type). The full path of the key is
32
Getting Started with Remote Graphics Software
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Winlogon\GinaDll
4. Set the value of the GinaDll key to the text "hprgina.dll". Confirm the spelling before closing.
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 "HprSso". Confirm the spelling before closing.
7. Restart the system. The hprgina.dll will be loaded by WinLogon when started.
WARNING: If the hprgina.dll does not exist in C:\WINDOWS\system32, do
not perform steps three and four. Doing so puts the system in a state that requires a complete re-installation of the operating system.
If the GinaDLL key does not currently exist in the registry then Microsoft's default GINA DLL (msgina.dll) is currently loaded by WinLogon. Adding the GinaDLL registry key and setting its value to hprgina.dll tells WinLogon to load the hprgina.dll instead of the default msgina.dll.
If the GinaDllMode key does not exist in the registry, or if the key does not contain the text "HprSso", then RGS Single Sign-on will be enabled by default.
Setting the Local Security Policy
The local security policy "Interactive logon: Do not require CTRL-ALT-DEL" must be disabled to support Single Sign-on. This can be set in the Windows "Local Security
Settings" under "Security Options." The RGS Diagnostic Tool programmatically detects if this local security policy is set correctly. See the RGS Diagnostic Tool section for more information.
Note: Creating the GinaDLL registry key disables Window's "Fast User Switching" and
"Welcome Screen" features.
Uninstalling and Disabling Single Sign-on
There are two methods used to disable Single Sign-on:
1. Using the rgadmin Tool:
The RGS Rgadmin Tool contains command-line options to disable RGS Single Sign­on. This method is preferred over the manual method.
2. Manual Method:
33
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. The GinaDLL key:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Winlogon\GinaDll
is removed through the use of regedit, the Windows Registry Editor. Be certain to actually remove the key by selecting the GinaDLL key in regedit and select the Delete entry in the Edit menu. Once the key is deleted, it no longer shows up as a key in the WinLogon subkey. When the system reboots, the default GINA module, msgina.dll, will be loaded by the WinLogon.exe process.
If there is a custom GINA DLL module on the system and it replaces the default msgina.dll, change the value of the GinaDLL value from hprgina.dll to the name
of the custom GINA module. To change the value of the GinaDLL key, select the 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. When the system reboots the custom GINA module is loaded by the WinLogon.exe process.
WARNING: If the value of the GinaDLL key contains the name of a custom GINA DLL,
and the file does not exist in C:\WINDOWS\system32, the system will not start correctly upon the next reboot. The system will then require a complete re-
installation of the operating system.
34
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.
The RGS shared library, hprgina.dll, enables Easy Login. The file hprgina.dll is a GINA (Graphical Identification and Authentication) module that is loaded by the Window's WinLogon.exe process. There are three ways to install and enable RGS Easy Login.
1. Install time:
The hprgina.dll can be installed and enabled during the RGS Sender installation. This is the preferred method and is the safest and easiest way to enable RGS Easy
Login. The default during installation is to not enable Easy Login. The user must answer two questions before Easy Login is properly enabled. If enabled, the system must be rebooted before RGS Easy Login is operational.
2. Using the rgadmin Tool:
The RGS Rgadmin Tool can be used to enable or disable the hprgina.dll. The rgadmin tool can also be run from the command line with the proper options to
enable or disable the GINA module. This method is preferred over the manual method.
3. Manual Method:
Although this is not the preferred method to enable RGS Easy Login, it is here so that administrators will know exactly what parts of the system are modified. To manually enable WinLogon to load the hprgina module, do the following steps in the exact order listed:
1. Install the RGS Sender on the HP Blade Workstation. If the RGS Sender is not installed or installs with errors, DO NOT perform the remaining steps. Doing so puts the system in a state that requires a complete re-installation of the operating system.
2. After the RGS Sender is installed confirm that the hprgina.dll exists in the
C:\WINDOWS\system32 directory. The RGS Sender installer copies hprgina.dll into the system32 directory directly. If it does not exist, DO NOT
perform the remaining steps. Doing so puts the system in a state that requires a complete re-installation of the operating system.
3. Add the GinaDLL registry key if it does not already exist. This can be done through the use of regedit, the Windows Registry Editor. Create the key as type REG_SZ (a string type). The full path of the key is
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Winlogon\GinaDll
35
HP Remote Graphics 4.2.0 User's Guide
4. Set the value of the GinaDll key to the text "hprgina.dll". Confirm the spelling before closing.
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.
7. Restart the system. The hprgina.dll will be loaded by WinLogon when started.
WARNING: If the hprgina.dll does not exist in C:\WINDOWS\system32, do
not perform steps three, four and five. Doing so puts the system in a state that requires a complete re-installation of the operating system.
If the GinaDLL key does not currently exist in the registry then Microsoft's default GINA DLL (msgina.dll) is currently loaded by WinLogon. Adding the GinaDLL registry key and setting its value to hprgina.dll tells WinLogon to load the hprgina.dll instead of the default msgina.dll.
The hprgina module is a chaining GINA DLL. When the RGS hprgina.dll is loaded by WinLogon, the hprgina module then loads the msgina.dll shared library. The hprgina module chains (forwards) all GINA requests to the msgina.dll module.
Chaining custom GINA modules
If it is discovered in step #3 above that the GinaDLL registry key does exist, and the value of the key is not msgina.dll, then a custom GINA module is currently loaded and being used by WinLogon. Custom GINA modules provide custom authentication dialogs or even custom user authentication methods. If it is determined that functionality of both the RGS Easy Login and a custom GINA module is necessary, then the hprgina.dll needs further configuration. The hprgina.dll module needs to be setup to load the custom GINA module rather than the default msgina.dll as described above.
To enable the hprgina module to load a custom GINA module, create a new registry key, ChainedGinaDLL, on the system with the value of the key containing the name of the chained custom GINA module. Do steps #1 through #4 shown above (the reboot will be done below) plus the following steps to chain custom modules:
1. Create the ChainedGinaDLL registry key. Create the key as type REG_SZ (a string type). The full path of the key is:
HKEY_LOCAL_MACHINE\Software\Hewlett-Packard\Remote Graphics Sender\ChainedGinaDLL
2. Set the value of the new ChainedGinaDLL key to the name of the custom GINA module. For instance, if the name of the custom GINA module is
foogina.dll, then the value of the key is foogina.dll. The value should
36
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.
If the custom foogina.dll is also a chaining GINA module, foogina, in turn, chains itself to the msgina module. Three GINA DLLs will be loaded as part of the WinLogon.exe process: 1) hprgina.dll, 2) foogina.dll, and 3) msgina.dll.
Setting the Local Security Policy
The local security policy "Interactive logon: Do not require CTRL-ALT-DEL" must be disabled to support Easy Login. This can be set in the Windows "Local Security
Settings" under "Security Options." The RGS Diagnostic Tool programmatically detects if this local security policy is set correctly. See the RGS Diagnostic Tool section for more information.
Note: Creating the GinaDLL registry key disables Window's "Fast User Switching" and
"Welcome Screen" features.
Uninstalling and Disabling Easy Login
There are two methods used to disable RGS Easy Login.
1. Using rgadmin Tool:
The RGS Rgadmin Tool contains command-line options to disable RGS Easy Login. This method is preferred over the manual method.
2. Manual Method:
To disable Easy Login 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 Easy Login. The GinaDLL key:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Winlogon\GinaDll
is removed through the use of regedit, the Windows Registry Editor. Be certain to actually remove the key by selecting the GinaDLL key in regedit and select the Delete entry in the Edit menu. Once the key is deleted, it no longer shows up as a key in the WinLogon subkey. When the system reboots, the default GINA module, msgina.dll, will be loaded by the WinLogon.exe process.
If there is a custom GINA DLL module on the system and it replaces the default msgina.dll, change the value of the GinaDLL value from hprgina.dll to the name of the custom GINA module. To change the value of the GinaDLL key, select the
37
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. When the system reboots the custom GINA module is loaded by the WinLogon.exe process.
WARNING: If the value of the GinaDLL key contains the name of a custom GINA DLL,
and the file does not exist in C:\WINDOWS\system32, the system will not start correctly upon the next reboot. The system will then require a complete re-
installation of the operating system.
38
Getting Started with Remote Graphics Software
Installing the Enterprise Service SDK
The RGS Enterprise Service SDK can be easily installed by following the directions below. The Enterprise Service SDK is meant to be installed by IT administrators and is not normally installed by end-users. The SDK is a Software Development Kit that can be used to implement a RGS Enterprise Service. A sample implementation is delivered with the SDK.
Installing the Enterprise Service SDK on Windows
To begin the installation, log in to an account with administrator privileges:
1. Insert the HP Remote Graphics Software CD and in Window's Explorer change to the directory win32\enterprise-service on your CD-ROM drive.
2. Double-click or select Setup.exe to start the installer.
3. Follow the instructions on the screen.
The installer will add a menu item to the HP Remote Graphics Programs folder called Start Enterprise Service.
Note: The Enterprise Service is a Python program and requires Python Version 2.4
for proper operation. 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. Refer to the Installing the Receiver section to install the RGS Receiver. To use the Enterprise Service, refer to the Using the Enterprise Service section.
39
HP Remote Graphics 4.2.0 User's Guide
Enabling OpenGL Applications
HP Remote Graphics Software supports remote viewing of 3D applications. The OpenGL 3D API is supported on all sender platforms. The HP-UX Sender supports all HP-UX 3D APIs.
Enabling OpenGL Applications on Windows
Automatically Enabling 3D Updates from OpenGL Applications:
HP Remote Graphics Software will automatically receive updates from 3D OpenGL applications. Automatic 3D updates are enabled by default during RGS Sender installation. On a Windows’s 64-bit OS (XP Professional x64 Edition), automatic 3D updates are enabled for 32-bit and 64-bit OpenGL applications. Previous versions of HP Remote Graphics Software required a library called OpenGL32.dll to be manually placed into the OpenGL application directory to obtain 3D updates. This file should be removed from the OpenGL application directory to obtain maximum performance. Do not remove the OpenGL32.dll library from the system directory ("C:\WINDOWS\system32").
Manually Enabling 3D Updates from OpenGL Applications:
If automatic updates are disabled through the RGS Admin Tool, 3D updates will only be received from OpenGL applications that have the HP Remote Graphics Software OpenGL32.dll library manually copied into the OpenGL application directory. For
example, suppose you want to enable remote viewing for the 3D OpenGL application "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.
On a Window's 64-bit OS (XP Professional x64 Edition) system, there are two RGS OpenGL32.dll libraries - a 32-bit library and a 64-bit library. They are both named
OpenGL32.dll and are use to enable viewing of OpenGL 32-bit or 64-bit applications. The libraries are located in the RGS Sender install directory "C:\Program Files\Hewlett-Packard\Remote Graphics Sender\OpenGL\32-bit" and "C:\Program Files\Hewlett-Packard\Remote Graphics Sender\OpenGL\64- bit". For remote viewing of 32-bit OpenGL applications running on a 64-bit OS, use the instructions above. For remote viewing of 64-bit OpenGL applications, the 64-bit RGS OpenGL32.dll must be manually copied to the same directory as the 64-bit OpenGL application executable.
Enabling OpenGL Applications on Linux
There are two supported methods to enable remote viewing of OpenGL applications on Linux. The first, and preferred method, requires an nVidia graphics device present on the system. The second method requires the use of the LD_PRELOAD environment variable.
40
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.
2. LD_PRELOAD method: The LD_PRELOAD method is used for systems that do not have nVidia graphics installed. Set the LD_PRELOAD environment variable as follows:
$ export LD_PRELOAD=/opt/hpremote/lib/librgopengl.so
Once the LD_PRELOAD variable is properly set, any OpenGL application can be started. The application should then properly display in a Remote Graphics
Software environment. To automate the setting of the environment variable, the variable can be set in the users .profile. For example, for those using bash, add the following to the system or users .bash_profile:
$ export LD_PRELOAD=/opt/hpremote/lib/librgopengl.so
Adding this to the .profile will enable remote viewing of 3D OpenGL screensavers.
Enabling OpenGL, PHIGS, PEX and Starbase Applications on HP-UX
OpenGL, PHIGS, PEX, and Starbase applications are automatically setup for remote access within an HP Remote Graphics Software environment. No extra setup steps are necessary. All that is required is that the proper X server and OpenGL libraries to be installed on the system.
41
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.
Versions of the Direct3D API other than 8.0 and 9.0 are not supported. If automatic updates are disabled using the RGS Admin Tool, updates from all Direct3D applications will be unavailable.
42
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. Remote Display Window: The window that displays the desktop of the remote computer.
3. Remote Display Window Toolbar: A toolbar that is displayed at the top of the Remote Display Window that provides status information and has several controls.
Modes of operation
There are three modes of operation for the Receiver - Normal Mode, Directory Mode, and Enterprise Service Mode.
1. Normal Mode: Enables a user to connect to a system by specifying the
hostname or IP address in the Receiver Control Panel:
On Windows, to start the HP Remote Graphics Software Receiver from the Start menu, select Start -> HP Remote Graphics -> Receiver
On Linux or HP-UX, execute
/opt/hpremote/rgreceiver/rgreceiver.sh
2. Directory Mode: Enables a user to automatically open connections to several systems based on the systems assigned to each user. These assignments are saved in the RGS directory file on a shared file server or network mapped drive. This file is normally created and maintained by the system administrator or an IT support engineer.
On Windows, to start the HP Remote Graphics Software Receiver ­directory version from the Start menu, select:
Start -> HP Remote Graphics -> Receiver -directory
On Linux or HP-UX, type:
/opt/hpremote/rgreceiver/rgreceiver.sh -directory [file]
where the optional "file" is the path to the directory file. If the file path is not entered, then the user can enter the directory file through the use
of the "Set Directory File" button on the user interface.
43
HP Remote Graphics 4.2.0 User's Guide
3. Enterprise Service Mode: Is similar to Directory Mode, but rather than looking up the systems assigned to a user in a file, they are looked up using the RGS Enterprise Service. The RGS Enterprise Service is a network service that is accessible over a standard computer network. Before the rgreceiver is started in Enterprise Service Mode, the Enterprise Service must be installed and running on the network and visible to the Receiver. After the 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 [service2 ... serviceN]
where "service1" is either the hostname or ipaddress of the system that the Enterprise Service is running on. Multiple hostnames or ipaddresses can be entered, each separated by white space.
44
Opening and Closing Connections
Using Remote Graphics Software
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. Press Enter or select the Connect buttonto connect. The selector on the right side of the text box displays a history of previously connected systems that can be selected.
Close a connection: To close a connection, select the Disconnect button.
Authentication during a connection: When the Receiver connects to a Sender
the user must be authenticated and authorized. The Receiver displays authentication dialogs where the user enters their credentials, such as username and password. If the Sender validates the credentials and the user is authorized, then the connection is established.
Enable Setup Mode: Select the Setup Mode button to configure the local
Remote Display Window. In Setup Mode, the Receiver suspends mouse and keyboard input to the remote system. This allows the user to move or resize the Remote Window Display Window. The Remote Display Window should also dim when Setup Mode is enabled. See Setup Mode and Hotkeys for more information.
Display Help: Click Help to display the online help. The online help is displayed separately in a WEB browser, such as Internet Explorer or Mozilla.
Display Program Information: Select the About button to display program and copyright information.
45
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.” The status bar can be useful in diagnosing connection problems because it displays the general reason for the failure, for example, “Authorization Failed”, “Authentication Failed”, and more.
46
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.
The Remote Display Window Toolbar.
General Options:
Prompt for username and password under specific scenarios this option enables
or disables prompting the user for domain, username and password credentials for each connection. When deselected, the current domain user credentials are sent to
47
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. Note: If Easy Login is installed on the Sender system, the user is sometimes not prompted for the connection.
Enable global image updates updates selects a different image update algorithm. When enabled, the Remote Display Window updates with all accumulated Sender updates as a single operation (commonly referred to as a BLockTransfer, or BLT). When disabled, the Remote Display Window updates with each intermediate change sent rather than accumulating results. The tradeoff is time versus quality. Global image updates reduces artifacts such as image tearing but sometimes at a higher data transfer cost (especially for large display resolutions).
Select help browser allows the user to specify a Web browser, such as mozilla, to display online help. This option is not available on Windows because the default Web Browser is automatically read from the Windows Registry.
Audio Options:
48
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. When unchecked, the Receiver combines the audio from all active connections into a single stream.
The Stereo checkbox enables or disables stereo audio. Stereo audio sends independent audio streams for the left and right channels. Stereo mode requires greater network bandwidth.
The Quality box allows the user to select one of three different audio quality settings:
Low specifies a sampling rate of 11 KHz.
Medium specifies a sampling rate of 22 KHz.
49
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.
USB Options:
Remote USB is only supported on a HP Blade Workstation Client and a HP Blade Workstation sender. See System Requirements for further details.
HP Remote Graphics Software supports a Remote USB capability. This allows a user to connect any number of USB devices to a local RGS Receiver system and have the devices appear connected to the RGS Sender system.
The toggle button labeled Enable Remote USB selectively enables or disables Remote USB capability. When enabled, USB devices plugged into the local system appear to the remote system as locally attached devices. Remote USB can dynamically enable or disable USB connections while connected to a Sender system. Remote USB supports hotplug events, so it is not necessary to disable Remote USB before plugging or unplugging USB devices.
50
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.
NOTE: In Directory Mode or Enterprise Service Mode, Remote USB requires selection
of one Sender system before connecting to any systems. Remote USB can only be enabled to one Sender at a time. During an active connection, if users want to change their Remote USB devices to another Sender system, they must
1. disconnect all systems using the "Disconnect All" button
2. use the "Select sender" box to select a new Remote USB system
3. reconnect to their remote systems using the "Connect All" button.
During device discovery, the new sender system will report the USB connection as a hotplug event for the Remote USB devices.
Network Options:
51
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. If network connectivity is restored before reaching the error timeout, the warning notification disappears and the user can continue often without interruption.
Dialog: Specifies the timeout in seconds used to display and wait for input dialog responses from input, such as the authorization or PAM authentication dialogs.
The Receiver must be disconnected from all Senders to change timeouts. See Using Timeouts for a detailed discussion on setting timeouts.
52
Hotkeys Options:
Using Remote Graphics Software
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. With this option checked, the Receiver recognizes Ctrl­Alt-End as a signal to send a Ctrl-Alt-Delete sequence directly to the Sender. The Ctrl-Alt-Delete sequence is also available via the Remote Display Window Toolbar.
Send First Key: The Receiver filters keystrokes and does not send hotkey sequences to the Sender. For example, the default setup mode hotkey consists of a shift press, space press, and space release. When the Receiver sees a shift key press, the event does not pass immediately through to the Sender. The Receiver holds the event to determine if the next keystroke forms a hotkey sequence. If the next key pressed is not space, the Receiver immediately forwards all events to the Sender.
53
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. If you need access to your local desktop or Receiver, use the Setup Mode Hotkey to expose them. See Setup Mode documentation for more information on other options available in Setup Mode.
By default, to access Setup Mode:
Press and hold down the Shift key.
At the same time, press then release the space bar to activate Setup
Mode.
You will remain in Setup Mode until you release the Shift key.
Pressing the Set button on the GUI begins redefinition of the Setup Mode Hotkey sequence. Typing any combinations of Ctrl, Alt, Shift, and Space defines a new sequence. Every sequence must begin with Ctrl, Alt, or Shift, and the first key pressed remains held down through the entire sequence. When the first key is released, the sequence is considered complete. When activating Setup Mode via this hotkey, it remains active until release of the first key in the sequence. Pressing the Reset button on the GUI restores the Setup Mode Hotkey sequence to its original default values.
When defining a hotkey sequence via the GUI, the sequence becomes left-side and right-side sensitive when multiple keys exist. For example, left-side shift key strokes differ from right-side shift key strokes. To define a sequence that is side insensitive, you must modify the property value from outside of the GUI while RGS is not running. See the Hotkeys Properties documentation for information on modifying the sequence from outside of the GUI.
Hotkey definitions are formed by strings of comma-separated word pairs. The first word represents the key while the second represents a specific action for that key. Each pair represents an event token. For example, the default Setup Mode Hotkey sequence is defined by:
Shift Down, Space Down, Space Up
The valid words for the keys are:
LCtrl, RCtrl, Ctrl: Specifies a left, right or side insensitive ctrl key, respectively.
LAlt, RAlt, Alt: Specifies a left, right or side insensitive alt key, respectively.
LShift, RShift, Shift: Specifies a left, right or side insensitive shift key, respectively.
Space: To specify a space key.
The valid words for the actions are:
Down: Specifies a key press.
54
Up: Specifies a key release.
Logging Options:
Using Remote Graphics Software
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.
Log level: determines the type and amount of information logged.
Clear Log: clears the contents of the log file.
View Log: displays the contents of the log file in a window.
Restore Defaults: resets all logging settings to default values.
55
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.
Copy rectangles per second: The combined number of copy updates per second received from all connections.
Remote Display Window Toolbar:
The Remote Display Window toolbar contains controls and information for the session. The toolbar is made visible by entering Setup Mode (using the key
56
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. Some key-sequences, such as Ctrl-Alt-Del, are trapped by the local system and therefore do not forward to the remote system using normal
methods. The user cannot send a Ctrl-Alt-Del key sequence using a keyboard on the Receiver. The Ctrl-Alt-Del button in the toolbar sends this key sequence to the Sender.
Borders button: adds or removes window borders and decorations to the Remote Display Window.
Snap button: when selected, this option causes the Remote Display Window to snap to the edges of the screen whenever the boundaries of the window are within 10 pixels of the edge of the screen.
Image quality slider: sets the compression level. Higher settings require greater bandwidth.
Network bandwidth: displays the current network bandwidth received by this session.
Image update rate: displays the number of image updates per second received by this session.
57
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.
When Setup Mode is active, the Receiver captures and interprets all keystrokes and mouse events on your local computer. No mouse or keyboard events pass to the Sender.
In Setup Mode, you can:
Easily move and resize Remote Display Windows - Use the left mouse button in any Remote Display Window to drag or resize the window on the desktop.
Show the Receiver Control Panel - Press M to show the control panel.
Show or hide the Receiver Toolbar - Press H to show or hide the toolbar.
Activate the Remote Display Window selection dialog – Press TAB to display
the dialog
The Remote Display Window selection dialog allows the user to quickly navigate between multiple active connections. The dialog displays a thumbnail representing each Remote Display Window. Display the dialog by pressing TAB while in Setup Mode. The dialog remains active while the initial Setup Mode hotkey is depressed. Releasing the initial Setup Mode key closes the selection dialog and switches focus to the selected Remote Display Window.
The currently selected Remote Display Window is highlighted with a red
border. While the Remote Display Window selection dialog is active, navigate between
windows by:
Pressing TAB to select the next window.
Pressing the numeric key displayed beneath the thumbnail.
Clicking the mouse on a thumbnail.
Double clicking the mouse on a thumbnail (this will also immediately
close the selection dialog).
To directly switch to a window without activating the selection dialog, simply press the number that corresponds to the identifier of the window (the same identifier displayed in the dialog).
58
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. The directory file may contain multiple users with a list of Senders assigned to each user.
The first time the Receiver starts in Directory Mode, if the command line (­directory "filename") specifies a filename the Receiver will use that file as the directory. If no file name is specified, the user is prompted to select the location and name of the directory file.
After the location of the directory file is set, the Receiver automatically connects to the Senders assigned to the user specified in the file. The locations of the directory file can be reset using the Receiver control panel.
59
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. The directory file can manage and administer the assignment of systems for any number of users. This file is specified as a normal
ASCII text file as follows:
domainName userName1 sender1 sender2 ... senderN domainName userName2 sender1 sender2 ... senderN
For example, the following text specifies the directory for the users Sally and Joe.
Domain1 sally sender1 sender2 sender3 Domain1 joe sender4 sender5 sender6
In this example:
Sally is assigned sender1, sender2, and sender3
Joe is assigned sender4, sender5, sender6
If the domain name, user name, or sender name contains white-space characters, then the name can be enclosed in double-quotes as follows:
"domain 1" "sally user" "sender 1" "sender 2" "sender 3" "domain 1" "joe user" "sender 4" "sender 5" "sender 6"
When using the directory file for users on either Linux or HP-UX systems, the "domain name" does not apply. Simply use the keyword "UNIX" in place of the domain name. For example:
UNIX sally sender1 sender2 sender3
Save the directory file on a readily accessible network file share or mapped drive so that each Receiver can read the file at start-up.
60
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. For optimal viewing the display resolution of the Sender and Receiver should be set to the same values. If the resolution of the display connected to the local system is less than display resolution of the remote system, the image will be cropped by the local display.
61
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. A service can support dynamic and complex business logic for system assignment.
Users authenticate against the Enterprise Service.
The Receiver can also read and write the user's properties.
The Enterprise Service comes as a Software Development Kit (SDK). Developers use the SDK to adapt and customize their required enterprise solution. Consequently, the ES SDK does not directly implement the specific functionality required for assigning and looking up user systems and settings. For example, the SDK does not provide ready-to-use Active Directory or LDAP integration itself. The SDK provides the ICE interfaces and a sample implementation written in Python. ICE (Internet Communications Engine - see http://www.zeroc.com/ice.html) is a modern alternative to object middleware such as CORBA™ or COM/DCOM/COM+, with support for C++, Java, Python, PHP, C# and Visual Basic.
The sample implementation demonstrates a simple XML file as the enterprise directory. Associated with the XML is a DTD that specifies a precise and legal set of XML elements and attributes that represent syntax to specify the user to machine mappings as well as the user RGS Properties. This sample implementation can be used to test the Enterprise Service and become familiar with its capabilities. Simply add a set of test users and user settings to the XML file, start the Enterprise Service, and connect to RGS Senders from a RGS Receiver using the service. After the sample is working, the job of creating an implementation that interacts with a customers enterprise directory can begin.
To learn more about the SDK, review the README.txt file in the ES installation. It explains the purpose and usage of each file in the installation.
Starting the RGS Receiver in Enterprise Service mode
When the RGS Receiver starts in Enterprise Service Mode using the command line option -esdir, the Receiver connects to the Enterprise Service. The user will then authenticate with the ES.
After the user authenticates, the Receier reads from the Enterprise Service a list of systems assigned to the user and specified by hostname or ipadress. The Receiver will try to connect to the specified systems.
If the command line option also specifies option -esdirsettings, the Receiver gets the properties that the Receiver should use from the ES. The properties specify
62
Using Remote Graphics Software
settings such as the location of each Remote Display Window on the local desktop, codec quality settings, audio settings, and others. See Properties for more details.
If the command line options -esdirsettings is not specified, then the users settings are read from the local system. When the Receiver closes, the users settings are saved, either locally or remotely in the Enterprise Service, depending on the
specification of the command line option -esdirsettings. When a connection to each of the RGS Senders is initiated, the credentials gathered
during the ES authentication are used to authenticate the connection. If "Prompt for username and password" is enabled in the Receiver Control Panel, then the credentials used to authenticate with the ES are not used and the user is prompted to enter credentials for each connection.
Organizing Displays in Enterprise Service Mode
Refer to "Organizing Displays in Directory Mode" section.
Starting the Enterprise Service
To run the sample Enterprise Service, the system must have Python 2.4 installed. 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
Configuring the Enterprise Service
As mentioned before, the current SDK provides a sample implementation using a simple XML file as an enterprise directory. This is only a sample to learn how the Enterprise Service operates. It is up to the customer to implement the ES interfaces, by providing an implementation that communicates with their enterprise infrastructure.
The README.txt file in the ES installation can help learn how to use the SDK. The current ES is written in the Python language. Python is an interpreted object-oriented (OO) language well suited for this problem and readily available on a wide variety of platforms. All of the Python code is human readable and can be used to understand the workings of the ES.
63
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. By right clicking on the icon, the user can display the Sender GUI
and select one of the following options:
"Remote Keyboard/Mouse --> Enable or Disable" - If "Disable" is selected, all non-primary users are in "view-only" mode. Only the primary user, the user that is logged into the desktop, will control the remote desktop remotely using the Receiver. If "Enable" is selected, all users connected to the Sender can interact with the remote desktop. All keyboard and mouse activity will be injected into the Sender allowing non-primary users control of the remote desktop.
"Disconnect --> Non-Primary Users or All Users" – disconnects receiver sessions for either non-primary users or all users.
"Help" displays the Remote Graphics Help system.
"About" displays Remote Graphics program information.
Manually Starting & Stopping the Sender
By default the Sender installs as a Windows Service and configures to automatically start on system startup. The user can control Windows Services by accessing the "Services" panel. The "Services" panel can be accessed from the Windows "Control Panel" and selecting "Administrative Tools".
The following diagram shows the Administrative Tool for Services. The Remote Graphics Sender is highlighted. The status of the service is "started" and the service is configured to startup automatically. By right clicking on the Sender, the service can be stopped, started, or resumed. Additionally, the properties of the service can be controlled such as the start-up type, and the recovery mode.
64
Controlling Settings on Linux and HP-UX
Using Remote Graphics Software
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 --> Enable or Disable" - If "Disable" is selected, all non-primary (A user of a RGS connection that does not match
the user logged into the desktop of the remote computer. If no one is logged into the desktop of the remote computer, then all connections are non­primary.) users are in "view-only" mode. Only the primary user, the user that
is logged into the desktop, will control the remote desktop remotely using the Receiver. If "Enable" is selected, all users connected to the Sender can
interact with the remote desktop. All keyboard and mouse activity will be injected into the Sender allowing non-primary users control of the remote desktop.
"Disconnect --> Non-primary Users or All Users" – disconnects receiver sessions for either non-primary users or all users.
"Help" displays the Remote Graphics Help system.
"About" displays Remote Graphics program information.
It is possible to disable the GUI from automatically starting. See Installing the Sender for more details.
Starting & Stopping
65
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 each X server.
If the Sender process is stopped or killed, the X server will attempt to restart the Sender. When the X server is shutdown, the Sender will also stop running. If the X server is recycled, the Sender process is stopped and a new Sender is started.
If for some reason the X server cannot start, and a Sender process is running, killing the Sender will allow the X server to restart.
66
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. In some cases, the Windows operating system scheduling algorithms do not give the RGS Sender sufficient CPU time to maintain smooth interactivity. Erratic updates from a Windows Sender can sometimes result from a process load and scheduling situation. (Networking performance can also contribute to poor interactivity.)
RGS Sender for Windows on some laptops has exhibited erratic behavior. Increasing the Sender priority to high usually improves interactivity in this case. This enables the Sender more frequent access to the CPU and improve updates to the Receiver.
Process priority for the Sender is command-line accessible for the Windows Sender. Four command-line options are available: -belownormal, -normal, -abovenormal, or -high. Priorities low and realtime cannot be selected for the Windows Sender. Please see Command Line Options for further information.
Currently, there are two ways of setting the process priority for a Windows Sender:
using regedit to modify the rgsender service start up parameters in the Windows Registry
using HP Performance Tuning Framework (PTF) to configure Windows Sender priority (available only on HP Workstations)
Both methods are covered below.
WARNING: Adjusting the process priority of the sender to a level higher than -
normal can cause other normally privileged processes to get fewer CPU cycles than usual. Please adjust the priority of the sender with caution.
Setting the Sender process priority using regedit
This section describes how to use the Windows regedit command to increase the process priority of the Sender service when it starts. Under normal operation the
Windows Sender runs as a Windows Service. When the system starts up, the installed services are usually started. When the RGS Sender is installed an entry is added in the Windows Registry for the Remote Graphics Sender service. regedit can be used to modify the command line that is used for starting the Sender service:
1. Start regedit - this can be done by opening a Windows command prompt and executing the command “regedit” or using the "run" command line from
the Start menu
2. Using regedit navigate to the key
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\rgsender
67
HP Remote Graphics 4.2.0 User's Guide
3. Add the desired process priority command-line option for starting the Remote 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.
Regedit should look like this prior to making any changes.
Double-clicking on the “ImagePath” key should bring up the following dialog which allows the user to edit the value. The screen-shot shows the “-high” option already added.
After the changes are made the registry should look like this
68
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. PTF is available for HP Workstations only from this location:
http://www.hp.com/workstations/software/framework/index.html
Please see the PTF help and documentation for further information.
69
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. A non-primary connection is defined as any connection to the Sender with a login other than the primary. Within the collaboration notification dialog, primary and non-primary users are identified using different fonts. Primary users are italicized and listed first. Non-primary usernames follow and are displayed using a normal font. The example screen-shot above shows two connections are active, one a primary user and the other a non-primary. A small button with an “X” is displayed next to all non-primary usernames. Pressing this button disconnects the corresponding non-primary user. All non-primary users may be disconnected with a single command using the Sender GUI as described in Controlling Sender Settings.
When the collaboration notification dialog is displayed, it indicates that there are multiple connections to the remote desktop. The collaboration notification dialog cannot be dismissed. It is possible to move the dialog within the boundaries of the desktop by clicking anywhere within the dialog and dragging it. The Sender removes the dialog when all non-primary connections terminate.
70
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 ... servN [-esdirsettings]]] [-nosplash] [-v | -ver | -version] [-h | -help | -?]
-directory [file] starts the Receiver in -directory mode. If the optional "file" file path is specified, then the file is opened and used to lookup systems assigned to the user. If the "file" is not specified, the user is prompted to enter a path to the directory file. See Starting the Receiver in Directory Mode for more details.
-esdir serv1 [serv2 … servN] starts the Receiver in enterprise service mode using service 1 and service 2 through service N where serv1, serv2, and servN are the hostnames or ipaddresses of the enterprise service. Setting the –esdir option allows the Remote Graphics Software Receiver to lookup the systems assigned to the user using a RGS Enterprise Service. See Using The Enterprise Service for more details.
-esdirsettings enables the Receiver to get and set the Receiver settings from the enterprise service. If this option is used, -esdir must also be set.
-nosplash disables display of the splash screen when the Receiver starts. [-v | -ver | -version] prints the Receiver's version information. [-h | -help | -?] prints a listing of the various command line options, those that are
listed on this page.
RGS Sender Command Line Options
The Windows Sender (rgsender.exe) or the Linux/HP-UX Sender (rgsender.sh) command line options are:
[-nocollab] [-timeout value] [-authtimeout value] [-l logSetupFile] [-v | -ver | -version]
71
HP Remote Graphics 4.2.0 User's Guide
[-h | -help | -?] [-installService | -startService | -uninstallService] [-belownormal | -normal | -abovenormal | -high] [-noautostartgui] [-display value]
Under normal operation the Windows Sender runs as a Windows Service. When the system starts up, the installed services are usually started. When the RGS Sender is installed an entry is added in the Windows Registry for the Remote Graphics Sender service. regedit can be used to modify the command line that is used for starting the Sender service:
1. Start regedit - this can be done by opening a Windows command prompt and executing the command “regedit” or using the "run" command line from
the Start menu
2. Using regedit navigate to the key
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\rgsender
3. Add the desired process priority command-line option for starting the Remote 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.
On HP-UX and Linux the Sender is started by the X Server. The file rgsender.sh can be edited to set the command line options.
Platform independent command line options
The following options are available on all platforms.
-nocollab Disables collaboration. When specified, only the primary user can connect to the Sender.
-timeout valueThe timeout in milliseconds used to detect and disconnect an inactive connection. This option sets the property “Rgsender.Network.Timeout.Error.” See Using Timeouts for more details.
-authtimeout valueThe timeout in milliseconds used to detect and notify the user of a network disruption. This option sets the property “Rgsender.Network.Timeout.Dialog.” See Using Timeouts for more details.
-l logSetupFile Specifies the "logSetupFile" file used to describe various logging parameters for Sender's error and informational output. Use this file to determine where the output goes (to a file or to standard error) as well as the type of output logged (INFO or DEBUG). At installation, the Sender default is with "-l logSetup"
72
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.
Windows specific command line options
The following options are only available on Windows.
-installService Installs the “Remote Graphics Sender” service.
-startService Starts the “Remote Graphics Sender” service. The Sender must be
installed as a service first.
-uninstallService Uninstalls the “Remote Graphics Sender” service.
-belownormal Sets the process priority of the Sender to below normal.
-normal Sets the process priority of the Sender to normal. This is the default
priority.
-abovenormal Sets the process priority of the Sender to above normal.
-high Sets the process priority of the Sender to high.
Linux/HP-UX specific command line options
The following options are only available on Linux and HP-UX.
-noautostartgui The RGS Sender GUI automatically starts on Linux when the Sender process starts. To start the GUI on a per-user basis, edit the /opt/hpremote/rgsender/rgsender.sh file, and add the -noautostartgui option. Refer to the Linux Sender GUI Installation or HP-UX Sender GUI Installation sections for more information.
-display value where value is the display number of the X server that the RGS Sender will share. For example, if both X servers hostname:0 and hostname:1 are running, use -display 1 to share the X server running at display hostname:1.
73
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.
Properties are set in a configuration file, on the command line, or using the RGS Enterprise Service. Properties specified on the command line override properties set in a configuration file or RGS Enterprise Service.
Syntax
Properties are name/value pairs and can contain any non whitespace characters except "=" and "#". The property name and property value are separated by an "=". For example:
Rgreceiver.Network.Timeout.Warning=10
The name of this property is Rgreceiver.Network.Timeout.Warning, and the value of the property is 10.
All RGS Receiver properties begin with "Rgreceiver". All RGS Sender properties begin with "Rgsender". Property values cannot contain the "=" or "#" characters.
Properties can contain values of the following types: string, int, bool, string vector and int vector. Properties of type bool are set to either "1" or "0" ­representing true or false.
Any property set to an empty value,
Rgreceiver.Browser.Name=
initializes as follows: if the value of the property is of type STRING, the value will be set to an empty string. If the value of the property is of type INT or BOOL, the value will be set to "0". This can be used to initialize properties in a configuration file or on the command line.
Configuration Files
All RGS properties can be set in a configuration file. The RGS Receiver uses a file named rgreceiverconfig to read for its properties. The RGS Sender uses a file named rgsenderconfig to read for its properties. On Windows these files are installed in the directory where RGS is installed. On Linux and HP-UX these files are installed in /etc/opt/hpremote/rgreceiver and /opt/opt/hpremote/rgsender respectively.
The configuration files contain properties (name/value pairs) with only one property per line. Empty lines (containing only whitespace characters) are ignored. The "#" character begins a comment on the line extending to the end of the line. If a property is listed more than once, the value of the last entry is used.
74
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. For example:
rgreceiver.sh -Rgreceiver.Network.Timeout.Warning=10000
will starts the RGS Receiver with the Rgreceiver.Network.Timeout.Warning property set to 10000 milliseconds. If any property is set more than once on the command line, the value of the last entry is used. There cannot be any whitespace between the property name, the "=" character, and the property value. The following example:
rgreceiver.sh -Rgreceiver.IsSnap = 1
is invalid, due to the whitespace on either side of the "=" character. Properties of type string vector and int vector cannot be set on the command
line.
RGS Receiver Properties
All of the following properties are used by the RGS Receiver, and available on the command line or using the RGS Receiver property configuration file (rgreceiverconfig).
All RGS Receiver properties are automatically saved away in a "Properties Archive" when the receiver exits. They are used again with the next invocation of the receiver.
General Properties:
Rgreceiver.IsBordersEnabled=bool
If set to "1", the borders on the Remote Display Window will be enabled. If set to "0" the borders will be removed creating a borderless windows to display the remote session. The default value is "1" - borders are on.
Rgreceiver.IsSnapEnabled=bool
If set to "1", as the Remote Display Window is being positioned on the display, the window will snap to the edge of the screen when top edge of the window moves within 10 pixels of the top of the display, or when the left edge of the window moves within 10 pixels of the left edge of the display. The default value is "1" - snap is on.
Rgreceiver.IsAlwaysPromptCredentialsEnabled=bool
If set to "1", when connecting to an RGS Sender, the user will always be prompted for the domain, username and password. There will be no attempt to automatically
75
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. The default value is "directory.txt".
Rgreceiver.ConnectionWarningColor=string
This is the color the Remote Display Window will be composited with when the RGS Receiver detects a network disruption. The value is a hexadecimal number, with four components (alpha, red, green, blue). The alpha component is used to specify the level of transparency the color will take. An alpha value of zero will be totally transparent, where no warning color will be visible by the user. An alpha value of one will be totally opaque, completely covering the image in the remote sender.
The default value is "0x80b40000". The alpha component is 0x80 (128 decimal). The red component is 0xb4 (180 decimal). The blue and green components are both zero. Therefore, the color is a red of strength 180/256, or around 70% of full red. The alpha value is 128/256, or 50% transparent.
Rgreceiver.IsGlobalImageUpdateMutable=bool
If set to "1", the user will be able to modify the Enable global image updates check box in the Receiver Control Panel. If set to "0", the user will be unable to modify the checkbox. This property can be used to permanently enable or disable global image updates in the Receiver. The default value is "1" - global image updates can be configured by the user.
Rgreceiver.IsGlobalImageUpdateEnabled=bool
If set to "1", the Receiver updates the area of the screen with the extents of all the areas of the screen that have changed. If set to "0", the Receiver updates the screen to just the areas of the screen that have changed - using individual update rectangles. If image updates in the Remote Display Window seem to show image tearing, setting the value to "1", enabling global image updates, might reduce the tearing. Tearing usually occurs on large images that are updated quite frequently, such as a model of a 3D object being rotated in an large window. Setting the value to '"0", disabling global image updates, is usually best for large Remote Display Windows (5120 x 1024 resolution) that display mostly text based applications. The default value is "0" - global image updates are disabled.
Rgreceiver.RecentWindowPositions=int vector
This property can be used to initialize the positions of the Remote Display Windows. The position of each Remote Display Window is controlled by an (xpos,ypox) tuple. The following example contains two tuples, one for each of two Remote Display Windows:
76
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.
Audio Properties:
Rgreceiver.Audio.IsMutable=bool
If set to "1", the user will be able to modify all audio controls in the RGS Receiver. If set to "0", none of the controls can be modifed by the user. The default value is "1" ­audio can be configured by the user.
This property only applies to the Windows or Linux versions of the RGS Receiver.
Rgreceiver.Audio.IsEnabled=bool
If set to "1", the audio subsystem in RGS will be enabled. If set to "0", all remote audio will be disabled and no network bandwidth will be consumed for remote audio. The default value is "1" - audio is enabled.
This property only applies to the Windows or Linux versions of the RGS Receiver.
Rgreceiver.Audio.IsInStereo=bool
If set to "1", stereo is enabled and both left and right channels are transmitted. The highest quality setting with stereo enabled is equivalent to CD quality audio but consumes more network bandwidth. The default value is "1" - stereo is enabled.
This property only applies to Windows or Linux versions of the RGS Receiver.
Rgreceiver.Audio.IsFollowsFocusEnabled=bool
If set to “1”, enables only the audio stream corresponding to the Remote Display Window that currently has the keyboard focus. The audio stream from all other active connections is disabled. Setting the property to “0” combines the audio from all active connections into a single stream. The default value is “0” – combine audio from all active connections and play in a single stream.
Rgreceiver.Audio.Quality=int
The AudioQuality can be set to low (0), medium (1) or high (2) quality. This property is used to adjust the sample rate of the streaming audio. The lower the sample rate, the less information that is sent over the network thereby reducing the amount of consumed bandwidth. The default value is "1" - medium audio quality.
This property only applies to Windows or Linux versions of the RGS Receiver.
77
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. This can be used to permanently set the browser to be used before the RGS Receiver is started. This setting only applies to the Linux and HP-UX versions of the RGS Receiver. The default value is "1".
For Window's versions of the RGS Receiver, the default browser that is set in the Windows Registry is used to display the online help.
This property only applies to the Linux or HP-UX versions of the RGS Receiver.
Rgreceiver.Browser.Name=string
Use this property to set the name of the browser to be used to display online help. For example, setting Rgreceiver.Browser.Name=mozilla will start up the Mozilla browser when the "Help" button is selected in the Receiver Control Panel.
This property only applies to Linux or HP-UX versions of the RGS Receiver.
Hotkeys Properties:
Rgreceiver.Hotkeys.IsMutable=bool
If set to "1", all Hotkey settings in the Receiver Control Panel will be able to be changed by the user. If set to "0", none of the settings can be changed by the user.
This can be used to permanently enable or disable Hotkey settings before the RGS Receiver is started. The default value is "1" - Hotkeys can be configured by the user.
Rgreceiver.Hotkeys.SetupModeSequence=string
Defines the Setup Mode hotkey sequence. The sequence may only consist of Ctrl, Alt, Shift and Space keys. The sequence must also start with either a Ctrl, Alt or Shift key. The first key must also be held down through the entire hotkey sequence. The default value is "Shift Down, Space Down, Space Up".
Rgreceiver.Hotkeys.IsSendCtrlAltEndAsCtrlAltDeleteEnabled=bool
When enabled a Ctrl-Alt-End key sequence in the Remote Display Window is sent to the RGS Sender as a Ctrl-Alt-Del key sequence. The default value is "1" - send a Ctrl-Alt-Del when the user enters Ctrl-Alt-End.
Rgreceiver.Hotkeys.IsSendFirstKeyInSequenceEnabled=bool
When enabled the first key in the hotkey sequence is sent to the RGS Sender. The default value is "0" - don't send the first key in the hotkey sequence.
ImageCodec Properties:
78
Using Remote Graphics Software
Rgreceiver.ImageCodec.IsMutable=bool
If set to "1", the image quality can be changed by the user in the Receiver Control Panel. If set to "0", the user cannot change the image quality. This can be used to permanently set the image quality before the RGS Receiver is started. The default value is "1" - image quality can be adjusted by user.
Rgreceiver.ImageCodec.Quality=int
The CodecQuality can be set to a value between and including 0 and 100. This property is used to set the quality of the image in the Remote Display Window. A value of 100 is the highest image quality and should be visually lossless. A value of 0 is the lowest image quality. Under most circumstances a value of 65 should be sufficient. Often, lowering the quality will reduce the bandwidth on the network. The default value is 65.
Logging Properties:
Rgreceiver.Log.IsMutable=bool
If set to "1", the logging settings in the Receiver Control Panel can be changed by the user. If set to "0", the user will not be able to change any of the logging settings. This can be used to permanently enable or disable logging settings before the RGS Receiver is started. The default value is "1" - logging settings can be changed.
Rgreceiver.Log.IsFileLoggerEnabled=bool
If set to "1", logging output from the RGS Receiver will be sent to a file. The default value is "1" - log to a file.
Rgreceiver.Log.IsConsoleLoggerEnabled=bool
If set to "1", logging output from the RGS Receiver will be sent to a console window. The RGS Receiver must be started in a console window to see the logging output. The default value is "1" - log to the console.
This property only applies to the Linux and HP-UX versions of the RGS Receiver.
Rgreceiver.Log.Filename=string
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. If DEBUG level is chosen, then all level of output from DEBUG to FATAL will be output to the
79
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.
Rgreceiver.Log.NumBackupFiles=int
If the log file exceeds its maximum size, the log file will be saved and a new log file will be created. This sets the number of extra files that will be saved. The default number of saved files is five.
Networking Properties:
Rgreceiver.Network.Timeout.IsMutable=bool
If set to "1", the user can modify all network timeout values in the RGS Receiver Control Panel. If set to "0", the user cannot modify the values. This property can be
used to permanently set network timeouts before the RGS Receiver is started. The default value is "1" - timeout values are changeable by the user.
Rgreceiver.Network.Timeout.Warning=int
The timeout in milliseconds used to detect and notify the user of a network disruption. The default value is 2000 milliseconds - two seconds.
Rgreceiver.Network.Timeout.Error=int
The timeout in milliseconds used to detect and disconnect an inactive connection. The default value is 30000 milliseconds - thirty seconds.
Rgreceiver.Network.Timeout.Dialog=int
The timeout in milliseconds used to display and wait on responses from input dialogs, such as the authorization dialog and PAMauthentication dialog. The default value is 15000 milliseconds - fifteen seconds.
USB Properties:
Rgreceiver.Usb.IsMutable=bool
If set to "1", the user will be able to modify all USB controls in the RGS Receiver Control Panel. If set to "0", none of the controls can be changed by the user. This can be used to permanently enable or disable remote USB before the RGS Receiver is started. The default value is "1".
This property only applies to HP Blade Workstation Client.
80
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. This property will specify the RGS Sender that remote USB will be connected to. To have all remote USB go to the first sender, use value zero. To have all remote USB go to the second sender, use value one, and so on. Remote USB can only go to one sender at a time. To change the sender, all senders must be disconnected. Then, enter a new value and reconnect all senders. The default value is zero - the first sender to be connected.
This property only applies to HP Blade Workstation Client.
RGS Sender Properties
All of the following properties are used by the RGS Sender, and can be set from the command line or from the RGS Sender property configuration file (rgsenderconfig).
General Properties:
Rgsender.IsRdpLogoutDetected=bool
The methods provided by Microsoft to close a connection through Remote Desktop Protocol (RDP) work quickly when the user disconnects from the RDP session. If the user logs out of the RDP session, the RGS Sender will be unable to access the desktop for about 60 seconds. If set to "1", the desktop will be available to the user through RGS as soon as possible. The RGS Sender will monitor the RDP session for a logout and begin the process of making the desktop available as soon as the logout is detected. If set to "0", the RGS Sender will not monitor the RDP session for a logout.
This property only applies to Windows versions of the RGS Sender.
Rgsender.IsCopyRegionEnabled=bool
If set to "1", RGS Copy Regions are sent from the Sender to the Receiver. If set to "0", RGS Copy Regions are turned off and will be sent to the Receiver as Image Update Regions. This is for advanced use and should not be set. The default value is "1" - send RGS Copy Regions.
Rgsender.IsRegionLimitEnabled=bool
Used to limit the number of update rectangles in a update region. This is for advanced use and should not be set. The default value is 0 - don't limit regions.
81
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. This will avoid persistent visual artifacts at the expense of potentially increased bandwidth usage. If set to "0", the alignment of the codec with respect to the screen will be arbitrary, as determined by the exposed or modified region. For user desktops that contain primarily 2D applications, turning off this property can save network bandwidth. The default value is "1" - always snap the codec to tile boundaries.
Rgsender.MaxImageUpdateRate=int
Used to limit the number of image updates per second transmitted from the Sender to the Receiver. The value is the maximum number of updates per second. If the image update rate is too high, and using too much network bandwidth, the MaxImageUpdateRate can be set to limit the number of image updates per second. The default value is 0 - don't limit the image update rate.
Networking Properties:
Rgsender.Network.Timeout.Error=int
The timeout in milliseconds used to detect and disconnect an inactive connection. The default value is 30000 milliseconds - thirty seconds. See Using Timeouts for more details.
Rgsender.Network.Timeout.Dialog=int
The timeout in milliseconds used to display and wait on responses from input dialogs, such as the authorization dialog and PAM authentication dialog. The default value is 15000 milliseconds - fifteen seconds. See Using Timeouts for more details.
82
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. All users must use a unique username and cannot share usernames.
Multiple connections between Senders and Receivers are only allowed if the user logged into the Sender system, referred to as the primary user, allows the connection. A question dialog, stating the domain and user name of the user attempting a connection, is displayed on the Sender's desktop when a new Receiver attempts to connect. All currently connected users are given the option to allow or disallow the connection using buttons in the message box.
If a user allows the connection, the new user is allowed to connect to the Sender and view the desktop.
If the connection is not allowed, the new Receiver will be unable to connect.
If no one is logged into the Sender's desktop (in other words there is no
primary user) then all authenticated connections are connected and able to view the Windows login desktop. However, when a user logs into the Sender desktop, all non-primary users, are disconnected. This is a security precaution.
On Windows, if the primary user disconnects, the desktop is locked, but the Receivers will remain connected.
On HP-UX and Linux, if the primary user disconnects, the desktop is locked and all users are disconnected.
If the remote user connecting is the same user as the user logged in the desktop, the collaboration dialog is not displayed and the connection is allowed.
On Microsoft Windows, a Sender desktop icon in the system application tray displays the status of connections. The icon animates when Receivers are connected. Additionally, a collaboration notification dialog is displayed on the desktop whenever a non-primary user is connected.
On Linux and HP-UX, the Sender GUI is present on the desktop, but does not display connection status.
The Sender icon or GUI can be used to enable and disable mouse and keyboard for non-primary users. For example, if you wish to grant "view only" access to users simply right-click on the icon or GUI and select "Remote IO" and then select "Enable" or "Disable"
All Receivers can be easily disconnected from the HP Remote Graphics icon located in the system tray or from the Sender GUI by right-clicking on the icon or GUI. This is useful when hosting collaborative session, such as in a classroom environment, and the session ends.
83
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). If any other user attempts to use the mouse or keyboard while the current owner is not using the input devices for this short period of time, the floor ownership transfers to the new user.
The mouse and keyboard can be disabled for non-primary users. The primary user is the user that is logged into the desktop of the Sender system. A non-primary user is a user that is connected, but is not logged in. For example, if UserA is logged into the Sender system and UserB is connected in, the with I/O disabled, UserB cannot control the mouse and keyboard.
84
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).
When Single Sign-on is installed, users will normally need to enter their credentials only once. The user will be prompted on the RGS Receiver to enter their credentials. These credentials will be used to authenticate the connection to the RGS Sender. If the user is authenticated on the sender, the same credentials will be used to silently log into or unlock the user onto the users desktop.
Single Sign-on will only occur when the Sender is in one of two states - the logged off state or the locked desktop state. These two states are WinLogon states, and are
controlled by the WinLogon.exe process running on the Sender system. WinLogon.exe is the Window's logon manager and is the process responsible for managing user logon and logoff. The WinLogon.exe process controls these states, more formally known as WlxDisplaySASNotice and WlxDisplayLockedNotice states.
When the remote desktop is in the logged off state (WlxDisplaySASNotice), the following dialog is present on the remote desktop:
When the remote desktop is in the locked desktop state (WlxDisplayLockedNotice), the following dialog is present on the remote desktop:
85
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. The RGS GINA module resides in the C:\WINDOWS\system32 directory of the Sender's system. The hprgina.dll module is loaded by Window's WinLogon.exe process at system boot up.
The RGS Sender enables Single Sign-on functionality with a correctly installed and configured hprgina.dll module. Please refer to Installing & Enabling Single Sign-on section to learn more about enabling RGS Single Sign-on.
86
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).
When Easy Login is installed, users will normally need to enter their credentials only once. The user will directly connect to the RGS Sender and immediately enter their credentials to log in or unlock the remote desktop in the Remote Display Window.
Easy Login works only with one RGS connection - no other prior / simultaneous RGS connections are allowed. Easy Login works only with the Sender in one of two states
- the logged off state or the locked desktop state. These two states are WinLogon states, and are controlled by the WinLogon.exe process running on the Sender system. WinLogon.exe is the Window's logon manager and is the process responsible for managing user logon and logoff. The WinLogon.exe process controls these states, more formally known as WlxDisplaySASNotice and WlxDisplayLockedNotice states.
When the remote desktop is in the logged off state (WlxDisplaySASNotice), the following dialog is present on the remote desktop:
When the remote desktop is in the locked desktop state (WlxDisplayLockedNotice), the following dialog is present on the remote desktop:
87
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. If the remote desktop state differs
from these requirements, Easy Login will not work and the user will need to enter their credentials twice.
To support Easy Login in the RGS Sender, the Sender must know about the various WinLogon states. The Sender uses a custom RGS GINA (Graphical Identification and Authentication) module, hprgina.dll, to determine these states. It resides in the C:\WINDOWS\system32 directory of the Sender's system. The hprgina.dll module is loaded by Window's WinLogon.exe process at system boot up. Once the module is loaded, the Sender receives notifications of all WinLogon state changes.
The RGS Sender enables Easy Login functionality with a correctly installed and configured hprgina.dll module. Please refer to Installing & Enabling Easy Login section to learn more about enabling Easy Login.
Microsoft Remote Desktop and Easy Login
Microsoft Remote Desktop and RGS Easy Login ideally coexist and work well together under certain situations. The following scenarios demonstrate how a user and an IT administrator can work together using their preferred methods:
UserA uses RGS to connect to his HP Blade Workstation.
UserB is an IT administrator and uses Microsoft Remote Desktop to connect to
UserA's Blade Workstation.
Careful orchestration keeps Easy Login enabled. Under certain scenarios, it can become disabled. The following section describes several of the possible key scenarios.
UserB never connects in - RGS Easy Login remains enabled for UserA:
This is the primary scenario assumed for day-to-day operations.
1. UserA logs off and then disconnects the RGS Receiver from the sender before leaving work for the evening. UserA might also lock the workstation rather
88
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.
2. UserB never uses Remote Desktop to connect into UserA's Blade Workstation.
3. UserA returns the next morning and connects to his Blade Workstation using the RGS Receiver. UserA connects directly to his workstation with an Easy Login connection. He enters his credentials only once.
UserB logs off of the Blade Workstation when finished - RGS Easy Login remains enabled for UserA:
This is the standard scenario assumed for IT support.
1. UserA logs off and then disconnects the RGS Receiver before leaving work for the evening.
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 logs off from the Blade Workstation. No Remote Desktop session remains.
3. UserA returns the next morning and connects to his Blade Workstation using the RGS Receiver. UserA connects directly to his workstation with an Easy Login connection. He enters his credentials only once.
UserB connects in, but does not log in - RGS Easy Login remains enabled for UserA:
This scenario should rarely occur.
1. UserA logs off and then disconnects the RGS Receiver before leaving work for the evening.
2. That night UserB connects to UserA's Blade Workstation using Remote Desktop Connection, but UserB does not log in. A Remote Desktop connection remains active although no login exists.
3. UserA returns the next morning and connects to his Blade Workstation using the RGS Receiver. UserA connects directly to his workstation with an Easy Login connection. He enters his credentials only once.
UserB connects in, and then disconnects without logging out - RGS Easy Login is disabled for UserA:
This scenario is possible but not recommended. IT administrators should always log off (not just disconnect) when finished working with a Microsoft Remote Desktop Connection. When a user only disconnects with Microsoft Remote Desktop, but the user doesn't logoff, it leaves a terminal services session open and this interferes with Easy Login.
1. UserA logs off and then disconnects the RGS Receiver before leaving work for the evening.
89
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.
3. UserA returns the next morning and attempts to connect to his Blade Workstation using the RGS Receiver. UserA must enter his credentials to connect into the workstation. Due to the active session left by UserB (who did not log off), UserA cannot connect to his workstation because UserB owns the desktop session on UserA's Blade Workstation.
4. UserA must call up IT and seek help. IT must discover the Remote Desktop or Windows terminal services session and log out the administrator session for UserA to connect.
90
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. This support is available through the RGS Sender for Windows.
This section describes how to interpret RGS connectivity status, decode Windows Event Log messages from the Sender, and create effective control agents for remote application management and termination during disconnects.
RGS Connection and User Status
The RGS Sender reports status of connections through a custom Windows Event Log called HPRemote. RGS connections normally occur in two phases:
Phase 1: RGS Connection - a connection over a standard computer network between an RGS Sender and RGS Receiver
Phase 2: Desktop Session - a logged-in session that gives access to a desktop workspace on a remote workstation using a RGS connection
Desktop Sessions can operate independently of active RGS Connections. This allows the user to disconnect and reconnect to Desktop Sessions as part of a normal workflow. However, when a connection is unintentionally disconnected, a user may require remote applications to be terminated after Desktop Sessions are left unattended for a period of time to prevent them from operating unsupervised.
Ownership of a Desktop Session on Windows defines the type of user status in effect for a RGS connection. Events posted to the HPRemote Windows Event Log reflect the following control priorities:
Primary User - The user of a RGS Connection that matches the user logged into the Desktop Session.
Non-primary User (also Collaborating User) - A user of a RGS Connection that does not match the user logged into the Desktop Session. If no one is logged into a Desktop Session, then all connections are non-primary.
Primary user status defines control and the need for a monitoring agent to take action against running applications of interest. When the number of primary user connections drops to zero, then the Desktop session may require user-defined actions.
HPRemote - the RGS Windows Event Log
The RGS Sender posts events in the HPRemote Windows Event Log. Event messages are directly viewable with the Windows Event Viewer or by an application
91
HP Remote Graphics 4.2.0 User's Guide
ctions in each
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. Review each message type in the table below for exact field and usage descriptions. Details for using the Event Viewer follow after the table.
Message ID Description
RGSENDER_CONNECT_STATE
The connection state consists of zero or more
primary connections and zero or more non­primary connections. Each event entry records
the current number of active conne category. Events appear when the connection status of these users changes. The first field represents the number of primary connections. The second field represents the number of non­primary connections. Each state field provides a text string and binary, 32-bit unsigned integer for application use.
Event Viewer Message:
Primary connections: %1. Non-primary connections: %2.
Strings:
%1 = number of primary connections %2 = number of non-primary
connections
Data:
UINT32 numPrimary UINT32 numNonprimary
Event Viewer Example:
Primary connections: 1 Non-primary connections: 0
92
Loading...