Administration Guide for Cisco Virtualization Experience Client 2111/2211 PCoIP Firmware Release 4.0
Administrative Web Interface
Downloads: This chapterpdf (PDF - 1.38MB) The complete bookPDF (PDF - 7.37MB) | Feedback

Administrative Web Interface

Administrative Web Interface

The PCoIP Administrative Web Interface lets you interact remotely with the device using an Internet browser.

Page layout

The following graphic shows an example of the Administrative Web Interface page for a client. Most pages have seven basic regions:

  • Log Out—Log out of the Administrative Web Interface
  • PCoIP Zero Client—Displays Cisco VXC PCoIP endpoint information
  • Home—Click to navigate to the Home web page
  • Drop-down menus—The toolbar at the top part of the page lets you easily find pages through its menus: Configuration, Permissions, Diagnostics, Info, and Upload
  • Web page information—Displays the title and summary of the current web page
  • Data field—A configurable or read-only parameter (inline help appears when appropriate)
  • Apply/Cancel—Each web page that includes editable parameters has two buttons:
    • Apply—Store the edited parameters in flash
    • Cancel—Reset the edited parameters to the values currently stored in flash
Figure 1. Administrative Web Interface page



Supported web browsers

The web page servers are compatible with the following web browsers:

  • Firefox 8.0 or earlier
  • Internet Explorer 6.0, 7.0, and 8.0

Note


Other browsers may also be compatible.


We strongly recommend you install the CA root certificate in the browser you use to avoid warning messages from appearing when you log in to the Administrative Web Interface (see Installing the CA Root Certificate).

Access Administrative Web Interface

To access the Administrative Web Interface:

Procedure
    Step 1   From an Internet browser, enter the IP address of the client you want to configure. The IP address used depends on how the IP addresses are determined within your IP network:

    Static IP Address: the IP address is hard-coded and must be known

    Dynamic IP Address: the IP address is dynamically assigned by the Dynamic Host Configuration Protocol (DHCP) server and can be obtained from the DHCP server

    Note   

    You can view the zero client IP address from the OSD by choosing Options > Configuration > Network. You can also view the IP address after you connect to the client through the Administrative Web Interface by choosing Configuration > Network.

    Step 2   Enter the IP address into the browser (for example, https://192.168.1.123).
    Note   

    Some networks using DHCP may be able to also access the Administrative Web Interface using the PCoIP Device Name. See Custom information configuration for more information.


    Administrative Web Interface security

    The Administrative Web Interface uses HTTP over an SSL socket (HTTPS). You cannot access it without an administrative password. The HTTPS connection is secured using a Teradici self-signed certificate.


    Note


    Some PCoIP devices have password protection disabled and do not require a password to log in.


    CA root certificate installation

    You can install a Certificate Authority (CA) root certificate in the Internet Explorer or Mozilla Firefox browser to avoid the browser security warnings. The certificate file ("cacert.pem") is part of the firmware release.

    Steps for installing the certificate on Internet Explorer 7 and Firefox are described in the following sections.

    Install the CA root certificate in Internet Explorer

    Procedure
      Step 1   Open the Tools menu and select Internet Options.
      Step 2   Click on the Content tab, and select Certificates.
      Step 3   On the Trusted Root Certification Authorities tab, select Import.
      Step 4   Follow the on-screen directions to import the certificate. The certificate file is part of the firmware release. The file is called cacert.pem. Ensure you use the Trusted Root Certification Authorities certificate store.

      Install the CA root certificate in Firefox

      Procedure
        Step 1   Open the Tools menu and select Options.
        Step 2   Select the Advanced icon at the top of the page.
        Step 3   On the Encryption tab, select View Certificates.
        Step 4   On the Authorities tab, select Import.
        Step 5   Follow the on-screen directions to import the certificate. The certificate file is part of the firmware release. The file is called cacert.pem. Check the option labeled Trust this CA to identify web sites.

        Log in

        Procedure
          Step 1   From the Log In page, enter your password. The default value is blank (“”).

          Step 2   To change the time after which the device is automatically logged out, set the Idle Timeout field to one of the following values:
          • 1 minute
          • 5 minutes
          • 15 minutes
          • 30 minutes
          • Never
          Step 3   Click Log In.

          When you first log in to a device, the home page appears. It provides an overview of the device status. If configured in the firmware defaults, the Initial Setup page optionally appears the first time you log in.

          Note   

          Some PCoIP devices have password protection disabled by default and do not require a password to login.

          If a warning message appears when you try to log in, a session is already in progress on that device. Only one user can log in to a device at one time. Logging in to a session already in progress terminates that session.

          See Updating the Password for a Device for information on changing the password.


          Home page display

          The home page displays a summary of the client. The first time you log into the Administrative Web Interface, the Initial Setup page appears. The home page appears for each subsequent session. To display it, click the Home link at the top left section of the menu bar.


          Note


          When you click the Reset Statistics button, the statistics reported in the home page are also reset. For details about resetting the statistics, see PCoIP protocol statistics display.


          Figure 2. Home Page



          The information fields shown on the home page are summarized in the following table.

          Table 1 Home Page Parameters
          Parameter Comments
          Processor PCoIP processor type, version, and RAM size.
          Time since boot Length of time that the PCoIP processor has been running (see Device processor reset).
          PCoIP Device Name The logical name for the device. This field is the name the client registers with the DNS server if:
          • DHCP is enabled
          • the system is configured to support registering the hostname with the DNS server
          Connection State Possible states: Disconnected, Connection Pending, Connected (see PCoIP protocol statistics display).
          802.1X Authentication Status Identify if the 802.1X authentication is enabled or disabled on the device.
          Session Encryption Type The type of encryption in use when a session is active:
          • AES-128-GCM
          • SALSA20-256-Round 12
          PCoIP Packets
          • Packets sent
          • Packets received
          • Packets lost
          (see PCoIP protocol statistics display)
          Bytes
          • Bytes sent
          • Bytes received
          (see PCoIP protocol statistics display)
          Round Trip Latency Approximate network minimum, average, and maximum round trip latency; for example, client to virtual machine and back to client (see PCoIP protocol statistics display).
          Transmit Bandwidth Minimum, average, maximum, and active limit for traffic transmitted (see PCoIP protocol statistics display).
          Receive Bandwidth Minimum, average, and maximum traffic received (see PCoIP protocol statistics display).
          Pipeline Processing rate How much image data is currently being processed by the image engine (in megapixels per second).
          Endpoint Image Settings In Use Displays whether the image settings being used are configured within the client or within the host (see Image quality configuration).
          Initial Image Quality The maximum and minimum quality setting is taken from the Image page for the device (see Image quality configuration).
          Image Quality Preference This setting is taken from the Image Quality Preference field on the Image page. The value determines if the image is set to a smoother versus a sharper image (see Image quality configuration).
          Build to Lossless Options that may appear in this field include:
          • Enabled: The Disable Build to Lossless field on the Image page is disabled.
          • Disabled: The Disable Build to Lossless field is enabled.
          See Image quality configuration.
          Display The port number for the display.
          Maximum Rate This column shows the refresh rate of the attached display. If the Maximum Rate field on the Image page is set to:
          • 0 (no limit): The maximum rate is taken from the monitor's refresh rate.
          • A value greater than 0: The refresh rate shows as "User Defined".
          See Image quality configuration.
          Output Process Rate The frame rate currently being sent from the image engine on the virtual machine to the client.
          Image Quality Shows the current lossless state of the attached display:
          • Lossy
          • Perceptually lossless
          • Lossless
          See Image quality configuration.

          Administrative Web Interface menus

          The Administrative Web Interface has five menus that link to the various configuration and status pages.

          • Configuration: The items on this menu let you configure the various aspects for the device, such as network settings, language, session parameters, and so on.
          • Permissions: The items on this menu let you set up the client permissions for the USB, audio, and power.
          • Diagnostics: The items on this menu help you troubleshoot the device.
          • Info: The items on this menu let you view firmware information and the devices currently attached to the device.
          • Upload: The items on this menu let you upload new a firmware version as well as an OSD logo to the device.

          The following graphic shows the web pages available in the Administrative Web Interface.

          Figure 3. Administrative Web Interface menus