Home
Buy Now
What's New
Download
Linux
Training
Data Recovery
DVD Burners
Products
Reseller Application
Purchasing FAQ
Product FAQ
Partners
Resellers
Documents
Newsletters
Bug Reports
Privacy
Links
Contacts
   

Volume Defragment for NetWare
Portlock Software
www.Portlock.com
Copyright (c) 2000-2001 Portlock Software. All rights reserved.

Release Notes
Release 2.02
December 1, 2001


CONTENTS

  1. Overview.
  2. Installation and Removal.
  3. What's New in Release 2.02?
  4. Known Issues.
  5. Command Line Options.
  6. VREPAIR support.
  7. Terminating a Defragmentation in Process.
  8. Software Updates.
  9. Additional Information and Support.

1. Overview

Volume Defragment for  NetWare is a comprehensive tool for improving the performance of Novell NetWare file systems. Traditional and NSS volumes are supported.

The following versions of Novell NetWare are supported:

  • Novell NetWare 3.12 and 3.20
  • Novell NetWare 4.10, 4.11 and 4.20
  • Novell NetWare 5.0, 5.1 and Small Business Suite 5.1

Supported Novell NetWare volume features include:

  • Single-segment volumes.
  • Multi-segment volumes.
  • Mirrored partitions.
  • NetWare Partition Hotfix.
  • Block Suballocation.
  • Compression.
  • DOS, LONG, MAC, NFS Name Spaces.
  • NWIO (DSK) Device Drivers.
  • NWPA (HAM) Device Drivers.
  • Novell NetWare NSS volumes.

Unsupported Features:

  • Volumes with Data Migration enabled.
  • FTAM Name Space

Fragmented NetWare volumes can affect the performance of Novell NetWare servers in numerous ways. Defragmentation can improve both the perceived responsiveness of the server and the actual performance of such factors as:

  • Volume mount time.
  • Tape backup performance.
  • Tape backup storage efficiency and wear.
  • Read and write performance.
  • Cache utilization of intelligent adapters such as RAID controllers.
  • NetWare DET cache utilization.
  • NetWare cache utilization.

This utility improves the performance of Novell NetWare systems by optimizing the following features of a Novell NetWare file system:

  • Organization of the Primary and Secondary Directory Tables.
  • Organization of the Primary and Secondary Extended Directory Tables.
  • Organization of the Block Suballocation Tables.
  • Organization of the File Data.
  • Organization of the Extended File Data.

2. Installation and Removal.

INSTALL:

This software is packaged as a zip file. Create a temporary directory on your system and unzip the files. This software does not require an installation before use. However, there are three supported installation methods:

  1. Installation using INSTALL.NLM (NW 3 & 4) or NWCONFIG.NLM (NW 5). Copy the files either to a floppy diskette or to a temporary directory on your server. Using INSTALL.NLM or NWCONFIG.NLM select "Product Options". Then select "Install a product not listed". 
  2. Create a directory SYS:/DEFRAG. Copy the files to the SYS:/DEFRAG  directory on your server. The software can also be copied to any directory on your server.
  3. Installation using PINSTALL.NLM. From the server console type: "load a:pinstall.nlm" if the files are on a floppy diskette, or "load <path>/pinstall.nlm" if the files are on a directory on the server.

The default installation directory is SYS:/DEFRAG.

To execute the software type: "load sys:/defrag/defrag" at the server console.

Also see the command line options section below.

UNINSTALL:

To remove the software, use INSTALL.NLM (NW 4) or NWCONFIG.NLM (NW 5). Select "Product Options". Then select "View/Configure/Remove installed products". Then select DEFRAG and press delete. 

To uninstall for NetWare 3, you will need to manually delete the directory and its contents SYS:/DEFRAG.


3. What's New in Release 2.02?

New Features:

None.

Bugs Fixed:

  1. NSS Volume Check would report an error for volumes with sparse files.
  2. NSS Volume Check would report an error for volumes with overflow blocks in the Name Tree.

What's New in Release 2.01?

New Features:

  1. I2O Controllers are now supported. This includes the Adaptec I2O RAID controllers and the Xiotech Fibre HBAs.
  2. The NSS Volume Check command has been enhanced to check for more error conditions for Trustees, Directory Quotas and User Space Restrictions.

Bugs Fixed:

  1. NSS: Storage Manager would report an error during Volume Check for NSS Beast Types 19 & 20. This has been corrected.
  2. On older versions of NSS, Storage Manager would list an NSS volume as available for Volume Commands. However, when the volume was selected, an error message would be displayed that NSS volumes are not supported. This problem has been fixed.

4. Known Issues

There are no known bugs in the software except for those listed in the What's New section.


The production version does have the following limitations:

  • Volumes with FTAM Name Space are not supported.
  • Volumes with Data Migration enabled are not supported.
  • The software supports a maximum of 64 logical disk drives per server. Note that a RAID-5 array appears as one logical disk drive to NetWare.
  • The software supports a maximum of 256 NetWare partitions per server.

5. Command Line Options

This version supports a number of command line options that can be used to modify the behavior of the software.

Command Syntax:

defrag <VolumeName> [options]

The VolumeName parameter specifies the name of the NetWare volume. This parameter is used when executing the software from a script.

The following are valid command line options:

-help

Display the help screen. All other options will be ignored.

-eraselog

This option will delete an existing file specified by the -logfile command line option.

-logfile=filename

This option creates a file on either a NetWare volume or a file located on the DOS partition. This option allows for the status of a volume defragmentation to be logged. The output will be appended to the file.

-maxtime=n

The software normally will execute until the task is complete. This option allows the specification of a time limit measured in minutes.

This is useful when the command is placed into a script that is run at a specific time. For example: a script could be created to run this software every Sunday morning at 3AM and to stop after 3 hours:

defrag VOL1 -maxtime=180 -mount

Note: This software does not include a scheduler for running scripts.

-mount

The software requires exclusive access to a NetWare volume. This option will automatically dismount a volume, perform its task and then remount the volume without operator intervention. If this option is not specified then the operator will need to confirm volume dismount and mount operations.

Note: there are no special broadcast messages sent to users when a dismount takes place other than the standard NetWare messages.

-nwio

The software supports using either the older NetWare NWIO (DSK) I/O subsystem interface and the newer NWPA (HAM) interface. This command line option specifies to use the older NWIO (DSK) interface.

Note: This option is not available on NetWare 5.x servers.

-nwpa

The software supports using either the older NetWare NWIO (DSK) I/O subsystem interface and the newer NWPA (HAM) interface. This command line option specifies to use the newer NWPA (HAM) interface.

Note: This option is not available on NetWare 3.x servers unless the NWPA update package has been installed. This is the only interface available for NetWare 5.x servers.

-quick

The software normally will defragment the entire volume. This option allows for the defragmentation of the Directory Tables only. The defragmentation of the Directory Tables can significantly reduce volume mount time.

-report

This option specifies to report on the fragmented files. The software will not defragment the volume. Note: this option is affected by the stripe width of the volume.

-script

This option forces the software to never display prompts asking the operator for input. This is for scripting where the software is not being executed from the console by an operator.

Note: some display prompts will continue to display for several seconds before being dismissed automatically.

-stripe=n

This option controls the stripe width for multi-segment volumes. This option will be ignored for volumes which consist of only one segment. This parameter is determines the number of blocks in a stripe before switching to another segment.

The default stripe width is:

  • 4K Volume Block Size: Stripe Width: 64 Blocks
  • 8K Volume Block Size: Stripe Width: 32 Blocks
  • 16K Volume Block Size: Stripe Width: 16 Blocks
  • 32K Volume Block Size: Stripe Width: 8 Blocks
  • 64K Volume Block Size: Stripe Width: 4 Blocks

Note that these numbers result in a default stripe width of 256KB.

A stripe width of zero ignores volume segmenting. This means that defragmentation starts with the first volume segment. Once this volume segment is full, then the next volume segment is used.

-verbose

The verbose option includes additional information in the logfile:

  • Include file names in logfile.
  • Include all files in when in report mode.
  • Additional information regarding errors.

6. VREPAIR Support.

The software will automatically execute VREPAIR.NLM after a volume has been defragmented. Normally, VREPAIR and its name space modules V_MAC, V_LONG, etc. are located in the SYS:/SYSTEM directory. It is standard practice to also include these files within the server startup directory i.e. C:\NWSERVER

When defragmenting the SYS volume ensure that the NetWare search path includes the DOS partition where the VREPAIR tools are located.

For example: search add C:\NWSERVER

To display the current search path type "search" on the system console.


7. Terminating a Defragmentation in Process.

The software can be stopped at any time by pressing any key on the keyboard. A prompt will be displayed asking for confirmation. This design allows for partial defragmentation that can be re-continued at at later time. Also see the -maxtime command line option.


8. Software Updates

Volume Defragment supports updating itself over the Internet. The update feature will connect to our web server and retrieve a file that lists the latest files. No information about your server or software is sent to our web server. We use the HTTP "GET" command for all software downloads.

An error message will sometimes occur about not being able to resolve the address www.portlock.com. This is fixed by loading the Novell NLM netdb.nlm which provides the DNS name resolution that Volume Defragment needs. As a fallback we have hard coded the IP address of our web server into Volume Defragment..


9. Additional Information and Support.

Please visit our web site to obtain addition documents on Novell NetWare and volume defragmentation: www.Portlock.com/documents/index.htm.

For technical support send email to: support@Portlock.com.

For sales support send email to: sales@Portlock.com.


End of Document

       
Portlock Software is a trademark of Portlock Software. 
All other products mentioned are registered trademarks or trademarks of their respective companies.
Contact sales sales@portlock.com T: 406-723-5200 - F: 406-723-5205
Contact support support@portlock.com T: 406-723-5200 - F: 406-723-5205
Questions or problems regarding this web site should be directed to our Web Master.
Copyright © 2000 - 2006 Portlock Software. All rights reserved.
Last modified: Tuesday March 14, 2006.