D.46. tarantella object new_windowsapp

Creates one or more Windows application objects. See Section C.1.14, “Windows Application Object”.

Syntax

tarantella object new_windowsapp {
   --name obj
   --width pixels 
   --height pixels  
 [ --description text ]
 [ --winproto wts|none ]
 [ --ntdomain dom ]
 [ --app pathname ]
 [ --args args ]
 [ --appserv obj... ]
 [ --workingdir dir ]
 [ --resumable never|session|always ]
 [ --displayusing independent|kiosk|seamless ]
 [ --xrandr true|false ]
 [ --maxinstances 0|instances ]
 [ --maximize true|false ]
 [ --scalable true|false ]
 [ --depth 8|16|24/32 ]
 [ --icon icon_name ]
 [ --hints hint...]
 [ --compression automatic|on|off ]
 [ --execution automatic|inorder|optimized ]
 [ --interlaced automatic|on|off ]
 [ --accel true|false ]
 [ --delayed true|false ]
 [ --login script ]
 [ --protoargs args ]
 [ --resumetimeout mins ]
 [ --middlemouse ms ]
 [ --dpi monitordpi ]
 [ --loadbal default|cpu|memory|sessions ]
 [ --ldapusers user_dn... ]
 [ --ldapgroups group_dn... ]
 [ --ldapsearch search_string... ]
 [ --clipboardlevel level ]
 [ --windowclose suspendsession|endsession ]
 [ --cdm drive_spec... ]
 [ --appprintingconfig 1|0 ]
 [ --mapprinters 2|1|0 ]
 [ --pdfenabled 1|0 ]
 [ --pdfviewerenabled 1|0 ]
 [ --pdfdriver driver_name ]
 [ --pdfisdefault 1|0 ]
 [ --pdfviewerisdefault 1|0 ]
 [ --allowkioskescape true|false ]
 [ --swmopts true|false ]
 [ --console 1|0 ]
 [ --remotewindowkeys true|false ]
 [ --disablewallpaper 1|0 ]
 [ --disablefullwindowdrag 1|0 ]
 [ --disablemenuanimations 1|0 ]
 [ --disabletheming 1|0 ]
 [ --disablecursorshadow 1|0 ]
 [ --disablecursorsettings 1|0 ]
 [ --enablefontsmoothing 1|0 ]
 [ --noprintprefs 1|0 ]
 [ --remoteaudio 1|0 ]
 [ --enhancednetworksecurity 1|0 ]
 } | --file file

Description

The following table shows the available options for this command.

Option

Description

More Information

--name

The common name of the object in the SGD datastore.

Section C.2.84, “Name”

--width

The width of the application, in pixels.

Section C.2.126, “Window Size: Width”

--height

The height of the application, in pixels.

Section C.2.120, “Window Size: Height”

--description

A text description of the object.

Section C.2.29, “Comment”

--winproto

Whether to run the Windows application from an application server using Remote Desktop Protocol.

Section C.2.99, “SGD Remote Desktop Client”

--ntdomain

The Windows domain to use for the application server authentication process.

Section C.2.44, “Domain Name”

--app

Full path name of the application.

Section C.2.4, “Application Command”

--args

The command-line arguments to use when starting the application.

Section C.2.11, “Arguments for Command”

--appserv

The application servers that can run the application.

Section C.2.60, “Hosting Application Servers Tab”

--workingdir

Working directory to be used by the application.

Section C.2.129, “Working Directory”

--resumable

Resumability behavior for the application.

Section C.2.6, “Application Resumability”

--displayusing

How the application is displayed to the user.

Section C.2.127, “Window Type”

--xrandr

Enables the RANDR X extension.

Section C.2.124, “Window Size: RandR Extension”

--maxinstances

The maximum number of instances of the application a user can run simultaneously.

Section C.2.85, “Number of Sessions”

--maximize

The initial size of the application.

Section C.2.118, “Window Size: Client's Maximum Size”

--scalable

Scale the application to fit the window in which it is displayed.

Section C.2.125, “Window Size: Scale to Fit Window”

--depth

Color depth for the application.

Section C.2.24, “Color Depth”

--icon

Webtop icon for the application.

Section C.2.61, “Icon”

--hints

String containing additional name-value data for the application.

Section C.2.58, “Hints”

--compression

Whether the AIP protocol compresses commands for transmission.

Section C.2.27, “Command Compression”

--execution

Whether the AIP protocol always executes commands in order, or optimizes commands for performance reasons.

Section C.2.28, “Command Execution”

--interlaced

Enables interlaced image transmission.

Section C.2.63, “Interlaced Images”

--accel

Enables graphics acceleration for the application's display.

Section C.2.57, “Graphics Acceleration”

--delayed

Enables delayed updates of the application's display.

Section C.2.41, “Delayed Updates”

--login

The login script used to start the application.

Section C.2.73, “Login Script”

--protoargs

Command-line arguments used for the SGD Remote Desktop Client.

Section C.2.10, “Arguments”

--resumetimeout

Number of minutes the application is resumable for.

Section C.2.7, “Application Resumability: Timeout”

--middlemouse

Timeout for emulating a middle mouse button click using a two-button mouse.

Section C.2.81, “Middle Mouse Timeout”

--dpi

Monitor resolution that SGD reports to X applications.

Section C.2.82, “Monitor Resolution”

--loadbal

Load balancing algorithm to use.

Section C.2.5, “Application Load Balancing”

--ldapusers

Assigns the application to the specified LDAP users.

Section C.2.13, “Assigned User Profiles Tab”

--ldapgroups

Assigns the application to the specified LDAP groups.

Section C.2.13, “Assigned User Profiles Tab”

--ldapsearch

Assigns the application to the users that match the LDAP search criteria.

Section C.2.13, “Assigned User Profiles Tab”

--clipboardlevel

Clipboard security level for the application.

Section C.2.36, “Copy and Paste: Application's Clipboard Security Level”

--windowclose

Effect on application session of closing the main application window.

Section C.2.113, “Window Close Action”

--cdm

The drives on a Microsoft Windows client device that can be accessed from the application running on an application server.

Section C.2.19, “Client Drive Mapping”

--appprintingconfig

Enables application-specific printing configuration.

Section C.2.21, “Client Printing: Override”

--mapprinters

The client printers users can print to when printing from the application.

Section C.2.20, “Client Printing”

--pdfenabled

Enables users to print using the SGD “Universal PDF Printer” printer when printing from the application.

Section C.2.106, “Universal PDF Printer”

--pdfviewerenabled

Enables users to print using the SGD “Universal PDF Viewer” printer when printing from the application.

Section C.2.107, “Universal PDF Viewer”

--pdfdriver

The printer driver to use for SGD PDF printing when printing from the application.

Section C.2.89, “Postscript Printer Driver”

--pdfisdefault

Sets the SGD “Universal PDF Printer” printer as the client's default printer when printing from the application.

Section C.2.74, “Make Universal PDF Printer the Default”

--pdfviewerisdefault

Sets the SGD “Universal PDF Viewer” printer as the client's default printer when printing from the application.

Section C.2.75, “Make Universal PDF Viewer the Default”

--allowkioskescape

Enables a pull-down header for kiosk mode applications.

Section C.2.67, “Kiosk Mode Escape”

--swmopts

Enables local window hierarchy for applications displayed in seamless windows mode. Needed for compatibility with some Borland applications.

Section C.2.103, “SWM Local Window Hierarchy”

--console

Starts the application in console mode, also called remote administration mode.

Section C.2.34, “Console Mode”

--remotewindowkeys

Sends window management key strokes to the remote session.

Section C.2.116, “Window Management Keys”

--disablewallpaper

Disables background wallpaper. This can improve performance.

Section C.2.42, “Desktop Wallpaper”

--disablefullwindowdrag

Disables the option to show the contents of a window when it is moved. This can improve performance.

Section C.2.56, “Full Window Drag”

--disablemenuanimations

Disables transition effects for menus and tooltips. This can improve performance.

Section C.2.79, “Menu Animations”

--disabletheming

Disables themes for the application. This can improve performance.

Section C.2.105, “Theming”

--disablecursorshadow

Disables the mouse pointer shadow. This can improve performance.

Section C.2.40, “Cursor Shadow”

--disablecursorsettings

Disables mouse pointer schemes and customizations. This can improve performance.

Section C.2.39, “Cursor Settings”

--enablefontsmoothing

Enables font smoothing for text in the application. This can improve text readability, but can affect performance.

Section C.2.54, “Font Smoothing”

--noprintprefs

Disables caching of printer preferences, such as paper size and page orientation.

Section C.2.90, “Printer Preference Caching”

--remoteaudio

Leaves audio at the remote application server.

Section C.2.93, “Remote Audio”

--enhancednetworksecurity

Uses enhanced security, such as Transport Layer Security (TLS) or Network Level Authentication (NLA) using CredSSP.

Section C.2.47, “Enhanced Network Security”

--file

Batch file used to create multiple objects within the organizational hierarchy.

 

To batch-create multiple objects, use the --file option. Use the other options to create a single object.

Examples

The following example creates a new Windows application object for the application Write-o-Win. The application runs on the application server rome.

$ tarantella object new_windowsapp \
--name "o=applications/cn=Write-o-Win" \
--width 1000  --height 800 \
--app c:\\programs\\apps\\write.exe \
--appserv "o=appservers/ou=Sales/cn=rome"