wlx.ini and $mac.ini file parameters only...parameter description defaultisno....

20
wlx.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 be used in a {username}.ini file. Caution The underlined value for a parameter is the default value. Some parameters also have options shown within brackets [ ]. If an option has an underlined value (default), that option and default value will automatically be used with the parameter (options without underlined values can also be used if you want to, but are not automatically used with the parameter). In addition, when using parameters and options, you can leave the default value or change it to another value shown. For example, in the following case where: ParameterX={yes , no} [Option1={0 , 1}] [Option2={1, 2, 3, 4}] If you use ParameterX, then Option1 and its default value 0 will automatically be used as Option1 has an underlined value (default of 0). You can still use Option2 if you want to, however, Option2 is not automatically 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 are separated into the following categories: wlx.ini and $MAC.ini File General Settings, page 2 wlx.ini and $MAC.ini File Peripheral Settings, page 9 wlx.ini and $MAC.ini File Connection Settings, page 10 wlx.ini and $MAC.ini File Custom GNOME Settings, page 17 INI Files Reference Guide for Cisco Virtualization Experience Client 6215 Firmware Release 10.6 1

Upload: others

Post on 17-Aug-2020

2 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

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

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

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

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

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

Page 2: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

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

Default is no.

Yes/no option on how the system starts when the power is first applied to thethin client.

If set to yes, then the system starts itself without waiting for users to pressthe power button (in cases where power was lost unexpectedly; even if thethin client was shut down properly before power was lost unexpectedly, whenthe power is restored, the thin client will be powered on). This setting is usefulin a kiosk environment.

Once an AutoPower statement is processed, it alters the behavior of the thinclient until a countermanding statement is processed. The effect of anAutoPower=yes statement continues even if the statement is removed fromthe INI file in which it was found.

Use of the AutoPower option does not interfere with performing a user directedshutdown.

AutoPower={no, yes}

Specifies the new password for the user with administrative privileges. Defaultis base-64 encoded.

ChangeAdminPassword=<base-64 encodedpassword>

Specifies the new password for the guest user. Default is base-64 encoded.ChangeGuestPassword=<base-64 encoded password>

Specifies the new password for the root user. Default is base-64 encoded.ChangeRootPassword=<base-64 encoded password>

Specifies the new password for the thin user. Default is base-64 encoded.ChangeThinUserPassword=<base-64 encodedpassword>

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

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

Page 3: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

DescriptionParameter

Default is no.

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, Dual VLAN detectionis disabled.

• No—If Cisco.Config.DisableDualVLAN=no or any other value(including invalid values), or if the parameter is not present, Dual VLANdetection is enabled.

Cisco.Config.DisableDualVLAN={no|yes}

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

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

Disablemenubar={no, yes}

Do Not Use. No Longer Supported.DisableReadyMode={no, yes}

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

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

Page 4: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

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 used for802.1x.

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.

InnerAuthentication—The second EAP type inside the PEAP tunnel. Usedonly in cases of PEAP authentication.

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.

AuthMode—Default isMachine. AuthenticationMode for TLS. SetAuthModeas Machine for TLS machine authentication or set to User for TLS userauthentication.

Example: Below is an example INI for 802.1x TLS Machine authentication.

Enable802=yesAuthentication=TLSPromptPassword=noCACertificate=scepUserCertificate=scep PrivateKey=scep PrivateKeyPassword=ZG90MXg=AuthMode=Machine

Example: Below is an example INI for 802.1x TLS User authentication.

Enable802=yesAuthentication=TLSPromptPassword=noCACertificate=scepUserCertificate=scep PrivateKey=scep PrivateKeyPassword=ZG90MXg=AuthMode=User

Example: Below is an example INI for EAP-PEAP connection.

Enable802=yes Authentication=PEAP InnerAuthentication=MSCHAPv2PeapVersion=Auto PromptPassword=no CACertificate=SCEPAuthMode=user

Enable802={no, yes}

Authentication={TLS, PEAP}

[PromptPassword={no, yes}]

[InnerAuthentication={MSCHAPv2}]

[UserCertificate=<certificate name>]

[CACertificate=<certificate name>]

[PrivateKey=<certificate name>]

[PrivateKeyPassword=<password>]

[PeapVersion={Auto,0,1}]

[AuthMode={Machine, User}]

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

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

Page 5: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

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

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

Page 6: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

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 10.66

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

Page 7: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

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

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

Page 8: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

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

Specifies the name of the thin client comprising a 15-character string.TerminalName=<name of thin client>

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

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

Page 9: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

DescriptionParameter

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.

Note

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

Default is Both.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}

Default is yes.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}

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

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

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

Page 10: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

Table 2: 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 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>

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 3: 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 10.610

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

Page 11: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

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

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

Page 12: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

DescriptionParameter

Default is no.

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

AutoSignoff={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 10.612

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

Page 13: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

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

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

Page 14: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

DescriptionParameter

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

When using the ICADenyUSB parameter, a user candeny redirection of devices using class/subclass alsoalongwith vid/pid (ICADenyUSB=class=01 subclass=01to deny USB Audio family).

Note

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

Specifies the JRE exception sites.

Example:

Java.Exception.Sites=http://aaa.111.aaa https://bbb.222.bbbhttps://abcd.123.abcd

Java.Exception.Sites={URLs separated by space}

Default is high.

Specifies the JRE security level.

Java.Security.Level={medium, high, very_high}

Default is no.

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

PermitSSHRootLogin={no, yes}

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

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

Page 15: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

DescriptionParameter

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]

Default is no.

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

Seamless={no, yes}

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

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

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

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

Page 16: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

DescriptionParameter

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

Specifies the keys or key combinations that should be sent to thelocal device instead of sending to the remote VMWare PCOIPsession.

Key combinations must be in the form of <modName>scanCode

Where:

• modName is one of four modifier keys: ctrl, alt, shift, andsuper. The Super key is keyboard-specific. For example,the Super key is usually the Windows key on a MicrosoftWindows keyboard.

• scanCode value is the keyboard scan code, in hexadecimal.

Example:

VMWareViewKeyConfig=<Alt>0x0f,<Ctrl><Alt>0x153

VMWareViewKeyConfig={<modName 1>key scancode 1,….<modName N>key scancode N}

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

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

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

Page 17: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

DescriptionParameter

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.

Table 4: 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 ; >

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

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

Page 18: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

DescriptionOption

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

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}

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

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

Page 19: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

DescriptionOption

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

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

Page 20: wlx.ini and $MAC.ini File Parameters Only...Parameter Description Defaultisno. IfyoudonotplantouseDualVLANconfiguration,usethisparameterto disableDualVLANdetectionandenablefasterstartupfortheCiscoVXC

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

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