INI Files Reference Guide for Cisco Virtualization Experience Client 2112/2212 ICA Firmware Release 8.0
WNOS INI only parameters
Downloads: This chapterpdf (PDF - 1.33MB) The complete bookPDF (PDF - 2.48MB) | The complete bookePub (ePub - 199.0KB) | Feedback

WNOS INI only parameters

WNOS INI only parameters

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

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.

General settings (wnos.ini files only)

The following table contains parameters used for configuring general settings (underlined values are defaults).

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

Default is 1.

AutoLoad-Specifies the firmware update mode.

  • 0-Disable checking for image.
  • 1-(default) Enable a forced firmware upgrade/downgrade process.
  • 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.
AutoPower={no, yes}

Default is no.

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}

Default is no.

Yes/no option to disable the power button.

EnableCacheIni
Caution   

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

EnableGKey={yes, no} Default is yes.

Yes/no option to enable G key reset. G key reset is supported for Privilege=High in the NVRAM.

Exit={yes, no, all} Default is yes.

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 file or {username}.ini file>

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

<{username}.ini> loads "/wnos/inc/{username}-address.ini".

Note   

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

MirrorFileServer={no, yes} Default is no.

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). WTOS would use the cached files when files on the file server are unavailable.

RootPath=<file server root path> This file server 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 file server root path entry before use.

TerminalName=<name>

[reboot={no, yes}]

TerminalName-Name of the client comprising a 15-character string. It can also be configured as system variable such as $MAC, $SN, $IP, and so on.

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

TimeZone=<zone value>

[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 zone values are listed in the System Preference dialog box on the thin client and in TimeZone parameter values.

Note   

The TimeZone parameter is dependent on the TimeServer=parameter. If a time server is not defined, the client CMOS/BIOS internal clock will be used as a reference.

ManualOverride-Default is no. 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-Default is no. Yes/no option to enable daylight saving time; MMWWDD is a 6-digit number to specify the start and the end of daylight saving time.

Important:

The Start and End options are in the MMWWDD format, where:

  • MM=Month of the year. Values are 01 to 12 for the months of the year from January to December. For example, 01=January, and 12=December.
  • WW=Week of the Month. Values are 01 to 05 for the week of the month, 05 is the last week. For example, 01=first week and 05=last week of the month.
  • DD=Day of the week. Values are 01 to 07 for the day in the week from Monday to Sunday. For example, 01=Monday, 07=Sunday.

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.

Example

TimeZone="(GMT-08:00) Pacific Time (US & Canada), Tijuana" \
ManualOverride=Yes Daylight=Yes Start=030207 End=110207 \
TimeZoneName="Pacific Standard Time (US & Canada), Tijuana" \
DaylightName="Pacific Daylight Savings Time (US & Canada), Tijuana"

Peripheral settings (wnos.ini files only)

The following table contains parameters used for configuring peripheral settings such as keyboard, monitor, mouse, printer, and so on (underlined values are defaults).



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]

Default is yes.

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 used for configuring connection settings (underlined values are defaults).



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

Default is default.

Specifies the type of VDI broker to use. Default is a 3rd party VDI broker and VDM is a VMware VDI broker."

IgnoreProfile — Default is no. 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=VDM, 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, builtin}

filename — Removes the named file from the nand flash or from the memory.

all — Removes all certificates except built-in certificates included by default.

builtin — Removes all certificates including the public certificates included by default.

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}

Default is reboot.

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

Default is no.

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 (Default is no) 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-Default is yes. Yes/no option to specify whether or not WTOS will interpret DHCP option 43 (vendor-specific information).

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-Default is yes. Yes/no option to specify whether or not WTOS will interpret DHCP option 43 (vendor-specific information).

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}

Default is no.

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

[Orientation={hort, vert}]

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

[Taskbar={wholescreen, mainscreen}]

[MonitorAutoDetect={yes,no}]

Default is no.

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

Caution   

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

ManualOverride-Default is no. 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.

Orientation — Default is hort. Sets which style is used for display (hort means horizontal and vert means vertical).

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-Default is wholescreen. 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.

MonitorAutoDetect — Determines whether or not the system will detect how many monitors are connected. If only one monitor is connected, Span mode will be transfered to Mirror mode.

FileServer=List of {IP address, DNS name}

[Username=username]

[Password=password]

[SecurityMode={No,Warning,Full}]

FileServer-Specifies the FTP or Web (http://) 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.

SecurityMode — Default is Warning. Specifies the security level for the file server during client verification of the server certificate. This option is only valid when connecting to an https file server. When configuring the https file server, the Username and Password options of the FileServer parameter can be omitted. Use the following:

Set SecurityMode=Full to have the client verify the server certificate in highest security mode; if any error occurs during verification, the client will not connect to the server and a pop-up message appears which includes a Reboot option.

(default) Set SecurityMode=Warning to have the client provide a warning when the client cannot verify the server certificate, but still allow the user to select to continue client connection to the server.

Set SecurityMode=No to have the client connect to the server without verifying the server certificate.

Note   

Security process includes:

  1. Verification that certificate has a valid date
  2. Verification that Issuer is valid and correct
  3. Certificate verification passes
  4. CN and SAN on the certificate matches the DNS naming

Example: FileServer=https://10.151.122.66:444 SecurityMode=warning

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}

Default is no.

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

Default is 0.

Option to enable VNC shadowing. Default value is 0 which means VNC shadowing is disabled. Set to 1 to enable shadowing. Note that only one VNC client session is allowed and a password is required. Set to 0 to disable shadowing.

See also VNCPrompt in Connection Settings (wnos.ini files, username.ini, and $MAC.ini files) to enable a VNC shadowing prompt to a user.

See also VncPassword in this table to specify a string of up to 16 bytes as the password used for shadowing.

VNCD_8bits — Default is yes. 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 — Default is no. Yes/no option to allow the VNC server to send data with Zlib compression. Default = no.

Multifarm={no, yes}

Default is no.

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

[Title="notice_title"]

[ButtonCaption="button_caption"]

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-Default is no. Yes/no option to resize the dialog box to fit the text size.

Timeout-Default is 0.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).

Title and ButtonCaption — Specifies the notification window title and button (can be customized). For example,

NoticeFile=filename Title=Problem ButtonCaption=Ok

PasswordServer=password_server

[AccountSelfService={yes, no}]

[connect={ica, rdp}]

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

PasswordServer — (ICA Only) 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.

If you define the AccountSelfService=yes, then it will require a Citrix Password Manager.

If set AccountSelfService=no or there is no AccountSelfService parameter, a direct ica or rdp connection to change the password is made. In this case, it does not require the Citrix Password Manager.

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

Default is no.

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 Cisco VXC Manager 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 [-hh:mm]

Default is no.

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.

Note   

If time is set as hh:mm-hh:mm, a random time during the configured time period will be selected. For example:

To have the client reboot on local time 20:30, set: Reboot=yes time=20:30

To have the client reboot at a random time between 20:30 and 4:30, set:

Reboot=yes time=20:30-4:30

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=server1_desc -host=server_host … description=serverN_desc - host=serverN_host

For a VDI server use the format: description=server1_desc - host=server_host … description=serverN_desc - host=serverN_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 Connection Settings (wnos.ini files, username.ini, and $MAC.ini files)

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-Default is no. Yes/no option to disable the services. disable must follow the Service parameter.

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

Default is no.

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

Default is no.

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}

Default is no.

Yes/no option to disable the vncd service (same as "MaxVncd={0, 1}").

Service=<port number> disable={no, yes}

Default is no.

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, user, domain}]

[DefaultINI=filename]

[IconGroupStyle={default, folder}]

[IconGroupLayout={Vertical, Horizontal}]

[PasswordVariables={yes, no}

[ExpireTime={0, 1 - 480}]

[UnlockRefresh={yes,no}]

Default is yes.

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-Default is minimize. State of the Connect Manager during sign-in.

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

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

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

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

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

SCRemovalBehavior-Default is 0 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, user, domain}]

[DefaultINI=filename]

[IconGroupStyle={default, folder}]

[IconGroupLayout={Vertical, Horizontal}]

[PasswordVariables={yes, no}

[ExpireTime={0, 1 - 480}]

[UnlockRefresh={yes,no}]

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.

IconGroupLayout — Default is vertical. Configures the direction of the icongroup on the desktop.

PasswordVariables — Default is no. 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.

UnlockRefresh — Default is yes. Yes/no option to specifies the refresh action after unlocking the system in classic mode.

Yes - (default) When unlocking the system will refresh the PNA list to verify the password.

No - Disables refresh.

Speedbrowser={on, off}

Default is on.

On/off option to enable the ICA Speedscreen Browser Acceleration Function.

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

[EnableLogonMainMenu={no, yes}]

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-Default is no. Yes/no option to disable the Cisco VXC toolbar from displaying (it set to yes, this option overrules other toolbar display options).
  • Toolbardisablemouse-Default is no. 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-Default is no. 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-Default is no. Yes/no option to hide the Home button.
  • toolbar_no_minimizeall-Default is no. Yes/no option to hide the Home button (thus affecting the ability to minimize displayed list of connections).
  • toolbardisablehotkey-Default is no. Yes/no option to disable the CTR+ALT+UPARROW hotkey that allows the toolbar to instantly display (without a timer).
  • ToolbarEnableOneSession — Default is no. Yes/no option to enable the toolbar when only one session is available.
  • ToolbarAutoQuit — Default is yes 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.
  • EnableLogonMainMenu — Default is no. Yes/no option to enable the main menu if you click the mouse button on the desktop prior to logon in Zero mode.

SysName

Important:

DO NOT USE as this parameter is being deprecated.

SysName is being deprecated.
Important:

DO NOT USE as this parameter is being deprecated.

TcpTimeOut={1, 2}

Default is 1.

Specifies the timeout value of a TCP connection. The number of 30 seconds for the timeout value of a TCP connection. The value must be 1 or 2 which means the connection timeout value is from 1x30= 30 seconds to 2x30= 60 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.

See also MaxVNCD in this table to enable VNC shadowing.

See also VNCPrompt in Ta ble 7 Connection Settings (wnos.ini, username.ini, and $MAC.ini files) to enable a VNC shadowing prompt to a user.

encrypt — Default is no. Yes/no option to set according to whether or not the vncpassword you are using is Base64 encrypted.

Important:

To use VNC Shadow, you must define a password. If you are using a Base64 encrypted password (you can use any third party Base64 encoder/decoder), you must set encrypt to yes (for example: VncPassword=<Base64 encoded password> encrypt=yes). If you are using a plain text password, you must set encrypt to no (for example: VncPassword=<plain text> encrypt=no).

WarnUnlinkDisabled={yes, no} Default is no.

Yes/no option to disable 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.