A P P E N D I X G

Configuring a Linux Server

This appendix provides access information and LUN setup information needed when you connect a Sun StorEdge 3510 FC array or Sun StorEdge 3511 SATA array to a server running the Linux operating system. For a list of supported adapters, refer to the release notes for your array.

Note - The RAID configuration examples in this appendix describe the steps required to access the controller firmware using Minicom.

This information supplements the configuration steps presented in this manual and covers the following topics:

Section G.1, Setting Up the Serial Port Connection

Section G.2, Accessing the Firmware Application From a Linux Server

Section G.3, Checking the Adapter BIOS

Section G.4, Multiple LUN Linux Configuration

Section G.5, Making an ext3 File System for Linux

Section G.6, Creating a File System

Section G.7, Creating a Mount Point and Mounting the File System Manually

Section G.8, Mounting the File System Automatically

Section G.9, Determining the Worldwide Name for Linux Hosts

G.1 Setting Up the Serial Port Connection

The RAID controller can be configured by means of a host system running a VT100 terminal emulation program or running a terminal emulation program such as Minicom.

Note - You can also monitor and configure a RAID array over an IP network with Sun StorEdge Configuration Service after you assign an IP address to the array. For details, see Section 4.10, Setting Up Out-of-Band Management Over Ethernet and refer to the Sun StorEdge 3000 Family Configuration Service User's Guide.

To access the controller firmware through the serial port, perform the following steps:

1. Use a null modem cable to communicate via the serial port of the array.

Connect the serial null modem cable to the array and to ttyS0 (COM1), ttyS1 (COM2), ttyS2 (COM3), or ttyS3 (COM4).

Note - A DB9-to-DB25 serial cable adapter is included in your package contents for connecting the serial cable to a DB25 serial port on your host if you do not have a DB9 serial port.

2. Power on the array.

3. After the array is powered up, power on the Linux server and log in as root (or become superuser if you logged in as a user).

4. Open a terminal session and type:

minicom -s

Press Return. The setup menu is displayed, where you define which serial ports to use, baud rate, hand shake settings, and flow control.

5. Set serial port parameters on the server.

Set serial port parameters to:

38,400 baud

8 bit

1 stop bit

No parity

a. At the configuration screen, use the arrow keys to highlight Serial Port Settings and press Return.

b. If A is not correct, press the letter A and the cursor goes to line A.

c. Backspace and edit to select the correct serial port:

/dev/ttyS(x)

where x is the proper serial port connecting the server to the array.

After you edit the line, press Return and the cursor goes back to the line Change which Settings?

d. If E is not correct, press the letter E and the cursor goes to line E. Backspace and change the line to:

38400 8N1

After you edit the line, press Return and the cursor goes back to the line Change which Settings?

e. Set F to no. When pressing F, toggle from yes to no.

f. Set G to no. When pressing G, toggle from yes to no.

g. Press the Escape key to return to the configuration screen.

h. In the configuration menu, use the arrow keys to highlight "Save setup as dfl" and press Return.

A "configuration saved" confirmation message is displayed.

i. Highlight "Exit from Minicom" in the configuration menu, and press Return.

G.2 Accessing the Firmware Application From a Linux Server

After you have set the Minicom serial port parameters, use the Minicom utility to access the controller firmware with the following steps:

1. To start the Minicom program from the terminal window, type:

minicom

A pop-up window stating "Initializing Modem" is displayed. When initialization is complete, the following banner is displayed:

Welcome to Minicom 2.00.0

Options: History Buffer, F-Key Macros, Search History Buffer, I18n

Compiled on Jun 23 2002, 16:14:20

Press "CTRL-A" Z for help on special keys.

2. Press Ctrl-L to connect to the array and access the firmware application.

3. In the main screen, choose Terminal (VT100 Mode) and view the RAID firmware Main Menu commands used to configure the array.

G.3 Checking the Adapter BIOS

When booting the server, watch for the HBA card BIOS message line to be displayed. Then press the proper sequence of keys to get into the HBA BIOS (<Alt-Q> for FC Qlogic HBAs).

The keystrokes are listed on the screen when the adapter is initializing. If your HBA has multiple interfaces on it, they will all show up in the main screen of the BIOS software. You must make the same changes on every interface unless one of the interfaces is going to be bootable.

After you enter the Qlogic HBA BIOS, perform the following steps.

1. If you have more than one interface, highlight the top interface listed under Adapter Type and press Return.

2. If you only have one interface, it is already highlighted; press Return.

3. Highlight Configuration Setting and press Return.

4. Highlight Host Adapter Settings and press Return.

5. Move down to Host Adapter BIOS and make sure it is enabled; if not, press the Return key and it toggles from disabled to enabled.

The setting should be enabled.

6. Press Escape and go back to Configuration Settings. Highlight Selectable Boot Settings and press Return.

This is where you can make the interface bootable or not bootable.

7. Highlight Select Boot Device. Press the Return key to toggle from disabled to enabled.

Select Disabled if this is not going to be a bootable device.

Select Enabled if this is going to be bootable device.

8. Press Escape until you get back to Configuration Settings.

9. Highlight Extended Firmware Settings and press Return.

10. On the Extended Firmware Settings menu, highlight Connection Option and press Return.

A screen lists three types of connection:

0 - Loop only - - - - for connecting to loop type devices

1 - Point to point only - - - - for connecting to fabric switches

2 - Loop preferred, otherwise point to point

11. Select a connection type.

If you are connecting to a loop device, select 0 and press Return.

If you are connecting to a fabric device or switch, select 1 and press Return.

Do not select 2.

12. Press Escape until a screen is displayed that says "Configuration setting modified." Highlight Save changes and press Return.

13. Return to the Fast!UTIL Options. Highlight Scan Fibre Devices and press Return.

This menu option scans all 126 channels to see if there are any devices attached; the devices are displayed after the scan. If there are no devices attached, it takes some time to scan. If there are devices attached, the scan usually finds them right away.

14. If you are satisfied with the configuration, press Escape until you get to Configuration Settings.

15. Highlight Exit Fast!UTIL and press Return.

A screen is displayed that says Exit Fast!UTIL.

16. Highlight Reboot System and press Return.

The server reboots.

G.4 Multiple LUN Linux Configuration

By default, the Linux kernel does not support multiple LUNs. To support multiple LUNs, modify the kernel with the following steps:

1. Log in as root, or become a superuser if you are logged in as a user.

2. Add this line to the end of the /etc/modules.conf file and save the file:

options scsi_mod max_scsi_luns=255

3. At the system prompt, enter this command and press Return:

mkinitrd -f /boot/initrd-2.4.9-e.3.img 2.4.9-e.3

The 2.4.9-e.3 entries refer to the current kernel. To find out your current kernel, type uname -r and substitute your kernel information in place of the 2.4.9-e.3 entries.

4. Reboot the server.

To halt the server completely, use shutdown -h now.

To reboot automatically after the shutdown is complete, use shutdown -r now.

G.5 Making an ext3 File System for Linux

The following procedure for labeling and partitioning drives using fdisk applies to an ext3 file system. To discover which disk you want to label, you need to determine what device it is.

1. To list all devices and their paths, start a terminal session and type:

fdisk -l

Record the device names and paths that you plan to use.

2. Type:

fdisk /dev/sd(x) x= a,b,c,...

A banner is displayed for the specified array device. The last statement displays a prompt.

3. Type m to display the menu.

4. On the displayed menu, select "n" for the command action and press Return.

Two choices are displayed:

e extended

p primary partition (1-4)

Note - Only four primary partitions are allowed per array. All additional partitions must be added as extended LUNs under one primary partition. Only one primary partition is allowed to have extended LUNs.

5. For the first partition, select "p."

When several options appear, keep the defaults. You can reconfigure this after you understand the process and see what it looks like. Add additional primary partitions and extended partitions as needed.

6. After you have completed accepting the defaults and are back at the "Command (m or help):" screen, press W to save the configuration and exit fdisk.

Your partition is ready for a file system now.

G.6 Creating a File System

1. Log in as root, or become superuser if you are logged in as a user.

2. Take the device that you ran fdisk on and run the following command to create an ext3 file system:

mkfs -t ext3 /dev/sdb(x)

where x is the partition on which you are creating a file system. Replace x with 1 because there is only one partition.

G.7 Creating a Mount Point and Mounting the File System Manually

1. Go to the directory where you want to create a directory that will be the mount point. Then type the following command:

mkdir name

where name is the name of the new directory.

2. To mount your file system, type the following:

mount /dev/sdb(x) / directory-path

where x is 1 for this partition and the directory-path is the directory that was created and its location.

G.8 Mounting the File System Automatically

You can label the partition so that it can be entered in the fstab file for mounting the partition automatically at bootup. The use of the label and fstab file is a faster operation than mounting the file system manually with a device path.

1. Type the following command to add a label to the partition:

e2label /dev/sdb(x) / directory-path

where x is 1 for this partition and directory-path is the directory that was created and its location.

2. Edit the /etc/fstab file and add the following line:

LABEL=/mount/point /mount/point ext3  1 2

3. Save the file.

4. To verify that fstab was set up correctly, type:

mount -a

If the mount point and the fstab file are correctly set up, no errors are displayed.

5. To verify that the file system is mounted and list all mounted file systems, type:

df -k

6. To unmount the file system, type:

umount /filesystem-name

G.9 Determining the Worldwide Name for Linux Hosts

Before you can create host filters, you need to know the worldwide name (WWN) for the FC HBA that connects your host to your FC array.

1. Boot a specific host system and note the BIOS version and HBA card models connected to your host.

2. Access the HBA card's BIOS with the appropriate command (Alt-Q or Control-A are commonly used).

If the host has multiple HBA cards, select the card that is connected to the array.

3. Scan the card to look for devices attached to it (usually with the Scan Fibre Devices or the Fibre Disk Utility).

The node name (or similar label) is the WWN. The following example shows the node name for a Qlogic card.

ID	Vendor	Product	Rev	Node Name	Port ID
0	Qlogic	QLA22xx Adapter	B	210000E08B02DE2F	0000EF

Refer to the Sun StorEdge 3000 Family RAID Firmware User's Guide for more information about creating host filters.