Modify Grid Settings (gridModify)

The gridModify command defines the user for authenticated access to membership servers and modifies properties of the grid, such as how long previous models of the grid will be retained or how many previous models of the grid will be retained.

ttGridAdmin gridModify [-membershipUser user]
                       [-retainDays numdays]
                       [-retainVersions n]
                       [-warnThresh percent]

Options

The gridModify command has the options:

Option	Description
-membershipUser user	Specifies the user name that instances will use for authenticated access to the membership servers. If not specified, access to the membership servers requires no authentication. If specified, the command prompts for a password. Also see Notes below.
-retainDays numdays	Specifies that old versions of the model should be retained for numdays days, then automatically deleted. If numdays is 0, then old versions of the model are not automatically deleted based on their age. The default is 30. Also see Notes below.
-retainVersions n	Specifies that n old versions of the model should be retained. Anything older than the newest n versions are deleted. If n is 0, then old versions of the model are not automatically deleted based on the number of versions. The default is 10. Also see Notes below.
-warnThresh percent	Management instances store metadata for the grid and model. If the metadata on the active management instance fills beyond this percentage of capacity, ttGridAdmin commands result in warnings. The default is 90% full.

Examples

This example defines a user name and password for instances to use to access the membership servers. The command prompts for a password.

% ttGridAdmin gridModify -membershipUser pat
Enter membership password:
Password accepted
Grid Definition modified.

This example shows selected output from gridDisplay before and after executing gridModify to change the number of days to retain old versions of the model.

% ttGridAdmin gridDisplay
Grid name:                  grid1
...
Retain Days:                30
Retain Versions:            10
...

% ttGridAdmin gridModify -retainDays 20
Grid Definition modified.

% ttGridAdmin gridDisplay
Grid name:                  grid1
...
Retain Days:                20
Retain Versions:            10
...

Notes

• The -membershipUser option overwrites any previously defined user name and password.

• The password for the -membershipUser option cannot be empty, must have a maximum length of 30 characters, and must consist only of printable characters.

• You can specify both -retainDays and -retainVersions, in which case old versions of the model are automatically deleted if they are older than numdays days old and there are more than n old versions. If one option is specified as zero, then only the other option takes effect. If both are zero, old versions of the model are not automatically deleted.