B.8 ravsui

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. You must log in as the root user to run this utility. You must place the pool in maintenance mode before starting the rebuild or verify process.

B.8.1 Syntax

/opt/novell/nss/sbin/ravsui
ravsui [OPTION]... [ROPTION]... rebuild poolname
ravsui [OPTION]... [VOPTION]... verify poolname

Replace poolname with the name of the pool you want to rebuild or verify, such as POOL1. Poolnames are case sensitive on Linux.

B.8.2 Arguments

The first mandatory argument specifies the action to be performed as rebuild or as verify.

  • The rebuild action checks the integrity of the data in the pool and rebuilds the pool. A rebuild process can take up to several hours, depending on the size of the pool. The rebuild argument can be combined with one or more OPTION and ROPTION options.

  • The verify action checks the integrity of the data in the pool; it does not perform the repair. A verify process can take several minutes, depending on the size of the pool. The verify argument can be combined with one or more OPTION and VOPTION options.

The second mandatory argument poolname is the target of the action. Replace poolname with the name of an NSS pool to be rebuilt or verified. Poolnames are case sensitive on Linux.

B.8.3 Options

This section describes the OPTION, ROPTION, and VOPTION options available for the RAVSUI (ravsui) utility. Mandatory arguments for long options are also mandatory for short options.

OPTION

General options can be used for both rebuild and verify actions.

Option

Description

-a, --attach

Attach to a rebuild or verify that it 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 Linux path where the log file is written that contains the results of the rebuild or verify action.

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

-v, --version

Displays version information and exits.

ROPTION

ROPTIONs can be used only for the rebuild action.

Option

Description

-i, --iv-prune

Prunes an internal volume.

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

Specifies the maximum number of files per volume to quietly prune.

Default: 100

-p, --purge-deleted-files

Purges deleted files.

-r, --rezid=ZID

Specifies the threshold to cause a reZID of a volume.

IMPORTANT:For NSS on Linux, a rebuild automatically causes a reZID of a volume if the rebuild finds a ZID over 2 billion.

This checks all blocks in the system. Rebuilding can take several minutes to several hours, depending on the number of objects in the pool. For all systems, reZID adds a third pass to the rebuild, which increases the time to rebuild a volume by about 50%.

For more information about reZID, see Section 16.3, ReZIDing Volumes in an NSS Pool.

Default: 0xefffffff

-u, --unknown-loss-prune

Prunes if losses unknown.

VOPTION

VOPTIONs can be used only for the verify action.

Option

Description

-q, --quick

Skips cross-tree validations.

B.8.4 Files

/opt/novell/nss/sbin/ravsui

The Rebuild and Verify Simple User Interface (RAVSUI, ravsui(8)) utility file.

/var/opt/novell/log/nss/rav/

The default location of the log file for the RAVSUI utility’s rebuild or verify actions. The path is the directory where the file is stored and does not include the filename itself. You can specify a different path for the log file by using the -P=PATH option.

B.8.5 Note

Before you run the RAVSUI utility to perform a pool verify or pool rebuild, you must put the pool into maintenance mode.

Log in as the root user, then open a terminal console.

At a terminal prompt, enter

nsscon

In nsscon, enter

nss /PoolMaintenance=poolname

Replace poolname with the name of the pool you plan to rebuild or verify, such as POOL1.

If you do not place the pool in maintenance mode before starting the utility, you receive NSS Error 21726:

NSS error: PoolVerify results
   Status: 21726
     Name: zERR_RAV_STATE_MAINTENANCE_REQUIRED
   Source: nXML.cpp[1289]

B.8.6 Example

Log in as the root user, then open a terminal console.

At a terminal prompt, enter

nsscon

At the nsscon prompt, put the pool that you want to verify (such as POOL1) in maintenance mode by entering

nss /PoolMaintenance=POOL1

At the terminal prompt, start the RAVSUI utility to verify the pool by entering

ravsui -q verify POOL1

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