B.18 REBUILD (NetWare)

Use REBUILD to recover corrupted Novell Storage Services (NSS) pools. The REBUILD utility salvages the data it finds on your corrupted NSS pool and recovers it.

NetWare users might be accustomed to using VREPAIR to repair and rebuild NetWare volumes. VREPAIR still works for NetWare Traditional volumes, but it does not work on NSS pools. For NSS, you must use REBUILD.

Rebuild verifies and uses the existing leaves of an object tree to rebuild all the other trees in the system. The NSS pools that are verified and rebuilt are placed in maintenance mode. This means the NSS pool and the volumes on it are unusable until this process is finished, and the pool is remounted.

After running REBUILD, you must run the VERIFY utility. VERIFY accounts for all blocks in the system. If errors are found, they are reported to the screen, and the NSS pool is left in maintenance mode. Run REBUILD again until no errors are found. If errors are not found, the pool is placed back in the active state. You might need to mount the pool and its volumes.

NOTE:This utility protects against system failures only, not hardware failures.

B.18.1 Syntax

To rebuild a single pool, specifying the name, enter

nss /poolrebuild=pool_name

B.18.2 Starting and Using REBUILD

Use REBUILD at the command line.

NOTE:Always back up your data. If an NSS pool uses several hard disks and one of the hard disks becomes corrupted, you must create a new NSS pool, then restore its NSS volumes from backup.

  1. Load NSS.

  2. Rebuild your NSS pool.

    Select one of the following options:

    • To rebuild a single pool, specifying the name, enter

      nss /poolrebuild=pool_name
      
    • To rebuild a single pool by selecting from a list of pool names, enter

      nss /poolrebuild
      

      A list of pools appears. Select the preferred pool. You must enter this command for each pool you want to rebuild.

    • To rebuild more than one NSS volume at a time, enter

      nss /poolrebuild=pool_name, pool_name
      

      A process runs for each volume up to five NSS volumes.

    Rebuilding a pool can take up to several hours, depending on the size of the pool.

  3. Check the output screen.

    This screen indicates the time elapsed, the time remaining, the total elapsed time, the number of objects processed, etc.

  4. Verify your rebuilt NSS pool, by entering

    nss /poolverify=[pool_name]
    

    If you do not enter the NSS pool name parameter, you will be prompted to select it.