INI Files Reference Guide for Cisco Virtualization Experience Client 2112/2212 ICA Firmware Release 7.1_118
WNOS INI only parameters
Downloads: This chapterpdf (PDF - 1.29MB) The complete bookPDF (PDF - 2.4MB) | Feedback

WNOS INI only parameters

WNOS INI only parameters

Parameters for wnos.ini files only

This chapter provides the supported parameters that you can use in a wnos.ini file.


Caution


Parameters in this chapter can only be used in a wnos.ini file; they cannot be used in a {username}.ini file.


Important:

The bold value for a parameter is the default value. Some parameters also have options shown within brackets [ ]. If an option has a bold value (default), that option and default value will automatically be used with the parameter (options without bold 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:

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 a bold 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 (bold) value.

General settings (wnos.ini files only)

The following table contains parameters (and their options) used for configuring general settings.

Table 1 General settings: wnos.ini files only
Parameter Description
AutoLoad=[0, 1, 2, 101, 102, 201, 202] [PXE= {imaging}]

AutoLoad-Specifies the firmware update mode.

  • 0-Disable checking for image.
  • 1-Enable a forced firmware upgrade/downgrade process. Default is 1.
  • 2-Enable a comparison/non-forced upgrade only process.
  • 101-Enable firmware upgrade/downgrade process, but have a popup message with OK and Cancel buttons appearing before the process; completion message appears after process.
  • 102-Enable upgrade only, but have a popup message box with OK and Cancel buttons appearing before the process; completion message appears after process.
  • 201-Enable a forced firmware upgrade/downgrade process, but have a popup message with OK button appearing before process although process will begin in 20 seconds in any case; completion message appears after process.
  • 202-Enable a comparison/non-forced upgrade only process, but have a popup message with OK and Cancel buttons appearing before the process; completion message appears after process.

PXE-Specifies for WTOS clients that boot from PXE to flash the image from an FTP server to the unit, otherwise the system runs in a normal mode.

Note   

PXE is not applicable to Cisco VXC clients.

AutoPower={no, yes}

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

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

After an AutoPower statement is processed, it alters the behavior of the zero client until a countermanding statement is processed. The effect of an AutoPower=yes statement continues even if the statement is removed from the INI file in which it was found.

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

DefaultUser={username, $SYS_VAR}

Specifies the default sign-in user.

See Rules and recommendations for WTOS INI files for a list of system variables for $SYS_VAR.
DisableButton={no, yes} Yes/no option to disable the power button.
EnableCacheIni={no, yes}
Caution   

IMPORTANT: This parameter is no longer supported and cannot be used. It is replaced by the MirrorFileServer parameter

EnableGKey={no, yes} Yes/no option to enable G key reset. G key reset is supported for Privilege=High in the NVRAM.
Exit={yes, no, all}

Specifies the INI file processing.

  • yes-Processing returns to the prior INI file on the next line after $include.
  • no-There is no operation.
  • all-All INI file processing is exited.
Include=$mac.ini

Loads "/wnos/inc/mac-address.ini".

Note   

The file name does not include the symbols ":" in the mac address. See also the Exit parameter for information on how to terminate Include.

MirrorFileServer={no, yes}

Yes/no option to enable the cache all server files functionality (cache all server files such as INI files, wallpaper, bitmap, font, local messages and so on to the local flash when files are changed in the file server). WTOST would use the cached files when files on the file server are unavailable. Default is set to no.

RootPath=FTP root path This FTP root path is entered into zero client local setup (non-volatile memory). The zero client immediately uses this path to access files. The directory name \wnos will be appended to the FTP root path entry before use.
TerminalName=name [reboot={no, yes}]

TerminalName-Name of the zero client comprising a 15-character string.

reboot-Yes/no option to reboot the zero client if the terminal name is changed.

TimeZone=zone

[ManualOverride={no, yes}]

[daylight={no, yes}]

[start=mmwwdd end=mmwwdd]

[TimeZoneName=timezonename]

[DayLightName=daylightname]

TimeZone-Specifies the time zone if the zone is unspecified on the zero client or is used with ManualOverride. Supported zones are listed in the System Preference dialog box (for example: 'GMT - 12:00' to 'GMT + 13:00' at one hour increment, 'GMT + 03:30', 'GMT + 04:30', 'GMT + 05:30', 'GMT + 05:45', 'GMT + 06:30', 'GMT + 09:30', 'GMT - 3:30' and 'Greenwich Mean Time').

ManualOverride-Yes/no option to override the zero client System Preference Menu setting with this TimeZone setting. TimeZone settings in the wnos.ini file will be saved into NVRAM if EnableLocal=yes is set in the wnos.ini file.

Daylight-Yes/no option to enable daylight saving time; mmwwd is a 6-digit number to specify the start and the end of daylight saving time using the following:

  • mm -01 to 12 for the month of the year from January to December. For example, 01 is January.
  • ww-01 to 05 for the week of the month. For example, 01 is the first week.
  • dd-01 to 07 for the day in the week from Monday to Sunday. For example, 01 is Monday.

TimeZoneName-Display name sent to the ICA/RDP session (such as Eastern Standard Time).

DayLightName-Display name for daylight saving time. If daylight saving time is enabled, DayLightName should be named something similar to Eastern Daylight Time, otherwise it should be the same as TimeZoneName.

Note   

To configure daylight saving time for an RDP session, you must enable the Allow Time Zone Redirection function. Use the following guidelines: Run gpedit.msc to open the Group Policy dialog box. Click Computer Configuration in the Local Computer Policy tree. Expand the Administrative Templates folder. Expand the Windows Components folder. Expand the Terminal Services folder. Click Client/Server data redirection to open the Setting list. Right-click Allow Time Zone Redirection and select Properties to open the Allow Time Zone Redirection Properties dialog box. Select the Enabled option, and then click OK. Close the Group Policy dialog box.

Peripheral settings (wnos.ini files only)

The following table contains parameters (and their options) used for configuring peripheral settings (such as keyboard, monitor, mouse, printer, and so on).



Table 2 Peripheral settings: wnos.ini files only
Parameter Description
PrinterMap=a text file name (or possibly URL) A text file to be included to define printer mappings. Each line in the file is of format Printer Identification=Printer Driver Name. For example: HL-1240 Series=HP LaserJet.

ThinPrintEnable={no, yes}

[Port=port number]

ThinPrintEnable-Yes/no option to enable the thinprint client.

port-The TCP port of the thinprint client. The default port number value is 4000. The port number value must be less than 65535.

Connection settings (wnos.ini files only)

The following table contains parameters (and their options) used for configuring connection settings.

Table 3 Connection settings: wnos.ini files only
Parameter Description

AddCertificate=filename

password={plain text password}

Password-enc={encrypted password}

AddCertificate-Specifies a certificate file residing in the subfolder cacerts under the wnos folder to load on the nand flash device (on platforms with nand flash), or on the memory. The length of the filename, including the trailing period and the file extension, is limited to 64 characters.

This parameter is required when configuring the Citrix Secure Gateway PNAgent Interface (PNAgent/Lite servers) in the Network Setup dialog box. Adding certificates are required if the user CSG environments use certificate agents that are not covered by the built-in certificates. The certificates are used to validate server identities by the zero client.

Supported files include .crt file on ICA CSG; .cer and .pfx in 802.1x.

Password and Password-Enc are for special use with PFX files.

Community=community Specifies the SNMP community name. Maximum of 31 characters is allowed in a string. After being specified, it is saved in the non-volatile memory.

ConnectionBroker={default, VDM}

[IgnoreProfile={no, yes}]

[SecurityMode={None,Warning,Full}]

Specifies the type of VDI broker to use.

IgnoreProfile — Set "IgnoreProfile=yes" to disable parsing the global setting from the VDI broker. It is only valid in the case of ConnectionBroker=default.

SecurityMode — SecurityMode specifies the security mode for the VMware broker. It is only valid in the case of ConnectionBroker=VMware, as follows:

  • Set SecurityMode=Full to have the View Client verify the server's certificate in highest security mode; if any relevant checks error, it will fail to connect to the server.
  • Set SecurityMode=Warning to have the View Client allow connection continuation in the following two specific exceptions where Full verification would fail:
    1. Certificate is self-signed.
    2. Certificate has an invalid time.
  • Set SecurityMode=None to have the View Client allow connection without any certificate verification.
DelCertificate={filename, all} Removes the named file from the nand flash or from the memory. If DelCertificate=ALL, then all certificates (except built-in certificates) will be deleted from the flash.
DesktopColorDepth={16, 32} DesktopColorDepth-Sets the desktop color to 16 or 32 bits. If DesktopColorDepth=16, the default color is 15 bits.
DHCPExpire={reboot, shutdown} When a DHCP lease expires, a message notifies the user as follows: DHCP Expired, you must reboot.
  • reboot-After 5 seconds, the system reboots.
  • shutdown-After 5 seconds, the system shuts down.

DHCPOptionsRemap={no, yes}

[DisableOption12={no, yes}]

[FileServer={128 to 254}]

[RootPath={128 to 254}]

[FtpUserName={128 to 254}]

[FtpPassWord={128 to 254}]

[RapportServer={128 to 254}]

[RapportPort={128 to 254}]

[PnliteServer={128 to 254}]

[DomainList={128 to 254}]

[VDIBroker-{248 to 254}]

[RapportSecurePort={128 to 254}]

DHCPOptionsRemap-Specifies whether or not the following options can be set. (the options are for use when default DHCP options discussed in the INI Files Reference Guide for Cisco Virtualization Experience Client 2112/2212 must be remapped).

The value for each option must be from 128 to 254. Values for the options must be different for each option. These options are used to configure DHCP server tags for zero client booting.

Note   

The DisableOption12 option sets whether or not the Option12 tag is accepted. By default, DHCP option 12 sets the hostname and domain name of the terminal. For example, if the option 12 information is terminalname.cisco.com, the terminal name will be set as terminalname and the domain name will set as cisco.com. If the DisableOption 12 setting is different than the value in NVRAM, the system will automatically reboot to make the value valid.

Note   

RapportSecurePort is the specified HTTPS port of the Cisco VXC Manager server.

[DHCPUserClassID=class_id

{ParseVendorInfo={no, yes]

DHCPUserClassID-Specifies the UserClassID used for DHCP.

ParseVendorInfo-Yes/no option to specify whether or not WTOS will interpret DHCP option 43 (vendor-specific information). Default is yes.

If ParseVendorInfo is set to no and the DHCPVendorID is also used with this parameter, you must set ParseVendorInfo=yes and then reboot the zero client twice. Maximum of 26 characters is allowed in a string.

DHCPVendorID=vendor

[ParseVendorInfo={no, yes}]

DHCPVendorID-Specifies the VendorID used for DHCP.

ParseVendorInfo-Yes/no option to specify whether or not WTOS will interpret DHCP option 43 (vendor-specific information). Default is yes.

If ParseVendorInfo is set to no and the DHCPVendorID is also used with this parameter, you must set ParseVendorInfo=yes and then reboot the zero client twice. Maximum of 26 characters is allowed in a string.

DisableDomain={no, yes} Yes/no option to disable the drop-down domain list in the PNAgent/PNLite sign-in dialog box.

DNSIPVersion={ipv4, ipv6}

[DNSServer=server_list]

[DNSDomain=dns_domain_url]

Specifies the DNS server and domain. Default IP version is ipv4.

The DNSServer is an IP list separated by ";" or ",", max size of this list is 16.

DNSTTL={0-3600}

Specifies the Time to Live (TTL) of DNS name caching; the default is from DNS server settings.

Note   

If DNSTTL=0, the DNS hostname in a connection always queries the DNS server to get the IP.

DomainList=List of NT domain names

A list of domain names that will appear in the zero client sign-in dialog box as options to help users in selecting the domain to sign-in to PNAgent/ PNLite servers. After being specified, it is saved in non-volatile memory.

Note   

Be sure to enclose in quotation marks if spaces are included. For example: DomainList= "North_America, SQA, test-domain"

Dualhead={no, yes}

[ManualOverride={no, yes}]

[Mainscreen={1, 2}]

[Align={Top|Left, Center, Bottom|Right}]

[Taskbar={wholescreen, mainscreen}]

Dualhead-Yes/no option to support a dual-monitor display.

ManualOverride-Yes/no option to allow the local client to override display dualhead settings received from central configuration (a factory default reset will again take server settings for dualhead). This is helpful for scenarios where you have a mixture of dualhead and single head deployments. For example:

Dualhead=yes ManualOverride=yesMainscreen=1 \ Orientation=hort Taskbar=mainscreen

Mainscreen-Sets which screen is used as the main screen.

Align-Sets how screens are aligned: Top means screens are top aligned in "hort" orientation. Left means screens are left aligned in "vert" orientation. Center means screens are center aligned. Bottom means screens are bottom aligned in "hort" orientation. Right means screen are right aligned in "vert" orientation.

Taskbar-Sets which style is used for the taskbar: "wholescreen" places the taskbar at the bottom of the entire screen; "mainscreen" places it at the bottom of the main screen.

Caution   

If Dualhead is changed from no to yes, the zero client requires a reboot to change the monitor display.

FileServer=List of {IP address, DNS name}

[Username=username]

[Password=password]

FileServer-Specifies the FTP server IP address or DNS name that is entered into zero client local setup (non-volatile memory); the zero client immediately uses this server to access files.

Username-Specifies the username of the file server.

Password-Specifies the password of the file server.

Note   

The target file server must support access using the same user credentials used in the INI files.

FormURL=URL to a file Specifies the URL to the name of a bitmap file (.ico, .bmp, .jpg, or .gif), to be displayed in the sign-in window, residing under the zero client home directory. The length of the path, including the home directory and the file, is limited to 128 characters. If auto dial-up is enabled, this statement is invalid.

LongApplicationName={no, yes}

Yes/no option to display all 38 characters in a desktop icon name. If LongApplicationName=no then icons will display up to 19 characters (any over 19 characters and the last three characters will be "…").

MaxVNCD={0, 1}

[VNCD_8bits={yes,no}]

[VNCD_Zlib={yes, no}]

Option to enable VNC shadowing. Default value is 1 which means VNC shadowing is enabled. Note that only one VNC client session is allowed. Set to 0 to disable shadowing.

VNCD_8bits — Yes/no option to force the VNC server to send out images with 8-bits-per-pixel; if set to no, the VNC server will send out images with the current system color depth. Default = yes.

VNCD_Zlib — Yes/no option to allow the VNC server to send data with Zlib compression. Default = no.

Multifarm={no, yes} Yes/no option to support Citrix multifarm functionality for the wnos.ini files. If Multifarm=yes, PNAgent/PNLite users are able to authenticate to more than one Citrix farm.
MultiLogon
Important:

DO NOT USE as this parameter is being deprecated. Use SelectServerList={PNA, VDI}.

NoticeFile=filename

[Resizable={no, yes}]

[Timeout={0, 10 to 600}]

NoticeFile-Specifies a legal notification file residing in the home directory folder. The file is displayed in a dialog box and the user is prompted to accept it before the sign-in process continues.

Resizable-Yes/no option to resize the dialog box to fit the text size.

Timeout-After the notice is accepted, if Timeout (seconds) is specified, and if no mouse or keyboard is used, then the dialog box will display again after the seconds set. (0 means no timeout).

PasswordServer=password_server

[AccountSelfService={yes, no}]

[connect={ica, rdp}]

[encryption={Basic, 40, 56, 128, Login-128, None}]

PasswordServer — Specifies the IP Address of the password server (which can be defined as an Account Self Service server (AccountSelfService=yes) or a direct connection (connect=) - if no option is specified, it will connect with the ICA protocol).

AccountSelfService — Yes/no option to define the password server as an Account Self Service server. AccountSelfService=yes also displays the Account Self-Service icon on the Log on dialog box. If AccountSelfService=yes option follows the PasswordServer parameter, the password server specified will be defined as the account self-service server and the connect option will be invalid.

connect — Defines the password server as a direct connection to an ICA or RDP server that can be logged on to modify a password for a user sign-on with a password timeout. An encryption option can also be set for this direct connection.

PlatformConfig=all

[EncryptFS=yes]

Encrypts local flash, specifically cached INI files and credentials that are stored (if using signon=yes).

Note   

Event log will display new statements stating that FileSystem encryption has been enabled.

RapportDisable={no, yes}

[DHCPinform={no, yes}]

[DNSLookup={no, yes}]

RapportDisable - Yes/no option to disable the Cisco VXC Manager agent.

Discovering the Cisco VXC Manager server is supported by the following:

  1. DHCP option tag values received from standard or WDM proxy DHCP service for vendor class “RTIAgent”
  2. DNS service location record "_wdmserver._tcp"
  3. DNS host name lookup "wdmserver"

If RapportDisable=no, setting DHCPinform=yes will do number 1, setting DNSLookup=yes will do numbers 2 and 3.

RapportServer=server_list

[Retry=retry number]

RapportServer-Specifies a list of IP addresses or DNS names (separated by using a comma) for the Cisco VXC Manager servers. After being specified, it is saved in non-volatile memory.

Retry-Determines the number of attempts to retry a contact to Cisco VXC Manager servers.

Reboot={no, yes} Time=hh:mm

Reboot-Yes/no option to enable automatic daily reboot of all WTOS devices.

Time-Specifies the time to reboot and must be in a 24-hour format. For example:

Reboot=Yes Time=17:30

will reboot all WTOS devices at 5:30 p.m. daily.

RegisterWINS=yes Forces the zero client to register itself with a Microsoft WINS server.
SelectServerList={PNA, VDI}; list of servers {Server1; Server2; ServerN}

Allows users to select one PNA or VDI server during sign-in.

For a PNA server, use the format: <description> - <host> [- <options>]

For a VDI server, use the format: <description> - <host>

Note   

Be sure to use a comma (,) or a semicolon (;) to separate different servers and to use a dash (-) to separate the server description, host, and other options.

For PNA server options: Use the options of the PnliteServer parameter in <Table 3-1 on page 3-2>??.

PNA example:

SelectServerList=PNA ; ServerDescription1 - 192.168.0.10 - autoconnectlist=* reconnectfrombutton=0; ServerDescription2 - HostName2.cisco.com - TimeOut=200; ServerDescription3 - https://server3.cisco.com;

For a VDI server: If you want to use a VDM VDI broker, specify ConnectionBroker=VDM in wnos.ini. Otherwise the VDI broker type is default.

VDI example:

ConnectionBroker=VDM SelectServerList=VDI ; description1 - 192.168.0.11; description2 - host2.cisco.com

Service={snmpd, thinprint, vncd}

disable={no, yes}

Service-Specifies the services you can enable or disable (there are different syntaxes for the different services).

disable-Yes/no option to disable the services. disable must follow the Service parameter.

Service=snmpd disable={no, yes} {community=<snmp community>}

Service=snmpd disable-Yes/no option to disable the snmpd service.

community-Same as the statement "Community."

Service=thinprint disable={no, yes} [port=<port number>] [PkSize={0-64000}]

Service=thinprint disable-Yes/no option to disable the thinprint service.

port-Same as the statement "ThinPrintEnable={no, yes} port=port number."

PkSize-Specifies the default packet size that will be sent to the server when negotiating with the thinprint server. The value 0 will rely on the server default setting, 64000 in ThinPrint 7.6 and 32000 in previous ThinPrint versions. WTOS only allocates a buffer of 64K, so if the default packet size of the server is above 64000, this setting must be set or printing will fail.

Service=vncd disable={no, yes} Yes/no option to disable the vncd service (same as "MaxVncd={0, 1}").
Service=<port number> disable={no, yes} Yes/no option to disable the service with this port number. The 80 port is an exception because the Cisco VXC Manager is always started before loading the global profile (wnos.ini file).

SignOn={yes,no, NTLM}

[MaxConnect=max]

[ConnectionManager={maximize, minimize, hide}]

[EnableOK={no, yes}]

[DisableGuest={no, yes}]

[DisablePassword={no, yes}]

[LastUserName={no, yes}]

[RequireSmartCard={no, yes}]

[SCRemovalBehavior= {-1, 0, 1}]

[SaveLastDomainUser={yes, no}]

[DefaultINI=filename]

[IconGroupStyle={default, folder}]

[PasswordVariables={yes, no}

[ExpireTime={1 - 480}]

SignOn-Yes/no/NTLM option to enable the sign-in process. If set to NTLM, a user can be authenticated with an NTLM protocol. The user must be a domain user and the same sign-in user credentials must be available in the ftp://~/wnos/ini/ directory. The NTLM protocol also requires a WINS server.

MaxConnect-Maximum number of connections allowed to be specified in the wnos.ini file and {username}.ini file totalled together. The range allowed for MaxConnect is 100 to 1000. The default maximum is 216 entries.

ConnectionManager-State of the Connect Manager during sign-in.

EnableOK-Yes/no option to show the OK and Cancel command buttons in the sign-in dialog box.

DisableGuest-Yes/no option to disable the guest sign-in.

DisablePassword-Yes/no option to disable the password text box and password check box in the sign-in dialog box.

LastUserName-Yes/no option to display the last sign-in username after the user signs off.

RequireSmartCard-Yes/no option to force sign-in with smartcard.

SCRemovalBehavior-Specifies what happens after a smart card is removed.

-1-System keeps working, but cannot communicate further with the server, and the lock terminal option is grayed out.

0-System will sign out

1-System will be locked and can be unlocked only when the same certificate is used with the smart card

SaveLastDomainUser-Yes/no option to save the username and domain into NVRAM after sign-in is successful. On next reboot, the username and domain saved in the NVRAM will be displayed in sign-in server as the default username and domain if no DefaultUser is set in the wnos.ini file. The size of username/domain is limited to 32 characters, and if larger than 32, it will first be truncated and then saved into NVRAM.

(continued)

SignOn={yes,no, NTLM}

[MaxConnect=max]

[ConnectionManager={maximize, minimize, hide}]

[EnableOK={no, yes}]

[DisableGuest={no, yes}]

[DisablePassword={no, yes}]

[LastUserName={no, yes}]

[RequireSmartCard={no, yes}]

[SCRemovalBehavior= {-1, 0, 1}]

[SaveLastDomainUser={yes, no}]

[DefaultINI=filename]

[IconGroupStyle={default, folder}]

[PasswordVariables={yes, no}

[ExpireTime={1 - 480}]

DefaultINI — The optional DefaultINI configures a file name which is in the default folder of the username ini files.

If the {username}.ini is not found, this file will be loaded as default.

IconGroupStyle — The optional IconGroupStyle configures the icongroup style on the desktop. PNAgent published applications can be configured with the client folder in the PNA server. If set IconGroupStyle=folder, the PNAgent published applications which are specified to display on the desktop will display with the folder. After clicking the folder icon, the subfolder or applications in this folder will display on the desktop. In this case, there is an Up to 1 Level icon on top. Clicking this icon will display the up one level folder contents.

PasswordVariables — Yes/no option to support variable mapping ($TN, $UN etc) for a password.

ExpireTime — Specifies the signon expiration time. The range is 0 to 480 minutes. The default is 0 which means no expiration.

If the value is larger than 480, then 480 is set instead. If the value is smaller than 0, then 0 is set instead.

After system signon or launching a connection, the expiration time starts counting. Once the expiration time is reached, launching a connection (click icon, menu or connection manager) will bring up a pop up message box to input the password. Only if the password is same as the original signon password, will the session be launched.

If the terminal is locked and unlocked with the password, the signon expiration time starts counting again.

Speedbrowser={on, off} On/off option to enable the ICA Speedscreen Browser Acceleration Function.
SwitchApplication={yes, no}
Important:

DO NOT USE as this parameter is being deprecated.

SysMode={classic, vdi}

[toolbardisable={no, yes}]

[toolbardisablemouse={no, yes}]

[toolbarclick={no, yes}]

[toolbardelay={0-4}]

[toolbar_no_conmgr={no, yes}]

[toolbar_no_minimizeall={no, yes}]

[toolbardisablehotkey={no, yes}]

ToolbarEnableOneSession={no, yes}]

[ToolbarAutoQuit={yes, no}]

[ToolbarStay={1~20}]

SysMode-Specifies the Cisco VXC Zero interface (optimized for VDI) or the Classic interface. This value will be remembered across reboots until changed. If not defined and an INI is present, Classic mode is the default. If no INI is present, VDI mode is the default.

Classic mode has full taskbar, desktop and connection manager and is recommended for a terminal server environment.

VDI mode (Cisco VXC Zero interface) has a launchpad-style interface optimized for full-screen sessions (that is, Desktops). Everything you need is accessed through an always available overlay interface.

The following options allow you to configure if and when the Cisco VXC toolbar will display under VDI mode.

  • Toolbardisable-Yes/no option to disable the Cisco VXC toolbar from displaying (it set to yes, this option overrules other toolbar display options).
  • Toolbardisablemouse-Yes/no option to disable the Cisco VXC toolbar from automatically displaying after the mouse pointer hovers on the left side of the screen for a specified amount of time.
  • toolbarclick-Yes/no option to pop up the toolbar only if clicking on the left-most side of the screen.
  • toolbardelay-Specifies the seconds to delay before displaying the toolbar after hovering the mouse pointer over the left-most side of the screen. The value 0 will have no delay. The other values 1, 2, 3,4 will delay 0.5, 1, 1.5 and 2 seconds respectively.
  • toolbar_no_conmgr-Yes/no option to hide the Home button.
  • toolbar_no_minimizeall-Yes/no option to hide the Home button (thus affecting the ability to minimize displayed list of connections).
  • toolbardisablehotkey-Yes/no option to disable the CTR+ALT+UPARROW hotkey that allows the toolbar to instantly display (without a timer).
  • ToolbarEnableOneSession — Yes/no option to enable the toolbar when only one session is available.
  • ToolbarAutoQuit — ToolbarAutoQuit=no will prevent the sub-window from being closed. The toolbar will auto-hide after a certain amount of time after user moves the mouse pointer away from the toolbar.
  • ToolbarStay — ToolbarStay={1~20} controls the auto-hide duration, 0.5s per value. Thus if ToolbarStay=1, the Toolbar will auto-hide after 0.5 second; If ToolbarStay=10, the Toolbar will auto-hide after 5 seconds.
SysName={client, DNS} Specifies system name. If set to DNS, a reverse DNS name from the DNS server is checked into the Cisco VXC Manager server (by default, the terminal name is checked in).
TcpTimeOut={1 to 255}

Specifies the timeout value of a TCP connection. The value must be between 1 and 255 (which means the connection timeout value is from 1x30 seconds to 255x30 seconds).

Values of 3-255 are recognized only for backwards compatibility (>2 = 60 seconds), however, these values should not be used and the value should be set to 2.

VncPassword=password [encrypt={no, yes}]

VncPassword=password-Specifies a string of up to 16 bytes as the password used for shadowing.

encrypt-Yes/no option to encrypt the password; an encrypted string is used as a password (ensures US HIPPA and Congress Acts compliance).

WarnUnlinkDisabled={yes, no}

Yes/no option to diable the pop-up warning message when a network has no link for an ICA/RDP session. Default is no.

WINSServer=server_list

Specifies the WINS server address. The WINSserver is an IP list separated by ";" or ",", with a maximum list size of 2.