1.179 VREPAIR

Purpose

For NetWare Traditional volumes, use this command at the System Console prompt to

NOTE:You cannot use VREPAIR on a mounted volume.

Also, VREPAIR is not used to repair NSS volumes. For NSS volumes, you must use the REBUILD utility. See Section 1.129, REBUILD.

Syntax


[LOAD] [path] VREPAIR [volume_name] [log_filename]

Parameter

Use to

path

Specify the path to vrepair.nlm if you moved it from the default directory.

volume_name

Specify the name of a volume to repair.

log_filename

Specify a text filename to log errors into.

Using VREPAIR

Minor problems can occur on a volume if the primary File Allocation Table (FAT) or Directory Entry Table (DET) becomes corrupted.

VREPAIR compares the primary tables with their mirrored counterparts. (The operating system keeps two copies of all tables. If hard disks are mirrored, then four copies are kept.)

VREPAIR checks the sets of mirrored tables for errors. If it finds inconsistencies, it uses the most correct table entry as the corrected entry. VREPAIR then writes the corrected entry to both the primary and mirrored tables.

VREPAIR may have to delete some corrupted files or tables. For more information, see Viewing Deleted Files.

VEPAIR will log bad block information into a file if you specify a log filename when you load VREPAIR. You can also specify a log filename after you load VREPAIR, when VREPAIR displays an error.

VREPAIR can repair a bad volume that you have dismounted while other NetWare server volumes are functioning. After you finish running VREPAIR, you can mount the repaired volume (in most cases).

Use VREPAIR when

The VREPAIR main screen displays the following menu:



Options:


1 - Repair a volume


2 - Set VRepair options


3 - Exit

Main Menu Selection

Use to

Repair a volume

Begin or continue with volume repair. You can also use this option to stop a volume repair in process or change the method of displaying errors during the repair.

Set VRepair options

Set VREPAIR configuration options.

Exit

Exit VREPAIR.

In the Set VRepair Options menu, there are two settings for each option, a default option and an alternate option. When VREPAIR autoloads and tries to repair a volume that will not mount, the default settings are used.

You can configure the VREPAIR alternate options by selecting the associated option number to toggle between the alternate and default options.

For example, Option 2 settings are Write All Directory and FAT Entries Out to Disk and Write Only Changed Directory and FAT Entries Out to Disk.

The default for Option 2 is Write Only Changed Directory and FAT Entries Out to Disk. If you select Option 2, your current VREPAIR configuration reflects the change from the default to the new setting: Write All Directory and FAT Entries Out to Disk.

The VREPAIR configuration options are described in the following table.

Table 1-22 VREPAIR Configuration Options

Default Option

Alternate Option

Explanation

1. Quit if a VREPAIR Name Space Support NLMâ„¢ Is Not Loaded

Remove Name Space Support From The Volume

These options control whether name space support for non-DOS files is retained in the volume tables.

If you add a name space to a volume and the system doesn't have enough memory, select Remove Name Space Support From the Volume. Then select a name space to delete.

If you remove a name space, the accompanying extended file information is destroyed.

For example, if you remove Macintosh name support, the Macintosh long names, the finder icons, and the resource forks are destroyed.

(The DOS name and its data file are kept and are accessible from DOS workstations.)

Important: To repair a volume with non-DOS name space entries, VREPAIR must find the corresponding name space support modules. (For example, to repair a volume with the Macintosh name space, you need to load v_mac.nlm; to repair a volume with the OS/2* or Windows* name space, load v_long.nlm.)

For more information, see Repairing a Traditional Volume in the NW6.5 SP8: Traditional File System Administration Guide.

2. Write Only Changed Directory And FAT Entries Out To Disk

Write All Directory And FAT Entries Out To Disk

These options control the changes that are made to the FATs and Directory tables.

If you repair a mirrored or duplexed volume, select the alternate option to force an update of all tables on both hard disks.

3. Write Changes Immediately To Disk

Keep Changes In Memory For Later Update

NetWare defaults to writing changes immediately to disk. In most cases, this default option speeds the repair.

Disks requiring very few changes will repair faster if the alternate option is used.

4. Retain Deleted Files

Purge All Deleted Files

These options control whether deleted files are purged or retained.

If a file is deleted, but not purged, it can be salvaged.

Purge deleted files if you are concerned about the amount of disk space being used to retain deleted files or if you don't want users to salvage files (for example, for security reasons).

5. Return to Main Menu

After you select the VREPAIR configuration options, press menu item 5 to return to the VREPAIR main menu.

Displaying Errors during Repair

There are run-time options you can modify during the VREPAIR process to change the way errors are displayed. To view the options, select the main menu option, Repair a Volume.

Viewing Deleted Files

The repair operation can create new files containing data that VREPAIR deleted. You can access these files if you select the default configuration option, Retain Deleted Files. The files are numbered and named vrnnnnnn.fil where n is any number.

These numbered files are created in any of the following circumstances:

VREPAIR might create as many as several thousand of these files. These numbered files are created in the directory where they were found during the volume repair operation.

You might be able to recover some or all of the files deleted by VREPAIR. Contact Technical Support for more information.

Additional Information

Topic

See

Repairing a NetWare traditional volume or NSS pool

(For NetWare Traditional volumes) Repairing a Traditional Volume in the NW6.5 SP8: Traditional File System Administration Guide

(For NSS pools on NetWare) Verifying and Rebuilding an NSS Pool and Its Volumes in the NW 6.5 SP8: NSS File System Administration Guide