Select the PCoIP Connection Manager session connection type from the Configuration > Session page to configure the client to use a PCoIP Connection Manager as the PCoIP session broker.
AWI Session Connection Type – PCoIP Connection Manager
AWI Session Page Parameters
Parameter | Description |
---|---|
Server URI |
Enter the Uniform Resource Identifier (URI) for the PCoIP Connection Manager. Note: The URI must be in the form "https://<hostname|IP address>". |
Desktop Name to Select |
Enter the desktop name used by the client when starting a session. Note: This field is case-insensitive. |
Certificate Check Mode |
Select the level of verification performed on the certificate presented by the connection server:
|
When enabled, prevents users from changing the Certificate Check Mode settings from the OSD or AWI. |
|
Auto Connect |
This field determines the client's auto connect behavior after startup:
Note: Devices running firmware 4.1.1 or lower do not support Retry On Error behavior and will always perform a single attempt to contact the connection server when this option is selected. Note: After enabling Auto Connect, the client must be power-cycled for the change to take effect. |
Connection Server Cache Mode |
This field determines whether a connection server is dynamically added to the Server drop-down menu on the OSD Connect page when a user types in a valid server URI, or whether it appears in a read-only list for the user to select.
Note: You can use the PCoIP Management Console to pre-populate the list of available connection servers. |
Enable Self Help Link |
See Enabling the Self Help Link for details. |
Auto Launch If Only One Desktop |
When enabled, users are automatically connected to a provisioned desktop after user credentials are entered. Note: This feature only applies to users who are entitled to a single desktop. It does not apply to users entitled to multiple virtual desktops. |
Remember Username |
When enabled, the username text box automatically populates with the last username entered. |
When enabled, the OSD logo banner appears at the top of login screens in place of the default banner. You can upload an OSD logo from the OSD Logo Upload page. |
|
Enable Peer Loss Overlay |
When enabled, the “Network Connection Lost” overlay appears on the display(s) when a loss of network connectivity is detected. Normal hypervisor scheduling delays can falsely trigger this message. 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, AWI, or MC. |
Enable Preparing Desktop Overlay |
When enabled, the "Preparing Desktop" overlay appears on the display(s) when users log in. Note: This overlay provides assurance that login is proceeding if the desktop takes more than a few seconds to appear. |
Enable Session Disconnect Hotkey |
When enabled, users can press the Ctrl+Alt+F12 hotkey sequence to pop up the "Zero Client Control Panel" overlay, which lets them disconnect the current session on the workstation or power off the workstation. Note: Before users can use this disconnect hotkey sequence, certain other configuration options must be in place. See Disconnecting from a Session for details. |
PCoIP Utility Bar Mode (Tera2 zero clients only) |
When enabled, the PCoIP Utility Bar appears at the top of the primary display when a user is in session and moves the cursor directly under the bar. The utility bar can be used to disconnect a session or to shut down a remote workstation. For Direct to Host session connection types, Local Cursor and Keyboard must be enabled in order for the zero client to process mouse events for the utility bar. For all connection types, the mouse must be locally connected (i.e., not bridged).
Note: This feature is configurable from the MC and AWI only. It requires firmware version 4.2.0 or newer. |
Session Negotiation Cipher |
Important: In release 4.8.0, the security cipher features listed below are supported on Tera2 zero clients only. In order to use a non-SHA-1 cipher, both the client and host endpoints must support it. Note: For sessions with software hosts, the zero client should be configured to use the Maximum Compatibility option. For Tera2 zero clients: Configure the Transport Layer Security (TLS) cipher to use for negotiating the TLS session between the PCoIP client and the PCoIP host.
For Tera1 zero clients: Configure the Transport Layer Security (TLS) cipher to use for negotiating the TLS session between the PCoIP client and the PCoIP host.
|
Enabled Session Ciphers |
Enable or disable an encryption mode for the device. By default, all encryption modes that pertain to a device are enabled.
Note: For more information about connecting to VMware Horizon virtual desktops, see “Using PCoIP® Zero Clients with VMware View User Guide” (TER0904005) in the Teradici Support Documentation Center. Note: The enabled encryption mode must match between the host and client for a session to be established. If more than one mode is enabled, the firmware selects the following:
|
Disconnect Message Filter |
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:
Warning: System-initiated, but expected actions affecting the session:
Error: Unexpected system-initiated actions causing session to fail:
Note: For detailed information about the above session disconnect codes, please see KB 15134-872 in the Teradici Support Site. You can choose to display:
|
Enable DSCP |
When enabled, the device populates the Differentiated Services Code Point (DSCP) field in the IP header, allowing intermediate network nodes to prioritize PCoIP traffic accordingly. |
Enable Transport Congestion Notification |
When enabled, transport congestion notification is enabled to allow PCoIP endpoints to react accordingly if an intermediate network node sets the congestion notification bit in either the IP header or PCoIP transport header. Note: For more information about the PCoIP transport header, see PCoIP Packet Format. |
Organization ID |
Enter an organization ID for the company (e.g., "mycompany.com"). This field accepts any UTF-8 character. Note: You only need to specify this parameter if the PCoIP Connection Manager requests it. The organization ID is used for certain types of PCoIP Broker Protocol authentication messages. |
The Self Help Link option lets you configure a self-help link that will appear on the OSD Connect window. When users click this link, they are automatically connected to a specific desktop that can be used as a corporate resource—for example, a desktop containing IT help information. After enabling this option, you then configure all the necessary details to automatically log users in to the desktop that you specify. You also configure the link text that you want to appear on the Connect window.
Enable Self Help Link Options
When you enable this field, the following options appear:
Parameter | Description |
---|---|
Connection Server |
Enter the fully-qualified domain name of the connection server brokering the desktop (e.g., a PCoIP Connection Manager for a PCoIP Connection Manager session connection type, or a View Connection Server for a View Connection Server session connection type). |
Port |
By default, port 443 is used to communicate with the connection server. If your network is set up to use a non-standard port for secure connections, enter the port number. |
Username |
To password protect the self-help desktop, enter a username in this field. |
Password |
To password protect the self-help desktop, enter a password in this field. |
Domain |
Enter the domain name for the self-help desktop (e.g., mycompany.com). |
Pool Name to Select |
Enter the pool or desktop name for the self-help desktop. Note: This field is case-insensitive. For Tera1 zero clients, this parameter is called Desktop Name to Select. |
Link Text |
Enter the text that you want to appear as hyperlinked text on the Connect window. |