B.8 ravview

The Rebuild and Verify View (RAVVIEW) utility displays specified rebuild or verify log files in human-readable format. The log files are generated by the Rebuild and Verify Simple User Interface (RAVSUI, ravsui(8)) utility.

You must log in as the root user to run this utility. If the specified pool is active when you run the utility, the ZIDs of files that appear in the log are converted to their /pathname/filename format so that they are more easily understood by the reader.

B.8.1 Syntax

/opt/novell/nss/sbin/ravview
ravview [OPTION]... rtf filename
ravview [OPTION]... [NOPTION]... rtfn poolname
ravview [OPTION]... [VOPTION]... vbf filename
ravview [OPTION]... [NOPTION]... [VOPTION]... vbfn poolname

Poolnames and filenames are case sensitive.

B.8.2 Arguments

The first mandatory argument specifies the type of log file you want to view. This can be rtf, rtfn, vbf, or vbfn. The second argument specifies information about the log you want to view.

IMPORTANT:In the raw log files, files that were acted upon are identified by their ZIDs, not the path and filename. If the pool that was rebuilt or verified is active when you view its log, the utility converts each ZID to display the path and filename instead.

First Argument

Description

Second Argument

rtf

Specifies that you want to view a rebuild results. You must specify the filename of the log you want to view. The utility displays any messages that occurred during the rebuild.

filename

rtfn

Specifies that you want to view the newest rebuild results in a specified path for a specified poolname. Optionally, specify the path to the logs by using the -P=PATH option. The utility displays any messages that occurred during the rebuild.

poolname

vbf

Specifies that you want to view a verify results. You must specify the filename of the log you want to view. The utility converts the binary file into a human-readable format.

filename

vbfn

Specifies that you want to view the newest verify results in a specified path for a specified poolname. Optionally, specify the path to the logs by using the -P option. The utility converts the binary file into a human-readable format.

poolname

Replace filename with the path and name of the log file for the rebuild or verify process that you want to view.

Replace poolname with the name of the NSS pool that was rebuilt or verified.

B.8.3 Options

This section describes the OPTION, VOPTION, and NOPTION options available for the RAVVIEW utility. Mandatory arguments for long options are mandatory for short options too.

OPTION

General options can be used for viewing rebuild or verify logs. Use them in combination with any of the rtf, rtfn, vbf, or vbfn arguments.

Option

Description

-h, --help

Displays help information and exits.

-V, --verbose=LEVEL

Controls the amount of output.

-v, --version

Displays version information and exits.

VOPTION

VOPTIONs are available only for viewing the verify results. Use them in combination with the vbf or vbfn arguments.

Option

Description

-a, --actions

Displays action information.

-H, --histograms

Displays histograms.

-o, --object-details

Displays object details.

NOPTION

NOPTIONS are available for viewing the newest log for a specified pool. Use this option in combination with the rtfn and vbfn arguments.

Option

Description

-P, --path=PATH

Specifies the path to RAV log files.

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

B.8.4 Files

/opt/novell/nss/sbin/ravview

The Rebuild and Verify View utility file.

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

The default location of the log file for the Rebuild and Verify Simple User Interface (RAVSUI, ravsui(8)) 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 or -P option. This should be the same path that you used when you ran the RAVSUI utility.

B.8.5 Example

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

To view the results of the last rebuild of the pool named POOL, enter the following command at the terminal prompt:

ravview rtfn --path=/test/path/novell/nss/rav_logs/ POOL

ravview rtfn -P /test/path/novell/nss/rav_logs/ POOL

You can specify a path for the log file by using the -path=PATH or -P option. This should be the same path that you specified when you used the ravsui utility. If you do not specify any path then, the default path searched is /var/opt/novell/log/nss/rav/.

To view a rebuild results, enter the following command at the terminal prompt:

ravview rtf /var/opt/novell/log/nss/rav/POOL_rebuild_4ff6bbfd_log.xml

Note: Specify the full path to the location of your log file.

If you want to view older rebuild results for a pool named DATAPOOL, enter the following command at the terminal prompt:

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

and then do ls -larth DATAPOOL_rebuild_*_log.xml

The command lists all the DATAPOOL rebuild results that are present on the server (in the current directory, which is the default location for rebuild logs in this case).

-rw-r--r-- 1 root root 1.8K May 24 14:58 DATAPOOL_rebuild_4fbea0bd_log.xml

-rw-r--r-- 1 root root 1.9K May 30 10:52 DATAPOOL_rebuild_4fc65010_log.xml

To view the May 30 rebuild results, enter the following command:

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

ravview rtf DATAPOOL_rebuild_4fc65010_log.xml

To view the results of the last verify operation performed on a pool named "TEST", enter the following command at the terminal prompt:

ravview vbfn TEST

To view a specific verify results, enter the following command at the terminal prompt:

ravview vbf /var/opt/novell/log/nss/rav/TEST_verify_4ffd76a8_report.vbf

Note: Specify the full pathname of the file where your log file is located.

If you want to view older verify results for a pool named TEST, enter the following command at the terminal prompt:

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

ls -larth TEST_verify_*.vbf

The command lists all the TEST verify results that are present on the server (in the current directory, which is the default location for rebuild logs in this case).

-rw-r--r-- 1 root root 38K Oct 7 2009 TEST_verify_4acd3641_report.vbf

-rw-r--r-- 1 root root 38K Jan 15 2010 TEST_verify_4b50f319_report.vbf

-rw-r--r-- 1 root root 38K Feb 17 11:52 TEST_verify_4f3ea059_report.vbf

To view the October 7, 2009 verify results, enter the following command:

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

ravview vbf TEST_verify_4acd3641_report.vbf

Clustered Environment

In a clustered deployment using Novell Cluster Services (NCS), verify and rebuild results for a pool can exist on any of the nodes in a cluster (since pools can be migrated between nodes), or even on a node that is no longer a part of the cluster, but was hosting the pool at the time the verify/rebuild operation was performed. It may be useful to create a common volume/directory, mounted through NFS or other access protocol on all nodes in the cluster to store the rebuild and verify results. For example, you can have an auto-mounted path /my/shared/rav/logs/ on all the nodes in a cluster.

To verify a pool named MYPOOL on node 1, enter

ravsui -P /my/shared/rav/logs/ verify MYPOOL

If the pool is then migrated to the node2 in the cluster. To view the logs on node 2, enter

ravview -P /my/shared/rav/logs/ vbfn MYPOOL

Note: This will work on node 2, if the same log directory is mounted on this node.

To view a specific verify or rebuild file, enter:

ravview vbf /my/shared/rav/logs/MYPOOL_verify_4ffd74b8_report.vbf