INI Files Reference Guide for Cisco V irtualization …...INI Files Reference Guide for Cisco V...

INI Files Reference Guide for Cisco Virtualization Experience Client6215 Firmware Release 9.0First Published: April 02, 2013

Last Modified: May 14, 2013

Americas HeadquartersCisco Systems, Inc.170 West Tasman DriveSan Jose, CA 95134-1706USAhttp://www.cisco.comTel: 408 526-4000 800 553-NETS (6387)Fax: 408 527-0883

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITEDWARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITHTHE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain versionof the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDINGANYOTHERWARRANTYHEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS"WITH ALL FAULTS.CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OFMERCHANTABILITY, FITNESS FORA PARTICULAR PURPOSEANDNONINFRINGEMENTORARISING FROMACOURSEOFDEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUTLIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERSHAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shownfor illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnershiprelationship between Cisco and any other company. (1110R)

© 2013 Cisco Systems, Inc. All rights reserved.

http://www.cisco.com/go/trademarks

http://www.cisco.com/go/trademarks

C O N T E N T S

C H A P T E R 1 Preface 1

Audience 2

Organization 2

Related documentation 2

Documentation, support, and security guidelines 3

Document conventions 3

C H A P T E R 2 Getting started: INI file basics 5

INI parameter updates using Cisco VXC Manager 5

Supported INI files 5

wlx.ini files 6

$MAC.ini files 6

INI file construction rules and recommendations 7

C H A P T E R 3 wlx.ini and $MAC.ini file parameters 9

wlx.ini and $MAC.ini file general settings 9

wlx.ini and $MAC.ini file peripheral settings 18

Desktop keyboard shortcuts 24

wlx.ini and $MAC.ini file connection settings 25

A P P E N D I X A Connect Parameter Options 37

Mozilla Firefox Connect options 37

XenDesktop connection example 38

ICA Connect options with XenApp 39

RDP Connect options 42

VMware View Client Connect options 45

A P P E N D I X B Printer parameter options 49

INI Files Reference Guide for Cisco Virtualization Experience Client 6215 Firmware Release 9.0 iii

JetDirectPrinter 49

NetworkPrinter 51

Printer 52

PrinterURI 53

SMBPrinter 55

A P P E N D I X C TimeZone parameter values 57

A P P E N D I X D Keyboard.layouts parameter values 61

INI Files Reference Guide for Cisco Virtualization Experience Client 6215 Firmware Release 9.0iv

Contents

C H A P T E R 1Preface

The Cisco Virtualization Client 6215 (Cisco VXC 6215) delivers superior voice and video collaborationcapabilities in desktop virtualization. It unifies voice, video, and virtual desktop in one device.

The Cisco VXC 6215 provides workers with secure, real-time access to business applications and contentwithout compromising the collaborative user experience. Cisco VXC 6215 supports the following capabilities:

• Combines virtual desktops with voice and video capabilities.

• Supports processing capabilities that use network and data center CPU resources efficiently.

• Supports high-quality, scalable voice and video, delivering an optimal user experience.

The Cisco VXC 6215 provides support for the following hosted virtual desktop protocols:

• Citrix Independent Computing Architecture (ICA)

• PC over IP (PCoIP)

• Remote Desktop Protocol (RDP) (does not support the Cisco Virtualization Experience Media Engine[VXME] add-on)

Cisco VXC 6215 Initialization (INI) files are plain-text files that you can construct to contain the configurationinformation you want for your thin clients on a global level. For example, you can use INI files to configureand save information about connection settings, display options, and printer options.

Information and procedures that are presented in this guide are intended for use by system administratorsand should not be used by untrained persons

Caution

• Audience, page 2

• Organization, page 2

• Related documentation, page 2

• Documentation, support, and security guidelines, page 3

• Document conventions, page 3

INI Files Reference Guide for Cisco Virtualization Experience Client 6215 Firmware Release 9.0 1

AudienceThis guide is intended for administrators of Cisco VXC 6215 thin clients. It provides the detailed informationyou need to help you understand and use the Cisco VXC 6215 INI files. It contains information on the differentINI files you can use and the rules for constructing the files. It also provides the parameter details you need(with working examples) to get the most out of your INI files.

OrganizationThis manual is organized as described in the following table.

DescriptionChapter

Contains the basic information you need to help youunderstand and use the Enhanced SLE INI files. Itcontains information on the different INI files youcan use and the rules and recommendations forconstructing the files.

Getting started: INI file basics, on page 5

Provides the supported parameters that you can usein a wlx.ini file and in a $MAC.ini file.

wlx.ini and $MAC.ini file parameters, on page 9

Provides lists of connect options for the supportedconnections.

Connect Parameter Options, on page 37

Describes printer-definition commands andparameters for wlx.ini files. It also describes commonparameters that the printer-definition commands share.

Printer parameter options, on page 49

Lists TimeZone values for use with the wlx.ini file.TimeZone parameter values, on page 57

Lists Keyboard.layouts values for use in the wlx.inifile (to designate the keyboard type).

Keyboard.layouts parameter values, on page 61

Related documentationFor more information, see the documents available at the following URLs:

Cisco Virtualization Experience Client 6000 Series

http://www.cisco.com/en/US/products/ps11976/tsd_products_support_series_home.html

Cisco Virtualization Experience Client Manager


INI Files Reference Guide for Cisco Virtualization Experience Client 6215 Firmware Release 9.02

PrefaceAudience



Documentation, support, and security guidelinesFor information on obtaining documentation, obtaining support, providing documentation feedback, securityguidelines, and also recommended aliases and general Cisco documents, see the monthlyWhat's New in CiscoProduct Documentation, which also lists all new and revised Cisco technical documentation, at:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

Subscribe toWhat's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed andset content to be delivered directly to your desktop using a reader application. The RSS feeds are a free serviceand Cisco currently supports RSS Version 2.0.

Document conventionsThis document uses the following conventions:

Means reader take note. Notes contain helpful suggestions or references to material not covered in thepublication.

Note

Means reader be careful. In this situation, you might do something that could result in equipment damageor loss of data.

Caution

Warnings use the following convention:

IMPORTANT SAFETY INSTRUCTIONS

This warning symbol means danger. You are in a situation that could cause bodily injury. Beforeyou work on any equipment, be aware of the hazards involved with electrical circuitry and befamiliar with standard practices for preventing accidents. Use the statement number provided atthe end of each warning to locate its translation in the translated safety warnings that accompaniedthis device.

SAVE THESE INSTRUCTIONS

Warning


PrefaceDocumentation, support, and security guidelines

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html


PrefaceDocument conventions

C H A P T E R 2Getting started: INI file basics

In this chapter you will learn how to construct and use the supported INI files.

After you become familiar with the INI file basics, you can refer to the parameter details you need in theother chapters and appendixes of this guide.

• INI parameter updates using Cisco VXC Manager, page 5

• Supported INI files, page 5

• wlx.ini files, page 6

• $MAC.ini files, page 6

• INI file construction rules and recommendations, page 7

INI parameter updates using Cisco VXC ManagerCisco VXC Manager is the standard tool used to push and schedule INI configuration updates to your thinclients. Cisco VXC Manager allows you to push the common INI file configurations to all of the thin clientsin your environment.

Do not modify INI files directly on the Cisco VXC 6215 as doing so can cause configuration issues andoperational errors.

Caution

For detailed information about configuring thin clients using Cisco VXCManager, see Administration Guidefor Cisco Virtualization Experience Client Manager and the Administration Guide for Cisco VirtualizationExperience Client 6215 .

Supported INI filesThe INI files contain the parameters (and associated options and values) necessary for the functionality youwant.

You can construct the following INI files:

• wlx.ini file (see wlx.ini files, on page 6)


• $MAC.ini file (see $MAC.ini files, on page 6)

The INI file processing hierarchy is as follows:Note

• Scenario 1 - $MAC.ini exists. The $MAC.ini file is processed and if the include=wlx.ini statementis included, then the wlx.ini file is processed.

• Scenario 2 - wlx.ini exists. The wlx.ini file is processed.

• Scenario 3 - No ini files exist. Local configuration is applied.

wlx.ini filesA wlx.ini file contains the global parameters you want that affect all thin clients accessing the server.

$MAC.ini filesA $MAC.ini file contains device-specific configuration parameters. If the thin client locates a $MAC.ini file(stored in the same directory as a wlx.ini file), the thin client uses the $MAC.ini file for its configuration ratherthan the wlx.ini file. In this case, the thin client does not access the wlx.ini file unless you specify theinclude=wlx.ini parameter in the $MAC.ini file.

If the wlx.ini and the $MAC.ini files each define the same parameter with different values, the thin clientassigns higher precedence based on which parameter appears last in the $MAC.ini file: either the repeatedparameter or the include=wlx.ini parameter.

For example, assume the following parameter definitions:

Note

• The wlx.ini file contains parameterA=valueB

• The $MAC.ini file contains parameterA=valueC

The following table describes the final value for parameterA based on its placement relative to theinclude=wlx.ini parameter in the $MAC.ini file.

Final value for parameterAParameter placement in $MAC.ini

ParameterA=ValueB (from wlx.ini file)parameterA=valueC appears earlier and wlx.iniappears later

ParameterA=valueC (from $MAC.ini file)wlx.ini appears earlier and parameterA=valueCappears later


Getting started: INI file basicswlx.ini files

INI file construction rules and recommendationsIn general, Enhanced SLE INI files follow currently accepted standard INI file formatting conventions. TheINI files consist of parameters that you can enter as necessary for reference. When you create an INI file, theonly required parameter that you must use is the Connect parameter. You can use any of the remainingparameters if you desire, but they are not mandatory unless you require changes from the default values. Everyparameter (and the associated options) has a name and a value with the name appearing to the left of the equalsign (name=value). All parameters with the same name in the various INI files have the same meaning (thatis, a parameter named XYZ in a wlx.ini file and named XYZ in a $MAC.ini file have the same meaning).Number signs (#) indicate the start of a comment. Comments can begin anywhere on a line. Everythingbetween the # and the End of Line is ignored.

Along with these general formatting conventions, use the following guidelines when you construct EnhancedSLE INI files:

1 Global Connect Parameters FirstList global connect parameters before other connect parameters in a wlx.ini file.

2 Connect is the Only Required ParameterAs previously stated, when you create an INI file, the only required parameter youmust enter is the Connectparameter. You can enter other parameters as desired, but they are not mandatory unless you requirechanges from the default values.

To create a connection using an INI file, you must specify the Connect= parameter, as well as the mandatoryconnect options associated with the specified connection type (for example, forMozilla Firefox or VMWareView). For more information about the Connect= parameter, including configuration examples, see ConnectParameter Options, on page 37.

3 Continue Lines Using Space and BackslashTo indicate line continuation, place a space and backslash (\) at the end of a line. The backslash meansthat the line and the following line are, for the purposes of reading code, the same line. No white spacecan appear after the backslash; the requirement of white space between parameter entries is maintainedby the use of the space before the backslash. In addition, starting all parameters at the left margin andplacing at least one leading space (or tab) at the beginning of all (and only) continuation lines makes anINI file easier to read.

Note that in circumstances where you require string concatenation, you can use a backslash without aspace before or after it to concatenate with the first set of characters from the previous line; for examplethe strings snow and ball may be concatenated to give snowball.

You must use the backslash continuation character to configure a connection with multiple parameters.For examples, see Connect Parameter Options, on page 37.

4 Blank Lines Make Files Easy to ReadUse blank lines to make the code easier to read.

5 Comment by Using Number SignAs stated previously, number signs (#) indicate the start of a comment. Comments can begin anywhereon a line. Everything between the # and the End of Line is ignored.

6 Values with White Spaces Require Quotation MarksYou must place parameter values containing white spaces inside quotation marks (use common-practicenesting rules).

7 Separate Lists by Using Semicolons or Commas


Getting started: INI file basicsINI file construction rules and recommendations

Use semicolons or commas for list separators.

8 Use the wlx.ini File to Set the Maximum Number of Connection Entries AllowedThe combined number of connection entries that you define in a wlx.ini file cannot exceed a defined totalmaximum number of connections. The maximum number of connections has a default limit of 216, butyou can modify this limit within a range of 100 to 1000 using the wlx.ini file.

9 Use System Variables with Some Options of the Connect ParameterSome options of the Connect parameter can use the system variables shown in the following table to mapthe string. All combinations of the variables are supported. For options that support use of system variables,see Connect Parameter Options, on page 37.

Table 1: System Variables

ValueOption

Serial number used.$SN

MAC address used.$MAC

IP Address used.$IP

Sign-on domain name used.$DN

Sign-on name used.$UN

Sign-on password used.$PW

Terminal name.$TN


Getting started: INI file basicsINI file construction rules and recommendations

C H A P T E R 3wlx.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.

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

Tip

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

• wlx.ini and $MAC.ini file general settings, page 9

• wlx.ini and $MAC.ini file peripheral settings, page 18

• Desktop keyboard shortcuts, page 24

• wlx.ini and $MAC.ini file connection settings, page 25

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


The underlined value for a parameter is the default value. Some parameters also have options shown withinbrackets [ ]. If an option has an underlined value (default), that option and default value will automaticallybe used with the parameter (options without underlined values can also be used if you want to, but are notautomatically used with the parameter). In addition, when using parameters and options, you can leavethe 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 anunderlined value (default of 0). You can still use Option2 if you want, however, Option2 is not automaticallyused with the parameter as Option2 does not have a default (underlined) value.

Note

Table 2: General Settings: wlx.ini and $MAC.ini Files

DescriptionParameter

Default is no.Specifies whether to mute the audio.

AudioMute={no, yes}

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

AudioVolume=<value of 0 to 100>


wlx.ini and $MAC.ini file parameterswlx.ini and $MAC.ini file general settings


BootOrder - Sets the boot order for the BIOS.

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

Note

Default is: Bootorder=H;S;U;F;C;PWhere 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 firstdetected USB key will be attempted; if this fails to boot, the bootwill fall back to the second detected USB key, and so on in orderof detection)

The boot order must follow these rules:Important

1 The boot order is a list of these values separatedby a semi-colon (;) or a comma (,).

2 Every value must be used.

3 The values must be different.

BootOrder

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

ChangeAdminPassword=<base-64 econded password>

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

ChangeGuestPassword=<base-64 encoded password>

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

ChangeRootPassword=<base-64 encoded password>

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

ChangeThinUserPassword=<base-64 encoded password>

Default is bottom.DesktopTaskBar-Specifies the position of the taskbar.

For example: DesktopTaskBar=left

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

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

DesktopTaskBar={bottom, top, left, right}

AutoHide={no, yes}

[AlwaysOnTop={no, yes}]




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

Disablemenubar={no, yes}

Default is yes.Specifies whether to disable the ready mode. When a device isshut down and ready mode is enabled, the device logs out of thesession, places the power button LED in a state of off, and thengoes 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 usingDisableReadyMode=no.

Example:

DisableReadyMode=no will enable ReadyMode functionality.

DisableReadyMode=yes will disable ReadyMode functionality.

DisableReadyMode={no, yes}

Default is no.Yes/no option to enable full screen mode (when selected it willdisable the Desktopsize option).

Fullscreenmode={no, yes}

Default is no.Configures the action of the device for an idle state.

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

By default, IdleAction.Enable=no.

Example:

IdleAction.Enable=yes

IdleAction.TimeOut=30

IdleAction.Action=/sbin/reboot

IdleAction.Enable={no, yes}

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

[IdleAction.Action=<Any valid Command>]

Default is no.Indicates whether to import certificates from the server. Certs isa list of certificate names (the names must be separated by asemicolon).

Certificates must be placed in the /wlx/certsdirectory.

Note

Example:

ImportCerts=yes

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

The certificatesmust be .crt, .pem, or any valid certificatetype.

Note

ImportCerts={no, yes}

[Certs=<list of certificate names>]




Includes another INI file at the position of this command.

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

Note

Include=<path/filename>

Default is cache.

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

• cache specifies that, if the server is available, the deviceuses the file on the INI file server; otherwise, the device usethe local cached INI file, cached/saved/used-at least-oncefile obtained from the file server.

• local specifies to use the INI created from settings made onthe thin client GUI

• server specifies to use the INI file server only. If the fileserver is not available, the devices does not fall back to thelocal cached INI file.

INIFileSource={cache, local, server}

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

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

Note

InstallAddons=<name of add-on>

OR

NewAddons= <name of add-on>




Default is the following order SRV, CNAME, HOSTNAME,UI, DHCP (if any of themethods specified in the INI file fails).Specifies the automatic discovery methods you want to use forthe automatic discovery of a thin client after failure of thin clientdiscovery. Use any or all of the following:

• SRV - DNS SRV Record (Dynamic Discovery) Allowsdevices to use the DNS SRV record lookup method todiscover a Cisco VXC Manager Server.

• CName - DNS Alias Allows devices to use the DNS Aliasmethod to discover a Cisco VXC Manager Server.

• Hostname - DNS Name Record (Dynamic Discovery)Allows devices to use the DNS Hostname lookup methodto discover a Cisco VXC Manager Server.

• UI - Allows devices to use the UI entries to discover a CiscoVXC Manager Server.

• DHCPOption Tags - (Dynamic Discovery) Allows devicesto use DHCP option tags to discover a Cisco VXCManagerServer.

• Static - Allows devices to use a static location to discovera Cisco VXC Manager Server.

When the Static option is used, theMgmtDiscoveryMethod parameter should be usedwith a valid Fully Qualified Domain Name or IPAddress.

Note

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

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

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

PasswordEncryptionCode- Default is yes. Specifies whether touse a Base64 encoded password. If no, a plain-text password isused.

Password=<encrypted password>

[PasswordEncryptionCode={yes, no}]




Default is interactive.Specifies the action the thin client takes when the power buttonis 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 sleepmode

none or nothing-No action (does nothing)

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

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

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

PowerManager={X,Y}

Specifies add-ons to uninstall. Use comma-separated add-onnames.

RemoveAddons=<name of add-on>

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

RootPath=<root path>




Default is 5 (minutes).

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

Put the parameters on the same line. For example:

ScreenSaver=5 LockTerminal=yes SoftSaver=yes

Type=coral,drift,hypertorus,interaggregate,pipes,skytentaclesCycleDelay=5

Note

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

• no-Disabled

• yes-Puts the thin client in a LOCK state when the screensaver is activated. The user is prompted with an unlockdialog box to enter the sign-on password to unlock the thinclient.

SoftSaver-Specifies whether the thin client runs a soft saver. Softsavers are available only when the optionalSCREENSAVER-THEMES add-on is installed.

• no-Displays a blank screen

• yes-Runs a graphical display

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}]




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

Type-Specifies which display programs should run ifSoftSaver=yes

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

Note

CycleDelay-When more than one Type name is specified,CycleDelay specifies howmany minutes each Type name shouldrun.

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

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

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

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

Note

ScreenSaver=<value of 0 to 180> ,continued

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.

SecureMode={neverconnect, warnbefore, donotverify}

Specifies the name of the thin client comprising a 15-characterstring.

TerminalName=<name of thin client>

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

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

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

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




Default is no.Specifies the time zone if the zone is unspecified on the thin clientor is used with ManualOverride.

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

For the complete list of TimeZone values, see TimeZoneparameter values, on page 57.

Note

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

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

Example:

UpdateBiosCmos=1

UpdateBiosCmos={no, yes}

Specifies the update mode for image upgrades.

Value and DescriptionBoth-Updates image and add-ons

Image-Updates image only

Addons-Updates add-ons only

None-Does not upgrade

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

Specifies whether to preserve changes while upgrading.

With update.preserve_changes=no, the thin client does not locallycache configuration settings during an image upgrade. Instead,the thin client erases all existing configurations and applies theconfiguration specified by the Cisco VXCManager package thatyou use to push the upgrade. This is the Cisco-recommendedsetting.

With update.preserve_changes=yes, the thin client preserves andapplies the previous device image configuration settings duringthe image upgrade.

Update.Preserve_changes={no, yes}

wlx.ini and $MAC.ini file peripheral settingsThe following table contains the parameters that you can use to configure peripheral settings such as keyboard,monitor, mouse, and printer. Default values are underlined.


wlx.ini and $MAC.ini file parameterswlx.ini and $MAC.ini file peripheral settings

Table 3: Peripheral Settings: wlx.ini and $MAC.ini Files


Specifies the amount of time to wait before the cursor is hidden(the cursor is hidden after the specified number of seconds). Afteryoumove or click themouse or press any keyboard key, the cursorreappears.

CursorHideDelay=<value of 1 to 60>

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 inHTML (rrggbb).

• A color name from the /usr/share/X11/rgb.txt file. Note thatthese names are case sensitive.

• Three integers in the range of 0 to 255 representing theamount of red, green, and blue, respectively (for example0 119 255).

This form is deprecated. It is available forbackward compatibility only.

Caution

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

The <primary color> is the primary color and the one which willbe 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"), theprimary color (in this example, DarkGoldenrod) appears on theleft (horizontal) or top (vertical) edge with a smooth transition tothe secondary color (in this example, LightGoldenrod) on theopposite edge.

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




Default is no wallpaper.Desktop-Specifies an image file to use as wallpaper for the localdesktop. The file must be located in the wlx/bitmap directory onthe server. The image file can be any type that is supported bySUSE/GNOME for use as wallpaper (such as PNG, JPG, andGIF). The filename is case sensitive.

Layout- Default is Center. Specifies the arrangement on thedesktop background of the specified image file. The tile valuereplicates the image across the desktop; the stretch value adjuststhe image to fill the screen; the scale value enlarges the image tofill 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 specifiedby the DeskColor option as though the image is not entirelyopaque. A value of 0 indicates total transparency, and the imageis not displayed at all.

For Example:

Desktop=ciscologo.gif Layout=Tile Opacity=25

Desktop=<image file>

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

[Opacity=<value of 0-100>]

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

DesktopColorDepth={8, 16, 24}

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

Possible values for:

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

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

Meaning of different positionvalues:

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

Note

Examples:

DisplaySettings="MON11024x768 on-left;MON21024x768@75on-right"

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

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




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

EnableNumLock={no, yes}

Default is yesSpecifies whether to forward all available printers for use in theRDP session. This parameter is supported with any direct RDPconnection (not supported through VMware View broker). Bydefault, ForwardPrinters is set to yes.

For example:

ForwardPrinters=yes

ForwardPrinters={yes, no}

The JetDirectPrinter command line defines a printer served byan HP JetDirect print server. For parameter options that are usedin the command line, see JetDirectPrinter in Printer parameteroptions, on page 49.

JetDirectPrinter=<value of an option>

The Keyboard.layouts parameter specifies the keyboard layout.For a list of supported keyboard layout values, seeKeyboard.layouts parameter values, on page 61.

Example:

Keyboard.layouts=us (for United States)

Keyboard.layouts=ru (for Russia)

Keyboard.layouts=<value of Keyboard.layouts>

Default is no.Specifies whether to mute the microphone volume.

MicMute={no, yes}

Default is 50.Specifies the microphone volume level.

MicVolume=<value of 0 to 100>

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

MouseLocate={no, yes)

For ICA only. Default is no.Allows the administrator to control the mouse button action in aUNIX environment.

The values are:

yes-In a UNIX environment, a middle mouse performs the samePaste function as the Ctrl+V keystroke combination inWindows.

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

MouseSendsControlV={no, yes}




Specifies the speed when moving the mouse.

You can use the following values for backwardcompatibility.

Note

You can use the following values for backward compatibility.

Value and Mouse Speed0-Slow (0.2)

1-Medium (default) (2.0)

2-Fast (6.0)

MouseSpeed=<value of 0 to 100>

Default is no.Specifies whether to swap the button order on the mouse. Thedefault value is no.

MouseSwap={no, yes}

Defines a printer that uses traditional UNIX Line Printer Daemonprotocols. For parameter options that are used in the commandline, see NetworkPrinter in Printer parameter options, on page49.

NetworkPrinter=<value of an option>

Default is no.Configures keyboard event grabbing in any direct RDP connectionsession (not supported throughVMware View broker). By default,NoGrabKeyboard is set to no.

For example:

NoGrabKeyboard=yes

NoGrabKeyboard={no, yes}

Defines a locally attached printer that is connected through thenoted interface. For parameter options that are used in thecommand line, see Printer in Printer parameter options, on page49.

Printer=<value of an option>

Defines a printer using a URI supported by the Common UNIXPrinting System (CUPS). This command is useful when you wantthe thin client to access a printer for which you already have aworking CUPS client because you can simply copy the URI fromthe /cups/printers.conf file on the existing client. For parameteroptions that are used in the command line, see PrinterURI inPrinter parameter options, on page 49.

PrinterURI=<value of an option>




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

For backward compatibility, you can also use the followingvalues:

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

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

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 Rate0-Slow (GUI value is 10)

1-Medium (default) (no GUI value)

2-Fast (GUI value is 110)

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

Defines a network printer shared through the Windows ServerMessage Block protocols. For parameter options that are used inthe command line, see SMBPrinter in Printer parameter options,on page 49.

SMBPrinter=<value of an option>

Default is FullScreenOnly.Enables keyboard shortcut sequences defined by the localWindows manager in the session.

FullScreenOnly-Key event is processed locally except inFullscreen mode

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

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

TransparentKeyPassThrough= {Local, Remote, FullScreenOnly}

For VMware View OnlySpecifies USB devices that are excluded from the VMWare Viewsession in a comma-separated list of vendor IDs and product IDs.

For example:

VMWareViewExcludeUSBID=vid148fpid2770,vid0x13d3pid3273

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




For VMware View OnlySpecifies USB device families that are excluded from theVMWare View session in a comma-separated list.

For example:

VMWareViewExcludeUSBFamily=bluetooth

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

For VMware View OnlySpecifies USB devices that are included in the VMWare Viewsession in a comma-separated list of vendor IDs and product IDs.

For example:

VMWareViewIncludeUSBID=vid148fpid2770,vid0x13d3pid3273

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

For VMware View OnlySpecifies USB device families that are included in the VMWareView session in a comma-separated list.

For example:

VMWareViewIncludeUSBFamily=bluetooth

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

Desktop keyboard shortcutsDepending on the type of application window you are using (full screen, standard, or seamless), you can useshortcut keys to manage windows.

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

Table 4: Desktop Keyboard Shortcuts

INI parameter to disable shortcutActionPress

Cisco.DisableKeyBinding.Close=yesClose windowAlt+F4

Cisco.DisableKeyBinding.Close=yesClose browser windowCtrl+F4

Not applicableMaximize windowAlt+F10

Cisco.DisableKeyBinding.Minimize=YesMinimize windowAlt+F9

Cisco.DisableKeyBinding.ShowDesktop=yesMinimize or maximize all windowsAlt+Ctrl+DownArrow

Cisco.DisableKeyBinding.MouseButtonModifier=yesMouse modifier (used by default as amouse modifier)

Alt

Not applicableMove focus to next windowAlt+Esc

Not applicableMove focus to previous windowAlt+Shift+Esc


wlx.ini and $MAC.ini file parametersDesktop keyboard shortcuts

INI parameter to disable shortcutActionPress

Not applicableMove window with arrow keysAlt+F7 and press an arrowkey

Not applicableResize the windowAlt+F8 and press an arrowkey

Not applicableRestore maximized window to previoussize

Alt+F5

Not applicableSwitch keyboard focus back to thinclient (used by Citrix Linux receiver tobring keyboard focus back to thin clientlocally)

Ctrl+F2

Cisco.DisableKeyBinding.SwitchWindows=yesSwitch windows using a dialog boxAlt+DownArrow

Not applicableSwitch panel focusAlt+Ctrl+Shift+DownArrow

Cisco.DisableKeyBinding.RunCommand1=yesShow Logout optionAlt+Ctrl+Delete

Cisco.DisableKeyBinding.PanelMainMenu=yesShow Computer Menu windowAlt+F1

Cisco.DisableKeyBinding.PanelMainMenu=yesShow Windows start menuCtrl+Esc

Cisco.DisableKeyBinding.PanelMainMenuList=yesShow main panel list when keyboardfocus is shifted to the thin client

Windows Key

Cisco.DisableKeyBinding.WindowMenu=yesShow window menuAlt+Space (you can alsoright-click the window titlebar or border, or click thewindow icon)

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

Tip

wlx.ini and $MAC.ini file connection settingsThe following table describes the parameters that you can use to configure connection settings. Default valuesare underlined.

Table 5: Connection Settings: wlx.ini and $MAC.ini Files


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

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


wlx.ini and $MAC.ini file parameterswlx.ini and $MAC.ini file connection settings


For ICA only.

Default is no.

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

Alternate={no, yes}

Default is no.Specifies whether to automatically log the user off when allconnections are closed.

AutoSignoff={no, yes}

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

Browser.Homepage=<URL>

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

Browser.Prefsurl=<URL>

Specifies the connection protocol.

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

Connect Parameter Options, on page 37 describes theseparameters:

• BROWSER, seeMozilla Firefox Connect options, on page37

• ICA, see ICA Connect options with XenApp, on page 39

• RDP, see RDP Connect options, on page 42

• VMWARE_VIEWCLIENT, see VMware View ClientConnect options, on page 45.

For details about configuring a XenDesktop connection, seeXenDesktop connection example, on page 38 and MozillaFirefox Connect options, on page 37.

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

Note

Connect={BROWSER, ICA,RDP,VMWARE_VIEWCLIENT}

Default is no.Yes/no option to disable the listing of View desktops after sessionlogout (when an error occurs).

Disableconnectonce={no, yes}

Specifies whether to disable the display of a Domain field. Thedefault 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, itdefaults to no (the display of a Domain field does display).

DisableDomain={no, yes}




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

DisableVNC={no, yes}

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

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

For example:

DomainList="North_America, SQA, test-domain"

Note

DomainList=<list of Windows domain names>

Maps drives on the server to USB mass storage devices that areattached 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.

Be sure each drive command is separated by aspace.

Note

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

Default is no.EnableBanner—Provides a banner description.

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

EnableBanner={no, yes}

[BannerMsg=<text description>]

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.

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

Note

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




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

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 thesame vendor ID group of devices regardless of theirproduct ID.

Important

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 aspace between vid and pid and each device is separated with acomma.

or

ICAAllowUSB=vid=1234, vid=5678

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

Do not use both ICADenyUSB and ICAAllowUSB inthe same INI file. By default, all USB devices areallowed. ICAAllowUSB results in a denial of all otherdevices other than those specified by ICAAllowUSB.ICADenyUSB only denies the specified devices, butallows others.

Note

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




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

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 thesame vendor ID group of devices regardless of theirproduct ID.

Important


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 aspace between vid and pid and each device is separated with acomma.

or

ICADenyUSB=vid=1234, vid=5678

This example excludes all USB devices that have the specifiedVIDs.

Do not use both ICADenyUSB and ICAAllowUSB inthe same INI file. By default, all USB devices areallowed. ICAAllowUSB results in a denial of all otherdevices other than those specified by ICAAllowUSB.ICADenyUSB only denies the specified devices, butallows others.

Note

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

Specifies a file server from which the device can access filesusing the specified protocol. If no protocol is specified, FTP isassumed (for example, 192.168.0.1 is understood asftp://192.168.0.1).

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

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

HomePage=<URL>

For ICA only.

Default is http.

Specifies the default browsing protocol. This setting can beoverridden by the HttpBrowsing={yes,no,ssl} in each connectionproperty.

ICABrowsing={udp, http, https}




For ICA only.Maps serial devices on the server to serial devices on the thinclient, where x=1 to 4; if COMy, map to that serial port on thethin client; if USBSERz, map to that USB serial port.

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

Note

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

For ICA only.

Default is yes.

Specifies whether to enable Citrix HDXUSB startup (for DesktopAppliance Mode) for any USB devices that are already pluggedin (the USB device will start up provided the device is notdisallowed with a deny rule in the USB policies on either theserver [registry entry] or the client [policy rules configurationfile]). This parameter requires two thin client reboots.

IcaDesktopApplianceMode={yes, no}

For ICA only.To map drives on the server to USB mass storage devices thatare 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.

Be sure each drive command is separated by aspace.

Note

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

For ICA only.

Default is no.

Enables/Disables Citrix enhanced audio.

true—enables Citrix enhanced audio

false—disables Citrix enhanced audio

IcaEnhancedAudio={no, yes}




For ICA only.

Default is yes.

Specifies whether to allowmapping of the hotkeys. For example:

ICAhotkey=yes

Hotkey1Char=F1 Hotkey1Shift=Shift Hotkey2Char=F3Hotkey2Shift=Shift Hotkey3Char=F2 Hotkey3Shift=ShiftHotkey4Char=F1 ..... Hotkey11Char=plus Hotkey11Shift=Ctrl

You must enter all hotkey options on oneline.

Note

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

For ICA only.

Default is yes.

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

For example:

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

ICADesktopApplianceMode=yes

ICAMMVideo=yes

ICAMMAudio=no

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


ICAMMVideo=yes

ICAMMAudio=yes

IcaMMAudio={yes, no}




For ICA only.

Default is yes.

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

For example:

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


ICAMMVideo=yes

ICAMMAudio=no

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


ICAMMVideo=yes

ICAMMAudio=yes

IcaMMVideo={yes, no}

For ICA only.

Default is no.

Specifies whether to enable Citrix multimedia redirection.

yes—Enables Citrix multimedia redirection

no—Disables multimedia redirection

ICAMultiMedia={no, yes}

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

ICAProxyHost=<proxy server IP address>

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

ICAProxyType=[None, HTTP, SOCKS]

DO NOT USE.This parameter is being deprecated and the use of PNAgentServeris recommended.

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




For RDP only.

Default is no.

Specifies whether to enable Network Level Authentication forRDP sessions.

NLA={no, yes}

Default is no.Specifies whether to enable login through SSH as the Linuxsuperuser (root).

PermitSSHRootLogin={no, yes}

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

Default is Empty.

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

DO NOT USE.This parameter is being deprecated and the use of PNAgentServeris recommended.

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

Default port number is 443.Designates the HTTP(S) secure port used for the Cisco VXCManager agent.

Example:

RapportServer=192.168.0.2:80

RapportSecurePort=443

RapportSecurePort=<port>

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

RapportServer=<host address>[:port]

For RDP only.

Default is yes.

Specifies whether to enable or disable the clipboard in an RDPsession.

RdpClipBoard={yes, no}

For RDP only.

Default is yes.

Specifies whether to enable or disable drive mapping in an RDPsession.

RdpDriveMap={yes, no}

Default is no.Specifies whether to set the default resolution for ICA-publishedapplications to seamless.

Seamless={no, yes}




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.

You must specify the parameters in the ordershown.

Note

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}}

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

Users may experience problems with over-scrolling when usingsome published applications. You can address this problem byadjusting the value to a greater number.

StopWatchMin=<integer value>

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


VMWareViewExcludeUSBFamily=<USB device family>,...

For example:

VMWareViewExcludeUSBFamily=audio,storage

This example excludes all USB devices per their deviceclass/family.

VMWareViewExcludeUSBFamily=<USB device family>,...

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


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

For example:

VMWareViewExcludeUSBID=vid148fpid2770,vid0x13d3pid3273

This example excludes two USB devices. Note that there is nospace between vid and pid and each device is separated with acomma.

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




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


VMWareViewIncludeUSBFamily=<USB device family>,...

For example:

VMWareViewIncludeUSBFamily=audio,storage

This example includes all USB devices per their deviceclass/family.

VMWareViewIncludeUSBFamily=<USB device family>,...

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


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

For example:

VMWareViewIncludeUSBID=vid148fpid2770,vid0x13d3pid3273

This example includes two USB devices. Note that there is nospace between vid and pid and each device is separated with acomma.

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

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

VNCAuthTypes={none, vnc}

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

If no VNCPasswd is specified, the default passwordis password.

Important

VNCPasswd= {<base-64 encoded password>}

Default is yes.Specifies whether to prompt the user before shadowing starts, inwhich case the user can select to decline or accept VNCshadowing.

VNCPrompt=yes means the user is always prompted beforeshadowing starts.

VNCPrompt=no means the user cannot decline or acceptshadowing.

VNCPrompt={yes, no}

Specifies the font server for X11 applications.

When the font server address is set by the GUI, the GUIhas priority, and the parameters from the INI file areignored.

Note

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



A P P E N D I X AConnect Parameter Options

This appendix provides the connect options that you can use for the supported connections.

You can use the Connect parameter in wlx.ini and $MAC.ini files.Tip

Mandatory options for a Connect parameter are marked as Mandatory Option in the option description.Note

• Mozilla Firefox Connect options, page 37

• XenDesktop connection example, page 38

• ICA Connect options with XenApp, page 39

• RDP Connect options, page 42

• VMware View Client Connect options, page 45

Mozilla Firefox Connect optionsThe following table contains the supported options you can use for Mozilla Firefox connections. Defaultvalues are underlined.

Example:CONNECT=BROWSER \Description="Cisco Home Page" \URL=http://www.cisco.com \Resolution=FullScreen \Mode=Normal

Table 6: Mozilla Firefox Connect Options

DescriptionOption

Default is no.Specifies whether to start a connection automatically at sign-on.

AutoConnect={no, yes}


DescriptionOption

Specifies a connection name for the Desktop icon and theConnection Manager.

The text must be enclosed in double quotation marks if it containsspaces or punctuation characters. These characters are not allowed:& ' " $ ? ! | ; ( ) [ ] { } \

Description=<string description>

Specifies an icon to appear on the local desktop or ConnectionManager. The file must be located in the wlx/bitmap directoryon the server. If no image file is specified, the default icon isdisplayed (except in the case of a published application).Supported file types are PNG, JPEG, and GIF, as well as XPMfor backward compatibility.

Icon=<image file>

Launches Firefox in kiosk or normal mode. (In kiosk mode,Firefox appears full-screen on the desktop, and the user has noaccess to the address bar.)

Mode={kiosk, normal}

Default is no.Specifies whether to enable automatic reconnection to anapplication server after a disconnection.

Reconnect={no, yes}

Default is 30.Specifies the amount of time in seconds to wait before automaticreconnection to an application server after a disconnection.Requires Reconnect=yes or 1.

ReconnectSeconds=<value in seconds>

Default is FullScreen.Specifies the connection window size.

Resolution={640x480, 800x600, 1024x768, 1280x1024,1600x1200, FullScreen}

Specifies the starting URL.URL=<URL>

XenDesktop connection exampleTo create XenDesktop server connections, use the Mozilla Firefox Connect options to specify the URL of theXenDesktop server to which users must connect. When the server URL is specified in the INI configuration,Firefox opens to this URL and the user can enter their credentials to initiate the connection to the HVD.

Example:CONNECT=BROWSER \Description="Windows Desktop" \URL=http://xd.company.com \Reconnect=yes \ReconnectSeconds=5 \AutoConnect=yes \mode=kiosk


Connect Parameter OptionsXenDesktop connection example

In the above example, replace xd.company.com with the URL of your XenDesktop server.Caution

With the optional Autoconnect=yes parameter specified in the preceding example, the browser connects tothe specified URLwhen the client boots up. In addition, the optional Reconnect=yes and ReconnectSeconds=5parameters specify to reconnect a disconnected connection after 5 seconds. Finally, the optional mode=kioskparameter specifies to operate in kiosk mode, in which Firefox operates in full-screen mode with no accessto the address bar.

ICA Connect options with XenAppThe following table contains the supported options you can use for ICA connections with XenApp. Defaultvalues are underlined.

The Cisco VXC 6215 supports the ICAConnect Options only with XenApp connections. The ICAConnectOptions are not supported with XenDesktop connections. To configure a XenDesktop connection, youcan use the Mozilla Firefox Connect INI parameters to specify the URL of the XenDesktop server towhich users connect (see XenDesktop connection example, on page 38).

Note

Example:CONNECT=ICA \BrowserIP=10.150.123.30 \Application="Desktop" \Description="ICA_Desktop " \AutoConnect=yes \Reconnect=yes \Encryption=128 \Colors=16m \Fullscreen=no \Resolution=800x600 \Username=$UN \Password=$PW \Domainname=$DN \Alternate=yes \LowBand=yes

Table 7: ICA Connect Options with XenApp

DescriptionOption

Mandatory OptionSpecifies the published application to launch.

Application=<published application>

Default is no.Specifies whether to start a connection automatically after sign-on.


Lists IP addresses or DNS registered names to specify ICAbrowsers. You must separate items on the list by semicolons orcommas.

BrowserIP=<list of browsers>


Connect Parameter OptionsICA Connect options with XenApp

DescriptionOption

Default is 64k.Specifies the session color mode. For faster display performance,use 256 colors.

Colors={256, 64k, 16m}


The text must be enclosed in double quotation marksif it contains spaces or punctuation characters. Thesecharacters are not allowed: & ' " $ ? ! | ; ( ) [ ] { } \

Caution


Specifies the domain name in aWindows network. $DN specifiesto use the thin client sign-on domain name.

DomainName={<Windows domain name>, $DN}

Default is Basic.Specifies the connection security level. The highest level is 128-bitsecurity; the lowest level is Basic.

Encryption={Basic, 40, 56, 128, Login-128, RC5, None}

Default is no.Runs the session at full screen (not in a window).

FullScreen={no, yes}

Mandatory OptionSpecifies a host or list of host values. The thin client attempts toconnect to the next server on the list if the current one fails. Listitems must be separated by semicolons or commas.

Mandatory if no application option isspecified.

Important

* Host=<host address>[;<host address>...]

Default is 1.Designates the browsing protocol:

• 0=udp

• 1=http (default)

• ssl=https

HttpBrowsing={0, 1, ssl}

Specifies an icon to appear on the thin client desktop for thisconnection. The file must be located in the server wlx/bitmapdirectory. If no image file is specified, the default icon is displayed(except in the case of a published application). Supported filetypes are PNG, JPEG, and GIF, as well as XPM for backwardcompatibility.

Icon=<image file>

Default is no.Specifies whether to enable optimization for low-speedconnections, such as reducing audio quality and decreasingprotocol-specific cache size.

LowBand={no, yes}

Default is no.Specifies whether to turn off compression.

NoReducer={no, yes}



DescriptionOption

Specifies the password required to log in to the application server.You can specify either a base-64 encoded login password or avariable.

password-Base-64 encoded login password

Variable and Description$SN-Serial number

$MAC-MAC address

$IP-IP address

$DN-Sign-on domain name

$UN-Sign-on name

$PW-Sign-on password

$TN-Terminal name

The application server password is not encrypted; notspecifying it is strongly recommended. The user willbe prompted to enter the password when theconnection is made. This application server passworddirective never starts a line, so it can be distinguishedfrom the thin client user sign-on password (whichstarts a line).

Caution

Password={<base-64 encoded password>, $SN, $MAC, $IP,$DN, $UN, $PW, $TN}

Default is yes.Specifies whether to enable ping. For nonpublished applicationconnections, the thin client sends an ICMP ping to the host serverbefore connecting to verify that the host is reachable.

ping={yes, no}

Default is no.Controls automatic reconnection to an application server after adisconnection.

Option Value and Action:yes-Immediately restarts the connection 30 seconds after adisconnect. Default for reconnect is 30 seconds.

no-(default) Does not reconnect after a disconnect.

1...3600-(integer) Specifies the interval to wait (in seconds) beforeautomatically restarting the connection after a disconnection.Valid range is 1 to 3600.

Reconnect={no, yes, <value of 1 to 3600>}

Default is default, which starts the connection using thecurrent desktop display setting.Specifies the connection display resolution. The default valuestarts the connection using the current desktop display setting. Ifthe connection is to a published application, the seamless selectionis available.

Resolution={default, seamless, 640x480, 800x600, 1024x768,1280x1024, 1600x1200}



DescriptionOption

Specifies the name required to login to the application server.You can specify either a conventional login name or a variable.

Variable and Descriptionusername-Conventional log-in name

$SN-Serial number

$MAC-MAC address

$IP-IP address


$UN-Sign-on name


$TN-Terminal name

Username={<username>, $SN, $MAC, $IP, $DN, $UN, $PW,$TN}

RDP Connect optionsThe following table contains the supported options you can use for RDP connections. Default values areunderlined.

Example:CONNECT=RDP \Host=10.150.123.35 \Description="RDP_Server" \AutoConnect=yes \Colors=16m \Username=Administrator \Password=Password \Domainname=$DN \Resolution=800x600 \Reconnect=no \Drives=J=disk \Drives=k=floppy \Sound=off

Table 8: RDP Connect Options

DescriptionOption

Default is no. Specifies whether to start a connectionautomatically after sign-on.


Default is 64K or High (these values are the same).Specifies the session color mode. For faster display performance,use 256 colors.

Colors={256, 64k, High, 16m}

Lists a string of commands to be executed after logging in to theserver. The maximum is 127 characters.

Command=<start command>


Connect Parameter OptionsRDP Connect options

DescriptionOption



Caution


Specifies a directory to be used as the working directory afterlogging in to the server. The maximum is 63 characters.

Directory=<working directory>

Specifies the domain name in aWindows network. $DN specifiesto use the thin client sign-on domain name.

DomainName={<Windows domain name>, $DN}

Maps drives on the server to USB mass storage devices that areattached to the thin client, where

drive letter=A to Z

floppy=USB floppy

cdrom=USB CDROM

disk=USB drive or memory

rw=read/write

ro=read only

basedir=an optional directory on the USB device to use.Be sure each drive command is separated by a space.Note

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

If you specify none, no encryption is used.Use this option when connecting to a server with dataencryption between the communication of the server andthe client.

NoteEncryption=none

Default is no.Runs the session at full screen (not in a window).


Mandatory OptionSpecifies a host or lists of host values. The thin client attemptsto connect to the next server on the list if the current one fails.You must separate list items by semicolons or commas.


Specifies an icon to appear on the thin client desktop for thisconnection. The file must be located in the server wlx/bitmapdirectory. If no image file is specified, the default icon is displayed(except in the case of a published application). Supported filetypes are PNG, JPEG, and GIF, as well as XPM for backwardcompatibility.

Icon=<image file>

Default is no.Specifies whether to enable optimization for low-speedconnections, such as reducing audio quality and/or decreasingprotocol-specific cache size.

LowBand={no, yes}



DescriptionOption

Maps parallel devices on the server to parallel devices on the thinclient, where x=1 to 4; if LPTy, map to that parallel port on thethin client; if USBLPz, map to that USB parallel port.

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

Note

Windows 2000 servers do not support LPT portmapping.

Note

LPTports=LPTx={LPTy, USBLPz}, LPTx=...

Default is false.Specifies whether to enable Network Level Authentication forthe RDP session.

NLA={false, true}


Variable and Descriptionpassword-Conventional login password

$SN-Serial number

$MAC-MAC address

$IP-IP address


$UN-Sign-on name


$TN-Terminal name

The application server password is not encrypted; notspecifying it is strongly recommended. The user willbe prompted to enter the password when theconnection is made. This application server passworddirective never starts a line so it can be distinguishedfrom the thin client user sign-on password, whichstarts a line.

Caution



ping={yes, no}

Default is 5 (servers running RDP 5 are accessed).Access servers running RDP 4 or RDP 5. To access serversrunning RDP 4, set the protocol to 4.

Protocol={4, 5}



DescriptionOption

Controls automatic reconnection to an application server after adisconnection.

Option Value and Actionyes-(default) Immediately restarts the connection 30 seconds aftera disconnect. The default for a reconnection is 30 seconds.

no-Does not reconnect after a disconnect.

Reconnect={yes, no}

Specifies the interval to wait (in seconds, an integer, 1...3600)before automatically restarting the connection after adisconnection. Valid range is 1 to 3600.

ReconnectSeconds=<value of 1 to 3600>

Default is default (starts the connection using the current desktopdisplay setting). Specifies the connection display resolution.

Resolution={default, seamless, 640x480, 800x600, 1024x768,1280x1024, 1600x1200}

Default is local.Specifies if and where to enable sound.

off-Disable sound

local-Enable sound to local machine (default)

remote-Enable sound to remote

Sound={off, local, remote}

Specifies the name required to log in to the application server.You can specify either a conventional login name or a variable.

Variable and Descriptionusername-Conventional login username

$SN-Serial number

$MAC-MAC address

$IP-IP address


$UN-Sign-on name


$TN-Terminal name

Username={<username>, $SN, $MAC, $IP, $TN, $DN, $UN,$PW}

VMware View Client Connect optionsThe following table contains the supported options you can use for VMware View Client connections. Defaultvalues are underlined.


Connect Parameter OptionsVMware View Client Connect options

The Cisco VXC 6215 Firmware Release 9.0 supports VMware View Client 1.7, which requires you toenable SSL for all connections to a View Connection Server.

Note

Example:CONNECT=VMWARE_VIEWCLIENT \Description="VMview" \Host=192.168.0.2 \DomainName=$DN \AutoConnect=yes \Fullscreen=yes \Ping=yes \UseSSL=yes \Username=Administrator \Password=cGFzc3dvcmQorPassword=$MAC

Table 9: VMware View Client Connect Options

DescriptionOption

Default is no.Specifies whether to start a connection automatically at sign-on.




Caution


Specifies the published desktop name.Desktop=<string>

Default is smallwindow.Specifies the desktop size. Valid values include useallmonitors,fullscreen, largewindow (or largescreen), and smallwindow (orsmallscreen), or you can specify the exact size in the form XxY.

Useallmonitors specifies to enable a session to display on allconnected monitors.

Largewindow is handled the same as largescreen.

Smallwindow is handled the same as smallscreen.

Desktopsize={useallmonitors, fullscreen, largewindow,largescreen, smallwindow, smallscreen, <X>x<Y>}

Default is no.Enables or disables the listing of View desktops after sessionlogout or when an error occurs.

DisableConnectOnce={yes,no}

Default is no.Disables or enables the Full Screen drop down menu bar.

DisableMenuBar={yes,no}

Specifies the domain name in a Windows network where theVMware server is located.

Domain=<string>



DescriptionOption

Default is no.Runs the session at full screen (not in a window). This parameteris used to make the View client connection dialog box (thatdisplays all available View desktops) display at full screen.


Default is no.Enables or disables full screen mode. When enabled, thisparameter disables the Desktopsize option.

FullScreenMode={no, yes,}

Mandatory Option.Specifies a host or list of host values. The thin client attempts toconnect to the next server on the list if the current one fails. Listitems must be separated by semicolons or commas.


Default is yes.Specifies whether to enable interactive connection mode.

Interactive={yes, no}


Variable and Descriptionpassword—base-64 encoded login password

$SN—Serial number

$MAC—MAC address

$IP—IP address

$DN—Sign-on domain name

$UN—Sign-on name

$PW—Sign-on password

$TN—Terminal name

The application server password is not encrypted; notspecifying it is strongly recommended. The user willbe prompted to enter the password when theconnection is made. This application server passworddirective never starts a line, so it can be distinguishedfrom the thin client user sign-on password (whichstarts a line).

Caution



ping={yes, no}

Specifies a port number other than the default 80 or 443. Defaultport is 80 or, if you enable UseSSL, the default port is 443.

Port=<string>



DescriptionOption

Default is no.Controls automatic reconnection to an application server after adisconnection.

• yes— Immediately restarts the connection 30 seconds aftera disconnect. Default for reconnect is 30 seconds.

• no— (default) Does not reconnect after a disconnect.

• <value of 1 to 3600>— (integer) Specifies the interval towait (in seconds) before automatically restarting theconnection after a disconnection. Valid range is 1 to 3600.

Reconnect={no, yes}, <value of 1 to 3600>

This parameter determines how the client proceeds when it cannotverify that the connection to the server is secure.

• neverconnect: Never connects to untrusted servers.

• warnbefore: Warns before connecting to untrusted servers.

• donotverify: Does not verify server identify certificates

SecureMode={neverconnect, warnbefore, donotverify}

Specifies the name required to login to the application server.You can specify either a conventional login name or a variable.

Variable and Descriptionusername—Conventional login name

$SN—Serial number

$MAC—MAC address

$IP—IP address

$DN—Sign-on domain name

$UN—Sign-on name

$PW—Sign-on password

$TN—Terminal name

Username={<username>, $SN, $MAC, $IP, $DN, $UN, $PW,$TN}

Default is no.Specifies whether to enable a secure connection (HTTPS).

UseSSL={no, yes}



A P P E N D I X BPrinter parameter options

This appendix provides the options that you can use for the supported printer parameters.

You can use supported printer parameters in wlx.ini and $MAC.ini files.Tip

• JetDirectPrinter, page 49

• NetworkPrinter, page 51

• Printer, page 52

• PrinterURI, page 53

• SMBPrinter, page 55

JetDirectPrinterThe following table describes the supported options you can use for the JetDirectPrinter parameter. Defaultvalues are underlined.

The JetDirectPrinter command line defines a printer that is served by an HP JetDirect print server.

Only the Name option is required for all supported printer parameters; other options you can use for theprinter parameter are optional.

Caution

Example:JetDirectPrinter=<hostaddress><options you want>


Table 10: JetDirectPrinter Options

DescriptionOption

Specifies whether the option block defines the default printer forthe thin client. If you specify this option on more than one printerdefinition in the INI file, the last instance you specify (withDefault=yes) is the default.

[Default={yes, no}]

Offers a short, human-readable description of the printer beingdefined. If the description includes blank spaces, youmust enclosethe full description in quotation marks.

[Description=<text>]

Specifies whether the printer is available for use.[Enable={yes, no}]

This parameter is retained for backward compatibility; otherwise,it is ignored.

[EnableLPD={yes, no}]

Identifies the printer for the purpose of choosing a Linux printerdriver (for example, "HP LaserJet 4"). Usually this parameter isnot specified for all locally attached printers; it is used for LPRprinters on the network.

[ModelID=<Linux driver name>]

Specifies both the name that is given in the local printers list andthe internal name of the local print queue. Namemust be between1 and 16 characters, starting with a letter and composed entirelyof letters, digits, underscores, and dashes.

This parameter is mandatory (all other commonparameters are optional).

Note

[Name=<printer name>]

Identifies the printer for the purpose of choosing a Windowsprinter driver (for example, "Brother MFC-420CN Printer").Specify this parameter if you are forwarding the printer accessto a Citrix or RDESKTOP connection.

[PrinterID=<Windows driver>]

Default is no.Specifies whether to automatically locate and register availableprinters.

[printers.autolocate={no, yes}]

Directly specifies a Postscript Printer Definition filename for useas a local printer driver.

The PPD option can be useful when you attach a localprinter for which you already have a Common UNIXPrinting System (CUPS) configuration on anothersystem.

Note

[PPD=<PPD name>]

Sets the class name for a printer. For example:ThinPrintClass=LaserJet-Series=PCL5;DeskJet-S eries=PS

ThinPrintClass= PrinterName1=Class1[;PrinterName2=Class2]


Printer parameter optionsJetDirectPrinter

NetworkPrinterThe following table describes the supported options you can use for the NetworkPrinter parameter. Defaultvalues are underlined.

The NetworkPrinter command line defines a printer that uses traditional UNIX Line Printer Daemon protocols.


Caution

Example:NetworkPrinter=<LPDQueue>=<printer-queue-name-on-server>

Table 11: NetworkPrinter Options

DescriptionOption

Specifies whether the option block defines the default printer forthe thin client. If you specify this option on more than one printerdefinition in the INI file, the last definition you specify (withDefault=yes) is the default.

[Default={yes, no}]










Note





Printer parameter optionsNetworkPrinter

DescriptionOption





Note

[PPD=<PPD name>]

Sets the class name for a printer.

For example:

ThinPrintClass=LaserJet-Series=PCL5;DeskJet-S eries=PS


PrinterThe following table contains the supported options you can use for the Printer parameter. Default values areunderlined.

The Printer command line defines a locally attached printer connected through the noted interface.


Caution

Example:Printer={[USB][USB1][USB2][USBLPT1][USBLPT2][USBSER1][USBSER2][COM1][COM2]} <options you want>

Table 12: Printer Options

DescriptionOption


[Default={yes, no}]





Printer parameter optionsPrinter

DescriptionOption







Note








Note

[PPD=<PPD name>]


Example:



PrinterURIThe following table contains the supported options you can use for the PrinterURI parameter. Default valuesare underlined.

The PrinterURI command line defines a printer using a URI that is supported by the Common UNIX PrintingSystem (CUPS). This command is useful when you want the thin client to access a printer for which youalready have a working CUPS client because you can simply copy the URI from the /cups/printers.conf fileon the existing client.


Printer parameter optionsPrinterURI


Caution

Example:PrinterURI=[ipp://[user[:password]@host[:port]/path[http://[user[:password]@host[:port]/path[socket://host[:port][lpd://host/queue[smb://[user[:password]@[workgroup/]server[:port]/sharename[usb:/dev/usb/lpunit[parallel:/dev/lpunit[serial:/dev/ttySunit?baud=speed<options you want>

Additional protocols beyond those listed here (for example, FTP and TFTP) may be supported by theCUPS system on the thin client.

Tip

Table 13: PrinterURI Options

DescriptionOption


[Default={yes, no}]










Note



Printer parameter optionsPrinterURI

DescriptionOption






The PPD option can be useful when you attach a localprinter for which you already have a CUPS configurationon another system.

Note

[PPD=<PPD name>]


Example:



SMBPrinterThe following table contains the supported options you can use for the SMBPrinter parameter. Default valuesare underlined.

The SMBPrinter command defines a network printer shared using the Windows Server Message Blockprotocols.


Caution

Example:SMBPrinter=<hostaddress>[username=<username>][password=<password>][domain=<Windows domain>] <options you want>

Table 14: SMBPrinter Options

DescriptionOption


[Default={yes, no}]


Printer parameter optionsSMBPrinter

DescriptionOption










Note

Name=<printer name>






The PPD option can be useful when you attach a localprinter for which you already have a CUPS configurationon another system.

Note

[PPD=<PPD name>]


Example:




Printer parameter optionsSMBPrinter

A P P E N D I X CTimeZone parameter values

The following table contains the supported values that you can use for the TimeZone parameter.

You can use the TimeZone parameter in wlx.ini and $MAC.ini files.Tip

The TimeZone parameter must be followed by the ManualOverride=true option.Caution

Example:

TimeZone="US/Pacific" ManualOverride=true \

Table 15: TimeZone Values for wlx.ini files

ValueContinent/Country

The following values must be preceded with Africa/. For example, Africa/Abidjan is the value for theAbidjan time zone.

Abidjan, Accra, Addis_Ababa, Algiers, Asmara, Asmera, Bamako, Bangui, Banjul, Bissau, Blantyre,Brazzaville, Bujumbura, Cairo, Casablanca, Ceuta, Conakry, Dakar, Dar_es_Salaam, Djibouti, Douala,El_Aaiun, Freetown, Gaborone, Harare, Johannesburg, Kampala, Khartoum, Kigali, Kinshasa, Lagos,Libreville, Lome, Luanda, Lubumbashi, Lusaka, Malabo, Maputo, Maseru, Mbabane, Mogadishu,Monrovia, Nairobi, Ndjamena, Niamey, Nouakchott, Ouagadougou, Porto-Novo, Sao_Tome, Timbuktu,Tripoli, Tunis, Windhoek

The following values can be used without being preceded with Africa/: Egypt, Libya

Africa



The following values must be preceded with America/. For example, America/Adak is the value for theAdak time zone.

Adak, Anchorage, Anguilla, Antigua, Araguaina, Argentina/Buenos_Aires, Argentina/Catamarca,Argentina/ComodRivadavia, Argentina/Cordoba, Argentina/Jujuy, Argentina/La_Rioja,Argentina/Mendoza, Argentina/Rio_Gallegos, Argentina/San_Juan, Argentina/San_Luis,Argentina/Tucuman, Argentina/Ushuaia, Aruba, Asuncion, Atikokan, Atka, Bahia, Barbados, Belem,Belize, Blanc-Sablon, Boa_Vista, Bogota, Boise, Buenos_Aires, Cambridge_Bay, Campo_Grande,Cancun, Caracas, Catamarca, Cayenne, Cayman, Chicago, Chihuahua, Coral_Harbour, Cordoba,Costa_Rica, Cuiaba, Curacao, Danmarkshavn, Dawson, Dawson_Creek, Denver, Detroit, Dominica,Edmonton, Eirunepe, El_Salvador, Ensenada, Fort_Wayne, Fortaleza, Glace_Bay, Godthab, Goose_Bay,Grand_Turk, Grenada, Guadeloupe, Guatemala, Guayaquil, Guyana, Halifax, Havana, Hermosillo,Indiana/Indianapolis, Indiana/Knox, Indiana/Marengo, Indiana/Petersburg, Indiana/Tell_City,Indiana/Vevay, Indiana/Vincennes, Indiana/Winamac, Indianapolis, Inuvik, Iqaluit, Jamaica, Jujuy,Juneau, Kentucky/Louisville, Kentucky/Monticello, Knox_IN, La_Paz, Lima, Los_Angeles, Louisville,Maceio,Managua,Manaus,Marigot,Martinique,Mazatlan,Mendoza,Menominee,Merida,Mexico_City,Miquelon,Moncton,Monterrey,Montevideo,Montreal, Montserrat, Nassau, New_York, Nipigon, Nome,Noronha, North_Dakota/Center, North_Dakota/New_Salem, Panama, Pangnirtung, Paramaribo, Phoenix,Port-au-Prince, Port_of_Spain, Porto_Acre, Porto_Velho, Puerto_Rico, Rainy_River, Rankin_Inlet,Recife, Regina, Resolute, Rio_Branco, Rosario, Santiago, Santo_Domingo, Sao_Paulo, Scoresbysund,Shiprock, St_Barthelemy, St_Johns, St_Kitts, St_Lucia, St_Thomas, St_Vincent, Swift_Current,Tegucigalpa, Thule, Thunder_Bay, Tijuana, Toronto, Tortola, Vancouver, Virgin,Whitehorse,Winnipeg,Yakutat, Yellowknife

The following values can be used without being preceded with America/: Cuba, Jamaica, Navajo

Americas (see alsoBrazil, Canada, Chile,Mexico, United States)

The following values must be preceded with Asia/. For example, Asia/Aden is the value for the Adentime zone.

Aden, Almaty, Amman, Anadyr, Aqtau, Aqtobe, Ashgabat, Ashkhabad, Baghdad, Bahrain, Baku,Bangkok, Beijing, Beirut, Bishkek, Brunei, Calcutta, Choibalsan, Chongqing, Chungking, Colombo,Dacca, Damascus, Dhaka, Dili, Dubai, Dushanbe, Gaza, Harbin, Ho_Chi_Minh, Hong_Kong, Hovd,Irkutsk, Istanbul, Jakarta, Jayapura, Jerusalem, Kabul, Kamchatka, Karachi, Kashgar, Katmandu, Kolkata,Krasnoyarsk, Kuala_Lumpur, Kuching, Kuwait, Macao, Macau, Magadan, Makassar, Manila, Muscat,Nicosia, Novosibirsk, Omsk, Oral, Phnom_Penh, Pontianak, Pyongyang, Qatar, Qyzylorda, Rangoon,Riyadh, Riyadh87, Riyadh88, Riyadh89, Saigon, Sakhalin, Samarkand, Seoul, Shanghai, Singapore,Taipei, Tashkent, Tbilisi, Tehran, Tel_Aviv, Thimbu, Thimphu, Tokyo, Ujung_Pandang, Ulaanbaatar,Ulan_Bator, Urumqi, Vientiane, Vladivostok, Yakutsk, Yekaterinburg, Yerevan

The following values can be used without being preceded with Asia/: Hongkong, Iran, Israel, Japan,Singapore, Turkey

Asia (see also Mideast)

The following values must be preceded with Australia/. For example, Australia/ACT is the value for theACT time zone.

ACT, Adelaide, Brisbane, Broken_Hill, Canberra, Currie, Darwin, Eucla, Hobart, LHI, Lindeman,Lord_Howe, Melbourne, NSW, North, Perth, Queensland, South, Sydney, Tasmania, Victoria, West,Yancowinna

Australia


TimeZone parameter values


The following values must be preceded with Brazil/. For example, Brazil/Acre is the value for the Acretime zone.

Acre, DeNoronha, East, West

Brazil

These values are preceded by Canada/. For example, Canada/Atlantic is the value for the Atlantic timezone.

Atlantic, Central, East-Saskatchewan, Eastern, Mountain, Newfoundland, Pacific, Saskatchewan, Yukon

Canada

Chile/Continental, Chile/EasterIslandChile

The following values must be preceded with Europe/. For example, Europe/Amsterdam is the value forthe Amsterdam time zone.

Amsterdam, Andorra, Athens, Belfast, Belgrade, Berlin, Bratislava, Brussels, Bucharest, Budapest,Chisinau, Copenhagen, Dublin, Gibraltar, Guernsey, Helsinki, Isle_of_Man, Istanbul, Jersey, Kaliningrad,Kiev, Lisbon, Ljubljana, London, Luxembourg, Madrid, Malta, Mariehamn, Minsk, Monaco, Moscow,Nicosia, Oslo, Paris, Podgorica, Prague, Riga, Rome, Samara, San_Marino, Sarajevo, Simferopol, Skopje,Sofia, Stockholm, Tallinn, Tirane, Tiraspol, Uzhgorod, Vaduz, Vatican, Vienna, Vilnius, Volgograd,Warsaw, Zagreb, Zaporozhye, Zurich

The following values can be used without being preceded with Europe/: Eire, GB, GB-Eire, Greenwich,Iceland, Poland, Portugal

Europe

Mexico/BajaNorte, Mexico/BajaSur, Mexico/GeneralMexico

NZ, NZ-CHATNew Zealand

The following values must be preceded with US/. For example, US/Alaska is the value for the Alaskatime zone.

Alaska, Aleutian, Arizona, Central, East-Indiana, Eastern, Hawaii, Indiana-Starke,Michigan,Mountain,Pacific, Samoa

United States

UTC, ZULUUniversal



A P P E N D I X DKeyboard.layouts parameter values

The following table contains the values that you can use for the Keyboard.layouts parameter (to designatethe keyboard type).

You can use the Keyboard.layouts parameter in wlx.ini and $MAC.ini files.Tip

All values that are listed in the following table work on the thin client locally. However, for ICA and RDPconnections, only the values marked with an x are supported on those connections. In addition, valuesthat are listed in the Notes column that are marked with an asterisk (*) are legacy values that are supportedby ICA or RDP (as marked).

Caution

Example:

Keyboard.layouts=us

Table 16: Keyboard.layouts Values

NotesValueRDPICACountry

alAlbania

Phoneticam_phoneticArmenia

*Arabic (Egypt)araxxArabic

Azertyara_azerty

Azerty\digitsara_azerty_digits

Digitsara_digits

ara_qwerty_digits

Cyrillicaz_cyrillicAzerbajian



bd_probhatBangladesh

byBelarus

Winkeysby_winkeys

Latinby_latin

*Belgian FrenchbexBelgium

Eliminate dead keysbe_nodeadkeys

ISO alternatebe_iso-alternate

Sun dead keysbe_sundeadkeys

btBhutan

Use Bosnian digraphsba_unicodeBosnia

Use guillemets for quotesba_alternatequotes

U.S. keyboard with Bosnian digraphsba_unicodeus

U.S. keyboard with Bosnian lettersba_us

*BrazilianbrxxBrazil

Eliminate dead keysbr_nodeadkeys

bg_phoneticBulgaria

khCambodia

*Canadian English (Multilingual)caxxCanada

*Canadian Frenchca_fr

Multilingual, second partca_multi-2gr

French Dvorakca_fr-dvorakx

French (legacy)ca_fr-legacyx

Inuktitutca_ike

Multilingual, first partca_multixx


Keyboard.layouts parameter values


Multilingualca_multixx

*CroatianhrxxCroatia

*DanishdkxxDenmark

Eliminate dead keysdk_nodeadkeys

Dvorakee_dvorakEstonia

Eliminate dead keysee_nodeadkeys

Eliminate dead keysfo_nodeadkeysFaroe

*FinishfixxFinland

Northern Saamifi_smi

Eliminate dead keysfi_nodeadkeys

*FrenchfrxxFrance

Dvorakfr_dvorak

Eliminate dead keysfr_nodeadkeys

Alternativefr_latin9

Alternative, eliminate dead keysfr_latin9_nodeadkeys

Alternative, Sun dead keysfr_latin9_sundeadkeys

Sun dead keysfr_sundeadkeys

Russiange_ruGeorgia

*GermandexxGermany

*Swiss Germande_CHxx

Dead acutede_deadacute

Dead grave acutede_deadgraveacute

Dvorakde_dvorak

Eliminate dead keysde_nodeadkeys




Romanian keyboard, German lettersde_ro

Romanian keyboard, German letters,eliminate dead keys

de_ro_nodeadkeys

Polytonicgr_polytonicGreece

Eliminate dead keysgr_nodeadkeys

Extendedgr_extended

*HungarianhuxxHungary

Standardhu_standard

Qwertyhu_qwerty

Eliminate dead keysnodeadkeys

101/qwerty/comma/dead keyshu_101_qwerty_comma_dead

101/qwerty/comma/Eliminate dead keyshu_101_qwerty_comma_nodead

101/qwerty/dot/dead keyshu_101_qwerty_dot_dead

101/qwerty/dot/Eliminate dead keyshu_101_qwerty_dot_nodead

101/qwertz/comma/dead keyshu_101_qwertz_comma_dead

101/qwertz/comma/Eliminate dead keyshu_101_qwertz_comma_nodead

101/qwertz/dot/dead keyshu_101_qwertz_dot_dead

101/qwertz/dot/Eliminate dead keyshu_101_qwertz_dot_nodead

102/qwerty/comma/dead keyshu_102_qwerty_comma_dead

102/qwerty/comma/Eliminate dead keyshu_102_qwerty_comma_nodead

102/qwerty/dot/dead keyshu_102_qwerty_dot_dead

102/qwerty/dot/Eliminate dead keyshu_102_qwerty_dot_nodead

102/qwertz/comma/dead keyshu_102_qwertz_comma_dead

102/qwertz/comma/Eliminate dead keyshu_102_qwertz_comma_nodead

102/qwertz/dot/dead keyshu_102_qwertz_dot_dead




102/qwertz/dot/Eliminate dead keyshu_102_qwertz_dot_nodead

*IcelandicisxxIceland

Eliminate dead keysis_nodeadkeys

Sun dead keysis_sundeadkeys

Bengaliin_benIndia

Bengali Probhatin_ben_probhat

Gujaratiin_guj

Gurmukhiin_guru

Kannadain_kan

Malayalamin_mal

Oriyain_ori

Tamilin_tam

Tamil TAB Typewriterin_tam_tab

Tamil TSCII Typewriterin_tam_tscii

Tamil Unicodein_tam_unicode

Teluguin_tel

Urduin_urd

Keypadir_keypadIran

Proir_pro

Pro Keypadir_pro_keypad

UnicodeExpertie_unicodeexpertIreland

CloGaelachie_clogaelach

Oghamie_ogam

Ogham IS434ie_ogam_is434




si1452il_si1452Israel

lyxil_lyx

Phoneticil_phonetic

*ItalianitxxItaly

Eliminate dead keysit_nodeadkeys

*JapanesejpxxJapan

Kazakh with Russiankz_kazrusKazakhstan

Russian with Kazakhkz_ruskaz

*KoreankoxxKorean

Eliminate dead keyslatam_nodeadkeysLatin

Sun dead keyslatam_sundeadkeys

Tilde (~) variantlv_tilde

*Latin AmericanlatamxxLatin American

*DutchnlxxNetherlands

*NorwegiannoxxNorway

Northern Saami, eliminate dead keysno_smi_nodeadkeys

Dvorakno_dvorak

Eliminate dead keysno_nodeadkeys

Northern Saamino_smi

pkPakistan

*Polish (Programmers)plxxPoland

qwertzpl_qwertz

Dvorakpl_dvorak

Dvorak, Polish quotes on key "1/!"pl_dvorak_altquotes




Dvorak, Polish quotes on quotemarkkey

pl_dvorak_quotes

*PortugueseptxxPortugal

Eliminate dead keyspt_nodeadkeys

Sun dead keyspt_sundeadkeys

Standardro_stdRomania

Winkeysro_winkeys

*RussianruxxRussia

Phoneticru_phonetic

Typewriterru_typewriter

Winkeysru_winkeys

Z and ZHE swappedcs_yzSerbia

Latincs_latin

Latin qwertycs_latinyz

Latin Unicodecs_latinunicode

Latin Unicode qwertycs_latinunicodeyz

Latin with guillemetscs_latinalternatequotes

With guillemetscs_alternatequotes

Z and ZHE swappedcs_yz

Use guillemets for quotessi_alternatequotesSlovakia

Use Slovenian digraphssi_unicode

U.S. keyboard with Slovenian digraphssi_unicodeus

U.S. keyboard with Slovenian letterssi_us

*SloveniansixxSlovenia

*SpanishesxxSpain




Sun dead keyses_sundeadkeys

Dvorakes_dvorak

Tamil TAB typewriterlk_tam_tabSri Lanka

Tamil Unicodelk_tam_unicode

*SwedishsexxSweden

Dvorakse_dvorak

Eliminate dead keysse_nodeadkeys

Northern Saamise_smi

Russian phoneticse_rus

Russian phonetic, eliminate dead keysse_rus_nodeadkeys

Swiss-German, eliminate dead keysch_de_nodeadkeysxxSwitzerland

Swiss-German, Sun dead keysch_de_sundeadkeysxx

*Swiss-Frenchch_fr

Swiss-French, eliminate dead keysch_fr_nodeadkeysxx

Swiss-French, Sun dead keysch_fr_sundeadkeysxx

*Swiss-Germande_ch

*Swiss-Frenchfr_chxx

Syriacsy_sycSyria

Syriac phoneticsy_syc_phonetic

tjTajikistan

*ThaithxxThailand

Pattachoteth_pat

TIS-820.2538th_tis

*Turkish (Q)trxxTurkey




Alt-Qtr_alt

*Turkish (F)tr_fxx

Phoneticua_phoneticUkraine

Standard RSTUua_rstu

Standard RSTU on Russian layoutua_rstu_ru

Typewriterua_typewriter

Winkeysua_winkeys

*British EnglishgbxxU.K.

International (with dead keys)gb_intl

Dvorakgb_dvorak

*U.S. EnglishusxxU.S.

Alternative international (formerus_intl)

us_alt-intl

*U.S.-Dvorakus_dvorakxx

*U.S.-International (with dead keys)us_intlxx

Russian phoneticus_rusx

uzUzbekistan

vnVietnam



INI Files Reference Guide for Cisco V irtualization …...INI Files Reference Guide for Cisco V...

Documents

Transcript of INI Files Reference Guide for Cisco V irtualization …...INI Files Reference Guide for Cisco V...