Adding Libraries or Magneto-Optical Drives for Archiving

The inquiry.conf file lists all of the supported devices.

The /kernel/drv/samst.conf file contains a list of SCSI and FC entries and works with the /opt/SUNWsamfs/examples/inquiry.conf file to define the devices that can be included in a SAM-QFS environment.

The following procedures show how to verify the entries in the samst.conf file and to update the file, if necessary.

Update the samst.conf file as follows:

• If you have only network-attached automated libraries, you do not need to verify device support or update it.

• If you use a SCSI or FC interface to attach a tape library to the server, see How to Configure Device Support in SCSI or FC Environments Using SAM-QFS Manager to discover the tape libraries with the current drive information.

• If you have a direct-attached library with a target number larger than 6 or a LUN identifier larger than 1, see How to Configure Device Support for a Direct-Attached Library.

How to Configure Device Support in SCSI or FC Environments Using SAM-QFS Manager

Repeat this procedure for each device in your environment.

1. On the SAM-QFS Manager Managed Hosts page, select the name of the server to which you want to add a library.

   The File Systems Summary page appears.

2. Expand the Archive Media section and select Tape Libraries.

   The Tape Library Summary page appears.

3. Click Add to start the Add a Library wizard.
4. Follow the steps to add the device.

   When you complete the wizard steps, the samst.conf file is automatically updated.

How to Configure Device Support for a Direct-Attached Library

1. Create a backup copy of the /kernel/drv/samst.conf file.

   # cp /kernel/drv/samst.conf /kernel/drv/samst.conf.orig

2. Open the /kernel/drv/samst.conf file.
3. Include SCSI-attached magneto-optical drives or SCSI-attached libraries.
   1. Search for entries that have the following format to locate the list of SCSI targets and LUNs:

      name="samst" class="scsi" target=target lun=lun;

      target is the target ID for each SCSI drive found and lun is the corresponding LUN for each SCSI drive found.

   2. Find the entry that corresponds to each SCSI target ID and LUN on your inventory list.

      For example, the StorageTek 9730 automated library is attached to target 0 and LUN 0. The following line corresponds to that interface:

      name="samst" class="scsi" target=0 lun=0;

      Note that some entries might extend over two lines if it includes return characters.

      • If an entry starts with a hash character (#), remove the character. A hash (#) character marks a line as a comment.

      • If an entry is missing, create an entry for the SCSI target and LUN line. Follow the format shown in Step 3a and use the information in your hardware inventory list.

4. Create a line for each FC-attached magneto-optical drive or FC-attached automated library in your inventory list.

   Use the following format:

   name="samst" parent="fp" lun=lun fc-port-wwn="world-wide-name"

   lun specifies the LUN for the drive and world-wide-name specifies the WWN for the drive.

   The following example shows the line added to support the StorageTek L700 tape drive in Table 2-1.

   name="samst" parent="fp" lun=0 fc-port-wwn="500104f00041182b"

5. Save your changes, and exit the samst.conf file.

Recovering After a Direct-Attached Library Fails to Initialize

A direct-attached library may fail to initialize after an ENOENT error while trying to open a samst device. The example below shows how to exclude a STK SL500 library so that the samstsamst device binds as needed at mount time. Add lines similar to the following to the /kernel/drv/scsi_vhci.conf file, replacing STK SL500 with the string for the type of library that you are using:

#
device-type-scsi-options-list =
"STK     SL500", "disable-option";

disable-option = 0x7000000;

For more information, see the scsi_vhci(7D) man page.