-------------------------------------
   INSTALL for scsirastools source 
-------------------------------------

The scsirastools source package provides certain SCSI serviceability tools.

To build this package:
    configure
    make
To install this package, use one of the following:
    make install  
    make rpm
Make rpm produces a binary rpm, and a source rpm, which can be installed
with "rpm -i".

This has been tested on i386 and ia64 architectures, but shouldn't 
have any limitations on other architectures. 

---------------------
   DESCRIPTION
---------------------

These scsirastools were designed to add to the Serviceability of SCSI devices 
under Linux so that the system does not have to be rebooted or taken out
of service to perform common maintenance or service functions.
These tools are currently provided, and man(8) pages for each of the 
tools are also included.
sgdefects    = tool to read the primary and grown defect lists
sgdskfl      = tool to load disk firmware to SCSI disks under Linux
sgdiag       = tool to perform format & other test functions
sgmode       = tool to get and set SCSI mode pages
sgraidmon    = tool to monitor software RAID disks for hot-insertion/removal
getmd        = tool to parse /etc/raidtab for devices (used in mdmon)
mdadm        = tool to administer and configure md raid devices

mdevt        = script to take actions when remove/insert events occur
mdmon        = script to monitor md raid for remove/insert events (uses mdadm)
               Note that this cannot handle insertion events.  (for test only)

UserGuide    = UserGuide for scsirastools
sgdefects.8  = man page for sgdefects
sgdskfl.8    = man page for sgdskfl
sgdiag.8     = man page for sgdiag
sgmode.8     = man page for sgmode
sgraidmon.8  = man page for sgraidmon
mdadm.8      = man page for mdadm
files/md*.sh = scripts to configure a software root mirror (from UserGuide 4.x)

atlasu32.mdf = mode pages for MAXTOR   ATLASU320_36_SCA
ddys-t09.mdf = mode pages for IBM      DDYS-T09170M
dpss-309.mdf = mode pages for IBM      DPSS-309170N
dk32dj-1.mdf = mode pages for HITACHI  DK32DJ-18MW
dk32dj-3.mdf = mode pages for HITACHI  DK32DJ-36MW
man3184m.mdf = mode pages for FUJITSU  MAN3183MP
man3367m.mdf = mode pages for FUJITSU  MAN3367MP
map3147n.mdf = mode pages for FUJITSU  MAP3147NC
st318406.mdf = mode pages for SEAGATE  ST318406LC 
st318452.mdf = mode pages for SEAGATE  ST318452LW 
st336605.mdf = mode pages for SEAGATE  ST336605LW 
st336607.mdf = mode pages for SEAGATE  ST336607LW 
st336752.mdf = mode pages for SEAGATE  ST336752LW 
st373405.mdf = mode pages for SEAGATE  ST373405LW
st39173w.mdf = mode pages for SEAGATE  ST39173W
st39173l.mdf = mode pages for SEAGATE  ST39173LW

Various firmware images were tested, but are not included with
scsirastools source or rpms.  This includes the following sample
images for each disk model.   Please contact your disk hardware
vendor for current firmware image files for your particular
disk model.
atlasu32.lod = disk firmware ver B300 for MAXTOR   ATLASU320_36_SCA
dpss-309.lod = disk firmware ver S9HA for IBM      DPSS-309170N
dk32dj-1.lod = disk firmware ver AAAA for HITACHI  DK32DJ-18MW
dk32dj-3.lod = disk firmware ver AAAA for HITACHI  DK32DJ-36MW
man3184m.lod = disk firmware ver 0107 for FUJITSU  MAN3183MP
man3367m.lod = disk firmware ver 0107 for FUJITSU  MAN3367MP
st318452.lod = disk firmware ver 0002 for SEAGATE  ST318452LW
st336752.lod = disk firmware ver 0002 for SEAGATE  ST336752LW
st373405.mdf = disk firmware ver 0003 for SEAGATE  ST373405LW
st39173w.lod = disk firmware ver 6621 for SEAGATE  ST39173W
st39173w.tms = disk servo    ver 6015 for SEAGATE  ST39173W
st39173l.lod = disk firmware ver 6632 for SEAGATE  ST39173LW

---------------------
   DEPENDENCIES
---------------------
The scsirastools do depend on the CONFIG_CHR_DEV_SG parameter being on (y or m)
in the kernel configuration used at runtime (see /usr/src/linux/.config).
The default kernels supplied in most distributions should already have
this parameter turned on.
 
The utility mdadm is used by the mdevt & mdmon scripts.  This makefile
will build mdadm version 1.3.0 in a subdirectory.
This version is available at:
   http://www.cse.unsw.edu.au/~neilb/source/mdadm/mdadm-1.3.0.tgz
   http://www.cse.unsw.edu.au/~neilb/source/mdadm/RPM/mdadm-1.3.0-1.i386.rpm
For version updates, etc., see
   http://www.cse.unsw.edu.au/~neilb/source/mdadm/

If you have an Adaptec 79XX U320 chipset, you should use the aic79xx driver
version 1.3.2 or greater.  See http://people.freebsd.org/~gibbs/linux/ for
the current aic79xx version.

There are also scsiras kernel patches (kern/*) associated with this project,
which have additional hardening and enhancements, but the scsirastools
utilities are not dependent upon the scsiras kernel patches.

---------------------
   PROBLEMS
---------------------
Please supply the contents of the /var/log/sg*.log file with any problem report.
Note that each tool has an option for additional debug output (-x).

See http://sourceforge.net/projects/scsirastools/ for a bug list and
any later versions of this utility.

------------------------------

