ARECA SATA RAID CONTROLLER ARC11XX/ARC12XX TurboLinux 10 Server =================== 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.00.08.zip - Source code (arcmsr.c, arcmsr.h, Makefile) install.zip - Ziped dirver modules disk (dd) image file "driver.img" arcmsr.2.6.8-5.zip - Ziped driver modules (.ko) for kernel version 2.6.8-5 ********************************************************************** ** 2. TurboLinux Linux 10 Server 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 TurboLinux 10 Server installation CD B. Turbo Linux installation start...boot from CD Step 1: Please select "installation" to install your Turbo Linux 10 Server Step 2: When Turbolinux installation message: "Language Configuration" "please select the default language for your system " appear..... Please push "Ctrl + Alt + F2" switch to new console for load "ARECA RAID CONTROLLER DRIVER". #mkdir /floppy #mount /dev/fd0 /floppy #ls /floppy #insmod /floppy/2.6.8-1/arcmsr.ko #dmesg ;; now you can see all attached RAID VOLUME on installation system ...... Please push "Ctrl + Alt + F7" switch to Installation console for system installation. Follow installion procedure to start your system installation. Step 3: When "Please insert Install CD2." message appears, You need to push "Ctrl + Alt + F2" again and do something. Case 1: if your system is single processor and no hyper-threading #cp /floppy/2.6.8-1/arcmsr.ko /mnt/sysimage/lib/modules/2.6.8-1/kernel/drivers/scsi #ls /mnt/sysimage/lib/modules/2.6.8-1/kernel/drivers/scsi Case 2: if your system is multi processors or hyper-threading, and system memory is 4Gb or smaller. #cp /floppy/2.6.8-1smp/arcmsr.ko /mnt/sysimage/lib/modules/2.6.8-1smp/kernel/drivers/scsi #ls /mnt/sysimage/lib/modules/2.6.8-1smp/kernel/drivers/scsi Case 3: if your system is multi processors or hyper-threading, and system memory is bigger than 4GB. #cp /floppy/2.6.8-1smp64G/arcmsr.ko /mnt/sysimage/lib/modules/2.6.8-1smp64G/kernel/drivers/scsi #ls /mnt/sysimage/lib/modules/2.6.8-1smp64G/kernel/drivers/scsi ;You need make sure that "arcmsr.ko file copy" has been done. then push "Ctrl + Alt + F7" switch to Installation console to continued system installation. Step 4: When Installation Completed message "Congratulations, your ..." appears, You need to push "Ctrl + Alt + F2" again and do something for completely system installation. Make new initrd image An initrd image is needed for loading your SCSI module at boot time. So you need update your initrd image..... # chroot /mnt/sysimage Insert and add this context description into /etc/modules.conf Example: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @ ...... @ alias scsi_hostadapter arcmsr <----add this context description @ ...... @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Build up a new initrd image. we assum your kernel version is 2.6.8-1 Case 1: if your system is single processor and no hyper-threading. # mkinitrd -f -v /boot/initrd-2.6.8-1 2.6.8-1 Case 2: if your system is multi processors or hyper-threading, and system memory is 4GB or smaller. # mkinitrd -f -v /boot/initrd-2.6.8-1smp 2.6.8-1smp Case 3: if your system is multi processors or hyper-threading, and system memory is bigger than 4GB. # mkinitrd -f -v /boot/initrd-2.6.8-1smp64G 2.6.8-1smp64G Than, push "Ctrl + Alt + F7" return to installation Graphic Mode..... Please push "exit" button for system reboot....... $$$$ Important $$$$ After system installation completed, if you upgrade system kernel. You must remake a new initrd image before reboot. ******************************************************************************* ** 3. Install raid driver module on an Existing system ** ******************************************************************************* P.S: If your system already upgrade to kernel version 2.6.8-5 please use "2.6.8-5" instead of "2.6.8-1" below. 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 TurboLinux 10 Server installation CD B. Mount driver floppy #mkdir /floppy #mount /dev/fd0 /floppy #ls /floppy C. Copy arcmsr to module directory. Case 1: if your system is single processor and no hyper-threading #cp /floppy/2.6.8-1/arcmsr.ko /lib/modules/2.6.8-1/kernel/drivers/scsi #ls /lib/modules/2.6.8-1/kernel/drivers/scsi Case 2: if your system is multi processors or hyper-threading, and system memory is 4Gb or smaller. #cp /floppy/2.6.8-1smp/arcmsr.ko /lib/modules/2.6.8-1smp/kernel/drivers/scsi #ls /lib/modules/2.6.8-1smp/kernel/drivers/scsi Case 3: if your system is multi processors or hyper-threading, and system memory is bigger than 4GB. #cp /floppy/2.6.8-1smp64G/arcmsr.ko /lib/modules/2.6.8-1smp64G/kernel/drivers/scsi #ls /lib/modules/2.6.8-1smp64G/kernel/drivers/scsi Case 4: if your system is using numa. #cp /floppy/2.6.8-1numa/arcmsr.ko /lib/modules/2.6.8-1numa/kernel/drivers/scsi #ls /lib/modules/2.6.8-1numa/kernel/drivers/scsi ;You need make sure that "arcmsr.ko file copy" has been done. D. Make new initrd image An initrd image is needed for loading your SCSI module at boot time. So you need update your initrd image..... Insert and add this context description into /etc/modules.conf Example: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @ ...... @ alias scsi_hostadapter arcmsr <----add this context description @ ...... @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Build up a new initrd image. we assum your kernel version is 2.6.8-1 Case 1: if your system is single processor and no hyper-threading. # mkinitrd -f -v /boot/initrd-2.6.8-1 2.6.8-1 Case 2: if your system is multi processors or hyper-threading, and system memory is 4GB or smaller. # mkinitrd -f -v /boot/initrd-2.6.8-1smp 2.6.8-1smp Case 3: if your system is multi processors or hyper-threading, and system memory is bigger than 4GB. # mkinitrd -f -v /boot/initrd-2.6.8-1smp64G 2.6.8-1smp64G Case 4: if your system is using numa. # mkinitrd -f -v /boot/initrd-2.6.8-1numa 2.6.8-1numa E. Reboot system ********************************************************************** ** 4. Remake new kernel ** ********************************************************************** P.S: You must install your Linux system by developmental environment and include kernel source first. A. Prepare for make new kernel and drivers a. unzip driver source file # unzip arcmsr.1.20.00.08.zip b. Copy this folder (arcmsr) to /usr/src/linux/drivers/scsi # cp -r arcmsr /usr/src/linux/drivers/scsi B. Modify make and config files In /usr/src/linux/drivers/scsi/Makefile @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @ ... @ .... @ obj-$(CONFIG_SCSI_ARCMSR) += arcmsr/ @ ... @ .. @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ In /usr/src/linux/drivers/scsi/Kconfig @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @ ... @ .... @ config SCSI_ARCMSR @ tristate "ARECA ARC11X0[PCI-X]/ARC12X0[PCI-EXPRESS] SATA-RAID support" @ depends on PCI && SCSI @ help @ This driver supports all of ARECA's SATA RAID controllers cards. @ This is an ARECA maintained driver by Erich Chen. @ . @ @ To compile this driver as a module, choose M here: the @ module will be called arcmsr (modprobe arcmsr) . @ .... @ ... @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ C. Make new kernel # cd /usr/src/linux # make mrproper # make config (or make xconfig) Tips: ;Please do "Load an Alternate Configuration File" from /usr/src/linux-2.6.8.../configs/kernel-2.6.8..... ;Check ARECA RAID driver.... "ARECA ARC11X0[PCI-X]/ARC12X0[PCI-EXPRESS] SATA-RAID support" # make bzImage # make modules # make modules_install # cp ./arch/i386/boot/bzImage /boot D. Modify boot loader configuration files. I. Modify /boot/grub/grub.conf Example: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @ ...... @ title Turbolinux @ kernel (hd0,0)/vmlinuz root=0803 quiet @ initrd (hd0,0)/initrd @ @ title Turbolinux custom <----add this context description @ kernel (hd0,0)/bzImage root=0803 quiet <----add this context description @ ...... @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ II. 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..... Insert a add this context description into /etc/modules.conf Example: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @ ...... @ alias scsi_hostadapter arcmsr <----add this context description @ ...... @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Build up a new initrd image. we assum your kernel version is 2..6.8custom. # mkinitrd -f -v /boot/initrd-2.6.8-1custom 2.6.8custom Insert a add this context description into /boot/grub/grub.conf Example: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @ ...... @ title Turbolinux @ kernel (hd0,0)/vmlinuz root=0803 quiet @ initrd (hd0,0)/initrd @ @ title Turbolinux custom @ kernel (hd0,0)/bzImage root=0803 quiet @ initrd /initrd-2.6.8-1custom <----add this context description @ ...... @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ E. #reboot