Java Solaris Communities Partners My Sun Sun Store

United States Worldwide

Research Home
»	Spotlight Articles
»	Projects
»	Publications
»	People
»	Awards
»	Events
»	Downloads
»	Internships
»	Contrarian Minds
»	About Sun Labs

opjparchive and opjprestore - physical archive and restore a quiescent OPJ store

opjgc removes unreferenced objects from a persistent store.

SYNOPSIS

opjparchive -config config-pathname -dir archive-directory
opjprestore -config config-pathname -dir archive-directory

DESCRIPTION

The physical archive tool generates a physical copy of all of the components of a persistent store into a single designated directory. The physical restore tool performs the reverse operation. A physical archive can therefore only be restored and accessed by the same OPJ implementation on the same machine architecture. See the logical archive tool, opjlarchive, for ways to produce a machine and implementation independent archive.

Physical archiving is a fast and easy way to archive and restore a store. Owing to the experimental nature of the PJama prototype, it is recommended that you archive a store periodically and before significant operations which, where they to fail, might corrupt the store, for example, garbage collection (opjgc) or evolution (opjsubst).

OPTIONS

-config pathname

The absolute pathname of the configuration file that identifes the store to be archived.

-dir directory

The absolute pathname of a directory for the archived store components. This directory must exist.

-verbose

Output detailed information on the archive/restore operation.

OPJPARCHIVE

The given archive directory must already exist. If the directory contains a previous archive, the tool will abort. Delete the contents of the directory or choose another directory and re-run the tool.

The given configuration file is used to identify the store components, and it is backed up also for completeness. However, any modifications to the configuration file since the last time the store was accessed, such as extending a segment, adding a segment, are ignored by the archive tool. The archive tool acquires the actual configuration from the store itself.

Example:

   opjparchive -config /usr/mjj/test.pjc -dir /usr/mjj/store_archives/test

OPJPRESTORE

This command restores the store from the given physical archive directory. The store may or may not already exits. If it exists, it is overwritten, otherwise it is created as necessary.

Example:

   opjprestore -config /usr/mjj/test.pjc -dir /usr/mjj/store_archives/test

Questions and comments to forest-info@sunlabs.com