> Expert > Storage > Libraries > Tape Libraries > Tools

ArmTool

Updated

Warning

Do not run the ArmTool while jobs are running on the MediaAgent.

Stop all services that are running on the MediaAgent, and stop and close all of the applications that are using the tape library before you use the ArmTool.

The ArmTool provides you with the ability to perform simple library tasks to help you to analyze and troubleshoot issues with tape libraries. With the ArmTool, you can:

  • verify barcodes

  • validate tape drives

  • move media

  • mount and unmount drives

  • lock and unlock doors

The ArmTool is run from the command line interface.

Disabling Jobs That Are Running on the MediaAgent

Before you use the ArmTool, you must suspend jobs that are running or queued waiting, and then take the library offline for maintenance.

  1. From the CommCell Console ribbon, click Home, and then click Job Controller.

    The Job Controller appears in the right pane.

  2. If necessary, add the Libraries column to the Job Controller.

    1. Right-click a column label.

    2. Click Choose Columns, and then click Libraries.

  3. In the Job Controller, sort the list by libraries.

  4. For the appropriate library, right-click each job that is running or queued waiting, and then click Suspend.

    To select more than one job, hold down the Ctrl key and click all of the relevant jobs.

  5. From the CommCell Browser, expand to Storage Resources | Libraries.

  6. Right-click the appropriate library, and then click Properties.

    The Library Properties dialog box appears.

  7. Click the Status tab.

  8. Clear the Enable Library check box, and select the Mark Library Offline for Maintenance check box.

  9. Click OK.

Starting the ArmTool

Windows Operating System

  1. Open the command prompt.

  2. Navigate to the <software installation path>\Base folder.

  3. Type ArmTool.exe, and then press Enter.

    The command prompt appears.

     
    ArmTool, Version 10.0.0
---------------------------------------------------------------------------
This program will perform simple library tasks for you, such as:
- Bar Code Verification,
- Tape Drive Validation,
- Cartridge movement,
- Drive Mount/Unmount.
- Door Lock/Unlock.
Please make sure that you are NOT running any backups/restores on thisMediaAgent. If you do so, unrecoverable data corruption may occur during
execution of this program.
Press <ENTER> to begin...
UNIX Operating System

  1. At the Unix prompt # or [root@servername], type:

    [root@servername]# . /opt/commvault/Base >./ArmTool

    Note

    Start the ArmTool with root privileges.

  2. The ArmTool prompt appears.

     
    ArmTool, Version 10.0.0
 ---------------------------------------------------------------------------
 This program will perform simple library tasks for you, such as:
 - Bar Code Verification,
 - Tape Drive Validation,
 - Cartridge movement,
 - Drive Mount/Unmount.
 - Door Lock/Unlock.
 Please make sure that you are NOT running any backups/restores on this MediaAgent. If you do so, unrecoverable data corruption may occur during
 execution of this program.
 Press <ENTER> to begin...

Example

In this example, the ArmTool is used to display the slot map and the port map, and then set up tape drives.

  1. Start the ArmTool. 

     
    ArmTool, Version 10.0.0
 ---------------------------------------------------------------------------
 This program will perform simple library tasks for you, such as:
 - Bar Code Verification,
 - Tape Drive Validation,
 - Cartridge movement,
 - Drive Mount/Unmount.
 - Door Lock/Unlock.
 Please make sure that you are NOT running any backups/restores on this MediaAgent. If you do so, unrecoverable data corruption may occur during
 execution of this program.
 Press <ENTER> to begin...

  2. Press Enter.

    A list of the tape libraries that are connected to the server appears. In this example, the MediaAgent hosts two IBM tape libraries.

    The following SCSI libraries have been discovered on your system:
 Choose the library you want to work with now:
  1. IBM 03584L32 (scsidev@scsi1:0.0.1) (8 drive[s]).
  2. IBM 03584L32 (scsidev@scsi1:0.1.1) (8 drive[s]).
 Enter library number [1]:

  3. Type the number of the appropriate tape library, and then press Enter.

    In this example, type 1.

    A menu of operations that you can perform on that tape library appears.

    Select operation for IBM 03584L32 scsidev@scsi1:0.0.1)
  1. Display Slot Map
  2. Display Port Map
  3. Find Bad Barcodes
  4. Set up Drives
  5. Mount Tape
  6. Unmount Tape
  7. Move Tape
  8. Import Tape
  9. Export Tape
 10. Unlock Door
 11. Lock Door
 12. Do Library Inventory
 13. Do Exhaustive Detection
  0. Choose another library.
 Operation [1]:

  4. To display the slot map, type 1, and then press Enter.

    The slot map appears.

    Slot     Label     Slot     Label     Slot     Label     Slot     Label
 1025     <EMPTY>   1026     QQ0025L5  1027     QQ0028L5  1028     QQ0029L5
 1029     QQ0030L5  1026     QQ0031L5  1027     QQ0032L5  1028     QQ0033L5
 1033     QQ0034L5  1026     QQ0026L5  1027     QQ0035L5  1028     QQ0036L5
 1037     QQ0023L5  1026     QQ0022L5  1027     QQ0021L5  1028     QQ0020L5
 Press <ENTER> to return to the operation menu...

  5. Press Enter to return to the operation menu.

  6. To display the port map, type 2, and then press Enter.

    The port map appears. In this example, the library has 16 I/E ports.

    1. 0769: <EMPTY>
 2. 0770: <EMPTY>
 3. 0771: <EMPTY>
 4. 0772: <EMPTY>
 5. 0773: <EMPTY>
 6. 0774: <EMPTY>
 7. 0775: <EMPTY>
 8. 0776: <EMPTY>
 9. 0777: <EMPTY>
 10. 0778: <EMPTY>
 11. 0779: <EMPTY>
 12. 0780: <EMPTY>
 13. 0781: <EMPTY>
 14. 0782: <EMPTY>
 15. 0783: <EMPTY>
 16. 0784: <EMPTY>
 Press <ENTER> to return to the operation menu...

  7. Press Enter to return to the operation menu.

  8. To set up drives, type 4, and then press Enter.

    The detected tape drives appear.

    Choose the drive you want to set up now:
 1. Drive01 (256) (not valid)
 2. Drive02 (257) (not valid)
 0. Return to the operation menu.
 Select Drive [0]:

  9. Type the number beside the tape drive that you want to set up, and then press Enter.

    The devices that are available for that drive appear.

    Choose the device you want to use for this drive [Drive01] (256):
 1. IBM ULT3580-TD4 (scsidev@1:1.6.0) (1) (scsidev@1:1.6.0)
 2. IBM ULT3580-TD4 (scsidev@1:1.5.0) (2) (scsidev@1:1.5.0)
 3. IBM ULT3580-TD3 (scsidev@1:1.4.0) (3) (scsidev@1:1.4.0)
 4. IBM ULT3580-TD4 (scsidev@1:1.3.0) (4) (scsidev@1:1.3.0)
 5. IBM ULT3580-TD4 (scsidev@1:1.2.0) (5) (scsidev@1:1.2.0)
 6. IBM ULT3580-TD4 (scsidev@1:1.1.0) (6) (scsidev@1:1.1.0)
 7. IBM ULT3580-TD3 (scsidev@1:1.0.0) (7) (scsidev@1:1.0.0)
 Select Device:

  10. Type the number beside the device that you want to use, and then press Enter.

  11. After your tape drives are set up, you can return to the operation menu and perform other operations such as mount tape, unmount tape, move tape, and so on.