How to install 3dm and 3ware 6400 card on your e-smith server in a RAID5 configuration

Eric Womack

Las Vegas Data LLC

Table of Contents
1. Introduction
2. Hardware
2.1. Firmware
3. Software
3.1. e-smith Install
3.2. Driver Update
3.3. 3dm Install
4. Tape Drives

This procedure has been tested on systems running e-smith server 4.1.2. It should work on all other versions of e-smith as well.

Warning

Do not try to install e-smith on to the 6800 series. The auto-partition portion of the install is incompatible with this card.


1. Introduction

This document explains how to setup a RAID5 array and install e-smith using the 3ware 6400 RAID card, then installing the 3dm RAID montioring software.

Special thanks go to Glenn Hudson, the programmer of the script and whose instructions this document was drawn from.


2. Hardware

2.1. Firmware

Download the following from 3ware's site to a local workstation that will be connected to the e-smith server:

  1. Latest Firmware Update http://www.3ware.com/support/3warednload_6000_driver.asp

  2. RedHat 7 Driver http://www.3ware.com/support/3warednload_6000_driver.asp

  3. Latest version of 3dm. (The version on the CD does not properly handle a RAID 5 configuration.) http://www.3ware.com/support/3warednload_3dm_driver.asp

  4. You will also need the custom 3dm install script for e-smith. http://www.e-smith.org/docs/howto/contrib/install.3dm This is a must to have everything work properly when using RAID5 and highly recommended for other raid modes as well.

  5. Finally, you must have a DOS/W95-8 boot disk. If you don't have a boot disk handy, you can download an image from: http://www.bootdisk.com

Extract the files from the firmware update and copy to the boot disk. Insert the boot disk into the machine with the 3ware card and reboot. Following the on-screen directions, install the new bios firmware. The original 3w-xxxx.o driver module supplied with e-smith will work fine to get you going even with the new RAID5 firmware so don't worry. You will update to the new driver module later after installing e-smith.

After the update is complete, remove the disk and reboot. Hit ALT-3 when prompted to enter the 3ware bios. Select the drives you wish to use in the array, the select "Create Array". Under type, change to RAID5. Verify your selection, then hit F8 and answer Y to confirm your changes. The array will now start to build itself and show a process indicator. You may insert your boot media at this time as the machine will automatically reboot itself when complete.


3. Software

3.1. e-smith Install

Install e-smith 4.1.x as usual and configure for your purposes. At this point you need only a minimal configuration as this is all you need for setting up the 3ware driver. Configure enough to have the local workstation be able to connect to it along with enabling all the SSH options. ( Don't setup an entire production system yet!!!) Using the local workstation, extract the files from the RedHat 7 driver file. Copy the resulting folder, the custom script and the 3dm software (3dm-lnx.tgz) to the Admin's Home directory, using either an FTP upload or Network Neighborhood (My Network Places in Windows2000) and browsing to the Admin's Home directory).


3.2. Driver Update

Using the SSH client of your choice on the local workstation, log into the server as root and create a temporary working directory as /tmp/3dm for copying the downloaded files and running the installation script with the following command:


mkdir /tmp/3dm

Now copy all the files from the Admin's Home directory to this folder.


cp /home/e-smith/files/users/admin/home/* /tmp/3dm

Copy over the original 3ware driver module in /lib/modules/2/2/16-22/scsi directory with the new RAID5 enabled driver module 3w-xxxx.o.


cp /tmp/3dm/RH7/3w.xxxx.o /lib/modules/2.2.16-22/scsi/
cp /tmp/3dm/RH7/3w.xxxx.smp /lib/modules/2.2.16-22smp/scsi/3w.xxxx.o

Change the ownership and permissions to match those of all other modules in the directory.


chmod 644 /lib/modules/2.2.16-22/scsi/3w.xxxx.o
chmod 644 /lib/modules/2.2.16-22smp/scsi/3w.xxxx.o

Re-boot at this point to make sure the server boots with the new RAID5 driver installed.


3.3. 3dm Install

Now for the setup of the 3ware "3dm" daemon to allow Web based RAID administration at http://server_ip_address:979/

Note: Must use the IP address and not the host's name for 3DM to work

Change the custom install script to allow it to execute and run it.

chmod 755 /tmp/3dm/install.3dm
/tmp/3dm/install.3dm

Warning

Use the modified script for e-smith running in RunLevel7... Do Not Use Original

Follow the on screen directions to setup the new daemon. Pay particular attention to the question of whether you installed the driver via and RPM. Be sure to answer NO to this question. Also, watch for the port number question and enter 979. The 3dmd daemon should report starting properly by displaying [OK] ... if not check the installation. If all went well... delete all files in the /tmp/3dm directory and remove /tmp/3dm by typing :


del /tmp/3dm/*
rmdir /tmp/3dm

Reboot the server and look for the 3dm daemon to start correctly and all should be fine. Using your local workstation, you can now check the status of your array with any browser at http://server_ip_address:979.


4. Tape Drives

On most systems, ATAPI tape drives will work without any change as SCSI emulation is enabled on all systems except those which already have a real SCSI host adapter (3ware appears as one). However, on systems which contains a SCSI controller and will utilize an IDE tape drive you must make the appropriate changes to the e-smith configuration scripts. You can do so simply by typing the following commands :


/sbin/e-smith/db configuration setprop backup Device /dev/nht0
/sbin/e-smith/signal-event conf-backup

These changes will configure to e-smith server to dynamically load the ide-tape.o module rather than the ide-scsi.o scsi emulation module when a backup occurs either manually or by a cron job setup through the e-smith web manager. Now all relevant tape drive commands will use /dev/nht0 instead of /dev/nst0. Now apply all the updated RPM's to get the system up to date with security and bug fixes. At the very least, you must update the e-smith-backup RPM to insure proper tape backups.

Server should now be ready for normal use!!!

If you have comments or suggestions about this document, please send them to eric@lasvegasdata.com