Skip to content

Connecting to Teradici PCoIP Remote Workstation Cards

You can connect to remote workstations with a Teradici PCoIP Remote Workstation Card and PCoIP Host Software installed. Refer to System Requirements for supported versions.

Initial Workstation Configuration

Before you can connect to your remote workstation for the first time, a few things must be configured on the host machine.

These configuration actions only need to be taken once on each remote workstation in your system:

  • Enable monitor emulation for the video ports on your remote workstation

    If monitor emulation is not enabled, you may see blank gray screens when you connect from the PCoIP Software Client.

    To enable monitor emulation, log in to the card’s Administrator Web Interface (AWI) and select Enable Monitor Emulation on Video Port n from the Configuration > Monitor Emulation menu. For more information, see the Tera2 PCoIP Zero Client Firmware 4.x and Remote Workstation Card Firmware 4.9 Administrators' Guide.

  • Disable temporal dithering

    Temporal dithering causes blurriness, heavy packet loss, and high CPU usage on the PCoIP Software Client machine. See Should I disable the dithering feature of my graphics card in a remote workstation environment? (KB 15134-207) for more information.

  • Linux workstations: configure PCoIP Host Software to Start Automatically

    To configure the PCoIP host software to start automatically, log into the workstation using a PCoIP Zero Client or directly from a local mouse and keyboard, and modify the workstation startup script to launch the PCoIP host software. For details, see Installing PCoIP Host Software Binary RPM in the PCoIP® Host Software for Linux User Guide.

Connecting to a Remote Workstation Card

Once the remote workstation is properly configured, you can connect to it from the PCoIP Software Client.

Workstation configuration is required before connecting

If you experience connection problems or degraded performance, make sure that the workstation is configured as described in Initial Workstation Configuration.

Direction Connection to a Remote Workstation Card

The direct connection from the PCoIP Software Client to the PCoIP Remote Workstation Card is supported through the PCoIP Remote Workstaton Agent software which needs to be installed on the workstation where the PCoIP Remote Workstation Card is installed. Both the NIC of the workstation and the Remote Workstation Card need to be connected to the same network switch. When establishing a connection, the PCoIP Software Client should connect to the IP or FQDN of the workstation, instead of the IP or FQDN of the PCoIP Remote Workstation Card.

Cloud Access Software Subscription

You need to have a valid Cloud Access Software Subscription to use the PCoIP Remote Workstation Card Agent.

Direct Connection to PCoIP Remote Workstation Cards

PCoIP brokering can now be used to connect to the Remote Workstation Card. You can still connect to a non-brokered Remote Workstation Card by connecting to the FQDN of the workstation instead of the FQDN of the Remote Workstation Card. This method of connection requires the PCoIP Remote Workstation Card agent to be installed on the workstation.

Connecting to a PCoIP Remote Workstation Card through the command line

You can have a direct connection to a PCoIP Remote Workstation card, from a PCoIP Software Client, without requiring a PCoIP Remote Workstation Card agent installed on the host machine if you connect via the command line by using the --hard-host option.

Connecting to a remote workstation with a Teradici PCoIP Remote Workstation Card installed:

  1. Double-click the PCoIP Client desktop icon, alias, or program file (PCoIPClient) to launch the application.

    Alt Text

  2. In the Host Address and Code box, enter the fully-qualified computer name or IP address of the Teradici PCoIP Remote Workstation Card installed in the remote workstation. This only works for direct connection to a legacy firmware releases. For the latest PCoIP Remote Workstation Card firmware, this must be the address of the broker.

  3. Optional: In the Connection Name box, enter a name for your connection. This field accepts any Unicode character.

    The Connection Information can be saved

    If you provide a connection name now, you will have the option of saving the connection after you are authenticated. Saved connections can be quickly recalled later, without manually re-entering connection information.

  4. Click NEXT.

    A short interface delay is normal

    When a session is first connected, it may take a few seconds before you can take control of the keyboard and mouse. This is normal behavior.

  5. If your desktop is locked upon connection and requires you to enter Ctrl+Alt+Delete to log in, select Connection > Send CTRL-ALT-DEL from the PCoIP Software Client menu bar.

PCoIP Remote Workstation Card Feature Compatibility

Not all features with the Software Client are fully supported when connecting to a PCoIP Remote Workstation Card. The following section outlines these limitations against certain features.

Audio: PCoIP Remote Workstation Card uses a hardware based audio protocol which is not fully supported on the Software Client.

Topology: Single display configuration will work. There may be disruptions in the forms of black bars or scroll bars on the client if the PCoIP Remote Workstation Card does not support the display configuration on the client. The worst instance of this disruption will occur for some client configurations that don't work with the hard host configuration.

USB: Connecting USB devices to the PCoIP Remote Workstation Card is not supported.

Performance: Updated to support PCoIP Ultra are not applicable to the PCoIP Remote Workstation Card.