Transcript
RocketRAID 278x FreeBSD Installation Guide
RocketRAID 278x SAS Controller FreeBSD Installation Guide
Version 1.0
Copyright © HighPoint Technologies, Inc. All rights reserved.
Last updated on June 13, 2011
RocketRAID 278x FreeBSD Installation Guide
Table of Contents 1 Overview ........................................................................................................................................ 1 2 Installing FreeBSD on RocketRAID 278x Controller ............................................................... 1 Step 1 Prepare Your Hardware for Installation ......................................................................... 1 Step 2 Check System BIOS Settings ......................................................................................... 1 Step 3 Prepare the Driver Diskette ............................................................................................ 1 Step 4 Install FreeBSD .............................................................................................................. 2 3 Installing RR278x Driver on an Existing System ...................................................................... 5 Step 1 Copy the Driver Module................................................................................................. 5 Step 2 Test the Driver Module .................................................................................................. 5 Step 3 Configure System to Automatically Load the Driver .................................................... 6 Step 4 Configure System to Mount Volumes when Startup...................................................... 6 4 Updating the Driver ..................................................................................................................... 6 5 Installing RAID Management Software ..................................................................................... 6 6 Uninstalling ................................................................................................................................... 7
.
i
Rocket RAID 278x FreeBSD Installation Guide
1 Overview The purpose of this document is to provide clear instructions on how to install and use RocketRAID 278x Controller on a FreeBSD system.
2 Installing FreeBSD on RocketRAID 278x Controller If you would like to install FreeBSD onto drives attached to RocketRAID 278x controller, please perform the following operations:
Step 1 Prepare Your Hardware for Installation After you attach your hard disks to RR278x controller, you can use RR278x BIOS Setting Utility to configure your hard disks as RAID arrays, or just use them as single disks. Note If you have other SCSI adapters installed, you must make sure the RR278x controller BIOS will be loaded firstly. If not, try to move it to another PCI slot. Otherwise you may be unable to boot up your system.
Step 2 Check System BIOS Settings In your system BIOS SETUP menu, change Boot Sequence in such a way that the system will first boot from CDROM, next from and then from floppy drive, and then from SCSI. Refer to your BIOS manual to see how to set boot sequence. If your BIOS settings do not support such a boot sequence, you can first set it to boot from CDROM. After you finish installation, set SCSI as the first boot device to boot up the system.
Step 3 Prepare the Driver Diskette If you are installing FreeBSD, you must prepare a driver disk for RR278x before installation. First obtain the driver diskette tgz file, freebsd.tgz. On a DOS or Windows system, create a MS-DOS filesystem and extract the archive file to the (USB) floppy diskette or USB hard disk. On a FreeBSD system, #newfs_msdos /dev/fd0 #mount –t msdosfs /dev/fd0 /mnt #tar xxx.tgz –C /mnt - 1 -
Rocket RAID 278x FreeBSD Installation Guide
#umount /mnt Note If the floppy diskette is inserted into an USB floppy controller and the device name in the system is da0, then replace fd0 in the upper command with da0. The driver also could be put on a USB disk, and the driver disk can be created as the floppy diskette. For example: use the first partition of the USB disk da1, then replace fd0 in the upper command with da1s1 or da1.
Step 4 Install FreeBSD 1)
Start installing the FreeBSD by booting from installation CD.
2)
When “Welcome to FreeBSD” screen appears, select “6”.
3)
Insert RR278x driver diskette into floppy drive now. Type in "load diskx:rr278x-x.x" (without quotation mark) and then press enter.
- 2 -
Rocket RAID 278x FreeBSD Installation Guide
If using USB disk, insert it into the USB port. Assume the USB disk’s name is disk1 and driver modules are located at the first partition of disk1 in system, then type in "load disk1s1:rr278x-x.x" (without quotation mark). If whole USB disk is formatted as one partition, i.e. format the USB disk directly without partitioned, type in "load disk1:rr278x-x.x" (without quotation mark) and then press enter.
To confirm USB disk name, type lsdev command. In the following document we assume the driver diskette is inserted into the on-board’s floppy controller. for FreeBSD 6.0-RELEASE ok load disk0:rr278x-6.0.ko for FreeBSD 6.0-AMD64-RELEASE ok load disk0:rr278x-6.0-amd64.ko for FreeBSD 6.1-RELEASE ok load disk0:rr278x-6.1.ko for FreeBSD 6.1-AMD64-RELEASE ok load disk0:rr278x-6.1-amd64.ko for FreeBSD 6.2-RELEASE ok load disk0:rr278x-6.2.ko for FreeBSD 6.2-AMD64-RELEASE ok load disk0:rr278x-6.2-amd64.ko for FreeBSD 6.3-RELEASE ok load disk0:rr278x-6.3.ko for FreeBSD 6.3-AMD64-RELEASE ok load disk0:rr278x-6.3-amd64.ko for FreeBSD 7.0-RELEASE ok load disk0:rr278x-7.0.ko for FreeBSD 7.0-AMD64-RELEASE ok load disk0:rr278x-7.0-amd64.ko for FreeBSD 7.1-RELEASE ok load disk0:rr278x-7.1.ko for FreeBSD 7.1-AMD64-RELEASE ok load disk0:rr278x-7.1-amd64.ko - 3 -
Rocket RAID 278x FreeBSD Installation Guide
for FreeBSD 7.2-RELEASE ok load disk0:rr278x-7.2.ko for FreeBSD 7.2-AMD64-RELEASE ok load disk0:rr278x-7.2-amd64.ko for FreeBSD 8.0-RELEASE ok load disk0:rr278x-8.0.ko for FreeBSD 8.0-AMD64-RELEASE ok load disk0:rr278x-8.0-amd64.ko for FreeBSD 8.2-RELEASE ok load disk0:rr278x-8.2.ko for FreeBSD 8.2-AMD64-RELEASE ok load disk0:rr278x-8.2-amd64.ko
4)
After the driver has been loaded, remove the floppy diskette from the (USB) floppy drive or remove USB disk from USB port.
5)
Type in "boot" and continue the installation as normal. You can refer to FreeBSD installation guide.
Note On some systems with ACPI enabled, FreeBSD may not work. You can try to disable ACPI in system BIOS or type the command “set hint.acpi.0.disabled=”1”” under boot prompt to solve the problem.
6)
Before exit install, insert floppy driver diskette into (USB) floppy drive, or insert USB driver disk into USB port, then an additional step must be taken to copy RR278x driver module to system. On the driver disk, there is a setup script "postinstall" which will do this work for you. Before you reboot the system, press Alt-F4 to the command shell and type the following commands: For common ISA floppy controller: # mount –t msdosfs /dev/fd0 /mnt
For USB floppy controller, we assume it is da0: # mount –t msdosfs /dev/da0 /mnt
For USB disk, we assume it is da1: # mount –t msdosfs /dev/da1 /mnt or - 4 -
Rocket RAID 278x FreeBSD Installation Guide # mount –t msdosfs /dev/da1s1 /mnt
Then run script to do postinstall # sh /mnt/postinstall # umount /mnt
Then press Alt-F1 to return to the setup screen and choose [X Exit Install] to finish setup. Note After the driver has been loaded, remove the floppy diskette from (USB) floppy drive or remove USB disk from USB port to avoid that the installed system does not boot normally. Note On some systems the floppy may be inaccessible during installation. In this case, please remove the CD, reboot from the installed system and load the driver manually from floppy again when booting from controller. After system boots up you can run the postinstall script to install the driver.
3 Installing RR278x Driver on an Existing System If you are currently running FreeBSD and would like to access drives or arrays attached to the RR278x Controller, you can perform the following steps.
Step 1 Copy the Driver Module If you have made freebsd drivers into a diskette, you can insert the driver diskette to floppy drive, then using the following commands to copy the driver module: for # # #
FreeBSD 6.x/7.x: mount –o ro /dev/fd0 /mnt cp /mnt/rr278x-xxx.ko /boot/kernel/rr278x.ko umount /mnt
You can also extract the files from .tgz files directly, without using a floppy diskette: For FreeBSD 6.x/7.x: # tar zxvf xxx.tgz # cp rr278x-xxx.ko /boot/kernel/rr278x.ko
Step 2 Test the Driver Module You can test out the module to ensure that it works for your system by load it during system booting. If the module has been loaded successfully you should see the RR278x banner and a - 5 -
Rocket RAID 278x FreeBSD Installation Guide
display screen of the attached drives. You can now access the drives as a SCSI device (if you have no other SCSI device, the first device is /dev/da0, then /dev/da1, etc.). If you have configured a RAID using all disks, it will be registered to system as device /dev/da0. You can use “/stand/sysinstall” to create partitions and disklabels (like da0s1e) on da0. Then you can create new filesystem using “newfs /dev/da0s1e”. Now you can mount /dev/da0s1e to somewhere to access it.
Step 3 Configure System to Automatically Load the Driver Most likely, you will not want to type “load rr278x” each time you boot up the system. Therefore you must install the module and tell the system about it. To configure system to automatically load the driver, type in the following commands: # echo ’rr278x_load=”YES”’ >> /boot/defaults/loader.conf
This tells the loader to try loading the RR278x module together with the kernel. Now, reboot the system. RR278x module should be automatically loaded each time system start up.
Step 4 Configure System to Mount Volumes when Startup Now you can inform the system to automatically mount the array by modifying the file /etc/fstab. E.g. You can add the following line to tell the system to mount /dev/da1s1e to location /mnt/hpt after startup: /dev/da1s1e
/mnt/hpt
ufs
rw
0
0
4 Updating the Driver To update the driver with a new version you simply reinstall the driver following the previous section, “Install the driver on an existing system”.
5 Installing RAID Management Software HighPoint RAID Management Software is used to configure and keep track of your hard disks and RAID arrays attached to RR278x controller. Installation of the management software is optional but recommended. To configure HighPoint RAID Management Software to work with RR278x driver, you should setup /etc/hptcfg to be the driver name: # echo rr278x > /etc/hptcfg Please refer to HighPoint RAID Management Software documents for more information.
- 6 -
Rocket RAID 278x FreeBSD Installation Guide
6 Uninstalling You can only uninstall the driver when your system is not booting from devices attached to RR278x controller. Just remove the line rr278x_load=”YES” in /boot/defaults/loader.conf, and then delete the driver module /modules/rr278x.ko or /boot/kernel/rr278x.ko .
- 7 -