historian - The StorageTek QFS and Oracle HSM historian
SUNWsamfs
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 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.
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
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).
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.
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.