Setting Up for Linux Desktops

Cause
The Horizon Agent installer might fail to register a Linux machine with View Connection Server for the
following reasons:
n
The View Connection Server FQDN, domain name, user name, or password that was provided during
Horizon Agent installation was incorrect.
n
The View administrator user does not have the Agent Registration Administrators or Administrators
role in View Administrator. Specifically, the Register Agent privilege is required to register Horizon
Agent with View Connection Server. Agent Registration Administrators is a restricted role that
provides this minimum privilege.
n
The View administrator password contains a special character, such as $, that was not escaped with a
backslash.
n
Reversible password encryption was not enabled for the administrator's Active Directory (AD) account.
For details about enabling this policy, see “Enable Reversible Password Encryption,” on page 45.
Solution
1 Verify that you have the correct View Connection Server FQDN, domain name, user name, and
password.
2 Verify that the View administrator user has the privileges to allow Horizon Agent registration.
a In View Administrator, select View Configuration > Administrators.
b In the Administrators and Groups tab, select the View administrator user that you provided during
Horizon Agent installation.
c Verify that the user has the Agent Registration Administrators or Administrators role.
3 If the View administrator password includes a special character, escape the special character with a
backslash.
For example: ab\$cdef
4 On the Linux machine, open the Horizon Agent registration log file and look for error messages.
/var/log/vmware/viewagent-registration.log
5 If the authentication mechanism is DIGEST-MD5, that is, the -k option is not specified, ensure that the
AD policy Store password using reversible encryption is enabled for the user that you specified.
6 If the authentication mechanism is Kerberos, ensure that the -k option specifies the AD server's correct
address and that the -b option specifies the Connection Server instance's full computer name, including
the host name and the domain name.
7 Install Horizon Agent on the Linux virtual machine again.
Troubleshooting an Unreachable Horizon Agent on a Linux Machine
View Connection Server cannot communicate with Horizon Agent on a Linux virtual machine.
Problem
In View Administrator, the Linux virtual machine is displayed as Agent Unreachable. This problem occurs
after Horizon Agent was installed and the Horizon Agent service started successfully on the Linux machine.
Cause
One cause might be that the Linux machine cannot resolve the FQDNs of the View Connection Server
instances.
Setting Up Horizon 7 for Linux Desktops
100 VMware, Inc.