INI Files Reference Guide for Cisco Virtualization Experience Client 2112/2212 ICA Firmware Release 8.0_215
WNOS INI, username INI, and $MAC INI parameters
Downloads: This chapterpdf (PDF - 1.44MB) The complete bookPDF (PDF - 2.48MB) | The complete bookePub (ePub - 210.0KB) | Feedback

WNOS INI, username INI, and $MAC INI parameters

WNOS INI, username INI, and $MAC INI parameters

This chapter provides the supported parameters that you can use in a wnos.ini file, a {username}.ini file, and a $MAC.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 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.


Caution


“User profile” parameters (found in the {username}.ini file) generally override the identically named “global” parameters (found in the wnos.ini file). However, some “global” parameters do not allow this—specifically, parameters in the following tables noted with an asterisk (*) do not allow this “user profile” override. Thus, if the parameters that are noted with * are used in both a {username}.ini file and in a wnos.ini file, the noted parameters in the wnos.ini file will override the same noted parameters in the {username}.ini file.

For example, if the parameter Resolution=1024x768 is used in the {username}.ini file and the same parameter Resolution=1280x1024 is used in the wnos.ini file, the Resolution=1280x1024 in the wnos.ini file will override the Resolution parameter in the {username}.ini file. Therefore, if you want the parameter Resolution=1024x768 in the {username}.ini file to be used, you must not use the Resolution parameter in the wnos.ini file.



Tip


Parameters in the following tables noted with two asterisks (**) that are used in a {username}.ini file or $MAC.ini file will return to the values set for those parameters in the wnos.ini file after a user sign-out.

For example, if your {username}.ini file contains the parameter MouseSwap=1 (so that the mouse buttons are swapped for your left-handed use) and you sign out of the zero client, then the MouseSwap value will return to the original default value of 0 (MouseSwap=0) contained in the wnos.ini file—so that others who sign in can use their own “user profile” (assuming the administrator has not changed the default values in the wnos.ini file).


General Settings (wnos.ini, username.ini, and $MAC.ini Files)

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

Table 1 General Settings: wnos.ini, {username}.ini, and $MAC.ini Files

Parameter

* Global overrides identically-named user profile

** After sign off, user profile returns to global value

Description

AdminMode={no, yes}

[admin-username=encrypted_username]

[admin-password=encrypted_password]

[Username=username]

[Password-password]

Default is no.

AdminMode-Yes/no option to use the username and the password to obtain a high privilege zero client configuration when the Privilege parameter level is set to high (Privilege=high).

admin-username-Specifies if admin-username=encrypted_username, then encrypted strings are used for admin-username.

admin-password-Specifies if admin-password=encrypted_password, then encrypted strings are used for admin-password.

Note   

Right-click on AdminMode to access the shortcut menu items

BootpDisable={no, yes}

Default is no.

BootpDisable - Yes/no option to disable BOOTP requests. WTOS supports both DHCP and BOOTP to obtain the network configurations. In the first two tries, only DHCP is requested. Then, both DHCP and BOOTP are requested. For some environments, BOOTP requests will delay obtaining the IP from the DHCP server. Set BootpDisable=yes will only perform a DHCP request. This setting is only valid after the next reboot.

CustomInfo={yes, no}

[Custom1=custom1_str]

[Custom2=custom2_str]

[Custom3=custom3_str]

[Location=location_str]

[Contact=contact_str]

Yes/no option to configure/store custom information. If CustomInfo=yes, the custom information configured by the following options will be stored into NVRAM. If CustomInfo=no, the custom information in NVRAM will be cleared.

For example:

CustomInfo=yes custom1=11 custom2=2 custom3=3 location=cisco contact=peter

**DeskColor="rrr ggg bbb"

Default is ”16 100 36”. Where DeskColor =”16 100 36” (green) is the default.

Specifies the desktop background color in RGB string format (must be enclosed in quotes), where rrr, ggg, and bbb are decimal numbers in the range of 0 to 255. When using this parameter in a wnos.ini file, it will be saved to NVRAM if EnableLocal is set to yes in the wnos.ini file.

Note   

The MirrorFileServer parameter also supports the DeskColor parameter.

**Desktop=bitmap file

[Layout={center, tile, stretch}]

[IconTextColor="rrr ggg bbb"]

Desktop-Specifies a bitmap file to be used as wallpaper for the local desktop. This file could be a 4-bit, 8-bit, or 24-bit BMP file or a standard GIF file or a standard JPEG file. The file must be located in the FTP server wnos\bitmap directory. Default is Cisco wallpaper. To disable the parameter, leave value blank (Desktop= ).

Layout-Default is stretch. Specifies the arrangement on the desktop background of the bitmap file specified by the Desktop parameter (if auto dial-up is set, Layout is invalid). For center, the image is placed in the center of the desktop without image size change. For tile, the image is replicated across the desktop. For stretch, the image is modified to fill the desktop.

Note   

In dual-monitor mode, the wallpaper is replicated and specified separately for each monitor (instead of being shared by the two monitors).

IconTextColor — Specifies the icon text color in RGB string format (must be enclosed in quotes), where rrr, ggg and bbb are decimal numbers in the range of 0 to 255.

Device=cmos [Action={extract, restore}]

CMOS management (extract and restore cmos settings).

Extract — For extract action, CMOS content is saved to the file:

$PF_cmos.$VER

($PF - Is the name of the platform: ZC0)

($VER - Is the version of the BIOS: 1.0B-0407)

WTOS log: "CMOS: extract to $PF_cmos.$VER"

Restore — For restore action, CMOS content is updated from the file: $PF_cmos.$VER

WTOS log: "CMOS: restore from $PF_cmos.$VER"

When using this feature, there should be a special INI user name such as "cmos". The associated ini/cmos.ini should include one line as "Device=cmos Action=extract" (NOTE: Do not include "Device=cmos Action=extract" in a global INI file such as wnos.ini, as it will take no effect if it is included in the global INI file).

After the administrator configures the CMOS on a template unit, the administrator should sign on to the "cmos" account on WTOS to have the CMOS content saved to the cmos file on a writable File Server wnos directory.

Then, the wnos.ini should be configured with "Device=CMOS action=restore", so that all target units will be updated with the same CMOS setting as the template unit after reboot.

Once the restore action is finished, both the "Device=cmos Action=extract" and "Device=CMOS action=restore" should be removed from the related INI files.

FactoryDefault={no, yes}

Default is no.

Yes/no option to reset the system settings to factory default (the option is only initialized once for each firmware change; however, you can set to no and then reboot so the option will be initialized again).

Caution   

If the FactoryDefault parameter value is changed to yes, the zero client will reboot without notice to the user.

*Include=path/filename For {username}.ini file only. Specifies to include another INI file at the position of this parameter. Only one level of including is allowed (no nesting) and only for a {username}.ini file

KeySequence={no, yes}

[Ctrl+Alt+Del={no, yes}]

[Ctrl+Alt+Up={no, yes}]

[Ctrl+Alt+Down={no, yes}]

[Ctrl+Alt+Left={no, yes} ]

[Ctrl+Alt+Right={no, yes}]

[Win+L={no,yes}]

KeySequence-Yes/no option to enable the following supported combined keys options.

KeySequence=yes enables all of these options, each having a default of yes or no as noted that you can change individually to the setting desired. KeySequence=no disables all of these options regardless of the individual settings.

Ctrl+Alt+Del-Default is no. Yes/no option to enable Ctrl+Alt+Del to lock the zero client if the user is signed in with a password (if the user is signed in without a password, this key sequence does not work).

Ctrl+Alt+Up-Default is yes. Yes/no option to enable Ctrl+Alt+Up to toggle a session between fullscreen and window mode.

Ctrl+Alt+Down-Default is yes. Yes/no option to enable Ctrl+Alt+Down to toggle between task selections.

Ctrl+Alt+Left-Default is yes. Yes/no option to enable Ctrl+Alt+Left Arrow to lock the zero client if the user is signed in with a password (if the user is signed in without a password, this key sequence does not work).

Ctrl+Alt+Right-Default is yes. Yes/no option to enable Ctrl+Alt+Right Arrow to lock the zero client if the user is signed in with a password (if the user is signed in without a password, this key sequence does not work).

[Win+L={no,yes}] — Default is no. Yes/no option to enable use of Win+L key to lock the client.

**Language=code

[Charset={ISO-8859-1, ISO-8859-2, ISO-8859-5, ISO-8859-7}]

[ImageSuffix={us, gb, b5, jp, ko, la, default]

Language-Specifies the language to use on the desktop display. After beingspecified in a wnos.ini file, it is saved in non-volatile memory. The code used must be exactly the same as the character string shown in the keyboard language list in Keyboard Language Codes.

Charset-Specifies which ISO option to use:

  • ISO-8859-1-(Default) Supports part 1 of the standard character encoding of the Latin alphabet.
  • ISO-8859-2-Supports the Czech, Hungarian, Polish, Romanian, and Slovenian languages on the desktop display.
  • ISO-8859-5-Supports Cyrillic characters on the desktop display.
  • ISO-8859-7-Supports the Greek language on the desktop display.

ImageSuffix — Localization builds have different suffixes according to the keyboard language as follows:

jp (Japanese)

gb (Simplified Chinese)

b5 (Traditional Chinese)

ko (Korean)

la (Spanish Mexican)

By default, with the above keyboard languages, the system will update the standard image according to the suffixes with the language code. With other keyboard languages, the system will update the standard image without the suffix specified.

For example, if you set Language=jp, the system will update the image named ZC0_wnos.jp which is the Japanese localization build.

If you set Language=us, the system will update the image named ZC0_wnos.

The option ImageSuffix can specify the suffix of the image name when you do not want the default behavior.

Locale={English | us | French | fr | German | de | Chinese Simplified | gb | Chinese Traditional | b5 | Japanese | jp | Korean | ko | Spanish Mexican | la}

[load={yes | no}]

Locale — Specifies the system language.

Note   

Locale changes the language for the user logon-experience screens only (displayed during boot-up and logon) and not the configuration or administrator screens.

load=yes/no specifies whether or not to load the language file. The language file must end with the locale name and be placed under the folder wnos/locale in the file server. For example, if you want to specify French and load the localized messages, you must place a file named French.msg under the folder wnos/locale in the file server, and then add Locale=French load=yes in the INI file.

Important:

For Chinese Simplified, Chinese Traditional, Japanese, and Korean localization, a font file must also be placed under the folder wnos/font in the file server. For example, if you want to specify the system language to be Japanese, you must place a file named Japanese.msg under the folder wnos/locale in the file server, place a file named Japanese.fnt under the folder wnos/font in the file server, and then add Locale=Japanese load=yes in the INI file.

The .msg and .fnt files are bundled with the firmware image on cisco.com.

LocaleList={English | us | French | fr | German | de | Chinese Simplified | gb | Chinese Traditional | b5 | Japanese | jp | Korean | ko | Spanish Mexican | la}

LocaleList — Specifies a list of locale, so that a user can switch the system language as needed. All the values will be display in the GUI (System Preference > General > Locale). Be sure to place the necessary files, for example German.msg, Japanese.msg, Japanese.fnt, and so on under the correct folders as described in the Locale parameter description.

**Password=sign-on password

[encrypt={no, yes}]

Specifies the password as the sign-on password.

In a wnos.ini file-If set to the default password, the system will sign on automatically and not wait for username, password, and domain entries.

In a [username].ini file-Be sure it is the encrypted password of the user or the system will fail to sign on. This can be changed by a user, if allowed, in the sign-in dialog box.

encrypt-Default is no. Yes/no option to use an encrypted string for a password in the INI file instead of clear text. If encrypt=yes, the password in the INI is an encrypted string instead of cleartext. For example:

Password=ciscoatc@123

or

Password=NCAONIBINMANMLCOLKCNLL \ encrypt=yes

**PRIVILEGE=[None, Low, High]

[LockDown= {no, yes}]

[HideSysInfo={no, yes}]

[HidePPP={no, yes}]

[HidePN={no, yes}]

[HideConnectionManager={no, yes}]

[EnableNetworkTest={no, yes}]

[EnableTrace={no, yes}]

[ShowDisplaySettings={no, yes}]

[EnableKeyboardMouseSettings={no, yes}]

[KeepDHCPRequestIP={no, yes}]

[SuppressTaskBar={no, yes, auto}]

[EnablePrinterSettings={no, yes}]

[CoreDump={ide, disabled]

[EnableNetworkSetup={yes, no}]

[DisableNetworkOptions={yes, no}]

[EnableSystemPreferences={yes,no}]

[DisableTerminalName={yes, no}]

[DisableSerial={yes, no}]

[DisableRotate={yes, no}]

Default is high.

Privilege controls operator privileges and access to zero client resources.

None-This level of access is typical for kiosk or other restricted-use deployment. The System Setup selection on the desktop menu is disabled (the Setup submenu cannot be displayed). The Connect Manager is disabled by default (the Connect Manager can be enabled (visible) by using the HideConnectionManager=no option, however, the user cannot create a new connection or edit an existing connection). The user cannot reset the zero client to factory defaults.

Low-This access level is assigned to a typical user. The Network selection on the Setup submenu is disabled (the Network Setup dialog box cannot be opened). The user cannot reset the zero client to factory defaults.

High-Administrator access level allows all zero client resources to be available with no restrictions. A user can reset to factory defaults.

Note   

If None or Low is used, the Network Setup dialog box is disabled. If it is necessary to access this dialog box and the setting None or Low is not saved into NVRAM, remove the network connector and reboot.

LockDown-Default is no. Yes/no option to allow lockdown of the zero client. If yes is specified, the system saves the privilege level in flash. If no is specified, the system clears the privilege level from flash to the default unlocked state.

Caution   

If the zero client is set to LockDown without a High privilege level, it will disable the G key reset on power-up.

Note   

LockDown can be used to set the default privilege of the zero client. For example, if LockDown=yes, then the privilege is saved in permanent registry; if LockDown=no, then the privilege level is set to the default high in the permanent registry. That is, the system has a default high privilege level, which is stored in the permanent registry; if you do not specify a privilege in either the wnos.ini file or the {username}.ini file or the network is unavailable, the setting of LockDown will take effect. It can be modified by a clause. For example, privilege=<none|low|high> lockdown=yes in a wnos.ini file or a {username}.ini file sets the default privilege to the specified level.

HideSysInfo-Default is no. Yes/no option to hide the System Information from view.

HidePPP-Default is no. Yes/no option to hide the Dialup Manager, PPPoE Manager, and PPTP Manager from view.

HidePN-Default is no. Yes/no option to hide the PNAgent or PNLite icon from view on the taskbar.

(continued)

**PRIVILEGE=[None, Low, High]

[LockDown= {no, yes}]

[HideSysInfo={no, yes}]

[HidePPP={no, yes}]

[HidePN={no, yes}]

[HideConnectionManager={no, yes}]

[EnableNetworkTest={no, yes}]

[EnableTrace={no, yes}]

[ShowDisplaySettings={no, yes}]

[EnableKeyboardMouseSettings={no, yes}]

[KeepDHCPRequestIP={no, yes}]

[SuppressTaskBar={no, yes, auto}]

[EnablePrinterSettings={no, yes}]

[CoreDump={ide, disabled]

[EnableNetworkSetup={yes, no}]

[DisableNetworkOptions={yes, no}]

[EnableSystemPreferences={yes,no}]

[DisableTerminalName={yes, no}]

[DisableSerial={yes, no}]

[DisableRotate={yes, no}]

HideConnectionManager-Default is no. Yes/no option to hide the Connect Manager window from view.

Note   

As stated earlier, although the Connect Manager is disabled by default if Privilege=none, the Connect Manager can be enabled (visible) by using HideConnectionManager=no (however, the user cannot create a new connection or edit an existing connection).

EnableNetworkTest-Default is no. Yes/no option to enable the Network Test.

EnableTrace-Default is no. Yes/no option to enable trace functionality (active items are added to the desktop right-click menu in Privilege=High level).

ShowDisplaySettings-Default is no. Yes/no option to enable the Display Settings in a popup menu.

EnableKeyboardMouseSettings-Yes/no option to enable the keyboard and mouse configuration preferences.

KeepDHCPREquest-Default is no. Yes/no option to keep the same IP address that is requested from the DHCP server after a request fails and does not invoke the Network Setup dialog box.

SuppressTaskBar-Default is no.Yes/no/auto option to hide the taskbar (auto will automatically hide/display the taskbar as used). When using this parameter in a wnos.ini file, it will be saved to NVRAM if EnableLocal is set to yes in the wnos.ini file.

EnablePrinterSettings — Default is no.Yes/no option to enable printer configurations when a user Privilege=None.

CoreDump — The option "CoreDump=disabled" will disable the core dump function.

EnableNetworkSetup — to enable and disable the network setup.

DisableNetworkOptions — to enable and disable the network options.

EnableSystemPreferences — to enable and disable the system preferences.

DisableTerminalName — to enable and disable the terminal name.

DisableSerial — to enable and disable the serial table in peripherals.

(continued)

**PRIVILEGE=[None, Low, High]

[DisableRotate={yes, no}]

DisableRotate — If the optional DisableRotate=yes is set, the rotate setting in the display setup will be disabled. This is only valid for C class clients because the rotation performance in C class may not be desirable.

Note   

If the optional EnableNetworkSetup=yes is set with Privilege={none, low}, the network setup will be enabled.

If the optional DisableNetworkOptions=yes is set at the same time, the Options table will be disabled.

If the optional EnableSystemPreferences=yes is set with Privilege={none, low}, the system preferences setup will be enabled.

If the optional DisableTerminalName=yes is set at the same time, the terminal name field will be disabled.

If the optional DisableSerial=yes is set with Privilege={none, low}, the serial table in peripherals setup will be enabled.

**ScreenSaver={0, 1, 5, 10, 15, 30, 60, 120, 180}

[LockTerminal={0, 1, 2}]

[Type={0,1, 2}]

[Image=imagefile]

Screensaver-Specifies to put the zero client in a screensaver state when the inactivity (delay before starting) time limit is reached. Value and delay before starting the screensaver:

  • 0—Disabled
  • 1—1 Minute
  • 5—5 Minutes
  • 10—10 Minutes
  • 15—15 Minutes (Default)
  • 30—30 Minutes
  • 60—1 Hour
  • 120—2 Hours
  • 180—3 Hours

LockTerminal-Specifies the zero client LOCK state function when the screen saver is activated.

  • 0-Disabled (Default)
  • 1-Puts the zero client in a LOCK state when the screen saver is activated. The user is prompted with an unlock dialog box to enter the sign-in password to unlock the zero client. LockTerminal settings are saved into NVRAM if LockTerminal=1 and EnableLocal=yes is set in the wnos.ini file.
  • 2-Puts the zero client in a LOCK state when the screen saver is activated, however, the unlock dialog box cannot be viewed and the desktop will use Blank the Screen as the screensaver.
Note   

The user must be signed in with a password for a Lock action to take effect.

Note   

If set in KeySequence, users can lock the zero client at any time by pressing Ctrl+Alt+Left Arrow or Ctrl+Alt+Right Arrow.

Type-Specifies which type of screensaver to use.

  • 0-Blank the Screen
  • 1-Flying Bubbles
  • 2-Moving Image

Image-Specifies an image file residing in the subfolder bitmap (under the home folder) to use as a screensaver Moving Image.

Note   

If Type=2 and no image file is specified, then the default Cisco logo image is used.

Shutdown={standby, turnoff}

Default is standby.

Specifies the system state when shutting down the unit. If set to standby, the WTOS system is suspended. When the unit boots up, it is resumed. It does not go to the BIOS and thus boots up quickly. If set to turnoff, the system is turned off. When the unit boots up, it first starts the BIOS then WTOS.

**ShutdownCount={0 to 60} (seconds)

or

**ShutdownCounter={0 to 60} (seconds)

ShutdownCount or ShutdownCounter-Specifies the number of seconds to count down before the shutdown sequence starts upon using the zero client power button when there are active sessions (default is 10, however, to commence shutdown immediately and prevent the display of the countdown pop-up dialog box, set the value to 0).
ShutdownInfo={no, yes} Yes/no option to display various information (such as System Version, Terminal Name, IP Address, and MAC Address) in shutdown window.

TimeServer=server_list

[TimeFormat={“24-hour format”, “12-hour format”}]

[DateFormat={yyyy/mm/dd, mm/dd/yyyy, dd/mm/yyyy}]

[GetBiosDT={no, yes}]

TimeServer-Specifies the SNTP time servers to use for time retrieval. If a time server is not defined, the client CMOS/BIOS internal clock will be used as a reference.

TimeFormat-Default is “24-hour format”. Specifies the time format to use.

DateFormat-Default is yyyy/mm/dd. Specifies the date format to use.

Note   

The TimeFormat and DateFormat settings in a wnos.ini file will be saved into NVRAM if EnableLocal=yes is set in the wnos.ini file.

GetBiosDT-Default is no.Yes/no option to obtain time from BIOS/CMOS when the timeserver is not available or cannot be contacted.

Example:

TimeServer=time.nist.gov

TimeFormat=”24-hour format”

DateFormat=mm/dd/yyyy

or

TimeServer=time.nist.com \

TimeFormat=”24-hour format” \

DateFormat=mm/dd/yyyy

WakeOnLAN={yes, no}

Default is yes.

Wake-on-LAN allows a thin client to be turned on or woken up by a network message.

If WakeOnLAN=yes, the WTOS will respond for the Wake-On-LAN packet for remote a wake up.

If WakeOnLAN=no, the WTOS will not respond for the Wake-On-LAN packet.

Note    To use the WakeOnLAN parameter, the Cisco VXC must use BIOS version 1.0B-0407 or later.

Keyboard Language Codes

The following table describes the keyboard language codes supported with the Language=code parameter.

Table 2 Keyboard Language Codes
Arabic (Algeria) — Ar_alg Arabic (Bahrain) — Ar_bah
Arabic (Egypt) — Ar_egy Arabic (Iraq) — Ar_ira
Arabic (Jordan) — Ar_jor Arabic (Kuwait) — Ar_kuw
Arabic (Lebanon) — Ar_leb Arabic (Libya) — Ar_lib
Arabic (Morocco) — Ar_mor Arabic (Oman) — Ar_oma
Arabic (Qatar) — Ar_qat Arabic (Saudi Arabia) — Ar_sau
Arabic (Syria) — Ar_syr Arabic (Tunisia) — Ar_tun
Arabic (U.A.E.) — Ar_uae Arabic (Yemen) — Ar_yem
Brazilian — Br Canadian Multilingual — ca_ml
Chinese (Simplified) — Gb Chinese (Traditional) — b5
Croatian — Croat Czech — Cz
Danish — Dk Dutch — Nl
Dutch (Belgian) — Nl_be Dutch (Belgian Comma) — Nl_be_c
English (3270 Australian) — au3270 English (Australian) — Au
English (New Zealand) — Nz English (United Kingdom) — Uk
English (United States) (default) — Us Finnish — Fi
French (Belgian) — fr_be French (Belgian Comma) — fr_be_c
French (Canadian) — fr_ca French (France) — Fr
French (Swiss) — fr_sf German — De
German (IBM) — de_ibm German (Swiss) — de_sg
Greek — el Hungarian — Hu
Italian — It Italian (Swiss) — it142
Japanese — Jp 1 Japanese_109a — Jp_109a
Korean — Ko Korean (MS-IME2002) — ko_ime
Norwegian — No Polish (214) — Pl
Polish Programmers — pl_prog Portuguese — Pt
Portuguese (Brazil) — Pt2 Romanian — Ro
Russian — Ru 2 Slovakian — Slovak
Slovakian (Qwerty) — sk_q Slovenian — Sloven
Spanish — Es Spanish (Mexican) English — La(us)
Spanish (Mexican) Localized — La Swedish — Se
Turkish — Turk Turkish (QWERTY) — turk_q
U.S. International — us_int
1 Japanese refers to Japanese Input system (MS-IME2000), not JP.
2 The Russian keyboard is only supported for server input; it is not supported for local input.

Peripheral Settings (wnos.ini, username.ini, and $MAC.ini Files)

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



Table 3 Peripheral Settings: wnos.ini, {username}.ini, and $MAC.ini Files

Parameter

* Global overrides identically-named user profile

** After sign off, user profile returns to global value

Description
**DefaultPrinter={LPD1, LPD2, LPD3, LPD4, COM1, COM2, LPT1, LPT2, SMB1, SMB2, SMB3, SMB4} Specifies the default printer. Be sure the printer set as default is enabled or the setting will be invalid.

Device=audio

volume={low, middle, high} or {0 to 25}

mute={0, 1, 2, 3}

[mic_vol={high, middle, low} or {0-25}]

[mic_mute={0, 1}]

[min_cache={1-50}]

Specifies the local zero client audio volume.

volume=

high — maximum volume

middle — medium volume (default)

low — minimum volume

Values of 0-25 provide more exact volume level.

mute=

0 — no mute (default)

1 — mutes audio

2 — mutes audio and system beep

3 — mutes system beep [Introduced in build 7.0.1_13]

mic_vol=

high — maximum volume

middle — medium volume (default)

low — minimum volume

Values of 0-25 provide more exact volume level.

mute=

0 — no mute (default)

1 — mutes audio

min_cache={1 - 50}", "min_cache" is for configuring WTOS audio playback minimum buffering amount (in ten millisecond units). "min_cache" can be used when network bandwidth is not large enough to play audio smoothly. In such cases, set "min_cache" higher, so that WTOS will buffer more audio data before playing the audio.

The "min_cache" is 1 by default.

1 – WTOS will buffer at least 10ms of audio data when playing audio.

...

50 – WTOS will buffer at least 500ms (0.5s) of audio data when playing audio.

Device=camera

[format=raw]

[width={camera supported width}]

[height={camera supported height}]

[fps={camera supported fps}]

[optimize={no, yes}]

Specifies the local zero client camera settings.

format — Support only for raw video type (format=raw is fixed).

width — The width of the resolution that the local camera supports.

height — The height of the resolution that the local camera supports.

fps — The fps (frame per second) of the resolution that the local camera supports.

optimize — Yes no option to optimize the width, height, and fps at 320 x 240 at 10 fps That is, if optimize=yes, then 320 x 240 at 10 fps will be used for the local camera settings regardless of the individual settings in width, height, and fps (as long as the camera supports the 320 x 240 at 10 fps).

If optimize=yes and the camera does not support the 320 x 240 at 10 fps settings, an error will be present in the Event Log of WTOS.

If optimize=no (Default), then the individual settings in width, height, and fps will be used (as long as the camera supports them).

**Device=keyboard

[numlockoff={no, yes}]

[repeatrate={0, 1, 2}]

[repeatdelay={0, 1, 2, 3, 4, 5, 6, 7}]

Device-Specifies the local keyboard.

numlockoff-Default is no.Yes/no option to turn off the NumLock of the keyboard.

repeatrate-Specifies the keyboard repeat rate.

  • 0-Slow
  • 1-Medium (Default)
  • 2-Fast

repeatdelay-Specifies the keyboard delay before repeat (in seconds).

  • 0-1/5
  • 1-1/4
  • 2-1/3 (Default)
  • 3-1/2
  • 4-3/4
  • 5-1
  • 6-2
  • 7-No Repeat
Note   

These settings in a wnos.ini file will be saved into NVRAM if EnableLocal=yes is set in the wnos.ini file.

Device=UsbSerial Start=COMx

Specifies the first COM port number that can be used by USB-serial port.

For example, the first USB-Serial port on a zero client is COM2 by default, but it can be changed to COM3 (Device=UsbSerial Start=COM3) with the INI file.

**DisableMouse={no, yes}

or

MouseDisable={no, yes}

DisableMouse-Default is no. Yes/no option to disabled mouse pointer so that it is shown on the screen. The pointer is enabled if any mouse activity occurs.

or

MouseDisable-Default is no. Yes/no option to disabled mouse pointer so that it is shown on the screen. The pointer is enabled if any mouse activity occurs.

MicBoost={no, yes}

Default is no.

Yes/no option to enable on-board microphone boost. Default = no.

**MouseNewSpeed={1-9}

Default is 6.

Value specifies the mouse speed within a range of 1 through 9, where 1 is slowest and 9 is fastest. This parameter is the replacement of MouseSpeed from release 7.0.

**MouseSwap={0, 1}

0/1 option to swap the mouse buttons (for example, for left-handed use).

  • 0-No
  • 1-Yes

NetworkPrinter=host/queue

[PrinterID=Window driver name]

[Enabled={no, yes}]

NetworkPrinter-Specifies the configuration for the network (LPD) printer in the same way as described for the Printer Setup dialog box in the Administration Guide for Cisco Virtualization Experience Client 2112/2212. The host and queue parameters define the IP address and queue name of the printer.

PrinterID-Specifies the Windows printer driver name.

Note   

The maximum length for the PrinterID value is 31 characters. To specify a driver name that is longer than 31 characters, see Printer Drivers Longer Than 31 Characters.

Enabled-Default is yes. Yes/no option to enable the network (LPD) printer.

Printer={COM1, COM2, LPT1, LPT2}

[Name=<name>]

[PrinterID=window_driver]

[Class=classname]

[Enabled={no, yes}]

[EnableLPD={no, yes}]

Default is COM1.

Printer-Specifies the local printer to configure.

Name-This option must be used. Specifies the name of the printer.

PrinterID-If not specified, the default Generic/Text Only is used.

Note   

The maximum length for the PrinterID value is 31 characters. To specify a driver name that is longer than 31 characters, see Printer Drivers Longer Than 31 Characters.

Class-Used in ThinPrint print for TPAutoconnect (the ThinPrint technology of mapping the printer from the client side). It can group printers to use the same template on the ThinPrint server side. The strings PCL5, PS, and TXT are pre-defined classes. Class can be a string with 7 characters.

Enabled-Default is yes. Yes/no option to enable the printer.

EnableLPD-Default is no. Yes/no option to enable the LPD service.

Note   

The parameters must be specified in the order shown.

Printer={LPD1, LPD2, LPD3, LPD4}

[LocalName=name]

[Host= host]

[Queue=queue]

[PrinterID=window_driver]

[Class=classname]

[Enabled={no, yes}]

Default is LPD1.

Printer-Specifies the LPD printer to configure.

LocalName-Specifies the name of the printer. If LocalName is not specified, the Queue name is used.

Host-Specifies the host name of the printer.

Queue-Specifies the queue name of the printer.

PrinterID-Specifies the windows driver to use for the printer. If not specified, the default Generic/Text Only is used.

Note   

The maximum length for the PrinterID value is 31 characters. To specify a driver name that is longer than 31 characters, see Printer Drivers Longer Than 31 Characters.

Class-Used in ThinPrint print for TPAutoconnect (the ThinPrint technology of mapping the printer from the client side). It can group printers to use the same template on the ThinPrint server side. The strings PCL5, PS, and TXT are pre-defined classes. Class can be a string with 7 characters.

Enabled-Default is yes.Yes/no option to enable the printer.

These settings in a wnos.ini file will be saved into NVRAM if EnableLocal=yes is set in the wnos.ini file.

Note   

The parameters must be specified in the order shown. LPD is accepted as LPD1.

Printer={SMB1, SMB2, SMB3, SMB4}

[LocalName=name]

[Host=\[domain]\host]

[Name=share_name]

[PrinterID=window_driver]

[Class=classname]

[Enabled={no, yes}]

[EnableLPD={no, yes}]

[Username=username]

[Password=password]

[Domain=domain name]

Default is SMB1.

Printer-Specifies the shared Microsoft network printer to configure. The Cisco VXC 2112/2212 supports up to four SMB printers.

LocalName-Specifies the name of the shared printer.

Host-Specifies the host name of the shared printer specified as \domain\host when the host is configured within a Microsoft domain (otherwise, host can be specified as \\host).

Name-Specifies the shared name of the shared printer.

PrinterID-Specifies the windows driver to use for the printer. If not specified, the default Generic/Text Only is used.

Note   

The maximum length for the PrinterID value is 31 characters. To specify a driver name that is longer than 31 characters, see Printer Drivers Longer Than 31 Characters.

Class-Used in ThinPrint print for TPAutoconnect (the ThinPrint technology of mapping the printer from the client side). It can group printers to use the same template on the ThinPrint server side. The strings PCL5, PS, and TXT are pre-defined classes. Class can be a string with 7 characters.

Enabled-Default is yes. Yes/no option to enable the printer.

EnableLPD-Default is no. Yes/no option to enable the LPD printer.

Username-Specifies the username of a user who can use the SMB printer.

Password-Specifies the password of a user who can use the SMB printer.

Domain-Specifies the domain name of the SMB printer.

**RepeatDelay={0, 1, 2, 3, 4, 5, 6, 7}

Specifies the keyboard delay before repeat (in seconds).

  • 0-1/5
  • 1-1/4
  • 2-1/3 (Default)
  • 3-1/2
  • 4-3/4
  • 5-1
  • 6-2
  • 7-No Repeat
**RepeatRate={0, 1, 2}

Specifies the keyboard repeat rate.

  • 0-Slow
  • 1-Medium (Default)
  • 2-Fast
*Resolution=[DDC, 640X480, 800X600, 1024X768, 1152X864, 1280X720, 1280X768, 1280X1024, 1360X768, 1366X768, 1368X768, 1400X1050, 1440X900, 1600X900, 1600X1200, 1680X1050, 1920X1080, 1920X1200]]

[Refresh=60, 75, 85}

Default is DDC.

Resolution-Specifies the local display resolution. Option DDC can be specified to select default display resolution.

Important:

When using a Y Cable, DDC will properly work on both monitors by default.

Refresh-Specifies the local display refresh rate.

Caution   

If the Resolution or Refresh parameter values are changed, the zero client will reboot without notice to the user.

Important:

The Screen parameter must be placed before the Resolution parameter; for example:

screen=1 resolution=1280x1024 refresh=60

Screen={1,2}

Default is 1.

Screen — Specifies the monitor for the Resolution parameter. You can configure each monitor with its own resolution; the specific monitor is set with the Screen= option.

Important:

The Screen parameter must be placed before the Resolution parameter; for example:

screen=1 resolution=1280x1024 refresh=60

Printer Drivers Longer Than 31 Characters

When you define a printer driver name in your INI file using the PrinterID option, the maximum allowable length for the driver name is 31 characters.

To specify a driver name that is longer than 31 characters, you must create a separate file named printer.map, in which you can associate a shorter printer ID value with the longer driver name. To reference the printer.map file, you must also include the following statement in the INI file:

PrinterMap=printer.map

The following examples show the required configurations.

printer.map file

Using a text editor, specify a shorter printer ID value for the driver name that contains more than 31 characters, for example:

HPU5.2="HP Universal Printing pcl 5 (v5.2)"
  |      |
  |      |________ The printer driver name that you have installed on your server.
  |
  |________  The printer driver ID that you use in your wnos.ini file.	

Note


If required, you can define more than one printer entry, for example:

HPU5.2="HP Universal Printing pcl 5 (v5.2)"
HPLJIII="HP LaserJet III PostScript Cartridge v52.2"

Save the file as printer.map, and place it in the ~\wnos folder.

wnos.ini file

In the wnos.ini file:

  • Include the PrinterMap=printer.map statement.
  • In the printer parameters, enter the shorter printer ID value for the PrinterId option.

For example:

			PrinterMap=printer.map # references the printer.map file for PrinterID definitions

			Printer=SMB1 \
			LocalName=SMB_Name1 \
			Host=test_name \
			Name=PC_Steve \
			PrinterID=HPU5.2 \ # references the printer ID defined in the printer.map file
			Class=PCL5 \
			Enabled=yes \
			EnableLPD=no \
			Username=test \
			Password=test.password \
			Domain=mydomain.com

Save the wnos.ini file in the ~\wnos folder.

With the correctly defined printer.map and wnos.ini files, the Cisco VXC 2112/2212 uses the longer driver name as defined in the printer.map file. You can use the shorter printer ID value defined in the printer.map file with any of the following parameters:

  • Printer={SMB1, SMB2, SMB3, SMB4}
  • Printer={LPD1, LPD2, LPD3, LPD4}
  • Printer={COM1, COM2, LPT1, LPT2}
  • NetworkPrinter=host/queue

Connection Settings (wnos.ini, username.ini, and $MAC.ini Files)

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

Table 4 Connection Settings: wnos.ini, {username}.ini, and $MAC.ini Files

Parameter

* Global overrides identically-named user profile

** After sign off, user profile returns to global value

Description
**AltCacheDisable={no, yes}

Default is no.

Yes/no option to disable the new cache mechanism allowing more memory to be available to a user (developed with Citrix Presentation Server 4.0 and Windows Server). If set to no, the new cache mechanism is enabled.

**Alternate={no, yes}

Default is no.

Yes/no option to use an alternate IP address returned from an ICA master browser to get through firewalls. This setting in a wnos.ini file will be saved into NVRAM if EnableLocal=yes is set in the wnos.ini file.

AutoDetectNetwork={yes, no}

RDP Only

Default is yes.

Yes/no option to enable RDP auto detect network feature.

**AutoSignoff={no, yes}

[Shutdown={no, yes}]

[Reboot={no, yes}]

Default is no.

AutoSignoff-Yes/no option to automatically sign-out a user when the last opened session is closed.

Shutdown-Default is no. Yes/no option to shut down the zero client. If shutdown is set to yes, the ShutdownCounter value is used to control the countdown before the system is shut off.

Reboot-Default is no. Yes/no option to reboot the zero client. If Reboot is set to yes, the ShutdownCounter value is used to control the count down before the system is rebooted.

ClearLicense={no, yes} Default is no.

Yes/no option to clear the TSCAL license stored in the non-volatile memory. It can be replaced by FixLicense=clean.

Connect={ICA, RDP}

Important:

If you are using an INI file to configure your clients, you must use this Connect parameter.

Connect — Connection protocol. Follow the ICA option list (see ICA Connect Options) or RDP option list (see RDP Connect Options). Any options you use for your connection must be on the same logical line (\ can be used for line continuation - See Rules and Recommendations for WTOS INI Files).

ConnectionBroker={default, Microsoft, VMware}

Default is default.

Specifies the Connection Broker type. Select VMware to enable VDM XML support. If you enter VMware, the VMware logo appears on the log-in screen.

Caution   

DO NOT use VDM as this value is being deprecated.

*Device=Ethernet

[Speed={Auto, 10M HD, 10M FD, 100M HD, 100M FD, 1000M}

[MTU=mtu]

[KeepAlive={5-600}]

[Warning={no, yes}]

Device-Specifies to use an ethernet.

Speed-Default is auto. Specifies the ethernet speed to either Auto, 10M HD, 10M FD, 100M HD, 100M FD, or 1000M. If Speed is set in a wnos.ini file, the Speed statement in the {username}.ini file will be disabled.

Note   

Device and Speed parameters can be replaced by the EthernetSpeed parameter.

KeepAlive-Specifies a time value (in seconds between 5 and 600) to keep an idle connection alive.

Warning-Default is no.Yes/no option to warn about an idle connection. In the seconds of the specified KeepAlive, if the tcp connection is idle and Warning=yes, one log will be printed for the session. For example:

device=ethernet keepalive=20 warning=yes

MTU-A maximum transmission unit value between 500 and 1500.

Caution   

If the Speed parameter value is changed, the zero client will require a reboot.

Device=vusb

[ForceRedirect=DeviceID]

[ForceLocal=DeviceID]

[Type={HDX}]

[InterfaceRedirect={no, yes}]

Device—Specifies the ID of a local USB device that is not redirected by default.

ForceRedirect—Specifies a forced redirect of the local USB device to the server. This parameter has priority over ForceLocal.

ForceLocal—Specifies that the local USB device should not be redirected to the server.

The DeviceID can be found in the event log. For example, if you find HDX USB: Local Device(0x04f2,0x0112,0x03,0x01,0x01)”,set the parameter as:

Device=vusb ForceRedirect=0x04f2,0x0112,0x03,0x01,0x01

Type—(Citrix Environments Only). In Citrix environments, allows you to force the usage of HDX for USB virtualization.

For example: Device=vusb Type=HDX

InterfaceRedirect — Default is no. Yes/no option to enable part of a composite device to run locally and part of the device to run on a remote session.

**EnableLocal={no, yes}

[HideDefault={no, yes}]

Default is no.

Yes/no option to enable locally configured entries to show in the Connect Manager list. When connections defined in local NV-RAM are displayed in the Connect Manager, they are marked with an asterisk. If EnableLocal=yes is in a wnos.ini file, then the global information will be saved into NVRAM. The global information includes: SEAMLESS, ALTERNATE, Reconnect, IcaBrowsing, LowBand, NoReducer, Time settings, and Printer settings in a wnos.ini file.

HideDefault-Default is no Yes/no option to hide the default ICA and RDP connections that are present on the devices.

*EthernetSpeed={Auto, 10M HD, 10M FD, 100M HD, 100M FD, 1000M}

Default is auto.

EthernetSpeed-Specifies the EthernetSpeed to either Auto, 10M HD, 10M FD, 100M HD, 100M FD, or 1000M. After being specified, it is saved in the non-volatile memory. This parameter can be replaced by the Device and Speed parameters.

Caution   

If the EthernetSpeed parameter value is changed, the zero client will require a reboot.

FastDisconnet={no, yes}

Default is no.

Yes/no option to use F12 key press to disconnect an ICA session.

FastDisconnectKey={F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, Pause\Break} Specifies the disconnect key that will disconnect an ICA session.
FixLicense={Factory, clean, yes, no, OldFormat}

Default is no.

Specifies the option to replace the TSCAL license stored in the non-volatile memory.

Note   

The OldFormat value specifies to keep the same license format as version 5.2.x of the TSCAL license.

HideIP={no, yes}

Default is no.

Yes/no option to hide the information of the connection host or IP.

Some examples include:

  • When moving a mouse cursor over the connection icons on the desktop, a balloon help pop-up displays '…' instead of the host name.
  • When a Reconnect to a connection message or an ICA error message window displays, the connection description displays instead of host name.
  • When moving a mouse cursor over the PN icon, the connected PN servers do not display.
**icaBrowsing={udp, http}

Default is udp.

Establishes the default browsing protocol. This setting can be overridden by the parameter HttpBrowsing in each connection property. The method of browsing selected must match the method provided by the servers being accessed. This setting in a wmos.ini file will be saved into NVRAM if EnableLocal=yes is set in the wnos.ini file.

IEEE8021X={yes, no}

network={wired}

[eap={yes,no}]

[eaptype={None, EAP-LEAP, EAP-TLS, EAP-PEAP}]

[leapun={username for EAP-LEAP}]

[leappwd={password for EAP-LEAP}]

[leappwdEnc={password encrypted for EAP-LEAP}]

[tlsauthtype={user, machine}]

[tlsclntcert={client certificate filename for EAP-TLS}]

[tlsclntprikey={filename of certificate with private key for EAP-TLS}]

[tlsclntprikeypwd={password for private key}]

[tlsclntprikeypwdEnc={password encrypted for private key}]

[peapeap={EAP-MSCHAPV2, EAP-GTC}]

[peapidentity={identity/username for PEAP}]

[peapmschapun={username for EAP-PEAP/EAP-MSCHAPV2}]

[peapmschappwd={password for EAP-PEAP/EAP-MSCHAPV2}]

[peapmschappwdEnc={password encrypted for EAP-PEAP/ EAP-MSCHAPV2}]

[peapmschapdm={domain for EAP-PEAP/ EAP-MSCHAPV2}]

[peapmschaphidedm={yes,no}]

[peapsinglesignon={yes, no}]

[peapgtcun={username for EAP-PEAP/ EAP-GTC}]

[peapgtcpwd={password for EAP-PEAP/ EAP-GTC}]

[peapgtcpwdEnc={password for encrypted for EAP-PEAP/EAP-GTC}]

Yes/no option to use IEEE8021X.

Important:

The usernames of IEEE8021X (peapmschapun, peapgtcun, leapun) can be configured as system variables such as $MAC, $SN, etc.

General rules:

1 - If IEEE8021X is set to no, then all parameters following it will be ignored.

2 - If network is not configured, the configuration will be ignored.

3 - The key left of equal is case sensitive, and the value right of equal is not case sensitive except for credential information (for example, username, password, or certificate filename).

4 - All EAP credential information is stored whatever the eaptype setting.

5 - Underlined values are default.

6 - Encrypted passwords will overwrite unencrypted passwords. Thus, if both an encrypted password and an unencrypted password are configured, then the encrypted password will overwrite the unencrypted password.

Examples:

IEEE8021X=yes network=wired eap=yes eaptype=eap-tls tlsclntcert=user.cer tlsclntprikey=user.pfx tlsclntprikeypwd=12345678

IEEE8021X=yes network=wired eap=yes eaptype=eap-tls tlsclntcert=user.cer tlsclntprikey=user.pfx tlsclntprikeypwd=12345678 leapun=user1 leappwd=1234 peapmschapun=user1 peapmschappwd=12345 peapmschapdm=cisco.com

**Inactive={0, 10 to 480} (minutes)

[NoSessionTimer=0-480]

Default is 0.

Specifies that if there is no keyboard or mouse use in the configured time (minutes), it will sign off or shutdown or reboot (depending on AutoSignoff=…)

If NoSessionTimer is set, then when there is an active sessions, use this timer to replace the Inactive value.

The following controls whether to reboot or shutdown or sign off.

AutoSignoff=yes [Shutdown=yes] [Reboot=yes]

IPProto=ICMP

[DisableTStamp={yes, no}]

[DisableEcho={yes, no}]

Configures the ICMP protocol.

DisableTStamp-If DisableTStamp=yes, the system will not reflect the ICMP timestamp (13) request.

DisableEcho - If DisableEcho=yes, the system will not reflect the ICMP echo (8) request. In this case, the unit cannot be pinged.

**LowBand={no, yes}

Default is no.

Yes/no option to enable optimization for low speed connections (on all connections), such as reducing audio quality or decreasing protocol-specific cache size. This setting in a wnos.ini file will be saved into NVRAM if EnableLocal=yes is set in the wnos.ini file.
LpdSpool={0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10} Specifies the size of spool to buffer all data before sending it to the LPD printer.

**NoReducer={no, yes}

Default is no (which enables compression).

Yes/no option to turn off compression. To turn off compression, enter yes.

Used here this parameter is a global statement for all connections. It sets the default value of NoReducer.

Note   

By default both the ICA and RDP protocols compress their data to minimize the amount of data that needs to traverse the network. This compression can be as much as 50% for text-based applications (for example, Microsoft Word) and 40% less for graphics applications than the uncompressed data streams.

OneSignServer=onesign_server

[DisableBeep={no, yes}

[KioskMode={no, yes}]

[EnableFUS={no, yes}]

[TapToLock={0, 1, 2}]

Specifies a list of host names or IP addresses with optional TCP port number or URLs of Imprivata OneSign servers. An HTTPS protocol must be used.

Note   

The OneSign Server parameter is for use with the Imprivata OneSign Server, which Cisco does not support. For user authentication on the Cisco VXC 2111/2211, Cisco supports only Gemalto .NET Smart cards. For detailed information, see http:/​/​www.cisco.com/​en/​US/​docs/​solutions/​Enterprise/​Data_Center/​VXI/​ VXI_​GemaltoNET.pdf.

The WTOS firmware supports additional smart cards, but Cisco does not provide support for these smart card solutions. For additional information about smart cards, contact your smart card vendor.

OneSign virtual desktop access offers care providers a seamless authentication experience and can be combined with single sign-on for no click access to desktops and applications in a virtual desktop environment.

The following inputs are acceptable values:

https://ip

or

https://FQDN

DisableBeep - Default is no. Yes/no option to set the Rfideas reader to mute when a card is tapped.

KisokMode - Default is no. Yes/no option to allow the OneSign user to share the client desktop.

EnableFUS - Default is no. Yes/no option to set the Citrix client to remain running when users are switched.

TaptoLock - Default is 2. Only active when KioskMode=yes. Specifies tap to lock.

If TapToLock=0, then tap a card to lock terminal is disabled.

If TapToLock=1 (Tap to lock), then use the proximity card to lock the terminal.

If TapToLock=2 (Tap over), then lock the terminal and log in a different user.

PnliteServer=<List of {IP address, DNS names, or URLs}>

[ReconnectAtLogon={0, 1, 2}]

[ReconnectFromButton={0, 1, 2}]

[AutoConnectList={*/ appname1;appname2; appname3...}]

[timeout=5…300]

[CAGRSAAuthMethod={LDAP, RSA}]

[CAGAuthMethod={LDAP, RSA}]

[CAGAuthMethod={LDAP+RSA, RSA+LDAP}]

[RequestIconDataCount={0-65535}]

[DefaultSettings={XenApp, XenDesktop}]

[SmartcardPassthrough={yes, no}]

[StoreFront={no, yes}]

PnliteServer-Specifies the list of IP addresses or host names with optional TCP port number or URLs of PNAgent/PNLite servers (by default the list is empty).

Each entry with optional port is specified as Name-or-IP:port, where :port is optional; if not specified, port 80 is used as the default. If a port other than 80 is used, the port number must be specified explicitly with the server location in the form IP:port or name:port. After being specified, it is saved in the non-volatile memory.

The statement PNAgentServer and Web interface for Citrix MetaFrame Server is equal to this statement.

Note   

PnliteServer and the DomainList parameters can be used in a {username}.ini file, but generally are used only in a wnos.ini file.

Note   

The PNAgent/PNLite server list and associated domain list optionally can be entered in DHCP server options 181 and 182, respectively. If entered in both places, the entries from this table will take precedence. However, the {username}.ini file will override the wnos.ini file if the identical parameters with different values exist in the {username}.ini file.

Note   

When Multifarm=yes, use # to separate failover servers, and use a comma (,) or a semicolon (;) to separate servers that belong to different farms.

ReconnectAtLogon-Specifies the reconnection function at sign-in.

  • 0-disables the option (Default)
  • 1-reconnects to disconnected sessions only
  • 2-reconnects to active and disconnected sessions

ReconnectFromButton-Specifies the reconnection function from the reconnect command button.

  • 0-disables the option (Default)
  • 1-reconnects to disconnected sessions only
  • 2-reconnects to active and disconnected sessions

AutoConnectList-Specifies the PNA applications that will be automatically launched when using PNA to sign-in. If AutoConnectList=*, then all the PNA applications will be automatically connected. The autoconnectlist is the connection description or application/host name which can use the wildcard * to match the string.

Timeout-Specifies the time (in seconds) a client will try to establish a connection before reporting that it is unreachable.

(continued)

PnliteServer=<List of {IP address, DNS names, or URLs}>

[ReconnectAtLogon={0, 1, 2}]

[ReconnectFromButton={0, 1, 2}]

[AutoConnectList={*/ appname1;appname2; appname3...}]

[timeout=5…300]

[CAGRSAAuthMethod={LDAP, RSA}]

[CAGAuthMethod={LDAP, RSA}]

[CAGAuthMethod={LDAP+RSA, RSA+LDAP}]

[RequestIconDataCount={0-65535}]

[DefaultSettings={XenApp, XenDesktop}]

[SmartcardPassthrough={yes, no}]

[StoreFront={no, yes}]

CAGRSAAuthMethod or CAGAuthMethod — CAGAuthMethod option is used for CAG authentication configuration.

Note   

This option replaces CAGRSAAuthMethod. If CAGAuthMethod=RSA (it is same as the prior "CAGRSAAuthMethod=RSASecurid"), an extra passcode field needs to be input except username/password/domain. If CAGAuthMethod=LDAP, no passcode field is needed.

CAGAuthMethod={LDAP+RSA, RSA+LDAP} - Used for CAG authentication configuration.

If CAGAuthMethod=LDAP+RSA, an extra passcode field needs to be input except username/password/domain. If the CAG server is configured for a double authentication policy, this INI setting corresponds to: First authentication LDAP and Second authentication RSA.

If CAGAuthMethod=RSA+LDAP, it has the same result as with CAGAuthMethod=RSA. (Compare to LDAP+RSA.) If the CAG server is configured for a double authentication policy, this INI setting corresponds to: First authentication RSA and Second authentication LDAP.

RequestIconDataCount — RequestIconDataCount is used for requesting 32-bit color icons. It is a counter which means that only the count of the icons will be requested. The default number is 10. For example, if set RequestIconDataCount=0, no icon data will be requested. If set RequestIconDataCount=5, only 5 icons are requested.

DefaultSettings - specifies the default settings for XenApp or XenDesktop.

Xen App Default Settings:

  1. SignOn=Yes
  2. PnliteServer= RequestIconDataCount=20
  3. desktopcolordepth=32
  4. LongApplicationName=yes
  5. sessionconfig=ica progressivedisplay=yes ondesktop=yes
  6. device=audio volume=high
  7. Seamless=yes FullscreenReserved=yes
  8. sessionconfig=all mapdisks=yes
  9. Enabled by default: Disks, Serials, Sound
  10. Disabled by default: USB, Printers, Smart Cards

(continued)

PnliteServer=<List of {IP address, DNS names, or URLs}>

[ReconnectAtLogon={0, 1, 2}]

[ReconnectFromButton={0, 1, 2}]

[AutoConnectList={*/ appname1;appname2; appname3...}]

[timeout=5…300]

[CAGRSAAuthMethod={LDAP, RSA}]

[CAGAuthMethod={LDAP, RSA}]

[CAGAuthMethod={LDAP+RSA, RSA+LDAP}]

[RequestIconDataCount={0-65535}]

[DefaultSettings={XenApp, XenDesktop}]

[SmartcardPassthrough={yes, no}]

[StoreFront={no, yes}]

Xen Desktop Default Settings:

  1. SignOn=Yes
  2. sysmode=vdi toolbarclick=yes toolbardelay=3
  3. sessionconfig=ica progressivedisplay=yes
  4. PnliteServer=
  5. AutoSignoff=yes
  6. Enable by default: Printers, Serials, USB, Sound
  7. Disabled by default: Disk, Smart Cards

SmartcardPassthrough — Default is yes. Yes/no option to enable/disable the smartcard passthrough mode.

StoreFront - Default is no. Yes/no option to support Citrix StoreFront Authentication. The value will be saved into NVRAM.

RTPTosDscp={Default/CS1

/CS2/CS3/CS4/CS5/CS6/CS7/AF

11/AF12/AF13/AF22/AF23/AF31

/AF32/AF33/AF42/AF43}

Sets RTP/UDP audio channel in the TOS fields.

SaveSysinfo={usb}

Specifies that the WTOS event logs will be saved into the last mounted USB disk.

The file used for saving Event log information is named WTOS_log.txt and is located at the root path of the USB disk.

**Seamless={no, yes}

[HideTaskbar={0, 1, 2, 3}]

[FullscreenReserved={no, yes}]

Default is no.

Seamless-Yes/no option to set the default resolution for ICA published applications to Seamless for ICA connection parameters.

HideTaskbar-Default is 0.Specifies the status of the taskbar when maximizing the seamless window.

0-Do not hide the taskbar

1-Taskbar will be hidden when maximizing the seamless window to full screen. Moving the mouse over the lowest bottom of the screen will display the taskbar. This setting (not including the FullscreenReserved parameter) in a wnos.ini file will be saved into NVRAM if EnableLocal=yes is set in the wnos.ini file.

When set Seamless=yes HideTaskbar=2, it removes the auto-hide taskbar function but it reports the full resolution to the ICA server in a similar way to HideTaskbar=1.

When set Seamless=yes HideTaskbar=3, the maximized size does not cover the taskbar, but the session size on the server side is reported as the full-screen size.

When set Seamless=yes FullscreenReserved and the applications are configured for fullscreen mode, they will be launched in fullscreen mode, not seamless mode.

SelectGroup={no, yes} description=group1

[groupname=name1] [description=group2

[groupname=name2]

Default is no.

SelectGroup — Yes/no option to allow a user to select from a group list on the Log on dialog box during a logon. If yes, the description will display in the group list box.

groupname — The groupname is used to identify the group including the directory and file name. If it is not defined, the description will become the groupname.

For example,

SelectGroup=yes \

description="Dev team" groupname=dev \

description="Sus team" \

description="SQA team" groupname=sqa \

description="guest"

Group 1: Description="Dev team" groupname=dev

The file \wnos\ini\dev\dev.ini must be created in the file server. In the dev.ini, the broker, domain list, or connections can be defined for the dev team.

Group 2: .Description="Sus team" The file \wnos\ini\Sus team\Sus team.ini must be created in the file server. In the Sus team.ini, the broker, broker list, or connections can be defined for the Sus team.

Group3...4...n...and so on.

After a user selects a group, the system will load the group ini file first, and then load the \wnos\ini\{group_name}\username.ini.

If the username.ini in the group directory is not found, it will attempt to load \wnos\ini\username.ini as before.

Because the group list may define different brokers, the SelectServerList statement will be invalid if set SelectGroup=yes.

**SessionConfig=ALL

[unmapprinters={no, yes}]

[unmapserials={no, yes}]

[smartcards={no, yes}]

[mapdisks={no, yes}]

[disablesound={no, yes}]

[unmapusb={no, yes}]

[DisksReadOnly={no, yes}]

[MouseQueueTimer={0-99}]

[UnmapClipboard={no, yes}]

[DefaultColor={0,1,2}]

[VUSB_DISKS={yes, no}]

[VUSB_AUDIO={yes, no}]

[VUSB_VIDEO={yes, no}]

[VUSB_PRINTER={yes, no}]

[FullScreen={no, yes}]

[Resolution={default, vga_resolution}]

[DisableResetVM={no, yes}]

[FontSmoothing={yes, no}]

[AutoConnect={yes, no}]

[MultiMonitor={yes,no}]

SessionConfig-Specifies the default settings of the optional connection parameters for all sessions.

unmapprinters-Default is no. Yes/no option to un-map printers.

unmapserials-Default is no. Yes/no option to un-map serials.

smartcards-Default is no. Yes/no option to use smartcards.

mapdisks-Default is no. Yes/no option to map disks.

disablesound-Default is no. Yes/no option to disable sound.

unmapusb-Default is no. Yes/no option to un-map USBs.

DisksReadOnly-Default is no. Yes/no option to mount mass storage disks as read-only.

MouseQueueTimer-Specifies the default queue timer of a mouse event in an ICA or RDP session (in 1/100 of a second). It can be used to adjust the bandwidth of a network.

UnmapClipboard-Yes/no option to disable clipboard redirection for all sessions. For ICA and RDP, specifies if redirecting the clipboard. This setting in wnos.ini will be saved into nvram if EnableLocal is set to yes in wnos.ini.

DefaultColor — Specifies the default color depth to use for the session 0=256, 1=High color, 2=True Color.

VUSB_DISKS, VUSB_AUDIO, VUSB_VIDEO, and VUSB_PRINTER — Default is no. Specifies if these USB devices will be redirected to the server using ICA/RDP USB redirection when USB redirection is enabled. By default, these devices are set as local devices.

For example, if you want to use USB disks as a network disk, you can set "SessionConfig=all mapdisks=yes VUSB_DISKS=no" if you want to use USB disks as server side device (display in device manager of a session), you can set "SessionConfig=all mapdisks=no VUSB_DISKS=yes".

FullScreen — Default is no. Specifies the default screen mode.

Resolution — Default is default. Specifies the session resolution. For example, 640 x 480 and so on (refer to supported resolutions).

DisableResetVM — Default is no. Set "DisableResetVM=yes" to disable "Reset VM" function. As default, this function is controlled by the server side is enabled including VMware View or Citrix PNA

FontSmoothing — Default is yes. Set no to disable font smoothing.

AutoConnect — Default is yes. Set no to disable auto connect function.

MultiMonitor — Default is yes. Sets a multiple monitor layout. Set MultiMonitor=no to disable multiple monitor layout function. The session has the same desktop width and height with local virtual desktop size, spanning across multiple monitors, if necessary.

**SessionConfig=ICA

[desktopmode={fullscreen, window}]

[mapdisksunderz] IMPORTANT: Do not use as this parameter option is being deprecated.

[TosIpPrecedence={0-5}]

[TosDscp={Default/CS1

/CS2/CS3/CS4/CS5/CS6/CS7/AF

11/AF12/AF13/AF22/AF23/AF31

/AF32/AF33/AF42/AF43}]

[DiskMapTo=a character sequence]

[OutBufCount=count]

[SysMenu={remote, local}]

[SessionReliability={no, yes}]

[ondesktop={no, yes, all, none, desktops, applications}]

[ProgressiveDisplay={no, yes}]

[BranchRepeater] IMPORTANT: Do not use as this parameter option is being deprecated.

[DisableIcaPing={no,yes}]

[AudioQuality={default, high, medium, low}]

[USBRedirection={ICA|HDX}]

[CGPParseMessageLen={yes, no}]

[ZLKeyboardMode={0, 1, 2}]

[ZLMouseMode={0, 1, 2}]

SessionConfig-Specifies the ICA default settings of the optional connection parameters for all ICA sessions.

desktopmode-Default is fullscreen. Specifies the display mode of an ICA published desktop when using an ICA PNAgent sign-in (the default is fullscreen mode for a PNA desktop application).

mapdisksunderz IMPORTANT: Do not use as this parameter option is being deprecated.

TosIpPrecedence — Allows you to set IP Precedence in the TOS fields.

TosDscp — Sets IP DSCP in the TOS fields.

Note   

mapdisksunderz=yes takes effect only if mapdisks=yes.

DiskMapTo-Specifies to map disks to a character sequence.

Note   

A sequence of characters can be used by DiskMapTo, with each letter mapped to one disk in order. For example, if RTNM is the sequence, R is mapped to the first disk (in WTOS, it will be D:/), T is mapped to the second disk (in WTOS, it will be E:/), and so on. Only the letters "a" through "y" and "A" through "Y" are accepted (all lowercase letters are changed to uppercase; other characters will be skipped; and duplicate characters will be omitted). For example, #GGefZzedAF1JaE will be mapped to GEFDAJ. The number of disks mapped to the session depends on the number of valid letters provided. If no letter is provided, all disks will be mapped to the session using default driver letters.

OutBufCount-Specifies the output buffer count of the ICA server and client (the default value is 0x2c).

SysMenu-Default is local. Specifies the system menu mode when right-clicking the taskbar button of a seamless window. If it is remote, the system menu will come from the remote server; otherwise, it will be the local menu.

SessionReliability-Default is no.Yes/no option to enable session reliability.

(continued)

**SessionConfig=ICA

[desktopmode={fullscreen, window}]

[mapdisksunderz] IMPORTANT: Do not use as this parameter option is being deprecated.

[TosIpPrecedence={0-5}]

[TosDscp={Default/CS1

/CS2/CS3/CS4/CS5/CS6/CS7/AF

11/AF12/AF13/AF22/AF23/AF31

/AF32/AF33/AF42/AF43}]

[DiskMapTo=a character sequence]

[OutBufCount=count]

[SysMenu={remote, local}]

[SessionReliability={no, yes}]

[ondesktop={no, yes, all, none, desktops, applications}]

[ProgressiveDisplay={no, yes}]

[BranchRepeater] IMPORTANT: Do not use as this parameter option is being deprecated.

[DisableIcaPing={no,yes}]

[AudioQuality={default, high, medium, low}]

[USBRedirection={ICA|HDX}]

[CGPParseMessageLen={yes, no}]

ZLKeyboardMode={0, 1, 2}]

[ZLMouseMode={0, 1, 2}]

ondesktop-Default is noSpecifies options for displaying connection icons on the desktop:

  • If AutoConnectList is set in the PNLiteServer statement, all connections configured in AutoConnectList parameter will display on the desktop.
  • Default is no and means that the property of ondesktop will be controlled by the server. However, the connections are still always added to the Connect Manager list and PNA menu list
  • In cases other than no, the connection is controlled by the local zero client. If set so that the connection icon does not display on the desktop, the connection icon will also not be added to the Connect Manager list nor the PNA menu list.

all — same as yes, display all connections on desktop

none — do not display any connections

desktops — only display connections on desktop

applications — only display applications, the connections will be handled as an ondesktop_list. For example, if you set ondesktop="word; excel", then only the applications "word" and "excel" will be displayed.

ProgressiveDisplay-Default is no. Yes/no option to enable Progressive Display support in ICA.

BranchRepeater-IMPORTANT: Do not use as this parameter option is being deprecated.

DisableIcaPing-Default is no. Yes/no option to disable ping.

AudioQuality-Default is default. Specifies the audio quality of ICA sessions.

Note   

Medium quality is recommended for Speech scenarios. For example: SessionConfig=ICA AudioQuality=high

USBRedirection — Default is ICA|HDX. Option to select the channel of usb devices redirection. This option is recommended to replace the older setting "device=vusb type={HDX}".

CGPParseMessageLen — Default is yes. Yes/no option to have the CGP parse the incoming stream before receiving the full package. By default CGP will parse the stream.

ZLKeyboardMode — Specifies to accelerate the display of the input text on the client device over a high latency connection. 0=off, 1=on, 2=auto

ZLMouseMode — Specifies to accelerate the visual feedback for mouse-clicks on the client device over a high latency connection. 0=off, 1=on, 2=auto

**SessionConfig=RDP

[MaxBmpCache={128 to 1024}]

[DefaultColor={0,1,2}]

[EnableNLA]={no,yes}]

[ForceSpan={no, yes}]

[EnableTSMM={yes, no}]

[EnableRecord={yes, no}]

[USBRedirection={TCX, RDP}]

[EnableUDP={yes,no}]

[RDPScreenAlign4={yes,no}]

[WallPaper={yes, no}]

[Dragging={yes, no}]

[Animation={yes, no}]

[Theme={yes, no}]

[TosIpPrecedence={0-5}]

[TosDscp={Default/CS1/CS2/CS3/CS4/CS5/

CS6/CS7/AF11/AF12/AF13/AF22/AF23/

AF31/AF32/AF33/AF42/AF43}]

[AutoDetectNetwork={yes, no}]

SessionConfig — Specifies the RDP default settings of the optional connection parameters for all RDP sessions.

MaxBmpCache — Specifies the maximum bitmap cache number (this impacts the memory usage of an RDP session).

DefaultColor — Specifies auto (0), 16-bit (1), and 32-bit (2) options.

EnableNLA — Default is yes. Yes/no option to utilize the Network Level Authentication feature in RDP 7

ForceSpan — Default is no. Yes/no option to disable RDP Multi Monitor feature.

EnableTSMM — Default is yes. Yes/no option to enable RDP7 Multi-media redirect.

EnableRecord — Default is yes. Yes/no option to enable RDP feature of recording from local.

USBRedirection — Default is TCX. Option to select the channel of usb devices redirection.

Important:

Cisco VXC 2112/2212 does not support TCX.

EnableUDP — Default is yes. Yes/no option to enable RDP8 UDP traffic channel.

RDPScreenAlign4 — Default is no. RDPScreenAlign4=yes can force RDP session width to 4 pixels aligned.

For example:

SessionConfig=RDP MaxBmpCache=1024 DefaultColor=1 EnableNLA=yes ForceSpan=yes EnableTSMM=no EnableRecord=yes EnableRFX=no RDPScreenAlign4=no

The options "WallPaper", "Dragging", "Animation" and "Theme" can set the RDP experience. Default is yes.

TosIpPrecedence — Allows you to set IP Precedence in the TOS fields.

TosDscp — Sets IP DSCP in the TOS fields.

AutoDetectNetwork — Default is yes. Yes/no option to enable an RDP session to adapt its data transfer to the bandwidth of the network.

TcpMaxRetransmission={2~12}

Configures the retransmission of a TCP connection. The default value of this option is 5.

TSGWDomainName=[domain]

Specifies the TS Gateway Domain for RDP session.

TSGWENABLE={no, yes}

Default is no.

Yes/no option to enable TS gateway.

TSGWNAME=[hostname]

Specifies the TS Gateway host address.

TSGWPassword=[password]

Specifies the TS Gateway Password for the RDP session.

TSGWPassword-enc=[encrypted-password]

Specifies the encrypted TS Gateway Password for RDP session.

TSGWSERVER=[hostname]

Specifies the TS Gateway host address.

TSGWUsername=[username]

Specifies the TS Gateway Username for RDP session.

TSGWUsername-enc=[encrypted-username]

Specifies the encrypted TS Gateway Username for RDP session.

TSGWUSESAMEINFO={no, yes}

Default is no.

Yes/no option to apply RDP connection credential to Gateway credential.

**UniSession={no, yes} Yes/no option to launch the connection only once at a time.
VDIBroker=vdi_broker_url [AutoConnectList={*|host1;host2;host3…}]

VDIBroker-Specifies the VDI broker server (supports both http and https). If the vdi_broker_url does not start with http or https, the default protocol used is http. For an https connection, only one URL is accepted.

Caution   

If the VDIBroker parameter value is changed, the zero client will reboot without notice to the user so it can reconnect to the new server.

AutoConnectList-Specifies the VDI/VDM host which will be automatically launched when using VDI/VDM sign-in. If the value is *, all of the VDI/VDM hosts will automatically be connected. The autoconnectlist is the connection description which can use the wildcard * to match the string.

VirtualCenter=virtual_center_url Specifies the Virtual Center server (supports both http and https). If the virtual_center_url does not start with http or https, the default protocol used is http.
Caution   

If a VirtualCenter in an INI file is different from the original URL, the zero client will reboot for the new URL to take effect.

Note   

Only this setting can enable the Virtual Center functions.

**VNCPrompt={no, yes}

[{Accept, Reject}={10 to 600} (seconds)]

[ViewOnly={no, yes}]

[ActiveVisible={no, yes}]

Default is yes.

VNCPrompt-Yes/no option to enable a VNC shadowing prompt to a user (VNCPrompt set to yes means the user will always be prompted before shadowing starts and the user will then decline or accept VNC shadowing; VNCPrompt set to no means the user will not be able to decline or accept shadowing).

See also MaxVNCD to enable VNC shadowing and VNCPassword to specify a password for shadowing in Connection Settings for wnos.ini files only.

Accept, Reject-Default is 10. Specifies the amount of time (in seconds) a user has to accept or reject the VNC shadowing prompt before the client desktop is shadowed.

ViewOnly-Default is no. Yes/no option to specify that the desktop being shadowed can only be viewed by the person who is shadowing (no keyboard or mouse events are allowed to interfere with the zero client being shadowed).

ActiveVisible-Default is no. Yes/no option to display a VNC session-end notice after the VNC session ends.