Deleting a container
There are two ways you can delete a container in QoreStor: through the user interface (GUI) or through the command line interface (CLI). The following procedures assume that the containers contain data.
|
|
Caution: Before deleting a container, you should first carefully consider whether you need to preserve the data in the container. Before deleting any QoreStor container that contains important data, you should take steps to preserve this data using another means of long-term retention. Once a container is deleted, the important data cannot be retrieved. |
|
|
NOTE: When deleting a container that has Recycle Bin enabled, you cannot delete the container until Recycle Bin is empty. Be sure to delete or expire all backups from the container and wait for the files to expire from Recycle Bin. When Recycle Bin is empty and the container has no more files, delete the container. |
Deleting a container through the GUI
|
|
NOTE: When there are files in the container, deleting the container through the GUI fails. If you want to delete a container and the files within it, use the Command Line Interface. |
|
|
NOTE: In case a container has an immute file or locked file in the cloud, deleting the container is not allowed. The stat can be updated by executing the following command with the respective options and the delete operation can be retried.
container --update --name <container name>
[--immutable_file_stat]
[--locked_file_stat] |
To delete a container through the GUI
- On the navigation menu, click Storage Groups. Select the storage group that contains the container you want to delete. (If you are only using the DefaultGroup storage group you do not need to select a group.)
- In the list of containers, select the container you want to delete, and then click the Delete icon.
- In the Warning dialog box, click Yes to confirm the deletion.
Deleting a container through the command line
To delete a container through the command line
-
- Access the QoreStor CLI. Refer to Accessing the CLI commands for more information.
- Delete a container with the command
container --delete --name <name> [--delete_files]
Refer to the QoreStor Command Line Reference Guide for more information.
Managing local storage
To organize your data, you can easily create storage groups and create containers within those storage groups on your QoreStor system. A storage group allows you to create separate storage policies for different data groups and the different capacities utilized on a single QoreStor. You can also create and organize storage groups for the different organizations in your enterprise, such as Engineering, Sales, Finance, and so on.
After initialization, QoreStor contains a single default storage group, named DefaultGroup.
Refer to these important notes about storage groups.
- Only administrator users can create storage groups.
- Data/containers cannot be moved between storage groups.
- Deduplication is defined at the storage group level and is not global to the appliance.
- Encryption is defined separately for each storage group.
- Compression is defined separately for each storage group.
- The system cleaner cannot be run on a single storage group; only at the system level.
- Before you can delete a storage group, you must delete all containers contained in that storage group.
- A filesystem scan can be run on a single storage group.
To view the Storage Groups page, on the left navigation menu, click Local Storage > Storage Groups in the QoreStor navigation pane.
|
|
NOTE: This section refers to using QoreStor with local storage. Please see Managing cloud storage for information on cloud and archive tiers as well as object storage. |
Viewing storage group information
In the QoreStor GUI you can easily view all of your storage groups on the Storage Groups page.
To view storage groups, complete the following steps.
- In the navigation menu, click Local Storage to expand the menu, then click Storage Groups.
- On the Storage Groups page you can view the following columns of information about your storage groups.
- Name—Displays the name of the Storage Group.
- Encryption—Displays whether Encryption is turned On or Off.
- Compression—Displays the compression type as either Fast or Best.
- Containers—Displays the number of containers in this storage group. You can click this number, which links to the Containers page for the storage group.
- In the list of storage groups, find the storage group for which you want to view statistics, and then click the
(ellipsis icon) in the upper-right corner of the information pane.
- Click Details. A page for the selected storage group is displayed, showing the following:
- Summary— Provides summary data for the storage group, including:
- Name
- Compression Mode
- Number of Containers
- Encryption status
- Storage group metadata
- Record Cleaner—
- Throughput—Displays the number of read data in Mebibytes/per second (MiB/s) based on time (in minutes), and the number of write data in MiB/s based on time (in minutes)
- Statistics—Lists the following statistics for the storage group.
- Cleaner Status
- Total Inodes
- Current Files
- Current Bytes
- Decrypted Bytes
- Post Compression Bytes
- Post Dedupe Bytes
- Post Encryption Bytes
- Compression Savings
- Dedupe Savings
- Total Savings
- Processed Cleaner—
- Log Cleaner—
Adding a storage group
You can add a storage group to QoreStor through either the QoreStor GUI or the command line interface. In both cases, when creating a storage group you define the name and compression level.
Adding a storage group through the GUI
To add a storage group, complete the following steps.
- In the navigation menu, click Local Storage to expand the menu, then click Storage Groups.
- Click Add Storage Group. The Add a Storage Group pane is displayed.
- In the Name field, enter a name for the storage group.
- Select a Compression Type from the drop-down list:
- Fast — Results in shorter backup time, but with less space savings.
- Best — Provides the highest space savings, but with a longer backup time.
- Optionally, configure a Quota by entering an amount and setting the unit (GiB or TiB). If no value is set, the quota will be unlimited.
|
|
NOTE: Quotas define the limit for limit for physical capacity usage. Once reached, data ingests are not allowed until space is recovered through savepoint expiration and cleaner operations. |
- To apply encryption, select Encryption and enter the following:
- Passphrase — the passphrase is user-defined and is used to generate a passphrase key that encrypts the file in which the content encryption keys are kept. The passphrase is a human readable key, which can be up to 255 bytes in length. It is mandatory to define a passphrase to enable encryption.
|
|
NOTE: It is mandatory to define a passphrase to enable encryption. If the passphrase is compromised or lost, the administrator should change it immediately so that the content encryption keys do not become vulnerable. |
- Confirm Passphrase — re-enter the passphrase used above.
- Encryption Mode — Select either static or internal.
- static - A global mode of key management in which a fixed key is used to encrypt all data.
- internal - A mode of key lifecycle management in which the keys are periodically generated and rotated. The minimum key rotation period before the content encryption key can be rotated and a new key is generated is 7 days. This rotation period is user-configurable and can be specified in days.
|
|
NOTE: Due to export regulations, the encryption at rest feature is not available in certain markets, and, therefore, may not be available in your locale. For more information about recommended guidelines for encryption, see Understanding Encryption at Rest |
|
|
NOTE: After encryption is enabled, all of the data that is backed up is encrypted and is kept encrypted until it is expired and cleaned by the system cleaner. Note that encryption is an irreversible process. |
- Click Add
Adding a storage group through the command line
To add a storage group, complete the following steps.
- Access the QoreStor CLI. Refer to Accessing the CLI commands for more information.
- Add a new storage group using the command
storage_group --add --name <name> [--compression_mode <fast|best>] [--quota <Quota value in GiB or TiB>]
Refer to the QoreStor Command LIne Reference Guide for more information
- To apply encryption to the data in this storage group, use the command:
storage_group --encryption --name <name> [--set <ON | OFF>] [--mode <static|internal> <--interval <7 days to 70 years>]
For more information, refer to the Storage Group commands section of the QoreStor Command Line Reference Guide.
|
|
NOTE: Due to export regulations, the encryption at rest feature is not available in certain markets, and, therefore, may not be available in your locale. For more information about recommended guidelines for encryption, see Understanding Encryption at Rest |
|
|
NOTE: It is mandatory to define a passphrase to enable encryption. If the passphrase is compromised or lost, the administrator should change it immediately so that the content encryption keys do not become vulnerable. |
|
|
NOTE: After encryption is enabled, all of the data that is backed up is encrypted and is kept encrypted until it is expired and cleaned by the system cleaner. Note that encryption is an irreversible process. |
