Skip to content

Installing the Standard Agent for Linux on Ubuntu

Important: Required ports will be automatically opened

The Standard Agent for Linux installer will add firewall exceptions for the following required PCoIP ports during installation: TCP 443, TCP 4172, UDP 4172, and TCP 60443.

Important: IP Configuration Considerations

For the Anyware Agent installation to complete successfully, the RHEL/Rocky 8 host machine must be configured to use both IPv4 and IPv6.

To install the Standard Agent for Linux software:

  1. Download and install the repository, via the shell script provided here.
  2. Optionally install USB dependencies, if you intend to support USB devices other than keyboards, mice, and pointer devices. If you skip this step, USB redirection will be completely disabled and bridged USB devices will not work.

    sudo apt install usb-vhci-dkms
    1. Install the Anyware Standard Agent for Linux:

    sudo apt update
    sudo apt install pcoip-agent-standard
    1. Note your machine's local IP address. Clients connecting directly to the host workstation will need this number to connect. 1. Enter the license registration code you received from us.

    Note: These instructions are for Cloud Licensing

    These instructions assume you are using Anyware Cloud Licensing to activate your PCoIP session licenses. If you are using the License Server instead, see Licensing the Standard Agent for Linux.

    For unproxied internet connections, type:

    pcoip-register-host --registration-code=<XXXXXX@YYY-YYYY-YYY>

    For proxied internet conections, type:

    pcoip-register-host --registration-code=<XXXXXX@YYY-YYYY-YYY> --proxy-server=<serverURL> --proxy-port=<port>
    1. Reboot the desktop.

Installing on stock Ubuntu 18.04 installations

When connecting to the Standard Agent for Linux installed on a stock Ubuntu 18.04 installation, users may not be able to establish PCoIP sessions. You can work around this issue by setting the pcoip.desktop_session value in pcoip-agent.conf:

  1. Open /etc/pcoip-agent/pcoip-agent.conf in a text editor

  2. Add the following line:

    pcoip.desktop_session = ubuntu
  3. Save and close the editor.

Note: Desktop user interfaces will only be available using PCoIP

Once installed and running, the Anyware Standard Agent for Linux takes over the graphics subsystem which is then unavailable to hypervisors. You can only view the graphical user interface when connecting with a Anyware client.

For example, you cannot view an ESXi virtual machine console through VSphere; you must connect to the machine using PCoIP.

GNOME Display Manager Support

  • GNOME Display Manager (GDM) is now supported by the Standard Agent for Linux as a credential authenticator when gdm-runtime-config is available. This allows PCoIP sessions to be locked and unlocked within the remoted session. When the PCoIP service starts, GDM is configured to run without obstructing access to the GPU. This configuration is reverted when the PCoIP service stops. This behavior is always on and requires no configuration on the Anyware agent. For more information on GDM, see the GNOME Display Manager Reference Manual.

Installing USB Drivers on Secure Boot Enabled Linux Machines

If Secure Boot is enabled on a Linux host machine deployed on an ESXi resource, USB drivers cannot be installed on the host machine. This prevents the client-side USB devices from getting bridged to the host machine. To prevent this from occurring, perform the following steps, provided that you have access to the UEFI Firmware Menu.

Note: If You Do Not Have UEFI Firmware Menu Access

If you do not have access to the UEFI Firmware Menu, either disable Secure Boot or deploy the Virtual Machine without Secure Boot.

  1. Connect to the remote host machine via SSH.

  2. Run the following command:

    sudo mokutil --import /var/lib/dkms/
  3. If the Machine Owner Key (MOK) is not set, the mokutil utility will prompt you to create one.

  4. Reboot the machine.

  5. Enroll the MOK in the UEFI firmware menu.

  6. Reboot the machine again.

  7. Run the following commands:

    lsmod | grep usb
    dmesg | grep vhci

The output of this command indicates that usb-vhci is installed on the host machine.

After Installation

Once you've installed the software, you can configure it, register licenses, or connect to it.