OSD Tera2: PCoIP Connection Manager Session Settings

Select the PCoIP Connection Manager session connection type from the Options > Configuration > Session page to configure the client to use a PCoIP Connection Manager as the PCoIP session broker.

Click the Advanced button to configure advanced settings for this option.

OSD Session Connection Type – PCoIP Connection Manager

Advanced Settings

OSD 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.

Auto Connect

This field determines the client's auto connect behavior after startup:

  • Enabled: The client automatically connects with the connection server after startup and a PCoIP session ends, bypassing the OSD Connect page.
  • Disabled: The client does not automatically connect with the connection server.
  • Enabled With Retry On Error: The client will continuously attempt to contact the connection server. After a connection failure, the client waits before attempting to connect again. This wait time increases with each successive failure. The wait interval is not configurable.

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.

Remember Username

When enabled, the username text box automatically populates with the last username entered.

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.

Use OSD Logo for Login Banner

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.

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:

  • 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.
  • 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:

  • You have been disconnected because your session timed out.

Error: Unexpected system-initiated actions causing session to fail:

  • 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). Please contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x201). Please contact your IT administrator for assistance.
  • 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). Please contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x303). Please contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x305). Please contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x400). Please contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x401). Please contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x402). Please contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x403). Please contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x404). Please contact your IT administrator for assistance.

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:

  1. Show All messages – This option shows all disconnect messages including Info, Warning, and Error messages.
  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. Show None – Don’t show any disconnect messages.

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.