volume object-store tiering show


Display Tiering Status of FabricPool Volumes

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


The volume object-store tiering show command displays information about the tiering scanner status of FabricPool aggregate volumes. The tiering scanner will, depending on the combination of the tiering-policy and cloud-retrieval-policy settings, both retrieve from and tier to the capacity tier. This show command can be used to display the status of the scanner, whether it has aborted, what errors it has encountered and when it will be scheduled to run again.


{ [-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.

[-vserver <vserver name>] - Vserver

vserver name

[-volume <volume name>] - Volume

volume name

[-node <nodename>] - Node Name

node name

[-vol-dsid <integer>] - Volume DSID

volume dsid

[-aggregate <aggregate name>] - Aggregate Name

aggregate name

[-scanner-state {ready|active|waiting}] - State

The state of the scanner. The values active, ready and waiting may appear in this field. Active means the scanner is currently running, waiting means the scanner is waiting to be scheduled, and ready means the scanner is ready to run. Once a scanner is ready to run, it must be scheduled by the system’s scan scheduler, the amount of time it takes for it to become active is variable and depends on how busy the system is..

[-scanner-last-status {aborted-nospace-promote|aborted-fabricpool|aborted-nospace-defrag|abortted-nospace|aborted-exception|aborted-policy|aborted|completed|prev-not-run|aborted-defrag-throttled}] - Previous Run Status

The status of the tiering scanner the last time it ran. This field will indicate if the scanner has aborted or completed.

[-scanner-abort-exception <integer>] - Aborted Exception Status

If the scanner last status indicates the scanner aborted with an exception then this field is set to the exception error code that caused the abort.

[-time-last-scan <Date>] - Time Scanner Last Finished

This field displays the date and time the last scanner status field was set.

[-scan-percent <percent>] - Scanner Percent Complete

This field displays the completion percentage of scans in the active state.

[-time-next-scan <Date>] - Time Waiting Scan will be scheduled

This field displays the date and time scans in the waiting state will enter the ready state.

[-tiering-policy {snapshot-only|auto|none|all}] - Tiering Policy

The tiering policy. This field displays the currnet tiering-policy in effect on the volume.

[-promotion-space-needed {<integer>[KB|MB|GB|TB|PB]}] - Estimated Space Needed for Promotion

If the scanner aborted due to no space for promote, then this field is set to the estimated minimum space required for promotion to take effect.

[-scan-start-time <Date>] - Time Scan Started

This field displays the date and time the scan, if in active state, started.

[-cloud-retrieval-policy {default|on-read|never|promote}] - Cloud Retrieval Policy

The cloud retrieval policy. This field displays the current cloud-retrieval-policy in effect on the volume.

[-scan-elapsed-time <[<integer>h][<integer>m][<integer>s]>] - Elapsed Time Scanner Ran

This field displays the time it took for the last scan to run to complete or abort.


cluster1::> volume object-store tiering show
Vserver Volume Aggregate State   %Complete  Tiering   CloudRetrieve LastStatus
------- ------ --------- -------- --------- --------- ------------- ----------
vs1     vol    aggr1     waiting          - snapshot-only
                                                      default       completed

Shows the tiering status for all FabricPool volumes.