Skip to main content

system controller bootmedia show-percentage-used

Contributors
Suggest changes
PDFs

Show the utilization percentage of the NVMe boot media

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

Description

The system controller bootmedia show-percentage-used command displays the Boot Media Device percentage used. These commands are available for NVMe bootmedia systems. By default, the command displays the following information about the NVMe bootmedia:

  • Node

  • Display Name

  • Is NVMe

  • NVMe Percentage Used

  • NVMe Available Spare

  • NVMe Spare Threshold

To display more details, use the -instance parameter.

Parameters

{ [-fields <fieldname>,…​]

Selects the fields that you specify.

| [-instance ] }

Displays detailed information for all the boot media devices.

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

Selects the bootmedia device that is present on the specified node.

[-serial-num <text>] - Serial Number

Selects the bootmedia devices with the specified serial number.

[-vendor-id <Hex Integer>] - Vendor ID

Selects the bootmedia devices with the specified vendor ID.

[-device-id <Hex Integer>] - Device ID

Selects the bootmedia devices with the specified device ID.

[-display-name <text>] - Display Name

Selects the bootmedia devices with the specified display name.

[-unique-name <text>] - Unique Name

Selects the bootmedia device with the specified unique name.

[-monitor {node-connect|system-connect|system|controller|chassis|cluster-switch|example|ethernet-switch}] - Health Monitor Name

Selects the bootmedia devices with the specified health monitor.

[-usbmon-status {present|not-present}] - Bootmedia Health Monitor

Selects the bootmedia devices with the specified USBMON status.

[-device-state {good|warn|bad}] - Bootmedia State

Selects the bootmedia devices with the specified device state.

[-size <integer>] - Max Memory Size (MB)

Selects the bootmedia devices with the specified memory size.

[-health {ok|ok-with-suppressed|degraded|unreachable|unknown}] - Status

Selects the bootmedia devices with the specified health monitor status.

[-is-nvme {true|false}] - Is NVMe Boot Media

Selects the boot media technology. If the value is "true", the boot media uses NVMe technology.

[-nvme-percent-used <integer>] - NVMe Percentage Used

Selects the NVMe boot media with the specified percentage of rated life used by the solid-state device (SSD). When an SSD reaches 100% of rated life, it might not be able to retain data while powered off for long periods of time.

[-nvme-available-spare <integer>] - NVMe Available Spare

Selects the NVMe boot media with the specified percentage of available spare blocks. When all spare blocks are consumed on the SSD, i.e. when this parameter reaches 0%, the system can no longer write data to the solid-state device (SSD).

[-nvme-spare-threshold <integer>] - NVMe Spare Threshold

Selects the NVMe boot media with the specified "low spare blocks" threshold percentage. System health monitor alerts are generated when the available spare blocks on the SSD cross below this threshold.

Examples

The following example displays the information of the boot media devices present in all the nodes in a cluster:

cluster1::> system controller bootmedia show-percentage-used

+                                            NVMe Used   NVMe Spare  NVMe Spare
+Node          Display Name         Is NVMe Percentage   Available   Threshold
+------------- -------------------- ------- ----------- ----------- -----------
localhost
              BootMedia/              true           0         100          10
              0X331511900503A0SAM0
              00PM9A30002T00025000

The following example displays the detailed information about the boot media present in a node:

cluster1::> system controller bootmedia show-percentage-used -instance -node node1
Node: localhost
           Serial Number: S668NE0RC00442
               Vendor ID: 144d
               Device ID: a80a
            Display Name: BootMedia/0X331511900503A0SAM000PM9A30002T00025000
             Unique Name: 0X331511900503A0SAM000PM9A30002T00025000
     Health Monitor Name: controller
Bootmedia Health Monitor: present
         Bootmedia State: good
    Max Memory Size (MB): 1831420
                  Status: ok
      Is NVME Boot Media: true
    NVME Percentage Used: 0
    NVME Available Spare: 100
    NVME Spare Threshold: 10