 Feedback
|
Table Of Contents
Parameters for WLX INI, $MAC INI, and {username} INI Files
General Settings (wlx.ini, $MAC.ini, and {username}.ini Files)
Peripheral Settings (wlx.ini, $MAC.ini, and {username}.ini Files)
Connection Settings (wlx.ini, $MAC.ini, and {username}.ini Files)
Parameters for WLX INI, $MAC INI, and {username} INI Files
This chapter provides the supported parameters that you can use in a wlx.ini file, a $MAC.ini file, and a {username}.ini file.
Tip
For information to help you construct and use the supported INI files, see Getting Started: Learning INI File Basics.
To increase usability, the supported parameters are separated into the following categories:
•
•
•
General Settings (wlx.ini, $MAC.ini, and {username}.ini Files)
Table 3-1 contains the parameters that you can use for configuring general settings.
Peripheral Settings (wlx.ini, $MAC.ini, and {username}.ini Files)
Table 3-2 contains the parameters that you can use to configure peripheral settings (such as keyboard, monitor, mouse, and printer).
Table 3-2 Peripheral Settings: wlx.ini files, $MAC.ini files, and {username}.ini files
DeskColor=<color> [{solid | horizontal-gradient | verticalgradient}<color>]
Specifies the desktop background color where <color> can be one of the following values:
•
•
•
For example: Deskcolor=DarkGoldenrod horizontal-gradient LightGoldenrod
The first <color> is the primary color and is used if no shading is specified or if the shading is solid.
The second color is the secondary color. When shading is specified, the primary color appears on the left (horizontal) or top (vertical) edge with a smooth transition to the secondary color on the opposite edge.Desktop=image file
[Layout={Center, Tile, Stretch, Scale, None}
Opacity={0-100}]Desktop—Specifies an image file to use as wallpaper for the local desktop. The file must be located in the wlx/bitmap directory on the server. The image file can be any type that is supported by SUSE/GNOME for use as wallpaper (such as PNG, JPG, and GIF). The filename is case sensitive. The default is no wallpaper.
Layout—Specifies the arrangement on the desktop background of the specified image file. The tile value replicates the image across the desktop; the stretch value adjusts the image to fill the screen; the scale value enlarges the image to fill either the screen width or height.
Opacity—Specifies the amount of transparency. Default is 100. At less than 100, the image is blended with the colors specified by the DeskColor option as though the image is not entirely opaque. A value of 0 indicates total transparency, and the image is not displayed at all.
For Example:
Desktop=ciscologo.gif Layout=Tile Opacity=25DesktopColorDepth={8, 16, 24}
Specifies the number of colors of the desktop in bits. 8 is 256 colors; 16 is High Color; and 24 is True Color.
DisplaySettings=MON1 <resolution> [; MON2 <resolution> <position>]
Defines the display settings for single and multimonitor display, clone and span mode.
Possible values for:
resolution={{x}X{y}, DDC}
position={mirror, on-left, on-right, on-above, on-below}Note
mirror—Clone mode
on-left—Span on left side
on-right—Span on right side
on-above—Span on top
on-below—Span on bottomExamples:
DisplaySettings=MON1 rotate-normal 1024x768@75 MON2 rotate-normal 1024x768@75 on-below
DisplaySettings=MON1 rotate-normal 1280x1024
DisplaySettings=MON1 1280x1024
DisplaySettings=MON1 1280x768
DisplaySettings=MON1 960x540
DisplaySettings=MON1 1024x768 rotate-right
DisplaySettings=MON1 1024x768 rotate-normal MON2 1024x768 rotate-right on-right
DisplaySettings=MON1 1024x768 rotate-normal MON2 1024x768 rotate-right on-left
DisplaySettings=MON1 1024x768 rotate-normal MON2 1024x768 rotate-left on-left
DisplaySettings=MON1 1024x768 rotate-normal MON2 1024x768 rotate-normal on-left
DisplaySettings=MON1 800x600@60 rotate-normal MON2 800x600 rotate-left on-left
DisplaySettings=MON1 800x600@75 rotate-normal
DisplaySettings=MON1 800x600@75 rotate-normal MON2 800x600@75 rotate-normal on-above
DisplaySettings=MON1 1280x1024 rotate-normal MON2 1280x1024 rotate-normal mirror
DisplaySettings=MON1 1280x1024 rotate-normal MON2 1280x1024 rotate-normal on-right
DisplaySettings=MON1 720x400 rotate-rightEnableNumLock={no, yes}
Specifies whether to enable the default state of the numeric keypad. If set to yes, the numeric keypad is activated, if set to no (default), the numeric keypad becomes the cursor control pad.
JetDirectPrinter={options}
The JetDirectPrinter command line defines a printer served by an HP JetDirect print server. For parameter options that are used in the command line, see JetDirectPrinter in "Printer Parameters: Options".
Keyboard.layouts={Keyboard layout value}
The Keyboard.layouts parameter specifies the keyboard layout. For a list of supported keyboard layout values, see "Keyboard.layouts Parameter Values".
Example:
Keyboard.layouts=us (for United States)
Keyboard.layouts=ru (for Russia)MouseLocate={no, yes}
Specifies whether to briefly display an animated graphic showing the location of the mouse pointer when pressing and releasing the Ctrl key (with no other keys pressed).
MouseSendsControlV={no, yes}
For ICA only.
Allows the administrator to control the mouse button action in a UNIX environment.
The values are:
yes—In a UNIX environment, a middle mouse performs the same Paste function as the Ctrl+V keystroke combination in Windows.
no—(default) Disables "enable middle button paste" when used in the wlx.ini file with ICA v.10.
MouseSpeed={0-100}
Specifies the speed when moving the mouse.
Note
You can use the following values for backward compatibility.
Value and Mouse Speed
0—Slow (0.2)
1—Medium (default) (2.0)
2—Fast (6.0)MouseSwap={no, yes}
Specifies whether to swap the button order on the mouse. The default value is no.
NetworkPrinter={options}
Defines a printer that uses traditional UNIX Line Printer Daemon protocols. For parameter options that are used in the command line, see NetworkPrinter in "Printer Parameters: Options"
Printer={options}
Defines a locally attached printer that is connected through the noted interface. For parameter options that are used in the command line, see Printer in "Printer Parameters: Options".
PrinterURI={options}
Defines a printer using a URI supported by the Common UNIX Printing System (CUPS). This command is useful when you want the thin client to access a printer for which you already have a working CUPS client because you can simply copy the URI from the /cups/printers.conf file on the existing client. For parameter options that are used in the command line, see PrinterURI in "Printer Parameters: Options".
RepeatDelay=value
Expresses, in milliseconds (100-10000), the delay before a repeat key press is recognized. Enter a value greater than 100. The default value is 660 milliseconds.
For backward compatibility, you can also use the following values:
0—1/4 second
1—1/4 second
2—1/2 second (default)
3—1/2 second
4—3/4 second
5—3/4 second
6—1 second
7—1 secondRepeatRate=value
Expresses the number of allowable repeat key presses per second. Enter a value between 3 and 255 or a designated rate, as follows:
Value and Keyboard Repeat Rate
0—Slow (GUI value is 10)
1—Medium (default) (no GUI value)
2—Fast (GUI value is 110)SMBPrinter={options}
Defines a network printer shared through the Windows Server Message Block protocols. For parameter options that are used in the command line, see SMBPrinter in "Printer Parameters: Options".
TransparentKeyPassThrough=
{Local/Remote/FullScreenOnly}Enables keyboard shortcut sequences defined by the local Windows manager in the session.
Default is FullScreenOnly.
FullScreenOnly—Key event is processed locally except in Fullscreen mode
Local—Key event is processed locally in order to use ICA hotkeys
Remote—Key event is forwarded to the server so that ICA hotkeys do not work
Connection Settings (wlx.ini, $MAC.ini, and {username}.ini Files)
Table 3-3 contains the parameters that you can use for configuring connection settings.
Table 3-3 Connection Settings: wlx.ini files, $MAC.ini files, and {username}.ini files
Alternate={no, yes}
For ICA only.
Specifies the use of an alternate IP address returned from an ICA master browser to get through firewalls.
Default is no.
Browser.Homepage=URL
If the browser add-on is installed, this is the home page for the browser.
Browser.Prefsurl=URL
If the browser add-on is installed, this is the URL to download preferences.
Connect={BROWSER, Custom, ICA, RDP, SSH, Ericom_PowerTerm, Ericom_WebConnect, VMWARE_VIEWCLIENT, VNC_VIEWER, XDMCP}
Specifies the connection protocol.
To create a connection using an INI file, you must specify the Connect= parameter, as well as the mandatory connect options associated with the specified connection type (for example, ICA or VMWare View).
Appendix A describes these parameters:
•
•
•
•
•
•
•
•
•
•
Note
Drives=drive letter={floppy, cdrom, disk}, {rw, ro} [, 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 stick
rw=read/write
ro=read only
basedir is an optional directory on the USB device to use.Note
HomePage=URL
If the browser add-on is installed, this is the URL to the home page for the browser.
ICABrowsing={udp, http, https}
For ICA only.
Specifies the default browsing protocol. Default is http. This setting can be overridden by the HttpBrowsing={yes,no,ssl} in each connection property.
ICAComports=COMx={COMy, USBSERz}, COMx=...
For ICA only.
Maps serial devices on the server to serial devices on the thin client, where x=1 to 4; if COMy, map to that serial port on the thin client; if USBSERz, map to that USB serial port.
Note
IcaDesktopApplianceMode={yes, no}
For ICA only.
Specifies whether to enable Citrix HDX USB startup (for Desktop Appliance Mode) for any USB devices that are already plugged in (the USB device will start up provided the device is not disallowed with a deny rule in the USB policies on either the server [registry entry] or the client [policy rules configuration file]). This parameter requires two thin client reboots.
ICADrives=drive letter={floppy, cdrom, disk}, {rw, ro}, basedir [drive letter=...]
For ICA only.
To map 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 stick
rw=read/write
ro=read only
basedir is an optional directory on the USB device to use.Note
IcaEnhancedAudio={no, yes}
For ICA only.
Enables/Disables Citrix enhanced audio.
true—enables Citrix enhanced audio
false—disables Citrix enhanced audioDefault is false.
ICAhotkey={yes, no}
[hotkey value]For ICA only.
Specifies whether to allow mapping of the hotkeys. For example:
ICAhotkey=yes
Hotkey1Char=F1 Hotkey1Shift=Shift Hotkey2Char=F3 Hotkey2Shift=Shift Hotkey3Char=F2 Hotkey3Shift=Shift Hotkey4Char=F1 ..... Hotkey11Char=plus Hotkey11Shift=CtrlNote
IcaMMAudio={yes, no}
For ICA only.
Specifies whether to enable Citrix HDX MultiMedia audio (see also ICADesktopApplianceMode and ICAMMVideo parameters). This parameter requires two thin client reboots.
For example:
To redirect audio to a USB audio device, set the following parameters as shown:
ICADesktopApplianceMode=yes
ICAMMVideo=yes
ICAMMAudio=noTo redirect audio to an analog audio device, set the following parameters as shown:
ICADesktopApplianceMode=yes
ICAMMVideo=yes
ICAMMAudio=yesIcaMMVideo={yes, no}
For ICA only.
Specifies whether to enable Citrix HDX MultiMedia video (see also ICADesktopApplianceMode and IcaMMAudio parameters). This parameter requires two thin client reboots.
For example:
To redirect audio to a USB audio device, set the following parameters as shown:
ICADesktopApplianceMode=yes
ICAMMVideo=yes
ICAMMAudio=noTo redirect audio to an analog audio device, set the following parameters as shown:
ICADesktopApplianceMode=yes
ICAMMVideo=yes
ICAMMAudio=yesICAMultiMedia={no, yes}
For ICA only.
Specifies whether to enable Citrix multimedia redirection.
yes—Enables Citrix multimedia redirection
no—Disables multimedia redirection
Default is no.ICAProxyHost=proxy server IP address
For ICA only.
Specifies the firewall server address for the ICA connection. When you configure an alternate address for firewalls, and you specify HTTPS or SOCKS for the ICAProxyType, you must specify the proxy server IP address and port. You must specify each entry as host:port, where :port is optional. If you do not specify the port, the value depends on the browsing protocol.
ICAProxyType=[None, HTTP, SOCKS]
For ICA only.
Defines the proxy type for the ICA connection. When you configure an alternate address for firewalls, you can select the proxy type of None, HTTP, or SOCKS.
NFuseServer=host[:port][;host [:port]]
OR
PNAgentServer=host[:port][;host [:port]]
OR
PNLiteServer=host[:port][;host [:port]]
Specifies a list of PN-Agent servers. If you do not specify a port, the port value depends on the browsing protocol.
Default is Empty.
NLA={no, yes}
For RDP only.
Specifies whether to enable Network Level Authentication for RDP sessions.
PNAgentServer
See NFuseServer.
PNLiteServer
See NFuseServer.
RdpClipBoard={yes, no}
For RDP only.
Specifies whether to enable or disable the clipboard in an RDP session. Default is yes.
RdpDriveMap={yes, no}
For RDP only.
Specifies whether to enable or disable drive mapping in an RDP session. Default is yes.
Serial={COM1, COM2, COM3, COM4}
{Baud={1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200}} {Parity={None, Even, Odd, Mark, Space}}
{Stop={1, 1.5, 2}}
{Size={5, 6, 7, 8}}
{Flow={None, XON/XOFF, CTS/RTS, Both}}Configures local serial ports:
Serial—Specifies the configuration for local serial ports .
Baud—Specifies the local serial port baud rate.
Parity—Specifies the local serial port parity.
Stop—Specifies the local serial port stop.
Size—Specifies the local serial port size.
Flow—Specifies the local serial port flow.Note
StopWatchMin=integer
Specifies an integer value to control over-scrolling; for example 100.
Users may experience problems with over-scrolling when using some published applications. Prevent this problem by adjusting the value to a greater number.
