vmware horizon flex client user guide - horizon flex 1 · contents vmware horizon flex client user...

VMware Horizon FLEX Client User GuideHorizon FLEX 1.7

This document supports the version of each product listed andsupports all subsequent versions until the document isreplaced by a new edition. To check for more recent editionsof this document, see http://www.vmware.com/support/pubs.

EN-001944-00

http://www.vmware.com/support/pubs

VMware Horizon FLEX Client User Guide

2 VMware, Inc.

You can find the most up-to-date technical documentation on the VMware Web site at:

http://www.vmware.com/support/

The VMware Web site also provides the latest product updates.

If you have comments about this documentation, submit your feedback to:

[email protected]

Copyright © 2014, 2015 VMware, Inc. All rights reserved. Copyright and trademark information.

VMware, Inc.3401 Hillview Ave.Palo Alto, CA 94304www.vmware.com

http://www.vmware.com/support/

mailto:[email protected]

http://pubs.vmware.com/copyright-trademark.html

Contents

VMware Horizon FLEX Client User Guide 5

1 Introducing Horizon FLEX 7

What Is a Horizon FLEX Virtual Machine? 7Selecting a Horizon FLEX Client 8

2 Using the Horizon FLEX Client for Windows 9

Host System Requirements for Workstation Player 9Install or Upgrade the Horizon FLEX Client for Windows 11Download a Horizon FLEX Virtual Machine with Workstation Player 11Open a Horizon FLEX Virtual Machine in Workstation Player 13Edit Virtual Machine Settings in Workstation Player 14Use Ctrl+Alt+Delete to Shut Down a Guest 14Suspend and Resume a Virtual Machine in Workstation Player 15Power Off a Virtual Machine in Workstation Player 15Where to Find More Information About Workstation Player 16

3 Using the Horizon FLEX Client for Mac 17

Host System Requirements for Fusion Pro 17Install or Upgrade the Horizon FLEX Client for Mac 18Download a Horizon FLEX Virtual Machine with Fusion Pro 18Open a Horizon FLEX Virtual Machine in Fusion Pro 20Edit Virtual Machine Settings in Fusion Pro 21Using Mac Keyboards in a Virtual Machine 22Suspend and Resume a Virtual Machine in Fusion Pro 22Power Off a Virtual Machine in Fusion Pro 23Where to Find More Information About Fusion Pro 23

4 Troubleshooting Horizon FLEX Virtual Machines 25

Virtual Machine File Cannot be Found 25Virtual Machine Cannot Be Powered On 26Virtual Machine Is Expired 26Virtual Machine Has Not Contacted the Server for n Days 26Virtual Machine Is Revoked 27Invalid Security Certificate 27Horizon FLEX Client Is Not Compatible with the Server 27Horizon FLEX Client Cannot Open the Virtual Machine 28Changing the Memory and Processor Settings Is Not Allowed 29Copying or Downloading the Virtual Machine Is Not Allowed 29Folder Sharing on the Virtual Machine Is Not Allowed 29USB Device Cannot Be Connected to the Virtual Machine 30

VMware, Inc. 3

Virtual Machine Is Removed 30

Index 31


4 VMware, Inc.


The VMware Horizon FLEX Client User Guide describes how to install and use Horizon FLEX Client to accessa virtual machine in a VMware Horizon® FLEX™ deployment.

Intended AudienceThis information is intended for anyone who wants to install or use a Horizon FLEX Client.

VMware, Inc. 5


6 VMware, Inc.

Introducing Horizon FLEX 1With Horizon FLEX, you can access a restricted virtual machine, called a Horizon FLEX virtual machine, onyour Windows or Mac computer. Horizon FLEX enables you to use the business desktop and applicationsyou need to get your job done while working in the style that best suits your needs. You can continue towork, even if you do not have an Internet connection.

This chapter includes the following topics:

n “What Is a Horizon FLEX Virtual Machine?,” on page 7

n “Selecting a Horizon FLEX Client,” on page 8

What Is a Horizon FLEX Virtual Machine?A Horizon FLEX virtual machine is a software computer that, like a physical computer, runs an operatingsystem and applications.

A Horizon FLEX virtual machine typically contains a display, a hard disk or disks, one or more processors,memory, a CD/DVD drive, a network adapter, and a USB controller. All of these components arevirtualized. That is, these elements of a virtual machine are all created by software and stored in files onyour computer.

Your Horizon FLEX virtual machine runs in a window on your local computer. You can install applicationsin the virtual machine and operate it as you would a physical computer. An operating system cannotdistinguish between a virtual machine and a physical machine, nor can applications or other computers on anetwork. What you can do with a physical machine (install software, save files, add additional drives, andso on) you can do with a virtual machine.

Horizon FLEX virtual machines are fully supported by VMware Fusion® Pro andVMware Workstation Player™ with the underlying physical hardware. For example, you can use a virtualmachine with virtual components that are completely different from the physical components that arepresent on the underlying hardware. Virtual machines on the same physical host can run different kinds ofoperating systems, including Windows and Linux.

VMware, Inc. 7

Selecting a Horizon FLEX ClientTo use a Horizon FLEX virtual machine, you must install a Horizon FLEX Client on your local machine.Horizon FLEX includes two versions of the Horizon FLEX Client, one for Windows hosts and one for Machosts. You can select and install the appropriate Horizon FLEX Client for you.

Horizon FLEX Client forWindows

If you have a Windows machine, you use Horizon FLEX Client for Windows(Workstation Player) to access your Horizon FLEX virtual machine. Whenyou install Workstation Player with a Horizon FLEX license key, you candownload and open a Horizon FLEX virtual machine on your Windowsmachine. You access all Workstation Player features through the mainWorkstation Player interface.

Workstation Player for Windows 12.1 is the Horizon FLEX Client forWindows for Horizon FLEX 1.7. For more information aboutWorkstation Player, see the Workstation Player for Windows documentationat https://www.vmware.com/support/pubs/player_pubs.html .

Horizon FLEX Client forMac

If you have a Mac, you use Horizon FLEX Client for Mac (Fusion Pro) toaccess your Horizon FLEX virtual machine. When you install Fusion Prowith a Horizon FLEX license key, you can download and open aHorizon FLEX virtual machine on your Mac. You access all Fusion Profeatures through the main Fusion interface.

Fusion Pro 8.1 is the Horizon FLEX Client for Mac for Horizon FLEX 1.7. Formore information about Fusion Pro, see the Fusion Pro documentation at https://www.vmware.com/support/pubs/fusion_pubs.html .

Your Horizon FLEX administrator might provide your Horizon FLEX virtual machine on a server or a USBdevice, or install it on your local machine.

If your virtual machine is on a server, you use your Horizon FLEX Client to download the virtual machineto your local machine. If your virtual machine is on a USB device or is installed on your local machine, youuse your Horizon FLEX Client to register the virtual machine with the Horizon FLEX server.


8 VMware, Inc.

https://www.vmware.com/support/pubs/player_pubs.html

https://www.vmware.com/support/pubs/fusion_pubs.html

Using the Horizon FLEX Client forWindows 2

When you install the Horizon FLEX Client for Windows (Workstation Player, formerly known as PlayerPro) with a Horizon FLEX license key, you can use Workstation Player to access your Horizon FLEX virtualmachine on your Windows machine. You access all Workstation Player features through themainWorkstation Player interface.


n “Host System Requirements for Workstation Player,” on page 9

n “Install or Upgrade the Horizon FLEX Client for Windows,” on page 11

n “Download a Horizon FLEX Virtual Machine with Workstation Player,” on page 11

n “Open a Horizon FLEX Virtual Machine in Workstation Player,” on page 13

n “Edit Virtual Machine Settings in Workstation Player,” on page 14

n “Use Ctrl+Alt+Delete to Shut Down a Guest,” on page 14

n “Suspend and Resume a Virtual Machine in Workstation Player,” on page 15

n “Power Off a Virtual Machine in Workstation Player,” on page 15

n “Where to Find More Information About Workstation Player,” on page 16

Host System Requirements for Workstation PlayerThe physical computer on which you install Workstation Player is called the host system and its operatingsystem is called the host operating system. To run Workstation Player, the host system and the hostoperating system must meet specific hardware and software requirements.

Processor Requirements for Host SystemsYou must install Workstation Player on a host system that meets certain processor requirements.

Supported ProcessorsThe host system must have a 64-bit x86 CPU with 1.3GHz or faster core speed. Multiprocessor systems aresupported.

When you install Workstation Player, the installer performs checks to make sure the host system has asupported processor. You cannot install Workstation Player if the host system does not meet the processorrequirements.

VMware, Inc. 9

Processor Requirements for 64-Bit Guest Operating SystemsThe operating system that runs inside a virtual machine is called the guest operating system. To run 64-bitguest operating systems, the host system must have one of the following processors.

n An AMD CPU that has segment-limit support in long mode

n An Intel CPU that has VT-x support

If you have an Intel CPU that has VT-x support, you must verify that VT-x support is enabled in the hostsystem BIOS. The BIOS settings that must be enabled for VT-x support vary depending on the systemvendor. See the VMware knowledge base article at http://kb.vmware.com/kb/1003944 for information abouthow to determine if VT-x support is enabled.

When you install a 64-bit operating system, Workstation Player performs checks to make sure the hostsystem has a supported processor. You cannot install a 64-bit operating system if the host system does notmeet the processor requirements.

Processor Requirements for Windows 7 Aero GraphicsTo support Windows 7 Aero graphics, the host system should have either an Intel Dual Core 2.2GHz or laterCPU or an AMD Athlon 4200+ or later CPU.

Memory Requirements for Host SystemsThe host system must have enough memory to run the host operating system, the guest operating systemsthat run inside the virtual machines on the host system, and the applications that run in the host and guestoperating systems.

The minimum memory required on the host system is 1 GB. 2 GB and above is recommended.

To support Windows 7 Aero graphics in a virtual machine, at least 3 GB of host system memory is required.1 GB of memory is allocated to the guest operating system and 256 MB is allocated to graphics memory.

See your guest operating system and application documentation for more information on memoryrequirements.

Supported Host Operating Systems for Workstation PlayerTo install Workstation Player, your Windows computer must have a supported Windows operating system.Workstation Player supports only 64-bit operating systems.

n Windows 7

n Windows 8

n Windows 8.1 Enterprise

n Windows 8.1 Pro

n Windows 10

n Windows Server 2012 R2


10 VMware, Inc.

http://kb.vmware.com/kb/1003944

Install or Upgrade the Horizon FLEX Client for WindowsYou install the Horizon FLEX Client for Windows (Workstation Player) on a Windows machine by runningthe installation wizard.

Prerequisites

n Verify that your Windows machine meets the host system requirements. See “Host SystemRequirements for Workstation Player,” on page 9.

n Download the Horizon FLEX Client for Windows installer to your Windows machine. You can obtainthe Horizon FLEX Client for Windows .exe installer file from the VMware Web site, or yourHorizon FLEX administrator might have provided you with a link to obtain the Workstation Player .bator .cmd installer file.

n Verify that you have a Horizon FLEX license key. You must provide a license key to run aHorizon FLEX virtual machine in Workstation Player.

Procedure

1 On your Windows machine, double-click the Workstation Player installer.

2 Follow the prompts to finish the installation.

3 Double-click the VMware Player icon or select Start > All Programs > VMware Player to startWorkstation Player.

4 Select Enter a license key to enable VMware Workstation Player features or to allow commercial use.

5 Type the Horizon FLEX license key and click Continue.

What to do next

Download the Horizon FLEX virtual machine. See “Download a Horizon FLEX Virtual Machine withWorkstation Player,” on page 11.

Download a Horizon FLEX Virtual Machine with Workstation PlayerIf your Horizon FLEX virtual machine is on a Horizon FLEX server, you must connect to the server anddownload the virtual machine to your Windows machine before you can open it in Workstation Player.

If your Horizon FLEX administrator provided your virtual machine on a USB device or deployed it to yourWindows machine, see “Open a Horizon FLEX Virtual Machine in Workstation Player,” on page 13.

Obtain the following information from your Horizon FLEX administrator:

n Instructions about whether to turn on a VPN connection.

n Instructions about whether to install certificates on your Windows computer.

n Credentials for connecting to the Horizon FLEX server and logging in to your virtual machine.

n The encryption password for the virtual machine. You will need this password to open the virtualmachine.

n (Optional) The restrictions password for the virtual machine, if you are allowed to change restrictedvirtual machine settings.

Prerequisites

n Install Workstation Player on your Windows machine. See “Install or Upgrade the Horizon FLEX Clientfor Windows,” on page 11.

n If a VPN connection is required, turn on the VPN.

Chapter 2 Using the Horizon FLEX Client for Windows

VMware, Inc. 11

Procedure

1 Connect to the Horizon FLEX server.

Option Action

Connect to the server inWorkstation Player

a On your Windows machine, double-click the VMware Player icon orselect Start > All Programs > VMware Player.

b Click the Connect to VMware Horizon FLEX Server icon on theWorkstation Player toolbar. The Connect to Server dialog box mightalso open when Workstation Player starts.

c In the Connect to Server dialog box, fill in the server host name (withfull domain name) or IP address, user name, and type the password.

d Click Connect to connect to the server.

If your Horizon FLEX client software cannot validate the certificate,you might receive an Invalid Security Certificate warning. Ifyou receive this warning, verify that the certificate is valid with yourHorizon FLEX administrator. If the certificate is valid, select theAlways trust this host with this certificate check box and clickConnect Anyway.

Connect to the server from a link If you received a link in an email from your Horizon FLEX administrator,perform these steps:a Click the link.b When the Connect to Server dialog box opens, type the password that

your Horizon FLEX administrator provided.c Click Connect to connect to the server.


The virtual machines to which you are entitled appear.

2 Select a virtual machine to download and click Download.

If your Horizon FLEX client software cannot validate the certificate, you might receive an InvalidSecurity Certificate warning. If you receive this warning, verify that the certificate is valid with yourHorizon FLEX administrator. If the certificate is valid, select the Always trust this host with thiscertificate check box and click Connect Anyway.

You are prompted to create a shortcut on your desktop. Click Yes to create the shortcut.

3 Select a location to save the virtual machine and click Select Folder.

Save the virtual machine in a location that you can readily access.

Before the download begins, a disclaimer message might appear that requires your acceptance. Afterthe download begins, a status bar shows the progress of the download operation.

You can click Pause to suspend the download and click Resume to restart the download at a later time.For example, if you suspend a download and exit Workstation Player, you can resume the downloadthe next time you start Workstation Player. You can click Cancel to cancel the download.

4 Type the password that your Horizon FLEX administrator provided and click OK to open your virtualmachine.

5 When the disclaimer message appears, click Power On if you agree.

NOTE You use the password that your Horizon FLEX administrator provided only the first time thatyou access the virtual machine.


12 VMware, Inc.

The virtual machine powers on.

6 Log in to the guest operating system with the login credentials that your Horizon FLEX administratorprovided.

What to do next

If your virtual machine does not start, see Chapter 4, “Troubleshooting Horizon FLEX Virtual Machines,” onpage 25.

Open a Horizon FLEX Virtual Machine in Workstation PlayerIf your Horizon FLEX virtual machine is on a USB device or deployed to your Windows machine, you mustregister it with the Horizon FLEX server before you can open it in Workstation Player.

If your virtual machine is on a Horizon FLEX server, you must download it to a folder on your Windowsmachine. See “Download a Horizon FLEX Virtual Machine with Workstation Player,” on page 11.







Prerequisites

n Install Workstation Player on your Windows machine. See “Install or Upgrade the Horizon FLEX Clientfor Windows,” on page 11.

n If your virtual machine is on a USB device, connect the USB device to your computer and copy thevirtual machine to your computer.


Procedure


2 In the VMware Player window, click Open a Virtual Machine.

3 Browse to and select the virtual machine configuration (.vmx) file for the virtual machine and clickOpen.


5 Type the credentials that your Horizon FLEX administrator provided for the Horizon FLEX server andclick Connect to connect to the server.

You must connect to the Horizon FLEX server to register your virtual machine.




VMware, Inc. 13



What to do next


Edit Virtual Machine Settings in Workstation PlayerWhen you edit Horizon FLEX virtual machine settings in Workstation Player, you must provide therestrictions password to unlock and edit certain settings. For other settings, including Memory, Processors,and Network Adapter, you do not need to enter the restrictions password.

For complete information about virtual machine settings, see the Workstation Player documentation at https://www.vmware.com/support/pubs/player_pubs.html.

Prerequisites




Procedure


2 In the VMware Player window, click Open a Virtual Machine.

3 Browse to and select the virtual machine configuration (.vmx) file for the virtual machine and clickOpen.

4 Type the encryption password that your Horizon FLEX administrator provided and click OK to openthe virtual machine.

5 In the right pane, click Edit virtual machine settings.

6 Select the virtual machine setting to modify.

You must click Unlock all settings and enter the restrictions password to access and modify certainsettings.

Your Horizon FLEX administrator controls whether you can change the virtual machine's memory ornumber of processor cores. If these options are unavailable (dimmed), these options have beenrestricted by your administrator.

7 Modify the setting and click OK to save your changes.

Use Ctrl+Alt+Delete to Shut Down a GuestYou can use the Ctrl+Alt+Delete key sequence to shut down or log off of a guest operating system.

Prerequisites

Power on the virtual machine.


14 VMware, Inc.


Procedure

n Select the virtual machine and select Player > Send Ctrl+Alt+Delete.

This option is the same as pressing Ctrl+Alt+Delete on your keyboard. On Windows hosts, using thephysical keyboard to press Ctrl+Alt+Delete might send the command to the host operating system andthe virtual machine, even when Workstation Player has control of input.

n If the command is received by both the host operating system and the virtual machine, press Ctrl+Alt+Ins on the keyboard.

The command is received solely by the virtual machine and shuts down or logs out of the guestoperating system.

Suspend and Resume a Virtual Machine in Workstation PlayerSuspending a virtual machine saves its current state. When you resume the virtual machine, applicationsthat were running before the virtual machine was suspended resume in their running state and their contentis unchanged.

How quickly the suspend and resume operations perform depends on how much data changed after youstarted the virtual machine. The first suspend typically takes longer than subsequent suspend operations.

Procedure

n To suspend a virtual machine, select Player > Power > Suspend and click Yes to confirm.

If soft power operations are configured for the virtual machine when the virtual machine is firstcreated, Suspend Guest appears in the menu instead of Suspend.

Workstation Player returns the virtual machine to the library in the Suspended state.

n To resume a suspended virtual machine, select the virtual machine and select Player > Power > PowerOn.

n To set the Workstation Player preferences to suspend the virtual machine when you close the virtualmachine window, select Player > File > Preferences and then select Suspend the virtual machine.

Power Off a Virtual Machine in Workstation PlayerAs with physical machines, shut down a guest operating system before you power off a virtual machine.

You might need to power cycle your virtual machine if your Horizon FLEX administrator changes thevirtual machine configuration.

Procedure

n To shut down the guest operating system, shut down as if you were using a physical machine.

When the guest operating system shuts down, the virtual machine is powered off andWorkstation Player exits.

n To power off a virtual machine without shutting down the guest operating system, select Player >Power Off.

If soft power operations are configured for the virtual machine, Power Off Guest appears in the menuinstead of Power Off.


VMware, Inc. 15

Where to Find More Information About Workstation PlayerThis document provides basic information about using Workstation Player. You can find more informationabout using Workstation Player at the following self-help sources.

n The complete Workstation Player documentation set, including release notes, is at https://www.vmware.com/support/pubs/player_pubs.html. See the Using VMware Workstation Player forWindows guide for instructions on how to use Workstation Player. Workstation Player for Linux is notsupported as a Horizon FLEX client.

n To find information on a specific problem you encounter in Workstation Player, select VMware Playerin the product list and search for your problem by key word at http://kb.vmware.com.

n For answers to frequently asked questions, go to http://www.vmware.com/products/player/faqs.html.


16 VMware, Inc.


http://kb.vmware.com

http://www.vmware.com/products/player/faqs.html

Using the Horizon FLEX Client forMac 3

When you install Horizon FLEX Client for Mac (Fusion Pro) with a Horizon FLEX license key, you can useFusion Pro to access your Horizon FLEX virtual machine on your Mac. You access all Fusion Pro featuresthrough the main Fusion interface.


n “Host System Requirements for Fusion Pro,” on page 17

n “Install or Upgrade the Horizon FLEX Client for Mac,” on page 18

n “Download a Horizon FLEX Virtual Machine with Fusion Pro,” on page 18

n “Open a Horizon FLEX Virtual Machine in Fusion Pro,” on page 20

n “Edit Virtual Machine Settings in Fusion Pro,” on page 21

n “Using Mac Keyboards in a Virtual Machine,” on page 22

n “Suspend and Resume a Virtual Machine in Fusion Pro,” on page 22

n “Power Off a Virtual Machine in Fusion Pro,” on page 23

n “Where to Find More Information About Fusion Pro,” on page 23

Host System Requirements for Fusion ProThe physical computer on which you install Fusion Pro is called the host system and its operating system iscalled the host operating system. To run Fusion Pro, the host system and the host operating system mustmeet specific hardware and software requirements.

Processor Requirements for Host SystemsYou can install Fusion Pro on any Mac that has a 64-bit Intel processor.

Fusion Pro is compatible with Core 2 Duo, Xeon, i3, i5, i7, and newer processors.

Memory Requirements for Host SystemsThe host system must have enough memory to run Mac OS X, the guest operating systems that run insidethe virtual machines on the Mac, and the applications that run in the Mac and guest operating systems.

The minimum memory required on the host system is 4 GB. 8 GB is recommended.

The host system must have 750 MB of free disk space for Fusion Pro and at least 5 GB of free disk space foreach virtual machine

VMware, Inc. 17

Supported Host Operating SystemsTo install Fusion Pro, your Mac must have a supported Mac OS X operating system.

n Mac OS X 10.9

n Mac OS X 10.10

n Mac OS X 10.11

Install or Upgrade the Horizon FLEX Client for MacYou install or upgrade theHorizon FLEX Client for Mac (Fusion Pro) in the same way you install other MacOS X applications.

Prerequisites

n Verify that your Mac meets the system requirements for Fusion Pro. See “Host System Requirementsfor Fusion Pro,” on page 17.

n Verify that you have the administrator password for your Mac.

n Download the Horizon FLEX Client for Mac installer to your Mac. You can obtain the Horizon FLEXClient for Mac installer from the VMware website, or your Horizon FLEX administrator may haveprovided you with a link to obtain the Horizon FLEX Client for Mac .dmg file.

n Verify that you have a Horizon FLEX license key for Fusion Pro. You must provide a Horizon FLEXlicense key during installation to run a Horizon FLEX virtual machine in Fusion Pro.

Procedure

1 Double-click the Horizon FLEX Client for Mac .dmg file to open it.

The contents of the disk image appear in the VMware Fusion Finder window.

2 In the VMware Fusion Finder window, double-click the VMware Fusion icon or drag it to theApplications folder.

3 Click the VMware Fusion icon in the Applications folder.

4 Type the administrator-level user credentials for your Mac to complete the installation.

5 Accept the license agreement and enter your Horizon FLEX license key.

What to do next

Download the Horizon FLEX virtual machine. See “Download a Horizon FLEX Virtual Machine with FusionPro,” on page 18 .

Download a Horizon FLEX Virtual Machine with Fusion ProIf your Horizon FLEX virtual machine is on a Horizon FLEX server, you must connect to the server anddownload the virtual machine to your Mac before you can open it in Fusion Pro.

If your Horizon FLEX administrator provided your virtual machine on a USB device or deployed it to yourMac, see “Open a Horizon FLEX Virtual Machine in Fusion Pro,” on page 20.






18 VMware, Inc.



Prerequisites

n Install Fusion Pro on your Mac. See “Install or Upgrade the Horizon FLEX Client for Mac,” on page 18.


Procedure

1 Connect to the Horizon FLEX server.

Option Action

Connect to the server in Fusion Pro a In the Applications folder on your Mac, click VMware Fusion.b If the Connect dialog box does not open automatically, select File >

Connect to Server to open it.c In the Connect to Server dialog box, fill in the server host name (with

full domain name) or IP address, user name, and type the password.The Server and Username text boxes might be prepopulated.

d Click Connect to connect to the server.


Connect to the server from a link If you received a link in an email from your Horizon FLEX administrator,perform these steps:a Click the link .b When the Connect to Server dialog box opens, type the password that

your Horizon FLEX administrator provided.c Click Connect to connect to the server.


2 In the Available Desktops window, select the virtual machine to download and click the download

icon.

If your Horizon FLEX client software cannot validate the certificate, you might receive an InvalidSecurity Certificate warning. If you receive this warning, verify that the certificate is valid with yourHorizon FLEX administrator. If the certificate is valid, select the Always trust this host with thiscertificate check box and click Connect Anyway.

3 Type a name for the virtual machine in the Save As text box or accept the default name.

4 Select a location to save the virtual machine from the Where menu or accept the default location.

VMware recommends that you save the virtual machine in the Virtual Machines folder.

5 Click Save to start the download operation.

Before the download begins, a disclaimer message might appear that requires your acceptance. Afterthe download begins, a status bar displays the progress of the download operation.

Chapter 3 Using the Horizon FLEX Client for Mac

VMware, Inc. 19

You can click the pause button to suspend the download and click the restart button to resume thedownload at a later time. If you suspend a download and exit Fusion Pro, you can resume thedownload the next time you start Fusion Pro. You can click the X button to cancel the download.






What to do next


Open a Horizon FLEX Virtual Machine in Fusion ProIf your Horizon FLEX virtual machine is on a USB device or is deployed to your Mac, you must register itwith the Horizon FLEX server before you can open it in Fusion Pro.

If your virtual machine is on a Horizon FLEX server, you must download it to a folder on your Mac. See “Download a Horizon FLEX Virtual Machine with Fusion Pro,” on page 18.







Prerequisites

n Install Fusion Pro on your Mac. See “Install or Upgrade the Horizon FLEX Client for Mac,” on page 18.

n If your virtual machine is on a USB device, connect the USB device to your computer and copy thevirtual machine to your computer.


Procedure

1 In the Applications folder on your Mac, click VMware Fusion.

2 Select File > Open from the VMware Fusion menu bar.

Use your Active Directory password to open the Horizon FLEX virtual machine.

3 Browse to and select the virtual machine configuration (.vmx) file for your virtual machine and clickOpen.


20 VMware, Inc.


5 Type the credentials that your Horizon FLEX administrator provided for the Horizon FLEX server andclick Connect to connect to the server.

You must connect to the Horizon FLEX server to register your virtual machine.




7 (Optional) If prompted, type the credentials that your Horizon FLEX administrator provided for theHorizon FLEX server and click Connect to connect to the server again.

The virtual machine connects to the Horizon FLEX server and the guest operating system restarts. Youare prompted to connect to the server again only if your Horizon FLEX administrator configured yourvirtual machine to join a domain.


What to do next


Edit Virtual Machine Settings in Fusion ProWhen you are editing Horizon FLEX virtual machine settings in Fusion Pro, you must provide therestrictions password to unlock and edit certain settings. For other settings, including General, ApplicationsMenu, Keyboard & Mouse, Processors & Memory, Network Adapter, USB & Bluetooth, and Encryption &Restrictions, you do not need to enter the restrictions password.

For complete information about virtual machine settings, see the Fusion Pro documentation at https://www.vmware.com/support/pubs/fusion_pubs.html.

Prerequisites




Procedure

1 In the Applications folder on your Mac, click VMware Fusion.

2 From the VMware Fusion menu bar, select Window > Virtual Machine Library.

3 Select the virtual machine and click Settings.

4 Type the encryption password that your Horizon FLEX administrator provided and click OK to openthe virtual machine.


VMware, Inc. 21


5 Select the virtual machine setting to modify.

If the setting you want to modify is not shown, click the lock icon in the upper-right corner of theSettings window and enter the restrictions password for the virtual machine.

Your Horizon FLEX administrator controls whether you can change the virtual machine's memory ornumber of processor cores. If these options are unavailable (dimmed), then these options have beenrestricted by your administrator.

6 Modify the setting and close the dialog box to save your changes.

Using Mac Keyboards in a Virtual MachineBecause PC and Mac keyboards differ, you must press certain key combinations to enable certain PCcommands on a Mac keyboard.

For keys with no keyboard equivalent, Fusion provides the Send Key item in the Virtual Machine menu.

Table 3‑1. PC and Mac Keyboard Equivalents

PC Keyboard Apple External KeyboardMacBook and MacBook Pro Built-InKeyboard

F1-F12 F1-F12 fn+F1 . . . fn+F12

Print Screen F14 (use Send Key)

Scroll Lock F15 (use Send Key)

Pause/Break F16 (use Send Key)

Backspace delete delete

delete (Forward Delete)

delete fn+delete

Insert (toggles overwrite) help (early models) (use Send Key and select Help item)

Num Lock clear fn+num lock F6

Command(Windows logo key—between Ctrl andAlt keys)

Alt alt option alt option

Suspend and Resume a Virtual Machine in Fusion ProThe suspend and resume feature is useful to save the current state of a virtual machine and continue worklater from the same state, even if you quit Fusion Pro in the interim.

Procedure

u Take one of the following actions.

n Select Virtual Machine > Suspend to suspend your virtual machine.

You can also set a Fusion Pro preference to suspend the virtual machine when you close the virtualmachine window.

n Select Virtual Machine > Resume to resume your virtual machine.


22 VMware, Inc.

Power Off a Virtual Machine in Fusion ProWhen you shut down the guest operating system in your virtual machine in Fusion Pro, the virtual machineis powered off.

You might need to power cycle your virtual machine if your Horizon FLEX administrator changes thevirtual machine configuration.

You can use several methods to shut down your virtual machine's operating system. This procedure is thepreferred method.

Procedure

u From the Fusion toolbar, select Virtual Machine > Shut Down.

Option Description

Power Off If Windows is not responding, click Power Off to power off the virtualmachine. Power off might result in data loss and should only be used ifWindows is not responding.

Shut Down Click Shut Down to ask Windows to shut down.

Where to Find More Information About Fusion ProThis document provides basic information about using Fusion Pro. You can find more information aboutusing Fusion Pro at the following self-help sources.

n The complete Fusion documentation set, including release notes, is at https://www.vmware.com/support/pubs/fusion_pubs.html.

n The Fusion Learning Center has video tutorials, FAQs, community forums, and more to help you getup and running with Fusion Pro. In Fusion Pro, click Help > Video Tutorials.

n Self-paced video tutorials and answers to frequently asked questions are available through the VMwaresupport portal at http://www.vmware.com/go/fusionsupport. Use the Advanced Help tab to view thelist of tutorials.

n Join the Fusion Community at http://www.vmware.com/go/fusionforums to exchange information,questions, and comments to get the most out of Fusion Pro.

n To find information on a specific problem you encounter, select VMware Fusion in the product list andsearch for your problem by key word at http://kb.vmware.com.

n For answers to frequently asked questions, go to http://www.vmware.com/products/fusion/faqs.html.


VMware, Inc. 23


http://www.vmware.com/go/fusionsupport

http://www.vmware.com/go/fusionforums

http://kb.vmware.com

http://www.vmware.com/products/fusion/faqs.html


24 VMware, Inc.

Troubleshooting Horizon FLEXVirtual Machines 4

If you experience difficulty when accessing your Horizon FLEX virtual machine, you can usetroubleshooting procedures to investigate the causes of problems.


n “Virtual Machine File Cannot be Found,” on page 25

n “Virtual Machine Cannot Be Powered On,” on page 26

n “Virtual Machine Is Expired,” on page 26

n “Virtual Machine Has Not Contacted the Server for n Days,” on page 26

n “Virtual Machine Is Revoked,” on page 27

n “Invalid Security Certificate,” on page 27

n “Horizon FLEX Client Is Not Compatible with the Server,” on page 27

n “Horizon FLEX Client Cannot Open the Virtual Machine,” on page 28

n “Changing the Memory and Processor Settings Is Not Allowed,” on page 29

n “Copying or Downloading the Virtual Machine Is Not Allowed,” on page 29

n “Folder Sharing on the Virtual Machine Is Not Allowed,” on page 29

n “USB Device Cannot Be Connected to the Virtual Machine,” on page 30

n “Virtual Machine Is Removed,” on page 30

Virtual Machine File Cannot be FoundWhen you try to power on a Horizon FLEX virtual machine, you receive an error message that the virtualmachine file cannot be found.

Problem

The message File not found: D:\Virtual Machines\Win7EntX64\Windows 7 x64.vmdk. The file isrequired to power on this virtual machine. If this file was moved, specify the new location.

Cause

The virtual machine disk (.vmdk) file is in the wrong directory.

Solution

u Move the .vmdk to the D:\Virtual Machines directory.

VMware, Inc. 25

Virtual Machine Cannot Be Powered OnThe Horizon FLEX virtual machine cannot be powered on.

Problem

When you try to power on the Horizon FLEX virtual machine, the operation fails.

Cause

The failure of the Horizon FLEX virtual machine to power on can stem from several causes.

n The Horizon FLEX virtual machine was created on a Horizon FLEX server version newer than the clientversion that you are running. As a result, the hardware version of your Horizon FLEX virtual machineis not compatible with the Horizon FLEX server.

n The Horizon FLEX virtual machine might have been created with more virtual processor cores or alarger memory size than your host system supports.

Solution

u Contact your Horizon FLEX administrator for assistance. For the compatibility problem, yourHorizon FLEX administrator can provide the Horizon FLEX client version to upgrade to. You mightalso be able to solve the compatibility problem by updating or downgrading the hardware version ofyour Horizon FLEX virtual machine.

Virtual Machine Is ExpiredWhen you start your Horizon FLEX virtual machine, you receive a message that states that your virtualmachine has expired.

Problem

The message This virtual machine has expired appears when you try to start your virtual machine inyour Horizon FLEX Client.

Cause

The expiration date for your virtual machine has been reached and the virtual machine has been turned off.

Solution

Ask your Horizon FLEX administrator to reactivate your virtual machine.

Virtual Machine Has Not Contacted the Server for n DaysWhen you start your Horizon FLEX virtual machine, you receive a message that states that the virtualmachine has not contacted the Horizon FLEX server for a certain number of days.

Problem

The message This restricted VM has been unable to contact its policy server for n day." appearswhen you try to start your virtual machine in Horizon FLEX Client.

Cause

Your Horizon FLEX administrator sets how many days you can use your virtual machine without contactwith the Horizon FLEX server. When this offline time limit is exceeded, the virtual machine will not poweron without first connecting to the Horizon FLEX server. This error occurs if the virtual machine cannotconnect to the Horizon FLEX server.


26 VMware, Inc.

Solution

Check your network connection and try again. If the problem persists, contact your Horizon FLEXadministrator.

Virtual Machine Is RevokedWhen you start your Horizon FLEX virtual machine, you receive a message that states your virtual machinehas been revoked.

Problem

The message Access to this virtual machine has been revoked appears when you try to start your virtualmachine in your Horizon FLEX Client.

Cause

Your Horizon FLEX administrator has revoked access to your virtual machine.

Solution

Ask your Horizon FLEX administrator to reactivate your virtual machine.

Invalid Security CertificateWhen you try to connect to Horizon FLEX server or download a Horizon FLEX virtual machine, you receivea warning stating the security certificate is invalid.

Problem

You receive the message Invalid Security Certificate when you try to download a Horizon FLEX virtualmachine.

Cause

This warning message appears when the Horizon FLEX server uses a self-signed certificate and yourcomputer does not trust the certificate.

Solution

Verify with your Horizon FLEX administrator that the certificate is valid for the Horizon FLEX server. If thecertificate is valid, select the Always trust this host with this certificate check box and click ConnectAnyway.

Horizon FLEX Client Is Not Compatible with the ServerWhen you start the Horizon FLEX virtual machine, you cannot connect to the Horizon FLEX server becausethe client version that you are using is incompatible with the server version.

Problem

When you open a Horizon FLEX virtual machine or try to connect to the server, a message appears: Youneed to upgrade your client or The server is running a newer version than supported by thissoftware. Please download a newer version to resolve this issue.

Cause

The Horizon FLEX server requires that you use a specific Horizon FLEX Client version.

Solution

u Contact your Horizon FLEX administrator to find out the Horizon FLEX Client version to upgrade to.

Chapter 4 Troubleshooting Horizon FLEX Virtual Machines

VMware, Inc. 27

Horizon FLEX Client Cannot Open the Virtual MachineWhen you try to open a Horizon FLEX virtual machine for the first time, you receive a message that therestrictions management server could not be contacted.

Problem

When you try to open a Horizon FLEX virtual machine for the first time, the restrictions management servercannot be contacted.

Cause

This error occurs because your operating system does not trust the Horizon FLEX server's certificate.

Solution

1 Verify with your Horizon FLEX administrator that the certificate is valid for the Horizon FLEX server.

IMPORTANT Do not perform this task if the certificate is not valid.

2 If you are using Fusion Pro, install the Horizon FLEX server's certificate on your Mac.

a In your browser, go to the Horizon FLEX server URL.

For example: https://yourserver:7443

b Accept the certificate warning to save the certificate.

c Open the KeyChain application.

d Find the certificate under login and drag it to System.

e Open the certificate under System. Expand the Trust button, select Use System Default, and closethe certificate.

f Reopen the certificate under System, expand Trust, select Always Trust, and close the certificate.

The certificate is now trusted for all users on the Mac.

3 If you are using Workstation Player, install the Horizon FLEX server's certificate on your Windowssystem.

a In your browser, go to the Horizon FLEX URL.

For example: https://yourserver:7443/rvm

b Click the lock icon in the address bar.

c Click Certificate information.

d On the Details tab, click Copy to file and export the certificate to a file.

e Start MMC (mmc.exe).

f Select File > Add/Remove Snap-in.

g Click the Certificates snap-in and click Add.

h On the Certificates snap-in display, select Computer account and click Next.

This setting is required by the Horizon FLEX server.

i Select Local Computer and click Finish and then OK.

j In the left navigation pane, expand Certificates (Local Computer).


28 VMware, Inc.

k Right-click on Trusted Root Certification Authorities and select All Tasks > Import.

The Certificate Import Wizard opens.

l Click Next.

m Browse for the root certificate file and click Next.

n Select Place all certificates in the following store: Trusted Root Certification Authorities andclick Next, then click Finish.

The certificate is now trusted for all users on your Windows computer.

Changing the Memory and Processor Settings Is Not AllowedYou cannot use the memory and processor settings option to change the settings on the Horizon FLEXvirtual machine.

Problem

You cannot change the memory and processor settings on your Horizon FLEX virtual machine.

Cause

Your Horizon FLEX administrator has restricted the ability to change memory and processor settings onyour virtual machine.

Solution

u Contact your Horizon FLEX administrator.

Copying or Downloading the Virtual Machine Is Not AllowedYou cannot copy your Horizon FLEX virtual machine or download it from the administrator.

Problem

You cannot copy or download your Horizon FLEX virtual machine. An error message states that the virtualmachine has already been downloaded and registered.

Cause

Your Horizon FLEX administrator has restricted the ability to create multiple instances of your virtualmachine.

Solution


Folder Sharing on the Virtual Machine Is Not AllowedYou cannot use the folder sharing options on your Horizon FLEX virtual machine.

Problem

You cannot share folders on your Horizon FLEX virtual machine. The options are dimmed or unavailable.

Cause

Your Horizon FLEX administrator has restricted the ability to share folders on your virtual machine.

Solution


Chapter 4 Troubleshooting Horizon FLEX Virtual Machines

VMware, Inc. 29

USB Device Cannot Be Connected to the Virtual MachineThe USB device cannot be connected to the Horizon FLEX virtual machine.

Problem

When you try to connect a USB device to the virtual machine, the USB device type is dimmed (unavailable).

Cause

Your Horizon FLEX administrator has restricted the ability to use the USB device type on your virtualmachine. Depending on how the Horizon FLEX administrator configured the virtual machine policy, someUSB device types might be allowed and some might be blocked.

Solution


Virtual Machine Is RemovedYour Horizon FLEX virtual machine is not visible on your desktop.

Problem

The virtual machine is not available or is not visible on your desktop.

Cause

Your Horizon FLEX administrator might have removed the virtual machine.

Solution



30 VMware, Inc.

Index

Bblocked USB devices 30

Cconnection problems 26copying the virtual machine unavailable 29CPUs, host requirements 9Ctrl+Alt+Delete 14Ctrl+Alt+Ins 14

Ddocumentation resources 16, 23downloading Horizon FLEX VM not allowed 29downloading Horizon FLEX VM not available 29downloading virtual machines 11, 18

Eediting virtual machines 14, 21expired virtual machines 26

Ffailure to contact the restrictions management

server 28folder sharing unavailable 29folders, sharing unavailable 29function keys 22Fusion Pro 8

HHorizon FLEX server, client incompatibility 26,

27Horizon FLEX Client compatibility with server

26, 27Horizon FLEX Client for Mac (Fusion Pro) 17Horizon FLEX Client for Windows (Workstation

Player) 9host operating systems 10, 18

Iincompatibility, Horizon FLEX server, client 26,

27installing Horizon FLEX Client for Mac (Fusion

Pro) 18installing Horizon FLEX Client for Windows

(Workstation Player) 11intended audience 5

introduction 7invalid security certificate warning 27

Kkeyboard

equivalent Mac and PC commands 22function keys 22

MMac client 8memory, host requirements 10memory requirements 17memory and processor settings 29

Oopening virtual machines 13, 20

Ppowering off virtual machines 15, 23processor requirements 17processor and memory settings 29processors, host requirements 9

RRAM, host requirements 10restrictions management server, unreachable 28resuming virtual machines 22revoked virtual machines 27

Sshutting down virtual machines 15, 23suspending virtual machines 15, 22system requirements, host system 9

Ttroubleshooting 25

UUSB device types unavailable on VMs 30USB devices blocked on VMs 30

Vvirtual machine, copying unavailable 29virtual machine file not found 25virtual machine removed 30

VMware, Inc. 31

virtual machinesdownloading 11editing 14, 21powering off 15resuming 22shutting down 15suspending 22using Mac keyboards with 22

WWindows client 8Workstation Player 8


32 VMware, Inc.

vmware horizon flex client user guide - horizon flex 1 · contents vmware horizon flex client user...

Documents