Software Client for Windows Administrators' Guide
This release is in Beta. Beta software is not fully supported, and may be incomplete or unstable. It is not intended for use in production systems. We welcome your feedback on this release! Send feedback to anyware-beta-feedback@hp.com.

Connecting to Remote Desktops

The Software Client for Windows can connect to any remote host with a Anyware agent installed and configured, or a Remote Workstation Card. Remote hosts can be Windows, macOS, or Linux, and connections can be made directly (client direct to host) or brokered through Anyware Manager or a Connection Manager.

Note: Remote Workstation Card connections

Connections to Remote Workstation Cards require preparation on the remote machine before they will work.

For details, see Preparing for Remote Workstation Card Connections.

Note: Support for Failover Gateways

The Software Client for Windows supports failover Security Gateways in a Connection Manager and Security Gateway deployment. If the primary gateway used to establish a PCoIP session fails unexpectedly, the session is automatically transferred to the next available gateway.

Session failover is only available if failover gateways are configured on the machines where the Connection Manager and/or Security Gateway are installed. No additional configuration is required on the HP Anyware Clients.

Instructions for configuring failover gateways is available in the topic "Configuring Failover Security Gateways" of the Connection Manager and Security Gateway Administrators' Guide.

Creating Your First Connection

The first step is to create a connection to either your agent (for direct connections) or to your connection manager (for managed deployments).

  1. Launch the Software Client for Windows.

  2. If this is your first connection, the Software Client for Windows will prompt you to create one:

    Click Add a new connection to proceed.

  3. In the Add New Connection pane, there are two fields to provide:

    • Host Address or Registration Code: Enter the address of the remote system you want to reach (you should have this information from your system administrator). This field accepts IP addresses, domain names, and registration codes, as in these examples:

      • An IP address: 123.456.789.012
      • A domain name: remote-desktops.example.com
      • A registration code: a1b2c3!@#

      Note: Amazon WorkSpaces registration codes

      If you are connecting to an Amazon WorkSpaces desktop, provide your WorkSpaces registration code in this field.

    • Connection Name: Provide a name for this connection. This can be anything; you will use this name to select this connection in future sessions. You can always change it later.

  4. Click Add connection.

Once this is done, you'll see the connection you created shown as a clickable button. You can add as many connections as you like, by clicking + Add a new connection at the bottom of the Connect pane.

Tip: Difference from previous workflows

The connections you save here are to brokers, or to direct desktop connections. If you have multiple desktops behind a single broker, you will still have to choose your desired desktop after authenticating with the broker. In the previous interface, you could save connections at any stage of the process, including to individual desktops.

If you have existing saved connections from previous releases, they will continue to work when you upgrade to this client version. However, if they are deleted, they cannot be re-created.

Connecting to a Session

  1. After you have set up at least one connection, the Software Client for Windows will show the available connection options. Click the connection that you want to access.

  2. Next, provide your username and password:

    Note: About authentication credentials

    For managed connections, the authentication screen and validation that happens here is managed by HP Anyware or by your connection broker. The credentials are supplied to you by your system administrators, and are usually your corporate credentials.

    For direct connections where no broker is present, use the credentials for your user account on the remote machine.

  3. If your account requires a password change, provide a new password on the Update connection password screen.

  4. If your system is configured for multi-factor authentication, you will see a Multi-Factor Authentication screen next. The actual view shown here depends on your MFA implementation; in this example, the MFA screen accepts a passcode or sends a push:

  5. Once your credentials are accepted:

    • If you have a single desktop available, your connection credentials will be used to automatically log into it and your session starts immediately.

    • If you have multiple desktops available, the Software Client for Windows shows you a list of desktops. Click the desktop you want to connect to.

Once you are connected, your PCoIP session will begin. The connection will use the display mode you last used (windowed, fullscreen one monitor, or fullscreen all monitors), unless altered by a launch-time configuration.

There may be a delay of a few seconds before you have control of your mouse and keyboard; this is normal.

Note: Access to Clipboard Data

If clipboard redirection is enabled, Anyware clients have access to clipboard data. We recommend that you disable clipboard redirection if you are handling sensitive data.


Last updated: Saturday, November 16, 2024