Blame contrib/bmc-snmp-proxy

Packit d14fb6
#!/bin/sh
Packit d14fb6
#############################################################################
Packit d14fb6
#
Packit d14fb6
# bmc-snmp-proxy:	Set SNMP proxy to BMC (Baseboard Management Controller)
Packit d14fb6
#
Packit d14fb6
# version:	0.62
Packit d14fb6
#
Packit d14fb6
# Authors:	Charles Rose <charles_rose@dell.com>
Packit d14fb6
#		Jordan Hargrave <jordan_hargrave@dell.com>
Packit d14fb6
#
Packit d14fb6
# Description:  Script to set snmp proxy to the BMC for certain OID
Packit d14fb6
#		See here for details:
Packit d14fb6
#		https://fedoraproject.org/wiki/Features/AgentFreeManagement
Packit d14fb6
#
Packit d14fb6
# Assumptions:  This script will work only when /etc/snmp/ is writable.
Packit d14fb6
#
Packit d14fb6
#############################################################################
Packit d14fb6
# GLOBALS
Packit d14fb6
#############################################################################
Packit d14fb6
SYSCONF_DIR="/etc/sysconfig"
Packit d14fb6
CONFIG="${SYSCONF_DIR}/bmc-snmp-proxy"
Packit d14fb6
Packit d14fb6
SNMPD_BMC_CONF_DIR="/etc/snmp/bmc"
Packit d14fb6
SNMPD_BMC_CONF="${SNMPD_BMC_CONF_DIR}/snmpd.local.conf"
Packit d14fb6
TRAPD_BMC_CONF="${SNMPD_BMC_CONF_DIR}/snmptrapd.local.conf"
Packit d14fb6
Packit d14fb6
TRAPD_CONF="/etc/snmp/snmptrapd.conf"
Packit d14fb6
Packit d14fb6
LOCKFILE="/var/lock/subsys/bmc-snmp-proxy"
Packit d14fb6
BMC_INFO="/var/run/bmc-info"
Packit d14fb6
Packit d14fb6
IPMITOOL=`which ipmitool`
Packit d14fb6
Packit d14fb6
#Default config
Packit d14fb6
BMC_COMMUNITY="public"
Packit d14fb6
BMC_OID=".1.3.6.1.4.1.674.10892.2"  # Dell iDRAC
Packit d14fb6
TRAP_FORWARD="no"
Packit d14fb6
RELOAD_SERVICES="yes"
Packit d14fb6
Packit d14fb6
#############################################################################
Packit d14fb6
Packit d14fb6
#TODO: Use inotify and daemonize when $BMC_INFO changes
Packit d14fb6
Packit d14fb6
# source config
Packit d14fb6
[ -r ${CONFIG} ] && . ${CONFIG}
Packit d14fb6
Packit d14fb6
. gettext.sh
Packit d14fb6
Packit d14fb6
SCRIPT_NAME=$(basename $0)
Packit d14fb6
RETVAL=0
Packit d14fb6
Packit d14fb6
# Check if bmc-info created by exchange-bmc-os-info
Packit d14fb6
bmc_info_exists()
Packit d14fb6
{
Packit d14fb6
	if [ -r "${BMC_INFO}" ]; then
Packit d14fb6
		. ${BMC_INFO}
Packit d14fb6
	else
Packit d14fb6
		RETVAL=2
Packit d14fb6
	fi
Packit d14fb6
Packit d14fb6
	return $RETVAL
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
check_snmp()
Packit d14fb6
{
Packit d14fb6
	if [ ! -d /etc/snmp ] || [ ! -x /usr/sbin/snmpd ]; then
Packit d14fb6
		RETVAL=12
Packit d14fb6
	fi
Packit d14fb6
Packit d14fb6
	return $RETVAL
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
#############################################################################
Packit d14fb6
# configure SNMP proxy
Packit d14fb6
#############################################################################
Packit d14fb6
write_snmp_conf()
Packit d14fb6
{
Packit d14fb6
	# SNMPv3 security: bmcview, bmc_ctx, bmc_sec, bmc_grp, bmc_cmty
Packit d14fb6
	printf "###############################################\n"
Packit d14fb6
	printf "# Automatically created by %s #\n" "${SCRIPT_NAME}"
Packit d14fb6
	printf "###############################################\n"
Packit d14fb6
	printf "#view bmcview included %s 80\n" "${BMC_OID}"
Packit d14fb6
	printf "#com2sec -Cn bmc_ctx bmc_sec default bmc_cmty\n"
Packit d14fb6
	printf "#group bmc_grp v1 bmc_sec\n"
Packit d14fb6
	printf "#access bmc_grp bmc_ctx any noauth exact bmcview none none\n"
Packit d14fb6
	printf "#proxy -Cn bmc_ctx -v 1 %s\n" "${PROXY_TOKEN}"
Packit d14fb6
	printf "proxy -v 1 %s\n" "${PROXY_TOKEN}"
Packit d14fb6
	printf "###############################################\n"
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
valid_ip()
Packit d14fb6
{
Packit d14fb6
        #Thanks to mkyong.com
Packit d14fb6
        octet="([01]?[[:digit:]][[:digit:]]?|2[0-4][[:digit:]]|25[0-5])"
Packit d14fb6
Packit d14fb6
        printf -- "%s" "${1}"| grep -Eq \
Packit d14fb6
		"^${octet}\\.${octet}\\.${octet}\\.${octet}$"
Packit d14fb6
Packit d14fb6
        return $?
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
check_vars()
Packit d14fb6
{
Packit d14fb6
	[ -z ${BMC_COMMUNITY} ] && BMC_COMMUNITY="public"
Packit d14fb6
	[ -z ${BMC_OID} ] && return 1
Packit d14fb6
Packit d14fb6
	if [ -n "${BMC_IPv4}" ] && valid_ip ${BMC_IPv4}; then
Packit d14fb6
		return 0
Packit d14fb6
	else
Packit d14fb6
		return 1
Packit d14fb6
	fi
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
set_snmp_proxy()
Packit d14fb6
{
Packit d14fb6
	if check_vars; then
Packit d14fb6
		PROXY_TOKEN="-c ${BMC_COMMUNITY} ${BMC_IPv4} ${BMC_OID}"
Packit d14fb6
Packit d14fb6
		if [ -d ${SNMPD_BMC_CONF_DIR} ]; then
Packit d14fb6
			write_snmp_conf > ${SNMPD_BMC_CONF} || RETVAL=4
Packit d14fb6
		fi
Packit d14fb6
	else
Packit d14fb6
		RETVAL=3
Packit d14fb6
	fi
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
set_snmpd_conf_path()
Packit d14fb6
{
Packit d14fb6
	if [ ! -d ${SNMPD_BMC_CONF_DIR} ]; then
Packit d14fb6
		mkdir ${SNMPD_BMC_CONF_DIR} || RETVAL=7
Packit d14fb6
	fi
Packit d14fb6
Packit d14fb6
	# We need SNMPCONFPATH set for both snmpd and snmptrapd
Packit d14fb6
	for sysconf in ${SYSCONF_DIR}/snmp*d;
Packit d14fb6
	do
Packit d14fb6
		if ! grep -q "^SNMPCONFPATH.*${SNMPD_BMC_CONF_DIR}" \
Packit d14fb6
			"${sysconf}" > /dev/null 2>&1; then
Packit d14fb6
			printf "SNMPCONFPATH=/etc/snmp:%s\n" \
Packit d14fb6
				"${SNMPD_BMC_CONF_DIR}" >> ${sysconf} || \
Packit d14fb6
				RETVAL=7
Packit d14fb6
		fi
Packit d14fb6
	done
Packit d14fb6
Packit d14fb6
	return $RETVAL
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
disable_snmp_proxy()
Packit d14fb6
{
Packit d14fb6
	if [ -f ${SNMPD_BMC_CONF} ]; then
Packit d14fb6
		rm -f ${SNMPD_BMC_CONF} || RETVAL=5
Packit d14fb6
	fi
Packit d14fb6
}
Packit d14fb6
#############################################################################
Packit d14fb6
# Trap Forwarding
Packit d14fb6
#############################################################################
Packit d14fb6
Packit d14fb6
pick_alert_dest()
Packit d14fb6
{
Packit d14fb6
	test_ip="$1"
Packit d14fb6
	# We have 4 IPv4 and 4 IPv6 alert dest. We will set IPv4 for now.
Packit d14fb6
	for ALERT_DEST in `seq 1 4`
Packit d14fb6
	do
Packit d14fb6
		temp_ip=$(${IPMITOOL} lan alert print ${CHANNEL} ${ALERT_DEST}\
Packit d14fb6
			2>/dev/null| sed -n "s#^Alert IP Address.*: ##p")
Packit d14fb6
Packit d14fb6
		[ "${temp_ip}" = "${test_ip}" ] && return 0
Packit d14fb6
	done
Packit d14fb6
	return 1
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
set_alert_dest_ip()
Packit d14fb6
{
Packit d14fb6
	${IPMITOOL} lan alert set ${CHANNEL} ${ALERT_DEST} ipaddr ${1} \
Packit d14fb6
		retry 4 type pet >/dev/null 2>&1 || RETVAL=8
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
config_bmc_alert_dest()
Packit d14fb6
{
Packit d14fb6
	# call with enable|disable
Packit d14fb6
	# Pick the first active LAN channel
Packit d14fb6
        for CHANNEL in `seq 1 14`
Packit d14fb6
        do
Packit d14fb6
                [ $(${IPMITOOL} -I open channel info ${CHANNEL} 2>/dev/null \
Packit d14fb6
                        | grep -q "802\.3") ] || break
Packit d14fb6
        done
Packit d14fb6
Packit d14fb6
	# If TRAPD_IP is already set as an alert dest,
Packit d14fb6
	if pick_alert_dest "${TRAPD_IP}"; then
Packit d14fb6
		# disable: reset it if we are called with disable
Packit d14fb6
		[ "${1}" = "disable" ] && \
Packit d14fb6
			set_alert_dest_ip "0.0.0.0"
Packit d14fb6
	# else, find the next free alert dest,
Packit d14fb6
	elif pick_alert_dest "0.0.0.0"; then
Packit d14fb6
		[ "${1}" = "disable" ] && \
Packit d14fb6
			return $RETVAL
Packit d14fb6
		# set: the TRAPD_IP
Packit d14fb6
		set_alert_dest_ip "${TRAPD_IP}"
Packit d14fb6
	else
Packit d14fb6
		# No free alert destinations
Packit d14fb6
		RETVAL=9
Packit d14fb6
	fi
Packit d14fb6
Packit d14fb6
	return $RETVAL
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
set_ipmi_pef()
Packit d14fb6
{
Packit d14fb6
	# Needs ipmitool-1.8.13 + patches
Packit d14fb6
	${IPMITOOL} pef policy set ${ALERT_DEST} "${1}" >/dev/null 2>&1 || \
Packit d14fb6
		RETVAL=10
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
get_host_ip()
Packit d14fb6
{
Packit d14fb6
	# Get host's IP that the BMC can reach. This is at best a hack.
Packit d14fb6
	IFACE=$(/usr/sbin/ip -o -f inet address |awk '!/: lo/ {print $2}')
Packit d14fb6
Packit d14fb6
	for dev in ${IFACE}
Packit d14fb6
	do
Packit d14fb6
		temp_ping=$(ping -c 1 -I ${dev} ${BMC_IPv4})
Packit d14fb6
		[ $? -ne 0 ] && continue
Packit d14fb6
Packit d14fb6
		printf -- "%s" "$temp_ping"| awk 'NR==1{print $5}' && break
Packit d14fb6
	done
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
config_bmc_alert()
Packit d14fb6
{
Packit d14fb6
	# Do two things
Packit d14fb6
	# Set/Reset TRAP IP in BMC
Packit d14fb6
	# Enable/Disable PEF alerting in BMC for TRAP
Packit d14fb6
Packit d14fb6
	# Get Host's IP that the BMC can send traps to
Packit d14fb6
	TRAPD_IP=$(get_host_ip)
Packit d14fb6
Packit d14fb6
	# Set Host's IP as the alert destination in the BMC
Packit d14fb6
	valid_ip ${TRAPD_IP} && config_bmc_alert_dest "${ACTION}"
Packit d14fb6
Packit d14fb6
	# Enable/Disable alerting on the LAN channel
Packit d14fb6
	[ $RETVAL -eq 0 ] && set_ipmi_pef "${ACTION}"
Packit d14fb6
Packit d14fb6
	return $RETVAL
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
write_trapd_conf()
Packit d14fb6
{
Packit d14fb6
	printf "###############################################\n"
Packit d14fb6
	printf "# Automatically created by %s #\n" "${SCRIPT_NAME}"
Packit d14fb6
	printf "forward default %s\n" "${FORWARD_HOST}"
Packit d14fb6
	printf "###############################################\n"
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
config_trapd()
Packit d14fb6
{
Packit d14fb6
	# Proceed only if snmptrapd is available on the system
Packit d14fb6
	if [ -f ${TRAPD_CONF} ]; then
Packit d14fb6
		write_trapd_conf > ${TRAPD_BMC_CONF} || RETVAL=11
Packit d14fb6
	else
Packit d14fb6
		RETVAL=11
Packit d14fb6
	fi
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
trap_sink_exists()
Packit d14fb6
{
Packit d14fb6
	# TODO: We only set the first match. We should be able to set
Packit d14fb6
	# multiple
Packit d14fb6
	FORWARD_HOST=$(awk '/^trap.*sink/{print $2}; /^informsink/{print $2}' \
Packit d14fb6
			/etc/snmp/snmpd*conf | head -1)
Packit d14fb6
Packit d14fb6
	if [ -z "${FORWARD_HOST}" ]; then
Packit d14fb6
		# there is no trapsink setup.
Packit d14fb6
		return 1
Packit d14fb6
	else
Packit d14fb6
		return 0
Packit d14fb6
	fi
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
# Forward SNMP traps from the BMC to trapsink.
Packit d14fb6
trap_forward()
Packit d14fb6
{
Packit d14fb6
	NO_TRAP=0
Packit d14fb6
	ACTION=${1} # enable or disable
Packit d14fb6
Packit d14fb6
	if [ "${ACTION}" = "enable" ]; then
Packit d14fb6
		# Get trapd config,
Packit d14fb6
		if trap_sink_exists; then
Packit d14fb6
			config_bmc_alert && config_trapd
Packit d14fb6
		else
Packit d14fb6
			# exit silently if there is no sink
Packit d14fb6
			NO_TRAP=1
Packit d14fb6
		fi
Packit d14fb6
	else
Packit d14fb6
		if [ -f ${TRAPD_BMC_CONF} ]; then
Packit d14fb6
			rm -f ${TRAPD_BMC_CONF} >/dev/null 2>&1
Packit d14fb6
			config_bmc_alert
Packit d14fb6
		else
Packit d14fb6
			NO_TRAP=1
Packit d14fb6
		fi
Packit d14fb6
	fi
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
#############################################################################
Packit d14fb6
service_reload()
Packit d14fb6
{
Packit d14fb6
	#TODO: do this in systemd
Packit d14fb6
	if [ ${RETVAL} -eq 0 ] && [ "${RELOAD_SERVICES}" = "yes" ]; then
Packit d14fb6
		service $1 reload
Packit d14fb6
		[ $? -ne 0 ] && RETVAL=6
Packit d14fb6
	fi
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
#############################################################################
Packit d14fb6
start()
Packit d14fb6
{
Packit d14fb6
	if bmc_info_exists && check_snmp; then
Packit d14fb6
		touch ${LOCKFILE}
Packit d14fb6
Packit d14fb6
		set_snmpd_conf_path && set_snmp_proxy
Packit d14fb6
		[ $RETVAL -eq 0 ] && service_reload snmpd
Packit d14fb6
Packit d14fb6
		if [ "${TRAP_FORWARD}" = "yes" ]; then
Packit d14fb6
			trap_forward "enable"
Packit d14fb6
			[ $RETVAL -eq 0 ] && [ $NO_TRAP -eq 0 ] && \
Packit d14fb6
				service_reload snmptrapd
Packit d14fb6
		fi
Packit d14fb6
	fi
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
#############################################################################
Packit d14fb6
stop()
Packit d14fb6
{
Packit d14fb6
	[ ! -f ${LOCKFILE} ] && return
Packit d14fb6
	if bmc_info_exists && check_snmp; then
Packit d14fb6
		disable_snmp_proxy
Packit d14fb6
		[ $RETVAL -eq 0 ] && service_reload snmpd
Packit d14fb6
Packit d14fb6
		if [ "${TRAP_FORWARD}" = "yes" ]; then
Packit d14fb6
			trap_forward "disable"
Packit d14fb6
			[ $RETVAL -eq 0 ] && [ $NO_TRAP -eq 0 ] && \
Packit d14fb6
				service_reload snmptrapd
Packit d14fb6
		fi
Packit d14fb6
Packit d14fb6
		rm -f ${LOCKFILE}
Packit d14fb6
	fi
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
#############################################################################
Packit d14fb6
status()
Packit d14fb6
{
Packit d14fb6
	eval_gettext "${SCRIPT_NAME}: snmp proxy to BMC is "
Packit d14fb6
	# Checking for lockfile is better.
Packit d14fb6
	#if grep -q "^proxy" "${SNMPD_BMC_CONF}" > /dev/null 2>&1 ; then
Packit d14fb6
	if [ -f ${LOCKFILE} ]; then
Packit d14fb6
		eval_gettext "set"
Packit d14fb6
	else
Packit d14fb6
		eval_gettext "not set"
Packit d14fb6
	fi
Packit d14fb6
Packit d14fb6
	echo
Packit d14fb6
	RETVAL=0
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
#############################################################################
Packit d14fb6
usage()
Packit d14fb6
{
Packit d14fb6
	eval_gettext "Usage: $0 {start|stop|status}"; echo 1>&2
Packit d14fb6
	RETVAL=1
Packit d14fb6
}
Packit d14fb6
Packit d14fb6
#############################################################################
Packit d14fb6
# MAIN
Packit d14fb6
#############################################################################
Packit d14fb6
case "$1" in
Packit d14fb6
	start) start ;;
Packit d14fb6
	stop)  stop ;;
Packit d14fb6
	status)	status ;;
Packit d14fb6
	*) usage ;;
Packit d14fb6
esac
Packit d14fb6
Packit d14fb6
case "$RETVAL" in
Packit d14fb6
	0|1) ;;
Packit d14fb6
	2) eval_gettext "${SCRIPT_NAME}: failed to read ${BMC_INFO} " 1>&2 ;;
Packit d14fb6
	3) eval_gettext "${SCRIPT_NAME}: failed to get proxy config." 1>&2 ;;
Packit d14fb6
	4) eval_gettext "${SCRIPT_NAME}: failed to set ${SNMPD_BMC_CONF}." 1>&2 ;;
Packit d14fb6
	5) eval_gettext "${SCRIPT_NAME}: failed to disable snmp proxy." 1>&2 ;;
Packit d14fb6
	6) eval_gettext "${SCRIPT_NAME}: failed to reload snmpd." 1>&2 ;;
Packit d14fb6
	7) eval_gettext "${SCRIPT_NAME}: failed to set snmpd config." 1>&2 ;;
Packit d14fb6
	8) eval_gettext "${SCRIPT_NAME}: failed to set IPMI alert dest." 1>&2 ;;
Packit d14fb6
	9) eval_gettext "${SCRIPT_NAME}: no free IPMI alert dest." 1>&2 ;;
Packit d14fb6
	10) eval_gettext "${SCRIPT_NAME}: failed to set IPMI PEF." 1>&2 ;;
Packit d14fb6
	11) eval_gettext "${SCRIPT_NAME}: failed to write snmptrapd.conf." 1>&2 ;;
Packit d14fb6
	12) eval_gettext "${SCRIPT_NAME}: snmpd not found." 1>&2 ;;
Packit d14fb6
	*) eval_gettext "${SCRIPT_NAME}: unknown error." 1>&2 ;;
Packit d14fb6
esac
Packit d14fb6
Packit d14fb6
if [ ${RETVAL} -gt 1 ]; then
Packit d14fb6
        eval_gettext " Return code: ${RETVAL}"; echo
Packit d14fb6
fi
Packit d14fb6
Packit d14fb6
exit ${RETVAL}
Packit d14fb6
#############################################################################
Packit d14fb6
# end of file
Packit d14fb6
#############################################################################