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
Copyright 2014 FUJITSU LIMITED P2U3-0031-15ENZ0
3
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
Copyright 2014 FUJITSU LIMITED P2U3-0031-15ENZ0
4
●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
Copyright 2014 FUJITSU LIMITED P2U3-0031-15ENZ0
5
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
Copyright 2014 FUJITSU LIMITED P2U3-0031-15ENZ0
6
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
Copyright 2014 FUJITSU LIMITED P2U3-0031-15ENZ0
7
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
Copyright 2014 FUJITSU LIMITED P2U3-0031-15ENZ0
8
■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
Copyright 2014 FUJITSU LIMITED P2U3-0031-15ENZ0
9
■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
Copyright 2014 FUJITSU LIMITED P2U3-0031-15ENZ0
10
■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).