Establishing a PCoIP Session

Prerequisites

Before you begin, gather the following host desktop details:

• IP address
• Port number
• Session ID
• Server name indication (SNI)
• Connection tag

This information can then be passed to the provided in-session client to establish a PCoIP session programmatically. See the example code for specific call syntax.

Establishing a PCoIP session from the Command-line

In terms of programming interface, there are two ways that the connection and security information can be presented to pcoip-client:

Pass the pieces of information individually to the executable. The following command invokes pcoip-client to establish a PCoIP session and passes the connection and session information as parameters, where:

• Connection tag:

  SCS1WsopFJ3iz1l48PTJMXFkcD4b6M9aiakHXH3ellLhUROBceWAifSSn%2b4AV1FC
  8IihWVmsISmYFKeA25AtzFrdMpdaCtqlic0zfxAA
  

• IP address: 10.64.60.115

• Log ID: a1ff3a80-8801-1038-19bd-0005680aded

• Session ID: 2305843009213693961

    ```xml
    pcoip-client -i connect-tag=
    SCS1WsopFJ3iz1l48PTJMXFkcD4b6M9aiakHXH3ellLhUROBceWAifSSn%2b4AV1FC
    8IihWVmsISmYFKeA25AtzFrdMpdaCtqlic0zfxAA address=10.64.60.115
    session-id=2305843009213693961
    log-id=a1ff3a80-8801-1038-a9bd-00505680aded
    ```
  

Encode all information into a string container (URI) and then pass to the executable. The following command invokes pcoip-client to establish a PCoIP session and passes the connection tag as a parameter and a URI encapsulating the IP address and Session ID in a string container, where:

• Connection tag: xml SCS1WsopFJ3iz1l48PTJMXFkcD4b6M9aiakHXH3ellLhUROBceWAifSSn%2b4AV1FC 8IihWVmsISmYFKeA25AtzFrdMpdaCtqlic0zfxAA
• URI: "teradici-pcoip://10.64.60.115:4172?session-id=230584300921369396"

'pcoip-client "connect-tag=SCS1WsopFJ3iz1l48PTJMXFkcD4b6M9aiakHXH3ellLhUROBceWAifSSn%2b4AV1FC8IihWVmsISmYFKeA25AtzFrdMpdaCtqlic0zfxAA" "teradici-pcoip://10.64.60.115:4172?session-id=230584300921369396"