AIX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systems

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 server.

Privilege class

To issue this command, you must have system privilege.

Restrictions:
  • You must issue the PROTECT STGPOOL command to back up data extents to the directory-container storage pool on the target server before you issue the REPAIR STGPOOL command.
  • 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

Syntax

Read syntax diagramSkip visual syntax diagram
>>-REPAir STGPool--pool_name------------------------------------>

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

   .-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.
MAXSESSions
Specifies the maximum number of data sessions that can send data to a target server. This parameter is optional. 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
Table 1. Commands related to REPAIR STGPOOL
Command Description
DEFINE STGPOOL Defines a storage pool as a named collection of server storage media.
DEFINE STGPOOLDIRECTORY Defines a storage pool directory to a directory-container storage pool.
PROTECT STGPOOL Protects a storage pool.