Creates one or more X application objects. See Section C.1.15, “X Application Object”.
tarantella object new_xapp { --nameobj
--widthpixels
--heightpixels
[ --descriptiontext
] [ --apppathname
] [ --argsargs
] [ --appservobj
... ] [ --method telnet|ssh ] [ --resumable never|session|always ] [ --endswhen lastclient|windowmanager|windowmanageralone| nowindows|loginscript|loginscriptnowindows ] [ --maxinstances 0|instances
] [ --displayusing clientwm|independent|kiosk ] [ --xrandr true|false ] [ --variablerootsize true|false ] [ --maximize true|false ] [ --scalable true|false ] [ --depth 8|16|24|16/8|24/8|8/16|8/24 ] [ --iconicon_name
] [ --hintshint
...] [ --clipboardlevellevel
] [ --roottype default|custom ] [ --rootcolorcolor
] [ --compression automatic|on|off ] [ --execution automatic|inorder|optimized ] [ --quality automatic|best|24|21|18|16|15|12|9|6 ] [ --interlaced automatic|on|off ] [ --accel true|false ] [ --delayed true|false ] [ --ldapusersuser_dn
... ] [ --ldapgroupsgroup_dn
... ] [ --ldapsearchsearch_string
... ] [ --loadbal default|cpu|memory|sessions ] [ --envsetting
... ] [ --loginscript
] [ --winmgrcommand
... ] [ --resumetimeoutmins
] [ --middlemousems
] [ --force3button true|false ] [ --windowclose notifyapp|killapp|suspendsession|endsession ] [ --dpimonitordpi
] [ --keepopen true|false ] [ --share true|false ] [ --securityextension true|false ] [ --sshargumentsargs
] [ --unixaudiopreload true|false ] [ --remotewindowkeys true|false ] [ --allowkioskescape true|false ] [ --allowsshdowngrade true|false ] } | --filefile
The following table shows the available options for this command.
Option | Description | More Information |
---|---|---|
| The common name of the object in the SGD datastore. | |
| The width of the application, in pixels. | |
| The height of the application, in pixels. | |
| A text description of the object. | |
| Full path name of the application. | |
| The command-line arguments to use when starting the application. | |
| The application servers that can run the application. | |
| The mechanism used by the SGD server to access the application server and start the application. | |
| Resumability behavior for the application. | |
| When the application session ends. | |
| The maximum number of instances of the application a user can run simultaneously. | |
| How the application is displayed to the user. | |
| Enables the RANDR X extension. | |
| Resize the root window to match the size of the user's screen. | |
| The initial size of the application. | |
| Scale the application to fit the window in which it is displayed. | |
| Color depth for the application. | |
| Webtop icon for the application. | |
| String containing additional name-value data for the application. | |
| Clipboard security level for the application. | Section C.2.36, “Copy and Paste: Application's Clipboard Security Level” |
| Appearance of the root window. | |
| Color of the root window. | |
| Whether the AIP protocol compresses commands for transmission. | |
| Whether the AIP protocol always executes commands in order, or optimizes commands for performance reasons. | |
| The effective color depth displayed on client devices. | |
| Enables interlaced image transmission. | |
| Enables graphics acceleration for the application's display. | |
| Enables delayed updates of the application's display. | |
| Assigns the application to the specified LDAP users. | |
| Assigns the application to the specified LDAP groups. | |
| Assigns the application to the users that match the LDAP search criteria. | |
| Load balancing algorithm to use. | |
| Environment variable settings needed to run the application. | |
| The login script used to start the application. | |
| The Window Manager to use for the application. | |
| Number of minutes the application is resumable for. | |
| Timeout for emulating a middle mouse button click using a two-button mouse. | |
| Specifies that the application only supports a 3-button mouse. | |
| Effect on application session of closing the main application window. | |
| Monitor resolution that SGD reports to X applications. | |
| Keep open the connection used to start the application. | |
| Enables resource sharing for similar application sessions. | |
| Enables the X Security Extension for the application. | |
| Command-line arguments for the ssh client. | |
| Enables the SGD audio redirection library. | |
| Sends window management key strokes to the remote session. | |
| Enables a pull-down header for kiosk mode applications. | |
| Enables SGD to try an X11 connection instead of SSH, when X11 forwarding is not configured or working. | |
| 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 X application object for the application XFinance. The application can be run on the application servers paris, bonn, or lisbon. Application server load balancing decides which one to use.
$ tarantella object new_xapp \ --name "o=applications/ou=Finance/cn=XFinance" \ --width 1000 --height 800 \ --app /usr/local/bin/xfinance \ --appserv "o=appservers/ou=Finance/cn=paris" \ "o=appservers/ou=Finance/cn=bonn" "o=appservers/cn=lisbon"