IBM Tivoli Storage Manager, Version 7.1

DEFINE PROFASSOCIATION (Define a profile association)

Use this command on a configuration manager to associate one or more objects with a configuration profile for distribution to subscribing managed servers. After a managed server subscribes to a profile, the configuration manager sends object definitions associated with the profile to the managed server where they are stored in the database. Objects created this way in the database of a managed server become managed objects. An object can be associated with more than one profile.

You can use this command to define an initial set of profile associations and to add to existing associations.

You can associate the following types of objects with a profile:

Administrator registrations and authorities
Policy domains, which include the domains' policy sets, management classes, copy groups, and client schedules
Administrative schedules
Server command scripts
Client option sets
Server definitions
Server group definitions

Tip: The configuration manager does not distribute status information for an object to managed servers. For example, information such as the number of days since an administrator last accessed the server is not distributed to managed servers. This type of information is maintained in the databases of the individual managed servers.

Privilege class

To issue this command, you must have system privilege.

Syntax


>>-DEFine PROFASSOCiation--profile_name------------------------->

>--+-------------------------------+---------------------------->
   '-ADMins--=--+-*--------------+-'   
                | .-,----------. |     
                | V            | |     
                '---admin_name-+-'     

>--+---------------------------------+-------------------------->
   '-DOmains--=--+-*---------------+-'   
                 | .-,-----------. |     
                 | V             | |     
                 '---domain_name-+-'     

>--+------------------------------------+----------------------->
   '-ADSCHeds--=--+-*-----------------+-'   
                  | .-,-------------. |     
                  | V               | |     
                  '---schedule_name-+-'     

>--+---------------------------------+-------------------------->
   '-SCRipts--=--+-*---------------+-'   
                 | .-,-----------. |     
                 | V             | |     
                 '---script_name-+-'     

>--+---------------------------------------+-------------------->
   '-CLOptsets--=--+-*-------------------+-'   
                   | .-,---------------. |     
                   | V                 | |     
                   '---option_set_name-+-'     

>--+---------------------------------+-------------------------->
   '-SERVers--=--+-*---------------+-'   
                 | .-,-----------. |     
                 | V             | |     
                 '---server_name-+-'     

>--+-------------------------------------+---------------------><
   '-SERVERGroups--=--+-*--------------+-'   
                      | .-,----------. |     
                      | V            | |     
                      '---group_name-+-'

Parameters

profile_name (Required)

Specifies the name of the configuration profile.

ADMins

Specifies administrators to associate with the profile. You can use wildcard characters in the names. You can specify more than one name by separating the names with commas and no intervening spaces. Use the match-all definition, an asterisk (*) by itself, to specify all administrators that are registered with the configuration manager. If you specify the match-all definition and later add more administrators, they are automatically distributed through the profile.

The configuration manager distributes the administrator name, password, contact information, and authorities of administrators associated with the profile. The configuration manager does not distribute the following:

The administrator named SERVER_CONSOLE, even if you use a match-all definition
The locked or unlocked status of an administrator

When the profile already has administrators associated with it, the following apply:

If you specify a list of administrators and a list already exists, Tivoli® Storage Manager combines the new list with the existing list.
If you specify a match-all definition and a list of administrators already exists, Tivoli Storage Manager replaces the list with the match-all definition.
If you specify a list of administrators, and a match-all definition had previously been specified, Tivoli Storage Manager ignores the list. To remove the match-all definition, issue the DELETE PROFASSOCIATION command with the ADMINS=* parameter.

DOmains

Specifies policy domains to associate with the profile. You can use wildcard characters in the names. You can specify more than one name by separating the names with commas and no intervening spaces. Use the match-all definition, an asterisk (*) by itself, to specify all domains that are defined on the configuration manager. If you specify the match-all definition and later add more domains, they are automatically distributed through the profile.

The configuration manager distributes domain information that includes definitions of policy domains, policy sets, management classes, copy groups, and client schedules. The configuration manager does not distribute the ACTIVE policy set. Administrators on a managed server can activate any policy set within a managed domain on a managed server.

When the profile already has domains associated with it, the following apply:

If you specify a list of domains and a list already exists, Tivoli Storage Manager combines the new list with the existing list.
If you use a match-all definition and a list of domains already exists, Tivoli Storage Manager replaces the list with the match-all definition.
If you specify a list of domains, and a match-all definition had previously been specified, Tivoli Storage Manager ignores the list. To remove the match-all definition, issue the DELETE PROFASSOCIATION command with the DOMAINS=* parameter.

Important: Client operations such as backup and archive fail if destination pools do not exist. Therefore, managed servers that subscribe to this profile must have definitions for any storage pools specified as destinations in the associated domains. Use the RENAME STGPOOL command to rename existing storage pools to match the destination names distributed.

ADSCHeds

Specifies administrative schedules to associate with the profile. You can use wildcard characters in the names. You can specify more than one name by separating the names with commas and no intervening spaces. Use the match-all definition, an asterisk (*) by itself, to specify all administrative schedules that are defined on the configuration manager. If you specify the match-all definition and later add more administrative schedules, they are automatically distributed through the profile.

Tip: Administrative schedules are not active when they are distributed by a configuration manager. An administrator on a managed server must activate any schedule to have it run on that server.

When the profile already has administrative schedules associated with it, the following apply:

If you specify a list of administrative schedules and a list already exists, Tivoli Storage Manager combines the new list with the existing list.
If you use a match-all definition and a list of administrative schedules already exists, Tivoli Storage Manager replaces the list with the match-all definition.
If you specify a list of administrative schedules, and a match-all definition had previously been specified, Tivoli Storage Manager ignores the list. To remove the match-all definition, issue the DELETE PROFASSOCIATION command with the ADSCHEDS=* parameter.

SCRipts

Specifies server command scripts to associate with the profile. You can use wildcard characters in the names. You can specify more than one name by separating the names with commas and no intervening spaces. Use the match-all definition, an asterisk (*) by itself, to specify all scripts that are defined on the configuration manager. If you specify the match-all definition and later add more scripts, they are automatically distributed through the profile.

When the profile already has scripts associated with it, the following apply:

If you specify a list of scripts and a list already exists, Tivoli Storage Manager combines the new list with the existing list.
If you use a match-all definition and a list of scripts already exists, Tivoli Storage Manager replaces the list with the match-all definition.
If you specify a list of scripts, and a match-all definition had previously been specified, Tivoli Storage Manager ignores the list. To remove the match-all definition, issue the DELETE PROFASSOCIATION command with the SCRIPTS=* parameter.

CLOptsets

Specifies client option sets to associate with the profile. You can use wildcard characters in the names. You can specify more than one name by separating the names with commas and no intervening spaces. Use the match-all definition, an asterisk (*) by itself, to specify all client option sets that are defined on the configuration manager. If you specify the match-all definition and later add more client option sets, they are automatically distributed through the profile.

When the profile already has client option sets associated with it, the following apply:

If you specify a list of client option sets and a list already exists, Tivoli Storage Manager combines the new list with the existing list.
If you use a match-all definition and a list of client option sets already exists, Tivoli Storage Manager replaces the list with the match-all definition.
If you specify a list of client option sets, and a match-all definition had previously been specified, Tivoli Storage Manager ignores the list. To remove the match-all definition, issue the DELETE PROFASSOCIATION command with the CLOPSETS=* parameter.

SERVers

Specifies server definitions to associate with the profile. The definitions are distributed to managed servers that subscribe to this profile. You can use wildcard characters in the names. You can specify more than one name by separating the names with commas and no intervening spaces. Use the match-all definition, an asterisk (*) by itself, to specify all servers that are defined on the configuration manager. If you specify the match-all definition and later add more servers, they are automatically distributed through the profile.

The configuration manager distributes the following server attributes: communication method, IP address, port address, server password, URL, and the description. Distributed server definitions always have the ALLOWREPLACE attribute set to YES on the managed server, regardless of this parameter's value on the configuration manager. On the managed server, you can use the UPDATE SERVER command to set all other attributes.

When the profile already has servers associated with it, the following apply:

If you specify a list of servers and a list already exists, Tivoli Storage Manager combines the new list with the existing list.
If you use a match-all definition and a list of servers already exists, Tivoli Storage Manager replaces the list with the match-all definition.
If you specify a list of servers, and a match-all definition had previously been specified, Tivoli Storage Manager ignores the list. To remove the match-all definition, issue the DELETE PROFASSOCIATION command with the SERVERS=* parameter.

Important:

A server definition on a managed server is not replaced by a definition from the configuration manager unless you have allowed replacement of the definition on the managed server. To allow replacement, on the managed server update the server definition by using the UPDATE SERVER command with ALLOWREPLACE=YES.
If a configuration manager distributes a server definition to a managed server, and a server group of the same name exists on the managed server, the distributed server definition replaces the server group definition.

SERVERGroups

Specifies server groups to associate with the profile. You can use wildcard characters in the names. You can specify more than one name by separating the names with commas and no intervening spaces. Use the match-all definition, an asterisk (*) by itself, to specify all server groups that are defined on the configuration manager. If you specify the match-all definition and later add more server groups, they are automatically distributed through the profile.

Tip: A configuration manager does not distribute a server group definition to a managed server if the managed server has a server defined with the same name as that of the server group.

When the profile already has server groups associated with it, the following apply:

If you specify a list of server groups and a list already exists, Tivoli Storage Manager combines the new list with the existing list.
If you use a match-all definition and a list of server groups already exists, Tivoli Storage Manager replaces the list with the match-all definition.
If you specify a list of server groups, and a match-all definition had previously been specified, Tivoli Storage Manager ignores the list. To remove the match-all definition, issue the DELETE PROFASSOCIATION command with the SERVERGROUPS=* parameter.

Example: Associate a specific domain with a specific profile

Associate a domain named MARKETING with a profile named DELTA.

define profassociation delta domains=marketing

Example: Associate all domains with a specific profile

You have already associated a list of domains with a profile named GAMMA. Now associate all domains defined on the configuration manager with the profile.

define profassociation gamma domains=*

Related commands

Table 1. Commands related to DEFINE PROFASSOCIATION
Command	Description
COPY PROFILE	Creates a copy of a profile.
DEFINE PROFILE	Defines a profile for distributing information to managed servers.
DELETE PROFASSOCIATION	Deletes the association of an object with a profile.
DELETE PROFILE	Deletes a profile from a configuration manager.
LOCK PROFILE	Prevents distribution of a configuration profile.
NOTIFY SUBSCRIBERS	Notifies servers to refresh their configuration information.
QUERY PROFILE	Displays information about configuration profiles.
SET CONFIGMANAGER	Specifies whether a server is a configuration manager.
UNLOCK PROFILE	Enables a locked profile to be distributed to managed servers.
UPDATE PROFILE	Changes the description of a profile.

Feedback