AWI: Direct to Host Session Settings

Select the Direct to Host session connection type from the Configuration > Session page to configure the client to connect directly to a Remote Workstation Card.

Alt text
AWI Session connection type – Direct to Host

The following parameters can be found on the AWI Direct to Host page.

AWI Direct to Host Parameters

Parameters Description
DNS Name or IP Address Enter the IP address or DNS name for the Remote Workstation Card.
Wake Host from Low Power State Select whether to use the PCoIP Remote Workstation Card’s MAC and IP address or a custom MAC and IP address when configuring the Wake-On-LAN feature on a client. This feature wakes up the host when the user presses the client’s power button, a key on the keyboard, or clicks the Connect button on the Connect window.
  • Wake-On-LAN Enabled + Peer Address: After you have successfully connected to the PCoIP Remote Workstation Card, both the card’s MAC address and IP address are automatically populated in the Host Wake MAC Address and Host Wake IP Address fields.
  • Wake-On-LAN Enabled + Custom Address: When selected, enables you to manually enter the MAC address and IP address of the device you want to wake up.

    If the Remote Workstation Card Software is installed in the host PC and the Use host PC NIC for Wake-on-LAN setting is enabled in the Features > Power Management section of the Remote Workstation Card Software GUI, the MAC address and IP address of the host PC’s network interface card (NIC) will automatically be populated in the Host Wake MAC Address and Host Wake IP Address fields.
The hardware host must be able to support waking from low power state (off/hibernate/sleep) when it receives a wake-on-LAN packet.

You can disable the Wake-On-LAN feature from the AWI Power page.
Host Wake MAC Address Enter the host’s MAC address to complete the host wake up configuration when Wake-On-LAN Enabled + Custom Address is selected.
When Wake-On-LAN Enabled + Peer Address is selected, the host’s MAC address is populated after a successful connection. The client will send a 'magic packet' to the MAC address to wake the host computer from a low power state.
Host Wake IP Address Enter the host’s IP address to complete the host wake up configuration when Wake-On-LAN Enabled + Custom Address is selected. The client will send a 'magic packet' to this IP address to wake the host computer from a low power state.
Enable Auto-Reconnect When enabled, lets the client automatically reconnect with the last connected host when a session is lost.
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.
Enable Preparing Desktop Overlay When a user first logs into a PCoIP session, this overlay appears with the message: Preparing desktop...
Enable Session Disconnect Hotkey When enabled, users can press the Ctrl+Alt+F12 hotkey sequence to quickly disconnect a PCoIP session. See Disconnecting from a Session for details.
PCoIP Utility Bar Mode 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 Tera2 PCoIP Zero Client to process mouse events for the utility bar. For all connection types, the mouse must be locally connected (that is, not bridged).
  • Disabled: Disables the PCoIP Utility Bar. By default, the utility bar is disabled.
  • Enabled: Enables and auto-hides the PCoIP Utility Bar. Users can show the utility bar by pointing the mouse at the top of the screen directly under the utility bar. Users can slide the utility bar to the right and left at the top of the screen.
  • Enabled and Pinned: Enables and pins the PCoIP Utility Bar at the top of the screen. Users cannot hide the utility bar, but they can slide it to the right and left at the top of the screen.
This feature is configurable from the PCoIP Management Console and AWI only. It requires firmware version 4.2.0 or higher.
Session Negotiation Cipher Suites Configure the Transport Layer Security (TLS) cipher to use for negotiating the TLS session between the PCoIP client and the PCoIP host.
  • Maximum Compatibility: TLS 1.2 or higher with 112-bit or higher elliptic curve encryption: This option provides maximum compatibility.
  • Suite B: TLS 1.2 with Suite B-compliant 192-bit elliptic curve encryption. This option provides a higher level of security.
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). Contact your IT administrator.
  • Unable to connect (0x1002). Contact your IT administrator.
  • Session closed remotely.
  • Session closed remotely (unknown cause).
  • You have been disconnected due to a configuration error (0x100). Contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x201). Contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x300). Contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x301). Contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x302). Contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x303). Contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x305). Contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x400). Contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x401). Contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x402). Contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x403). Contact your IT administrator for assistance.
  • You have been disconnected due to a configuration error (0x404). Contact your IT administrator for assistance.
For detailed information about the session disconnect codes, see What do the PCoIP server log disconnect codes mean? (KB 1094).

You can choose to display:
  • Show All – This option shows all disconnect messages including Info, Warning, and Error messages.
  • Error and Warnings Only – This option hides info messages and displays only Error and Warning messages.
  • Show Eror Only - This option hides Info and Warning messages and displays only Error messages.
  • Show None – Don’t show any disconnect messages.
Enable DSCP When enabled, the device populates the Differentiated Services Code Point (DSCP) field in the IP header, enabling intermediate network nodes to prioritize PCoIP traffic accordingly.
Enable Congestion Notification When enabled, transport congestion notification is enabled to enable PCoIP endpoints to react accordingly if an intermediate network node sets the congestion notification bit in either the IP header or PCoIP transport header. For more information about the PCoIP transport header, see PCoIP Packet Format.