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 version 3 or later
Internet Explorer 7.0 and 8.0
Other browsers may also be compatible.
Cisco strongly recommends 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:
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
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.
Enter the IP address into the browser (for example, https://192.168.1.123).
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.
Some PCoIP devices have password protection disabled and do not require a password to log in.
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
Open the Tools menu and select Internet Options.
Click on the Content tab, and select Certificates.
On the Trusted Root Certification Authorities tab, select Import.
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
Open the Tools menu and select Options.
Select the Advanced icon at the top of the page.
On the Encryption tab, select View Certificates.
On the Authorities tab, select Import.
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.
The Cisco VXC 2111/2211 firmware can support other smart cards, but Cisco does not provide support for additional smart card solutions. For information about additional smart cards, contact your smart card vendor.
From the Log In page, enter your password. The default value is blank (“”).
To change the time after which the device is automatically logged out, set the Idle Timeout field to one of the following values:
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.
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.
Some networks using DHCP may be able to access the AWI using the PCoIP device name.
Failed Login Attempt message
A a warning message alerts you if any failed access attempts to the Administrative Web Interface, On Screen Display, or PCoIP Management Console were detected since the last successful login. The message provides the date and time of the failed attempt, as shown below in the example warning message on the Administrative Web Interface
Figure 2. Failed Login Attempt Message
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.
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 3. Home Page
The information fields shown on the home page are summarized in the following table.
Bytes sent: The total number of bytes sent in the current/last session.
Bytes received: The total number of bytes received in the current/last session.
Round Trip Latency
The minimum, average, and maximum round trip PCoIP system and network latency in milliseconds (+/- 1 ms).
The minimum, average, and maximum traffic transmitted by the Tera processor. The active bandwidth limit is the maximum amount of network traffic the Tera processor may currently generate. The value is derived from the configured bandwidth parameters and the current (or last) network congestion levels.
The minimum, average, and maximum traffic received by the Tera processor.
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.
This is based on how the Use Client Image Settings field is configured on the Image page for the host device.
Initial Image Quality
The maximum and minimum quality setting is taken from the Image page for the device.
The active setting is what is currently being used in the session and only appears on the host.
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.
Build to Lossless
Options that may appear in this field include:
Enabled: The Disable Build to Lossless field on the Image page is unchecked
Disabled: The Disable Build to Lossless field is checked.
The port number for the display.
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".
Output Process Rate
The frame rate currently being sent from the image engine on the virtual machine to the client.
Shows the current lossless state of the attached display:
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 (see Cisco VXC PCoIP configuration).
Permissions: The items on this menu let you set up the client permissions for the USB, audio, and power (see User Permissions setup).
Diagnostics: The items on this menu help you troubleshoot the device (see Diagnostics tools).
Info: The items on this menu let you view firmware information and the devices currently attached to the device (see Device Information Display).
Upload: The items on this menu let you upload new a firmware version as well as an OSD logo to the device (see Uploads to device).