NSS Utilities included with NetWare 6 Support Pack 3
(Last modified: 05Aug2004)
This document (10079738) is provided subject to the disclaimer at the end of this document.
goal
NSS Utilities included with NetWare 6 Support 3
fact
Novell NetWare 6 SP3
NSS v3.0
note
Included with NetWare 6 Support Pack 3 in the SYS:\SYSTEM directory are 3 NSS utilities:
- CHECKVIS.NLM
- DMPTRUST.NLM
- COMPFIX.NLM
These NSS utilities are build specific. This means that the NSS modules on the server must be code matched to these utilities for them to work correctly. If the NLMs are not run on the correct build, then will not load or work at all. Another way to say this is that this NLMs will not run on anything other than the NSS modules they come with (SP2, or any released NSS patch). Each subsequently released NSS patch will have a copy of these 3 NLMs so they will stay lockstep with the code.
These utilites are included as a courtesy for customers running NSS to help them with known issues. It is strongly recommended that customers use these utilities with the assistance of Novell technical support. This document will describe the usage of these NLMs.
CHECKVIS.NLM:
This NLM scans a volume and prints out statistics on the NSS visibility list (trustees). If there are problems other than the main statistics printed, more information will be included in the output log file for the administrator to review.
This NLM requires a volume name as a parameter for input and will send results to the logger screen and to a file named CHECKVIS.OUT. The volume must be in an active state for this NLM to be run. Novell has seen extremely large volumes take quite a bit of time and processor cycles to run this NLM on. We suggest that this NLM be run after hours when the response of the specific volume and the servere is not as demanding as during peak business hours.
The NLM syntax is: checkvis <volume name>
When this NLM is run, the logger screen will display information on when the NLM starts working on the volume and when it has completed working on the volume. It will also display a group of statistics specific to the volume submitted.
DMPTRUST.NLM:
This NLM scans a volume and prints out information specific to trustees assigned to the volume and how it relates to GUIDs stored in NSS and eDirectory.
This NLM requires a volume name as a parameter for input and will send results to the logger screen and to a file named DMPTRUST.OUT. The volume must be in an active state for this NLM to be run.
The NLM syntax is: dmptrust <volume name>
When this NLM is run, the logger screen will display information on when the NLM starts working on the volume and when it has completed working on the volume.
In the February AppNotes from Novell, a document describes the output of these two NLMs and how this can be used to troubleshoot issues on a NetWare 6. server with NSS. The complete description and run through is better left to the AppNote as a background of how trustees and GUIDs work and operate with NetWare and NSS is necessary in understanding the output of these files. The Novell AppNotes can be found online off a link from the developer web site at Novell (http://developer.novell.com).
COMPFIX.NLM:
This NLM has a two-fold purpose:
- Iterate through a volume's file system and list off corrupted compressed files.
- Reset all of the NSS compression statistics without having to run a rebuild.
The NLM syntax is: compfix -lc | -fs <volume name>
To have this NLM check for corrupted files on a volume, the following would be typed at the system console prompt:
compfix -lc <volume name>
To have this NLM fix the compression statistics for a volume, the following would be typed at the system console prompt:
compfix -fs <volume name>
Novell suggests that the volume where the compression statistics are reset on be in maintenance mode. This, by default, means that all logical volumes in the pool will also be put in maintenance mode. We suggest this be done so that the statistics cannot be modified while the NLM is running. This NLM switch can be run on a volume while it is active, but again it is not suggested.
In each case "<volume name>" is representative of the actual server's volume name; do not type in "<volume name>". So, if a server's volume that needed to be checked was named USERS, the following would be typed:
compfix -lc USERS
or
compfix -fs USERS
For the corrupted file list, the output file is named compfix.txt and is placed on the root of the volume specified. This file will contain the name of the file and full path to the file. Also included is an NSS reason for the corruption. This file can then be used to identify the corrupted files and have them immediately restored from a backup tape.
Added new switches "-pc", "-pf" and "-cc" to compfix, so a user can delete non-fixable corrupted files if they choose so.
"-cc" -- clears cant_compress_bit attribute from all files on the volume. It is useful if user wants to have more files to be compressed by modifying compression settings, specifically, by lowering the value of server set parameter "Minimum Compression Percentage Gain".Novell suggests that customers contact technical support for further questions about the proper use of these utilities.
.document
| Document Title: | NSS Utilities included with NetWare 6 Support Pack 3 |
| Document ID: | 10079738 |
| Solution ID: | NOVL86454 |
| Creation Date: | 30Jan2003 |
| Modified Date: | 05Aug2004 |
| Novell Product Class: | NetWare Novell eDirectory |
disclaimer
The Origin of this information may be internal or external to Novell. Novell makes all reasonable efforts to verify this information. However, the information provided in this document is for your information only. Novell makes no explicit or implied claims to the validity of this information.
Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.