ini files reference guide for cisco virtualization experience … · chapter 1 preface...

98
INI Files Reference Guide for Cisco Virtualization Experience Client 6215 Firmware Release 9.7 First Published: June 04, 2014 Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0883

Upload: others

Post on 17-Aug-2020

39 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

INI Files Reference Guide for Cisco Virtualization Experience Client6215 Firmware Release 9.7First Published: June 04, 2014

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

Page 2: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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 and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, networktopology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentionaland 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)

© 2014 Cisco Systems, Inc. All rights reserved.

Page 3: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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

Supported INI Files 5

wlx.ini Files 6

$MAC.ini Files 6

{username}.ini Files 7

Rules and Recommendations for INI Files 7

C H A P T E R 3 wlx.ini and $MAC.ini File Parameters Only 11

wlx.ini and $MAC.ini File General Settings 12

wlx.ini and $MAC.ini File Peripheral Settings 20

Desktop Keyboard Shortcuts 21

wlx.ini and $MAC.ini File Connection Settings 23

wlx.ini and $MAC.ini File Custom GNOME Settings 28

C H A P T E R 4 wlx.ini, $MAC.ini, and {username}.ini File Parameters 31

wlx.ini, $MAC.ini, and {username}.ini File General Settings 31

wlx.ini, $MAC.ini, and {username}.ini File Peripheral Settings 35

wlx.ini, $MAC.ini, and {username}.ini File Connection Settings 39

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

Mozilla Firefox Connect Options 49

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

Page 4: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

XenDesktop Connection Example 51

ICA Connect Options with XenApp 51

RDP Connect Options 55

VMware View Client Connect Options 59

Custom Connect Options 62

Ericom PowerTerm TEC Connect Options 63

Ericom PowerTerm WebConnect Connect Options 65

SSH Connect Options 66

VNC Viewer Connect Options 68

XDMCP Connect Options 69

A P P E N D I X B Printer Parameter Options 73

JetDirectPrinter 73

NetworkPrinter 75

Printer 76

PrinterURI 77

SMBPrinter 79

A P P E N D I X C Timezone Parameter Values 81

A P P E N D I X D Keyboard.layouts Parameter Values 85

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

Contents

Page 5: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

C H A P T E R 1Preface

The Cisco Virtualization Experience Client 6215 (VXC 6215) running the Cisco Virtualization ExperienceMedia Engine (VXME) delivers superior voice and video collaboration capabilities 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 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.7 1

Page 6: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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 or in a $MAC.ini file.

wlx.ini and $MAC.ini File Parameters Only, on page11

Provides the supported parameters that you can usein a wlx.ini file, $MAC.ini file, or {username}.inifile.

wlx.ini, $MAC.ini, and {username}.ini FileParameters, on page 31

Provides lists of connect options for the supportedconnections.

Connect Parameter Options, on page 49

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

Printer Parameter Options, on page 73

Lists TimeZone values for use with the wlx.ini file.Timezone Parameter Values, on page 81

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

Keyboard.layouts Parameter Values, on page 85

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

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

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

PrefaceAudience

Page 7: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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

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

PrefaceDocumentation, Support, and Security Guidelines

Page 8: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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

PrefaceDocument Conventions

Page 9: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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.

• Supported INI Files, page 5

• Rules and Recommendations for INI Files, page 7

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

• {username}.ini file

• $MAC.ini file

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

Page 10: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

The INI file processing hierarchy is as follows:Important

• 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—MAC.ini exists and {username}.ini exists. The MAC.ini file is processed and if theInclude=WLX.ini statement is included, then the WLX.ini file is processed. Once the credentialsare provided, the {username}.ini file is processed.

• Scenario 3—WLX.ini exists. The WLX.ini file is processed.

• Scenario 4—WLX.ini exists and {username}.ini exists. The WLX.ini file processed. Once thecredentials are provided, the {username}.ini file is processed.

• Scenario 5—No ini files exist. Local configuration is applied.

wlx.ini FilesA wlx.ini file contains the global parameters you want that will affect all thin clients accessing the server.Parameters in both wlx.ini and $MAC.ini File Parameters Only, on page 11 and wlx.ini, $MAC.ini, and{username}.ini File Parameters, on page 31 can be used in a wlx.ini file.

Parameters in wlx.ini and $MAC.ini File Parameters Only, on page 11 can only be used in a wlx.ini or$MAC.ini file; they cannot be used in a {username}.ini file.

$MAC.ini FilesA $MAC.ini file can be used instead of a wlx.ini file for device-specific configurations. If the thin clientlocates a $MAC.ini file (it is stored in the same directory as a wlx.ini file), then the wlx.ini file is not accessed,unless you use the include=wlx.ini parameter.

Note also that the placement of the include=wlx.ini parameter within the $MAC.ini file will dictate whichvalue will take priority for a same specific parameter that is contained in both the wlx.ini file and the $MAC.inifile but is defined differently (different values for the same parameter).

For example, if the wlx.ini file has parameterA=valueB, and the $MAC.ini file has the sameparameterA=valueC, then:

• If the include=wlx.ini parameter is included in the $MAC.ini file before the parameterA=valueC statement,then the wlx.ini parameterA=valueB is discarded and parameterA=valueC (from the $MAC.ini file) isthe final value used.

• If the include=wlx.ini parameter is included in the $MAC.ini file after the parameterA=valueC statement,then the $MAC.ini parameterA=valueC is discarded and parameterA=valueB (from the wlx.ini file) isthe final value used.

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

Getting Started: INI File Basicswlx.ini Files

Page 11: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

{username}.ini FilesA {username}.ini file contains the user-specific or user profile parameters you want that will comprise theconnection profile for an individual user. These parameters will affect only the user you specify. Parametersin wlx.ini, $MAC.ini, and {username}.ini File Parameters, on page 31 can be used in a {username}.ini file.

User profile parameters (found in the {username}.ini file) generally override the identically named globalparameters (found in the wlx.ini file), however, some global parameters do not allow this (for hierarchicalprecedence of one variable over another, refer to the parameter descriptions in wlx.ini, $MAC.ini, and{username}.ini File Parameters, on page 31).

Note

If both PNAgent/PNLite and a user profile are being used in the environment, the username must bedefined in theWindows domain to be used, and the password used must be the same for both theWindowsdomain and the user profile.

Caution

Rules and Recommendations for INI FilesIn 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 constructing the INIfiles:

1 Global Connect Parameters First

List global connect parameters before other connect parameters in a wlx.ini file.

2 Connect is the Only Required Parameter

As 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 49.

3 Continue Lines by using a Space and Backslash

To 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 space

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

Getting Started: INI File Basics{username}.ini Files

Page 12: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

can appear after the backslash; the requirement of white space between parameter entries is maintainedby the use of the space before the backslash.

Do not insert any spaces after the backslash, otherwise the device may not be able to parse the INI filecorrectly.

Note

In addition, starting all parameters at the left margin and placing at least one leading space (or tab) at thebeginning of all (and only) continuation lines makes an INI 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 49.

4 Blank Lines Make Files Easy to Read

Use blank lines to make the code easier to read.

5 Comment by using a # Sign

As 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 Marks

You must place parameter values containing white spaces inside quotation marks (use common-practicenesting rules).

7 Separate Lists by using Semicolons or Commas

Use semicolons or commas for list separators.

8 {username}.ini Files must be Write-Enabled

All {username}.ini files must be write-enabled to allow the thin client to place the encrypted user passwordsin the files.

9 Use the wlx.ini File to Set the Maximum Number of Connection Entries Allowed

The 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.

10 Use System Variables with Some Options of the Connect Parameter

Some 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 49.

Table 1: System Variables

ValueOption

Serial number used.$SN

MAC address used.$MAC

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

Getting Started: INI File BasicsRules and Recommendations for INI Files

Page 13: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

ValueOption

IP Address used.$IP

Sign-on domain name used.$DN

Sign-on name used.$UN

Sign-on password used.$PW

Terminal name.$TN

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

Getting Started: INI File BasicsRules and Recommendations for INI Files

Page 14: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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

Getting Started: INI File BasicsRules and Recommendations for INI Files

Page 15: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

C H A P T E R 3wlx.ini and $MAC.ini File Parameters Only

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

Parameters in the following sections can only be used in a wlx.ini file or $MAC.ini file; they cannot beused in a {username}.ini file.

Caution

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 to, however, Option2 is notautomatically used with the parameter as Option2 does not have a default (underlined) value.

Important

To increase usability (such as relation to thin client dialog box equivalents), the supported parameters areseparated into the following categories:

• wlx.ini and $MAC.ini File General Settings, page 12

• wlx.ini and $MAC.ini File Peripheral Settings, page 20

• Desktop Keyboard Shortcuts, page 21

• wlx.ini and $MAC.ini File Connection Settings, page 23

• wlx.ini and $MAC.ini File Custom GNOME Settings, page 28

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

Page 16: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

wlx.ini and $MAC.ini File General SettingsThe following table describes 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.

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

DescriptionParameter

ActiveDirectoryServer—Active Directory Server IP for Domain Login to theclient.

For example: ActiveDirectoryServer=10.150.124.150

ActiveDirectoryServer=<ActiveDirectory Server IP>

Default is no.Specifies whether to mute the audio.

AudioMute={no, yes}

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

AudioVolume=<value of 0 to 100>

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

ChangeAdminPassword=<base-64 encodedpassword>

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

ChangeGuestPassword=<base-64 encoded password>

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

ChangeRootPassword=<base-64 encoded password>

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

ChangeThinUserPassword=<base-64 encodedpassword>

Default is no.

By default, CiscoVXMEoperates in Dual VLANmode (formore information,see theDeployment Guide for Cisco Virtualization ExperienceMedia Engine).

If you do not plan to use Dual VLAN configuration, use this parameter todisable Dual VLAN detection and enable faster startup for the Cisco VXC6215.

Valid values are:

• Yes—If Cisco.Config.DisableDualVLAN=yes, Cisco VXME skipsDual VLAN detection and starts in single VLAN mode.

• No—If Cisco.Config.DisableDualVLAN=no or has any other value(including invalid values), or the parameter is not present, the clientapplies the default behavior (Cisco VXME attempts to detect andconfigure the Dual VLAN at startup).

Cisco.Config.DisableDualVLAN={no|yes}

Specifies the default sign-on user. See also AutoLogin.DefaultUser=<username>

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File General Settings

Page 17: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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 is shut downand ready mode is enabled, the device logs out of the session, places thepower button LED in a state of off, and then goes into Suspend mode. If auser presses the power button again, the device wakes up immediately forthe user to log in.

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

Example:

DisableReadyMode=no will enable ReadyMode functionality.

DisableReadyMode=yes will disable ReadyMode functionality.

DisableReadyMode={no, yes}

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File General Settings

Page 18: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

Important: Put the parameters on the same line. This is the generic syntaxof INI parameter for 802.1x settings for aWired connection. Parameter usagewill be based on the use case and EAP method chosen. For example: If youuse Active Directory login to the thin client, user credentials are not requiredin the ini.

Enable802—Default value is no.Yes/no to enable or disable 802.1x settingsfor Auto Eth0 Wired connection.

Yes—Enables 802.1x settings for Wired network.

No—Disables 802.1x settings for Wired network.

Authentication—The authentication method (EAP method) to be chosen for802.1x.

Username—Username used for inner authentication.

Example: In an Active Directory environment this is the Active Directoryusername used for MSCHAPv2 exchange.

Password—The inner authentication MSCHAP password. In an ActiveDirectory environment this is the Active Directory user password used forMSCHAPv2 exchange.

PromptPassword—Default value is no.Yes/no option to prompt or not promptfor a password every time for 802.1x authentication when the network comesup. Default value is "no".

Identity—The identity/username you chose while creating the client/usercertificate. Used for TLS authentication.

InnerAuthentication—The second EAP type inside the PEAP or TLS tunnel.Used only in case of PEAP and Tunneled TLS authentications.

UserCertificate—The client/user certificate name. Used for TLSauthentication.

CACertificate—Root CA certificate name for authentication.

PrivateKey—Client/user private key certificate. Used for TLS authentication.

PrivateKeyPassword—The password given during the creation of a user/clientcertificate. This should be a base64 encoded password.

PeapVersion—Default value is Auto. PEAP protocol version.

PACProvisioning—Automatic PAC Provisioning for FAST authentication.

PACFile—PAC File for FAST authentication.

Example: Below is an example ini for 802.1x PEAP MSCHAPv2authentication in the case of a domain user login to a thin client.

Enable802=yes Authentication=PEAP InnerAuthentication=MSCHAPv2PeapVersion=Auto PromptPassword=no CACertificate=scep

Enable802={no, yes}

Authentication={MD5, TLS, FAST, TunnledTLS,PEAP}

[Username=<username>]

[Password=<password>]

[PromptPassword={no, yes}]

[Identity=<username>]

[InnerAuthentication={GTC, MSCHAPv2, PAP,CHAP, MD5}]

[UserCertificate=<certificate name>]

[CACertificate=<certificate name>]

[PrivateKey=<certificate name>]

[PrivateKeyPassword=<password>]

[PACProvisioning={Anonymous, Authenticated,Both}]

[PACFile=<filename>]

[PeapVersion={Auto,0,1}]

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File General Settings

Page 19: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

Default is yes.

Yes/no option to enable G key reset. G key reset is supported forPrivilege=High.

EnableGKey={yes, no}

Default is no.Yes/no option to enable full screen mode (when selected it will disable theDesktopsize 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 the IdleAction.Timeout(in minutes from 0 to 1440), then the device executes the command that isspecified in the IdleAction.Action parameter.

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 is a list ofcertificate names (the names must be separated by a semicolon).

Certificatesmust be placed in the /wlx/certs directory.Note

Example:

ImportCerts=yes

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

The certificates must be .crt, .pem, or any valid certificatetype.

Note

ImportCerts={no, yes}

[Certs=<list of certificate names>]

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

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

Note

InstallAddons=<name of add-on>

OR

NewAddons= <name of add-on>

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File General Settings

Page 20: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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

• SRV - DNS SRV Record (Dynamic Discovery) Allows devices to usethe DNS SRV record lookup method to discover a Cisco VXCManagerServer.

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

• Hostname - DNS Name Record (Dynamic Discovery) Allows devicesto use the DNS Hostname lookup method to discover a Cisco VXCManager Server.

• UI - Allows devices to use the UI entries to discover a Cisco VXCManager Server.

• DHCPOption Tags - (DynamicDiscovery) Allows devices to use DHCPoption tags to discover a Cisco VXC Manager Server.

• Static - Allows devices to use a static location to discover a Cisco VXCManager Server.

When the Static option is used, the MgmtDiscoveryMethodparameter should be used with a valid Fully Qualified DomainName or IP Address.

Note

• Default - The Default method to discover a Cisco VXCManager Serveris used when none is specified or if any of the methods mentioned inthis section fails; then the default method is used which is the followingdicovery order {SRV, CNAME, HOSTNAME, UI, DHCP}.

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

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

interactive-Presents an option window to the user

reboot or restart-Reboots the device

halt or shutdown-Shuts down the device

sleep-Puts the device into sleep mode

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

none or nothing-No action (does nothing)

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

Specifies add-ons to uninstall. Use comma-separated add-on names.RemoveAddons=<name of add-on>

The thin client uses this root path to access files on the central file server (notapplicable with Cisco VXCManager). The directory name /wlx is appendedto the root path entry before use.

RootPath=<root path>

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File General Settings

Page 21: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

CertName—Name of certificate to be enrolled using SCEP

URL—SCEP server URL

ChallengePassword—Certificate Enrollment Challenge Password

CADN—CA Distinguished Name.

AutoEnroll—Yes/No parameter to enable or disable certificate automaticenrollment.

For example:

ScepClientCertSettings =CertName=ScepCertOne

URL=http://192.168.0.10/certssrv/mscep.dll

ChallengePassword=C35F78367BA20216

CADN=scepca-root-ca

ScepClientCertSettings=CertName=<Name ofCertificate file>

URL=<SCEP server URL>

[ChallengePassword=<Password>]

CADN=<CA Distinguished Name>

[AutoEnroll={yes, no}]

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File General Settings

Page 22: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

Default is 5 (minutes).

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

Put the parameters on the same line. For example:

ScreenSaver=5 LockTerminal=yes SoftSaver=yes

Type=coral,drift,hypertorus,interaggregate,pipesCycleDelay=5

Note

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

• no-Disabled

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

SoftSaver-Specifies whether the thin client runs a soft saver. Soft savers areavailable only when the optional SCREENSAVER-THEMES add-on isinstalled.

• no-Displays a blank screen

• yes-Runs a graphical display

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

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

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

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

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

Layout-Specifies the layout to use for the screen saver (this option is ignoredin 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 the availablescreensaver names. The Name entry in each .desktop file providesthe value that is displayed in the Screensaver configuration GUIapplication; and the Comment entry provides a brief description.

Note

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

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File General Settings

Page 23: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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-character string.TerminalName=<name of thin client>

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

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

Specifies the SNTP time servers to use for time retrieval. You can designateone or two (as shown in the parameter example) Network Time Protocolservers (separated by a semicolon). The client synchronizes the time of dayto the servers at boot time, and keeps the time in sync with the servers duringoperation.

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

Default is no.Specifies the time zone if the zone is unspecified on the thin client or is usedwith ManualOverride.

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

For the complete list of TimeZone values, see Timezone ParameterValues, on page 81.

Note

TimeZone=<zone value> [ManualOverride={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 locally cacheconfiguration settings during an image upgrade. Instead, the thin client erasesall existing configurations and applies only the configuration specified in theINI that you use with the upgrade.

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

Update.Preserve_changes={no, yes}

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File General Settings

Page 24: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

wlx.ini and $MAC.ini File Peripheral SettingsThe following table contains parameters used for configuring peripheral settings such as keyboard, monitor,mouse, printer, and so on (underlined values are defaults).

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

DescriptionParameter

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>

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}

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

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

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

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

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File Peripheral Settings

Page 25: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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

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

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.)

The keyboard shortcuts listed below are applicable only in the SUSE Linux desktop. The disable INIparameters listed are provided so that you can disable the shortcuts in the SUSE Linux desktop, so thatthey do not conflict with shortcuts entered in the HVD.

Note

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

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

wlx.ini and $MAC.ini File Parameters OnlyDesktop Keyboard Shortcuts

Page 26: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

INI parameter to disable shortcutActionPress

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

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

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

wlx.ini and $MAC.ini File Parameters OnlyDesktop Keyboard Shortcuts

Page 27: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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

DescriptionParameter

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

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

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File Connection Settings

Page 28: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

Default is no.

Yes/no option to automatically log the user in as DefaultUser ifno login occurs before the CountDown interval. This is for useat kiosks and other environments where the user logs in withouthuman intervention. Autologin can be canceled by pressing theESC button. The first time a device reads Autologin, it may stayat the login screen for a few seconds before taking effect. Oncedoing so, it will automatically log in and all future reboots willautologin with the defined delay. Changing fromAutoLogin=yesto AutoLogin=no may require 2 reboots to take effect in somecases. No password is required for automatic login even if theuser normally needs a password.

SignOn=no and AutoLogin=yes are alternativeparameters/ways to provide similar functionality.

Note

SignOn=no and AutoLogin=yes should not be usedtogether. In general, use AutoLogin; SignOn=no isbeing deprecated. AutoLogin=yes logs in as thedefault user; which may be set via the DefaultUserini-file parameter; the privilege level is that user'snormal privilege level; determined in the samemanneras if they had logged in manually.

Caution

ADVANCEDNOTE:Any valid user may be specified; but notethat PNA and Active Domain users will not obtain a passwordfirst; which may prevent them from accessing the Published Appsor Domain services. If there is no DefaultUser specified in theregistry, it will use Guest.

Note that for both SignOn=no and AutoLogin with a short delay,it is quite likely that the login process will proceed before thenetwork is up and the wlx.ini file has been read. This means thatchanges to the wlx.ini login parameters will not take effect untila logout or reboot.

Note also that changes to the System/DefaultUser orSystem/PrivLevel registry keys do not automatically adjust thelogin parameters; that is normally done only after fetching andparsing a wlx.ini file when a network interface comes up. If youneed to change the parameters outside that sequence; use the/sbin/configureGDM script to modify the system's loginconfiguration.

The wlx.ini will be fetched and processed every time the networkcomes up; so if the network goes down and is restored during asession, it may affect existing settings (although the login-relatedsettings will not be apparent until the current user logs out).

Also note that neither mechanism actually authenticates theuser—they just verify that the user exists. But both methods, andnormal manual login, will fetch and process a $USER.ini file, ifone exists, independent of what, if any, authenticationmechanismwas used.

AutoLogin={no, yes}

[CountDown=<value in seconds>]

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File Connection Settings

Page 29: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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

AutoSignoff={no, yes}

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>

Default is no.

Cisco VXC 6215 devices can be converted to Desktop Appliancemode by enabling the EnableApplianceMode parameter. Whenenabled, upon system boot the thin client will connect to theXenDesktop server and prompt for XenDesktop login credentialsto access the desktop. By default EnableApplianceMode=No.

XenDesktopURL specifies the virtual desktop to use whenEnableApplianceMode is enabled.

For example:-

EnableApplianceMode=Yes

XenDesktopURL=http://192.168.0.2

EnableApplianceMode={no, yes}

[XenDesktopURL=<URL of Xendesktop>]

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 no.

Yes/no option to enable SSH.

EnableSSH={no, yes}

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File Connection Settings

Page 30: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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

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>,...

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File Connection Settings

Page 31: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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

The format must be the following:

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

or

ICADenyUSB=vid=<hexnumber>,...

For example:

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

This example excludes two USB devices. Note that there is 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>,...

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

PermitSSHRootLogin={no, yes}

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]

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File Connection Settings

Page 32: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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

Seamless={no, yes}

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

wlx.ini and $MAC.ini File Custom GNOME SettingsThe following table describes the parameters that you can use to configure Custom GNOME settings. Defaultvalues are underlined. You can use the parameters in a wlx.ini file or a $MAC.ini file.

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File Custom GNOME Settings

Page 33: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

Table 6: Custom GNOME Settings: wlx.ini and $MAC.ini Files

DescriptionOption

Disables a specified set of applets in the Control Center orApplication Browser based on user privilege levels.

Values for privilege level are:

• HighPrivilege—Where HighPrivilege is equivalent to theprivilege level of a default admin user.

• LowPrivilege—Where LowPrivilege is equivalent to theprivilege level of a default thinuser user.

Applet names must be separated by a semicolon (;) and Appletnames must be the same as the file name of the desktop files from/usr/share/applications/ without the desktop extension.

The applet file names are casesensitive.

Important

Example:

Applets.Disable.LowPrivilege=dmlangsel;display-properties;gnome-appearance-properties;DeviceSettings_wyse-settings;gnome-screenshot;vino-preferences;

Applets.Disable.HighPrivilege=dmlangsel;display-properties;gnome-appearance-properties;DeviceSettings_wyse-settings;gnome-screenshot;vino-preferences;

Applets.Disable.<Privilege Level>=<Name of applets separatedby ; >

Enables a specified set of applets in the Control Center orApplication Browser based on user privilege levels.

Values for privilege level are:

• HighPrivilege—Where HighPrivilege is equivalent to theprivilege level of a default admin user.

• LowPrivilege—Where LowPrivilege is equivalent to theprivilege level of a default thinuser user.

Applet names must be separated by a semicolon (;) and Appletnames must be the same as the file name of the desktop files from/usr/share/applications/ without the desktop extension.

The applet file names are casesensitive.

Important

Example:

Applets.Enable.LowPrivilege=display-properties;keyboard

Applets.Enable.<Privilege Level>=<Name of applets separatedby ;>

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File Custom GNOME Settings

Page 34: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

Default is no.

Yes/no option to disable the notification area from the task bar.

Values for privilege level are:

• HighPrivilege—Where HighPrivilege is equivalent to theprivilege level of a default admin user.

• LowPrivilege—Where LowPrivilege is equivalent to theprivilege level of a default thinuser user.

Example:

NotificationArea.Disable.HighPrivilege=yes

NotificationArea.Disable.<Privilege Level>={no, yes}

Default is no.

Yes/no option to disable the Clock button from the task bar.

Values for privilege level are:

• HighPrivilege—Where HighPrivilege is equivalent to theprivilege level of a default admin user.

• LowPrivilege—Where LowPrivilege is equivalent to theprivilege level of a default thinuser user.

Example:

TaskBarClockButton.Disable.LowPrivilege=yes

TaskBarClockButton.Disable.<Privilege Level>={no, yes}

Default is no.

Yes/no option to disable the Configure Display Settings buttonfrom the task bar.

Values for privilege level are:

• HighPrivilege—Where HighPrivilege is equivalent to theprivilege level of a default admin user.

• LowPrivilege—Where LowPrivilege is equivalent to theprivilege level of a default thinuser user.

Example:

TaskBarDisplaySettingsButton.Disable.HighPrivilege=Yes

TaskBarDisplaySettingsButton.Disable.<Privilege Level>={no,yes}

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

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

wlx.ini and $MAC.ini File Parameters Onlywlx.ini and $MAC.ini File Custom GNOME Settings

Page 35: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

C H A P T E R 4wlx.ini, $MAC.ini, and {username}.ini FileParameters

This chapter provides the supported parameters that you can use in a wlx.ini file, a $MAC.ini file, and in a{username}.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 to, however, Option2 is notautomatically used with the parameter as Option2 does not have a default (underlined) value.

Important

To increase usability (such as relation to thin client dialog box equivalents), the supported parameters areseparated into the following categories:

• wlx.ini, $MAC.ini, and {username}.ini File General Settings, page 31

• wlx.ini, $MAC.ini, and {username}.ini File Peripheral Settings, page 35

• wlx.ini, $MAC.ini, and {username}.ini File Connection Settings, page 39

wlx.ini, $MAC.ini, and {username}.ini File General SettingsThe following table describes 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.

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

Page 36: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

Table 7: General Settings: wlx.ini, $MAC.ini, and {username}.ini Files

DescriptionParameter

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=<value listed in description>

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

Includes another INI file at the position of this command.

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

Note

Include=<path/filename>

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File General Settings

Page 37: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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 deviceuses the local cached INI file, cached/saved/used-atleast-once file 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 device does not fall back to thelocal cached INI file.

INIFileSource={cache, local, server}

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

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File General Settings

Page 38: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

Default is High.

Privilege controls operator privileges and access to thin clientresources for the INI user.

This parameter is not applicable to default users such asadmin and thinuser.

Note

Value and Operator Privileges:

High— (default) For administrators. All thin client resources areavailable with no restrictions. A high-level user can reset thedevice to factory defaults.

Low— For a typical user. Access is granted to the ConnectionManager and desktop panel, but not theMore Applications buttonor Control Center. Users can view connections, but not add ormodify them.

None— For a kiosk or other restricted-use deployment. Usershave access only to icons put on the desktop by the administrator,not the Connection Manager, desktop panel, More Applicationsbutton, or Control Center.

If optional LockDown=Yes the system saves theprivilege level in the flash device. If LockDown=No,the system clears the privilege level from the flash deviceto the default unlocked state.

Note

LockDown— Default is no. Yes/no option to lock the defaultprivilege for the thin client. If LockDown=Yes, the privilege issaved in permanent registry; if LockDown=No, the privilege levelis set to the default high in the permanent registry.

The default high privilege level is stored in the permanent registry;if you do not specify a privilege in either the wlx.ini or{username}.ini files or the network is unavailable, the setting ofthe Lockdown parameter takes effect. It can be modified by aclause. For example,

privilege=<None|Low|High> lockdown=yes

in the wlx.ini or {username}.ini sets up the default privilege tothe specified level.

And a clause such as

privilege=<None|Low|High> Lockdown=No

sets up the default privilege back to high regardless of thespecified level, and current effective privilege level specified.

Privilege={High, None, Low}

[LockDown={no, yes}]

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}

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File General Settings

Page 39: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

wlx.ini, $MAC.ini, and {username}.ini File Peripheral SettingsThe following table contains parameters used for configuring peripheral settings such as keyboard, monitor,mouse, printer, and so on (underlined values are defaults).

Table 8: wlx.ini, $MAC.ini, and {username}.ini file peripheral settings

DescriptionParameter

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

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File Peripheral Settings

Page 40: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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=MON1 1024x768 on-leftMON2 1024x768@75on-right

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

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

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File Peripheral Settings

Page 41: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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}

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 73.

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 85.

Example:

Keyboard.layouts=us (for United States)

Keyboard.layouts=ru (for Russia)

Keyboard.layouts=<value of Keyboard.layouts>

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

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}

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File Peripheral Settings

Page 42: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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 page73.

NetworkPrinter=<value of an option>

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 page73.

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 73.

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 73.

SMBPrinter=<value of an option>

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File Peripheral Settings

Page 43: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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}

wlx.ini, $MAC.ini, and {username}.ini File Connection SettingsThe following table describes the parameters that you can use to configure connection settings. Default valuesare underlined.

Table 9: Connection Settings: wlx.ini, $MAC.ini, and {username}.ini Files

DescriptionParameter

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}

For Browser only.

Yes/no option to clear out or persist the browser history acrossdifferent thin client users.

Yes - Clears out browser data across different user logins.

No - Persists the browser data across different user logins.

Browser.ClearBrowserData={yes,no}

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>

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File Connection Settings

Page 44: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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 49 describes theseparameters:

• BROWSER, seeMozilla Firefox Connect Options, on page49

• ICA, see ICA Connect Options with XenApp, on page 51For details about configuring a XenDesktopconnection, see XenDesktop Connection Example,on page 51 and Mozilla Firefox Connect Options,on page 49.

Note

• RDP, see RDP Connect Options, on page 55

• VMWARE_VIEWCLIENT, see VMware View ClientConnect Options, on page 59.

• Custom, see Custom Connect Options, on page 62

• Ericom_PowerTerm, see Ericom PowerTerm TECConnectOptions, on page 63

• Ericom_WebConnect, see Ericom PowerTermWebConnectConnect Options, on page 65

• SSH, see SSH Connect Options, on page 66

• VNC_VIEWER, see VNC Viewer Connect Options, onpage 68

• XDMCP, see XDMCP Connect Options, on page 69

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

Note

Connect={BROWSER, Custom, ICA, RDP, SSH,Ericom_PowerTerm, Ericom_WebConnect,VMWARE_VIEWCLIENT, VNC_VIEWER, XDMCP}

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 a space.Note

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

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File Connection Settings

Page 45: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

Default is no.

Yes/no option to enable the transport of audio data as UDP.

EnableUDPAudio={no, yes}

For ICA only

Default is yes.

Yes/no option to enable deep compression codec support.

H264Enabled={yes, no}

For ICA only

Default is null.

Name of the customized H264 CaptureBin.

HDXH264CaptureBin=<name>

For ICA only

Default is no.

Yes/no option to enable H264 encoding is attempted because anH264 encoder (gstreamer plugin) is present. The default is no,which enables Theora encoding.

HDXH264InputEnabled={no, yes}

For ICA only

Default is /dev/video0.

Selects the webcam device.

HDXWebCamDevice=<webcam device>

For ICA only

Default is 15.

Sets the preferred frame rate.

HDXWebCamFramesPerSec= <integer>

For ICA only

These settings control the resolution parameters. The defaults areHDXWebCamWidth=352 and HDXWebCamHeight=288.

HDXWebCamWidth=<integer>

HDXWebCamHeight=<integer>

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}

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File Connection Settings

Page 46: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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 a space.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}

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File Connection Settings

Page 47: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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:

ICADesktopApplianceMode=yes

ICAMMVideo=yes

ICAMMAudio=yes

IcaMMAudio={yes, no}

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File Connection Settings

Page 48: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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:

ICADesktopApplianceMode=yes

ICAMMVideo=yes

ICAMMAudio=no

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

ICADesktopApplianceMode=yes

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

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File Connection Settings

Page 49: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

For RDP only.

Default is no.

Specifies whether to enable Network Level Authentication forRDP sessions.

NLA={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>]]

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

Youmust specify the parameters in the order shown.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}}

For ICA only

Default is no.

Yes/no option to close gst_play at the end of a media clip. Thisensures only one gst_play process runs at a time.

SpeedScreenMMAClosePlayerOnEOS={no, yes}

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File Connection Settings

Page 50: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

For ICA only

Default is yes.

Yes/no option to enable Speed Screen MMACSF. Setting to nodisables this functionality, and media will revert to the traditionalstreaming mode of HDX MediaStream where possible.

SpeedScreenMMACSFEnabled={yes, no}

For ICA only

Default is yes.

Yes/no option to enable all MediaStream features to use playbin2.Setting to no configures all other MediaStream features to useplaybin except Client-Side Fetching, which continues to useplaybin2.

SpeedScreenMMAEnablePlaybin2={yes, no}

For ICA only

Default is 20.

Period of time, in seconds, allowed for gst_play processes to exitbefore being closed.

SpeedScreenMMAGstPlayExitTimeout=<int eger>

For ICA only

Default is yes.

Yes/no option to enable Receiver to quit any gst_play processesthat do not exit within a specified timeout period.

SpeedScreenMMAGstPlayKillAtExit={yes, no}

For ICA only

Default is yes.

Yes/no option to enable re-basing of timestamps to a positivevalue following seek.

SpeedScreenMMARebaseTimestampsOnSeek={yes, no}

For ICA only

Default is no.

Yes/no option to enable the correction of a mouse pointer issuewhere the mouse pointer disappears in full-screen WMP.

Set to no to fix potential issues with videos not playing in thecorrect location or at the correct size, not resizing properly, orwith the videowindow remaining black, but causes an issue wherethe mouse pointer disappears in full-screen WMP and does notreturn when the mouse is moved. Set to yes to correct themouse-pointer issue.

SpeedScreenMMAStopOverlayHandlingEvents={no, yes}

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File Connection Settings

Page 51: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionParameter

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>

For ICA only

Default is 65536 for Thinwire and 32768 for client audio.

If threading is enabled, this defines the size of the thread's dataqueue in bytes. A larger queue size may result in more lag becausethe overall buffering increases.

ThreadQueueSize=<integer value>

For ICA only

Default is 16509.

Specifies the maximum port number for UDP audio on the userdevice.

UDPAudioPortHigh=<integer value>

For ICA only

Default is 16500.

Specifies the minimum port number for UDP audio on the userdevice.

UDPAudioPortLow=<integer value>

For ICA only

Default is yes.

Yes/no option to enable the use of a thread to be used for thisvirtual channel.

UseThread={yes, no}

If you configure groups on the Cisco ASA, this parameter allowsyou to specify the group name or names (separated by commas)that the CiscoAnyConnect Client can use for the VPN connection.

VPNGroup=<Group name>,... (optional)

Specifies the VPN headend FQDN or IP Address to autoconfigurethe Cisco AnyConnect Client. For example, VPN.Cisco.com or192.168.0.1.

VPNHeadendAddress= <FQDN or IP address> (required)

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File Connection Settings

Page 52: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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

wlx.ini, $MAC.ini, and {username}.ini File Parameterswlx.ini, $MAC.ini, and {username}.ini File Connection Settings

Page 53: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

A P P E N D I X AConnect Parameter Options

This appendix provides the options that you can use for the Connect parameter in the supported connections.

You can use the Connect parameter in wlx.ini, $MAC.ini, and {username}.ini files.Tip

Mandatory options for a Connect parameter are marked as Mandatory Option in the description of anoption.

Important

• Mozilla Firefox Connect Options, page 49

• XenDesktop Connection Example, page 51

• ICA Connect Options with XenApp, page 51

• RDP Connect Options, page 55

• VMware View Client Connect Options, page 59

• Custom Connect Options, page 62

• Ericom PowerTerm TEC Connect Options, page 63

• Ericom PowerTerm WebConnect Connect Options, page 65

• SSH Connect Options, page 66

• VNC Viewer Connect Options, page 68

• XDMCP Connect Options, page 69

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

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

Page 54: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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

Table 10: Mozilla Firefox Connect Options

DescriptionOption

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

AutoConnect={no, yes}

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>

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

Connect Parameter OptionsMozilla Firefox Connect Options

Page 55: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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

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 51).

Note

ExampleCONNECT=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

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

Connect Parameter OptionsXenDesktop Connection Example

Page 56: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

Table 11: 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.

AutoConnect={no, yes}

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

BrowserIP=<list of browsers>

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

Colors={256, 64k, 16m}

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

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

Caution

Description=<string description>

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}

Default is no.

Yes/no option to disable client side fetching of Flash content.This is a global INI parameter for the Citrix ICA client.

HDXFlashEnableServerSide ContentFetching={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>...]

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

Connect Parameter OptionsICA Connect Options with XenApp

Page 57: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

Default is 1.Designates the browsing protocol:

• 0=udp

• 1=http (default)

• ssl=https

HttpBrowsing={0, 1, ssl}

Default is no.

Yes/no option to disable the Citrix Firefox plug-in feature thatsends the option "-WI_is_FS" to its receiver, if Firefox is infullscreen mode, which makes the Citrix receiver ignore windowsize configuration. Disabling the feature will allow users to beable to resize their Citrix session when using Firefox Kiosk mode.

IcaDisableWIFS={no, yes}

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}

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

Connect Parameter OptionsICA Connect Options with XenApp

Page 58: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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}

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

Connect Parameter OptionsICA Connect Options with XenApp

Page 59: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

Yes/no option to have the connection attempt to connect to theStorefront server. If set to no, the connection will attempt toconnect to the PNAgent server. There is no default value. If theparameter is not specified, it will be considered as a Serverconnection

StoreFront={yes, no}

Name of the Store to connect through PNAgent server orStorefront server.

StoreName=<Name of the Store>

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

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

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

ExampleCONNECT=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

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

Connect Parameter OptionsRDP Connect Options

Page 60: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

Table 12: RDP Connect Options

DescriptionOption

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

AutoConnect={no, yes}

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>

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

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

Caution

Description=<string description>

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).

FullScreen={no, yes}

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.

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

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

Connect Parameter OptionsRDP Connect Options

Page 61: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

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}

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}

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

Variable and Descriptionpassword-Conventional 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

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

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

Connect Parameter OptionsRDP Connect Options

Page 62: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

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

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 no.

Yes/no option to enable Smart Card Authentication.

The Cisco VXC 6215 firmware supports smart cards,but Cisco does not provide support for smart cardsolutions. For information about smart cards, contactyour smart card vendor.

Note

Smartcard={no, yes}

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}

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

Connect Parameter OptionsRDP Connect Options

Page 63: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

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

$DN-Sign-on domain name

$UN-Sign-on name

$PW-Sign-on password

$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.

For VMware View connections, you must enable SSL for all connections to a View Connection Server.Note

ExampleCONNECT=VMWARE_VIEWCLIENT \Description="VMview" \Host=192.168.0.2 \DomainName=$DN \AutoConnect=yes \Fullscreen=yes \Ping=yes \UseSSL=yes \Username=Administrator \Password=cGFzc3dvcmQ

or

Password=$MAC

Table 13: VMware View Client Connect Options

DescriptionOption

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

AutoConnect={no, yes}

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

Connect Parameter OptionsVMware View Client Connect Options

Page 64: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

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

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

Caution

Description=<string description>

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>

Default is no.

Yes/no option to enable the VMWare View client to use FIPSapproved cryptographic algorithms and protocols for establishingremote PCoIP connections.

EnableFipsMode={no, yes}

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.

FullScreen={no, yes}

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.

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

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

Connect Parameter OptionsVMware View Client Connect Options

Page 65: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

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

Interactive={yes, no}

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

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

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}

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>

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>

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

Connect Parameter OptionsVMware View Client Connect Options

Page 66: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

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}

Specifies the VMWare View client image cache size in MB.

A larger cache size reduces bandwidth usage, but requires morememory on the client. A smaller cache size requires morebandwidth usage. Valid values for this INI parameter option arebetween 50 and 1024. If it is set to a value less than 50, the systemwill automatically use a value of 50. If it is set to a value morethan 1024, the system will automatically use a value of 1024.

VMWareView.ImageCacheSize=<a number value from 50 to1024>

Default is no.

Yes/no option to display a visual indication that the image cachein VMWare View client is working. If enabled, the user will seerectangles around every 32x32 tile in the established session. Setthe value on this INI parameter to yes to see the visual effect.

VMWareView.ShowImageCacheHits ={no, yes}

Custom Connect OptionsThe following table contains the supported options you can use for Custom connections (underlined valuesare defaults).

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

Connect Parameter OptionsCustom Connect Options

Page 67: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

ExampleCONNECT=Custom \Description="Custom_Connection" \AutoConnect=Yes \Reconnect=Yes \ReconnectSeconds=100 \Command=/usr/bin/xterm\

Table 14: Custom Connect options

DescriptionOption

Default is no.

Yes/no option to start a connection automatically at sign-on.

AutoConnect={no, yes}

Mandatory Option

Specifies a command or application to be executed from the client. For example:Command=/usr/bin/xterm>

Command=<command or applicationto be executed from the client>

Mandatory Option

Connection description. Provides a connection name for the Desktop icon and the ConnectionManager.

The text must be enclosed in quotation marks if it contains spaces or punctuationcharacters. These characters are not allowed: & ‘ “ $ ? ! | ; ( ) [ ] { } \

Caution

Description=<string description>

Default is no.

Yes/no option to automatically reconnect to an application server after a disconnection.

Reconnect={no, yes}

Default is 30.

Specifies the amount of time in seconds (default is 30) to wait before automatic reconnectionto an application server after a disconnection. Requires Reconnect=yes or 1.

ReconnectSeconds=<value inseconds>

Ericom PowerTerm TEC Connect OptionsThe following table contains the supported options you can use for Ericom PowerTerm TEC connections(underlined values are defaults).

ExampleCONNECT=Ericom_Powerterm \Description="Ericom_Test" \Host=192.168.0.2 \AutoConnect=Yes \Reconnect=Yes \ReconnectSeconds=100 \Filename=sec \Filepath=Wyse/WLX \Ping=yes \Terminal=WY50 \Resolution=800x600 \Fullscreen=No \

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

Connect Parameter OptionsEricom PowerTerm TEC Connect Options

Page 68: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

Echo=No \UIConfig=menu

Table 15: Ericom PowerTerm TEC Connect Options

DescriptionOption

Default is no.

Yes/no option to start a connection automatically at sign-on.

AutoConnect={no, yes}

Connection description. Provides a connection name for the Desktop icon and the ConnectionManager.

The text must be enclosed in double quotation marks if it contains spaces orpunctuation characters. These characters are not allowed: & ‘ “ $ ? ! | ; ( ) [ ] { }\

Caution

Description=<string description>

Specifies the terminal identification string that is sent as a response when a request foridentification is requested to terminal.

DeviceID=<string>

Default is no.

Yes/no option to set the local echo option on the serial port. For serial connection only.

Echo={no, yes}

Lists the name the configuration files you want to use.FileName=<name>

Specifies where the configuration files are on the server.FilePath=<file location>

Default is no.

Yes/no option to run the session at full screen (not in a window).

FullScreen={no, yes}

Mandatory Option

Specifies the host. The thin client attempts to connect to the next server on the list if thecurrent one fails. List items must be separated by semicolons or commas.

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

Specifies an icon to appear on the thin client desktop for this connection. The file must belocated in the server wlx/bitmap directory. If not specified, the default icon is displayed(except in the case of a published application). A PNG, JPEG, or GIF may be used. XPM ispermitted for backward compatibility.

Icon=<image file>

Specifies the modem dial-up number. For serial connection only.Phone=<phone number>

Default is yes.

Yes/no option to enable ping. For non-published application connections, a ping (ICMP) issent to the host server prior to connecting to verify that the host is reachable.

Ping={yes, no}

Default is COM1.

Designates the connection serial port. For serial connection only.

Port={COM1, COM2}

Default is no.

Yes/no option to automatically reconnect to an application server after a disconnection.

Reconnect={no, yes}

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

Connect Parameter OptionsEricom PowerTerm TEC Connect Options

Page 69: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

Default is 30.

Specifies the amount of time in seconds (default is 30) to wait before automatic reconnectionto an application server after a disconnection. Requires Reconnect=yes or 1.

ReconnectSeconds=<value inseconds>

Default is default, which starts the connection using the current desktop display settingwith no window frame or border.

Specifies the connection display resolution. The default value starts the connection usingthe current desktop display setting with no window frame or border. Arbitrary widthxheightvalues are accepted.

Resolution={default, 640x480,800x600, 1024x768, 1280x1024,1600x1200, <width>x<height>}

Specifies the terminal emulation type.{TerminalType,TerminalID,Terminal}=<emulationtype>

Specifies the terminal identification string that is sent as a response when a request foridentification is requested to terminal.

Termname=<terminal ID string>

Opens the window with the menu, toolbar, status bar, or buttons.Uiconfig={menu, toolbar, status,buttons}

Ericom PowerTerm WebConnect Connect OptionsThe following table contains the supported options you can use for EricomPowerTermWebConnect connections(underlined values are defaults).

ExampleCONNECT=Ericom_WebConnect \Description="Test_Ericom_WebConnect" \Host=192.168.0.2 \Username=$MAC \Password=Password

Table 16: Ericom PowerTerm WebConnect Connect Options

DescriptionOption

Connection description. Provides a connection name for the Desktop icon and the ConnectionManager.

The text must be enclosed in double quotation marks if it contains spaces orpunctuation characters. These characters are not allowed: & ‘ “ $ ? ! | ; ( ) [ ] { }\

Caution

Description=<string description>

Mandatory Option

Specifies the host. The thin client attempts to connect to the next server on the list if thecurrent one fails. List items must be separated by semicolons or commas.

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

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

Connect Parameter OptionsEricom PowerTerm WebConnect Connect Options

Page 70: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

Specifies the password required to log in to the application server. Either a base-64 encodedlog-in password or a variable can be used.

password— base-64 encoded log-in 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; not specifying it is stronglyrecommended. The user will be prompted to enter the password when theconnection is made. This application server password directive never starts aline, so it can be distinguished from the thin client user sign-on password (whichstarts a line).

Caution

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

Specifies the name required to log in to the application server. Either a conventional log-inname or a variable can be used.

Variable and Description:

username— Conventional log-in 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}

SSH Connect OptionsThe following table contains the supported options you can use for SSH connections (underlined values aredefaults).

ExampleCONNECT=SSH \Description="SSH_Connection" \Host=192.168.0.2 \Reconnect=yes \

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

Connect Parameter OptionsSSH Connect Options

Page 71: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

ReconnectSeconds=100 \Username=root \Command=/usr/X11R6/bin/xterm\

Table 17: SSH Connect Options

DescriptionOption

Default is no.

Yes/no option to start a connection automatically at sign-on.

AutoConnect={no, yes}

Mandatory Option

Specifies a command to execute remotely. For xterms, it is recommended that the ‘-ls’ optionbe used so that it is a login shell.

Command=<command line>

Mandatory Option

Connection description. Provides a connection name for the Desktop icon and the ConnectionManager.

The text must be enclosed in quotation marks if it contains spaces or punctuationcharacters. These characters are not allowed: & ‘ “ $ ? ! | ; ( ) [ ] { } \

Caution

Description=<string description>

Mandatory Option

Specifies the server name or IP address to connect to.

This option ismandatory.

Note

Host=<host server name or IPaddress>

Specifies an icon to appear on the thin client desktop for this connection. The file must bean XPM file located in the FTP server wlx/bitmap directory. If not specified, the default iconis displayed.

Icon=<bitmap file>

Default is yes.

Yes/no option to enable ping. For non-published application connections, a ping (ICMP) issent to the host server prior to connecting to verify that the host is reachable.

Ping={yes, no}

Default is no.

Yes/no option to automatically reconnect to an application server after a disconnection.

Reconnect={no, yes}

Default is 30.

Specifies the amount of time in seconds (default is 30) to wait before automatic reconnectionto an application server after a disconnection. Requires Reconnect=yes or 1.

ReconnectSeconds=<value inseconds>

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

Connect Parameter OptionsSSH Connect Options

Page 72: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

Specifies the name required to log in to the SSH server. Either a conventional log-in nameor a variable can be used.

Variable and Description:

username— Conventional log-in name

$SN— Serial number used

$MAC—MAC address used

$IP— IP Address used

$DN— Sign-on domain name

$UN— Sign-on name used

$PW— Sign-on password used

$TN— Terminal name

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

VNC Viewer Connect OptionsThe following table contains the supported options you can use for VNC Viewer connections (underlinedvalues are defaults).

ExampleCONNECT=VNC_VIEWER \Description="VNC_Connection" \Host=192.168.0.2 \Color=24 \AutoConnect=Yes \Display=0 \Password=xyz \Fullscreen=Yes

Table 18: VNC Viewer Connect Option List

DescriptionOption

Default is no.

Yes/no option to start a connection automatically at sign-on.

AutoConnect={no, yes}

Default is True_Color.

Specifies how many colors to display for each pixel. 16 is 16-bit (thousands); 24 is 24-bit(millions); OwnCMap specifies to use your own color map. Default is True_Color.

Colors={True_Color, 16, 24,OwnCMap}

Connection description. Provides a connection name for the Desktop icon and the ConnectionManager.

The text must be enclosed in double quotation marks if it contains spaces orpunctuation characters. These characters are not allowed: & ‘ “ $ ? ! | ; ( ) [ ] { }\

Caution

Description=<string description>

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

Connect Parameter OptionsVNC Viewer Connect Options

Page 73: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

Default is 0.

Specifies the display to connect to on the server.

Display=<value of 0 to 99>

Default is no.

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

FullScreen={no, yes}

Mandatory Option

Specifies a host or lists of host values. The thin client attempts to connect to the next serveron the list if the current one fails. List items must be separated by semicolons or commas.

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

Specifies the password required to log in to the application server. Either a conventionallog-in password or a variable can be used.

Variable and Description:

password— Conventional log-in 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; not specifying it is stronglyrecommended. The user will be prompted to enter the password when theconnection is made. This application server password directive never starts aline, so it can be distinguished from the thin client user sign-on password (whichstarts a line).

Caution

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

Default is yes.

Yes/no option to enable ping. For non-published application connections, a ping (ICMP) issent to the host server prior to connecting to verify that the host is reachable.

Ping={yes, no}

XDMCP Connect OptionsThe following table contains the supported options you can use for XDMCP connections (underlined valuesare defaults).

Example

CONNECT=XDMCP \Description="Xnest" \Host=192.168.0.2 \

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

Connect Parameter OptionsXDMCP Connect Options

Page 74: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

Mode=Query \Resolution=800x600 \Program=Xnest \Reconnect=Yes \Ping=Yes \AutoConnect=Yes

ExampleCONNECT=XDMCP \Description="xServer" \Host=192.168.0.2 \Mode=Chooser \Fullscreen=yes \Program=Xserver \Reconnect=Yes \Ping=yes \Icon=W61.xpm

Example

CONNECT=XDMCP \Description="Indirect_User" \Mode=Broadcast

Table 19: XDMCP Connect Options

DescriptionOption

Default is no.

Yes/no option to start a connection automatically at sign-on.

AutoConnect={no, yes}

Connection description. Provides a connection name for the Desktop icon and the ConnectionManager.

The text must be enclosed in double quotation marks if it contains spaces orpunctuation characters. These characters are not allowed: & ‘ “ $ ? ! | ; ( ) [ ] { }\

Caution

Description=<string description>

Default is no.

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

FullScreen={no, yes}

Mandatory Option

Specifies a host or lists of host values. The thin client attempts to connect to the next serveron the list if the current one fails. List items must be separated by semicolons or commas.

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

Specifies an icon to appear on the local desktop. The file must be located in the serverwlx/bitmap directory. If not specified, the default icon is displayed (except in the case of apublished application). A PNG, JPEG, or GIF may be used. XPM is permitted for backwardcompatibility.

Icon=<image file>

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

Connect Parameter OptionsXDMCP Connect Options

Page 75: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

Default is Query.

Broadcast— sends broadcast query packets to the network - the first responding displaymanager is chosen.

Chooser— selects all hosts you specify in host

Query— (default) selects only one host you specify in host. The first responding displaymanager is chosen.

Mode={Broadcast, Chooser, Query}

Default is yes.

Yes/no option to enable ping. For non-published application connections, a ping (ICMP) issent to the host server prior to connecting to verify that the host is reachable.

Ping is only used in Querymode.

Note

Ping={yes, no}

Default is Xnest.

Use Xnest to connect, or run a new instance of the Xserver. Use Xserver to claim the entiredisplay.

Program={Xnest, Xserver}

Default is no.

Yes/no option to automatically reconnect to an application server after a disconnection.

Reconnect={no, yes}

Default is 30.

Specifies the amount of time in seconds (default is 30) to wait before automatic reconnectionto an application server after a disconnection. Requires Reconnect=yes or 1.

ReconnectSeconds=<value inseconds>

Default is default, which starts the connection using the current desktop display settingwith no window frame or border.

Specifies the connection display resolution. The default value starts the connection usingthe current desktop display setting with no window frame or border.

Arbitrary widthxheight values are accepted.

Resolution={default, 640x480,800x600, 1024x768, 1280x1024,1600x1200, <width>x<height>}

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

Connect Parameter OptionsXDMCP Connect Options

Page 76: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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

Connect Parameter OptionsXDMCP Connect Options

Page 77: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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 73

• NetworkPrinter, page 75

• Printer, page 76

• PrinterURI, page 77

• SMBPrinter, page 79

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=<host address><options you want>

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

Page 78: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

Table 20: 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]

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

Printer Parameter OptionsJetDirectPrinter

Page 79: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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.

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

Caution

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

Table 21: 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}]

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

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

Printer Parameter OptionsNetworkPrinter

Page 80: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

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]

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.

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

Caution

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

Table 22: Printer 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}]

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

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

Printer Parameter OptionsPrinter

Page 81: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

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.

Example:

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

ThinPrintClass= PrinterName1=Class1[;PrinterName2=Class2]

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.

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

Printer Parameter OptionsPrinterURI

Page 82: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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

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 23: PrinterURI 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}]

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

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

Printer Parameter OptionsPrinterURI

Page 83: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

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 CUPS configurationon another system.

Note

[PPD=<PPD name>]

Sets the class name for a printer.

Example:

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

ThinPrintClass= PrinterName1=Class1[;PrinterName2=Class2]

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.

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

Caution

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

Table 24: SMBPrinter 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}]

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

Printer Parameter OptionsSMBPrinter

Page 84: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

DescriptionOption

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 CUPS configurationon another system.

Note

[PPD=<PPD name>]

Sets the class name for a printer.

Example:

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

ThinPrintClass= PrinterName1=Class1[;PrinterName2=Class2]

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

Printer Parameter OptionsSMBPrinter

Page 85: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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 \

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

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

Page 86: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

The following values must be preceded with America/. For example, America/Adak is the value forthe Adak 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 also Brazil,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 forthe ACT 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

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

Acre, DeNoronha, East, West

Brazil

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

Timezone Parameter Values

Page 87: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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 valuefor the 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

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

Timezone Parameter Values

Page 88: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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

Timezone Parameter Values

Page 89: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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 25: Keyboard.layouts Values

NotesValueRDPICACountry

alAlbania

Phoneticam_phoneticArmenia

*Arabic (Egypt)araxxArabic

Azertyara_azerty

Azerty\digitsara_azerty_digits

Digitsara_digits

ara_qwerty_digits

Cyrillicaz_cyrillicAzerbajian

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

Page 90: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

NotesValueRDPICACountry

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

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

Keyboard.layouts Parameter Values

Page 91: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

NotesValueRDPICACountry

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

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

Keyboard.layouts Parameter Values

Page 92: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

NotesValueRDPICACountry

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

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

Keyboard.layouts Parameter Values

Page 93: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

NotesValueRDPICACountry

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

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

Keyboard.layouts Parameter Values

Page 94: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

NotesValueRDPICACountry

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

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

Keyboard.layouts Parameter Values

Page 95: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

NotesValueRDPICACountry

Dvorak, Polish quotes on quotemark keypl_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

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

Keyboard.layouts Parameter Values

Page 96: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

NotesValueRDPICACountry

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

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

Keyboard.layouts Parameter Values

Page 97: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

NotesValueRDPICACountry

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 (former us_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 Virtualization Experience Client 6215 Firmware Release 9.7 93

Keyboard.layouts Parameter Values

Page 98: INI Files Reference Guide for Cisco Virtualization Experience … · CHAPTER 1 Preface TheCiscoVirtualizationExperienceClient6215(VXC6215)runningtheCiscoVirtualizationExperience …

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

Keyboard.layouts Parameter Values