samadm - StorageTek QFS and Oracle HSM main administrative command
samadm eq-add eq_number#
samadm eq-release eq_number#
samadm eq-remove eq_number#
samadm eq-alloc eq_number#
samadm eq-noalloc eq_number#
samadm -?|--help
The samadm command is a single command line interface to many
StorageTek QFS and Oracle HSM commands.
The detailed description of each subcommand follows.
eq-addThis subcommand adds an equipment to an existing mounted
StorageTek QFS file system. The equipment must be added to the mcf (4)
file, and samd config must be run prior to adding the equipment
number to a file system. The equipment will be placed into the
off state.
In a non-shared file system, after the equipment number is added, it is placed into the on state.
In a shared file system, after the equipment number is added,
it is initially placed into the unavail state. All the mcf files
on the clients must be updated to include the new∕changed equipment
number, and samd config run. After this has been done, To place this
equipment number into full read∕write status, change the state
to alloc via samadm eq-alloc eq_number#.
eq-releaseThis subcommand releases the disk space associated with files that
have valid archive copies from Oracle HSM. It can be used prior to an
eq-remove command to quickly release space on a device that
is to be removed for hardware failure or other reasons.
The eq-release subcommand starts a background process called
sam-shrink which releases space on the equipment number
The releasing process may take some time to complete. Progress can be
monitored via samu (1m) (m display). When the release is started,
the equipment is first put into noalloc state to prevent further
data allocation on that equipment. When the releasing process is
complete, the equipment is placed into off state if all space was
successfully released.
eq-removeThis subcommand removes an equipment number from an existing mounted StorageTek QFS file system. It is intended to be used to remove an equipment for reuse, or to remove an equipment that needs replacement because of hardware failure.
The eq-remove subcommand starts a background process called
sam-shrink which copies the data on the equipment number
to be removed to other equipments in the file system. The removal process
may take some time to complete. Progress can be monitored via
samu (1m) (m display). When the remove is started, the equipment to be
removed is first put into noalloc state to prevent further data
allocation on that equipment. When the removal process is complete,
the equipment is placed into off state if all space was successfully
moved to other equipments.
eq-allocThis subcommand changes the state of an equipment number to alloc which allows new data allocations to be placed on it. This subcommand is only legal for equipments which are currently in the noalloc or unavail state.
eq-noallocThis subcommand changes the state of an equipment number to noalloc which prevents new data allocations to be placed on it. This subcommand is only legal for equipments which are currently in the on state.
-?|--helpDisplays a command syntax summary.
