hitachi adaptable modular storage 2000 series

Hitachi Adaptable Modular Storage ®

2000 SeriesHitachi Simple Modular Storage ® 100 Series

Red Hat® Linux® VersionHost Installation Guide for Fibre Channel Connection

FAS TFIND LINK S

Document Organization

Getting Help

Contents

K6603482

Hitachi Adaptable Modular Storage 2000 Series/Hitachi Simple Modular Storage 100 Series Host Installation Guide for Red Hat Linux

ii

Copyright © 2008 Hitachi Data Systems Corporation, ALL RIGHTS RESERVED

Notice: No part of this publication may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, or stored in a database or retrieval system for any purpose without the express written permission of Hitachi Data Systems Corporation (hereinafter referred to as “Hitachi Data Systems”).

Hitachi Data Systems reserves the right to make changes to this document at any time without notice and assumes no responsibility for its use. Hitachi Data Systems products and services can only be ordered under the terms and conditions of Hitachi Data Systems’ applicable agreements. All of the features described in this document may not be currently available. Refer to the most recent product announcement or contact your local Hitachi Data Systems sales office for information on feature and product availability.

This document contains the most current information available at the time of publication. When new and/or revised information becomes available, this entire document will be updated and distributed to all registered users.

Hitachi Data Systems is a registered trademark and service mark of Hitachi, Ltd., and the Hitachi Data Systems design mark is a trademark and service mark of Hitachi, Ltd.

VERITAS is a trademark of Symantec Corporation.

All other brand or product names are or may be trademarks or service marks of and are used to identify products or services of their respective owners.

Contents

Preface............................................................................................. iii

System Configuration Prerequisites..................................................3

1.1 Installation and Configuration Roadmap.....................................3

Preparing the Host Servers...............................................................3

2.1 Connecting the AMS2000/SMS100 System to the Red Hat Linux Host.......................................................................3

2.2 Configuring the Host Fibre-Channel HBA(s)...................3

2.3 Verifying New Device Recognition......................................3

Configuring the New Disk Devices....................................................3

3.1 Partitioning the Devices...........................................................3

Troubleshooting................................................................................3

4.1 Calling the Hitachi Data Systems Support Center.......3

Acronyms and Abbreviations............................................................3

Contents


iii

Contents


iv

Preface

Welcome to the Hitachi Adaptable Modular Storage/Hitachi Simple Modular Storage (called the AMS2000/SMS100 series hereafter) Installation Guide for RED HAT LINUX. This document provides guidelines about how to connect the Adaptable Modular Storage/Simple Modular Storage system (called the AMS2000/SMS100 system hereafter) with a RED HAT LINUX host, and provides information on where to find resources to ensure proper functioning between the AMS2000/SMS100 system and RED HAT LINUX host.

Note: This guide assumes that the AMS2000/SMS100 system is installed and functioning correctly. If it is not, install the system before reading this guide.

Please read this document carefully to understand how to use this product, and maintain a copy for reference purposes.

This preface includes the following information:

Document revision Level

Safety and Warnings

Intended Audience


Referenced Documents

Related Web Sites

Document Conventions

Convention for Storage Capacity Values

Getting Help

Support Contact Information

Comments

Notice: The use of AMS2000/SMS100 system and all other Hitachi Data Systems products is governed by the terms of your agreement(s) with Hitachi Data Systems.

Preface


v

Document Revision Level

This section provides a history of the revision changes to this document.

Revision Date Description

K6603482-00 April 2008 Initial Release

Safety and Warnings

This document uses the following symbols to draw attention to important safety and operational information.

Symbol

Meaning Description

Tip Tips provide helpful information, guidelines, or suggestions for performing tasks more effectively.

Note Notes emphasize or supplement important points of the main text.

Caution Cautions indicate that failure to take a specified action could result in damage to the software or hardware.

WARNING Warnings indicate that failure to take a specified action could result in loss of data or serious damage to hardware.

Intended Audience

This document is intended for system administrators, Hitachi Data Systems representatives, Authorized Service Providers, and AMS2000/SMS100 system customers who are involved in verifying the AMS2000/SMS100 system LUNs connected to the host server are discovered by the AMS2000/SMS100 system and can be used by RED HAT LINUX and other applications. It also assumes the user is familiar with the following:

• Direct-access storage device (DASD) systems and their basic functions.

• AMS2000/SMS100 Series Host Installation Guide for RED HAT LINUX system and the LUN configurations as described in supporting Hitachi Data Systems documents.

Preface


vi

• RED HAT LINUX operating system and the RED HAT LINUX server systems. For the latest supported operating systems, go to the HiFire Web Site.UNIX® file system, system commands, and utilities.


The following table provides an overview of the contents and organization of this document. Click the chapter title in the first column to go to that chapter. The first page of every chapter or appendix contains a brief list of the contents of that section of the manual, with links to the pages where the information is located.

Chapter/AppendixTitle

Description

Chapter 1, System Configuration Prerequisites

Describes the prerequisites for setting up a AMS2000/SMS100 system to work with RED HAT LINUX .

Chapter 2, Connecting the Host Servers

Discusses guidelines on preparing the RED HAT LINUX host to connect to the AMS2000/SMS100 system.

Chapter 3, Verifying and Discovering LUNs

Discusses how LUNs are discovered.

Chapter 4, Troubleshooting Lists possible error messages and conditions, and actions to take to resolve these issues.

Referenced Documents

These documents contain information that is related to the topics in this document and can provide additional information about them.

Preface


vii

Related Web Sites

Before you install FC HBAs, drivers, and BIOS, verify they are supported by Hitachi Data Systems and the OS vendor by referring to the Web sites listed below.

• For information on items supported by Hitachi Data Systems:

• Hitachi Customer Support Portal:http://support.hds.com

• Hitachi Interoperability Web Site (HiFire):

https://extranet.hds.com/http://hifirerw.hds.com/HiFire/GuestRegister.jsp

• Check the HBA vendor’s web sites for the latest driver and BIOS updates.

• For OS-specific issues, refer to the RED HAT Web site:

http://www.redhat.com/

N Hitachi Data Systems is not responsible for the availability of third-party web sites mentioned in this document. Hitachi Data Systems does not endorse and is not responsible or liable for any content advertising, products, or other materials that are available on or through such sites or resources. Hitachi Data Systems will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content goods, or services that are available on or through such sites or resources.

Document Conventions

The following table describes the typographic conventions used in this document.

Convention Description

Bold Indicates text on a window, other than the window title, including menus, menu options, buttons, fields, and labels. Example: Click OK.

Italic Indicates a variable, which is a placeholder for actual text provided by the user or system. Example: copy source-file target-file. Note: Angled brackets (< >) are also used to indicate variables.

screen/codeIndicates text that is displayed on screen or entered by the user. Example: # pairdisplay -g oradb

< > angled brackets

Indicates a variable, which is a placeholder for actual text provided by the user or system. Example: # pairdisplay -g <group>Note: Italic font is also used to indicate variables.

[ ] square brackets

Indicates optional values. Example: [ a | b ] indicates that you can choose a, b, or nothing.

Preface


viii

http://www.redhat.com/

https://extranet.hds.com/http://hifirerw.hds.com/HiFire/GuestRegister.jsp

http://support.hds.com/

{ } braces Indicates required or expected values. Example: { a | b } indicates that you must choose either a or b.

| vertical bar Indicates that you have a choice between two or more options or arguments. Examples:[ a | b ] indicates that you can choose a, b, or nothing.{ a | b } indicates that you must choose either a or b.

underline Indicates the default value. Example: [ a | b ]

Convention for Storage Capacity Values

The Operating system displays storage capacity values in various places in GUI and command line outputs. To determine the base calculation conventions for these Storage Capacity values, consult the Operating system Vendors’ Online Help or Web site articles. Displays may differ for AMS2000/SMS100 system. Refer to the appropriate Hitachi Data Systems documents associated with your system for details.

For further information on the Hitachi Data Systems storage system, refer to the user's guide for the system (for example, Hitachi Adaptable Modular Storage 2000 Series User’s Guide, MK-XXXX/Hitachi Simple Modular Storage 100 Series User’s Guide, MK-XXXX). For further information on Hitachi Data Systems products and services, please contact your Hitachi Data Systems account team, or visit Hitachi Data Systems online at http://www.hds.com.

Getting Help

If you have questions after reading this guide, contact an Hitachi Data Systems authorized service provider or visit the Hitachi Data Systems support website, http://support.hds.com.

Support Contact Information

If you purchased this product from an authorized Hitachi Data Systems reseller, contact that reseller for support. For the name of your nearest Hitachi Data Systems authorized reseller, refer to the Hitachi Data Systems support web site for locations and contact information.

To contact the Hitachi Data Systems Support Center, please visit the Hitachi Data Systems website at http://support.hds.com.

Please provide at least the following information about the problem:

• Product name, model number, part number (if applicable) and serial number

• System configuration, including names of optional features installed, host connections, and storage configuration such as RAID groups and LUNs

• Operating system name and revision or service pack number

Preface


ix

http://www.hds.com/

• The exact content of any error message(s) displayed on the host system(s)

• The circumstances surrounding the error or failure

• A detailed description of the problem and what has been done to try to solve it

• Confirmation that the Hitachi Data Systems Hi-Track remote monitoring feature has been installed and tested.

Comments

Your comments and suggestions to improve this document are greatly appreciated. When contacting Hitachi Data Systems, please include the document title, number, and revision. Please refer to specific section(s) and paragraph(s) whenever possible.

• E-mail: [email protected]

• Fax: 858-695-1186

• Mail: Technical Writing, M/S 35-10 Hitachi Data Systems 10277 Scripps Ranch Blvd. San Diego, CA 92131

Thank you! (All comments become the property of Hitachi Data Systems Corporation.)

Preface


x

System Configuration Prerequisites

This chapter provides an overview of the tasks that need to be completed before you connect the RED HAT LINUX host to an AMS2000/SMS100 system.

This chapter covers the following key topics:

1.1 Installation and Configuration Roadmap



1

1.1 Installation and Configuration Roadmap

The steps in Figure 1-1 outline the general process you follow to install and configure the AMS2000/SMS100 system on a Red Hat Linux operating system.

Table1-1 Installation and Configuration Roadmap

Task

1. Verify that the system on which you are installing the AMS2000/SMS100 system meets the minimum requirements for this release.

2. Prepare the AMS2000/SMS100 system for the installation.

3. Connect the AMS2000/SMS100 system to a Red Hat Linux host.

4. Configure the fibre-channel HBAs for the installation.

5. Verify recognition of the new devices.

6. Set the number of logical units.

7. Partition the disk devices.

2. Prepare the AMS/SMS

3. Connect AMA/SMS to the Red Hat Linux Host

4. Configure the Fibre-Channel

HBA(s)

6. Set the Number of

Logical Units

1. Verify Minimum

Requirements

5. Verify Recognition of

the New Devices

7. Partition Disk Devices

Figure1-1 Installation and Configuration Roadmap



2


Hitachi Adaptable Modular Storage Host Installation Guide for RED HAT LINUX

3

Preparing the Host Servers

This chapter describes how to set up a Red Hat Linux operating system:

This chapter covers the following key topics:

2.1 Connecting the AMS2000/SMS100 system to the Red Hat Linux Host

2.2 Configuring the Host Fibre-Channel HBA(s)

2.3 Verifying New Device Recognition



4

2.1 Connecting the AMS2000/SMS100 System to the Red Hat Linux Host

After you prepare the AMS2000/SMS100 system hardware and software and fibre-channel HBA(s), connect the AMS2000/SMS100 system to the Red Hat Linux system. The AMS2000/SMS100 system comes with all the hardware and cabling required for connection to the host system(s).

Table 2-1 summarizes the steps for connecting AMS2000/SMS100 system to the Red Hat Linux system host. Some steps are performed by the Hitachi Data Systems representative, while others are performed by the user.

Table 2-1 Steps for Connecting AMS2000/SMS100 System to a Red Hat Linux Host

Activity Performed by Description

1. Verify AMS2000/SMS100 system installation

Hitachi Data Systems representative

Confirm that the status of the fibre-channel HBA(s) and LDEVs is NORMAL.

2. Shut down the Red Hat Linux system

User Power off the Red Hat Linux system before connecting the AMS2000/SMS100 system.

Shut down the Red Hat Linux system.

When shutdown is complete, power off the Red Hat Linux display.

Power off all peripheral devices except for the AMS2000/SMS100 system.

Power off the host system. You are now ready to connect the AMS2000/SMS100 system.

3. Connect the AMS2000/SMS100 system

Hitachi Data Systems representative

Install fibre-channel cables between the AMS2000/SMS100 system and the Red Hat Linux system. Follow all precautions and procedures in the Adaptable Modular Storage Maintenance Manual/Simple Modular Storage Maintenance Manual. Check all specifications to ensure proper installation and configuration.

4. Power on the Red Hat Linux system

User Power on the Red Hat Linux system after connecting the AMS2000/SMS100 system:

Power on the Red Hat Linux system display.

Power on all peripheral devices. The AMS2000/SMS100 system should be on, and the fibre-channel ports should be configured. If the fibre ports are configured after the Red Hat Linux system is powered on, restart the system to have the new devices recognized.

Confirm the ready status of all peripheral devices, including the AMS2000/SMS100 system

Power on the Red Hat Linux system.

5 Boot the Red Hat Linux system



5

2.2 Configuring the Host Fibre-Channel HBA(s)

Configure the fibre-channel HBA(s) connected to the AMS2000/SMS100 system. The HBAs have many configuration options. This section provides the following minimum requirements for configuring host fibre-channel adapters for operation with the AMS2000/SMS100 system. For more information, refer to the documentation for your fibre-channel HBA(s).

The queue depth requirements for AMS2000/SMS100 system devices are specified in Table 2-2.

The BIOS might need to be disabled to prevent the system from trying to boot from the AMS2000/SMS100 system.

Several other parameters (e.g., FC, fabric) may also need to be set. Please refer to the user documentation that came with your HBA to determine whether other options are required to meet your operational requirements.

Note: Be sure to use the same settings and device parameters for all AMS2000/SMS100 system devices.

Table 2-2 Requirements for AMS2000/SMS100 System Devices

Parameter Required Value

Queue depth per LU 32 per LU

Queue depth per port (MAXTAGS) 512 per port

Note: You can adjust the queue depth for the AMS2000/SMS100 system devices later as needed (within the specified range) to optimize the I/O performance of the AMS2000/SMS100 system devices.



6

2.3 Verifying New Device Recognition

The final step before configuring the new AMS2000/SMS100 system disk devices is to verify that the host system recognizes the new devices. The host system automatically creates a device file for each new device recognized.

To verify new device recognition:

1. Use the dmesg command to display the devices (see Figure 2-3).

2. Record the device file name for each new AMS2000/SMS100 system device. You will need this information when you partition the devices (see Verifying Device Recognition by Red Hat Linux). See Table 2-8 for a sample SCSI path worksheet.

3. The device files are created under the /dev directory. Verify that a device file was created for each new AMS2000/SMS100 system disk device (see Figure 2-4).

# dmesg | more::scsi1 : ioc1: LSI53C1030, FwRev=01032700h, Ports=1, MaxQ=255, IRQ=209 Emulex LightPulse Fibre Channel SCSI driver 8.1.10.3 Copyright(c) 2004-2006 Emulex. All rights reserved. scsi : 1 host.Vendor: HITACHI Model: DF600F Rev: 0000Type: Direct-Access ANSI SCSI revision: 04sd 0:0:0:0: Attached scsi disk sda scsi ID0/channel 0/ID 0/lun 0 Device file name of this disk = /dev/sda

Vendor: HITACHI Model: DF600F Rev: 0000Type: Direct-Access ANSI SCSI revision: 04sd 0:0:0:1: Attached scsi disk sd b ::

In this example, the HITACHI DF600F device (TID 0, LUN 0) and the HITACHI DF600F device (TID 0, LUN 1) are recognized by the Red Hat Linux server.

Figure 2-2 Example of Verifying New Device Recognition

# ls -l /dev | more:brw-rw---- 1 root disk 8, 0 Oct 30 2007 sda Device file = sda

Figure 2-3 Example of Verifying Device Files



7

Setting of Device Mapper Multipath

You can duplicate the path for the LUN of Hitachi Simple Modular Storage in the following procedure.

1. Please gather the backup when “/etc/multipath.conf” already exists.# cp /etc/multipath.conf /etc/multipath.conf.bak

2. Please edit “/etc/multipath.conf” as follows.defaults {

udev_dir /devpolling_interval 10selector "round-robin 0"path_grouping_policy failovergetuid_callout "/sbin/scsi_id -g -u -s /block/%n"prio_callout /bin/truepath_checker readsector0rr_min_io 100rr_weight prioritiesfailback immediateuser_friendly_name yesdefault_features "1 queue_if_no_path"

}devnode_blacklist {# wwid 26353900f02796769

devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"devnode "^hd[a-z]"devnode "^sda$" # When internal organs HDD is sdadevnode "^cciss!c[0-9]d[0-9]*"

}devices {

device {vendor "HITACHI"product "DF600F"path_grouping_policy multibuspath_checker readsector0getuid_callout "/sbin/scsi_id -g -u -s /block/%n"failback immediate

}}

3. The multipath demon is started.# service multipathd startThe multipath demon is being start: [ OK ]



8

4. Path is doubled.# multipathcreate: 36000000000000000045a0b5700000000 HITACHI, DF600F[size=10G][features=1 queue_if_no_path][hwhandler=0]\_ round-robin 0 [prio=0][active] \_ 4:0:0:2 sdb 66:48 [active][ready] \_ 5:0:0:2 sdj 67:48 [active][ready]create: 36000000000000000045a0b5700000001 HITACHI,DF600F[size=10G][features=1 queue_if_no_path][hwhandler=0]\_ round-robin 0 [prio=0][active] \_ 4:0:0:1 sdc 66:32 [active][ready] \_ 5:0:0:1 sdk 67:32 [active][ready]･････

5. The device name is listed.# multipath -F# multipath | grep create | sort | awk {'print $2'}36000000000000000045a0b570000000036000000000000000045a0b5700000001･････

6. Alias of the device name is set to “/etc/multipath.conf”.multipaths {

multipath {wwid 36000000000000000045a0b5700000000alias lu000

}multipath {

wwid 36000000000000000045a0b5700000001alias lu001

}･････}

7. “/etc/multipath.conf” is applied again by restarting the multipath demon.# service multipathd restartmultipathd demon is being stop: [ OK ]multipathd demon is being start: [ OK ]# multipathcreate: lu000 (36000000000000000045a0b5700000000) HITACHI, DF600F[size=10G][features=1 queue_if_no_path][hwhandler=0]\_ round-robin 0 [prio=0][active] \_ 4:0:0:2 sdb 66:48 [active][ready] \_ 5:0:0:2 sdj 67:48 [active][ready]create: lu001 (36000000000000000045a0b5700000001) HITACHI, DF600F[size=10G][features=1 queue_if_no_path][hwhandler=0]\_ round-robin 0 [prio=0][active] \_ 4:0:0:1 sdc 66:32 [active][ready] \_ 5:0:0:1 sdk 67:32 [active][ready]･････



9

Preparing the Host Servers


11

Configuring the New Disk Devices

This chapter describes how to configure the new AMS2000/SMS100 system disk devices that you attached to the Red Hat Linux system host in the previous chapter:

3.1 Partitioning the Devices

Configuring the New Disk Devices


12

3.1 Partitioning the Devices

After the setting the number of logical units, use the following procedure to set the partitions on the AMS2000/SMS100 system disk devices:

1. Enter fdisk/dev/<device_name>

Example: fdisk/dev/sda

where dev/sda is the device file name

2. Select p to display the present partitions.

3. Select n to make a new partition. You can make up to four primary partitions (1-4) or one extended partition. The extended partition can be organized into 11 logical partitions, which can be assigned partition numbers from 5 to 15.

4. Select w to write the partition information to disk and complete the fdisk command.

Note: Other commands that you might want to use include d to remove partitions or q to stop a change.

Repeat steps 1 through 4 for each new AMS2000/SMS100 system disk device.

Other Settings


13

Troubleshooting

This chapter provides troubleshooting information for AMS2000/SMS100 system and instructions for calling technical support.

4.1 Calling the Hitachi Data Systems Support Center

Troubleshooting


14

4.1 Calling the Hitachi Data Systems Support Center

This chapter provides troubleshooting information for AMS2000/SMS100 Series Host Installation Guide for RED HAT LINUX and instructions for calling technical support.

Table 4-1: Potential Error Conditions and Recommended Ac lists some potential error conditions during AMS2000/SMS100 Series Host Installation Guide for RED HAT LINUX system configuration with the RED HAT LINUX host, and provides instructions for resolving each condition. If you are unable to resolve an error condition, please contact your Hitachi Data Systems representative or VAR for help, or log on to the Hitachi Customer Support Portal:

http://support.hds.com

Table 4-1: Potential Error Conditions and Recommended Actions

Error Condition Recommended Action

The AMS2000/SMS100 Series Host Installation Guide for RED HAT LINUX LUN devices are not recognized by the system.

Verify that the READY indicator lights on the AMS2000/SMS100 Series Host Installation Guide for RED HAT LINUX system are working properly.Check that the Fibre Channel interface cables are correctly installed and firmly connected.Recheck the Fibre Channel buses for new devices using lsdev command.

The AMS2000/SMS100 system red alarm light is on.

Please contact the Hitachi Data Systems Support Center.

•

If you need to call the Hitachi Data Systems Support Center, make sure to provide as much information about the problem as possible, including:

• The circumstances surrounding the error or failure.

• The exact content of any error messages displayed on the host system(s).

• The exact content of any error messages displayed by Storage Navigator Modular 2.

• The Storage Navigator Modular 2 configuration information.

The Hitachi Data Systems customer support staff is available 24 hours/day, seven days a week. If you need technical support, please call:

• United States: (800) 446-0744

•Outside the United States: (858) 547-4526

Troubleshooting


15

Acronyms and Abbreviations

AL arbitrated loop

AL-PA arbitrated-loop physical address

AMS Adaptable Modular Storage

CLI command line interface

e.g. for example

FCP fibre-channel protocol

GUI graphical user interface

HBA host bus adapter

HDD hard disk drive

HDLM Hitachi Dynamic Link Manager

LU logical unit

LUN logical unit number

MB megabytes

OFC open fibre control

OS operating system

PC personal computer system

RAID redundant array of independent disks

SMS Simple Modular Storage

TID target ID

VxVM VERITAS Volume Manager



16



17

Hitachi Data Systems

Corporate Headquarters750 Central ExpresswaySanta Clara, California 95050-2627U.S.A.Phone: 1 408 970 [email protected]

Asia Pacific and Americas750 Central ExpresswaySanta Clara, California 95050-2627U.S.A.Phone: 1 408 970 [email protected]

Europe HeadquartersSefton ParkStoke PogesBuckinghamshire SL2 4HDUnited KingdomPhone: + 44 (0)1753 [email protected]

mailto:[email protected]



http://www.hds.com/