INI Files Reference Guide for Cisco Virtualization Experience Client 6215 Firmware Release 8.6
Connect Options
Downloads: This chapterpdf (PDF - 349.0KB) The complete bookPDF (PDF - 582.0KB) | Feedback

Connect Options

Table Of Contents

Connect Options

Mozilla Firefox Connect Options

XenDesktop Connection Example

RDP Connect Options

VMware View Client Connect Options


Connect Options


This appendix provides the connect options that you can use for the supported connections.

It includes:

Mozilla Firefox Connect Options

XenDesktop Connection Example

RDP Connect Options

VMware View Client Connect Options


Tip You can use the Connect parameter in wlx.ini and $MAC.ini files.



Tip Options marked with an asterisk (*) in these tables are mandatory. Default values appear in bold.


Mozilla Firefox Connect Options

Table A-1 contains the supported options you can use for Mozilla Firefox connections.

Example:

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

Table A-1 Mozilla Firefox Connect Options 

Parameter
Description

AutoConnect={no, yes}

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

Description=string description

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

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

Icon=image file

Specifies an icon to appear on the local desktop or Connection Manager. The file must be located in the wlx/bitmap directory on the server. If no image file is specified, the default icon is displayed (except in the case of a published application). Supported file types are PNG, JPEG, and GIF, as well as XPM for backward compatibility.

Mode={kiosk, normal}

Launches Firefox in kiosk or normal mode. (In kiosk mode, Firefox appears full-screen on the desktop, and the user has no access to the address bar.)

Reconnect={no, yes}

Specifies whether to enable automatic reconnection to an application server after a disconnection.

ReconnectSeconds={seconds}

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

Resolution={640x480, 800x600, 1024x768, 1280x1024, 1600x1200, FullScreen}

Specifies the connection window size.

URL=URL

Specifies the starting URL.


XenDesktop Connection Example

To create XenDesktop server connections, use the Mozilla Firefox Connect options to specify the URL of the XenDesktop server to which users must connect. When the server URL is specified in the INI configuration, Firefox opens to this URL and the user can enter their credentials to initiate the connection to the HVD.

Example:

CONNECT=BROWSER \
Description="Windows Desktop" \
URL=http://xd.company.com \
Reconnect=yes \
ReconnectSeconds=5 \
AutoConnect=yes \
mode=kiosk


Caution In the above example, replace xd.company.com with the URL of your XenDesktop server.

With the optional Autoconnect=yes parameter specified in the preceding example, the browser connects to the specified URL when the client boots up. In addition, the optional Reconnect=yes and ReconnectSeconds=5 parameters specify to reconnect a disconnected connection after 5 seconds. Finally, the optional mode=kiosk parameter specifies to operate in kiosk mode, in which Firefox operates in full-screen mode with no access to the address bar.

RDP Connect Options

Table A-2 contains the supported options you can use for RDP connections.

Example:

CONNECT=RDP \
Host=10.150.123.35 \
Description="RDP_Server" \
AutoConnect=yes \
Colors=16m \
Username=Administrator \
Password=Password \
Domainname=$DN \
Resolution=800x600 \
Reconnect=no \
Drives=J=disk \
Drives=k=floppy \
Sound=off

Table A-2 RDP Connect Options 

Parameter
Description

AutoConnect={no, yes}

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

Colors={256, 64k, High, 16m}

Specifies the session color mode. For faster display performance, use 256 colors.

Default is 64k or High (these options are the same).

Command=start command

Lists a string of commands to be executed after logging in to the server. The maximum is 127 characters.

Description=string description

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


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

Directory=working directory

Specifies a directory to be used as the working directory after logging in to the server. The maximum is 63 characters.

DomainName={Windows domain name, $DN}

Specifies the domain name in a Windows network. $DN specifies to use the thin client sign-on domain name.

Drives=drive letter={floppy, cdrom, disk} [, basedir] drive letter=...

Maps drives on the server to USB mass storage devices that are attached to the thin client, where
drive letter=A to Z
floppy=USB floppy
cdrom=USB CDROM
disk=USB drive or memory
rw=read/write
ro=read only
basedir=an optional directory on the USB device to use.

Note Be sure each drive command is separated by a space.

Encryption=none

If you specify none, no encryption is used.

Note Use this option when connecting to a server with data encryption between the communication of the server and the client.

FullScreen={no, yes}

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

* Host=host[;host...]

Specifies a host or lists of host values. The thin client attempts to connect to the next server on the list if the current one fails. You must separate list items by semicolons or commas.

Note This option is mandatory.

Icon=image file

Specifies an icon to appear on the thin client desktop for this connection. The file must be located in the server wlx/bitmap directory. If no image file is specified, the default icon is displayed (except in the case of a published application). Supported file types are PNG, JPEG, and GIF, as well as XPM for backward compatibility.

LowBand={no, yes}

Specifies whether to enable optimization for low-speed connections, such as reducing audio quality and/or decreasing protocol-specific cache size.

LPTports=LPTx={LPTy, USBLPz}, LPTx=...

Maps parallel devices on the server to parallel devices on the thin client, where x=1 to 4; if LPTy, map to that parallel port on the thin client; if USBLPz, map to that USB parallel port.

Note Be sure each serial device command is separated by a comma and space.

Note Windows 2000 servers do not support LPT port mapping.

Password={password must be base-64 encoded, $SN, $MAC, $IP, $UN, $PW, $TN}

Specifies the password for login to the application server. You can specify either a conventional login password or a variable.

Variable and Description

password—Conventional login password
$SN—Serial number
$MAC—MAC address
$IP—IP address
$UN—Sign-on name
$PW—Sign-on password
$TN—Terminal name


Caution The application server password is not encrypted; not specifying it is strongly recommended. The user will be prompted to enter the password when the connection is made. This application server password directive never starts a line so it can be distinguished from the thin client user sign-on password, which starts a line.

ping={yes, no}

Specifies whether to enable ping. For nonpublished application connections, the thin client sends an ICMP ping to the host server before connecting to verify that the host is reachable.

Default is yes

Protocol={4, 5}

Access servers running RDP 4 or RDP 5. To access servers running RDP 4, set the protocol to 4.

Default is 5 (access servers running RDP 5)

Reconnect={yes, no}

Controls automatic reconnection to an application server after a disconnection.

Option Value and Action

yes—(default) Immediately restarts the connection 30 seconds after a disconnect. The default for a reconnection is 30 seconds.
no—Does not reconnect after a disconnect.

ReconnectSeconds={1...3600}

Specifies the interval to wait (in seconds, an integer, 1...3600) before automatically restarting the connection after a disconnection. Valid range is 1 to 3600.

Resolution={default, seamless, 640x480, 800x600, 1024x768, 1280x1024, 1600x1200}

Specifies the connection display resolution. The default value starts the connection using the current desktop display setting.

Sound={off, local, remote}

Specifies if and where to enable sound.

off—Disable sound
local—Enable sound to local machine (default)
remote—Enable sound to remote

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

Specifies the name to log in to the application server. You can specify either a conventional login name or a variable.

Variable and Description

username—Conventional login username
$SN—Serial number
$MAC—MAC address
$IP—IP address
$UN—Sign-on name
$PW—Sign-on password
$TN—Terminal name


VMware View Client Connect Options

Table A-3 contains the supported options you can use for VMware View Client connections.

Example:

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

Example:

CONNECT=VMWARE_VIEWCLIENT \
Description="VMview" \
Host=192.168.0.2 \
DomainName=$DN \
Username=Administrator \
Password=Password \
DesktopSize=800x600 \
Ping=yes

Table A-3 VMware View Client Connect Options 

Parameter
Description

AutoConnect={no, yes}

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

Description=string description

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


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

Desktop=string

Specifies the published desktop name.

Desktopsize={fullscreen, largewindow, smallwindow, <x>x<y>}

Specifies the desktop size. Valid values include fullscreen, largewindow, and smallwindow, or you can specify the exact size in the form XxY.

Domain=string

Specifies the domain name in a Windows network where the VMware server is located.

FullScreen={no, yes}

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

Default is no.

* Host=host[;host...]

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

Note This option is mandatory.

Interactive={yes, no}

Specifies whether to enable interactive connection mode.

Password={password must be base-64 encoded, $SN, $MAC, $IP, $UN, $PW, $TN}

Specifies the password to log in to the application server. You can specify either a conventional login password or a variable.

Variable and Description

password—Conventional login password
$SN—Serial number
$MAC—MAC address
$IP—IP address
$UN—Sign-on name
$PW—Sign-on password
$TN—Terminal name


Caution The application server password is not encrypted; not specifying it is strongly recommended. The user will be prompted to enter the password when the connection is made. This application server password directive never starts a line, so it can be distinguished from the thin client user sign-on password (which starts a line).

ping={yes, no}

Specifies whether to enable ping. For nonpublished application connections, the thin client sends an ICMP ping to the host server before connecting to verify that the host is reachable.

Default is yes.

Port=string

Specifies a port number other than the default. Default port is 80 or, if you enable UseSSL, the default port is 443.

Useallmonitors={no, yes}

Specifies whether to enable a session to display on all connected monitors. Default is no. Requires Fullscreen=yes.

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

Specifies the name for login to the application server. You can specify either a conventional login name or a variable.

Variable and Description

username—Conventional login name
$SN—Serial number
$MAC—MAC address
$IP—IP address
$UN—Sign-on name
$PW—Sign-on password
$TN—Terminal name

UseSSL={no, yes}

Specifies whether to enable a secure connection (HTTPS). Default is no.