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.

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

Privilege class

To issue this command, you must have system privilege.

Syntax


>>-REPAir STGPool--pool_name------------------------------------>

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

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

   .-TRANSFERMethod--=--Tcpip---------.   
>--+----------------------------------+------------------------><
   |                              (1) |   
   '-TRANSFERMethod--=--+-Tcpip-+-----'   
                        '-Fasp--'

Notes:

The TRANSFERMETHOD parameter is available only on Linux x86_64 operating systems.

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.

TRANSFERMethod

Specifies the method that is used for server-to-server data transfer. This parameter is optional. You can specify one of the following values:

Tcpip

Specifies that TCP/IP is used to transfer data. This value is the default.

Fasp

Specifies that Aspera® Fast Adaptive Secure Protocol (FASP®) technology is used to transfer data. Aspera FASP technology can help you optimize data transfer in a wide area network (WAN). If you specify TRANSFERMETHOD=FASP, you override any TRANSFERMETHOD parameters that you specified on the DEFINE SERVER or UPDATE SERVER commands.

Restrictions:

Before you enable Aspera FASP technology, determine whether the technology is appropriate for your system environment and install the appropriate licenses. For instructions, see Determining whether Aspera FASP technology can optimize data transfer in your system environment. If the licenses are missing or expired, operations to protect storage pools fail.
If WAN performance meets your business needs, do not enable Aspera FASP technology.

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 (directory-container)	Define 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.