INI Files Reference Guide for Cisco Virtualization Experience Client 6215 Firmware Release 9.0
wlx.ini and $MAC.ini file parameters
Downloads: This chapterpdf (PDF - 1.18MB) The complete bookPDF (PDF - 2.22MB) | Feedback

wlx.ini and $MAC.ini file parameters

wlx.ini and $MAC.ini file parameters

This chapter describes the supported parameters that you can use in a wlx.ini file and in a $MAC.ini file.


Tip


For information to help you construct and use the supported INI files, see Getting started: INI file basics.


To increase usability, the supported parameters are separated into the following categories:

wlx.ini and $MAC.ini file general settings

The following tables describe the parameters that you can use to configure general settings. Default values are underlined. You can use the parameters in a wlx.ini file or a $MAC.ini file.


Note


The underlined value for a parameter is the default value. Some parameters also have options shown within brackets [ ]. If an option has an underlined value (default), that option and default value will automatically be used with the parameter (options without underlined values can also be used if you want to, but are not automatically used with the parameter). In addition, when using parameters and options, you can leave the default value or change it to another value shown.

For example, in the following case where:

ParameterX={yes, no}

[Option1={0, 1}]

[Option2={1, 2, 3, 4}]

If you use ParameterX, then Option1 and its default value 0 will automatically be used as Option1 has an underlined value (default of 0). You can still use Option2 if you want, however, Option2 is not automatically used with the parameter as Option2 does not have a default (underlined) value.


Table 1 General Settings: wlx.ini and $MAC.ini Files
Parameter Description

AudioMute={no, yes}

Default is no.

Specifies whether to mute the audio.

AudioVolume=<value of 0 to 100>

Specifies the volume level. Values of 0 to 100 provide more exact volume level.

BootOrder

BootOrder - Sets the boot order for the BIOS.

Note   

If the first boot order is not H, the system restart will boot from the BIOS setting.

Default is: Bootorder=H;S;U;F;C;P

Where values are as follows:

C is USB CD-ROM

F is USB FDC

H is SATA 0

P is PXE LAN

S is SATA 1

U is USB HDD

(Note that under U if multiple USB keys are connected, the first detected USB key will be attempted; if this fails to boot, the boot will fall back to the second detected USB key, and so on in order of detection)

Important:

The boot order must follow these rules:

  1. The boot order is a list of these values separated by a semi-colon (;) or a comma (,).
  2. Every value must be used.
  3. The values must be different.

ChangeAdminPassword=<base-64 econded password>

Specifies the new password for the user with administrative privileges. You can use any third-party base-64 encoder/decoder.

ChangeGuestPassword=<base-64 encoded password>

Specifies the new password for the guest user. You can use any third-party base-64 encoder/decoder.

ChangeRootPassword=<base-64 encoded password>

Specifies the new password for the root user. You can use any third-party base-64 encoder/decoder.

ChangeThinUserPassword=<base-64 encoded password>

Specifies the new password for the thin user. You can use any third-party base-64 encoder/decoder.

DesktopTaskBar={bottom, top, left, right}

AutoHide={no, yes}

[AlwaysOnTop={no, yes}]

Default is bottom.

DesktopTaskBar-Specifies the position of the taskbar.

For example: DesktopTaskBar=left

AutoHide- Default is no. Specifies whether to hide the taskbar until the user moves the mouse cursor over the taskbar area.

AlwaysOnTop- Default is no. Specifies whether to always display the taskbar on top of all other windows in a session launched in full screen mode only.

Disablemenubar={no, yes}

Default is no.

Yes/no option to disable top full screen drop-down menu bar.

DisableReadyMode={no, yes}

Default is yes.

Specifies whether to disable the ready mode. When a device is shut down and ready mode is enabled, the device logs out of the session, places the power button LED in a state of off, and then goes into Suspend mode. If a user presses the power button again, the device wakes up immediately for the user to log in.

The ready mode functionality can be enabled using DisableReadyMode=no.

Example:

DisableReadyMode=no will enable ReadyMode functionality.

DisableReadyMode=yes will disable ReadyMode functionality.

Fullscreenmode={no, yes}

Default is no.

Yes/no option to enable full screen mode (when selected it will disable the Desktopsize option).

IdleAction.Enable={no, yes}

[IdleAction.TimeOut=<value of 0 to 1440>]

[IdleAction.Action=<Any valid Command>]

Default is no.

Configures the action of the device for an idle state.

If IdleAction.Enable=yes and the device is idle for the IdleAction.Timeout (in minutes from 0 to 1440), then the device executes the command that is specified in the IdleAction.Action parameter.

By default, IdleAction.Enable=no.

Example:

IdleAction.Enable=yes

IdleAction.TimeOut=30

IdleAction.Action=/sbin/reboot

ImportCerts={no, yes}

[Certs=<list of certificate names>]

Default is no.

Indicates whether to import certificates from the server. Certs is a list of certificate names (the names must be separated by a semicolon).

Note   

Certificates must be placed in the /wlx/certs directory.

Example:

ImportCerts=yes

Certs=Cert1.cer;Cert2.crt;Cert3.pem;Cert4.der

Note   

The certificates must be .crt, .pem, or any valid certificate type.

Include=<path/filename>

Includes another INI file at the position of this command.

Note   

Only one level of include is allowed (nesting is not allowed).

INIFileSource={cache, local, server}

Default is cache.

Specifies the location of the INI file for the device to use:

  • cache specifies that, if the server is available, the device uses the file on the INI file server; otherwise, the device use the local cached INI file, cached/saved/used-at least-once file obtained from the file server.
  • local specifies to use the INI created from settings made on the thin client GUI
  • server specifies to use the INI file server only. If the file server is not available, the devices does not fall back to the local cached INI file.

InstallAddons=<name of add-on>

OR

NewAddons= <name of add-on>

Specifies add-ons to install. Use comma-separated add-on names.

Note   

You can use InstallAddons= or NewAddons= for the parameter name (the names are interchangeable).

MgmtDiscoveryMethod={SRV, CNAME, HOSTNAME, UI, DHCP, STATIC, DEFAULT}

Default is the following order SRV, CNAME, HOSTNAME, UI, DHCP (if any of the methods specified in the INI file fails).

Specifies the automatic discovery methods you want to use for the automatic discovery of a thin client after failure of thin client discovery. Use any or all of the following:

  • SRV - DNS SRV Record (Dynamic Discovery) Allows devices to use the DNS SRV record lookup method to discover a Cisco VXC Manager Server.
  • CName - DNS Alias Allows devices to use the DNS Alias method to discover a Cisco VXC Manager Server.
  • Hostname - DNS Name Record (Dynamic Discovery) Allows devices to use the DNS Hostname lookup method to discover a Cisco VXC Manager Server.
  • UI - Allows devices to use the UI entries to discover a Cisco VXC Manager Server.
  • DHCP Option Tags - (Dynamic Discovery) Allows devices to use DHCP option tags to discover a Cisco VXC Manager Server.
  • Static - Allows devices to use a static location to discover a Cisco VXC Manager Server.
    Note   

    When the Static option is used, the MgmtDiscoveryMethod parameter should be used with a valid Fully Qualified Domain Name or IP Address.

  • Default - The Default method to discover a Cisco VXC Manager Server is used when none is specified or if any of the methods mentioned in this section fails; then the default method is used which is the following dicovery order {SRV, CNAME, HOSTNAME, UI, DHCP}.

Password=<encrypted password>

[PasswordEncryptionCode={yes, no}]

Specifies the encrypted password for the INI user. Use the crypt utility available on standard Linux machines to encrypt the plain-text password and use the encrypted string for the password. For example: Password=lF2Sqd7qEqBg

PasswordEncryptionCode- Default is yes. Specifies whether to use a Base64 encoded password. If no, a plain-text password is used.

PowerButtonAction={interactive, reboot, restart, halt, shutdown, sleep, logoutandsleep, none, nothing}

Default is interactive.

Specifies the action the thin client takes when the power button is pressed.

interactive-Presents an option window to the user

reboot or restart-Reboots the device

halt or shutdown-Shuts down the device

sleep-Puts the device into sleep mode

logoutandsleep-Logs out the device and puts the device into sleep mode

none or nothing-No action (does nothing)

PowerManager={X,Y}

X is the system sleep time range:0..3600 seconds. Default value is 0 (never).

Y is the display sleep time range:0..3600 seconds. Default value is 300.

RemoveAddons=<name of add-on>

Specifies add-ons to uninstall. Use comma-separated add-on names.

RootPath=<root path>

The thin client uses this root path to access files on the central file server (not applicable with Cisco VXC Manager). The directory name /wlx is appended to the root path entry before use.

ScreenSaver=<value of 0 to 180>

[LockTerminal={no, yes}]

[SoftSaver={no, yes}]

[LogoutButton={no, yes}]

[Type={1, 2, name[,name...]}]

[CycleDelay=<value of 0 to 180>]

[Image=<filename>]

[Layout={none, centered, wallpaper, scaled, stretched}]

Default is 5 (minutes).

Specifies to put the thin client in a screensaver state when the time limit for inactivity in minutes (delay before starting) is reached. 0 turns off the screensaver.

Note   

Put the parameters on the same line. For example:

ScreenSaver=5 LockTerminal=yes SoftSaver=yes

Type=coral,drift,hypertorus,interaggregate,pipes,skytentacles CycleDelay=5

LockTerminal-Specifies whether to lock the client when the screen saver is activated.

  • no-Disabled
  • yes-Puts the thin client in a LOCK state when the screen saver is activated. The user is prompted with an unlock dialog box to enter the sign-on password to unlock the thin client.

SoftSaver-Specifies whether the thin client runs a soft saver. Soft savers are available only when the optional SCREENSAVER-THEMES add-on is installed.

  • no-Displays a blank screen
  • yes-Runs a graphical display

ScreenSaver=<value of 0 to 180> ,continued

LogoutButton-Displays a Logout button in the unlock dialog box if LockTerminal=yes

Type-Specifies which display programs should run if SoftSaver=yes

Note   

Names are preferred over the legacy numbers. 1=fadeplot; 2=rocks

CycleDelay-When more than one Type name is specified, CycleDelay specifies how many minutes each Type name should run.

Image-Specifies the filename to use for the screen saver (this option is ignored in cases of backward compatibility).

Layout-Specifies the layout to use for the screen saver (this option is ignored in cases of backward compatibility).

Note   

For a complete list of screensaver names, install the SCREENSAVER-THEMES add-on and then search in /usr/share/applications/screensavers.

The filenames, without the .desktop suffix, are the available screensaver names. The Name entry in each .desktop file provides the value that is displayed in the Screensaver configuration GUI application; and the Comment entry provides a brief description.

SecureMode={neverconnect, warnbefore, donotverify}

Default is warnbefore.

Specifies how to control connection security mode preferences.

Value and Description:

neverconnect - Never connect to untrusted servers

warnbefore - Warn before connecting to untrusted servers.

donotverify - Do not verify server identity certificates.

TerminalName=<name of thin client>

Specifies the name of the thin client comprising a 15-character string.

TimeFormat={"12-hour format", "24-hour format"}

Specifies the time format to use (how the clock on the desktop panel is displayed). By default, the local format is used.

TimeServer=<host address>[;<host address>]

Specifies the SNTP time servers to use for time retrieval. You can designate one or two (as shown in the parameter example) Network Time Protocol servers (separated by a semicolon). The client synchronizes the time of day to the servers at boot time, and keeps the time in sync with the servers during operation.

TimeZone=<zone value> [ManualOverride={no, yes}]

Default is no.

Specifies the time zone if the zone is unspecified on the thin client or is used with ManualOverride.

ManualOverride specifies whether to override the thin client System Preference Menu setting with this TimeZone setting.

Note   

For the complete list of TimeZone values, see TimeZone parameter values.

UpdateBiosCmos={no, yes}

Enables or disables the BIOS CMOS update. By default, UpdateBiosCmos is disabled (set to no). See also the BiosCmosImages parameter.

Example:

UpdateBiosCmos=1

Update.Mode={Both, Image, Addons, None}

Specifies the update mode for image upgrades.

Value and Description

Both-Updates image and add-ons

Image-Updates image only

Addons-Updates add-ons only

None-Does not upgrade

Update.Preserve_changes={no, yes}

Specifies whether to preserve changes while upgrading.

With update.preserve_changes=no, the thin client does not locally cache configuration settings during an image upgrade. Instead, the thin client erases all existing configurations and applies the configuration specified by the Cisco VXC Manager package that you use to push the upgrade. This is the Cisco-recommended setting.

With update.preserve_changes=yes, the thin client preserves and applies the previous device image configuration settings during the image upgrade.

wlx.ini and $MAC.ini file peripheral settings

The following table contains the parameters that you can use to configure peripheral settings such as keyboard, monitor, mouse, and printer. Default values are underlined.

Table 2 Peripheral Settings: wlx.ini and $MAC.ini Files
Parameter Description

CursorHideDelay=<value of 1 to 60>

Specifies the amount of time to wait before the cursor is hidden (the cursor is hidden after the specified number of seconds). After you move or click the mouse or press any keyboard key, the cursor reappears.

DeskColor="<primary color> [{solid, horizontal-gradient, vertical-gradient}<secondary color>]"

Specifies the desktop background color where <primary color> and <secondary color> can be one of the following values:

  • RGB color specification in the form commonly used in HTML (rrggbb).
  • A color name from the /usr/share/X11/rgb.txt file. Note that these names are case sensitive.
  • Three integers in the range of 0 to 255 representing the amount of red, green, and blue, respectively (for example 0 119 255).
    Caution    This form is deprecated. It is available for backward compatibility only.

Note that an optional shading can be specified (solid, horizontal-gradient, vertical- gradient).

The <primary color> is the primary color and the one which will be used if no shading is specified or if the shading is solid.

The optional <secondary color> is the secondary color.

When shading is specified (for example Deskcolor= "DarkGoldenrod horizontal-gradient LightGoldenrod"), the primary color (in this example, DarkGoldenrod) appears on the left (horizontal) or top (vertical) edge with a smooth transition to the secondary color (in this example, LightGoldenrod) on the opposite edge.

Desktop=<image file>

[Layout={Center, Tile, Stretch, Scale, None}

[Opacity=<value of 0-100>]

Default is no wallpaper.

Desktop-Specifies an image file to use as wallpaper for the local desktop. The file must be located in the wlx/bitmap directory on the server. The image file can be any type that is supported by SUSE/GNOME for use as wallpaper (such as PNG, JPG, and GIF). The filename is case sensitive.

Layout- Default is Center. Specifies the arrangement on the desktop background of the specified image file. The tile value replicates the image across the desktop; the stretch value adjusts the image to fill the screen; the scale value enlarges the image to fill either the screen width or height.

Opacity- Default is 100. Specifies the amount of transparency. At less than 100, the image is blended with the colors specified by the DeskColor option as though the image is not entirely opaque. A value of 0 indicates total transparency, and the image is not displayed at all.

For Example:

Desktop=ciscologo.gif Layout=Tile Opacity=25

DesktopColorDepth={8, 16, 24}

Default is 24.

Specifies the number of colors of the desktop in bits. 8 is 256 colors; 16 is High Color; and 24 is True Color.

DisplaySettings="MON1 <resolution> <position> [; MON2 <resolution> <position>]"

MON1 and MON2 define the display settings for single and multi-monitor displays (clone and span mode).

Possible values for:

resolution={{X}x{Y}, DDC}

position={mirror, on-left, on-right, on-above, on-below}

Note   

Meaning of different position values:

mirror-Clone mode

on-left-Span on left side

on-right-Span on right side

on-above-Span on top

on-below-Span on bottom

Examples:

DisplaySettings="MON1 1024x768 on-left; MON2 1024x768@75 on-right"

DisplaySettings="MON1 1024x768 on-above; MON2 1024x768@75 on-below"

EnableNumLock={no, yes}

Default is no.

Specifies whether to enable the default state of the numeric keypad. If set to yes, the numeric keypad is activated, if set to no (default), the numeric keypad becomes the cursor control pad.

ForwardPrinters={yes, no}

Default is yes

Specifies whether to forward all available printers for use in the RDP session. This parameter is supported with any direct RDP connection (not supported through VMware View broker). By default, ForwardPrinters is set to yes.

For example:

ForwardPrinters=yes

JetDirectPrinter=<value of an option>

The JetDirectPrinter command line defines a printer served by an HP JetDirect print server. For parameter options that are used in the command line, see JetDirectPrinter in Printer parameter options.

Keyboard.layouts=<value of Keyboard.layouts>

The Keyboard.layouts parameter specifies the keyboard layout. For a list of supported keyboard layout values, see Keyboard.layouts parameter values.

Example:

Keyboard.layouts=us (for United States)

Keyboard.layouts=ru (for Russia)

MicMute={no, yes}

Default is no.

Specifies whether to mute the microphone volume.

MicVolume=<value of 0 to 100>

Default is 50.

Specifies the microphone volume level.

MouseLocate={no, yes)

Default is no.

Specifies whether to briefly display an animated graphic showing the location of the mouse pointer when pressing and releasing the Ctrl key (with no other keys pressed).

MouseSendsControlV={no, yes}

For ICA only. Default is no.

Allows the administrator to control the mouse button action in a UNIX environment.

The values are:

yes-In a UNIX environment, a middle mouse performs the same Paste function as the Ctrl+V keystroke combination in Windows.

no-(default) Disables "enable middle button paste" when used in the wlx.ini file with ICA v.10.

MouseSpeed=<value of 0 to 100>

Specifies the speed when moving the mouse.

Note   

You can use the following values for backward compatibility.

You can use the following values for backward compatibility.

Value and Mouse Speed

0-Slow (0.2)

1-Medium (default) (2.0)

2-Fast (6.0)

MouseSwap={no, yes}

Default is no.

Specifies whether to swap the button order on the mouse. The default value is no.

NetworkPrinter=<value of an option>

Defines a printer that uses traditional UNIX Line Printer Daemon protocols. For parameter options that are used in the command line, see NetworkPrinter in Printer parameter options.

NoGrabKeyboard={no, yes}

Default is no.

Configures keyboard event grabbing in any direct RDP connection session (not supported through VMware View broker). By default, NoGrabKeyboard is set to no.

For example:

NoGrabKeyboard=yes

Printer=<value of an option>

Defines a locally attached printer that is connected through the noted interface. For parameter options that are used in the command line, see Printer in Printer parameter options.

PrinterURI=<value of an option>

Defines a printer using a URI supported by the Common UNIX Printing System (CUPS). This command is useful when you want the thin client to access a printer for which you already have a working CUPS client because you can simply copy the URI from the /cups/printers.conf file on the existing client. For parameter options that are used in the command line, see PrinterURI in Printer parameter options.

RepeatDelay={<value in milliseconds>, <supported value for backwards compatibility>}

Default is 660 milliseconds.

Expresses, in milliseconds (100-10000), the delay before a repeat key press is recognized. Enter a value greater than 100.

For backward compatibility, you can also use the following values:

0-1/4 second

1-1/4 second

2-1/2 second (default)

3-1/2 second

4-3/4 second

5-3/4 second

6-1 second

7-1 second

RepeatRate={<value of 3 to 255>, <supported value of 0 to 2>}

Expresses the number of allowable repeat key presses per second. Enter a value between 3 and 255 or a designated rate, as follows:

Value and Keyboard Repeat Rate

0-Slow (GUI value is 10)

1-Medium (default) (no GUI value)

2-Fast (GUI value is 110)

SMBPrinter=<value of an option>

Defines a network printer shared through the Windows Server Message Block protocols. For parameter options that are used in the command line, see SMBPrinter in Printer parameter options.

TransparentKeyPassThrough= {Local, Remote, FullScreenOnly}

Default is FullScreenOnly.

Enables keyboard shortcut sequences defined by the local Windows manager in the session.

FullScreenOnly-Key event is processed locally except in Fullscreen mode

Local-Key event is processed locally in order to use ICA hotkeys

Remote-Key event is forwarded to the server so that ICA hotkeys do not work.

VMWareViewExcludeUSBID={vid<hex number>pid<hex number>,...}

For VMware View Only

Specifies USB devices that are excluded from the VMWare View session in a comma-separated list of vendor IDs and product IDs.

For example:

VMWareViewExcludeUSBID=vid148fpid2770,vid0x13d3pid3273

VMWareViewExcludeUSBFamily={<USB device family>,...}

For VMware View Only

Specifies USB device families that are excluded from the VMWare View session in a comma-separated list.

For example:

VMWareViewExcludeUSBFamily=bluetooth

VMWareViewIncludeUSBID={vid<h ex number>pid<hex number>,...}

For VMware View Only

Specifies USB devices that are included in the VMWare View session in a comma-separated list of vendor IDs and product IDs.

For example:

VMWareViewIncludeUSBID=vid148fpid2770,vid0x13d3pid3273

VMWareViewIncludeUSBFamily={< USB device family>,...}

For VMware View Only

Specifies USB device families that are included in the VMWare View session in a comma-separated list.

For example:

VMWareViewIncludeUSBFamily=bluetooth

Desktop keyboard shortcuts

Depending on the type of application window you are using (full screen, standard, or seamless), you can use shortcut keys to manage windows.

You can disable some of these shortcuts by including the INI parameters listed below in your INI file. By default, every shortcut listed is enabled. (Possible values for each parameter are yes or no.)

Table 3 Desktop Keyboard Shortcuts
Press Action INI parameter to disable shortcut
Alt+F4 Close window Cisco.DisableKeyBinding.Close=yes
Ctrl+F4 Close browser window Cisco.DisableKeyBinding.Close=yes
Alt+F10 Maximize window Not applicable
Alt+F9 Minimize window Cisco.DisableKeyBinding.Minimize=Yes
Alt+Ctrl+DownArrow Minimize or maximize all windows Cisco.DisableKeyBinding.ShowDesktop=yes
Alt Mouse modifier (used by default as a mouse modifier) Cisco.DisableKeyBinding.MouseButtonModifier=yes
Alt+Esc Move focus to next window Not applicable
Alt+Shift+Esc Move focus to previous window Not applicable
Alt+F7 and press an arrow key Move window with arrow keys Not applicable
Alt+F8 and press an arrow key Resize the window Not applicable
Alt+F5 Restore maximized window to previous size Not applicable
Ctrl+F2 Switch keyboard focus back to thin client (used by Citrix Linux receiver to bring keyboard focus back to thin client locally) Not applicable
Alt+DownArrow Switch windows using a dialog box Cisco.DisableKeyBinding.SwitchWindows=yes
Alt+Ctrl+Shift+DownArrow Switch panel focus Not applicable
Alt+Ctrl+Delete Show Logout option Cisco.DisableKeyBinding.RunCommand1=yes
Alt+F1 Show Computer Menu window Cisco.DisableKeyBinding.PanelMainMenu=yes
Ctrl+Esc Show Windows start menu Cisco.DisableKeyBinding.PanelMainMenu=yes
Windows Key Show main panel list when keyboard focus is shifted to the thin client Cisco.DisableKeyBinding.PanelMainMenuList=yes
Alt+Space (you can also right-click the window title bar or border, or click the window icon) Show window menu Cisco.DisableKeyBinding.WindowMenu=yes

Tip


The shortcut keys Alt+DownArrow (allows you to switch windows using a dialog box) and Alt+Ctrl+DownArrow (minimizes or maximizes all windows) are useful for navigating multiple remote sessions without having to log out.


wlx.ini and $MAC.ini file connection settings

The following table describes the parameters that you can use to configure connection settings. Default values are underlined.

Table 4 Connection Settings: wlx.ini and $MAC.ini Files
Parameter Description

AddtoEtcHosts="ip1 FQDN1 aliases1;ip2 FQDN2 aliases2;..."

Adds entries to the /hosts file, where aliases are an optional space-separated list of hostnames.

Alternate={no, yes}

For ICA only.

Default is no.

Specifies the use of an alternate IP address returned from an ICA master browser to get through firewalls.

AutoSignoff={no, yes}

Default is no.

Specifies whether to automatically log the user off when all connections are closed.

Browser.Homepage=<URL>

If the browser add-on is installed, this is the home page for the browser.

Browser.Prefsurl=<URL>

If the browser add-on is installed, this is the URL to download preferences.

Connect={BROWSER, ICA, RDP, VMWARE_VIEWCLIENT}

Specifies the connection protocol.

To create a connection using an INI file, you must specify the Connect= parameter, as well as the mandatory connect options associated with the specified connection type.

Connect Parameter Options describes these parameters:

For details about configuring a XenDesktop connection, see XenDesktop connection example and Mozilla Firefox Connect options.

Note   

The availability of connection types depends on the add-ons that are installed on the client.

Disableconnectonce={no, yes}

Default is no.

Yes/no option to disable the listing of View desktops after session logout (when an error occurs).

DisableDomain={no, yes}

Specifies whether to disable the display of a Domain field. The default value depends on the value of the DomainList option. When the DomainList is empty, DisableDomain defaults to yes (the display of a Domain field does not display); otherwise, it defaults to no (the display of a Domain field does display).

DisableVNC={no, yes}

Default is yes.

Specifies whether to disable an installed VNC Server Add-on.

DomainList=<list of Windows domain names>

Specifies a list of domain names that appear in the login dialog box as options to help users select the domain to use to log in to PNAgent/PNLite servers. After you specify the list, it is saved in nonvolatile memory.

Note   

Be sure to enclose the domain list in quotation marks if you include spaces.

For example:

DomainList="North_America, SQA, test-domain"

Drives=<drive letter>={floppy, cdrom, disk}, {rw, ro} [, basedir] drive letter=...

Maps drives on the server to USB mass storage devices that are attached to the thin client, where:

drive letter=A to Z

floppy=USB floppy

cdrom=USB CDROM

disk=USB drive or memory stick

rw=read/write

ro=read only

basedir is an optional directory on the USB device to use.

Note   

Be sure each drive command is separated by a space.

EnableBanner={no, yes}

[BannerMsg=<text description>]

Default is no.

EnableBanner—Provides a banner description.

BannerMsg—The text must be enclosed in double quotation marks if it contains spaces or punctuation characters.

EthernetSpeed=[Auto, 100M-F, 100M-H, 10M-F, 10M-H]

Default is Auto.

Specifies the NIC speed:

Auto—Auto-negotiates speed with the peer (default).

100M-F is 100 Mb/s Full Duplex.

100M-H is 100 Mb/s Half Duplex.

10M-F is 10 Mb/s Full Duplex.

10M-H is 10 Mb/s Half Duplex.

Note   

Gigabit Ethernet (1000 Mb/s) is available on hardware that supports it using the Auto value.

ICAAllowUSB=vid=<hexnumber><space>pid=<hexnumber>,...

Specifies the USB devices that are included for the ICA session (comma separated IDs of USB devices that are included for the ICA session).

Important:

You can use vendor IDs and product IDs together (as shown); or also use only the vendor IDs (that is, not use the product IDs) if you want to include the same vendor ID group of devices regardless of their product ID.

The format must be the following:

ICAAllowUSB=vid=<hexnumber><space>pid=<hexnumber>,...

or

ICAAllowUSB=vid=<hexnumber>,...

For example:

ICAAllowUSB=vid=1234 pid=5678,vid=1234 pid=9876

This example includes two USB devices. Note that there is a space between vid and pid and each device is separated with a comma.

or

ICAAllowUSB=vid=1234, vid=5678

This example includes all USB devices that have the same vendor ID regardless of their product ID.

Note   

Do not use both ICADenyUSB and ICAAllowUSB in the same INI file. By default, all USB devices are allowed. ICAAllowUSB results in a denial of all other devices other than those specified by ICAAllowUSB. ICADenyUSB only denies the specified devices, but allows others.

ICADenyUSB=vid=<hexnumber><space>pid=<hexnumber>,...

Specifies the USB devices that are excluded from ICA session (comma separated IDs of USB devices that are excluded from the ICA session).

Important:

You can use vendor IDs and product IDs together (as shown); or also use only the vendor IDs (that is, not use the product IDs) if you want to exclude the same vendor ID group of devices regardless of their product ID.

The format must be the following:

ICADenyUSB=vid=<hexnumber><space>pid=<hexnumber>,...

or

ICADenyUSB=vid=<hexnumber>,...

For example:

ICADenyUSB=vid=1234 pid=5678,vid=1234 pid=9876

This example excludes two USB devices. Note that there is a space between vid and pid and each device is separated with a comma.

or

ICADenyUSB=vid=1234, vid=5678

This example excludes all USB devices that have the specified VIDs.

Note   

Do not use both ICADenyUSB and ICAAllowUSB in the same INI file. By default, all USB devices are allowed. ICAAllowUSB results in a denial of all other devices other than those specified by ICAAllowUSB. ICADenyUSB only denies the specified devices, but allows others.

FileServer=<protocol://><host address>

Specifies a file server from which the device can access files using the specified protocol. If no protocol is specified, FTP is assumed (for example, 192.168.0.1 is understood as ftp://192.168.0.1).

HomePage=<URL>

If the browser add-on is installed, this is the URL to the home page for the browser.

ICABrowsing={udp, http, https}

For ICA only.

Default is http.

Specifies the default browsing protocol. This setting can be overridden by the HttpBrowsing={yes,no,ssl} in each connection property.

ICAComports=COMx={COMy, USBSERz}, COMx=...

For ICA only.

Maps serial devices on the server to serial devices on the thin client, where x=1 to 4; if COMy, map to that serial port on the thin client; if USBSERz, map to that USB serial port.

Note   

Be sure each serial device command is separated by a comma and space.

IcaDesktopApplianceMode={yes, no}

For ICA only.

Default is yes.

Specifies whether to enable Citrix HDX USB startup (for Desktop Appliance Mode) for any USB devices that are already plugged in (the USB device will start up provided the device is not disallowed with a deny rule in the USB policies on either the server [registry entry] or the client [policy rules configuration file]). This parameter requires two thin client reboots.

ICADrives=<drive letter>={floppy, cdrom, disk}, {rw, ro}, basedir [drive letter=...]

For ICA only.

To map drives on the server to USB mass storage devices that are attached to the thin client, where:

drive letter=A to Z

floppy=USB floppy

cdrom=USB CDROM

disk=USB drive or memory stick

rw=read/write

ro=read only

basedir is an optional directory on the USB device to use.

Note   

Be sure each drive command is separated by a space.

IcaEnhancedAudio={no, yes}

For ICA only.

Default is no.

Enables/Disables Citrix enhanced audio.

true—enables Citrix enhanced audio

false—disables Citrix enhanced audio

ICAhotkey={yes, no} [<hotkey value>=<supported value>]

For ICA only.

Default is yes.

Specifies whether to allow mapping of the hotkeys. For example:

ICAhotkey=yes

Hotkey1Char=F1 Hotkey1Shift=Shift Hotkey2Char=F3 Hotkey2Shift=Shift Hotkey3Char=F2 Hotkey3Shift=Shift Hotkey4Char=F1 ..... Hotkey11Char=plus Hotkey11Shift=Ctrl

Note   

You must enter all hotkey options on one line.

IcaMMAudio={yes, no}

For ICA only.

Default is yes.

Specifies whether to enable Citrix HDX MultiMedia audio (see also ICADesktopApplianceMode and ICAMMVideo parameters). This parameter requires two thin client reboots.

For example:

To redirect audio to a USB audio device, set the following parameters as shown:

ICADesktopApplianceMode=yes

ICAMMVideo=yes

ICAMMAudio=no

To redirect audio to an analog audio device, set the following parameters as shown:

ICADesktopApplianceMode=yes

ICAMMVideo=yes

ICAMMAudio=yes

IcaMMVideo={yes, no}

For ICA only.

Default is yes.

Specifies whether to enable Citrix HDX MultiMedia video (see also ICADesktopApplianceMode and IcaMMAudio parameters). This parameter requires two thin client reboots.

For example:

To redirect audio to a USB audio device, set the following parameters as shown:

ICADesktopApplianceMode=yes

ICAMMVideo=yes

ICAMMAudio=no

To redirect audio to an analog audio device, set the following parameters as shown:

ICADesktopApplianceMode=yes

ICAMMVideo=yes

ICAMMAudio=yes

ICAMultiMedia={no, yes}

For ICA only.

Default is no.

Specifies whether to enable Citrix multimedia redirection.

yes—Enables Citrix multimedia redirection

no—Disables multimedia redirection

ICAProxyHost=<proxy server IP address>

For ICA only.

Specifies the firewall server address for the ICA connection. When you configure an alternate address for firewalls, and you specify HTTPS or SOCKS for the ICAProxyType, you must specify the proxy server IP address and port. You must specify each entry as host:port, where :port is optional. If you do not specify the port, the value depends on the browsing protocol.

ICAProxyType=[None, HTTP, SOCKS]

For ICA only.

Defines the proxy type for the ICA connection. When you configure an alternate address for firewalls, you can select the proxy type of None, HTTP, or SOCKS.

NFuseServer=<host address>[:<port>][;<host address> [:<port>]]

DO NOT USE.

This parameter is being deprecated and the use of PNAgentServer is recommended.

NLA={no, yes}

For RDP only.

Default is no.

Specifies whether to enable Network Level Authentication for RDP sessions.

PermitSSHRootLogin={no, yes}

Default is no.

Specifies whether to enable login through SSH as the Linux superuser (root).

PNAgentServer=<host address>[:<port>][;<host address> [:<port>]]

Specifies a list of PNAgent servers. If you do not specify a port, the port value depends on the browsing protocol.

Default is Empty.

PNLiteServer=<host address>[:<port>][;<host address> [:<port>]]

DO NOT USE.

This parameter is being deprecated and the use of PNAgentServer is recommended.

RapportSecurePort=<port>

Default port number is 443.

Designates the HTTP(S) secure port used for the Cisco VXC Manager agent.

Example:

RapportServer=192.168.0.2:80

RapportSecurePort=443

RapportServer=<host address>[:port]

Default port number is 80.

Specifies the Cisco VXC Manager Server and optional port to connect to. This can either be a DNS name or IP address, optionally followed by a ":" and a port number.

RdpClipBoard={yes, no}

For RDP only.

Default is yes.

Specifies whether to enable or disable the clipboard in an RDP session.

RdpDriveMap={yes, no}

For RDP only.

Default is yes.

Specifies whether to enable or disable drive mapping in an RDP session.

Seamless={no, yes}

Default is no.

Specifies whether to set the default resolution for ICA-published applications to seamless.

Serial={COM1, COM2, COM3, COM4}

{Baud={1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200}}

{Parity={None, Even, Odd, Mark, Space}}

{Stop={1, 1.5, 2}}

{Size={5, 6, 7, 8}}

{Flow={None, XON/XOFF, CTS/RTS, Both}}

Default is COM1.

Configures local serial ports:

Serial—Specifies the configuration for local serial ports.

Baud—Specifies the local serial port baud rate.

Parity—Specifies the local serial port parity.

Stop—Specifies the local serial port stop.

Size—Specifies the local serial port size.

Flow—Specifies the local serial port flow.

Note   

You must specify the parameters in the order shown.

StopWatchMin=<integer value>

Controls over-scrolling when using some published applications. Specify an integer value to control over-scrolling; for example 100.

Users may experience problems with over-scrolling when using some published applications. You can address this problem by adjusting the value to a greater number.

VMWareViewExcludeUSBFamily=<USB device family>,...

Specifies the USB family of devices that are excluded from the VMWare View session (comma separated USB device families that are excluded from the VMWare View session).

The format must be the following:

VMWareViewExcludeUSBFamily=<USB device family>,...

For example:

VMWareViewExcludeUSBFamily=audio,storage

This example excludes all USB devices per their device class/family.

VMWareViewExcludeUSBID=vid<hexnumber>pid <hexnumber>,...

Specifies the USB devices that are excluded from VMWare View session (comma separated vendor Ids and product Ids of USB devices that are excluded from the VMWare View session).

The format must be the following:

VMWareViewExcludeUSBID=vid<hexnumber>pid<hexnumber>,...

For example:

VMWareViewExcludeUSBID=vid148fpid2770,vid0x13d3pid3273

This example excludes two USB devices. Note that there is no space between vid and pid and each device is separated with a comma.

VMWareViewIncludeUSBFamily=<USB device family>,...

Specifies the USB family of devices that are included in the VMWare View session (comma separated USB device families that are included in the VMWare View session).

The format must be the following:

VMWareViewIncludeUSBFamily=<USB device family>,...

For example:

VMWareViewIncludeUSBFamily=audio,storage

This example includes all USB devices per their device class/family.

VMWareViewIncludeUSBID=vid<he xnumber>pid<hexnumber>,...

Specifies the USB devices that are included in the VMWare View session (comma separated vendor Ids and product Ids of USB devices that are included in the VMWare View session).

The format must be the following:

VMWareViewIncludeUSBID=vid<hexnumber>pid<hexnumber>,...

For example:

VMWareViewIncludeUSBID=vid148fpid2770,vid0x13d3pid3273

This example includes two USB devices. Note that there is no space between vid and pid and each device is separated with a comma.

VNCAuthTypes={none, vnc}

Set VNCAuthTypes=vnc to enforce the use of a password for remote VNC connection (use the VNCPasswd parameter to specify the password used). If VNCAuthTypes=none, no password is required for the VNC connection.

VNCPasswd= {<base-64 encoded password>}

If the VNC-Server Add-on is installed, specifies the password to be entered for the remote VNC connection.

Important:

If no VNCPasswd is specified, the default password is password.

VNCPrompt={yes, no}

Default is yes.

Specifies whether to prompt the user before shadowing starts, in which case the user can select to decline or accept VNC shadowing.

VNCPrompt=yes means the user is always prompted before shadowing starts.

VNCPrompt=no means the user cannot decline or accept shadowing.

XFontServers=<host address>:<port>[;<host address>:<port>...]

Specifies the font server for X11 applications.

Note   

When the font server address is set by the GUI, the GUI has priority, and the parameters from the INI file are ignored.