INI Files Reference Guide for Cisco Virtualization Experience Client 6215 Firmware Release 9.0
Connect Parameter Options
Downloads: This chapterpdf (PDF - 1.15MB) The complete bookPDF (PDF - 2.22MB) | Feedback

Connect Parameter Options

Connect Parameter Options

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


Tip


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



Note


Mandatory options for a Connect parameter are marked as Mandatory Option in the option description.


Mozilla Firefox Connect options

The following table contains the supported options you can use for Mozilla Firefox connections. Default values are underlined.

Example:

CONNECT=BROWSER \
Description="Cisco Home Page" \
URL=http://www.cisco.com \
Resolution=FullScreen \
Mode=Normal
Table 1 Mozilla Firefox Connect Options
Option Description

AutoConnect={no, yes}

Default is no.

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

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}

Default is no.

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

ReconnectSeconds=<value in seconds>

Default is 30.

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

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

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

ICA Connect options with XenApp

The following table contains the supported options you can use for ICA connections with XenApp. Default values are underlined.


Note


The Cisco VXC 6215 supports the ICA Connect Options only with XenApp connections. The ICA Connect Options are not supported with XenDesktop connections. To configure a XenDesktop connection, you can use the Mozilla Firefox Connect INI parameters to specify the URL of the XenDesktop server to which users connect (see XenDesktop connection example).


Example:

CONNECT=ICA \
BrowserIP=10.150.123.30 \
Application="Desktop" \
Description="ICA_Desktop " \
AutoConnect=yes \
Reconnect=yes \
Encryption=128 \
Colors=16m \
Fullscreen=no \
Resolution=800x600 \
Username=$UN \
Password=$PW \
Domainname=$DN \
Alternate=yes \
LowBand=yes
Table 2 ICA Connect Options with XenApp
Option Description

Application=<published application>

Mandatory Option

Specifies the published application to launch.

AutoConnect={no, yes}

Default is no.

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

BrowserIP=<list of browsers>

Lists IP addresses or DNS registered names to specify ICA browsers. You must separate items on the list by semicolons or commas.

Colors={256, 64k, 16m}

Default is 64k.

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

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: & ' " $ ? ! | ; ( ) [ ] { } \

DomainName={<Windows domain name>, $DN}

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

Encryption={Basic, 40, 56, 128, Login-128, RC5, None}

Default is Basic.

Specifies the connection security level. The highest level is 128-bit security; the lowest level is Basic.

FullScreen={no, yes}

Default is no.

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

* Host=<host address>[;<host address>...]

Mandatory Option

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.

Important:

Mandatory if no application option is specified.

HttpBrowsing={0, 1, ssl}

Default is 1.

Designates the browsing protocol:

  • 0=udp
  • 1=http (default)
  • ssl=https

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}

Default is no.

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

NoReducer={no, yes}

Default is no.

Specifies whether to turn off compression.

Password={<base-64 encoded password>, $SN, $MAC, $IP, $DN, $UN, $PW, $TN}

Specifies the password required to log in to the application server. You can specify either a base-64 encoded login password or a variable.

password-Base-64 encoded login password

Variable and Description

$SN-Serial number

$MAC-MAC address

$IP-IP address

$DN-Sign-on domain name

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

Default is yes.

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.

Reconnect={no, yes, <value of 1 to 3600>}

Default is no.

Controls automatic reconnection to an application server after a disconnection.

Option Value and Action:

yes-Immediately restarts the connection 30 seconds after a disconnect. Default for reconnect is 30 seconds.

no-(default) Does not reconnect after a disconnect.

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

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

Default is default, which starts the connection using the current desktop display setting.

Specifies the connection display resolution. The default value starts the connection using the current desktop display setting. If the connection is to a published application, the seamless selection is available.

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

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

Variable and Description

username-Conventional log-in name

$SN-Serial number

$MAC-MAC address

$IP-IP address

$DN-Sign-on domain name

$UN-Sign-on name

$PW-Sign-on password

$TN-Terminal name

RDP Connect options

The following table contains the supported options you can use for RDP connections. Default values are underlined.

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 3 RDP Connect Options
Option Description
AutoConnect={no, yes} Default is no. Specifies whether to start a connection automatically after sign-on.
Colors={256, 64k, High, 16m} Default is 64K or High (these values are the same).

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

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

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

* Host=<host address>[;<host address>...] Mandatory Option

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.

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}

Default is no.

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.

NLA={false, true} Default is false.

Specifies whether to enable Network Level Authentication for the RDP session.

Password={<base-64 encoded password>, $SN, $MAC, $IP, $DN, $UN, $PW, $TN}

Specifies the password required to log in to the application server. You can specify either a base-64 encoded login password or a variable.

Variable and Description

password-Conventional login password

$SN-Serial number

$MAC-MAC address

$IP-IP address

$DN-Sign-on domain name

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

Default is yes.

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.

Protocol={4, 5}

Default is 5 (servers running RDP 5 are accessed).

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

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=<value of 1 to 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}

Default is default (starts the connection using the current desktop display setting). Specifies the connection display resolution.

Sound={off, local, remote}

Default is local.

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, $DN, $UN, $PW}

Specifies the name required 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

$DN-Sign-on domain name

$UN-Sign-on name

$PW-Sign-on password

$TN-Terminal name

VMware View Client Connect options

The following table contains the supported options you can use for VMware View Client connections. Default values are underlined.


Note


The Cisco VXC 6215 Firmware Release 9.0 supports VMware View Client 1.7, which requires you to enable SSL for all connections to a View Connection Server.


Example:

CONNECT=VMWARE_VIEWCLIENT \
Description="VMview" \
Host=192.168.0.2 \
DomainName=$DN \
AutoConnect=yes \
Fullscreen=yes \
Ping=yes \
UseSSL=yes \
Username=Administrator \
Password=cGFzc3dvcmQ 
or
Password=$MAC 
Table 4 VMware View Client Connect Options
Option Description

AutoConnect={no, yes}

Default is no.

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

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={useallmonitors, fullscreen, largewindow, largescreen, smallwindow, smallscreen, <X>x<Y>}

Default is smallwindow.

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

Useallmonitors specifies to enable a session to display on all connected monitors.

Largewindow is handled the same as largescreen.

Smallwindow is handled the same as smallscreen.

DisableConnectOnce={yes,no}

Default is no.

Enables or disables the listing of View desktops after session logout or when an error occurs.

DisableMenuBar={yes,no}

Default is no.

Disables or enables the Full Screen drop down menu bar.

Domain=<string>

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

FullScreen={no, yes}

Default is no.

Runs the session at full screen (not in a window). This parameter is used to make the View client connection dialog box (that displays all available View desktops) display at full screen.

FullScreenMode={no, yes,}

Default is no.

Enables or disables full screen mode. When enabled, this parameter disables the Desktopsize option.

* Host=<host address>[;<host address>...]

Mandatory Option.

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.

Interactive={yes, no}

Default is yes.

Specifies whether to enable interactive connection mode.

Password={<base-64 encoded password>, $SN, $MAC, $IP, $DN, $UN, $PW, $TN}

Specifies the password required to log in to the application server. You can specify either a base-64 encoded login password or a variable.

Variable and Description

password—base-64 encoded login password

$SN—Serial number

$MAC—MAC address

$IP—IP address

$DN—Sign-on domain name

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

Default is yes.

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.

Port=<string>

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

Reconnect={no, yes}, <value of 1 to 3600>

Default is no.

Controls automatic reconnection to an application server after a disconnection.

  • yes — Immediately restarts the connection 30 seconds after a disconnect. Default for reconnect is 30 seconds.
  • no — (default) Does not reconnect after a disconnect.
  • <value of 1 to 3600> — (integer) Specifies the interval to wait (in seconds) before automatically restarting the connection after a disconnection. Valid range is 1 to 3600.

SecureMode={neverconnect, warnbefore, donotverify}

This parameter determines how the client proceeds when it cannot verify that the connection to the server is secure.

  • neverconnect: Never connects to untrusted servers.
  • warnbefore: Warns before connecting to untrusted servers.
  • donotverify: Does not verify server identify certificates

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

Specifies the name required to 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

$DN—Sign-on domain name

$UN—Sign-on name

$PW—Sign-on password

$TN—Terminal name

UseSSL={no, yes}

Default is no.

Specifies whether to enable a secure connection (HTTPS).