Overview

The slxml script can be used to remove the tapes listed in an export list. The process involves three steps: moving tapes around the library to free TeraPacks, moving the listed tapes over to the open TeraPacks, and then exporting those TeraPacks. In order to minimize impact on the library’s production load, the moves are passed to the library via a MoveQueue file during each step before proceeding to the next. The number of moves in each MoveQueue file can be determined with the –moves flag to ensure the number of moves sent to the library don’t impact production as well.

Requirements

• A host with network access to the library’s LCM and JDK 14 or higher.
• Web UI access to the library.
• Physical access to the library to remove the TeraPacks.
• At least 1 TeraPack of free space in the library.
• A text file with a list of tapes to be exported in a single column without additional whitespace.

Commands

slxml

--http create an insecure connection to the library.

--endpoint/-e IP address of the library

--username/-u Library username

--password/-p Library password

--command/-c Command to be executed. The three necessary for this operation are listed below.

magazine-compaction

--partition Partition name

--moves The maximum number of moves to execute. Limit is 100.

--output-format Specify move-queue to save the moves to a MoveQueue.txt file in the output/ directory.

group-listed-tapes

--partition Partition name

--moves The maximum number of moves to execute. Limit is 100.

--file-name The path and name of the file containing the list of tapes to be ejected.

--output-format Specify move-queue to save the moves to a MoveQueue.txt file in the output/ directory.

eject-listed-tapes

--partition Partition name

--file-name The path and name of the file containing the list of tapes to be ejected. This will be output/completed_tapes.text.

Outputs

• MoveQueue.txt – a list of tape moves to be executed by the library.
• completed_tapes.txt – a list of all the tapes that have been ejected from the library.

Sample Export List

321102L5

000008L6

032167L6

032186L6

081958L5

321024L5

321029L5

A00215L6

321023L5

089655L6

Process

1. Ensure at least one free TeraPack is available for moves with the magazine-compaction command.

a. From the bin/ directory of spectra_xml-1.6/ execute the magazine compaction command.

./slxml --http -e 10.10.10.10 -u su -p somepass -c magazine-compaction --partition Partition 1 --moves 30 --output-format move-queue

b. Upload the move queue to the library i. Log into the library’s web UI. ii. Navigate to the General > Inventory screen iii. Select the correct partition and select go. iv. Click Advanced v. Select the Remote radial button vi. Click Upload to Move Queue vii. Click browse and select the MoveQueue.txt file in the spectra_xml-1.6/output/ directory viii. Click next ix. Moves should populate in the Move Queue field. x. Click start moves c. Wait until the moves complete before proceeding to step 2.

2. Move tapes from their current slots to the empty TeraPacks with the group-listed-tapes command. a. From the bin/ directory of spectra_xml-1.6/ execute the group-listed-tapes command.

./slxml --http -e 10.10.10.10 -u su -p somepass -c group-listed-tapes --partition Partition 1 --moves 30 --file-name path/to/export/list.txt --output-format move-queue

b. Upload the move queue to the library i. Log into the library’s web UI. ii. Navigate to the General > Inventory screen iii. Select the correct partition and select go. iv. Click Advanced v. Select the Remote radial button vi. Click Upload to Move Queue vii. Click browse and select the MoveQueue.txt file in the spectra_xml-1.6/output/ directory viii. Click next ix. Moves should populate in the Move Queue field. x. Click start moves c. Wait until the moves complete before proceeding.

3. Repeat steps 1 and 2 until all tapes in the export list have been moved over to the new TeraPacks.

4. Eject the TeraPacks with the ejected tapes. a. Prepare an import export list for the listed tapes with the ejected-listed-tapes command.

./slxml --http -e 10.10.10.10 -u su -p somepass -c eject-listed-tapes --partition Partition 1 --file-name ../output/completed_tapes.txt

b. Remove the TeraPacks from the library. i. Log into the library from the front panel. ii. Navigate to the General > Import/Export screen on the library. iii. Ensure the correct partition is selected. iv. Click Advanced. v. Click Populate. vi. Click start moves for the library to start ejecting the specified TeraPacks.

5. Verify the correct tapes have been ejected.