Teradici PCOIP APEX2800 LP User manual

TERADICI PCOIP®
HARDWARE ACCELERATOR
Quick Start Guide
Models: APEX2800 LP
Actual products may not be exactly as shown.

3
PACKAGE CONTENTS
• Hardware Accelerator APEX2800 LP
• Standalone full height bracket
• Quick Start Guide (this document)
IMPORTANT TIPS
Please check that the card is detected by the
ESXi hypervisor before installing the drivers
Download the latest ESXi and VM drivers to keep
the card compatible with VMware®product
releases by visiting the Teradici Support Site.
SYSTEM REQUIREMENTS
System requirements may vary based
on the driver versions used, check the
Administrators' Guide for the latest
updates.
APEX2800 LP
• PCIe slot x4, x8 or x16
• ESXi 6.0 or later
• VMware Horizon View 7.5 or later
Thank you for purchasing
the Teradici PCoIP Hardware
Accelerator.
The only product of its kind, the
PCoIP Hardware Accelerator
enhances VMware Horizon®
performance, either View (VDI)
or Published Desktop (RDS). The
card is designed to dynamically
offload PCoIP image encoding
tasks from the server’s CPU to
significantly reduce CPU peaks,
thus ensuring a better user
experience at all times.
This guide will help you install and
configure your PCoIP Hardware
Accelerator.

4
Figure 1
1. Always power down and disconnect devices from AC power before
handling them, as some circuitry on the server can continue to
operate even though the front panel switch is OFF. Failure to
disconnect the device from AC power can result in personal injury
or equipment damage. And, always ensure correct anti-static
handling is observed to avoid potential ESD damage in the card
(e.g. do not walk on carpet).
INSTALLATION STEPS
Install the PCoIP Hardware Accelerator
1. Ensure all virtual machines hosted by the server are powered down
or migrated to another server before continuing.
2. In the VMware vSphere client, right click on the ESXi server in the
inventory and select Enter Maintenance Mode.
3. Shutdown ESXi server.
4. Make sure the server is turned off and disconnected from AC power.
4. Insert the PCoIP Hardware Accelerator into a free PCI Express
slot and secure the bracket.
5. Plug the server into a surge-protected AC outlet and power on.
6. Use the command “lspci |grep -i tera” to check if the card is
detected by ESXi as shown below. If not, please ensure the slot is
compatible

5
2. Copy the driver package from your PC to the ESXi server using secure
copy:
a. Download and install WinSCP (Windows Secure Copy) on your PC.
b. Start WinSCP and specify your ESXi server Host name
(IP address), Username and Password.
c. Make sure the File protocol is SCP.
d. Click Login (refer to Figure 2 and 3).
A
Figure 2
Install the ESXi Driver Package
1. Enable remote login on the VMware ESXi server:
a. Press F2 to enter customization.
b. Enter your Username and Password.
c. Enable by selecting Troubleshooting Mode Options > Enable SSH

6
3. Connect to the ESXi server using a SSH client (e.g. PuTTy) from
your PC and install the driver package:
a. Navigate to the /tmp directory Enter the following command
for ESXi 5.5 or later:
esxcli software vib install -d /tmp/apex2800-rel-
<version>.<build number>.zip
The message in Figure 4 appears when the installation completes:
4. Reboot the ESXi server
5. In vSphere client, right click on the ESXi server in the inventory
and select Exit Maintenance Mode.
e. Drag the apex2800-rel-<version>.<build number>.zip to: the tmp
directory on your ESXi server.
Figure 4
Figure 3

7
Install the virtual machine driver
Install the PCoIP Hardware Accelerator virtual machine driver on each
virtual machine.
1. Power up the virtual machine as shown below.
2. Open a console window from vSphere client.
3. Run the apex2800-version-rel-build.exe installer on the virtual
machine and follow the steps that appear. (Note: This package
must be installed from VM’s Console in the vSphere client – it
cannot be installed from within a PCoIP session to the virtual
machine).
4. After the installation completes, choose to power cycle the
machine.
IMPORTANT
Make sure to power the virtual machine off and back on again.
This ensures that ESXi will inspect the updated virtual machine
image.
In a Horizon View 6 RDS environment please follow KB
15134-1145 toenable offload for multiple sessions on RDS hosts.
Figure 5

8
Verify global policies settings
1. Verify global policies settings in View Connection Server:
• Make sure that PCoIP Hardware Accelerator is set to ‘allow’ in the
Global Policies, if any policies inherit from it.
• In any custom policies, make sure the option for enabling and
disabling PCoIP Hardware Accelerator is set to allow as per
Figure 6.
View the PCoIP Hardware Accelerator status
The PCoIP Hardware Accelerator is now installed and configured.
1. Verify the working status of the PCoIP Hardware Accelerator
as shown in Figure 7:
• In your SSH session, enter the following command:
opt/teradici/pcoip-ctrl-1
• The output should show Device (Bus x) (IN_SERVICE) under
APEX2800 Device Summary.
Figure 6 Figure 7

9
RESOURCES
•Teradici Support Site - https://help.teradici.com/s/
•PCoIP Community Forum – https://communities.teradici.com
•Teradici PCoIP Hardware Accelerator’s Guide
•PCoIP Session Planning Guide
PCoIP Knowledge Base:
•KB 15134-1145: “How to enable more than one offload on the
PCoIP Hardware Accelerator (APEX2800) when using a View 6 RDS
host?”
•KB 15134-1553: “Dashboard and Simulation Tools”
Videos:
•What is PCoIP Hardware Accelerator?
•How is the PCoIP Hardware Accelerator different from a
GPU?
•What are the PCoIP Hardware Accelerator Benefits?

10
PRODUCT WARRANTY & SUPPORT
This product is covered by a three (3) year warranty period from the time of purchase.
For more information, visit teradici.com/pcoip-product-support-maintenance or contact your reseller.
SPECIFICATIONS
Model APEX2800 LP
Format Half height, half length
PCIe gen 2.0, x4
Memory 2GB of onboard DDR3 SDRAM with ECC protection
# of displays
supported
Resolution
2560x1600
1920x1200
1680x1050
1280x1024
In Portrait
25
40
50
100
In Landscape
40
64
85
100
Power Power supplied to card via PCIe interface, Max 15 watts
GPU compatibility Supports GPU options: shared GPU (vSGA), vGPU and GPU pass-through (vDGA)
Optional add-on PCoIP Zero Clients - coupled with PCoIP Hardware Accelerator would deliver the best user experience

11

12
© 2004-2018 Teradici Corporation. All rights reserved. Teradici, PCoIP and PC-over-IP are
trademarks of Teradici Corporation and may be registered in the United States and/or other
countries. All other trademarks are property of their respective owners. Specifications subject to
change without notice. Covered under US patents. Visit www.teradici.com/patents. TER1104010-9