D.46. tarantella object new_windowsapp

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


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


The following table shows the available options for this command.



More Information


The common name of the object in the SGD datastore.

Section C.2.84, “Name”


The width of the application, in pixels.

Section C.2.126, “Window Size: Width”


The height of the application, in pixels.

Section C.2.120, “Window Size: Height”


A text description of the object.

Section C.2.29, “Comment”


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

Section C.2.99, “SGD Remote Desktop Client”


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

Section C.2.44, “Domain Name”


Full path name of the application.

Section C.2.4, “Application Command”


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

Section C.2.11, “Arguments for Command”


The application servers that can run the application.

Section C.2.60, “Hosting Application Servers Tab”


Working directory to be used by the application.

Section C.2.129, “Working Directory”


Resumability behavior for the application.

Section C.2.6, “Application Resumability”


How the application is displayed to the user.

Section C.2.127, “Window Type”


Enables the RANDR X extension.

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


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

Section C.2.85, “Number of Sessions”


The initial size of the application.

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


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

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


Color depth for the application.

Section C.2.24, “Color Depth”


Webtop icon for the application.

Section C.2.61, “Icon”


String containing additional name-value data for the application.

Section C.2.58, “Hints”


Whether the AIP protocol compresses commands for transmission.

Section C.2.27, “Command Compression”


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

Section C.2.28, “Command Execution”


Enables interlaced image transmission.

Section C.2.63, “Interlaced Images”


Enables graphics acceleration for the application's display.

Section C.2.57, “Graphics Acceleration”


Enables delayed updates of the application's display.

Section C.2.41, “Delayed Updates”


The login script used to start the application.

Section C.2.73, “Login Script”


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

Section C.2.10, “Arguments”


Number of minutes the application is resumable for.

Section C.2.7, “Application Resumability: Timeout”


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

Section C.2.81, “Middle Mouse Timeout”


Monitor resolution that SGD reports to X applications.

Section C.2.82, “Monitor Resolution”


Load balancing algorithm to use.

Section C.2.5, “Application Load Balancing”


Assigns the application to the specified LDAP users.

Section C.2.13, “Assigned User Profiles Tab”


Assigns the application to the specified LDAP groups.

Section C.2.13, “Assigned User Profiles Tab”


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

Section C.2.13, “Assigned User Profiles Tab”


Clipboard security level for the application.

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


Effect on application session of closing the main application window.

Section C.2.113, “Window Close Action”


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”


Enables application-specific printing configuration.

Section C.2.21, “Client Printing: Override”


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

Section C.2.20, “Client Printing”


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

Section C.2.106, “Universal PDF Printer”


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

Section C.2.107, “Universal PDF Viewer”


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

Section C.2.89, “Postscript Printer Driver”


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”


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”


Enables a pull-down header for kiosk mode applications.

Section C.2.67, “Kiosk Mode Escape”


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”


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

Section C.2.34, “Console Mode”


Sends window management key strokes to the remote session.

Section C.2.116, “Window Management Keys”


Disables background wallpaper. This can improve performance.

Section C.2.42, “Desktop Wallpaper”


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”


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

Section C.2.79, “Menu Animations”


Disables themes for the application. This can improve performance.

Section C.2.105, “Theming”


Disables the mouse pointer shadow. This can improve performance.

Section C.2.40, “Cursor Shadow”


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

Section C.2.39, “Cursor Settings”


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

Section C.2.54, “Font Smoothing”


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

Section C.2.90, “Printer Preference Caching”


Leaves audio at the remote application server.

Section C.2.93, “Remote Audio”


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

Section C.2.47, “Enhanced Network Security”


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.


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"