VMware Horizon View Agent DirectConnection Plugin Administration Horizon View 5.3 View Agent 5.3 This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs.
VMware Horizon View Agent Direct-Connection Plugin Administration You can find the most up-to-date technical documentation on the VMware Web site at: http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: docfeedback@vmware.com Copyright © 2013 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
Contents VMware Horizon View Agent Direct-Connection Plugin Administration 5 1 Set Up and Install VMware Horizon View Agent Direct-Connection Plugin 7 VMware Horizon View Agent Direct-Connection Plugin System Requirements Install VMware Horizon View Agent Direct-Connection Plugin 7 Uninstall VMware Horizon View Agent Direct-Connection Plugin 7 8 2 VMware Horizon View Agent Direct-Connection Plugin Advanced Configuration 9 VMware Horizon View Agent Direct-Connection Plugin Configuration Settings Disab
VMware Horizon View Agent Direct-Connection Plugin Administration 4 VMware, Inc.
VMware Horizon View Agent Direct-Connection Plugin Administration VMware Horizon View Agent Direct-Connection Plugin Administration provides information about installing and configuring VMware Horizon View Agent Direct-Connection Plugin. This plugin is an installable extension to View Agent that allows a View Client to directly connect to a View desktop without using View Connection Server.
VMware Horizon View Agent Direct-Connection Plugin Administration 6 VMware, Inc.
Set Up and Install VMware Horizon View Agent Direct-Connection Plugin 1 Installing the Horizon View Agent Direct-Connection Plugin involves verifying that the View desktop meets certain system requirements and then running the plugin installer on the virtual machine.
VMware Horizon View Agent Direct-Connection Plugin Administration Procedure 1 Log in to the virtual machine as an administrator and launch the installer that is appropriate for your operating system. Operating System Installer Windows 64-bit VMware-viewagent-direct-connection-x86_64-x.y.z-nnnnnn.exe Windows 32-bit VMware-viewagent-direct-connection-x.y.z-nnnnnn.exe The installer confirms that the correct version of the Windows operating system and View Agent is installed.
VMware Horizon View Agent DirectConnection Plugin Advanced Configuration 2 You can use the default Horizon View Direct-Connection Plugin configuration settings or customize them through Windows Active Directory group policies (GPOs) or by using specific Windows registry settings.
VMware Horizon View Agent Direct-Connection Plugin Administration Table 2‑1. Direct-Connection Plugin Configuration Settings (Continued) 10 Setting Registry Value Type Description Disclaimer Enabled disclaimerEnabled REG_SZ Value is set to TRUE or FALSE. If set to TRUE, show disclaimer text for user acceptance at login. The text is shown from 'Disclaimer Text' if written, or from the GPO Configuration\Windows Settings\Security Settings\Local Policies\Security Options: Interactive logon.
Chapter 2 VMware Horizon View Agent Direct-Connection Plugin Advanced Configuration Table 2‑1. Direct-Connection Plugin Configuration Settings (Continued) Setting Registry Value Type Description External Framework Channel Port externalFrameworkCha nnelPort REG_SZ The port number sent to the View Client for the destination TCP port number that is used for the Framework Channel protocol. A + character in front of the number indicates a relative number from the port number used for HTTPS.
VMware Horizon View Agent Direct-Connection Plugin Administration Disabling Weak Ciphers in SSL/TLS You can ensure that View Client to View desktop communications that use SSL/TLS protocol do not allow weak cryptographic ciphers by using this View desktop hardening procedure. The configuration for disabling weak ciphers is stored in the Windows registry. Changes to these settings must be done on all desktop operating systems that run View Agent Direct-Connection Plugin.
Chapter 2 VMware Horizon View Agent Direct-Connection Plugin Advanced Configuration Certificates with Subject Alternative Name (SAN) and wildcard certificates are supported. NOTE To distribute the CA signed SSL Server Certificates to a large number of View desktops using the View Agent Direct-Connection Plugin, use Active Directory Enrollment to distribute the certificates to each virtual machine. For more information see: http://technet.microsoft.com/en-us/library/cc732625.
VMware Horizon View Agent Direct-Connection Plugin Administration Figure 2‑2. PCoIP From a Client via a NAT Device Showing the Failure NAT PNAT IP address 10.1.1.9 IP address 192.168.1.1 View Desktop PCoIP Client TCP DST 192.168.1.1:4172 SRC 10.1.1.9:? PCoIP server To resolve this problem, you must configure the plugin to use an external IP address. If externalIPAddress is configured as 10.1.1.1 for this desktop, the plugin gives the client an IP address of 10.1.1.
Chapter 2 VMware Horizon View Agent Direct-Connection Plugin Advanced Configuration Advanced Addressing Scheme When you configure several View desktops to be accessible through a NAT and port mapping device on the same external IP address, you must give each View desktop a unique set of port numbers. The clients can then use the same destination IP address, but use a unique TCP port number for the HTTPS connection to direct the connection to a specific virtual desktop.
VMware Horizon View Agent Direct-Connection Plugin Administration View Client would connect to IP address 10.20.30.40 and an HTTPS destination port number of (1000 + n * 5) where n is the View desktop number. To connect to View desktop 3, the client would connect to 10.20.30.40:1015. This addressing scheme significantly simplifies the configuration setup for each View desktop. All desktops are configured with identical external address and port configurations.
Troubleshooting the VMware Horizon View Agent Direct-Connection Plugin 3 When using the Horizon View Agent Direct-Connection Plugin, you might encounter some known issues and have to troubleshoot them. When you investigate a problem with the Horizon View Agent Direct-Connection Plugin, make sure that the correct version is installed and running. In the example above, the plugin version details are version=e.x.p build-855808, buildtype=release.
VMware Horizon View Agent Direct-Connection Plugin Administration 2012-10-01T12:09:59.078+01:00 INFO (09E4-0C08) [MessageFrameWork] Plugin 'wsnm_xmlapi - VMware View Agent XML API Handler Plugin' loaded, version=e.x.p build- 855808, buildtype=release 2012-10-01T12:09:59.
Index A authorizing View Client 13 C configuration settings for View Agent DirectConnection Plugin 9 D Disabling Weak Ciphers 12 H Horizon View Agent Direct-Connection Plugin 5 Horizon View Agent direct-connection plug-in advanced configuration configuration 9 Horizon View Agent Direct-Connection Plugin enable full logging 17 I incorrect graphics driver 18 installing Horizon View Agent Direct-Connection Plugin 7 Insufficient video RAM 18 N Network Address Translation 13 P port mapping 15 Port Mapping
VMware Horizon View Agent Direct-Connection Plugin Administration 20 VMware, Inc.
