Using VMware Horizon Client for iOS September 2014 VMware Horizon 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 iOS 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–2014 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 iOS 5 1 Setup and Installation 7 System Requirements 7 Preparing View Connection Server for Horizon Client 8 Smart Card Authentication Requirements 9 Configure Smart Card Authentication for Mobile Clients 10 Using Embedded RSA SecurID Software Tokens 11 Configure Advanced SSL Options 12 Supported Desktop Operating Systems 12 Configure the Client Download Links Displayed in View Portal 5.
Using VMware Horizon Client for iOS Internationalization 40 5 Troubleshooting Horizon Client 41 Collecting and Sending Logging Information 41 Enable Horizon Client Log Collection 41 Manually Retrieve and Send Horizon Client Log Files 42 Disable Horizon Client Log Collection 42 Reset a Remote Desktop or Application 43 Uninstall Horizon Client 43 Horizon Client Stops Responding or the Remote Desktop Freezes Problem Establishing a Connection When Using a Proxy 44 Index 4 44 45 VMware, Inc.
Using VMware Horizon Client for iOS This guide, Using VMware Horizon Client for iOS, provides information about installing and using VMware Horizon™ Client™ software on an iOS device to connect to a remote desktop or application in the datacenter. The information in this document includes system requirements and instructions for installing Horizon Client. This document also provides tips for improving the user experience of navigating and using Windows desktop elements on an iOS device such as an iPad.
Using VMware Horizon Client for iOS 6 VMware, Inc.
Setup and Installation 1 Setting up a View deployment for iOS clients involves using certain View Connection Server configuration settings, meeting the system requirements for View servers and iOS clients, and installing the app for Horizon Client from the Apple App Store. VMware also recommends that you set up a View security server so that your iOS clients will not need a VPN connection.
Using VMware Horizon Client for iOS View Connection Server, Security Server, and View Agent Latest maintenance release of View 4.6.x and later releases. VMware recommends that you use a security server so that your iOS clients will not require a VPN connection. The Unity Touch feature requires View 5.2 or later servers and desktops and the Remote Experience Agent must also be installed on the desktop. Remote applications are available only on Horizon 6.0.x with View servers.
Chapter 1 Setup and Installation Smart Card Authentication Requirements Client systems that use a smart card for user authentication must meet certain requirements. Horizon Client for iOS supports using smart cards with remote desktops that have Windows 7, Windows Vista, Windows 8.1, Windows XP, or Windows Server 2008 R2 guest operating systems. VMware recommends using an iOS 6.1.3 or later operating system.
Using VMware Horizon Client for iOS Configure Smart Card Authentication for Mobile Clients Configuration tasks include connecting and pairing the card reader with the mobile device and setting the smart card removal policy. Prerequisites n Verify that you are using the correct version of the client, desktop agent, server, mobile device operating system, smart card reader, and smart card. See “Smart Card Authentication Requirements,” on page 9.
Chapter 1 Setup and Installation Using Embedded RSA SecurID Software Tokens If you create and distribute RSA SecurID software tokens to end users, they need enter only their PIN, rather than PIN and token code, to authenticate. Setup Requirements You can use Compressed Token Format (CTF) or dynamic seed provisioning, which is also called CT-KIP (Cryptographic Token Key Initialization Protocol), to set up an easy-to-use RSA authentication system. With this system, you generate a URL to send to end users.
Using VMware Horizon Client for iOS Configure Advanced SSL Options You can select the security protocols that Horizon Client can use. You can also specify the cipher control string. Prerequisites Verify the security protocol that the View server can use. If you configure a security protocol for Horizon Client that is not enabled on the View server to which the client connects, an SSL error occurs and the connection fails.
Chapter 1 Setup and Installation When you make links for Mac OS X, Linux, and Windows client systems, the correct operating system specific link is shown on the portal page. For example, if you browse to the portal page from a Windows system, only the link or links for Windows installers appear. You can make separate links for 32-bit and 64bit installers.
Using VMware Horizon Client for iOS 6 Edit the C:\ProgramData\VMware\VDM\portal\portal.properties file to specify the text to display for the links. These lines appear in the section of the file called # keys based on key names in portal- links.properties. The following example shows the text that corresponds to the links specified for link.win and link.win.1: text.win=Horizon Client for Windows 32-bit client users text.win.
Chapter 1 Setup and Installation VMware collects data on the clients to prioritize hardware and software compatibility. If your company's administrator has opted to participate in the customer experience improvement program, VMware collects anonymous data about your deployment in order to improve VMware's response to customer requirements. No data that identifies your organization is collected.
Using VMware Horizon Client for iOS Table 1‑1. Data Collected from Horizon Clients for the Customer Experience Improvement Program (Continued) Description Is This Field Made Anonymous ? Host operating system architecture No Example Value Examples include the following: x86_64 n i386 n armv71 n ARM n Host system model No Examples include the following: n Dell Inc. OptiPlex 960 n iPad3,3 n MacBookPro8,2 n Dell 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 View 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 iOS 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. Unsaved data is lost. Resetting a remote desktop is the equivalent of pressing the Reset button on a physical PC. In Horizon Client 3.0, if you specify an application, the action will be ignored. logoff Logs the user out of the guest operating system in the remote desktop.
Using VMware Horizon Client for iOS Horizon Client is launched and connects to the view.mycompany.com server. In the login box, the User name text box is populated with the name fred, and the Domain text box is populated with mycompany. The user must supply only a password. After a successful login, the client connects to the desktop whose display name is displayed as Finance Desktop, and the user is logged in to the guest operating system. 5 vmware-view://view.mycompany.
Managing Remote Desktop and Application Connections 3 Use Horizon Client to connect to View Connection Server or a security server, edit the list of servers you connect to, log in to or off of remote desktops, 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 iOS If your company has an internal wireless network to provide routable access to remote desktops that your device can use, you do not have to set up a View security server or VPN connection. n Verify that you have the fully qualified domain name (FQDN) of the server that provides access to the remote desktop or application. Note that underscores (_) are not supported in server names. You also need the port number if the port is not 443.
Chapter 3 Managing Remote Desktop and Application Connections c Tap to toggle the Remember this Password option to On if your administrator has enabled this feature and if the server certificate can be fully verified. d Tap Login. The desktop and application selector screen appears. 7 Tap a desktop or application to connect to it.
Using VMware Horizon Client for iOS n Do not verify server identity certificates. This setting means that View does not perform any certificate checking. If the certificate checking mode is set to Warn, you can still connect to a View Connection Server instance that uses a self-signed certificate.
Chapter 3 Managing Remote Desktop and Application Connections 3 To manage saved servers in Horizon Client 3.1, touch and hold the server icon until the context menu appears. Option Action Change the user name, domain, server name, or description a b c Remove a server Tap Delete Server in the context menu. The desktop and application shortcuts associated with the server are also deleted. Forget a saved password Tap Forget Password in the context menu.
Using VMware Horizon Client for iOS 4 (Optional) In Horizon Client 3.1, tap Favorites (star icon) at the bottom of the desktop and application selection window to display only favorite desktops or applications. You can tap All (cloud icon) at the bottom of the desktop and application selection window to display all the available desktops and applications.
Chapter 3 Managing Remote Desktop and Application Connections Manage Desktop and Application Shortcuts After you connect to a remote desktop or application, Horizon Client saves a shortcut for the recently used desktop or application. You can rearrange and remove these shortcuts. Desktop and application shortcuts can appear on multiple pages and you can swipe across pages to see more shortcuts. Horizon Client creates new pages, as needed, to accommodate all of your shortcuts.
Using VMware Horizon Client for iOS 28 VMware, Inc.
4 Using a Microsoft Windows Desktop or Application on a Mobile Device On mobile devices, Horizon Client includes additional features to aid in navigation.
Using VMware Horizon Client for iOS Table 4‑1. Features Supported on Windows Desktops for iOS Horizon Clients (Continued) Windows 8.x Desktop Windows 7 Desktop Windows Vista Desktop Windows XP Desktop Windows Server 2008 R2 Desktop Location-based printing X X X X X Smart cards X X X X X Feature Real-Time Audio-Video (RTAV) Wyse MMR Windows 7 MMR Virtual printing Multiple monitors Features that are supported on Windows desktops for Horizon Client for iOS have the following restrictions.
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mobile Device Also with the Apple Wireless Keyboard (Bluetooth), after the external keyboard is detected, you cannot use the Horizon Client interface tools or three-finger tap to display the onscreen keyboard. You must first deactivate the external keyboard by pressing its Eject key. The Apple Wireless Keyboard does not input the Japanese full-width tilde correctly in remote desktops.
Using VMware Horizon Client for iOS Figure 4‑1. Unity Touch Sidebar If you access a desktop that has Unity Touch enabled but the sidebar is not displayed, you can see a tab on the left side of the screen. Besides swiping this tab to the right to open the sidebar, you can slide the tab up or down. IMPORTANT To use this feature, you must have an iOS 5.0 or later device. From this sidebar, you can perform many actions on a file or application. Table 4‑2.
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mobile Device Table 4‑2. Unity Touch Sidebar Actions for a Remote Desktop (Continued) Action Procedure Search for an application or file n n n n Tap in the Search box and type the name of the application or file. To use voice dictation, tap the microphone on the keyboard. To launch an application or file, tap the name of the application or file in the search results.
Using VMware Horizon Client for iOS NOTE The Unity Touch feature is available only if you have Horizon View 5.2 and later servers and desktops. The Remote Experience Agent must be installed on the desktops. If you have the Remote Experience Agent installed but want to turn off this feature, you can set a registry value on the remote desktop. If users have a floating desktop, users’ favorite applications and files can be saved only if Windows roaming user profiles are configured for the desktop.
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mobile Device Table 4‑3. Unity Touch Sidebar Actions for a Remote Application (Continued) Action Procedure Open an application Tap the name of the application under Available Applications in the sidebar. The application starts and the sidebar closes.
Using VMware Horizon Client for iOS Table 4‑4. Radial Menu Icons (Continued) Icon Description Virtual touchpad Gesture help Onscreen Keyboard The onscreen keyboard in a remote desktop has more keys than the standard onscreen keyboard. For example, Control keys and function keys are available. To display the onscreen keyboard, tap the screen with three fingers at the same time or tap the Keyboard button. IMPORTANT If you use Horizon Client with a View 5.
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mobile Device By default, when you tap the touchpad icon, you can touch anywhere on the screen to move the mouse pointer. The screen becomes a full screen touchpad. To change the default, so that the virtual touchpad resembles the touchpad on a laptop, including right- and left-click buttons, use the Horizon Client interface tools to display the general settings or options and turn the Full screen touchpad control off.
Using VMware Horizon Client for iOS n Use the Horizon Client interface tools to display the touchpad, tap the touchpad with two fingers, and then drag to scroll. n Use the onscreen touchpad to move the mouse pointer and click scroll bars. Zooming In and Out As in other applications, pinch your fingers together or apart to zoom.
Chapter 4 Using a Microsoft Windows Desktop or Application on a Mobile Device Configure Horizon Client to Support Reversed Mouse Buttons You can use the Left Handed Mode option if the primary and secondary mouse buttons are switched in your remote desktop. If you set the mouse properties inside your remote desktop so that the primary mouse button is the one on the right side, as many left-handed people do, you must turn on the Left Handed Mode option in Horizon Client.
Using VMware Horizon Client for iOS PCoIP Client-Side Image Cache PCoIP client-side image caching stores image content on the client to avoid retransmission. This feature reduces bandwidth usage. IMPORTANT This feature is available only when the version of View Agent and View Connection Server is View 5.0 or later. The PCoIP image cache captures spatial, as well as temporal, redundancy.
Troubleshooting Horizon Client 5 You can solve most Horizon Client problems by resetting the desktop or reinstsalling the app. You can also enable log collection and send log files to VMware for troubleshooting.
Using VMware Horizon Client for iOS Procedure 1 2 On your iOS device, open the Horizon Client settings. Option Description Horizon Client 3.0 Tap your iOS Settings app and tap VMware View. Horizon Client 3.1 Tap your iOS Settings app and tap Horizon. Tap to toggle the Logging option to On. After log collection is enabled, Horizon Client generates several log files. When Horizon Client quits unexpectedly or is exited and relaunched, the log files are merged and compressed into a single GZ file.
Chapter 5 Troubleshooting Horizon Client Reset a Remote Desktop or Application Resetting a remote desktop shuts down and restarts the desktop. Resetting a remote application quits the application. You might need to reset a desktop or application if the desktop operating system or application stops responding. Resetting a remote desktop is the equivalent of pressing the Reset button on a physical PC to force the PC to restart.
Using VMware Horizon Client for iOS What to do next Reinstall Horizon Client. See “Install or Upgrade Horizon Client for iOS,” on page 14. Horizon Client Stops Responding or the Remote Desktop Freezes When the screen freezes, first, try resetting the remote desktop operating system. Problem Horizon Client does not work or repeatedly exits unexpectedly or the remote desktop freezes.
Index A App Store 14 B background multitasking 38 C caching, client-side image 40 cellular data warning message 40 certificates, ignoring problems 23 client image cache 40 connection problems 44 copying and pasting 38 customer experience program, desktop pool data 14 D disconnecting from a remote desktop 26 display requirements 39 displays, external 39 E external displays 39 F favorites 25 favorites list in Unity Touch sidebar 31 feature support matrix 29 H hardware requirements iOS devices 7 smart c
Using VMware Horizon Client for iOS R reset a desktop 43 resizing windows 37 resolution, screen 39 reversed mouse buttons 39 RSA SecurID tokens 11 running in the background 38 S saving documents in a remote application 38 screen resolution 39 scrolling 37 security servers, PCoIP connections to 21 server connections, managing 21 shortcut, desktops 27 sidebar, Unity Touch 31 smart card authentication on mobile devices 10 requirements 9 software tokens 11 SSL options 12 system requirements, for iPad and iPho
