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.
/opt/novell/nss/sbin/ravview
ravview [OPTION]... rtf filenameravview [OPTION]... [NOPTION]... rtfn poolnameravview [OPTION]... [VOPTION]... vbf filenameravview [OPTION]... [NOPTION]... [VOPTION]... vbfn poolname
Poolnames and filenames are case sensitive.
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.
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.
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. |
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. |
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/ |
The Rebuild and Verify View utility file.
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.
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
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