Show cartridge
tcmgr cartridge show – show detailed information about the given tape cartridge including capacity metrics
SYNOPSIS
tcmgr cartridge show [VOLSER|-]
DESCRIPTION
Show detailed
information about the given tape cartridge within the IBM Deep Archive system.OPTIONS
-h, --help
Display this help and exit.
PARAMETERS
VOLSER
The volume serial number (VOLSER) on the tape cartridge barcode label.
EXAMPLES
This example shows
information for a tape cartridge in the IBM Deep Archive system.$ tcmgr cartridge show F31356L9
Date/Time: December 02, 2024, 04:52:46 PM -07:00; IBM Deep Archive Version: 1.1.0
VOLSER F31356L9
Library 1
State appendable
Location slot
Type LTO 9
Format LTO 9
Capacity 16,344.71 GiB
Used capacity 0.02 GiB
ATTRIBUTES
The description of the attributes for tcmgr cartridge show command are as follows:
Attribute | Explanation |
---|---|
VOLSER | The volume serial number (VOLSER) on the tape cartridge barcode label. |
Library | The unique ID of the tape library the tape cartridge is installed in. |
State | The health status of the tape cartridge. |
Location | The current location of the tape cartridge in the tape library. It is one of slot, drive, ioslot, or robot. |
Type | A description of the type of tape cartridge in question. |
Format | The format of the tape cartridge media which determines its data density and thus its native capacity. |
Capacity | The capacity of the tape cartridge in gibibytes (GiB) to two decimal places. |
Used capacity | The used capacity of the tape cartridge in gibibytes (GiB) to two decimal places. |
The definition of the cartridge state information is as follows:
Cartridge state | Explanation |
---|---|
unassigned | The cartridge is not in use by the TapeCloud nodes yet. Cartridges are assigned and put in the appendable state automatically when more writable capacity is needed. (DISABLED/GRAY) |
appendable | The cartridges is in use but still contains free space. Cartridges in this state are used for reading and writing. (OK/GREEN) |
data_full | The cartridge no free capacity remaining. Cartridges in this state are used only for recall. (OK/GREEN) |
full | The cartridge has no free space for data and metadata. Cartridges in this state are used only for recall. (WARN/YELLOW) |
recall_only | The tape cartridge is write-protected physically or logically. Cartridges in this state are used only for recall. (OK/GREEN) |
needs_replace | One or more permanent read errors were detected on this cartridge. See tcmgr cartridge replace command for more details on replacing cartridges. (WARN/YELLOW) |
require_replace | One or more permanent write errors were detected on this cartridge. See tcmgr cartridge replace command for more details on replacing cartridges. (ERROR/RED) |
dispose_ready | The cartridge is ready for replacement and disposal. This state represents a cartridge that was in "need_replace" or "require_replace" that had been successfully removed from pools with tcmgr cartridge replace command. (WARN/YELLOW) |
check_library | One or more tape drive mount errors were detected for this cartridge. After ensuring the library is working correctly, recover the cartridge from this state by using tcmgr cartridge validate command. (WARN/YELLOW) |
require_validate | Metadata mismatches detected on the cartridge. Recover the cartridge from this state by using tcmgr cartridge validate command. (WARN/YELLOW) |
check_node | The TapeCloud node that manages this tape cartridge is down. Check the node states with tcmgr node list command and make the nodes available with tcmgr node resume command. (WARN/YELLOW) |
check_key_server | The tape library detected a key server error. All encrypted cartridges on this library encrypted using keys from the key server will be in this state. After the issue with the key server is resolved using the Library GUI, recover the cartridge from this state with tcmgr cartridge validate command. (ERROR/RED) |
inaccessible | The tape library reports the cartridge is not accessible by the robotic accessor. Resolve the issue with the Library GUI and recover the cartridge with tcmgr library rescan command. (ERROR/RED) |
duplicate | There is another cartridge that has the same barcode label as this one in the tape library. Remove one of the duplicated cartridges and run the tcmgr library rescan command. The cartridge is not accessible until this is resolved. (ERROR/RED) |
missing | The cartridge was expected in the tape library but was not found. Insert the cartridge in the library and then run tcmgr library inventory command. (ERROR/RED) |
label_mismatch | A physical barcode label on the cartridge and an internal label written to the cartridge don't match. Contact IBM for support. (ERROR/RED) |
need_unlock | The system is processing a permanent write error for this cartridge. This state is automatically resolved once the issue has been resolved internally. (ERROR/RED) |
check_hba | One or more eErrors related to the HBA were detected for this cartridge. Contact IBM for support. (ERROR/RED) |
non_supported | The cartridge does not support the LTFS format. Contact IBM for support. (ERROR/RED) |
unformatted | The cartridge is online and assigned but is not formatted as LTFS. Contact IBM for support. (ERROR/RED) |
append_fenced | The cartridges contains free space, but did not match the media-restriction type and the format type. Cartridges in this state are used only for recall. Contact IBM for support. (ERROR/RED) |
exported | The cartridge was manually exported from the library without using tcmgr cartridge replace command. This may be done as part of service actions. Contact IBM for support. (ERROR/RED) |
offline | The cartridge was manually put into an offline state, so the data on the cartridge cannot be accessed. This may be done as part of service actions. Contact IBM for support. (ERROR/RED) |