HP ZCentral Remote Boost User Manual

HP ZCentral Remote Boost User Guide
SUMMARY
HP ZCentral Remote Boost brings added security, performance, mobility, and collaboration to your workstation deployment. With HP ZCentral Remote Boost, you can use a lower-powered desktop, notebook, or thin client to remotely connect to a powerful workstation and use your graphics-intensive workstation programs wherever you go.
Copyright and License
Trademark Credits
Third-party software notice
© Copyright 2020-2021 HP Development Company, L.P.
12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.
The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Third Edition: February 2021
First Edition: February 2020
Document Part Number: L85268-003
macOS is a trademark of Apple Inc. Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries. Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. NVIDIA is a trademark and/or a registered trademark of NVIDIA Corporation in the U.S. and other countries. Red Hat and Red Hat Enterprise Linux are trademarks of Red Hat, Inc. in the United States and other countries. VMware and VMware vSphere are registered trademarks or trademarks of VMware, Inc. in the United States and/or other jurisdictions.
Third-party source code and licenses are redistributed, if required, with HP ZCentral Remote Boost.
User input syntax key
Text that you must enter into a user interface is indicated by fixed-width font.
Table -1 User input syntax key
Item Description
Text without brackets or braces
<Text inside angle brackets>
[Text inside square brackets]
{Text inside braces}
|
...
Items you must type exactly as shown
A placeholder for a value you must provide; omit the brackets
Optional items; omit the brackets
A set of items from which you must choose only one; omit the braces
A separator for items from which you must choose only one; omit the vertical bar
Items that can or must repeat; omit the ellipsis
iii
iv User input syntax key
Table of contents
1 HP ZCentral Remote Boost overview ................................................................................................................ 1
Features ................................................................................................................................................................. 2
Interoperability between dierent versions of HP ZCentral Remote Boost ......................................................... 3
Software compatibility with HP ZCentral Remote Boost ...................................................................................... 3
HP ZCentral Remote Boost Sender licensing ......................................................................................................... 4
Finding more information ...................................................................................................................................... 4
2 Getting started ............................................................................................................................................. 5
3 Installation ................................................................................................................................................... 6
Installing HP ZCentral Remote Boost Receiver (Windows) ................................................................................... 6
Performing a custom HP ZCentral Remote Boost Receiver installation using the installer
wizard .................................................................................................................................................. 6
Performing a custom HP ZCentral Remote Boost Receiver installation on the command line ......... 7
Installing HP ZCentral Remote Boost Sender (Windows) ...................................................................................... 9
Installer wizard installation ................................................................................................................ 9
Command-line installation ............................................................................................................... 10
Installing HP ZCentral Remote Boost Receiver (Linux) ....................................................................................... 11
Installing HP ZCentral Remote Boost Sender (Linux) .......................................................................................... 12
Installing HP ZCentral Remote Boost Receiver (macOS) ..................................................................................... 12
Installer wizard installation .............................................................................................................. 12
Command-line installation ............................................................................................................... 12
4 HP ZCentral Remote Boost Receiver overview ................................................................................................. 14
Opening HP ZCentral Remote Boost Receiver ..................................................................................................... 14
Opening HP ZCentral Remote Boost Receiver on Windows .............................................................. 14
Opening HP ZCentral Remote Boost Receiver on Linux .................................................................... 14
Opening HP ZCentral Remote Boost Receiver on macOS ................................................................. 14
HP ZCentral Remote Boost Receiver GUI (Windows/Linux) ................................................................................ 14
HP ZCentral Remote Boost Receiver GUI (macOS) .............................................................................................. 15
Starting an HP ZCentral Remote Boost session .................................................................................................. 15
HP ZCentral Remote Boost Receiver window GUI (Windows/Linux) ................................................................... 16
HP ZCentral Remote Boost Receiver toolbar GUI (Windows/Linux) ................................................. 16
HP ZCentral Remote Boost Receiver window GUI (macOS) ................................................................................. 18
Setup Mode .......................................................................................................................................................... 18
Changing the Setup Mode hotkey sequence ..................................................................................... 19
v
HP ZCentral Remote Boost Receiver settings ..................................................................................................... 19
Connection ......................................................................................................................................... 20
Performance ...................................................................................................................................... 20
Gestures (Windows touch-capable devices only) ............................................................................. 21
Mapping a hotkey sequence to a gesture ....................................................................... 21
Unmapping a hotkey sequence from a gesture ............................................................. 21
Audio .................................................................................................................................................. 21
Network ............................................................................................................................................. 22
Hotkeys .............................................................................................................................................. 22
Logging .............................................................................................................................................. 23
Statistics (Windows/Linux only) ........................................................................................................ 23
HP ZCentral Remote Boost Receiver command-line options .............................................................................. 24
5 HP ZCentral Remote Boost Sender overview ................................................................................................... 25
HP ZCentral Remote Boost Sender overview (Windows) .................................................................................... 25
HP ZCentral Remote Boost Sender overview (Linux) .......................................................................................... 25
HP ZCentral Remote Boost Sender command-line options (Windows) .............................................................. 25
HP ZCentral Remote Boost Sender command-line options (Linux) .................................................................... 26
HP ZCentral Remote Boost Sender notication icon (Windows only) ................................................................. 27
HP ZCentral Remote Boost Sender event logging (Windows only) ..................................................................... 27
Filtering access to HP ZCentral Remote Boost Senders ...................................................................................... 27
Filtering by user name ....................................................................................................................... 27
Filtering by network identiers ......................................................................................................... 28
6 Conguring certicates ................................................................................................................................ 29
Sender verication ............................................................................................................................................... 29
Certicate Verication Error Policy ................................................................................................... 29
End-user verication of a sender certicate .................................................................................... 29
Using a certicate signed by a CA ........................................................................................................................ 30
Conguring the sender to use a certicate signed by a CA .............................................................. 30
Modifying the sender Ice conguration le .................................................................... 30
Modifying the sender conguration le ......................................................................... 30
Modifying the receiver Ice conguration le .................................................................. 30
Modifying the receiver conguration le ....................................................................... 31
Conguring the receiver to use a certicate signed by a CA ............................................................. 31
Modifying the receiver Ice conguration le .................................................................. 31
Modifying the sender Ice conguration le .................................................................... 32
Removing a certicate ......................................................................................................................................... 32
Windows ............................................................................................................................................ 32
Linux .................................................................................................................................................. 32
macOS ................................................................................................................................................ 32
vi
Troubleshooting the certicate conguration .................................................................................................... 33
7 Using HP ZCentral Remote Boost features ...................................................................................................... 34
HP ZCentral Remote Boost Advanced Features .................................................................................................. 34
Advanced Video Compression (Windows/Linux only) ....................................................................... 34
HP Velocity ......................................................................................................................................... 34
Authentication ..................................................................................................................................................... 35
Authentication methods ................................................................................................................... 35
Standard authentication ................................................................................................. 35
Using Kerberos Authentication ....................................................................................... 36
Easy Login ....................................................................................................................... 36
Single Sign-on ................................................................................................................. 36
Smart card redirection ...................................................................................................................... 36
Using smart card redirection .......................................................................................... 36
Conguring Remote USB for smart card redirection ...................................................... 37
Limitations ...................................................................................................................... 37
Collaboration ....................................................................................................................................................... 37
Collaboration invitations ................................................................................................................... 39
Display ................................................................................................................................................................. 39
Display resolution and layout matching ........................................................................................... 39
Multi-monitor overview .................................................................................................. 39
Matching display resolution and layout methods .......................................................... 40
Matching display resolution and layout (Windows-based sender) ................................ 42
Testing the resolution .................................................................................. 42
Additional conguration on the sender ....................................................... 42
NVIDIA resolution-matching (Windows-based senders with NVIDIA
graphics only) ............................................................................................... 43
EDID les ....................................................................................................... 43
Creating and applying an EDID le ............................................................... 44
Adding custom resolutions ........................................................................... 44
Matching display resolution and layout (Linux-based sender) ...................................... 45
Conguring the X server ............................................................................... 45
Creating an EDID le ..................................................................................... 46
Using display properties to set resolution and layout ..................................................................... 46
Sender screen blanking ..................................................................................................................... 48
Input ..................................................................................................................................................................... 48
Wacom solution ................................................................................................................................. 48
Adjusting tablet properties ............................................................................................. 48
Windows and Mac receiver solution ............................................................................... 49
ThinPro receiver solution ................................................................................................ 49
Linux receiver solution (non-ThinPro) .......................................................... 49
vii
Windows sender solution ............................................................................................... 49
Linux sender solution ..................................................................................................... 50
Using touch features (Windows touch-capable devices only) .......................................................... 50
Game Mode (Windows only) .............................................................................................................. 51
Supported keyboard layouts ............................................................................................................. 51
Remote Audio ...................................................................................................................................................... 51
HP ZCentral Remote Boost audio path ............................................................................................. 51
Using Remote Audio (Windows-based sender) ................................................................................. 52
Using Remote Audio (Linux-based sender) ....................................................................................... 52
PulseAudio ...................................................................................................................... 52
ALSA ................................................................................................................................ 53
Remote Clipboard ................................................................................................................................................ 54
Remote USB (Windows and ThinPro only) ........................................................................................................... 54
Conguring the remoting behavior of individual USB devices (Windows only) ............................... 55
USB microphones .............................................................................................................................. 55
Remote USB Access Control List ....................................................................................................... 56
Determining USB device information (Windows) .............................................................................. 57
Determining USB device information (Linux) ................................................................................... 57
Enabling Remote USB on HP ThinPro ................................................................................................ 57
Directory Mode ..................................................................................................................................................... 57
Directory le format .......................................................................................................................... 58
Starting HP ZCentral Remote Boost Receiver in Directory Mode (Windows) ................................... 58
Verifying the HP ZCentral Remote Boost connection ..................................................... 58
Bringing a specic HP ZCentral Remote Boost Receiver window to the front ............... 58
Starting HP ZCentral Remote Boost Receiver in Directory Mode (macOS) ....................................... 59
8 Conguration tools and properties ............................................................................................................... 60
HP ZCentral Remote Boost Receiver setting override hierarchy ........................................................................ 60
HP ZCentral Remote Boost Receiver Conguration tool (Windows and Linux Only) .......................................... 60
Using the HP ZCentral Remote Boost Receiver Conguration tool .................................................. 60
General .............................................................................................................................................. 61
Image and Display ............................................................................................................................. 63
Audio .................................................................................................................................................. 64
Network ............................................................................................................................................. 65
HP Velocity ......................................................................................................................................... 66
USB (Windows / ThinPro only) ........................................................................................................... 67
Hotkeys .............................................................................................................................................. 67
Logging .............................................................................................................................................. 68
Activation ........................................................................................................................................... 69
HP ZCentral Remote Boost Sender setting override hierarchy ........................................................................... 69
HP ZCentral Remote Boost Sender Conguration tool (Windows/Linux only) ................................................... 69
viii
Using the HP ZCentral Remote Boost Sender Conguration tool ..................................................... 70
General .............................................................................................................................................. 70
Authentication (Windows only) ......................................................................................................... 71
Image and Display ............................................................................................................................. 71
Network ............................................................................................................................................. 72
HP Velocity ......................................................................................................................................... 73
USB .................................................................................................................................................... 74
Collaboration ..................................................................................................................................... 74
Logging .............................................................................................................................................. 75
Diagnostics ........................................................................................................................................ 75
Certicates ......................................................................................................................................... 75
Setting HP ZCentral Remote Boost properties manually .................................................................................... 76
Property syntax ................................................................................................................................. 76
Setting property values in a conguration le ................................................................................. 76
Setting property values on the command line ................................................................................. 77
Making a property immutable ........................................................................................................... 77
Automation API restriction control ................................................................................................... 77
Other properties .................................................................................................................................................. 78
Other global properties ..................................................................................................................... 78
Per-session properties (HP ZCentral Remote Boost Receiver only) ................................................. 80
Window location and size properties (per-session) ....................................................... 81
Clipboard properties (per-session) ................................................................................. 81
Auto-launch properties ..................................................................................................................... 82
9 Performance optimization ............................................................................................................................ 84
General ................................................................................................................................................................. 84
Network ............................................................................................................................................................... 84
Forcing a network speed (Windows) ................................................................................................. 85
Forcing a network speed (Linux) ....................................................................................................... 85
10 Troubleshooting ........................................................................................................................................ 86
Failed connection attempts ................................................................................................................................. 86
Receiver checklist .............................................................................................................................. 86
Sender checklist ................................................................................................................................ 86
Kerberos ............................................................................................................................................ 87
Sender network interface binding .................................................................................................... 87
Reconguring network interface binding manually ....................................................... 88
Reconguring network interface binding using the HP ZCentral Remote Boost
Sender Conguration tool ............................................................................................... 88
Determining the number that corresponds to the network interface ......... 88
Conguring the HP ZCentral Remote Boost Sender settings ...................... 89
ix
Network timeouts ................................................................................................................................................ 89
The HP ZCentral Remote Boost Receiver window repeatedly dims and displays a connection
warning message .............................................................................................................................. 89
The HP ZCentral Remote Boost Receiver window dims, and HP ZCentral Remote Boost Receiver disconnects and displays a connection error, but you can connect again immediately ... 89
When connecting to a Linux-based sender, the PAM authentication dialog on the receiver
does not display long enough for credentials to be entered ............................................................ 90
When connecting to the sender, the authorization dialog is not displayed long enough for the user to respond to it
The HP ZCentral Remote Boost Receiver window is not updating ................................................... 90
Increasing the error timeout value of HP ZCentral Remote Boost Receiver does not appear to
have an eect, and HP ZCentral Remote Boost Receiver still disconnects ...................................... 90
Graphical issues (Linux) ....................................................................................................................................... 90
Full-screen crosshair cursors ............................................................................................................ 90
Gamma correction on the receiver .................................................................................................... 91
Black or blank HP ZCentral Remote Boost Receiver window ........................................................... 91
High DPI display issues ........................................................................................................................................ 91
Disabling or enabling support for high DPI displays ........................................................................ 91
Input issues .......................................................................................................................................................... 91
Keystrokes are repeated when connected to Linux Sender ............................................................. 92
Remote Audio issues ........................................................................................................................................... 92
HP ZCentral Remote Boost Receiver is not producing audio ............................................................ 92
Audio is disrupted .............................................................................................................................. 92
Audio causes continuous network traic ......................................................................................... 92
There is no audio on a sender or a receiver with multiple audio devices ......................................... 93
Remote USB issues .............................................................................................................................................. 93
Smart card redirection issues .............................................................................................................................. 93
Mouse Cursor issues on servers and blades (Windows Sender) ......................................................................... 94
.......................................................................................................................... 90
Appendix A Switching between HP ZCentral Remote Boost and Remote Desktop Connection (Windows only) ......... 95
Appendix B Creating an agent for remote application termination (Windows only) .............................................. 96
Viewing the HPRemote log .................................................................................................................................. 96
HPRemote log format .......................................................................................................................................... 96
Agent design guidelines .................................................................................................................................... 100
Desktop session logout ................................................................................................................... 100
Selective environment shutdown ................................................................................................... 100
Wrapping applications of interest ................................................................................................... 100
Administrator alerts ........................................................................................................................ 101
Anticipating user disconnects and reconnects ............................................................................... 101
General agent design guidelines .................................................................................................... 101
x
Recovery settings for the HP ZCentral Remote Boost Sender service ........................................... 101
Sample agent ..................................................................................................................................................... 102
Appendix C Uninstalling HP ZCentral Remote Boost ......................................................................................... 107
Uninstalling HP ZCentral Remote Boost Receiver or HP ZCentral Remote Boost Sender (Windows) .............. 107
Uninstalling HP ZCentral Remote Boost Receiver (Linux) ................................................................................. 107
Red Hat Enterprise Linux ................................................................................................................ 107
Ubuntu ............................................................................................................................................. 107
HP ThinPro ....................................................................................................................................... 107
Uninstalling HP ZCentral Remote Boost Sender (Linux) ................................................................................... 108
Red Hat Enterprise Linux ................................................................................................................ 108
Ubuntu ............................................................................................................................................. 108
Uninstalling HP ZCentral Remote Boost Receiver (macOS) .............................................................................. 109
Index ........................................................................................................................................................... 110
xi
xii

1 HP ZCentral Remote Boost overview

HP ZCentral Remote Boost brings added security, performance, mobility, and collaboration to your workstation deployment. With HP ZCentral Remote Boost, you can use a lower-powered desktop, notebook, or thin client to remotely connect to a powerful workstation and use your graphics-intensive workstation programs wherever you go.
Your programs run natively on the remote workstation and take full advantage of its graphics resources. The desktop of the remote workstation is transmitted over a standard network to your local computer using advanced image compression technology specically designed for digital imagery, text, and high frame rate video applications.
The following image and table demonstrate a typical HP ZCentral Remote Boost deployment.
Table 1-1 HP ZCentral Remote Boost deployment components
Item Description
1 The sender is typically a high-performance workstation, virtual workstation, blade, or server that hosts your software. HP
ZCentral Remote Boost Sender is installed on the sender and transmits graphics, audio, and USB data to the receiver. The
sender receives input and USB data from the receiver.
NOTE: A monitor does not necessarily have to be connected to the sender.
2 The receiver is typically a desktop, notebook, tablet, or thin client with HP ZCentral Remote Boost Receiver installed. You
establish the Remote Boost connection from the receiver side. The desktop of the sender is displayed inside the HP ZCentral Remote Boost Receiver window on the receiver, and Remote Boost Receiver transmits input to the sender so that you can interact with your programs remotely.
3 A TCP/IP network serves as the communication link between the sender and the receiver.
IMPORTANT: The sender and receiver must be on the same network for a Remote Boost connection to be established
between them.
1
NOTE: HP ZCentral Remote Boost software and documentation might also refer to the sender and the
receiver as the remote computer and the local computer respectively.
HP ZCentral Remote Boost system requirements, such as hardware and operating system support, are not discussed in this document. Some HP ZCentral Remote Boost features might have additional system requirements. System requirements are described in the QuickSpecs (see Finding more information
on page 4).

Features

HP ZCentral Remote Boost includes a variety of features, including the ones described in the following table.
NOTICE: Some features are not supported by certain operating systems.
Table 1-2 HP ZCentral Remote Boost features and their descriptions
Feature Description
3D graphics API support Provides workstation-class performance for software based on OpenGL or Direct X
NOTICE: See Software compatibility with HP ZCentral Remote Boost on page 3 for
information about the types of programs and congurations that HP does and does not recommend for use with HP ZCentral Remote Boost.
Advanced Video Compression (Windows®/ Linux® only)
Authentication methods Support varied deployment scenarios and preferences, including smart card redirection
Collaboration Lets multiple receivers connect to the same sender simultaneously, allowing multiple
Directory Mode Lets a single receiver connect to multiple senders simultaneously
Display resolution and layout matching Adjusts the display resolution and display layout of the sender to match those of the
HP Velocity Improves performance within a wide area network (WAN)
Pixel Mode Enables you to view the remote desktop in two dierent ways. 1:1 mode displays the
Remote Audio Transmits smooth, continuous, low-latency, high-quality audio from the sender to the
Reduces the network bandwidth needed for high-quality video streams
See Advanced Video Compression (Windows/Linux only) on page 34 for more information.
See Authentication on page 35 for more information.
users to view and interact with the same desktop session and programs
See Collaboration on page 37 for more information.
See Directory Mode on page 57 for more information.
receiver or user-dened properties, even when you use multiple monitors
See Display resolution and layout matching on page 39 for more information.
See HP Velocity on page 34 for more information.
remote desktop as is. Scaled mode scales the remote desktop up or down to ll the the HP ZCentral Remote Boost Receiver window.
receiver
Remote Clipboard Lets you cut, copy, and paste data between the sender and the receiver or between two
Remote USB (Windows/ThinPro only) Lets receiver-side USB devices be mounted to and accessed by the sender through the HP
2 Chapter 1 HP ZCentral Remote Boost overview
See Remote Audio on page 51 for more information.
senders
See Remote Clipboard on page 54 for more information.
ZCentral Remote Boost connection
Table 1-2 HP ZCentral Remote Boost features and their descriptions (continued)
Feature Description
See Remote USB (Windows and ThinPro only) on page 54 for more information.
Sender screen blanking Blanks the screen of the sender monitor (if one is connected) so that the desktop session
is not visible on the sender monitor
See Sender screen blanking on page 48 for more information.
Touch features (Windows only) Lets you control your remote desktop with touch input and congure custom gestures
See Using touch features (Windows touch-capable devices only) on page 50 for more information.
Interoperability between dierent versions of HP ZCentral Remote Boost
Interoperability is supported between dierent versions of HP ZCentral Remote Boost Sender and HP ZCentral Remote Boost Receiver only if they have the same primary version number.
Table 1-3 HP ZCentral Remote Boost version number items and their descriptions
Item Description
1 Primary version number: A primary release typically contains upgrades and changes signicant enough that
interoperability with previous primary releases is not guaranteed by HP. For example, a connection between dierent primary releases of HP ZCentral Remote Boost Sender and HP ZCentral Remote Boost Receiver might not function at an acceptable quality, or at all.
2 Minor version number: When this number is zero, it represents a minor release, which typically introduces new features or
enhances existing functionality, as well as including changes from any previous patch releases. A connection between dierent minor releases (but the same primary release) of HP ZCentral Remote Boost Sender and HP ZCentral Remote Boost Receiver should function at an acceptable level of quality.
3 Patch version number: When this number is zero, it represents a patch release, which is typically only for xing major
security issues or defects. A connection between dierent patch releases (but the same primary release) of HP ZCentral Remote Boost Sender and HP ZCentral Remote Boost Receiver should function at an acceptable quality.
NOTE: Each release of HP ZCentral Remote Boost is a complete release of the entire product, regardless of
which components have changed.
NOTE: The version numbering changed between HP Remote Graphics Software (RGS) and HP ZCentral
Remote Boost. The last version of RGS is 7.7.x and the rst version of Remote Boost is 2020.0.

Software compatibility with HP ZCentral Remote Boost

HP ZCentral Remote Boost works with most software that runs in windowed mode, including those based on OpenGL and Direct X. Some exceptions include:
Interoperability between dierent versions of HP ZCentral Remote Boost 3
The installation of HP ZCentral Remote Boost Sender disables video overlay surfaces on the sender.
Most OpenGL-based software will adjust to this and still work correctly, but in some cases, the following could happen as a result:
Some OpenGL-based software might display incorrectly.
Media players that use video overlay surfaces might display incorrectly.
If these types of issues occur, likely the software is still trying to use video overlay surfaces even though they are disabled. You can sometimes resolve this issue if the software has an option to disable the use of video overlay surfaces.
NOTICE: HP ZCentral Remote Boost Sender does not support programs in full-screen exclusive mode. This
means that HP ZCentral Remote Boost is not suitable for most full-screen games.

HP ZCentral Remote Boost Sender licensing

HP ZCentral Remote Boost Sender is included with HP Z workstations, HP ZBook mobile workstations, and HP VR backpack workstations. A separate license purchase is not required for HP ZCentral Remote Boost Sender on these products.
HP ZCentral Remote Boost Sender requires a license if installed on any other computer. Further information can be found in the Licensing Guide (see Finding more information on page 4).
NOTE: An HP ZCentral Remote Boost connection can be established without a license; however, a warning
message about the missing license is displayed over the HP ZCentral Remote Boost Receiver window, blocking a signicant portion of the Sender desktop.
NOTE: HP ZCentral Remote Boost Receiver is a free download for all devices.

Finding more information

The following table can be used to nd more information about HP ZCentral Remote Boost.
Table
1-4 Resources and their contents
Resource Contents
HP ZCentral Remote Boost website
http://hp.com/ZCentralRemoteBoost
HP ZCentral Remote Boost at HP Support Center
http://www.hp.com/support/rgs
More HP ZCentral Remote Boost documentation, including the following:
User guides for some previous versions of HP ZCentral Remote Boost. Select HP
Worldwide support
Licensing Guide—Describes how to obtain and install licensing for HP ZCentral
Remote Boost Sender.
QuickSpecs—Describes HP ZCentral Remote Boost system requirements.
ZCentral Remote Boost.
Online chat with an HP technician
Support telephone numbers
NOTE: If your phone call is answered by a voice recognition system and you are
asked to say the name of the product, say "ZCentral Remote Boost."
4 Chapter 1 HP ZCentral Remote Boost overview

2 Getting started

The following procedure is a high-level description of how to get started using HP ZCentral Remote Boost:
1. Install HP ZCentral Remote Boost Sender and HP ZCentral Remote Boost Receiver.
2. Open HP ZCentral Remote Boost Receiver.
3. Start an HP ZCentral Remote Boost session with the sender.
a. On the Home panel of HP ZCentral Remote Boost Receiver, enter the host name or IP address of the
sender, and then press the Enter key or select the Connect button.
b. In the HP ZCentral Remote Boost authentication window that appears, enter the credentials of a
user account that resides on the sender, and then select OK.
If authentication is successful, the HP ZCentral Remote Boost session starts, and the sender desktop appears inside the HP ZCentral Remote Boost Receiver window that opens on the receiver.
NOTE: If the sender desktop was in a locked state when you started the HP ZCentral Remote Boost
session, you must unlock the desktop by entering the credentials again, this time into the logon screen on the sender.
5

3 Installation

Follow the installation instructions for your operating system.
NOTE: Although RGS has a new name, HP ZCentral Remote Boost, the installation parameter names, folders
and executable names have not changed.

Installing HP ZCentral Remote Boost Receiver (Windows)

The installer wizard for the HP ZCentral Remote Boost Receiver allows for both Typical and Custom installations. The Typical installation installs Remote USB and Remote Clipboard. The Typical installation should be suitable for most deployments.
The Custom installation type lets you choose whether you want to install certain features, as well as specify proxy settings. You can perform a custom installation on the command line as well.
IMPORTANT: Windows administrator privileges are required to perform the installation.
NOTE: If the software is already installed, installing a newer version will perform an update. Attempting to
install the same version or an older version will cause the installer to exit without making changes to the system.
NOTE: During the installation process, the installer creates a log le named
rgreceiverInstaller.log in the location specied by the Windows TEMP environment variable.

Performing a custom HP ZCentral Remote Boost Receiver installation using the installer wizard

To perform a custom installation of HP ZCentral Remote Boost Receiver on Windows using the installer wizard:
1. Run ReceiverSetup64.exe, follow the on-screen instructions until you are prompted to choose a
setup type, select Custom, and then select Next.
2. On the Remote USB Conguration page, select the appropriate installation setting for the Remote USB
feature from the following options, and then select Next.
USB devices are Local—Remote USB is not installed on the receiver, and all receiver-side USB
devices always mount to the receiver only, even during an HP ZCentral Remote Boost session.
USB devices are Remote—Remote USB is installed, and all receiver-side USB devices always
mount to the sender only, which means the USB devices are accessible only during an HP ZCentral Remote Boost session. The USB devices cannot mount to the receiver at any time, regardless of the HP ZCentral Remote Boost connection state.
USB devices are Local/Remote—Remote USB is installed, and each USB device has its access set
individually to either the receiver or the sender, depending on when the USB device is plugged in to the receiver.
If a USB device is plugged in to a USB port on the receiver while HP ZCentral Remote Boost
Receiver is disconnected, the USB device becomes accessible by the receiver only.
If a USB device is plugged in to a USB port on the receiver while HP ZCentral Remote Boost
Receiver is connected, the USB device becomes accessible by the sender only.
6 Chapter 3 Installation
You can switch access to a particular device by removing it and then re-inserting it while the HP ZCentral Remote Boost Receiver is in the opposite connection state.
NOTE: This setting controls whether Remote USB components are installed. To change this setting
after installation, you must uninstall and reinstall HP ZCentral Remote Boost Receiver. If installed, Remote USB can be disabled (and re-enabled) later using HP ZCentral Remote Boost Receiver or the HP ZCentral Remote Boost Receiver Conguration tool.
Alternatively, you can override the Remote USB installation setting for individual devices (without a reinstallation) with an advanced option that the installer does not oer (see Conguring the remoting
behavior of individual USB devices (Windows only) on page 55).
3. On the Remote Clipboard Conguration page, select whether you want the Remote Clipboard feature
installed, and then select Next.
NOTE: This setting controls whether Remote Clipboard components are installed. To change this
setting after installation, you must uninstall and reinstall HP ZCentral Remote Boost Receiver. If installed, Remote Clipboard can be disabled (and re-enabled) later using HP ZCentral Remote Boost Receiver or the HP ZCentral Remote Boost Receiver Conguration tool.
4. If the next page of the wizard is titled Proxy Conguration, select the appropriate setting from the
following list, and then select Next. If the next page prompts you to start the installation next, then HP ZCentral Remote Boost automatically detected and used the proxy settings from Internet Explorer, and you can skip this step.
If the receiver accesses the internet through a proxy server, select Use this proxy and enter the
proxy address and port.
If the receiver does not access the internet through a proxy server, leave Do not use a proxy
selected.
IMPORTANT: Proxy server settings must be congured correctly to activate HP ZCentral Remote Boost
Advanced Features. See HP ZCentral Remote Boost Advanced Features on page 34 for more information.
5. Select Install to start the installation process.
6. When prompted, restart the computer to complete the installation.

Performing a custom HP ZCentral Remote Boost Receiver installation on the command line

HP ZCentral Remote Boost command-line options must be preceded by a /z ag and be enclosed in double quotes, with no space before or after the opening double quote and no space before the closing double quote.
If you use multiple commands, separate them with a single space. See the following example:
ReceiverSetup64.exe /z"/autoinstall /agreetolicense"
If you need to include a double quote as part of a parameter (such as for a folder path), then you should precede each of those double quotes with a backwards slash like in the following example:
ReceiverSetup64.exe /z"/autoinstall /agreetolicense /folder=\"C:\RGS Receiver""
NOTE: This command must be issued from the location of the ReceiverSetup64.exe installation le.
Unless a folder path is specied, HP ZCentral Remote Boost is installed in the folder: C:\Program Files \HP\Remote Graphics Receiver.
The following table describes the installation-related command-line options.
Installing HP ZCentral Remote Boost Receiver (Windows) 7
IMPORTANT: The options /autoinstall and /agreetolicense are always required when
performing the installation on the command line.
Table 3-1 Installation options and their descriptions
Option Description
Initiates the installation
/autoinstall
Accepts the license agreement
/agreetolicense
/folder=\"<folder path>\"
/usb={local|remote|localRemote}
/clipboard
/noreboot
/proxy=<IP address>:<port>
Species the folder path to install to, which is the following by default if not specied:
C:\Program Files\HP\Remote Graphics Receiver
NOTE: The folder path C:\Program Files\HP\Remote Graphics
Receiver applies to 64-bit versions of Windows. On 32-bit versions of Windows, the folder path is C:\Program Files\Hewlett-Packard \Remote Graphics Receiver.
Sets the Remote USB installation option, which is localRemote by default if not specied
For a description of each option, see Performing a custom HP ZCentral Remote
Boost Receiver installation using the installer wizard on page 6.
Installs the Remote Clipboard feature
Prevents the computer from restarting at the end of the installation process
Congures proxy settings to allow for activation of HP ZCentral Remote Boost Advanced Features.
IMPORTANT: Activation of HP ZCentral Remote Boost Advanced Features
does not work through a proxy server if the proxy settings are not congured correctly. See HP ZCentral Remote Boost Advanced Features on page 34 for more information.
The following table describes additional command-line options for the installer.
NOTE: If either /help or /viewlicense is used, all other options are ignored.
Table 3-2 Installation options and their descriptions
Option Description
/help
/viewlicense
/autoremove
8 Chapter 3 Installation
Displays the valid command line options
Displays the EULA (End User License Agreement)
Initiates an uninstallation
NOTE: The option /noreboot can be used in conjunction with this option.

Installing HP ZCentral Remote Boost Sender (Windows)

The installer wizard for the HP ZCentral Remote Boost Sender allows for both Typical and Custom installations. The Typical installation installs Remote USB and Remote Clipboard but not smart card redirection. The Typical installation should be suitable for most deployments.
The Custom installation lets you choose whether or not to install certain features. A custom installation can be performed on the command line as well.
IMPORTANT: Windows administrator privileges are required to perform the installation.
NOTE: If an older version of the software is already installed, installing a newer version will perform an
update. Attempting to install the same version or an older version will cause the installer to exit without making changes to the system.
NOTE: During the installation process, the installer creates a log le named rgsenderInstaller.log
in the location specied by the Windows TEMP environment variable.

Installer wizard installation

To perform a custom installation of HP ZCentral Remote Boost Sender on Windows using the installer wizard:
NOTE: The installer wizard might contain additional options not discussed below regarding installation of
beta features. Do not install these features unless instructed to by HP.
1. Run SenderSetup64.exe, follow the on-screen instructions until you are prompted to choose a
setup type, select Custom, and then select Next.
2. On the Remote Boost Sender Conguration page, select whether you want the Remote USB, smart card
redirection, and Remote Clipboard features installed, and then select Next.
NOTE: These settings control whether the features are installed. To change these settings after
installation, you must uninstall and reinstall HP ZCentral Remote Boost Sender. If installed, Remote Clipboard can be disabled (and re-enabled) later using the HP ZCentral Remote Boost Sender Conguration tool.
3. On the Single Sign-On / Easy Login Conguration page, select an authentication method, and then
select Next.
TIP: You can change the authentication method after installation. See Authentication on page 35 for
more information and for a description of each of the authentication methods.
NOTE: If you select Do not enable either, then the standard authentication method will be used.
4. If the next page of the wizard is titled Remote Boost Sender Licensing, complete this step. If the next
page prompts you to start the installation next, then an HP ZCentral Remote Boost Sender license is either already installed or is not required, and you can skip this step.
On the Remote Boost Sender Licensing page, select the appropriate option depending on if you have an HP ZCentral Remote Boost Sender license le ready to install, select Next.
If you chose to install a license le, follow the on-screen instructions to complete that procedure before proceeding to the next step.
NOTE: For a brief overview of HP ZCentral Remote Boost Sender licensing requirements, see HP
ZCentral Remote Boost Sender licensing on page 4. For detailed information and instructions about HP
ZCentral Remote Boost Sender licensing, see Finding more information on page 4 to locate the Licensing Guide.
Installing HP ZCentral Remote Boost Sender (Windows) 9
5. You will be prompted to restart your computer after the HP ZCentral Remote Boost Sender installation is
complete. Select Yes when asked to restart the system.
6. Select Install to start the installation process.
7. When prompted, restart the computer to complete the installation.

Command-line installation

HP ZCentral Remote Boost command-line options must be preceded by a /z ag and be enclosed in double quotation marks, with no space before or after the opening quotation mark and no space before the closing
quotation mark. If using multiple commands, separate them with a single space, as in the following example:
SenderSetup64.exe /z"/autoinstall /agreetolicense"
If you need to include a quotation mark as part of a parameter (such as for a folder path), then precede each quotation mark with a forward slash like in the following example:
SenderSetup64.exe /z"/autoinstall /agreetolicense /folder="C:RGS Sender""
The following table describes the installation-related command-line options.
NOTE: This command must be issued from the location of the SenderSetup64.exe installation le.
NOTE: Unless a folder path is specied, HP ZCentral Remote Boost is installed in the folder C:\Program Files
\HP\Remote Graphics Sender.
IMPORTANT: The options /autoinstall and /agreetolicense are always required when you install
from the command line.
Table 3-3 Installation options and their descriptions
Option Description
/autoinstall
/agreetolicense
/folder=\"<folder path>\"
/usb
/clipboard
/el
—or—
/sso
/rgslicenseserver=[<port>@]<host>
—or—
/rgslicensefile=\"<file path>\"
Initiates the installation
Accepts the license agreement
Species the folder path to install to, which is the following by default:
C:\Program Files\HP\Remote Graphics Sender
NOTE: The folder path C:\Program Files\HP\Remote Graphics Sender applies
only to 64-bit versions of Windows. On 32-bit versions of Windows, the folder path is C:\Program Files\Hewlett-Packard\Remote Graphics Sender.
Installs the Remote USB feature
Installs the Remote Clipboard feature
Enables Easy Login or Single Sign-on
NOTE: If neither option is specied, the standard authentication method will
be used.
IMPORTANT: You can use either /rgslicenseserver or /
rgslicensefile but not both. If neither is used, HP ZCentral Remote Boost
Sender is installed without a license.
/rgslicenseserver—Species the license server that HP ZCentral Remote Boost Sender should acquire a license from during installation
NOTE: If a port is not specied, the default port of the host is used.
10 Chapter 3 Installation
Table 3-3 Installation options and their descriptions (continued)
Option Description
/rgslicensefile—Species the location of a license le on the local system
/noreboot
/smartcard
/enableLegacySecurity
Prevents the computer from restarting at the end of the installation process.
Installs the smart card redirection feature.
Allows the use of legacy security settings, enabling HP RGS 7.4 and earlier receivers to connect without conguring certicates. Not recommended for highest security.
The following table describes additional command-line options for the installer.
NOTE: If you use either /help or /viewlicense, all other options are ignored.
Table 3-4 Installation options and their descriptions
Option Description
/help
/viewlicense
/autoremove
Displays the valid command line options
Displays the EULA (End User License Agreement)
Initiates an uninstallation
NOTE: You can use the option /noreboot with this option.

Installing HP ZCentral Remote Boost Receiver (Linux)

These instructions describe how to install HP ZCentral Remote Boost Receiver on Linux®.
1. Log in as root.
2. Go to the download directory for the HP ZCentral Remote Boost Receiver, and unpack the HP ZCentral
Remote Boost package. HP ZCentral Remote Boost for Linux includes installers specic to Linux distributions. Change to the directory that matches your distribution.
3. Execute the following command:
./install.sh
TIP: Optionally, add the directory /opt/hpremote/rgreceiver to your PATH environment
variable.
4. Enter any of the following installation-related command-line options.
Option Description
-agreeToLicense Accepts the license agreement.
-[no]legacyWacom Enables the previous Wacom pen solution.
NOTE: When this option is provided, the Wacom
pen solution works only with a Linux receiver.
-h
Displays help message.
Installing HP ZCentral Remote Boost Receiver (Linux) 11
Option Description
—or—
-help

Installing HP ZCentral Remote Boost Sender (Linux)

These instructions describe how to install HP ZCentral Remote Boost Sender on Linux.
1. Log in as root.
2. Go to the download directory for the HP ZCentral Remote Boost Sender, and unpack the HP ZCentral
Remote Boost package. HP ZCentral Remote Boost for Linux includes installers specic to Linux distributions. Change to the directory that matches your distribution.
3. Execute the following command:
./install.sh
4. Enter any of the following installation-related command-line options.
Option Description
-agreeToLicense Accepts the license agreement.
-[no]smartcard Enables smart card support without prompting.
-nolicenseconfig Skips the license conguration.
-enableLegacySecurity Allows connections from older RGS Receivers.
-h
—or—
-help
5. If the sender has the pcsc-lite package installed, the installer gives you the option to install smart card
redirection. By default, this feature does not install.
Displays help message.

Installing HP ZCentral Remote Boost Receiver (macOS)

On macOS®, you can install HP ZCentral Remote Boost Receiver using the installer wizard or on the command line.
NOTE: If the software is already installed, the installation process overwrites it.

Installer wizard installation

You can use the wizard to install HP ZCentral Remote Boost Receiver.
1. Log in as an administrator (or be able to provide administrator credentials).
2. Run HP RGS Receiver.pkg, and then follow the on-screen instructions.

Command-line installation

Execute the following command:
12 Chapter 3 Installation
sudo installer -pkg “HP\RGS\Receiver.pkg” -target /
NOTE: To install HP ZCentral Remote Boost Receiver in a location other than the root of the boot volume,
enter /Volumes/OtherDrive instead of / at the end of the command.
Installing HP ZCentral Remote Boost Receiver (macOS) 13
4 HP ZCentral Remote Boost Receiver
overview
The HP ZCentral Remote Boost Receiver runs locally.

Opening HP ZCentral Remote Boost Receiver

To open HP ZCentral Remote Boost Receiver, use one of the following procedures.

Opening HP ZCentral Remote Boost Receiver on Windows

To open HP ZCentral Remote Boost Receiver on Windows:
Perform the action in the following table that corresponds to the operating system of the receiver.
Table 4-1 Windows operating systems and their procedures
Operating system Procedure
Windows 10 Select Start , type HP ZCentral Remote Boost, and then select HP HP ZCentral
Remote Boost Receiver from the search results.

Opening HP ZCentral Remote Boost Receiver on Linux

To open HP ZCentral Remote Boost Receiver on Linux:
Run the executable le /opt/hpremote/rgreceiver/rgreceiver.sh.
– or –
Select either the Applications or Activities menu, and then select HP ZCentral Remote Boost Receiver.

Opening HP ZCentral Remote Boost Receiver on macOS

To open HP ZCentral Remote Boost Receiver on macOS:
Select the HP Remote Boost icon in Launchpad.
TIP: HP ZCentral Remote Boost Receiver can alternatively be started on the command line (see HP ZCentral
Remote Boost Receiver command-line options on page 24).

HP ZCentral Remote Boost Receiver GUI (Windows/Linux)

Several items are displayed on the GUI.
14 Chapter 4 HP ZCentral Remote Boost Receiver overview
Table 4-2 GUI items and their descriptions
Item Description
1 Enter the host name or IP address of the sender in this eld.
TIP: The drop-down list contains recent entries.
2 Initiates the connection.
3 Opens the Settings panel (see HP ZCentral Remote Boost Receiver settings on page 19 for more information).
4 Opens the Info panel, which contains version information and the End User License Agreement (EULA) for HP ZCentral
Remote Boost, as well as third-party acknowledgments.
5 Opens the User Guide (this document).

HP ZCentral Remote Boost Receiver GUI (macOS)

Several items are displayed on the GUI.
Table
4-3 GUI items and their descriptions
Item Description
1 Enter the host name or IP address of the sender in this eld.
TIP: The drop-down list contains recent entries.
2 Initiates the connection.

Starting an HP ZCentral Remote Boost session

To start an HP ZCentral Remote Boost session:
1. On the Home panel of HP ZCentral Remote Boost Receiver, enter the host name or IP address of the
sender, and then press the Enter key or select the Connect button.
2. This step depends on the authentication method you are using (see Authentication on page 35).
Enter the credentials as required by the authentication method.
HP ZCentral Remote Boost Receiver GUI (macOS) 15
If authentication is successful, the HP ZCentral Remote Boost session starts, and the sender desktop appears inside the HP ZCentral Remote Boost Receiver window that opens on the receiver.
Note the following additional information about creating an HP ZCentral Remote Boost connection:
You cannot connect to more than one sender at a time using the GUI of HP ZCentral Remote Boost Receiver. If an attempt is made to connect to a second sender, the connection to the rst sender is terminated. For information about how to connect to more than one sender at a time, see Directory
Mode on page 57.

HP ZCentral Remote Boost Receiver window GUI (Windows/ Linux)

Several items are displayed on the GUI.
Table 4-4 GUI items and their descriptions
Item Description
1 The HP ZCentral Remote Boost Receiver toolbar provides easy access to the most frequently used options (see HP
ZCentral Remote Boost Receiver toolbar GUI (Windows/Linux) on page 16 for more information).
2 Scroll bars appear if the resolution of the sender is larger than the size of the HP ZCentral Remote Boost Receiver window.

HP ZCentral Remote Boost Receiver toolbar GUI (Windows/Linux)

Several icons are displayed in the GUI.
16 Chapter 4 HP ZCentral Remote Boost Receiver overview
Table 4-5 Icons and their descriptions
Icon Description
By clicking and holding the left mouse button while moving the mouse, the toolbar may be moved horizontally.
Allows the toolbar to be pinned or unpinned to the Receiver window. If it is unpinned, it will hide when not in use. To unhide the toolbar, hover the mouse near the top of the Receiver window.
Displays the current status of HP Velocity (see HP Velocity on page 34 for more information).
Displays the current network bandwidth consumed by the connection.
Displays the number of image updates in frames-per-second.
Opens the virtual keyboard (see Using touch features (Windows touch-capable devices only) on page 50 for more information).
Enables the virtual mouse (see Using touch features (Windows touch-capable devices only) on page 50 for more information).
TIP: The virtual mouse also can be enabled and disabled using the 4-nger tap gesture.
Toggles Setup Mode (see Setup Mode on page 18).
Sends a virtual Ctrl+Alt+Del command to the sender.
Opens the Settings panel (see HP ZCentral Remote Boost Receiver settings on page 19 for more information).
Adds borders to the HP ZCentral Remote Boost Receiver window, allowing it to be moved and resized.
Removes borders from the HP ZCentral Remote Boost Receiver window.
Makes the HP ZCentral Remote Boost Receiver window expand to ll the boundaries of the current active monitor screen.
Enables 1:1 Pixel Mode, which causes the remote desktop to be displayed at the exact same size on the HP ZCentral Remote Boost Receiver window. If the remote desktop is larger than the HP ZCentral Remote Boost Receiver window, scroll bars are added to the window. If the remote desktop is smaller, a black area is added around the desktop.
Enables Scaled Pixel Mode, which causes the remote desktop to be scaled to ll the HP ZCentral Remote Boost Receiver window. Black bars might be added either horizontally or vertically to keep the same aspect ratio.
HP ZCentral Remote Boost Receiver window GUI (Windows/Linux) 17

HP ZCentral Remote Boost Receiver window GUI (macOS)

Several items are displayed on the GUI.
Table 4-6 GUI items and their descriptions
Item Description
1
2 Displays the number of image updates in frames-per-second.
3 Scroll bars appear if the resolution of the sender is larger than the size of the HP ZCentral Remote Boost Receiver window,

Setup Mode

In Setup Mode, transmission of keyboard and mouse input to the sender is suspended. Instead, the keyboard and mouse can be used to interact with the HP ZCentral Remote Boost Receiver window on the receiver. In this mode, you can do the following:
The HP ZCentral Remote Boost Receiver menu bar provides easy access to the most frequently used options via the following menus:
HP ZCentral Remote Boost Receiver: Lets you view version information, change settings (see HP ZCentral Remote Boost Receiver settings on page 19), and quit HP ZCentral Remote Boost Receiver.
NOTE: HP ZCentral Remote Boost settings are also known as preferences on macOS.
Connection: Lets you enable Setup Mode (see Setup Mode on page 18), send a virtual Ctrl+Alt+Del command to the
sender, and disconnect from the sender.
View: Lets you select 1:1 Pixel Mode or Scaled Pixel Mode. Also, lets you switch among windowed, borderless, or full-
screen window modes.
Image Quality: Lets you set the image quality (see Performance on page 20 for more information).
Help: Lets you open the User Guide (this document).
or when the Receiver window is adjusted below the size of the sender resolution.
Move an HP ZCentral Remote Boost Receiver window that has its title bar and borders hidden
Select (bring to the front) a specic HP ZCentral Remote Boost Receiver window that might be obscured
by another HP ZCentral Remote Boost Receiver window in Directory Mode
The following Setup Mode HotKeys can be used to control the HP ZCentral Remote Boost Receiver
application:
M: Display the HP ZCentral Remote Boost Receiver Settings window.
18 Chapter 4 HP ZCentral Remote Boost Receiver overview
Loading...
+ 93 hidden pages