A P P E N D I X H

Configuring a Linux Server

This appendix provides access information and LUN setup information needed when you connect a Sun StorEdge 3510 FC Array to a server running the Linux operating environment. For a list of supported adapters, refer to the Sun StorEdge 3510 FC Array Release Notes.

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

Setting Up the Serial Port Connection

Checking the Adapter BIOS

Multiple LUN Linux Configuration

Making an ext3 File System for Linux

Creating a File System

Creating a Mount Point and Mounting the File System Manually

Mounting the File System Automatically

Determining the World Wide Name for Linux Hosts

H.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 the Sun StorEdge Configuration Service program after you assign an IP address to the array. For details, see 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. You must 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 DB-9-to-DB-25 serial cable adapter is included in your package contents to connect the serial cable to a DB-25 serial port on your host if you do not have a DB-9 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 log in as su if you logged in as a user).

4. Open a terminal session and type:

minicom -s

Press Return. You see the setup menu, where you define which serial ports to use, baud rate, hand shake settings, and flow control.

5. Set the serial port parameters on the server.

See Configuring a COM Port to Connect to a RAID Array for the parameters to use.

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

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

Backspace and edit:

/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?

c. 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?

d. Set F to no. When pressing F, toggle from yes to no or vice versa.

e. Set G to no. When pressing G, toggle from yes to no or vice versa.

f. Press the Esc key to return to the configuration screen.

g. In the configuration menu, highlight "Save setup as dfl" using the arrow keys and press Return.

A "configuration saved" confirmation message is displayed.

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

H.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" appears. 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 main menu commands used to configure the array.

H.3 Checking the Adapter BIOS

When booting the server, watch for the HBA card BIOS message line to show up. Then press the proper sequence of keys to get into the HBA BIOS:

For FC Qlogic HBAs, <Alt-Q>

The keystrokes are listed on the screen when the adapter is initializing.

After you enter the Qlogic HBA BIOS with Alt-Q, perform the following steps.

If your HBA has more than one interface on it, they show up in the main screen of the BIOS software after you press Alt-Q. You have to make the same changes on one interface as the other unless one of the interfaces is going to be bootable.

1. If you have more than one interface, highlight the top one listed under Adapter Type and press Return. If you only have one interface, it is already highlighted; press Return.

2. Highlight Configuration Setting and press Return.

3. Highlight Host Adapter Settings and press Return.

4. 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.

5. Press Esc 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.

6. 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.

If it is going to be bootable device, select Enabled.

7. Press Esc until you get back to Configuration Settings.

8. Highlight Extended Firmware Settings and press Return.

9. 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 - - - - connecting to fabric switches

2 - Loop preferred, otherwise point to point

10. If you are connecting to a loop device, highlight 0 and press Return. If you are connecting to a Fabric device or switch, highlight 1 and press Return.

11. Once completed, press Esc until you get to a screen that displays "Configuration setting modified." Highlight Save changes and press Return.

12. 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 show up after the scan. If there are no devices attached, it takes some time to scan. If there are devices attached, it usually finds them right away.

13. If you are satisfied with the configuration, press Esc until you get to Configuration Settings.

14. Highlight Exit Fast!UTIL and press Return. A screen displays Exit Fast!UTIL. Highlight Reboot System and press Return.

The server reboots.

H.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 su to root 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.

H.5 Making an ext3 File System for Linux

The following procedure to label and partition drives using fdisk applies to an ext3 file system. To discover which disk you want to label, you need to find out 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. Then type:

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

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

3. Type m or help.

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)

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.

H.6 Creating a File System

1. Log in as root, or su to root 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 that you are making into a file system. Replace x with 1 since there is only one partition.

H.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)

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.

H.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 check to see if fstab was set up correctly, type:

mount -a

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

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

H.9 Determining the World Wide Name for Linux Hosts

Before you can create host filters, you need to know the world wide 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 storage.

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

See Setting Up Host Filter Entries for more information about creating host filters.