tarback.sh(1M)

NAME
     tarback.sh - Reloads files from SAM-QFS archive tapes

SYNOPSIS
     /opt/SUNWsamfs/examples/tarback.sh

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     The tarback.sh script reloads files from SAM-QFS archive
     tapes.  This script can be used if a file system is lost and
     there are no usable samfsdump(1M) files or copies of the
     .inodes files available.

USAGE
     The following steps describe how to use the tarback.sh
     script.

     Step 1.   Use sammkfs(1M) to recreate or restore the file
               system.

     Step 2.   Use samu(1M) to set the drive you are using to
               unavail.

     Step 3.   Copy the script from its original location in
               /opt/SUNWsamfs/examples/tarback.sh to the /tmp
               directory or to a different alternate location.
               The script itself contains comments to guide you
               in tailoring the script for your own use.

     Step 4.   Modify the variables you need.  Generally, only
               the following variables in the script need to be
               modified:

               Variable Name       Content

               EQ="eq"             The Equipment Number of the
                                   tape drive as defined in the
                                   mcf file.

               TAPEDRIVE="path"    The raw path to the device
                                   described by EQ=.

               BLOCKSIZE="size"    The block size in 512-byte
                                   units.  For example, specify
                                   256 for a block size of 128
                                   kilobytes.

               MEDIATYPE="mt"      The 2-character media type for
                                   this tape as defined on the
                                   mcf(4) man page.

               VSN_LIST="vsn1 vsn2 ..."
                                   The list of VSNs to be read.
                                   There is no limit on the
                                   number of VSNs that can be
                                   specified.  Use a space
                                   character to separate the VSN
                                   names.  This list can be
                                   continued onto another line by
                                   using a backslash character
                                   (\).

                                   For example:

                                   VSN_LIST="vsn1 vsn2 \
                                     vsn3"

     Step 5.   Remove the pound character (#) from column 1 of
               the line that defines the variables.

     Step 6.   Run tarback.sh.  There are no arguments.

EXAMPLES
     The following script has been edited to contain site-
     specific information (only the edited portions of the script
     are shown):

     STAR="/opt/SUNWsamfs/sbin/star"
     LOAD="/opt/SUNWsamfs/sbin/load"
     UNLOAD="/opt/SUNWsamfs/sbin/unload"
     EQ=28
     TAPEDRIVE="/dev/rmt/3cbn"
     BLOCKSIZE=256
     MEDIATYPE="lt"

     VSN_LIST="VSNA VSNB VSNC \
        VSNZ"

WARNINGS
     Improper use of this script can damage user or system data.
     Please refer to the Sun QFS and SAM-QFS Disaster Recovery
     Guide or contact technical support before using this script.

FILES
     The tarback.sh script resides in the following location:

     /opt/SUNWsamfs/examples/tarback.sh

SEE ALSO
     samload(1M), samu(1M), star(1M), unload(1M).