Skip to content

Connections from Software Clients

Connections from a PCoIP Software Client to Remote Workstation Card require the use of the command line or the installation and licensing of the Remote Workstation Card Agent. Once the Remote Workstation Card Agent is installed and activated on the host computer, clients are required to use the IP address of the host computer NIC or the FQDN of the host computer to connect. Optional host computer changes can improve performance of software client connections. If configuration changes on the host computer are needed, you will need administrator permissions and access to the host computer.

Software Client USB support

USB devices connected to PCoIP Software Client hosts are not supported when connecting to Remote Workstation Cards or Remote Workstation Card Agents.

The following optional configurations are recommended for the best experience when accessing the Remote Workstation Card.

  • Enable monitor emulation on Remote Workstation Card to avoid blank grey screens when you connect. To enable monitor emulation using the AWI, see Configuring Monitor Emulation.

  • Disable temporal dithering as it may cause blurriness, heavy packet loss, and high CPU usage on the PCoIP Software Client machine.See KB 1087 for more information.

Prerequisites

  • You are using the same release of PCoIP Software Client as PCoIP Remote Workstation Card firmware or one release prior. Other software client releases may work but are not supported.

  • The network the Remote Workstation Card and PCoIP Software Client are installed are properly configured and optionally have a 1 Gb connection between them for a better experience.

  • The PCoIP Remote Workstation Card is using Maximum Compatibility encryption. See Configuring a Session

  • For details about PCoIP software client requirements, and instructions on how to configure the client to connect to a Remote Workstation Card, see your Windows, Linux, or macOS software client administrators guide.

Requirements

  • The host computer NIC and the Remote Workstation Card is plugged into the same network.

  • The PCoIP Remote Workstation Card Agent for Windows or Linux is installed and licensed on the host computer.

  • Known IP address:

    • The NIC IP address of the host computer is known for connections via the Remote Workstation Card Agent.

    • The Remote Workstation Card IP address is known for direct connections without the agent.

  • The PCoIP Remote Workstation Card Software for Windows or Linux is installed on the host computer.

    • This requires the Host Firmware Function is enabled. You can enable this setting by logging into Remote Workstation Card from the AWI page—Configuration > Host Driver Function.

What IP address to connect to

When the Remote Workstation Card Agent is installed, the IP address of the Remote Workstation Card is not used. Clients must connect to the IP address of the host computer NIC card.

Connecting Remotely using VPN

The same principles that apply for Zero Clients using a VPN apply to Software Clients when connecting to multiple hosts through a WAN. Connections from a PCoIP Software Client to a Remote Workstation Card across a WAN will require a VPN with enterprise level NATing devices.

Connections with Remote Workstation Card Agent Installed

If you are brokering your PCoIP client to your Remote Workstation Card, you will first need to install the Remote Workstation Card Agent on the host PC that contains the Remote Workstation Card.

The following directions show how to connect a Windows Software Client to Remote Workstation Card installed in a Windows host computer.

To connect from your Software Client to the Remote Workstation Card Agent:

  1. Ensure the Remote Workstation Card and Remote Workstation Card Software is installed on the host computer.

  2. Install the Remote Workstation Card Agent on the host computer that has the Remote Workstation Card installed.

  3. License your Remote Workstation Card Agent.

  4. Ensure your Remote Workstation Card Session configuration is configured to Accept Any Peer or has your client credentials entered (MAC address).

  5. From your Software Client interface enter:

    • the IP address or FQDN of the host computer in the Host Address or Code: field connect for a direct connection.

    • the IP address or FQDN of the connection manager in the Host Address or Code: field connect for a brokered connections.

  6. Connect to your Remote Workstation Card host computer.

Software Client Direct Connections using the Command Line

To connect from your Software Client using the command line without the Remote Workstation Card Agent installed:

  1. Ensure the Remote Workstation Card and Remote Workstation Card Software are installed on the host computer.

  2. Open the command prompt on your client host computer.

  3. Enter the following command:

    • Linux Client: pcoip-client.exe --hard-host <RWC_FQDN or RWC_IP_Address>

    • Windows Client: "pcoip_client.exe --hard-host <RWC_FQDN or RWC_IP_Address>

Create a shortcut

If you have multiple Remote Workstation Cards to connect to on Windows hosts, create shortcuts to each one using the following:

"C:\Program Files (x86)\Teradici\PCoIP Client\bin\pcoip_client.exe" quit-after-disconnect -h <RWC_IP or RWC_FQDN>