Using VMware Horizon View Client for Android January 2014 Horizon View 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 View Client for Android 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 © 2011–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 View Client for Android 5 1 Setup and Installation 7 System Requirements 7 Preparing View Connection Server for Horizon View 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 View Client Download Links Displayed in View Portal Install or Upgrade Horizon View Client for Android 14 Horizon
Using VMware Horizon View Client for Android 5 Troubleshooting Horizon View Client 39 Collecting and Sending Logging Information 39 Enable View Client Log Collection 39 Manually Retrieve and Send Horizon View Client Log Files 40 Disable View Client Log Collection 40 Reset a Desktop 41 Uninstall the VMware View App 42 Horizon View Client Stops Responding or the Remote Desktop Freezes Problem Establishing a Connection When Using a Proxy 43 Index 4 42 45 VMware, Inc.
Using VMware Horizon View Client for Android This guide, Using VMware Horizon View Client for Android, provides information about installing and using ® VMware Horizon View™ software on an Android device to connect to a remote desktop in the datacenter. The information in this document includes system requirements and instructions for installing Horizon View Client for Android.
Using VMware Horizon View Client for Android 6 VMware, Inc.
Setup and Installation 1 Setting up an Horizon View deployment for Android clients involves using certain View Connection Server configuration settings, meeting the system requirements for Horizon View servers and Android device clients, and installing the VMware View app.
Using VMware Horizon View Client for Android CPU architecture n View Client 1.2, 1.3, and 1.4: Android 3 (Honeycomb). On Cisco Cius devices, Android 2.2 is supported. n Horizon View Client 2.1 and later: ARM and x86 n Horizon View Client 2.0 and earlier: ARM External keyboards (Optional) Bluetooth and docked keyboard devices. For information about the devices that your specific device supports, see the documentation from the device manufacturer.
Chapter 1 Setup and Installation This feature is available for View Client 1.5 and later connecting to remote desktops through View Connection Server 5.1 or later . Users can save their passwords if the policy is configured to allow it and if Horizon View Client can fully verify the server certificate that View Connection Server presents.
Using VMware Horizon View Client for Android In addition to meeting these requirements for Horizon View Client systems, other Horizon View components must meet certain configuration requirements to support smart cards: n For information about configuring View servers to support smart card use, see the topic "Configure Smart Card Authentication," in the VMware Horizon View Administration document. IMPORTANT Smart cards are supported only with Horizon View 5.1.3 and 5.2 or later servers and desktops.
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 NOTE This feature is available only if you are using View Client 1.6 or later.
Using VMware Horizon View Client for Android Configure Advanced SSL Options In Horizon View Client 2.3 and later, you can select the security protocols that Horizon View Client can use to connect to a View server. You can also specify the cipher control string. IMPORTANT Horizon View Client and View Connection Server support TLS v1.0 and TLS v1.1 by default.
Chapter 1 Setup and Installation Configure the View Client Download Links Displayed in View Portal By default, when you open a browser and enter the URL of a View Connection Server instance, the portal page that appears contains links to the VMware Download site for downloading Horizon View Client. You can change the default . The default Horizon View Client links on portal page ensure that you are directed to the latest compatible Horizon View Client installers.
Using VMware Horizon View Client for Android 5 Edit C:\ProgramData\VMware\VDM\portal\portal-links.properties file to point to the new location of the installer files. You can edit the lines in this file and add to them if you need to create more links. You can also delete lines. The following examples show properties for creating two links for View Client for Windows and two links for View Client for Linux: link.win=https://server-name/downloads/VMware-Horizon-View-Client-x86_64-y.y.y-XXXX.exe#win link.
Chapter 1 Setup and Installation Devices from different manufacturers use different methods for installing Android apps. See the manufacturer's user's guide for your device. Depending on the device, you might have to perform the following tasks before you can install an app: n Install a particular driver. n Install a file browser. Procedure 1 Browse to the URL for downloading the VMware View app, or search for the VMware View app in the Google Play Store or Amazon Appstore for Android.
Using VMware Horizon View Client for Android Table 1‑1.
Using URIs to Configure Horizon View 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 View Client, connect to View Connection Server, and launch a specific desktop with specific configuration options. You can simplify the process of logging in to a remote desktop by creating Web or email links for end users.
Using VMware Horizon View Client for Android 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 View Client Table 2‑1. Values That Can Be Used with the action Query (Continued) Value Description logoff Logs the user out of the guest operating system in the remote desktop. rollback Discards changes made to the specified desktop while it was checked out for use in local mode on a Windows PC or laptop. domainName The domain associated with the user who is connecting to the remote desktop. tokenUserName Specifies the RSA or RADIUS user name.
Using VMware Horizon View Client for Android 5 vmware-view://view.mycompany.com/ Horizon View Client is launched, and the user is taken to the login prompt for connecting to the view.mycompany.com server. 6 vmware-view://view.mycompany.com/Primary%20Desktop?action=reset Horizon View 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.
Managing Server Connections and Desktops 3 Use Horizon View Client to connect to View Connection Server or a security server, edit the list of servers you connect to, and log in to or off of a remote desktop. For troubleshooting purposes, you can also reset a remote desktop assigned to you. 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 View Client for Android 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. You also need the port number if the port is not 443.
Chapter 3 Managing Server Connections and Desktops 7 In the list of remote desktops that appears, tap a desktop to connect to it. In Horizon View Client 2.3 and later, you can use the search box at the top of the list to search for a particular desktop. If you are using smart card authentication, you are not prompted to supply your PIN again, but the login process takes longer than if you use Active Directory authentication.
Using VMware Horizon View Client for Android Create a Desktop Shortcut for the Android Home Screen You can use a desktop shortcut on the Recent Connections screen to create a desktop shortcut for your Android Home screen. NOTE This feature is not available on Kindle Fire devices. Prerequisites Log in to the remote desktop at least once from the device so that a shortcut for the desktop appears on the Recent Connections screen.
Chapter 3 Managing Server Connections and Desktops Disconnecting from a Desktop You can disconnect from a remote desktop without logging off, so that applications remain open on the remote desktop. When you are logged in to the remote desktop and are not using full screen mode, you can disconnect by tapping the Menu button in the upper-right corner of the screen and selecting Disconnect.
Using VMware Horizon View Client for Android n In Horizon View Client 2.2 and earlier, perform these steps. a On the Horizon View Client Home screen, display the remote desktop's context menu. The context menu is available only if your administrator has allowed it. The items in the menu are available only if the status of the desktop is such that the action can be taken. Option Action Use a Recent Desktops shortcut Tap and hold the shortcut for the recently used desktop.
Chapter 3 Managing Server Connections and Desktops n In Horizon View Client 2.2 and earlier, perform these steps. a On the Horizon View Client Home screen, display the remote desktop's context menu. The context menu is available only if your administrator has allowed it. The items in the menu are available only if the status of the desktop is such that an action can be taken. Option Action Use a Recent Desktops shortcut Tap and hold the shortcut for the recently used desktop.
Using VMware Horizon View Client for Android 28 VMware, Inc.
4 Using a Microsoft Windows Desktop on a Mobile Device On mobile devices, Horizon View Client includes additional features to aid in navigation.
Using VMware Horizon View Client for Android Table 4‑1. Features Supported on Windows Desktops for Android Horizon View Clients (Continued) Feature Windows 8.x Desktop Windows 7 Desktop Windows Vista Desktop Windows XP Desktop Location-based printing X X X X Smart cards X X X X Windows Server 2008 R2 Desktop X Multiple monitors Local mode Features that are supported on Windows desktops for Horizon View Client for Android have the following restrictions. n Windows 8.
Chapter 4 Using a Microsoft Windows Desktop on a Mobile Device Enable the Japanese 106/109 Keyboard Layout If you are connected to a Windows XP desktop, you can configure Horizon View Client 2.3 and later to use the Japanese 106/109 keyboard layout. Prerequisites n Verify that you have Horizon View Client 2.3 or later. n Use Horizon View Client to connect to a Windows XP desktop that has the Japanese keyboard layout enabled.
Using VMware Horizon View Client for Android 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. From this sidebar, you can perform many actions on a file or application. Table 4‑2.
Chapter 4 Using a Microsoft Windows Desktop on a Mobile Device Table 4‑2. Actions You Can Perform from the Sidebar (Continued) Action Procedure Create a list of favorite applications or files 1 2 Search for the application or file, or tap Manage under the Favorite Applications or Favorite Files list. If the Manage bar is not visible, tap the chevron (>) next to Favorite Applications or Favorite Files. NOTE To add a favorite from a list of search results, you must have Horizon View Client 2.1 or later.
Using VMware Horizon View Client for Android Table 4‑3. Radial Menu Icons Icon Description Horizon View Client Tools (radial menu) Disconnect from desktop Onscreen keyboard (toggles to show or hide) Settings Navigation keys Virtual touchpad Gesture help If the desktop is not in full screen mode, a toolbar appears on the right side of the menu bar at the top of the screen. For View Client for Android 1.3 through 1.7, the radial menu is not available.
Chapter 4 Using a Microsoft Windows Desktop on a Mobile Device Even if you use an external keyboard, a one-row onscreen keyboard might still appear, which contains function keys, and the Ctrl, Alt, Win, and arrow keys. Some external keyboards do not have all these keys. Sending a String of Characters From the onscreen keyboard, tap the pen icon on the left side of the Ctrl key to display the local input buffer. Text that you type into this text box is not sent to an application until you tap Send.
Using VMware Horizon View Client for Android To adjust how quickly the pointer moves when you use the touchpad, if you are not using full screen mode, use the Horizon View Client toolbar to display the General settings list. If you are using full screen mode, tap the Horizon View Client Tools icon and tap the settings icon. Drag the slider in the Touchpad Sensitivity option. For pictures of the icons, see the table at the beginning of this topic.
Chapter 4 Using a Microsoft Windows Desktop on a Mobile Device Multitasking You can switch between a remote desktop and other apps without losing the desktop connection. In a WiFi network, by default Horizon View Client runs in the background indefinitely. In a 3G network, depending on the version of Horizon View Client, the client might suspend data transfer in order to conserve data costs: n View Client 1.6 and later suspends data transmission when you switch to another app.
Using VMware Horizon View Client for Android If you have View Client 2.1 or later, you can use the Presentation mode setting in the General settings list to display the keyboard and an expanded onscreen touchpad on the device while displaying the remote desktop on the projector or attached monitor. The expanded touchpad and keyboard appear when you plug the device into the external monitor. The device detects the maximum resolution provided by the external display.
Troubleshooting Horizon View Client 5 You can solve most Horizon View 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 View Client for Android Procedure 1 Use the Horizon View Client interface tools to display the General settings list. If you are using full-screen mode, tap the Horizon View Client Tools icon and tap the settings icon. If you are not using full-screen mode, the Settings button is in the upper-right corner of the screen. 2 Tap Enable log to select the check box and tap OK to confirm your choice.
Chapter 5 Troubleshooting Horizon View Client Reset a Desktop Resetting shuts down and restarts the desktop. Unsaved data is lost. You might need to reset a desktop if the desktop operating system stops responding. Resetting a remote desktop is the equivalent of pressing the Reset button on a physical PC to force the PC to restart. Any files that are open on the remote desktop will be closed without being saved first. You can reset the desktop only if the View administrator has enabled this feature.
Using VMware Horizon View Client for Android Uninstall the VMware View App You can sometimes resolve problems with Horizon View Client by uninstalling and reinstalling the VMware View app. You uninstall Horizon View Client just as you would any Android app. Procedure 1 On your device, go to Apps and browse to the VMware View app. 2 Tap and hold the VMware View icon until the Uninstall icon appears in the upper-right corner of your device. 3 Drag the VMware View icon to the Uninstall trash can icon.
Chapter 5 Troubleshooting Horizon View Client What to do next Problem Establishing a Connection When Using a Proxy Sometimes if you attempt to connect to View Connection Server using a proxy while on the LAN, an error occurs. Problem If the Horizon View environment is set up to use a secure connection from the remote desktop to View Connection Server, and if the client device is configured to use an HTTP proxy, you might not be able to connect.
Using VMware Horizon View Client for Android 44 VMware, Inc.
Index A K Android, installing View Client on 7 Android View Client, uninstalling 42 keyboard navigation keys 33 onscreen 33, 36 keyboard support 30, 38 keys, navigation 33 B background multitasking 37 C caching, client-side image 38 certificates, ignoring problems 23 client image cache 38 connection problems 43 customer experience program, desktop pool data 15 D disconnecting from a remote desktop 25 display requirements 37 displays, external 37 E external displays 37 F L log collection 40 log off
Using VMware Horizon View Client for Android shortcut desktops 27 Home screen 24 sidebar, Unity Touch 31 smart card authentication on mobile devices 10 requirements 9 software tokens 11 SSL options 12 system requirements, for Android devices 7 T tablet gestures 36 tokens, RSA SecurID 11 toolbar, View Client 33 touchpad, virtual 33 troubleshooting, connection problems 43 U Unity Touch feature 31 URI examples 19 URI syntax for View Clients 17 URIs (uniform resource identifiers) 17 V View Agent, installati
