Connections from Software Clients

Connections from a Teradici 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 Teradici 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 Teradici 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 Teradici 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 Teradici Software Client to a Remote Workstation Card across a WAN will require a VPN with enterprise level NATing devices.

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 using the Remote Workstation Card Agent:

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

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

  3. License your Remote Workstation Card Agent.

  4. From your Software Client interface enter the IP address or FQDN of the host computer in the Host Address or Code: field connect.

  5. Connect to your Remote Workstation Card host computer.

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

  1. Confirm the Remote Workstation Card Software is installed on your 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>