This README is your full source of information for our driver installation. Storage Manager and DPTUTIL installation instructions and files can be obtained separately from www.adaptec.com

1. Section one contains a description of the dpti2olinux.zip file and drivers required for your specific distribution.
2. Section two contains all the specific installation instructions for your distribution.
3. Section three contains information for creating custom drivers from source, including directions on how to install the patches and source.

   DPT/Adaptec provides 'out of the box' support for the following distributions along with their native kernels:

     Red Hat 6.0, 6.1 and 6.2
     SUSE 6.3 and 6.4.

   If your distribution is not listed, or you do not wish to use a module driver, then you will need to proceed directly to Section III and create your own driver for your distribution. Using drivers not specifically created for your kernel/distro may have unexpected results and is not recommended.

4. Section four contains FAQ about our driver installations and problems you may encounter.

******************************************************************************
*    Although we strive for accuracy, we may occasionally miss something.    *
*    Therefore, should you find any errors or omissions in this document,    *
*    or you have any suggestions, we invite you to send an                   * 
*    e-mail to support@dpt.com or telephone us at (321) 207-2000.            *
******************************************************************************

1. This README
2. i2orh61.zip   <---Red Hat 6.1 module driver
3. i2orh62.zip   <---Red Hat 6.2 module driver
4. 106_2.tgz   <---the actual driver source code for kernel 2.2.5
5. 106_2pat.gz   <---driver source code patch for 2.2.5
6. 109pat.gz   <---base source patch for the 2.2.12-20 kernel
7. dptdriver-1.12-9.1.i386.rpm <---- a really great rpm that will install our driver on Red Hat 6.0, 6.1, 6.2 and SUSE 6.3, 6.4.

1. Red Hat 6.0 module driver for a fresh linux installation
2. Red Hat 6.1 or 6.2 module driver for a fresh linux installation
3. Installing the driver RPM
4. Installing SMARTRAID V/VI as a secondary controller on RedHat 6.1/6.2

*** FOR THIS INSTALLATION YOU WILL BE USING BOTH THE rh60root.zip ***
*** and rh60boot.zip files which you can obtain from the ftp server ***

Linux DPT SmartRAID V and VI HOWTO
Distributed Processing Technology Corp. (http://www.dpt.com)
v1.3, June 27, 2000

How to install a DPT SmartRAID V & VI controller under RedHat Linux 6.0.

1. Introduction
2. Supported controllers
3. What hardware should be used?
4. Installation
   4.1 Installing and configuring the hardware
   4.2 Installing Linux and a DPT SmartRAID V Controller
   4.3 Applying Kernel Update 2.2.5-22
5. Troubleshooting
   5.1 RAID configuration shows up as N different disks
   5.2 If all fails...
   5.3 Contacting DPT
6. References

1. Introduction

   This document describes how to install the Linux I2O driver for DPT SmartRAID V & VI SCSI RAID controllers.

2. Supported controllers

   These instructions are for DPT SmartRAID V & VI controllers. These controllers use an I2O device interface and require a different driver than the one used for earlier DPT SCSI RAID controllers.

   If you have an earlier model DPT controller, see the DPT Hardware RAID HOWTO for specific instructions. SmartRAID V controllers are not compatible with the previous EATA-DMA driver used for older model DPT controllers.

3. What hardware should be used?

   This HOWTO assumes you are installing both the Linux OS (kernel version 2.0 or 2.2) and the controller in a computer system for the first time. Your computer must be compliant with the PCI 2.1 specification and have at least one free PCI slot that can accommodate a full length card if necessary.

4. Installation
   4.1. Installing and configuring the hardware

   Refer to the DPT SmartRAID V or VI User's Manual to install the controller. A current version of the SmartRAID V and VI manual in PDF format is available on the DPT web site. Refer to your system documentation for information on installing disk drives and additional hardware.

   After the hardware is installed, boot the system. The system BIOS should detect and configure the DPT controller hardware automatically. You can use the DPT Storage Manager on ROM (SMOR) utility to configure your disk drives and create RAID groups, if necessary. When the DPT I2O BIOS message appears, press Ctrl+D to activate SMOR.

   4.2. Installing Linux and a DPT SmartRAID V or VI Controller

   The DPT I2O driver install for Red Hat Linux 6.0 has 2 disks. Disk 1 is a boot disk with the Linux install program and Disk 2/Root Disk contains supplemental files for the DPT I2O driver installation.

   When you boot from Disk 1, you will see a menu that gives you the choices of a regular install, expert mode and help mode.

   1. For the regular install, press Enter. For the expert install, type "expert" and press Enter.
   2. Root Disk. Insert the DPT Disk 2 to continue.
   3. Choose a Language. Select the appropriate one.
   4. Keyboard Type. Choose the appropriate one.
   5. Installation Method. This defaults to Local CDROM and Force supplemental disk is checked. If you chose the Expert mode, be sure the Force supplemental disk option is not checked.
   6. The next screen asks if the Red Hat CD is in your CD-ROM drive. If not, insert the Red Hat CD at this time.
   7. CDROM Type. Choose the appropriate one.

      NOTE:   If you are using an IDE CDROM, this will automatically initialize the drive.

   8. Press Enter to start a search for the DPT I2O controller. After finding the controller, you are prompted for additional SCSI adapters. If you are using an additional SCSI adapter, choose the appropriate one.
   9. Installation Path. Choose the appropriate one (new installation or upgrade).
   10. Installation Class. Choose the appropriate one. The instructions are similar for each one, except for what is loaded for each choice.
   11. Disk Setup. Choose either Disk Druid or fdisk to partition the drive.
   12. Partition Disks. Choose which disks to partition. For fdisk, if you click on the Edit button, a command line prompt is displayed. For help using fdisk, type "m".

       After partitioning the drives, you are returned to the graphical screen. Click on Done to continue.

   13. The next screen shows the current disk partitions, including the mount point, device, requested space for device and type of partition.

       NOTE:   Linux requires the partition dedicated to the swap file to be not more than 127 MB.

       Choose the partition you want to create as the root and click on Edit.

   14. Edit Partition. Type / in the Mount Point field to make that drive the root.

       If you have multiple drives, create the path for the additional drives such that it is different from the root, such as: /usr or /usr/rac.

       After creating the mounting points, highlight OK to continue with installation.

   15. Active Swap Space. Choose the appropriate partition created in step 14.
   16. Partitions to Format. Choose the partitions you want to format.
   17. Components to Install. If you chose Workstation or Server the installation continues.

       If you chose Custom you can choose what components you want to install from Red Hat Linux.

       The choice has no effect on installing the DPT controller and I2O driver.

       If you choose Custom, after installing the components you selected, the installation will continue.

   18. Probing Result. First the type of mouse is detected. Choose the appropriate mouse.

       Next the PCI slots are probed. If you have a PCI video adapter, it will find the device, install drivers and then ask about Monitor Setup. Choose the appropriate one. Depending on the monitor you use, the system will either probe or not probe the monitor.

   19. Network Configuration. Follow the directions for the LAN configuration install. If you are not using a local area network, You can bypass this screen.
   20. Configure the time zone.
   21. Services. Choose the appropriate ones.
   22. Configure your printer.
   23. Choose a root password. The password must be at least 6 characters long.
   24. After the driver is installed, choose whether to make a bootdisk or not.
   25. Lilo Installation. Choose where you want to install the bootloader. Default is normally /dev/sda Master Boot Record.
   26. After choosing the boot loader location, follow the instructions for the next screen.

       If there are no special instructions, press OK to continue. A LILO RAMDISK will be created. The installation is now complete.

   4.3 Applying Kernel Update 2.2.5-22

   This procedure should be used after updating your kernel to 2.2.5-22. This ensures that your DPT I2O driver is still installed correctly with the new kernel. For additional information about this kernel update, see http://www.redhat.com/corp/support/errata/kernel99_06_03.html

   1. Install the 2.2.5-22 or 2.2.5-22smp kernel from RedHat, but do not reboot yet.
   2. Create the following directory if it does not already exist:

            mkdir -p /lib/modules/2.2.5-22/scsi
          

      (or if on an SMP machine):

            mkdir -p /lib/modules/2.2.5-22smp/scsi
           

   3. Copy the dpt_i2o.o driver to that directory:

            cp dpt_i2o.o /lib/modules/2.2.5-22/scsi
          

      (SMP equivalent; note that the driver is renamed in the target directory):

            cp dpt_i2o_smp.o /lib/modules/2.2.5-22smp/scsi/dpt_i2o.o
          

   4. Create an initial ramdisk with the dpt_i2o driver in it in the /boot directory:

            cd /boot ; mkinitrd initrd-2.2.5-22.img 2.2.5-22
          

      (SMP equivalent):

            cd /boot ; mkinitrd initrd-2.2.5-22smp.img 2.2.5-22smp
          

   5. Edit the /etc/lilo.conf file. Add or replace the image and initrd entries:

            image=/boot/vmlinuz-2.2.5-22
            initrd=/boot/initrd-2.2.5-22.img
          

      (SMP equivalent):

             image=/boot/vmlinuz-2.2.5-22smp
             initrd=/boot/initrd-2.2.5-22smp.img
          

   6. Run lilo: lilo
   7. Reboot: shutdown -hr now
5. Troubleshooting

   5.1. RAID configuration shows up as N different disks

   The disk array is not configured properly. If you are using the DPT SMOR utility, you need to configure the RAID disks as a single logical array.

   5.2. If all fails...

   Read the SCSI-HOWTO again. Check the cabling and the termination. Try a different machine if you have access to one. The most common cause of problems with SCSI devices and drivers is faulty or misconfigured hardware.

   5.3. Contacting DPT

   You can contact DPT Technical Support for assistance.

   E-mail: <support@dpt.com>
   Phone: (321) 207-2000

6. References

   The following documents may prove useful as you set up RAID:

   DPT RAID Primer and other RAID/SCSI-related documents
   <http://www.dpt.com/>
   navigate to the Tech Library, Technical Support or Documentation pages.

   Linux Kernel HOWTO
   <http://metalab.unc.edu/LDP/HOWTO/Kernel-HOWTO.html>

   Linux DPT Hardware RAID HOWTO
   <http://metalab.unc.edu/LDP/HOWTO/mini/DPT-Hardware-RAID.html>

   EATA-DMA homepage (for older DPT controllers)
   <http://www.uni-mainz.de/~neuffer/scsi/dpt/index.html>

*** FOR THIS INSTALLATION YOU WILL BE USING THE ***
*** i2orh61.zip or i2orh62.zip files. ***

Linux DPT SmartRAID V and VI HOWTO
Distributed Processing Technology Corp. (http://www.dpt.com)
v1.3, June 27, 2000

How to install a DPT SmartRAID V/VI controller on RedHat Linux 6.1 or 6.2.

1. Introduction
2. Supported controllers
3. What hardware should be used?
4. Installation
   4.1 Installing and configuring the hardware
   4.2 Installing Linux and a DPT SmartRAID V Controller
5. Troubleshooting
   5.1 RAID configuration shows up as N different disks
   5.2 If all fails...
   5.3 Contacting DPT
6. References

1. Introduction

   This document describes how to install the Red Hat Linux I2O driver for DPT SmartRAID V or VI SCSI RAID controllers.

2. Supported controllers

   These instructions are for DPT SmartRAID V and VI controllers. These controllers use an I2O device interface and require a different driver than the one used for earlier DPT SCSI RAID controllers.

   If you have an earlier model DPT controller, see the DPT Hardware RAID HOWTO for specific instructions. SmartRAID V and VI controllers are not compatible with the previous EATA-DMA driver used for older model DPT controllers.

3. What hardware should be used?

   This HOWTO assumes you are installing both the Red Hat Linux 6.1 or 6.2 operating system and the controller in a computer system for the first time. Your computer must be compliant with the PCI 2.1 specification and have at least one free PCI slot that can accommodate a full length card if necessary.

4. Installation

   4.1. Installing and configuring the hardware

   Refer to the DPT SmartRAID V User's Manual to install the controller. A current version of the SmartRAID V and VI manuals in PDF format are available on the DPT web site. Refer to your system documentation for information on installing disk drives and additional hardware.

   After the hardware is installed, boot the system. The system BIOS should detect and configure the DPT controller automatically. You can use the DPT Storage Manager on ROM (SMOR) utility to configure your disk drives and create RAID groups, if necessary. When the DPT I2O BIOS message appears, press Ctrl+D to activate SMOR.

   4.2. Installing Linux and a DPT SmartRAID V or VI Controller

   The DPT I2O driver files for Red Hat Linux 6.1 and 6.2 are on one disk.

   NOTE Any partitions created on disks that are not part of an array will be unavailable if you subsequently use the disk in a RAID configuration. If your hard drives do not have partition tables or do not contain a recognizable partition), you will be prompted to initialize these disks. The operating system can automatically remove the data or you can manually partition the drives. For more information, refer to the Red Hat documentation.

   1. Boot the system with the Red Hat Linux boot diskette in the floppy drive and CD Disk 1 in your CD-ROM drive.
   2. When the Red Hat Welcome screen appears, type:

          expert
          

      at the boot: prompt.
   3. When prompted, insert the DPT driver diskette and press OK.
   4. You will be prompted for the language and keyboard type.
   5. You will be asked to specify the location of the media packages to be installed.

      If you are installing from CD-ROM, select Local CD-ROM. If you selected CD-ROM, you will be asked what type of CD-ROM you have.

   6. The system will ask you to specify a driver. Scroll down and select the DPT I2O driver.
   7. The system will inform you that it has found DPT I2O SmartRAID.
   8. Unless there are other third party devices to install in your system, select Done.
   Continue with the Red Hat Linux installation according to the Red Hat documentation.
5. Troubleshooting 5.1. RAID configuration shows up as N different disks The disk array is not configured properly. If you are using the DPT SMOR utility, you need to configure the RAID disks as a single logical array. 5.2. If all fails... Read the SCSI-HOWTO again. Check the cabling and the termination. Try a different machine if you have access to one. The most common cause of problems with SCSI devices and drivers is faulty or misconfigured hardware. 5.3. Contacting DPT You can contact DPT Technical Support for assistance. E-mail: Phone: 321-207-2000
6. References

   The following documents may prove useful as you set up RAID:

   DPT RAID Primer and other RAID/SCSI-related documents
   <http://www.dpt.com/>
   navigate to the Tech Library, Technical Support or Documentation pages.

   Linux Kernel HOWTO
   <http://metalab.unc.edu/LDP/HOWTO/Kernel-HOWTO.html>

   Linux DPT Hardware RAID HOWTO
   <http://metalab.unc.edu/LDP/HOWTO/mini/DPT-Hardware-RAID.html>

   EATA-DMA homepage (for older DPT controllers)
   <http://www.uni-mainz.de/~neuffer/scsi/dpt/index.html>

1. Mount the floppy containing the RPM to it's mount point. Example:

   		mount -t msdos /dev/fd0 /mnt/floppy
   

   - OR - Copy the rpm to your hard drive.
2. Change to the installation directory and type:

   	rpm -Uvh dptdriver-1.12-9.1.i386.rpm
   	

*** The following installations require the i2orh61.zip ***
*** or i2orh62.zip module drivers ***
*** Alternatively you can use the RPM driver ***

To install the module driver: (Assuming a NON SMP machine)

1. Mount the DPT Red Hat 6.1 driver disk.

   	mount -t msdos /dev/fd0 /mnt/floppy
   	

2. Extract the driver using the following commands:

   	cd /lib/modules
   	mkdir -p 2.2.12-20/scsi
   	gzip -cd /mnt/floppy/modules.cgz | cpio -i 2.2.12/dpt_i2o.o
   	mv 2.2.12-20/dpt_i2o.o 2.2.12-20/scsi
   	

3. Modify or verify that your scsi_hostadapter entries in your local /etc/conf.modules file are numbered starting with 1:

   For example:

   	alias scsi_hostadapter1 dpt_i2o
   	

4. Reboot your server; or alternatively do a depmod -a; insmod dpt_i2o
5. FDISK, mkfs, and create a mount point for your new drives.

1. Unzip and copy the RedHat 6.2 driver module files to a floppy disk.
2. Mount the floppy

   	mount -t msdos /dev/fd0 /mnt/floppy  
   	

3. Create the following directory

   	cd /lib/modules     
   	mkdir -p 2.2.14-5.0/scsi   
   	

   (ensure that 2.2.14-5.0 is the full name of your kernel, just ensure you keep the same kernel number throughout)
4. Extract the driver using the following commands:

   	gzip -cd /mnt/floppy/modules.cgz | cpio -i 2.2.14/dpt_i2o.o
   	mv 2.2.14-5.0/dpt_i2o.o 2.2.14-5.0/scsi
   	

5. Check your /etc/modules.conf directory to ensure there is a reference to your dpt controller(s), if not then use your favourite text editor to add the lines:

   Example:

   	alias scsi_hostadapter1 dpt_i2o
   	

6. Reboot your server or do a depmod -a; then insmod dpt_i2o.
7. FDISK, mkfs, and create a mount point for your new drives.

Depending on your kernel, you may be able to build a custom driver from source.

For Kernel Version	   you will need	Source + Patch
-------------------         			---------------
2.2.5								106_2.tgz + 106_2pat.gz
2.2.12								106_2.tgz + 109pat
2.2.14								106_2.tgz + 109pat
2.2.15								106_2.tgz + 109pat

Uncompressing Information
For the tar file (assuming 106_2.tgz is in the /tmp directory):

cd /usr/src/linux ; gzip -cd /tmp/106_2.tgz | tar xvf - 

For the patch (assuming 106_2pat.gz is in the /tmp directory):

cd /usr/src/linux ; gzip -cd /tmp/106_2pat.gz | patch -p1 

Example. A previously installed 106 patch:

		cd /usr/src/linux ; gzip -cd /tmp/106_2pat.gz | patch -p1 -R 
		(this will reverse the 106 patch)
		
		gzip -cd /tmp/109patch.gz | patch -p1 (apply the 109 patch)
		
		

			in file dpt_i2o.h add
		
			#include "osd_util.h"
		

1. After installing the proper source files, you will need to change to the /usr/src/linux directory

   	    # cd /usr/src/linux
   		

   (note: this directory is a soft link to your kernel)

   Use either 'make config', . make menuconfig. (or if in graphical mode) . make xconfig. to start the menu selection of kernel options.

       # make menuconfig
   		

   (The dpt_i2o driver can be found under SCSI Support - SCSI low-level drivers. Make sure to select this box to load as a module (you will see an (M) or a (*) next to this selection if it was done correctly).)

   Save your new configuration and exit.

2. At the command line type:

       # make dep clean && make bzImage modules && make modules_install 
   	

3. Boot your new kernel.

   For full source of information on compiling your kernel, please utilize the following link:

   http://www.redhat.com/mirrors/LDP/HOWTO/Kernel-HOWTO.html