DEFINE STGPOOL (Define a cloud-container storage pool)
Use this command to define a container storage pool in a cloud environment. This type of storage pool is used for data deduplication. Cloud-container storage pools are not supported on Linux® on System z®.
Tip: To help optimize backup and archive performance, set up one or more local storage
directories to temporarily hold data that IBM Spectrum Protect is transferring to the cloud. After you use the
DEFINE STGPOOL command to define a cloud-container storage pool, use the
DEFINE STGPOOLDIRECTORY command to assign local storage directories to the
cloud-container storage pool.
Privilege class
To issue this command, you must have system privilege.
Syntax
Notes:
- 1 If you specify CLOUDTYPE=AZURE or CLOUDTYPE=GOOGLE, do not specify the IDENTITY parameter.
- 2 If you specify CLOUDTYPE=GOOGLE, do not specify the PASSWORD parameter.
- 3 The KEYLOCATION parameter is valid only if you specify CLOUDTYPE=GOOGLE.
- 4 The BUCKETNAME parameter is valid only if you specify CLOUDTYPE=S3 or CLOUDTYPE=GOOGLE.
- 5 The default value of the ENCRYPT parameter is conditional. The server encrypts data by default if the CLOUDLOCATION parameter is set to OFFPREMISE. If the CLOUDLOCATION parameter is set to ONPREMISE, the default is NO.
- 6 If you specify CLOUDTYPE=AZURE, do not specify the CLOUDSTORAGECLASS parameter.
Parameters
- pool_name (Required)
- Specifies the cloud-container storage pool to define. This parameter is required. The maximum length of the name is 30 characters.
- STGType=CLoud (Required)
- Specifies the type of storage that you want to define for a cloud-container storage pool. To ensure that the storage pool can be used in a cloud environment, you must specify STGTYPE=CLOUD.
- POoltype=PRimary
- Specifies that you want to define a primary storage pool. This parameter is optional.
- DESCription
- Specifies a description of the cloud-container storage pool. This parameter is optional. The maximum length of the description is 255 characters. Enclose the description in quotation marks if it contains blank characters.
- CLOUDType
- Specifies the type of cloud environment for the storage pool.
- CLOUDUrl
- Specifies the URL of the cloud environment. Based on your cloud provider, you can use a blob service endpoint, region endpoint URL, an Accesser® IP address, a public authentication endpoint, or a similar value for this parameter. Be sure to include the protocol, such as https:// or http://, at the beginning of the URL. The maximum length of the web address is 870 characters. The CLOUDURL parameter is not validated until the first backup operation begins.
- IDentity
- Specifies the user ID for the cloud provider. The IDENTITY parameter is required for all supported cloud computing systems except Azure and Google. If you specified CLOUDTYPE=AZURE or CLOUDTYPE=GOOGLE, do not specify the IDENTITY parameter. Based on your cloud provider, you can use an access key ID, a user name, a tenant name and user name, or a similar value for this parameter. The maximum length of the user ID is 255 characters.
- PAssword
- Specifies the password for the cloud that is specified in the STGTYPE=CLOUD parameter. Based on your cloud provider, you can use a shared access signature (SAS) token, secret access key, an API key, a password, or a similar value for this parameter. If you specified CLOUDTYPE=GOOGLE, do not specify the PASSWORD parameter. This parameter is required for other cloud types. The maximum length of the password is 256 characters. The IDENTITY and PASSWORD parameters are not validated until the first backup operation begins.
- CLOUDLocation
- Specifies the physical location of the cloud that is specified in the CLOUD
parameter. This parameter is optional. The default value is OFFPREMISE. You can
specify one of the following values:
- OFfpremise
- ONpremise
- KEYLocation
- Specifies the name of the file that contains the Google Cloud Storage service account key in JavaScript Object Notation (JSON) format. This parameter is required and is valid only if you specify CLOUDTYPE=GOOGLE.
- BUCKETName
- Specifies the name of an AWS S3 or Google Cloud Storage bucket, or an IBM Cloud Object Storage vault to use with this storage pool, instead of using the default bucket name or vault name. This parameter is required and is valid only if you specify CLOUDTYPE=S3 or CLOUDTYPE=GOOGLE.
- ACCess
- Specifies how client nodes and server processes access the cloud-container storage pool. This
parameter is optional. The default value is READWRITE. You can specify one of the
following values:
- READWrite
- Specifies that client nodes and server processes can read and write to the cloud-container storage pool. This value is the default.
- READOnly
- Specifies that client nodes and server processes can only read from the cloud-container storage pool.
- UNAVailable
- Specifies that client nodes and server processes cannot access the cloud-container storage pool.
- MAXWriters
- Specifies the maximum number of writing sessions that can run concurrently on the
cloud-container storage pool. By limiting the number of writing sessions, you can help to ensure
that write operations do not negatively impact other system resources and system performance. This
parameter is optional. The default value is NOLIMIT. You can specify one of the
following values:
- NOLimit
- Specifies that no limit exists for the number of writers that you can use. This value is the default.
- maximum_writers
- Limits the maximum number of writers that you can use. Specify an integer in the range 1 - 99999.
- REUsedelay
- Specifies the number of days that must elapse after all deduplicated extents are removed from a
cloud-container storage pool. This parameter controls the duration that deduplicated extents are
associated with a cloud-container storage pool. When the value that is specified for the parameter
expires, the deduplicated extents are deleted from the cloud-container storage pool. The default is
1. You can specify one of the following values:
- 1
- Specifies that deduplicated extents are deleted from a cloud-container storage pool after one day. This value is the default.
- days
- You can specify an integer in the range 0 - 9999.
Tip: Set this parameter to a value that is greater than the number specified for the SET DRMDBBACKUPEXPIREDAYS command. By setting this parameter to a higher value, the references to files in the cloud-container storage pool are still valid when you restore the database to an earlier level. - ENCRypt
- Specifies whether the server encrypts client data before it writes it to the storage pool. You
can specify the following values:
- Yes
- Specifies that client data is encrypted by the server by using 256-bit Advanced Encryption Standard (AES) data encryption.
- No
- Specifies that client data is not encrypted by the server.
This parameter is optional. The default depends on the physical location of the cloud, which is specified by the CLOUDLOCATION parameter. If the cloud is off premise, the server encrypts data by default. If the cloud is on premises, the server does not encrypt data by default.
- COMPRession
- Specifies whether data is compressed in the storage pool. This parameter is optional. You can
specify one of the following values:
- No
- Specifies that data is not compressed in the storage pool.
- Yes
- Specifies that data is compressed in the storage pool. This value is the default.
- CLOUDSTORAGEClass
- Specifies the type of Amazon Simple Storage Service (Amazon S3) or Google Cloud Storage storage
class that you are configuring for the storage pool. This parameter is valid only if you specify
CLOUDTYPE=S3 or CLOUDTYPE=GOOGLE. This parameter is
optional. You can specify the following values, based on your cloud provider:
- Default
- Specifies that data that is uploaded to Amazon S3 storage is sent to the S3 Standard storage class. Data that is uploaded to Google Cloud Storage is sent to the Standard storage class.
- AUTOmaticvendortiering
- Specifies that data that is uploaded to Amazon S3 storage is sent to the S3 Intelligent-Tiering storage class.
- NEARLINE
- Specifies that data that is uploaded to Google Cloud Storage is sent to the Nearline storage class.
Example 1: Define an OpenStack Swift cloud-container storage pool
Define an OpenStack Swift cloud-container storage pool that is named STGPOOL1.define stgpool stgpool1 stgtype=cloud
cloudtype=swift cloudurl=http://123.234.123.234:5000/v2.0
identity=admin:admin password=protect8991 description="OpenStack Swift cloud"
Example 2: Define a cloud-container primary storage pool
Define a cloud-container primary storage pool that is named STGPOOL1.define stgpool stgpool1 stgtype=cloud
cloudtype=swift cloudurl=http://123.234.123.234:5000/v2.0
identity=admin:admin password=protect8991 pooltype=primary
Example 3: Define a cloud-container storage pool with read-only access
Define a cloud-container storage pool that is named STGPOOL1 with read-only access.define stgpool stgpool1 stgtype=cloud
cloudtype=swift cloudurl=http://123.234.123.234:5000/v2.0
identity=admin:admin password=protect8991 access=readonly
Example 4: Define a cloud-container storage pool with 99 writing sessions
Define a cloud-container storage pool that is named STGPOOL1 with 99 writing sessions.define stgpool stgpool1 stgtype=cloud
cloudtype=swift cloudurl=http://123.234.123.234:5000/v2.0
identity=admin:admin password=protect8991 maxwr=99
Example 5: Define a cloud-container storage pool in which deduplicated extents are deleted after two days
Define a cloud-container storage pool that is named STGPOOL1 and deduplicated extents are deleted after two days.define stgpool stgpool1 stgtype=cloud
cloudtype=swift cloudurl=http://123.234.123.234:5000/v2.0
identity=admin:admin password=protect8991 reusedelay=2
Command | Description |
---|---|
UPDATE STGPOOL (cloud-container) | Update a cloud-container storage pool. |