Use this command to copy active versions of backup data from a primary storage pool to an active-data pool. The primary benefit of active-data pools is fast client restores. Copy your active data regularly to ensure that the data is protected in case of a disaster.
If a file already exists in the active-data pool, the file is not copied unless the copy of the file in the active-data pool is marked damaged. However, a new copy is not created if the file in the primary storage pool is also marked damaged. In a random-access storage pool, neither cached copies of migrated files nor damaged primary files are copied.
If migration for a storage pool starts while active data is being copied, some files might be migrated before they are copied. For this reason, you should copy active data from storage pools that are higher in the migration hierarchy before copying active data from storage pools that are lower. Be sure a copy process is complete before beginning another.
To issue this command, you must have system privilege, unrestricted storage privilege, or restricted storage privilege for the active-data pool from which active versions of backup data are being copied.
>>-COPY ACTIVEdata--primary_pool_name--active-data_pool_name----> .-MAXProcess--=--1----------. >--+---------------------------+--------------------------------> '-MAXProcess--=----number---' .-Preview--=--No------------------. .-Wait--=--No------. >--+---------------------------------+--+------------------+----> '-Preview--=--+-No--------------+-' '-Wait--=--+-No--+-' +-Yes-------------+ '-Yes-' | (1) | '-VOLumesonly-----' .-SHREDTONOshred--=--No------. >--+----------------------------+------------------------------>< '-SHREDTONOshred--=--+-No--+-' '-Yes-'
Using multiple, parallel processes may improve throughput for the COPY ACTIVEDATA command. The expectation is that the time needed to copy active data will be decreased by using multiple processes. However, when multiple processes are running, in some cases one or more of the processes might need to wait to use a volume that is already in use by a different COPY ACTIVEDATA process.
When determining this value, consider the number of logical and physical drives that can be dedicated to this operation. To access a sequential-access volume, Tivoli® Storage Manager uses a mount point and, if the device type is not FILE, a physical drive. The number of available mount points and drives depends on other Tivoli Storage Manager and system activity and on the mount limits of the device classes for the sequential-access storage pools that are involved when copying active data.
Each process needs a mount point for active-data pool volumes, and, if the device type is not FILE, each process also needs a drive. If you are copying active data from a sequential-access storage pool, each process needs an additional mount point for primary storage pool volumes and, if the device type is not FILE, an additional drive. For example, suppose you specify a maximum of 3 processes to copy a primary sequential storage pool to an active-data pool of the same device class. Each process requires two mount points and two drives. To run all three processes, the device class must have a mount limit of at least six, and at least six mount points and six drives must be available.
To use the PREVIEW parameter, only one process is used, and no mount points or drives are needed.
You can continue with other tasks while the command is being processed. Messages created from the background process are displayed either in the activity log or the server console, depending on where messages are logged.
To cancel a background process, use the CANCEL PROCESS command. If you cancel this process, some files may have already been copied prior to the cancellation.
You cannot specify WAIT=YES from the server console.
copy activedata primary_pool activepool
Command | Description |
---|---|
DEFINE DOMAIN | Defines a policy domain that clients can be assigned to. |
DEFINE STGPOOL | Defines a storage pool as a named collection of server storage media. |
EXPORT NODE | Copies client node information to external media or directly to another server. |
EXPORT SERVER | Copies all or part of the server to external media or directly to another server. |
IMPORT NODE | Restores client node information from external media. |
IMPORT SERVER | Restores all or part of the server from external media. |
MOVE NODEDATA | Moves data for one or more nodes, or a single node with selected file spaces. |
QUERY CONTENT | Displays information about files in a storage pool volume. |
QUERY DOMAIN | Displays information about policy domains. |
QUERY NODE | Displays partial or complete information about one or more clients. |
QUERY NODEDATA | Displays information about the location and size of data for a client node. |
QUERY STGPOOL | Displays information about storage pools. |
RESTORE STGPOOL | Restores files to a primary storage pool from copy storage pools. |
RESTORE VOLUME | Restores files stored on specified volumes in a primary storage pool from copy storage pools. |
UPDATE DOMAIN | Changes the attributes of a policy domain. |
UPDATE STGPOOL | Changes the attributes of a storage pool. |