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.
/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.
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.
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.
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. |
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. |
VOPTIONs can be used only for the verify action.
|
Option |
Description |
|---|---|
-q, --quick |
Skips cross-tree validations. |
The Rebuild and Verify Simple User Interface (RAVSUI, ravsui(8)) utility file.
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.
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]
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.