Skip to main content

Create an ONTAP S3 bucket on a mirrored or unmirrored aggregate in a MetroCluster configuration

Contributors netapp-aoife netapp-dbagwell netapp-lenida
PDFs

Beginning with ONTAP 9.14.1, you can provision a bucket on a mirrored or unmirrored aggregate in MetroCluster FC and IP configurations.

About this task

  • By default, buckets are provisioned on mirrored aggregates.

  • The same provisioning guidelines outlined in Create a bucket apply to creating a bucket in a MetroCluster environment.

  • The following S3 object storage features are not supported in MetroCluster environments:

    • SnapMirror S3

    • S3 bucket lifecycle management

    • S3 object lock in Compliance mode

      Note S3 object lock in Governance mode is supported.

    • Local FabricPool tiering

Before you begin

An SVM containing an S3 server must already exist.

Process to create buckets

CLI

  1. If you plan to select aggregates and FlexGroup components yourself, set the privilege level to advanced (otherwise, admin privilege level is sufficient): set -privilege advanced

  2. Create a bucket:

    vserver object-store-server bucket create -vserver <svm_name> -bucket <bucket_name> [-size integer[KB|MB|GB|TB|PB]] [-use-mirrored-aggregates true/false]

    Set the -use-mirrored-aggregates option to true or false depending on whether you want to use a mirrored or unmirrored aggregate.

    Note By default, the -use-mirrored-aggregates option is set to true.

    • The SVM name must be a data SVM.

    • If you specify no options, ONTAP creates an 800GB bucket with the service level set to the highest level available for your system.

    • If you want ONTAP to create a bucket based on performance or usage, use one of the following options:

      • service level

        Include the -storage-service-level option with one of the following values: value, performance, or extreme.

      • tiering

        Include the -used-as-capacity-tier true option.

    • If you want to specify the aggregates on which to create the underlying FlexGroup volume, use the following options:

      • The -aggr-list parameter specifies the list of aggregates to be used for FlexGroup volume constituents.

        Each entry in the list creates a constituent on the specified aggregate. You can specify an aggregate multiple times to have multiple constituents created on the aggregate.

        For consistent performance across the FlexGroup volume, all of the aggregates must use the same disk type and RAID group configurations.

      • The -aggr-list-multiplier parameter specifies the number of times to iterate over the aggregates that are listed with the -aggr-list parameter when creating a FlexGroup volume.

        The default value of the -aggr-list-multiplier parameter is 4.

  3. Add a QoS policy group if needed:

    vserver object-store-server bucket modify -bucket bucket_name -qos-policy-group qos_policy_group

  4. Verify bucket creation:

    vserver object-store-server bucket show [-instance]

Example

The following example creates a bucket for SVM vs1 of size 1TB on a mirrored aggregate:

cluster-1::*> vserver object-store-server bucket create -vserver svm1.example.com -bucket testbucket  -size 1TB -use-mirrored-aggregates true