Dell PowerVault MD3260 Administrator's Guide - Page 125

Important Information About Special Partitions, Limitations And Known Issues

Page 125 highlights

1. Unmount all Device Mapper multipath device nodes mounted on the server: # umount 2. Stop the Device Mapper multipath service: # /etc/init.d/multipathd stop 3. Flush the Device Mapper multipath maps list to remove any old or modified mappings: # multipath -F NOTE: The boot operating system drive may have an entry with the Device Mapper multipathing table. This is not affected by the multipath -F command. 4. Log out of all iSCSI sessions from the host server to the storage array: # iscsiadm -m node --logout Important Information About Special Partitions When using Device Mapper with the MD Series Dense storage arrays, all physical disks are assigned a disk device node. This includes a special device type used for in-band management of the storage arrays, known as the Access Disk or Universal Xport device. CAUTION: Certain commands, such as lsscsi, display one or more instances of Universal Xport devices. These device nodes must never be accessed, mounted, or used in any way. Doing so can cause loss of communication to the storage array and possibly cause serious damage to the storage array, potential making data stored on the array inaccessible. Only multipathing device nodes and partition nodes created using the directions provided above must be mounted or in any way accessed by the host system or its users. Table 6. Useful Device Mapper Commands Command Description multipath -h Prints usage information. multipath -ll multipath Displays the current multipath topology using all available information (sysfs, the device mapper, path checkers, and so on). Re-aggregates multipathing device with simplified output. multipath -f multipath -F Flushes out Device Mapper for the specified multipathing device. Used if the underlying physical devices are deleted/unmapped. Flushes out all unused multipathing device maps. rescan_dm_devs Dell provided script. Forces a rescan of the host SCSI bus and aggregates multipathing devices as needed. Use this command when: • LUNs are dynamically mapped to the hosts. • New targets are added to the host. • Failback of the storage array is required. • For MD Series Dense iSCSI storage arrays, iSCSI sessions have to be established for rescan to take effect. Limitations And Known Issues • In certain error conditions with the no_path_retry or the queue_if_no_path feature is set, applications may hang. To overcome these conditions, enter the following command for each affected multipath device: dmsetup message [device] 0 "fail_if_no_path" where [device] is the multipath device name (for example, mpath2; do not specify the path) 125

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175

1.
Unmount all Device Mapper multipath device nodes mounted on the server:
# umount
<mounted_multipath_device_node>
2.
Stop the Device Mapper multipath service:
# /etc/init.d/multipathd stop
3.
Flush the Device Mapper multipath maps list to remove any old or modified mappings:
# multipath –F
NOTE:
The boot operating system drive may have an entry with the Device Mapper multipathing table. This is
not affected by the
multipath –F
command.
4.
Log out of all iSCSI sessions from the host server to the storage array:
# iscsiadm –m node --logout
Important Information About Special Partitions
When using Device Mapper with the MD Series Dense storage arrays, all physical disks are assigned a disk device
node. This includes a special device type used for in-band management of the storage arrays, known as the Access Disk
or Universal Xport device.
CAUTION: Certain commands, such as
lsscsi
, display one or more instances of Universal Xport devices. These
device nodes must never be accessed, mounted, or used in any way. Doing so can cause loss of communication to
the storage array and possibly cause serious damage to the storage array, potential making data stored on the
array inaccessible.
Only multipathing device nodes and partition nodes created using the directions provided above must be mounted or in
any way accessed by the host system or its users.
Table 6. Useful Device Mapper Commands
Command
Description
multipath –h
Prints usage information.
multipath –ll
Displays the current multipath topology using all available information (sysfs, the
device mapper, path checkers, and so on).
multipath
Re-aggregates multipathing device with simplified output.
multipath –f
<multipath_dev_node>
Flushes out Device Mapper for the specified multipathing device. Used if the
underlying physical devices are deleted/unmapped.
multipath –F
Flushes out all unused multipathing device maps.
rescan_dm_devs
Dell provided script. Forces a rescan of the host SCSI bus and aggregates
multipathing devices as needed. Use this command when:
LUNs are dynamically mapped to the hosts.
New targets are added to the host.
Failback of the storage array is required.
For MD Series Dense iSCSI storage arrays, iSCSI sessions have to be
established for rescan to take effect.
Limitations And Known Issues
In certain error conditions with the
no_path_retry
or the
queue_if_no_path
feature is set,
applications may hang. To overcome these conditions, enter the following command for each affected multipath
device:
dmsetup message [device] 0 "fail_if_no_path"
where
[device]
is the multipath device name (for example, mpath2; do not specify the path)
125