About This Guide

This guide documents OpenVault releases running on IRIX systems and SGI ProPack for Linux.

OpenVault is a package of mediation software that helps other applications manage removable media:

This guide describes how to administer and operate OpenVault. It also provides an introduction to tertiary storage management.

Intended Audience

This guide is intended for administrators who set up the OpenVault system and monitor its operation, and for operators who perform prescribed storage management tasks. To use the information in this guide, you should have the following experience:

  • Understanding UNIX system infrastructure including devices and networking

  • Writing UNIX shell and Perl scripts

  • Using common text editors (for example, emacs, jot, nedit, or vi)

  • Using backup utilities such as cpio, tar, xfsdump, or IRIX NetWorker

What This Guide Contains

The following is an overview of the material in this guide:

Related Publications

The following documents contain additional information that may be helpful:

  • The OpenVault Application Programmer's Guide describes the client side of OpenVault, showing how applications can make OpenVault requests in a prescribed format.

  • The OpenVault Infrastructure Programmer's Guide describes the server side of OpenVault, showing how to write control programs for removable media libraries and drives.

  • Release notes: On IRIX systems, you can view release notes by typing either grelnotes or relnotes at the command line. On SGI ProPack for Linux systems, see the documentation in /usr/share/doc/openvault-version.

Obtaining Publications

You can obtain SGI documentation in the following ways:

  • See the SGI Technical Publications Library at http://docs.sgi.com. Various formats are available. This library contains the most recent and most comprehensive set of online books, release notes, man pages, and other information.

  • If it is installed on your SGI system, you can use InfoSearch, an online tool that provides a more limited set of online books, release notes, and man pages. With an IRIX system, select Help from the Toolchest, and then select InfoSearch. Or you can type infosearch on a command line.

  • You can also view man pages by typing man title on a command line.


The following conventions are used throughout this document:




This fixed-space font denotes literal items such as commands, files, routines, path names, signals, messages, and programming language structures.


Man page section identifiers appear in parentheses after man page names.


Italic typeface denotes variable entries and words or concepts being defined.

user input 

This bold, fixed-space font denotes literal items that the user enters in interactive sessions. (Output is shown in nonbold, fixed-space font.)

[ ] 

Brackets enclose optional portions of a command or directive line.


Ellipses indicate that a preceding element can be repeated.

Reader Comments

If you have comments about the technical accuracy, content, or organization of this publication, contact SGI. Be sure to include the title and document number of the publication with your comments. (Online, the document number is located in the front matter of the publication. In printed publications, the document number is located at the bottom of each page.)

You can contact SGI in any of the following ways:

  • Send e-mail to the following address:

    [email protected]

  • Use the Feedback option on the Technical Publications Library Web page:


  • Contact your customer service representative and ask that an incident be filed in the SGI incident tracking system.

  • Send mail to the following address:

    Technical Publications
    1600 Amphitheatre Parkway, M/S 535
    Mountain View, California 94043-1351

  • Send a fax to the attention of “Technical Publications” at +1 650 932 0801.

SGI values your comments and will respond to them promptly.