ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • autobalance aggregate show-aggregate-state

    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 ] }

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

    [-node {<nodename>|local}] - Node Name

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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

    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
    Top of Page