Administration Guide for Cisco Virtualization Experience Client 2112/2212 ICA Firmware Release 7.1_118
Getting started
Downloads: This chapterpdf (PDF - 1.91MB) The complete bookPDF (PDF - 6.18MB) | Feedback

Getting started

Getting started

WTOS

The Cisco VXC 2112/2212 runs WTOS firmware for use with ICA and RDP.

WTOS is designed to be centrally managed and configured using INI files Cisco recommends that you use central configuration to enable you to automatically push updates and any desired default configuration to all Cisco VXC Clients (zero clients) in your WTOS environment. (see Automated updates and configuration using central configuration).

If no INI files are detected, you can use local dialog boxes (on each zero client) to make available configurations. WTOS will save many of these locally configured settings (common settings such as resolution, mouse, keyboard, and so on) to persist after reboot. However, once INI files are detected, rebooting causes WTOS to become stateless (ignoring locally configured settings after a reboot) and the settings contained in the INI file will be used.

Remote server connection setup using central configuration

If you are set up for automatic detection (using INI files—see INI Files Reference Guide for Cisco Virtual Experience Client 2112/2212 ), your zero client automatically detects and connects to the configured remote services during the boot-up process.

Simply press the power button to turn on your zero client to see the Login dialog box. Enter your username, password, and domain, and then click Login. After successful authentication, your available connections are presented for use.


Tip


Although the zero client defaults to the Classic Desktop for INI backward compatibility, you can configure the zero client to display the Cisco VXC desktop by using the SysMode=VDI parameter in the INI files or by selecting the desktop option in a dialog box Desktop options: Cisco VXC Desktop and Classic Desktop.


Remote server connection setup using manual configuration

If you are not yet set up for central configuration, you see the Cisco VXC toolbar, where you can configure the initial server connection you want using the Remote Connections dialog box before you can log in. See Connect to remote virtual machine using manual configuration.

Figure 1. Cisco VXC toolbar



You need to only complete this manual configuration once (or after reboot to factory defaults). After the zero client knows the location of your server, it automatically connects to the server for login when you start the zero client in the future. After you confirm that your environment is ready for deployment, you can create INI files for central configuration.

Connect to remote virtual machine using manual configuration

Your system administrator will provide the specific steps and information necessary for you to log in to your Cisco VXC client.

One of the standard ways to log in to a Citrix Virtual Machine (VM) is to set up a broker server by clicking Remote Connections, selecting Citrix Xen, restarting the Cisco VXC client, and then entering login credentials. However, another procedure may be supplied by your system administrator.

  1. Click the System Settings icon on the Cisco VXC toolbar to open the System Settings menu, and then click Remote Connections to open the Remote Connections dialog box.
  2. Use the Broker Setup tab of the Remote Connections dialog box to configure one of the following connections:
    • ICA or RDP connection (select None, select ICA or RDP, click Configure Connection, and then follow the wizard)
    • A specific broker server connection (select Other, Citrix Xen, or VMware View, and then enter the IP address for the server in the Broker Server field)

    Note


    For more details, see Remote connection setup.


  3. Click OK, and then restart the zero client (click the Shutdown icon on the Cisco VXC toolbar to open and use the Shutdown dialog box to restart the zero client.
    • (If you configured an ICA or RDP connection) After the zero client restarts, click the Home icon on the Cisco VXC toolbar to open the list of available connections, click the ICA or RDP connection you created, and then log in.
    • (If you configured a specific broker server connection) After the zero client restarts, the Login dialog box appears for your server.
  4. Enter the User Name, Password, and Domain, and click Login. After successful authentication, your Cisco VXC toolbar displays with your assigned connections defined by the broker server.

VPN for Cisco VXC 2112

Cisco IP Phones 8961, 9951, or 9971 running Firmware Release 9.3(1) or later provide support for the Cisco VXC VPN feature, which provides integrated VPN functionality for the Cisco VXC 2112. You can use this feature to enable VPN tunneling for the Cisco VXC 2112 clients when they are attached to Cisco Unified IP Phones 8961, 9951, or 9971. This feature is not supported on the Cisco VXC 2212.

The Cisco VXC clients require no configuration to support the VPN. All VPN configuration is performed for the phone only.

To support the Cisco VXC VPN feature, the Cisco VXC 2112 clients must be running the minimum ICA Firmware Release 7.1_118 or later.

For more information, see Cisco Unified IP Phone 8961, 9951, and 9971 Release Notes for Firmware Release 9.3(1).

Desktop options: Cisco VXC Desktop and Classic Desktop

What you see after logging in to the server depends on the administrator configurations.

  • Users with a Classic Desktop—See the classic desktop with full task bar, desktop, and Connect Manager. This option is recommended for terminal server environments with published applications. For more information on using the Classic Desktop, see Additional Classic Desktop features.
    Figure 2. Classic Desktop



  • Users with a Cisco VXC desktop—See the Cisco VXC desktop with the Cisco VXC toolbar showing the assigned list of connections from which to select. This option is recommended for VDI and any full-screen-only connections. For more information on using the Cisco VXC desktop, see Additional Cisco VXC Desktop features.
    Figure 3. Cisco VXC Desktop



In any desktop case, you can select the desktop option you want (Classic Desktop or Cisco VXC desktop) and create the connections you need using the Visual Experience tab on the Remote Connections dialog box (see Remote connection setup.

To open the Remote Connections dialog box, do one of the following:

  • Classic Desktop—Click User Name (User Name is the name of the user who is logged in and the name is displayed at the bottom-left side of the task bar), and then select System Setup > Remote Connections.
  • Cisco VXC desktop—Click the System Settings icon on the Cisco VXC toolbar, and then select Remote Connections.
    Figure 4. Remote Connections dialog box



Client and connection settings

While the use of INI files is recommended to configure zero client settings and connection settings available to users (see Automated updates and configuration using central configuration), you can use dialog boxes on a zero client to:

Printer connections

To connect a parallel printer to your zero client through a USB port, you will need a USB-to-printer adapter cable (not included). Before use, you may need to install the driver for the printer by following the printer driver installation instructions. For information on connecting to printers, see Printer settings setup.

Monitor connections

Depending on your zero client hardware, connections to monitors can be made using either a VGA (analog) monitor port or a DVI (digital) monitor port and the proper monitor cables/splitters. For information on configuring display settings, see Display settings setup.


Note


For dual-monitor supported zero clients using a DVI to DVI/VGA splitter with VGA and DVI monitors at the same time, note that the VGA monitor will be the primary monitor.


Terminal lock

To help ensure that no one else can access your private information without permission, WTOS allows you to lock your zero client so that credentials are required to unlock and use the zero client after you do one of the following:

  • Use LockTerminal from the shortcut menu and Shutdown dialog box—On the Classic Desktop, click on the desktop and select Lock Terminal, or use the Shutdown dialog box (see Additional Classic Desktop features). On the Cisco VXC desktop, use the Shutdown dialog box (see Signoff and shutdown). To open the zero client for use, you must use your correct password.
  • Use the screen saver—If an administrator has set LockTerminal=2 for the ScreenSaver parameter in the INI files and you use the screen saver, then the zero client will lock. To open the zero client for use, you must use your correct password.

Signoff and shutdown

Use the Shutdown dialog box (Classic Desktop—click Shutdown in the Connect Manager or Desktop Menu; Cisco VXC desktop—click the Shutdown icon on the Cisco VXC toolbar) to select the available option you want.


Note


You can also configure automatic behavior after all desktop sessions are closed by using the Remote Connections dialog box (see Remote connection setup) or the AutoSignoff parameter in a wnos.ini file (see Automated updates and configuration using central configuration).
Figure 5. Shutdown dialog box



Use the following guidelines (depending on user privilege, some options may not be available for use).



Table 1 Shutdown dialog box options

Option

What It Does

Sign-off from account

Allows you to log out from the current open account (the Login dialog box appears and is ready for another user).

Lock Terminal

Locks the zero client from use until you log in again.

Shutdown the system

Turns off the zero client.

Restart the system

Logs out the user account (the Login dialog box appears after the zero client restarts).

Reset the system setting to factory default

Appears for high-privileged users/administrators only. This option allows you to reset the zero client to factory defaults (see Reset to factory defaults using G-Key reset).

Additional Cisco VXC Desktop features

Cisco VXC interactive desktop guidelines

The Cisco VXC desktop has a Cisco default background with the Cisco VXC toolbar at the left of the screen.

The following table lists available shortcuts.



Table 2 Cisco VXC interactive desktop shortcuts

Action

Press

Display the Cisco VXC toolbar

Ctrl-Alt-UpArrow

Open a selection box for toggling between the desktop and currently-active connections

Ctrl-Alt-DownArrow

Lock the zero client

Ctrl-Alt-Left Arrow

or

Ctrl-Alt-RightArrow

Keyboard shortcuts to menu commands

Left-Alt-UnderlinedLetter

NOTE: Right-Alt-UnderlinedLetter combination is not currently supported

Capture the full desktop to the clipboard

Print Screen

Capture the active window to the clipboard

Alt-PrintScreen


Caution


You can copy and paste between application sessions and between sessions and the desktop; however, this function depends on session server configurations.



Tip


In addition to the standard two-button mouse, the zero client supports a wheel mouse (used for scrolling). Other similar types of wheel mouse may or may not work.

To switch the left and right buttons, use the Peripherals dialog box (see Peripherals settings setup).


Cisco VXC toolbar

The Cisco VXC toolbar usually appears at the left edge of the Cisco VXC desktop. However, depending on administrator configurations, the toolbar can be removed or hidden (shown only when a user moves the mouse pointer over the left edge of the desktop screen)


Tip


Administrators can configure the toolbar settings using either a dialog box (see Remote connection setup) or the SysMode parameter in the wnos.ini file (see INI Files Reference Guide for Cisco Virtual Experience Client 2112/2212 ).


The following table describes the Cisco VXC toolbar icons.

Table 3 Cisco VXC toolbar icons

Icon

What it does

Home

Opens the list of available connections (see List of connections).

System Information

Displays zero client system information (see System Information dialog box).

System Settings

Opens the System Settings menu to configure zero client system settings and perform diagnostics (see Connectivity options configuration, Local settings configuration, and Automated updates and configuration using central configuration).

Shutdown Terminal

Click the Shutdown Terminal icon to use the Shutdown options available on the zero client (see Signoff and shutdown).

Note   

The Shutdown Terminal icon does not display on the toolbar when using the Admin Mode button to configure system settings.


Tip


If configured to display (by an administrator), the current date and time are shown on the Cisco VXC toolbar. The zero client is capable of synchronizing its clock to time provided by a Simple Network Time Protocol (SNTP) server.


List of connections

On the Cisco VXC toolbar, you can click the Home icon to open your list of assigned connections (in some cases the list may contain only default connections).

Figure 6. List of connections



Use the following guidelines (depending on user privilege level, some options may not be available for use):



Table 4 Connection options
Option What it does

Name of the connection

Opens the connection you want to use (all open connections display a blue icon to the left of the connection name in the list).

Restart icon



Restarts the connection (useful when a connection is not functioning properly or you need to reboot the connection).

Quick Disconnect icon



Closes the connection (the Close icon is dimmed for connections that are not open).

Edit icon



Opens the Connection Settings dialog box (see Advanced details about ICA and RDP connections) to change the connection options (depending on user privilege level, editing options may not be available for use).

Configuring Global Connection Settings

If you do not use INI files to provide global connection settings, you can click Global Connection Settings to open and use the Global Connection Settings dialog box to configure settings that affect all of the connection in the list (see Global Connection Settings dialog box).

Additional Classic Desktop features

Classic interactive desktop guidelines

The Classic Desktop has a Cisco default background with a horizontal task bar at the bottom of the screen.

Use the following guidelines:

  • Icons representing available server connections and published applications are displayed on the background. Hovering the mouse pointer over an icon pops-up information about the connection. Right-clicking (or left-clicking if the mouse buttons are reversed) on an icon opens a Connection Settings dialog box which displays additional information about the connection. The number of icons that can be displayed on the desktop depends on the desktop resolution and administrator configuration.
  • A server connection/published application can be opened by double-clicking a desktop icon or a user can navigate to the desktop icon they want by using the Ttab key and pressing Enter to initiate the connection.
  • Right-clicking on the desktop provides a Shortcut Menu (see Shortcut menu).
  • Clicking the User Name (User Name is the user who is logged-on and is located at the bottom-left side of the taskbar), or clicking on the desktop opens the desktop menu (see Desktop menu).

Tip


If configured to display (by an administrator), the volume control is displayed in the right corner of the task bar and the current time and date are shown when the cursor is placed on the time.

The zero client is capable of synchronizing its clock to time provided by a Simple Network Time Protocol (SNTP) server.


The following table lists available shortcuts on the Classic Desktop.



Table 5 Classic Desktop shortcut keys
Action Press

Toggle between window display modes

Ctrl-Alt-UpArrow

Open a selection box for toggling between the desktop, Connect Manager, and currently active connections

Ctrl-Alt-DownArrow

Lock the zero client

Ctrl-Alt-LeftArrow

or

Ctrl-Alt-RightArrow

Keyboard shortcuts to menu commands

Left-Alt-UnderlinedLetter

Note   

Right-Alt-UnderlinedLetter combination is not currently supported

Capture a full desktop

Print Screen

Capture the active window

Alt-PrintScreen


Caution


You can copy and paste between application sessions and between sessions and the desktop, however, this function depends on session server configurations.



Tip


In addition to the standard two-button mouse, the zero client supports a wheel mouse (used for scrolling). Other similar types of a wheel mouse may or may not work.

To switch the left and right buttons, use the System Preference dialog box (see System preferences setup).


Shortcut menu

Right-clicking on the desktop provides a shortcut menu with the following options:

  • Administrator Mode—Allows administrators to configure various settings locally on zero client.
  • Hide all windows—Brings the full desktop to the foreground.
  • Copy to clipboard—Copies an image of the full screen, current window, or event log to the clipboard. The clipboard contents can then be pasted to an ICA or an RDP session.
  • Purge clipboard—Discards the contents of the clipboard in order to free up memory.
  • Lock Terminal—Puts the zero client in a locked state if the user has signed on to the system with a password. The zero client can only be unlocked using the same password.
  • Group Sessions—Enables you to open more than three ICA or three RDP or three ICA seamless sessions. The sessions will be displayed as a group on the task bar.
  • Write Event Log to USB - Writes the event log of the zero client to the last connected USB device (see System tools).
  • Network Capture to USB - Captures network traces to the last connected USB device (see System tools).
  • Trace Action - Captures (capture option) or plays back (playback option) the network traces (see System tools).
  • Delay on Trace - Enables a time delay on traces (see System tools).
  • Trace to/from USB - Enables the capture of network information (a network trace of all traffic coming in and out of the zero client) to a USB drive that is inserted into the zero client (see System tools).

Desktop menu

Clicking the User Name (User Name is the name of user who is logged in and the name is displayed at the bottom-left side of the task bar), or clicking on the desktop opens the desktop menu with the following options (for High-privileged and Low-privileged users only):

Figure 7. Desktop menu



  • System Setup—Provides access to the following local system setup dialog boxes:
    • Network Setup—Allows selection of DHCP or manual entry of network settings, as well as entry of locations of servers essential to zero client operation. This menu selection is disabled for low-privileged users. See Network setup.
    • Remote Connections—Allows you to configure zero client network connections including ICA, RDP, Citrix Xen, and other broker server connections. See Remote connection setup.
    • Central Configuration—Allows you to configure zero client central connection settings such as file server and optional VXC Manager server settings. See Central configuration setup.
    • WAN Setup—Allows you to configure zero client WAN.
    • System Preference—Allows user selection of zero client parameters that are a matter of personal preference. See System preferences setup.
    • Display—Allows you to configure the monitor resolution and refresh rate. See Display settings setup.
    • Peripherals—Allows you to select the peripherals settings such as keyboard, mouse, volume, and touch screen settings. See Peripherals settings setup.
    • Printer—Allows configuration of network printers and local printers that are connected to the zero client. See Printer settings setup.
  • System Information—Provides zero client system information. See System Information dialog box.
  • Applications—Contains a submenu of all locally configured applications and is populated with published applications when a user is signed on using either PNLite or PNAgent.
  • Network Test—Opens a submenu from which the Ping and Trace Route tools can be used to check the integrity of the network connection. See Ping tab and Trace Route tab.
  • System Tools—Opens a submenu from which the wnos.ini and user.ini windows can be opened to view the contents of the files. See System tools.
  • Shutdown—Opens the Shutdown dialog box. See Signoff and shutdown.

Connect Manager

Clicking Connect Manager on the task bar opens the Connect Manager. The Connect Manager has a list of connection entries and a set of command buttons available for use with the connections.


Tip


Non-privileged users cannot view the Connect Manager.


Figure 8. Connect Manager



The command buttons available depend on the privileges of the user and administrator configuration; the following default examples are typical:

  • High-privileged user—Includes Connect, New, Settings, and Sign-off
  • Low-privileged user—Includes Connect, Settings, and Sign-off
  • Standalone user—Includes Connect, New, Settings, and Delete

Tip


If set by an administrator (enablelocal=yes in the user.ini/wnos.ini file), high-privileged and low-privileged users will have the Delete command button available instead of the Sign-off command button).


The use associated with these command buttons also depends on user privilege. For example, Settings allows a high-privileged user to view and edit connection definitions, while it allows a low-privileged user to only view connection definitions.


Tip


Guest-user privileges are determined by an administrator.


The Connect Manager command buttons include:

  • Connect—To make a connection, select a connection from the list and click Connect.
  • New—Clicking New opens the Connection Settings dialog box either directly or through the Connection Protocol menu selection for creating a new connection definition (for more information on the Connection Settings dialog box, see Advanced details about ICA and RDP connections). The new locally-defined connections are added to the connection list. Be aware of the following information:
    • High-privileged user—Typically, all locally-defined connection definitions are temporary and are lost when the user logs off and when the zero client restarts or is shut down. However, if configured by an administrator (enablelocal=yes), locally-defined connection definitions can be saved in these cases.
    • Standalone user —Locally defined connections are retained when the zero client restarts or is shut down (there is no individual sign in). Network configuration settings must be made locally.
  • Properties—Clicking Properties opens the Connection Settings dialog box for the selected connection (for more information on the Connection Settings dialog box, see Advanced details about ICA and RDP connections). Be aware of the following information:
    • High-privileged user—Can view and edit the definitions for the currently selected connection. Edits are not permanently retained when the user signs-off.
    • Low-privileged user—Cannot create or edit connections, but can view connection definitions.
    • Standalone user—Can permanently modify the persistent connections (except when PNAgent/PNLite services are used).
  • Sign-off—To sign-off from the zero client, click Sign-off.
  • Delete—To delete a connection, select a connection from the list and click Delete.
  • Reset VM—To reset a virtual connection, select a virtual connection from the list and click Reset VM.
  • Global Connection Settings—If you do not use INI files to provide global connection settings, you can click Global Connection Settings to open and use the Global Connection Settings dialog box to configure settings that affect all of the connections in the list (see Global Connection Settings dialog box).

Login dialog box features

While the Login dialog box allows you to log in to the server, it also allows you to:

  • Obtain system information
  • Access Admin Mode to configure zero client settings
  • Change or reset your own password and unlock your account
  • Open the Shutdown dialog box
Figure 9. Login dialog box



Use the following guidelines:

  • Sys Info—Click the Sys Info button to open the System Information dialog box and view the zero client system information such as System Version, IP Address, information on devices connected to your zero client, event logs, and so on (see System Information dialog box).
  • Admin Mode—Click the Admin Mode button to configure various settings locally on the zero client (not broker desktop configurations). For example, you can choose to manually configure the Citrix Xen Broker Server URL (or override the URL that is centrally defined by file servers) by using the Remote Connections dialog box as described in Remote connection setup. To exit Admin Mode:
    • Classic Desktop - Use the Leave Administrator Mode option on the Shutdown dialog box.
    • Cisco VXC Desktop - Use the Leave Administrator Mode option on the Shutdown dialog box, or use the Leave Administrator Mode icon (X) on the top right of the System Settings menu.

    Tip


    By default the Admin Mode button is not displayed on the Log on dialog box. You can display it by checking the Show local admin button check box on the Shutdown dialog box (see Signoff and shutdown).



    Caution


    By default there is no password needed for Admin Mode button use. You can password protect the Admin Mode button (to require login credentials) by using the AdminMode parameter in a wnos.ini file (see INI Files Reference Guide for Cisco Virtual Experience Client 2112/2212 ).


  • Shutdown—Click the Shutdown button to open and use the Shutdown dialog box to log out, shut down, restart, reset the system setting to factory defaults, and so on (see Signoff and shutdown).
  • Account Self-Service - Click the Account Self-Service icon (shown when configured using the AccountSelfService option of the PasswordServer INI parameter - see INI Files Reference Guide for Cisco Virtual Experience Client 2112/2212 ) to open and use the Account Self-Service dialog box to change or reset your own password and unlock your account. Note that this process assumes that the security questions and answers have been pre-registered by the user inside of their Windows environment. Users must use HTTPS (not HTTP) for an account self-service server address (such as https://IPAddress) in the Broker Setup tab (see Remote connection setup). After answering the security questions, your new password will be set or your account will be unlocked.
    Figure 10. Account Self-Service dialog box



System Information dialog box

Use the System Information dialog box to view system information.

  • Classic Desktop—Click System Information in the Desktop Menu
  • Cisco VXC desktop—Click the System Information icon on the Cisco VXC toolbar

The System Information dialog box includes:

  • General Tab—Displays general information such as System Version, Serial Number, Boot From, Memory Size (Total and Free), Terminal Name, IP Address, Net Mask, Gateway, and DHCP Lease.
  • Devices Tab—Displays information about devices such as the CPU Speed, ROM Size, Monitor, Parallel Ports, Ethernet Speed, Memory Speed, NAND Size, Resolution, Serial Ports, and the zero client MAC Address.

    Note


    Clicking the Device Viewer button allows you to easily view recognized devices (this screen provides USB information such as PID and VID needed for the forcelocal= or forceredirect= INI parameters).


  • Copyright/Patents Tab—Displays the software copyright and patent notices.
  • Event Log Tab—Displays the zero client startup steps (normally beginning from System Version to Checking Firmware) or error messages that are helpful for debugging problems.
  • Status Tab—Displays status information about TCP performance-related parameters, CPU Busy, System Up Time, Free Memory, and DHCP lease time remaining.