A.13 RAVSUI (Linux)

Use the Rebuild and Verify Simple User Interface ( ravsui) utility to rebuild or verify an NSS pool on Linux that is in a maintenance state.

A.13.1 Syntax

/opt/novell/nss/sbin/ravsui

ravsui [OPTION]... [ROPTION]... rebuild poolname

ravsui [OPTION]... [VOPTION]... verify poolname

A.13.2 Arguments

The first argument is the ACTION to perform. This can be either rebuild or verify.

Rebuild checks the integrity of the data in the pool and rebuilds the pool. A rebuild operation can take up to several hours, depending on the size of the pool.

Verify checks the integrity of the data in in the pool; it does not repair. A verify operation can take several minutes, depending on the size of the pool.

The second argument is the TARGET of the action. Replace poolname with the name of an NSS pool to be rebuilt or verified.

A.13.3 Options

Mandatory arguments for long options are also mandatory for short options.

OPTION

The following are general options available to either rebuild or verify actions.

Option

Description

 
-a, --attach

Attaches to a rebuild or verifies that is running.

 
-D, --log-kernel=MASK

Controls the amount of log output from the kernel.

Default : 0x70

 
-d, --log-application=LEVEL

Controls the amount of log output from the application.

Default: 0x60

 
-h, --help

Displays this help information and exits.

 
-P, --path=PATH

Specifies the path to store logs and the results.

Default: /var/opt/novell/log/nss/rav/

 
-v, --version

Displays version information and exits.

ROPTION

The following options are available for the rebuild action.

Option

Description

 
-i, --iv-prune

Prunes internal volume.

 
-l, --loss-file-limit=LIMIT

Maximum number of files per volume to quietly prune.

Default : 100

 
-p, --purge-deleted-files

Purges deleted files.

 
-r, --rezid=ZID

Threshold to cause a rezid of a volume.

Default: 0xefffffff

 
-u, --unknown-loss-prune

Prunes if losses unknown.

VOPTION

The following options are available for the verify action.

Option

Description

 
-q, --quick

Skips cross-tree validations.

A.13.4 Example

ravsui -q verify POOL1

This command checks the integrity of the data in in POOL1 in the current tree; it skips cross-tree validations.