                            
                 AUTOmatic volume REPair
                        (AUTOREP)

          NetWare File Server Automatic Volume
                     Repair Facility
             Version 1.00, 1th December 1992

                    Author Jason Hart
                        ShareWare

AUTOREP is designed to automatically run VREPAIR.NLM over
nominated volumes if they do not mount properly at server
startup. This NLM will run VRepair.NLM until the volume
is mountable or until the maximum number of VRepair
retries is executed.

If a NetWare v3.11 server fails to mount all needed
volumes at load-time, this NLM will attempt to use
VREPAIR to correct the problems, then remount the
previously disabled volume.

Automatic Reboot after ABEND
This auto-repair NLM may be used with SENTINEL. SENTINEL
will automatically reboot a fileserver after an ABEND
occurs. If the volume was damaged by the ABEND message,
AUTOREP will use VREPAIR to correct most faults and start
the NLM.

=====================================================


OPTIONS

LOAD AUTOREP <volume> <volume> <volume> <volume>

<volume>
The volumes listed will be checked by AUTOREP and if they
are not mounted, VREPAIR will be used against it.

====================================================
Setup

NetWare SERVER.EXE will execute the AUTOEXEC.NCF file
from a local disk if it is unable to mount volume SYS.
In the directory were your SERVER.EXE is executed from
include the following

AUTOEXEC.NCF    <located on the local disk ie C:\SERVER\>
  FILE SERVER NAME  <name of your server>
  IPX INTERNAL NET <as per SYS:\SYSTEM\AUTOEXEC.NCF>

  LOAD CLIB
  LOAD PATCH311     <Novell patch for CLIB must be applied-see below>
  LOAD AUTOREP SYS  <plus any other volumes>

NOTE: The fileserver name and IPX number here should be
the same in the real autoexec.ncf file.


Add the following line into your normal
SYS:SYSTEM\AUTOEXEC.NCF  (you can use install.nlm)
     LOAD PATCH311
     LOAD AUTOREP SYS <plus any other volumes>


STARTUP.NCF should have this line added to it to prevent
TTS error prompts.

SET AUTO TTS BACKOUT FLAG = ON


If volume SYS fails the local autoexec.ncf file will be
started and AUTOREP will attempt to repair and mount the
SYS and any other volumes. Once SYS has been mounted it
will execute the AUTOEXEC.NCF file from the SYS volume
bringing the server back to its orginal state
automatically.

If the SYS volume was not the volume that failed, then
the AUTOREP from the SYS:SYSTEM\AUTOEXEC.NCF will be
executed and will try to repair all volumes specified
that were not already mounted.


The following files must be accessible from the local
disk or AUTOREP will not be able to check and repair the
volumes :

          AUTOREP.NLM
          CLIB.NLM
          STREAMS.NLM
          VREPAIR.NLM
          PATCH311.NLM

NOTE: These files should also be copied to the SYS:SYSTEM
directory.

====================================================
              What is PATCH311.NLM ?
Patch311.NLM is a Novell provided patch that adds enhanced
functionality to the CLIB.NLM. Later version of CLIB have it included,
if you are presently using an early version of CLIB.NLM it is required
(AUTOREP won't load without it) however if you are using the latest
version of CLIB, it is not required and PATCH311.NLM will not load.
It has been provided with this program or may be downloaded from the
Novell section of Compuserve.

Autorep requires either PATCH311.NLM installed or a late
version of CLIB.NLM. if you receive the following error, the
correct version of CLIB is not installed or PATCH311 is not
installed.

    unresolved public symbol <xxxxxx>

====================================================
SENTINEL.NLM  (companion product)

Sentinel is a companion product to AUTOREP.NLM. It is designed
to restart a fileserver after the server has stopped due to an
ABEND message. Sentinel creates a logfile to a local disk which
contains the fileserver ABEND message and stack details.

When AUTOREP and SENTINEL are used together, a fileserver may
automatically recover from an ABEND message even if the disk
volumes required repairing.

1. Fileserver stops due to ABEND
2. Sentinel traps the ABEND to a logfile and reboots the server
3. AUTOREP repairs all nominated volumes using VREPAIR if they
     fail to mount.
4. AUTOREP writes logfile of activity (registered version only)
5. System is up and running again.


====================================================
                  !! READ THIS !!

This version of the program contains all features except that
the log file facility has been removed. The log facility
creates a logfile of all repair events that occurred whenever
AUTOREP.NLM is executed. This enables a system administrator to
determine if during the course of an automatic recovery whether
any volumes encountered problems.

To obtain the latest version of AUTOREP with the log facility,
send a cheque or money order for $30US to the below postal address.

You will receive the full registered version of AUTOREP with updates
for 12 months.

To receive a registered copy of AUTOREP and SENTINEL with 12 months
of updates, send a cheque for $45US.


====================================================

Source Code

If you would like to receive the original commented
source code to this application please send a cheque or
money order for $90 to:

               Jason  Hart
               Post Office Box 92
               Canterbury, Victoria, 3126
               Australia.

If you have any suggestions, questions about the program
or customisations, they are welcome and I am reachable on
CompuServe at 100033,3202 or via the above address.

=========================================================

DISTRIBUTION

Feel free to distribute this program and documentation in
its original untampered state.

=========================================================

DISCLAIMER:
While all care has been taken in the development of this
product, you are using it AT YOUR OWN RISK. It has been
tested on different platforms and with a number of
testing tools to ensure that the product is stable. No
loss of any kind is accepted by the author arising from
the use of any of these programs. You are free to
distribute provided the program and text files are not
changed.
