
#######################################################################
#         Silicon Image SiI SATA controller                           #
#               RedHat Linux  Driver     	                      #
#######################################################################


1. OVERVIEW

   This driver disk adds support for the SiI 3531 SATA controller and overrides the Open Source Driver if it is contained in the CD-ROM.

   Supported RedHat Linux versions:

      * RedHat Enterprise Linux 4 Update 2, Kernel revision 2.6.9-22.
      * This driver rev. 1.0.9.2 supports 32-bit AMD/Intel platforms for SiI3531 controller with RAID 5, port multiplier, and hot-plug capability.


2. INSTALLATION

   For detailed information about RedHat installation visit:
    http://www.redhat.com/docs/manuals/

   IMPORTANT NOTE FOR OEM CUSTOMERS:
        ADD your PCI ID to the "pcitable" file if OEM VendorId is going to be different 
        from SiI 0x1095 IDs. (End Users should ignore this step.) 

   2.1 PREPARING DRIVER DISK

   A floppy disk is required to install into a brand new (or blank) disk drive. 

   If you received the driver in an xxx.img format, create a floppy containing the drivers under Linux by 'dd' as follows:

      dd if=file_name.img of=/dev/fd0  (In a Linux System)
      where filename will change with the distribution used.
       
   If you received a zip file, use Winzip to unzip the [distribution]filename.zip file on to a formatted floppy disk.

   2.2 FRESH INSTALLATION TO A BOOT DRIVE

   Before you start make sure the BIOS sees your adapter card (if applicable) and
    your disk drives.
    
   If just adding Data Drives or upgrading, go to sections 3 or 4.
     (Non-bootable SATA drives are considered as data drives.)

   The following BIOS BOOT sequence is recommended => CD, Hard Disk, Floppy.
 
   Installing the SiI Driver currently requires some manual intervention.
   Boot from the CD 1.

   When you get to the screen shown in figure 1, get a shell prompt ([Ctrl]-[Alt]-[F2]) and execute the initial_install script as followings to install the driver for boot disk:


   # mkdir /f   
   # mount /dev/fd0 /f
   # cd /f
   # ./initial_install.sh



                    Figure 1:


                    | Warning |

         No hard drives have been found.
         You probably need to manually
         choose device drivers for the
      for the installation to succeed. Would
      you like to select drivers now?

        | Yes |                        | No |                   
               



   Once the driver is installed select  'No' and then 'Done' on the next two screens.      Continue with the installation and follow the system instructions and swap the CDs as directed.

   At the end,  go to shell prompt ([Ctrl]-[Alt]-[F2]) to run the script below BEFORE REBOOTING.

   ./upgrade_driver.sh 


   This last step writes all the drivers permanently into the kernel.

   Go back to the last screen (such as [Ctrl]-[Alt]-[F7]) to reboot the system. Installation of boot disk at this point is completed.

   Please note, all ATA/ATAPI devices connected to SiI controller will be presented as SCSI devices.


3. ACCESS A SATA DISK AS DATA DRIVE WITHOUT UPGRADING THE KERNEL	
    
     If your system is already up and running, you can add loadable modules to access the SATA drives by the followings:

     . Unload the open source driver for Silicon Image controllers if it was loaded.

     . # mount /mnt/floppy or mount /media/floppy, whichever is appropriate.
          in case of DOS formatted floppy
          . # mount -t vfat /dev/fd0 /mnt/floppy  

     . Type "modules.cgz | gunzip | cpio -ivH crc" to
       unzip the driver tree and select the appropriate driver file for your system.
     
     . Install the driver by adding the following lines at the end of the script in /etc/rc.d/rc.sysinit

       'insmod scsi_mod'
       'insmod si3531r5'

     The SATA data drive would be available at next time when system reboot. At this point you are done with the installation 

     . If you want to permanently have access to your SATA drives we recommend
       you upgrade to kernel as shown below.
   


4. UPGRADE THE KERNEL TO ACCESS SATA AS DATA DRIVES

     If your system is already up and running, you can use shell scripts to modify
     the kernel or add loadable modules to access the SATA drives as followings:

     . Unload the open source driver for Silicon Image controllers if it was loaded.

     . # mount /mnt/floppy or mount /media/floppy, whichever is appropriate.
         in case of DOS formatted floppy
         . # mount -t vfat /dev/fd0 /mnt/floppy  

     . # 'sh /mnt/floppy/load-driver-from-floppy.sh'  (DATA DRIVES)  
         (or use the the proper script depending on your kernel)

     . If you received a zipped file, unzip the file and copy the modules.cgz
       to a destination directory. Type "modules.cgz | gunzip | cpio -ivH crc" to
       unzip the driver tree and load the appropriate driver file to your system.

     . if you want to make sure you can see the drives, you may want
       to 'mke2fs /dev/sda' and 'mount /dev/sda /test' the hard disk(s)

     . insmod si3531r5. As an example add the following lines at the end
       of the script in /etc/rc.d/rc.sysinit

       'insmod scsi_mod'
       'insmod si3531r5'

     . # ./mnt/floppy/upgrade_driver.sh
          /etc/lilo.conf and /boot/grub/grub.conf will be saved by the setup
          script. You may back them up as you wish. Visually inspect lilo.conf and 
          grub.conf to make sure the result is what you want.
   
5.   GENERAL INFO

   . If you cat /proc/scsi/Si3*/* you should see the Driver as reported by
     the kernel.

   . If you cat /proc/scsi/scsi you should see the your DRIVE TYPE as reported
     by the kernel.


6. New Features and bug fixes

   This revision has fixed a system hang issue when unload a driver after unplugging a drive from SV2000 BOX.

7. Known Restrictions

   1. The ATAPI CD/DVD write is not ready. Please also note that ATAPI hot plug is not expected.
   2. Do not form a raid5 set while any of its members were rebuilding for another raid set.
   3. Fail to detect a device that is plugged in after driver is loaded.


Console Keystrokes Contents:

1 [Ctrl]-[Alt]-[F1] installation dialog 
2 [Ctrl]-[Alt]-[F2] shell prompt 
3 [Ctrl]-[Alt]-[F3] install log (messages from installation program) 
4 [Ctrl]-[Alt]-[F4] system-related messages 
5 [Ctrl]-[Alt]-[F5] other messages 
7 [Ctrl]-[Alt]-[F7] X graphical display


8. To run the Raid5 GUI,

	1. Raid5 Driver need to be loaded before running GUI.
	2. Install jre (Java Runtime Environment), the jre revision needs to be 1.5.0 or above.
	3. Run daemon by entering SATARaid5Daemon32_RH&, or SATARaid5Daemon_xxxx& depending on platforms.
	4. Run Raid5 GUI by execute script ./SATARaid5Manager, you might need to modify the script to specify the path of the java directory.


