Skip Headers
Oracle Hierarchical Storage Manager and QFS Software Command Reference
Section 1m: Maintenance Commands
Release 6.1.1
E70305-03

NAME

tarback.sh - Reloads files from Oracle HSM archive tapes

SYNOPSIS

∕opt∕SUNWsamfs∕examples∕tarback.sh

AVAILABILITY

SUNWsamfs

DESCRIPTION

The tarback.sh script reloads files from Oracle HSM 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.

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

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

  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.

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

  5. 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"
    
  6. Remove the pound character (#) from column 1 of the line that defines the variables.

  7. 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 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).