HP xw4400 User Manual

HP Remote Graphics 4.2.0

User's Guide

Copyrights and trademarks

The HP Remote Graphics Sender for Windows uses Microsoft Detours Professional

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.

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 thinclient. 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).

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 preassigned 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.

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. Multiheaded 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, customerdesigned 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.

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.

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

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.

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

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.

• 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

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.

3. Not all USB devices are supported. Refer HP Blade Workstation documentation for more details.

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

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

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.

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

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.

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" ...

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").

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"

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. HPUX 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.

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

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"

+ 125 hidden pages