Using VMware Horizon Client for Mac OS X Horizon Client 4.1 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.
Using VMware Horizon Client for Mac OS X 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 © 2010–2016 VMware, Inc. All rights reserved. Copyright and trademark information. VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc.
Contents Using VMware Horizon Client for Mac OS X 5 1 Setup and Installation 7 System Requirements for Mac Clients 7 System Requirements for Real-Time Audio-Video 8 Smart Card Authentication Requirements 8 Supported Desktop Operating Systems 9 Preparing Connection Server for Horizon Client 10 Install Horizon Client on Mac OS X 10 Add Horizon Client to Your Dock 11 Configuring Certificate Checking for End Users 11 Configure Advanced TLS/SSL Options 12 Configuring Log File Collection Values 12 Configure V
Using VMware Horizon Client for Mac OS X 4 Using a Microsoft Windows Desktop or Application on a Mac 39 Feature Support Matrix for Mac OS X 39 Internationalization 42 Monitors and Screen Resolution 42 Connect USB Devices 43 Configuring USB Redirection on a Mac OS X Client 45 USB Redirection Properties 47 USB Device Families 49 Turn on Logging for USB Redirection 50 Using the Real-Time Audio-Video Feature for Webcams and Microphones 50 When You Can Use Your Webcam 51 Select a Default Microphone on a Mac OS
Using VMware Horizon Client for Mac OS X Using VMware Horizon Client for Mac OS X provides information about installing and using VMware ® Horizon Client™ software on a Mac to connect to a remote desktop or application in the datacenter. This information is intended for administrators who need to set up a View deployment that includes Mac client devices. The information is written for experienced system administrators who are familiar with virtual machine technology and datacenter operations. VMware, Inc.
Using VMware Horizon Client for Mac OS X 6 VMware, Inc.
Setup and Installation 1 Setting up a View deployment for Mac clients involves using certain Connection Server configuration settings, meeting the client and server system requirements, and downloading and installing Horizon Client for Mac OS X from the VMware Web site. NOTE In Horizon 7 and later, View Administrator is renamed Horizon Administrator. This document uses the name View Administrator to refer to both View Administrator and Horizon Administrator.
Using VMware Horizon Client for Mac OS X n Connection Server, Security Server, and View Agent or Horizon Agent Mac OS X El Capitan (10.11) Latest maintenance release of View 5.3.x and later releases If client systems connect from outside the corporate firewall, VMware recommends that you use a security server. With a security server, client systems will not require a VPN connection. Remote applications are available on Horizon 6.0 with View and later servers.
Chapter 1 Setup and Installation n U.S. Federal Government Personal Identity Verification (PIV), also called FIPS-201 Each client system that uses a smart card for user authentication must have the following software and hardware: n Horizon Client n A compatible smart card reader n Product-specific application drivers You must also install product-specific application drivers on the remote desktops or Microsoft RDS host.
Using VMware Horizon Client for Mac OS X Preparing Connection Server for Horizon Client Administrators must perform specific tasks to enable end users to connect to remote desktops and applications. Before end users can connect to Connection Server or a security server and access a remote desktop or application, you must configure certain pool settings and security settings: n If you plan to use Access Point, which is available with Horizon 6 version 6.
Chapter 1 Setup and Installation n If you plan to use the RDP display protocol to connect to a remote desktop, verify that the Mac client system has Remote Desktop Connection Client for Mac from Microsoft, version 2.0 or later installed. n Verify that you have the URL for a download page that contains the Horizon Client installer. This URL might be the VMware Downloads page at http://www.vmware.com/go/viewclients, or it might be the URL for a Connection Server instance.
Using VMware Horizon Client for Mac OS X You can set the verification mode so that end users cannot change it. Set the "Security Mode" key in the /Library/Preferences/com.vmware.horizon.plist file on Mac clients to one of the following values: n 1 implements Never connect to untrusted servers. n 2 implements Warn before connecting to untrusted servers. n 3 implements Do not verify server identity certificates.
Chapter 1 Setup and Installation If the MaxDebugLogs or MaxDaysToKeepLogs keys are not set in the com.vmware.horizon.plist file, the default number of log files is 5 and the default number of days to keep log files is 7. Configure VMware Blast Options You can configure decoding and network protocol options for remote desktop and application sessions that use the VMware Blast display protocol. Prerequisites This feature requires Horizon Agent 7.0 or later.
Using VMware Horizon Client for Mac OS X Table 1‑2. Data Collected from Horizon Clients for the Customer Experience Improvement Program Is This Field Made Anonymous ? Example Value Company that produced the Horizon Client application No VMware Product name No VMware Horizon Client Client product version No (The format is x.x.x-yyyyyy, where x.x.x is the client version number and yyyyyy is the build number.
Chapter 1 Setup and Installation Table 1‑2. Data Collected from Horizon Clients for the Customer Experience Improvement Program (Continued) Description Is This Field Made Anonymous ? MB of memory on the host system No Example Value Examples include the following: 4096 n unknown (for Windows Store) n Number of USB devices connected No 2 (USB device redirection is supported only for Linux, Windows, and Mac OS X clients.
Using VMware Horizon Client for Mac OS X 16 VMware, Inc.
Using URIs to Configure Horizon Client 2 Using uniform resource identifiers (URIs), you can create a Web page or an email with links that end users click to launch Horizon Client, connect to Connection Server, and launch a specific desktop or application with specific configuration options. You can simplify the process of connecting to a remote desktop or application by creating Web or email links for end users.
Using VMware Horizon Client for Mac OS X The only required element is the URI scheme, vmware-view. For some versions of some client operating systems, the scheme name is case-sensitive. Therefore, use vmware-view. IMPORTANT In all parts, non-ASCII characters must first be encoded according to UTF-8 [STD63], and then each octet of the corresponding UTF-8 sequence must be percent-encoded to be represented as URI characters.
Chapter 2 Using URIs to Configure Horizon Client Table 2‑1. Values That Can Be Used with the action Query (Continued) Value Description reset Shuts down and restarts the specified desktop or remote application. Unsaved data is lost. Resetting a remote desktop is the equivalent of pressing the Reset button on a physical PC. logoff Logs the user out of the guest operating system in the remote desktop.
Using VMware Horizon Client for Mac OS X Examples of vmware-view URIs You can create hypertext links or buttons with the vmware-view URI scheme and include these links in email or on a Web page. Your end users can click these links to, for example, launch a particular remote desktop with the startup options you specify. URI Syntax Examples Each URI example is followed by a description of what the end user sees after clicking the URI link. 1 vmware-view://view.mycompany.
Chapter 2 Using URIs to Configure Horizon Client Horizon Client is launched and connects to the view.mycompany.com server. The login box prompts the user for a user name, domain name, and password. After a successful login, Horizon Client displays a dialog box that prompts the user to confirm the reset operation for Primary Desktop. After the reset occurs, depending on the type of client, the user might see a message indicating whether the reset was successful.
Using VMware Horizon Client for Mac OS X 22 VMware, Inc.
Managing Remote Desktop and Application Connections 3 Use Horizon Client to connect to Connection Server or a security server and log in to or off of a remote desktop, and use remote applications. For troubleshooting purposes, you can also reset remote desktops and applications. Depending on how the administrator configures policies for remote desktops, end users might be able to perform many operations on their desktops.
Using VMware Horizon Client for Mac OS X Connect to a Remote Desktop or Application After you connect to a server, you can use the remote desktops and applications that you are authorized to use. Before you have end users access remote desktops and applications, test that you can connect to remote desktop or application from the client system. To use remote applications, you must connect to Connection Server 6.0 or later.
Chapter 3 Managing Remote Desktop and Application Connections 4 Connect to a server. Option Description Connect to a new server Click the New Server icon on the Horizon Client Home screen, type the server name and port number (if required), and click Connect. An example using a non-default port is view.company.com:1443. Connect to an existing server Double-click the server shortcut on the Horizon Client Home screen.
Using VMware Horizon Client for Mac OS X If Horizon Client cannot connect to the remote desktop or application, perform the following tasks: n Determine whether Connection Server is configured not to use SSL. Horizon Client requires SSL connections. Check whether the global setting in View Administrator for the Use SSL for client connections check box is deselected.
Chapter 3 Managing Remote Desktop and Application Connections Procedure 1 2 3 Open the Preferences dialog box with the Sharing panel displayed. Option Description From the desktop and application selection window Select VMware Horizon Client > Preferences and click Sharing. From the Sharing dialog box that appears when you connect to a desktop or application Click the Preferences > Sharing link in the dialog box.
Using VMware Horizon Client for Mac OS X n From within a remote application, if applicable, select File > Open or File > Save As and navigate to the folder or drive, which appears in the file system as a network drive that uses the naming format foldername on MACHINE-NAME. Connecting to a Server at Horizon Client Launch The Always connect at launch setting is enabled by default for the first server that you connect to with Horizon Client.
Chapter 3 Managing Remote Desktop and Application Connections Configure Horizon Client to Select a Smart Card Certificate You can configure Horizon Client to select a local certificate or the certificate on a smart card when you authenticate to a server by setting a preference. If this preference is not set (the default), you must manually select a certificate.
Using VMware Horizon Client for Mac OS X 3 Configure the keyboard shortcut mappings. Option Action Delete a keyboard shortcut mapping Select the mapping to delete and click the minus (-) button. Add a keyboard shortcut mapping a b Modify a keyboard shortcut mapping 4 Click the plus (+) button. Specify the Apple keyboard shortcut sequence by clicking one or more keyboard modifiers and typing a key code in the text box. You can also select a key from the drop-down menu.
Chapter 3 Managing Remote Desktop and Application Connections n For remote applications, Windows shortcuts that include the Windows key are disabled by default and do not appear on the Horizon Client Keyboard Preferences dialog box. If you create a mapping for one of these disabled keyboard shortcuts, the shortcut appears in the Keyboard Preferences dialog box. For a list of the default OS X keyboard shortcuts, go to the Apple support website ( http://support.apple.com).
Using VMware Horizon Client for Mac OS X 3 4 Configure the default shortcuts. Option Action Enable a shortcut Select the On check box next to the shortcut. When you enable a shortcut, Horizon Client does not send the shortcut to the remote desktop or application. Disable a shortcut Deselect the On check box next to the shortcut. When you disable a shortcut, Horizon Client sends the shortcut to the remote desktop or application.
Chapter 3 Managing Remote Desktop and Application Connections n Do not verify server identity certificates. This setting means that no certificate checking occurs. If the certificate checking mode is set to Warn, you can still connect to a Connection Server instance that uses a self-signed certificate.
Using VMware Horizon Client for Mac OS X Switch Desktops or Applications If you are connected to a remote desktop, you can switch to another desktop. You can also connect to remote applications while you are connected to a remote desktop. Procedure u Select a remote desktop or application from the same server or a different server.
Chapter 3 Managing Remote Desktop and Application Connections Procedure n Disconnect from a remote desktop without logging off. Option Action Disconnect and quit Horizon Client a b Disconnect and remain in Horizon Client Click the Close button in the corner of the window or select File > Close from the menu bar. Select VMware Horizon Client > Quit VMware Horizon Client from the menu bar. Click the Disconnect button in the toolbar or select Connection > Disconnect from the menu bar.
Using VMware Horizon Client for Mac OS X Autoconnect to a Remote Desktop You can configure a server to automatically launch a remote desktop when you connect to the server. If you are entitled to only one remote desktop on a server, Horizon Client automatically launches that desktop when you connect to the server. NOTE You cannot configure a server to automatically launch a remote application.
Chapter 3 Managing Remote Desktop and Application Connections 5 Select an application reconnect behavior option. These options determine how Horizon Client behaves when a user connects to the server and remote applications are still running. 6 Option Description Ask to reconnect to open applications Horizon Client shows the message You have one or more remote applications running. Would you like to open them now? . Users can respond by clicking Reconnect to Applications or Not Now.
Using VMware Horizon Client for Mac OS X 38 VMware, Inc.
4 Using a Microsoft Windows Desktop or Application on a Mac Horizon Client for Mac OS X supports several features.
Using VMware Horizon Client for Mac OS X Table 4‑1. Features Supported on Windows Desktops for Mac OS X Clients (Continued) Windows 7 Desktop Windows Vista Desktop Windows XP Desktop Windows Server 2008/2012 R2 Desktop X X Limited Limited X X X Limited Limited X X Limited Limited X X Limited Limited X Windows 10 Desktop Windows 8.
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mac Table 4‑2. Features Supported for RDS Hosts with View Agent 6.0.x or Later, or Horizon Agent 7.0 or Later, Installed (Continued) Feature Windows Server 2008 R2 RDS Host on a Physical Machine Windows Server 2008 R2 RDS Host on a Virtual Machine Windows Server 2012 RDS Host on a Physical Machine Windows Server 2012 RDS Host on a Virtual Machine Client drive redirection View Agent 6.1.1 and later View Agent 6.1.
Using VMware Horizon Client for Mac OS X Feature Support for Linux Desktops Some Linux guest operating systems are supported if you have View Agent 6.1.1 or later or Horizon Agent 7.0 or later. For a list of supported Linux operating systems and information about supported features, see Setting Up Horizon 6 for Linux Desktops or Setting Up Horizon 7 for Linux Desktops.
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mac Using a High-Resolution Mac with Retina Display When you use the VMware Blast display protocol or the PCoIP display protocol, Horizon Client also supports very high resolutions for those client systems with Retina Display. After you connect to a remote desktop, you can choose the Connection > Resolution > Full Resolution menu item. This menu item appears only if the client system supports Retina Display.
Using VMware Horizon Client for Mac OS X Prerequisites n To use USB devices with a remote desktop, the View administrator must have enabled the USB feature for the remote desktop. This task includes installing the USB Redirection component of the agent, and can include setting policies regarding USB redirection. For more information, see the View Administration document if you are using Connection Server and Agent 5.3.x.
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mac n Configure Horizon Client to connect USB devices automatically to the remote desktop when you plug them in to the local system. Use the autoconnect feature if you plan to connect devices that use MTP drivers, such as Android-based Samsung smart phones and tablets. a Before you plug in the USB device, start Horizon Client and connect to a remote desktop.
Using VMware Horizon Client for Mac OS X Configuration settings on the client might be merged with or overridden by corresponding policies set for View Agent or Horizon Agent on the remote desktop. For information about how USB settings on the client work in conjunction with View Agent or Horizon Agent USB policies, see the topics about using policies to control USB redirection, in the Setting Up Desktop and Application Pools in View document.
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mac Because this composite device includes a component that is ordinarily excluded by default, such as a mouse or keyboard, the fourth line is necessary so that the other components of the composite device Vid-0911_Pid-149a can be redirected to the remote desktop. The first three properties are splitting properties. The last property is a filtering property. Filtering properties are processed before splitting properties.
Using VMware Horizon Client for Mac OS X Table 4‑4. Configuration Properties for USB Redirection (Continued) Policy Name and Property Description Allow HID Property: Allows input devices other than keyboards or mice to be redirected. The default value is undefined, which equates to true. AllowHID Allow HIDBootable Property: Allows input devices other than keyboards or mice that are available at boot time (also known as hid-bootable devices) to be redirected.
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mac Table 4‑4. Configuration Properties for USB Redirection (Continued) Policy Name and Property Description Include Device Family Property: Includes families of devices that can be redirected. The format of the setting is family_name_1[;family_name_2]... IncludeFamily For example: storage The default value is undefined. Include Path Property: Include devices at a specified hub or port paths that can be redirected.
Using VMware Horizon Client for Mac OS X Table 4‑5. USB Device Families (Continued) Device Family Name Description vendor Devices with vendor-specific functions. video Video-input devices. wireless Wireless networking adapters. wusb Wireless USB devices. Turn on Logging for USB Redirection You can use USB logs to troubleshoot and to determine the product ID and vendor ID of various devices you plug in to the client system.
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mac To download a test application that verifies the correct installation and operation of the Real-Time AudioVideo functionality, go to http://labs.vmware.com/flings/real-time-audio-video-test-application. This test application is available as a VMware fling, and therefore no technical support is available for it.
Using VMware Horizon Client for Mac OS X The next time that you connect to a remote desktop and start a call, the desktop uses the default microphone that you selected on the client system. Configuring Real-Time Audio-Video on a Mac OS X Client You can configure Real-Time Audio-Video settings at the command line by using the Mac OS X defaults system. With the defaults system, you can read, write, and delete Mac OS X user defaults by using Terminal (/Applications/Utilities/Terminal.app).
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mac Configure a Preferred Webcam or Microphone on a Mac OS X Client System With the Real-Time Audio-Video feature, if you have multiple webcams or microphones on your client system, only one webcam and one microphone can be used on your remote desktop. You specify which webcam and microphone are preferred at the command line by using the Mac OS X defaults system.
Using VMware Horizon Client for Mac OS X - Index=255 Name=Built-in Microphone UserId=Built-in Microphone#AppleHDAEngineInput:1B, 0,1,0:1 SystemId=AppleHDAEngineInput:1B,0,1,0:1 2013-12-16T12:18:17.
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mac In Horizon 7 version 7.0 and earlier and Horizon Client 4.0 and earlier, the clipboard can accommodate 1 MB of data for copy and paste operations. In Horizon 7 version 7.0.1 and later and Horizon Client 4.1 and later, the clipboard memory size is configurable for both the server and the client. When a PCoIP or VMware Blast session is established, the server sends its clipboard memory size to the client.
Using VMware Horizon Client for Mac OS X n Flashing Windows taskbar items are forwarded to Horizon Client. For example, if the remote application is an IM client and you receive a new message, a flashing red dot appears on the IM client's icon in the Dock. n You can start voice dictation, minimize, and zoom a remote application from the menu bar. n You can use the Exposé feature to see open remote applications, and you can press Command-Tab to switch between open remote applications.
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mac Saving Documents in a Remote Application With certain remote applications, such as Microsoft Word or WordPad, you can create and save documents. Where these documents are saved depends on your company's network environment. For example, your documents might be saved to a home share mounted on your local computer. Administrators can use an ADMX template file to set a group policy that specifies where documents are saved.
Using VMware Horizon Client for Mac OS X Set Printing Preferences for the Virtual Printer Feature on a Remote Desktop The virtual printing feature lets end users use local or network printers from a remote desktop without requiring that additional print drivers be installed in the remote desktop. For each printer available through this feature, you can set preferences for data compression, print quality, double-sided printing, color, and so on.
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mac Using USB Printers In an View environment, virtual printers and redirected USB printers can work together without conflict. A USB printer is a printer that is attached to a USB port on the local client system. To send print jobs to a USB printer, you can either use the USB redirection feature or use the virtual printing feature. USB printing can sometimes be faster than virtual printing, depending on network conditions.
Using VMware Horizon Client for Mac OS X 60 VMware, Inc.
Troubleshooting Horizon Client 5 You can solve most problems with Horizon Client by resetting the desktop or by reinstalling the VMware Horizon Client application. This chapter includes the following topics: n “Reset a Remote Desktop or Application,” on page 61 n “Uninstalling Horizon Client,” on page 62 Reset a Remote Desktop or Application You might need to reset a desktop or application if the application or desktop operating system stops responding.
Using VMware Horizon Client for Mac OS X Uninstalling Horizon Client You can sometimes resolve problems with Horizon Client by uninstalling and reinstalling the Horizon Client application. You uninstall Horizon Client by using the same method that you usually use to uninstall any other application. Drag the VMware Horizon Client application from the Applications folder to the Trash and empty the trash. After uninstalling is complete, you can reinstall the application.
Index A agent, installation requirements 9 always connect at launch setting 28 autoconnect to a remote desktop 36 autoconnect USB devices 43 C caching, client-side image 59 certificates, ignoring problems 11, 32 client image cache 59 client drive redirection 26 clipboard memory size 55 connect to a desktop 24 to Connection Server 24 USB devices 43 Connection Server connect to 24 shortcuts for 37 copying text and images 54 customer experience program, desktop pool data 13 forwarding USB devices 45 H hard
Using VMware Horizon Client for Mac OS X P V pasting text and images 54 PCoIP client image cache 59 preferences, desktop 24 prerequisites for client devices 10 print from a desktop 57 printers, setting up 58 verification modes for certificate checking 11 virtual printers 57 virtual printing 57 virtual printing feature 58 VMware Blast 13 R webcam 50, 51, 53 W Real-Time Audio-Video, system requirements 8 reconnect to a remote application 36 redirection properties for USB devices 47 USB 45, 50 remote a