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:
Table 1. Description of the attributes for tcmgr cartridge show command
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:
Table 2. Definition of the cartridge state information
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)