volume object-store tiering show

Display Tiering Status of FabricPool Volumes

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

Description

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.

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.
[-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|aborted-nospace|aborted-exception|aborted-policy|aborted|completed|prev-not-run|aborted-defrag-throttled|aborted-nospace-revert-format|aborted-revert-format-paused|aborted-dual-tier-dirty-failed}] - 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.

Examples

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