MegaPR for Linux Utility for PERC RAID
========================================

MegaPR for Linux is a utility that allows the user to start and stop Patrol
Read on specified PERC controllers from the Linux environment. MegaPR can also
display the current status of Patrol Read on a given PERC controller. Online
help is available by typing 'megapr ?'. For further information concerning
Patrol Read, see the latest PERC User's Guide on http://support.dell.com. 

This package contains a RAID management application for Linux for use with the
following controllers:

    PERC 4e/Di, 4e/Si, 4e/DC
    PERC 4/Di, 4/DC, 4/SC
    PERC 3/QC, 3/DC, 3/DCL, 3/SC


Compatibility / Minimum Requirements
====================================

This utility is compatible with the following firmware versions:

Controller         Minimum firmware level    Description

PERC 3/QC          198Q                      PERC 3 Quad Channel
PERC 3/DC          198Q                      PERC 3 Dual Channel
PERC 3/DCL         198Q                      PERC 3 Dual Channel Lite
PERC 3/SC          198Q                      PERC 3 Single Channel
PERC 4/Di          421Q                      PERC 4 Integrated on PE 1750
PERC 4/Di          251Q                      PERC 4 Integrated on PE 2600
PERC 4/SC          351Q                      PERC 4 Single Channel
PERC 4/DC          351Q                      PERC 4 Dual Channel
PERC 4e/Di         521Q                      PERC 4e Integrated on PE 2800, 2850, 6800, 6850
PERC 4e/Si         521Q                      PERC 4e Integrated on PE 1850
PERC 4e/DC         521Q                      PERC 4e Dual Channel

NOTE: MegaPR is only supported on the firmware listed or later versions. Do not
      run MegaPR on controllers with firmware earlier than the versions listed
      above.


Installation Instructions
=========================

Download 
--------
1. Click the Download Now link to download the file.
2. If the Export Compliance Disclaimer window appears, click the I agree link
   to accept the agreement.
3. When the File Download window appears, click Save to save the file to your
   hard drive.


Extract Files
-------------
1. From a Linux command shell, change to the directory where the
   MegaPR_Linux_A02.tar.gz file was downloaded.
2. Extract the files by typing:

   tar xvzf MegaPR_Linux_A02.tar.gz

   This command will extract the contents of MegaPR_Linux_A02.tar.gz
   into the same directory where the downloaded file is located.
   
NOTE: Winzip may not extract the files correctly under Microsoft Windows.   


Install RPM
-----------
To install the MegaPR package, type the following from the directory
where the RPM is located:

rpm -ihv megapr-1.03-1.i386.rpm

This will install two files in the /usr/sbin directory:

megapr : script to call megapr binary
megapr.bin : binary for megapr utility 

After installation, type 'megapr' to run the utility.


Uninstall RPM
-------------
To uninstall the MegaPR RPM:

rpm -e megapr


Files included in this release:
-------------------------------

megapr-1.03-1.i386.rpm
  - RPM installation package

MegaPR_Linux_A02.txt
  - MegaPR for Linux readme file


Usage:
======

MegaPR is invoked by typing 'megapr'. 

Available options are:

1. -dispPR: Display Patrol Read status for a specified PERC controller.
2. -startPR: Start Patrol Read on a specified PERC controller.
3. -stopPR: Stop Patrol Read on a specified PERC controller.

Help is available for individual options by typing 'megapr -[option] ?'

The correct PERC adapter number must be specified after each command.

For example, to start a Patrol Read iteration on adapter 0, type:

   megapr -startPR -a0

NOTE: MegaPR is only supported on the firmware listed or later versions. Do not
      run MegaPR on controllers with firmware earlier than the versions listed
      in the Compatibility/Minimum Requirements section of this document.


Additional Information
======================

- MegaPR will display 'Option not supported for adp 0' for any operations
  attempted when Patrol Read mode for the controller is set to Disable. The
  adapter number referenced in the message will correspond to the adapter
  number specified in the MegaPR command. The Patrol Read mode must be set to
  Auto or Manual for MegaPR to start or stop a PR iteration. To change the 
  Patrol Read mode on an adapter, enter the PERC BIOS configuration utility by
  pressing CTRL+M at controller initialization during system POST. Go to
  Objects, and then select the Adapter menu. If multiple adapters are in the
  server, select the appropriate adapter. Now choose Patrol Read Options.
  Change the Patrol Read Mode to Auto or Manual. MegaPR will now be able to
  start, stop, or display status for Patrol Read from Linux.

- Typing 'megapr ?' displays help information for the MegaPR utility. The
  example given for command specific help displays '-ctlrInfo ?', which is not
  a supported option. Supported options include -dispPR, -startPR, and -stopPR.
  
- For further information concerning the MegaPR utility or the Patrol Read
  feature, see the latest PERC User's Guide on http://support.dell.com.


Fixes and Enhancements
======================

Initial release of MegaPR for Linux.