Tivoli Storage Manager for Windows Administrator's Reference
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
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:
- 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, TSM
combines the new list with the existing list.
- If you specify a match-all definition and a list of administrators already
exists, TSM replaces the list with the match-all definition.
- If you specify a list of administrators, and a match-all definition had
previously been specified, TSM 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, TSM combines
the new list with the existing list.
- If you use a match-all definition and a list of domains already exists,
TSM replaces the list with the match-all definition.
- If you specify a list of domains, and a match-all definition had
previously been specified, TSM ignores the list. To remove the
match-all definition, issue the DELETE PROFASSOCIATION command with the
DOMAINS=* parameter.
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:
- If you specify a list of administrative schedules and a list already
exists, TSM combines the new list with the existing list.
- If you use a match-all definition and a list of administrative schedules
already exists, TSM 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, TSM 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, TSM combines
the new list with the existing list.
- If you use a match-all definition and a list of scripts already exists,
TSM replaces the list with the match-all definition.
- If you specify a list of scripts, and a match-all definition had
previously been specified, TSM 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, TSM
combines the new list with the existing list.
- If you use a match-all definition and a list of client option sets already
exists, TSM 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, TSM 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, TSM combines
the new list with the existing list.
- If you use a match-all definition and a list of servers already exists,
TSM replaces the list with the match-all definition.
- If you specify a list of servers, and a match-all definition had
previously been specified, TSM ignores the list. To remove the
match-all definition, issue the DELETE PROFASSOCIATION command with the
SERVERS=* parameter.
Notes:
- 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.
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:
- If you specify a list of server groups and a list already exists, TSM
combines the new list with the existing list.
- If you use a match-all definition and a list of server groups already
exists, TSM 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, TSM ignores the list. To remove the
match-all definition, issue the DELETE PROFASSOCIATION command with the
SERVERGROUPS=* parameter.
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 69. Commands Related to DEFINE PROFASSOCIATION
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]