Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
6. Standards, Environment, and Macros (Man Pages Section 5)
NAME grauaci - The ADIC/Grau Automated Tape Library through the ACI AVAILABILITY SUNWsamfs DESCRIPTION grauaci is the Sun QFS and SAM-QFS software interface to the ADIC/Grau Network-attached library. This interface utilizes the DAS/ACI 3.10E interface supplied by ADIC. For more information on DAS/ACI, see the DAS/ACI 3.10E Interfacing Guide and the DAS Administration Guide. Both manuals are supplied by ADIC. CONFIGURATION Sun assumes that your site has the DAS server configured and operating with the ADIC/Grau library. In the DAS configura- tion file for this client, the avc (avoid volume contention) and the dismount parameters should both be set to true. The Equipment Identifier field in the mcf file is the full path name to a parameters file used by grauaci. This file consists of a list of keyword = value pairs or a keyword followed by a drivename = value pair. For more information on the mcf file, see the mcf(4) man page. All keywords and values, including the following, are case sensitive and must be entered as shown: Keyword Value client This is the name of this client as defined in the DAS configuration file. This is a required param- eter. server This is the hostname of the server running the DAS server code. This is a required parameter. acidrive There is one acidrive line for every drive assigned to this client. Following the acidrive keyword is a drivename = path, string that is as follows: drivename The drive name as configured in the DAS configuration file. path The path name to the device. This name must match the Equipment Identifier of an entry in the mcf file. If the library contains different media types, then there must be a separate media changer for each of the media types. Each media changer must have a unique client name in the DAS configuration, a unique library catalog and a unique parameters file. EXAMPLE The following example shows sample parameters files and mcf entries for a ADIC/Grau library supporting DLT tape and HP optical drives. The catalog files are placed in the default directory, which is /var/opt/SUNWsamfs/catalog. # # This is file: /etc/opt/SUNWsamfs/gr50 # client = grau50 server = DAS-server # # the name "drive1" is from the DAS configuration file # acidrive drive1 = /dev/rmt/0cbn # a comment # # the name "drive2" is from the DAS configuration file # acidrive drive2 = /dev/rmt/1cbn # a comment # # This is file: /etc/opt/SUNWsamfs/gr60 # client = grau60 server = DAS-server # # the name "DH03" is from the DAS configuration file # acidrive DH03 = /dev/samst/c1t1u0 The mcf file entries. # # Sample mcf file entries for an ADIC/Grau library - DLT # /etc/opt/SUNWsamfs/gr50 50 gr gr50 - gr50cat /dev/rmt/0cbn 51 lt gr50 - /dev/samst/c2t5u0 /dev/rmt/1cbn 52 lt gr50 - /dev/samst/c2t6u0 # # Sample mcf file entries for an ADIC/Grau library - HP optical # /etc/opt/SUNWsamfs/gr60 60 gr gr60 - gr60cat /dev/samst/c1t1u0 61 od gr60 - IMPORT/EXPORT The physical adding and removing of cartridges in an ADIC/Grau network-attached library is accomplished using the DAS utilities. The import(1M) and export(1M) commands affect only the library catalog. Therefore, importing and exporting cartridges with the ADIC/Grau network-attached library consists of the following two-step process: 1) Physically import or export the cartridge using the DAS utilities. 2) Virtually update the automated library catalog using the Sun QFS or SAM-QFS import and export utilities. The import(1M) command has an optional -v parameter for sup- plying the VSN to be added. The grauaci interface verifies that DAS knows about the VSN before updating the catalog with the new entry. The export(1M) command removes the entry from the catalog. For more information on importing and exporting, see the import and export(1M) man pages. CATALOG There are several methods for building a catalog for an ADIC/Grau network-attached library. You should use the method that best suits your system configuration, and this is typically determined by the size of the catalog that is needed. Method 1: Create a catalog with existing VSN entries. (Please note this method only works for tapes. It does not work for barcoded optical media.) You can build a catalog that contains entries for many tapes by using the build_cat(1M) command. As input to build_cat(1M), you need to create a file that contains the slot number, VSN, bar- code, and media type. For example, file input_vsns follows: 0 TAPE01 TAPE01 lt 1 TAPE02 TAPE02 lt 2 TAPE03 TAPE03 lt The input_vsns file can be used as input to the build_cat(1M) command, as follows: build_cat input_vsns /var/opt/SUNWsamfs/grau50cat Method 2: Create a null catalog and import VSN entries. You can create an empty catalog and populate it. To create a catalog that will accommodate 1000 slots, use the build_cat command, as follows: build_cat -s 1000 /dev/null /var/opt/SUNWsamfs/catalog/grau50cat Use the import(1M) command to add VSNs to this catalog, as follows: import -v TAPE01 50 For ADIC/Grau optical media, it is very important to import the A side of barcoded optical media. The Sun QFS and SAM- QFS software queries the ADIC/Grau database to find the bar- code for the B side and fills in the catalog entry for the B side appropriately. The A side of optical media in the ADIC/Grau automated library is the left side of a slot as you face the slots. Method 3: Use the default catalog and import VSN entries. If a catalog path name is not specified in the mcf file, a default catalog is created in /var/opt/SUNWsamfs/catalog/family_set_name when the Sun QFS or SAM-QFS software is initialized. Following initializa- tion, you must import VSN entries to this catalog. Use the import(1M) command, as follows: import -v TAPE01 50 In the preceding import(1M) command, 50 is the Equipment Identifier of the automated library as specified in the mcf file. FILES mcf The configuration file for the Sun QFS and SAM-QFS software. /opt/SUNWsamfs/lib/libaci.so The ACI library supplied by ADIC. SEE ALSO build_cat(1M), dump_cat(1M), export(1M), import(1M), sam- robotsd(1M). mcf(4).