The install_viewagent.sh script installs Horizon Agent on a Linux guest operating system.

Use the following form of the install_viewagent.sh script in a command window in the gnome desktop environment.

install_viewagent.sh command_option argument [command_option argument] . . .

The install_viewagent.sh script includes mandatory and optional parameters.

Table 1. install_viewagent.sh Mandatory Parameters

Mandatory Parameter

Description

-b

FQDN or IP address of the View Connection Server instance if the authentication mechanism is DIGEST-MD5. If the authentication mechanism is Kerberos, specify the real FQDN and not the IP address or a mapped FQDN.

-d

Domain name of the Broker administrator. For example: mydomain.com

-u

User name of the View Connection Server administrator. For example: myadmin

The administrator must 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.

Table 2. install_viewagent.sh Password Parameter

Optional Parameter (Required Information)

Description

-p

Password for the View Connection Server administrator.

You do not have to type the -p parameter at the command line if you do not want to expose the password in text. If you type the install_viewagent.sh command without the -p parameter, you are prompted to enter the password. When you type the password at the prompt, the text is hidden.

You must provide the password, either with the -p parameter or at the prompt.

If the password contains a special character such as $ within the shell in which the installer is executed, make sure the special character is escaped. For example: ab\$cdef

-A yes

EULA acceptance. You must specify yes for the install to proceed. If this parameter is not specified, the install script prompts for the value.

Table 3. install_viewagent.sh Optional Parameters

Optional Parameters

Description

-n

Machine name that is registered to View Connection Server. By default, the Horizon Agent installer uses the host name. You can specify your own name.

-s

Subject DN of the self-signed certificate.

By default, the Horizon Agent installer generates a self-signed certificate with the following Subject DN value: '/C=US/ST=California/O=VMware/CN=Hostname.DomainName'. The default CN specifies the host name and domain name of the machine.

You can specify your own Subject DN.

-m yes

Enable smart card redirection.

-j

JMS SSL keystore password. If not specified, the installer will generate a random password.

-k

The Active Directory server's address of the Broker administrator. This is required only for Kerberos authentication.

-r

Reboot the operating system after installation. The allowed values are yes and no. The default is no.

-K

The Active Directory server's address of the Broker host. It is required only for Kerberos authentication when the broker host and the broker admin are from different domains.

-B

Domain name of the Broker host. It is required only for Kerberos authentication when the broker host and the broker admin are from different domains.

Table 4. Examples of install_viewagent.sh Parameters

Condition

Examples

Broker host and Broker admin are from same domain

  • Digest-MD5.

    sudo install_viewagent.sh -A yes -n mymachine -b mybroker.mydomain.com -d mydomain.com -u myadmin -p Pa\$ssword
  • Kerberos.

    sudo install_viewagent.sh -A yes -n mymachine -b mybroker.mydomain.com -d mydomain.com -u myadmin -p Pa\$ssword -k mydomain-host.mydomain.com

Broker host and Broker admin are from different domains

  • MD5-Digest.

    sudo install_viewagent.sh -A yes -n mymachine -b mybroker.mydomain1.com -d mydomain2.com -u myadmin@mydomain2.com-p Pa\$ssword
  • Kerberos.

    sudo install_viewagent.sh -A yes -n mymachine -b mybroker.mydomain1.com -B mydomain1.com -K mydomain1-host.mydomain1.com -d mydomain2.com -u myadmin -p Pa\$ssword -k mydomain2-host.mydomain2.com