ARECA SATA RAID CONTROLLER
                               ARC11XX/ARC12XX
                                 S.u.S.E. 9.0 x86_64 Linux

     ===================  Driver User's Guide  =======================

	Linux SCSI driver technical support
	mail address: erich@areca.com.tw
	         Tel: 886-2-8797-4060 Ext.203
	         Fax: 886-2-8797-5970
	    Web site: www.areca.com.tw
     =================================================================

**********************************************************************
** 1. Contents                                                      **
**********************************************************************

	readme.txt		- (This file)The readme file for ARC11XX/ARC12XX Linux scsi raid driver  
 	arcmsr.1.20.0x.12.zip	- Source code (arcmsr.c, arcmsr.h, Makefile)
	install.zip		- Ziped dirver modules disk (dd) image file "driver.img"

**********************************************************************
** 2. First time Installation                          **
**********************************************************************
	A. Before Installation - Under DOS/Windows environment

		a. Unzip "install.zip"
			X:\PATH\pkunzip.exe install.zip =>> driver.img
		b. Dump it into a floppy disk.
			X:\PATH\rawrite.exe driver.img A:
		Tips: You can get rawrite.exe from S.u.S.E. 9.0 CD1 or DVD 

	B. S.u.S.E Linux installation start...boot from CD or DVD

		a. Press "F3" to install a Driver Disk.

		b. Select "Installation ---" to install the SuSE 9.0

		c. Insert the driver disk to floppy drive.

		d. When Driver Update Menu pop-up, press "OK".

		e. After driver installed, press "back" for back to installation console.

		f. Follow SuSE installion procedure to finish your system installation.

	P.S. : Once you updated kernel version to 2.4.21-297. you must do following procedure before reboot.
		otherwise, the system may not boot up correctly...

		Insert the driver disk to floppy drive.
		# mount /media/floppy
		# cd /media/floppy
		# sh patch.297
		# cd /
		# umount /media/floppy
		; If your updated kernel version is not 2.4.21-297, 
		  you will need to boot up from old kernel, 
		  and make a driver module for new kernel first.


**********************************************************************
** 3. Installing raid driver on an Existing System.                 **
**********************************************************************
CASE 1: if you do not attempt to compile driver source

	Insert the driver disk to floppy drive.
	# mount /media/floppy
	# cd /media/floppy
	# sh patch
	# cd /
	# umount /media/floppy
	# reboot

	P.S. : If your kernel already updated to 2.4.21-297, please use "patch.297" instead "patch".

CASE 2: if you need to compile linux kernel drivers source
	(You must install your Linux system with development environment first.)

	A. Prepare for make new kernel and drivers

		a. After kernel source installed, you need create a short link 'linux' in /usr/src directory first.

			#ln -s linux-2.4.x linux

		b. Unzip arcmsr.1.20.0x.12.zip

		c. Depended on your kernel version, copy the properly folder (arcmsr) to /usr/src/linux/drivers/scsi

	B. Modify make and config files 

		In /usr/src/linux/drivers/scsi/Makefile
			@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
			@ ...
			@ ....
			@ subdir-$(CONFIG_SCSI_ARCMSR)	+= arcmsr
			@ obj-$(CONFIG_SCSI_ARCMSR)	+= arcmsr/arcmsr.o
			@ ...
			@ ..
			@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

		In /usr/src/linux/drivers/scsi/Config.in
			@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
			@ ...
			@ ....
			@ if [ "$CONFIG_PCI" = "y" ]; then
			@    dep_tristate 'ARECA ARC11X0/12X0 SATA PCI RAID Controller SCSI support' CONFIG_SCSI_ARCMSR $CONFIG_SCSI
			@ fi
			@ ....
			@ ...
			@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

	C. Make new kernel

		# cd /usr/src/linux
		# make mrproper
		# make config (or make xconfig ,make gconfig ,make menuconfig)
			Tips: Say "M" means configure this driver as a module.
		;You can load default config from /boot/config-2.4.21-101-smp ....
		;When prompt for "SCSI support" say "Y" or "M".
		;When prompt for "SCSI disk support" say "Y" or "M".
		;When prompt for "SCSI tape support" say "Y" or "M".
		;When prompt for "SCSI CD-ROM support" say "Y" or "M".
		;When prompt for "SCSI generic support" say "Y" or "M".
		;When prompt for "ARECA ARC11X0[PCI-X]/ARC12X0[PCI-EXPRESS] SATA-RAID support" 
			;say "Y" or "M"

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

		;if your system is not SMP
		# cp -f ./arch/x86_64/boot/bzImage   /boot/vmlinuz-2.4.21-102-default

		; if your system is SMP
		# cp -f ./arch/x86_64/boot/bzImage   /boot/vmlinuz-2.4.21-102-smp


	D. Make an initrd image

		NOTICE: If your low-level drivers are module, go through, otherwise, skip.  

		An initrd image is needed for loading your SCSI module at boot time.
		So you need make your own initrd image.....

		Edit file /etc/sysconfig/kernel
			###############################################################################
			..
			...
			INITRD_MODULES="arcmsr reiserfs"           # add this context description
			...
			..
			===============================================================================

		#mkinitrd
		#reboot

	P.S: If you don't overwrite default kernel.
	You can edit /boot/grub/menu.lst and do your own kernel and ramdisk image in case that you have made incorrect kernel.