historian - The Sun QFS and SAM-QFS historian
historian is a catalog that keeps track of volumes that have
been exported from an automated library or that have been
unloaded from manually loaded devices.
The historian catalog is similar to the catalog for an
automated library but since there are no devices associated
with it, has no family set name. If there is no historian
catalog configured in the mcf file (see mcf(4)) one will be
historian n+1 hy - - /var/opt/SUNWsamfs/catalog/historian
Where n+1 is the highest equipment number defined in the
mcf file plus 1.
The historian catalog will be created with 32 entries when
the catalog server initializes and can grow during execu-
tion. Each time the catalog fills, 32 entries of approxi-
mately 200 bytes each will be added. Make sure the
historian's catalog resides on a file system large enough to
hold the expected size. Since the catalog is needed before
a sam file system can be mounted, DO NOT put the catalog on
a Sun QFS or SAM-QFS file system.
Two configuration parameters in the defaults.conf file (see
defaults.conf(4)) affect the way the system will react to
requests for media or requests to add media to the historian
catalog. If exported_media is set to unavailable, then any
media exported from a media changer will be set to unavail-
able in the historian. Any request for media flagged as
unavailable will receive an ESRCH error. If attended is set
to "no" (operator is NOT available), then any request for
media in the historian catalog will be sent back to the file
system with an error (ESRCH). Any request for media
currently loaded in a manually loaded drive will be accepted
no matter what the state of the attended or unavailable
EFFECTS OF HISTORIAN
Whenever the file system receives the error ESRCH for a
stage request, it will automatically generate a stage
request for the next archived copy (unless the last stage
request was for the last copy). For a removable media
request, the error ESRCH will be returned to the user.
import (see import(1M)) is used to insert entries to the
export (see export(1M)) is used to remove entries from the
historian catalog. You may export by slot or vsn.
The catalog server will create a new, empty catalog in the
default file location if none exists or no catalog is speci-
fied in the mcf file. Alternately, the build_cat command
(see build_cat(1M)) may be used to build the initial cata-
To initialize a catalog with 32 slots run:
build_cat - /tmp/catalog_file < /dev/null
then move /tmp/catalog_file to the path pointed to in the
mcf file for the historian. 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.
mcf The configuration file for the
Sun QFS and SAM-QFS software.
defaults.conf Default information.
Default historian catalog
build_cat(1M), dump_cat(1M), export(1M), sam-robotsd(1M).