NAME

historian - The StorageTek QFS and Oracle HSM historian

AVAILABILITY

SUNWsamfs

DESCRIPTION

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.

CONFIGURATION

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 created as:

    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 execution. Each time the catalog fills, 32 entries of approximately 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 StorageTek QFS or Oracle HSM 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 unavailable 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 flags are.

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 AND EXPORT

import is used to insert entries to the historian catalog. See import (1m).

export is used to remove entries from the historian catalog. You may export by slot or vsn. See export (1m).

CATALOG

The catalog server will create a new, empty catalog in the default file location if none exists or no catalog is specified in the mcf file. Alternately, the build_cat command (see build_cat (1m)) may be used to build the initial catalog.

To initialize a catalog with 32 slots run:

build_cat - ∕tmp∕catalog_file  ∕dev∕null

Then move the ∕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.

FILES

mcf: The configuration file for the StorageTek QFS and Oracle HSM software.
defaults.conf: Default information.
∕var∕opt∕SUNWsamfs∕catalog∕historian: Default historian catalog file.