Tivoli Storage Manager for Sun Solaris Administrator's Reference

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:

Note: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:

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

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:

Attention: 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.
Note: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:

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:

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:

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:

Notes:

  1. 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.

  2. 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.
Note: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:

Examples

Task 1

Associate a domain named MARKETING with a profile named DELTA.

Command:
define profassociation delta domains=marketing

Task 2

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.

Command:
define profassociation gamma domains=*

Related Commands

Table 71. 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.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]