This release note and the software that accompanies it are copyright (c) 2003, Intel Corporation, and may only be installed and used in accordance with the license that accompanies the software. File name: gdth_dvr_205.zip Driver version 2.05 This download supports the following Intel(R) Server RAID Controllers: *SRCS14L This download supports SATA Intel(R) Server RAID Controllers, please verify that this driver has been tested with the RAID controller you have chosen to use. You can verify compatability on the RAID controller's driver page at http://support.intel.com. This download is packaged as a zip file and can be unzipped using a variety of compatible zip programs. The contents of this download are governed by the terms and conditions as laid out by the file COPYING. The file gdth.tgz is a tar-zipped file containg driver source code taken from the Linux kernel. Untar and unzip the file and copy contents to: /usr/src/linux/drivers/scsi and recompile the kernel. Attention! =========== This program will extract a copy the gdth RAID driver set to a floppy diskette. These files are provided for your convenience, however no support is provided. Because these files can be used with a variety of Linux versions, Please refer your specifice product and OS documentation for application instructions for this driver. Contents ========= File Version Size Date Description ----- -------- ----- ----- ------------ Copying n/a 18KB 10/16/02 gdth.tgz 2.05 53KB 10/16/02 Driver GDTH README.TXT n/a 2KB 10/22/02 This file Using This Tool ================ 1. Extract the download files to a floppy diskette. 2. Installing/Upgrading gdth Drivers ================================= Requirements: ------------ 1. Please make sure you have installed Linux kernel sources for the running Linux kernel. 2. Make sure you have all the required development tools necessary to recompile the Linux Kernel. If the driver version of the installed drivers are lower than the ones supplied here, please upgrade your drivers. This can be done by following either of the two steps. 1. Use the file "gdth.bin" The file "gdth.bin" is a self extracting executable to compile GDTH driver as linux kernel module for the ruuning kernel. If your existing drivers are kernel modules, this method might be the easiest way to update them. a) If the file "gdth.bin" is not executable then make it executable using the following command: "chmod +x gdth.bin" b) Simply run the file with the command "./gdth.bin" and follow prompts. 2. Use the file "gdth.tgz: You will need access to source files of the Linux kernel running on your system. Assumming that the kernel source code is installed at /usr/src/linux, do the following: a) Untar and unzip the file and copy contents to: /usr/src/linux/drivers/scsi b) Recompile the kernel. For more information on recompiling the kernel, please read documentation under the /usr/src/linux/Documentation directory. c) Install the newly built kernel and modules. Note you might have to make changes to your Boot loader configuration to activate the new kernel. Please refer to the documentation supplied with your Linux distribution. _______________________________________________________________________ III) Using gdth drivers ================== A) gdth driver parameters ------------------------- Driver versions older than 1.05 do not support driver parameters. From driver version 1.05 to 1.07 it is necessary to add driver parameters directly in /usr/src/linux/drivers/scsi/gdth.c . From version 1.10 on you may use for the parameters the LILO boot prompt (gdth=...") or in /etc/lilo.conf the append command (append = "gdth=..."). Reservation of SCSI devices: --------------------------- The reservation of SCSI devices becomes necessary if you wish that so-called 'Direct Access Devices' (e.g. hard disks, removable hard disks like IOMEGA or SyQuest, some MOs) are directly controlled by Linux and not the Storage RAID Controller's firmware (i.e., they are not configured as Host Drives). This is also called "raw-service". In this case the Storage RAID Controller does not cache the data to/from the reserved SCSI device. This reservation is important for removable hard disks. If they are controlled by the Storage RAID Controller and are a Host Drive, a media change is very difficult. 'Non Direct Access Devices' like CD-ROMs, Streamers, DATs, etc. do NOT require a reservation. IMPORTANT: The reservation is only possible with uninitialized SCSI devices. (Use Storcon utility to de-initialize an already initialized device). As already mentioned a reservation for driver versions 1.05 to 1.07 has to be made directly in the driver sources. Look for 'gdth_reserve_str' in '/usr/src/linux/drivers/scsi/gdth.c' . You'll find a non-active sample entry, which you can change according to the coordinates of the device you want to reserve (enter Adapter, Bus, ID and LUN). Save the file and compile a new kernel. From driver version 1.10 on you can add the parameters for the reservation with the LILO append command: Excerpt of a sample /etc/lilo.conf: ----------------------------------- # End LILO global section # Linux bootable partition config begins image = /boot/vmlinuz root = /dev/sda2 label = Linux append = "gdth=reserve_list:1,0,6,0" # Linux bootable partition config ends This gdth driver parameter reserves the SCSI device which is connected with Storage RAID Controller 1 (second Storage RAID Controller), SCSI Bus 0 (channel A), ID 6, LUN 0 for Linux (raw service). Note: After each change in /etc/lilo.conf , lilo must be rerun to activate the changes. Note: Driver parameters may also be entered at the LILO boot prompt. (e.g.: gdth=reserve_list:1,0,6,0). Further driver parameters: ------------------------- irq1,irq2, etc. Only for Storage RAID EISA Controllers with disabled BIOS (irq1, irq2, etc. correspond with the IRQs of the Storage RAID Controllers) disable:Y deactivates the Storage RAID driver disable:N activates the Storage RAID driver reserve_mode:0 reserves no SCSI devices [*1] reserve_mode:1 reserves all not-initialized removable hard disk [*1] reserve_mode:2 reserves all not-initialized SCSI devices [*1] reserve_list:h,b,t,l,h,b,t,l,... reserves SCSI devices at the corresponding coordinates with h=Hostadapter, b=SCSI Bus, t=Target ID, l=LUN reverse_scan:Y reversed scanning order of the PCI controllers reverse_scan:N normal scanning order of PCI Controllers according to the system BIOS max_ids:x x = number of target IDs per SCSI channel (accelerates the boot process) rescan:Y rescan all SCSI channels / IDs rescan:N scan only those SCSI devices found during system power up [*1] [*1] The driver parameters reserve_mode and rescan:N require Storage RAID Controllers with firmware version FW 1.23.00/2.23.00 or higher. The current default settings of the driver are: "gdth=disable:N,reserve_mode:1,reverse_scan:N,max_ids:127,rescan:N" If gdth is loaded as a module, these parameters can also be added with a special syntax. IRQ parameters are entered as 'IRQ=' (e.g. IRQ=10). Several parameters are not separated with a comma (',') but a space (' '). All ':' are substituted with '=', all 'Y' with '1' and all 'N' with '0'. Default: "modprobe gdth disable=0 reserve_mode=1 reverse_scan=0 max_ids=127 rescan=0" B) Further interesting information: ----------------------------------- /proc-Support: Read of /proc/scsi/gdth/0, /proc/scsi/gdth/1, .. : Displays the Storage RAID Controller/SCSI busses, firmware version, driver version (e.g.: cat /proc/scsi/gdth/0) Write to /proc/scsi/gdth/0, .. : gdth flush Flush all Host Drives of the Storage RAID Controller gdth flush drive Flush the Host Drive with the number drive gdth wbp_off Disable Write-Back permanently gdth wbp_on Enable Write-Back permanently gdth wb_off Disable Write-Back for this session (from Firmware version 1.15/2.15) gdth wb_on Enable Write-Back for this session (from Firmware version 1.15/2.15) ###################################################################################