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=*