fujitsulmf(7)

NAME
     fujitsulmf - The Fujitsu LMF Automated Tape Library

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     fujitsulmf is the Sun QFS and SAM-QFS software interface  to
     the  Fujitsu  LMF  library.  This interface utilizes the LMF
     interface supplied by Fujitsu.  For more information on LMF,
     see  the  LMF  MTL  Server/Client  User's  Guide supplied by
     Fujitsu.

CONFIGURATION
     It is assumed that the site has the  LMF  server  configured
     and operating with the LMF library.

     The "equipment identifier"  field  in  the  mcf  file,  (see
     mcf(4)),  is the full path name to a parameters file used by
     fujitsulmf.  This file consists of a list of keyword = value
     pairs  or  a  keyword  followed by a drivename = value pair.
     All keywords and  values  are  case-sensitive  and  must  be
     entered as shown.

     lmfdrive
          There is one lmfdrive line for every drive assigned  to
          this  client.   Following  the  lmfdrive  keyword  is a
          drivename = path, where:

          drivename
               is the drivename as configured in LMF.

          path is the pathname to the  device.   This  name  must
               match  the  "equipment  identifier" of an entry in
               the mcf file.

EXAMPLE
     Here are sample parameters files and mcf entries for an  LMF
     library.

          #
          # This is file: /etc/opt/SUNWsamfs/lmf50
          #
          # the name "LIB001DRV000" is from the LMF configuration
          #
          lmfdrive LIB001DRV000 = /dev/rmt/0cbn   # a comment
          #
          # the name "LIB001DRV001" is from the LMF configuration
          #
          lmfdrive LIB001DRV001 = /dev/rmt/1cbn  # a comment

          The mcf file entries.

          #
          # Sample mcf file entries for an LMF library
          #
          /etc/opt/SUNWsamfs/lmf50 50   fj   fj50  -  /var/opt/SUNWsamfs/catalog/fj50_cat
          /dev/rmt/0cbn           51   fd   fj50  -  /dev/samst/c2t5u0
          /dev/rmt/1cbn           52   fd   fj50  -  /dev/samst/c2t6u0

IMPORT/EXPORT
     Since the physical adding and removing of media in  the  LMF
     library  is  done with LMF utilities, the import/export com-
     mands will only affect the library catalog.  The import com-
     mand  has  an  optional  parameter (see import(1M)) (-v) for
     supplying the volser to be added.   fujitsulmf  will  verify
     that  LMF knows about the volser before updating the catalog
     with the new entry.  The  export  command  (see  export(1M))
     will remove the entry from the catalog.

CATALOG
     There are two utilities used to maintain the library catalog
     used by LMF.  build_cat (see build_cat(1M)) is used to build
     the catalog.   dump_cat  (see  dump_cat(1M))  and  build_cat
     together are used to change the size of the catalog.

     To initialize a catalog with 1000 slots run:

          build_cat /tmp/catalog_file < /dev/null

     then move /tmp/catalog_file to the path pointed  to  in  the
     mcf file for this media changer.  Use import to populate the
     catalog with the volumes allowed by DAS.  Or, you can create
     a  file  with  the list of volumes and supply it as input to
     build_cat (see build_cat(1M)) for the format  of  the  input
     file.

     If the size of the catalog needs to  be  increased,  execute
     something like:

          dump_cat file1 | build_cat -s 2000 /tmp/file2

     This would create a new catalog file (/tmp/file2) with  room
     for  2000  entries  and  initialize it with the entries from
     file1.  This should only be done when the Sun QFS  and  SAM-
     QFS  software  is not running and sam-amld has been shutdown
     (see sam-amld(1M)).

FILES
     mcf                 The configuration file for the  Sun  QFS
                         and SAM-QFS software.
     /opt/SUNWsamfs/lib/liblmf2.so
                         The LMF library supplied by Fujitsu.

SEE ALSO
     build_cat(1M), dump_cat(1M),  export(1M),  import(1M),  sam-
     robotsd(1M).

     mcf(4).