UPDATE DOMAIN (Update a policy domain)
Use this command to change a policy domain.
Privilege class
To issue this command, you must have system privilege, unrestricted policy privilege, or restricted policy privilege for the specified policy domain.
Syntax
>>-UPDate DOmain--domain_name-----------------------------------> >--+-----------------------------+------------------------------> '-DESCription--=--description-' >--+------------------------+--+------------------------+-------> '-BACKRETention--=--days-' '-ARCHRETention--=--days-' >--+-----------------------------------------------------+----->< | .-,-------------------------. | | V | | '-ACTIVEDESTination--=------active-data_pool_name---+-'
Parameters
- domain_name (Required)
- Specifies the name of the policy domain.
- DESCription
- Describes the policy domain by using a text string. This parameter is optional. The maximum length of the description is 255 characters. Enclose the description in quotation marks if it contains any blank characters. To remove a previously defined description, specify a null string ("").
- BACKRETention
- Specifies the number of days (from the date the backup versions
became inactive) to retain backup versions that are no longer on the
client file system. This parameter is optional. You can specify an
integer in the range 0 - 9999. The server uses the backup retention
value to manage inactive versions of files when any of the following
conditions occur:
- A file is rebound to a new management class, but the new management class and the default management class do not contain a backup copy group.
- The management class to which a file is bound no longer exists. The default management class does not contain a backup copy group.
- The backup copy group is deleted from the management class to which a file is bound. The default management class does not contain a backup copy group.
- ARCHRETention
- Specifies the number of days (from the date of archive) to retain
archive copies. This parameter is optional. You can specify an integer
in the range 0 - 30000. The server uses the archive retention value
to manage archive copies of files when either of the following conditions
occur:
- The management class to which a file is bound, no longer exists. The default management class does not contain an archive copy group.
- The archive copy group is deleted from the management class to which a file is bound. The default management class does not contain an archive copy group.
- ACTIVEDESTination
- Specifies the names of active-data pools that store active versions
of backup data for nodes that are assigned to the domain. This parameter
is optional. Spaces between the names of the active-data pools are
not permitted. You cannot specify more than 10 active-data pools
for a domain.
Before the Tivoli® Storage Manager server writes data to an active-data pool, it verifies that the node that owns the data is assigned to a domain that has the active-data pool that is listed in the ACTIVEDESTINATION list. If the server verifies that the node meets this criteria, the data is stored in the active-data pool. If the node does not meet the criteria, then the data is not stored in the active-data pool. If the simultaneous-write function is used to write data to an active-data pool, the server completes the verification during backup operations by Tivoli Storage Manager backup-archive clients or by application clients by using the Tivoli Storage Manager API. The verification is also done when active-data is being copied by using the COPY ACTIVEDATA command.
Example: Update the backup retention period for a policy domain
Update the policy domain ENGPOLDOM so that the backup retention grace period is extended to 90 days and the archive retention grace period is extended to two years. Specify an active-data pool as the destination for active versions of backup data belonging to nodes that are assigned to the domain. Use engactivedata as the name of the active-data pool. Issue the following command:update domain engpoldom description='Engineering Policy Domain'
backretention=90 archretention=730 activedestination=engactivedata
Related commands
Command | Description |
---|---|
COPY DOMAIN | Creates a copy of a policy domain. |
DEFINE DOMAIN | Defines a policy domain that clients can be assigned to. |
DEFINE POLICYSET | Defines a policy set within the specified policy domain. |
DELETE DOMAIN | Deletes a policy domain along with any policy objects in the policy domain. |
QUERY DOMAIN | Displays information about policy domains. |