Page 2
PCoIP Administrator's Guide Teradici Corporation #101-4621 Canada Way, Burnaby, BC V5G 4X8 Canada p +1 604 451 5800 f +1 604 451 5818 www.teradici.com The information contained in this document represents the current view of Teradici Corporation as of the date of publication.
PCoIP Administrator's Guide Revision History Version Date Description Updated for Firmware Release 4.0.0 Security enhancement when connecting to VMware View Connection server: New VCS Certificate Check Mode options allow users to configure the client to reject, warn, or allow an unverifiable connection. This feature is available from both the Administrator Web Interface (AWI) and the Online Screen Display (OSD).
Page 4
PCoIP Administrator's Guide Version Date Description Updated for Firmware Release 3.5.0 Proximity card based SSO with Imprivata OneSign server support IEEE 802.1X network authentication IPv6 support DHCPv6 support Self-help link added: Lets you configure an end-user link for access to self-help information Limited USB 2.0 support for View 4.6 or later deployments (bulk only for devices directly connected to root ports) Enhanced imaging controls...
Page 5
PCoIP Administrator's Guide Version Date Description surface acoustic wave and AccuTouch five-wire resistive touch screen technologies. April 18, Updated for Firmware Release 3.3.1. 2011 Updated for Firmware Release 3.3. February Incorporated information from Administrative notes (which 2011 documented features for Firmware Release 3.2.0). Updated for Firmware Release 3.1.0.
Page 6
PCoIP Administrator's Guide Version Date Description Added description for Label webpage Added description for VMware View webpage Updated description (Device Bandwidth Floor) for Bandwidth webpage Updated figure for Image webpage Added description for Host Driver Function webpage Updated description (removed Enable Audio Compression) for Audio webpage Improved document wording and fixed errors Updated for Firmware Release 1.8...
Page 7
PCoIP Administrator's Guide Version Date Description Updated RDP web configuration Added Maximum Initial Image Quality to Image web configuration Added Time web configuration Added Firmware Part Number in Version web information Updated Firmware Upload build filename web information Updated RDP OSD configuration Added Firmware Part Number in Version OSD information Clarified Bandwidth and Image Configuration Example Removed TERA1x00 Firmware Defaults appendix to...
PCoIP Administrator's Guide Contents Revision History Table of Figures Table of Tables Definitions 1 Introduction 1.1 About this Document 1.2 Menu and Page Overview 2 Administrative Web Interface Overview 2.1 About the Page Layout 2.2 Supported Web Browsers 2.3 Administrative Web Interface IP Address 2.4 Administrative Interface Security 2.4.1 Installing the CA Root Certificate 2.5 Logging In...
Page 9
PCoIP Administrator's Guide 4.7.1 Configuring a Direct Session 4.7.2 Configuring a Direct Session with SLP Host Discovery 4.7.3 Configuring a VMware View Connection 4.7.4 Configuring Kiosk Mode 4.7.5 Configuring a View Connection Server + Imprivata OneSign Connection 4.7.6 Enabling or Disabling Connection Management 4.8 Controlling the Bandwidth for PCoIP Sessions 4.9 Setting the User Interface Language 4.10 Configuring the OSD Screen-saver Timeout...
Page 10
PCoIP Administrator's Guide 8.1.1 Firmware Upload Process Example: 8.2 Uploading a Logo to the Device 8.2.1 OSD Logo Upload Process Example 8.3 Uploading the Certificate 8.3.1 Uploading Certificates for 802.1X Authentication 9 Configuring the User Settings 9.1 Configuring VMware View Certificate Checking 9.2 Configuring the Mouse Settings 9.3 Changing the Keyboard Repeat Settings 9.4 Adjusting the Image Quality from the OSD...
Page 11
PCoIP Administrator's Guide A.2 DHCP and Enable Host Discovery Example A.2.1 Configuring the Client for DHCP and SLP Discovery A.2.2 Configuring the Host for Host DHCP and SLP Discovery A.2.3 Initiating an SLP Discovery Session A.3 USB Permissions Example A.3.1 Authorizing USB Device By Class A.3.2 Authorizing USB Device By Vendor/Product ID Appendix B: Client Language and Keyboard Support B.1 Languages Supported by the Client...
PCoIP Administrator's Guide Definitions Definition Description Certificate Authorities Connection Management Interface – interface provided by the host or client, used to communicate with an external connection management server Connection Management Server – an external management entity (third party) that manages and controls the host/client through the CMI interface Display Data Channel DHCP Dynamic Host Configuration Protocol...
Page 19
PCoIP Administrator's Guide Definition Description PCoIP Host Host side of PC-over-IP system Remote Desktop Protocol Note: RDP is not supported in firmware releases after 3.2.2 SLAAC Stateless Address Auto-configuration Service Location Protocol SNMP Simple Network Management Protocol Secure Socket Layer (security protocol) TERA1100 Teradici device supporting PC-over-IP client functionality TERA1200...
PCoIP Administrator's Guide Introduction ® As a user or administrator you can interact with your PCoIP zero clients and host cards (or "clients" and "hosts") through the embedded HTTPS web interface (i.e., Administrative Web Interface) and On Screen Display (OSD). To minimize the total learning curve and maximize the accessibility, the web interface and OSD are organized as similarly as possible and are structured in a task-oriented fashion.
PCoIP Administrator's Guide Title Description Section available from the Diagnostic menu. These options help you troubleshoot the device by letting you view Tools device statistics, generate test tones and patterns, reset the device, ping the device, and so on. This section describes the options available in the Viewing Device Information menu.
PCoIP Administrator's Guide Table 1-1: Configuration Menu Page Name Administrative Web Client, Section Interface (AWI), OSD, Host, or or Both Both Initial Setup Both Network Both Both IPv6 Both Both Label Both Both Discovery Both Both SNMP Both Session Both Both Bandwidth Both...
PCoIP Administrator's Guide Page Name Administrative Web Client, Section Interface (AWI), OSD, Host, or or Both Both Audio Both Power Client Table 1-3: Diagnostics Menu Page Name Administrative Web Client, Section Interface (AWI), OSD, Host, or or Both Both Event Log Both Both Session Control...
PCoIP Administrator's Guide Administrative Web Interface Overview The PCoIP Administrative Web Interface (AWI) lets you interact remotely with the device through an Internet browser. The host and client webpages have unique banners to easily identify each. About the Page Layout The following screenshot is an example of an Administrative Web Interface page from a host.
PCoIP Administrator's Guide Figure 2-1: Administrative Web Interface Home Page (Host) Supported Web Browsers The webpage servers on the host and client are compatible with the following web browsers: Firefox 8.0 or earlier Internet Explorer 6.0, 7.0, 8.0 Note: Other browsers may also be compatible. We strongly recommend you install the CA root certificate in your browser to avoid warning messages from appearing when you log into the Administrative Web Interface.
PCoIP Administrator's Guide Administrative Web Interface IP Address To access the Administrative Web Interface: 1. From an Internet browser, enter the IP address of the host or client you want to configure. The IP address used depends on how the IP addresses are determined within your IP network.
PCoIP Administrator's Guide Figure 2-2: Administrative Web Interface Log In Page 2. To change the time after which the device is automatically logged off, set the Idle Timeout field to: 1 minute 5 minutes 15 minutes 30 minutes Never 3. Click Log In. When you first login to a device, the Home Page appears. It provides an overview of the device status.
PCoIP Administrator's Guide Figure 2-4: Administrative Web Interface Home Page (Client) Table 2-1: Home Page Statistics Statistics Description For Further Details PCoIP processor type, version, and RAM Processor size Length of time that the PCoIP processor Time Since Boot See section has been running.
Page 31
PCoIP Administrator's Guide Statistics Description For Further Details Possible states: Disconnected, Connection Pending, Connected. Click the hyperlinked Connection State IP address to access the Administrative See section Web Interfaces for the peer of the host or client. 802.1X Authentication Identify if the 802.1X authentication is See section Status enabled or disabled on the device.
PCoIP Administrator's Guide Statistics Description For Further Details Preference field on the Image page. The value determines if the image is set to a smoother versus a sharper image. Options that may appear in this field include: Enabled: The Disable Build to Lossless Build to Lossless See section 4.11...
PCoIP Administrator's Guide Diagnostics: The pages off this menu help you troubleshoot the device. See section 6. Info: The pages off this menu let you view firmware information and the devices currently attached to the device. See section 7. Upload: The pages off this menu let you upload a new firmware version, an OSD logo, and your certificates to the device.
PCoIP Administrator's Guide 2.7.2 Viewing the Permissions Menu The Permissions menu contains links to pages that define the range of functionality exposed to the user. For details on each of the Permissions options, see section 5. 2.7.3 Viewing the Diagnostics Menu The Diagnostics menu contains links to pages with run-time information and functions that may be useful for troubleshooting.
PCoIP Administrator's Guide Working with the On Screen Display (OSD) The On Screen Display (OSD) local GUI appears on the client when the device is powered on and a PCoIP session is not in progress. The OSD lets the user connect to a host device through the Connect window.
PCoIP Administrator's Guide 3.1.1 Connect Button Click the Connect button to start a PCoIP session. When the PCoIP connection is pending, the OSD local GUI displays a "Connection Pending" message. When the connection is established, the OSD local GUI disappears and the session image appears. Figure 3-4: OSD Connect Screen (Connecting) About the OSD Options Menu There are five pages available from the Options menu:...
PCoIP Administrator's Guide Configuring the Device The Configuration option on the Administrative Web Interface and OSD lets you configure various aspects for the device. This section describes the full set of configuration options available from the host and the client. Note: The OSD configuration options are a subset of the options available in the Administrative Web Interface.
PCoIP Administrator's Guide Figure 4-2: Initial Setup Page (Client) Table 4-1: Audio Parameters For details on configuring the full set of Audio parameters, see section 5.2. Parameter Description Enable HD Audio Enables audio support on the host or client. Enables 64-bit mode on the host. This mode should only be used ®...
PCoIP Administrator's Guide Parameter Description Follow the onscreen instructions if you have Windows Vista or Windows 7 installed on the device. Note: This option is only available on the host. It does not appear on the client. Table 4-2: Network Parameters For details on configuring the full set of Network parameters, see section 4.2.
PCoIP Administrator's Guide Note: When Host Discovery or connection management is configured on the client, you cannot modify the client session parameters. A message appears on the Initial Setup Client page instead of the session parameters. Configuring the Network Settings You can configure the host and client network settings from the Initial Setup page or Network page.
PCoIP Administrator's Guide Figure 4-4: OSD Network Page Table 4-5: Network Page Parameters Parameter Description When enabled: The device contacts a DHCP server to be assigned an IP address, subnet mask, gateway IP address, and DNS servers. The firmware requests a domain name (option 15), host name Enable DHCP (option 12), and client FQDN (option 81).
Page 43
PCoIP Administrator's Guide Parameter Description ager, the Connection Manager address may be set as an FQDN instead of an IP address. The device's secondary DNS IP address. This field is optional. If the DNS server IP address is configured when using a connection Secondary DNS Server manager, the connection manager address may be set as an FQDN instead of an IP address.
PCoIP Administrator's Guide Parameter Description The default MTU is 1300 for sessions with PCoIP software (in the host or client) such as VMware View. Enable this field for each of your hosts and zero clients if your Enable 802.1X Security network uses 802.1X security.
PCoIP Administrator's Guide Figure 4-6: OSD IPv6 Page Table 4-6: IPv6 Page Parameters Note: When you make a change to one of the settings on this page, you must reboot your device for the change to take effect. Parameter Description Enable IPv6 Enable this field to enable IPv6 for your PCoIP devices.
PCoIP Administrator's Guide Parameter Description The domain name used (for example, 'domain.local') for the host or Domain Name client. If DHCPv6 is enabled, this field is automatically populated by the DHCPv6 server. The fully qualified domain name for the host or client. If DHCPv6 is FQDN enabled, this field is automatically populated by the DHCPv6 server.
PCoIP Administrator's Guide Figure 4-8: OSD Label Page Table 4-7: Label Page Parameters Parameter Description Lets you give the host or client a logical name. The default is pcoip- host-<MAC> or pcoip-portal-<MAC> where <MAC> is the device's MAC address. This field is the name the host or client registers with the DNS server if DHCP is enabled and the system is configured to support registering the hostname with the DNS server.
PCoIP Administrator's Guide Configuring the Discovery Mechanism Use the settings on the Discovery Configuration page to ease the discovery of hosts and clients in your PCoIP system and dramatically reduce the configuration and maintenance effort for complex systems. This discovery mechanism is independent of DNS SRV discovery.
PCoIP Administrator's Guide Figure 4-10: OSD Discovery Page Table 4-8: Discovery Page Parameters Parameters Description When enabled, the hosts and clients can be dynamically discovered Enable SLP Discovery by SLP management entities without requiring prior knowledge of their locations in the network. When enabled: Hosts and clients can be dynamically discovered by a connection broker discovery method that uses DNS SRV resource records...
PCoIP Administrator's Guide Parameters Description SRV functionality for the PCoIP Management Console, the DNS SRV Discovery Delay is used for the PCoIP Management Console. When DNS SRV records are not installed, we recommend you set the delay to the maximum value of “9999”. This minimizes attempts by the host or client to contact the PCoIP Management Console.
PCoIP Administrator's Guide Direct from Client Host Direct to Host Client Direct to Host + SLP Host Discovery Client View Connection Server Client View Connection Server + Auto-Logon Client View Connection Server + Kiosk Client View Connection Server + Imprivata OneSign Client Connection Management Interface Client/Host...
PCoIP Administrator's Guide 4.7.1 Configuring a Direct Session When you select a direct session connection type from the Session page, specific configuration options appear. Note: The parameters on this page are different for the host and client. If a host is configured to accept any peer, some of the fields on this page become non-editable.
PCoIP Administrator's Guide Figure 4-16: OSD Session Connection Type – Direct to Host Figure 4-17: OSD Session Connection Type – Direct to Host (Advanced Settings) TER0606004 Issue 16...
PCoIP Administrator's Guide Table 4-10: Session Page Parameters Parameters Description Enter the IP address or DNS name for the host. DNS Name or IP Address Note: This setting is only available on the client. When this option if enabled, the host accepts connections from any client.
Page 56
PCoIP Administrator's Guide Parameters Description connected host when a session is lost. Note: This setting is only available for the client. When enabled, the “Network Connection Lost” overlay appears on the display(s) when a loss of network connectivity is detected. It also appears in the case of a virtual desktop such as VMware View.
Page 57
PCoIP Administrator's Guide Parameters Description You have been disconnected because an administrator disconnected you. You have been disconnected because you logged in from another location. You have been disconnected because you disconnected from your workstation. Warning: System-initiated, but expected actions affecting the session.
PCoIP Administrator's Guide Parameters Description 4. Show None – Don’t show any disconnect messages. Note: This setting is only available for the client. 4.7.2 Configuring a Direct Session with SLP Host Discovery If you are connecting a client to a host using SLP discovery, select the Direct to Host + SLP Discovery option in the Session Connection Type field on the Session page.
PCoIP Administrator's Guide Figure 4-19: OSD Session Connection Type – Direct to Host with SLP Host Discovery Figure 4-20: OSD Session Connection Type – Direct to Host with SLP Host Discovery TER0606004 Issue 16...
PCoIP Administrator's Guide (Advanced Settings) Table 4-11: Session Page Parameters Parameters Description Lets the client automatically reconnect with the last connected host when a session is lost. Enable Auto-Reconnect Note: This setting is only available on a client. When enabled, the “Network Connection Lost” overlay appears on the display(s) when a loss of network connectivity is detected.
Page 61
PCoIP Administrator's Guide Parameters Description This field lets you control what type of messages appear when a session is disconnected. There are three categories: Information: User or administrator initiated actions affecting the session. You have been disconnected because you logged in from another location or your host was shut down or restarted.
PCoIP Administrator's Guide Parameters Description 2. Show Error and Warnings Only – This option hides info messages and displays only error and warning messages. 3. Show Error Only – This option hides Info and Warning messages and displays only Error messages. 4.
PCoIP Administrator's Guide Table 4-12: VMware View Page Parameters Parameter Description DNS Name or IP Enter the VMware View Connection server's DNS name or IP Address address. Enter the pool/desktop name used by a zero client when starting a session. Desktop Name to Select Note: This setting is optional.
Page 65
PCoIP Administrator's Guide Parameter Description Read-only Note: You can use the PCoIP Management Console to pre-populate the list of available connection servers. Enable Self Help Link "Enabling the Self Help Link" for details. When enabled, after user credentials are entered, users are automatically connected to their virtual desktop.
Page 66
PCoIP Administrator's Guide Parameter Description Note: VMware View hosts do not support Suite B. Do not select the TLS 1.2 with Suite B-compliant 192-bit elliptic curve option when using a View Connection Server mode to connect. Enable or disable an encryption mode for the host or client. By default, both encryption modes are enabled: AES-128-GCM: An encryption method implemented in the TERA1x100 processor that allows best performance between...
PCoIP Administrator's Guide Parameter Description You have been disconnected due to a configuration error (0x300). Please contact your IT administrator for assistance. You have been disconnected due to a configuration error (0x301). Please contact your IT administrator for assistance. You have been disconnected due to a configuration error (0x302).
Page 68
PCoIP Administrator's Guide Parameter Description Enter the name of the View Connection Server hosting the self-help View Connection Server virtual machine. By default this field is blank, and port 443 is used to communicate with the VMware View Connection server. Port If your network is set up to use a non-standard port for secure connections, enter the port number.
PCoIP Administrator's Guide Figure 4-26: OSD View Connection Server with Auto-Logon Table 4-13: View Connection Server + Auto-Logon Parameters Parameter Description Logon Username Enter the username for the client. Logon Password Enter the password. Logon Domain Name Enter the domain name. 4.7.4 Configuring Kiosk Mode You can configure kiosk mode by selecting the View Connection Server + Kiosk option as...
PCoIP Administrator's Guide Table 4-14: View Connection Server + Kiosk Parameters Parameters Description DNS Name or IP Enter the IP address or DNS name for the kiosk's View Connection Address Server. Select the type of username that matches the naming you use for the devices on the View Connection Server.
Page 74
PCoIP Administrator's Guide Parameters Description message. This option is disabled by default. Note: This option is only available for a zero client. Desktop applications that require the peer loss notification should re-enable the feature through the OSD, Administrative Web Interface, or PCoIP Management Console.
Page 75
PCoIP Administrator's Guide Parameters Description another location. You have been disconnected because you disconnected from your workstation. Warning: System-initiated, but expected actions affecting the session. This occurs when a session is closed remotely (the global timeout value is reached). Error: Unexpected system-initiated actions causing session to fail. The following are Error messages: You have been disconnected.
PCoIP Administrator's Guide 4.7.5 Configuring a View Connection Server + Imprivata OneSign Connection If you want the zero client to authenticate through the Imprivata OneSign system, configure the View Connection Server + Imprivata OneSign option as the Session Connection Type on the Session page. Note: This option is only available on a client.
PCoIP Administrator's Guide Table 4-15: VMware View Page Parameters Parameter Description Bootstrap URL Enter the address of the OneSign Server. This field lets you configure the client to connect to any appliance or only to appliances with verified certificates: OneSign Appliance No verification: Connect to any appliance: Verification Full verification: Only connect to appliances with verified...
Page 79
PCoIP Administrator's Guide Parameter Description display(s) when you log in. This option is disabled by default. Desktop Overlay Note: This overlay provides assurance that login is proceeding if the desktop takes more than a few seconds to appear. Configure the Transport Layer Security (TLS) cipher the client will use to negotiate the TLS session between the PCoIP client and the PCoIP host: TLS 1.0 with RSA keys and AES-256 or AES-128 encryption:...
PCoIP Administrator's Guide Parameter Description The following are Error messages: You have been disconnected. Unable to connect (0x1001). Please contact your IT administrator. Unable to connect (0x1002). Please contact your IT administrator. Session closed remotely. Session closed remotely (unknown cause). You have been disconnected due to a configuration error (0x100).
PCoIP Administrator's Guide communicates with and can remotely control and configure the device. can locate an appropriate peer for the device to connect to and initiate the connection. can simplify the administration effort for large, complex systems. Figure 4-33: AWI Connection Type – Connection Management Interface TER0606004 Issue 16...
PCoIP Administrator's Guide Table 4-16: Connection Management Page Parameters Parameter Description DNS Name or IP Enter the DNS name or IP address of the connection manager. Address When enabled, the “Network Connection Lost” overlay appears on the display(s) when a loss of network connectivity is detected. It also appears in the case of a virtual desktop such as VMware View.
Page 84
PCoIP Administrator's Guide Parameter Description session is disconnected. There are three categories: Information: User or administrator initiated actions affecting the session. You have been disconnected because you logged in from another location or your host was shut down or restarted. You have been disconnected because an administrator disconnected you.
PCoIP Administrator's Guide Parameter Description 2. Show Error and Warnings Only – This option hides info messages and displays only error and warning messages. 3. Show Error Only – This option hides Info and Warning messages and displays only Error messages 4.
PCoIP Administrator's Guide Parameters Description The PCoIP processor only uses the required bandwidth up to the Device Bandwidth Limit maximum. The PCoIP processor dynamically adjusts the bandwidth in response to network congestion. Setting the Device Bandwidth Limit to 0 configures the PCoIP processor to adjust the bandwidth depending on network congestion.
PCoIP Administrator's Guide Figure 4-37: Administrative Web Interface Language Page Figure 4-38: OSD Language Page Table 4-18: Language Page Parameters For a list of supported languages and keyboard layouts, see section Appendix Parameters Description Configure the OSD language. This setting only determines the Language language for the OSD only.
PCoIP Administrator's Guide Parameters Description Change the layout of the keyboard. When the user starts a session, this setting is pushed to the virtual machine. If the PCoIP "Use Keyboard Layout Enhanced Keyboard on Windows Client if available" GPO is set to allow the keyboard layout setting, it is used during the user's session.
PCoIP Administrator's Guide Figure 4-40: OSD-OSD Page Table 4-19: OSD Page Parameters Parameters Description Configure the screen-saver timeout before the client puts the attached displays into low-power mode. You can configure the time- Screen-saver Timeout out mode in seconds, up to 9999 seconds. A setting of 0 seconds dis- ables the screen-saver.
PCoIP Administrator's Guide Figure 4-41: Administrative Web Interface Image Page (Host) Note: When the Use Client Image Settings field is not selected, the text boxes on this page are replaced with sliders, as shown below. Figure 4-42: Administrative Web Interface Image Page (Host) TER0606004 Issue 16...
PCoIP Administrator's Guide Figure 4-44: OSD Image Page Note: In the OSD, this page is available from the Options->User Settings menu. Table 4-20: Image Page Parameters For more details about adjusting the image quality, see section 9.5. Parameter Description This field is only available from the host. (It is not available on the client.) When enabled: The image settings on this page are not editable.
Page 93
PCoIP Administrator's Guide Parameter Description In environments where the network bandwidth is constrained, moving the slider towards Reduced allows higher frame rates. Moving the slider towards Perception-Free allows for higher image quality. When network bandwidth is not constrained, the PCoIP system maintains perception-free quality regardless of the Minimum Image Quality parameter.
PCoIP Administrator's Guide Parameter Description continues to refine the image in the background until it reaches a fully lossless state. Stopping the build process when the image reaches the "perceptually lossless" stage can deliver significant bandwidth savings. If you have any questions about this field setting, contact Teradici Support.
PCoIP Administrator's Guide 4.13 Configuring the NTP Parameters The Time page lets you configure the Network Time Protocol (NTP) parameters to allow the host and client event logs to be time-stamped based on NTP time. Note: If the zero client is configured for DHCP and the DHCP server provides an NTP server address, this address will override any manually configured NTP server.
PCoIP Administrator's Guide Parameter Description choose: IP Address: Shows the NTP Host IP address FQDN: Shows the NTP Host DNS name NTP Host Port Configure the NTP port number. Configure the query interval. The first field is for the interval period NTP Query Interval and the second field is for the time unit in Minute(s), Hour(s), Day(s), and Week(s).
PCoIP Administrator's Guide Figure 4-48: OSD Change Password Page Note: In the OSD, this page is available from the Options->Password menu. Table 4-22: Change Password Page Parameters Parameter Description This field must match the current administrative password before you Old Password can update the password.
PCoIP Administrator's Guide Figure 4-49: Administrative Web Interface Reset Page (Client) Figure 4-50: OSD Reset Page Table 4-23: Reset Parameters Parameter Description When you click this button, a prompt appears for confirmation. This is Reset Parameters to prevent accidental resets. Enable Keyboard When enabled, the user can press the combination of keys to Shortcut...
PCoIP Administrator's Guide Parameter Description Note: This field is only available from the zero client. It is not available from the host. When the Enable Keyboard Shortcut field is enabled, and this field is: Disabled: The keyboard sequence appears on the Reset Hide Keyboard Shortcut Parameters page for the zero client.
PCoIP Administrator's Guide Figure 4-51: OSD Display Page Parameter Description This option is intended for legacy systems. It configures the client to send default EDID information to the host when a monitor cannot be detected or is not attached to the client. In versions of Windows prior to Windows 7, once the host had no EDID information, it would assume no monitors were attached and would never recheck.
PCoIP Administrator's Guide Parameter Description of 1024x768 when this option is enabled. Enable this option when a display is attached but cannot be detected by the system, and you want to specify a preferred resolution for the display. The same default list of resolutions as above will be advertised, except the native resolution you configure here for a display will be sent instead of the default native resolution of 1024x768.
PCoIP Administrator's Guide 4.18 Enabling or Disabling the OSD Configuration Menus You can enable or disable the PCoIP zero client configuration menus through the PCoIP Management Console (you must have release 1.4.x or higher). Disabling the OSD Configuration menu means that to configure the device, you must use the Administrative Web Interface (if enabled) or the PCoIP Management Console.
PCoIP Administrator's Guide 4. Check the Set in Profile option for Enable Web Interface. 5. Set the option to: True: enable the web interface for the device or group of devices. False: disable the web interface for the device or group of devices. 3.
PCoIP Administrator's Guide Setting up the User Permissions The Permissions menu on the Administrative Web Interface has options that let you configure parameters for the USB, Audio, and Power for the device. Note: There are no corresponding Permissions options for the OSD. Specifying USB Devices The USB page lets you specify authorized and unauthorized USB devices.
PCoIP Administrator's Guide Figure 5-1: Administrative Web Interface USB Page Table 5-1: USB Page Parameters Parameter Description Specify the authorized USB devices for the host and client. Two buttons let you customize this "white list": Add New: add a new device or device group to the list. This allows USB authorization by ID or Class: Authorized Devices...
PCoIP Administrator's Guide Parameter Description Remove: Delete a rule for a device or device group from the list. Enable this field to configure EHCI (USB 2.0) for devices connected directly to the zero client USB ports for sessions with a soft host running VMware View 4.6 Enable EHCI or later.
PCoIP Administrator's Guide Figure 5-2: Administrative Web Interface Audio Page (Host) Table 5-3: Audio Page Parameters Parameter Description Enables audio support on host or client. If the Enable HD Audio option is Enable HD Audio disabled on the host, the audio hardware is not available for the operating system to enumerate.
PCoIP Administrator's Guide Figure 5-3: Administrative Web Interface Power Page (Client) Table 5-4: Power Page Parameter Parameter Description The drop-down menu lets you configure the client Power button functionality. Options include: Power-off not permitted Client Power Button Soft power-off only Hard power-off only Soft and hard power-off TER0606004 Issue 16...
PCoIP Administrator's Guide Using the Diagnostic Tools The Diagnostic menu contains links to pages with run-time information and functions that may be useful for troubleshooting. Note: The Diagnostic options in the OSD are a subset of those available through the Administrative Web Interface.
PCoIP Administrator's Guide Parameter Description FQDN: Enter the DNS name for the syslog host Syslog Host Port Lets you configure the syslog port number. The facility is a number attached to every syslog message used to categorize the source of the syslog messages. The facility is part of the standard syslog header and can be interpreted by all syslog servers.
PCoIP Administrator's Guide Figure 6-3: Administrative Web Interface Session Control Page Table 6-2: Session Control Page Parameters Parameter Description This field displays the current state for the session. Options include: Disconnected Connection Pending Connected Two buttons appear below the Connection State field: Connect: If the connection state is Disconnected, click this button to initiate a PCoIP session between the client and its peer Connection State...
PCoIP Administrator's Guide Table 6-3: Session Statistics Page Parameters Parameters Description The current (or last) state of the PCoIP session. Values include: Asleep Canceling Connection State Connected Connection Pending Disconnected Waking 802.1X Authentication Identify if 802.1X authentication is enabled or disabled on the device. Status PCoIP Packets Sent: The total number of PCoIP packets sent in the current/last session.
PCoIP Administrator's Guide Parameters Description This setting is taken from the Image Quality Preference field on the Image Quality Image page. The value determines if the image is set to a smoother Preference versus a sharper image. Options that may appear in this field include: Enabled: The Disable Build to Lossless field on the Image page is Build to Lossless unchecked.
PCoIP Administrator's Guide Figure 6-7: Administrative Web Interface Host CPU Page Table 6-4: Host CPU Page Parameters Parameters Description Host Identity The identity string of the host computer (if data is available). Current Power State The current state of the power for the host (e.g., "on"). Power off the host as: S5 (Soft Off) Change Power State...
PCoIP Administrator's Guide Figure 6-8: Administrative Web Interface Audio Diagnostics Page Viewing a Test Pattern on the Client's Display The Display page lets you initiate and view a test pattern on the client's display. Note: The test pattern only appears on the Display page when the client is not in a PCoIP session.
PCoIP Administrator's Guide Parameters Description Set the test pattern resolution as: 1024x768 Test resolution 1280x1024 1600x1200 1920x1200 Start/Stop Click Start to begin the test pattern. Click Stop to stop the test. Resetting the Device Processor The PCoIP Processor page lets you reset the host or client and view the uptime of the client PCoIP processor since the last boot.
PCoIP Administrator's Guide Figure 6-11: OSD PCoIP Processor Page Table 6-6: PCoIP Processor Page Statistics Statistics Description The current time. This feature requires that NTP be enabled and Current Time configured. For details about configuring the NTP settings, see section 4.13. Time Since Boot View the uptime of the PCoIP processor since the last boot.
PCoIP Administrator's Guide Figure 6-12: OSD Ping Page Table 6-7: Ping Page Parameters Parameter Description Destination IP address or FQDN to ping Interval Interval between ping packets Packet Size Size of the ping packet Packets Sent Number of ping packets transmitted Packets Received Number of ping packets received TER0606004 Issue 16...
PCoIP Administrator's Guide Viewing Device Information The Information page lets you see details about the device. The Administrative Web Interface shows version, VPD, and attached device information. The OSD lets you view the device version information. Viewing the Version Information The Version page lets you view the hardware and firmware version details for a device.
PCoIP Administrator's Guide Figure 7-2: OSD Version Page Table 7-1: OSD Version Page Parameters Parameters Description (Vital Product Data): Information provisioned by the factory to uniquely identify each host or client: MAC Address: Host/client unique MAC address Unique Identifier: Host/client unique identifier VPD Information Serial Number: Host/client unique serial number Firmware Part Number: Part number of the current firmware...
PCoIP Administrator's Guide Viewing the Attached Devices The Attached Devices page lets you see the type and status of the monitor and USB hardware currently attached to the client. Figure 7-3: Administrative Web Interface Attached Devices Page (Host) Note: The attached USB device information is only available on a client. It is not available on a host.
PCoIP Administrator's Guide Figure 7-4: Administrative Web Interface Attached Devices Page (Client) Table 7-2: Attached Devices Page Statistics Statistic Description This section displays the model, status, mode, resolution, serial number, vendor identification (VID), product identification (PID), and date of the monitor attached to each port. The first line is for monitor Displays 1.
Page 127
PCoIP Administrator's Guide Statistic Description Connected: The device is detected and authorized in a PCoIP session. TER0606004 Issue 16...
PCoIP Administrator's Guide Uploading to the Device You can use the options in this menu to upload new firmware, an OSD logo to a device, or to manage your certificates. These options are not available through the OSD. Uploading Firmware to the Device The Firmware page lets you upload a new firmware build to the host or client.
PCoIP Administrator's Guide 6. Click OK to confirm that you want to proceed with the upload. When the firmware upload completes, the message "Success Flash successfully programmed! You must reset the device for the changes to take effect" appears. 7. Click Reset. The message “The PCoIP processor will reset on the next host system restart;...
PCoIP Administrator's Guide 8.2.1 OSD Logo Upload Process Example 1. From the OSD Logo webpage, click Browse to locate the target logo file. 2. Click Open. 3. Click Upload. The message "Are you sure? This will upload a new logo for the local GUI.
PCoIP Administrator's Guide 8.3.1 Uploading Certificates for 802.1X Authentication The following are some general guidelines when using 802.1X authentication. For detailed information, see Knowledge Base support topic 15134-1063 on the Teradici support site. 802.1X authentication requires two certificates—an 802.1X client certificate and an 802.1X server CA root certificate.
PCoIP Administrator's Guide Configuring the User Settings The User Settings page lets you access tabs to: Determine how the client behaves if it cannot verify that a connection to the server is secure. Define the mouse and keyboard settings. Set the preferred PCoIP protocol image quality. Configure the display topology.
PCoIP Administrator's Guide Table 9-1: VMware View Page Parameters Parameter Description Reject the unver- Configure the client to reject the connection if a trusted, valid certificate is ifiable connection not installed. Warn if the Configure the client to display a warning if an unsigned or expired connection may be certificate is encountered, or when the certificate is not self-signed and insecure...
PCoIP Administrator's Guide Table 9-2: Mouse Page Parameters Parameter Description Configure the speed of the mouse cursor. Note: You can also configure the mouse speed through the PCoIP host Mouse Speed software. See the PCoIP Host Software for Windows User Guide (TER0810001) for more details.
PCoIP Administrator's Guide Table 9-3: Keyboard Page Parameters Parameter Description Keyboard Repeat Lets users configure the client keyboard repeat delay. Delay Keyboard Repeat Lets users configure the client keyboard repeat rate. Rate Repeat Settings Test Lets users test the chosen keyboard settings. Adjusting the Image Quality from the OSD For more information about adjusting the image quality, see section 4.11.
PCoIP Administrator's Guide To apply the display topology feature to a PCoIP session between a zero client and a PCoIP host, you must have the PCoIP host software installed on the host. See the PCoIP Host Software for Windows User Guide (TER0810001) for details. Notes: The Display Topology tab has no corresponding menu in the Administration Web Interface.
Page 137
PCoIP Administrator's Guide Parameter Description are applied when the device is reset. Select whether you want a horizontal or vertical layout for your displays (A and B). This setting should reflect the physical layout of the displays on your desk. Horizontal: Select to arrange A and B horizontally, with A located to Display Layout the left of B.
PCoIP Administrator's Guide Parameter Description Position Specify which display is physically connected to Port 1 and Port 2. Configure the rotation of the display in Port 1 and Port 2: No rotation Rotation 90° clockwise 180° rotation 90° counter-clockwise The display resolution can be configured for a PCoIP session between a virtual machine or host and a zero client.
PCoIP Administrator's Guide Table 9-5: OSD Touch Screen Page Parameters Parameter Description Select this checkbox to let users generate a right-click when they Enable right click on hold touch the screen and hold it for a few seconds. If disabled, right-click- ing is not supported.
PCoIP Administrator's Guide 1. Follow the steps in the previous procedure to install the touch screen to your zero client. 2. Log into the Administrative Web Interface for the zero client. 3. From the Info menu, click Attached Devices. 4. The touch screen details should appear in this page. Write down the PID and the VID information.
Page 141
PCoIP Administrator's Guide 1. Log into the Administrative Web Interface. 2. From the Configuration menu, select Session. 3. In the Session Connection Type drop-down list, select View Connection Server + Auto-Logon. 4. Enter the VMware View Connection server's DNS name or IP address. 5.
PCoIP Administrator's Guide About the Overlay Windows Overlay pages display pertinent information to users during a PCoIP session. These pages occasionally appear on top of the user's remote session. Status overlay pages show network, USB device, and monitor statuses as icons and text. The overlays have simple animation and appear when the status changes (that is, the network connection is lost or an unauthorized USB device is plugged in).
PCoIP Administrator's Guide 10.3 USB Device Not Authorized Overlay If an unauthorized USB device is connected, an overlay appears with the message "USB device not authorized". The overlay lasts for approximately five seconds. Figure 10-3: USB Device Not Authorized Overlay 10.4 USB Over Current Notice Overlay If the USB devices connected to the client cannot be handled by the USB ports, an overlay appears with the message "USB over current notice".
PCoIP Administrator's Guide not supported". Figure 10-6: Resolution Not Supported Overlay 10.7 Half Duplex Overlay PCoIP technology is not compatible with half-duplex network connections. When a half- duplex connection is detected, and overlay appears with the message "Half-duplex network connection". Figure 10-7: Half Duplex Overlay 10.8 Video Source Overlays Improper connection of the host video source is denoted by two possible overlays.
PCoIP Administrator's Guide Using Smart Cards with PCoIP Zero Clients Firmware 3.2.0 and higher provides pre-session and in-session smart-card support for PCoIP zero clients connecting to VMware View 4.5 or later virtual desktops. Note: Before using smart cards with PCoIP zero clients, be sure that the smart card infrastructure is properly deployed.
PCoIP Administrator's Guide HID Omnikey 5321 Gemalto PC USB-SW 11.1.3 CAC Smart Card Properties For smart card authentication and SSO, the smart card must meet one of these specifications: GSC-IS v2.0 and v2.1 cards (firmware 3.2.0 or later) PIV transitional cards (firmware 3.4.0 or later) PIV endpoint cards (firmware 3.4.0 or later) 11.1.4 .Net Smart Card Properties For smart card authentication and SSO, the smart card must be a Gemalto .Net card...
PCoIP Administrator's Guide Smart Card Model Tested for Firmware Release (or later) application Oberthur ID-One Cosmo v7.0 with Oberthur PIV Applet 3.4.0 Suite 2.3.2 Oberthur ID-One Cosmo v7.0 128K 3.4.0 Note: Other smart card models may be supported. For the most up-to-date list, see Knowledge Base item #15134-299 from the Teradici Support Site.
PCoIP Administrator's Guide If the smart card contains multiple certificates, the “Select Certificate” prompt appears. If the smart card contains only one certificate, this prompt does not appear and the certificate is automatically selected. Figure 11-2: Select Certificate Prompt 2. Click Details. The following window appears with the certificate details: Figure 11-3: Certificate Details Window 3.
PCoIP Administrator's Guide Figure 11-4: Smart Card Holder Verification Window 4. When the PIN is successfully authenticated, a window appears that lists VM(s) or VM pool(s) entitled to the user. Select the VM or VM pool to which you want to connect. A PCoIP session is established to the virtual machine, and the PIN is automatically transferred to Windows for SSO.
PCoIP Administrator's Guide Appendix A: Usage Examples Overview This section provides detailed examples to help you determine how best to configure your devices. A.1 Peer-to-Peer Direct Connection Example This example provides an overview of how to configure a client and host for a direct connection.
PCoIP Administrator's Guide 5. From the DNS Name or IP Address field, enter the IP address for the host. (For example, 192.168.42.76.) 6. Click Apply to accept the changes. A.1.2 Configuring the Host Peer-to-Peer Operation To configure the host for peer-to-peer connection: 1.
PCoIP Administrator's Guide 4. From the Session Connection Type field, select Direct from Client. 5. Set the Accept Any Peer box: Enable: Allow all zero clients to connect to the host Disable: Allow only one zero client access to the host. Enter the client MAC address in the Peer MAC Address field.
PCoIP Administrator's Guide A.2 DHCP and Enable Host Discovery Example This example describes how to configure the client and host for use with a DHCP server and the Host Discovery feature without the use of a Connection Management Server. The following starting IP addresses are used for this example: Client: IP Address: 192.168.0.111 Host: IP Address: 192.168.1.222 Note: To configure for DHCP and Host Discovery, you must know the IP address of the...
Page 155
PCoIP Administrator's Guide 8. Enable the Enable SLP Discovery box. 9. Click Apply to accept the changes. 10. Click Continue to complete the configuration. 11. From the Configuration menu, select the Network page. TER0606004 Issue 16...
PCoIP Administrator's Guide Figure 12-2: Client Network Page DHCP Configuration 12. Enable the Enable DHCP box. 13. Click Apply to accept the changes. Note: Once configured for DHCP, the IP address is leased from the DHCP server. For future configuration, get the IP address from the DHCP server. 14.
PCoIP Administrator's Guide 8. Select Enable DHCP. 9. Click Apply to accept the changes. Note: Once configured for DHCP, the IP address is leased from the DHCP server. For future configuration, get the IP address from the DHCP server. 10. Click Reset to reset the PCoIP processor. Note: The host does not reset immediately.
PCoIP Administrator's Guide 1. Open the USB Permissions page. 2. In the Authorization section, click Add new. 3. When the entry fields expand, select Class from the Add New drop-down menu to authorize a class of devices. 4. Select Printer from the Device Class drop-down menu to authorize a class of printers. 5.
PCoIP Administrator's Guide Figure 12-5: USB Permissions Example: Entering Vendor ID and Product ID 4. Click Apply to save the changes to flash and complete the configuration. Figure 12-6: USB Permissions Example: Vendor ID and Product ID Authorization TER0606004 Issue 16...
PCoIP Administrator's Guide Appendix B: Client Language and Keyboard Support The client firmware can support various languages and keyboard layouts. B.1 Languages Supported by the Client English (default) French German Greek Spanish Italian Portuguese Korean Japanese Traditional Chinese Simplified Chinese Keyboard Layouts Supported by the Client Belgian ISO-8895-1 Belgian ISO-8859-1 (accent keys)
Page 162
PCoIP Administrator's Guide Hungarian Italian ISO-8859-1 Japanese 106/109 Japanese 106x (ctrl and shift swapped) Korean Dubeolsik ISO-8859-1 Latin American Latin American (accent keys) Latvian (QWERTY) Lithuanian Norwegian Dvorak Norwegian ISO-8859-1 Norwegian ISO-8859-1 (accent keys) Polish ISO-8859-2 (Programmers) Portuguese ISO-8859-1 Portuguese ISO-8859-1 (accent keys) Romanian Russian Serbian (Cyrillic)
Page 163
PCoIP Administrator's Guide United States of America Emacs optimized layout United States of America ISO-8859-1 United States of America ISO-8859-1 (accent keys) United States of America ISO-8859-1 (ctrl and caps swapped) United States of America left-hand Dvorak United States of America right-hand Dvorak United States of America traditional Unix workstation TER0606004 Issue 16...