# DAMON Help File
# Copyright (C) 1993-93, UltraStor Corporation.

#Main Menu
.index 1 Monitors
.index 2 Recovery
.index 3 Select Controller
.index 4 Preventive Maintenance
.index 5 Misc.
.index 6 Unload
MAIN MENU

- Monitor Options:
    View array drives,  physical drives, or scheduled jobs.
- Recover From A Failed Drive:
    Repairs RAID 1, 4 or 5 array drives.
- Select Array Controller:
    Select from more than one array controller.
- Preventive Maintenance (PM):
    Invoke premature rebuild operations (Hot-Swap or Hot-Spare).
- Miscellaneous Options:
    Scan new drives, hot-spare options, notification options,
    queue maintenance, silence alarms, & change log file name.
- Unload DAMON:
    Exit this NLM and unload.
.end

# Monitor Menu
.index 10 Logical
.index 11 Physical
.index 12 Scheduled Jobs
MONITOR OPTIONS

- View Array Drive Status
- View Physical Drive Status
- View Scheduled Jobs
.end

# Miscellaneous Menu
.index 20 Scan for new drives
.index 21 Hot-spare options
.index 22 Notification options
.index 23 Job Maintenance
.index 20 Silence alarms
.index 25 Change log file
MISCELLANEOUS MENU

- Scan For Newly Installed Drives
    Scan for new drive or removed drives. Invoke Restore if necessary.
- Hot-Spare Options
    Set hot-spare mode, pre-format, day, time, & spare pool.
- User Notification Options
    Set failure/completion notify and change notify group.
- Scheduled Job Queue Maintenance
    Release, suspend, or delete Queued jobs.
- Silence Alarm(s)
    Silence audible alarms for all attached array controllers.
- Change Log File
    Modify drive/path/filename of DAMON's event log. 
.end

.index 31
Array (Logical) Drive Status

Status:
Ready    Nonactive and available.
Busy     Active performing some operation.
Init     Initializing.
Rebuild	 Hot-swap or hot-spare in progress.
CheckInt Integrity Check in progress.

Integrity:
Good     Perfect working condition.
Critical RAID 1, 4 or 5 redundancy failure.  Still usable.
         Requires recovery (hot-swap or hot-spare).
Failed   Complete failure.  Drive not usable.  Not repairable.
Bad Def  Bad Definitions.  Check drive power/cables/RAID definitions.
.end

.index 30
Physical Drive Status

Status:
Ready      Nonactive and available.
(Spare)    Drive is declared a spare drive.
Unassigned Drive is not assigned to any array drive.
Failed     Drive failed (Down condition).  Requires replacement.
Error      Unknown drive error.
Active     Some operation is in progress (Rebuild, Initialize, etc.).
Format     Low-Level Formatting.

.end

.index 32
Scheduled Jobs

Status:
  Rdy      Job is ready to execute.
  Wait     Job is waiting to execute pending execution time.
  Exec     Job is executing.
  Susp     Job is suspended indefinitely.  Must be released by user.
  Done     Job completed successfully.
  Err      Job completed in error.
Queue Time:
  Time job was submitted into the queue.
Execute Time:
  Time job is scheduled to execute.
User:
  Name of user that submitted the job.
.end



######################################

# Select drive to rebuild
.index 60
Select drive to rebuild:

The drives in this list are failed physical drives and members of
RAID 1, 4 or 5 array drives.  

Select the drive that you want to rebuild.  You will be given to
option to replace the drive and rebuild it (Hot-Swap), or to
perform a hot-spare.  And you may schedule the rebuild for a later
time.

Note: If automatic hot-sparing is enabled, you do not need to perform
a rebuild since a hot-spare will have been scheduled automatically. 
If, however, you want to rebuild before the scheduled time, you may
do this.  The scheduled job will simply fail when it executes.
.end

# Select Recover method
# Select Method of Maintenance Rebuild
.index 61 original chan/id
.index 66
Hot-Swap Original Channel/ID:

Allows you to replace the failing drive with a new one and rebuilds
all associated RAID 1, 4 and 5 array drives.
.end
.index 62 any available drive
.index 67
Hot-Spare To Any Available Spare Drive:

Seeks an appropriate spare drive and restores redundancy of associated
RAID 1, 4 and 5 array drives using the spare drive.
.end
.index 63 selected spare drive
Hot-Spare To Selected Spare Drive:

The selected spare drive will be used to restore redundancy of 
associated RAID 1, 4 and 5 array drives.
.end

# Before hot swapping, replace and check size
.index 80
The specified failed physical drive need to be replaced with a
good drive of the specified size or greater.  This must be done before
the hot-swap operation begins.  You should replace the drive before
continuing.
.end

# hotswap now or schedule for later?
.index 81
You have the option to begin the hot-swap rebuild now or scheduled
the hot-swap for a later time.
.end

# hotspare now or schedule for later?
.index 82
.index 85
You have the option to begin the hot-spare rebuild now or schedule
the hot-spare for later.
.end

# make sure drive is available
.index 83
.index 84
.index 86
.index 87
You should make sure a spare drive of sufficient capacity is available
before the hot-spare operation begins.  Is is acceptable to schedule
the hot-spare first then install the spare drives; but, if the
hot-spare is to start immediately, you should make the spare drive
available now.
.end


#######################################

# card select
.index 64
Select Array Controller

Use the up and down arrow keys to move the selection bar and press
ENTER to select the high-lighted controller.
.end

#######################################

# make sure user wants PM function
.index 88 Preventive Maintenance
The Preventive Maintenance (PM) operation allows you to perform premature
rebuilds on RAID 1, 4 or 5 array drives.  This allows you to replace
drives that you suspect to be faulty or to swap out drives on a
rotational basis.

Both hot-swaps and hot-spares can be performed, much like the recovery
operations, with the exception that a forced failure will occur on the
selected drive before the rebuild operation is performed.

Note that you may only perform PM operations when all array drives are 
in 'Good' condition.  Note also that if any associated array drives
Span or RAID 0 drives, they will be destroyed because they are not
redundant.
.end

# Select Drive For Maintenance Rebuild
.index 65
Select Drive For Maintenance Rebuild:

The drives in this list are members of RAID 1, 4 or 5 array drives.  

Select the drive that you want to rebuild.  You will be given to option
to replace the drive and rebuild it (Hot-Swap), or to perform a hot-spare.
And you may schedule the rebuild for a later time.
.end

# drive will be forced to fail - hotswap
.index 89
A failure condition will be forced on the specified drive.  After the
failure condition, the drive may be removed and replaced.
.end

# replace with good drive - hot swap
The failure conitions has benn forced on the specified drive.
You may now replace the drive with a good drive.  Press ENTER
to begin the rebuild operation.
.index 90
.end

# hot swap now or later
.index 91
You have the option of beginning the hot-swap rebuild now
or scheduling it for a later time and date.
.end

# hot spare now or later
.index 92
.index 95
You have the option of beginning the hot-spare rebuild now
or scheduling it for a later date and time.
.end

# make sure drive is available
.index 93
.index 94
.index 96
.index 97
You should make sure a spare drive of sufficient capacity is available
before the hot-spare operation begins.  Is is acceptable to schedule
the hot-spare first then install the spare drives; but, if the
hot-spare is to start immediately, you should make the spare drive
available now.
.end

# enter schedule time
.index 108
Enter the date and time you want to schedule this job in the given
format.

Examples:  Oct. 29, 1994  2:00 am
           10/29/1994 02:00

           April 5, 1994  3:00 pm
           04/05/1994 15:00
.end

# enter job will be scheduled for...
.index 109
This job is scheduled for the given execution time.
.end

#######################################

# drive scan has detected new drive
.index 98
The drive scan has detect a new drive.  If the all unassigned drives
are spare option is ON, then this drive will become a spare.
.end

# not sure if changed
.index 99
The drive scan could not determine if you had changed the given drive.
If the drive has been changed, respond YES.  If it has not been changed,
respond NO.  If you respond YES, the drive failed status will be cleared.
.end

# detect replacement
.index 100
The drive scan detected a replacement drive at the given location.
If you respond YES, the drive failed condition will be cleared.
If you responnd NO, it is assumed that the drive is still failed.
.end

# release restore job?
.index 101
The given drive is the original drive previous to some hot-spare
operation.  If you select YES, a hot-restore operation will be released
in the job queue and restore the original array drive configurations.
.end

#######################################

# Hot spare options
.index 40 Hot-Spare Method
.index 41 Pre-Format Spare
.index 42 Day to spare
.index 43 Time to spare
.index 44 Spare Pool
.index 45 Select Spares
Hot Spare Options

- Hot-Spare Method
    Select automatic hot-sparing, manual or off.
- Pre-Format Spare
    Set pre low-level formatting before hot-sparing.
- Day To Spare
    Set day that hot-spares occur after a drive failure.
- Time To Spare
    Set time that hot-spares occur after a drive failure.
- Spare Pool
    Select whether all unassigned drive or selected drives are spares.
- Select Spares
    Select which unassigned drives are spares.
.end

.index 103
Hot Spare Method

Automatic - A drive failure will cause a hot-spare operation to
    automatically occur.

Manual - A drive failure will cause a hot-spare job to be queued
    in a suspend state.  The job must be manually released by a user
    using the Scheduled Jobs Queue Maintenance operations.

Off - No hot-spare will occur when a drive failure occurs.
.end

.index 105
Pre Low-Level Format Before Hot-Sparing

Select whether you want spare drives to be low-level formatted before
a hot-spare rebuilds take place.
.end

# Day to spare
.index 17
Day Of Failure

Upon drive failure, a hot-spare will take place on the same day
as the failure.
.end
.index 15
Day Of Week

Upon drive failure, a hot-spare job will execute on the
selected day of week following the failure.
.end

# Time to spare
.index 18
Time Of Failure

Upon drive failure, a hot-spare will take place immediately
after the failure occurs if the hot-spare day is 'Day of failure'.
If the spare day is set to a day of week, the hot-spare
will occur on 12:01am of the specified day of week following
the failure.
.end
.index 16
Time Selection

Upon drive failure, a hot-spare job will execute on the specified
hour following the failure.  If the spare day is set to some
day of week, the hot-spare will occur on that day of week on the
selected hour following the failure.
.end

.index 104
Spare Pool

Unassigned Drives - All physical drives that are not assigned to any
    array drives are candidates for spare drives.

Selected Drives - Only selected drives are candidates for spare
    drives.
.end

.index 68
Select Spares

Select drives that may be used as spare drives.

Use the up and down arrow keys move the selection bar and use the
ENTER key to toggle the spare drive mark.  The check-marked drives
become part of the spare pool.

Use ESC to exit.
.end

# no drives may be used as spare.
.index 102
All physical drives are either currently assigned to some 
array drive or failed, none are unassigned and therefore 
may not become spare drives.
.end

#####################################

# notification options
.index 48 drive failures
.index 49 job completions
.index 50 group
User Notification Options

Drive Failure      - Notify users upon drive failures.
Job Completion     - Notify users upon drive completions.
Notification Group - Select notification group.
.end

.index 106
Select whether to notify users upon drive failures.
.end

.index 107
Select whether to notify users upon queue job completions.
.end

.index 69
Select notification Group

Use the up and down arrow keys to move the selection bar over
the desired group to notify.  Press ENTER to select the group.
.end

.index 110
Silence Alarm(s)

Audible alarms on all available controllers will be silenced.
.end

.index 111
Change Log File Name
Type in the new drive/path/filename of the log file.
Press ENTER to accept the new name.
Press ESC to abort.
.end


####################################

# suspend  or delete wait or ready job
.index 112
Select 'Suspend' to suspend the selected job indefinitely.
Select 'Delete' to remove the selected job from the queue.
.end

# release or delete hold job
.index 113
Select 'Release' to release the selected job for execution.
If the job has an execution time, the job will not execute
until the execution time is reached.

Select 'Delete' to remove the selected job from the queue.
.end

# maintenance queue list
.index 70
.index 71
.index 72
.index 73
.index 74
Use the up and down arrow keys to move the selection bar over
the job that you want to change.  Press ENTER to select the job.

You may not perform any operations on jobs that are executing
or completed.
.end

