Académique Documents
Professionnel Documents
Culture Documents
User's Guide
REFERENCE 86 A2 93ER 11
STOREWAY
Software
June 2011
BULL CEDOC 357 AVENUE PATTON B.P.20845 49008 ANGERS CEDEX 01 FRANCE REFERENCE 86 A2 93ER 11
The following copyright notice protects this book under Copyright laws which prohibit such actions as, but not limited to, copying, distributing, modifying, and making derivative works.
The information in this document is subject to change without notice. Bull will not be liable for errors contained herein, or for incidental or consequential damages in connection with the use of this material.
Table of Contents
Chapter 1.About this Guide............................................................................................................. 1 Chapter 2.Overview........................................................................................................................ 3 2.1Purpose................................................................................................................................... 3 2.2Supported Disk Subsystems........................................................................................................ 3 2.3Supported Architectures............................................................................................................ 3 2.4Supported HBA........................................................................................................................ 4 2.5Packages................................................................................................................................ 4 2.6CD-ROM Contents.................................................................................................................... 5 Chapter 3.Multipathing Feature........................................................................................................ 7 3.1Installation and Configuration.................................................................................................... 7 3.1.1Automatic Installation..................................................................................................... 7 3.1.2Manual Installation......................................................................................................... 9 3.2Advanced Multipathing Configuration.......................................................................................11 3.2.1Multipathing over ISCSI configuration.............................................................................11 3.3Multipathing Un-installation...................................................................................................... 12 3.3.1Automatic Un-installation............................................................................................... 12 3.3.2Manual Un-installation..................................................................................................12 3.4Multipathing Status Checking: multipath Command..................................................................14 3.5Using Multipath Devices.......................................................................................................... 15 3.6Using LVM2 on top of the Multipath devices...............................................................................17 3.7Partitions on top of Multipath Devices.......................................................................................20 3.8Boot Support......................................................................................................................... 21 3.9Taking into Account Newly Created Devices..............................................................................23 3.10Checking Path at Boot Time................................................................................................... 24 3.10.1Automatic Checks...................................................................................................... 24 3.10.2How to Reinitialize Manually the File Paths....................................................................24 3.10.3How to change multipath policy...................................................................................24 3.11Wiring Subsystems............................................................................................................... 25 Chapter 4.Messages..................................................................................................................... 29 4.1FC Multipathing errlog............................................................................................................ 29 4.2Trace example after the first reboot with only a path available.....................................................29 4.3Trace example after a reboot with only a path available.............................................................29 4.4iSCSI Multipath errlog............................................................................................................. 30 Chapter 5.The bsan Tool................................................................................................................ 31 StoreWay Multipath for Linux - User's Guide i
ii
It is assumed that the reader has a good knowledge of the Linux native I/O concepts and features of Linux kernel 2.6.
Chapter 2. Overview
2.1 Purpose
The Bull StoreWay Multipath for Linux product provides two complementary features: Scripts to automatically configure and setup the native multipathing failover / load balancing features of the Device-Mapper module of Linux v2.6 kernel. An additional Nec prio feature to select the bester path.
This document describes the installation and use of these Linux packages.
2.2
The following disk subsystems have been tested and are supported by the Multipathing feature: FRA1622 subsystem with failover mode.
2.3
Supported Architectures
The following architectures, platforms and distributions are supported: NovaScale SLES9 sp3 ia64, RHEL4 up2/up4/up5 ia64, RHEL5 up1/up2/up3/up4/up5.
NovaScale Universal / NovaScale Blade SLES9 sp3 ia32, RHEL4 up2/up4/up5 ia32, RHEL5 up1/up2/up3/up4/up5. SLES9 sp3 EM-64T, RHEL4 up2/up4/up5 EM-64T, RHEL5 up1/up2/up3/up4/up5 EM-64T.
2.4
Supported HBA
Emulex HBA / CNA Qlogic HBA Brocade HBA / CNA
mportant All HBA Emulex, Brocade and QLogic models supported by the drivers of the distributions can be used with the multipathing.
2.5
Packages
The multipathing function basic code and modules are directly available on SuSe SLES9SP, RedHat EL 4 up2 /up4/up5 and RedHat EL 5 up1 and upper Linux distributions. The multipath-tools-x.x.x.rpm on SLES9 or device-mapper-multipath-x.x.x.rpm on RHEL4/5 package is also included in these distributions and must be installed on your system. Additional specific packages are needed for SCSI-reservation and will be installed by the install.sh installation script provided by this StoreWay Multipath for Linux product (see the relevant chapter below).
2.6
CD-ROM Contents
The StoreWay Multipath for Linux CD-ROM contains the following items. Packages are delivering the Optima prio feature and the bsan tool that could gather all the disk-related information for a better understanding of the SAN configuration. These features are described in the next chapters. Packages: sles9 i386 bsan_lib-X.X.X-Y.i586.rpm scsi_reserve_gui-X.X.X-Y.i586.rpm bsan_monitor-X.X.X-Y.i586.rpm ia64 bsan_lib-X.X.X-Y.ia64.rpm scsi_reserve_gui-X.X.X-Y.ia64.rpm bsan_monitor-X.X.X-Y.ia64.rpm x86_64 bsan_lib-X.X.X-Y.x86_64.rpm scsi_reserve_gui-X.X.X-Y.x86_64.rpm bsan_monitor-X.X.X-Y.x86_64.rpm rh4/rh5 i386 bsan_lib-X.X.X-Y.i386.rpm bsan-X.X.X-Y.i386.rpm multipath-tools-nec-X.X.X-Y.i386.rpm ia64 bsan_lib-X.X.X-Y.ia64.rpm bsan-X.X.X-Y.ia64.rpm multipath-tools-nec-0.4.7-1.ia64.rpm x86_64 bsan_lib-X.X.X-Y.x86_64.rpm bsan-X.X.X-Y.x86_64.rpm multipath-tools-nec-X.X.X-Y.x86_64.rpm device-mapper-multipath-0.x.x-x.0.BullRH4.x86_64.rpm rh6 x86_64 multipath-tools-nec-X.X.X-Y.x86_64.rpm bsan_lib-X.X.X-Y.x86_64.rpm bsan-X.X.X-Y.x86_64.rpm i386 multipath-tools-nec-X.X.X-Y.i386.rpm bsan_lib-X.X.X-Y.i386.rpm bsan-X.X.X-Y.i386.rpm setup.sh readme 86A293ER11.pdf (this manual)
3.1.1
Automatic Installation
An installation script is located on the CD-ROM media, which performs all the installation and configuration actions described below in section 3.1.2 Manual Installation. Note On RHEL 6, check the presence of the following package: libsysfs To perform the automatic installation, mount the CD-ROM, go to the mounted cdrom directory and launch the setup.sh script. Example:
The title and CD-ROM version are displayed on the first line. The first choice (Check Supported Distributions) checks and displays the supported distributions, as illustrated below:
The second choice (Activate multipath) installs the bsan packages and configures the multipath. The install is interactive, you must reply to some questions.
After the Multipath installation, you can either uninstall Multipath or quit. Note The displayed choices are context-dependent. Uninstall packages choice uninstalls all packages. Upgrade packages choice updates the packages (this choice is not displayed in the above screen).
3.1.2
Manual Installation
1. Add the following line in the /etc/modprobe.conf.local file on SLES9 or in the /etc/modprobe.conf file on RHEL4
options lpfc lpfc_nodev_tmo=5
2. 3.
4.
5.
Activate Multipathing feature. According to the distribution: On SLES9: The Multipathing feature is activated by the following commands:
# /etc/init.d/boot.multipath start # /etc/init.d/multipathd start
To be directly taken into account at the next reboot, the corresponding service can be activated by the command:
# insserv boot.multipath multipathd
Also check that the /etc/sysconfig/kernel file correctly references the lpfc driver in the INITRD_MODULES variable before issuing the mkinitrd command. On RHEL4/5/6: The Multipathing feature is activated by the following commands:
# /etc/rc.d/init.d/multipathd start
To be directly taken into account at the next reboot, the corresponding service can be activated by the command:
# chkconfig --level 235 multipathd on # mkinitrd f /boot//initrd kernel
Comment the three lines on the top of the /etc/multipath.conf file (as stated in the comments):
# Blacklist all devices by default. Remove this to enable multipathing # on the default devices. # devnode_blacklist { # #} ## devnode "*"
6.
10
3.2
3.2.1
11
3.3
Multipathing Un-installation
You can un-install Multipathing either automatically or manually.
3.3.1
Automatic Un-installation
mportant The un-installation must be done with the SAME version of the CD-ROM.
To perform the automatic un-installation, do as follows: 1. 2. 3. Mount the CD-ROM, Go to the mounted cdrom directory Launch the setup.sh script. The following screen appears:
4.
Select choice 3.
3.3.2
Manual Un-installation
To un-install manually the Multipathing feature (unsuitable), do as follows: 1. Remove the bsan tool:
rpm e bsan_lib-w.x.y-z rpm e bsan[_monitor]-w.x.y-z
12
2.
According to the distribution: On SLES9 Remove the lpfc option (options lpfc lpfc_nodev_tmo=5) in the /etc/modprobe.conf.local file. Run:
mkinitrd
On RHEL4/5/6 Remove the lpfc option (options lpfc lpfc_nodev_tmo=5) in /etc/modprobe.conf file Run:
mkinitrd f /boot//<initrd-file> <kernel>
13
3.4
In this example: The hexadecimal string (1NEC_iStorage_2000_00000009279003580010A) is the unique identification of the device given back by the device-mapper layer. This identification can be used as unique name of devices on the SAN, bringing the capability of persistent naming over reconfiguration events. It also shows the size, the feature and hardware handlers involved, as well as the priority groups: path are grouped into priority groups where only one priority group is active for I/O usage. To model an active/active configuration, all paths are included in the same group. To model an active/passive configuration, the paths which should not be active in parallel are placed in several distinct priority groups. This setting is completely automatic at device discovery time. Both paths on the same priority group are used with round-robin/load balancing algorithm. For each path, its physical address (host:bus:target:lun), device node name in /dev and major:minor are also displayed. The current path status (active or not) is also shown.
Notes: a) You may change the active priority group with the switchgroup command. Usage: switchgroup mapname index Example:
switchgroup1NEC_iStorage_2000_00000009279003580010A 1
b)
With a NetApp subsystem one of the paths is the main one (i.e. the more efficient one for IOs), the second path is a backup one (see bsan command to display such information). On a failure, the backup path will be activated. After the repair of the failed path: with RHEL4 up2, you can use the perf_netapp command to restore the IOs on the main path. with RHEL4 up4 and upper, it is automatic.
14
3.5
The device mapper identification can be directly used for file-system or physical volume creation. Filesystem creation:
# mke2fs /dev/disk/by-name/1NEC_iStorage_2000_0000009279003580010A mke2fs 1.36 (05-Feb-2005) Filesystem label= OS type: Linux Block size=4096 (log=2) Fragment size=4096 (log=2) 1093440 inodes, 2184448 blocks 109222 blocks (5.00%) reserved for the super user First data block=0 67 block groups 32768 blocks per group, 32768 fragments per group 16320 inodes per group Superblock backups stored on blocks: 32768, 98304, 163840, 229376, 294912, 819200, 884736, 1605632 Writing inode tables: done Writing superblocks and filesystem accounting information: done This filesystem will be automatically checked every 29 mounts or 180 days, whichever comes first. Use tune2fs -c or -i to override. # mount /dev/disk/byname/1NEC_iStorage_2000_00000009279003580010A /mnt/workdir # mount /dev/sda3 on / type reiserfs (rw,acl,user_xattr) proc on /proc type proc (rw) sysfs on /sys type sysfs (rw) /dev/dm-3 on /mnt/workdir type ext2 (rw)
15
brw-rw---- 1 root disk 253, 3 Aug 1 11:46 1NEC_iStorage_2000_0000009279003580010A crw------1 root root 10, 63 Aug 1 18:22 control
# mke2fs /dev/mapper/1NEC_iStorage_2000_0000009279003580010A mke2fs 1.35 (28-Feb-2004) Filesystem label= OS type: Linux Block size=4096 (log=2) Fragment size=4096 (log=2) 2621440 inodes, 5242880 blocks 262144 blocks (5.00%) reserved for the super user First data block=0 Maximum filesystem blocks=4294967296 160 block groups 32768 blocks per group, 32768 fragments per group 16384 inodes per group Superblock backups stored on blocks: 32768, 98304, 163840, 229376, 294912, 819200, 884736, 1605632, 2654208, 4096000 Writing inode tables: done Writing superblocks and filesystem accounting information: done This filesystem will be automatically checked every 39 mounts or 180 days, whichever comes first. Use tune2fs -c or -i to override. # mount /dev/mapper/1NEC_iStorage_2000_0000009279003580010A /mnt/workdir # mount | grep workdir
16
3.6
For RHEL4/5:
# types = [ "fd", 16 ] types = [ "device-mapper", 16 ]
This will allow LVM2 to scan only the /dev/disk/by-name paths with SLES9 or /dev/mapper with RHEL4 and reject everything else. (If you are using LVM2 on non-MPIO devices too, of course you will need to make the necessary adjustments to suit your setup). Then, you can use pvcreate and the other LVM2 commands as usual on the /dev/disk/by-name/ path with SLES9 or /dev/mapper/ path with RHEL4. Warning: Using LVM2, our recommendation is to create Physical Volumes (PVs) on a full disk (and not on a disk partition). If the lun has been previously used with parted (ex filesystem), it must be fully erased before issuing pvcreate, with this command: For SLES9:
clean_parts /dev/disk/by-name/lun-name
For RHEL4/5:
clean_parts /dev/mapper/lun-name
17
Volume group "vg001" successfully created # pvdisplay --- Physical volume --PV Name /dev/dm-2 VG Name vg001 PV Size 8.33 GB / not usable 0 Allocatable yes PE Size (KByte) 4096 Total PE 2133 Free PE 2133 Allocated PE 0 PV UUID 7m0tyb-k27W-ppxA-upjw-EAUn-PULX-lyiMi0
# lvcreate -L 2G vg001
Logical volume "lvol0" created # mke2fs /dev/vg001/lvol0 mke2fs 1.36 (05-Feb-2005) Filesystem label= OS type: Linux Block size=4096 (log=2) Fragment size=4096 (log=2) 262144 inodes, 524288 blocks 26214 blocks (5.00%) reserved for the super user First data block=0 16 block groups 32768 blocks per group, 32768 fragments per group 16384 inodes per group Superblock backups stored on blocks: 32768, 98304, 163840, 229376, 294912 Writing inode tables: done Writing superblocks and filesystem accounting information: done This filesystem will be automatically checked every 39 mounts or 180 days, whichever comes first. Use tune2fs -c or -i to override.
18
# mount /dev/vg001/lvol0 /mnt/workdir # mount /dev/sda3 on / type reiserfs (rw,acl,user_xattr) /dev/mapper/vg001-lvol0 on /mnt/workdir type ext2 (rw)
Volume group "vg3" successfully created # pvdisplay /dev/mapper/1NEC_iStorage_2000_00000009279003580010A --- Physical volume --PV Name /dev/dm-2 VG Name vg3 PV Size 20.00 GB / not usable 0 Allocatable yes PE Size (KByte) 4096 Total PE 5119 Free PE 5119 Allocated PE 0 PV UUID WuXHVw-Yufj-O1UY-kvVx-tAM5-xkoU-nKdi4N # lvcreate -L 2G vg3
Logical volume "lvol0" created # mkfs /dev/vg3/lvol0 mke2f1.35 (28-Feb-2004) Fesystem label= OSype: Linux Bck size=4096 (log=2) Fagmet size=4096 (log=2) 262144nodes, 524288 blocks 26214bocks (5.00%) reserved for the super user Frt data block=0 Mamum filesystem blocks=536870912 16bock groups 32768bocks per group, 32768 fragments per group 16384nodes per group Sperbock backups stored on blocks:
19
32768, 98304, 163840, 229376, 294912 Wting inode tables: done Wting superblocks and filesystem accounting information: done Th filesystem will be automatically checked every 38 mounts or 180day, whichever comes first. Use tune2fs -c or -i to override. # mount /dev/vg3/lvol0 /mnt/workdir # mount | grep workdir
3.7
20
3.8
Boot Support
Currently, the Multipathing feature is not available neither for the root nor for the boot partition with SLES9. How to add boot support with RHEL4/RHEL5 The boot support is available only with RHEL4 up4/up5, RHEL5 up1 and with /root filesystem and swap on LVs and /boot on a partition (fat with IA64 or ext3 with IA32 and EM64T). The installation phase must be done with only one path connected. The second path will be connected when the installation is complete. Then: Mount the StoreWay Multipath for Linux CD-ROM Run the script setup.sh and reply to the questions. Shutdown. Connect the second path. Reboot. At this step, the boot partition is not mounted. The access path to this boot partition needs to be determined and updated in the /etc/fstab file. Example with Storeway FDA2300 on IA64:
[root@tigre3 ~]# bsan
#Copyright (C) by BULL 2003,2006 #cmd: 0.1.2 #lib: 2.1.3 all rights reserved. # ============== ADP info ====================== eth0 == ??? == FW:? V:? == IP@:172.16.101.57 = MAC:00:0e:0c:08:c1:22 eth1 == ??? == FW:? V:? == MAC:00:0e:0c:08:c1:23 eth2 == ??? == FW:? V:? == MAC:00:0e:0c:72:53:08 lo == XER == FW:? V:? == MAC:00:00:00:00:00:00 sit0 == XER == FW:? V:? == MAC:00:00:00:00 host0 == scsi0 FW:? V:? == host1 == scsi1 FW:? V:? == ses0 OK == sg0 , raw? == ESG-SHV SCA HSBP M24 6,0 host2 == scsi2 EMU == FW:1.80A2 (T2D1.80A2) V:8.0.16.27 == DID:030000 = 20000000c938c7e1:10000000c938c7e1 tgt2.0 == NEC CORPORATION == 2300 == WWN:200000004c7f0445:210000004c7f0445 DID:0119ef sda OK == sg1 , raw? == NEC iStorage 2000 19900 8,0 0,0 30 R5 sdb OK == sg2 , raw? == NEC iStorage 2000 19900 8,16 0,1 30 R5 host3 == scsi3 EMU == FW:3.93A0 (C2D3.93A0) V:8.0.16.27 == DID:030100 = 20000000c9272023:10000000c9272023 tgt3.0 == XYRATEX == WWN:20000050cc2000b8:24000050cc2000b8 = DID:030d00 ses1 OK == sg3 , raw? == XYRATEX F5402E 0,0 ses2 OK == sg4 , raw? == XYRATEX F5402E 0,2 tgt3.1 == NEC CORPORATION == 2300 == WWN:200000004c7f0445:230000004c7f0445 DID:011ce8 sdc OK == sg5 , raw? == NEC iStorage 2000 19900 8,32 1,0 30 R5 sdd OK == sg6 , raw? == NEC iStorage 2000 19900 8,48 1,1 30 R5 ============== MPIO info ====================== dm-1 == 1NEC_____iStorage_2000___00000009279003580008F pgrp 0 == 2 paths == active /dev/sdb == active Ready == failcount 0 /dev/sdd == active Ready == failcount 0 dm-0 == 1NEC_____iStorage_2000___00000009279003580008E pgrp 0 == 2 paths == active
= 008E 008F
= 008E 008F
= 1 pg/2 paths lb
= 1 pg/2 paths lb
21
== failcount 0 == failcount 0
LVM info ======================= == 19.31 GB = resizable == sdc sda (dm-6) == 5.88 GB = linear = available (dm-7) == 3.91 GB = linear = available (dm-8) == 1.97 GB = linear = available
total 0 brw-rw---brw-rw---brw-rw---brw-rw---brw-rw---brw-rw---crw------brw-rw---brw-rw---brw-rw---1 root disk 253, 1 root disk 253, 1 root disk 253, 1 root disk 253, 1 root disk 253, 1 root disk 253, 1 root root 1 root disk 253, 1 root disk 253, 1 root disk 253, 0 Oct 10 4 Oct 10 5 Oct 10 1 Oct 10 2 Oct 10 3 Oct 10 8 Oct 10 6 Oct 10 7 Oct 10 2006 1NEC_____iStorage_2000___00000009279003580008E 2006 1NEC_____iStorage_2000___00000009279003580008E1 2006 1NEC_____iStorage_2000___00000009279003580008E2 2006 1NEC_____iStorage_2000___00000009279003580008F 2006 1NEC_____iStorage_2000___00000009279003580008F1 2006 1NEC_____iStorage_2000___00000009279003580008F2 2006 control 2006 VolGroup00-LogVol00 2006 VolGroup00-LogVol01 2006 VolGroup00-LogVol02
10, 63 Oct 10
And you can see that the first sda partition is:
1NEC_____iStorage_2000___00000009279003580008E1,
Then issue the mount /boot/efi command (/boot on IA32 or EM64T machine). To verify, enter:
[root@tigre3 hg]# df Filesystem 1K-blocks Used Available Use% Mounted on /dev/mapper/VolGroup00-LogVol01 6063688 1917012 3838660 34% / none 2034912 0 2034912 0% /dev/shm /dev/mapper/VolGroup00-LogVol02 4031680 78712 3748168 3% /home /dev/mapper/1NEC_____iStorage_2000___00000009279003580008E1 104170 11984 92186 12% /boot/efi [root@tigre3 hg]# swapon -as
Filename /dev/mapper/VolGroup00-LogVol00
Type partition
Size
Used
Priority -1
2064352 0
22
3.9
The same command may be used with "-r" option to remove LUNs in the configuration. This command must also be used very carefully, as there is a risk to corrupt the system disk ("/" directory) when it is used with inadequate parameters. So, it is advised to reboot the system to remove LUNs from your configuration. With the RedHat distribution, issue the following command on the adapter X:
echo - - - > /sys/class/scsi_host/hostX/scan
23
3.10
3.10.1
Automatic Checks
After the first boot (after the Multipath installation) StoreWay Multipath checks automatically the paths and if the path number on a device is equal to one, a message is logged as in the example in section 4.2 . After the next reboots StoreWay Multipath checks automatically the paths and if the path number on a device is lesser than the first boot, a message is logged as in the example in section 4.3. The storeway_mpio_check repair command brings back the paths of the multipathing system after the physical path(s) reparation.
3.10.2
3.10.3
24
3.11
Wiring Subsystems
FRA1622 subsystem direct attach:
Note
The hub mode must be set on the subsystem. FRA1622 subsystem SAN attach:
Note
25
26
27
28
Chapter 4. Messages
4.1 FC Multipathing errlog
Here is an example of failover/failback messages in /var/log/messages file: Dec 5 11:10:59 tigre3 kernel: lpfc 0000:06:01.0: 0:0203 Nodev timeout on NPort x119ef Data: x2010808 x7 x6 Dec 5 11:10:59 tigre3 multipathd: devmap event (2) on 1NEC_iStorage_2000_000000092790035800109 Dec 5 11:10:59 tigre3 multipathd: 8:48: mark as failed Dec 5 11:10:59 tigre3 kernel: SCSI error : <2 0 1 0> return code = 0x10000 Dec 5 11:10:59 tigre3 kernel: end_request: I/O error, dev sdd, sector 2922240 Dec 5 11:10:59 tigre3 kernel: device-mapper: dm-multipath: 8:48 (#2922272): IO error - error: -5 - bi_rw: 8 - bi_flags: 18 - bi_error: 01000005 Dec 5 11:10:59 tigre3 kernel: device-mapper: dm-multipath: Failing path 8:48 Dec 5 11:10:59 tigre3 kernel: device-mapper: dm-multipath: 8:48 (#2922240): Requeued sector as #1 Dec 5 11:10:59 tigre3 kernel: end_request: I/O error, dev sdd, sector 2922272 Dec 5 11:10:59 tigre3 kernel: device-mapper: dm-multipath: 8:48 (#2922304): IO error - error: -5 - bi_rw: 8 - bi_flags: 18 - bi_error: 01000005 Dec 5 11:10:59 tigre3 kernel: device-mapper: dm-multipath: 8:48 (#2922272): Requeued sector as #2 Dec 5 11:10:59 tigre3 kernel: device-mapper: dm-multipath: 8:48 (#2922336): IO error - error: -5 - bi_rw: 8 - bi_flags: 18 - bi_error: 01000005 Dec 5 11:10:59 tigre3 kernel: device-mapper: dm-multipath: 8:48 (#2922304): Requeued sector as #3 Dec 5 11:10:59 tigre3 kernel: device-mapper: dm-multipath: 8:48 (#2922368): IO error - error: -5 - bi_rw: 8 - bi_flags: 18 - bi_error: 01000005 Dec 5 11:11:05 tigre3 multipathd: 8:48: readsector0 checker reports path is up Dec 5 11:11:05 tigre3 kernel: SCSI error : <2 0 1 0> return code = 0x10000 Dec 5 11:11:05 tigre3 multipathd: 8:48: reinstated Dec 5 11:11:05 tigre3 multipathd: devmap event (3) on1NEC_iStorage_2000_000000092790035800109
4.2
Trace example after the first reboot with only a path available
Jun 1 10:15:54 yack23 StoreWay: Init paths file ... Jun 1 10:16:09 yack23 StoreWay: Init multipath with not enough path with 360060160192712008f5027c1f8cbdb11 Jun 1 10:16:09 yack23 StoreWay: Init multipath with not enough path with 360060160192712008e5027c1f8cbdb11 Jun 1 10:16:09 yack23 rc: Starting storeway_mpio: succeeded
4.3
29
4.4
30
The adapter/Interface lines display: Host Ven FW Ver DID host name Vendor (3 ASCII characters) Firmware version Driver version switchDomain, portId, loopId (with brocade device)
OK => device ready NOK => device not ready *OK => device ready and registered
!OK => device ready and reserved Parent Ven Type MB dev sid lun Qd Ty Port DEV scsi name of the device Vendor (3 ASCII characters) Device type returned by Inquiry Capacity in M bytes major, minor device Target Id (Decimal) Lun (from 0 to 31) retrieve the actual Queue Depth (HDS, SYMM, DGC, STK) Device Type (R5,Rs,R1,R0,R6+, i, B for BCV) Subsystem attachment Port name Device number inside the subsystem (EMC) Symmetrix DEV Id
31
Ven MB dev
Identify the device partition name (ex: sda1) Partition state Ex: BSY => busy Ex: IDL => idle Partition type (primary, extended, logical) Capacity in M bytes major, minor device
The filesystem lines display: Fs Label Type BSF ISF Filesystem identiticator (ex: fs0) Filesystem label Filesystem type (ext3, xfs etc...) Block space free (%) Inode space free (%)
The DM part displays device-mapper mirror and device-mapper multipath information: The device-mapper mirror lines display: Device alias log sync Identify the Linux device-mapper name (dm-#) Identify the persistante name (link) to the dm-# Log type {core or disk} Sync type {sync or nosync}
The next lines describe the mirror components The device-mapper multipath lines display: Device Alias Pg Path Type Identify the Linux device-mapper name (dm-#) Identify the persistant name (link) to the dm-# Priority group number Path number multipath type (fo=failover, lb=loadbalancing)
The priority group lines display: pgrp# path stat Identify Priority group number Path number per Priority group Priority group status
The Path description lines display: Device Status tur fail Identify the path name (tgt:/dev/sdx) path status test unit ready result fail counter
32
The LVM part displays Logical Volume Group information: The volume group lines display:
VG Size Status Deps Identify the volume group name volume group size volume group status volume group dependence
The filesystem lines display: Fs Label Type BSF ISF Filesystem identiticator (ex: fs0) Filesystem label Filesystem type (ext3, xfs etc...) Block space free (%) Inode space free (%)
Example1: FC SAN
#Copyright (C) by BULL 2003,2006 #cmd: 0.1.2 #lib: 2.1.3 all rights reserved. # ============== ADP info ====================== eth0 == NEC == FW:? V:? == IP@:172.16.101.56 = MAC:00:00:4c:71:3f:10 eth1 == Int == FW:? V:? == IP@:192.168.1.56 = MAC:00:03:47:e0:79:b8 eth2 == ZNY == FW:? V:? == IP@:192.168.2.56 = MAC:00:c0:95:f8:8c:14 lo == XER == FW:? V:? == MAC:00:00:00:00:00:00 sit0 == XER == FW:? V:? == MAC:00:00:00:00 host0 == scsi0 ADP == FW:? V:6.2.36 == host1 == scsi1 ADP == FW:? V:6.2.36 == st0 OK == sg0 , raw? == TANDBERG TDC 4222 Bull 5,0 host2 == scsi2 EMU == FW:1.90A3 (E2M1.90A3) V:8.0.16.17 == DID:30600 = 20000000c93fcdef:0x10000000c93fcdef tgt2.0 == NETWORK APPLIANCE CORP. == FAS3020 == WWN:500a09808617b917:500a09818617b917 = DID:030400 sda OK == sg1 , raw? == NETAPP LUN 10240 8,0 0,0 30 sdb OK == sg2 , raw? == NETAPP LUN 10240 8,16 0,1 30 tgt2.1 == XYRATEX == Optima1200 == WWN:20000050cc2000b8:23000050cc2000b8 = DID:030c00 sdc OK == sg3 , raw? == XYRATEX F5402E 9540 8,32 1,0 30 R? 2 sdd OK == sg4 , raw? == XYRATEX F5402E 9540 8,48 1,1 30 R? 3 ses0 OK == sg5 , raw? == XYRATEX F5402E 1,2 tgt2.2 == EMC CORPORATION == Symm7 == WWN:50060482d52cda47:50060482d52cda47 = DID:000000 sde OK == sg6 , raw? == EMC SYMMETRIX 8631 8,64 2,0 30 QT 0080 sdf OK == sg7 , raw? == EMC SYMMETRIX 8631 8,80 2,1 30 QT 0081 sdg OK == sg8 , raw? == EMC SYMMETRIX 8631 8,96 2,2 30 QT 0082 sdh OK == sg9 , raw? == EMC SYMMETRIX 8631 8,112 2,3 30 QT 0083 sdi OK == sg10 , raw? == EMC SYMMETRIX 8631 8,128 2,4 30 QT 0084 sdj OK == sg11 , raw? == EMC SYMMETRIX 8631 8,144 2,5 30 QT 0085 sdk OK == sg12 , raw? == EMC SYMMETRIX 8631 8,160 2,6 30 QT 0086 sdl OK == sg13 , raw? == EMC SYMMETRIX 8631 8,176 2,7 30 QT 0087 sdm OK == sg14 , raw? == EMC SYMMETRIX 8631 8,192 2,8 30 QT 0088 sdn OK == sg15 , raw? == EMC SYMMETRIX 8631 8,208 2,9 30 QT 0089 tgt2.3 == NEC CORPORATION == 2300 == WWN:200000004c7f0445:210000004c7f0445 = DID:0019ef sdo OK == sg16 , raw? == NEC iStorage 2000 8533 8,224 3,0 30 R1 0109 sdp OK == sg17 , raw? == NEC iStorage 2000 8533 8,240 3,1 30 R1 010A
33
host3 == scsi3 EMU == FW:1.00A4 (H2D1.00A4) V:8.0.16.17 == DID:30700 = 20000000c93393dc:0x10000000c93393dc tgt3.0 == NETWORK APPLIANCE CORP. == FAS3020 == WWN:500a09808617b917:500a098a8617b917 = DID:030900 sdq OK == sg18 , raw? == NETAPP LUN 10240 65,0 0,0 30 sdr OK == sg19 , raw? == NETAPP LUN 10240 65,16 0,1 30 tgt3.1 == XYRATEX == Optima1200 == WWN:20000050cc2000b8:22000050cc2000b8 = DID:030d00 sds OK == sg20 , raw? == XYRATEX F5402E 9540 65,32 1,0 30 R? 2 sdt OK == sg21 , raw? == XYRATEX F5402E 9540 65,48 1,1 30 R? 3 ses1 OK == sg22 , raw? == XYRATEX F5402E 1,2 tgt3.2 == EMC CORPORATION == Symm7 == WWN:50060482d52cda49:50060482d52cda49 = DID:000400 sdu OK == sg23 , raw? == EMC SYMMETRIX 8631 65,64 2,0 30 QT 0080 sdv OK == sg24 , raw? == EMC SYMMETRIX 8631 65,80 2,1 30 QT 0081 sdw OK == sg25 , raw? == EMC SYMMETRIX 8631 65,96 2,2 30 QT 0082 sdx OK == sg26 , raw? == EMC SYMMETRIX 8631 65,112 2,3 30 QT 0083 sdy OK == sg27 , raw? == EMC SYMMETRIX 8631 65,128 2,4 30 QT 0084 sdz OK == sg28 , raw? == EMC SYMMETRIX 8631 65,144 2,5 30 QT 0085 sdaa OK == sg29 , raw? == EMC SYMMETRIX 8631 65,160 2,6 30 QT 0086 sdab OK == sg30 , raw? == EMC SYMMETRIX 8631 65,176 2,7 30 QT 0087 sdac OK == sg31 , raw? == EMC SYMMETRIX 8631 65,192 2,8 30 QT 0088 sdad OK == sg32 , raw? == EMC SYMMETRIX 8631 65,208 2,9 30 QT 0089 tgt3.3 == NEC CORPORATION == 2300 == WWN:200000004c7f0445:230000004c7f0445 = DID:001ce8 sdae OK == sg33 , raw? == NEC iStorage 2000 8533 65,224 3,0 30 R1 0109 sdaf OK == sg34 , raw? == NEC iStorage 2000 8533 65,240 3,1 30 R1 010A host4 == scsi4 FW:3.00.00.04 V:5.00.04 == iqn.2000-04.com.qlogic:qla4010.fs20517b00891 rdc0 == DAC == FW:4.07-0-29 V:2.5.47 == c0d0 OK == raw? == Disk RAID-5 48,0 c0d1 OK == raw? == Disk RAID-7 48,8 ============== MPIO info ====================== dm-3 == SEMC_____SYMMETRIX______100329089000 = 1 pg/2 pgrp 0 == 2 paths == active /dev/sdad == active Ready == failcount 2 /dev/sdn == active Ready == failcount 3 dm-9 == 320030050cc2000b8 = 2 pg/2 pgrp 0 == 1 paths == enabled /dev/sdd == active Ready == failcount 2 pgrp 1 == 1 paths == active /dev/sdt == active Ready == failcount 0 dm-10 == SEMC_____SYMMETRIX______100329080000 = 1 pg/2 pgrp 0 == 2 paths == active /dev/sde == active Ready == failcount 3 /dev/sdu == active Ready == failcount 2 dm-14 == SEMC_____SYMMETRIX______100329084000 = 1 pg/2 pgrp 0 == 2 paths == active /dev/sdi == active Ready == failcount 3 /dev/sdy == active Ready == failcount 2 dm-7 == 360a9800043346234525a356f61395478 = 2 pg/2 pgrp 0 == 1 paths == active /dev/sdb == active Ready == failcount 5 == main ok pgrp 1 == 1 paths == enabled /dev/sdr == active Ready == failcount 4 == backup ok dm-2 == SEMC_____SYMMETRIX______100329088000 = 1 pg/2 pgrp 0 == 2 paths == active /dev/sdac == active Ready == failcount 2 /dev/sdm == active Ready == failcount 3 dm-4 == 1NEC_____iStorage_2000___000000092790035800109 = 1 pg/2 pgrp 0 == 2 paths == active /dev/sdae == active Ready == failcount 2 /dev/sdo == active Ready == failcount 2 dm-13 == SEMC_____SYMMETRIX______100329083000 = 1 pg/2 pgrp 0 == 2 paths == active /dev/sdh == active Ready == failcount 4 /dev/sdx == active Ready == failcount 3 dm-8 == 320020050cc2000b8 = 2 pg/2 pgrp 0 == 1 paths == enabled /dev/sdc == active Ready == failcount 2 pgrp 1 == 1 paths == active /dev/sds == active Ready == failcount 0 dm-1 == SEMC_____SYMMETRIX______100329087000 = 1 pg/2 pgrp 0 == 2 paths == active /dev/sdab == active Ready == failcount 2 /dev/sdl == active Ready == failcount 3 dm-6 == 360a9800043346234525a356f47566d33 = 2 pg/2 pgrp 0 == 1 paths == active /dev/sda == active Ready == failcount 5 == main ok pgrp 1 == 1 paths == enabled /dev/sdq == active Ready == failcount 4 == backup ok paths lb
paths fo
paths lb
paths lb
paths fo
paths lb
paths lb
paths lb
paths fo
paths lb
paths fo
34
dm-12 == SEMC_____SYMMETRIX______100329082000 pgrp 0 == 2 paths == active /dev/sdg == active Ready == failcount 3 /dev/sdw == active Ready == failcount 2 dm-5 == 1NEC_____iStorage_2000___00000009279003580010A pgrp 0 == 2 paths == active /dev/sdaf == active Ready == failcount 2 /dev/sdp == active Ready == failcount 2 dm-0 == SEMC_____SYMMETRIX______100329086000 pgrp 0 == 2 paths == active /dev/sdaa == active Ready == failcount 2 /dev/sdk == active Ready == failcount 3 dm-11 == SEMC_____SYMMETRIX______100329081000 pgrp 0 == 2 paths == active /dev/sdf == active Ready == failcount 3 /dev/sdv == active Ready == failcount 2 dm-15 == SEMC_____SYMMETRIX______100329085000 pgrp 0 == 2 paths == active /dev/sdj == active Ready == failcount 3 /dev/sdz == active Ready == failcount 2
= 1 pg/2 paths lb
= 1 pg/2 paths lb
= 1 pg/2 paths lb
= 1 pg/2 paths lb
= 1 pg/2 paths lb
============== LVM info ====================== VG1 == 16.66 GB = resizable == sdo sdae sdp sdaf lvol0 (dm-16) == 3.00 GB = linear = available = dm-4
35
36
Chapter 6. References
Multipathing online documentation: http://christophe.varoqui.free.fr/multipath.html http://sources.redhat.com/dm For RHEL6: http://docs.redhat.com/docs/enUS/Red_Hat_Enterprise_Linux/6/html/DM_Multipath/index.html
37
38
39
active - Path group currently receiving I/O requests. enabled - Path groups to try if the active path group has no paths in the ready state. disabled - Path groups to try if the active path group and all enabled path groups have no paths in the active state. NOTE: The disabled state only exists for certain storage arrays.
Path Priority: Each path can have a priority assigned to it by a callout program. Path priorities can be used to group paths by priority and change their relative weights for the round robin path selector. Path States: ready - Path is able to handle I/O requests. shaky - Path is up, but temporarily not available for normal operations. faulty - Path is unable to handle I/O requests. ghost - Path is a passive path, on an active/passive controller. NOTE: The shaky and ghost states only exist for certain storage arrays. WWID: The WWID (World Wide Identifier) is an identifier for the Multipath device that is guaranteed to be globally unique and unchanging. It is determined by the getuid callout program.
40
BULL CEDOC 357 AVENUE PATTON B.P.20845 49008 ANGERS CEDEX 01 FRANCE
REFERENCE
86 A2 93ER 11