ltfsee pool

You can use the ltfsee pool command to create or delete IBM Spectrum Archive Enterprise Edition tape storage pools. You can also show the configuration attributes of a tape pool, or set the configuration attributes for a pool. The ltfsee pool command is also used to add or remove tapes from a tape pool, or to format or repair tapes before you add them to a tape pool. The ltfsee pool command can work with tapes that have a "Write fenced" status, and are therefore read-only cartridges.

You must have root user authority to use the ltfsee pool command.

Synopsis 1

pool create -p <poolname> -l <libraryname> [-g <nodegroup>] [--worm <worm>]

The pool create option is used to create the specified IBM Spectrum Archive Enterprise Edition tape storage pool. You must always specify the tape storage pool name (-p <poolname>). With optional parameters, you can also specify thenodegroup, the library, and whether the tapes in the pool are write-once read-many (WORM).

Required parameters
-p <poolname>
The name of the tape pool to create.
-l <libraryname>
The name of the library to which the tape pool is assigned. This option can be omitted in single-library systems.
Optional parameters
-g <nodegroup>
The name of the nodegroup to which the tape pool is assigned. The nodegroup option can be omitted if only a single nodegroup is configured for the library.
--worm <worm> [physical|no]
Specifies whether the new pool is a write-once, read-many (WORM) pool, or not. Valid --worm options are physical , meaning that the pool is for physical WORM tape cartridges, or no, meaning that the pool in not for WORM cartridges. The default is no.

Synopsis 2

pool delete -p <poolname> -l <libraryname>

The pool delete option is used to delete the specified IBM Spectrum Archive Enterprise Edition tape storage pool. You must always specify the tape storage pool name (-p <poolname>). If you have more than one tape library, you must also specify the -l <libraryname>.

Required parameters
-p <poolname>
The name of the tape pool to delete.
-l <libraryname>
The name of the library to which the tape pool is assigned. This option can be omitted in single-library systems.

Synopsis 3

pool add -p <poolname> [-l <libraryname>] -t <tape_id_1> [-t <tape_id_N>] [-f | -F | -e | -c | -d | -q ] [-T <formatType>]

The pool add option is used to add one or more tapes to the specified IBM Spectrum Archive Enterprise Edition storage pool. You can run formatting or repairing options on the tape before it is added to the pool.

Required parameters
-p <poolname>
The name of the tape pool to which the tapes are to be added.
-l <libraryname>
The name of the library to which the tape pool is assigned. This option can be omitted in single-library systems.
-t <tape_id_1> [-t <tape_id_N>]
The ID of the tape to add to the pool. Multiple tapes can be added with a single command by specifying the -t option multiple times.
Optional parameters

You can specify one of the following optional parameters with the ltfsee pool add command:

Note: A JC or JK cartridge gets reformatted in fifth generation 3592 tape drive recording format by the ltfsee pool add -f command when the cartridge is used with a TS1150 drive.
-f, --format
Specify this option to format tapes before you add them to a pool.
-F, --force_format
Specify this option to format tapes before you add them to a pool. This option is required instead of the -f option if the tape is already formatted.
Important: Before you specify the ltfsee pool add command with the -F option, ensure any tapes that you want to add are empty. Otherwise, replicas might become lost.

-e, --exception_format
Specify this option to format tapes before you add them to a pool. This option is required instead of the -f or -F options if the tape contains migrated data. This option must be used when you add a tape back to a pool when the tape was previously removed by the ltfsee pool remove command with the -E option.
Important: Before you specify the ltfsee pool add command with the -e option, ensure that any migrated data on the target tapes is no longer needed, and is safe to erase.

-c, --check
Specify this option to check and repair tapes before you add them to a pool. Use the command with the -c option before you attempt to use it with the -d option.
-d, --deep_recovery
Specify this option to repair tapes that are missing an end-of-data (EOD) mark before you add them to a pool. Use the command with the -d option only after a failed attempt with the -c option.
-q, --quick
Adds a tape to a pool without first checking the tape's status, leaving the tape with a status of "Unknown." This option is primarily used with the ltfsee rebuild command, which can use a tape with an "Unknown" status.

To use a tape with an "Unknown" status for other IBM Spectrum Archive Enterprise Edition functions, you must first validate the tape as usable by running the ltfsee tape validate command.

-T <formatType>
Format the tape with the specified format type. Valid values are E07, E08, and 55F. If the tape pool is defined with a specific format type, the tape must match that format type.

Synopsis 4

pool remove -p <poolname> [-l <libraryname>] -t <tape_id_1> [-t <tape_id_N>] [-E | -r]
The pool remove option is used to remove one or more tapes from the specified IBM Spectrum Archive Enterprise Edition storage pool.
Note: If a tape is removed from a pool, you cannot recall the files that are on the tape. If you need to recall files from the tape, add the tape back into the same pool from which it was removed, without formatting the tape.
Required parameters
-p <poolname>
The name of the tape pool to which the tapes are to be removed.
-l <libraryname>
The name of the library to which the tape pool is assigned. This option can be omitted in single-library systems.
-t <tape_id_1> [-t <tape_id_N>]
The ID of the tape to remove from the pool. Multiple tapes can be removed with a single command by specifying the -t option multiple times.
Optional parameters
-E, --empty_remove

Remove the tape even if the tape is not reconciled and still contains stale file data that is already deleted in GPFS™. If the tape contains any active files whose corresponding stub files exist in GPFS, the command does not remove it. This option does not do reconciliations.

The removed tape must be formatted with the -e option when you add it back to a pool.

If many small files were migrated to a tape, and the user knows that all the files were deleted in GPFS, using the -E option and formatting the tape is faster than using the ltfsee reconcile and ltfsee reclaim commands.

This command supports all types of data that is stored on tape by IBM Spectrum Archive Enterprise Edition, including migrated files and saved objects such as empty directories and symbolic links.

-r, --force_remove
Try to remove the tape even if active files exist on the tape.

Synopsis 5

pool set -p <poolname> [-l <libraryname>] -a <attribute> -v <value>

The pool set command sets the configuration attributes of a pool.

Required parameters
-p <poolname>
The name of the pool on which to set the properties.
-l <libraryname>
The name of the library with which the pool is associated. If only a single library is configured in the system, this option can be omitted.
-a <attribute>
The attribute to set. You can set the following attributes with the pool set command:
  • poolname
  • format
  • mountlimit
  • lowspacewarningenable
  • lowspacewarningthreshold
  • nospacewarningenable
-v <value>
The values that you can assign to the attributes. The list of attributes that can be set, and their valid values are:
  • The poolname value can be up to 16 characters in length. Valid characters to use are ASCII alphanumeric characters and underscores.
  • The format attribute can be LTO5, LTO6, LTO7, LTO8, M8, E07, E08, or 55F.
  • The mountlimit value can be an integer. Use 0 (zero) for no limit. The value is used to set the maximum number of drives in a pool that can be used for migration. The number of drives in a pool that are used for migration is less than or equal to the specified mountlimit.
    Note: IBM Spectrum Archive Enterprise Edition chooses and allocates drives for migration based on the workload. Therefore, migration might use fewer drives than the maximum specified by the mountlimit value.
  • The lowspacewarningenable value can be either " true" or "false." A value of " true" means that when a low space condition is detected, an SNMP warning is sent.
  • The lowspacewarningthreshold value can be an integer. It shows the threshold value for free space in the pool, in TibiBytes (TiB), for when an SNMP trap is sent.

    If the lowspacewarningthreshold value is set to 10, for example, when IBM Spectrum Archive Enterprise Edition periodically checks the free space of the pool, and finds that the free space is less than 10 TiB, an SNMP trap such as "ibmsaWarnM609PoolLowSpace" is sent to warn of the low-space condition. If thelowspacewarningthreshold value is set to 0, IBM Spectrum Archive Enterprise Edition does not check the size of the free space in the pool.

  • The nospacewarningenable value can be either "true" or "false." A value of " true" means that when no space remains in a pool, an SNMP warning is sent.

Synopsis 6

pool show -p <poolname> [-l <libraryname>] [-a <attribute>]

The pool show command shows the configuration attributes of a tape pool.

Required parameters
-p <poolname>
The name of the pool of which to show the properties.
-l <libraryname>
The name of the library with which the pool is associated. If only a single library is configured in the system, this option can be omitted.
Optional parameter
-a <attribute>
The attribute to show. If this option is omitted, all attributes of the tape pool, as shown in the following list, are shown:
poolname
The human-readable pool name.
poolid
A unique identifier.
devtype
Device type.
format
The preferred tape format.
worm
Write-once, read-only tape format.
nodegroup
The associated nodegroup.
fillpolicy
The tape fill policy.
owner
Owner.
mountlimit
The maximum number of drives that can be used for migration. A 0 (zero) indicates no limit.

Examples

Synopsis 1 examples
ltfsee pool create -p mypool --worm no
ltfsee pool create -p mypool -g mynodegroup -l mylibrary
ltfsee pool delete -p mypool -l mylibrary
Synopsis 2 examples
ltfsee pool add -p mypool -t 327AAQL5 -t 277BAXL5 -t 329AAQL5
pool add -p mypool -t 327AAQL5 -f
ltfsee pool add -p mypool -t 327AAQL5 -c