[dm-devel] multipath.conf aliases

Thu Oct 28 18:22:53 UTC 2004

> -----Original Message-----
> From: dm-devel-bounces at redhat.com
> [mailto:dm-devel-bounces at redhat.com] On Behalf Of Virgilio, Vincent
> Sent: Thursday, October 28, 2004 1:18 PM
> To: dm-devel at redhat.com
> Subject: [dm-devel] multipath.conf aliases
>
>
>
> Hello,
>
> I have just successfully configured most of Multipath on my system,
> which is:
>
> Fedora Core 3 Test 3
> kernel 2.6.10-rc1, with latest udm patches (not kgdb)
> multipath v0.3.5
>
> This CPU hosts a Qlogic 2200, which is attached to a Brocade Silkworm
> 2400 via one fiber.  There is one target storage enclosure attached to
> the same Brocade via two controllers/fibers.  The storage enclosure
> advertises the same 3 LUNs through each of those controllers.
>
> Thus there are two paths from the CPU to each LUN.  This is
> reflected in
> the output from /sbin/multipath -v 2 below.
>
> Now, I'd like to alias the LUN devices to something like /dev/lun0,
> /dev/lun1, and /dev/lun2.  Currently I only have default device mapper
> devices (/dev/dm-*, 5 of them, which I don't understand yet).
>
> I tried to do this aliasing in /etc/multipath.conf, included
> below.
> ...

My apologies, I included the wrong multipath.conf.  Here is the right
one:

#
# name  : defaults
# desc  : multipath-tools default settings
#
defaults {
	#
	# name    : multipath_tool
	# scope   : multipathd
	# desc    : the tool in charge of configuring the multipath
device maps
	# default : "/sbin/multipath -v 0 -S"
	#
	multipath_tool	"/sbin/multipath -v 0 -S"

	#
	# name    : udev_dir
	# desc    : directory where udev creates its device nodes
	# default : /udev
	#
	udev_dir	/dev

	#
	# name    : polling_interval
	# scope   : multipathd
	# desc    : interval between two path checks in seconds
	# default : 5
	#
	polling_interval 10

	#
	# name    : default_selector
	# scope   : multipath
	# desc    : the default path selector algorithm to use
	#           these algorithms are offered by the kernel multipath
target
	# values  : round-robin
	# default : round-robin
	#
	default_selector	round-robin

	#
	# name    : default_selector_args
	# scope   : multipath
	# desc    : the default path selector number of args
	#           for the selected path selector algorithm
	# default : 0
	#
	default_selector_args	0

	#
	# name    : default_path_grouping_policy
	# scope   : multipath
	# desc    : the default path grouping policy to apply to
unspecified
	#           multipaths
	# default : multibus
	#
	default_path_grouping_policy	multibus

	#
	# name    : default_getuid_callout
	# scope   : multipath
	# desc    : the default program and args to callout to obtain a
unique
	#           path identifier. Absolute path required
	# default : /sbin/scsi_id -g -u -s
	#
	default_getuid_callout	"/sbin/scsi_id -g -u -s"

	#
	# name    : default_prio_callout
	# scope   : multipath
	# desc    : the default program and args to callout to obtain a
path
	#           priority value. The ALUA bits in SPC-3 provide an
	#           exploitable prio value for example
	# default : /bin/false
	#
	default_prio_callout	"/bin/false"
}

#
# name    : devnode_blacklist
# scope   : multipath & multipathd
# desc    : list of device names to discard as not multipath candidates
# default : cciss, fd, hd, md, dm, sr, scd, st, ram, raw, loop
#
devnode_blacklist {
	devnode cciss
	devnode fd
	devnode hd
	devnode md
	devnode dm
	devnode sr
	devnode scd
	devnode st
	devnode ram
	devnode raw
	devnode loop
}

#
# name    : multipaths
# scope   : multipath & multipathd
# desc    : list of multipaths finest-grained settings
#
multipaths {
	#
	# name  : multipath
	# scope : multipath & multipathd
	# desc  : container for settings that apply to one specific
multipath
	#
	multipath {
		#
		# name  : wwid
		# scope : multipath & multipathd
		# desc  : index of the container
		#
		wwid	20080e5000011b784

		#
		# name    : alias
		# scope   : multipath
		# desc    : symbolic name for the multipath
		#
		alias	lun0

		#
		# name    : path_grouping_policy
		# scope   : multipath
		# desc    : path grouping policy to apply to this
multipath
		# values  : failover, multibus, group_by_serial
		# default : failover
		#
		path_grouping_policy	multibus

		#
		# name    : path_checker
		# scope   : multipathd
		# desc    : path checking alorithm to use to check path
state
		# values  : readsector0, tur
		# default : readsector0
		#
		# path_checker		readsector0

		#
		# name    : path_selector
		# desc    : the path selector algorithm to use for this
mpath
		#           these algo are offered by the kernel mpath
target
		# values  : round-robin
		# default : round-robin
		#
		path_selector		round-robin

		#
		# name    : path_selector_args
		# desc    : the defined path selector number of args
		# default : 0
		#
		# path_selector_args	0
	}
	multipath {
		wwid	20080e5000111b784
		alias	lun1
	}
	multipath {
		wwid	20080e5000211b784
		alias	lun2
	}
}

#
# name  : devices
# scope : multipath & multipathd
# desc  : list of per storage controler settings
#	  overrides default settings (device_maps block)
#         overriden by per multipath settings (multipaths block)
#
devices {
	#
	# name  : device
	# scope : multipath & multipathd
	# desc  : settings for this specific storage controler
	#
	device {
		#
		# name  : vendor, product
		# scope : multipath & multipathd
		# desc  : index for the block
		#
		vendor			"MYLEX   "
		product			"DACARMRB        "

		#
		# name    : path_grouping_policy
		# scope   : multipath
		# desc    : path grouping policy to apply to multipath
hosted
		#           by this storage controler
		# values  : failover        = 1 path per priority group
		#           multibus        = all valid paths in 1
priority
		#                             group
		#           group_by_serial = 1 priority group per
detected
		#                             serial number
		# default : failover
		#
		path_grouping_policy	multibus

		#
		# name    : getuid_callout
		# scope   : multipath
		# desc    : the program and args to callout to obtain a
unique
		#           path identifier. Absolute path required
		# default : /sbin/scsi_id -g -u -s
		#
		getuid_callout          "/sbin/scsi_id -g -u -s"

		#
		# name    : path_checker
		# scope   : multipathd
		# desc    : path checking alorithm to use to check path
state
		# values  : readsector0, tur
		# default : readsector0
		#
		path_checker		readsector0

		#
		# name    : path_selector
		# desc    : the path selector algorithm to use for this
mpath
		#           these algo are offered by the kernel mpath
target
		# values  : round-robin
		# default : round-robin
		#
		path_selector		round-robin
	}
}

************************************
This e-mail and any files transmitted with it are proprietary and intended solely for the use of the individual or entity to whom they are addressed. If you have received this e-mail in error please notify the sender. Please note that any views or opinions presented in this e-mail are solely those of the author and do not necessarily represent those of ITT Industries, Inc. The recipient should check this e-mail and any attachments for the presence of viruses. ITT Industries accepts no liability for any damage caused by any virus transmitted by this e-mail.
************************************