VMware Horizon Client For Android Installation And Setup Guide VMware. 4.7 47

User Manual: Pdf Horizon Client 4.7 for Android - Installation and Setup Guide User Guide for VMware Horizon Software, Free Instruction Manual

Open the PDF directly: View PDF PDF.
Page Count: 74

VMware Horizon Client
for Android Installation
and Setup Guide
04 JAN 2018
VMware Horizon Client for Android 4.7
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 2
You can find the most up-to-date technical documentation on the VMware website at:
https://docs.vmware.com/
If you have comments about this documentation, submit your feedback to
docfeedback@vmware.com
Copyright © 2011–2018 VMware, Inc. All rights reserved. Copyright and trademark information.
VMware, Inc.
3401 Hillview Ave.
Palo Alto, CA 94304
www.vmware.com
Contents
VMware Horizon Client for Android Installation and Setup Guide 5
1Setup and Installation 6
System Requirements 6
System Requirements for Android Devices 6
System Requirements for Thin Clients 7
System Requirements for Chromebooks 8
System Requirements for Real-Time Audio-Video 8
Smart Card Authentication Requirements 8
Configure Smart Card Authentication 10
Fingerprint Authentication Requirements 11
Supported Desktop Operating Systems 12
Preparing Connection Server for Horizon Client 12
Installing Horizon Client 14
Install or Upgrade Horizon Client 14
Configure AirWatch to Deliver Horizon Client to Android Devices 15
Configure AirWatch to Deliver Horizon Client to Android for Work Devices 17
Configuring a List of Servers and a Default Server for Chromebooks 20
Configure Horizon Client in Thin Client Mode 21
Using Horizon Client on a Thin Client 22
Using Embedded RSA SecurID Software Tokens 22
Configure Advanced TLS/SSL Options 23
Configure VMware Blast Options 24
Configure the Horizon Client Default View 25
Horizon Client Data Collected by VMware 26
2Using URIs to Configure Horizon Client 29
Syntax for Creating vmware-view URIs 29
Examples of vmware-view URIs 32
3Managing Remote Desktop and Application Connections 36
Setting the Certificate Checking Mode in Horizon Client 36
Connect to a Remote Desktop or Application 37
Use Unauthenticated Access to Connect to Remote Applications 40
Share Access to Local Storage with Client Drive Redirection 41
Create a Remote Desktop or Application Shortcut 43
Manage Server Shortcuts 43
Select a Favorite Remote Desktop or Application 44
VMware, Inc. 3
Switch Remote Desktops or Published Applications 45
Reconnecting to a Desktop or Published Application 45
Disconnecting From a Remote Desktop or Application 46
Log Off From a Remote Desktop 46
Manage Desktop and Application Shortcuts 47
Using Android 7.0 Nougat Multi-Window Modes with Horizon Client 47
Using Horizon Client with Samsung DeX 47
Enable the DeX Mode Auto Launch Feature 48
4Using a Microsoft Windows Desktop or Application 49
Feature Support Matrix 49
Input Devices, Keyboards, and Keyboard Settings 52
Enable the Japanese 106/109 Keyboard Layout 52
Using the Real-Time Audio-Video Feature 53
Using Native Operating System Gestures with Touch Redirection 54
Using the Unity Touch Sidebar with a Remote Desktop 54
Using the Unity Touch Sidebar with a Remote Application 57
Horizon Client Tools on a Mobile Device 59
Gestures 61
Multitasking 62
Copying and Pasting Text and Images 63
Dragging and Dropping Text and Image Files 63
Saving Documents in a Published Application 64
Screen Resolutions and Using External Displays 64
PCoIP Client-Side Image Cache 66
Internationalization and International Keyboards 67
5Troubleshooting Horizon Client 68
Restart a Remote Desktop 68
Reset a Remote Desktop or Remote Applications 69
Uninstall Horizon Client 70
Collecting and Sending Logging Information to VMware 70
Enable Horizon Client Log Collection 71
Manually Retrieve and Send Horizon Client Log Files 71
Disable Horizon Client Log Collection 72
Report Horizon Client Crash Data to VMware 72
Horizon Client Stops Responding or the Remote Desktop Freezes 73
Problem Establishing a Connection When Using a Proxy 73
Connecting to a Server in Workspace ONE Mode 74
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 4
VMware Horizon Client for Android
Installation and Setup Guide
This document, VMware Horizon Client for Android Installation and Setup Guide, provides information
about installing, configuring, and using VMware Horizon® Client™ software on an Android or
Chromebook device.
This information is intended for administrators who must set up a Horizon 7 deployment that includes
Android and Chromebook client devices. The information is written for experienced system administrators
who are familiar with virtual machine technology and data center operations.
VMware, Inc. 5
Setup and Installation 1
Setting up a Horizon deployment for Android and Chromebook client devices involves using certain
Connection Server configuration settings, meeting the system requirements for Horizon servers and client
devices, and installing the Horizon Client app.
This chapter includes the following topics:
nSystem Requirements
nPreparing Connection Server for Horizon Client
nInstalling Horizon Client
nConfiguring a List of Servers and a Default Server for Chromebooks
nConfigure Horizon Client in Thin Client Mode
nUsing Embedded RSA SecurID Software Tokens
nConfigure Advanced TLS/SSL Options
nConfigure VMware Blast Options
nConfigure the Horizon Client Default View
nHorizon Client Data Collected by VMware
System Requirements
Android, thin client, and Chromebook devices that run Horizon Client must meet certain hardware and
software requirements.
System Requirements for Android Devices
The Android device on which you install Horizon Client, and the peripherals it uses, must meet certain
system requirements.
Android operating
systems
nAndroid 4.0 (Ice Cream Sandwich)
nAndroid 4.1, 4.2, and 4.3 (Jelly Bean)
nAndroid 4.4 (KitKat)
nAndroid 5.0 (Lollipop)
VMware, Inc. 6
nAndroid 6.0 (Marshmallow)
nAndroid 7.0 and 7.1 (Nougat)
nAndroid 8.0
CPU architecture nARM
nx86
Note Non-NEON devices are not supported.
External keyboards (Optional) Bluetooth and docked keyboard devices. For information about
the external devices that your specific device supports, see the
documentation from the device manufacturer.
Smart cards See Smart Card Authentication Requirements.
Connection Server,
security server, and
View Agent or
Horizon Agent
Latest maintenance release of Horizon 6 version 6.x and later releases.
VMware recommends that you use a security server or
Unified Access Gateway appliance so that client devices do not require a
VPN connection. If your company has an internal wireless network to
provide routable access to remote desktops that devices can use, you do
not have to set up a security server, Unified Access Gateway, or VPN
connection
Display protocols nPCoIP
nVMware Blast (requires Horizon Agent 7.0 or later)
System Requirements for Thin Clients
You can install Horizon Client on certain thin clients.
The thin client on which you install Horizon Client, and the external input devices it uses, must meet
certain system requirements.
Thin client models and
Android operating
systems
nRemix Mini with Android 5.1 (RemixOS 2.0.205 or later)
nNVIDIA SHIELD Android TV with Android 6.0
nAmazon Fire TV (1st Generation) with Android 5.1
External input devices Horizon Client generally works with any external input device, including
keyboards and controllers, that works with the thin client. For information
about the devices that a specific thin client supports, see the
documentation from the device manufacturer.
Horizon Client
requirements
Enable the Thin Client mode setting in Horizon Client. See Configure
Horizon Client in Thin Client Mode.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 7
System Requirements for Chromebooks
You can install Horizon Client on certain Chromebook models. You can install Horizon Client on a
Chromebook from Google Play.
Chromebook models
that support Android
apps
Google is continuing to evaluate Chromebook models that support Android
apps. For the latest information, go to
https://sites.google.com/a/chromium.org/dev/chromium-os/chrome-os-
systems-supporting-android-apps?
visit_id=0-636124384717258228-2661029306&rd=1.
Horizon Client feature
limitations
Because of device and operating system limitations, certain Horizon Client
features work only on an Android device, and certain features work only on
a Chrome device. These limitations are mentioned where the features are
described in this document.
System Requirements for Real-Time Audio-Video
Real-Time Audio-Video works with standard audio and video devices and with standard conferencing
applications such as Skype, WebEx, and Google Hangouts. To support Real-Time Audio-Video, your
Horizon environment must meet certain software and hardware requirements.
Remote desktops and
applications
To use Real-Time Audio-Video with published desktops and remote
applications, you must have Horizon Agent 7.0.2 or later.
Client access device Real-Time Audio Video is supported on all devices that run Horizon Client.
For more information, see System Requirements.
Smart Card Authentication Requirements
Client devices that use a smart card for user authentication must meet certain requirements.
Client Hardware and Software Requirements
Smart card authentication is supported on Android devices. VMware recommends that you use an
Android 4.0 or later operating system. The CPU architecture may be ARM or x86.
Smart card authentication is not supported on a Chromebook.
Each client device that uses a smart card for user authentication must have the following hardware and
software:
nHorizon Client
nA compatible smart card reader.
VMware tested the baiMobile 3000MP Bluetooth Smart Card, baiMobile 301MP USB Smart Card,
and baiMobile 301MP_LT Smart Card readers.
nSmart card middleware
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 8
The Android device app must support your baiMobile smart card reader. For example, one such app
is baiMobile PCSC-Lite (Android device tile name baiMobile PC/SC). Horizon Client for Android
contains support for both the baiMobile 3000MP Bluetooth and baiMobile 301MP USB smart card
readers. Without such an app, you can pair the Bluetooth card reader with the Android device, but
you cannot connect it. The app sends a connection request to the reader and you tap the OK button
on the reader to establish the Bluetooth connection.
nProduct-specific application drivers
Users that authenticate with smart cards must have a smart card and each smart card must contain a
user certificate.
Remote Desktop and Application Software Requirements
A Horizon administrator must install product-specific application drivers on the remote desktops or RDS
host. VMware tested the ActiveClient6.2.0.50, ActivClient_7.0.1, Gemalto.MiniDriver.NET.inf, and
Charismathics CSTC PIV 5.2.2 drivers.
Enabling the Username Hint Field in Horizon Client
In some environments, smart card users can use a single smart card certificate to authenticate to multiple
user accounts. Users enter their user name in the Username hint field during smart card sign-in.
To make the Username hint field appear on the Horizon Client login dialog box, you must enable the
smart card user name hints feature for the Connection Server instance in Horizon Administrator. The
smart card user name hints feature is supported only with Horizon 7 version 7.0.2 and later servers and
agents. For information about enabling the smart card user name hints feature, see the View
Administration document.
If your environment uses an Unified Access Gateway appliance rather than a security server for secure
external access, you must configure the Unified Access Gateway appliance to support the smart card
user name hints feature. The smart card user name hints feature is supported only with
Unified Access Gateway 2.7.2 and later. For information about enabling the smart card user name hints
feature in Unified Access Gateway, see the Deploying and Configuring Unified Access Gateway
document.
Note Horizon Client still supports single-account smart card certificates when the smart card user name
hints feature is enabled.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 9
Additional Smart Card Authentication Requirements
In addition to meeting the smart card requirements for Horizon Client systems, other Horizon components
must meet certain configuration requirements to support smart cards.
Connection Server and
security server hosts
An administrator must add all applicable Certificate Authority (CA)
certificates for all trusted user certificates to a server truststore file on the
Connection Server host or security server host. These certificates include
root certificates and must include intermediate certificates if the user's
smart card certificate was issued by an intermediate certificate authority.
For information about configuring Connection Server to support smart card
use, see the View Administration document.
Active Directory For information about tasks that an administrator might need to perform in
Active Directory to implement smart card authentication, see the View
Administration document.
Configure Smart Card Authentication
To use a physical smart card, you must connect and pair the card reader with the device and set the
smart card removal policy.
Prerequisites
Verify that the client device, remote desktops, RDS hosts, Connection Server host, and other Horizon
components meet the smart card authentication requirements. See Smart Card Authentication
Requirements.
Procedure
1Install the smart card middleware app on the device.
2Pair the device with the smart card reader, according to the documentation provided by the
manufacturer of the reader.
If you are using a Bluetooth smart card reader, a randomly generated number is displayed on both
devices during this process. When you confirm that the numbers match, you establish secure
Bluetooth communication.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 10
3Configure the smart card removal policy.
Option Description
Set the policy on the Connection
Server instance
When you set the policy on the Connection Server instance, you can disconnect
users from the Connection Server instance when they remove their smart cards,
or keep users connected to Connection Server when they remove their smart
cards and let them start new desktop or application sessions without
reauthenticating.
a In Horizon Administrator, select View Configuration > Servers.
b On the Connection Servers tab, select the Connection Server instance and
click Edit.
c On the Authentication tab, select or deselect the Disconnect user
sessions on smart card removal check box to configure the smart card
removal policy.
d Click OK to save your changes.
e Restart the Connection Server service to make your changes take effect.
If you select the Disconnect user sessions on smart card removal check box,
Horizon Client returns to the Recent tab when users remove their smart cards.
Set the policy on the remote desktop When you set the policy on the remote desktop, you can use the Group Policy
Editor (gpedit.msc) to configure one of the following settings: no action, lock
workstation, force log off, or Disconnect if a Remote Desktop Services session.
a Open gpedit.msc in the desktop operating system.
b Navigate to Windows settings > Security settings > Local policies >
Security options > Interactive logon: smart card removal behavior.
c Run the gpupdate /force command after you change the configuration to
force a group policy refresh.
Fingerprint Authentication Requirements
To use fingerprint authentication in Horizon Client, the client device on which you install Horizon Client
must meet certain requirements.
Android device models Any Android device model that has a fingerprint sensor and native
fingerprint reader functionality.
Fingerprint authentication is not supported on a Chromebook.
Operating system
requirements
nAndroid 6 (Marshmallow) and later
nThe Fingerprint Authentication option must be enabled and at least
one fingerprint must be enrolled.
Connection Server
requirements
nHorizon 6 version 6.2 or a later release.
nEnable biometric authentication in Connection Server. For information,
see "Configure Biometric Authentication" in the View Administration
document.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 11
nThe Connection Server instance must present a valid root-signed
certificate to Horizon Client.
Horizon Client
requirements
nSet the certificate checking mode to Never connect to untrusted
servers or Warn before connecting to untrusted servers. For
information about setting the certificate checking mode, see Setting the
Certificate Checking Mode in Horizon Client.
nEnable fingerprint authentication by tapping Enable Fingerprint on the
server login window. After you successfully log in, your Active Directory
credentials are stored securely in your Android device. The Enable
Fingerprint option is shown the first time you log in and does not
appear after fingerprint authentication is enabled.
You can use fingerprint authentication with smart card authentication and as part of two-factor
authentication with RSA SecurID and RADIUS authentication. If you use fingerprint authentication with
smart card authentication, Horizon Client connects to the server after you enter your PIN and the
fingerprint authentication window does not appear.
Supported Desktop Operating Systems
A Horizon administrator creates virtual machines that have a guest operating system and installs agent
software in the guest operating system. End users can log in to these virtual machines from a client
device.
For a list of the supported Windows guest operating systems, see the View Installation document.
Some Linux guest operating systems are also supported if you have View Agent 6.1.1 or later, or
Horizon Agent 7.0 or later. For information about system requirements, configuring Linux virtual machines
for use in Horizon, and a list of supported features, see Setting Up Horizon 6 for Linux Desktops or
Setting Up Horizon 7 for Linux Desktops.
Preparing Connection Server for Horizon Client
A Horizon administrator must perform specific tasks to enable end users to connect to remote desktops
and applications.
Before end users can connect to a server and access a remote desktop or published application, a
Horizon administrator must configure certain pool settings and security settings.
Unified Access Gateway and Security Servers
nIf you plan to use Unified Access Gateway, configure Connection Server to work with
Unified Access Gateway. See the Deploying and Configuring Unified Access Gateway document.
Unified Access Gateway appliances fulfill the same role that was previously played by only security
servers.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 12
nIf you are using a security server, verify that you are using the latest maintenance releases of
Connection Server 6.x and Security Server 6.x or later releases. For more information, see the View
Installation document.
Secure Tunnel Connection
nIf you plan to use a secure tunnel connection for client devices, and if the secure connection is
configured with a DNS host name for Connection Server instance or a security server, verify that the
client device can resolve this DNS name.
To enable or disable the secure tunnel, in Horizon Administrator, go to the Edit Horizon Connection
Server Settings dialog box and select or deselect the Use secure tunnel connection to desktop
check box.
Desktop and Application Pools
nVerify that a desktop or application pool has been created and that the user account that you plan to
use is entitled to access the pool. For information, see the Setting Up Virtual Desktops in Horizon 7 or
Setting Up Published Desktops and Applications in Horizon 7 document.
nVerify that the desktop or application pool is set to use the VMware Blast display protocol or the
PCoIP display protocol. For information, see the Setting Up Virtual Desktops in Horizon 7 and Setting
Up Published Desktops and Applications in Horizon 7 documents.
User Authentication
nTo use two-factor authentication with Horizon Client, such as RSA SecurID or RADIUS authentication,
you must enable this feature in the Connection Server instance. For more information, see the topics
about two-factor authentication in the View Administration document.
nTo hide security information in Horizon Client, including server URL information and the Domain
drop-down menu, enable the Hide server information in client user interface and Hide domain
list in client user interface settings in Horizon Administrator. These global settings are available in
Horizon 7 version 7.1 and later. For information about configuring global settings, see the View
Administration document.
To authenticate when the Domain drop-down menu is hidden, users must provide domain information
by entering their user name in the format domain\username or username@domain in the User name
text box.
Important If you enable the Hide server information in client user interface and Hide domain
list in client user interface settings and select two-factor authentication (RSA SecureID or RADIUS)
for the Connection Server instance, do not enforce Windows user name matching. Enforcing
Windows user name matching will prevent users from being able to enter domain information in the
user name text box and login will always fail. For more information, see the topics about two-factor
authentication in the View Administration document.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 13
nTo use Fingerprint authentication, you must enable biometric authentication in the Connection Server
instance. Biometric authentication is supported in Horizon 6 version 6.2 and later. For more
information, see the View Administration document.
nTo enable end users to save their passwords with Horizon Client, so that they do not always need to
supply credentials when they connect to a Connection Server instance, configure Horizon LDAP for
this feature in the Connection Server instance.
Users can save their passwords if Horizon LDAP is configured to allow it, if the Horizon Client
certificate verification mode is set to Warn before connecting to untrusted servers or Never
connect to untrusted servers, and if Horizon Client can fully verify the server certificate that
Connection Server presents. For more information, see the View Administration document.
nTo provide end users unauthenticated access to published applications in Horizon Client, you must
enable this feature in the Connection Server instance. For more information, see the topics about
unauthenticated access in the View Administration document.
Installing Horizon Client
You can install Horizon Client the same way that you install other Android apps. You can also use
AirWatch to deliver Horizon Client to Android device users.
Install or Upgrade Horizon Client
Horizon Client is an Android app, and you install it just as you do other Android apps on the client device.
Prerequisites
nIf you have not already set up the client device, do so. See the manufacturer's user's guide for the
client device.
nVerify that the client device meets the system requirements for Horizon Client. See System
Requirements.
nVerify 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.
nBecome familiar with the client device's procedure for installing apps.
Devices from different manufacturers use different methods for installing Android apps. See the
manufacturer's user's guide for the client device. Depending on the device, you might have to perform
the following tasks before you can install an app:
nInstall a particular driver.
nInstall a file browser.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 14
Procedure
1Browse to the URL for downloading the Horizon Client app, or search for the Horizon Client app in the
Google Play Store or Amazon Appstore for Android.
For some client devices, you download the file to the device. For others, you download the file to a
PC or a USB device. For Chromebooks, you download Horizon Client from the Google Play Store.
2If necessary, copy the app (.apk file) to your client device.
3Install the app according to the client device's customary procedure for installing Android apps.
For example, on some devices, you must tap the file to install it.
4Verify that the Horizon app appears on the client device.
What to do next
The first time you launch Horizon Client on an Android 6.0 Marshmallow device, the app prompts you to
allow Horizon Client to make and manage phone calls, access photos, media, and files, and record audio
on your device.
If you installed Horizon Client on a thin client, see Configure Horizon Client in Thin Client Mode.
Configure AirWatch to Deliver Horizon Client to Android Devices
You can configure AirWatch to deliver Horizon Client to Android device users.
You can optionally specify a list of Connection Server instances or a default Connection Server instance.
If you specify a list of servers, the servers appear as shortcuts in Horizon Client. If you specify a default
server, Horizon Client automatically connects to that server.
If your environment is set up for Android for Work, do not follow this procedure. Instead, see Configure
AirWatch to Deliver Horizon Client to Android for Work Devices.
Prerequisites
nInstall and deploy AirWatch. See http://www.air-watch.com.
nDownload the Horizon Client app from the VMware Downloads page at
http://www.vmware.com/go/viewclients or from the Google Play Store or Amazon Appstore for
Android.
nBecome familiar with the AirWatch console. This procedure assumes you know how to use the
AirWatch console. For more information, see the AirWatch documentation or online help.
nDecide which version of Horizon Client to deploy with the AirWatch console. The AirWatch console
cannot deploy both the ARM and the x86 version at the same time.
Procedure
1Log in to the AirWatch console as an administrator.
2Select Accounts > Users > List View, click Add, select Add User, and add user accounts for the
users who will run Horizon Client on their Android devices.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 15
3Select Accounts > Users > User Groups > List View, click Add, select Add User Group, and
create a user group for the user accounts that you created.
4Create an application profile for Horizon Client in AirWatch.
a Select Apps & Books > Applications > Application Settings > Profiles and click Add Profile.
b Select the SDK Profile configuration type.
c Select the Android profile type.
d (Optional) Click Custom Settings to configure a list of servers or a default server.
Use the server property to specify the IP address or host name of the server, the username and
domain properties to specify the name and domain of a user that is entitled to use the server, and
the description property to specify a description of the server. The username, domain, and
description properties are optional. For example:
{
"settings": {
"server-list":
[
{"server":"123.456.1.1","username":"User1","domain":"TestDomain1","description":"View
server 1"},
{"server":"123.456.1.2","username":"User2","domain":"TestDomain2","description":"View
server 2"},
{"server":"123.456.1.3","username":"User3","domain":"TestDomain3","description":"View
server 3"},
{"server":"viewserver4.mydomain.com","username":"User4","domain":"TestDomain4","description":"V
iew server 4"}
]
}
}
You can use the default property to specify a default server. Valid values are true and false.
For example:
{
"settings": {
"server-list":
[
{"server":"123.456.1.1","username":"User1","domain":"TestDomain1","description":"View
server 1","default":true},
]
}
}
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 16
5Upload and add the Horizon Client application to AirWatch.
a Select Apps & Books > Applications > List View and click Add Application on the Internal
tab.
b Browse to the Horizon Client app that you downloaded and click Save to upload the application to
AirWatch.
c On the Info tab, type an application name and specify the supported mobile device models.
d On the Assignment tab, assign the Horizon Client application to the user group that you created.
e On the Deployment tab, set Application uses AirWatch SDK to Yes and select the SDK profile
that you created from the SDK Profile drop-down menu.
f Publish the Horizon Client application.
6Install and set up the AirWatch Agent on each device.
You can download the AirWatch Agent from the Google Play Store or Amazon Appstore for Android.
7Use the AirWatch console to install the Horizon Client application on the devices.
You cannot install the Horizon Client application before the effective date on the Deployment tab.
AirWatch delivers Horizon Client to the devices in the user group that you associated with the
Horizon Client application.
When a user launches Horizon Client, Horizon Client communicates with the AirWatch Agent on the
device. If you configured a list of Connection Server instances, AirWatch pushes the server information to
the AirWatch Agent on the device and shortcuts for those servers appear in Horizon Client.
What to do next
You can use the AirWatch console to edit the Horizon Client application and push those changes to
devices.
Configure AirWatch to Deliver Horizon Client to Android for Work
Devices
You can configure AirWatch to deliver Horizon Client to Android for Work device users.
You can optionally specify a list of Connection Server instances or a default Connection Server instance.
If you specify a list of servers, the servers appear as shortcuts in Horizon Client. If you specify a default
server, Horizon Client automatically connects to that server.
Use this procedure only if your environment is set up for Android for Work. If your environment is not set
up for Android for Work, see Configure AirWatch to Deliver Horizon Client to Android Devices.
Prerequisites
nVerify that your AirWatch environment is integrated with Android for Work. See the AirWatch
documentation or online help.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 17
nInstall and deploy AirWatch. You must install AirWatch Server v8.0 FP02 or later and AirWatch Agent
v4.2 or later. See http://www.air-watch.com. You can download AirWatch Agent from Google Play
Store or Amazon Appstore for Android.
nBecome familiar with the AirWatch console. This procedure assumes that you know how to use the
AirWatch console. See the AirWatch documentation or online help.
nVerify that you have a corporate Google account. You must have a corporate Google account to enroll
Android for Work devices. For information about the enrollment process, see the AirWatch
documentation or online help.
Procedure
1Log in to the AirWatch Console as an administrator.
2Create and configure a smart group for your Horizon Client users in AirWatch.
a Select Groups and Settings > Groups > Assignment Groups.
b Click Add Smart Group.
c Enter the smart group name, select the smart group type, and configure the smart group
properties.
d Click Save.
3Add the Horizon Client application to AirWatch.
a Select Apps & Books > Applications > List View.
b On the Public tab, click Add Application.
c Select Android from the Platform drop-down menu, click Search App Store, enter
com.vmware.view.client.android in the Name text box, and click Next.
d Click Select next to the Horizon Client application.
e Click Save & Publish.
4Assign the Horizon Client application to users and configure the deployment details.
a Select Apps & Books > Applications > List View.
b On the Public tab, click the Edit icon next to the Horizon Client application.
c On the Assignment tab, assign the Horizon Client application to the smart group that you
created.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 18
d (Optional) On the Deployment tab, select a push mode, select the Send Application
Configuration check box, enter broker_list in the Configuration Key text box, select String
from the Value Type drop-down menu, and enter a list of servers in the Configuration Value text
box in JSON format.
Use the server property to specify the IP address or host name of the server, the username and
domain properties to specify the name and domain of a user that is entitled to the server, and the
description property to specify a description of the server. The username, domain, and
description properties are optional. For example:
{
"settings":{
"server-list":
[
{"server":"123.456.1.1","username":"User1","domain":"TestDomain1","description":"View
server 1"},
{"server":"123.456.1.2","username":"User2","domain":"TestDomain2","description":"View
server 2"},
{"server":"123.456.1.3","username":"User3","domain":"TestDomain3","description":"View
server 3"},
{"server":"viewserver4.mydomain.com","username":"User4","domain":"TestDomain4","description":"V
iew server 4"}
]
}
}
You can use the default property to specify a default server. Valid values are true and false.
For example:
{
"settings":{
"server-list":
[
{"server":"123.456.1.1","username":"User1","domain":"TestDomain1","description":"View
server 1","default":true},
]
}
}
e Click Save & Publish to make the Horizon Client application available to end users.
5Enroll Android for Work devices.
You use your corporate Google account to enroll the devices.
6In the AirWatch Console, install the Horizon Client application on each device.
AirWatch delivers Horizon Client to the Android devices in the smart group that you created.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 19
When a user starts Horizon Client, Horizon Client communicates with the AirWatch Agent on the Android
device.
If you configured a list of Connection Server instances or a default Connection Server instance, AirWatch
pushes the server information to the AirWatch Agent on the Android devices.
What to do next
You can use the AirWatch console to edit the Horizon Client application and push those changes to
mobile devices. For example, you can add a default Connection Server instance to the server list for the
Horizon Client application.
Configuring a List of Servers and a Default Server for
Chromebooks
You can configure a list of Connection Server instances and a default Connection Server instance for
Horizon Client on enrolled Chromebooks.
When you configure a list of servers, the servers appear as shortcuts in Horizon Client. If you configure a
default server, Horizon Client automatically connects to that server.
To configure a list of servers or a default server, you must create a JSON configuration file. A Chrome
administrator must use the Google Admin console to upload the JSON configuration file for the
Horizon Client app. For detailed information about using the Google Admin console, see the G Suite
Administrator Help.
For example, the following JSON configuration file specifies a list of servers. The server property
specifies the IP address or host name of the server, the username and domain properties specify the
name and domain of a user that is entitled to use the server, and the description property specifies a
description of the server. The username, domain, and description properties are optional.
{
"broker_list": "
{
\"settings\": {
\"server-list\": [{
\"server\": \"123.456.1.1\",
\"description\": \"View Server 1\",
\"username\": \"User1\",
\"domain\": \"TestDomain1\"
}, {
\"server\": \"123.456.1.2\",
\"description\": \"View Server 2\",
\"username\": \"User2\",
\"domain\": \"TestDomain2\"
}, {
\"server\": \"123.456.1.3\",
\"description\": \"View Server 3\",
\"username\": \"User3\",
\"domain\": \"TestDomain3\"
}, {
\"server\": \"viewserver4.mydomain.com\",
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 20
\"description\": \"View Server 4\",
\"username\": \"User4\",
\"domain\": \"TestDomain4\"
}]}
}"
}
The following example shows how to use the default property to specify a default server. Valid values
are true and false.
{
"broker_list": "
{
\"settings\": {
\"server-list\": [{
\"server\": \"123.456.1.1\",
\"description\": \"View Server 1\",
\"default\": true,
\"username\": \"User1\",
\"domain\": \"TestDomain1\"
}]}
}"
}
You can install Horizon Client only on certain Chromebook models. For information, see System
Requirements for Chromebooks.
Configure Horizon Client in Thin Client Mode
You can configure Horizon Client to work on a thin client by enabling the Thin Client mode setting.
Prerequisites
Install Horizon Client on the thin client. For thin client requirements, see System Requirements for Thin
Clients.
Procedure
1Start Horizon Client on the thin client.
2Tap the Settings (gear) icon in the upper-right corner of the Horizon Client window.
3Tap Thin Client mode and select the Thin Client mode check box.
What to do next
See Using Horizon Client on a Thin Client.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 21
Using Horizon Client on a Thin Client
Some features are different or unavailable when you use Horizon Client in thin client mode.
nThe Horizon Client window resolution is set to Auto-fit by default. The auto-fit resolution is the same
as the thin client's HDMI output. For example, if the thin client supports HDMI 4K output, the auto-fit
resolution is 4K. If the thin client supports HDMI 1080p output, the auto-fit resolution is 1920x1080.
You can downscale the resolution by modifying the Horizon Client Resolution setting.
nThe Horizon Client Presentation Mode and Stay Awake display settings are not available.
nYou cannot modify the Horizon Client Keyboard settings.
nThe Horizon Client Tools radial menu is not available in remote desktops and applications.
nIn general, the gestures you use in Horizon Client depend on the thin client model and the type of
external input device that you use with the thin client. For example, you might have a keyboard,
mouse, remote control, or game controller. See the documentation for the external input device for
more information.
nThe Unity Touch sidebar contains Keyboard, Settings, and Disconnect icons. For more information,
see Using the Unity Touch Sidebar with a Remote Desktop and Using the Unity Touch Sidebar with a
Remote Application.
nThe Unity Touch sidebar is supported on Remix Mini and NVIDIA SHIELD Android TV devices. The
Unity Touch sidebar is not supported on Amazon Fire TV.
nIf you are connected to a remote desktop or application from an Amazon Fire TV device, you must
use a pop-up menu to display Horizon Client Settings and to disconnect from the remote desktop or
application. On a remote control or external keyboard, press the Menu button to display the pop-up
menu.
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 their PIN and a 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. To install the token, end users paste this URL
directly into Horizon Client on their client devices. The dialog box for pasting this URL appears when end
users connect to a Connection Server instance with Horizon Client.
Horizon Client also supports file-based provisioning. When a file-based software token is issued to a user,
the authentication server generates an XML-format token file called an SDTID file. Horizon Client can
import the SDTID file directly. Users can also launch Horizon Client by tapping the SDTID file in a file
browser.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 22
After the software token is installed, end users enter a PIN to authenticate. With external RSA tokens,
end users must enter a PIN and the token code generated by a hardware or software authentication
token.
The following URL prefixes are supported for end users that copy and paste the URL into Horizon Client
when Horizon Client is connected to an RSA-enabled Connection Server instance:
nviewclient-securid://
nhttp://127.0.0.1/securid/
End users can install the token by tapping the URL. Both the viewclient-securid:// and
http://127.0.0.1/securid/ prefixes are supported. Not all browsers support hyperlinks that begin
with http://127.0.0.1. Some file browsers, such as the File Manager app on the ASUS Transformer
Pad, cannot link the SDTID file with Horizon Client.
For information about using dynamic seed provisioning or file-based (CTF) provisioning, see the Web
page RSA SecurID Software Token for iPhone Devices at http://www.rsa.com/node.aspx?id=3652 or RSA
SecurID Software Token for Android at http://www.rsa.com/node.aspx?id=3832.
Instructions to End Users
When you create a CTFString URL or CT-KIP URL to send to end users, you can generate a URL with or
without a password or activation code. You send this URL to end users in an email that must include the
following information:
nInstructions for navigating to the Install Software Token dialog box.
Tell end users to tap External Token in the Horizon Client dialog box that prompts them for RSA
SecurID credentials when they connect to a Connection Server instance.
nCTFString URL or CT-KIP URL in plain text.
If the URL has formatting on it, end users will get an error message when they try to use it in
Horizon Client.
nActivation code, if the CT-KIP URL that you create does not already include the activation code.
End users must enter this activation code in a text field of the dialog box.
nIf the CT-KIP URL includes an activation code, tell end users that they need not enter anything in the
Password or Activation Code text box in the Install Software Token dialog box.
Configure Advanced TLS/SSL Options
You can select the security protocols and cryptographic algorithms that are used to encrypt
communications between Horizon Client and Horizon servers and between Horizon Client and the agent
in the remote desktop.
By default, TLSv1.0, TLSv1.1, and TLSv1.2 are enabled. SSL v2.0 and 3.0 are not supported. The default
cipher control string is "!aNULL:kECDH+AESGCM:ECDH+AESGCM:RSA+AESGCM:kECDH
+AES:ECDH+AES:RSA+AES".
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 23
If you configure a security protocol for Horizon Client that is not enabled on the Horizon server to which
the client connects, a TLS/SSL error occurs and the connection fails.
For information about configuring the security protocols that are accepted by Connection Server
instances, see the View Security document.
Procedure
1Open Settings and tap Security options.
If you are connected to a remote desktop or application in full-screen mode, tap the Horizon Client
Tools radial menu icon and tap the gear icon to access Settings. If you are not using full-screen
mode, Settings is in the menu in the upper right corner of the Horizon Client toolbar. If you are not
connected to a remote desktop or application, tap the gear icon in the upper right corner of the
Horizon Client window.
2Tap Advanced SSL Options.
3Make sure that Use Default Settings is unchecked.
4To enable or disable a security protocol, tap the check box next to the security protocol name.
5To change the cipher control string, replace the default string.
6(Optional) If you need to revert to the default settings, tap to select the Use Default Settings option.
7Tap OK to save your changes.
Your changes take effect the next time you connect to the server.
Configure VMware Blast Options
You can configure H.264 decoding and network condition options for remote desktop and application
sessions that use the VMware Blast display protocol.
You cannot configure VMware Blast settings after you connect to a server.
JPG/PNG encoding is always used in multi-monitor mode, even when H.264 decoding is enabled.
Prerequisites
To use this feature, Horizon Agent 7.0 or later must be installed.
Procedure
1Before you log in to a server, tap the Settings (gear) icon in the upper-right corner of the
Horizon Client window and tap VMware Blast.
You cannot configure VMware Blast settings after you log in to a server.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 24
2Configure the decoding and network condition options.
Option Action
H.264 Select this option to allow H.264 decoding in Horizon Client.
When this option is selected (the default setting), Horizon Client uses H.264
decoding if the agent supports H.264 software or hardware encoding. If the agent
does not support H.264 software or hardware encoding, Horizon Client uses
JPG/PNG decoding.
Deselect this option to use JPG/PNG decoding.
Network Condition Select one of the following network condition options:
nExcellent - Horizon Client uses only TCP networking. This option is ideal for
a LAN environment.
nTypical (default) - Horizon Client works in mixed mode. In mixed mode,
Horizon Client uses TCP networking when connecting to the server and uses
Blast Extreme Adaptive Transport (BEAT) if the agent and Blast Security
Gateway (if enabled) support BEAT connectivity. This option is the default
setting.
nPoor - Horizon Client uses only BEAT networking if the BEAT Tunnel Server
is enabled on the server, otherwise it switches to mixed mode.
Note In Horizon 7 version 7.1 and earlier, Connection Server and Security
Server instances do not support the BEAT Tunnel Server.
Unified Access Gateway 2.9 and later supports the BEAT Tunnel Server.
Blast Security Gateway for Connection Server and Security Server instances do
not support BEAT networking.
Changes for H.264 take effect the next time a user connects to a remote desktop or application and
selects the VMware Blast display protocol. Your changes do not affect existing VMware Blast sessions.
Configure the Horizon Client Default View
You can configure whether recently used desktops and applications or server shortcuts appear when you
launch Horizon Client.
Procedure
1Open Settings and tap Display.
If you are connected to a remote desktop or application in full-screen mode, tap the Horizon Client
Tools radial menu icon and tap the gear icon to access Settings. If you are not using full-screen
mode, Settings is in the menu in the upper right corner of the Horizon Client toolbar. If you are not
connected to a remote desktop or application, tap the gear icon in the upper right corner of the
Horizon Client window.
2Tap Default launch view.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 25
3Tap an option to select the default view.
Option Description
Recent The Recent tab appears when you launch Horizon Client. The Recent tab
contains shortcuts to recently used desktops and applications. This is the default
setting.
Servers The Servers tab appears when you launch Horizon Client. The Servers tab
contains shortcuts to the servers that you added to Horizon Client.
The default view you selected takes effect immediately.
Horizon Client Data Collected by VMware
If your company participates in the customer experience improvement program, VMware collects data
from certain Horizon Client fields. Fields that contain sensitive information are anonymous.
VMware collects data on client systems 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 to respond better to customer requirements.
VMware does not collect data that identifies your organization. Horizon Client information is sent first to
the Connection Server instance and then to VMware, with data from Connection Server, desktop pools,
and remote desktops.
Although the information is encrypted while in transit to the Connection Server instance, the information
on the client system is logged unencrypted in a user-specific directory. The logs do not contain any
personally identifiable information.
The administrator who installs Connection Server can select whether to participate in the VMware
customer experience improvement program while running the Connection Server installation wizard, or an
administrator can set an option in Horizon Administrator after the installation.
Table 1‑1. Data Collected from Horizon Clients for the Customer Experience Improvement
Program
Description
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.)
Client binary architecture No Examples include the following:
ni386
nx86_64
narm
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 26
Table 1‑1. Data Collected from Horizon Clients for the Customer Experience Improvement
Program (Continued)
Description
Is This Field
Made
Anonymous? Example Value
Client build name No Examples include the following:
nVMware-Horizon-Client-Win32-Windows
nVMware-Horizon-Client-Linux
nVMware-Horizon-Client-iOS
nVMware-Horizon-Client-Mac
nVMware-Horizon-Client-Android
nVMware-Horizon-Client-WinStore
Host operating system No Examples include the following:
nWindows 8.1
nWindows 7, 64-bit Service Pack 1 (Build 7601 )
niPhone OS 5.1.1 (9B206)
nUbuntu 12.04.4 LTS
nMac OS X 10.8.5 (12F45)
Host operating system kernel No Examples include the following:
nWindows 6.1.7601 SP1
nDarwin Kernel Version 11.0.0: Sun Apr 8 21:52:26 PDT 2012;
root:xnu-1878.11.10~1/RELEASE_ARM_S5L8945X
nDarwin 11.4.2
nLinux 2.6.32-44-generic #98-Ubuntu SMP Mon Sep 24
17:27:10 UTC 2012
nunknown (for Windows Store)
Host operating system architecture No Examples include the following:
nx86_64
ni386
narmv71
nARM
Host system model No Examples include the following:
nDell Inc. OptiPlex 960
niPad3,3
nMacBookPro8,2
nDell Inc. Precision WorkStation T3400 (A04 03/21/2008)
Host system CPU No Examples include the following:
nIntel(R) Core(TM)2 Duo CPU E8400 @ 3.00GH
nIntel(R) Core(TM)2 Quad CPU Q6600 @ 2.40GH
nunknown (for iPad)
Number of cores in the host system's
processor
No For example: 4
MB of memory on the host system No Examples include the following:
n4096
nunknown (for Windows Store)
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 27
Table 1‑1. Data Collected from Horizon Clients for the Customer Experience Improvement
Program (Continued)
Description
Is This Field
Made
Anonymous? Example Value
Number of USB devices connected No 2 (USB device redirection is supported only for Linux, Windows,
and Mac clients.)
Maximum concurrent USB device
connections
No 2
USB device vendor ID No Examples include the following:
nKingston
nNEC
nNokia
nWacom
USB device product ID No Examples include the following:
nDataTraveler
nGamepad
nStorage Drive
nWireless Mouse
USB device family No Examples include the following:
nSecurity
nHuman Interface Device
nImaging
USB device usage count No (Number of times the device was shared)
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 28
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 start Horizon Client, connect to a server, and open 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. You create these links by constructing URIs that provide some or all the following
information, so that your end users do not need to supply it:
nConnection Server address
nPort number for Connection Server
nActive Directory user name
nRADIUS or RSA SecurID user name, if different from the Active Directory user name
nDomain name
nDesktop or application display name
nActions including reset, log out, and start session
To construct a URI, you use the vmware-view URI scheme with Horizon Client specific path and query
parts.
Note You can use URIs to start Horizon Client only if the client software is already installed on client
computers.
This chapter includes the following topics:
nSyntax for Creating vmware-view URIs
nExamples of vmware-view URIs
Syntax for Creating vmware-view URIs
Syntax includes the vmware-view URI scheme, a path part to specify the desktop or application, and,
optionally, a query to specify desktop or application actions or configuration options.
VMware, Inc. 29
URI Specification
Use the following syntax to create URIs to start Horizon Client:
vmware-view://[authority-part][/path-part][?query-part]
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.
For information about encoding for ASCII characters, see the URL encoding reference at
http://www.utf8-chartable.de/.
authority-part Specifies the server address and, optionally, a user name, a non-default
port number, or both. Underscores (_) are not supported in server names.
Server names must conform to DNS syntax.
To specify a user name, use the following syntax:
user1@server-address
You cannot specify a UPN address, which includes the domain. To specify
the domain, you can use the domainName query part in the URI.
To specify a port number, use the following syntax:
server-address:port-number
path-part Specifies the desktop or application. Use the desktop display name or
application display name. This name is the one specified in Horizon
Administrator when the desktop or application pool was created. If the
display name has a space in it, use the %20 encoding mechanism to
represent the space.
query-part Specifies the configuration options to use or the desktop or application
actions to perform. Queries are not case-sensitive. To use multiple queries,
use an ampersand (&) between the queries. If queries conflict with each
other, the last query in the list is used. Use the following syntax:
query1=value1[&query2=value2...]
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 30
Supported Queries
This topic lists the queries that are supported for this type of Horizon Client. If you are creating URIs for
multiple types of clients, such as desktop clients and mobile clients, see the Using VMware Horizon Client
guide for each type of client system.
action Table 2‑1. Values That Can Be Used With the action Query
Value Description
browse Displays a list of available desktops and applications hosted on the
specified server. You are not required to specify a desktop or application
when using this action.
If you use the browse action and specify a desktop or application, the
desktop or application is highlighted in the list of available items.
start-session Opens the specified desktop or application. If no action query is provided
and the desktop or application name is provided, start-session is the
default action.
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. Specifying an application is not supported. If
you specify an application, an error message appears.
If you do not specify a desktop or application, Horizon Client quits all
published applications.
restart Shuts down and restarts the specified desktop. Restarting a remote
desktop is the equivalent of the Windows operating system restart
command. The operating system usually prompts the user to save any
unsaved data before it restarts.
logoff Logs the user out of the guest operating system in the remote desktop. If
you specify an application, the action is ignored or the end user sees the
warning message "Invalid URI action."
args Specifies command-line arguments to add to published application launch.
Use the syntax args=value, where value is a string. Use percent encoding
for the following characters:
nFor a colon (:), use %3A
nFor a back slash (\), use %5C
nFor a space ( ), use %20
nFor a double quotation mark ("), use %22
For example, to specify the filename "My new file.txt" for the Notepad
++ application, use %22My%20new%20file.txt%22.
appProtocol For published applications, valid values are PCOIP and BLAST. For
example, to specify PCoIP, use the syntax appProtocol=PCOIP.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 31
defaultLaunchView Sets the default launch view for Horizon Client. Valid values are recent
and servers.
desktopProtocol For remote desktops, valid values are PCOIP and BLAST. For example, to
specify PCoIP, use the syntax desktopProtocol=PCOIP.
domainName The NETBIOS domain name associated with the user who is connecting to
the remote desktop or published application. For example, you might use
mycompany rather than mycompany.com.
tokenUserName Specifies the RSA or RADIUS user name. Use this query only if the RSA or
RADIUS user name is different from the Active Directory user name. If you
do not specify this query and RSA or RADIUS authentication is required,
the Windows user name is used. The syntax is tokenUserName=name.
unauthenticatedAccess
Enabled
If this option is set to true, the Unauthenticated Access feature is enabled
by default. If this option is set to false, the Unauthenticated Access feature
is disabled. When this option is set to "", the Unauthenticated Access
feature is disabled. The Log in anonymously using Unauthenticated
Access option is available in the Horizon Client settings. An example of the
syntax is unauthenticatedAccessEnabled=true.
unauthenticatedAccess
Account
Sets the account to use if the Unauthenticated Access feature is enabled. If
Unauthenticated Access is disabled, then this query is ignored. An example
of the syntax using the anonymous1 user account is
unauthenticatedAccessAccount=anonymous1.
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, open 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.
1vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session
Horizon Client starts 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, the client connects to
the desktop whose display name is displayed as Primary Desktop, and the user is logged in to the
guest operating system.
Note The default display protocol and window size are used. The default display protocol is PCoIP.
The default window size is full screen.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 32
2vmware-view://view.mycompany.com:7555/Primary%20Desktop
This URI has the same effect as the previous example, except that it uses the nondefault port of 7555
for Connection Server. (The default port is 443.) Because a desktop identifier is provided, the desktop
opens even though the start-session action is not included in the URI.
3vmware-view://fred@view.mycompany.com/Finance%20Desktop?desktopProtocol=PCOIP
Horizon Client starts and connects to the view.mycompany.com server. In the login box, the User
name text box is populated with the name fred. The user must supply the domain name and
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. The
connection uses the PCoIP display protocol.
4vmware-view://view.mycompany.com/Calculator?action=start-session&appProtocol=BLAST
Horizon Client starts and connects to the view.mycompany.com server. In the login box, the user
must supply the user name, domain name, and password. After a successful login, the client
connects to the application whose display name is displayed as Calculator. The connection uses the
VMware Blast display protocol.
5vmware-view://fred@view.mycompany.com/Finance%20Desktop?domainName=mycompany
Horizon Client starts 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.
6vmware-view://view.mycompany.com/
Horizon Client starts and the user is taken to the login prompt for connecting to the
view.mycompany.com server.
7vmware-view://view.mycompany.com/Primary%20Desktop?action=reset
Horizon Client starts 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.
Note This action is available only if a Horizon administrator has enabled the desktop reset feature
for the desktop.
8vmware-view://view.mycompany.com/Primary%20Desktop?action=restart
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 33
Horizon Client starts 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 restart operation for Primary Desktop.
Note This action is available only if a Horizon administrator has enabled the desktop restart feature
for the desktop.
9vmware-view://view.mycompany.com?action=reset
Horizon Client starts 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 all remote applications.
10 vmware-view://
If the client is already running, the Horizon Client application comes to the foreground. If the client is
not already running, Horizon Client starts.
11 vmware-view://?defaultlaunchview=recent
Horizon Client starts and the user sees the Recent tab.
12 vmware-view://10.10.10.10/My%20Notepad++?args=%22My%20new%20file.txt%22
Launches My Notepad++ on server 10.10.10.10 and passes the argument My new file.txt in the
application launch command. The filename is enclosed in double quotes because it contains spaces.
13 vmware-view://10.10.10.10/Notepad++%2012?args=a.txt%20b.txt
Launches Notepad++ 12 on server 10.10.10.10 and passes the argument a.text b.txt in the
application launch command. Because the argument is not enclosed in quotes, a space separates the
filenames and the two files are opened separately in Notepad++.
Note Applications can differ in the way they use command line arguments. For example, if you pass
the argument a.txt b.txt to Wordpad, Wordpad will open only one file, a.txt.
14 vmware-view://view.mycompany.com/Notepad?
unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous1
Horizon Client starts and connects to the view.mycompany.com server using the anonymous1 user
account. The Notepad application is launched without prompting the user to provide login credentials.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 34
HTML Code Examples
You can use URIs to make hypertext links and buttons to include in emails or on Web pages. The
following examples show how to use the URI from the first URI example to code a hypertext link that
says, Test Link, and a button that says, TestButton.
<html>
<body>
<a href="vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session">Test Link</a><br>
<form><input type="button" value="TestButton" onClick="window.location.href=
'vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session'"></form> <br>
</body>
</html>
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 35
Managing Remote Desktop and
Application Connections 3
End users can use Horizon Client to connect to a server, edit the list of servers they connect to, log in to
or off of remote desktops, and use remote applications. For troubleshooting purposes, end users can also
reset remote desktops and applications.
Depending on how you configure policies for remote desktops, end users might be able to perform many
operations on their desktops.
This chapter includes the following topics:
nSetting the Certificate Checking Mode in Horizon Client
nConnect to a Remote Desktop or Application
nUse Unauthenticated Access to Connect to Remote Applications
nShare Access to Local Storage with Client Drive Redirection
nCreate a Remote Desktop or Application Shortcut
nManage Server Shortcuts
nSelect a Favorite Remote Desktop or Application
nSwitch Remote Desktops or Published Applications
nReconnecting to a Desktop or Published Application
nDisconnecting From a Remote Desktop or Application
nLog Off From a Remote Desktop
nManage Desktop and Application Shortcuts
nUsing Android 7.0 Nougat Multi-Window Modes with Horizon Client
nUsing Horizon Client with Samsung DeX
Setting the Certificate Checking Mode in Horizon Client
You can determine whether client connections are rejected if any or some server certificate checks fail by
configuring a setting in Horizon Client.
VMware, Inc. 36
Certificate checking occurs for SSL connections between the server and Horizon Client. Certificate
verification includes the following checks:
nIs the certificate intended for a purpose other than verifying the identity of the sender and encrypting
server communications? That is, is it the correct type of certificate?
nHas the certificate expired, or is it valid only in the future? That is, is the certificate valid according to
the computer clock?
nDoes the common name on the certificate match the host name of the server that sends it? A
mismatch can occur if a load balancer redirects Horizon Client to a server that has a certificate that
does not match the host name entered in Horizon Client. Another reason a mismatch can occur is if
you enter an IP address rather than a host name in the client.
nIs the certificate signed by an unknown or untrusted certificate authority (CA)? Self-signed certificates
are one type of untrusted CA.
To pass this check, the certificate's chain of trust must be rooted in the device's local certificate store.
Important For information about distributing a self-signed root certificate that users can install on their
Android devices, as well as instructions for installing a certificate on an Android device, see the
documentation on the Google Web site, such as the Android 3.0 User's Guide.
To set the certificate checking mode, start Horizon Client and open Settings. In Settings, tap Security
options and tap Security mode. You have three choices:
nNever connect to untrusted servers. If any of the certificate checks fails, the client cannot connect
to the server. An error message lists the checks that failed.
nWarn before connecting to untrusted servers. If a certificate check fails because the server uses a
self-signed certificate, you can click Continue to ignore the warning. For self-signed certificates, the
certificate name is not required to match the server name you entered in Horizon Client.
nDo 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 server that uses a self-signed
certificate.
If an administrator later installs a security certificate from a trusted certificate authority, so that all
certificate checks pass when you connect, this trusted connection is remembered for that specific server.
In the future, if that server ever presents a self-signed certificate again, the connection fails. After a
particular server presents a fully verifiable certificate, it must always do so.
Connect to a Remote Desktop or Application
To connect to a remote desktop or application, you must provide the name of a server and supply
credentials for your user account.
Before you have end users access their remote desktops and applications, test that you can connect to a
remote desktop or application from a client device. You might need to specify a server and supply
credentials for your user account.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 37
Prerequisites
nObtain login credentials, such as a user name and password, RSA SecurID user name and
passcode, RADIUS authentication user name and passcode, or smart card personal identification
number (PIN).
nObtain the NETBIOS domain name for logging in. For example, you might use mycompany rather than
mycompany.com.
nPerform the administrative tasks described in Preparing Connection Server for Horizon Client.
nIf you are outside the corporate network and require a VPN connection to access remote desktops
and applications, verify that the client device is set up to use a VPN connection and turn on that
connection.
nVerify that you have the fully qualified domain name (FQDN) of the server that provides access to the
remote desktop or application. Underscores (_) are not supported in server names. If the port is not
443, you also need the port number.
nIf you plan to use embedded RSA SecurID software, verify that you have the correct CT-KIP URL and
activation code. See Using Embedded RSA SecurID Software Tokens.
nConfigure the certificate checking mode for the SSL certificate presented by the server. See Setting
the Certificate Checking Mode in Horizon Client.
nIf you plan to use fingerprint authentication, verify that the Fingerprint Authentication option is enabled
and at least one fingerprint is enrolled on the client device. For complete fingerprint authentication
requirements, see Fingerprint Authentication Requirements.
Procedure
1If a VPN connection is required, turn on the VPN.
2On the client device, tap the Horizon app icon.
3Connect to a server.
Option Action
Connect to a new server Enter the name of a server, enter a description (optional), and tap Connect.
Connect to an existing server Tap the server shortcut on the Servers tab.
Connections between Horizon Client and servers always use SSL. The default port for SSL
connections is 443. If the server is not configured to use the default port, use the format shown in this
example: view.company.com:1443.
4If a smart card is required or optional, select the smart card certificate to use and enter your PIN.
If your smart card has only one certificate, that certificate is already selected. If there are many
certificates, you can scroll through the certificates.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 38
5If you are prompted for RSA SecurID credentials or RADIUS authentication credentials, either type
your credentials or, if you plan to use an embedded RSA SecurID token, install an embedded token.
Option Action
Existing token If you use a hardware authentication token or software authentication token on a
smart phone, enter your user name and passcode. The passcode might include
both a PIN and the generated number on the token.
Install software token Tap External Token. In the Install Software Token dialog box, paste the CT-KIP
URL or CTFString URL that your administrator sent to you in email. If the URL
contains an activation code, you do not need to enter anything in the Password
or Activation Code text box.
6If you are prompted a second time for RSA SecurID credentials or RADIUS authentication
credentials, enter the next generated number on the token.
Do not enter your PIN, and do not enter the same generated number that you entered before. If
necessary, wait until a new number is generated.
If this step is required, it is required only when you mistype the first passcode or when configuration
settings in the RSA server change.
7If you are prompted for a user name and password, supply your Active Directory credentials.
a Type the user name and password of a user who is entitled to use at least one desktop or
application pool.
b Select a domain.
If the Domain drop-down menu is hidden, type the user name as username@domain or
domain\username.
c (Optional) If the Enable Fingerprint check box is available, select it to use fingerprint
authentication.
The Enable Fingerprint check box is available only if biometric authentication is enabled on the
server and you have not previously authenticated with fingerprint authentication.
d (Optional) Select the Save Password check box if your administrator has enabled this feature
and if the server certificate can be fully verified.
If this is the first time you are saving a password, you are prompted to activate the device
administrator, which is required to save a password on client devices.
e Tap Connect.
If fingerprint authentication is enabled and you are logging in for the first time, your Active Directory
credentials are stored securely in the client device's database for future use.
8If you are prompted for fingerprint authentication, place your finger on the fingerprint sensor.
If you do not want to use fingerprint authentication, tap Cancel. You can connect to the server again
and tap Use password to enter a user name and password.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 39
9(Optional) Tap the display protocol settings icon in the upper-right corner of the window to select the
display protocol to use.
VMware Blast provides better battery life and is the best protocol for high-end 3D and mobile device
users.
10 Tap a desktop or application to connect to it.
If you are connecting to a published desktop, and if the desktop is already set to use the Microsoft
RDP display protocol, you cannot connect immediately. You are prompted to have the system log you
off the remote operating system so that a connection can be made with the PCoIP display protocol or
the VMware Blast display protocol.
The remote desktop or application starts.
If you are using Horizon Client on a Chromebook or an Android device in DeX desktop mode, the remote
desktop or application starts in a new window instead of in the original window. The desktop and
application selector window also remains open, so that you can connect to multiple items at the same
time. When you open a new application, Horizon Client opens all previous application sessions.
Horizon Client does not open previous application sessions when you open a remote desktop session.
You can have a maximum of four sessions at the same time.
After you connect to a desktop or application for the first time, a shortcut for the desktop or application is
saved to the Recent tab. The next time you want to connect to the remote desktop or application, you can
tap the shortcut instead of tapping the server icon.
Use Unauthenticated Access to Connect to Remote
Applications
A Horizon administrator can use the Unauthenticated Access feature to create Unauthenticated Access
users and entitle those users to remote applications on a Connection Server instance. Unauthenticated
Access users can log in to the server anonymously to connect to their remote applications.
Before you have end users access a remote application with the Unauthenticated User feature, test that
you can connect to the remote application from a client device. You might need to specify a server and
supply credentials for your user account.
Prerequisites
nPerform the administrative tasks described in Preparing Connection Server for Horizon Client.
nSet up Unauthenticated Access users on the Connection Server instance. For information, see
"Providing Unauthenticated Access for Published Applications" in the View Administration document.
nConfigure the certificate checking mode for the SSL certificate presented by the server. See Setting
the Certificate Checking Mode in Horizon Client.
nIf you are accessing remote applications outside of the corporate network, verify that your client
device is set up to use a VPN connection and turn on that connection.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 40
Procedure
1If a VPN connection is required, turn on the VPN.
2On the client device, open the Horizon app.
3Tap the Settings (gear) icon in the upper-right corner of the Horizon Client window, tap
Unauthenticated access, and select the Unauthenticated access check box.
4Connect to the server on which you have unauthenticated access to remote applications.
Option Description
Connect to a new server Enter the name of a server, enter a description (optional), and tap Connect.
Connect to an existing server Tap the server shortcut on the Servers tab.
Connections between Horizon Client and servers always use SSL. The default port for SSL
connections is 443. If the server is not configured to use the default port, use the format shown in this
example: view.company.com:1443.
5When the login window appears, select a user account from the User account drop-down menu, if
required.
If only one user account is available, the user account is automatically selected.
6(Optional) Select the Always use this account check box to bypass the login window the next time
you connect to the server.
To deselect this setting before you connect to the server the next time, touch and hold the server
shortcut until the context menu appears, tap Edit, tap Forget the saved Unauthenticated Access
account (name), and tap Done.
7Tap Connect to log in to the server.
The application selection window appears.
8Tap an application icon to start the application.
After you connect to a remote application for the first time, a shortcut for the application is saved to the
Recent tab. The next time you want to connect to the application, you can tap the shortcut instead of
tapping the server icon.
Share Access to Local Storage with Client Drive
Redirection
You can configure Horizon Client to share local storage with a remote desktop or application. This feature
is called client drive redirection.
In a Windows remote desktop or remote application, local storage appears in the Devices and drives
section in the This PC folder, or in the Other section in the Computer folder. The folders and storage
devices that you select for sharing use the naming format name on HorizonClient.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 41
Prerequisites
nEnable the client drive redirection feature. This task includes installing View Agent 6.1.1 or later, or
Horizon Agent 7.0 or later, and enabling the agent Client Drive Redirection option. It can also
include setting policies or registry settings to control client drive redirection behavior. For more
information, see the Configuring Remote Desktop Features in Horizon 7 document.
nConnect to the remote desktop or application with which you want to share local storage. If you have
not logged in at least once, become familiar with the procedure Connect to a Remote Desktop or
Application.
Procedure
1Open Settings and tap Local storage redirection.
If you are connected to the remote desktop or application in full-screen mode, tap the Horizon Client
Tools radial menu icon and tap the gear icon. If you are not using full-screen mode, Settings is in the
menu in the upper-right corner of the Horizon Client toolbar.
2Tap Local Storage Redirection and configure the local storage redirection options.
Option Action
Automatically share all removable
storage devices
Select the Enable auto direct for mounted storage check box. All removable
storage devices mounted to your device are automatically shared with the remote
desktop or application. This option is selected by default.
Do not automatically share all
removable storage devices
Deselect the Enable auto direct for mounted storage check box. The next time
you connect to the remote desktop or application, removable storage devices
mounted to your device are not automatically shared with the remote desktop or
application.
Note Deselecting the Enable auto direct for mounted storage check box does
not stop sharing a removable storage device that is already shared with the
remote desktop or application.
Share a specific folder or removable
storage device
Select the check box next to the name of the local folder or removable storage
device in the list. The device becomes available in the remote desktop or
application.
When you connect a removable storage device, its name appears in the list.
When you disconnect a removable storage device, its name is removed from the
list.
Stop sharing a specific folder or
removable storage device
Deselect the check box next to the name of the local folder or removable storage
device in the list. The device is no longer available in the remote desktop or
application.
3Tap OK to save your settings.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 42
What to do next
Verify your changes from within the remote desktop or application.
nFrom within a Windows remote desktop, open the This PC folder and look in the Devices and drives
section, or open the Computer folder and look in the Other section. If you shared a folder or storage
device, you should see the folder or device. Shared folders and storage devices use the naming
format name on HorizonClient.
nFrom a remote application, select File > Open or File > Save As, if applicable. If you shared a folder
or storage device, you should be able to navigate to the folder or device. Shared folders and storage
devices use the naming format name on HorizonClient.
Create a Remote Desktop or Application Shortcut
You can add a shortcut for a remote desktop or application to the Android home screen and then tap the
shortcut to open the remote desktop or application. When Horizon Client is installed on a Chromebook,
Horizon Client adds the remote desktop or application shortcut to the Chrome App Launcher.
On Android 4 through 7 devices, Horizon Client adds the remote desktop or application shortcut to the
Android home screen.
On Android 8 devices, remote desktop and application shortcuts appear as entries above the Horizon
app icon when you touch and hold the app icon. You can drag an entry from the app icon to the Android
home screen to create a shortcut directly on the Android home screen.
This feature is not available on Amazon devices, on Android devices that are managed by AirWatch, or
when you connect to the server anonymously by using the Unauthenticated Access feature.
Procedure
1You can add a desktop or application shortcut before or after you connect to a server.
If you are not connected to a server, you must have connected to the remote desktop or application at
least once from the device so that a shortcut for the desktop or application appears on the Recent
tab.
Option Action
If you have not connected to a server On the Recent tab, touch and hold the shortcut until Add To Home appears at
the bottom of the window and then drag the shortcut to Add To Home.
If you are connected to a server On the All or Favorites tab, touch and hold the desktop or application shortcut
until the context menu appears and tap Add To Home.
2Type a name for the shortcut and tap OK.
If the name is longer than 12 characters, the extra characters do not appear in the shortcut.
Manage Server Shortcuts
After you connect to a server, Horizon Client creates a server shortcut. You can edit and remove server
shortcuts.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 43
Horizon Client saves the server name or IP address in a shortcut, even if you mistype the server name or
type the wrong IP address. You can delete or change this information by editing the server name or IP
address. If you do not type a server description, the server name or IP address becomes the server
description.
Server 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 server shortcuts.
Procedure
1On the Servers tab, touch and hold the server shortcut until the context menu appears.
2Use the context menu to delete the server or edit the server name, server description, or user name.
You can also remove a credential that was saved for fingerprint authentication by tapping Remove
Credential.
Select a Favorite Remote Desktop or Application
You can select remote desktops and applications as favorites. Favorites are identified by a star. The star
helps you quickly find your favorite desktops and applications. Your favorite selections are saved, even
after you log off from the server.
Prerequisites
Obtain the credentials you need to connect to the server, such as a user name and password or RSA
SecurID and passcode.
Procedure
1On the Servers tab, tap the server shortcut to connect to the server.
2If prompted, supply your RSA user name and passcode, your Active Directory user name and
password, or both.
3Perform these steps to select or deselect a desktop or application as a favorite.
Option Action
Select a favorite Touch and hold the desktop or application name until the context menu appears
and tap Mark as Favorite. A star appears in the upper right corner of the name
and the name appears on the Favorites tab.
Deselect a favorite On the All or Favorites tab, touch and hold the desktop or application name until
the context menu appears and tap Unmark Favorite. A star no longer appears in
the upper right corner of the name and the name disappears from the Favorites
tab.
4(Optional) Tap the Favorites tab to display only favorite desktops or applications.
You can tap the All tab to display all the available desktops and applications.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 44
Switch Remote Desktops or Published Applications
Horizon Client supports multiple remote desktop and application sessions when you use a Chromebook
or an Android device in DeX desktop mode. You can switch these remote desktop and application
sessions.
Procedure
uSelect a remote desktop or published application from the same server or a different server.
Option Description
Choose a different desktop or
application on the same server
From the desktop and application selector window, tap the other desktop or
application. The desktop or application opens in a new window so that now you
have multiple windows open and you can switch between them.
Note If the new application is in the same farm as the current application, the
new application opens in the same window.
Choose a different desktop or
application on a different server
Tap the Back button or the Disconnect icon in the upper-right corner of the
desktop and application selector window and tap Log Out to disconnect from the
server. You can now connect to a different server and open a new desktop or
application.
Reconnecting to a Desktop or Published Application
For security purposes, a Horizon administrator can set timeouts that log you off of a server after a certain
number of hours and that lock a published application after a certain number of minutes of inactivity.
If you have not used a published application for a certain amount of time, you receive a warning prompt
30 seconds before the application is automatically locked. If you do not respond, the application is locked.
By default, the timeout occurs after 15 minutes of inactivity, but your Horizon administrator can change
the time period. For example, if you have one or more applications open and you walk away from your
computer, the application windows might no longer be open when you return an hour later. Instead you
might see a dialog box that prompts you to click OK so that the application windows appear again.
The server timeout period is typically set for a certain number of hours of inactivity. By default, you are
required to log in again if you have Horizon Client open and connected to a particular server for more
than 10 hours. This timeout applies to both published application and remote desktop connections.
To configure these timeout settings in Horizon Administrator, go to Global Settings and edit the general
settings.
On a Chromebook or an Android device in DeX desktop mode, if you navigate to the desktop and
application selector window and one or more previous application sessions are disconnected,
Horizon Client prompts you to reconnect to the previous application sessions. You can click Reconnect
to applications to open the previous application sessions, or click Not now to dismiss the message. You
can also select a check box to not show the message again.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 45
Disconnecting From a Remote Desktop or Application
You can disconnect from a remote desktop without logging off, so that applications remain open on the
remote desktop. You can also disconnect from a remote application so that the remote application
remains open.
On a mobile device, when you are using a remote desktop or application in full-screen mode, you can
disconnect by tapping the Horizon Client Tools radial menu icon and tapping the Disconnect icon. If you
are not using full-screen mode, Disconnect is in the menu in the upper-right corner of the Horizon Client
toolbar.
On a thin client, when you are connected to a remote desktop or application, you disconnect by clicking
the Disconnect icon in the Unity Touch sidebar or in a pop-up menu, depending on your thin client
model. For more information, see Using Horizon Client on a Thin Client.
Note A Horizon administrator can configure a remote desktop to automatically log off when it is
disconnected. In that case, any open programs in the remote desktop are stopped.
Log O From a Remote Desktop
You can log off from a remote desktop operating system, even if you do not have a desktop open in
Horizon Client. If you are currently connected to and logged in to a remote desktop, you can use the
Windows Start menu to log off. After Windows logs you off, the desktop is disconnected.
Prerequisites
Obtain the credentials that you use to log in, such as your Active Directory user name and password,
RSA SecurID user name and passcode, or RADIUS authentication user name and passcode.
Procedure
1On the Servers tab, tap the server shortcut.
2If prompted, supply your RSA user name and passcode, your Active Directory user name and
password, or both.
3Touch and hold the desktop name until the context menu appears.
You can perform this step from either the All or Favorites tab.
4Tap Log Off in the context menu.
Any unsaved files that are open on the remote desktop are closed during the logoff operation.
What to do next
Tap the Back button or the Disconnect icon in the upper-right corner of the window and tap Log Out to
disconnect from the server.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 46
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.
Procedure
nPerform these steps to remove a desktop or application shortcut from the Recent tab.
a Touch and hold the shortcut until Remove Shortcut appears at the bottom of the window.
b Drag the shortcut to Remove Shortcut.
nTo move a desktop or application shortcut, touch and hold the shortcut and drag it to the new location.
You cannot drag a shortcut to another page unless that page already exists.
Using Android 7.0 Nougat Multi-Window Modes with
Horizon Client
Android 7.0 Nougat allows several apps to share the screen at the same time. You can use split-screen
mode with Horizon Client on an Android 7.0 Nougat device. Horizon Client does not support picture-in-
picture mode.
With split-screen mode, you can run Horizon Client and another app side-by-side, or one-above-the other.
A dividing line separates the two apps, and you can make one app larger and the other app smaller.
Using Horizon Client with Samsung DeX
If the Android device supports Samsung DeX, you can use Horizon Client in DeX desktop mode.
When the device is in DeX desktop mode, Horizon Client treats the device as a thin client and Thin Client
mode is enabled. For more information, see Using Horizon Client on a Thin Client.
The following features are supported when you use Horizon Client in Horizon DeX desktop mode:
nYou can configure Horizon Client to start automatically when you switch to DeX desktop mode. See
Enable the DeX Mode Auto Launch Feature.
nDesktop and application sessions continue to run after you enter or exit from DeX desktop mode.
nIf Horizon Client is maximized, remote desktops enter full-screen mode after you switch to DeX
desktop mode.
nYou can use the language switch key on a Samsung physical keyboard to switch the language input
method in a remote desktop.
nYou can connect to multiple remote desktops and applications at the same time. Smart card
authentication is not supported for multiple sessions.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 47
Enable the DeX Mode Auto Launch Feature
You can configure Horizon Client to start automatically when you switch the Android device to DeX
desktop mode.
If you added a desktop or application shortcut to the Android home screen, Horizon Client connects to the
most recent shortcut after Horizon Client starts. For information about adding shortcuts to the Android
home screen, see Create a Remote Desktop or Application Shortcut.
The DeX mode auto launch feature is disabled by default.
You cannot enable the DeX mode auto launch feature if a default Connection Server instance is
configured for Horizon Client.
Prerequisites
Verify that the Android device supports Samsung DeX.
Procedure
1Before you log in to a server, tap the Settings (gear) icon in the upper-right corner of the
Horizon Client window.
2Tap Display, tap Dex Mode Auto Launch, and select the Dex Mode Auto Launch check box.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 48
Using a Microsoft Windows
Desktop or Application 4
Horizon Client includes additional features to aid in navigation on Android devices, thin clients, and
Chromebooks. Users can use external devices with remote desktops and applications, copy text and
images from client devices to remote desktops and applications, and save documents in remote
applications.
This chapter includes the following topics:
nFeature Support Matrix
nInput Devices, Keyboards, and Keyboard Settings
nEnable the Japanese 106/109 Keyboard Layout
nUsing the Real-Time Audio-Video Feature
nUsing Native Operating System Gestures with Touch Redirection
nUsing the Unity Touch Sidebar with a Remote Desktop
nUsing the Unity Touch Sidebar with a Remote Application
nHorizon Client Tools on a Mobile Device
nGestures
nMultitasking
nCopying and Pasting Text and Images
nDragging and Dropping Text and Image Files
nSaving Documents in a Published Application
nScreen Resolutions and Using External Displays
nPCoIP Client-Side Image Cache
nInternationalization and International Keyboards
Feature Support Matrix
Some features are supported on one type of Horizon Client but not on another.
VMware, Inc. 49
Table 4‑1. Features Supported on Windows Desktops with Horizon Client for Android
Feature
Windows
10 Desktop
Windows 8.x
Desktop
Windows
7 Desktop
Windows
Vista
Desktop
Windows XP
Desktop
Windows Server
2008/2012 R2 or
Windows Server
2016 Desktop
RSA SecurID or RADIUS X X X Limited Limited X
Single sign-on X X X Limited Limited X
RDP display protocol
PCoIP display protocol X X X Limited Limited X
VMware Blast display
protocol
X X X X
USB redirection
Client drive redirection X X X X
Real-Time Audio-Video X X X X
Wyse MMR
Windows 7 MMR
Virtual printing
Location-based printing X X X Limited Limited X
Smart cards X X X Limited Limited X
Multiple monitors X X X X
Windows 10 desktops require View Agent 6.2 or later or Horizon Agent 7.0 or later. Windows Server 2012
R2 desktops require View Agent 6.1 or later or Horizon Agent 7.0 or later. Windows Server 2016 desktops
require Horizon Agent 7.0.2 or later.
Important View Agent 6.1 and later and Horizon Agent 7.0 and later releases do not support Windows
XP and Windows Vista desktops. View Agent 6.0.2 is the last View release that supports these guest
operating systems. Customers who have an extended support agreement with Microsoft for Windows XP
and Vista, and an extended support agreement with VMware for these guest operating systems, can
deploy the View Agent 6.0.2 version of their Windows XP and Vista desktops with Connection Server 6.1.
For descriptions of these features, see the View Planning document.
Feature Support for Published Desktops on RDS Hosts
RDS hosts are server computers that have Windows Remote Desktop Services and View Agent or
Horizon Agent installed. Multiple users can have desktop sessions on an RDS host simultaneously. An
RDS host can be either a physical machine or a virtual machine.
Note The following table contains rows only for the features that are supported. Where the text specifies
a minimum version of View Agent, the text "and later" is meant to include Horizon Agent 7.0.x and later.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 50
Table 4‑2. Features Supported for RDS Hosts with View Agent 6.0.x or Later, or
Horizon Agent 7.0.x or Later, Installed
Feature
Windows Server 2008 R2
RDS Host
Windows Server 2012
RDS Host
Windows Server 2016 RDS
Host
RSA SecurID or RADIUS X X Horizon Agent 7.0.2 and later
Smart card View Agent 6.1 and later View Agent 6.1 and later Horizon Agent 7.0.2 and later
Single sign-on X X Horizon Agent 7.0.2 and later
RDP display protocol X X Horizon Agent 7.0.2 and later
PCoIP display protocol X X Horizon Agent 7.0.2 and later
VMware Blast display protocol Horizon Agent 7.0 and later Horizon Agent 7.0 and later Horizon Agent 7.0.2 and later
HTML Access View Agent 6.0.2 and later
(virtual machine only)
View Agent 6.0.2 and later
(virtual machine only)
Horizon Agent 7.0.2 and later
Client drive redirection View Agent 6.1.1 and later View Agent 6.1.1 and later Horizon Agent 7.0.2 and later
Virtual printing View Agent 6.0.1 and later
(virtual machine only)
View Agent 6.0.1 and later
(virtual machine only)
Horizon Agent 7.0.2 and later
(virtual machine only)
Location-based printing View Agent 6.0.1 and later
(virtual machine only)
View Agent 6.0.1 and later
(virtual machine only)
Horizon Agent 7.0.2 and later
(virtual machine only)
Multiple monitors X X Horizon Agent 7.0.2 and later
Unity Touch X X Horizon Agent 7.0.2 and later
Real-Time Audio-Video (RTAV) Horizon Agent 7.0.2 and later Horizon Agent 7.0.2 and
later
Horizon Agent 7.0.3 and later
For information about which editions of each guest operating system are supported, see the View
Installation document.
Limitations for Specific Features
Specific features that are supported on Windows desktops for Horizon Client have certain restrictions.
Table 4‑3. Requirements for Specific Features
Feature Requirements
Location-based printing for Windows Server 2008
R2 desktops, published desktops (on virtual
machine RDS hosts), and remote applications
Horizon 6 version 6.0.1 and later servers.
Smart cards for published desktops View Agent 6.1 and later or Horizon Agent 7.0 and later.
Real-Time Audio-Video See System Requirements for Real-Time Audio-Video.
Client drive redirection View Agent 6.1.1 and later or Horizon Agent 7.0 and later.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 51
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 the Setting Up Horizon 6 for Linux Desktops or Setting Up Horizon 7 for Linux
Desktops document.
Input Devices, Keyboards, and Keyboard Settings
Horizon Client supports Bluetooth and docked keyboard devices and keyboards. You can also set
preferences for settings such as auto-capitalization and text correction.
External Keyboards and Input Devices
For information about the devices that a specific tablet supports, see the documentation from the tablet
manufacturer.
External keyboards are sometimes automatically detected by Horizon Client. For some external
keyboards, you must either tap the tablet screen with three fingers at the same time, or you must tap the
Keyboard icon. If you are using a remote desktop or application in full-screen mode, the Keyboard icon
is in the Horizon Client Tools radial menu. If you are not using full-screen mode, the Keyboard icon is on
the Horizon Client toolbar.
Note On Kindle Fire tablets, tapping with three fingers does not display the onscreen keyboard. You can
instead use the Keyboard icon to display the onscreen keyboard.
After the external keyboard is detected, you might not be able to use the Horizon Client Tools or three-
finger tap to display the onscreen keyboard. You might first have to deactivate the external keyboard by
pressing its Eject key.
International Onscreen Keyboards
With the correct input methods installed, you can input characters for the following languages: English-
United States, Japanese, French, German, Simplified Chinese, Traditional Chinese, Korean, and
Spanish.
To choose a language for the keyboard or voice, tap the Keyboard Settings key on the onscreen
keyboard. The Keyboard Settings key is the left-most key on the bottom row of the onscreen keyboard.
When you finish selecting settings, tap the Back button to dismiss the dialog box.
Enable the Japanese 106/109 Keyboard Layout
If you are connected to a Windows XP desktop, you can configure Horizon Client to use the Japanese
106/109 keyboard layout.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 52
Prerequisites
Use Horizon Client to connect to a Windows XP desktop that has the Japanese keyboard layout enabled.
Procedure
1Open Settings and tap Keyboard.
If you are using the remote desktop in full-screen mode, tap the Horizon Client Tools radial menu icon
and tap the gear icon. If you are not using full-screen mode, Settings is in the menu in the upper-right
corner of the Horizon Client toolbar. If you are not connected to a remote desktop or application, tap
the gear icon in the upper right corner of the Horizon Client window.
2Tap Use Japanese 106/109 Keyboard Layout to select the check box.
This setting is disabled if the keyboard layout on the Windows XP desktop is not set to Japanese or if
the desktop is not running Windows XP.
Using the Real-Time Audio-Video Feature
With the Real-Time Audio-Video feature, you can use the client device's built-in cameras and
microphones in a remote desktop. Real-Time Audio-Video is compatible with standard conferencing
applications such as Skype, WebEx, and Google Hangouts.
Real-Time Audio-Video is enabled by default when you install Horizon Client on the client device.
For information about setting up the Real-Time Audio-Video feature on a remote desktop, see the
Configuring Remote Desktop Features in Horizon 7 document.
When you install Horizon Client on an Android 6 or later device, Horizon Client prompts you for
permission to access the camera and microphone. You must grant permission for the camera and
microphone to work with the remote desktop. You can enable or disable access to the camera or
microphone in the Android Settings app. For Android devices earlier than Android 6, permission to the
camera and microphone is opened by default.
If the camera is currently being used by another app, it cannot be used by the remote desktop
simultaneously. Also, if the camera is being used by the remote desktop, it cannot be used by the client
device at the same time.
If the client device has both a front and a back camera, you can select which camera to use in the remote
desktop. If you are using a remote desktop in full-screen mode, tap the Horizon Client Tools radial menu
icon, tap the gear icon, tap Camera, tap Select a camera, and tap the camera to use. If you are not using
full-screen mode, Settings is in the menu in the upper-right corner of the Horizon Client toolbar. The
Camera setting is available only when the camera is started.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 53
Using Native Operating System Gestures with Touch
Redirection
You can use native operating system gestures from a touch-based mobile device when you are
connected to a Windows 8, Windows 10, or Windows Server 2012 remote desktop, or to a remote
application that is hosted on Windows Server 2012. For example, you can touch, hold, and release an
item on a Windows 8 desktop to display the item's context menu.
When touch redirection is enabled, you can use only native operating system touch gestures.
Horizon Client local gestures, such as double-click and pinch, no longer work. You must drag the Unity
Touch tab button to display the Unity Touch sidebar.
Touch redirection is enabled by default when you connect to a Windows 8, Windows 10, or Windows
Server 2012 remote desktop, or to a remote application that is hosted on Windows Server 2012.
To disable touch redirection, open Settings, tap Touch, and deselect the Windows native touch
gestures check box. If you are connected to a remote desktop or application in full-screen mode, tap the
Horizon Client Tools radial menu icon and tap the gear icon. If you are not using full-screen mode,
Settings is in the menu in the upper-right corner of the Horizon Client toolbar. If you are not connected to
a remote desktop or application, tap the gear icon in the upper right corner of the Horizon Client window.
Using the Unity Touch Sidebar with a Remote Desktop
You can quickly navigate to a remote desktop application or file from a Unity Touch sidebar. From this
sidebar, you can open files and applications, switch between running applications, and minimize,
maximize, restore, or close windows and applications in a remote desktop.
The Unity Touch feature is available only if a Horizon administrator has enabled it. If users have a floating
desktop, users’ favorite applications and files can be saved only if Windows roaming user profiles are
configured for the remote desktop. A Horizon administrator can also create a default Favorite
Applications list that end users see the first time the sidebar appears. For more information, see
"Configuring Unity Touch" in the Configuring Remote Desktop Features in Horizon 7 document.
If the Unity Touch feature is enabled, the sidebar appears on the left side of the window when you first
access a remote desktop.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 54
Figure 4‑1. Unity Touch Sidebar for a Remote Desktop on a Mobile Device
Figure 4‑2. Unity Touch Sidebar for a Remote Desktop on a Thin Client
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 window. 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‑4. Unity Touch Sidebar Actions for a Remote Desktop
Action Procedure
Show or hide the onscreen
keyboard
(Thin client only) Select the Keyboard icon.
Change the Horizon Client
settings
(Thin client only) Select the Settings icon.
Disconnect from the desktop (Thin client only) Select the Disconnect icon.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 55
Table 4‑4. Unity Touch Sidebar Actions for a Remote Desktop (Continued)
Action Procedure
Show the sidebar Swipe the tab to the right. When the sidebar is open, you cannot perform actions on the
desktop window or the Horizon Client Tools radial menu.
Hide the sidebar Swipe the tab to the left to close the sidebar. When the sidebar is open, you cannot perform
actions on the desktop window or the Horizon Client Tools radial menu.
Navigate to an application Tap All Programs and navigate to the application just as you would from the Windows Start
menu.
Navigate to a file Tap My Files to access the User folder, and navigate to the file. My Files includes folders
such as My Pictures, My Documents, and Downloads.
My Files includes the folders in the user profile (%USERPROFILE% directory). If you relocate the
system folder in the %USERPROFILE% directory, the My Files menu can also display content
from the relocated folder, whether it is a local relocated folder or a network share folder.
Search for an application or file nTap in the Search box and type the name of the application or file.
nTo use voice dictation, tap the microphone on the keyboard.
nTo launch an application or file, tap the name of the application or file in the search results.
nTo return to the home view of the sidebar, tap the X to close the Search box.
Open an application or file Tap the name of the file or application in the sidebar. The application starts and the sidebar
closes.
Switch between running
applications or open windows
Tap the application name under Running Applications. If more than one file is open for one
application, tap the chevron (>) next to the application to expand the list.
Minimize a running application or
window
Touch and hold the application name under Running Applications until the context menu
appears. Tap Minimize.
Maximize a running application or
window
Touch and hold the application name under Running Applications until the context menu
appears. Tap Maximize.
Close a running application or
window
Touch and hold the application name under Running Applications until the context menu
appears. Tap Close.
Restore a running application or
window to its previous size and
position
Touch and hold the application name under Running Applications until the context menu
appears. Tap Restore.
Create a list of favorite
applications or files
1 Search for the application or file, or tap Manage under the Favorite Applications or
Favorite Documents list.
If the Manage bar is not visible, tap the chevron (>) next to Favorite Applications or
Favorite Files.
2 Tap the check box next to the names of your favorites in the search results or in the list of
available applications or files.
The favorite that you add last appears at the top of your favorites list.
Your favorites are remembered across all of your mobile devices so that, for example, you
have the same list whether using your smart phone or your tablet.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 56
Table 4‑4. Unity Touch Sidebar Actions for a Remote Desktop (Continued)
Action Procedure
Remove an application or file from
the favorites list
1 Search for the application or file, or tap Manage under the Favorite Applications or
Favorite Dcuments list.
If the Manage bar is not visible, tap the chevron (>) next to Favorite Applications or
Favorite Documents.
2 Tap to remove the check mark next to the name of the application or file in the favorites
list.
Reorder an application or file in
the favorites list
1 Tap Manage under the Favorite Applications or Favorite Documents list.
If the Manage bar is not visible, tap the chevron (>) next to Favorite Applications or
Favorite Documents.
2 In the favorites list, touch and hold the handle on the left side of the application or file
name and drag the favorite up or down the list.
Using the Unity Touch Sidebar with a Remote Application
You can quickly navigate to a remote application from a Unity Touch sidebar. From this sidebar, you can
launch applications, switch between running applications, and minimize, maximize, restore, or close
remote applications. You can also switch to a remote desktop.
The Unity Touch feature is available only if a Horizon administrator has enabled it.
When you access a remote application, the Unity Touch sidebar appears on the left side of the window. If
the Unity Touch sidebar is closed, a tab appears on the left side of the window. You can swipe this tab to
the right to reopen the sidebar. You can also slide the tab up or down.
Figure 4‑3. Unity Touch Sidebar for a Remote Application on a Mobile Device
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 57
Figure 4‑4. Unity Touch Sidebar for a Remote Application on a Thin Client
From the Unity Touch sidebar, you can perform many actions on a remote application.
Table 4‑5. Unity Touch Sidebar Actions for a Remote Application
Action Procedure
Show or hide the onscreen keyboard (Thin client only) Select the Keyboard icon.
Modify Horizon Client settings (Thin client only) Select the Settings icon.
Disconnect from the application (Thin client only) Select the Disconnect icon.
Show the sidebar Swipe the tab to the right to open the sidebar. When the sidebar is open, you cannot
perform actions on the application window.
Hide the sidebar Swipe the tab to the left to close the sidebar. When the sidebar is open, you cannot perform
actions on the application window.
Switch between running applications Tap the application under Current Connection.
Open an application Tap the name of the application under Applications in the sidebar. The application starts
and the sidebar closes.
Close a running application 1 Touch and hold the application name under Current Connection until the context menu
appears.
2 Tap Close.
Minimize a running application 1 Touch and hold the application name under Current Connection until the context menu
appears.
2 Tap Minimize.
Maximize a running application 1 Touch and hold the application name under Current Connection until the context menu
appears.
2 Tap Maximize.
Restore a running application 1 Touch and hold the application name under Current Connection until the context menu
appears.
2 Tap Restore.
Switch to a remote desktop Tap the desktop name under Desktops.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 58
Horizon Client Tools on a Mobile Device
On a mobile device, the Horizon Client Tools include buttons for displaying the onscreen keyboard, virtual
touchpad, configuration settings, and a virtual keypad for arrow keys and function keys.
When you use a remote desktop or application in full-screen mode, the Horizon Client Tools radial menu
icon appears at the right edge of the window. You can drag the radial menu icon to relocate it. Tap to
expand the radial menu and display icons for each tool, which you can tap to select. Tap outside the tool
icons to collapse the icons back into the radial menu icon.
If the remote desktop or application is not in full-screen mode, a toolbar appears on the right side of the
menu bar at the top of the window. You can tap the Full Screen icon on the toolbar to enter full-screen
mode. When you are in full-screen mode, you can tap a similar icon in the radial menu to exit full-screen
mode.
The radial menu includes several tools.
Table 4‑6. Radial Menu Icons
Icon Description
Horizon Client Tools radial menu
Disconnect
Onscreen keyboard (toggles to show or hide)
Settings
Navigation keys
Virtual touchpad
Gesture help
Onscreen Keyboard
The onscreen keyboard 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 icon.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 59
If you are using a remote desktop or application in full-screen mode, the Keyboard icon is in the
Horizon Client Tools radial menu. If you are not using full-screen mode, the Keyboard icon is on the
Horizon Client toolbar.
You can also use the feature that displays the onscreen keyboard whenever you tap a text field, such as
in a note or new contact. If you then tap in an area that is not a text field, the keyboard is dismissed.
To turn this feature on or off, use the Keyboard popup and Keyboard dismiss options. To display these
options when you are using a remote desktop or application in full-screen mode, tap the Horizon Client
Tools radial menu icon, tap the gear icon, and tap Keyboard. If you are not using full-screen mode,
Settings is in the menu in the upper-right corner of the Horizon Client toolbar. If you are not connected to
a remote desktop or application, tap the gear icon in the upper right corner of the Horizon Client window.
Note On Kindle Fire tablets, tapping with three fingers does not display the onscreen keyboard. You can
instead tap the Keyboard icon on the Horizon Client toolbar to display the onscreen keyboard.
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. For example, if
you open an application such as Notepad and tap the pen icon, the text that you type does not appear in
the Notepad application until you tap Send.
Use this feature if you have a poor network connection. That is, use this feature if, when you type a
character, the character does not immediately appear in the application. With this feature, you can quickly
type up to 1,000 characters and then either tap Send or tap Return to have all 1,000 characters appear
at once in the application.
Navigation Keys
Tap the Ctrl/Page icon in the Horizon Client Tools or onscreen keyboard to display the navigation keys.
These keys include Page Up, Page Down, arrow keys, function keys, and other keys that you often use in
Windows environments, such as Alt, Del, Shift, Ctrl, Win, and Esc. You can press and hold arrow keys for
continuous key strokes. For a picture of the Ctrl/Page icon, see the table at the beginning of this topic.
Use the Shift key on this keypad when you need to use key combinations that include the Shift key, such
as Ctrl+Shift. To tap a combination of these keys, such as Ctrl+Alt+Shift, first tap the onscreen Ctrl key.
After the Ctrl key turns blue, tap the onscreen Alt key. After the Alt key turns blue, tap the onscreen Shift
key. A single onscreen key is provided for the key combination Ctrl+Alt+Del.
Onscreen Touchpad and Full-Screen Touchpad
The virtual touchpad can be either regular-size, to resemble a touchpad on a laptop computer, or full
screen, so that the entire device screen is a touchpad.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 60
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.
nMoving your finger around the touchpad creates a mouse pointer that moves around the remote
desktop or application.
nYou can use the regular-size and full-screen virtual touchpad for single-clicking and double-clicking.
nThe regular touchpad also contains left-click and right-click buttons.
nYou can tap with two fingers and then drag to scroll vertically.
You can drag the regular-size virtual touchpad to the side of the device so that you can use your thumb to
operate the touchpad while you are holding the device.
You can make the virtual touchpad resemble the touchpad on a laptop, including right-click and left-click
buttons, by setting the Full screen touchpad setting to off. If you are using the remote desktop or
application in full-screen mode, tap the Horizon Client Tools radial menu icon, tap the gear icon, tap
Touch, and deselect the Full screen touchpad setting.
To adjust how quickly the pointer moves when you use the touchpad, adjust the Touchpad sensitivity
option. If you are using the remote desktop or application in full-screen mode, tap the Horizon Client Tools
radial menu icon, tap the gear icon, tap Touch, tap Touchpad sensitivity, and drag the slider.
If you are not using full-screen mode, Settings is in the menu in the upper-right corner of the
Horizon Client toolbar. If you are not connected to a remote desktop or application, tap the gear icon in
the upper right corner of the Horizon Client window.
Gestures
VMware has created user interaction aids to help you navigate conventional Windows user interface
elements on a non-Windows device.
Clicking
As in other applications, you tap to click a user interface element.
Right-Clicking
The following options are available for right-clicking:
nUse the Horizon Client Tools to display the regular virtual touchpad and use the touchpad's right-click
button.
nOn a touch screen, tap with two fingers at nearly the same time. The right-click occurs where the first
finger tapped.
nOn some devices, you can use an external mouse, such as a USB or Bluetooth mouse, to right-click.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 61
Scrolling and Scrollbars
The following options are available for vertical scrolling.
nOn a touch screen, tap with one or two fingers and then drag to scroll. The text under your fingers
moves in the same direction as your fingers.
Important Scrolling with one finger has the following limitations: It does not work if you have
zoomed in, or when the onscreen keyboard is displayed, or when you are using the full-screen
touchpad.
nUse the Horizon Client Tools to display the touchpad, tap the touchpad with two fingers, and then
drag to scroll.
nUse 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 on a touch screen.
Window Resizing
If you use the full-screen touchpad to resize a window, touch and hold one finger at the corner or side of
the window and drag to resize.
If you use the regular-size virtual touchpad, touch and hold the left-click button while dragging the corner
or side of a window.
Sound, Music, and Video
If sound is turned on for your device, you can play audio in a remote desktop.
Using a Thin Client
How you interact with Windows user interface elements when Horizon Client is installed on a thin client
depends on the thin client model and the external input device you are using with the thin client. For more
information, see Using Horizon Client on a Thin Client.
Multitasking
You can switch between Horizon Client and other apps without losing a remote desktop or application
connection.
In a WiFi network, by default Horizon Client runs in the background indefinitely. In a 3G network,
Horizon Client suspends data transmission when you switch to another app. Data transmission resumes
when you switch back to Horizon Client.
The Horizon Client icon appears in the status bar when the app is running in the background and there is
a connection to a remote desktop. To switch back to Horizon Client, tap the icon in the status bar.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 62
Copying and Pasting Text and Images
By default, you can copy and paste plain text from the client device to a remote desktop or application. If
a Horizon administrator enables the feature, you can also copy and paste plain text from a remote
desktop or application to the client device, or between two remote desktops or applications.
A Horizon administrator can configure this feature so that copy and paste operations are allowed only
from the client device to a remote desktop or application, or only from a remote desktop or application to
the client device, or both, or neither.
You can also copy and paste images and Rich Text Format (RTF) text, but the following restrictions apply:
nYou cannot copy and paste RTF text on a Chromebook.
nYou can copy and paste images and RTF text from the client device to a remote desktop or
application. You cannot copy and paste images and RTF text from a remote desktop or application to
the client device.
nOnly Google apps are supported. For example, you can copy and paste images and RTF text from
Google Docs, Gmail, Chrome, Google+, Google Hangouts, Google Calendar, Google Sheets, and
Google Slides.
nYou can copy and paste images only when the client device can access the Google website.
nIf you select an image and RTF text (or plain text) together, the image is discarded and only the text is
copied and pasted. To copy and paste an image, you must select only the image.
nA Horizon administrator can use group policies to restrict clipboard formats during copy and paste
operations. The clipboard format filter policies for Microsoft Office Chart and Smart Art data and
Microsoft Text Effects data are not supported. For information about clipboard format filter policies,
see the Configuring Remote Desktop Features in Horizon 7 document. Using Smart Policies to
control copy and paste behavior in remote desktops is not supported.
The clipboard can accommodate a maximum of 1 MB of data for copy and paste operations. If the text
and RTF data together use less than maximum clipboard size, the formatted text is pasted. Often the RTF
data cannot be truncated, so that if the text and formatting use more than the maximum clipboard size
amount, the RTF data is discarded, and plain text is pasted. If you are unable to paste all of the formatted
text you selected in one operation, you might need to copy and paste smaller amounts in each operation.
Dragging and Dropping Text and Image Files
You can drag a text file or an image file from local storage on the client device to a published application
or an open application in a remote desktop and drop the content of the file into the application.
For example, if Horizon Client is installed on an Android phone, you can select Settings > Storage >
Explore or open the MyFiles app, select a folder, and drag a text file to the Wordpad application in a
remote desktop. If Horizon Client is installed on a Chromebook, you can drag files from the Downloads
folder or from a USB device attached to the Chromebook.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 63
This feature has the following limitations and requirements:
nYou can drag and drop a maximum of 1 MB of data.
nYou cannot drag and drop Rich Text Format (RTF) text.
nIf you select multiple files, only the content of the first file is dropped into the application.
nYou cannot drag and drop text files and image files from a remote desktop or application to the client
device.
nAndroid 7.0 or later is required for Android client devices.
nChrome OS M63 or later is required for Chrome client devices.
A Horizon administrator can use the Configure clipboard redirection group policy settings to disable
this feature. For more information, see the Configuring Remote Desktop Features in Horizon 7 document.
Saving Documents in a Published Application
With certain published 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.
A Horizon administrator can use the RDS Profiles group policy setting called Set Remote Desktop
Services User Home Directory to specify where documents are saved. For more information, see the
Configuring Remote Desktop Features in Horizon 7 document.
Screen Resolutions and Using External Displays
You can use Horizon Client with external displays and you can change screen resolutions.
When you connect a client device to an external display or projector, Horizon Client supports certain
maximum display resolutions. You can change the screen resolution used on the client device to allow
scrolling a larger screen resolution.
Enlarging the Screen Resolution for a Remote Desktop
By default, the display resolution is set so that the entire Windows desktop fits inside the client device,
and the desktop icons and task bar icons are a certain size. If you change the default to a higher
resolution, the desktop still fits inside the client device, but the desktop and taskbar icons become smaller.
You can pinch your fingers apart to zoom in and make the desktop larger than the device screen. You can
then tap and drag to access the edges of the desktop.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 64
Changing the Display Resolution Setting
You can use the Resolution setting to set the display resolution to a larger value. If you are using a
remote desktop or application in full-screen mode, tap the Horizon Client Tools radial menu icon, tap the
gear icon, tap Display, and tap Resolution. If you are not using full-screen mode, Settings is in the
menu in the upper-right corner of the Horizon Client toolbar. If you are not connected to a remote desktop
or application, tap the gear icon in the upper right corner of the Horizon Client window.
Using High Quality Mode
You can use the High Quality Mode feature to obtain the best display quality in remote desktops and
applications.
To enable High Quality Mode, before you connect to a remote desktop or application, tap the gear icon in
the upper right corner of the Horizon Client window, tap Display, and then tap High Quality Mode. You
cannot enable the High Quality Mode setting after you connect to a remote desktop or application.
The High Quality Mode feature has the following requirements and limitations:
nYou cannot use the High Quality Mode feature for existing sessions. You must log out and log in to a
new session for the feature to take effect.
nThe High Quality Mode setting is not available if the client device has less than an extra-high density
(xhdpi) screen.
nThe High Quality Mode feature requires Horizon Agent 7.0.3 or later.
High Quality Mode is disabled by default.
Using External Displays
You can use the Enable External display setting to configure settings for external displays, such as
projectors and attached monitors.
When the Enable External display setting is selected, you can select the Presentation mode, Multi-
Monitor mode, Keep screen on when external display is connected, and Zoom settings. When the
Enable External display setting is not selected, all of the external display settings are disabled.
In Presentation mode, a keyboard and expanded onscreen touchpad appear on the device when you
display a remote desktop on an external display. The expanded touchpad and keyboard appear when you
plug the device into the external display. The device detects the maximum resolution provided by the
external display. The presentation mode feature requires an Android 4.2 or later client device.
You can use the Multi-Monitor mode setting on an Android client to extend a secondary desktop on an
external display. The Unity Touch sidebar is supported only on the client's internal monitor. You cannot
change the orientation and full-screen mode. You can interact with remote desktops and applications on
the external display with the onscreen touchpad and full-screen touchpad. The multi-monitor mode
feature has the following requirements and limitations when used with an Android client.
nAndroid 4.2 or later is required.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 65
nYou cannot use the physical mouse on the external display.
You can use the Keep screen on when external display is connected setting to keep the display from
turning off after a period of inactivity. You can drag the Zoom slider to set the resolution for the external
display.
If you are connected to a remote desktop or application, pressing the Back button quits presentation
mode or multi-monitor mode and the Enable External display setting is deselected.
To configure external display settings if you are using a remote desktop or application in full-screen mode,
tap the Horizon Client Tools radial menu icon, tap the gear icon, tap Display, and then tap External
Display Options. If you are not using full-screen mode, Settings is in the menu in the upper-right corner
of the Horizon Client toolbar. If you are not connected to a remote desktop or application, tap the gear
icon in the upper right corner of the Horizon Client window.
Do not use an external mouse, such as a Bluetooth mouse, when using the Presentation mode setting.
Instead, use the large onscreen touchpad on the client device. If you attempt to use a mouse, the mouse
pointer might not be able to move to the bottom or right side of the screen, and when moved to the top of
the screen, might conflict with some of the function keys shown on the large onscreen touchpad, rather
than the top of the remote desktop.
Using Multi-Monitor Mode with Horizon Client for Android on a
Chromebook
When Horizon Client for Android is installed on a Chromebook device, there is no option for the multi-
monitor feature in Settings. Instead, when you maximize a session window in the internal display, a new
window opens and is maximized in the external display and the session enters multi-monitor mode. When
you restore the window in the internal display from the maximized state, the window in the external
display is closed and the session quits multi-monitor mode.
The multi-monitor mode feature has the following requirements and limitations when used with a
Chromebook device.
nChrome OS M64 or later is required.
nOnly one external display is supported.
nUnified desktop mode must not be enabled on the Chromebook.
PCoIP Client-Side Image Cache
PCoIP client-side image caching stores image content on the client to avoid retransmission. This feature
reduces bandwidth usage.
The PCoIP image cache captures spatial, as well as temporal, redundancy. For example, when you scroll
down through a PDF document, new content appears from the bottom of the window and the oldest
content disappears from the top of the window. All the other content remains constant and moves upward.
The PCoIP image cache is capable of detecting this spatial and temporal redundancy.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 66
Because during scrolling, the display information sent to the client device is primarily a sequence of cache
indices, using the image cache saves a significant amount of bandwidth. This efficient scrolling has
benefits both on the LAN and over the WAN.
nOn the LAN, where bandwidth is relatively unconstrained, using client-side image caching delivers
significant bandwidth savings.
nOver the WAN, to stay within the available bandwidth constraints, scrolling performance would be
degraded without client-side caching. Over the WAN, client-side caching saves bandwidth and ensure
a smooth, highly responsive scrolling experience.
With client-side caching, the client stores portions of the display that were previously transmitted. The
cache size is 250 MB.
Internationalization and International Keyboards
Both the Horizon Client user interface and the documentation are available in English, Japanese, French,
German, Simplified Chinese, Traditional Chinese, Korean, and Spanish. International keyboards of
English-United States, Japanese, French, German, Simplified Chinese, Traditional Chinese, Korean, and
Spanish are supported.
To choose a language for the keyboard or voice, tap the Keyboard Settings key on the onscreen
keyboard. The Keyboard Settings key is the left-most key on the bottom row of the onscreen keyboard.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 67
Troubleshooting Horizon Client 5
You can solve most Horizon Client problems by resetting the desktop or reinstalling the app.
You can also enable log collection and send log files to VMware for troubleshooting.
This chapter includes the following topics:
nRestart a Remote Desktop
nReset a Remote Desktop or Remote Applications
nUninstall Horizon Client
nCollecting and Sending Logging Information to VMware
nReport Horizon Client Crash Data to VMware
nHorizon Client Stops Responding or the Remote Desktop Freezes
nProblem Establishing a Connection When Using a Proxy
nConnecting to a Server in Workspace ONE Mode
Restart a Remote Desktop
You might need to restart a remote desktop if the desktop operating system stops responding. Restarting
a remote desktop is the equivalent of the Windows operating system restart command. The desktop
operating system usually prompts you to save any unsaved data before it restarts.
You can restart a remote desktop only if a Horizon administrator has enabled the desktop restart feature
for the desktop.
For information about enabling the desktop restart feature, see the Setting Up Virtual Desktops in Horizon
7 or Setting Up Published Desktops and Applications in Horizon 7 document.
Prerequisites
nObtain login credentials, such as a user name and password, RSA SecurID user name and
passcode, RADIUS authentication user name and passcode, or smart card personal identification
number (PIN).
nIf you have not logged in at least once, become familiar with the procedure Connect to a Remote
Desktop or Application.
VMware, Inc. 68
Procedure
1On the Servers tab, tap the server shortcut to connect to the server.
2If prompted, supply your RSA user name and passcode, your Active Directory user name and
password, or both.
3Touch and hold the desktop name until the context menu appears.
You can perform this step from either the All or Favorites tab.
4Tap Restart in the context menu.
Restart is available only if the status of the desktop is such that the action can be taken.
The operating system in the remote desktop reboots and Horizon Client disconnects and logs off from the
desktop.
What to do next
Wait an appropriate amount of time for system startup before you attempt to reconnect to the remote
desktop.
If restarting the remote desktop does not solve the problem, you might need to reset the remote desktop.
See Reset a Remote Desktop or Remote Applications.
Reset a Remote Desktop or Remote Applications
You might need to reset a remote desktop if the desktop operating system stops responding and
restarting the remote desktop does not solve the problem. Resetting remote applications quits all open
applications.
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 are closed and are not saved.
Resetting remote applications is the equivalent of quitting the applications without saving any unsaved
data. All open remote applications are closed, even applications that come from different RDS server
farms.
You can reset a remote desktop only if a Horizon administrator has enabled the desktop reset feature for
the desktop.
For information about enabling the desktop reset feature, see the Setting Up Virtual Desktops in Horizon
7 or Setting Up Published Desktops and Applications in Horizon 7 document.
Prerequisites
nObtain login credentials, such as a user name and password, RSA SecurID user name and
passcode, RADIUS authentication user name and passcode, or smart card personal identification
number (PIN).
nIf you have not logged in at least once, become familiar with the procedure Connect to a Remote
Desktop or Application.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 69
Procedure
1On the Servers tab, tap the server shortcut to connect to the server.
2If prompted, supply your RSA user name and passcode, your Active Directory user name and
password, or both.
3Touch and hold the desktop or application name until the context menu appears.
You can perform this step from either the All or Favorites tab.
4Tap Reset in the context menu.
Reset is available only if the status of the desktop or application is such that the action can be taken.
When you reset a remote desktop, the operating system in the remote desktop reboots and
Horizon Client disconnects and logs off from the desktop. When you reset remote applications, the
applications quit.
What to do next
Wait an appropriate amount of time for system startup before attempting to reconnect to the remote
desktop or application.
Uninstall Horizon Client
You can sometimes resolve problems with Horizon Client by uninstalling and reinstalling Horizon Client.
You uninstall Horizon Client just as you would any Android app.
Procedure
1On your device, go to the Horizon app.
2Touch and hold the app icon until the Uninstall (trash can) icon appears on your device.
3Drag the app to the Uninstall (trash can) icon.
Alternatively, you can go to Apps > Settings and select Applications > Manage Applications to
uninstall Horizon Client.
What to do next
Reinstall Horizon Client.
See Install or Upgrade Horizon Client.
Collecting and Sending Logging Information to VMware
You can configure Horizon Client to collect log information and send log files to VMware for
troubleshooting.
If Horizon Client quits unexpectedly, Horizon Client immediately prompts you to send log files to VMware.
If log collection is enabled, the crash log file contains detailed debug information. If log collection is
disabled, only certain exception information is included in the crash log file.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 70
Horizon Client generates three types of log files (Horizon_View_Client_logs_timestamp.txt,
libcdk_timestamp.txt, and pcoip_client_timestamp.txt) and keeps the last five log files of each
type.
If you choose to send log files to VMware, Horizon Client uses the available email client on the client
device to create a message. If the email client can send multiple attachments, Horizon Client attaches the
last five log files of each type to the message. If the email client cannot send multiple attachments,
Horizon Client compresses the last five log files of each type and attaches a ZIP file to the message. The
ZIP file name contains a time stamp, for example, Horizon_View_Client_logs_timestamp.zip.
You can also manually retrieve and send log files at any time.
Enable Horizon Client Log Collection
When you enable log collection, Horizon Client creates log files that contain information that can help
VMware troubleshoot problems with Horizon Client.
Because log collection affects the performance of Horizon Client, enable log collection only if you are
experiencing a problem.
Prerequisites
Verify that an email client is available on the device. Horizon Client requires an email client to send log
files.
Procedure
1Open Settings and tap Log collection.
If you are connected to a remote desktop or application in full-screen mode, tap the Horizon Client
Tools radial menu icon and tap the gear icon. If you are not using full-screen mode, Settings is in the
menu in the upper right corner of the Horizon Client toolbar. If you are not connected to a remote
desktop or application, tap the gear icon in the upper right corner of the Horizon Client window.
2Tap Enable log to select the check box and tap OK to confirm your choice.
After log collection is enabled, Horizon Client generates a log file it quits unexpectedly or when it is exited
and relaunched.
Manually Retrieve and Send Horizon Client Log Files
When Horizon Client log collection is enabled on your device, you can manually retrieve and send log
files at any time.
This procedure shows you how retrieve and send log files through Horizon Client. You can also retrieve
log files by using tools that can access app storage space. Horizon Client saves log files in the
Android/data/com.vmware.view.client.android/files directory.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 71
Prerequisites
nVerify that an email client is available on the device. Horizon Client requires an email client to send
log files.
nEnable Horizon Client log collection. See Enable Horizon Client Log Collection.
Procedure
1Open Settings and tap Log collection.
If you are connected to a remote desktop or application in full-screen mode, tap the Horizon Client
Tools radial menu icon and tap the gear icon. If you are not using full-screen mode, Settings is in the
menu in the upper right corner of the Horizon Client toolbar. If you are not connected to a remote
desktop or application, tap the gear icon in the upper right corner of the Horizon Client window.
2Tap Send the log.
Horizon Client uses the email client on the device to create a message. The body of the message
contains information about your device. If your email client can send multiple attachments,
Horizon Client attaches the last five log files of each type to the message. If your email client cannot
send multiple attachments, Horizon Client compresses the last five log files of each type and attaches
a ZIP file to the message.
Disable Horizon Client Log Collection
Because log collection affects the performance of Horizon Client, disable log collection if you are not
troubleshooting a problem.
Procedure
1Open Settings and tap Log collection.
If you are connected to a remote desktop or application in full-screen mode, tap the Horizon Client
Tools radial menu icon and tap the gear icon. If you are not using full-screen mode, Settings is in the
menu in the upper right corner of the Horizon Client toolbar. If you are not connected to a remote
desktop or application, tap the gear icon in the upper right corner of the Horizon Client window.
2Tap Enable log to clear the check box.
Report Horizon Client Crash Data to VMware
You can configure Horizon Client to report crash data to VMware.
Procedure
1Tap the Settings (gear) icon in the upper right corner of the Horizon Client window.
2Tap Crash Reporting.
3Tap Crash Reporting to enable or disable the check box.
The setting is enabled by default.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 72
If Horizon Client stops responding, a crash log file is uploaded to the VMware server the next time
Horizon Client starts.
Horizon Client Stops Responding or the Remote Desktop
Freezes
When the window freezes, first, try resetting the remote desktop operating system.
Problem
Horizon Client does not work or repeatedly exits unexpectedly or the remote desktop freezes.
Cause
Assuming that Horizon servers are configured properly and that firewalls surrounding them have the
correct ports open, other issues usually relate to Horizon Client on the device or to the guest operating
system on the remote desktop.
Solution
nIf the operating system in the remote desktop freezes, use Horizon Client on the device to reset the
desktop.
This option is available only if the Horizon administrator has enabled this feature.
nUninstall and reinstall the app on the device.
nIf resetting the remote desktop and reinstalling Horizon Client do not help, you can reset the Android
device, as described in the user guide for your Android device.
nIf you get a connection error when you attempt to connect to the server, you might need to change
your proxy settings.
Problem Establishing a Connection When Using a Proxy
Sometimes if you attempt to connect to Connection Server using a proxy while on the LAN, an error
occurs.
Problem
If the Horizon environment is set up to use a secure connection from the remote desktop to Connection
Server, and if the client device is configured to use an HTTP proxy, you might not be able to connect.
Cause
Unlike Windows Internet Explorer, the client device does not have an Internet option to bypass the proxy
for local addresses. When an HTTP proxy is used for browsing external addresses, and you try to
connect to Connection Server using an internal address, you might see the error message Could not
establish connection.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 73
Solution
uRemove the proxy settings so that the device no longer uses a proxy.
Connecting to a Server in Workspace ONE Mode
If you cannot connect to a server directly through Horizon Client, or if your desktop and application
entitlements are not visible in Horizon Client, Workspace ONE mode might be enabled on the server.
Problem
nWhen you try to connect to the server directly through Horizon Client, Horizon Client redirects you to
the Workspace ONE portal.
nWhen you open a desktop or application through a URI or shortcut, or when you open a local file
through file association, the request redirects you to the Workspace ONE portal for authentication.
nAfter you open a desktop or application through Workspace ONE and Horizon Client starts, you
cannot see or open other entitled remote desktops or applications in Horizon Client.
Cause
Beginning with Horizon 7 version 7.2, a Horizon administrator can enable Workspace ONE mode on a
Connection Server instance. This behavior is normal when Workspace ONE mode is enabled on a
Connection Server instance.
Solution
Use Workspace ONE to connect to a Workspace ONE enabled server and access your remote desktops
and applications.
VMware Horizon Client for Android Installation and Setup Guide
VMware, Inc. 74

Navigation menu