Adding an object container can be accomplished through the QoreStor UI or via the object_container command in the QoreStor CLI. Refer to the QoreStor Command Line Reference Guide for more information on the object_container command.

NOTE: QoreStor object container does not support object lifecycle management, which means transitioning storage classes or server side expiration of objects is not supported.

To create an object container

1. In the navigation menu, click Containers.
2. On the Containers pane, click Add Container. The Add Container dialog will be displayed.
3. In the Protocol field, select Object (S3 Compatible). The Name and Storage Group are populated by default.
4. Click Next.
5. 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: Refer to Configuring and Using Encryption at Rest for more information about encryption.

6. 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.
7. Optionally, select Use HTTP instead of HTTPS. To use an HTTP connection, you must also follow the steps below:

   1. On the QoreStor server, copy the aws.conf file to a new location:

      cp /etc/oca/aws.conf.oca /etc/oca/aws.conf

   2. Open the aws.conf file and update the endpoint connection protocol to http:

      vi /etc/oca/aws.conf

      Find the line containing AWS_ENDPOINT_PROTOCOL and set the value to http .

8. NOTE: The QoreStor implementation of object storage uses a self-signed certificate. If your data management application requires third party certificates, you must use HTTP to connect to the object container.

9. Click Next.
10. Review the summary and click Finish.

When the process is completed and the object container has been added to QoreStor, you will see the storage group ObjectContainer and the container ObjectStorageGroup added to the Storage Groups and Container pages, respectively.  See the topics below for information on working with object storage.

• Creating a bucket
• Setting user policy
• Editing an Object Tier

Adding an object container through the command line

To add an object container, complete the following steps.

2. Access the QoreStor CLI. Refer to Using the QoreStor command line for more information.
2. Add an object tier using the command

   object_container --add [--quota <Quota value in GiB or TiB][--use_http <yes|no>]

   Refer to the QoreStor Command LIne Reference Guide for more information.

3. To apply encryption to the data in this object tier, use the command:

   object_container --encryption [--set <ON | OFF>] [--mode <static|internal> <--interval <7 days to 70 years>]

   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.

   NOTE: When QoreStor is installed in Object direct mode, only Static encryption is supported.

   For more information, refer to the QoreStor Command Line Reference Guide.

4. After creating an object container, you must configure user access for the container. By default, the backup_user account is configured with the object role and read/write access. To set the user policy for additional user accounts, use the command:

   object_container --policy [--set] [--policy_type <readonly|readwrite|none>] --name <user name> [--show] --name <user name>

   IMPORTANT: The backup_user and password are to be used as access key and secret key respectively when connecting to QoreStor from the S3 clients. The default values are: Access key: backup_user Secret key: St0r@ge! To see the S3 endpoint, use the command object_container CLI /opt/qorestor/bin/object_container --show --endpoint The endpoint is displayed in the format https://<QoreStor IP address>:9000 Make sure port 9000 is allowed for access through the firewall.