Fujitsu ETERNUS Multipath Driver V2 User manual

FUJITSU Storage

ETERNUS Multipath Driver V2

User's Guide

P2U3-0031-15ENZ0

for Linux

This page is intentionally left blank.

FUJITSU Storage ETERNUS Multipath Driver V2 User’s Guide for Linux

Preface

This FUJITSU Storage ETERNUS Multipath Driver User's Guide describes the features, functions, and operation

of the "ETERNUS Multipath Driver" (hereinafter referred to as "Multipath Driver") software on a Linux server.

This manual describes how to use the Multipath Driver to manage the path control, connection status, and

other features of FUJITSU Storage "ETERNUS Disk storage system, ETERNUS All Flash Array, GR series"

(hereinafter referred to as "storage system" unless stated otherwise).

The latest information is provided in the "FUJITSU Storage ETERNUS Multipath Driver V2 (for Linux) Installation

Information" found under "Downloads" at the following URL:

http://www.fujitsu.com/global/products/computing/storage/software/eternus-mpd/

Fifteenth Edition

October 2014

Intended Audience

This guide is intended for system administrators who are connecting the storage system to a Linux server.

Organization and Contents

This guide is composed of the following 11 chapters and an appendix.

●Chapter 1 What is Multipath Driver?

This chapter explains the features, functions, and connection patterns of the Multipath Driver.

●Chapter 2 Multipath Driver System Setup

This chapter explains how to install and uninstall the Multipath Driver. Instructions are provided for setting

up the system environment, including setup of logical units, partitions, and file systems, and mounting the

storage system.

●Chapter 3 Multipath Driver Functions and Operation

This chapter explains how to use the main commands to operate various functions of the Multipath Driver.

●Chapter 4 Changing the Multipath Configuration (FC/FCoE Connection for RHEL-AS4, RHEL-ES4, RHEL5,

SLES9, or SLES10)

This chapter explains how to change a multipath configuration for a FC/FCoE connection with RHEL-AS4,

RHEL-ES4, RHEL5, SLES9, or SLES10.

Preface

FUJITSU Storage ETERNUS Multipath Driver V2 User’s Guide for Linux

●Chapter 5 Changing the Multipath Configuration (SAS Connection for RHEL-AS4, RHEL-ES4, RHEL5, or

SLES10)

This chapter explains how to change a multipath configuration for a SAS connection with RHEL-AS4, RHEL-

ES4, RHEL5, or SLES10.

●Chapter 6 Changing the Multipath Configuration (iSCSI Connection for RHEL5, SLES9, or SLES10)

This chapter explains how to change a multipath configuration for an iSCSI connection with RHEL5, SLES9,

or SLES10.

●Chapter 7 Changing the Multipath Configuration (FC/FCoE Connection for RHEL6, RHEL7, or SLES11)

This chapter explains how to change a multipath configuration for a FC/FCoE connection with RHEL6,

RHEL7, or SLES11.

●Chapter 8 Changing the Multipath Configuration (SAS Connection for RHEL6, RHEL7, or SLES11)

This chapter explains how to change a multipath configuration for a SAS connection with RHEL6, RHEL7, or

SLES11.

●Chapter 9 Changing the Multipath Configuration (iSCSI Connection for RHEL6, RHEL7, or SLES11)

This chapter explains how to change a multipath configuration for an iSCSI connection with RHEL6, RHEL7,

or SLES11.

●Chapter 10 Notes when Using the Multipath Driver

This chapter contains important notes for using the Multipath Driver.

●Chapter 11 Command Reference

This chapter contains important notes for using the Multipath Driver.

A list of "Syslog Messages" is provided in the appendix.

Preface

FUJITSU Storage ETERNUS Multipath Driver V2 User’s Guide for Linux

Trademarks, Product Names, and Abbreviations Used in this Guide

•"HBA" represents a Host Bus Adapter, which is a Linux server-installed Fibre Channel card, Serial Attached

SCSI (SAS) card, or Converged Network Adapter (CNA) that connects to a storage system.

•"NIC" is a Network Interface Card.

•"CA" is a storage system Channel Adapter.

•"CM" is a storage system Controller Module.

•The following software bundle is described as "ETERNUS Web GUI".

-Web-based GUI management tool that is provided with the storage system as standard

-ETERNUSmgr that is installed in some storage systems

•Red Hat Enterprise Linux series products are as described below.

•SUSE Linux Enterprise Server series products are as described below.

Related Manuals

Refer to the following related manuals for more information:

•The storage system manual

•The manual provided with ETERNUS Web GUI/GRmgr/ETERNUSmgr

Product names Abbreviation

Red Hat Enterprise Linux 7 RHEL7

Red Hat Enterprise Linux 6 RHEL6

Red Hat Enterprise Linux 5 RHEL5

Red Hat Enterprise Linux AS v.4 RHEL-AS4

Red Hat Enterprise Linux ES v.4 RHEL-ES4

Product names Abbreviation

SUSE Linux Enterprise Server 11 SLES11

SUSE Linux Enterprise Server 10 SLES10

SUSE Linux Enterprise Server 9 SLES9

Preface

FUJITSU Storage ETERNUS Multipath Driver V2 User’s Guide for Linux

Typographical Conventions

The following conventions are used in this guide.

High Safety

This Product is designed, developed and manufactured as contemplated for general use, including without

limitation, general office use, personal use, household use, and ordinary industrial use, but is not designed,

developed and manufactured for use in situations with accompanying fatal risks or dangers that, unless

extremely high safety is secured, could lead directly to death, personal injury, severe physical damage or

other loss (hereinafter "High Safety Required Use"), including without limitation, nuclear reaction control in

nuclear facility, aircraft flight control, air traffic control, mass transport control, medical life support system,

and missile launch control in weapon systems. Do not use this Product for High Safety Required Use without

securing the sufficient safety level required. If you wish to use this Product for High Safety Required Use,

please consult with our sales representative before such use.

Linux is a registered trademark of Linus Torvalds.

Red Hat is a registered trademark of Red Hat, Inc. in the U.S. and other countries.

SUSE is a registered trademark of Novell, Inc. in the United States and other countries.

Intel, the Intel logo, Itanium, and the Itanium logo are trademarks of Intel Corporation in the U.S. and other

countries.

The company names, product names and service names mentioned in this document are registered

trademarks or trademarks of their respective companies.

A product-usage caution that must be followed.

Not doing so may result in loss of data.

A note that provides additional information.

FUJITSU Storage ETERNUS Multipath Driver V2 User’s Guide for Linux

Release Information

Multipath Driver Modification History

This section provides a history of modifications for the Multipath Driver.

■V2.0L03 modifications

●Modification outline

Previously, when a response from the device was "Illegal Request", it was changed to "DID_SOFT_ERROR".

For V2.0L03, the "Illegal Request" response does not change to "DID_SOFT_ERROR".

-Modification target

Multipath Driver

-Modification details

-Modification effect

Previously, some I/Os for which the cause of the error was "Illegal Request" returned "DID_SOFT_ERROR".

After this modification, "Illegal Request" is returned for I/Os for which the error factor is "Illegal

Request".

●Modification outline

The error levels of some messages that were NOTICE or lower error levels have been changed to WARNING

or higher. In addition, the error levels of some messages that were WARNING or higher have been changed

to NOTICE or lower.

-Modification target

Multipath Driver

-Modification details

-Modification effect

This change affects when error levels are used for message monitoring.

Version Modification details

V2.0L02 or earlier The "Illegal Request" response from the device changes to "DID_SOFT_ERROR".

V2.0L03 The "Illegal Request" response from the device does not change to "DID_SOFT_ERROR".

Version Modification details

V2.0L02 or earlier Some error messages that require device monitoring have "NOTICE" error level. Some

error messages that do not require device monitoring have "WARNING" error level.

V2.0L03 For error messages that require device monitoring, "WARNING" or higher error level are

displayed. For error messages that do not require device monitoring, "NOTICE" or a lower

error level are displayed.

Release Information

FUJITSU Storage ETERNUS Multipath Driver V2 User’s Guide for Linux

■V2.0L10 modification

●Modification outline

The "by-path" name for the udev function is not created after V2.0L10 is applied. Use the "by-id" name.

-Modification target

Multipath Driver

-Modification details

-Modification effect

The "by-path" name for the udev function cannot be used. Use the "by-id" name.

■V2.0L11 modification

●Modification outline

Removed the function that inquires whether the udev function is used or not when using the "mpdconfig -

s" command.

-Modification target

"mpdconfig" command

-Modification details

-Modification effect

Does not affect any other operation.

Version Modification details

V2.0L03 or earlier Creates a "by-path" name.

V2.0L10 Does not create a "by-path" name.

Version Modification details

V2.0L10 or earlier Inquires whether the udev function is used or not when using the "mpdconfig -s"

command.

V2.0L11 Does not inquire whether the udev function is used or not when using the "mpdconfig -s"

command.

Release Information

FUJITSU Storage ETERNUS Multipath Driver V2 User’s Guide for Linux

■V2.0L12 modifications

●Modification outline

The default Max Throttle value of the ETERNUS2000 is changed from "256" to "40".

-Modification target

Multipath Driver

-Modification details

-Modification effect

After a connected ETERNUS2000 is initially recognized, the Max Throttle value is changed from "256" to

"40".

●Modification outline

The default Max Throttle setting of the ETERNUS8000, the ETERNUS6000, and the ETERNUS4000 model

300 and 500 is automated.

-Modification target

Multipath Driver

-Modification details

-Modification effect

When connecting to the ETERNUS8000, the ETERNUS6000, and the ETERNUS4000 model 300 and 500,

Max Throttle does not have to be set with the "mpdconfig -m" command.

Version Modification details

V2.0L11 or earlier The default Max Throttle value of the ETERNUS2000 is "256".

V2.0L12 The default Max Throttle value of the ETERNUS2000 is "40".

Version Modification details

V2.0L11 or earlier The default Max Throttle value of the ETERNUS8000, the ETERNUS6000, and the

ETERNUS4000 model 300 and 500 has to be manually specified.

V2.0L12 The default Max Throttle value of the ETERNUS8000, the ETERNUS6000, and the

ETERNUS4000 model 300 and 500 is automatically specified.

Release Information

FUJITSU Storage ETERNUS Multipath Driver V2 User’s Guide for Linux

■V2.0L13 modifications

●Modification outline

The maximum number of devices for the specifying recognition order is changed from "20" to "32".

-Modification target

Multipath Driver, "mpdconfig" command

-Modification details

-Modification effect

Up to 32 storage systems can be specified for the recognition order. If 33 or more storage systems are

specified for the recognition order and the "mpdconfig -s" command is executed, the following error

message is displayed:

●Modification outline

Added a message for loading concurrent firmware in storage systems.

-Modification target

Multipath Driver

-Modification details

-Modification effect

When performing message monitoring, the newly added message may not be monitored as intended.

Note that this change does not affect the message monitoring function with Fujitsu middleware.

Version Modification details

V2.0L12 or earlier Up to 20 devices can be specified for the recognition order.

V2.0L13 Up to 32 devices can be specified for the recognition order.

Cannot setup because the number of devices is greater than 32.

Version Modification details

V2.0L12 or earlier Even when performing concurrent firmware loading closes all the paths for the

connected storage system, a message is not output in "/var/log/messages".

V2.0L13 When performing concurrent firmware loading closes all the paths for the connected

storage system, the following message is output in "/var/log/messages":

MPDH%d: NOTICE: %s: Device configuration is without

CFL redundancy.

All paths connect to (ZZ%x, ZZ%x).

Table of contents

Other Fujitsu Storage manuals

Fujitsu

Fujitsu Eternus CS800 S2 User manual

Fujitsu

Fujitsu MAP3147NC - Enterprise - Hard Drive User manual

Fujitsu

Fujitsu MAP3147NP User manual

Fujitsu

Fujitsu ETERNUS DX60 User manual

Fujitsu

Fujitsu MPF3XXXAT User manual

Fujitsu

Fujitsu Storage ETERNUS CS800 M1 Manual

Fujitsu

Fujitsu MHW2040AT - Mobile 40 GB Hard Drive User manual

Fujitsu

Fujitsu ETERNUS DX S4 Series User manual

Fujitsu

Fujitsu ETERNUS DX Disk User manual

Fujitsu

Fujitsu PRIMERGY LTO4 User manual

Fujitsu

Fujitsu MPD3XXXAT User manual

Fujitsu

Fujitsu Eternus DX80 S2 User manual

Fujitsu

Fujitsu MBB2147RC SERIES User manual

Fujitsu

Fujitsu ETERNUS DX400 series User manual

Fujitsu

Fujitsu ETERNUS DX S5 Series Installation guide

Fujitsu

Fujitsu DISK DRIVES MHL2300AT User manual

Fujitsu

Fujitsu MAS3367FC User manual

Fujitsu

Fujitsu Streamer DAT 160 User manual

Fujitsu

Fujitsu ETERNUS DX8100 S3 Technical manual

Fujitsu

Fujitsu ETERNUS DX Disk User manual

Fujitsu

Fujitsu DynaMO 640SZI User manual

Fujitsu

Fujitsu MPD3XXXAH User manual

Fujitsu

Fujitsu GP5-HDH96 User manual

Fujitsu

Fujitsu MHT2060BH - Mobile 60 GB Hard Drive User manual

Popular Storage manuals by other brands

QNAP

QNAP TS 32PXU Series user guide

LaCie

LaCie RUGGED RAID user manual

Freecom

Freecom CLS DOCK Quick install guide

PNY

PNY Attache P-FD64MBATT3 install guide

HP StorageWorks MSL2024 Getting started

OLT

OLT 6x6 Maximizer Assembly manual

Transcend

Transcend JetFlash 160 Specifications

LaCie

LaCie RUGGED MINI user manual

Thunderbolt

Thunderbolt 600 user manual

Panasonic

Panasonic LB-DH8 series Operator's guide

Intel

Intel RAID High Availability user guide

LaCie

LaCie 12big Thunderbolt 3 Quick install guide

Spectra Logic

Spectra Logic T-Series Spectra T50e quick start guide

Panasonic

Panasonic LKM-F931-1 instruction manual

Tabernus

Tabernus Enterprise Erase E2400 user guide

Rocstor

Rocstor COMMANDER 3F series user manual

HP P9000 user guide

Western Digital

Western Digital Ultrastar Data60 installation guide