MOVE CONTAINER (Move a container)

Use this command to move the contents of a storage pool container to another container if a storage pool directory is removed or if a container is damaged. You can also use the command to consolidate data and reclaim space. You can issue this command for directory containers and cloud containers.

If the data in a storage pool is fragmented, the command consolidates the data:
  • For a directory-container storage pool, the command potentially reduces the number of containers.
  • For a cloud-container storage pool, the command consolidates the data into a smaller container.
In addition, for directory-container storage pools, you can use this command to move the contents of a storage pool container under these conditions:
  • When you upgrade hardware
  • If I/O errors occur on a disk

Privilege class

To issue this command, you must have restricted storage privilege.

Syntax

Read syntax diagramSkip visual syntax diagram MOVe CONTainer container_name DEFRag=YesDEFRag=YesNoSTGPOOLDIRectory=directory_nameWait=YesWait=YesNo

Parameters

container_name (Required)
Specifies the name of the container to move. You must specify the full path name of the container.
DEFRag
Specifies whether the contents of the container are consolidated into existing containers during a MOVE CONTAINER operation. This parameter is optional.

The following values are possible:

Yes
This is the default value. The container contents are moved in the following way:
  • For a container in a directory-container storage pool, the contents are moved into one or more existing containers. If the existing containers have insufficient space, a container is created and any remaining data is allocated to the new container.
  • For a container in a cloud-container storage pool, the contents are moved into a single new cloud container.
Restriction: During data ingestion, backup, or delete operations, do not issue the MOVE CONTAINER command with the DEFRAG=YES setting.
No
The contents are moved into a newly created container.
Restriction: If you are issuing the MOVE CONTAINER command for a cloud container, you cannot specify the DEFRAG=NO setting.

In some cases, especially if you encrypt data, you might have to create additional containers and allocate the data to the new containers to ensure sufficient space. For instructions, see technote 7050411 (https://www.ibm.com/support/docview.wss?uid=swg27050411).

STGPOOLDIRectory
Specifies the name of the storage pool directory to which the container is moved. This parameter is optional.

If you specify a storage pool directory, it must be in the same storage pool as the original container. The storage pool directory is used for the new container. If you don't specify a storage pool directory, the IBM Spectrum® Protect server selects a storage pool directory from the same storage pool.

Restriction: If you are issuing the MOVE CONTAINER command for a cloud container, do not specify the STGPOOLDIRECTORY parameter.
Wait
Specifies whether to wait for the IBM Spectrum Protect server to process this command in the foreground. This parameter is optional. You can specify one of the following values:
No
The server processes this command in the background and you can continue with other tasks while the command is processing. Messages that are related to the background process are shown either in the activity log file or the server console, depending on where the messages are logged. This is the default.
Yes
The server processes this command in the foreground. The operation must complete processing before you can continue with other tasks. Messages are shown either in the activity log file or the server console, or both, depending on where the messages are logged.
Restriction: You cannot specify the WAIT=YES parameter from the server console.

Example: Move a container in a directory-container storage pool

Linux operating systemsAIX operating systemsMove a container, 0000000000000001.dcf, from the /data1/storage/dir1 storage pool directory to the /data/storage/dir2 storage pool directory.
move container /data1/storage/dir1/00/0000000000000001.dcf 
stgpooldir=/data/storage/dir2
Windows operating systemsMove a container, 0000000000000001.dcf, from the e:\data1\storage\dir1 storage pool directory to the e:\data\storage\dir2 storage pool directory.
move container e:\data1\storage\dir1\00\0000000000000001.dcf 
stgpooldir=e:\data\storage\dir2
Table 1. Commands related to MOVE CONTAINER
Command Description
AUDIT CONTAINER commands Audit directory-container or cloud-container storage pools.
QUERY CONTAINER Displays information about a container.