D.15. tarantella config edit

Edits global and server-specific attributes.

Syntax

tarantella config edit { { --setting value... }...
                         [ --array | --server serv... ]
                       } | --file file

Description

The following table shows the available options for this command.

Option

Description

--setting value...

Names an attribute you want to edit, and its new value or values.

--array

When configuring a server-specific attribute, applies the change to all SGD servers in the array.

--server

When configuring a server-specific attribute, applies the change to each named serv in the array. Use a peer DNS name or IP address for each server.

--file

Specifies a file containing a batch of commands to edit attributes.

If neither --array nor --server is specified, the command sets server-specific attributes for the SGD server where the command is run.

Use the tarantella config list command to see a list of settings you can change.

For detailed information on global attributes, see Appendix A, Global Settings and Caches.

For detailed information on server-specific attributes, see Appendix B, Secure Global Desktop Server Settings.

Some attribute settings are lists. When editing a list on the command line, it is best to enclose each item in the list in quotes, and separate each item with a space. For example:

$ tarantella config edit --tarantella-config-tpeconfig-logfilter \
"tpe/*/*" "pem/*/*"

Alternatively, you can put each item in the list on a separate line. For example:

$ tarantella config edit --tarantella-config-tpeconfig-logfilter \
"tpe/*/*" \
"pem/*/*"

If you omit the quotes, you must use a backslash (\) to escape any characters, such as asterisks (*), to prevent your shell from expanding them.

On the command line, when you display attribute settings that are lists, the setting is shown as a comma-separated list. For example:

$ tarantella config list --tarantella-config-tpeconfig-logfilter
tarantella-config-tpeconfig-logfilter: tpe/*/*,pem/*/*

Examples

The following example sets the cpe-exitafter attribute to 50 on SGD servers newyork.example.com and boston.example.com.

$ tarantella config edit --cpe-exitafter 50 \
--server newyork.example.com boston.example.com

The following example sets the cpe-maxsessions attribute to 10 for the server where the command is run.

$ tarantella config edit --cpe-maxsessions 10