The following deployment instructions and information about library dependencies are provided for VMware distribution partners. These instructions describe how to deploy Horizon Client for Linux and individual Horizon Client components using tar.gz packages.
For instructions on how to install Horizon Client for Linux using the .bundle, .deb, or .rpm installer file, see Installing Horizon Client for Linux.
Download the VMware-Horizon-Client-Linux-YYMM-x.x.x-yyyyyyyy.tar.gz file from the VMware Downloads site and extract the contents of the downloaded tar.gz package to your system, where YYMM is the marketing version number, x.x.x is the internal version number, and yyyyyyyy is the build number.
Navigate to the folder for your CPU instruction set architecture. You will find additional tar.gz packages for individual Horizon Client components. For example, in the x64 folder you will find the following tar.gz packages for Horizon Client.
Use the following deployment instructions for each of the tar.gz packages.
Horizon Client for Linux
The VMware-Horizon-Client-YYMM-x.x.x-yyyyyyyy.ARCH.tar.gz package contains the VMware Horizon Client binaries. Use the following instructions as a guide for configuring the VMware Horizon Client binary files.
The VMware-Horizon-PCoIP-YYMM-x.x.x-yyyyyyyy.ARCH.tar.gz package contains the mandatory binaries used by both display protocols, PCoIP and VMware Blast. Use the following instructions as a guide for configuring the Horizon Client display protocol files.
Extract the VMware-Horizon-Client-YYMM-x.x.x-yyyyyyyy.ARCH.tar.gz package.
Navigate to the extracted folder, VMware-Horizon-Client-YYMM-x.x.x-yyyyyyyy.ARCH. Move the contents of the usr folder to the /usr folder. Depending on your particular Linux environment, you can choose to use a folder different from /usr.
Note: You must have libudev.so.0 in order to run Horizon Client. If libudev.so.0 is not available on the system, create a symbolic link from /usr/lib/vmware/libudev.so.0 to the libudev.so.1 on the system. For example, you can use this command for an Ubuntu system:
sudo ln -s /lib/x86_64-linux-gnu/libudev.so.1 /usr/lib/vmware/libudev.so.0
Extract the contents of the VMware-Horizon-PCoIP-YYMM-x.x.x-yyyyyyyy.ARCH.tar.gz package.
Navigate to the extracted folder, VMware-Horizon-PCoIP-YYMM-x.x.x-yyyyyyyy.ARCH, and copy the contents of the usr folder to the /usr folder. Depending on your particular Linux environment, you can choose to use a folder different from /usr.
Note: To keep the attributes intact, use the
-a option of the
cp command when copying the files from lib folder.
The VMware-Horizon-USB-YYMM-xxx-yyyy.ARCH.tar.gz package contains the binaries used by the USB Redirection feature.
Extract the contents of the VMware-Horizon-USB-YYMM-xxx-yyyy.ARCH.tar.gz package.
Navigate to where the package was extracted and copy the extracted folders to the recommended system folders.
Copy the contents of the bin folder to the /usr/bin folder.
Copy the contents of the lib folder to the /usr/lib folder.
Copy the contents of the init.d folder to the /etc/init.d folder.
Configure the USB Redirection feature, using the following examples for an Ubuntu system as a guide.
Set up USB arbitrator daemon in the system's auto-startup script using one of the following methods, where # refers to 2, 3, 4, or 5, depending on your system's run level.
Create symbolic links using the following command:
sudo ln -s /etc/init.d/vmware-USBArbitrator /etc/rc#.d/S50vmware-USBArbitrator
/etc/init.d/vmware-USBArbitrator start in your system's /etc/rc.local file. Make sure /etc/rc.local has the executable permission.
Automatically stop the USB arbitrator daemon before a system reboot or halt using the following command, where # refers to 0 or 6, depending on your system's run level.
sudo ln -s /etc/init.d/vmware-USBArbitrator /etc/rc#.d/K08vmware-USBArbitrator
Manually start, stop, or restart the USB arbitrator daemon when necessary using the following command:
sudo /etc/init.d/vmware-USBArbitrator [start|stop|restart]
Serial Port Redirection
To install the Serial Port Redirection feature, see the README file included in the VMware-Horizon-serialportClient-YYMM-x.x.x.yyyyyyyy.ARCH.tar.gz file, which is available with the VMware-Horizon-Client-Linux-YYMM-x.x.x-yyyyyyyy.tar.gz file that you downloaded earlier from the VMware Downloads site.
To install the Scanner Redirection feature, see the README file included in the VMware-Horizon-scannerClient-x.x.x.yyyyyyyy.ARCH.tar.gz file, which is available with the VMware-Horizon-Client-Linux-YYMM-x.x.x-yyyyyyyy.tar.gz file that you downloaded earlier from the VMware Downloads site.
VMware Integrated Printing
To install the VMware Integrated Printing feature, see the README file included in the VMware-Horizon-integratedPrinting-x.x.x.yyyyyyyy.ARCH.tar.gz file, which is available for download from the VMware Downloads site.
HTML5 Multimedia Redirection
To install the HTML5 Multimedia Redirection feature, see the README file included in the VMware-Horizon-html5mmr-x.x.x-yyyyyyyy.ARCH.tar.gz file, which is available for download from the VMware Downloads site.
File Type Association
To install the File Type Association feature, see the README file included in the VMware-Horizon-fileAssociation-YYMM-x.x.x-yyyyyyyy.ARCH.tar.gz file, which is available with the VMware-Horizon-Client-Linux-YYMM-x.x.x-yyyyyyyy.tar.gz file that you downloaded earlier from the VMware Downloads site.
The following libraries are required for building and running Horizon Client for Linux.
The following environment variables are required for building Horizon Client for Linux with the Seamless Window feature.
After you install the Horizon Client components, locate the /bin directory in the Horizon Client package that you extracted earlier. From that bin directory, run the
vmware-view-lib-san script, which checks the build dependencies.
Microsoft Teams Optimization and HID Features
To configure the Teams Optimization and HID-compliant features on a thin client, perform the following steps using an administrator account.
On the thin client, modify the /etc/hosts file by adding the following entry:
Set the correct access mode on libwebrtc_sharedlib.so as follows:
chmod +755 /usr/lib/vmware/view/vdpService/webrtcRedir/libwebrtc_sharedlib.so
To configure the HID-compliant features, create a file named vmware_hid.rules and add the following entries to it:
Copy the vmware_hid.rules file to /etc/udev/rules.d.
Reload the udev rules as follows:
sudo udevadm control --reload-rules && sudo udevadm trigger