Created setup-kaminario-mpath.sh

New script for setting up multipath on Kaminario all flash arrays

Author: flashdba

setup-kaminario-mpath.sh

@@ -0,0 +1,150 @@
+#!/bin/bash
+# setup-kaminario-mpath.sh - script for configuring the multipath.conf file with Kaminario devices
+# Author: flashdba (http://flashdba.com)
+# The output can be cut and pasted into the "multipaths {}" section of /etc/multipath.conf
+# Alternatively the -l option can be used to print a list of devices
+#
+# For educational purposes only - no warranty is provided
+# Test thoroughly - use at your own risk
+
+# TODO: Currently only written for use with Red Hat 6 / Oracle Linux 6 / SLES 11
+
+# Setup variables and arrays
+VERBOSE=0
+LISTMODE=0
+MULTIPATH_DEVICES=()
+
+# Setup print functions
+echoerr() { echo "Error: $@" 1>&2; }
+echovrb() { [[ "$VERBOSE" = 1 ]] && echo "Info : ${@}" 1>&2; }
+echoout() { echo "$@"; }
+echolst() { echo "$@" | tr '±' '\t' | expand -t 5 1>&2; }
+
+# Function for printing usage information
+usage() {
+	echo "" 1>&2
+	if [ "$#" -gt 0 ]; then
+		echo "Error: $@" 1>&2
+		echo "" 1>&2
+	fi
+	echo "Usage: $0 [-v ]" 1>&2
+	echo "" 1>&2
+	echo "  Script for configuring the /etc/multipath.conf file" 1>&2
+	echo "  Creates entries for the \"multipath \{\}\" section" 1>&2
+	echo "  Requires the sg3_utils package to be present" 1>&2
+	echo "  Errors and info are printed to stderr" 1>&2
+	echo "" 1>&2
+	echo "  Options:" 1>&2
+	echo "    -h   Help     (print help and version information)" 1>&2
+	echo "    -l   List     (print a list of devices and their details)" 1>&2
+	echo "    -v   Verbose  (show processing details)" 1>&2
+	echo "" 1>&2
+	exit 1
+}
+
+while getopts ":hvl" opt; do
+	case $opt in
+		h)
+			usage
+			;;
+		v)
+			VERBOSE=1
+			echovrb "Running in verbose mode"
+			;;
+		l)
+			LISTMODE=1
+			echovrb "Running in list mode"
+			;;
+		\?)
+			echo "Invalid option: -$OPTARG" >&2
+			usage
+			;;
+	esac
+done
+
+# Check that the s3_utils package has been installed and is in the path
+if hash sg_inq 2> /dev/null; then
+	echovrb "Using sg_inq `sg_inq -V 2>&1`"
+else
+	echoerr "sg3_utils package not installed - exiting..."
+	exit 1
+fi
+
+# Build a list of multipath devices to scan
+MULTIPATH_FILELIST=$( ls -1 /dev/dm-* )
+
+# Iterate through the list
+for MPDEVICE in $MULTIPATH_FILELIST; do
+
+	echovrb "Issuing inquiry to device $MPDEVICE"
+
+	# Issue sg3 inquiry to device
+	SG3_OUTPUT=`sg_inq -i $MPDEVICE 2> /dev/null`
+	SG3_RETVAL=$?
+
+	# If inquiry returned error code then skip
+	if [ "$SG3_RETVAL" -ne 0 ]; then
+		echovrb "Skipping device $MPDEVICE"
+		continue
+	fi
+
+	# Scan output to find vendor id
+	SG3_VENDORID=`echo "$SG3_OUTPUT" | grep "vendor id:" | cut -d':' -f2- | sed 's/^ *//g' | sed 's/ *$//g' ` 2> /dev/null
+
+	# Check the vendor is KMNRIO otherwise skip
+	if [ "$SG3_VENDORID" != "KMNRIO" ]; then
+		echovrb "Ignoring device on $MPDEVICE with vendor id = $SG3_VENDORID"
+		continue
+	fi
+
+	# Get the sysfs device location (required for udevinfo)
+	MPATH_DEVBASE=`basename $MPDEVICE`
+	MPATH_SYSFS="/block/$MPATH_DEVBASE"
+
+	# Process device specific details
+	LUN_NAME=`echo "$SG3_OUTPUT" | grep "vendor specific:" | awk '{print ($3)}'`
+	LUN_UUID=`udevadm info --query=property --path=$MPATH_SYSFS 2> /dev/null | grep "DM_UUID=" | sed 's/^DM_UUID=mpath-*//g'`
+	echovrb "Found Kaminario device on $MPDEVICE: LUN Name = $LUN_NAME UUID = $LUN_UUID"
+
+	# Add details to an array variable of Kaminario devices
+	MULTIPATH_DEVICES+=(`echo "$LUN_NAME:$LUN_UUID:$MPDEVICE"`)
+done
+
+# Sort the array into alphabetical order based on LUN name
+echovrb "Sorting discovered devices into alphabetical order..."
+MULTIPATH_DEVICES=($(for MPDEVICE in ${MULTIPATH_DEVICES[@]}; do
+	echo $MPDEVICE
+done | sort))
+echovrb "Sort complete"
+
+if [ "$LISTMODE" = 1 ]; then
+	echolst "Device Name±LUN Name±WWID"
+	echolst "-----------±--------±----------------------------------"
+else
+	if [ -r /etc/multipath.conf ]; then
+		echovrb "Backup up /etc/multipath.conf to /tmp"
+		cp /etc/multipath.conf /tmp
+	fi
+fi
+	
+echovrb "Printing multipath.conf configuration details..."
+echovrb ""
+
+# Now print the multipath.conf output for each device, converting the LUN name to lowercase
+for MPDEVICE in ${MULTIPATH_DEVICES[@]}; do
+	MP_WWID=`echo $MPDEVICE | cut -d':' -f2`
+	MP_ALIAS=`echo $MPDEVICE | cut -d':' -f1 | tr '[:upper:]' '[:lower:]'`
+	MP_DEVNAME=`echo $MPDEVICE | cut -d':' -f3`
+
+	if [ "$LISTMODE" = 1 ]; then
+		echolst "$MP_DEVNAME  ±$MP_ALIAS±$MP_WWID"
+	else
+		echoout "    multipath {"
+		echoout "        wwid $MP_WWID"
+		echoout "        alias $MP_ALIAS"
+		echoout "    }"
+	fi
+done
+
+echovrb "Successful completion"
+exit 0