Teradici t310 Manual

Using PCoIP®Host Cards with
VMware View™
TER0911004
Issue 2

Using PCoIP Host Cards with VMware View
TER0911004 Issue 2 3
Teradici Corporation
#101-4621Canada Way, Burnaby, BC V5G 4X8Canada
p+1 604451 5800f+1 604451 5818
www.teradici.com
The information contained in thisdocumentrepresents thecurrent view of Teradici Corporation as of thedate
of publication.BecauseTeradici must respond to changingmarket conditions, itshould not beinterpreted to be
a commitmenton thepart of Teradici,andTeradicicannot guaranteethe accuracy ofany information
presented after the date of publication.
Thisdocumentis for informational purposes only.TERADICI MAKESNO WARRANTIES, EXPRESS, IMPLIED
OR STATUTORY, AS TO THE INFORMATION IN THIS DOCUMENT.
Complying withall applicablecopyrightlaws isthe responsibility of the user. Without limitingtherightsunder
copyright, no part of thisdocumentmay be reproduced, stored in or introduced intoa retrieval system, or
transmitted in anyform or by any means(electronic, mechanical,photocopying,recording,or otherwise), or for
any purpose, withoutthe express written permission of Teradici Corporation.
Teradici mayhave patents, patentapplications,trademarks, copyrights, or other intellectual propertyrights
covering subject matter in this document.Except as expressly provided in any written licenseagreement from
Teradici,thefurnishing of this documentdoesnot give you any license to these patents, trademarks,
copyrights, or other intellectual property.
© 2011Teradici Corporation. All rightsreserved.
Teradici,PC-over-IP, and PCoIP are registered trademarks of TeradiciCorporation inthe UnitedStates and/or
other countries. The namesof actual companiesand products mentionedherein maybe the trademarks of
their respective owners.

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 4
RevisionHistory
Version Date Description
2 October 27, 2011 Update for VMwareView 5
1 April 8, 2010 Initial release

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 5
Contents
Table of Figures....................................................................................................6
1Overview ........................................................................................................9
1.1 Additional Resources.........................................................................................9
2Prerequisites ................................................................................................11
2.1 Installing VMwareView 5 or Later......................................................................11
2.2 Setting up the PCoIP Host Card and Zero Client..................................................11
2.3 Installing Tera1 Firmware Release 3.4.1 or Later..................................................12
2.3.1 Checking the Firmware Version..............................................................12
2.3.2 Updating the Firmware..........................................................................13
2.4 Installing PCoIP Host Driver Software Release v3.3.20 for Windows.......................14
2.5 Ensuring your Operating System Complies with VMware View...............................14
3Host PC Configuration.................................................................................15
3.1 Installing the VMware View Agent on a Host PC...................................................15
4Configuring a Physical PC in View .............................................................17
5Installing the PCoIP Host Driver Software..................................................18
5.1 Installing the PCoIP Host Driver Software on a Host PC........................................18
6Configuring the PCoIP Zero Client .............................................................19
7Connecting a PCoIP Zero Client to View ...................................................21
7.1 Testing the PCoIP Connection...........................................................................21
8Deployment Considerations........................................................................22
8.1 Bandwidth Matrix for Various Setups of Zero Clients, Soft Clients, and Hosts...........22
9Known Issues, Troubleshooting, and FAQ.................................................23
9.1 Troubleshooting..............................................................................................23
9.2 Frequently Asked Questions .............................................................................23

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 6
Tableof Figures
Figure 1-1: VMware View andPCoIP Technology Architecture .........................................9
Figure 2-1: Administrative Web Interface VersionWebpage...........................................13
Figure 3-1: VMware View Agent Custom Setup Window................................................15
Figure 3-2: VMware View Agent Register with View Connection Server Window................16

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 7
Definitions
CA Certificate Authorities
CMI Connection Management Interface – interface provided by the client or host,
used to communicate withan external connection management server
CMS Connection Management Server – an external management entity (third
party) that manages and controls the client/host through the CMI interface
DDC Display Data Channel
DHCP Dynamic Host Configuration Protocol
DNS Domain Name System
DNS SRV Domain Name System Service Record
EDID Extended Display Identification Data
FQDN Fully Qualified Domain Name
GPU Graphics Processing Unit
GUI Graphical User Interface presented by the client On-Screen Display whennot
operating in a PC-over-IP session
HPDET Hot Plug Detect
MTU Maximum Transmission Unit
NTP Network Time Protocol
OS Operating System
OSD On Screen Display
PC-over-IP
®
Personal Computer over Internet Protocol
PCoIP
®
Personal Computer over Internet Protocol (PC-over-IP)
PCoIP host Host side of PC-over-IP system
PCoIP zero client Desktop or client side of PC-over-IP system
SLP Service Location Protocol
SSL Secure Socket Layer (security protocol)
TERA1100 Teradici PCoIP zero client processor
TERA1200 Teradici PCoIP host processor
VPD Vital Product Data – Factory provisioned information to uniquely identify a
client or host
VPN Virtual Private Netw ork

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 8
Introduction
This document describes the use of PCoIP®host cards to remote demanding applications that
require dedicated graphics cards within an environment brokered by VMware®View™. It
describes the setup and configuration of PCoIP host cards (or“host cards”) in physicalPCs or
workstations connecting to PCoIP software clients or PCoIP zero clients.

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 9
1 Overview
VMware View lets you set up PCoIP sessions between PCoIP clients and PCoIP hostcards.
Using a PCoIP host card installed in a physical PC or workstation lets you remote higher end
3D applications that use dedicated GPUs.
This document describes how to set up a PCoIP session between a PCoIP zero client or
software client (i.e., a notebook or thin client running a VMware View client) and a PCoIP
host card using VMware View.
VMWare
Virtual
Center
Active
Directory
VMWare
View
Connection
Server
VMware ESXi
VMware View
Client Protocol
VMware View
Agent Protocol
PCoIP Protcol
VMware
View Agent
PCoIP
Server
VMware
View Agent
PCoIP
Server
Guest VM
Guest VM
PCoIP Protcol
PCoIP Zero Client
Integrated Display
Client PC or TC
VMware View Client
VMware
View Client
PCoIP
Client Plug-
in
ESX/ESXi Server
Guest VM
VMware
View Agent
PCoIP
Server
OS
VMware
View Agent
PCoIP
Host SW
PCoIP Protocol
PCoIP Zero Client
PCoIP Host Card
Host Machine
PCoIP Hardware
Accelerated Workstation
Figure 1-1: VMware View and PCoIP Technology Architecture
1.1 Additional Resources
This document provides basic guidelines for using PCoIP host cards with VMware View. For
more details on any of these steps or procedures, see the following documents:
DocumentName Description Source
PCoIP Administrator’s
Guide
(TER0606004)
Documents configuration details for a single
zero client through the administrative w eb
interface.
Teradici Support Site
PCoIP Host Softw are User
Guide
(TER0810001)
Details the host driver installation process.
PCoIP Management
Console User Manual
(TER0812002)
Provides (multiple) zero client setup and
maintenance details through the
management console for PCoIP softw are.

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 10
DocumentName Description Source
PCoIP to VMw are View
Virtual Desktop
Configuration and WAN
Netw ork Optimization
Guide
(TER1007002)
Provides general guidelines for typical office
users that are connecting PCoIP zero clients
and softw areclients to VMw areView 5 virtual
desktops over remote access WAN
networks.
Using PCoIP Zero Clients
withVMw are View
(TER0904005)
The configuration of a PCoIP zero client or
PCoIP integrated display, w ithVMware View.
Virtual Desktop Network
Design Checklist
(TER1105004)
Documents things to consider (such as
bandwidth, QoS, latency, jitter, and packet
loss) w hendesigning your netw ork for virtual
desktops to ensure a responsive desktop.
VMwareView 5
Evaluator's Guide A self-guided, hands-on review of VMw are View 5. The content is intended to show how
easily you can set up a VMwareView
environment so you can evaluate both new
and important capabilities. These capabilities
include creating and managing virtualized
desktops, and validating the suggested use
cases.
VMwareView Technical
Resources
VMwareView
Administration guide 5 Describes how to configure and administer VMwareView,including how to configure
View Connection Server, create
administrators, provision and deploy View
desktops, set up user authentication,
configure policies, and manage VMware
ThinApp™ applications in View
Administrator. This information also
describes how to maintain and troubleshoot
VMwareView components.
VMwareView
documentation site
VMw areView Architecture
Planning guide VMwareView Architecture Planning provides an introduction to VMw are View, including a
description of its major features and
deployment options and an overview of how
VMwareView components are typically set
up in a production environment.

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 11
2 Prerequisites
To use a PCoIP zero client and PCoIP host card (in a workstation or physicalPC) with
VMware View 5, you need aminimum of a:
•VMware View environment currently running with VMware View 5 Connection Server
and VMware View 5 Agent
•Firmware release 3.4.1 (or later) for PCoIP zero clients and host cards
•PCoIP host card
•PCoIP client(s) including:
oPCoIP zero client
oNotebook, thin client, or repurposed PC running a VMware View 5 client configured
for a PCoIP session (default)
•PCoIP host driver software v3.3.20 (or later) for Windows®
•Workstation operating system compatible with VMware View 5
•Workstation graphics card that complies with PCoIP host cards(i.e, DVI or display port
based GPU)
You must also know how to use PCoIP zero clients and PCoIP host cards independent of
VMware View. For details, see the Additional Resources section.
2.1 Installing VMware View 5 or Later
You must install VMware View 5, which includes the View Connection Server and View
Administrator UI. For more details about the process to install the View Agent in the target
desktop, see section 3.1.
2.2 Setting up the PCoIP Host Card and Zero Client
1. Set up a physicalhost PC with the host card installed. Connect the network and DVI
cables. For more details, see your vendor setup documentation.
2. Set up a zero client, connecting display(s), powercable, network cable, and the USB
mouse/keyboard.
3. Make sure that the host card and zero client are running PCoIP firmware release 3.4.1 or
later (see section 2.3).
4. From a web browser, enter the IP addressfor the zero client.
5. Log in to the administrative web interface.
6. From the Configuration > VMware Viewmenu, ensureEnable VMware Viewis
deselected (that is, disable use with VMware View Connection Server/Manager).
7. Make sure the host PC NIC is connected to the same network as the host, the zero client,
and the View Connection Server. Make sure:
oThe host PC can ping the IP address of the host card, client, and View Connection
Server.

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 12
oThe View Connection Server can communicate with the host card, client, and the
View Agent installed on the host PC (seesection 3.1). This lets View manage
connections between the host card and client.
8. Set up a PCoIP session between the host card and zero client.
2.3 Installing Tera1 Firmware Release 3.4.1 or Later
The functionality described in this document is available with Tera1 firmware release 3.4.1 or
later. Verify that the zero client and host card are using the correct firmware release.
The processes described in this document refer to the administrative web interface.
2.3.1 Checking the Firmware Version
To check the firmware version through the administrative web interface:
1. From a web browser, enter the IP address of the client.
2. Log in (if required).
3. Click Info > Version.
You can also access the IP address for the client and host card from the:
•Router’s DHCP lease table
•Management Console for PCoIP protocoldevices
•On Screen Display (from the Connect screen, click Options > Configuration>
Network)

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 13
Example: Findingthe Firmware Release
The example in Figure 2-1 shows that firmware release 3.4.0 is currently in use. The client
must be updated to firmware release 3.4.1 (or later).
Figure 2-1: Administrative Web Interface Version Webpage
2.3.2 Updating the Firmware
You can update the firmware release through the:
•Administrative webinterface: Verify the firmware release for a single zero client or
host card through the respective IP address
•Management Console for PcoIPprotocol devices:Verify one or many zero clients in
your network
•Other tools such as connection brokers
If you do not have firmware release 3.4.1 (or later), visit the TeradiciSupport site to
download the latest version.
Example
This example shows you the steps to update the firmware through the administrative web
interface:
1. Ensure the host PC or workstation is in an idle state (close all applications).
2. Open a web browser.
3. Log into the administrative web interface for the host card. For example, 192.168.1.100
(accept certificates, and then enter the login information as required).
4. Choose Upload > Firmware, and then click Browse.
5. Select the firmware .all file. For example, tera1x00_rel3-4-1_ga_11491.all
6. Click Open.

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 14
7. Click Upload.
8. A warning appears. Click OK to start the upload. This operation may take a few minutes.
9. The following message appears when complete:“Success Flash successfully
programmed!” Click Resetto reset the device for the changes to take effect.
10. A warning appears. Click OK to proceed.
11. Repeat steps 3 through 8 on the client, but do not reset or power cycle the client.
12. Restart the host.
13. Reset the client.
14. The new firmware is installed. You can now start a PCoIP session.
2.4 Installing PCoIP Host Driver Software Release v3.3.20
for Windows
The functionality described in this document requires PCoIP host driver software v3.3.20or
later. Verify that the PCoIP host driver software installed on the host PC is using the correct
release. See section 5 for details on the host software installation process. You can download
the latest host driver software package fromthe Teradici Support site.
2.5 Ensuring your Operating System Complies with
VMware View
Ensure that you are using an operating system that is supported by VMware View. See the
VMware View Architecture Planning guide for a list of supported operating systems.

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 15
3 HostPC Configuration
VMware View 5 enables the use of the PCoIP protocolto connect PCoIPzero clients to
virtual desktops and physicalhost PCs (with the PCoIP hostcards installed). This section
describes how to configure dedicated physicalhost PCs with PCoIP hostcards.
Note: Ensure that the host PC computer name is unique and easy to identify. To set up the
computer name, from Windows®XP: MyComputer> Properties> ComputerName tab>
Change...
3.1 Installing the VMware View Agent on a Host PC
1. Start the VMware View Agent installation wizard by double-clicking the file (such as,
VMware-viewagent-5.0.0-481677.exe) in the Windows operating systemfor the hostPC.
2. From the Welcome screen, click Next, and then click Next.
3. If you accept the terms, select I accept the terms inthe license agreement, and then
click Next.
4. Click Next.
The VMware View Agent Custom Setupwindow appears:
]
Figure 3-1: VMware View Agent Custom Setup Window
5. Note that in Figure 3-1, the PCoIP Server is not yet enabled. To enable it, click the down
arrow, and then choose This featurewill be installedin local harddrive.
The Custom Setupwindow reappears with the PCoIP now enabled.

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 16
6. Click Next. The Register with ViewConnection Server window appears:
Figure 3-2: VMware View Agent Register with View Connection Server Window
7. Enter the IP address / FQDN of the physicalserver or virtualmachine hosting VMware
View Manager 5.
8. Choose Specify administrator credentials, and then enter the username and password
for the VMware View Connection Server.
9. Click Next.
10. Click Install. Wait for the agent to install.
11. When the install finishes, click Finish.
12. When prompted, click Yes to reboot the host PC.
13. Wait for the PC to reboot before continuing.

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 17
4 Configuring aPhysicalPC in View
This section outlines the steps to configure a physicalPC for use with View.
1. Log into the VMware View Administrator interface.
2. Click Pools, and then click Add… to create a desktop entry.
3. Click Manual.
4. Follow the onscreen prompts to configure the PC to your specifications.

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 18
5 InstallingthePCoIPHost DriverSoftware
To complete the process to let the physicalPC work with VMwareView, you must installthe
PCoIP host driver software.
Important Note:You cannot upgrade the PCoIP host driver sofware while a VMware View-
brokered PCoIP session is active between a host workstation or host PC and VMware View
client. Doing this results in losing access to your mouse and keyboard when the driver
software is removed.
To upgrade the PCoIP host driver sofware in this type of deployment, either:
•Connect to the host from a zero client, or
•Upgrade the software while connected to the host throughanother desktop-remoting
protocolsuch as RDP or VNC
This section provides a quick overview of the host driver installation process. For more
details, see the PCoIP Host Software UserGuide (TER0810001) from the TeradiciSupport
site.
5.1 Installing the PCoIP Host Driver Software on a Host
PC
1. Download the PCoIP host driver software fromthe TeradiciSupport site (click Current
PCoIP Product and Releases).
2. Log into the administrative web interface for the host card.
3. From the Configuration > Host Driver Function menu, enable the Host Driver
Function.
4. Restart the host PC.
5. Install the PCoIP host software package appropriate for the operating systeminstalled on
the host PC. You can start the install process by double-clicking the installer.
o32 bit: PCoipHostSoftware_x86-v3.3.20.msi(or later)
o64 bit: PCoipHostSoftware_x64-v3.3.20.msi(or later)
6. When the Welcome screen appears, click Next.
7. Accept the terms, and then click Next.
8. Ensure the install location is correct, and then click Next.
9. Click Install.
Note: For Windows 7, when the driver is installed, a Windows Security dialog may
appear. Click Installto continue with the installation. To avoid this dialog from
appearing in the future, select Always trust software fromTeradici Corporation.
10. If prompted, restart the OS (otherwise skip this step). When restarted, the host driver
software installation process continues when the OS boots up. Click Install to continue.
11. Click Finish to complete installation.

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 19
6 Configuring the PCoIPZero Client
To use the PCoIP zero client through VMware View, you must enable the client for
management by VMware View.
To configure the zero client:
1. Log into the client administrative web interface or OSD (from the Connectwindow,
click Options).
2. From the Configuration menu,choose ConnectionManagement.
3. Ensure Enable Connection Managementis not selected.
4. From the Configuration menu,choose VMware View.
5. Select Enable VMware View.
6. From the Connection Server IP Address field, enter the IP address / FQDN of the
physicalserver or virtual machine hosting View.
7. Enable SSL.

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 20
8. Click Apply.
The VMware View logo should appear on the OSD Connect screen of the zero client.

Using PCoIP Host Cards with VMwareView
TER0911004 Issue 2 21
7 Connectinga PCoIP Zero Client toView
This section provides a brief outline of how to connect a client to a physicalPC that uses
VMware View. See Using PCoIP Zero Clients with VMware View (TER0904005) fromthe
TeradiciSupport site for details not covered in this section.
7.1 Testing the PCoIP Connection
1. From the client’s OSD Connect screen, click Connect.
2. Enter the credentials of the user you set up for the desktop entry created in the VMware
View Connection Server. Choose the domain associated with the entitled user.
3. Click Login.
4. Select the physical PC’s desktop entry created in the View Connection Server from the
list of available desktops.
5. Click Connect.
The View Connection Server establishes a PCoIP session between the client and the host
card. You can now access the physicalPC.
Note: If this is the first time that the physical PC is installed with View Agent 5 and
registered to the View Manager, there may be a short delay before the physicalPC is
available in the View Connection Server. If a warning message appears stating that the
desktop source is not yet available, wait a couple of minutes, and try to connect.