| 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
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
tarantella object remove_member
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
This command enables SGD Administrators to set up and dismantle arrays of SGD servers.
The command can be run on any SGD server in the array.
tarantella array add_backup_primary | clean | detach | edit_backup_primary | join | list | list_backup_primaries | make_primary | remove_backup_primaries
The following table shows the available subcommands for this command.
|
Note - All commands include a --help option. You can use tarantella array command --help to get help on a specific command.
The following example adds the server boston to the array with primary server newyork.
$ tarantella array join --primary newyork.example.com \ --secondary boston.example.com
The following example makes the secondary server boston the primary server in the array. The previous primary server becomes a secondary server.
$ tarantella array make_primary \ --secondary boston.example.com
Adds a secondary server to the list of backup primaries for an SGD array.
tarantella array add_backup_primary --secondary serv --position [ first | last | position ]
The following table shows the available options for this command.
|
The following example adds the secondary server boston to the backup primaries list for the array. The server is added in last position of the list.
$ tarantella array add_backup_primary \ --secondary boston.example.com --position last
Deletes array information and returns an SGD server to a preconfigured array state. By default, a confirmation prompt is displayed.
Note - This command only affects the SGD server where the command is run.
tarantella array clean [ --standalone | --contactmembers ] [ --quiet ]
The following table shows the available options for this command.
|
Note - After running this command, it is advisable to run the tarantella status command on the SGD server to check the status of the server.
The following example removes array configuration and returns the SGD server where the command is run to a standalone state. A confirmation prompt is not shown.
$ tarantella array clean --quiet
Removes a secondary server from the array of SGD servers it belongs to.
tarantella array detach --secondary serv
The following table shows the available options for this command.
|
To remove the primary server from an array, first use 
tarantella array make_primary to make
another server the primary server and then detach the old primary server.
When you use this command, the secondary server is removed from the backup primaries list for the SGD array.
When you remove a server from an array, it loses its license keys.
Note - After running this command, it is advisable to wait until SGD has copied the changes to all SGD servers in the array before running any further tarantella array commands. Run the tarantella status command on the primary SGD server to check the status of the array.
If you are using secure intra-array communication, the secondary server generates its own Certificate Authority (CA) certificate and its own server peer Secure Sockets Layer (SSL) certificate when it is detached.
The following example removes the secondary server boston from the array.
$ tarantella array detach --secondary boston.example.com
Sets the position of a secondary server in the list of backup primaries for an SGD array.
tarantella array edit_backup_primary --secondary serv --position [ first | last | position ]
The following table shows the available options for this command.
|
The following example sets the position of the secondary server boston in the backup primaries list for the array. The server is moved to last position in the list.
$ tarantella array edit_backup_primary \ --secondary boston.example.com --position last
Adds a server to an array of SGD servers, either as a primary or a secondary server.
tarantella array join [ --primary pserv ]
[ --secondary sserv ]
The clock on the server joining the array must be in synchronization with the clocks on the other servers in the array. If the time difference is more than one minute, this command will fail.
After running this command, it is advisable to wait until SGD has copied the changes to all SGD servers in the array before running any further tarantella array commands. Run the tarantella status command on the primary SGD server to check the status of the array.
It is best to use a fully-qualified DNS name when specifying the server to add to an array.
The following table shows the available options for this command.
|
When you use this command, the secondary server is added to the end of the backup primaries list for the SGD array.
If the server you add has been load balancing application servers using Advanced Load Management, use the tarantella restart sgd --warm command to do a warm restart of the new server after it has joined the array. If the array to which the new server is joined is using Advanced Load Management, do a warm restart of the whole array after the new server has joined.
If you are using secure intra-array communication, you are prompted to accept the CA certificate of either the primary server or the secondary server, depending on where you ran the command.
The following example adds the server boston to the array with newyork as its primary server.
$ tarantella array join \ --primary newyork.example.com \ --secondary boston.example.com
The following example adds the server where the command is run to the array with newyork as its primary server.
$ tarantella array join \ --primary newyork.example.com
Lists each member of the array of SGD servers, identifying the primary server.
tarantella array list
The following example lists all SGD servers in the array.
$ tarantella array list
Displays the contents of the backup primaries list for an SGD array.
tarantella array list_backup_primaries [ --first | --last | --all ]
If no options are specified, this command displays all entries in the backup primaries list.
The following table shows the available options for this command.
|
The following example displays all entries in the backup primaries list for the SGD array.
$ tarantella array list_backup_primaries
Makes a secondary server the primary server for the array that it is currently a member of. The previous primary server becomes a secondary server.
tarantella array make_primary --secondary serv
The following table shows the available options for this command.
|
Note - After running this command, it is advisable to wait until SGD has copied the changes to all SGD servers in the array before running any further tarantella array commands. Run the tarantella status command on the primary SGD server to check the status of the array.
If you are using secure intra-array communication, the new primary becomes the certificate authority for the array and issues new server peer SSL certificates to all SGD servers in the array.
The following example makes the secondary server boston the primary server in the array.
$ tarantella array make_primary \ --secondary boston.example.com
Removes one or all secondary servers from the list of backup primaries for an SGD array.
tarantella array remove_backup_primary [ --secondary serv | --all ]
The following table shows the available options for this command.
|
The following example removes the secondary server boston from the backup primaries list for the array.
$ tarantella array remove_backup_primary \ --secondary boston.example.com
|
|