storage retire command

The storage retire command retires a storage bucket variant that is no longer needed. After a variant is retired, data objects in the variant can still be retrieved or deleted, but new data objects cannot be created.

Usage notes

If the storage file system is unavailable, and you still want to retire the variant, use the advanced option (-a) with the command. At the Suppress Creation of Marker File? prompt, enter y to retire the variant when the storage file system is unavailable.

Environment

  • Windows Server 2008
  • Linux®

Authorization

Administrative user

Syntax

./storageConfigurator.sh -retire

Examples

Example: Retiring a variant
This command retires the my_bucket variant.
./storageConfigurator.sh -retire


Inspecting configuration.  Might take a minute...
Choose storage bucket name:

 0. my_bucket

Enter selection number: 0
Choose Service Name:

*0. 1st_provisioned_var00

Enter selection number: 0
You have chosen the variant my_bucket_var00
Do you wish to retire the selected variant? [y|n]: y


Sending request. This might take a minute.....
Activity complete.
Example: Retiring a variant when the storage file system is unavailable
This command retires the my_bucket variant. The -a parameter brings up the prompt Suppress Creation of Marker File?. The entry of y at the prompt Suppress Creation of Marker File? enables you to retire the variant when the storage file system is unavailable.
./storageConfigurator.sh -retire -a

Suppress Creation of Marker File? [y|n] (n): y

Inspecting configuration.  Might take a minute...
Choose storage bucket name:

 0. my_bucket

Enter selection number: 0
Choose Service Name:

*0. my_bucket_var00

Enter selection number: 0
You have chosen the variant my_bucket_var00
Do you wish to retire the selected variant? [y|n]: y


Sending request. This might take a minute.....
Activity complete.