| Exit Print View | |
Oracle Secure Global Desktop Administration Guide for Version 4.6 |
|
|
|
|
3. Publishing Applications to Users
7. SGD Servers, Arrays, and Load Balancing
B. Secure Global Desktop Server Settings
C. User Profiles, Applications, and Application Servers
The tarantella archive Command
tarantella array add_backup_primary
tarantella array edit_backup_primary
tarantella array list_backup_primaries
tarantella array remove_backup_primary
The tarantella emulatorsession Command
tarantella emulatorsession list
tarantella emulatorsession info
tarantella emulatorsession shadow
tarantella emulatorsession suspend
tarantella emulatorsession end
tarantella object list_attributes
tarantella object list_contents
tarantella object new_container
tarantella object new_dynamicapp
tarantella object new_windowsapp
tarantella object remove_mapping
The tarantella passcache Command
The tarantella restart Command
The tarantella security Command
tarantella security certrequest
tarantella security decryptkey
tarantella security fingerprint
The tarantella service Command
The tarantella tokencache Command
The tarantella uninstall Command
The tarantella version Command
The tarantella webserver Command
tarantella webserver add_trusted_user
tarantella webserver delete_trusted_user
tarantella webserver list_trusted_users
The tarantella webtopsession Command
The tarantella object command enables you to create, list, edit, and delete objects in the organizational hierarchy. You can also add and remove assigned applications links, configure application server load balancing for each application, and add and remove group members.
tarantella object add_host | add_link | add_mapping | add_member | delete | edit | list_attributes | list_contents | new_3270app | new_5250app | new_charapp | new_container | new_dc | new_doc | new_dynamicapp | new_group | new_host | new_org | new_orgunit | new_person | new_windowsapp | new_xapp | remove_host | remove_link | remove_mapping | remove_member | rename | script
The following table shows the available subcommands for this command.
|
Note - All commands include a --help option. You can use tarantella object subcommand --help to get help on a specific command.
The following example lists the objects that belong to the organizational unit Sales.
$ tarantella object list_contents \ --name "o=Indigo Insurance/ou=Sales"
Adds application servers to the list of those that can run an application, for application server load balancing.
tarantella object add_host { --name obj...
--host hobj...
} | --file file
The following table shows the available options for this command.
|
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example adds the application server rome to the load balancing pool for the application Slide-o-Win.
$ tarantella object add_host \ --name "o=applications/cn=Slide-o-Win" \ --host "o=appservers/ou=Sales/cn=rome"
The following example adds the group WinHosts to the load balancing pool for the applications Write-o-Win and Slide-o-Win. Load balancing is performed across all the application servers in WinHosts.
$ tarantella object add_host \ --name "o=applications/cn=Write-o-Win" \ "o=applications/cn=Slide-o-Win" \ --host "o=appservers/cn=WinHosts"
Adds assigned applications links for an object.
tarantella object add_link { --name obj...
--link lobj...
} | --file file
The following table shows the available options for this command.
|
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example adds the Write-o-Win application to Violet Carson’s assigned applications.
$ tarantella object add_link \ --name "o=Indigo Insurance/ou=Sales/cn=Violet Carson" \ --link "o=applications/cn=Write-o-Win"
The following example adds the group Applications to the assigned applications of the
organizational units Sales and Marketing. Everyone who inherits assigned applications from one of
these OUs, for example, they belong to that OU and 
Inherit Assigned Applications from Parent is selected for
their user profile object, sees all the applications in the group in their
assigned applications.
$ tarantella object add_link \ --name "o=Indigo Insurance/ou=Sales" \ --name "o=Indigo Insurance/ou=Marketing" \ --link "o=applications/cn=Applications"
Adds mappings for a dynamic application object. See Dynamic Application Object.
tarantella object add_mapping { --name obj
--mapping [type=application]
} | --file file
The following table shows the available options for this command.
|
When you add a mapping, the applications that are mapped must already exist.
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example adds a windows type mapping to the winApp dynamic application object.
$ tarantella object add_mapping \ --name "o=applications/cn=winApp" \ --mapping windows="o=applications/cn=windows_desktop"
The following example adds a solaris type mapping to the desktopApp dynamic application object.
$ tarantella object add_mapping \ --name "o=applications/cn=desktopApp" \ --mapping solaris="o=applications/cn=solaris_desktop"
Adds objects to groups.
tarantella object add_member { --name obj...
--member mobj...
} | --file file
The following table shows the available options for this command.
|
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example adds the Write-o-Win application to the group Applications.
$ tarantella object add_member \ --name "o=applications/cn=Applications" \ --member "o=applications/cn=Write-o-Win"
The following example adds the three application server objects rome, brussels, and berlin
to the group WinHosts. This group can be added to an application’s Hosting Application Servers Tab
to perform load balancing between the application servers. From the command line, use tarantella object add_host.
$ tarantella object add_member \ --name "o=appservers/cn=WinHosts" \ --member "o=appservers/ou=Sales/cn=rome" \ --member "o=appservers/cn=brussels" \ --member "o=appservers/ou=Marketing/cn=berlin"
Permanently deletes objects from the organizational hierarchy.
tarantella object delete { --name obj [ --children ] } | --file file
The following table shows the available options for this command.
|
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example removes the user profile object for Violet Carson.
$ tarantella object delete \ --name "o=Indigo Insurance/ou=Sales/cn=Violet Carson"
The following example deletes the organizational unit Sales.
$ tarantella object delete \ --name "o=Indigo Insurance/ou=Sales" \ --children
Edits the attributes of an object in the organizational hierarchy.
tarantella object edit { --name obj
{ --attribute [value] }...
} | --file file
The following table shows the available options for this command.
|
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example changes the Inherit Assigned Applications from Parent attribute for the organizational unit Sales.
$ tarantella object edit \ --name "o=Indigo Insurance/ou=Sales" \ --inherit false
Lists the attributes of an object in the organizational hierarchy.
tarantella object list_attributes { --name obj
[ --attribute... ]
} | --file file
The following table shows the available options for this command.
|
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example lists all attributes for the Sales organizational unit.
$ tarantella object list_attributes \ --name "o=Indigo Insurance/ou=Sales"
The following example lists the Email Address and Login attributes for the user
profile object for Rusty Spanner.
$ tarantella object list_attributes \ --name "o=Indigo Insurance/ou=IT/cn=Rusty Spanner" \ --email --enabled
Lists the objects that belong to a particular object in the organizational hierarchy.
tarantella object list_contents { --name obj }| --file file
The following table shows the available options for this command.
|
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example lists all the objects within the organizational unit Sales.
$ tarantella object list_contents \ --name "o=Indigo Insurance/ou=Sales"
Creates one or more 3270 application objects. See 3270 Application Object.
tarantella object new_3270app {
--name obj
--width pixels
--height pixels
[ --description text ]
[ --args args ]
[ --method rexec|telnet|ssh ]
[ --resumable never|session|always ]
[ --endswhen lastclient|windowmanager|windowmanageralone|
nowindows|loginscript|loginscriptnowindows ]
[ --maxinstances 0|instances ]
[ --displayusing clientwm|independent|kiosk|localx ]
[ --maximize true|false ]
[ --scalable true|false ]
[ --icon icon_name ]
[ --hints hint...]
[ --hostname host ]
[ --portnumber tcp ]
[ --3270tnclose 0|1|2|3 ]
[ --3270kt pc|sun4|sun5|hp ]
[ --3270bl 0|1|2|3|4 ]
[ --3270ma true|false ]
[ --3270mb true|false ]
[ --3270si true|false ]
[ --3270fg color ]
[ --3270bg color ]
[ --roottype default|custom ]
[ --rootcolor color ]
[ --compression automatic|on|off ]
[ --execution automatic|inorder|optimized ]
[ --interlaced automatic|on|off ]
[ --accel true|false ]
[ --delayed true|false ]
[ --ldapusers user_dn... ]
[ --ldapgroups group_dn... ]
[ --ldapsearch search_string... ]
[ --env setting... ]
[ --login script ]
[ --winmgr command... ]
[ --resumetimeout mins ]
[ --middlemouse ms
[ --windowclose notifyapp|killapp|suspendsession|endsession ]
[ --euro unicode|iso8859-15 ]
[ --dpi monitordpi ]
[ --keepopen true|false ]
[ --lockkeymap true|false ]
[ --ssharguments args ]
[ --share true|false ]
} | --file file
SGD uses the third-party TeemTalk for Unix emulator for 3270 applications. See the TeemTalk for Unix User’s Guide supplied with SGD for details.
The following table shows the available options for this command.
|
To batch-create multiple objects, use the --file option. Use the other options to create a single object.
The following example creates a new 3270 application object for the application 3270cat. The emulator connects to the 3270 host warsaw.indigo-insurance.com.
$ tarantella object new_3270app \ --name "o=applications/ou=Finance/cn=3270cat" \ --width 1000 --height 800 \ --app /3270cat \ --hostname warsaw.indigo-insurance.com
Creates one or more 5250 application objects. See 5250 Application Object.
tarantella object new_5250app {
--name obj
--width pixels
--height pixels
[ --description text ]
[ --args args ]
[ --method telnet|ssh ]
[ --resumable never|session|always ]
[ --endswhen lastclient|windowmanager|windowmanageralone|
nowindows|loginscript|loginscriptnowindows ]
[ --maxinstances 0|instances ]
[ --displayusing clientwm|independent|kiosk|localx ]
[ --maximize true|false ]
[ --scalable true|false ]
[ --icon icon_name ]
[ --hints hint...]
[ --hostname host ]
[ --portnumber tcp ]
[ --tnclose 0|1|2|3 ]
[ --kt pc|sun4|sun5|hp ]
[ --bl 0|1|2|3|4 ]
[ --ma true|false ]
[ --mb true|false ]
[ --si true|false ]
[ --fg color ]
[ --bg color ]
[ --roottype default|custom ]
[ --rootcolor color ]
[ --compression automatic|on|off ]
[ --execution automatic|inorder|optimized ]
[ --interlaced automatic|on|off ]
[ --accel true|false ]
[ --delayed true|false ]
[ --ldapusers user_dn... ]
[ --ldapgroups group_dn... ]
[ --ldapsearch search_string... ]
[ --env setting... ]
[ --login script ]
[ --winmgr command... ]
[ --resumetimeout mins ]
[ --middlemouse ms ]
[ --windowclose notifyapp|killapp|suspendsession|endsession ]
[ --euro unicode|iso8859-15 ]
[ --dpi monitordpi ]
[ --keepopen true|false ]
[ --lockkeymap true|false ]
[ --share true|false ]
[ --ssharguments args ]
} | --file file
SGD uses the third-party TeemTalk for Unix emulator for 5250 applications. See the TeemTalk for Unix User’s Guide supplied with SGD for details.
The following table shows the available options for this command.
|
To batch-create multiple objects, use the --file option. Use the other options to create a single object.
The following example creates a new 5250 application object for the application 5250cat. The emulator runs on the application server prague, and connects to the AS/400 host warsaw.indigo-insurance.com.
$ tarantella object new_5250app \ --name "o=applications/ou=Finance/cn=5250cat" \ --width 400 --height 300 \ --app /5250cat \ --appserv "o=appservers/cn=prague" \ --hostname warsaw.indigo-insurance.com
Creates one or more character application objects. See Character Application Object.
tarantella object new_charapp {
--name obj
--emulator scocon|vt420|wyse60
--termtype type
--width pixels
--height pixels
[ --description text ]
[ --app pathname ]
[ --args args ]
[ --appserv obj... ]
[ --method telnet|ssh ]
[ --resumable never|session|always ]
[ --maxinstances 0|instances ]
[ --displayusing independent|kiosk ]
[ --maximize true|false ]
[ --cols cols ]
[ --lines lines ]
[ --icon icon_name ]
[ --hints hint...]
[ --font courier|helvetica|timesroman ]
[ --fontsize points ]
[ --fixedfont true|false ]
[ --autowrap true|false ]
[ --cursor off|block|underline ]
[ --statusline none|indicator|hostmessages|standard|extended ]
[ --scrollstyle line|multiple|smooth ]
[ --border normal|indented|raised ]
[ --answermsg message ]
[ --appkeymode true|false ]
[ --keypad numeric|application ]
[ --cursorkeys application|cursor ]
[ --escape 7-bit|8-bit ]
[ --codepage 437|850|852|860|863|865|8859-1|8859-2|
Multinational|Mazovia|CP852 ]
[ --ldapusers user_dn... ]
[ --ldapgroups group_dn... ]
[ --ldapsearch search_string... ]
[ --loadbal default|cpu|memory|sessions ]
[ --compression automatic|on|off ]
[ --env setting... ]
[ --login script ]
[ --keymap keymap ]
[ --attributemap attrmap ]
[ --colormap colormap ]
[ --resumetimeout mins ]
[ --windowclose suspendsession|endsession ]
[ --ssharguments args ]
} | --file file
The following table shows the available options for this command.
|
To batch-create multiple objects, use the --file option. Use the other options to create a single object.
The following example creates a character application object for the application Pers-o-dat. The application can be run on the application servers prague and london. Application server load balancing decides which application server to use.
$ tarantella object new_charapp \ --name "o=applications/cn=Pers-o-dat" \ --emulator vt420 --termtype vt220 \ --width 400 --height 300 \ --app /bin/persodat \ --appserv "o=appservers/cn=prague" \ "o=appservers/ou=IT/cn=london"
Creates one or more Active Directory container objects. See Directory (Light): Active Directory Container Object.
tarantella object new_container { --name obj } | --file file
To batch-create multiple objects, use the --file option. Use the other options to create a single object.
The following example creates a new Active Directory container object with name Users, within the indigo-insurance.com domain components.
$ tarantella object new_container \ --name "dc=com/dc=indigo-insurance/cn=Users"
The following example creates two Active Directory container objects using a batch script defined as a “here-document”. You can alternatively store the batch script in a file, and reference it using --file filename.
$ tarantella object new_container --file - <<EOF --name "dc=com/dc=indigo-insurance/cn=Users" --name "dc=com/dc=indigo-insurance/cn=Applications" EOF
Creates one or more domain component objects. See Directory (Light): Domain Component Object.
tarantella object new_dc { --name obj } | --file file
To batch-create multiple objects, use the --file option. Use the other options to create a single object.
The following example creates a new domain component object with name com, at the top level of the organizational hierarchy.
$ tarantella object new_dc --name "dc=com"
The following example creates two domain component objects using a batch script defined as a “here-document”. You can alternatively store the batch script in a file, and reference it using --file filename.
$ tarantella object new_dc --file - <<EOF --name "dc=com" --name "dc=com/dc=indigo-insurance" EOF
Creates one or more document objects. See Document Object.
tarantella object new_doc {
--name obj
--url url
[ --description text ]
[ --newbrowser true|false ]
[ --icon icon_name ]
[ --hints hint...]
[ --ldapusers user_dn... ]
[ --ldapgroups group_dn... ]
[ --ldapsearch search_string... ]
} | --file file
The following table shows the available options for this command.
|
To batch-create multiple objects, use the --file option. Use the other options to create a single object.
The following example creates a new document object named PhoneList.
$ tarantella object new_doc \ --name "o=applications/ou=Finance/ou=Administration/cn=Phone List" \ --url http://newyork.indigo-insurance.com \ --newbrowser false
The following example creates two document objects using a batch script defined as a “here-document”. You can alternatively store the batch script in a file, and reference it using --file filename.
$ tarantella object new_doc --file - <<EOF --name "o=applications/ou=Finance/ou=Administration/cn=Phone List" --url http://newyork.indigo-insurance.com --newbrowser false --name "o=applications/cn=Indigo Insurance web site" --url http://www.indigo-insurance.com --newbrowser true EOF
Creates one or more dynamic application objects. See Dynamic Application Object.
tarantella object new_dynamicapp {
--name obj
--mapping [type=application]
[ --description text ]
[ --icon icon ]
} | --file file
The following table shows the available options for this command.
|
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example creates a new dynamic application object named desktopApp, with a mapping for a windows type.
$ tarantella object new_dynamicapp \ --name "o=applications/cn=desktopApp" \ --mapping windows="o=applications/cn=windows_desktop"
Creates one or more group objects. See Group Object.
tarantella object new_group {
--name obj
[ --description text ]
[ --member obj... ]
[ --ldapusers user_dn... ]
[ --ldapgroups group_dn... ]
[ --ldapsearch search_string... ]
} | --file file
The following table shows the available options for this command.
|
To batch-create multiple objects, use the --file option. Use the other options to create a single object.
The following example creates a new group object with common name WinHosts, belonging to the organization object appservers. The group’s members are the application server objects for the application servers rome, brussels, and berlin.
$ tarantella object new_group \ --name "o=appservers/cn=WinHosts" \ --member "o=appservers/ou=Sales/cn=rome" \ --member "o=appservers/cn=brussels" \ --member "o=appservers/ou=Marketing/cn=berlin"
The following example creates three group objects using a batch script defined as
a “here-document”. The groups have no members. You can use tarantella object add_member to add members
later from the command line. You can alternatively store the batch script in
a file, and reference it using --file filename.
$ tarantella object new_group --file - <<EOF --name "o=appservers/cn=WinHosts" --name "o=appservers/cn=UNIXHosts" --name "o=applications/cn=Applications" EOF
Creates one or more application server or dynamic application server objects. See Application Server Object
and Dynamic Application Server Object.
For an application server object, use the following syntax:
tarantella object new_host {
--name obj
[ --address address ]
[ --description text ]
[ --ntdomain dom ]
[ --available true|false ]
[ --auth trytta|nevertrytta|default ]
[ --location location ]
[ --hostlocale ll_tt ]
[ --maxcount count ]
[ --userassign spec ]
} | --file file
For a dynamic application server object, use the following syntax:
tarantella object new_host {
--name obj
--dynamic
[ --description text ]
[ --auth trytta|nevertrytta|default ]
[ --vsbclass classname ]
[ --vsbparams params ]
} | --file file
The following table shows the available options for this command.
|
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example creates a new application server object with common name paris, belonging to the organizational unit object Finance, which must already exist.
$ tarantella object new_host \ --name "o=appservers/ou=Finance/cn=paris" \ --address paris.indigo-insurance.com \ --auth default \ --location Europe-north
The following example creates a new dynamic application server object MyBroker that uses the User-defined SGD broker.
$ tarantella object new_host --dynamic \ --name "o=appservers/cn=MyBroker" \ --vsbclass com.sun.sgd.vsbim.UserDefinedSGDBroker
The following example creates three application server objects using a batch script defined as a “here-document”. Alternatively, you can store the batch script in a file, and reference it using --file filename.
$ tarantella object new_host --file - <<EOF --name "o=appservers/ou=Finance/cn=paris" --address paris.indigo-insurance.com --name "o=appservers/cn=brussels" --address brussels.indigo-insurance.com --name "o=appservers/ou=IT/cn=london" --address london.indigo-insurance.com EOF
Creates one or more organization objects. See Directory: Organization Object.
tarantella object new_org {
--name obj
[ --description text ]
[ --conntype type_spec... ]
[ --cdm drive_spec... ]
[ --userprintingconfig true|false ]
[ --mapprinters 2|1|0 ]
[ --pdfenabled 1|0 ]
[ --pdfviewerenabled 1|0 ]
[ --pdfdriver driver_name ]
[ --pdfisdefault 1|0 ]
[ --pdfviewerisdefault 1|0 ]
[ --links obj... ]
[ --editprofile 2|1|0 ]
[ --clipboard 2|1|0 ]
[ --serialport 2|1|0 ]
} | --file file
The following table shows the available options for this command.
|
To batch-create multiple objects, use the --file option. Use the other options to create a single object.
The following example creates a new organization object with name Indigo Insurance. Connections for all users in the organization are secure (SSL-based) unless the OU or user profile objects are configured to give a different type of connection.
$ tarantella object new_org \ --name "o=Indigo Insurance" \ --conntype '*:*:SSL'
The following example creates two organization objects using a batch script defined as a “here-document”. You can alternatively store the batch script in a file, and reference it using --file filename.
$ tarantella object new_org --file - <<EOF --name "o=Indigo Insurance" --name "o=Indigo Insurance Services" EOF
Creates one or more organizational unit (OU) objects. See Directory: Organizational Unit Object.
tarantella object new_orgunit {
--name obj
[ --description text ]
[ --inherit true|false ]
[ --conntype type_spec... ]
[ --cdm drive_spec... ]
[ --userprintingconfig 1|0 ]
[ --mapprinters 2|1|0 ]
[ --pdfenabled 1|0 ]
[ --pdfviewerenabled 1|0 ]
[ --pdfdriver driver_name ]
[ --pdfisdefault 1|0 ]
[ --pdfviewerisdefault 1|0 ]
[ --links obj... ]
[ --editprofile 2|1|0 ]
[ --clipboard 2|1|0 ]
[ --serialport 2|1|0 ]
} | --file file
The following table shows the available options for this command.
|
To batch-create multiple objects, use the --file option. Use the other options to create a single object.
The following example creates a new OU object with the name IT, belonging to the organization object Indigo Insurance, which must already exist. This OU inherits assigned applications from its parent, the organization object. Connections for all users in the OU are secure (SSL-based) unless their user profile objects are configured to give a different type of connection.
$ tarantella object new_orgunit \ --name "o=Indigo Insurance/ou=IT" \ --inherit true --conntype '*:*:SSL'
The following example creates three OU objects using a batch script defined as a “here-document”. The OU Administration belongs to the OU Finance, just created. You can alternatively store the batch script in a file, and reference it using --file filename.
$ tarantella object new_orgunit --file - <<EOF --name "o=Indigo Insurance/ou=IT" --name "o=Indigo Insurance/ou=Finance" --name "o=Indigo Insurance/ou=Finance/ou=Administration" EOF
Creates one or more user profile objects. See User Profile Object.
tarantella object new_person {
--name obj
--surname surname
[ --description text ]
[ --user user ]
[ --email name@domain ]
[ --ntdomain dom ]
[ --inherit true|false ]
[ --shared true|false ]
[ --enabled true|false ]
[ --conntype type_spec... ]
[ --cdm drive_spec... ]
[ --keymap keymap ]
[ --bandwidth limit ]
[ --links obj... ]
[ --userprintingconfig 1|0 ]
[ --mapprinters 2|1|0 ]
[ --pdfenabled 1|0 ]
[ --pdfviewerenabled 1|0 ]
[ --pdfdriver driver_name ]
[ --pdfisdefault 1|0 ]
[ --pdfviewerisdefault 1|0 ]
[ --editprofile 2|1|0 ]
[ --clipboard 2|1|0 ]
[ --serialport 2|1|0 ]
} | --file file
The following table shows the available options for this command.
|
To batch-create multiple objects, use the --file option. Use the other options to create a single object.
The following example creates a new user profile object for Indigo Jones. Indigo inherits assigned applications from the organization object.
$ tarantella object new_person \ --name "o=Indigo Insurance/cn=Indigo Jones" \ --surname Jones --user indigo \ --email indigo@indigo-insurance.com --inherit true
The following example creates three user profile objects using a batch script defined as a “here-document”. You can alternatively store the batch script in a file, and reference it using --file filename.
$ tarantella object new_person --file - <<EOF --name "o=Indigo Insurance/cn=Indigo Jones" --surname Jones --name "o=Indigo Insurance/ou=IT/cn=Bill Orange" --surname Orange --name "o=Indigo Insurance/ou=Finance/cn=Mulan Rouge" --surname Rouge EOF
Creates one or more Windows application objects. See Windows Application Object.
tarantella object new_windowsapp {
--name obj
--width pixels
--height pixels
[ --description text ]
[ --winproto wts|none ]
[ --trylocal true|false ]
[ --ntdomain dom ]
[ --app pathname ]
[ --args args ]
[ --appserv obj... ]
[ --workingdir dir ]
[ --resumable never|session|always ]
[ --displayusing independent|kiosk|seamless ]
[ --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 ]
[ --winmgr command... ]
[ --login script ]
[ --protoargs args ]
[ --resumetimeout mins ]
[ --middlemouse ms ]
[ --euro unicode|iso8859-15 ]
[ --dpi monitordpi ]
[ --lockkeymap true|false ]
[ --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 ]
} | --file file
The following table shows the available options for this command.
|
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"
Creates one or more X application objects. See X Application Object.
tarantella object new_xapp {
--name obj
--width pixels
--height pixels
[ --description text ]
[ --app pathname ]
[ --args args ]
[ --appserv obj... ]
[ --method rexec|telnet|ssh ]
[ --resumable never|session|always ]
[ --endswhen lastclient|windowmanager|windowmanageralone|
nowindows|loginscript|loginscriptnowindows ]
[ --maxinstances 0|instances ]
[ --displayusing clientwm|independent|kiosk|localx ]
[ --maximize true|false ]
[ --scalable true|false ]
[ --depth 8|16|24|16/8|24/8|8/16|8/24 ]
[ --icon icon_name ]
[ --hints hint...]
[ --clipboardlevel level ]
[ --roottype default|custom ]
[ --rootcolor color ]
[ --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 ]
[ --ldapusers user_dn... ]
[ --ldapgroups group_dn... ]
[ --ldapsearch search_string... ]
[ --loadbal default|cpu|memory|sessions ]
[ --env setting... ]
[ --login script ]
[ --winmgr command... ]
[ --resumetimeout mins ]
[ --middlemouse ms ]
[ --force3button true|false ]
[ --windowclose notifyapp|killapp|suspendsession|endsession ]
[ --euro unicode|iso8859-15 ]
[ --dpi monitordpi ]
[ --keepopen true|false ]
[ --lockkeymap true|false ]
[ --share true|false ]
[ --securityextension true|false ]
[ --ssharguments args ]
[ --unixaudiopreload true|false ]
[ --remotewindowkeys true|false ]
[ --allowkioskescape true|false ]
[ --allowsshdowngrade true|false ]
} | --file file
The following table shows the available options for this command.
|
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"
Removes application servers from the list of those that can run an application, for application server load balancing.
tarantella object remove_host { --name obj...
--host hobj...
} | --file file
The following table shows the available options for this command.
|
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example removes the application server rome from the load balancing pool for the application Slide-o-Win.
$ tarantella object remove_host \ --name "o=applications/cn=Slide-o-Win" \ --host "o=appservers/ou=Sales/cn=rome"
The following example removes the group WinHosts from the load balancing pool for the applications Write-o-Win and Slide-o-Win. Load balancing is no longer performed across all the application servers in WinHosts.
$ tarantella object remove_host \ --name "o=applications/cn=Write-o-Win" \ "o=applications/cn=Slide-o-Win" \ --host "o=appservers/cn=WinHosts"
Removes assigned applications links for an object.
tarantella object remove_link { --name obj...
--link lobj...
} | --file file
The following table shows the available options for this command.
|
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example removes the Write-o-Win application from the assigned applications for Violet Carson.
$ tarantella object remove_link \ --name "o=Indigo Insurance/ou=Sales/cn=Violet Carson" \ --link "o=applications/cn=Write-o-Win"
The following example removes the group Applications from the assigned applications of the
organizational units Sales and Marketing. Everyone who inherits assigned applications from one of these
OUs no longer sees all the applications in their assigned applications. For example,
if they belong to that OU and Inherit Assigned Applications from Parent is selected for their user
profile object. However, they might still see an application if it is inherited
from elsewhere.
$ tarantella object remove_link \ --name "o=Indigo Insurance/ou=Sales" \ "o=Indigo Insurance/ou=Marketing" \ --link "o=applications/cn=Applications"
Removes type-application mappings for a dynamic application object. See Dynamic Application Object.
tarantella object remove_mapping {
--name obj
--mappingtype [type]
} | --file file
The following table shows the available options for this command.
|
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example removes a mapping for the windows type from a dynamic application object with common name winApp.
$ tarantella object remove_mapping \ --name "o=applications/cn=winApp" \ --mappingtype windows
The following example removes a mapping for the solaris type from a dynamic application object named desktopApp.
$ tarantella object remove_mapping \ --name "o=applications/cn=desktopApp" \ --mappingtype solaris
Removes objects from groups.
tarantella object remove_member { --name obj...
--member mobj...
} | --file file
The following table shows the available options for this command.
|
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example removes the Write-o-Win application from the group Applications.
$ tarantella object remove_member \ --name "o=applications/cn=Applications" \ --member "o=applications/cn=Write-o-Win"
The following example removes the three application server objects rome, brussels, and berlin from the group WinHosts.
$ tarantella object remove_member \ --name "o=appservers/cn=WinHosts" \ --member "o=appservers/ou=Sales/cn=rome" \ "o=appservers/cn=brussels" \ "o=appservers/ou=Marketing/cn=berlin"
Renames or moves an object in the organizational hierarchy.
tarantella object rename { --name obj...
--newname newobj...
} | --file file
The following table shows the available options for this command.
|
Note - Make sure you quote any object names containing spaces, for example, "o=Indigo Insurance".
The following example renames the user profile object for Elizabeth Blue to Liz Blue.
$ tarantella object rename \ --name "o=Indigo Insurance/ou=Sales/cn=Elizabeth Blue" \ --newname "o=Indigo Insurance/ou=Sales/cn=Liz Blue"
The following example moves Ginger Butcher between the organizational units IT and Sales.
$ tarantella object rename \ --name "o=Indigo Insurance/ou=IT/cn=Ginger Butcher" \ --newname "o=Indigo Insurance/ou=Sales/cn=Ginger Butcher"
Runs a batch script of tarantella object commands, or enables commands to be run interactively.
tarantella object script
The batch script consists of standard tarantella object commands, one per line, without the tarantella object prefix. For example, use edit rather than tarantella object edit.
The batch script can use a back slash (\) to break commands across multiple lines. Lines beginning with a hash (#) are treated as comments and ignored.
If you need to include quotes (") or a backslash (\) character in any of the values for the commands, you must backslash protect them. For example, to use "c:\ Program Files" as a value for the --args option, type the following: --args "\"c:\\Program Files\""
The command reads from standard input. For example, you can use a “here-document” to run a batch script:
$ tarantella object script <<EOF commands EOF
If standard input is empty, you can run tarantella object commands interactively.
The following example adds the group Applications to the organizational units Sales and
Marketing, and sets the Sales OU’s Inherit Assigned Applications from Parent attribute to false.
$ tarantella object script <<EOF add_link --name "o=Indigo Insurance/ou=Sales" "o=Indigo Insurance/ou=Marketing" --link "o=Indigo Insurance/cn=Applications" edit --name "o=Indigo Insurance/ou=Sales" --inherit false EOF
|
|