Utilities to manage IBM Spectrum Protect collocation groups.

Resolving The Problem

fullvolcapacity.pl
This script displays the average full volume capacity by storage pool for all sequential storage pools. The average full volume capacity depends on the type of storage device and the type of data stored (compressibility). This information is useful for determining how much data needs to be included in a collocation group to optimally use the storage media volumes.

Usage: fullvolcapacity -ID=userid -PAssword=password
where -ID=userid specifies the administrator's user ID
-PAssword=password specifies the administrator's
password

nongroupednodes.pl

This script displays the registered nodes that are not currently defined as members of a collocation group, and their domain.

Usage: nongroupednodes -ID=userid -PAssword=password

addnodestogroup.pl

This script defines all registered nodes in domain_name that are not currently defined as members of a collocation group to the group group_name. The collocation group group_name is created if it does not already exist.

Usage: addnodestogroup -ID=userid -PAssword=password domain_name group_name

where -ID=userid specifies the administrator's user ID
-PAssword=password specifies the administrator's
password
-domain_name specifies the TSM policy domain name
-group_name specifies the collocation group name


defgroups.pl
This script defines all registered nodes in domain_name that are not currently defined as members of a collocation group to new groups based on the amount of data currently stored under those nodes and the specified media capacity. The new collocation groups are created with names using the group_prefix prefix and a sequentially increasing numeric suffix. The capacity is to be specified in MB and is used only by this script, which does not
limit the storage capacity on the TSM server for these nodes in any manner. A recommended value to be used for capacity is 4 times the expected or realized sequential media volume capacity (which might be determined using the fullvolcapacity script).
This value will likely provide a favorable balance so that the storage volumes are filled and data for any given node is spread across an optimal number of storage volumes for multi-session restore. Collocation by group will only be used for data that is
stored in sequential storage pools that are configured with collocate=group.

Collocation groups are only supported by TSM server version 5.3 or higher, however, this script may be run on TSM servers prior to 5.3. In that case, all nodes in the domain are included, and the collocation groups are not defined (regardless of -EXEC).

Usage: defgroups -ID=userid -PAssword=password -EXEC
domain_name group_prefix capacity

where -ID=userid specifies the administrator's user ID
-PAssword=password specifies the administrator's
password
-EXEC specifies that the new collocation groups will
be defined with their members as determined by
this script. If this argument is not specified,
information about the groups that would be defined
is displayed, and a macro called _defgrps.mac is
created in the current directory, but the macro is
not executed and the groups are not defined.
domain_name specifies the TSM policy domain name
group_prefix specifies the prefix to be used for
creating the collocation group names
capacity specifies the amount of data in MB to be
used for creating the collocation groups and
defining nodes to them

The scripts can be found in the servers installation directory, they will run on a system with a Perl interpreter installed.