Populating the Catalog

The appropriate method to use to populate a library's catalog depends on the number of volumes that you include in the catalog.

How to Populate an Automated Library With Many Volumes

Use this procedure for StorageTek ACSLS-Attached, ADIC/Grau, Sony network-attached,and IBM 3494 automated libraries.

Note the following when creating the input file:

• The file has four fields in each row. Each row identifies a volume. For each volume, specify the slot number, the VSN, the bar code, and the media type.

• Use a space character or a tab character to separate the fields in this file.

• If a VSN contains one or more space characters, enclose the VSN name in quotation marks (" ").

1. Create an input file that contains the slot number, the volume's VSN, the barcode number, and the media type.

   The following example shows the sample file input_vsns.

   0 TAPE01  "TAPE 01" lt
   1 TAPE02  TAPE02  lt
   2 TAPE03  TAPE03  lt

2. Use the build_cat command to create the catalog.

   # build_cat input-file catalog-file

   
   

   Header Header input-file Specifies the name of an input file, which is typically a file that contains a list of VSNs. catalog-file Specifies the full path to the library catalog. By default, the SAM-QFS software creates a catalog and writes it to /var/opt/SUNWsamfs/catalog/ family-set-name. family-set-name is derived from the mcf file entry for this automated library. Alternatively, if you have specified a catalog name in the Additional Parameters field of the mcf file, use that catalog file name for catalog-file.

   For example, you might specify the following build_cat command:

   # build_cat input_vsns /var/opt/SUNWsamfs/catalog/grau50

How to Populate an Automated Library With a Small Number of Volumes

Use this procedure for ADIC/Grau, Sony network-attached, StorageTek ACSLS-Attached, and IBM 3494 automated libraries.

Perform this procedure for each cartridge that you want to include in the catalog. The cartridge must be physically present in the automated library. If the cartridge is not present, the entry is recorded in the historian. The historian keeps track of cartridges that are exported from an automated library or a manually mounted device. For more information about the historian, see Tracking Exported Media - The Historian.

• Use the samimport command to import catalog entries into the default catalog.

  # samimport -v VSN eq

  
  

  Argument Content VSN Specifies the VSN identifier for a volume. If a VSN name contains one or more space characters, enclose the VSN name in double quotes (" "). eq Specifies the Equipment Ordinal as specified for the device in the mcf file.

  For example:

  # samimport -v TAPE01 50

How to Populate an IBM 3494 Automated Library

Use this procedure only if you are using an IBM 3494 library as one physical library where access=private is specified in the mcf file. Do not use this procedure if you divided the library into multiple logical libraries.

• Insert the media cartridge into the mail slot.

  The library automatically builds a catalog that includes the media cartridge.

How to Populate a StorageTek ACSLS-Attached Library Quickly

This procedure is a faster method of populating a library catalog than the methods described in How to Populate an Automated Library With Many Volumes or How to Populate an Automated Library With a Small Number of Volumes.

• Use the samimport command with the -c and -s options to import from a pool of VSNs.

  For more information, see samimport(1M) in Sun QFS and Sun Storage Archive Manager Reference Manual.