REPAIR STGPOOL (Repair a directory-container storage pool)

Use this command to repair deduplicated extents in a directory-container storage pool. Damaged deduplicated extents are repaired with extents that are backed up to the target replication server or to container-copy storage pools on the same server.

Restrictions:

You can issue the REPAIR STGPOOL command only if you already issued the PROTECT STGPOOL command to back up data to another storage pool on a replication target server or on the same server.
When you repair a directory-container storage pool from the replication server, the REPAIR STGPOOL command fails when any of the following conditions occur:
- The target server is unavailable.
- The target storage pool is damaged.
- A network outage occurs.
When you repair a directory-container storage pool from container-copy pools, the REPAIR STGPOOL command fails when any of the following conditions occur:
- The container-copy storage pool is unavailable.
- The container-copy storage pool is damaged.

Privilege class

To issue this command, you must have system privilege.

Syntax when the source is the replication server


                              .-SRCLOCation--=--Replserver-.   
>>-REPAir STGPool--pool_name--+----------------------------+---->
                              '-SRCLOCation--=--Replserver-'   

   .-MAXSESSions--=--1-------------------.   
>--+-------------------------------------+---------------------->
   '-MAXSESSions--=----number_sessions---'   

   .-Preview--=--No------.  .-Wait--=--No------.   
>--+---------------------+--+------------------+---------------><
   '-Preview--=--+-No--+-'  '-Wait--=--+-No--+-'   
                 '-Yes-'               '-Yes-'

Syntax when the source is a storage pool on the same server


>>-REPAir STGPool--pool_name--SRCLOCation--=--Local------------->

   .-Preview--=--No------.  .-Wait--=--No------.   
>--+---------------------+--+------------------+---------------><
   '-Preview--=--+-No--+-'  '-Wait--=--+-No--+-'   
                 '-Yes-'               '-Yes-'

Parameters

pool_name (Required)

Specifies the name of the directory-container storage pool that contains the data that must be repaired.

SRCLOCation

Specifies the source location that is used to repair the data. The default value is REPLSERVER. This parameter is only required when the source location is on the same server. You can specify one of the following values:

Local: Specifies that the data is repaired from container-copy storage pools on the same server.
Replserver: Specifies that the data is repaired from a directory-container storage pool on the target replication server.

MAXSESSions

Specifies the maximum number of data sessions that can send data to a target server. This parameter is optional when you repair data from a replication server.

The value that you specify can be in the range 1 - 20. The default value is 1. If you increase the number of sessions, you can repair the storage pool faster.

When you set a value for the MAXSESSIONS parameter, ensure that the available bandwidth and the processor capacity of the source and target servers are sufficient.

Tips:

If you issue a QUERY SESSION command, the total number of sessions might exceed the number of data sessions.
The number of sessions that are used to repair storage pools depends on the amount of data that is repaired. If you repair only a small amount of data, there is no benefit to increasing the number of sessions.

Preview

Specifies whether to preview data or to repair the data. This parameter is optional. The default value is NO. You can specify one of the following values:

No: Specifies that the data is repaired to the storage pool but the data is not previewed.
Yes: Specifies that the data is previewed but not repaired.

Wait

Specifies whether to wait for the server to complete the repair processing of the storage pool. This parameter is optional. The default value is NO. You can specify this parameter only from an administrative command line. You can specify one of the following values:

No: Specifies that the command processes run in the background. To monitor the background processing of the REPAIR STGPOOL command, issue the QUERY PROCESS command.
Yes: Specifies that the command processes run in the foreground. Messages are not displayed until the command completes processing.

Example: Repair a storage pool and preview the data

Repair a storage pool that is named POOL1 and preview the data.

repair stgpool pool1 preview=yes

Example: Repair a storage pool and specify a maximum number of sessions

Repair a storage pool that is named POOL1 and specify 10 maximum sessions.

repair stgpool pool1 maxsessions=10

Example: Repair a storage pool from tape

Repair a storage pool that is named POOL1 and specify local for the source location.

repair stgpool pool1 SRCLOCation=local

Table 1. Commands related to REPAIR STGPOOL
Command	Description
DEFINE STGPOOL (directory-container)	Define a directory-container storage pool.
DEFINE STGPOOL (container-copy)	Define a container-copy storage pool that stores copies of data from a directory-container storage pool.
DEFINE STGPOOLDIRECTORY	Defines a storage pool directory to a directory-container or cloud-container storage pool.
PROTECT STGPOOL	Protects a directory-container storage pool.