Skip to main content

autobalance aggregate show-aggregate-state

Contributors
Suggest changes
PDFs

Display the Auto Balance Aggregate state for an aggregate

Availability: This command is available to cluster administrators at the advanced privilege level.

Description

The autobalance aggregate show-aggregate-state command displays information about an aggregate state that is considered by the Auto Balance Aggregate feature.

Parameters

[-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] (privilege: advanced) }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-node {<nodename>|local}] - Node Name (privilege: advanced)

If this parameter is specified, the display will be limited to only those aggregates with a node that matches the specified value.

[-aggregate <aggregate name>] - Name of the Aggregate (privilege: advanced)

If this parameter is specified, the display will be limited to only that aggregate with a name that matches the specified value.

[-total-size {<integer>[KB|MB|GB|TB|PB]}] - Total Size of the Aggregate (privilege: advanced)

If this parameter is specified, the display will be limited to only those aggregates with a total-size that matches the specified value.

[-used-size {<integer>[KB|MB|GB|TB|PB]}] - Used Size of the Aggregate (privilege: advanced)

If this parameter is specified, the display will be limited to only those aggregates with a used-size that matches the specified value.

[-aggregate-unbalanced-threshold {<integer>[KB|MB|GB|TB|PB]}] - Threshold When Aggregate Is Considered Unbalanced (privilege: advanced)

If this parameter is specified, the display will be limited to only those aggregates with a threshold that matches the specified value.

[-outgoing-size {<integer>[KB|MB|GB|TB|PB]}] - Size of Outgoing Volumes in the Aggregate (privilege: advanced)

If this parameter is specified, the display will be limited to only those aggregates with an outgoing-size that matches the specified value. Outgoing size will be equal to the total size of the volumes that move away from each one of those aggregate.

[-incoming-size {<integer>[KB|MB|GB|TB|PB]}] - Size of Incoming Volumes in the Aggregate (privilege: advanced)

If this parameter is specified, the display will be limited to only those aggregates with an incoming-size that matches the specified value. Incoming size will be equal to the total size of the volumes that move towards to each one of those aggregates.

[-raidtype {raid_tec|raid_dp|raid4|raid_ep}] - RAID Type (privilege: advanced)

If this parameter is specified, the display will be limited to only those aggregates with a raidtype that matches the specified value.

[-home-cluster <UUID>] - Home Cluster ID (privilege: advanced)

If this parameter is specified, the display will be limited to only those aggregates with a home-cluster ID that matches the specified value.

[-is-hybrid {true|false}] - Aggregate Is a Hybrid (privilege: advanced)

If this parameter is specified as true, the display will be limited to only hybrid aggregates. If the parameter is specified as false, the display will be limited to only non-hybrid aggregates.

[-is-incoming-volume-thin {true|false}] - An Incoming Volume Is Thin (privilege: advanced)

When you use thin provisioning for a volume, it can run out of space even if it has not yet consumed its nominal size and you should carefully monitor space utilization to avoid unexpected errors due to the volume running out of space. If this parameter is specified as true, the display will be limited to only those aggregates which are the target of a move of thin volume. If the parameter is specified as false, the display will be limited to only those aggregates which are not the target of a move of thin volume.

[-is-balanceable {true|false}] - Is Balanceable (privilege: advanced)

If this parameter is specified as true, the display will be limited to only balanceable aggregates. If the parameter is specified as false, the display will be limited to only non-balanceable aggregates.

[-is-move-target {true|false}] - Aggregate Is a Volume Move Target (privilege: advanced)

If this parameter is specified as true, the display will be limited to only those aggregates which are target of a volume move. If the parameter is specified as false, the display will be limited to only those aggregates which are not the target of a volume move.

[-attributes <text>,…​] - Aggregate Attributes (privilege: advanced)

If this parameter is specified, the display will be limited to only those aggregates with attributes that matches the specified values.

[-aggregate-available-threshold {<integer>[KB|MB|GB|TB|PB]}] - Threshold When Aggregate Is Considered Balanced (privilege: advanced)

If this parameter is specified, the display will be limited to only those aggregates which meet the specified threshold to be considered as balanced.

Examples

The following example displays information about the state for all aggregates in the cluster.

cluster1::*> autobalance aggregate show-aggregate-state
                          Aggregate: aggr0
                         Total Size: 4.78GB
                          Used Size: 4.56GB
                      Outgoing Size: 0B
                      Incoming Size: 0B
     Aggregate Used Space Threshold: 3.34GB
Aggregate Available Space Threshold: 1.91GB
                          RAID Type: raid_dp
                    Home Cluster ID: edf0379b-16da-11e6-aa3c-0050568558c2
                         Attributes: CFO
                                     Excluded
                                     Mroot
Aggregate: aggr_1
                         Total Size: 12.61GB
                          Used Size: 111.6MB
                      Outgoing Size: 0B
                      Incoming Size: 0B
     Aggregate Used Space Threshold: 8.83GB
Aggregate Available Space Threshold: 5.04GB
                          RAID Type: raid4
                    Home Cluster ID: edf0379b-16da-11e6-aa3c-0050568558c2
                         Attributes: Excluded

The following example displays information about all entries of the aggregate state, for all aggregates in the cluster.

cluster1::*> autobalance aggregate show-aggregate-state -instance
                                        Node Name: cluster-1-01
                            Name of the Aggregate: aggr0
                      Total Size of the Aggregate: 4.78GB
                       Used Size of the Aggregate: 4.56GB
Threshold When Aggregate Is Considered Unbalanced: 3.34GB
        Size of Outgoing Volumes in the Aggregate: 0B
        Size of Incoming Volumes in the Aggregate: 0B
                                        RAID Type: raid_dp
                                  Home Cluster ID: edf0379b-16da-11e6-aa3c-0050568558c2
                            Aggregate Is a Hybrid: false
                       An Incoming Volume Is Thin: false
                                   Is Balanceable: false
                Aggregate Is a Volume Move Target: false
                             Aggregate Attributes: CFO
                                                   Excluded
                                                   Mroot
  Threshold When Aggregate Is Considered Balanced: 1.91GB
Node Name: cluster-1-01
                            Name of the Aggregate: aggr_1
                      Total Size of the Aggregate: 12.61GB
                       Used Size of the Aggregate: 111.6MB
Threshold When Aggregate Is Considered Unbalanced: 8.83GB
        Size of Outgoing Volumes in the Aggregate: 0B
        Size of Incoming Volumes in the Aggregate: 0B
                                        RAID Type: raid4
                                  Home Cluster ID: edf0379b-16da-11e6-aa3c-0050568558c2
                            Aggregate Is a Hybrid: false
                       An Incoming Volume Is Thin: false
                                   Is Balanceable: false
                Aggregate Is a Volume Move Target: false
                             Aggregate Attributes: Excluded
  Threshold When Aggregate Is Considered Balanced: 5.04GB