[Debian-ha-commits] [fence-agents] 01/04: Imported Upstream version 4.0.7.1
Richard Winters
devrik-guest at moszumanska.debian.org
Thu Apr 16 08:06:53 UTC 2015
This is an automated email from the git hooks/post-receive script.
devrik-guest pushed a commit to branch master
in repository fence-agents.
commit cc8e4069355ae607a6c09e63c0a436bbdaf01b51
Author: Richard B Winters <rik at mmogp.com>
Date: Thu Apr 16 03:48:20 2015 -0400
Imported Upstream version 4.0.7.1
---
.gitignore | 86 +
Makefile.am | 46 +
autogen.sh | 4 +
configure.ac | 302 +
doc/COPYING.applications | 339 +
doc/COPYING.libraries | 510 +
doc/COPYRIGHT | 73 +
doc/Makefile.am | 6 +
doc/README.licence | 33 +
fence/Makefile.am | 3 +
fence/agents/Makefile.am | 4 +
fence/agents/alom/Makefile.am | 17 +
fence/agents/alom/fence_alom.py | 65 +
fence/agents/amt/Makefile.am | 17 +
fence/agents/amt/fence_amt.py | 151 +
fence/agents/apc/Makefile.am | 17 +
fence/agents/apc/fence_apc.py | 268 +
fence/agents/apc_snmp/Makefile.am | 19 +
fence/agents/apc_snmp/README | 45 +
fence/agents/apc_snmp/fence_apc_snmp.py | 209 +
fence/agents/apc_snmp/powernet369.mib | 31109 ++++++++++++++++++++++
fence/agents/baytech/Makefile.am | 17 +
fence/agents/baytech/fence_baytech.pl | 746 +
fence/agents/bladecenter/Makefile.am | 17 +
fence/agents/bladecenter/fence_bladecenter.py | 118 +
fence/agents/brocade/Makefile.am | 17 +
fence/agents/brocade/fence_brocade.py | 86 +
fence/agents/bullpap/Makefile.am | 17 +
fence/agents/bullpap/fence_bullpap.pl | 433 +
fence/agents/cisco_mds/Makefile.am | 17 +
fence/agents/cisco_mds/fence_cisco_mds.py | 105 +
fence/agents/cisco_ucs/Makefile.am | 17 +
fence/agents/cisco_ucs/fence_cisco_ucs.py | 158 +
fence/agents/cpint/Makefile.am | 17 +
fence/agents/cpint/fence_cpint.pl | 188 +
fence/agents/drac/Makefile.am | 17 +
fence/agents/drac/fence_drac.py | 80 +
fence/agents/drac5/Makefile.am | 17 +
fence/agents/drac5/fence_drac5.py | 160 +
fence/agents/dummy/Makefile.am | 17 +
fence/agents/dummy/fence_dummy.py | 131 +
fence/agents/eaton_snmp/Makefile.am | 18 +
fence/agents/eaton_snmp/README | 20 +
fence/agents/eaton_snmp/fence_eaton_snmp.py | 233 +
fence/agents/egenera/Makefile.am | 17 +
fence/agents/egenera/fence_egenera.pl | 501 +
fence/agents/eps/Makefile.am | 17 +
fence/agents/eps/fence_eps.py | 129 +
fence/agents/hds_cb/Makefile.am | 17 +
fence/agents/hds_cb/fence_hds_cb.py | 146 +
fence/agents/hpblade/Makefile.am | 17 +
fence/agents/hpblade/fence_hpblade.py | 95 +
fence/agents/ibmblade/Makefile.am | 17 +
fence/agents/ibmblade/fence_ibmblade.py | 77 +
fence/agents/ifmib/Makefile.am | 18 +
fence/agents/ifmib/README | 45 +
fence/agents/ifmib/fence_ifmib.py | 126 +
fence/agents/ilo/Makefile.am | 23 +
fence/agents/ilo/fence_ilo.py | 128 +
fence/agents/ilo_mp/Makefile.am | 17 +
fence/agents/ilo_mp/fence_ilo_mp.py | 68 +
fence/agents/intelmodular/Makefile.am | 17 +
fence/agents/intelmodular/fence_intelmodular.py | 92 +
fence/agents/ipdu/Makefile.am | 17 +
fence/agents/ipdu/fence_ipdu.py | 155 +
fence/agents/ipmilan/Makefile.am | 22 +
fence/agents/ipmilan/fence_ipmilan.py | 200 +
fence/agents/kdump/Makefile.am | 14 +
fence/agents/kdump/fence_kdump.8 | 85 +
fence/agents/kdump/fence_kdump.c | 511 +
fence/agents/kdump/fence_kdump_send.8 | 50 +
fence/agents/kdump/fence_kdump_send.c | 254 +
fence/agents/kdump/list.h | 573 +
fence/agents/kdump/message.h | 41 +
fence/agents/kdump/options.h | 241 +
fence/agents/kdump/version.h | 33 +
fence/agents/ldom/Makefile.am | 17 +
fence/agents/ldom/fence_ldom.py | 118 +
fence/agents/lib/Makefile.am | 28 +
fence/agents/lib/XenAPI.py.py | 209 +
fence/agents/lib/check_used_options.py | 65 +
fence/agents/lib/fence.rng.head | 7 +
fence/agents/lib/fence.rng.tail | 13 +
fence/agents/lib/fence2man.xsl | 59 +
fence/agents/lib/fence2rng.xsl | 161 +
fence/agents/lib/fencing.py.py | 1077 +
fence/agents/lib/fencing_snmp.py.py | 131 +
fence/agents/lib/metadata.rng | 77 +
fence/agents/lib/transfer.py | 16 +
fence/agents/lpar/Makefile.am | 17 +
fence/agents/lpar/fence_lpar.py | 160 +
fence/agents/manual/Makefile.am | 17 +
fence/agents/manual/fence_ack_manual.8 | 39 +
fence/agents/manual/fence_ack_manual.in | 37 +
fence/agents/mcdata/Makefile.am | 17 +
fence/agents/mcdata/fence_mcdata.pl | 361 +
fence/agents/netio/Makefile.am | 17 +
fence/agents/netio/fence_netio.py | 119 +
fence/agents/ovh/Makefile.am | 17 +
fence/agents/ovh/fence_ovh.py | 144 +
fence/agents/rackswitch/Makefile.am | 16 +
fence/agents/rackswitch/do_rack.c | 807 +
fence/agents/rackswitch/do_rack.h | 27 +
fence/agents/rhevm/Makefile.am | 17 +
fence/agents/rhevm/fence_rhevm.py | 127 +
fence/agents/rsa/Makefile.am | 17 +
fence/agents/rsa/fence_rsa.py | 77 +
fence/agents/rsb/Makefile.am | 17 +
fence/agents/rsb/fence_rsb.py | 86 +
fence/agents/sanbox2/Makefile.am | 17 +
fence/agents/sanbox2/fence_sanbox2.py | 152 +
fence/agents/scsi/Makefile.am | 21 +
fence/agents/scsi/fence_scsi.8 | 119 +
fence/agents/scsi/fence_scsi.pl | 875 +
fence/agents/scsi/fence_scsi_check.pl | 170 +
fence/agents/virsh/Makefile.am | 17 +
fence/agents/virsh/fence_virsh.py | 101 +
fence/agents/vixel/Makefile.am | 17 +
fence/agents/vixel/fence_vixel.pl | 267 +
fence/agents/vmware/Makefile.am | 17 +
fence/agents/vmware/fence_vmware.py | 333 +
fence/agents/vmware/fence_vmware_helper.pl | 276 +
fence/agents/vmware_soap/Makefile.am | 17 +
fence/agents/vmware_soap/fence_vmware_soap.py | 220 +
fence/agents/wti/Makefile.am | 17 +
fence/agents/wti/fence_wti.py | 241 +
fence/agents/xcat/Makefile.am | 17 +
fence/agents/xcat/fence_xcat.pl | 250 +
fence/agents/xenapi/Makefile.am | 17 +
fence/agents/xenapi/fence_xenapi.py | 228 +
fence/agents/zvm/Makefile.am | 13 +
fence/agents/zvm/fence_zvm.8 | 81 +
fence/agents/zvm/fence_zvm.c | 601 +
fence/agents/zvm/fence_zvm.h | 580 +
fence/agents/zvm/fence_zvmip.8 | 86 +
fence/agents/zvm/fence_zvmip.c | 651 +
make/copyright.cf | 6 +
make/fencebuild.mk | 19 +
make/fenceman.mk | 9 +
make/fencemanc.mk | 8 +
make/fencemanperl.mk | 8 +
make/git-version-gen | 161 +
make/gitlog-to-changelog | 191 +
make/release.mk | 73 +
scripts/fenceparse | 42 +
tests/actions.d/list.cfg | 2 +
tests/actions.d/power-on-off.cfg | 2 +
tests/actions.d/sleep.cfg | 2 +
tests/actions.d/status.cfg | 2 +
tests/devices.d/dummy-with_action.cfg | 9 +
tests/devices.d/dummy.cfg | 3 +
tests/devices.d/invalid-missing_option.cfg | 4 +
tests/devices.d/true-with_action.cfg | 8 +
tests/devices.d/true.cfg | 8 +
tests/fence_testing.py | 126 +
tests/fence_testing_test.py | 70 +
tests/test-apc2.py | 17 +
tests/test-apc5.py | 17 +
tests/test-drac4.py | 15 +
tests/test-multi-apc2.py | 17 +
tests/test.py | 21 +
161 files changed, 50087 insertions(+)
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..a711b3a
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,86 @@
+*.swp
+Makefile.in
+aclocal.m4
+autoconf
+autoheader
+autom4te.cache
+automake
+autoscan.log
+compile
+configure
+configure.scan
+config.guess
+config.log
+config.sub
+config.status
+Makefile
+depcomp
+install-sh
+libtoolize
+ltmain.sh
+libtool
+make/stamp-h1
+m4
+make/clusterautoconfig.h*
+missing
+*.pc
+.deps
+.libs
+*.o
+*.la
+*.lo
+fence/agents/alom/fence_alom
+fence/agents/apc/fence_apc
+fence/agents/apc_snmp/fence_apc_snmp
+fence/agents/baytech/fence_baytech
+fence/agents/bladecenter/fence_bladecenter
+fence/agents/brocade/fence_brocade
+fence/agents/bullpap/fence_bullpap
+fence/agents/cisco_mds/fence_cisco_mds
+fence/agents/cisco_ucs/fence_cisco_ucs
+fence/agents/cpint/fence_cpint
+fence/agents/drac/fence_drac
+fence/agents/drac5/fence_drac5
+fence/agents/eaton_snmp/fence_eaton_snmp
+fence/agents/egenera/fence_egenera
+fence/agents/eps/fence_eps
+fence/agents/ibmblade/fence_ibmblade
+fence/agents/ifmib/fence_ifmib
+fence/agents/ilo/fence_ilo
+fence/agents/ilo_mp/fence_ilo_mp
+fence/agents/intelmodular/fence_intelmodular
+fence/agents/ipdu/fence_ipdu
+fence/agents/ipmilan/fence_ipmilan
+fence/agents/ldom/fence_ldom
+fence/agents/lib/fencing.py
+fence/agents/lib/fencing_snmp.py
+fence/agents/lib/fencing.pyc
+fence/agents/lib/fencing_snmp.pyc
+fence/agents/lpar/fence_lpar
+fence/agents/manual/fence_ack_manual
+fence/agents/mcdata/fence_mcdata
+fence/agents/netio/fence_netio
+fence/agents/node_assassin/fence_na
+fence/agents/node_assassin/fence_na.conf
+fence/agents/node_assassin/fence_na.lib
+fence/agents/node_assassin/fence_na.pod
+fence/agents/nss_wrapper/fence_nss_wrapper
+fence/agents/rackswitch/fence_rackswitch
+fence/agents/rhevm/fence_rhevm
+fence/agents/rsa/fence_rsa
+fence/agents/rsb/fence_rsb
+fence/agents/sanbox2/fence_sanbox2
+fence/agents/scsi/fence_scsi
+fence/agents/scsi/fence_scsi_test
+fence/agents/virsh/fence_virsh
+fence/agents/vixel/fence_vixel
+fence/agents/vmware/fence_vmware
+fence/agents/vmware/fence_vmware_helper
+fence/agents/wti/fence_wti
+fence/agents/xcat/fence_xcat
+fence/agents/zvm/fence_zvm
+fence/agents/zvm/fence_zvmip
+.fence*.tmp
+fence-agents*
+.version
+tests/devices.d/*
diff --git a/Makefile.am b/Makefile.am
new file mode 100644
index 0000000..1bd077a
--- /dev/null
+++ b/Makefile.am
@@ -0,0 +1,46 @@
+EXTRA_DIST = autogen.sh make/fencebuild.mk scripts/fenceparse \
+ .version make/release.mk \
+ make/git-version-gen make/gitlog-to-changelog
+
+AUTOMAKE_OPTIONS = foreign
+
+MAINTAINERCLEANFILES = Makefile.in aclocal.m4 configure depcomp \
+ config.guess config.sub missing install-sh \
+ autoheader automake autoconf libtool libtoolize \
+ ltmain.sh compile make/clusterautoconfig.h.in \
+ make/clusterautoconfig.h.in~ autoscan.log \
+ configure.scan
+
+noinst_HEADERS = make/copyright.cf
+
+ACLOCAL_AMFLAGS = -I m4
+
+SUBDIRS = fence doc
+
+install-exec-local:
+ $(INSTALL) -d $(DESTDIR)/$(LOGDIR)
+ $(INSTALL) -d $(DESTDIR)/$(CLUSTERVARRUN)
+
+uninstall-local:
+ rmdir $(DESTDIR)/$(LOGDIR) || :;
+ rmdir $(DESTDIR)/$(CLUSTERVARRUN) || :;
+
+BUILT_SOURCES = .version
+.version:
+ echo $(VERSION) > $@-t && mv $@-t $@
+
+dist-hook: gen-ChangeLog
+ echo $(VERSION) > $(distdir)/.tarball-version
+
+gen_start_date = 2000-01-01
+.PHONY: gen-ChangeLog
+gen-ChangeLog:
+ if test -d .git; then \
+ $(top_srcdir)/make/gitlog-to-changelog \
+ --since=$(gen_start_date) > $(distdir)/cl-t; \
+ rm -f $(distdir)/ChangeLog; \
+ mv $(distdir)/cl-t $(distdir)/ChangeLog; \
+ fi
+
+maintainer-clean-local:
+ rm -rf m4
diff --git a/autogen.sh b/autogen.sh
new file mode 100755
index 0000000..3c5e1d9
--- /dev/null
+++ b/autogen.sh
@@ -0,0 +1,4 @@
+#!/bin/sh
+# Run this to generate all the initial makefiles, etc.
+mkdir -p m4
+autoreconf -i -v && echo Now run ./configure and make
diff --git a/configure.ac b/configure.ac
new file mode 100644
index 0000000..eaef1d8
--- /dev/null
+++ b/configure.ac
@@ -0,0 +1,302 @@
+# Process this file with autoconf to produce a configure script.
+
+AC_PREREQ([2.63])
+
+AC_INIT([fence-agents],
+ m4_esyscmd([make/git-version-gen .tarball-version]),
+ [linux-cluster at redhat.com])
+
+AM_INIT_AUTOMAKE([-Wno-portability dist-bzip2 dist-xz])
+
+LT_PREREQ([2.2.6])
+LT_INIT
+
+AC_CONFIG_MACRO_DIR([m4])
+AC_CONFIG_SRCDIR([fence/agents/rackswitch/do_rack.h])
+AC_CONFIG_HEADERS([make/clusterautoconfig.h])
+
+AC_CANONICAL_HOST
+AC_PROG_LIBTOOL
+
+AC_LANG([C])
+
+# Sanitize path
+
+if test "$prefix" = "NONE"; then
+ prefix="/usr"
+ if test "$localstatedir" = "\${prefix}/var"; then
+ localstatedir="/var"
+ fi
+ if test "$sysconfdir" = "\${prefix}/etc"; then
+ sysconfdir="/etc"
+ fi
+ if test "$libdir" = "\${exec_prefix}/lib"; then
+ if test -e /usr/lib64; then
+ libdir="/usr/lib64"
+ else
+ libdir="/usr/lib"
+ fi
+ fi
+fi
+
+case $exec_prefix in
+ NONE) exec_prefix=$prefix;;
+ prefix) exec_prefix=$prefix;;
+esac
+
+# Checks for programs.
+
+# check stolen from gnulib/m4/gnu-make.m4
+if ! ${MAKE-make} --version /cannot/make/this >/dev/null 2>&1; then
+ AC_MSG_ERROR([you don't seem to have GNU make; it is required])
+fi
+
+AC_PROG_CC
+AM_PROG_CC_C_O
+AC_PROG_LN_S
+AC_PROG_INSTALL
+AC_PROG_MAKE_SET
+AC_PROG_AWK
+AC_PROG_CXX
+AC_PROG_RANLIB
+
+## local helper functions
+
+# this function checks if CC support options passed as
+# args. Global CFLAGS are ignored during this test.
+cc_supports_flag() {
+ local CFLAGS="$@"
+ AC_MSG_CHECKING([whether $CC supports "$@"])
+ AC_COMPILE_IFELSE([int main(){return 0;}] ,
+ [RC=0; AC_MSG_RESULT([yes])],
+ [RC=1; AC_MSG_RESULT([no])])
+ return $RC
+}
+
+# this function tests if a library has a certain function
+# by using AC_CHECK_LIB but restores the original LIBS global
+# envvar. This is required to avoid libtool to link everything
+# with everything.
+check_lib_no_libs() {
+ AC_CHECK_LIB([$1], [$2],,
+ [AC_MSG_ERROR([Unable to find $1 library])])
+ LIBS=$ac_check_lib_save_LIBS
+}
+
+# Checks for header files.
+AC_CHECK_HEADERS([arpa/inet.h fcntl.h libintl.h limits.h netdb.h stddef.h sys/socket.h sys/time.h syslog.h])
+
+# Checks for typedefs, structures, and compiler characteristics.
+AC_C_INLINE
+AC_TYPE_SIZE_T
+AC_TYPE_SSIZE_T
+AC_TYPE_UINT32_T
+
+# Checks for library functions.
+AC_FUNC_FORK
+AC_FUNC_MALLOC
+AC_CHECK_FUNCS([alarm atexit bzero dup2 memmove memset select socket strcasecmp strchr strdup strerror strtol])
+
+# local options
+AC_ARG_ENABLE([debug],
+ [ --enable-debug enable debug build. ],
+ [ default="no" ])
+
+AC_ARG_WITH([fenceagentslibdir],
+ [ --with-fenceagentslibdir=PATH
+ installation path for fence library. ],
+ [ FENCEAGENTSLIBDIR="$withval" ],
+ [ FENCEAGENTSLIBDIR="${datadir}/fence" ])
+
+AC_ARG_WITH([snmpbin],
+ [ --with-snmpbin=PATH
+ path to snmp binaries (snmpwalk/get). ],
+ [ SNMPBIN="$withval" ],
+ [ SNMPBIN="${bindir}" ])
+
+AC_ARG_WITH([default-config-dir],
+ [ --with-default-config-dir=DIR
+ cluster config directory. ],
+ [ DEFAULT_CONFIG_DIR="$withval" ],
+ [ DEFAULT_CONFIG_DIR="$sysconfdir/cluster" ])
+
+AC_ARG_WITH([default-config-file],
+ [ --with-default-config-file=FILE
+ cluster config file. ],
+ [ DEFAULT_CONFIG_FILE="$withval" ],
+ [ DEFAULT_CONFIG_FILE="cluster.conf" ])
+
+AC_ARG_WITH([agents],
+ [ --with-agents=LIST
+ list of agents to build/ship (default: all). ],
+ [ AGENTS_LIST="$withval" ],
+ [ AGENTS_LIST="all" ])
+
+if test "x$AGENTS_LIST" = x; then
+ AC_ERROR([No agents selected])
+fi
+
+if test "x$AGENTS_LIST" != xall; then
+ for j in $AGENTS_LIST; do
+ if ! test -d fence/agents/$j; then
+ AC_ERROR([Agent $j does not exists])
+ fi
+ done
+fi
+
+if test "x$AGENTS_LIST" = xall; then
+ AGENTS_LIST=`find $srcdir/fence/agents -mindepth 2 -maxdepth 2 -name Makefile.am -printf '%h ' | sed -e 's#'$srcdir'/fence/agents/##g' -e 's#lib ##g' -e 's#nss_wrapper ##g'`
+fi
+
+XENAPILIB=0
+if echo "$AGENTS_LIST" | grep -q xenapi; then
+ XENAPILIB=1
+fi
+
+## random vars
+
+LOGDIR=${localstatedir}/log/cluster
+CLUSTERVARRUN=${localstatedir}/run/cluster
+CLUSTERDATA=${datadir}/cluster
+
+## path to 3rd-party binaries
+AC_PATH_PROG([IPMITOOL_PATH], [ipmitool], [/usr/bin/ipmitool])
+AC_PATH_PROG([AMTTOOL_PATH], [amttool], [/usr/bin/amttool])
+AC_PATH_PROG([GNUTLSCLI_PATH], [gnutlscli], [/usr/bin/gnutls-cli])
+## do subst
+
+AC_SUBST([DEFAULT_CONFIG_DIR])
+AC_DEFINE_UNQUOTED([DEFAULT_CONFIG_DIR], "$(eval echo ${DEFAULT_CONFIG_DIR})",
+ [Default config directory])
+
+AC_SUBST([DEFAULT_CONFIG_FILE])
+AC_DEFINE_UNQUOTED([DEFAULT_CONFIG_FILE], "$(eval echo ${DEFAULT_CONFIG_FILE})",
+ [Default config file])
+
+AC_SUBST([LOGDIR])
+AC_DEFINE_UNQUOTED([LOGDIR], "$(eval echo ${LOGDIR})",
+ [Default logging directory])
+
+AC_SUBST([CLUSTERVARRUN])
+AC_DEFINE_UNQUOTED([CLUSTERVARRUN], "$(eval echo ${CLUSTERVARRUN})",
+ [Default cluster var/run directory])
+
+AC_SUBST([CLUSTERDATA])
+AC_SUBST([FENCEAGENTSLIBDIR])
+AC_SUBST([SNMPBIN])
+AC_SUBST([AGENTS_LIST])
+AM_CONDITIONAL(BUILD_XENAPILIB, test $XENAPILIB -eq 1)
+
+AC_SUBST([IPMITOOL_PATH])
+AC_SUBST([AMTTOOL_PATH])
+
+## *FLAGS handling
+
+ENV_CFLAGS="$CFLAGS"
+ENV_CPPFLAGS="$CPPFLAGS"
+ENV_LDFLAGS="$LDFLAGS"
+
+# debug build stuff
+if test "x${enable_debug}" = xyes; then
+ AC_DEFINE_UNQUOTED([DEBUG], [1], [Compiling Debugging code])
+ OPT_CFLAGS="-O0"
+else
+ OPT_CFLAGS="-O2"
+fi
+
+# gdb flags
+if test "x${GCC}" = xyes; then
+ GDB_FLAGS="-ggdb3"
+else
+ GDB_FLAGS="-g"
+fi
+
+# extra warnings
+EXTRA_WARNINGS=""
+
+WARNLIST="
+ all
+ shadow
+ missing-prototypes
+ missing-declarations
+ strict-prototypes
+ declaration-after-statement
+ pointer-arith
+ write-strings
+ cast-align
+ bad-function-cast
+ missing-format-attribute
+ format=2
+ format-security
+ format-nonliteral
+ no-long-long
+ unsigned-char
+ gnu89-inline
+ no-strict-aliasing
+ "
+
+for j in $WARNLIST; do
+ if cc_supports_flag -W$j; then
+ EXTRA_WARNINGS="$EXTRA_WARNINGS -W$j";
+ fi
+done
+
+CFLAGS="$ENV_CFLAGS $OPT_CFLAGS $GDB_FLAGS \
+ $EXTRA_WARNINGS $WERROR_CFLAGS"
+CPPFLAGS="-I\$(top_builddir)/make -I\$(top_srcdir)/make -I. $ENV_CPPFLAGS"
+LDFLAGS="$ENV_LDFLAGS"
+
+AC_CONFIG_FILES([Makefile
+ fence/Makefile
+ fence/agents/Makefile
+ fence/agents/alom/Makefile
+ fence/agents/apc/Makefile
+ fence/agents/apc_snmp/Makefile
+ fence/agents/amt/Makefile
+ fence/agents/baytech/Makefile
+ fence/agents/bladecenter/Makefile
+ fence/agents/brocade/Makefile
+ fence/agents/bullpap/Makefile
+ fence/agents/cisco_mds/Makefile
+ fence/agents/cisco_ucs/Makefile
+ fence/agents/cpint/Makefile
+ fence/agents/drac/Makefile
+ fence/agents/drac5/Makefile
+ fence/agents/dummy/Makefile
+ fence/agents/eaton_snmp/Makefile
+ fence/agents/egenera/Makefile
+ fence/agents/eps/Makefile
+ fence/agents/hpblade/Makefile
+ fence/agents/ibmblade/Makefile
+ fence/agents/ipdu/Makefile
+ fence/agents/ifmib/Makefile
+ fence/agents/ilo/Makefile
+ fence/agents/ilo_mp/Makefile
+ fence/agents/intelmodular/Makefile
+ fence/agents/ipmilan/Makefile
+ fence/agents/kdump/Makefile
+ fence/agents/ldom/Makefile
+ fence/agents/lib/Makefile
+ fence/agents/lpar/Makefile
+ fence/agents/manual/Makefile
+ fence/agents/mcdata/Makefile
+ fence/agents/netio/Makefile
+ fence/agents/rackswitch/Makefile
+ fence/agents/ovh/Makefile
+ fence/agents/rhevm/Makefile
+ fence/agents/rsa/Makefile
+ fence/agents/rsb/Makefile
+ fence/agents/sanbox2/Makefile
+ fence/agents/scsi/Makefile
+ fence/agents/virsh/Makefile
+ fence/agents/vixel/Makefile
+ fence/agents/vmware/Makefile
+ fence/agents/vmware_soap/Makefile
+ fence/agents/wti/Makefile
+ fence/agents/xcat/Makefile
+ fence/agents/xenapi/Makefile
+ fence/agents/hds_cb/Makefile
+ fence/agents/zvm/Makefile
+ doc/Makefile])
+
+AC_OUTPUT
diff --git a/doc/COPYING.applications b/doc/COPYING.applications
new file mode 100644
index 0000000..d511905
--- /dev/null
+++ b/doc/COPYING.applications
@@ -0,0 +1,339 @@
+ GNU GENERAL PUBLIC LICENSE
+ Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+ Preamble
+
+ The licenses for most software are designed to take away your
+freedom to share and change it. By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users. This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it. (Some other Free Software Foundation software is covered by
+the GNU Lesser General Public License instead.) You can apply it to
+your programs, too.
+
+ When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+ To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+ For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have. You must make sure that they, too, receive or can get the
+source code. And you must show them these terms so they know their
+rights.
+
+ We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+ Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software. If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+ Finally, any free program is threatened constantly by software
+patents. We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary. To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+ The precise terms and conditions for copying, distribution and
+modification follow.
+
+ GNU GENERAL PUBLIC LICENSE
+ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+ 0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License. The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language. (Hereinafter, translation is included without limitation in
+the term "modification".) Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope. The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+ 1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+ 2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+ a) You must cause the modified files to carry prominent notices
+ stating that you changed the files and the date of any change.
+
+ b) You must cause any work that you distribute or publish, that in
+ whole or in part contains or is derived from the Program or any
+ part thereof, to be licensed as a whole at no charge to all third
+ parties under the terms of this License.
+
+ c) If the modified program normally reads commands interactively
+ when run, you must cause it, when started running for such
+ interactive use in the most ordinary way, to print or display an
+ announcement including an appropriate copyright notice and a
+ notice that there is no warranty (or else, saying that you provide
+ a warranty) and that users may redistribute the program under
+ these conditions, and telling the user how to view a copy of this
+ License. (Exception: if the Program itself is interactive but
+ does not normally print such an announcement, your work based on
+ the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole. If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works. But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+ 3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+ a) Accompany it with the complete corresponding machine-readable
+ source code, which must be distributed under the terms of Sections
+ 1 and 2 above on a medium customarily used for software interchange; or,
+
+ b) Accompany it with a written offer, valid for at least three
+ years, to give any third party, for a charge no more than your
+ cost of physically performing source distribution, a complete
+ machine-readable copy of the corresponding source code, to be
+ distributed under the terms of Sections 1 and 2 above on a medium
+ customarily used for software interchange; or,
+
+ c) Accompany it with the information you received as to the offer
+ to distribute corresponding source code. (This alternative is
+ allowed only for noncommercial distribution and only if you
+ received the program in object code or executable form with such
+ an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it. For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable. However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+ 4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License. Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+ 5. You are not required to accept this License, since you have not
+signed it. However, nothing else grants you permission to modify or
+distribute the Program or its derivative works. These actions are
+prohibited by law if you do not accept this License. Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+ 6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions. You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+ 7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all. For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices. Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+ 8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded. In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+ 9. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time. Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation. If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+ 10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission. For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this. Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+ NO WARRANTY
+
+ 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+ 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+ END OF TERMS AND CONDITIONS
+
+ How to Apply These Terms to Your New Programs
+
+ If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+ To do so, attach the following notices to the program. It is safest
+to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+ <one line to give the program's name and a brief idea of what it does.>
+ Copyright (C) <year> <name of author>
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License along
+ with this program; if not, write to the Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+ Gnomovision version 69, Copyright (C) year name of author
+ Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+ This is free software, and you are welcome to redistribute it
+ under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License. Of course, the commands you use may
+be called something other than `show w' and `show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary. Here is a sample; alter the names:
+
+ Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+ `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+ <signature of Ty Coon>, 1 April 1989
+ Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs. If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library. If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.
diff --git a/doc/COPYING.libraries b/doc/COPYING.libraries
new file mode 100644
index 0000000..2d2d780
--- /dev/null
+++ b/doc/COPYING.libraries
@@ -0,0 +1,510 @@
+
+ GNU LESSER GENERAL PUBLIC LICENSE
+ Version 2.1, February 1999
+
+ Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+ 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+[This is the first released version of the Lesser GPL. It also counts
+ as the successor of the GNU Library Public License, version 2, hence
+ the version number 2.1.]
+
+ Preamble
+
+ The licenses for most software are designed to take away your
+freedom to share and change it. By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software--to make sure the software is free for all its users.
+
+ This license, the Lesser General Public License, applies to some
+specially designated software packages--typically libraries--of the
+Free Software Foundation and other authors who decide to use it. You
+can use it too, but we suggest you first think carefully about whether
+this license or the ordinary General Public License is the better
+strategy to use in any particular case, based on the explanations
+below.
+
+ When we speak of free software, we are referring to freedom of use,
+not price. Our General Public Licenses are designed to make sure that
+you have the freedom to distribute copies of free software (and charge
+for this service if you wish); that you receive source code or can get
+it if you want it; that you can change the software and use pieces of
+it in new free programs; and that you are informed that you can do
+these things.
+
+ To protect your rights, we need to make restrictions that forbid
+distributors to deny you these rights or to ask you to surrender these
+rights. These restrictions translate to certain responsibilities for
+you if you distribute copies of the library or if you modify it.
+
+ For example, if you distribute copies of the library, whether gratis
+or for a fee, you must give the recipients all the rights that we gave
+you. You must make sure that they, too, receive or can get the source
+code. If you link other code with the library, you must provide
+complete object files to the recipients, so that they can relink them
+with the library after making changes to the library and recompiling
+it. And you must show them these terms so they know their rights.
+
+ We protect your rights with a two-step method: (1) we copyright the
+library, and (2) we offer you this license, which gives you legal
+permission to copy, distribute and/or modify the library.
+
+ To protect each distributor, we want to make it very clear that
+there is no warranty for the free library. Also, if the library is
+modified by someone else and passed on, the recipients should know
+that what they have is not the original version, so that the original
+author's reputation will not be affected by problems that might be
+introduced by others.
+
+ Finally, software patents pose a constant threat to the existence of
+any free program. We wish to make sure that a company cannot
+effectively restrict the users of a free program by obtaining a
+restrictive license from a patent holder. Therefore, we insist that
+any patent license obtained for a version of the library must be
+consistent with the full freedom of use specified in this license.
+
+ Most GNU software, including some libraries, is covered by the
+ordinary GNU General Public License. This license, the GNU Lesser
+General Public License, applies to certain designated libraries, and
+is quite different from the ordinary General Public License. We use
+this license for certain libraries in order to permit linking those
+libraries into non-free programs.
+
+ When a program is linked with a library, whether statically or using
+a shared library, the combination of the two is legally speaking a
+combined work, a derivative of the original library. The ordinary
+General Public License therefore permits such linking only if the
+entire combination fits its criteria of freedom. The Lesser General
+Public License permits more lax criteria for linking other code with
+the library.
+
+ We call this license the "Lesser" General Public License because it
+does Less to protect the user's freedom than the ordinary General
+Public License. It also provides other free software developers Less
+of an advantage over competing non-free programs. These disadvantages
+are the reason we use the ordinary General Public License for many
+libraries. However, the Lesser license provides advantages in certain
+special circumstances.
+
+ For example, on rare occasions, there may be a special need to
+encourage the widest possible use of a certain library, so that it
+becomes a de-facto standard. To achieve this, non-free programs must
+be allowed to use the library. A more frequent case is that a free
+library does the same job as widely used non-free libraries. In this
+case, there is little to gain by limiting the free library to free
+software only, so we use the Lesser General Public License.
+
+ In other cases, permission to use a particular library in non-free
+programs enables a greater number of people to use a large body of
+free software. For example, permission to use the GNU C Library in
+non-free programs enables many more people to use the whole GNU
+operating system, as well as its variant, the GNU/Linux operating
+system.
+
+ Although the Lesser General Public License is Less protective of the
+users' freedom, it does ensure that the user of a program that is
+linked with the Library has the freedom and the wherewithal to run
+that program using a modified version of the Library.
+
+ The precise terms and conditions for copying, distribution and
+modification follow. Pay close attention to the difference between a
+"work based on the library" and a "work that uses the library". The
+former contains code derived from the library, whereas the latter must
+be combined with the library in order to run.
+
+ GNU LESSER GENERAL PUBLIC LICENSE
+ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+ 0. This License Agreement applies to any software library or other
+program which contains a notice placed by the copyright holder or
+other authorized party saying it may be distributed under the terms of
+this Lesser General Public License (also called "this License").
+Each licensee is addressed as "you".
+
+ A "library" means a collection of software functions and/or data
+prepared so as to be conveniently linked with application programs
+(which use some of those functions and data) to form executables.
+
+ The "Library", below, refers to any such software library or work
+which has been distributed under these terms. A "work based on the
+Library" means either the Library or any derivative work under
+copyright law: that is to say, a work containing the Library or a
+portion of it, either verbatim or with modifications and/or translated
+straightforwardly into another language. (Hereinafter, translation is
+included without limitation in the term "modification".)
+
+ "Source code" for a work means the preferred form of the work for
+making modifications to it. For a library, complete source code means
+all the source code for all modules it contains, plus any associated
+interface definition files, plus the scripts used to control
+compilation and installation of the library.
+
+ Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope. The act of
+running a program using the Library is not restricted, and output from
+such a program is covered only if its contents constitute a work based
+on the Library (independent of the use of the Library in a tool for
+writing it). Whether that is true depends on what the Library does
+and what the program that uses the Library does.
+
+ 1. You may copy and distribute verbatim copies of the Library's
+complete source code as you receive it, in any medium, provided that
+you conspicuously and appropriately publish on each copy an
+appropriate copyright notice and disclaimer of warranty; keep intact
+all the notices that refer to this License and to the absence of any
+warranty; and distribute a copy of this License along with the
+Library.
+
+ You may charge a fee for the physical act of transferring a copy,
+and you may at your option offer warranty protection in exchange for a
+fee.
+
+ 2. You may modify your copy or copies of the Library or any portion
+of it, thus forming a work based on the Library, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+ a) The modified work must itself be a software library.
+
+ b) You must cause the files modified to carry prominent notices
+ stating that you changed the files and the date of any change.
+
+ c) You must cause the whole of the work to be licensed at no
+ charge to all third parties under the terms of this License.
+
+ d) If a facility in the modified Library refers to a function or a
+ table of data to be supplied by an application program that uses
+ the facility, other than as an argument passed when the facility
+ is invoked, then you must make a good faith effort to ensure that,
+ in the event an application does not supply such function or
+ table, the facility still operates, and performs whatever part of
+ its purpose remains meaningful.
+
+ (For example, a function in a library to compute square roots has
+ a purpose that is entirely well-defined independent of the
+ application. Therefore, Subsection 2d requires that any
+ application-supplied function or table used by this function must
+ be optional: if the application does not supply it, the square
+ root function must still compute square roots.)
+
+These requirements apply to the modified work as a whole. If
+identifiable sections of that work are not derived from the Library,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works. But when you
+distribute the same sections as part of a whole which is a work based
+on the Library, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote
+it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Library.
+
+In addition, mere aggregation of another work not based on the Library
+with the Library (or with a work based on the Library) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+ 3. You may opt to apply the terms of the ordinary GNU General Public
+License instead of this License to a given copy of the Library. To do
+this, you must alter all the notices that refer to this License, so
+that they refer to the ordinary GNU General Public License, version 2,
+instead of to this License. (If a newer version than version 2 of the
+ordinary GNU General Public License has appeared, then you can specify
+that version instead if you wish.) Do not make any other change in
+these notices.
+
+ Once this change is made in a given copy, it is irreversible for
+that copy, so the ordinary GNU General Public License applies to all
+subsequent copies and derivative works made from that copy.
+
+ This option is useful when you wish to copy part of the code of
+the Library into a program that is not a library.
+
+ 4. You may copy and distribute the Library (or a portion or
+derivative of it, under Section 2) in object code or executable form
+under the terms of Sections 1 and 2 above provided that you accompany
+it with the complete corresponding machine-readable source code, which
+must be distributed under the terms of Sections 1 and 2 above on a
+medium customarily used for software interchange.
+
+ If distribution of object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the
+source code from the same place satisfies the requirement to
+distribute the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+ 5. A program that contains no derivative of any portion of the
+Library, but is designed to work with the Library by being compiled or
+linked with it, is called a "work that uses the Library". Such a
+work, in isolation, is not a derivative work of the Library, and
+therefore falls outside the scope of this License.
+
+ However, linking a "work that uses the Library" with the Library
+creates an executable that is a derivative of the Library (because it
+contains portions of the Library), rather than a "work that uses the
+library". The executable is therefore covered by this License.
+Section 6 states terms for distribution of such executables.
+
+ When a "work that uses the Library" uses material from a header file
+that is part of the Library, the object code for the work may be a
+derivative work of the Library even though the source code is not.
+Whether this is true is especially significant if the work can be
+linked without the Library, or if the work is itself a library. The
+threshold for this to be true is not precisely defined by law.
+
+ If such an object file uses only numerical parameters, data
+structure layouts and accessors, and small macros and small inline
+functions (ten lines or less in length), then the use of the object
+file is unrestricted, regardless of whether it is legally a derivative
+work. (Executables containing this object code plus portions of the
+Library will still fall under Section 6.)
+
+ Otherwise, if the work is a derivative of the Library, you may
+distribute the object code for the work under the terms of Section 6.
+Any executables containing that work also fall under Section 6,
+whether or not they are linked directly with the Library itself.
+
+ 6. As an exception to the Sections above, you may also combine or
+link a "work that uses the Library" with the Library to produce a
+work containing portions of the Library, and distribute that work
+under terms of your choice, provided that the terms permit
+modification of the work for the customer's own use and reverse
+engineering for debugging such modifications.
+
+ You must give prominent notice with each copy of the work that the
+Library is used in it and that the Library and its use are covered by
+this License. You must supply a copy of this License. If the work
+during execution displays copyright notices, you must include the
+copyright notice for the Library among them, as well as a reference
+directing the user to the copy of this License. Also, you must do one
+of these things:
+
+ a) Accompany the work with the complete corresponding
+ machine-readable source code for the Library including whatever
+ changes were used in the work (which must be distributed under
+ Sections 1 and 2 above); and, if the work is an executable linked
+ with the Library, with the complete machine-readable "work that
+ uses the Library", as object code and/or source code, so that the
+ user can modify the Library and then relink to produce a modified
+ executable containing the modified Library. (It is understood
+ that the user who changes the contents of definitions files in the
+ Library will not necessarily be able to recompile the application
+ to use the modified definitions.)
+
+ b) Use a suitable shared library mechanism for linking with the
+ Library. A suitable mechanism is one that (1) uses at run time a
+ copy of the library already present on the user's computer system,
+ rather than copying library functions into the executable, and (2)
+ will operate properly with a modified version of the library, if
+ the user installs one, as long as the modified version is
+ interface-compatible with the version that the work was made with.
+
+ c) Accompany the work with a written offer, valid for at least
+ three years, to give the same user the materials specified in
+ Subsection 6a, above, for a charge no more than the cost of
+ performing this distribution.
+
+ d) If distribution of the work is made by offering access to copy
+ from a designated place, offer equivalent access to copy the above
+ specified materials from the same place.
+
+ e) Verify that the user has already received a copy of these
+ materials or that you have already sent this user a copy.
+
+ For an executable, the required form of the "work that uses the
+Library" must include any data and utility programs needed for
+reproducing the executable from it. However, as a special exception,
+the materials to be distributed need not include anything that is
+normally distributed (in either source or binary form) with the major
+components (compiler, kernel, and so on) of the operating system on
+which the executable runs, unless that component itself accompanies
+the executable.
+
+ It may happen that this requirement contradicts the license
+restrictions of other proprietary libraries that do not normally
+accompany the operating system. Such a contradiction means you cannot
+use both them and the Library together in an executable that you
+distribute.
+
+ 7. You may place library facilities that are a work based on the
+Library side-by-side in a single library together with other library
+facilities not covered by this License, and distribute such a combined
+library, provided that the separate distribution of the work based on
+the Library and of the other library facilities is otherwise
+permitted, and provided that you do these two things:
+
+ a) Accompany the combined library with a copy of the same work
+ based on the Library, uncombined with any other library
+ facilities. This must be distributed under the terms of the
+ Sections above.
+
+ b) Give prominent notice with the combined library of the fact
+ that part of it is a work based on the Library, and explaining
+ where to find the accompanying uncombined form of the same work.
+
+ 8. You may not copy, modify, sublicense, link with, or distribute
+the Library except as expressly provided under this License. Any
+attempt otherwise to copy, modify, sublicense, link with, or
+distribute the Library is void, and will automatically terminate your
+rights under this License. However, parties who have received copies,
+or rights, from you under this License will not have their licenses
+terminated so long as such parties remain in full compliance.
+
+ 9. You are not required to accept this License, since you have not
+signed it. However, nothing else grants you permission to modify or
+distribute the Library or its derivative works. These actions are
+prohibited by law if you do not accept this License. Therefore, by
+modifying or distributing the Library (or any work based on the
+Library), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Library or works based on it.
+
+ 10. Each time you redistribute the Library (or any work based on the
+Library), the recipient automatically receives a license from the
+original licensor to copy, distribute, link with or modify the Library
+subject to these terms and conditions. You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties with
+this License.
+
+ 11. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Library at all. For example, if a patent
+license would not permit royalty-free redistribution of the Library by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Library.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply, and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system which is
+implemented by public license practices. Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+ 12. If the distribution and/or use of the Library is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Library under this License
+may add an explicit geographical distribution limitation excluding those
+countries, so that distribution is permitted only in or among
+countries not thus excluded. In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+ 13. The Free Software Foundation may publish revised and/or new
+versions of the Lesser General Public License from time to time.
+Such new versions will be similar in spirit to the present version,
+but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Library
+specifies a version number of this License which applies to it and
+"any later version", you have the option of following the terms and
+conditions either of that version or of any later version published by
+the Free Software Foundation. If the Library does not specify a
+license version number, you may choose any version ever published by
+the Free Software Foundation.
+
+ 14. If you wish to incorporate parts of the Library into other free
+programs whose distribution conditions are incompatible with these,
+write to the author to ask for permission. For software which is
+copyrighted by the Free Software Foundation, write to the Free
+Software Foundation; we sometimes make exceptions for this. Our
+decision will be guided by the two goals of preserving the free status
+of all derivatives of our free software and of promoting the sharing
+and reuse of software generally.
+
+ NO WARRANTY
+
+ 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
+WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
+KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+ 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
+WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
+AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
+FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
+CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
+LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGES.
+
+ END OF TERMS AND CONDITIONS
+
+ How to Apply These Terms to Your New Libraries
+
+ If you develop a new library, and you want it to be of the greatest
+possible use to the public, we recommend making it free software that
+everyone can redistribute and change. You can do so by permitting
+redistribution under these terms (or, alternatively, under the terms
+of the ordinary General Public License).
+
+ To apply these terms, attach the following notices to the library.
+It is safest to attach them to the start of each source file to most
+effectively convey the exclusion of warranty; and each file should
+have at least the "copyright" line and a pointer to where the full
+notice is found.
+
+
+ <one line to give the library's name and a brief idea of what it does.>
+ Copyright (C) <year> <name of author>
+
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+
+ This library is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ Lesser General Public License for more details.
+
+ You should have received a copy of the GNU Lesser General Public
+ License along with this library; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+
+Also add information on how to contact you by electronic and paper mail.
+
+You should also get your employer (if you work as a programmer) or
+your school, if any, to sign a "copyright disclaimer" for the library,
+if necessary. Here is a sample; alter the names:
+
+ Yoyodyne, Inc., hereby disclaims all copyright interest in the
+ library `Frob' (a library for tweaking knobs) written by James
+ Random Hacker.
+
+ <signature of Ty Coon>, 1 April 1990
+ Ty Coon, President of Vice
+
+That's all there is to it!
+
+
diff --git a/doc/COPYRIGHT b/doc/COPYRIGHT
new file mode 100644
index 0000000..8124c53
--- /dev/null
+++ b/doc/COPYRIGHT
@@ -0,0 +1,73 @@
+Unless specified otherwise in the "exceptions section" below:
+
+Copyright (C) 1997-2003 Sistina Software, Inc. All rights reserved.
+Copyright (C) 2004-2011 Red Hat, Inc. All rights reserved.
+
+Exceptions:
+
+fence/agents/hds_cb/*:
+ Copyright (C) 2012 Matthew Clark.
+ Author: Matthew Clark <mattjclark0407 at hotmail.com>
+
+fence/agents/xenapi/*:
+ Copyright (C) 2011 Matthew Clark.
+ Author: Matthew Clark <mattjclark0407 at hotmail.com>
+
+fence/agents/apc_snmp/powernet369.mib:
+ Copyright (c) 2005 American Power Conversion, Inc.
+ PowerNet is a Trademark of American Power Conversion Corp.
+
+fence/agents/eaton_snmp/fence_eaton_snmp.py:
+ Copyright (c) 2011 eaton.com
+ Author: Arnaud Quette <ArnaudQuette at Eaton.com>
+
+fence/agents/ifmib/fence_ifmib.py:
+ Copyright (C) 2008-2011 Ross Vandegrift.
+ Written by Ross Vandegrift <ross at kallisti.us>
+
+fence/agents/intelmodular/fence_intelmodular.pl:
+ Contributed by Matthew Kent <matt at bravenet.com>
+
+fence/agents/ipmilan/expect.{c,h}:
+ Copyright (C) 2000 Alan Robertson <alanr at unix.sh>
+
+fence/agents/node_assassin/*
+ Copyright (C) 2009-2011 Madison Kelly/Alteeve's Niche!
+ Author: Digimer <digimer at alteeve.com>
+
+fence/man/fence_ifmib.8:
+ Copyright (C) 2008-2011 Ross Vandegrift.
+ Written by Ross Vandegrift <ross at kallisti.us>
+
+Authors as known by current RCS as of the time of writing:
+
+Abhijith Das <adas at redhat.com>
+Adam Manthei <amanthei at redhat.com>
+A. J. Lewis <alewis at redhat.com>
+Alasdair G. Kergon <agk at redhat.com>
+Andrew Price <andy at andrewprice.me.uk>
+Benjamin Marzinski <bmarzins at redhat.com>
+Bob Peterson <rpeterso at redhat.com>
+Chris Feist <cfeist at redhat.com>
+Christine Caulfield <ccaulfie at redhat.com>
+Daniel Phillips <phillips at redhat.com>
+David Teigland <teigland at redhat.com>
+Fabio M. Di Nitto <fdinitto at redhat.com>
+James Parsons <jparsons at redhat.com>
+Joel Becker <joel.becker at oracle.com>
+Jonathan Brassow <jbrassow at redhat.com>
+jparsons <jparsons at redhat.com>
+Ken Preslan <kpreslan at redhat.com>
+Lon Hohberger <lhh at redhat.com>
+Marc - A. Dahlhaus <mad at wol.de>
+Marek 'marx' Grac <mgrac at redhat.com>
+Mark Hlawatschek <hlawatschek at atix.de>
+Michael Conrad Tadpol Tilstra <mtilstra at redhat.com>
+Patrick Caulfield <pcaulfie at redhat.com>
+Robert Peterson <rpeterso at redhat.com>
+Ross Vandegrift <ross at kallisti.us>
+Ryan McCabe <rmccabe at redhat.com>
+Ryan O'Hara <rohara at redhat.com>
+Stanko Kupcevic <kupcevic at redhat.com>
+Steven Whitehouse <swhiteho at redhat.com>
+Wendy Cheng <wcheng at redhat.com>
diff --git a/doc/Makefile.am b/doc/Makefile.am
new file mode 100644
index 0000000..13035fc
--- /dev/null
+++ b/doc/Makefile.am
@@ -0,0 +1,6 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+dist_doc_DATA = COPYING.applications \
+ COPYING.libraries \
+ COPYRIGHT \
+ README.licence
diff --git a/doc/README.licence b/doc/README.licence
new file mode 100644
index 0000000..075aa77
--- /dev/null
+++ b/doc/README.licence
@@ -0,0 +1,33 @@
+The Red Hat Cluster is a collection of free software built on top of different
+libraries and applications.
+
+For a detailed list of authors and copyright holders, please check the
+included COPYRIGHT file.
+
+Libraries:
+
+You can redistribute them and/or modify them under the terms of the GNU Lesser
+General Public License as published by the Free Software Foundation; either
+version 2.1 of the License, or (at your option) any later version.
+
+The libraries are distributed in the hope that they will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
+details.
+
+Applications:
+
+You can redistribute them and/or modify them under the terms of the GNU General
+Public License as published by the Free Software Foundation; either version
+2 of the License, or (at your option) any later version.
+
+The applications are distributed in the hope that they will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
+details.
+
+A copy of each license is included for your convenience in COPYING.applications
+and COPYING.libraries.
+
+If missing, write to the Free Software Foundation, Inc., 51 Franklin St,
+Fifth Floor, Boston, MA 02110-1301 USA.
diff --git a/fence/Makefile.am b/fence/Makefile.am
new file mode 100644
index 0000000..43fc1a0
--- /dev/null
+++ b/fence/Makefile.am
@@ -0,0 +1,3 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+SUBDIRS = agents
diff --git a/fence/agents/Makefile.am b/fence/agents/Makefile.am
new file mode 100644
index 0000000..c47f5d5
--- /dev/null
+++ b/fence/agents/Makefile.am
@@ -0,0 +1,4 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+SUBDIRS = lib \
+ $(AGENTS_LIST)
diff --git a/fence/agents/alom/Makefile.am b/fence/agents/alom/Makefile.am
new file mode 100644
index 0000000..972f8a9
--- /dev/null
+++ b/fence/agents/alom/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_alom
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/alom/fence_alom.py b/fence/agents/alom/fence_alom.py
new file mode 100644
index 0000000..ef2db3c
--- /dev/null
+++ b/fence/agents/alom/fence_alom.py
@@ -0,0 +1,65 @@
+#!/usr/bin/python
+
+# The Following Agent Has Been Tested On:
+#
+# Sun(tm) Advanced Lights Out Manager CMT v1.6.1
+# as found on SUN T2000 Niagara
+
+import sys, re, pexpect, time, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="Sun Advanced Lights Out Manager (ALOM)"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+def get_power_status(conn, options):
+ conn.send_eol("showplatform")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ status = re.search("standby", conn.before.lower())
+ result = (status != None and "off" or "on")
+
+ return result
+
+def set_power_status(conn, options):
+ cmd_line = (options["--action"] == "on" and "poweron" or "poweroff -f -y")
+ conn.send_eol(cmd_line)
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+ # Get the machine some time between poweron and poweroff
+ time.sleep(int(options["--power-timeout"]))
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "cmd_prompt", "secure" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["secure"]["default"] = "1"
+ all_opt["cmd_prompt"]["default"] = [ "sc\>\ " ]
+
+ options = check_input(device_opt, process_input(device_opt))
+ options["telnet_over_ssh"] = 1
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for Sun ALOM"
+ docs["longdesc"] = "fence_alom is an I/O Fencing \
+agent which can be used with ALOM connected machines."
+ docs["vendorurl"] = "http://www.sun.com"
+ show_docs(options, docs)
+
+ # Operate the fencing device
+ conn = fence_login(options)
+ result = fence_action(conn, options, set_power_status, get_power_status, None)
+
+ # Logout from system
+ try:
+ conn.send_eol("logout")
+ conn.close()
+ except:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/amt/Makefile.am b/fence/agents/amt/Makefile.am
new file mode 100644
index 0000000..9902731
--- /dev/null
+++ b/fence/agents/amt/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_amt
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/amt/fence_amt.py b/fence/agents/amt/fence_amt.py
new file mode 100644
index 0000000..81b8aec
--- /dev/null
+++ b/fence/agents/amt/fence_amt.py
@@ -0,0 +1,151 @@
+#!/usr/bin/python
+
+import sys, subprocess, re, os, stat
+from pipes import quote
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="Fence agent for Intel AMT"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+def get_power_status(_, options):
+
+ cmd = create_command(options, "status")
+
+ if options["log"] >= LOG_MODE_VERBOSE:
+ options["debug_fh"].write("executing: " + cmd + "\n")
+
+ try:
+ process = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, shell=True)
+ except OSError:
+ fail_usage("Amttool not found or not accessible")
+
+ process.wait()
+
+ output = process.communicate()
+ process.stdout.close()
+ options["debug_fh"].write(output)
+
+ match = re.search('Powerstate:[\\s]*(..)', str(output))
+ status = match.group(1) if match else None
+
+ if (status == None):
+ return "fail"
+ elif (status == "S0"): # SO = on; S3 = sleep; S5 = off
+ return "on"
+ else:
+ return "off"
+
+def set_power_status(_, options):
+
+ cmd = create_command(options, options["--action"])
+
+ if options["log"] >= LOG_MODE_VERBOSE:
+ options["debug_fh"].write("executing: " + cmd + "\n")
+
+ try:
+ process = subprocess.Popen(cmd, stdout=options["debug_fh"], stderr=options["debug_fh"], shell=True)
+ except OSError:
+ fail_usage("Amttool not found or not accessible")
+
+ process.wait()
+
+ return
+
+def reboot_cycle(_, options):
+ cmd = create_command(options, "cycle")
+
+ if options["log"] >= LOG_MODE_VERBOSE:
+ options["debug_fh"].write("executing: " + cmd + "\n")
+
+ try:
+ process = subprocess.Popen(cmd, stdout=options["debug_fh"], stderr=options["debug_fh"], shell=True)
+ except OSError:
+ fail_usage("Amttool not found or not accessible")
+
+ status = process.wait()
+
+ return not bool(status)
+
+def create_command(options, action):
+
+ # --password / -p
+ cmd = "AMT_PASSWORD=" + quote(options["--password"])
+
+ cmd += " " + options["--amttool-path"]
+
+ # --ip / -a
+ cmd += " " + options["--ip"]
+
+ # --action / -o
+ if action == "status":
+ cmd += " info"
+ elif action == "on":
+ cmd = "echo \"y\"|" + cmd
+ cmd += " powerup"
+ elif action == "off":
+ cmd = "echo \"y\"|" + cmd
+ cmd += " powerdown"
+ elif action == "cycle":
+ cmd = "echo \"y\"|" + cmd
+ cmd += " powercycle"
+ if action in ["on", "off", "cycle"] and options.has_key("--boot-option"):
+ cmd += options["--boot-option"]
+
+ # --use-sudo / -d
+ if options.has_key("--use-sudo"):
+ cmd = SUDO_PATH + " " + cmd
+
+ return cmd
+
+def define_new_opts():
+ all_opt["boot_option"] = {
+ "getopt" : "b:",
+ "longopt" : "boot-option",
+ "help" : "-b, --boot-option=[option] Change the default boot behavior of the machine. (pxe|hd|hdsafe|cd|diag)",
+ "required" : "0",
+ "shortdesc" : "Change the default boot behavior of the machine.",
+ "choices" : ["pxe", "hd", "hdsafe", "cd", "diag"],
+ "order" : 1
+ }
+ all_opt["amttool_path"] = {
+ "getopt" : "i:",
+ "longopt" : "amttool-path",
+ "help" : "--amttool-path=[path] Path to amttool binary",
+ "required" : "0",
+ "shortdesc" : "Path to amttool binary",
+ "default" : "@AMTTOOL_PATH@",
+ "order": 200
+ }
+
+def main():
+
+ atexit.register(atexit_handler)
+
+ device_opt = [ "ipaddr", "no_login", "passwd", "boot_option", "no_port",
+ "sudo", "amttool_path", "method" ]
+
+ define_new_opts()
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for AMT"
+ docs["longdesc"] = "fence_amt is an I/O Fencing agent \
+which can be used with Intel AMT. This agent calls support software amttool\
+(http://www.kraxel.org/cgit/amtterm/)."
+ docs["vendorurl"] = "http://www.intel.com/"
+ show_docs(options, docs)
+
+ if not is_executable(options["--amttool-path"]):
+ fail_usage("Amttool not found or not accessible")
+
+ result = fence_action(None, options, set_power_status, get_power_status, None, reboot_cycle)
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/apc/Makefile.am b/fence/agents/apc/Makefile.am
new file mode 100644
index 0000000..355c873
--- /dev/null
+++ b/fence/agents/apc/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_apc
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/apc/fence_apc.py b/fence/agents/apc/fence_apc.py
new file mode 100644
index 0000000..24ab5ee
--- /dev/null
+++ b/fence/agents/apc/fence_apc.py
@@ -0,0 +1,268 @@
+#!/usr/bin/python
+
+#####
+##
+## The Following Agent Has Been Tested On:
+##
+## Model Firmware
+## +---------------------------------------------+
+## AP7951 AOS v2.7.0, PDU APP v2.7.3
+## AP7941 AOS v3.5.7, PDU APP v3.5.6
+## AP9606 AOS v2.5.4, PDU APP v2.7.3
+##
+## @note: ssh is very slow on AP79XX devices protocol (1) and
+## cipher (des/blowfish) have to be defined
+#####
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="New APC Agent - test release on steroids"
+REDHAT_COPYRIGHT=""
+BUILD_DATE="March, 2008"
+#END_VERSION_GENERATION
+
+def get_power_status(conn, options):
+ exp_result = 0
+ outlets = {}
+
+ conn.send_eol("1")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ version = 0
+ admin = 0
+ switch = 0
+
+ if (None != re.compile('.* MasterSwitch plus.*', re.IGNORECASE | re.S).match(conn.before)):
+ switch = 1
+ if (None != re.compile('.* MasterSwitch plus 2', re.IGNORECASE | re.S).match(conn.before)):
+ if (0 == options.has_key("--switch")):
+ fail_usage("Failed: You have to enter physical switch number")
+ else:
+ if (0 == options.has_key("--switch")):
+ options["--switch"] = "1"
+
+ if (None == re.compile('.*Outlet Management.*', re.IGNORECASE | re.S).match(conn.before)):
+ version = 2
+ else:
+ version = 3
+
+ if (None == re.compile('.*Outlet Control/Configuration.*', re.IGNORECASE | re.S).match(conn.before)):
+ admin = 0
+ else:
+ admin = 1
+
+ if switch == 0:
+ if version == 2:
+ if admin == 0:
+ conn.send_eol("2")
+ else:
+ conn.send_eol("3")
+ else:
+ conn.send_eol("2")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ conn.send_eol("1")
+ else:
+ conn.send_eol(options["--switch"])
+
+ while True:
+ exp_result = conn.log_expect(options, ["Press <ENTER>" ] + options["--command-prompt"], int(options["--shell-timeout"]))
+ lines = conn.before.split("\n")
+ show_re = re.compile('(^|\x0D)\s*(\d+)- (.*?)\s+(ON|OFF)\s*')
+ for x in lines:
+ res = show_re.search(x)
+ if (res != None):
+ outlets[res.group(2)] = (res.group(3), res.group(4))
+ conn.send_eol("")
+ if exp_result != 0:
+ break
+ conn.send(chr(03))
+ conn.log_expect(options, "- Logout", int(options["--shell-timeout"]))
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ if ["list", "monitor"].count(options["--action"]) == 1:
+ return outlets
+ else:
+ try:
+ (_, status) = outlets[options["--plug"]]
+ return status.lower().strip()
+ except KeyError:
+ fail(EC_STATUS)
+
+def set_power_status(conn, options):
+ action = {
+ 'on' : "1",
+ 'off': "2"
+ }[options["--action"]]
+
+ conn.send_eol("1")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ version = 0
+ admin2 = 0
+ admin3 = 0
+ switch = 0
+
+ if (None != re.compile('.* MasterSwitch plus.*', re.IGNORECASE | re.S).match(conn.before)):
+ switch = 1
+ ## MasterSwitch has different schema for on/off actions
+ action = {
+ 'on' : "1",
+ 'off': "3"
+ }[options["--action"]]
+ if (None != re.compile('.* MasterSwitch plus 2', re.IGNORECASE | re.S).match(conn.before)):
+ if (0 == options.has_key("--switch")):
+ fail_usage("Failed: You have to enter physical switch number")
+ else:
+ if (0 == options.has_key("--switch")):
+ options["--switch"] = 1
+
+ if (None == re.compile('.*Outlet Management.*', re.IGNORECASE | re.S).match(conn.before)):
+ version = 2
+ else:
+ version = 3
+
+ if (None == re.compile('.*Outlet Control/Configuration.*', re.IGNORECASE | re.S).match(conn.before)):
+ admin2 = 0
+ else:
+ admin2 = 1
+
+ if switch == 0:
+ if version == 2:
+ if admin2 == 0:
+ conn.send_eol("2")
+ else:
+ conn.send_eol("3")
+ else:
+ conn.send_eol("2")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ if (None == re.compile('.*2- Outlet Restriction.*', re.IGNORECASE | re.S).match(conn.before)):
+ admin3 = 0
+ else:
+ admin3 = 1
+ conn.send_eol("1")
+ else:
+ conn.send_eol(options["--switch"])
+
+ while 0 == conn.log_expect(options, [ "Press <ENTER>" ] + options["--command-prompt"], int(options["--shell-timeout"])):
+ conn.send_eol("")
+
+ conn.send_eol(options["--plug"]+"")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ if switch == 0:
+ if admin2 == 1:
+ conn.send_eol("1")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ if admin3 == 1:
+ conn.send_eol("1")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ else:
+ conn.send_eol("1")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ conn.send_eol(action)
+ conn.log_expect(options, "Enter 'YES' to continue or <ENTER> to cancel :", int(options["--shell-timeout"]))
+ conn.send_eol("YES")
+ conn.log_expect(options, "Press <ENTER> to continue...", int(options["--shell-timeout"]))
+ conn.send_eol("")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ conn.send(chr(03))
+ conn.log_expect(options, "- Logout", int(options["--shell-timeout"]))
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+def get_power_status5(conn, options):
+ exp_result = 0
+ outlets = {}
+
+ conn.send_eol("olStatus all")
+
+ exp_result = conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ lines = conn.before.split("\n")
+
+ show_re = re.compile('^\s*(\d+): (.*): (On|Off)\s*$', re.IGNORECASE)
+
+ for x in lines:
+ res = show_re.search(x)
+ if (res != None):
+ outlets[res.group(1)] = (res.group(2), res.group(3))
+
+ if ["list", "monitor"].count(options["--action"]) == 1:
+ return outlets
+ else:
+ try:
+ (_, status) = outlets[options["--plug"]]
+ return status.lower().strip()
+ except KeyError:
+ fail(EC_STATUS)
+
+def set_power_status5(conn, options):
+ action = {
+ 'on' : "olOn",
+ 'off': "olOff"
+ }[options["--action"]]
+
+ conn.send_eol(action + " " + options["--plug"])
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "cmd_prompt", "secure", \
+ "port", "switch" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["cmd_prompt"]["default"] = [ "\n>", "\napc>" ]
+ all_opt["ssh_options"]["default"] = "-1 -c blowfish"
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for APC over telnet/ssh"
+ docs["longdesc"] = "fence_apc is an I/O Fencing agent \
+which can be used with the APC network power switch. It logs into device \
+via telnet/ssh and reboots a specified outlet. Lengthy telnet/ssh connections \
+should be avoided while a GFS cluster is running because the connection \
+will block any necessary fencing actions."
+ docs["vendorurl"] = "http://www.apc.com"
+ show_docs(options, docs)
+
+ ## Support for --plug [switch]:[plug] notation that was used before
+ if (options.has_key("--plug") == 1) and (-1 != options["--plug"].find(":")):
+ (switch, plug) = options["--plug"].split(":", 1)
+ options["--switch"] = switch
+ options["--plug"] = plug
+
+ ##
+ ## Operate the fencing device
+ ####
+ conn = fence_login(options)
+
+ ## Detect firmware version (ASCII menu vs command-line interface)
+ ## and continue with proper action
+ ####
+ result = -1
+ firmware_version = re.compile('\s*v(\d)*\.').search(conn.before)
+ if (firmware_version != None) and (firmware_version.group(1) == "5"):
+ result = fence_action(conn, options, set_power_status5, get_power_status5, get_power_status5)
+ else:
+ result = fence_action(conn, options, set_power_status, get_power_status, get_power_status)
+
+ ##
+ ## Logout from system
+ ##
+ ## In some special unspecified cases it is possible that
+ ## connection will be closed before we run close(). This is not
+ ## a problem because everything is checked before.
+ ######
+ try:
+ conn.send_eol("4")
+ conn.close()
+ except:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/apc_snmp/Makefile.am b/fence/agents/apc_snmp/Makefile.am
new file mode 100644
index 0000000..65c24fd
--- /dev/null
+++ b/fence/agents/apc_snmp/Makefile.am
@@ -0,0 +1,19 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_apc_snmp
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC) \
+ powernet369.mib \
+ README
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/apc_snmp/README b/fence/agents/apc_snmp/README
new file mode 100644
index 0000000..75aa37a
--- /dev/null
+++ b/fence/agents/apc_snmp/README
@@ -0,0 +1,45 @@
+This is an snmp based fence agent for APC power switches to be used
+with RHEL4 Red Hat Cluster Suite.
+
+The reasons to use this agent rather than the current fence_apc agent are:
+1) This script has been tested with EVERY powerswitch that APC currently
+makes.
+2) It will work on many older models that are no longer supported by APC.
+I have been told that it even works with the AP9200 switch. Older switches
+usually don't do well with the fence_apc script.
+3) This agent works with large power switches that have more than 8 outlets.
+The fence_apc script will also, in the next update -- this script will work for you now.
+
+If feedback on this beta version of the agent is good, and if ganged switches
+can be supported, then this agent may replace fence_apc.
+
+In order to use this agent, you will need to have net-snmp-utils installed
+on every node in your cluster. net-snmp-utils is scheduled for inclusion
+in the base RHEL distribution for Update 4, and is yummable in FC5.
+
+After net-snmp-utils is installed, there will be a directory named:
+/usr/share/snmp/mibs/
+
+Place the accompanying powernet369.mib file in this directory.
+
+To use the agent, cp the agent to the /sbin directory on every
+cluster node. The interface for the fence_apc_snmp agent is identical to
+the existing fence_apc agent, so if you are using APC for fencing in
+your cluster, you *could* backup your current fence_apc agent, and
+rename this agent from fence_apc_snmp to fence_apc, and it should just work.
+
+NOTE: The fence_apc_snmp agent does not yet support ganged or 'daisy-chained'
+APC switches.
+
+If you would rather not copy over your fence_apc agent, you can still use
+the fence_apc_snmp agent by dropping it into /sbin on every node, and then
+defining a <fencedevice> in the cluster.conf file with agent="fence_apc_snmp"
+as an attribute, and use it that way. Note, please, that the GUI does
+not support this agent yet, and you will have to edit your cluster.conf
+by hand and then propagate it yourself. If you need help with this, email
+me on linux-cluster or at the address below.
+
+Big thanks to Nate Straz who laid the foundation for this agent.
+
+Please let me know how this agent works.
+--Jim Parsons - jparsons at redhat.com
diff --git a/fence/agents/apc_snmp/fence_apc_snmp.py b/fence/agents/apc_snmp/fence_apc_snmp.py
new file mode 100644
index 0000000..da02066
--- /dev/null
+++ b/fence/agents/apc_snmp/fence_apc_snmp.py
@@ -0,0 +1,209 @@
+#!/usr/bin/python
+
+# The Following agent has been tested on:
+# - APC Switched Rack PDU (MB:v3.7.0 PF:v2.7.0 PN:apc_hw02_aos_270.bin AF1:v2.7.3 AN1:apc_hw02_aos_270.bin
+# AF1:v2.7.3 AN1:apc_hw02_rpdu_273.bin MN:AP7930 HR:B2) - SNMP v1
+# - APC Web/SNMP Management Card (MB:v3.8.6 PF:v3.5.8 PN:apc_hw02_aos_358.bin AF1:v3.5.7 AN1:apc_hw02_aos_358.bin
+# AF1:v3.5.7 AN1:apc_hw02_rpdu_357.bin MN:AP7900 HR:B2) - SNMP v1 and v3 (noAuthNoPrivacy,authNoPrivacy, authPrivacy)
+# - APC Switched Rack PDU (MB:v3.7.0 PF:v2.7.0 PN:apc_hw02_aos_270.bin AF1:v2.7.3 AN1:apc_hw02_rpdu_273.bin
+# MN:AP7951 HR:B2) - SNMP v1
+# - Tripplite PDUMH20HVNET 12.04.0055 - SNMP v1, v2c, v3
+
+import sys
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+from fencing_snmp import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="APC SNMP fence agent"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+### CONSTANTS ###
+# oid defining fence device
+OID_SYS_OBJECT_ID = '.1.3.6.1.2.1.1.2.0'
+
+### GLOBAL VARIABLES ###
+# Device - see ApcRPDU, ApcMSP, ApcMS, TripplitePDU
+device = None
+
+# Port ID
+port_id = None
+# Switch ID
+switch_id = None
+
+# Classes describing Device params
+class TripplitePDU:
+ # Rack PDU
+ status_oid= '.1.3.6.1.4.1.850.10.2.3.5.1.2.1.%d'
+ control_oid= '.1.3.6.1.4.1.850.10.2.3.5.1.4.1.%d'
+ outlet_table_oid='.1.3.6.1.4.1.850.10.2.3.5.1.5'
+ ident_str="Tripplite"
+ state_on=2
+ state_off=1
+ turn_on=2
+ turn_off=1
+ has_switches=False
+
+class ApcRPDU:
+ # Rack PDU
+ status_oid = '.1.3.6.1.4.1.318.1.1.12.3.5.1.1.4.%d'
+ control_oid = '.1.3.6.1.4.1.318.1.1.12.3.3.1.1.4.%d'
+ outlet_table_oid = '.1.3.6.1.4.1.318.1.1.12.3.5.1.1.2'
+ ident_str = "APC rPDU"
+ state_on = 1
+ state_off = 2
+ turn_on = 1
+ turn_off = 2
+ has_switches = False
+
+class ApcMSP:
+ # Master Switch+
+ status_oid = '.1.3.6.1.4.1.318.1.1.6.7.1.1.5.%d.1.%d'
+ control_oid = '.1.3.6.1.4.1.318.1.1.6.5.1.1.5.%d.1.%d'
+ outlet_table_oid = '.1.3.6.1.4.1.318.1.1.6.7.1.1.4'
+ ident_str = "APC Master Switch+"
+ state_on = 1
+ state_off = 2
+ turn_on = 1
+ turn_off = 3
+ has_switches = True
+
+class ApcMS:
+ # Master Switch - seems oldest, but supported on every APC PDU
+ status_oid = '.1.3.6.1.4.1.318.1.1.4.4.2.1.3.%d'
+ control_oid = '.1.3.6.1.4.1.318.1.1.4.4.2.1.3.%d'
+ outlet_table_oid = '.1.3.6.1.4.1.318.1.1.4.4.2.1.4'
+ ident_str = "APC Master Switch (fallback)"
+ state_on = 1
+ state_off = 2
+ turn_on = 1
+ turn_off = 2
+ has_switches = False
+
+### FUNCTIONS ###
+def apc_set_device(conn, options):
+ global device
+
+ agents_dir = {'.1.3.6.1.4.1.318.1.3.4.5':ApcRPDU,
+ '.1.3.6.1.4.1.318.1.3.4.4':ApcMSP,
+ '.1.3.6.1.4.1.850.1':TripplitePDU,
+ None:ApcMS}
+
+ # First resolve type of APC
+ apc_type = conn.walk(OID_SYS_OBJECT_ID)
+
+ if (not ((len(apc_type)==1) and (agents_dir.has_key(apc_type[0][1])))):
+ apc_type = [[None, None]]
+
+ device = agents_dir[apc_type[0][1]]
+
+ conn.log_command("Trying %s"%(device.ident_str))
+
+def apc_resolv_port_id(conn, options):
+ global port_id, switch_id
+
+ if (device == None):
+ apc_set_device(conn, options)
+
+ # Now we resolv port_id/switch_id
+ if ((options["--plug"].isdigit()) and ((not device.has_switches) or (options["--switch"].isdigit()))):
+ port_id = int(options["--plug"])
+
+ if (device.has_switches):
+ switch_id = int(options["--switch"])
+ else:
+ table = conn.walk(device.outlet_table_oid, 30)
+
+ for x in table:
+ if (x[1].strip('"') == options["--plug"]):
+ t = x[0].split('.')
+ if (device.has_switches):
+ port_id = int(t[len(t)-1])
+ switch_id = int(t[len(t)-3])
+ else:
+ port_id = int(t[len(t)-1])
+
+ if (port_id == None):
+ fail_usage("Can't find port with name %s!"%(options["--plug"]))
+
+def get_power_status(conn, options):
+ if (port_id == None):
+ apc_resolv_port_id(conn, options)
+
+ oid = ((device.has_switches) and device.status_oid%(switch_id, port_id) or device.status_oid%(port_id))
+
+ (oid, status) = conn.get(oid)
+ return (status==str(device.state_on) and "on" or "off")
+
+def set_power_status(conn, options):
+ if (port_id == None):
+ apc_resolv_port_id(conn, options)
+
+ oid = ((device.has_switches) and device.control_oid%(switch_id, port_id) or device.control_oid%(port_id))
+
+ conn.set(oid, (options["--action"]=="on" and device.turn_on or device.turn_off))
+
+
+def get_outlets_status(conn, options):
+ result = {}
+
+ if (device == None):
+ apc_set_device(conn, options)
+
+ res_ports = conn.walk(device.outlet_table_oid, 30)
+
+ for x in res_ports:
+ t = x[0].split('.')
+
+ port_num = ((device.has_switches) and "%s:%s"%(t[len(t)-3], t[len(t)-1]) or "%s"%(t[len(t)-1]))
+
+ port_name = x[1].strip('"')
+ port_status = ""
+ result[port_num] = (port_name, port_status)
+
+ return result
+
+# Define new options
+def apc_snmp_define_defaults():
+ all_opt["snmp_version"]["default"] = "1"
+ all_opt["community"]["default"] = "private"
+
+# Main agent method
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "no_login", "no_password", \
+ "port", "snmp_version", "community" ]
+
+ atexit.register(atexit_handler)
+
+ snmp_define_defaults ()
+ apc_snmp_define_defaults()
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ ## Support for -n [switch]:[plug] notation that was used before
+ if ((options.has_key("--plug")) and (-1 != options["--plug"].find(":"))):
+ (switch, plug) = options["--plug"].split(":", 1)
+ if ((switch.isdigit()) and (plug.isdigit())):
+ options["--switch"] = switch
+ options["--plug"] = plug
+
+ if (not (options.has_key("--switch"))):
+ options["--switch"] = "1"
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for APC, Tripplite PDU over SNMP"
+ docs["longdesc"] = "fence_apc_snmp is an I/O Fencing agent \
+which can be used with the APC network power switch or Tripplite PDU devices.\
+It logs into a device via SNMP and reboots a specified outlet. It supports \
+SNMP v1, v2c, v3 with all combinations of authenticity/privacy settings."
+ docs["vendorurl"] = "http://www.apc.com"
+ show_docs(options, docs)
+
+ # Operate the fencing device
+ result = fence_action(FencingSnmp(options), options, set_power_status, get_power_status, get_outlets_status)
+
+ sys.exit(result)
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/apc_snmp/powernet369.mib b/fence/agents/apc_snmp/powernet369.mib
new file mode 100644
index 0000000..ab948f8
--- /dev/null
+++ b/fence/agents/apc_snmp/powernet369.mib
@@ -0,0 +1,31109 @@
+-- *************************************************************************
+-- AMERICAN POWER CONVERSION PowerNet-MIB
+-- *************************************************************************
+-- Copyright (c) 2005 American Power Conversion, Inc.
+-- PowerNet is a Trademark of American Power Conversion Corp.
+--
+-- Title: APC TOP LEVEL PowerNet MIB
+--
+-- Version : 3.6.9
+--
+-- Generated by script: tomib.awk
+--
+-- Input File: powernetPS.mib
+--
+-- Created: Wednesday, January, 26, 2005
+--
+-- Revision History:
+-- *************************************************************************
+
+-- - v3.2.0 Added functionality for MasterSwitch Plus
+-- - v3.3.0 Added functionality for MX28B (dcDM3) and 3-phase UPS
+-- - v3.3.2 New traps for Symmetra PX UPS
+-- 07/15/01 - v3.4.0 Added transfer switch
+-- - v3.4.3 Added functionality for External and Integrated Environmental Monitor
+-- 06/14/02 - v3.4.4 Added dcmim2(Siemens) branch, Battery Manager(Reading) traps, and
+-- Psx Traps for PDU and RM-PDU and Netlock branch/traps
+-- 06/18/02 - v3.5.0a Sync Control Group support
+-- 08/06/02 - v3.5.0a Environmental Management System branch/traps
+-- 09/16/02 - v3.5.0b Fixed some odds/ends ... going to RM-PDU for MS additions
+-- 09/25/02 - v3.5.0c MS3 additions
+-- 11/05/02 - v3.5.0e More Environmental Management System/A-Link devices(ARU)
+-- 11/22/02 - v3.5.0g Added General APC device status OID
+-- 11/27/02 - v3.5.0h Wrapped up MS3 ((Controlled or Metered) Rack PDU) changes
+-- 12/26/02 - v3.5.1a Changed MS3 name again, Controlled to Switched Rack PDU
+-- 01/07/03 - v3.6.0a Added OIDs/Traps for UPS Switchable Outlet Groups.
+-- 01/09/03 - Adding the General APC device discovery OIDs (hidden)
+-- 01/28/03 - v3.6.0c Made some small trap pair fixes for Switched Rack PDU (MS3)
+-- 02/13/03 - v3.6.0d Mods from the review and some EMS fixes.
+-- Added OID for the new 20kVA Symmetra 3 Phase type.
+-- Added OIDs to upsAdvConfig for Symmetra type UPSs.
+-- Added upsDiagnostics branch OID for Symmetra module information.
+-- 04/05/03 - v3.6.2 Added OID for the new Smart-UPS 7500 and 10000 types.
+-- 06/04/03 - v3.6.3 Added OIDs/Traps for AirFM.
+-- 06/24/03 - v3.6.4 Moved some AirFM temps and humidities from system level to module level.
+-- 10/24/03 - v3.6.4a Added OIDs/Traps for xPDU.
+-- 10/27/03 - v3.6.4f Added AirPA OIDs.
+-- 11/03/03 - v3.6.4g Merge of 3.6.4e and 3.6.4f
+-- 11/07/03 - v3.6.4h Additional review corrections
+-- 12/01/03 - v3.6.5a Added group OIDs for Air FM. Added C & F OIDs for Air PA setpoint.
+-- 12/19/03 - v3.6.5b Review corrections.
+-- 02/23/04 - v3.6.5c Added Modbus to experimental and multiple CB(bank) rPDU support
+-- 05/05/04 - v3.6.6 Adding EMS status OID and trap for H/W issues, redefined duplicate
+-- trap #228 (to ARU Device config change) and minor clean-up
+-- 05/12/04 - v3.6.7a Added Air FM alarm status OIDs.
+-- 06/03/04 - v3.6.7b Added UPS Config for Simple Signal Shutdowns and Number of External
+-- batteries. Added Mute option to the UPS Config Audible Alarm.
+-- 07/12/04 - v3.6.7d Removed Air FM alarm status OIDs due to delay in release.
+-- 07/14/04 - v3.6.7d Added a detailed description to the UPSAdvConfigAlarm OID
+-- 07/14/04 - v3.6.7e Added Custom Event traps
+-- 08/04/04 - v3.6.7 Tag for final builds, see v3.6.7 beta build notes for changes
+-- 08/26/04 - v3.6.8a Added new traps for UPS internal over temperature fault and cleared.
+-- 09/01/04 - v3.6.8b Adding new thresholds for EMS probe config & status
+-- 09/08/04 - v3.6.8c Corrections from MIB review.
+-- 09/30/04 - v3.6.8d Added new traps for AIS ^F Message events.
+-- 10/21/04 - v3.6.8e EMS. Added missing traps and new Rate functionality.
+-- 10/22/04 - v3.6.8f Added resetNetworkLeaveModeAndRestart option to the mcontrolRestartAgent OID.
+-- 10/28/04 - v3.6.8g Updated EMS sections from mib committee review.
+-- 11/22/04 - v3.6.8 Tag for final build.
+-- 12/02/04 - v3.6.9a Added OIDs and traps for BMS-HVA.
+-- 12/20/04 - v3.6.9c corrections to xPDU.
+-- 12/20/04 - v3.6.9c added OIDs and traps for xATS.
+-- 01/03/05 - v3.6.9d removed traps for xATS.
+-- 01/03/05 - v3.6.9e correction to xATS entries, that removed underscores (mib browser incompatibility)
+-- 01/07/05 - v3.6.9f
+-- 01/14/05 - v3.6.9g add xPDU OIDs and traps and some corrections.
+-- 01/14/05 - v3.6.9g modifications to xATS OIDs and traps.
+
+-- *************************************************************************
+-- *************************************************************************
+-- PowerNet-MIB { iso org(3) dod(6) internet(1) private(4)
+-- enterprises(1) apc(318) }
+
+PowerNet-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+ enterprises, IpAddress, Gauge, TimeTicks FROM RFC1155-SMI
+ DisplayString FROM RFC1213-MIB
+ OBJECT-TYPE FROM RFC-1212
+ TRAP-TYPE FROM RFC-1215;
+
+apc OBJECT IDENTIFIER ::= { enterprises 318 }
+
+products OBJECT IDENTIFIER ::= { apc 1 }
+apcmgmt OBJECT IDENTIFIER ::= { apc 2 }
+
+hardware OBJECT IDENTIFIER ::= { products 1 }
+software OBJECT IDENTIFIER ::= { products 2 }
+system OBJECT IDENTIFIER ::= { products 3 }
+experimental OBJECT IDENTIFIER ::= { products 4 }
+
+mconfig OBJECT IDENTIFIER ::= { apcmgmt 1 }
+mcontrol OBJECT IDENTIFIER ::= { apcmgmt 2 }
+mtrapargs OBJECT IDENTIFIER ::= { apcmgmt 3 }
+mfiletransfer OBJECT IDENTIFIER ::= { apcmgmt 4 }
+
+mconfigClock OBJECT IDENTIFIER ::= { mconfig 6 }
+
+mfiletransferStatus OBJECT IDENTIFIER ::= { mfiletransfer 1 }
+mfiletransferConfig OBJECT IDENTIFIER ::= { mfiletransfer 2 }
+mfiletransferControl OBJECT IDENTIFIER ::= { mfiletransfer 3 }
+
+mfiletransferConfigSettings OBJECT IDENTIFIER ::= { mfiletransferConfig 1 }
+mfiletransferConfigTFTP OBJECT IDENTIFIER ::= { mfiletransferConfig 2 }
+mfiletransferConfigFTP OBJECT IDENTIFIER ::= { mfiletransferConfig 3 }
+
+ups OBJECT IDENTIFIER ::= { hardware 1 }
+measureUps OBJECT IDENTIFIER ::= { hardware 2 }
+miniSNMPadapter OBJECT IDENTIFIER ::= { hardware 3 }
+masterswitch OBJECT IDENTIFIER ::= { hardware 4 }
+masterswitchVM OBJECT IDENTIFIER ::= { hardware 5 }
+masterswitchMSP OBJECT IDENTIFIER ::= { hardware 6 }
+dcDM3 OBJECT IDENTIFIER ::= { hardware 7 }
+automaticTransferSwitch OBJECT IDENTIFIER ::= { hardware 8 }
+dc2 OBJECT IDENTIFIER ::= { hardware 9 }
+environmentalMonitor OBJECT IDENTIFIER ::= { hardware 10 }
+netlock OBJECT IDENTIFIER ::= { hardware 11 }
+rPDU OBJECT IDENTIFIER ::= { hardware 12 }
+airConditioners OBJECT IDENTIFIER ::= { hardware 13 }
+rARU OBJECT IDENTIFIER ::= { hardware 14 }
+xPDU OBJECT IDENTIFIER ::= { hardware 15 }
+battMan OBJECT IDENTIFIER ::= { hardware 16 }
+xATS OBJECT IDENTIFIER ::= { hardware 17 }
+generator OBJECT IDENTIFIER ::= { hardware 18 }
+
+powerNetSubAgent OBJECT IDENTIFIER ::= { software 1 }
+
+powerNetSoftwareSystem OBJECT IDENTIFIER ::= { powerNetSubAgent 1 }
+powerNetSoftwareConfig OBJECT IDENTIFIER ::= { powerNetSubAgent 2 }
+
+backUPS OBJECT IDENTIFIER ::= { system 1 }
+smartUPS OBJECT IDENTIFIER ::= { system 2 }
+matrixUPS OBJECT IDENTIFIER ::= { system 3 }
+masterSwitch OBJECT IDENTIFIER ::= { system 4 }
+symmetraUPS OBJECT IDENTIFIER ::= { system 5 }
+dp100E OBJECT IDENTIFIER ::= { system 6 }
+dp300E OBJECT IDENTIFIER ::= { system 7 }
+monitors OBJECT IDENTIFIER ::= { system 8 }
+redundantSwitch OBJECT IDENTIFIER ::= { system 9 }
+dcPower OBJECT IDENTIFIER ::= { system 10 }
+automaticXferSwitch OBJECT IDENTIFIER ::= { system 11 }
+netLock OBJECT IDENTIFIER ::= { system 12 }
+symmetra3PhaseUPS OBJECT IDENTIFIER ::= { system 13 }
+networkAir OBJECT IDENTIFIER ::= { system 14 }
+infraXurePDU OBJECT IDENTIFIER ::= { system 15 }
+ais5000UPS OBJECT IDENTIFIER ::= { system 16 }
+smartUPS3Phase OBJECT IDENTIFIER ::= { system 17 }
+battManager OBJECT IDENTIFIER ::= { system 18 }
+infraXureATS OBJECT IDENTIFIER ::= { system 19 }
+
+battManIdent OBJECT IDENTIFIER ::= { battMan 1 }
+battManSystemCalib OBJECT IDENTIFIER ::= { battMan 2 }
+battManUnitCalib OBJECT IDENTIFIER ::= { battMan 3 }
+battManStringCalib OBJECT IDENTIFIER ::= { battMan 4 }
+battManBatteryCalib OBJECT IDENTIFIER ::= { battMan 5 }
+battManConfig OBJECT IDENTIFIER ::= { battMan 6 }
+battManAlarm OBJECT IDENTIFIER ::= { battMan 7 }
+battManSystemStatus OBJECT IDENTIFIER ::= { battMan 8 }
+battManStringStatus OBJECT IDENTIFIER ::= { battMan 9 }
+battManBatteryStatus OBJECT IDENTIFIER ::= { battMan 10 }
+battManInputContactStatus OBJECT IDENTIFIER ::= { battMan 11 }
+battManControl OBJECT IDENTIFIER ::= { battMan 12 }
+battManTestResults OBJECT IDENTIFIER ::= { battMan 13 }
+
+xPDUIdent OBJECT IDENTIFIER ::= { xPDU 1 }
+xPDUDevice OBJECT IDENTIFIER ::= { xPDU 2 }
+xPDUACMonitoringPoint OBJECT IDENTIFIER ::= { xPDU 3 }
+xPDUCircuitBreakers OBJECT IDENTIFIER ::= { xPDU 4 }
+xPDUInputContacts OBJECT IDENTIFIER ::= { xPDU 5 }
+xPDUOutputRelays OBJECT IDENTIFIER ::= { xPDU 6 }
+xPDUMiscGroup OBJECT IDENTIFIER ::= { xPDU 7 }
+
+xPDUMainInput OBJECT IDENTIFIER ::= { xPDUACMonitoringPoint 1 }
+xPDUBypassInput OBJECT IDENTIFIER ::= { xPDUACMonitoringPoint 2 }
+xPDUUPSInput OBJECT IDENTIFIER ::= { xPDUACMonitoringPoint 3 }
+xPDUSystemOutput OBJECT IDENTIFIER ::= { xPDUACMonitoringPoint 4 }
+xPDUGroundMonitorPoint OBJECT IDENTIFIER ::= { xPDUACMonitoringPoint 5 }
+
+xPDUSystemBreakers OBJECT IDENTIFIER ::= { xPDUCircuitBreakers 1 }
+xPDUBranchBreakers OBJECT IDENTIFIER ::= { xPDUCircuitBreakers 2 }
+
+xATSIdent OBJECT IDENTIFIER ::= { xATS 1 }
+xATSDevice OBJECT IDENTIFIER ::= { xATS 2 }
+xATSSwitch OBJECT IDENTIFIER ::= { xATS 3 }
+xATSACMonitoringPoint OBJECT IDENTIFIER ::= { xATS 4 }
+xATSTesting OBJECT IDENTIFIER ::= { xATS 5 }
+xATSInputContacts OBJECT IDENTIFIER ::= { xATS 6 }
+xATSOutputRelays OBJECT IDENTIFIER ::= { xATS 7 }
+xATSMisc OBJECT IDENTIFIER ::= { xATS 8 }
+
+xATSSwitchStatus OBJECT IDENTIFIER ::= { xATSSwitch 1 }
+xATSSwitchSettings OBJECT IDENTIFIER ::= { xATSSwitch 2 }
+xATSSwitchTimers OBJECT IDENTIFIER ::= { xATSSwitch 3 }
+xATSSwitchBlockMap OBJECT IDENTIFIER ::= { xATSSwitch 4 }
+xATSSwitchStatistics OBJECT IDENTIFIER ::= { xATSSwitch 5 }
+
+xATSSource1 OBJECT IDENTIFIER ::= { xATSACMonitoringPoint 1 }
+xATSSource2 OBJECT IDENTIFIER ::= { xATSACMonitoringPoint 2 }
+xATSSystemOutput OBJECT IDENTIFIER ::= { xATSACMonitoringPoint 3 }
+
+xATSTestingStatus OBJECT IDENTIFIER ::= { xATSTesting 1 }
+xATSTestingResults OBJECT IDENTIFIER ::= { xATSTesting 2 }
+xATSTestingSchedule OBJECT IDENTIFIER ::= { xATSTesting 3 }
+xATSTestingSimulatePowerFail OBJECT IDENTIFIER ::= { xATSTesting 4 }
+
+xATSGenerator OBJECT IDENTIFIER ::= { generator 1 }
+
+xATSGeneratorIdent OBJECT IDENTIFIER ::= { xATSGenerator 1 }
+xATSGeneratorStatus OBJECT IDENTIFIER ::= { xATSGenerator 2 }
+xATSGeneratorAdvStatus OBJECT IDENTIFIER ::= { xATSGenerator 3 }
+xATSGeneratorOutput OBJECT IDENTIFIER ::= { xATSGenerator 4 }
+xATSGeneratorSettings OBJECT IDENTIFIER ::= { xATSGenerator 5 }
+xATSGeneratorService OBJECT IDENTIFIER ::= { xATSGenerator 6 }
+xATSGeneratorFuelSystem OBJECT IDENTIFIER ::= { xATSGenerator 7 }
+
+
+smartUPS250 OBJECT IDENTIFIER ::= { smartUPS 1 }
+smartUPS400 OBJECT IDENTIFIER ::= { smartUPS 2 }
+smartUPS600 OBJECT IDENTIFIER ::= { smartUPS 3 }
+smartUPS900 OBJECT IDENTIFIER ::= { smartUPS 4 }
+smartUPS1250 OBJECT IDENTIFIER ::= { smartUPS 5 }
+smartUPS2000 OBJECT IDENTIFIER ::= { smartUPS 6 }
+
+smartUPS450 OBJECT IDENTIFIER ::= { smartUPS 7 }
+smartUPS700 OBJECT IDENTIFIER ::= { smartUPS 8 }
+smartUPS1000 OBJECT IDENTIFIER ::= { smartUPS 9 }
+smartUPS1400 OBJECT IDENTIFIER ::= { smartUPS 10 }
+smartUPS2200 OBJECT IDENTIFIER ::= { smartUPS 11 }
+smartUPS3000 OBJECT IDENTIFIER ::= { smartUPS 12 }
+smartUPS5000 OBJECT IDENTIFIER ::= { smartUPS 13 }
+smartUPS7500 OBJECT IDENTIFIER ::= { smartUPS 14 }
+smartUPS10000 OBJECT IDENTIFIER ::= { smartUPS 15 }
+smartUPS1500 OBJECT IDENTIFIER ::= { smartUPS 16 }
+
+matrixUPS3000 OBJECT IDENTIFIER ::= { matrixUPS 1 }
+matrixUPS5000 OBJECT IDENTIFIER ::= { matrixUPS 2 }
+
+masterSwitchV1 OBJECT IDENTIFIER ::= { masterSwitch 1}
+masterSwitchV2 OBJECT IDENTIFIER ::= { masterSwitch 2}
+masterSwitchVM OBJECT IDENTIFIER ::= { masterSwitch 3}
+masterSwitchMSP OBJECT IDENTIFIER ::= { masterSwitch 4}
+masterSwitchrPDU OBJECT IDENTIFIER ::= { masterSwitch 5}
+
+symmetraUPS4kVA OBJECT IDENTIFIER ::= { symmetraUPS 1 }
+symmetraUPS8kVA OBJECT IDENTIFIER ::= { symmetraUPS 2 }
+symmetraUPS12kVA OBJECT IDENTIFIER ::= { symmetraUPS 3 }
+symmetraUPS16kVA OBJECT IDENTIFIER ::= { symmetraUPS 4 }
+
+environmental OBJECT IDENTIFIER ::= { monitors 1 }
+environmentalMgtSystem OBJECT IDENTIFIER ::= { monitors 2 }
+emu2 OBJECT IDENTIFIER ::= { monitors 3 }
+
+dm3 OBJECT IDENTIFIER ::= { dcPower 1 }
+dcmim2 OBJECT IDENTIFIER ::= { dcPower 2 }
+
+symmetra3PhaseUPS40kVA OBJECT IDENTIFIER ::= { symmetra3PhaseUPS 1 }
+symmetra3PhaseUPS60kVA OBJECT IDENTIFIER ::= { symmetra3PhaseUPS 2 }
+symmetra3PhaseUPS80kVA OBJECT IDENTIFIER ::= { symmetra3PhaseUPS 3 }
+symmetra3PhaseUPS20kVA OBJECT IDENTIFIER ::= { symmetra3PhaseUPS 4 }
+
+airFMSeries OBJECT IDENTIFIER ::= { networkAir 1 }
+rackAirRemovalUnit OBJECT IDENTIFIER ::= { networkAir 2 }
+airPASeries OBJECT IDENTIFIER ::= { networkAir 3 }
+
+ais5000UPS10kVA OBJECT IDENTIFIER ::= { ais5000UPS 1 }
+ais5000UPS20kVA OBJECT IDENTIFIER ::= { ais5000UPS 2 }
+ais5000UPS30kVA OBJECT IDENTIFIER ::= { ais5000UPS 3 }
+ais5000UPS40kVA OBJECT IDENTIFIER ::= { ais5000UPS 4 }
+ais5000UPS60kVA OBJECT IDENTIFIER ::= { ais5000UPS 5 }
+ais5000UPS80kVA OBJECT IDENTIFIER ::= { ais5000UPS 6 }
+ais5000UPS100kVA OBJECT IDENTIFIER ::= { ais5000UPS 7 }
+
+smartUPS3Phase10kVA OBJECT IDENTIFIER ::= { smartUPS3Phase 1 }
+smartUPS3Phase15kVA OBJECT IDENTIFIER ::= { smartUPS3Phase 2 }
+smartUPS3Phase20kVA OBJECT IDENTIFIER ::= { smartUPS3Phase 3 }
+smartUPS3Phase30kVA OBJECT IDENTIFIER ::= { smartUPS3Phase 4 }
+smartUPS3Phase40kVA OBJECT IDENTIFIER ::= { smartUPS3Phase 5 }
+
+upsIdent OBJECT IDENTIFIER ::= { ups 1 }
+upsBattery OBJECT IDENTIFIER ::= { ups 2 }
+upsInput OBJECT IDENTIFIER ::= { ups 3 }
+upsOutput OBJECT IDENTIFIER ::= { ups 4 }
+upsConfig OBJECT IDENTIFIER ::= { ups 5 }
+upsControl OBJECT IDENTIFIER ::= { ups 6 }
+upsTest OBJECT IDENTIFIER ::= { ups 7 }
+upsComm OBJECT IDENTIFIER ::= { ups 8 }
+upsPhase OBJECT IDENTIFIER ::= { ups 9 }
+upsSyncCtrlGroup OBJECT IDENTIFIER ::= { ups 10 }
+upsState OBJECT IDENTIFIER ::= { ups 11 }
+upsOutletGroups OBJECT IDENTIFIER ::= { ups 12 }
+upsDiagnostics OBJECT IDENTIFIER ::= { ups 13 }
+
+upsBasicIdent OBJECT IDENTIFIER ::= { upsIdent 1 }
+upsAdvIdent OBJECT IDENTIFIER ::= { upsIdent 2 }
+
+upsBasicBattery OBJECT IDENTIFIER ::= { upsBattery 1 }
+upsAdvBattery OBJECT IDENTIFIER ::= { upsBattery 2 }
+
+upsBasicInput OBJECT IDENTIFIER ::= { upsInput 1 }
+upsAdvInput OBJECT IDENTIFIER ::= { upsInput 2 }
+
+upsBasicOutput OBJECT IDENTIFIER ::= { upsOutput 1 }
+upsAdvOutput OBJECT IDENTIFIER ::= { upsOutput 2 }
+
+upsBasicConfig OBJECT IDENTIFIER ::= { upsConfig 1 }
+upsAdvConfig OBJECT IDENTIFIER ::= { upsConfig 2 }
+
+upsBasicControl OBJECT IDENTIFIER ::= { upsControl 1 }
+upsAdvControl OBJECT IDENTIFIER ::= { upsControl 2 }
+
+upsBasicTest OBJECT IDENTIFIER ::= { upsTest 1 }
+upsAdvTest OBJECT IDENTIFIER ::= { upsTest 2 }
+
+upsPhaseResetValues OBJECT IDENTIFIER ::= { upsPhase 1 }
+upsPhaseInput OBJECT IDENTIFIER ::= { upsPhase 2 }
+upsPhaseOutput OBJECT IDENTIFIER ::= { upsPhase 3 }
+
+upsSyncCtrlGroupConfig OBJECT IDENTIFIER ::= { upsSyncCtrlGroup 1 }
+upsSyncCtrlGroupStatus OBJECT IDENTIFIER ::= { upsSyncCtrlGroup 2 }
+
+upsBasicState OBJECT IDENTIFIER ::= { upsState 1 }
+upsAdvState OBJECT IDENTIFIER ::= { upsState 2 }
+
+upsOutletGroupStatus OBJECT IDENTIFIER ::= { upsOutletGroups 1 }
+upsOutletGroupConfig OBJECT IDENTIFIER ::= { upsOutletGroups 2 }
+upsOutletGroupControl OBJECT IDENTIFIER ::= { upsOutletGroups 3 }
+
+upsDiagnosticIM OBJECT IDENTIFIER ::= { upsDiagnostics 1 }
+upsDiagnosticPowerModules OBJECT IDENTIFIER ::= { upsDiagnostics 2 }
+upsDiagnosticBatteries OBJECT IDENTIFIER ::= { upsDiagnostics 3 }
+upsDiagnosticSubsystem OBJECT IDENTIFIER ::= { upsDiagnostics 4 }
+upsDiagnosticExternalDevices OBJECT IDENTIFIER ::= { upsDiagnostics 5 }
+upsDiagnosticComBus OBJECT IDENTIFIER ::= { upsDiagnostics 6 }
+
+upsDiagSwitchGear OBJECT IDENTIFIER ::= { upsDiagnosticExternalDevices 1 }
+upsDiagMCCBBox OBJECT IDENTIFIER ::= { upsDiagnosticExternalDevices 2 }
+upsDiagTransformer OBJECT IDENTIFIER ::= { upsDiagnosticExternalDevices 3 }
+
+mUpsEnviron OBJECT IDENTIFIER ::= { measureUps 1 }
+mUpsContact OBJECT IDENTIFIER ::= { measureUps 2 }
+
+serialPort OBJECT IDENTIFIER ::= { miniSNMPadapter 1}
+
+serialPort1 OBJECT IDENTIFIER ::= { serialPort 1}
+serialPort2 OBJECT IDENTIFIER ::= { serialPort 2}
+
+serialPort2Config OBJECT IDENTIFIER ::= { serialPort2 1}
+serialPort2Control OBJECT IDENTIFIER ::= { serialPort2 2}
+
+sPDUIdent OBJECT IDENTIFIER ::= { masterswitch 1 }
+sPDUMasterControl OBJECT IDENTIFIER ::= { masterswitch 2 }
+sPDUMasterConfig OBJECT IDENTIFIER ::= { masterswitch 3 }
+sPDUOutletControl OBJECT IDENTIFIER ::= { masterswitch 4 }
+sPDUOutletConfig OBJECT IDENTIFIER ::= { masterswitch 5 }
+
+sPDUIdentVM OBJECT IDENTIFIER ::= { masterswitchVM 1 }
+sPDUMasterControlVM OBJECT IDENTIFIER ::= { masterswitchVM 2 }
+sPDUMasterConfigVM OBJECT IDENTIFIER ::= { masterswitchVM 3 }
+sPDUMasterStatusVM OBJECT IDENTIFIER ::= { masterswitchVM 4 }
+sPDUOutletControlVM OBJECT IDENTIFIER ::= { masterswitchVM 5 }
+sPDUOutletConfigVM OBJECT IDENTIFIER ::= { masterswitchVM 6 }
+sPDUOutletStatusVM OBJECT IDENTIFIER ::= { masterswitchVM 7 }
+
+sPDUIdentMSP OBJECT IDENTIFIER ::= { masterswitchMSP 1 }
+sPDUMasterControlMSP OBJECT IDENTIFIER ::= { masterswitchMSP 2 }
+sPDUMasterConfigMSP OBJECT IDENTIFIER ::= { masterswitchMSP 3 }
+sPDUMasterStatusMSP OBJECT IDENTIFIER ::= { masterswitchMSP 4 }
+sPDUOutletControlMSP OBJECT IDENTIFIER ::= { masterswitchMSP 5 }
+sPDUOutletConfigMSP OBJECT IDENTIFIER ::= { masterswitchMSP 6 }
+sPDUOutletStatusMSP OBJECT IDENTIFIER ::= { masterswitchMSP 7 }
+
+sPDUOutletConfigMSPall OBJECT IDENTIFIER ::= { sPDUOutletConfigMSP 1 }
+sPDUOutletConfigMSPgs OBJECT IDENTIFIER ::= { sPDUOutletConfigMSP 2 }
+sPDUOutletConfigMSPannun OBJECT IDENTIFIER ::= { sPDUOutletConfigMSP 3 }
+sPDUOutletConfigMSPmups OBJECT IDENTIFIER ::= { sPDUOutletConfigMSP 4 }
+
+rPDUIdent OBJECT IDENTIFIER ::= { rPDU 1 }
+rPDULoad OBJECT IDENTIFIER ::= { rPDU 2 }
+rPDUOutlet OBJECT IDENTIFIER ::= { rPDU 3 }
+rPDUPowerSupply OBJECT IDENTIFIER ::= { rPDU 4 }
+
+rPDULoadDevice OBJECT IDENTIFIER ::= { rPDULoad 1 }
+rPDULoadPhaseConfig OBJECT IDENTIFIER ::= { rPDULoad 2 }
+rPDULoadStatus OBJECT IDENTIFIER ::= { rPDULoad 3 }
+rPDULoadBankConfig OBJECT IDENTIFIER ::= { rPDULoad 4 }
+
+rPDUOutletDevice OBJECT IDENTIFIER ::= { rPDUOutlet 1 }
+rPDUOutletPhase OBJECT IDENTIFIER ::= { rPDUOutlet 2 }
+rPDUOutletControl OBJECT IDENTIFIER ::= { rPDUOutlet 3 }
+rPDUOutletConfig OBJECT IDENTIFIER ::= { rPDUOutlet 4 }
+rPDUOutletStatus OBJECT IDENTIFIER ::= { rPDUOutlet 5 }
+rPDUOutletBank OBJECT IDENTIFIER ::= { rPDUOutlet 6 }
+
+rPDUPowerSupplyDevice OBJECT IDENTIFIER ::= { rPDUPowerSupply 1 }
+
+dm3Ident OBJECT IDENTIFIER ::= { dcDM3 1 }
+dm3Config OBJECT IDENTIFIER ::= { dcDM3 2 }
+dm3Status OBJECT IDENTIFIER ::= { dcDM3 3 }
+
+dm3IdentSystem OBJECT IDENTIFIER ::= { dm3Ident 1}
+
+dm3ConfigSystem OBJECT IDENTIFIER ::= { dm3Config 1 }
+dm3ConfigLVD OBJECT IDENTIFIER ::= { dm3Config 2 }
+dm3ConfigBattery OBJECT IDENTIFIER ::= { dm3Config 3 }
+dm3ConfigPowerModules OBJECT IDENTIFIER ::= { dm3Config 4 }
+dm3ConfigRelays OBJECT IDENTIFIER ::= { dm3Config 5 }
+dm3ConfigDistribution OBJECT IDENTIFIER ::= { dm3Config 6 }
+
+dm3ConfigRectifier OBJECT IDENTIFIER ::= { dm3ConfigPowerModules 1 }
+dm3ConfigConverter OBJECT IDENTIFIER ::= { dm3ConfigPowerModules 2 }
+
+dm3ConfigRectThresh OBJECT IDENTIFIER ::= { dm3ConfigRectifier 1 }
+dm3ConfigRectAlarms OBJECT IDENTIFIER ::= { dm3ConfigRectifier 2 }
+
+dm3ConfigConvThresh OBJECT IDENTIFIER ::= { dm3ConfigConverter 1 }
+dm3ConfigConvAlarms OBJECT IDENTIFIER ::= { dm3ConfigConverter 2 }
+
+dm3ConfigOutputRelays OBJECT IDENTIFIER ::= { dm3ConfigRelays 1 }
+dm3ConfigInputRelays OBJECT IDENTIFIER ::= { dm3ConfigRelays 2 }
+
+dm3ConfigBreakers OBJECT IDENTIFIER ::= { dm3ConfigDistribution 1 }
+dm3ConfigFuses OBJECT IDENTIFIER ::= { dm3ConfigDistribution 2 }
+
+dm3StatusSystem OBJECT IDENTIFIER ::= { dm3Status 1 }
+dm3StatusAlarms OBJECT IDENTIFIER ::= { dm3Status 2 }
+dm3StatusBattery OBJECT IDENTIFIER ::= { dm3Status 3 }
+dm3StatusOEM OBJECT IDENTIFIER ::= { dm3Status 4 }
+dm3StatusLVD OBJECT IDENTIFIER ::= { dm3Status 5 }
+dm3StatusPowerModules OBJECT IDENTIFIER ::= { dm3Status 6 }
+dm3StatusRelays OBJECT IDENTIFIER ::= { dm3Status 7 }
+dm3StatusDistribution OBJECT IDENTIFIER ::= { dm3Status 8 }
+
+dm3StatusRectifier OBJECT IDENTIFIER ::= { dm3StatusPowerModules 1 }
+dm3StatusConverter OBJECT IDENTIFIER ::= { dm3StatusPowerModules 2 }
+
+dm3StatusOutputRelays OBJECT IDENTIFIER ::= { dm3StatusRelays 1 }
+dm3StatusInputRelays OBJECT IDENTIFIER ::= { dm3StatusRelays 2 }
+
+dm3StatusBreakers OBJECT IDENTIFIER ::= { dm3StatusDistribution 1 }
+dm3StatusFuses OBJECT IDENTIFIER ::= { dm3StatusDistribution 2 }
+
+atsIdent OBJECT IDENTIFIER ::= { automaticTransferSwitch 1 }
+atsCalibration OBJECT IDENTIFIER ::= { automaticTransferSwitch 2 }
+atsControl OBJECT IDENTIFIER ::= { automaticTransferSwitch 3 }
+atsConfig OBJECT IDENTIFIER ::= { automaticTransferSwitch 4 }
+atsStatus OBJECT IDENTIFIER ::= { automaticTransferSwitch 5 }
+
+atsCalibrationInput OBJECT IDENTIFIER ::= { atsCalibration 1 }
+atsCalibrationPowerSupply OBJECT IDENTIFIER ::= { atsCalibration 2 }
+atsCalibrationOutput OBJECT IDENTIFIER ::= { atsCalibration 3 }
+
+atsStatusDeviceStatus OBJECT IDENTIFIER ::= { atsStatus 1 }
+atsStatusResetValues OBJECT IDENTIFIER ::= { atsStatus 2 }
+atsStatusInput OBJECT IDENTIFIER ::= { atsStatus 3 }
+atsStatusOutput OBJECT IDENTIFIER ::= { atsStatus 4 }
+
+dcmim2Ident OBJECT IDENTIFIER ::= { dc2 1 }
+dcmim2Control OBJECT IDENTIFIER ::= { dc2 2 }
+dcmim2Config OBJECT IDENTIFIER ::= { dc2 3 }
+dcmim2Status OBJECT IDENTIFIER ::= { dc2 4 }
+
+dcmim2IdentSystem OBJECT IDENTIFIER ::= { dcmim2Ident 1 }
+
+dcmim2ControlSystem OBJECT IDENTIFIER ::= { dcmim2Control 1 }
+
+dcmim2ConfigSystem OBJECT IDENTIFIER ::= { dcmim2Config 1 }
+dcmim2ConfigBattery OBJECT IDENTIFIER ::= { dcmim2Config 2 }
+dcmim2ConfigLVD OBJECT IDENTIFIER ::= { dcmim2Config 3 }
+
+dcmim2StatusSystem OBJECT IDENTIFIER ::= { dcmim2Status 1 }
+dcmim2StatusRectifier OBJECT IDENTIFIER ::= { dcmim2Status 2 }
+dcmim2StatusBattery OBJECT IDENTIFIER ::= { dcmim2Status 3 }
+dcmim2StatusLVD OBJECT IDENTIFIER ::= { dcmim2Status 4 }
+dcmim2StatusAlarms OBJECT IDENTIFIER ::= { dcmim2Status 5 }
+
+external OBJECT IDENTIFIER ::= { environmentalMonitor 1 }
+integrated OBJECT IDENTIFIER ::= { environmentalMonitor 2 }
+envMgtSystem OBJECT IDENTIFIER ::= { environmentalMonitor 3 }
+
+emIdent OBJECT IDENTIFIER ::= { external 1 }
+emConfig OBJECT IDENTIFIER ::= { external 2 }
+emStatus OBJECT IDENTIFIER ::= { external 3 }
+
+iemIdent OBJECT IDENTIFIER ::= { integrated 1 }
+iemConfig OBJECT IDENTIFIER ::= { integrated 2 }
+iemStatus OBJECT IDENTIFIER ::= { integrated 3 }
+
+emsIdent OBJECT IDENTIFIER ::= { envMgtSystem 1 }
+
+emsOutputRelayControl OBJECT IDENTIFIER ::= { envMgtSystem 2 }
+emsOutletControl OBJECT IDENTIFIER ::= { envMgtSystem 3 }
+emsSensorControl OBJECT IDENTIFIER ::= { envMgtSystem 4 }
+emsAlarmDeviceControl OBJECT IDENTIFIER ::= { envMgtSystem 5 }
+
+emsConfig OBJECT IDENTIFIER ::= { envMgtSystem 6 }
+emsProbeConfig OBJECT IDENTIFIER ::= { envMgtSystem 7 }
+emsInputContactConfig OBJECT IDENTIFIER ::= { envMgtSystem 8 }
+emsOutputRelayConfig OBJECT IDENTIFIER ::= { envMgtSystem 9 }
+emsOutletConfig OBJECT IDENTIFIER ::= { envMgtSystem 10 }
+emsSensorConfig OBJECT IDENTIFIER ::= { envMgtSystem 11 }
+
+emsStatus OBJECT IDENTIFIER ::= { envMgtSystem 12 }
+emsProbeStatus OBJECT IDENTIFIER ::= { envMgtSystem 13 }
+emsInputContactStatus OBJECT IDENTIFIER ::= { envMgtSystem 14 }
+emsOutputRelayStatus OBJECT IDENTIFIER ::= { envMgtSystem 15 }
+emsOutletStatus OBJECT IDENTIFIER ::= { envMgtSystem 16 }
+emsAlarmDeviceStatus OBJECT IDENTIFIER ::= { envMgtSystem 17 }
+emsSensorStatus OBJECT IDENTIFIER ::= { envMgtSystem 18 }
+
+nlIdent OBJECT IDENTIFIER ::= { netlock 1 }
+nlStatus OBJECT IDENTIFIER ::= { netlock 2 }
+
+airFM OBJECT IDENTIFIER ::= { airConditioners 1 }
+airFMIdent OBJECT IDENTIFIER ::= { airFM 1 }
+airFMStatus OBJECT IDENTIFIER ::= { airFM 2 }
+airFMGroup OBJECT IDENTIFIER ::= { airFM 3 }
+
+airPA OBJECT IDENTIFIER ::= { airConditioners 2 }
+airPAIdent OBJECT IDENTIFIER ::= { airPA 1 }
+airPAStatus OBJECT IDENTIFIER ::= { airPA 2 }
+
+rARUIdent OBJECT IDENTIFIER ::= { rARU 1 }
+rARUConfig OBJECT IDENTIFIER ::= { rARU 2 }
+rARUStatus OBJECT IDENTIFIER ::= { rARU 3 }
+
+
+-- object types
+
+-- the products group
+-- the experimental group
+
+
+
+-- the apcmgmt group
+-- the mconfig group
+
+mconfigNumTrapReceivers OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of managers to send traps to."
+ ::= { mconfig 1 }
+
+mconfigTrapReceiverTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF MconfigTrapReceiverEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of managers to send traps to. The number of
+ entries is given by the value of mconfigNumTrapReceivers.
+ Maximum number of Trap Receivers is four."
+ ::= { mconfig 2 }
+
+mconfigTrapReceiverEntry OBJECT-TYPE
+ SYNTAX MconfigTrapReceiverEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The managers to send traps to."
+ INDEX { trapIndex}
+ ::= { mconfigTrapReceiverTable 1 }
+
+MconfigTrapReceiverEntry ::=
+ SEQUENCE {
+ trapIndex
+ INTEGER,
+ receiverAddr
+ IpAddress,
+ communityString
+ DisplayString,
+ severity
+ INTEGER,
+ acceptThisReceiver
+ INTEGER,
+ receiveTrapType
+ INTEGER
+ }
+
+trapIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to a trap receiver entry."
+ ::= { mconfigTrapReceiverEntry 1 }
+
+receiverAddr OBJECT-TYPE
+ SYNTAX IpAddress
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The IP address of the manager to send a trap to."
+ ::= { mconfigTrapReceiverEntry 2 }
+
+communityString OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The community name to use in the trap when
+ sent to the manager."
+ ::= { mconfigTrapReceiverEntry 3 }
+
+severity OBJECT-TYPE
+ SYNTAX INTEGER {
+ information(1),
+ warning(2),
+ severe(3)
+ }
+ ACCESS read-only
+ STATUS obsolete
+ DESCRIPTION
+ "The severity threshold of traps to send to the manager.
+ traps are labeled in severity as informational(1), warning(2),
+ severe(3). Only traps of equal or greater severity than
+ this value are sent to the manager."
+ ::= { mconfigTrapReceiverEntry 4 }
+
+acceptThisReceiver OBJECT-TYPE
+ SYNTAX INTEGER {
+ yes (1),
+ no (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "An entry will become active if yes, and will
+ be deleted if no."
+ ::= { mconfigTrapReceiverEntry 5 }
+
+
+receiveTrapType OBJECT-TYPE
+ SYNTAX INTEGER {
+ powernet (1),
+ ietf (2),
+ both (3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The node in this entry will receive traps defined in APC
+ PowerNet MIB, if this OID is set to yes."
+ ::= { mconfigTrapReceiverEntry 6 }
+
+mconfigBOOTPEnabled OBJECT-TYPE
+ SYNTAX INTEGER {
+ yes (1),
+ no (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The value of yes(1) indicates the PowerNet Adapter is configured to
+ obtain its IP configuration parameters from a BOOTP server.
+
+ The value of no(2) indicates adapter will assume IP configuration parameters
+ values saved in adapter's eeprom, which was originally configured at local
+ console."
+ ::= { mconfig 3 }
+
+mconfigTFTPServerIP OBJECT-TYPE
+ SYNTAX IpAddress
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The IP address of TFTP server. If mconfigBOOTPEnabled is yes(1), then this IP address
+ is provided by BOOTP server and not allowed to be modified; otherwise, this IP address
+ can be modified.
+
+ Before using TFTP to load new code image, the image file should be placed in proper
+ directory of the specified TFTP server. This OID is only supported by AP9605, AP9205,
+ and AP9603 PowerNet SNMP Adapters."
+ ::= { mconfig 4 }
+
+newCodeAuthentViaTFTP OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ validNewAgentCodeImage (2),
+ sameAgentCodeImage (3),
+ invalidAgentCodeImage (4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Once mcontrolRestartAgent is set to loadAndExecuteNewAgent (3), PowerNet adapter will
+ start to load the remote image file, for authentication only, instead of saving the code
+ into flash memory. Only if a validNewAgentCodeImage (1) is found will the agent reboot
+ the PowerNet adapter and invoke the loader to load and save new code into the flash memory.
+ Otherwise, the current agent code will continue to run.
+
+ This OID shows the result of the above authentication process.
+ validNewAgentCodeImage (1) means the code image on TFTP server
+ is a valid APC agent code and is different version from the current agent.
+ Once agent identifies this, loader will start to update flash memory with
+ the new agent code.
+
+ sameAgentCodeImage (2) means the code image on TFTP server is exactly the
+ same as the currently running agent. Currently running agent will not invoke
+ loader to load the same again.
+
+ invalidAgentCodeImage (3) means the code image on TFTP server is NOT a valid
+ APC agent code. Thus, current agent will not load it into the flash memory.
+
+ The value of this OID will be associated with TRAP codeImageAuthentDone.
+ This OID is only supported by AP9605, AP9205, and AP9603 PowerNet SNMP Adapters."
+
+ ::= { mconfig 5 }
+
+mconfigClockDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The current date in the mm/dd/yyyy format. Example: 01/01/2000."
+ ::= { mconfigClock 1 }
+
+mconfigClockTime OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The current time in the hh:mm:ss am/pm format. Example: 12:00:00 am."
+ ::= { mconfigClock 2 }
+
+mcontrolRestartAgent OBJECT-TYPE
+ SYNTAX INTEGER {
+ restartCurrentAgent (1),
+ continueCurrentAgent (2),
+ loadAndExecuteNewAgent (3),
+ restartWithoutAgent (4),
+ resetNetworkAndRestart (5),
+ resetNetworkLeaveModeAndRestart (6)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to restartCurrentAgent (1) will restart the same SNMP
+ agent code currently saved in flash memory. Setting this OID to
+ loadAndExecuteNewAgent (3) will enable adapter to load a new agent code
+ into the flash memory and start to execute this new agent code.
+ Bootp/tftp is the default protocol. loadAndExecuteNewAgent is only
+ supported by AP9605, AP9205, and AP9603 PowerNet SNMP Adapters. Setting
+ this OID to restartWithoutAgent (4) will restart the system and not
+ start the agent. The subsequent time the system restarts the agent will
+ also automatically restart. Setting this OID to
+ resetNetworkAndRestart (5) will set the Boot Mode, IP Address, Subnet
+ Mask, and Default Gateway to defaults, expire any existing DHCP lease
+ and then restart the system. Setting this OID to
+ resetNetworkLeaveModeAndRestart (6) will leave the Boot Mode at the
+ current setting, set the IP Address, Subnet Mask, and Default Gateway to
+ defaults, expire any existing DHCP lease and then restart the system."
+
+ ::= { mcontrol 1 }
+
+-- The mtrapargs group
+-- These OIDs allows APC traps to be sent with additional arguments
+-- which may not be defined in the APC MIB.
+
+mtrapargsInteger OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with an integer argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return 0."
+ ::= { mtrapargs 1 }
+
+mtrapargsIpAddress OBJECT-TYPE
+ SYNTAX IpAddress
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with an IP address argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return 0.0.0.0."
+ ::= { mtrapargs 2 }
+
+mtrapargsString OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with an octet string argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return a NULL string."
+ ::= { mtrapargs 3 }
+
+mtrapargsGauge OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with a Gauge argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return 0."
+ ::= { mtrapargs 4 }
+
+mtrapargsTimeTicks OBJECT-TYPE
+ SYNTAX TimeTicks
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with a TimeTicks argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return 0."
+ ::= { mtrapargs 5 }
+
+mtrapargsInteger02 OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with an integer argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return 0."
+ ::= { mtrapargs 6 }
+
+mtrapargsInteger03 OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with an integer argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return 0."
+ ::= { mtrapargs 7 }
+
+mtrapargsIpAddress02 OBJECT-TYPE
+ SYNTAX IpAddress
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with an IP address argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return 0.0.0.0."
+ ::= { mtrapargs 8 }
+
+mtrapargsIpAddress03 OBJECT-TYPE
+ SYNTAX IpAddress
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with an IP address argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return 0.0.0.0."
+ ::= { mtrapargs 9 }
+
+mtrapargsString02 OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with an octet string argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return a NULL string."
+ ::= { mtrapargs 10 }
+
+mtrapargsString03 OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with an octet string argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return a NULL string."
+ ::= { mtrapargs 11 }
+
+mtrapargsGauge02 OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with a Gauge argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return 0."
+ ::= { mtrapargs 12 }
+
+mtrapargsGauge03 OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with a Gauge argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return 0."
+ ::= { mtrapargs 13 }
+
+mtrapargsTimeTicks02 OBJECT-TYPE
+ SYNTAX TimeTicks
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with a TimeTicks argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return 0."
+ ::= { mtrapargs 14 }
+
+mtrapargsTimeTicks03 OBJECT-TYPE
+ SYNTAX TimeTicks
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID allows APC traps to be sent with a TimeTicks argument
+ that my not be defined in the APC MIB.
+
+ A get of this OID will return 0."
+ ::= { mtrapargs 15 }
+
+-- the mfiletransfer group
+-- the mfiletransferStatus group
+mfiletransferStatusLastTransferResult OBJECT-TYPE
+ SYNTAX INTEGER {
+ lastFileTransferResultSuccessful (1),
+ lastFileTransferResultNotAvailable (2),
+ lastFileTransferResultFailureUnknown (3),
+ lastFileTransferResultFailureServerInaccessible (4),
+ lastFileTransferResultFailureServerAccessDenied (5),
+ lastFileTransferResultFailureFileNotFound (6),
+ lastFileTransferResultFailureFileTypeUnknown (7),
+ lastFileTransferResultFailureFileCorrupted (8)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Once mfiletransferControlInitiateFileTransfer is set to a value other than doNotInitiateFileTransfer
+ a file transfer of mfiletransferConfigSettingsFilename will be attempted from either a TFTP or FTP
+ server.
+
+ This OID shows the last attempted file transfer result.
+ lastFileTransferResultSuccessful (1) means the file transfer was successful.
+ lastFileTransferResultNotAvailable (2) means that there have been no previous file transfers.
+ lastFileTransferResultFailureUnknown (3) means that the last file transfer failed for an unknown reason.
+ lastFileTransferResultFailureServerInaccessible (4) means that the TFTP or FTP server could not be found on the network.
+ lastFileTransferResultFailureServerAccessDenied (5) means that the TFTP or FTP server denied access.
+ lastFileTransferResultFailureFileNotFound (6) means that the file could not be located.
+ lastFileTransferResultFailureFileTypeUnknown (7) means the file was examined, but the contents were unknown.
+ lastFileTransferResultFailureFileCorrupt (8) means the transferred file was corrupt."
+
+ ::= { mfiletransferStatus 1 }
+
+-- the mfiletransferConfig group
+-- the mfiletransferConfigSettings group
+
+mfiletransferConfigSettingsFilename OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The path and name of the file to transfer using the mfiletransferControlInitiateFileTransfer OID.
+ If the file to transfer exists in the default server directory then the path may be omitted."
+
+ ::= { mfiletransferConfigSettings 1 }
+
+-- the mfiletransferConfigTFTP group
+
+mfiletransferConfigTFTPServerAddress OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The IP Address in dotted decimal notation of the TFTP server involved in the file transfer."
+
+ ::= { mfiletransferConfigTFTP 1 }
+
+-- the mfiletransferConfigFTP group
+
+mfiletransferConfigFTPServerAddress OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The IP Address in dotted decimal notation of the FTP server involved in the file transfer."
+
+ ::= { mfiletransferConfigFTP 1 }
+
+mfiletransferConfigFTPServerUser OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The user identification for logging into the FTP server specified with mfiletransferConfigFTPServerAddress."
+
+ ::= { mfiletransferConfigFTP 2 }
+
+mfiletransferConfigFTPServerPassword OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The password for logging into the FTP server specified with mfiletransferConfigFTPServerAddress."
+
+ ::= { mfiletransferConfigFTP 3 }
+
+-- the mfiletransferControl group
+
+mfiletransferControlInitiateFileTransfer OBJECT-TYPE
+ SYNTAX INTEGER {
+ doNotInitiateFileTransfer (1),
+ initiateFileTransferDownloadViaTFTP (2),
+ initiateFileTransferDownloadViaFTP (3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to doNotInitiateFileTransfer (1) will do nothing.
+
+ Setting this OID to initiateFileTransferDownloadViaTFTP (2) will attempt to transfer the file named in
+ mfiletransferConfigSettingsFilename from the TFTP Server identified in mfiletransferConfigTFTPAddress.
+
+ Setting this OID to initiateFileTransferDownloadViaFTP (3) will attempt to transfer the file named in
+ mfiletransferConfigSettingsFilename from the FTP Server identified in mfiletransferConfigFTPAddress
+ using mfiletransferConfigFTPUser and mfiletransferConfigFTPPassword for the FTP Server login process."
+
+ ::= { mfiletransferControl 1 }
+
+-- the battManIdent group
+
+battManIdentProductName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the battery manager."
+ ::= { battManIdent 1 }
+
+battManIdentHardwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The battery manager network interface hardware revision.
+ This value is set at the factory."
+ ::= { battManIdent 2 }
+
+battManIdentFirmwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The battery manager network interface firmware revision.
+ This value is set at the factory and can change with firmware update."
+ ::= { battManIdent 3 }
+
+battManIdentDateOfManufacture OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date the battery manager was manufactured in mm/dd/yyyy format.
+ This value is set at the factory."
+ ::= { battManIdent 4 }
+
+battManIdentModelNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The battery manager model number character string.
+ This value is set at the factory."
+ ::= { battManIdent 5 }
+
+battManIdentSerialNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The battery manager serial number character string.
+ This value is set at the factory."
+ ::= { battManIdent 6 }
+
+-- the battManCalib group
+-- system calibration
+
+battManOhmicValueCorrectionFactor OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The system ohmic value correction factor in percent."
+ ::= { battManSystemCalib 1 }
+
+-- unit calibration
+
+battManUnitCalibTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of entries in the battManUnitCalibTable."
+ ::= { battManUnitCalib 1 }
+
+battManUnitCalibTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF BattManUnitCalibTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting calibration information from each unit in the system."
+ ::= { battManUnitCalib 2 }
+
+battManUnitCalibTableEntry OBJECT-TYPE
+ SYNTAX BattManUnitCalibTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The unit to get data from."
+ INDEX { battManUnitCalibIndex }
+ ::= { battManUnitCalibTable 1 }
+
+BattManUnitCalibTableEntry ::=
+ SEQUENCE {
+ battManUnitCalibIndex INTEGER,
+ battManUnitSerialNumber DisplayString,
+ battManBatteryVoltageZeroCalib INTEGER,
+ battManBatteryVoltageSpanCalib INTEGER
+ }
+
+battManUnitCalibIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of unit calibration entries in the table."
+ ::= { battManUnitCalibTableEntry 1 }
+
+battManUnitSerialNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The serial number of the unit."
+ ::= { battManUnitCalibTableEntry 2 }
+
+battManBatteryVoltageZeroCalib OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The unit battery voltage zero calibration in millivolts."
+ ::= { battManUnitCalibTableEntry 3 }
+
+battManBatteryVoltageSpanCalib OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The unit battery voltage span calibration in percent."
+ ::= { battManUnitCalibTableEntry 4 }
+
+-- string calibration table
+
+battManStringCalibTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of entries in the battManStringCalibTable."
+ ::= { battManStringCalib 1 }
+
+battManStringCalibTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF BattManStringCalibTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting calibration information from each string in the system."
+ ::= { battManStringCalib 2 }
+
+battManStringCalibTableEntry OBJECT-TYPE
+ SYNTAX BattManStringCalibTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The string to get data from."
+ INDEX { battManStringCalibIndex }
+ ::= { battManStringCalibTable 1 }
+
+BattManStringCalibTableEntry ::=
+ SEQUENCE {
+ battManStringCalibIndex INTEGER,
+ battManDCCurrentZeroCalib INTEGER,
+ battManACCurrentZeroCalib INTEGER,
+ battManProbeRange INTEGER
+ }
+
+battManStringCalibIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of string calibration entries in the table."
+ ::= { battManStringCalibTableEntry 1 }
+
+battManDCCurrentZeroCalib OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The string DC current zero calibration in tenths of amps."
+ ::= { battManStringCalibTableEntry 2 }
+
+battManACCurrentZeroCalib OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The string AC current zero calibration in tenths of amps."
+ ::= { battManStringCalibTableEntry 3 }
+
+battManProbeRange OBJECT-TYPE
+ SYNTAX INTEGER {
+ amps1000 (1),
+ amps500 (2),
+ amps100 (3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The string probe range in amps."
+ ::= { battManStringCalibTableEntry 4 }
+
+--string 1 battery calibration table
+
+battManString1BatteryCalibTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of entries in the battManString1BatteryCalibTable."
+ ::= { battManBatteryCalib 1 }
+
+battManString1BatteryCalibTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF BattManString1BatteryCalibTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting calibration information from each battery in String 1."
+ ::= { battManBatteryCalib 2 }
+
+battManString1BatteryCalibTableEntry OBJECT-TYPE
+ SYNTAX BattManString1BatteryCalibTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The string to get data from."
+ INDEX { battManString1BatteryCalibIndex }
+ ::= { battManString1BatteryCalibTable 1 }
+
+BattManString1BatteryCalibTableEntry ::=
+ SEQUENCE {
+ battManString1BatteryCalibIndex INTEGER,
+ battManString1BatteryInterTierOhmicValue INTEGER
+ }
+
+battManString1BatteryCalibIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of battery calibration entries in the table."
+ ::= { battManString1BatteryCalibTableEntry 1 }
+
+battManString1BatteryInterTierOhmicValue OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The battery inter-tier ohmic value in ohms. This corresponds to the ohmic
+ value for the positive terminal of the battery."
+ ::= { battManString1BatteryCalibTableEntry 2 }
+
+--string 2 battery calibration table
+
+battManString2BatteryCalibTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of entries in the battManString2BatteryCalibTable."
+ ::= { battManBatteryCalib 3 }
+
+battManString2BatteryCalibTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF BattManString2BatteryCalibTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting calibration information from each battery in String 2."
+ ::= { battManBatteryCalib 4 }
+
+battManString2BatteryCalibTableEntry OBJECT-TYPE
+ SYNTAX BattManString2BatteryCalibTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The string to get data from."
+ INDEX { battManString2BatteryCalibIndex }
+ ::= { battManString2BatteryCalibTable 1 }
+
+BattManString2BatteryCalibTableEntry ::=
+ SEQUENCE {
+ battManString2BatteryCalibIndex INTEGER,
+ battManString2BatteryInterTierOhmicValue INTEGER
+ }
+
+battManString2BatteryCalibIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of battery calibration entries in the table."
+ ::= { battManString2BatteryCalibTableEntry 1 }
+
+battManString2BatteryInterTierOhmicValue OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The battery inter-tier ohmic value in ohms."
+ ::= { battManString2BatteryCalibTableEntry 2 }
+
+-- the battManConfig group
+
+battManConfigApplication OBJECT-TYPE
+ SYNTAX INTEGER {
+ silcon (1),
+ other (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The type of application the battery manager is installed on:
+ Silcon(1) Silcon UPS or
+ Other(2) Other UPS/Charger."
+ ::= { battManConfig 1 }
+
+battManConfigBatteryChemistry OBJECT-TYPE
+ SYNTAX INTEGER {
+ leadAcid (1),
+ nickel-Cadmium (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The battery chemistry of the monitored batteries:
+ LeadAcid(1) Lead Acid or
+ Nickel-Cadmium(2) Nickel-Cadmium."
+ ::= { battManConfig 2 }
+
+battManConfigBatteryAHCapacity OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The amp hour capacity of the monitored batteries 5-2000 AH."
+ ::= { battManConfig 3 }
+
+battManConfigNumberofStrings OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The number of strings in the battery manager system (1 - 2 Silcon)/(1 Other)."
+ ::= { battManConfig 4 }
+
+battManConfigBatteriesperString OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The number of batteries per string."
+ ::= { battManConfig 5 }
+
+battManConfigCellsperBattery OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The number of cells per battery (1 - 6 for lead-acid, 1 - 2 for NiCd."
+ ::= { battManConfig 6 }
+
+battManConfigMinCellVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum battery cell voltage alarm limit in millivolts DC."
+ ::= { battManConfig 7 }
+
+battManConfigMaxCellVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum battery cell voltage alarm limit in millivolts DC."
+ ::= { battManConfig 8 }
+
+battManConfigMaxPilotTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum pilot battery temperature alarm limit in tenths of degrees Fahrenheit."
+ ::= { battManConfig 9 }
+
+battManConfigMaxPilotTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum pilot battery temperature alarm limit in tenths of degrees Celcius."
+ ::= { battManConfig 10 }
+
+battManConfigMaxAmbientTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum ambient temperature alarm limit in tenths of degrees Fahrenheit."
+ ::= { battManConfig 11 }
+
+battManConfigMaxAmbientTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum ambient temperature alarm limit in tenths of degrees Celcius."
+ ::= { battManConfig 12 }
+
+battManConfigMinAmbientTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The Minimum Ambient Temperature alarm limit in tenths of degrees Fahrenheit."
+ ::= { battManConfig 13 }
+
+battManConfigMinAmbientTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The Minimum Ambient Temperature alarm limit in tenths of degrees Celcius."
+ ::= { battManConfig 14 }
+
+battManConfigMaxRippleCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum ripple current alarm limit for the monitored battery
+ strings in percent of AH capacity."
+ ::= { battManConfig 15 }
+
+battManConfigMaxCurrentAcceptanceDeviation OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum current acceptance deviation alarm limit in percentage."
+ ::= { battManConfig 16 }
+
+battManConfigMonitorWireLength OBJECT-TYPE
+ SYNTAX INTEGER {
+ fiftyFeetOrLess (1),
+ moreThanFiftyFeet (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The monitor wire length:
+ fiftyFeetOrLess (1) indicates that the wire length is less than or equal to 50 feet.
+ moreThanFiftyFeet (2) indicates that the wire length is greater than 50 feet."
+ ::= { battManConfig 17 }
+
+battManConfigDischargeVoltageAlarmLevel OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The discharge voltage alarm level in percent."
+ ::= { battManConfig 18 }
+
+battManConfigAutoAnnunciatorReset OBJECT-TYPE
+ SYNTAX INTEGER {
+ disabled (1),
+ enabled (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The annunciator output signal reset method:
+ disabled(1) means the annunciator signal output will be reset when the reset button is pressed.
+ enabled(2) means the annunciator will stop signalling when all alarm conditions clear."
+ ::= { battManConfig 19 }
+
+-- the battManAlarm group
+
+battManAlarmManagementController OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The Management Controller Alarm is :
+ normal(1) no alarm condtions identified
+ alarm(2) an alarm condition exits."
+ ::= { battManAlarm 1 }
+
+battManAlarmBatteries OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The Batteries Alarm is :
+ normal(1) no alarm condtions identified
+ alarm(2) an alarm condition exits."
+ ::= { battManAlarm 2 }
+
+battManAlarmCharger OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The Charger Alarm is :
+ normal(1) no alarm condtions identified
+ alarm(2) an alarm condition exits."
+ ::= { battManAlarm 3 }
+
+battManAlarmEnvironment OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The Environment Alarm is :
+ normal(1) no alarm condtions identified
+ alarm(2) an alarm condition exits."
+ ::= { battManAlarm 4 }
+
+-- the battManSystemStatus group
+
+-- These are system wide parameters
+
+battManSystemAmbientTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system ambient temperture in tenths of degrees Celcius."
+ ::= { battManSystemStatus 1 }
+
+battManSystemAmbientTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system ambient temperture in tenths of degrees Fahrenheit."
+ ::= { battManSystemStatus 2 }
+
+battManSystemPilotTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system pilot temperature in tenths of degrees Celcius."
+ ::= { battManSystemStatus 3 }
+
+battManSystemPilotTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system pilot temperature in tenths of degrees Fahrenheit."
+ ::= { battManSystemStatus 4 }
+
+battManSystemAmbientHighTempAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates that the system has a high temperature alarm."
+ ::= { battManSystemStatus 5 }
+
+battManSystemAmbientLowTempAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates that the system has a low temperature alarm."
+ ::= { battManSystemStatus 6 }
+
+battManSystemPilotBatteryHighTempAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates that the system has a pilot battery high temperature alarm."
+ ::= { battManSystemStatus 7 }
+
+battManSystemPilotProbeDisconnected OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates that the system pilot probe is disconnected."
+ ::= { battManSystemStatus 8 }
+
+battManSystemAmbientProbeDisconnected OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates that the system ambient probe is disconnected."
+ ::= { battManSystemStatus 9 }
+
+-- This is a table of input contact parameters
+
+battManInputContactTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of entries in the battManContactTable."
+ ::= { battManInputContactStatus 1 }
+
+battManInputContactTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF BattManInputContactTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting information from each contact
+ in the system. "
+ ::= { battManInputContactStatus 2 }
+
+battManInputContactTableEntry OBJECT-TYPE
+ SYNTAX BattManInputContactTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The contact to get data from."
+ INDEX { battManInputContactIndex }
+ ::= { battManInputContactTable 1 }
+
+BattManInputContactTableEntry ::=
+ SEQUENCE {
+ battManInputContactIndex INTEGER,
+ battManInputContactName DisplayString,
+ battManInputContactAlarmState INTEGER,
+ battManInputContactState INTEGER,
+ battManInputContactNormalState INTEGER,
+ battManInputContactAlarmDelay INTEGER
+ }
+
+battManInputContactIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of contact entries in the table."
+ ::= { battManInputContactTableEntry 1 }
+
+battManInputContactName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the input contact."
+ ::= { battManInputContactTableEntry 2 }
+
+battManInputContactAlarmState OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates that the alarm condition is active for this contact."
+ ::= { battManInputContactTableEntry 3 }
+
+battManInputContactState OBJECT-TYPE
+ SYNTAX INTEGER {
+ open (1),
+ closed (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to open(1), the input contact is in the open state.
+ When set to closed(2), the input contact is in the closed state."
+ ::= { battManInputContactTableEntry 4 }
+
+battManInputContactNormalState OBJECT-TYPE
+ SYNTAX INTEGER {
+ open (1),
+ closed (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to open(1), the input contact is normally open.
+ When set to closed(2), the input contact is normally closed."
+ ::= { battManInputContactTableEntry 5 }
+
+battManInputContactAlarmDelay OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The alarm delay time in seconds."
+ ::= { battManInputContactTableEntry 6 }
+
+-- This is a table of battery string parameters
+
+battManStringTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of entries in the battManStringTable."
+ ::= { battManStringStatus 1 }
+
+battManStringTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF BattManStringTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting information from each string
+ in the system. "
+ ::= { battManStringStatus 2 }
+
+battManStringTableEntry OBJECT-TYPE
+ SYNTAX BattManStringTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The string to get data from."
+ INDEX { battManStringIndex }
+ ::= { battManStringTable 1 }
+
+BattManStringTableEntry ::=
+ SEQUENCE {
+ battManStringIndex INTEGER,
+ battManStringCurrent INTEGER,
+ battManStringRippleCurrent INTEGER,
+ battManStringChargerHighVoltageAlarm INTEGER,
+ battManStringChargerLowVoltageAlarm INTEGER,
+ battManStringCurrentProbeDisconnected INTEGER,
+ battManStringOnBattery INTEGER
+ }
+
+battManStringIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of string entries in the table."
+ ::= { battManStringTableEntry 1 }
+
+battManStringCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The string current in tenths of Amps."
+ ::= { battManStringTableEntry 2 }
+
+battManStringRippleCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The string ripple current in tenths of Amps."
+ ::= { battManStringTableEntry 3 }
+
+battManStringChargerHighVoltageAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates that the string charger has a high voltage alarm."
+ ::= { battManStringTableEntry 4 }
+
+battManStringChargerLowVoltageAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates that the string charger has a low voltage alarm."
+ ::= { battManStringTableEntry 5 }
+
+battManStringCurrentProbeDisconnected OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates that the string charger probe is disconnected."
+ ::= { battManStringTableEntry 6 }
+
+battManStringOnBattery OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates that the string is in the on-battery state."
+ ::= { battManStringTableEntry 7 }
+
+-- the battManString1BatteryStatus group
+
+battManString1BatteryTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of entries in the battManString1BatteryStatusTable."
+ ::= { battManBatteryStatus 1 }
+
+battManString1BatteryTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF BattManString1BatteryTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting information from each string
+ in the system. "
+ ::= { battManBatteryStatus 2 }
+
+battManString1BatteryTableEntry OBJECT-TYPE
+ SYNTAX BattManString1BatteryTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The string to get data from."
+ INDEX { battManString1BatteryIndex }
+ ::= { battManString1BatteryTable 1 }
+
+BattManString1BatteryTableEntry ::=
+ SEQUENCE {
+ battManString1BatteryIndex INTEGER,
+ battManString1BatteryVoltage INTEGER,
+ battManString1BatteryLowestVoltage INTEGER,
+ battManString1BatteryCellShorted INTEGER,
+ battManString1BatteryOpenFuseOrConnection INTEGER,
+ battManString1BatteryLowCapacity INTEGER,
+ battManString1BatteryHighOhmicValue INTEGER,
+ battManString1BatteryThermalRunaway INTEGER,
+ battManString1BatteryDryout INTEGER
+ }
+
+battManString1BatteryIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of string entries in the table."
+ ::= { battManString1BatteryTableEntry 1 }
+
+battManString1BatteryVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The battery voltage in milli VDC."
+ ::= { battManString1BatteryTableEntry 2 }
+
+battManString1BatteryLowestVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The lowest battery discharge voltage during the last power event in milli VDC."
+ ::= { battManString1BatteryTableEntry 3 }
+
+battManString1BatteryCellShorted OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates that a battery cell is shorted."
+ ::= { battManString1BatteryTableEntry 4 }
+
+battManString1BatteryOpenFuseOrConnection OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates that a fuse or connection is open."
+ ::= { battManString1BatteryTableEntry 5 }
+
+battManString1BatteryLowCapacity OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates a battery has low capacity."
+ ::= { battManString1BatteryTableEntry 6 }
+
+battManString1BatteryHighOhmicValue OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates a battery has a high ohmic value."
+ ::= { battManString1BatteryTableEntry 7 }
+
+battManString1BatteryThermalRunaway OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates a battery has a thermal runaway condition."
+ ::= { battManString1BatteryTableEntry 8 }
+
+battManString1BatteryDryout OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates a battery has a dryout condition."
+ ::= { battManString1BatteryTableEntry 9 }
+
+-- the battManString2BatteryStatus group
+
+battManString2BatteryTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of entries in the battManString2BatteryStatusTable."
+ ::= { battManBatteryStatus 3 }
+
+battManString2BatteryTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF BattManString2BatteryTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting information from each string
+ in the system. "
+ ::= { battManBatteryStatus 4 }
+
+battManString2BatteryTableEntry OBJECT-TYPE
+ SYNTAX BattManString2BatteryTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The string to get data from."
+ INDEX { battManString2BatteryIndex }
+ ::= { battManString2BatteryTable 1 }
+
+BattManString2BatteryTableEntry ::=
+ SEQUENCE {
+ battManString2BatteryIndex INTEGER,
+ battManString2BatteryVoltage INTEGER,
+ battManString2BatteryLowestVoltage INTEGER,
+ battManString2BatteryCellShorted INTEGER,
+ battManString2BatteryOpenFuseOrConnection INTEGER,
+ battManString2BatteryLowCapacity INTEGER,
+ battManString2BatteryHighOhmicValue INTEGER,
+ battManString2BatteryThermalRunaway INTEGER,
+ battManString2BatteryDryout INTEGER
+ }
+
+battManString2BatteryIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of string entries in the table."
+ ::= { battManString2BatteryTableEntry 1 }
+
+battManString2BatteryVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The battery voltage in milli VDC."
+ ::= { battManString2BatteryTableEntry 2 }
+
+battManString2BatteryLowestVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The lowest battery discharge voltage during the last power event in milli VDC."
+ ::= { battManString2BatteryTableEntry 3 }
+
+battManString2BatteryCellShorted OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates that a battery cell is shorted."
+ ::= { battManString2BatteryTableEntry 4 }
+
+battManString2BatteryOpenFuseOrConnection OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates that a fuse or connection is open."
+ ::= { battManString2BatteryTableEntry 5 }
+
+battManString2BatteryLowCapacity OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates a battery has low capacity."
+ ::= { battManString2BatteryTableEntry 6 }
+
+battManString2BatteryHighOhmicValue OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates a battery has a high ohmic value."
+ ::= { battManString2BatteryTableEntry 7 }
+
+battManString2BatteryThermalRunaway OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates a battery has a thermal runaway condition."
+ ::= { battManString2BatteryTableEntry 8 }
+
+battManString2BatteryDryout OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ alarm (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When set to alarm(2), indicates a battery has a dryout condition."
+ ::= { battManString2BatteryTableEntry 9 }
+
+-- battery manager control group
+battManRemoteAnnunciatorReset OBJECT-TYPE
+ SYNTAX INTEGER {
+ noOperation (1),
+ reset (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to reset(2) will reset the user interface annunciator.
+ Getting this OID will do nothing and return the noOperation(1) value."
+ ::= { battManControl 1 }
+
+battManResetChargeCurrentDeviationBenchmark OBJECT-TYPE
+ SYNTAX INTEGER {
+ noOperation (1),
+ reset (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to reset(2) will reset the charge current deviation benchmark.
+ Getting this OID will do nothing and return the noOperation(1) value."
+ ::= { battManControl 2 }
+
+battManResetLowestDischargeVoltages OBJECT-TYPE
+ SYNTAX INTEGER {
+ noOperation (1),
+ reset (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to reset(2) will reset the lowest discharge voltages.
+ Getting this OID will do nothing and return the noOperation(1) value."
+ ::= { battManControl 3 }
+
+-- the battManTestResults group
+
+--string 1 test results table
+
+battManString1OhmicValueLastDischargeInfo OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Informational text showing the date/time, load, and pilot temperature for the string
+ during the last discharge when ohmic values were recorded."
+ ::= { battManTestResults 1 }
+
+battManString1OhmicValueTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of entries in the battManString1OhmicValueTable."
+ ::= { battManTestResults 2 }
+
+battManString1OhmicValueTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF BattManString1OhmicValueTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting ohmic value information from each battery in String 1."
+ ::= { battManTestResults 3 }
+
+battManString1OhmicValueTableEntry OBJECT-TYPE
+ SYNTAX BattManString1OhmicValueTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The string to get data from."
+ INDEX { battManString1OhmicValueIndex }
+ ::= { battManString1OhmicValueTable 1 }
+
+BattManString1OhmicValueTableEntry ::=
+ SEQUENCE {
+ battManString1OhmicValueIndex INTEGER,
+ battManString1OhmicValueData INTEGER
+ }
+
+battManString1OhmicValueIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The battery number."
+ ::= { battManString1OhmicValueTableEntry 1 }
+
+battManString1OhmicValueData OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The battery inter-tier ohmic value in ohms.
+ Note: Negative values are invalid and may indicate faulty calibration
+ of ohmic value correction factors."
+ ::= { battManString1OhmicValueTableEntry 2 }
+
+battManString1ResponseTestChangeTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of entries in the battManString1ResponseTestChangeTable."
+ ::= { battManTestResults 4 }
+
+battManString1ResponseTestChangeTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF BattManString1ResponseTestChangeTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting response test change information from each battery in String 1."
+ ::= { battManTestResults 5 }
+
+battManString1ResponseTestChangeTableEntry OBJECT-TYPE
+ SYNTAX BattManString1ResponseTestChangeTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The string to get data from."
+ INDEX { battManString1ResponseTestChangeIndex }
+ ::= { battManString1ResponseTestChangeTable 1 }
+
+BattManString1ResponseTestChangeTableEntry ::=
+ SEQUENCE {
+ battManString1ResponseTestChangeIndex INTEGER,
+ battManString1ResponseTestChangeData INTEGER
+ }
+
+battManString1ResponseTestChangeIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of the entries in the table."
+ ::= { battManString1ResponseTestChangeTableEntry 1 }
+
+battManString1ResponseTestChangeData OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The battery response test change in percent."
+ ::= { battManString1ResponseTestChangeTableEntry 2 }
+
+battManString2OhmicValueLastDischargeInfo OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Informational text showing the date/time, load, and pilot temperature for the string
+ during the last discharge when ohmic values were recorded."
+ ::= { battManTestResults 6 }
+
+battManString2OhmicValueTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of entries in the battManString2OhmicValueTable."
+ ::= { battManTestResults 7 }
+
+battManString2OhmicValueTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF BattManString2OhmicValueTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting ohmic value information from each battery in String 1."
+ ::= { battManTestResults 8 }
+
+battManString2OhmicValueTableEntry OBJECT-TYPE
+ SYNTAX BattManString2OhmicValueTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The string to get data from."
+ INDEX { battManString2OhmicValueIndex }
+ ::= { battManString2OhmicValueTable 1 }
+
+BattManString2OhmicValueTableEntry ::=
+ SEQUENCE {
+ battManString2OhmicValueIndex INTEGER,
+ battManString2OhmicValueData INTEGER
+ }
+
+battManString2OhmicValueIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of battery calibration entries in the table."
+ ::= { battManString2OhmicValueTableEntry 1 }
+
+battManString2OhmicValueData OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The battery inter-tier ohmic value in ohms.
+ Note: Negative values are invalid and may indicate faulty calibration
+ of ohmic value correction factors."
+ ::= { battManString2OhmicValueTableEntry 2 }
+
+battManString2ResponseTestChangeTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of entries in the battManString2ResponseTestChangeTable."
+ ::= { battManTestResults 9 }
+
+battManString2ResponseTestChangeTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF BattManString2ResponseTestChangeTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting response test change information from each battery in String 1."
+ ::= { battManTestResults 10 }
+
+battManString2ResponseTestChangeTableEntry OBJECT-TYPE
+ SYNTAX BattManString2ResponseTestChangeTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The string to get data from."
+ INDEX { battManString2ResponseTestChangeIndex }
+ ::= { battManString2ResponseTestChangeTable 1 }
+
+BattManString2ResponseTestChangeTableEntry ::=
+ SEQUENCE {
+ battManString2ResponseTestChangeIndex INTEGER,
+ battManString2ResponseTestChangeData INTEGER
+ }
+
+battManString2ResponseTestChangeIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of the entries in the table."
+ ::= { battManString2ResponseTestChangeTableEntry 1 }
+
+battManString2ResponseTestChangeData OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The battery response test change in percent."
+ ::= { battManString2ResponseTestChangeTableEntry 2 }
+
+-- the xPDUIdent group
+
+xPDUIdentProductName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the PDU."
+ ::= { xPDUIdent 1 }
+
+xPDUIdentHardwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware revision of the PDU.
+ This value is set at the factory."
+ ::= { xPDUIdent 2 }
+
+xPDUIdentFirmwareAppRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An ID string identifying the application firmware revision of the PDU."
+ ::= { xPDUIdent 3 }
+
+xPDUIdentFirmwareAppOSRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An ID string identifying the application operating system firmware revision of the PDU."
+ ::= { xPDUIdent 4 }
+
+xPDUIdentFirmwareControllerRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An ID string identifying the PDU controller firmware revision."
+ ::= { xPDUIdent 5 }
+
+xPDUIdentDateOfManufacture OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date when the PDU was manufactured in mm/dd/yyyy format.
+ This value is set at the factory."
+ ::= { xPDUIdent 6 }
+
+xPDUIdentModelNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the model number of
+ the PDU. This value is set at the factory."
+ ::= { xPDUIdent 7 }
+
+xPDUIdentSerialNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the serial number of
+ the PDU. This value is set at the factory."
+ ::= { xPDUIdent 8 }
+
+-- the xPDUDevice group
+
+xPDUDeviceNominalMainInputVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The nominal main input voltage to the PDU.
+ Measured in Volts, line-to-line for a delta service or
+ line-to-neutral for a wye service."
+ ::= { xPDUDevice 1 }
+
+xPDUDeviceServiceType OBJECT-TYPE
+ SYNTAX INTEGER {
+ delta (1),
+ wye (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The type of utility input to the PDU. Either 3 wires (delta), or 4 wires (wye)."
+ ::= { xPDUDevice 2 }
+
+xPDUDeviceNominalOutputVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The nominal line-to-neutral output voltage to the load measured in Volts."
+ ::= { xPDUDevice 3 }
+
+xPDUDeviceMainInputBreakerRating OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The rating of the main input breaker measured in Amps."
+ ::= { xPDUDevice 4 }
+
+xPDUDevicePanelBreakerRating OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The rating of the panel breaker measured in Amps."
+ ::= { xPDUDevice 5 }
+
+xPDUDeviceTransformerPresent OBJECT-TYPE
+ SYNTAX INTEGER {
+ notPresent (1),
+ present (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates whether or not a transformer is installed in the PDU."
+ ::= { xPDUDevice 6 }
+
+xPDUDeviceLoadTieBreakerPresent OBJECT-TYPE
+ SYNTAX INTEGER {
+ notPresent (1),
+ present (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates whether or not a load tie breaker is installed in the PDU."
+ ::= { xPDUDevice 7 }
+
+xPDUDeviceLoadTestPortPresent OBJECT-TYPE
+ SYNTAX INTEGER {
+ notPresent (1),
+ present (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates whether or not a load test port is installed in the PDU."
+ ::= { xPDUDevice 8 }
+
+xPDUDeviceFusesPresent OBJECT-TYPE
+ SYNTAX INTEGER {
+ notPresent (1),
+ present (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates whether or not the UPS feed from the PDU includes fuses."
+ ::= { xPDUDevice 9 }
+
+xPDUDeviceFansPresent OBJECT-TYPE
+ SYNTAX INTEGER {
+ notPresent (1),
+ present (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates whether or not cooling fans are installed in the PDU."
+ ::= { xPDUDevice 10 }
+
+xPDUDeviceBypassInputPresent OBJECT-TYPE
+ SYNTAX INTEGER {
+ notPresent (1),
+ present (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates whether or not the PDU is equipped with a second feed for
+ the UPS's bypass input."
+ ::= { xPDUDevice 11 }
+
+xPDUDeviceCrossTieOutputPresent OBJECT-TYPE
+ SYNTAX INTEGER {
+ notPresent (1),
+ present (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates whether or not the PDU is equipped with a cross-tie output."
+ ::= { xPDUDevice 12 }
+
+xPDUDeviceEarthGroundMonitorPresent OBJECT-TYPE
+ SYNTAX INTEGER {
+ notPresent (1),
+ present (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates whether or not the PDU can provide ground current measurements."
+ ::= { xPDUDevice 13 }
+
+xPDUDeviceInfraXureType OBJECT-TYPE
+ SYNTAX INTEGER {
+ typeB (1),
+ typeC (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates the configuration of this PDU system.
+ Type-B PDU is in a distributed UPS system and has bypass capabilities.
+ Type-C PDU receives power from a larger central UPS."
+ ::= { xPDUDevice 14 }
+
+-- Main Input
+
+xPDUMainInputOverVoltThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..30)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold above which an input over voltage condition will be generated.
+ Specified as percent deviation from nominal."
+ ::= { xPDUMainInput 1 }
+
+xPDUMainInputUnderVoltThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..30)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold below which an input under voltage condition will be generated.
+ Specified as percent deviation from nominal."
+ ::= { xPDUMainInput 2 }
+
+-- Main Input Voltage Table
+
+xPDUMainInputVoltageTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of Main input voltage entries."
+ ::= { xPDUMainInput 3 }
+
+xPDUMainInputVoltageTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XPDUMainInputVoltagePhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of input voltage table entries. The number of
+ entries are the phase entries.
+ The number of entries is contained in the
+ xPDUMainInputVoltageTableSize OID."
+ ::= { xPDUMainInput 4 }
+
+ xPDUMainInputVoltagePhaseEntry OBJECT-TYPE
+ SYNTAX XPDUMainInputVoltagePhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular main input voltage phase."
+ INDEX { xPDUMainInputVoltagePhaseIndex }
+ ::= { xPDUMainInputVoltageTable 1 }
+
+ XPDUMainInputVoltagePhaseEntry ::= SEQUENCE {
+ xPDUMainInputVoltagePhaseIndex INTEGER,
+ xPDUMainInputVoltageLtoL INTEGER,
+ xPDUMainInputVoltageLtoN INTEGER
+ }
+
+ xPDUMainInputVoltagePhaseIndex OBJECT-TYPE
+ SYNTAX INTEGER{
+ phase1(1),
+ phase2(2),
+ phase3(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Description of each input phase entry in the table."
+ ::= { xPDUMainInputVoltagePhaseEntry 1 }
+
+ xPDUMainInputVoltageLtoL OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Line-to-line PDU input voltage when an isolation transformer is present,
+ or -1 if no transformer present in this PDU. Measured in tenths of Volts."
+ ::= { xPDUMainInputVoltagePhaseEntry 2 }
+
+ xPDUMainInputVoltageLtoN OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Line-to-neutral PDU input voltage when an isolation transformer is not present,
+ or -1 if a transformer is present in this PDU. Measured in tenths of Volts."
+ ::= { xPDUMainInputVoltagePhaseEntry 3 }
+
+
+xPDUBypassInputOverVoltThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..30)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold above which a bypass input over voltage condition will be generated.
+ Specified as percent deviation from nominal."
+ ::= { xPDUBypassInput 1 }
+
+xPDUBypassInputUnderVoltThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..30)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold below which an bypass input under voltage condition will be generated.
+ Specified as percent deviation from nominal."
+ ::= { xPDUBypassInput 2 }
+
+-- Bypass Input Voltage Table
+
+xPDUBypassInputVoltageTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of bypass input voltage entries."
+ ::= { xPDUBypassInput 3 }
+
+xPDUBypassInputVoltageTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XPDUBypassInputVoltagePhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of output table entries. The number of
+ entries are the phase entries.
+ The number of entries is contained in the
+ xPDUBypassInputVoltageTableSize OID."
+ ::= { xPDUBypassInput 4 }
+
+ xPDUBypassInputVoltagePhaseEntry OBJECT-TYPE
+ SYNTAX XPDUBypassInputVoltagePhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular bypass input voltage phase."
+ INDEX { xPDUBypassInputVoltagePhaseIndex }
+ ::= { xPDUBypassInputVoltageTable 1 }
+
+ XPDUBypassInputVoltagePhaseEntry ::= SEQUENCE {
+ xPDUBypassInputVoltagePhaseIndex INTEGER,
+ xPDUBypassInputVoltageLtoL INTEGER,
+ xPDUBypassInputVoltageLtoN INTEGER
+ }
+
+ xPDUBypassInputVoltagePhaseIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of each bypass input phase entry in the table."
+ ::= { xPDUBypassInputVoltagePhaseEntry 1 }
+
+ xPDUBypassInputVoltageLtoL OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Line-to-line bypass input voltage, or -1 if no bypass
+ feed is present in this PDU. Measured in tenths of Volts"
+ ::= { xPDUBypassInputVoltagePhaseEntry 2 }
+
+ xPDUBypassInputVoltageLtoN OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Line-to-neutral bypass input voltage, or -1 if no bypass
+ feed is present in this PDU. Measured in tenths of Volts"
+ ::= { xPDUBypassInputVoltagePhaseEntry 3 }
+
+-- UPS Input Table
+
+xPDUUPSInputVoltageTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of UPS input voltage entries."
+ ::= { xPDUUPSInput 1 }
+
+xPDUUPSInputVoltageTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XPDUUPSInputVoltagePhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of UPS input table entries. The number of
+ entries are the phase entries.
+ The number of entries is contained in the
+ xPDUUPSInputVoltageTableSize OID."
+ ::= { xPDUUPSInput 2 }
+
+ xPDUUPSInputVoltagePhaseEntry OBJECT-TYPE
+ SYNTAX XPDUUPSInputVoltagePhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular UPS input voltage phase."
+ INDEX { xPDUUPSInputVoltagePhaseIndex }
+ ::= { xPDUUPSInputVoltageTable 1 }
+
+ XPDUUPSInputVoltagePhaseEntry ::= SEQUENCE {
+ xPDUUPSInputVoltagePhaseIndex INTEGER,
+ xPDUUPSInputVoltageLtoNPresent INTEGER
+ }
+
+ xPDUUPSInputVoltagePhaseIndex OBJECT-TYPE
+ SYNTAX INTEGER{
+ phase1(1),
+ phase2(2),
+ phase3(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Description of each UPS input phase entry in the table."
+ ::= { xPDUUPSInputVoltagePhaseEntry 1 }
+
+ xPDUUPSInputVoltageLtoNPresent OBJECT-TYPE
+ SYNTAX INTEGER {
+ notPresent (1),
+ present (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates whether or not voltage is present at the UPS feed."
+ ::= { xPDUUPSInputVoltagePhaseEntry 2 }
+
+-- System Output
+
+xPDUSystemOutputFrequency OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system output frequency in tenths of Hertz."
+ ::= { xPDUSystemOutput 1 }
+
+xPDUSystemOutputNeutralCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Shows the neutral current measured at the system output in tenths of Amps."
+ ::= { xPDUSystemOutput 2 }
+
+xPDUSystemOutputTotalPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Shows the total system output power in tenths of kW."
+ ::= { xPDUSystemOutput 3 }
+
+xPDUSystemOutputTotalApparentPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Shows the total system output power in tenths of kVA."
+ ::= { xPDUSystemOutput 4 }
+
+xPDUSystemOutputTotalPowerFactor OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates the total power factor of the system output.
+ A value of 100 representing a unity power factor (1.00).
+ Measured in hundredths."
+ ::= { xPDUSystemOutput 5 }
+
+xPDUSystemOutputFrequencyTolerance OBJECT-TYPE
+ SYNTAX INTEGER{
+ freqToleranceOff (1),
+ freqTolerancePointTwo (2),
+ freqTolerancePointFive (3),
+ freqToleranceOne (4),
+ freqToleranceOnePointFive (5),
+ freqToleranceTwo (6),
+ freqToleranceThree (7),
+ freqToleranceFour (8),
+ freqToleranceFive (9),
+ freqToleranceNine (10)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Shows the circuit panel output frequency tolerance in Hertz."
+ ::= { xPDUSystemOutput 6 }
+
+xPDUSystemOutputMaxKWPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Defines 100% load in kW.
+ Purpose is to set to match UPS capabilities."
+ ::= { xPDUSystemOutput 7 }
+
+xPDUSystemOutputOverVoltThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..30)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold above which an output over voltage condition will be generated.
+ Specified as percent deviation from nominal."
+ ::= { xPDUSystemOutput 8 }
+
+xPDUSystemOutputUnderVoltThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..30)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold below which an output under voltage condition will be generated.
+ Specified as percent deviation from nominal."
+ ::= { xPDUSystemOutput 9 }
+
+
+xPDUSystemOutputOverCurrentThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..100)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold above which an over current condition will be generated.
+ Specified as a percent of the panel breaker rating."
+ ::= { xPDUSystemOutput 10 }
+
+xPDUSystemOutputOverCurrentNeutralThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..100)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold above which an Over current neutral condition will be generated.
+ Specified as a percent of the panel breaker rating."
+ ::= { xPDUSystemOutput 11 }
+
+xPDUSystemOutputUnderCurrentThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..100)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold below which an under current condition will be generated.
+ Specified as a percent of the panel breaker rating."
+ ::= { xPDUSystemOutput 12 }
+
+xPDUSystemOutputTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of System Output phase entries."
+ ::= { xPDUSystemOutput 13 }
+
+xPDUSystemOutputTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XPDUSystemOutputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of system output table entries.
+ The number of entries is contained in the
+ xPDUSystemOutputTableSize OID."
+ ::= { xPDUSystemOutput 14 }
+
+ xPDUSystemOutputPhaseEntry OBJECT-TYPE
+ SYNTAX XPDUSystemOutputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular system output phase."
+ INDEX { xPDUSystemOutputPhaseIndex }
+ ::= { xPDUSystemOutputTable 1 }
+
+ XPDUSystemOutputPhaseEntry ::= SEQUENCE {
+ xPDUSystemOutputPhaseIndex INTEGER,
+ xPDUSystemOutputVoltageLtoL INTEGER,
+ xPDUSystemOutputVoltageLtoN INTEGER,
+ xPDUSystemOutputPhaseCurrent INTEGER,
+ xPDUSystemOutputPower INTEGER,
+ xPDUSystemOutputApparentPower INTEGER,
+ xPDUSystemOutputPowerFactor INTEGER
+ }
+
+ xPDUSystemOutputPhaseIndex OBJECT-TYPE
+ SYNTAX INTEGER{
+ phase1(1),
+ phase2(2),
+ phase3(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Description of each output phase entry in the table."
+ ::= { xPDUSystemOutputPhaseEntry 1 }
+
+ xPDUSystemOutputVoltageLtoL OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Line-to-line system output voltage available at the cicuit panel.
+ Measured in tenths of Volts."
+ ::= { xPDUSystemOutputPhaseEntry 2 }
+
+ xPDUSystemOutputVoltageLtoN OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Line-to-neutral system output voltage available at the cicuit panel.
+ Measured in tenths of Volts."
+ ::= { xPDUSystemOutputPhaseEntry 3 }
+
+
+ xPDUSystemOutputPhaseCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "System load current per phase. Measured in tenths of Amps."
+ ::= { xPDUSystemOutputPhaseEntry 4 }
+
+ xPDUSystemOutputPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "System output power per phase. Measured in tenths of kW."
+ ::= { xPDUSystemOutputPhaseEntry 5 }
+
+ xPDUSystemOutputApparentPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "System output power per phase. Measured in tenths of kVA."
+ ::= { xPDUSystemOutputPhaseEntry 6 }
+
+ xPDUSystemOutputPowerFactor OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates the Power Factor of the system output per phase.
+ A value of 100 representing a unity Power Factor (1.00).
+ Measured in hundredths."
+ ::= { xPDUSystemOutputPhaseEntry 7 }
+
+xPDUGroundCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Shows the current measured in the earth ground conductor in tenths of Amps."
+ ::= { xPDUGroundMonitorPoint 1 }
+
+xPDUGroundCurrentThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..50)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold above which a ground current over current
+ condition will be generated. Measured in tenths of Amps."
+ ::= { xPDUGroundMonitorPoint 2 }
+
+-- System Breakers
+
+xPDUSystemBreakerTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of system breaker entries."
+ ::= { xPDUSystemBreakers 1 }
+
+xPDUSystemBreakerTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XPDUSystemBreakerTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of system breaker entries.
+ The number of entries is contained in the
+ xPDUSystemBreakerTableSize OID."
+ ::= { xPDUSystemBreakers 2 }
+
+ xPDUSystemBreakerTableEntry OBJECT-TYPE
+ SYNTAX XPDUSystemBreakerTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular system breaker."
+ INDEX { xPDUSystemBreakerTableIndex }
+ ::= { xPDUSystemBreakerTable 1 }
+
+ XPDUSystemBreakerTableEntry ::= SEQUENCE {
+ xPDUSystemBreakerTableIndex INTEGER,
+ xPDUSystemBreakerDescription DisplayString,
+ xPDUSystemBreakerPosition INTEGER
+ }
+
+ xPDUSystemBreakerTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of system breaker entries in the table."
+ ::= { xPDUSystemBreakerTableEntry 1 }
+
+xPDUSystemBreakerDescription OBJECT-TYPE
+ SYNTAX DisplayString (SIZE (0..79))
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A brief description of the system breakers."
+ ::= { xPDUSystemBreakerTableEntry 2 }
+
+ xPDUSystemBreakerPosition OBJECT-TYPE
+ SYNTAX INTEGER {
+ open (1),
+ closed (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates whether this breaker is open(1) or closed(2)."
+ ::= { xPDUSystemBreakerTableEntry 3 }
+
+-- Branch Breakers (Breaker Panel)
+
+xPDUNumOfBranchBreakers OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of branch breakers in the Panel."
+ ::= { xPDUBranchBreakers 1 }
+
+-- Branch Breakers Table
+
+xPDUBranchBreakerTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of branch breaker entries."
+ ::= { xPDUBranchBreakers 2 }
+
+xPDUBranchBreakerTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XPDUBranchBreakerEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of branch breaker table entries. The
+ number of entries is given by the value of xPDUBranchBreakerTableSize
+ The number of entries is contained in the
+ xPDUBranchBreakerTableSize OID."
+ ::= { xPDUBranchBreakers 3 }
+
+ xPDUBranchBreakerEntry OBJECT-TYPE
+ SYNTAX XPDUBranchBreakerEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular branch breaker."
+ INDEX { xPDUBranchBreakerTableIndex }
+ ::= { xPDUBranchBreakerTable 1 }
+
+ XPDUBranchBreakerEntry ::= SEQUENCE {
+ xPDUBranchBreakerTableIndex INTEGER,
+ xPDUBranchBreakerRating INTEGER,
+ xPDUBranchBreakerRDPFeed INTEGER,
+ xPDUBranchBreakerTieIndicator INTEGER,
+ xPDUBranchBreakerCurrent INTEGER,
+ xPDUBranchBreakerOverCurrentThreshold INTEGER,
+ xPDUBranchBreakerUnderCurrentThreshold INTEGER
+ }
+
+ xPDUBranchBreakerTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of branch breaker entries in the table."
+ ::= { xPDUBranchBreakerEntry 1 }
+
+ xPDUBranchBreakerRating OBJECT-TYPE
+ SYNTAX INTEGER (0..100)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates current rating of this breaker.
+ 0=Breaker is not present.
+ 1=Earth leakage connection.
+ 2=Neutral connection.
+ A value greater than 2 indicates breaker current rating in Amps."
+ ::= { xPDUBranchBreakerEntry 2 }
+
+ xPDUBranchBreakerRDPFeed OBJECT-TYPE
+ SYNTAX INTEGER {
+ remoteDistribution (1),
+ noRemoteDistribution (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates that a breaker position is feeding a remote
+ distribution panel."
+ ::= { xPDUBranchBreakerEntry 3 }
+
+ xPDUBranchBreakerTieIndicator OBJECT-TYPE
+ SYNTAX INTEGER {
+ breakerTied (1),
+ breakerUntied (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates whether or not the breaker pole is physically
+ connected to the breaker immediately below."
+ ::= { xPDUBranchBreakerEntry 4 }
+
+ xPDUBranchBreakerCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates the branch current in tenths of Amps or -1 when not available."
+ ::= { xPDUBranchBreakerEntry 5 }
+
+ xPDUBranchBreakerOverCurrentThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..100)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold above which a branch circuit over current
+ condition will be generated.
+ Specified as a percent of the branch breaker rating."
+ ::= { xPDUBranchBreakerEntry 6 }
+
+ xPDUBranchBreakerUnderCurrentThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..100)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold below which a branch circuit under current
+ condition will be generated.
+ Specified as a percent of the branch breaker rating."
+ ::= { xPDUBranchBreakerEntry 7 }
+
+-- the xPDUInputContacts group
+
+xPDUInputContactNumContacts OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of contacts supported by the PDU."
+ ::= { xPDUInputContacts 1 }
+
+xPDUInputContactTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of input contact entries."
+ ::= { xPDUInputContacts 2 }
+
+xPDUInputContactTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XPDUInputContactEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of contacts supported by the PDU.
+ The number of entries is contained in the
+ xPDUInputContactTableSize OID."
+ ::= { xPDUInputContacts 3 }
+
+xPDUInputContactEntry OBJECT-TYPE
+ SYNTAX XPDUInputContactEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A contact entry containing information for a given contact."
+ INDEX { xPDUInputContactNumber }
+ ::= { xPDUInputContactTable 1 }
+
+XPDUInputContactEntry ::=
+ SEQUENCE {
+ xPDUInputContactNumber INTEGER,
+ xPDUInputContactName DisplayString,
+ xPDUInputContactNormalState INTEGER,
+ xPDUInputContactCurrentState INTEGER
+ }
+
+xPDUInputContactNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An index identifying the contact on the PDU."
+ ::= { xPDUInputContactEntry 1 }
+
+xPDUInputContactName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The description of the purpose/use of the contact."
+ ::= { xPDUInputContactEntry 2 }
+
+xPDUInputContactNormalState OBJECT-TYPE
+ SYNTAX INTEGER {
+ open (1),
+ closed (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The normal operating position of the contact."
+ ::= { xPDUInputContactEntry 3 }
+
+xPDUInputContactCurrentState OBJECT-TYPE
+ SYNTAX INTEGER {
+ open (1),
+ closed (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This value indicates the current state of the contact."
+ ::= { xPDUInputContactEntry 4 }
+
+-- the xPDUOutputRelays group
+
+xPDUOutputRelaysNumRelays OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of output relays supported by the PDU."
+ ::= { xPDUOutputRelays 1 }
+
+xPDUOutputRelaysTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of output relay entries."
+ ::= { xPDUOutputRelays 2 }
+
+xPDUOutputRelayTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XPDUOutputRelayEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of output relays supported by the PDU.
+ The number of entries is contained in the
+ xPDUOutputRelayTableSize OID."
+ ::= { xPDUOutputRelays 3 }
+
+xPDUOutputRelayEntry OBJECT-TYPE
+ SYNTAX XPDUOutputRelayEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A output relay entry containing information for a given contact."
+ INDEX { xPDUOutputRelayNumber }
+ ::= { xPDUOutputRelayTable 1 }
+
+XPDUOutputRelayEntry ::=
+ SEQUENCE {
+ xPDUOutputRelayNumber INTEGER,
+ xPDUOutputRelayName DisplayString,
+ xPDUOutputRelayNormalState INTEGER,
+ xPDUOutputRelayCurrentState INTEGER
+ }
+
+xPDUOutputRelayNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An index identifying the output relay on the PDU."
+ ::= { xPDUOutputRelayEntry 1 }
+
+xPDUOutputRelayName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The description of the purpose/use of the output relay."
+ ::= { xPDUOutputRelayEntry 2 }
+
+xPDUOutputRelayNormalState OBJECT-TYPE
+ SYNTAX INTEGER {
+ open (1),
+ closed (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The normal operating position of the output relay."
+ ::= { xPDUOutputRelayEntry 3 }
+
+xPDUOutputRelayCurrentState OBJECT-TYPE
+ SYNTAX INTEGER {
+ open (1),
+ closed (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This value indicates the current state of the output relay."
+ ::= { xPDUOutputRelayEntry 4 }
+
+-- the xPDUMiscGroup
+
+xPDUEPOMode OBJECT-TYPE
+ SYNTAX INTEGER {
+ armed (1),
+ disarmed (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates whether the EPO System is armed(1) or disarmed(2)."
+ ::= { xPDUMiscGroup 1 }
+
+xPDUTransformTempStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ overtemp (2),
+ noTransformerPresent (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates if the PDU's isolation transformer is over temperature."
+ ::= { xPDUMiscGroup 2 }
+
+xPDUCoolingFanStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ normal (1),
+ failed (2),
+ noCoolingFansPresent (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates if one or more of the PDU's cooling fans have failed."
+ ::= { xPDUMiscGroup 3 }
+
+-- The xATSIdent group
+
+xATSIdentProductName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the transfer switch unit."
+ ::= { xATSIdent 1 }
+
+xATSIdentHardwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware revision of the transfer switch.
+ This value is set at the factory."
+ ::= { xATSIdent 2 }
+
+xATSIdentFirmwareAppRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An ID string identifying the application firmware revision of the transfer switch."
+ ::= { xATSIdent 3 }
+
+xATSIdentFirmwareAppOSRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An ID string identifying the application operating system firmware revision of the transfer switch."
+ ::= { xATSIdent 4 }
+
+xATSIdentFirmwareControllerRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An ID string identifying the transfer switch controller firmware revision."
+ ::= { xATSIdent 5 }
+
+xATSIdentDateOfManufacture OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date when the transfer switch was manufactured in mm/dd/yyyy format.
+ This value is set at the factory."
+ ::= { xATSIdent 6 }
+
+xATSIdentModelNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the model number of the transfer switch.
+ This value is set at the factory."
+ ::= { xATSIdent 7 }
+
+xATSIdentSerialNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the serial number of the transfer switch.
+ This value is set at the factory."
+ ::= { xATSIdent 8 }
+
+-- The xATSDevice group
+
+xATSDeviceServiceType OBJECT-TYPE
+ SYNTAX INTEGER {
+ threeWire (1),
+ fourWire (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The type of utility input to the transfer switch.
+ Either 3 wires (delta), or 4 wires (wye)."
+ ::= { xATSDevice 1 }
+
+xATSDeviceNominalVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The nominal line-to-neutral system voltage.
+ Measured in Volts, line-to-line for a 3-wire service or
+ line-to-neutral for a 4-wire service. -1 if not available."
+ ::= { xATSDevice 2 }
+
+xATSDeviceNominalFrequency OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The nominal system frequency. Measured in tenths of Hertz.
+ -1 if not available."
+ ::= { xATSDevice 3 }
+
+xATSDeviceTransferSwitchRating OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The rating of the transfer switch.
+ Measured in Amps."
+ ::= { xATSDevice 4 }
+
+xATSDeviceDCBackUpPresent OBJECT-TYPE
+ SYNTAX INTEGER{
+ yes (1),
+ no (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates if a DC backup is present or not."
+ ::= { xATSDevice 5 }
+
+-- The xATS Switch Status group
+
+xATSSwitchStatusSelectedSource OBJECT-TYPE
+ SYNTAX INTEGER{
+ none (1),
+ source1 (2),
+ source2 (3),
+ fault (4),
+ unknown (5)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The source which is currently selected, i.e. supplying power to the load."
+ ::= { xATSSwitchStatus 1 }
+
+xATSSwitchStatusOperationalMode OBJECT-TYPE
+ SYNTAX INTEGER{
+ automatic (1),
+ notInAutoAbnormal (2),
+ notInAuto (3),
+ unknown (4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current operating mode of the transfer switch. When the ATS is in
+ automatic mode, generator starting and ATS transferring is all done automatically
+ as needed based on the state of source 1. Automatic operation is halted when the
+ ATS is in either of the notInAuto modes.
+ A mode of notInAuto indicates that the automatic operation switch is in the
+ disabled position, as indicated by the xATSSwitchStatusAutomaticOperationSwitch OID.
+ The notInAutoAbnormal condition indicates that an abnormal
+ condition has caused the transfer switch to halt automatic operation.
+ In this case, traps can indicate the exact problem. In the case of
+ notInAutoAbnormal, refer to the operation manual for details
+ on how debug the condition and restore automatic operation."
+ ::= { xATSSwitchStatus 2 }
+
+xATSSwitchStatusAutomaticOperationSwitch OBJECT-TYPE
+ SYNTAX INTEGER{
+ disabled (1),
+ enabled (2),
+ unknown (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The position of the automatic operation switch on the front of the transfer switch."
+ ::= { xATSSwitchStatus 3 }
+
+xATSSwitchStatusEngineStartSignal OBJECT-TYPE
+ SYNTAX INTEGER{
+ run (1),
+ stop (2),
+ unknown (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The position of the Start/Stop contact which signals the generator
+ engine to start/run. When the ATS is in automatic mode,
+ generator starting/stopping is under ATS control."
+ ::= { xATSSwitchStatus 4 }
+
+-- The xATS Switch Setting group
+
+xATSSwitchSettingsLowVoltageTransferPoint OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The lowest acceptable voltage condition at source 1.
+ When any phase of source 1 is lower than this voltage,
+ source quality is considered bad and the generator run signal
+ is asserted to begin generator operation.
+ Specified in volts, line-to-line for a 3-wire service or
+ line-to-neutral for a 4-wire service.
+ -1 if not available."
+ ::= { xATSSwitchSettings 1 }
+
+xATSSwitchSettingsHighVoltageTransferPoint OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The highest acceptable voltage condition at source 1.
+ When any phase of source 1 is greater than this voltage,
+ source quality is considered bad and the generator run signal
+ is asserted to begin generator operation.
+ Specified in volts, line-to-line for a 3-wire service or
+ line-to-neutral for a 4-wire service.
+ -1 if not available."
+ ::= { xATSSwitchSettings 2 }
+
+xATSSwitchSettingsMaxFrequencyDeviation OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum acceptable frequency deviation condition from nominal at source 1.
+ When source 1 frequency is outside the specified range,
+ source quality is considered bad and the generator run signal
+ is asserted to begin generator operation.
+ Specified in tenths of Hertz above or below nominal.
+ A value of zero indicates that frequency is ignored when
+ determining source quality.
+ -1 if not available."
+ ::= { xATSSwitchSettings 3 }
+
+xATSSwitchSettingsMinPhaseBalance OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum required phase balance at source 1.
+ When the percentage difference between the minimum and maximum
+ phase voltage measurements at source 1 is greater than this value,
+ source quality is considered bad and the generator run signal
+ is asserted to begin generator operation.
+ Specified as a percentage. A value of zero indicates that phase balance
+ is ignored when determining source quality.
+ -1 if not available."
+ ::= { xATSSwitchSettings 4 }
+
+xATSSwitchSettingsNominalRotation OBJECT-TYPE
+ SYNTAX INTEGER{
+ abc (1),
+ cba (2),
+ any (3),
+ unknown (4)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The nominal phase rotation (or phase sequence) required by the load.
+ For certain types of equipment, such as rotating machinery, phase rotation
+ is critical for proper operation as it determines the direction which motors
+ will rotate (clockwise or counterclockwise).
+ Source quality will be seen as bad if the rotation measured at that
+ ATS input does not match this setting.
+ If this setting is set to any, phase rotation is ignored."
+ ::= { xATSSwitchSettings 5 }
+
+xATSSwitchSettingsAllowClosedTransfer OBJECT-TYPE
+ SYNTAX INTEGER{
+ yes (1),
+ no (2),
+ unknown (3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This setting enables seemless (closed) transfers between sources.
+ When possible, both source 1 and source 2 are closed to the output
+ for a brief time. If closed transfer is not possible within the amount
+ of time specified by the xATSSwitchSettingsMaxSyncTime OID,
+ an open transfer will be executed."
+ ::= { xATSSwitchSettings 6 }
+
+xATSSwitchSettingsMaxSyncTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "When attempting/seeking to perform a closed transfer, this setting defines
+ the maximum time allowed before the transfer switch will give up and perform
+ an open transfer. Specified in seconds.
+ -1 if not available."
+ ::= { xATSSwitchSettings 7 }
+
+xATSSwitchSettingsNeutralTransferTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This setting defines how long both source 1 and source 2 will be
+ disconnected from the output, during an open transfer.
+ Specified in seconds.
+ -1 if not available."
+ ::= { xATSSwitchSettings 8 }
+
+xATSSwitchSettingsClearLatchedAlarms OBJECT-TYPE
+ SYNTAX INTEGER{
+ yes (1),
+ no (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Clears any latched alarm conditions."
+ ::= { xATSSwitchSettings 9 }
+
+xATSSwitchSettingsSetToFactoryDefaults OBJECT-TYPE
+ SYNTAX INTEGER{
+ yes (1),
+ no (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Sets all transfer switch settings to factory default values."
+ ::= { xATSSwitchSettings 10 }
+
+
+-- The xATSSwitchTimers group
+
+ xATSSwitchTimersTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of transfer switch timer entries."
+ ::= { xATSSwitchTimers 1 }
+
+ xATSSwitchTimersTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XATSSwitchTimersEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of timers supported by ATS.
+ The number of entries is contained in the xATSSwitchTimersTableSize OID."
+ ::= { xATSSwitchTimers 2 }
+
+ xATSSwitchTimersEntry OBJECT-TYPE
+ SYNTAX XATSSwitchTimersEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information about an individual ATS timer."
+ INDEX { xATSSwitchTimersIndex }
+ ::= { xATSSwitchTimersTable 1 }
+
+ XATSSwitchTimersEntry ::=
+ SEQUENCE {
+ xATSSwitchTimersIndex INTEGER,
+ xATSSwitchTimersName DisplayString,
+ xATSSwitchTimersAbort INTEGER,
+ xATSSwitchTimersStatus INTEGER,
+ xATSSwitchTimersRemainingTime INTEGER,
+ xATSSwitchTimersDelaySetting INTEGER
+ }
+
+xATSSwitchTimersIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of timer entries in the table."
+ ::= { xATSSwitchTimersEntry 1 }
+
+xATSSwitchTimersName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Name of the individual timer.Refer to ATS operation manual,
+ or on-line help, for detailed descriptions of ATS timers."
+ ::= { xATSSwitchTimersEntry 2 }
+
+xATSSwitchTimersAbort OBJECT-TYPE
+ SYNTAX INTEGER{
+ yes (1),
+ no (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This aborts the individual timer."
+ ::= { xATSSwitchTimersEntry 3 }
+
+xATSSwitchTimersStatus OBJECT-TYPE
+ SYNTAX INTEGER{
+ inactive (1),
+ active (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the individual timer. Designates whether this timer
+ entry is currently running or inactive."
+ ::= { xATSSwitchTimersEntry 4 }
+
+xATSSwitchTimersRemainingTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The time remaining for this timer entry.
+ Specified in seconds."
+ ::= { xATSSwitchTimersEntry 5 }
+
+xATSSwitchTimersDelaySetting OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The delay settings associated with this timer entry.
+ When this timer entry is active, the timer value must exceed this setting
+ before the ATS behavior associated with this timer is executed.
+ Refer to ATS operation manual, or on-line help, for detailed
+ descriptions of ATS timers."
+ ::= { xATSSwitchTimersEntry 6 }
+
+-- The xATSSwitchBlockMap group
+
+ xATSSwitchBlockMapTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of blocking map entries, or how many ATS actions can be blocked."
+ ::= { xATSSwitchBlockMap 1 }
+
+ xATSSwitchBlockMapTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XATSSwitchBlockMapEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of blocking maps supported by the ATS.
+ The number of entries is contained in the xATSSwitchBlockMapTableSize OID."
+ ::= { xATSSwitchBlockMap 2 }
+
+ xATSSwitchBlockMapEntry OBJECT-TYPE
+ SYNTAX XATSSwitchBlockMapEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information about a specific ATS blocking map."
+ INDEX { xATSSwitchBlockMapIndex }
+ ::= { xATSSwitchBlockMapTable 1 }
+
+ XATSSwitchBlockMapEntry ::=
+ SEQUENCE {
+ xATSSwitchBlockMapIndex INTEGER,
+ xATSSwitchBlockMapName DisplayString,
+ xATSSwitchBlockMapStatus INTEGER,
+ xATSSwitchBlockMapSetting INTEGER
+ }
+
+ xATSSwitchBlockMapIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of blocking map entries in the table."
+ ::= { xATSSwitchBlockMapEntry 1 }
+
+ xATSSwitchBlockMapName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A string describing the ATS action to be blocked."
+ ::= { xATSSwitchBlockMapEntry 2 }
+
+ xATSSwitchBlockMapStatus OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Represents the status of this blocking map entry, in bit-mapped format.
+ A non-zero value indicates that this entry's ATS action is currently being blocked.
+ The bit(s) set indicate which input(s) are causing the blocking (bit0, bit1, etc).
+
+ bit 0 - Contact 1
+ bit 1 - Contact 2
+ bit 2 - Contact 3
+ bit 3 - Contact 4."
+ ::= { xATSSwitchBlockMapEntry 3 }
+
+ xATSSwitchBlockMapSetting OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This setting designates the inputs that block the ATS action
+ The mapping is specified as a bit-field, where each bit set indicates
+ the input that blocks the ATS action associated with the entry.
+
+ bit 0 - Contact 1
+ bit 1 - Contact 2
+ bit 2 - Contact 3
+ bit 3 - Contact 4."
+ ::= { xATSSwitchBlockMapEntry 4 }
+
+-- The xATSSwitchStatistics group
+
+ xATSSwitchStatisticsTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of transfer switch statistics entries."
+ ::= { xATSSwitchStatistics 1 }
+
+ xATSSwitchStatisticsTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XATSSwitchStatisticsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of statistics supported by ATS.
+ The number of entries is contained in the xATSSwitchStatisticsTableSize OID."
+ ::= { xATSSwitchStatistics 2 }
+
+ xATSSwitchStatisticsEntry OBJECT-TYPE
+ SYNTAX XATSSwitchStatisticsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information about an individual ATS statistic."
+ INDEX { xATSSwitchStatisticsIndex }
+ ::= { xATSSwitchStatisticsTable 1 }
+
+ XATSSwitchStatisticsEntry ::=
+ SEQUENCE {
+ xATSSwitchStatisticsIndex INTEGER,
+ xATSSwitchStatisticsName DisplayString,
+ xATSSwitchStatisticsValue DisplayString,
+ xATSSwitchStatisticsReset INTEGER
+ }
+
+ xATSSwitchStatisticsIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Index of ATS statistics entries in the table."
+ ::= { xATSSwitchStatisticsEntry 1 }
+
+ xATSSwitchStatisticsName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This is the name of the ATS statistic associated with this entry."
+ ::= { xATSSwitchStatisticsEntry 2 }
+
+ xATSSwitchStatisticsValue OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This is the value of the ATS statistic associated with this entry."
+ ::= { xATSSwitchStatisticsEntry 3 }
+
+ xATSSwitchStatisticsReset OBJECT-TYPE
+ SYNTAX INTEGER{
+ yes (1),
+ no (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This will reset the individual ATS statistic associated with this entry."
+ ::= { xATSSwitchStatisticsEntry 4 }
+
+-- The xATS Source 1 group
+
+xATSSource1Name OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "String used to identify source 1."
+ ::= { xATSSource1 1 }
+
+xATSSource1Position OBJECT-TYPE
+ SYNTAX INTEGER{
+ open (1),
+ closed (2),
+ tripped (3),
+ unknown (4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current position of the switch at source 1."
+ ::= { xATSSource1 2 }
+
+xATSSource1Frequency OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The frequency at source 1 in tenths of Hertz.
+ -1 if unavailable."
+ ::= { xATSSource1 3 }
+
+xATSSource1Quality OBJECT-TYPE
+ SYNTAX INTEGER{
+ sourceGood (1),
+ lowVoltage (2),
+ highVoltage (3),
+ phaseImbalance (4),
+ freqOutOfRange (5),
+ badRotation (6),
+ unknown (7)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current line quality of source 1."
+ ::= { xATSSource1 4 }
+
+xATSSource1Rotation OBJECT-TYPE
+ SYNTAX INTEGER{
+ abc (1),
+ cba (2),
+ unknown (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The phase rotation measured at the source 1 input of the ATS.
+ The sequence is a reference to the order in which the three phases
+ pass the zero-crossing boundary in time."
+ ::= { xATSSource1 5 }
+
+xATSSource1TableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of input voltage entries at the source 1 input of the ATS."
+ ::= { xATSSource1 6 }
+
+ xATSSource1Table OBJECT-TYPE
+ SYNTAX SEQUENCE OF XATSSource1PhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of voltage table entries for source 1. The number of
+ entries are the phase entries. The number of entries is contained in the
+ xATSSource1TableSize OID."
+ ::= { xATSSource1 7 }
+
+ xATSSource1PhaseEntry OBJECT-TYPE
+ SYNTAX XATSSource1PhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular input voltage phase at the source 1 input of the ATS."
+ INDEX { xATSSource1Index }
+ ::= { xATSSource1Table 1 }
+
+ XATSSource1PhaseEntry ::= SEQUENCE {
+ xATSSource1Index INTEGER,
+ xATSSource1VoltageLtoL INTEGER,
+ xATSSource1VoltageLtoN INTEGER
+ }
+
+ xATSSource1Index OBJECT-TYPE
+ SYNTAX INTEGER{
+ phase1(1),
+ phase2(2),
+ phase3(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Description of each phase utilized at source 1."
+ ::= { xATSSource1PhaseEntry 1 }
+
+ xATSSource1VoltageLtoL OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Source 1 line-to-line input voltage.
+ Measured in tenths of Volts."
+ ::= { xATSSource1PhaseEntry 2 }
+
+ xATSSource1VoltageLtoN OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Source 1 line-to-neutral input voltage.
+ Measured in tenths of Volts. -1 for a 3-wire service type."
+ ::= { xATSSource1PhaseEntry 3 }
+
+-- The xATS Source 2 group
+
+xATSSource2Name OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "String used to identify source 2."
+ ::= { xATSSource2 1 }
+
+xATSSource2Position OBJECT-TYPE
+ SYNTAX INTEGER{
+ open (1),
+ closed (2),
+ tripped (3),
+ unknown (4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current position of the switch at source 2."
+ ::= { xATSSource2 2 }
+
+xATSSource2Frequency OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The frequency at source 2 in tenths of Hertz.
+ -1 if not available."
+ ::= { xATSSource2 3 }
+
+xATSSource2Quality OBJECT-TYPE
+ SYNTAX INTEGER{
+ sourceGood (1),
+ lowVoltage (2),
+ highVoltage (3),
+ phaseImbalance (4),
+ freqOutOfRange (5),
+ badRotation (6),
+ unknown (7)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current line quality of source 2."
+ ::= { xATSSource2 4 }
+
+xATSSource2Rotation OBJECT-TYPE
+ SYNTAX INTEGER{
+ abc (1),
+ cba (2),
+ unknown (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The phase rotation measured at the source 2 input of the ATS.
+ -1 if not available."
+ ::= { xATSSource2 5 }
+
+xATSSource2TableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of input voltage entries at the source 2 input of the ATS."
+ ::= { xATSSource2 6 }
+
+ xATSSource2Table OBJECT-TYPE
+ SYNTAX SEQUENCE OF XATSSource2PhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of voltage table entries for the source 2. The number of
+ entries are the phase entries. The number of entries is contained in the
+ xATSSource2TableSize OID."
+ ::= { xATSSource2 7 }
+
+ xATSSource2PhaseEntry OBJECT-TYPE
+ SYNTAX XATSSource2PhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular input voltage phase at the source 2 input of the ATS."
+ INDEX { xATSSource2Index }
+ ::= { xATSSource2Table 1 }
+
+ XATSSource2PhaseEntry ::= SEQUENCE {
+ xATSSource2Index INTEGER,
+ xATSSource2VoltageLtoL INTEGER,
+ xATSSource2VoltageLtoN INTEGER
+ }
+
+ xATSSource2Index OBJECT-TYPE
+ SYNTAX INTEGER{
+ phase1(1),
+ phase2(2),
+ phase3(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Description of each phase utilized at the source 2."
+ ::= { xATSSource2PhaseEntry 1 }
+
+ xATSSource2VoltageLtoL OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Source 2 line-to-line input voltage.
+ Measured in tenths of Volts."
+ ::= { xATSSource2PhaseEntry 2 }
+
+ xATSSource2VoltageLtoN OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Source 2 line-to-neutral input voltage.
+ Measured in tenths of Volts. -1 for a 3-wire service type."
+ ::= { xATSSource2PhaseEntry 3 }
+
+-- The xATSSystemOutput
+
+xATSSystemOutputFrequency OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system output frequency in tenths of Hertz."
+ ::= { xATSSystemOutput 1 }
+
+xATSSystemOutputTotalPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Shows the total system output power in tenths of kW."
+ ::= { xATSSystemOutput 2 }
+
+xATSSystemOutputTotalApparentPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Shows the total system output power in tenths of kVA."
+ ::= { xATSSystemOutput 3 }
+
+xATSSystemOutputTotalPowerFactor OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates the total power factor of the system output.
+ A value of 100 representing a unity power factor (1.00)
+ Specified in hundredths."
+ ::= { xATSSystemOutput 4 }
+
+xATSSystemOutputFrequencyTolerance OBJECT-TYPE
+ SYNTAX INTEGER{
+ freqToleranceOff (1),
+ freqTolerancePointTwo (2),
+ freqTolerancePointFive (3),
+ freqToleranceOne (4),
+ freqToleranceOnePointFive (5),
+ freqToleranceTwo (6),
+ freqToleranceThree (7),
+ freqToleranceFour (8),
+ freqToleranceFive (9),
+ freqToleranceNine (10)
+
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Shows the panel output frequency tolerance in +/- Hertz."
+ ::= { xATSSystemOutput 5 }
+
+xATSSystemOutputOverVoltThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold above which an output over voltage condition will be generated.
+ Specified as tenths of percent deviation from nominal.
+ A value of zero indicates that the threshold is disabled."
+ ::= { xATSSystemOutput 6 }
+
+xATSSystemOutputUnderVoltThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold below which an output under voltage condition will be generated.
+ Specified as tenths of percent deviation from nominal.
+ A value of zero indicates that the threshold is disabled."
+ ::= { xATSSystemOutput 7 }
+
+xATSSystemOutputOverCurrentThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..100)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold above which an over current condition will be generated.
+ Specified as a percent of the transfer switch rating (xATSDeviceTransferSwitchRating OID).
+ A value of zero indicates that the threshold is disabled."
+ ::= { xATSSystemOutput 8 }
+
+xATSSystemOutputUnderCurrentThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..100)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold below which an under current condition will be generated.
+ Specified as a percent of the transfer switch rating (xATSDeviceTransferSwitchRating OID).
+ A value of zero indicates that the threshold is disabled."
+ ::= { xATSSystemOutput 9 }
+
+xATSSystemOutputAlarmDelayThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Delay the generation of an output alarm.
+ Specified in seconds."
+ ::= { xATSSystemOutput 10 }
+
+xATSSystemOutputTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of system output phase entries."
+ ::= { xATSSystemOutput 11 }
+
+xATSSystemOutputTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XATSSystemOutputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of system output table entries.
+ The number of entries is contained in the xATSSystemOutputTableSize OID."
+ ::= { xATSSystemOutput 12 }
+
+ xATSSystemOutputPhaseEntry OBJECT-TYPE
+ SYNTAX XATSSystemOutputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular system output phase."
+ INDEX { xATSSystemOutputPhaseIndex }
+ ::= { xATSSystemOutputTable 1 }
+
+ XATSSystemOutputPhaseEntry ::= SEQUENCE {
+ xATSSystemOutputPhaseIndex INTEGER,
+ xATSSystemOutputVoltageLtoL INTEGER,
+ xATSSystemOutputVoltageLtoN INTEGER,
+ xATSSystemOutputPhaseCurrent INTEGER,
+ xATSSystemOutputPower INTEGER,
+ xATSSystemOutputApparentPower INTEGER,
+ xATSSystemOutputPowerFactor INTEGER
+ }
+
+ xATSSystemOutputPhaseIndex OBJECT-TYPE
+ SYNTAX INTEGER{
+ phase1(1),
+ phase2(2),
+ phase3(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Description of each system output phase utilized in this device."
+ ::= { xATSSystemOutputPhaseEntry 1 }
+
+ xATSSystemOutputVoltageLtoL OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Line-to-line system output voltage, measured in tenths of Volts, available at the circuit panel.
+ -1 if not available."
+ ::= { xATSSystemOutputPhaseEntry 2 }
+
+ xATSSystemOutputVoltageLtoN OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Line-to-neutral system output voltage, measured in tenths of Volts, available at the circuit panel.
+ -1 for a 3-wire service type or if not available."
+ ::= { xATSSystemOutputPhaseEntry 3 }
+
+ xATSSystemOutputPhaseCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "System load current per phase. Measured in Amps.
+ -1 if not available."
+ ::= { xATSSystemOutputPhaseEntry 4 }
+
+ xATSSystemOutputPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "System output power per phase. Measured in tenths of kW."
+ ::= { xATSSystemOutputPhaseEntry 5 }
+
+ xATSSystemOutputApparentPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "system output power per phase. Measured in tenths of kVA."
+ ::= { xATSSystemOutputPhaseEntry 6 }
+
+ xATSSystemOutputPowerFactor OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "indicates the power factor of the system output per phase.
+ A value of 100 representing a unity power factor (1.00).
+ Measured in hundredths."
+ ::= { xATSSystemOutputPhaseEntry 7 }
+
+-- xATS TestingStatus group
+
+xATSTestingStatusSelectTestProcess OBJECT-TYPE
+ SYNTAX INTEGER {
+ engineStartTest (1),
+ systemLoadTest (2),
+ generatorHoldTest (3),
+ cancelTest (4)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Type of tests that can be selected when no test has been scheduled.
+ engineStartTest and systemLoadTest may be selected when no tests
+ are running. Tests that are selected may be cancelled manually."
+ ::= { xATSTestingStatus 1 }
+
+xATSTestingStatusTestStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ noTestInProcess (1),
+ testPending (2),
+ startingEngine (3),
+ engineWarmingUp (4),
+ awaitingTransferToS2 (5),
+ testingWithLoad (6),
+ awaitingRetransferToS1 (7),
+ testingWithoutLoad (8),
+ stoppingEngine (9),
+ holdingOnGenerator (10)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The present system test status/state."
+ ::= { xATSTestingStatus 2 }
+
+xATSTestingStatusProfileWarmupTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The amount of time that the generator will warm up during a test.
+ This is portion of the test when the xATSTestingStatusTestStatus
+ OID returns the value engineWarmingUp.
+ Specified in seconds."
+ ::= { xATSTestingStatus 3 }
+
+xATSTestingStatusProfileLoadedTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The amount of time that ATS will apply the system load to the generator
+ during a system load test.
+ This is portion of the test when the xATSTestingStatusTestStatus
+ OID returns the value testingWithLoad.
+ Specified in minutes."
+ ::= { xATSTestingStatus 4 }
+
+xATSTestingStatusProfileUnloadedTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The amount of time that the generator will run following the warm up
+ portion of a start test, or the loaded portion of a load test.
+ This is portion of the test when the xATSTestingStatusTestStatus
+ OID returns the value testingWithoutLoad.
+ Specified in seconds."
+ ::= { xATSTestingStatus 5 }
+
+-- xATS TestingResults group
+
+xATSTestingResultsLastDateOfTest OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Date of the last test that was performed, either scheduled or manual.
+ Test results are available in the xATSTestingResultsLastResult OID.
+ Specified in the dd/mm/yyyy format, or 'none' if not available."
+ ::= { xATSTestingResults 1 }
+
+xATSTestingResultsLastResult OBJECT-TYPE
+ SYNTAX INTEGER {
+ startTestPassed (1),
+ loadTestPassed (2),
+ startSignalFailure (3),
+ failedGenNotInAuto (4),
+ failedGenEmerStop (5),
+ failedGenShutdown (6),
+ failedGenDidNotStart (7),
+ failedS2NeverGood (8),
+ genFailedDuringWarmup (9),
+ failureOnXferToS1 (10),
+ genFailedLoaded (11),
+ failureOnRexferToS2 (12),
+ genFailedToStop (13),
+ failedAtsInternalFault (14),
+ failedAtsNotInAuto (15),
+ cancelledManualTest (16),
+ cancelledScheduledTest (17)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The result of the last ATS/generator system test."
+ ::= { xATSTestingResults 2 }
+
+xATSTestingResultsTestLastTestTime OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Time of day at which the last test was performed, either scheduled or manual.
+ Test results are available in the xATSTestingResultsLastResult OID.
+ Specified in the hh:mm:ss format, or 'none' if not available."
+ ::= { xATSTestingResults 3 }
+
+xATSTestingResultsLastCrankDuration OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The time spent cranking the generator before it started during the last test.
+ Specified in seconds, or -1 if not available."
+ ::= { xATSTestingResults 4 }
+
+xATSTestingResultsLastWarmupDuration OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The time spent in the engineWarmingUp state during the last system test.
+ Specified in seconds, or -1 if not available."
+ ::= { xATSTestingResults 5 }
+
+xATSTestingResultsLastLoadedDuration OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The time spent in the testingWithLoad state during the last system test.
+ Specified in seconds, or -1 if not available."
+ ::= { xATSTestingResults 6 }
+
+xATSTestingResultsLastUnloadedDuration OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The time spent in the testingWithoutLoad state during the last system test.
+ Specified in seconds, or -1 if not available."
+ ::= { xATSTestingResults 7 }
+
+-- xATS TestingSchedule group
+
+xATSTestingScheduleFrequency OBJECT-TYPE
+ SYNTAX INTEGER {
+ never (1),
+ daily (2),
+ weekly (3),
+ monthly (4)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The frequency of running scheduled tests."
+ ::= { xATSTestingSchedule 1 }
+
+xATSTestingScheduleTestDay OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The desired day for the scheduled test. This object applies only
+ when the xATSTestingScheduleFrequency OID is set to weekly or monthly.
+ For weekly test frequency, the string is the day the test will be run.
+ For monthly test frequency, the string indicates the day,
+ and the instance within the month.
+ For example, for monthly frequency: 2nd sunday, 3rd monday, 4th tuesday,
+ for weekly frequency: sunday, monday, tuesday."
+ ::= { xATSTestingSchedule 2 }
+
+xATSTestingScheduleTestTime OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The time of day that the scheduled test will occur.
+ Specified in the format hh:mm."
+ ::= { xATSTestingSchedule 3 }
+
+xATSTestingScheduleTestWithLoadInterval OBJECT-TYPE
+ SYNTAX INTEGER {
+ applyLoadEveryTest (1),
+ neverApplyLoad (2),
+ applyLoadMonthly (3),
+ applyLoadMonthlyDetailed (4)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This setting specifies which system tests should include applying the
+ load to the generator. The applyLoadMonthlyDetailed entry
+ in the list will apply load once, for each month represented in the
+ xATSTestingScheduleTestWithLoadSelectMonth OID."
+ ::= { xATSTestingSchedule 4 }
+
+xATSTestingScheduleTestWithLoadSelectMonth OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The detailed selection for testing with load on a month-by-month basis.
+ This object is applicable when the xATSTestingScheduleTestWithLoadInterval
+ is set to applyLoadMonthlyDetailed. Otherwise this selection will be ignored.
+ Format for this string is a comma-separated entry of months.
+ For example: Jan,Mar,Dec.
+ The string will return 'No Months Scheduled' if no months have been selected."
+ ::= { xATSTestingSchedule 5 }
+
+xATSTestingScheduleNextTestDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date of the next scheduled test, in the format dd-mmm-yyyy."
+ ::= { xATSTestingSchedule 6 }
+
+-- xATSTestingSimulatePowerFail group
+
+xATSTestingSimulatePowerFailTest OBJECT-TYPE
+ SYNTAX INTEGER{
+ cancelSimulation (1),
+ fiveSecondsSimulation (2),
+ tenSecondsSimulation (3),
+ thirtySecondsSimulation (4),
+ oneMinuteSimulation (5),
+ threeMinutesSimulation (6),
+ fiveMinutesSimulation (7),
+ tenMinutesSimulation (8)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This object executes a simulated power failure for the duration indicated.
+ Simulation can be aborted by selecting cancelSimulation."
+ ::= { xATSTestingSimulatePowerFail 1 }
+
+xATSTestingSimulatePowerFailTimeRemaining OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates the time remaining in seconds, for a simulated power failure.
+ a value of zero indicates that simulated power failure is not active."
+ ::= { xATSTestingSimulatePowerFail 2 }
+
+-- The xATS Input Contact group
+
+xATSInputContactNumContacts OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of contacts supported by the ATS."
+ ::= { xATSInputContacts 1 }
+
+xATSInputContactTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of input contact entries."
+ ::= { xATSInputContacts 2 }
+
+xATSInputContactTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XATSContactEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of contacts supported by the ATS.
+ The number of entries is contained in the
+ xATSInputContactTableSize OID."
+ ::= { xATSInputContacts 3 }
+
+ xATSInputContactEntry OBJECT-TYPE
+ SYNTAX XATSContactEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A contact entry containing information for a given contact."
+ INDEX { xATSInputContactNumber }
+ ::= { xATSInputContactTable 1 }
+
+ XATSContactEntry ::=
+ SEQUENCE {
+ xATSInputContactNumber INTEGER,
+ xATSInputContactName DisplayString,
+ xATSInputContactNormalState INTEGER,
+ xATSInputContactCurrentState INTEGER
+ }
+
+ xATSInputContactNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An index identifying the contact on the ATS."
+ ::= { xATSInputContactEntry 1 }
+
+ xATSInputContactName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The description of the purpose/use of the contact."
+ ::= { xATSInputContactEntry 2 }
+
+ xATSInputContactNormalState OBJECT-TYPE
+ SYNTAX INTEGER {
+ open (1),
+ closed (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The normal operating position of the contact."
+ ::= { xATSInputContactEntry 3 }
+
+ xATSInputContactCurrentState OBJECT-TYPE
+ SYNTAX INTEGER {
+ open (1),
+ closed (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This value indicates the current state of the contact."
+ ::= { xATSInputContactEntry 4 }
+
+-- the xATS OutputRelays group
+
+ xATSOutputRelayNumRelays OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of output relays supported by the ATS."
+ ::= { xATSOutputRelays 1 }
+
+ xATSOutputRelayTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of output relay entries."
+ ::= { xATSOutputRelays 2 }
+
+ xATSOutputRelayTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XATSOutputRelayEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of output relays supported by the ATS.
+ The number of entries is contained in the
+ xATSOutputRelayTableSize OID."
+ ::= { xATSOutputRelays 3 }
+
+ xATSOutputRelayEntry OBJECT-TYPE
+ SYNTAX XATSOutputRelayEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A output relay entry containing information for a given contact."
+ INDEX { xATSOutputRelayNumber }
+ ::= { xATSOutputRelayTable 1 }
+
+ XATSOutputRelayEntry ::=
+ SEQUENCE {
+ xATSOutputRelayNumber INTEGER,
+ xATSOutputRelayName DisplayString,
+ xATSOutputRelayNormalState INTEGER,
+ xATSOutputRelayCurrentState INTEGER
+ }
+
+ xATSOutputRelayNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An index identifying the output relay on the ATS."
+ ::= { xATSOutputRelayEntry 1 }
+
+ xATSOutputRelayName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The description of the purpose/use of the output relay."
+ ::= { xATSOutputRelayEntry 2 }
+
+ xATSOutputRelayNormalState OBJECT-TYPE
+ SYNTAX INTEGER {
+ open (1),
+ closed (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The normal operating position of the output relay."
+ ::= { xATSOutputRelayEntry 3 }
+
+ xATSOutputRelayCurrentState OBJECT-TYPE
+ SYNTAX INTEGER {
+ open (1),
+ closed (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This value indicates the current state of the output relay."
+ ::= { xATSOutputRelayEntry 4 }
+
+-- The xATS Generator Ident group
+
+xATSGeneratorIdentModelNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the model number of the generator.
+ This value is set at the factory."
+ ::= { xATSGeneratorIdent 1 }
+
+xATSGeneratorIdentSerialNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the serial number of the generator.
+ This value is set at the factory."
+ ::= { xATSGeneratorIdent 2 }
+
+xATSGeneratorIdentDateofManufacture OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying when the generator was manufactured in mm/dd/yyyy format.
+ This value is set at the factory."
+ ::= { xATSGeneratorIdent 3 }
+
+xATSGeneratorIdentVoltageConfiguration OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The voltage for which the generator's alternator is designed.
+ Specified in Volts line-to-line."
+ ::= { xATSGeneratorIdent 4 }
+
+xATSGeneratorIdentMaxPowerRating OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The max power rating of the generator. Specified in kW."
+ ::= { xATSGeneratorIdent 5 }
+
+xATSGeneratorIdentAlternatorFrequency OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The frequency for which the generator's alternator is designed.
+ Specified in Hertz."
+ ::= { xATSGeneratorIdent 6 }
+
+-- The xATS Generator Status group
+
+xATSGeneratorStatusGeneratorName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name or label for the generator connected to the source 2 of the ATS."
+ ::= { xATSGeneratorStatus 1 }
+
+xATSGeneratorStatusOperational OBJECT-TYPE
+ SYNTAX INTEGER{
+ nocomm (1),
+ off (2),
+ ready (3),
+ starting (4),
+ idle (5),
+ running (6),
+ normalStop (7),
+ emergencyStop (8),
+ notInAuto (9),
+ shutdown (10),
+ unknown (11)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The operational status of the generator. unavailable when unrecognized status is received."
+ ::= { xATSGeneratorStatus 2 }
+
+xATSGeneratorStatusModeSwitchPosition OBJECT-TYPE
+ SYNTAX INTEGER{
+ off (1),
+ manual (2),
+ automatic (3),
+ unknown (4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The position of the generator's auto-mode switch.
+ In automatic mode, the generator is started and stopped via the
+ remote start contact, which has state indicated in the
+ xATSGeneratorStatusRemoteStart OID.
+ In manual mode generator start/stop control is via local command only.
+ Off prevents the generator from running."
+ ::= { xATSGeneratorStatus 3 }
+
+xATSGeneratorStatusRemoteStart OBJECT-TYPE
+ SYNTAX INTEGER{
+ stop (1),
+ run (2),
+ unknown (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the generator's remote start contact, which is
+ provided as an output from the transfer switch to start/stop the
+ generator when in automatic mode."
+ ::= { xATSGeneratorStatus 4 }
+
+-- The xATS Generator Advanced Status group
+
+xATSGeneratorAdvStatusBatteryVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The voltage of the generator's starting battery.
+ Measured in tenths of VDC, or -1 if not available."
+ ::= { xATSGeneratorAdvStatus 1 }
+
+xATSGeneratorAdvStatusOilPressure OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The generator's engine oil pressure.
+ Measured in tenths of Psi or kPa, based on the
+ value of the xATSGeneratorSettingsMetricUnit OID,
+ or -1 if not available."
+ ::= { xATSGeneratorAdvStatus 2 }
+
+xATSGeneratorAdvStatusCoolantTemperature OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Current coolant temperature in the generator.
+ Measured in degrees Celsius or Fahrenheit, based on the
+ value of the xATSGeneratorSettingsMetricUnit OID,
+ or -1 if not available."
+ ::= { xATSGeneratorAdvStatus 3 }
+
+xATSGeneratorAdvStatusEngineRPM OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Current engine speed of the generator.
+ Measured in RPM, or -1 if not available."
+ ::= { xATSGeneratorAdvStatus 4 }
+
+xATSGeneratorAdvStatusOilLevel OBJECT-TYPE
+ SYNTAX INTEGER{
+ ok (1),
+ low (2),
+ unknown (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates adequate oil level in the generator."
+ ::= { xATSGeneratorAdvStatus 5 }
+
+xATSGeneratorAdvStatusCoolantLevel OBJECT-TYPE
+ SYNTAX INTEGER{
+ ok (1),
+ low (2),
+ unknown (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates adequate coolant level in the generator."
+ ::= { xATSGeneratorAdvStatus 6 }
+
+-- The xATS Generator Output group
+
+xATSGeneratorOutputFrequency OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output frequency of the generator.
+ Measured in tenths of Hertz, or -1 if not avaialble."
+ ::= { xATSGeneratorOutput 1 }
+
+xATSGeneratorOutputTotalPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The total output power of the generator.
+ Measured in tenths of tenths of kW, or -1 if not avaialble."
+ ::= { xATSGeneratorOutput 2 }
+
+xATSGeneratorOutputTotalApparentPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The total output power of the generator.
+ Measured in tenths of kVA, or -1 if not avaialble."
+ ::= { xATSGeneratorOutput 3 }
+
+xATSGeneratorOutputTotalPowerFactor OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates the total load power factor of the generator.
+ A value of 100 representing a unity power factor (1.00),
+ or -1 when if not avaialble."
+ ::= { xATSGeneratorOutput 4 }
+
+xATSGeneratorOutputTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of generator output phase entries."
+ ::= { xATSGeneratorOutput 5 }
+
+ xATSGeneratorOutputTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF XATSGeneratorOutputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of generator output table entries.
+ The number of entries is contained in the xATSGeneratorOutputTableSize OID."
+ ::= { xATSGeneratorOutput 6 }
+
+ xATSGeneratorOutputPhaseEntry OBJECT-TYPE
+ SYNTAX XATSGeneratorOutputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular generator output phase."
+ INDEX { xATSGeneratorOutputPhaseIndex }
+ ::= { xATSGeneratorOutputTable 1 }
+
+ XATSGeneratorOutputPhaseEntry ::= SEQUENCE {
+ xATSGeneratorOutputPhaseIndex INTEGER,
+ xATSGeneratorOutputVoltageLtoL INTEGER,
+ xATSGeneratorOutputVoltageLtoN INTEGER,
+ xATSGeneratorOutputPhaseCurrent INTEGER,
+ xATSGeneratorOutputPower INTEGER,
+ xATSGeneratorOutputApparentPower INTEGER,
+ xATSGeneratorOutputPowerFactor INTEGER
+ }
+
+ xATSGeneratorOutputPhaseIndex OBJECT-TYPE
+ SYNTAX INTEGER{
+ phase1(1),
+ phase2(2),
+ phase3(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Description of each generator output phase utilized in this device."
+ ::= { xATSGeneratorOutputPhaseEntry 1 }
+
+ xATSGeneratorOutputVoltageLtoL OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Line-to-line generator output voltage.
+ Measured in Volts, or -1 if not available."
+ ::= { xATSGeneratorOutputPhaseEntry 2 }
+
+ xATSGeneratorOutputVoltageLtoN OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Line-to-neutral generator output voltage.
+ Measured in volts, or -1 if not avaialble."
+ ::= { xATSGeneratorOutputPhaseEntry 3 }
+
+ xATSGeneratorOutputPhaseCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Generator load current per phase.
+ Measured in Amps, or -1 if not avaialble."
+ ::= { xATSGeneratorOutputPhaseEntry 4 }
+
+ xATSGeneratorOutputPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Generator output power per phase.
+ Measured in tenths of kW, or -1 if not avaialble."
+ ::= { xATSGeneratorOutputPhaseEntry 5 }
+
+ xATSGeneratorOutputApparentPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Generator output power per phase.
+ Measured in tenths of kVA, or -1 if not available."
+ ::= { xATSGeneratorOutputPhaseEntry 6 }
+
+ xATSGeneratorOutputPowerFactor OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates the load power factor of the generator output per phase.
+ A value of 100 representing a unity power factor (1.00),
+ or -1 if not avaialble."
+ ::= { xATSGeneratorOutputPhaseEntry 7 }
+
+-- xATS Generator Settings group
+
+xATSGeneratorSettingsVoltageAdjust OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The voltage adjust of the generator.
+ Specified in volts line-to-line,
+ or -1 if not available."
+ ::= { xATSGeneratorSettings 1 }
+
+xATSGeneratorSettingsFrequencyAdjust OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The frequency adjust of the generator.
+ Specified in tenths of Hertz."
+ ::= { xATSGeneratorSettings 2 }
+
+xATSGeneratorSettingsStartDelay OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The delay, in seconds, after the remote run signal is activated
+ before the generator's engine will be cranked to start,
+ or -1 if not available."
+ ::= { xATSGeneratorSettings 3 }
+
+xATSGeneratorSettingsStopDelay OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The delay, in seconds, before the generator will stop
+ after the remote run signal is deactivated,
+ or -1 if not available."
+ ::= { xATSGeneratorSettings 4 }
+
+xATSGeneratorSettingsCrankCycleEnable OBJECT-TYPE
+ SYNTAX INTEGER{
+ disabled (1),
+ enabled (2),
+ unknown (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "When Crank Cycle is enabled, the engine will be cranked up to the time
+ specified by the xATSGeneratorSettingsCrankTime OID.
+ If the generator's engine does not start, there will be a pause as
+ specified by the xATSGeneratorSettingsCrankRestTime OID before the
+ engine will be cranked again. This cycle is repeated as specified by
+ the xATSGeneratorSettingsNumberCrank OID.
+ When crank cycle is disabled, the generator's engine will be
+ cranked continuously until it starts."
+ ::= { xATSGeneratorSettings 5 }
+
+xATSGeneratorSettingsCrankTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The duration of engine cranking, in seconds, when starting the generator.
+ Applicable when the xATSGeneratorSettingsCrankCycleEnable OID is enabled.
+ -1 if not available."
+ ::= { xATSGeneratorSettings 6 }
+
+xATSGeneratorSettingsCrankRestTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The pause duration, in seconds, following an unsuccessful attempt to start the generator.
+ Applicable when the xATSGeneratorSettingsCrankCycleEnable OID is enabled.
+ -1 if not available."
+ ::= { xATSGeneratorSettings 7 }
+
+xATSGeneratorSettingsNumberCrank OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of failed crank attempts before giving up on starting the generator.
+ Applicable when the xATSGeneratorSettingsCrankCycleEnable OID is enabled.
+ -1 if not available."
+ ::= { xATSGeneratorSettings 8 }
+
+xATSGeneratorSettingsMetricUnit OBJECT-TYPE
+ SYNTAX INTEGER{
+ disabled (1),
+ enabled (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Specifies the use of metric units in generator related OIDs, as well
+ as on all other interfaces including the generator's local interface."
+ ::= { xATSGeneratorSettings 9 }
+
+-- xATS generator service group
+
+xATSGeneratorServiceTotalRunHoursLifetime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Total time that the generator engine has been run,
+ over the life of the generator. Measured in hours.
+ -1 if not available."
+ ::= { xATSGeneratorService 1 }
+
+xATSGeneratorServiceEngineStartsLifetime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Number of engine starts over the life of the generator.
+ -1 if not available."
+ ::= { xATSGeneratorService 2 }
+
+xATSGeneratorServiceTotalkWhLifetime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Total kWh of operation over the life of the generator.
+ -1 if not available."
+ ::= { xATSGeneratorService 3 }
+
+xATSGeneratorServiceTotalRunHoursSinceMaintanence OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Total time that the generator engine has been run,
+ since last service maintenance. Measured in tenths of hours.
+ -1 if not available."
+ ::= { xATSGeneratorService 4 }
+
+xATSGeneratorServiceEngineStartsSinceMaintanence OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Number of engine starts since last service maintenance.
+ -1 if not available."
+ ::= { xATSGeneratorService 5 }
+
+xATSGeneratorServiceTotalkWhMaintanence OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Total kWh of operation since last service maintenance.
+ -1 if not available."
+ ::= { xATSGeneratorService 6 }
+
+xATSGeneratorServiceResetRecord OBJECT-TYPE
+ SYNTAX INTEGER{
+ yes (1),
+ no (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Resets the engine start counter, engine run-hours, and kWh values that have
+ accumulated in the generator since last maintenance.
+ Also, the last service date will be reset to the current system date, and
+ any service alarms will be cleared."
+ ::= { xATSGeneratorService 7 }
+
+xATSGeneratorServiceRecordResetDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Date at which the generator's service record was reset, in dd-mmm-yyyy format."
+ ::= { xATSGeneratorService 8 }
+
+xATSGeneratorServiceNextServiceDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Date at which the next generator service is due in dd-mmm-yyyy format.
+ Based on the xATSGeneratorServiceCalendarIntervalThreshold OID
+ or '' if the calander-based threshold is set to off."
+ ::= { xATSGeneratorService 9 }
+
+xATSGeneratorServiceRunHoursUntilServiceDate OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Runhours until the next generator service is due, in hours.
+ Based on the xATSGeneratorServiceRunHoursThreshold OID
+ or -1 if the runhour-based threshold is set to off."
+ ::= { xATSGeneratorService 10 }
+
+xATSGeneratorServiceRunHoursThreshold OBJECT-TYPE
+ SYNTAX INTEGER{
+ disabled (1),
+ runThreshold100Hours (2),
+ runThreshold150Hours (3),
+ runThreshold200Hours (4),
+ runThreshold250Hours (5),
+ runThreshold300Hours (6),
+ runThreshold400Hours (7),
+ runThreshold500Hours (8)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Runhour-based service interval. When the run-hours since
+ service surpasses this threshold, generator service is due."
+ ::= { xATSGeneratorService 11 }
+
+xATSGeneratorServiceCalendarIntervalThreshold OBJECT-TYPE
+ SYNTAX INTEGER{
+ disabled (1),
+ interval1month (2),
+ interval2month (3),
+ interval3month (4),
+ interval6month (5),
+ intervalyearly (6)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Calander-based service interval. When the next service date,
+ as indicated by the xATSGeneratorServiceNextServiceDate OID
+ is in the past, generator is due for service."
+ ::= { xATSGeneratorService 12 }
+
+-- The xATS Generator Fuel system group
+
+xATSGeneratorFuelSystemType OBJECT-TYPE
+ SYNTAX INTEGER{
+ diesel (1),
+ propane (2),
+ naturalGas (3),
+ unknown (4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The type of fuel used by the generator."
+ ::= { xATSGeneratorFuelSystem 1 }
+
+xATSGeneratorFuelSystemTankSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Size of the generator's fuel tank.
+ Specified in gallons or liters, based on the value of the
+ xATSGeneratorSettingsMetricUnit OID, or -1 if not available."
+ ::= { xATSGeneratorFuelSystem 2 }
+
+xATSGeneratorFuelSystemFuelLevel OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Fuel remaining in the generator tank.
+ Measured in percent of tank fill, or -1 if if not available."
+ ::= { xATSGeneratorFuelSystem 3 }
+
+xATSGeneratorFuelSystemRuntimePower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The power value used in the runtime remaining calculation.
+ Measured in tenths of kW, or -1 if not available."
+ ::= { xATSGeneratorFuelSystem 4 }
+
+xATSGeneratorFuelSystemEstimatedRunTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An estimate of available runtime for the generator, based on
+ available fuel as specified in the xATSGeneratorFuelSystemFuelLevel OID
+ and kW load as specified in the xATSGeneratorFuelSystemRuntimePower OID.
+ Measured in tenths of hours, or -1 if not available."
+ ::= { xATSGeneratorFuelSystem 5 }
+
+xATSGeneratorFuelSystemLowRunTimeThreshold OBJECT-TYPE
+ SYNTAX INTEGER{
+ disabled (1),
+ oneHour (2),
+ twoHours (3),
+ threeHours (4),
+ fourHours (5),
+ fiveHours (6),
+ sixHours (7),
+ twelveHours (8),
+ oneDay (9),
+ twoDays (10),
+ threeDays (11),
+ fourDays (12),
+ fiveDays (13),
+ sixDays (14),
+ sevenDays (15)
+
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold below which a low runtime alarm will exist."
+ ::= { xATSGeneratorFuelSystem 6 }
+
+xATSGeneratorFuelSystemVeryLowRunTimeThreshold OBJECT-TYPE
+ SYNTAX INTEGER{
+ disabled (1),
+ oneHour (2),
+ twoHours (3),
+ threeHours (4),
+ fourHours (5),
+ fiveHours (6),
+ sixHours (7),
+ twelveHours (8),
+ oneDay (9),
+ twoDays (10),
+ threeDays (11),
+ fourDays (12),
+ fiveDays (13),
+ sixDays (14),
+ sevenDays (15)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold below which a very low runtime alarm will exist."
+ ::= { xATSGeneratorFuelSystem 7 }
+
+xATSGeneratorFuelSystemLowFuelLevelThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..100)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold below which a low fuel alarm will exist, with a value of 0 indicating disabled.
+ Specified as percent of tank fill."
+ ::= { xATSGeneratorFuelSystem 8 }
+
+xATSGeneratorFuelSystemVeryLowFuelLevelThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..100)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold below which a very low fuel alarm will exist, with a value of 0 indicating disabled.
+ Specified as percent of tank fill."
+ ::= { xATSGeneratorFuelSystem 9 }
+
+-- the software group
+-- the powerNetSubAgent group
+-- the powerNetSoftwareSystem group
+
+powerNetSoftwareSystemDescription OBJECT-TYPE
+ SYNTAX DisplayString (SIZE (0..79))
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A brief description of the PowerNet sub-agent."
+ ::= { powerNetSoftwareSystem 1 }
+
+powerNetSoftwareOid OBJECT-TYPE
+ SYNTAX OBJECT IDENTIFIER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The object identifier of the PowerNet sub-agent."
+ ::= { powerNetSoftwareSystem 2 }
+
+-- powerNetSmuxPeer OBJECT IDENTIFIER ::= { powerNetSoftwareOid 1 }
+-- powerNetDPIPeer OBJECT IDENTIFIER ::= { powerNetSoftwareOid 2 }
+
+powerNetSoftwareSystemUpTime OBJECT-TYPE
+ SYNTAX TimeTicks
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The time that the sub-agent has been running."
+ ::= { powerNetSoftwareSystem 3 }
+
+
+-- powerNetSoftwareConfig group
+
+powerNetSoftwareTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of software modules supporting the UPS."
+ ::= { powerNetSoftwareConfig 1 }
+
+powerNetSoftwareTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF SoftwareEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of the software monitoring the UPS."
+ ::= { powerNetSoftwareConfig 2 }
+
+powerNetSoftwareEntry OBJECT-TYPE
+ SYNTAX SoftwareEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information on a software module."
+ INDEX { moduleNumber }
+ ::= { powerNetSoftwareTable 1 }
+
+SoftwareEntry ::=
+ SEQUENCE {
+ moduleNumber
+ INTEGER,
+ moduleName
+ DisplayString,
+ moduleVersion
+ DisplayString,
+ moduleDate
+ DisplayString
+ }
+
+moduleNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index into the Software Entry Table"
+ ::= { powerNetSoftwareEntry 1 }
+
+moduleName OBJECT-TYPE
+ SYNTAX DisplayString (SIZE (0..79))
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the software module."
+ ::= { powerNetSoftwareEntry 2 }
+
+moduleVersion OBJECT-TYPE
+ SYNTAX DisplayString (SIZE (0..8))
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The version of the software module."
+ ::= { powerNetSoftwareEntry 3 }
+
+moduleDate OBJECT-TYPE
+ SYNTAX DisplayString (SIZE (0..9))
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date of the software module represented as mm-dd-yy."
+ ::= { powerNetSoftwareEntry 4 }
+
+
+-- the ups group
+-- the upsIdent group
+-- the upsBasicIdent
+
+upsBasicIdentModel OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The UPS model name (e.g. 'APC Smart-UPS 600')."
+ ::= { upsBasicIdent 1 }
+
+upsBasicIdentName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "An 8 byte ID string identifying the UPS. This object
+ can be set by the administrator."
+ ::= { upsBasicIdent 2 }
+
+
+-- the upsAdvIdent group
+
+upsAdvIdentFirmwareRevision OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The firmware revision of the UPS system's microprocessor."
+ ::= { upsAdvIdent 1 }
+
+upsAdvIdentDateOfManufacture OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date when the UPS was manufactured in mm/dd/yy format."
+ ::= { upsAdvIdent 2 }
+
+upsAdvIdentSerialNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An 8-character string identifying the serial number of
+ the UPS internal microprocessor. This number is set at
+ the factory. NOTE: This number does NOT correspond to
+ the serial number on the rear of the UPS."
+ ::= { upsAdvIdent 3 }
+
+
+
+-- the upsBattery group
+-- the upsBasicBattery group
+
+upsBasicBatteryStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown(1),
+ batteryNormal(2),
+ batteryLow(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the UPS batteries. A batteryLow(3)
+ value indicates the UPS will be unable to sustain the
+ current load, and its services will be lost if power is
+ not restored. The amount of run time in reserve at the
+ time of low battery can be configured by the
+ upsAdvConfigLowBatteryRunTime."
+ ::= { upsBasicBattery 1 }
+
+upsBasicBatteryTimeOnBattery OBJECT-TYPE
+ SYNTAX TimeTicks
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The elapsed time since the UPS has switched to battery
+ power."
+ ::= { upsBasicBattery 2 }
+
+upsBasicBatteryLastReplaceDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The date when the UPS system's batteries were last replaced
+ in mm/dd/yy format. For Smart-UPS models, this value
+ is originally set in the factory. When the UPS batteries
+ are replaced, this value should be reset by the administrator."
+ ::= { upsBasicBattery 3 }
+
+
+
+-- the upsAdvBattery group
+
+upsAdvBatteryCapacity OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The remaining battery capacity expressed in
+ percent of full capacity."
+ ::= { upsAdvBattery 1 }
+
+upsAdvBatteryTemperature OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current internal UPS temperature expressed in
+ Celsius."
+ ::= { upsAdvBattery 2 }
+
+upsAdvBatteryRunTimeRemaining OBJECT-TYPE
+ SYNTAX TimeTicks
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The UPS battery run time remaining before battery
+ exhaustion."
+ ::= { upsAdvBattery 3 }
+
+upsAdvBatteryReplaceIndicator OBJECT-TYPE
+ SYNTAX INTEGER {
+ noBatteryNeedsReplacing(1),
+ batteryNeedsReplacing(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Indicates whether the UPS batteries need replacing."
+ ::= { upsAdvBattery 4 }
+
+upsAdvBatteryNumOfBattPacks OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of external battery packs connected to the UPS. If
+ the UPS does not use smart cells then the agent reports
+ ERROR_NO_SUCH_NAME."
+ ::= { upsAdvBattery 5 }
+
+upsAdvBatteryNumOfBadBattPacks OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of external battery packs connected to the UPS that
+ are defective. If the UPS does not use smart cells then the
+ agent reports ERROR_NO_SUCH_NAME."
+ ::= { upsAdvBattery 6 }
+
+upsAdvBatteryNominalVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The nominal battery voltage in Volts."
+ ::= { upsAdvBattery 7 }
+
+upsAdvBatteryActualVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The actual battery bus voltage in Volts."
+ ::= { upsAdvBattery 8 }
+
+upsAdvBatteryCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The battery current in Amps."
+ ::= { upsAdvBattery 9 }
+
+upsAdvTotalDCCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The total DC current in Amps."
+ ::= { upsAdvBattery 10 }
+
+
+-- the upsBasicInput group
+
+upsBasicInputPhase OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current AC input phase."
+ ::= { upsBasicInput 1 }
+
+
+-- the upsAdvInput group
+
+upsAdvInputLineVoltage OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current utility line voltage in VAC."
+ ::= { upsAdvInput 1 }
+
+upsAdvInputMaxLineVoltage OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum utility line voltage in VAC over the
+ previous 1 minute period."
+ ::= { upsAdvInput 2 }
+
+upsAdvInputMinLineVoltage OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum utility line voltage in VAC over the
+ previous 1 minute period."
+ ::= { upsAdvInput 3 }
+
+upsAdvInputFrequency OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current input frequency to the UPS system in Hz."
+ ::= { upsAdvInput 4 }
+
+
+upsAdvInputLineFailCause OBJECT-TYPE
+ SYNTAX INTEGER {
+ noTransfer(1),
+ highLineVoltage(2),
+ brownout(3),
+ blackout(4),
+ smallMomentarySag(5),
+ deepMomentarySag(6),
+ smallMomentarySpike(7),
+ largeMomentarySpike(8),
+ selfTest(9),
+ rateOfVoltageChnage(10)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The reason for the occurrence of the last transfer to UPS
+ battery power. The variable is set to:
+ - noTransfer(1) -- if there is no transfer yet.
+ - highLineVoltage(2) -- if the transfer to battery is caused
+ by an over voltage greater than the high transfer voltage.
+ - brownout(3) -- if the duration of the outage is greater than
+ five seconds and the line voltage is between 40% of the
+ rated output voltage and the low transfer voltage.
+ - blackout(4) -- if the duration of the outage is greater than five
+ seconds and the line voltage is between 40% of the rated
+ output voltage and ground.
+ - smallMomentarySag(5) -- if the duration of the outage is less
+ than five seconds and the line voltage is between 40% of the
+ rated output voltage and the low transfer voltage.
+ - deepMomentarySag(6) -- if the duration of the outage is less
+ than five seconds and the line voltage is between 40% of the
+ rated output voltage and ground. The variable is set to
+ - smallMomentarySpike(7) -- if the line failure is caused by a
+ rate of change of input voltage less than ten volts per cycle.
+ - largeMomentarySpike(8) -- if the line failure is caused by
+ a rate of change of input voltage greater than ten volts per cycle.
+ - selfTest(9) -- if the UPS was commanded to do a self test.
+ - rateOfVoltageChange(10) -- if the failure is due to the rate of change of
+ the line voltage."
+ ::= { upsAdvInput 5 }
+
+
+-- the upsBasicOutput group
+
+upsBasicOutputStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown(1),
+ onLine(2),
+ onBattery(3),
+ onSmartBoost(4),
+ timedSleeping(5),
+ softwareBypass(6),
+ off(7),
+ rebooting(8),
+ switchedBypass(9),
+ hardwareFailureBypass(10),
+ sleepingUntilPowerReturn(11),
+ onSmartTrim(12)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current state of the UPS. If the UPS is unable
+ to determine the state of the UPS this variable is set
+ to unknown(1)."
+ ::= { upsBasicOutput 1 }
+
+upsBasicOutputPhase OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current output phase."
+ ::= { upsBasicOutput 2 }
+
+
+-- the upsAdvOutput group
+
+upsAdvOutputVoltage OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output voltage of the UPS system in VAC."
+ ::= { upsAdvOutput 1 }
+
+upsAdvOutputFrequency OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current output frequency of the UPS system in Hz."
+ ::= { upsAdvOutput 2 }
+
+upsAdvOutputLoad OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current UPS load expressed in percent
+ of rated capacity."
+ ::= { upsAdvOutput 3 }
+
+upsAdvOutputCurrent OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current in amperes drawn by the load on the UPS."
+ ::= { upsAdvOutput 4 }
+
+
+-- the upsBasicConfig group
+
+upsBasicConfigNumDevices OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of devices that are plugged into the UPS."
+ ::= { upsBasicConfig 1 }
+
+upsBasicConfigDeviceTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsBasicConfigDeviceEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of devices that are plugged into the UPS.
+ The number of entries is given by the value of
+ upsBasicConfigNumDevices."
+ ::= { upsBasicConfig 2 }
+
+upsBasicConfigDeviceEntry OBJECT-TYPE
+ SYNTAX UpsBasicConfigDeviceEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The devices plugged in to the UPS."
+ INDEX { deviceIndex }
+ ::= { upsBasicConfigDeviceTable 1 }
+
+UpsBasicConfigDeviceEntry ::=
+ SEQUENCE {
+ deviceIndex
+ INTEGER,
+ deviceName
+ DisplayString,
+ vaRating
+ INTEGER,
+ acceptThisDevice
+ INTEGER
+ }
+
+deviceIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of the device that is plugged into the UPS."
+ ::= { upsBasicConfigDeviceEntry 1 }
+
+deviceName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name/description of the device plugged into the UPS."
+ ::= { upsBasicConfigDeviceEntry 2 }
+
+vaRating OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The volt-amp rating of the device plugged into the UPS."
+ ::= { upsBasicConfigDeviceEntry 3 }
+
+acceptThisDevice OBJECT-TYPE
+ SYNTAX INTEGER {
+ yes(1),
+ no(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "An entry is added if yes, the entry is deleted if no."
+ ::= { upsBasicConfigDeviceEntry 4 }
+
+
+
+
+-- the upsAdvConfig group
+
+upsAdvConfigRatedOutputVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The nominal output voltage from the UPS in VAC.
+
+ For a list of allowed values supported by your UPS model,
+ see the UPS User's Manual.
+
+ If a value other than a supported value is provided in a
+ set request, the UPS interprets it as the next lower
+ acceptable value. If the provided value is lower than
+ the lowest acceptable value, the lowest acceptable
+ value is used."
+ ::= { upsAdvConfig 1 }
+
+upsAdvConfigHighTransferVolt OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum line voltage in VAC allowed before the
+ UPS system transfers to battery backup.
+
+ For a list of allowed values supported by your UPS model,
+ see the UPS User's Manual.
+
+ If a value other than a supported value is provided in a
+ set request, the UPS interprets it as a the next higher
+ acceptable value. If the provided value is higher than
+ the highest acceptable value, the highest acceptable
+ value is used."
+ ::= { upsAdvConfig 2 }
+
+upsAdvConfigLowTransferVolt OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum line voltage in VAC allowed before the
+ UPS system transfers to battery backup.
+
+ For a list of allowed values supported by your UPS model,
+ see the UPS User's Manual.
+
+ If a value other than a supported value is provided in a
+ set request, the UPS interprets it as the next lower
+ acceptable value. If the provided value is lower than
+ the lowest acceptable value, the lowest acceptable
+ value is used."
+ ::= { upsAdvConfig 3 }
+
+upsAdvConfigAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ timed(1),
+ atLowBattery(2),
+ never(3),
+ mute(4)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A flag indicating how the UPS should handle audible
+ line fail alarms:
+ timed(1): UPS alarm will sound after a preset timed duration starting
+ from the line fail condition (see OID upsAdvConfigAlarmTimer for the
+ alarm timer value)
+ atLowBattery(2): UPS alarm will sound when the UPS has reached a Low
+ Battery condition during a line fail
+ never(3): Disables the UPS audible alarm
+ mute(4): Mutes the current alarm for some UPSs only when it is in an
+ alarm state and will return to the previously configured option when
+ the UPS recovers from the alarm condition"
+ ::= { upsAdvConfig 4 }
+
+upsAdvConfigAlarmTimer OBJECT-TYPE
+ SYNTAX TimeTicks
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The time after initial line failure at which the UPS
+ begins emitting audible alarms (beeping). This timer is
+ observed only if the value of extControlAlarm is timed(2).
+ Allowed values are 0 or 30 seconds.
+
+ If a value other than a supported value is provided in a
+ set request, the UPS interprets it as a the next lower
+ acceptable value. If the provided value is lower than
+ the lowest acceptable value, the lowest acceptable
+ value is used."
+ ::= { upsAdvConfig 5 }
+
+upsAdvConfigMinReturnCapacity OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum battery capacity required before the UPS will
+ return from a low battery shutdown condition. The capacity is
+ measured from 0% battery capacity (or Low Battery) as a percent
+ of full capacity (100%). In other words, the UPS will not re-energize
+ the output until the battery has charged so that its' capacity is equal
+ to this value.
+
+ For a list of allowed values supported by your UPS model,
+ see the UPS User's Manual.
+
+ If a value other than a supported value is provided in a
+ set request, the UPS interprets it as a the next higher
+ acceptable value. If the provided value is higher than
+ the highest acceptable value, the highest acceptable
+ value is used."
+ ::= { upsAdvConfig 6 }
+
+upsAdvConfigSensitivity OBJECT-TYPE
+ SYNTAX INTEGER {
+ auto(1),
+ low(2),
+ medium(3),
+ high(4)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The sensitivity of the UPS to utility line abnormalities
+ or noises."
+ ::= { upsAdvConfig 7 }
+
+upsAdvConfigLowBatteryRunTime OBJECT-TYPE
+ SYNTAX TimeTicks
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The desired run time of the UPS, in seconds, once the
+ low battery condition is reached. During this time the UPS will
+ produce a constant warning tone which can not be disabled.
+
+ For a list of allowed values supported by your UPS model,
+ see the UPS User's Manual.
+
+ If a value other than a supported value is provided in a set
+ request, the UPS interprets the value as the next higher
+ acceptable value. If the provided value is higher than the
+ highest acceptable value, the highest acceptable value is used."
+ ::= { upsAdvConfig 8 }
+
+upsAdvConfigReturnDelay OBJECT-TYPE
+ SYNTAX TimeTicks
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The delay in seconds after utility line power returns
+ before the UPS will turn on. This value is also used
+ when the UPS comes out of a reboot and before the UPS
+ wakes up from 'sleep' mode.
+
+ For a list of allowed values supported by your UPS model,
+ see the UPS User's Manual.
+
+ If a value other than a supported value is provided in a
+ set request, the UPS interprets it as a the next higher
+ acceptable value. If the provided value is higher than
+ the highest acceptable value, the highest acceptable
+ value is used."
+ ::= { upsAdvConfig 9 }
+
+upsAdvConfigShutoffDelay OBJECT-TYPE
+ SYNTAX TimeTicks
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The delay in seconds the UPS remains on after being told
+ to turn off.
+
+ For a list of allowed values supported by your UPS model,
+ see the UPS User's Manual.
+
+ If a value other than a supported value is provided in a
+ set request, the UPS interprets it as a the next higher
+ acceptable value. If the provided value is higher than
+ the highest acceptable value, the highest acceptable
+ value is used."
+ ::= { upsAdvConfig 10 }
+
+upsAdvConfigUpsSleepTime OBJECT-TYPE
+ SYNTAX TimeTicks
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The time in seconds for the UPS to go to 'sleep' when
+ instructed. When in sleep mode, the UPS will not provide
+ output power regardless of the input line state. Once the
+ specified time has elapsed, output power will be restored.
+
+ This is a configuration setting. The UPS will not go to
+ sleep until told to do so by the manager from a management
+ station.
+
+ Any input value is allowed, however the UPS only recognizes
+ 1/10 of an hour increments. The provided value will be
+ rounded to the closest 1/10 of an hour with one exception:
+ Any value entered between 1 and 540 seconds will be rounded
+ to 360 seconds (or 6 minutes)."
+ ::= { upsAdvConfig 11 }
+
+
+upsAdvConfigSetEEPROMDefaults OBJECT-TYPE
+ SYNTAX INTEGER {
+ noSetEEPROMDefaults(1),
+ setEEPROMDefaults(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "WRITE: Resets the UPS EEPROM variables to default values.
+ READ: returns 0"
+ ::= { upsAdvConfig 12 }
+
+upsAdvConfigDipSwitchSetting OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsAdvConfigDipSwitchEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Current settings of UPS dip switches."
+ ::= { upsAdvConfig 13 }
+
+upsAdvConfigDipSwitchEntry OBJECT-TYPE
+ SYNTAX UpsAdvConfigDipSwitchEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The current setting of one dip switch."
+ INDEX { dipSwitchIndex }
+ ::= { upsAdvConfigDipSwitchSetting 1 }
+
+UpsAdvConfigDipSwitchEntry ::=
+ SEQUENCE {
+ dipSwitchIndex
+ INTEGER,
+ dipSwitchStatus
+ INTEGER
+ }
+
+dipSwitchIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of a UPS dip switch."
+ ::= { upsAdvConfigDipSwitchEntry 1 }
+
+dipSwitchStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ on(1),
+ off(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The setting of a UPS dip switch."
+ ::= { upsAdvConfigDipSwitchEntry 2 }
+
+upsAdvConfigBattExhaustThresh OBJECT-TYPE
+ SYNTAX TimeTicks
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The number of seconds prior to battery exhaustion when the
+ UPS will switch off power to its load."
+ ::= { upsAdvConfig 14 }
+
+upsAdvConfigPassword OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The password entered at the UPS front panel to enable local
+ configuration of the EEProm. If the password is disabled or
+ is not supported, then the agent returns a null string."
+ ::= { upsAdvConfig 15 }
+
+upsAdvConfigAllowedSetTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ApcUpsConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The table listing the allowed values for all discrete
+ configurable UPS variables."
+ ::= { upsAdvConfig 16 }
+
+apcUpsConfigEntry OBJECT-TYPE
+ SYNTAX ApcUpsConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The table entry for a configurable UPS variable."
+ INDEX { apcUpsConfigFieldIndex }
+ ::= { upsAdvConfigAllowedSetTable 1 }
+
+ApcUpsConfigEntry ::= SEQUENCE {
+ apcUpsConfigFieldIndex INTEGER,
+ apcUpsConfigFieldOID OBJECT IDENTIFIER,
+ apcUpsConfigFieldValueRange DisplayString
+ }
+
+apcUpsConfigFieldIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to an eeprom field entry."
+ ::= { apcUpsConfigEntry 1 }
+
+apcUpsConfigFieldOID OBJECT-TYPE
+ SYNTAX OBJECT IDENTIFIER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The OID of the current configurable value."
+ ::= { apcUpsConfigEntry 2 }
+
+apcUpsConfigFieldValueRange OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The discrete set of allowed values of a configurable
+ register. Individual values are delimited by a comma."
+ ::= { apcUpsConfigEntry 3 }
+
+upsAdvConfigBattCabAmpHour OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Configure settings of UPS battery cabinet amp hour setting."
+ ::= { upsAdvConfig 17 }
+
+upsAdvConfigPositionSelector OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ rack (2),
+ tower (3)
+ }
+
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Configure UPS position selector. If the UPS doesn't
+ support this configuration it will report unknown (1).
+ The positions are either rack (2) for rack mounted or
+ tower (3) for tower unit."
+ ::= { upsAdvConfig 18 }
+
+upsAdvConfigOutputFreqRange OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ freqRangeAUTO (2),
+ freqRange60Var1 (3),
+ freqRange60Var3 (4),
+ freqRange50Var1 (5),
+ freqRange50Var3 (6),
+ freqRange60Var10 (7),
+ freqRange50Var10 (8)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Configure the output frequency tolerance range.
+ unknown(1) indicates the output frequency is unknown.
+ freqRangeAUTO(2) configure the output frequency range for automatic.
+ freqRange60Var1(3) configure the output frequency range for 60 +/- 0.1 Hz
+ freqRange60Var3(4) configure the output frequency range for 60 +/- 3.0 Hz
+ freqRange50Var1(5) configure the output frequency range for 50 +/- 0.1 Hz
+ freqRange50Var3(6) configure the output frequency range for 50 +/- 3.0 Hz
+ freqRange60Var10(7) configure the output frequency range for 60 +/- 10 Hz
+ freqRange50Var10(8) configure the output frequency range for 50 +/- 10 Hz"
+ ::= { upsAdvConfig 19 }
+
+upsAdvConfigUPSFail OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ gotoBypass (2),
+ dropLoad (3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Configure the UPS fail action. If UPS fails,
+ and frequency or voltage is out of range it will either
+ GotoBypass (2) or DropLoad (3). This OID will report
+ unknown (1) if it is not supported feature or option."
+ ::= { upsAdvConfig 20 }
+
+upsAdvConfigAlarmRedundancy OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Configure settings of UPS alarm if the redundancy is
+ under the current redundancy. Use -1 for never."
+ ::= { upsAdvConfig 21 }
+
+upsAdvConfigAlarmLoadOver OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Configure settings of UPS alarm if the load is
+ over the current load in kVA. Use -1 for never."
+ ::= { upsAdvConfig 22 }
+
+upsAdvConfigAlarmRuntimeUnder OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Configure settings of UPS alarm if the runtime is
+ under the current time of minutes. Use -1 for never."
+ ::= { upsAdvConfig 23 }
+
+upsAdvConfigVoutReporting OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ voutAUTO (2),
+ vout208 (3),
+ vout240 (4)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Configure the way the UPS scales its output voltage readings.
+ unknown(1) indicates the Vout Reporting is unknown.
+ voutAUTO(2) configure the Vout Reporting for automatic scalling.
+ vout208(3) configure the Vout Reporting for 208 Volts.
+ vout240(4) configure the Vout Reporting for 240 Volts."
+ ::= { upsAdvConfig 24 }
+
+upsAdvConfigNumExternalBatteries OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Configure the number of external batteries connected to the UPS."
+ ::= { upsAdvConfig 25 }
+
+upsAdvConfigSimpleSignalShutdowns OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ disabled (2),
+ enabled (3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Configure Simple Signal shutdown commands from the Simple Signal
+ port to be issued to the UPS.
+ unknown(1) indicates the Simple Signal Shutdown setting is unknown.
+ disabled(2) configure to disable Simple Signal Shutdowns.
+ enabled(3) configure to enable Simple Signal Shutdowns."
+ ::= { upsAdvConfig 26 }
+
+
+-- the upsSyncCtrlGroupConfig group
+
+upsSCGMembershipGroupNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The SCG Membership Group number (MGN) is a 16-bit number allowing
+ up to 65534 separate groups that can be identified and distinguished
+ per IP subnet. Zero and 65535 are not used. The MGN is used in all
+ communication between members of the SCG and a Network Management Card
+ (NMC) will listen and only respond to commands sent to it using its
+ configured SCG ID."
+ ::= { upsSyncCtrlGroupConfig 1 }
+
+upsSCGActiveMembershipStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ enabledSCG (1),
+ disabledSCG (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Membership in the configured SCG can be enabled and
+ disabled. If an NMC is configured for an SCG, but
+ has its membership disabled, all synchronized control commands
+ received will be ignored."
+ ::= { upsSyncCtrlGroupConfig 2 }
+
+upsSCGPowerSynchronizationDelayTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The Power Synchronization Delay Time (PSD) setting is the maximum
+ number of seconds an SCG Initiator will wait for all SCG members to
+ recover utility power before completing the reboot sequence of a
+ reboot or sleep command. If all SCG members are ready to proceed,
+ no additional delay is introduced."
+ ::= { upsSyncCtrlGroupConfig 3 }
+
+upsSCGReturnBatteryCapacityOffset OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A reboot command uses the Initiator�s Return battery Capacity (RBC) to control
+ when the SCG completes this operation. In a Normal Control Operation (NCC) the
+ UPS will only complete the reboot if RBC is reached. Due to normal battery
+ charge rate variations it may be desirable for the Followers to complete the
+ reboot if they are within some range of the Initiator�s RBC when the Initiator
+ is prepared (charged to RBC) to complete the reboot. The Return Battery
+ Capacity Offset (RBCO) defines a percent battery capacity subtracted from an
+ RBC above which a Follower�s battery must be charged for it to complete a
+ reboot. For example, if the Initiator�s RBC is 50% and the Initiator�s RBCO is
+ 5% then a Follower�s battery capacity is within range if it is greater or equal
+ to 45% (50% - 5%) at the time when the Initiator tries to complete the reboot
+ command. The default RBCO is 10%. "
+ ::= { upsSyncCtrlGroupConfig 4 }
+
+upsSCGMultiCastIP OBJECT-TYPE
+ SYNTAX IpAddress
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The MultiCast IP address of the SCG Group."
+ ::= { upsSyncCtrlGroupConfig 5 }
+
+-- the upsSyncCtrlGroupStatus group
+
+upsSCGNumOfGroupMembers OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of active, communicating members in the Sync Control Group (SCG).
+ This variable indicates the number of rows in the SCG Status Table."
+ ::= { upsSyncCtrlGroupStatus 1 }
+
+-- Sync Control Group Status Table
+
+upsSCGStatusTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsSCGStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of SCG status table entries. The number of entries
+ is given by the value of upsSCGNumOfGroupMembers."
+ ::= { upsSyncCtrlGroupStatus 2 }
+
+ upsSCGStatusEntry OBJECT-TYPE
+ SYNTAX UpsSCGStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular SCG Member."
+ INDEX { upsSCGStatusTableIndex }
+ ::= { upsSCGStatusTable 1 }
+
+ UpsSCGStatusEntry ::= SEQUENCE {
+ upsSCGStatusTableIndex INTEGER,
+ upsSCGMemberIP IpAddress,
+ upsSCGACInputStatus INTEGER,
+ upsSCGACOutputStatus INTEGER
+ }
+
+ upsSCGStatusTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of a status entry for an active, communicating SCG member."
+ ::= { upsSCGStatusEntry 1 }
+
+ upsSCGMemberIP OBJECT-TYPE
+ SYNTAX IpAddress
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The IP address of an active, communicating SCG Member."
+ ::= { upsSCGStatusEntry 2 }
+
+ upsSCGACInputStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ acInGood(1),
+ acInBad(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID indicates the AC Input Status of the SCG Member.
+ acInGood(1) indicates the AC Input is within tolerance.
+ acInBad(2) indicates the AC Input is not within tolerance."
+ ::= { upsSCGStatusEntry 3 }
+
+ upsSCGACOutputStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ acOutOn(1),
+ acOutOff(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID indicates the AC Output Status of the SCG Member.
+ acOutOn(1) indicates the UPS output is providing power to the load.
+ acOutOff(2) indicates the UPS output is not providing power to the load. "
+ ::= { upsSCGStatusEntry 4 }
+
+-- the upsBasicState group
+
+upsBasicStateOutputState OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An ASCII string containing the 64 flags representing
+ the current state(s) of the UPS. If the Network Card
+ is unable to determine the state of the UPS, this
+ variable is set to �UNKNOWN�.
+
+ The flags are numbered 1 to 64, read from left to
+ right. The flags are defined as follows:
+
+ Flag 1: Abnormal Condition Present
+ Flag 2: On Battery
+ Flag 3: Low Battery
+ Flag 4: On Line
+
+ Flag 5: Replace Battery
+ Flag 6: Serial Communication Established
+ Flag 7: AVR Boost Active*
+ Flag 8: AVR Trim Active*
+
+ Flag 9: Overload
+ Flag 10: Runtime Calibration
+ Flag 11: Batteries Discharged
+ Flag 12: Manual Bypass
+
+ Flag 13: Software Bypass
+ Flag 14: In Bypass due to Internal Fault
+ Flag 15: In Bypass due to Supply Failure*
+ Flag 16: In Bypass due to Fan Failure*
+
+ Flag 17: Sleeping on a Timer
+ Flag 18: Sleeping until Utility Power Returns
+ Flag 19: On
+ Flag 20: Rebooting
+
+ Flag 21: Battery Communication Lost*
+ Flag 22: Graceful Shutdown Initiated
+ Flag 23: Smart Boost or Smart Trim Fault*
+ Flag 24: Bad Output Voltage*
+
+ Flag 25: Battery Charger Failure*
+ Flag 26: High Battery Temperature
+ Flag 27: Self Test In Progress
+ Flag 28: Low Battery / On Battery
+
+ Flag 29: Graceful Shutdown Issued by Upstream Device
+ Flag 30: Graceful Shutdown Issued by Downstream Device
+ Flag 31: No Batteries Attached*
+ Flag 32: Synchronized command is in progress
+
+ Flag 33: <Not Used>
+ Flag 34: <Not Used>
+ Flag 35: <Not Used>
+ Flag 36: <Not Used>
+
+ Flag 37: <Not Used>
+ Flag 38: <Not Used>
+ Flag 39: <Not Used>
+ Flag 40: <Not Used>
+
+ Flag 41: <Not Used>
+ Flag 42: <Not Used>
+ Flag 43: <Not Used>
+ Flag 44: <Not Used>
+
+ Flag 45: <Not Used>
+ Flag 46: <Not Used>
+ Flag 47: <Not Used>
+ Flag 48: <Not Used>
+
+ Flag 49: <Not Used>
+ Flag 50: <Not Used>
+ Flag 51: <Not Used>
+ Flag 52: <Not Used>
+
+ Flag 53: <Not Used>
+ Flag 54: <Not Used>
+ Flag 55: <Not Used>
+ Flag 56: <Not Used>
+
+ Flag 57: <Not Used>
+ Flag 58: <Not Used>
+ Flag 59: <Not Used>
+ Flag 60: <Not Used>
+
+ Flag 61: <Not Used>
+ Flag 62: <Not Used>
+ Flag 63: <Not Used>
+ Flag 64: <Not Used>"
+
+ ::= { upsBasicState 1 }
+
+-- the upsAdvState group
+
+upsAdvStateAbnormalConditions OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An ASCII string containing the 32 flags representing
+ the current active UPS faults. If the Network Card
+ is unable to determine the values of the flags, this
+ variable is set to �UNKNOWN�. If this variable is not
+ supported by the connected UPS, this variable is set to
+ �NOT SUPPORTED�.
+
+ The flags are numbered from 1 to 32, and read from left to
+ right. The flags are defined as follows:
+
+ Flag 1: Power Module Failure
+ Flag 2: Main Intelligence Module Failure
+ Flag 3: Redundant Intelligence Module Failure
+ Flag 4: Battery Failure
+
+ Flag 5: Load(kVA) Alarm Threshold Violation
+ Flag 6: Redundancy Lost
+ Flag 7: Redundancy Below Alarm Threshold
+ Flag 8: Bypass notin Range; Either Frequency or Voltage
+
+ Flag 9: Bypass Contactor Stuck in Bypass Condition
+ Flag 10: Bypass Contactor Stuck in On-Line Condition
+ Flag 11: In Bypass due to an Internal Fault
+ Flag 12: In Bypass due to an Overload
+
+ Flag 13: In Maintanence Bypass
+ Flag 14: Input Circuit Braker Tripped Open
+ Flag 15: System Level Fan Failure
+ Flag 16: Redundant Intelligent Module in Control
+
+ Flag 17: IIC Inter-Module Communication Failure
+ Flag 18: No Working Power Modules
+ Flag 19: Load Shutdown From Bypass; Input Frequency
+ Flag 20: Runtime Below Alarm Threshold
+
+ Flag 21: Extended Run Frame Fault
+ Flag 22: Output Voltage out of Range
+ Flag 23: UPS Not Synchronized
+ Flag 24: No Batteries Installed
+
+ Flag 25: Battery Voltage High
+ Flag 26: UPS Specific Fault Detected
+ Flag 27: Site Wiring Fault
+ Flag 28: Backfeed Protection Relay Opened
+
+ Flag 29: <Not Used>
+ Flag 30: <Not Used>
+ Flag 31: <Not Used>
+ Flag 32: <Not Used>"
+ ::= { upsAdvState 1 }
+
+upsAdvStateSymmetra3PhaseSpecificFaults OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An ASCII string containing the 64 flags representing
+ the current active UPS specific faults for the Symmetra
+ 3-Phase UPS models. If the Network Card is unable to
+ determine the values of the flags, this variable is set
+ to �UNKNOWN�. If the connected UPS does not use this
+ variable, it is set to �NOT SUPPORTED�.
+
+ The flags are numbered from 1 to 64, and read from left
+ to right. The bits are defined as follows:
+
+ Flag 1: External Switch Gear Failure
+ Flag 2: External Transformer Over Temperature
+ Flag 3: External DC Circuit Breaker Tripped
+ Flag 4: System Power Supply Failure
+
+ Flag 5: Battery Monitor Card Failure
+ Flag 6: Battery Monitor Card Removed
+ Flag 7: XR Communication Card Failure
+ Flag 8: XR Communication Card Removed
+
+ Flag 9: External Switch Gear Monitoring Card Failure
+ Flag 10: External Switch Gear Monitoring Card Removed
+ Flag 11: Internal DC Circiut Breaker Tripped
+ Flag 12: Static Bypass Switch Failure
+
+ Flag 13: System EEPROM Removed
+ Flag 14: System EEPROM Failure
+ Flag 15: UPS in Forced Bypass
+ Flag 16: <Not Used>
+
+ Flag 17: <Not Used>
+ Flag 18: <Not Used>
+ Flag 19: <Not Used>
+ Flag 20: <Not Used>
+
+ Flag 21: <Not Used>
+ Flag 22: <Not Used>
+ Flag 23: <Not Used>
+ Flag 24: <Not Used>
+
+ Flag 25: <Not Used>
+ Flag 26: <Not Used>
+ Flag 27: <Not Used>
+ Flag 28: <Not Used>
+
+ Flag 29: <Not Used>
+ Flag 30: <Not Used>
+ Flag 31: <Not Used>
+ Flag 32: <Not Used>
+
+ Flag 33: <Not Used>
+ Flag 34: <Not Used>
+ Flag 35: <Not Used>
+ Flag 36: <Not Used>
+
+ Flag 37: <Not Used>
+ Flag 38: <Not Used>
+ Flag 39: <Not Used>
+ Flag 40: <Not Used>
+
+ Flag 41: <Not Used>
+ Flag 42: <Not Used>
+ Flag 43: <Not Used>
+ Flag 44: <Not Used>
+
+ Flag 45: <Not Used>
+ Flag 46: <Not Used>
+ Flag 47: <Not Used>
+ Flag 48: <Not Used>
+
+ Flag 49: <Not Used>
+ Flag 50: <Not Used>
+ Flag 51: <Not Used>
+ Flag 52: <Not Used>
+
+ Flag 53: <Not Used>
+ Flag 54: <Not Used>
+ Flag 55: <Not Used>
+ Flag 56: <Not Used>
+
+ Flag 57: <Not Used>
+ Flag 58: <Not Used>
+ Flag 59: <Not Used>
+ Flag 60: <Not Used>
+
+ Flag 61: <Not Used>
+ Flag 62: <Not Used>
+ Flag 63: <Not Used>
+ Flag 64: <Not Used>"
+ ::= { upsAdvState 2 }
+
+upsAdvStateDP300ESpecificFaults OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An ASCII string containing the 64 flags representing
+ the current active UPS specific faults for the Silcon
+ DP300E UPS models. If the Network Card is unable to
+ determine the values of the flags, this variable is set
+ to �UNKNOWN�. If the connected UPS does not use this
+ variable, it is set to �NOT SUPPORTED�.
+
+ The flags are numbered from 1 to 64, and read from left
+ to right. The bits are defined as follows:
+
+ Flag 1: Peak Current Limiter Avtive
+ Flag 2: Bypass Power Supply Fault
+ Flag 3: Delta Current LImiter Active
+ Flag 4: Fan Fault
+
+ Flag 5: High DC warning
+ Flag 6: Inverter Voltage Error
+ Flag 7: Parallel Synchronization Error
+ Flag 8: Second Power Supply Fault
+
+ Flag 9: Internal Power Supply Fault
+ Flag 10: <Not Used>
+ Flag 11: <Not Used>
+ Flag 12: <Not Used>
+
+ Flag 13: <Not Used>
+ Flag 14: Bypass Static Switch High Temperature
+ Flag 15: High Battery Temperature
+ Flag 16: Battery Weak
+
+ Flag 17: <Not Used>
+ Flag 18: System Locked in Operation Mode
+ Flag 19: RAM1 Memory Write Error
+ Flag 20: Memory Write Error
+
+ Flag 21: Communication to VQ Bypass Lost
+ Flag 22: Communication to VQ Output Lost
+ Flag 23: Communication to DMU Lost
+ Flag 24: Communication to Controller Lost
+
+ Flag 25: Communication to Parallel IF Lost
+ Flag 26: External Shutdown Accepted
+ Flag 27: DC Capacitor Charge Error
+ Flag 28: Communication to VQ Mains Lost
+
+ Flag 29: Bypass Synchronization Error
+ Flag 30: Charge Error
+ Flag 31: <Not Used>
+ Flag 32: <Not Used>
+
+ Flag 33: <Not Used>
+ Flag 34: <Not Used>
+ Flag 35: <Not Used>
+ Flag 36: <Not Used>
+
+ Flag 37: <Not Used>
+ Flag 38: <Not Used>
+ Flag 39: <Not Used>
+ Flag 40: <Not Used>
+
+ Flag 41: <Not Used>
+ Flag 42: <Not Used>
+ Flag 43: <Not Used>
+ Flag 44: <Not Used>
+
+ Flag 45: <Not Used>
+ Flag 46: <Not Used>
+ Flag 47: <Not Used>
+ Flag 48: <Not Used>
+
+ Flag 49: <Not Used>
+ Flag 50: <Not Used>
+ Flag 51: <Not Used>
+ Flag 52: <Not Used>
+
+ Flag 53: <Not Used>
+ Flag 54: <Not Used>
+ Flag 55: <Not Used>
+ Flag 56: <Not Used>
+
+ Flag 57: <Not Used>
+ Flag 58: <Not Used>
+ Flag 59: <Not Used>
+ Flag 60: <Not Used>
+
+ Flag 61: <Not Used>
+ Flag 62: <Not Used>
+ Flag 63: <Not Used>
+ Flag 64: <Not Used>"
+ ::= { upsAdvState 3 }
+
+
+-- the upsBasicControl group
+
+upsBasicControlConserveBattery OBJECT-TYPE
+ SYNTAX INTEGER {
+ noTurnOffUps(1),
+ turnOffUpsToConserveBattery(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this variable to turnUpsOffToConserveBattery(2)
+ causes a UPS on battery to be put into 'sleep' mode. The
+ UPS will turn back on when utility power is restored.
+ Attempting to turn off a UPS that is not on battery will
+ result in a badValue error.
+
+ Setting this value to noTurnOffUps(1) has no
+ effect.
+
+ The value noTurnOffUps(1) will always be returned
+ when the variable is read."
+::= { upsBasicControl 1 }
+
+
+
+-- the upsAdvControl group
+
+upsAdvControlUpsOff OBJECT-TYPE
+ SYNTAX INTEGER {
+ noTurnUpsOff(1),
+ turnUpsOff(2),
+ turnUpsOffGracefully(3),
+ turnUpsSyncGroupOff(4),
+ turnUpsSyncGroupOffAfterDelay(5),
+ turnUpsSyncGroupOffGracefully(6)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this variable to turnUpsOff(2) causes
+ the UPS to shut off. When in this state, the UPS
+ will not provide output power regardless of the input
+ line state.
+
+ Setting this variable to turnUpsOffGracefully(3) causes
+ the UPS to shut off after a delay period. This allows the
+ host to shut down in a graceful manner. When in this state,
+ the UPS will not provide output power regardless of the
+ input line state.
+
+ If this UPS is an active member of a Synchronized
+ Control Group (SCG) the turnUpsSyncGroupOff(4) command
+ will perform a Synchronized Turn Off of all active Group
+ members regardless of their current AC output status.
+
+ If this UPS is an active member of a Synchronized
+ Control Group (SCG) the turnUpsSyncGroupOffAfterDelay(5)
+ command will perform a Synchronized Turn Off After Delay
+ of all active Group members regardless of their current
+ AC output status. This unit's Shutdown Delay will be used
+ to execute the Turn Off After Delay command.
+
+ If this UPS is an active member of an SCG, the
+ turnUpsSyncGroupOffGracefully(6) command will perform a
+ Synchronized Turn Off Gracefully of all active Group
+ members regardless of their current AC output status.
+ This unit's Maximum Shutdown Time and Shutdown Delay will
+ be used to execute the Turn Off Gracefully command.
+
+ Setting this value to noTurnUpsOff(1) has no
+ effect.
+
+ The value noTurnUpsOff(1) will always be returned
+ when the variable is read."
+ ::= { upsAdvControl 1 }
+
+upsAdvControlRebootUps OBJECT-TYPE
+ SYNTAX INTEGER {
+ noRebootUps(1),
+ rebootUps(2),
+ rebootUpsGracefully(3),
+ rebootSyncGroupUps(4),
+ rebootSyncGroupUpsGracefully(5)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this variable to rebootUps(2) causes the
+ UPS to shut off and turn back on.
+
+ Setting this variable to rebootUpsGracefully(3) causes the
+ UPS to shut off and turn back on after a delay period.
+ This allows the host to shut down in a graceful manner.
+
+ If this UPS is an active member of a Synchronized Control
+ Group (SCG) the rebootSyncGroupUps(4) command will perform
+ a Synchronized Reboot of all active Group members regardless
+ of their current AC output status. This unit's Power
+ Synchronization Delay, Shutdown Delay, Return Delay,
+ Return Battery Capacity, and Return Battery Capacity Offset
+ will be used to execute the Reboot command.
+
+ If this UPS is an active member of a SCG the
+ rebootSyncGroupUpsGracefully(5) command will perform a
+ Synchronized Reboot of all active Group members regardless
+ of their current AC output status. This unit's Power
+ Synchronization Delay, Maximum Shutdown Time,
+ Shutdown Delay, Return Delay, Return Battery Capacity, and
+ Return Battery Capacity Offset will be used
+ to execute the Reboot command.
+
+ Setting this value to noRebootUps(1) has no effect.
+
+ The value noRebootUps(1) will always be returned
+ when the variable is read."
+ ::= { upsAdvControl 2 }
+
+upsAdvControlUpsSleep OBJECT-TYPE
+ SYNTAX INTEGER {
+ noPutUpsToSleep(1),
+ putUpsToSleep(2),
+ putUpsToSleepGracefully(3),
+ putUpsSyncGroupToSleep(4),
+ putUpsSyncGroupToSleepGracefully(5)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this variable to putUpsToSleep(2) causes
+ the UPS to go to sleep for the time specified by
+ upsAdvConfigUpsSleepTime.
+
+ Setting this variable to putUpsToSleepGracefully(3)
+ causes the UPS to go to sleep for the time specified
+ by upsAdvConfigUpsSleepTime after a delay period.
+ This allows the host to shut down in a graceful manner.
+
+ If this UPS is an active member of a Synchronized Control
+ Group (SCG), the putUpsSyncGroupToSleep(4) command will perform
+ a Synchronized Sleep of all active Group members regardless
+ of their current AC output status. This unit's Power
+ Synchronization Delay, Shutdown Delay, Sleep Time,
+ and Return Delay will be used to execute the sleep command.
+
+ If this UPS is an active member of a SCG the
+ putUpsSyncGroupToSleepGracefully(5) command will perform a
+ Synchronized Sleep Gracefully of all active Group members
+ regardless of their current AC output status. This unit's
+ Power Synchronization Delay, Maximum Shutdown Time, Shutdown
+ Delay, Sleep Time, and Return Delay to execute the sleep
+ command.
+
+ When in sleep mode, the UPS will not provide output
+ power regardless of the input line state. Once the
+ specified time has elapsed, output power will be
+ restored.
+
+ Setting this value to noPutUpsToSleep(1) has no
+ effect.
+
+ The value noPutUpsToSleep(1) will always be returned
+ when the variable is read."
+ ::= { upsAdvControl 3 }
+
+
+upsAdvControlSimulatePowerFail OBJECT-TYPE
+ SYNTAX INTEGER {
+ noSimulatePowerFailure(1),
+ simulatePowerFailure(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this variable to simulatePowerFailure(2) causes
+ the UPS switch to battery power.
+
+ Setting this value to noSimulatePowerFailure(1) has no
+ effect.
+
+ The value noSimulatePowerFailure(1) will always be returned
+ when the variable is read."
+ ::= { upsAdvControl 4 }
+
+
+upsAdvControlFlashAndBeep OBJECT-TYPE
+ SYNTAX INTEGER {
+ noFlashAndBeep(1),
+ flashAndBeep(2),
+ flashAndBeepSyncGroup(3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this variable to flashAndBeep(2) causes the
+ UPS to beep and simultaneously turn on the UPS front
+ panel lights (Smart-UPS only).
+
+ If this UPS is an active member of a Synchronized Control
+ Group (SCG), the flashAndBeepSyncGroup(3) command will
+ Flash and Beep all active Group members regardless of
+ current AC output status.
+
+ Setting this value to noFlashAndBeep(1) has no
+ effect.
+
+ The value noFlashAndBeep(1) will always be returned
+ when the variable is read."
+ ::= { upsAdvControl 5 }
+
+
+upsAdvControlTurnOnUPS OBJECT-TYPE
+ SYNTAX INTEGER {
+ noTurnOnUPS(1),
+ turnOnUPS(2),
+ turnOnUPSSyncGroup(3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this variable to turnOnUPS(2) causes the
+ UPS to be turned on immediately.
+
+ If this UPS is an active member of a Synchronized Control
+ Group (SCG), the turnOnUPSSyncGroup(3) command will perform
+ a Synchronized Turn On of all active Group members
+ regardless of their current AC output status.
+
+ Setting this value to noTurnOnUPS(1) has no
+ effect.
+
+ The value noTurnOnUPS(1) will always be returned
+ when the variable is read."
+ ::= { upsAdvControl 6 }
+
+upsAdvControlBypassSwitch OBJECT-TYPE
+ SYNTAX INTEGER {
+ noBypassSwitch (1),
+ switchToBypass (2),
+ switchOutOfBypass(3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This switch puts the UPS in or out of bypass mode."
+ ::= { upsAdvControl 7 }
+
+
+-- the upsTest group
+
+-- the upsBasicTest group
+
+-- the upsAdvTest group
+
+upsAdvTestDiagnosticSchedule OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown(1),
+ biweekly(2),
+ weekly(3),
+ atTurnOn(4),
+ never(5)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The UPS system's automatic battery test schedule."
+ ::= { upsAdvTest 1 }
+
+
+upsAdvTestDiagnostics OBJECT-TYPE
+ SYNTAX INTEGER {
+ noTestDiagnostics(1),
+ testDiagnostics(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this variable to testDiagnostics(2) causes
+ the UPS to perform a diagnostic self test.
+
+ Setting this value to noTestDiagnostics(1) has no
+ effect.
+
+ The value noTestDiagnostics(1) will always be returned
+ when the variable is read."
+ ::= { upsAdvTest 2 }
+
+upsAdvTestDiagnosticsResults OBJECT-TYPE
+ SYNTAX INTEGER {
+ ok(1),
+ failed(2),
+ invalidTest(3),
+ testInProgress(4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The results of the last UPS diagnostics test performed."
+ ::= { upsAdvTest 3 }
+
+upsAdvTestLastDiagnosticsDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date the last UPS diagnostics test was performed in
+ mm/dd/yy format."
+ ::= { upsAdvTest 4 }
+
+upsAdvTestRuntimeCalibration OBJECT-TYPE
+ SYNTAX INTEGER {
+ noPerformCalibration(1),
+ performCalibration(2),
+ cancelCurrentCalibration(3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this variable to performCalibration(2) causes
+ the UPS to discharge to calibrate the UPS.
+ The test will only start if the battery capacity is 100%.
+ The test runs until capacity is less than 25%.
+
+ Setting this variable to cancelCurrentCalibration(3)
+ after setting performCalibration(2) will cancel the
+ current discharge.
+
+ Setting this variable to noPerformCalibration(1)
+ will have no effect.
+
+ The value noPerformCalibration(1) will always be returned
+ when the variable is read.
+
+ The result of the calibration will be saved in
+ upsAdvTestCalibrationResult."
+ ::= { upsAdvTest 5 }
+
+upsAdvTestCalibrationResults OBJECT-TYPE
+ SYNTAX INTEGER {
+ ok(1),
+ invalidCalibration(2),
+ calibrationInProgress(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The results of the last runtime calibration.
+
+ Value ok(1) means a successful runtime calibration.
+
+ Value invalidCalibration(2) indicates last calibration did
+ not take place since the battery capacity was below
+ 100%.
+
+ Value calibrationInProgress(3) means a calibration
+ is occurring now. "
+ ::= { upsAdvTest 6 }
+
+upsAdvTestCalibrationDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date the last UPS runtime calibration was
+ performed in mm/dd/yy format."
+ ::= { upsAdvTest 7 }
+
+-- the upsComm group
+
+upsCommStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ ok(1),
+ noComm(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of agent's communication with UPS. "
+ ::= { upsComm 1 }
+
+
+-- the measureUps group
+-- the Environ group
+
+mUpsEnvironAmbientTemperature OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The ambient temperature in Celsius for Probe 1."
+ ::= { mUpsEnviron 1 }
+
+mUpsEnvironRelativeHumidity OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The relative humidity as a percentage for Probe 1."
+ ::= { mUpsEnviron 2 }
+
+
+mUpsEnvironAmbientTemperature2 OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The ambient temperature in Celsius for Probe 2."
+ ::= { mUpsEnviron 3 }
+
+mUpsEnvironRelativeHumidity2 OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The relative humidity as a percentage for Probe 2."
+ ::= { mUpsEnviron 4 }
+
+-- the mUpsContact group
+
+mUpsContactNumContacts OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of contacts supported by the Measure-UPS."
+ ::= { mUpsContact 1 }
+
+mUpsContactTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ContactEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of contacts supported by the Measure-UPS."
+ ::= { mUpsContact 2 }
+
+mUpsContactEntry OBJECT-TYPE
+ SYNTAX ContactEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A contact entry containing information for a given contact."
+ INDEX { contactNumber }
+ ::= { mUpsContactTable 1 }
+
+ContactEntry ::=
+ SEQUENCE {
+ contactNumber
+ INTEGER,
+ normalState
+ INTEGER,
+ description
+ DisplayString,
+ monitoringStatus
+ INTEGER,
+ currentStatus
+ INTEGER
+ }
+
+contactNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An index identifying the contact on the Measure-UPS."
+ ::= { mUpsContactEntry 1 }
+
+normalState OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown(1),
+ open(2),
+ closed(3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The normal operating position of the contact. If the normal
+ operating position cannot be set then it is controlled via the
+ dip switch on the Measure-UPS and is therefore read-only."
+ ::= { mUpsContactEntry 2 }
+
+description OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The description of the purpose/use of the contact."
+ ::= { mUpsContactEntry 3 }
+
+monitoringStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown(1),
+ enabled(2),
+ disabled(3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A flag indicating whether this contact is
+ monitored, or not."
+ ::= { mUpsContactEntry 4 }
+
+currentStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown(1),
+ noFault(2),
+ fault(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This value indicates the current state of the contact.
+ If the contact is not in its normal state. This value
+ is set to fault(2)."
+ ::= { mUpsContactEntry 5 }
+
+-- Three Phase Group
+
+--
+-- Reset Max/Min Values Group
+--
+
+ upsPhaseResetMaxMinValues OBJECT-TYPE
+ SYNTAX INTEGER {
+ none (1),
+ reset (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Reset the maximum and minimum UPS values:
+ upsPhaseInputMaxVoltage, upsPhaseInputMinVoltage,
+ upsPhaseInputMaxCurrent, upsPhaseInputMinCurrent,
+ upsPhaseInputMaxPower, upsPhaseInputMinPower,
+ upsPhaseOutputMaxCurrent, upsPhaseOutputMinCurrent,
+ upsPhaseOutputMaxLoad, upsPhaseOutputMinLoad,
+ upsPhaseOutputMaxPercentLoad, upsPhaseOutputMinPercentLoad,
+ upsPhaseOutputMaxPower, upsPhaseOutputMinPower,
+ upsPhaseOutputMaxPercentPower, upsPhaseOutputMinPercentPower."
+ ::= { upsPhaseResetValues 1 }
+
+--
+-- Input Group
+--
+
+-- Number of Inputs
+
+ upsPhaseNumInputs OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of input feeds to this device.
+ This variable indicates the number of rows in the
+ input table."
+ ::= { upsPhaseInput 1 }
+
+-- Input Table
+
+ upsPhaseInputTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsPhaseInputEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of input table entries. The number of entries
+ is given by the value of upsPhaseNumInputs."
+ ::= { upsPhaseInput 2 }
+
+ upsPhaseInputEntry OBJECT-TYPE
+ SYNTAX UpsPhaseInputEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular input."
+ INDEX { upsPhaseInputTableIndex }
+ ::= { upsPhaseInputTable 1 }
+
+ UpsPhaseInputEntry ::= SEQUENCE {
+ upsPhaseInputTableIndex INTEGER,
+ upsPhaseNumInputPhases INTEGER,
+ upsPhaseInputVoltageOrientation INTEGER,
+ upsPhaseInputFrequency INTEGER,
+ upsPhaseInputType INTEGER,
+ upsPhaseInputName DisplayString
+ }
+
+ upsPhaseInputTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input identifier."
+ ::= { upsPhaseInputEntry 1 }
+
+ upsPhaseNumInputPhases OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of input phases utilized in this
+ device. The sum of all the upsPhaseNumInputPhases
+ variable indicates the number of rows in the
+ input phase table."
+ ::= { upsPhaseInputEntry 2 }
+
+ upsPhaseInputVoltageOrientation OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown(1),
+ singlePhase(2),
+ splitPhase(3),
+ threePhasePhaseToNeutral(4),
+ threePhasePhaseToPhase(5)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input voltage orientation:
+ 1: unknown for this UPS
+ 2: singlePhase - phase 1 voltage is between Phase 1
+ and Neutral.
+ 3: splitPhase - phase 1 voltage is between Phase 1 and
+ Neutral; phase 2 voltage is between Phase 2 and Neutral;
+ phase 3 voltage is between Phase 1 and Phase2.
+ 4: threePhasePhaseToNeutral - phase 1 voltage is between
+ Phase 1 and Neutral; phase 2 voltage is between Phase 2
+ and Neutral; phase 3 voltage is between Phase3 and
+ Neutral.
+ 5: threePhasePhaseToPhase - phase 1 voltage is between
+ Phase 1 and Phase 2; phase 2 voltage is between Phase 2
+ and Phase 3; phase 3 voltage is between Phase 3 and
+ Phase 1."
+ ::= { upsPhaseInputEntry 3 }
+
+ upsPhaseInputFrequency OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input frequency in 0.1 Hertz, or -1 if it's unsupported
+ by this UPS."
+ ::= { upsPhaseInputEntry 4 }
+
+ upsPhaseInputType OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown(1),
+ main(2),
+ bypass(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input type."
+ ::= { upsPhaseInputEntry 5 }
+
+ upsPhaseInputName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A name given to a particular input."
+ ::= { upsPhaseInputEntry 6 }
+
+-- Input Phase Table
+
+ upsPhaseInputPhaseTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsPhaseInputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of input table entries. The number of entries
+ is given by the sum of the upsPhaseNumInputPhases."
+ ::= { upsPhaseInput 3 }
+
+ upsPhaseInputPhaseEntry OBJECT-TYPE
+ SYNTAX UpsPhaseInputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular input phase."
+ INDEX { upsPhaseInputPhaseTableIndex, upsPhaseInputPhaseIndex }
+ ::= { upsPhaseInputPhaseTable 1 }
+
+ UpsPhaseInputPhaseEntry ::= SEQUENCE {
+ upsPhaseInputPhaseTableIndex INTEGER,
+ upsPhaseInputPhaseIndex INTEGER,
+ upsPhaseInputVoltage INTEGER,
+ upsPhaseInputMaxVoltage INTEGER,
+ upsPhaseInputMinVoltage INTEGER,
+ upsPhaseInputCurrent INTEGER,
+ upsPhaseInputMaxCurrent INTEGER,
+ upsPhaseInputMinCurrent INTEGER,
+ upsPhaseInputPower INTEGER,
+ upsPhaseInputMaxPower INTEGER,
+ upsPhaseInputMinPower INTEGER
+ }
+
+ upsPhaseInputPhaseTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input identifier."
+ ::= { upsPhaseInputPhaseEntry 1 }
+
+ upsPhaseInputPhaseIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input phase identifier."
+ ::= { upsPhaseInputPhaseEntry 2 }
+
+ upsPhaseInputVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input voltage in VAC, or -1 if it's unsupported
+ by this UPS."
+ ::= { upsPhaseInputPhaseEntry 3 }
+
+ upsPhaseInputMaxVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum input voltage in VAC measured
+ since the last reset (upsPhaseResetMaxMinValues), or
+ -1 if it's unsupported by this UPS.
+ Sampled every 30 seconds."
+ ::= { upsPhaseInputPhaseEntry 4 }
+
+ upsPhaseInputMinVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum input voltage in VAC measured
+ since the last reset (upsPhaseResetMaxMinValues), or
+ -1 if it's unsupported by this UPS.
+ Sampled every 30 seconds."
+ ::= { upsPhaseInputPhaseEntry 5 }
+
+ upsPhaseInputCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input current in 0.1 amperes, or -1 if it's
+ unsupported by this UPS."
+ ::= { upsPhaseInputPhaseEntry 6 }
+
+ upsPhaseInputMaxCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum input current in 0.1 amperes measured
+ since the last reset (upsPhaseResetMaxMinValues), or
+ -1 if it's unsupported by this UPS.
+ Sampled every 30 seconds."
+ ::= { upsPhaseInputPhaseEntry 7 }
+
+ upsPhaseInputMinCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum input current in 0.1 amperes measured
+ since the last reset (upsPhaseResetMaxMinValues), or
+ -1 if it's unsupported by this UPS.
+ Sampled every 30 seconds."
+ ::= { upsPhaseInputPhaseEntry 8 }
+
+ upsPhaseInputPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input power in Watts, or -1 if it's unsupported
+ by this UPS."
+ ::= { upsPhaseInputPhaseEntry 9 }
+
+ upsPhaseInputMaxPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum input power in Watts measured
+ since the last reset (upsPhaseResetMaxMinValues), or
+ -1 if it's unsupported by this UPS.
+ Sampled every 30 seconds."
+ ::= { upsPhaseInputPhaseEntry 10 }
+
+ upsPhaseInputMinPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum input power in Watts measured
+ since the last reset (upsPhaseResetMaxMinValues), or
+ -1 if it's unsupported by this UPS.
+ Sampled every 30 seconds."
+ ::= { upsPhaseInputPhaseEntry 11 }
+
+ --
+ -- The Output group.
+ --
+
+ -- Number of Outputs
+
+ upsPhaseNumOutputs OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of output feeds to this device.
+ This variable indicates the number of rows in the
+ output table."
+ ::= { upsPhaseOutput 1 }
+
+ -- Output Table
+
+ upsPhaseOutputTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsPhaseOutputEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of output table entries. The number of entries
+ is given by the value of upsOutputNumPhases."
+ ::= { upsPhaseOutput 2 }
+
+ upsPhaseOutputEntry OBJECT-TYPE
+ SYNTAX UpsPhaseOutputEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular output."
+ INDEX { upsPhaseOutputTableIndex }
+ ::= { upsPhaseOutputTable 1 }
+
+ UpsPhaseOutputEntry ::= SEQUENCE {
+ upsPhaseOutputTableIndex INTEGER,
+ upsPhaseNumOutputPhases INTEGER,
+ upsPhaseOutputVoltageOrientation INTEGER,
+ upsPhaseOutputFrequency INTEGER
+ }
+
+ upsPhaseOutputTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output identifier."
+ ::= { upsPhaseOutputEntry 1 }
+
+ upsPhaseNumOutputPhases OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of output phases utilized in this
+ device. The sum of all the upsPhaseNumOutputPhases
+ variable indicates the number of rows in the
+ output phase table."
+ ::= { upsPhaseOutputEntry 2 }
+
+ upsPhaseOutputVoltageOrientation OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown(1),
+ singlePhase(2),
+ splitPhase(3),
+ threePhasePhaseToNeutral(4),
+ threePhasePhaseToPhase(5)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output voltage orientation:
+ 1: unknown for this UPS
+ 2: singlePhase - phase 1 voltage is between Phase 1
+ and Neutral.
+ 3: splitPhase - phase 1 voltage is between Phase 1 and
+ Neutral; phase 2 voltage is between Phase 2 and Neutral;
+ phase 3 voltage is between Phase 1 and Phase2.
+ 4: threePhasePhaseToNeutral - phase 1 voltage is between
+ Phase 1 and Neutral; phase 2 voltage is between Phase 2
+ and Neutral; phase 3 voltage is between Phase3 and
+ Neutral.
+ 5: threePhasePhaseToPhase - phase 1 voltage is between
+ Phase 1 and Phase 2; phase 2 voltage is between Phase 2
+ and Phase 3; phase 3 voltage is between Phase 3 and
+ Phase 1."
+ ::= { upsPhaseOutputEntry 3 }
+
+ upsPhaseOutputFrequency OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output frequency in 0.1 Hertz, or -1 if it's
+ unsupported by this UPS."
+ ::= { upsPhaseOutputEntry 4 }
+
+ -- Output Phase Table
+
+ upsPhaseOutputPhaseTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsPhaseOutputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of output table entries. The number of
+ entries is given by the sum of the upsPhaseNumOutputPhases."
+ ::= { upsPhaseOutput 3 }
+
+ upsPhaseOutputPhaseEntry OBJECT-TYPE
+ SYNTAX UpsPhaseOutputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular output phase."
+ INDEX { upsPhaseOutputPhaseTableIndex, upsPhaseOutputPhaseIndex }
+ ::= { upsPhaseOutputPhaseTable 1 }
+
+ UpsPhaseOutputPhaseEntry ::= SEQUENCE {
+ upsPhaseOutputPhaseTableIndex INTEGER,
+ upsPhaseOutputPhaseIndex INTEGER,
+ upsPhaseOutputVoltage INTEGER,
+ upsPhaseOutputCurrent INTEGER,
+ upsPhaseOutputMaxCurrent INTEGER,
+ upsPhaseOutputMinCurrent INTEGER,
+ upsPhaseOutputLoad INTEGER,
+ upsPhaseOutputMaxLoad INTEGER,
+ upsPhaseOutputMinLoad INTEGER,
+ upsPhaseOutputPercentLoad INTEGER,
+ upsPhaseOutputMaxPercentLoad INTEGER,
+ upsPhaseOutputMinPercentLoad INTEGER,
+ upsPhaseOutputPower INTEGER,
+ upsPhaseOutputMaxPower INTEGER,
+ upsPhaseOutputMinPower INTEGER,
+ upsPhaseOutputPercentPower INTEGER,
+ upsPhaseOutputMaxPercentPower INTEGER,
+ upsPhaseOutputMinPercentPower INTEGER
+ }
+
+ upsPhaseOutputPhaseTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output identifier."
+ ::= { upsPhaseOutputPhaseEntry 1 }
+
+ upsPhaseOutputPhaseIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output phase identifier."
+ ::= { upsPhaseOutputPhaseEntry 2 }
+
+ upsPhaseOutputVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output voltage in VAC, or -1 if it's unsupported
+ by this UPS."
+ ::= { upsPhaseOutputPhaseEntry 3 }
+
+ upsPhaseOutputCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output current in 0.1 amperes drawn
+ by the load on the UPS, or -1 if it's unsupported
+ by this UPS."
+ ::= { upsPhaseOutputPhaseEntry 4 }
+
+ upsPhaseOutputMaxCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum output current in 0.1 amperes measured
+ since the last reset (upsPhaseResetMaxMinValues), or
+ -1 if it's unsupported by this UPS.
+ Sampled every 30 seconds."
+ ::= { upsPhaseOutputPhaseEntry 5 }
+
+ upsPhaseOutputMinCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum output current in 0.1 amperes measured
+ since the last reset (upsPhaseResetMaxMinValues), or
+ -1 if it's unsupported by this UPS.
+ Sampled every 30 seconds."
+ ::= { upsPhaseOutputPhaseEntry 6 }
+
+ upsPhaseOutputLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output load in VA, or -1 if it's unsupported
+ by this UPS."
+ ::= { upsPhaseOutputPhaseEntry 7 }
+
+ upsPhaseOutputMaxLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum output load in VA measured
+ since the last reset (upsPhaseResetMaxMinValues), or
+ -1 if it's unsupported by this UPS.
+ Sampled every 30 seconds."
+ ::= { upsPhaseOutputPhaseEntry 8 }
+
+ upsPhaseOutputMinLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum output load in VA measured
+ since the last reset (upsPhaseResetMaxMinValues), or
+ -1 if it's unsupported by this UPS.
+ Sampled every 30 seconds."
+ ::= { upsPhaseOutputPhaseEntry 9 }
+
+ upsPhaseOutputPercentLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The percentage of the UPS load capacity in VA at
+ redundancy @ (n + x) presently being used on this
+ output phase, or -1 if it's unsupported by this UPS."
+ ::= { upsPhaseOutputPhaseEntry 10 }
+
+ upsPhaseOutputMaxPercentLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum percentage of the UPS load capacity in
+ VA measured at redundancy @ (n + x) presently
+ being used on this output phase since the last reset
+ (upsPhaseResetMaxMinValues), or -1 if it's unsupported
+ by this UPS. Sampled every 30 seconds."
+ ::= { upsPhaseOutputPhaseEntry 11 }
+
+ upsPhaseOutputMinPercentLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum percentage of the UPS load capacity in
+ VA measured at redundancy @ (n + x) presently
+ being used on this output phase since the last reset
+ (upsPhaseResetMaxMinValues), or -1 if it's unsupported
+ by this UPS. Sampled every 30 seconds."
+ ::= { upsPhaseOutputPhaseEntry 12 }
+
+ upsPhaseOutputPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output power in Watts, or -1 if it's
+ unsupported by this UPS."
+ ::= { upsPhaseOutputPhaseEntry 13 }
+
+ upsPhaseOutputMaxPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum output power in Watts measured
+ since the last reset (upsPhaseResetMaxMinValues), or
+ -1 if it's unsupported by this UPS.
+ Sampled every 30 seconds."
+ ::= { upsPhaseOutputPhaseEntry 14 }
+
+ upsPhaseOutputMinPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum output power in Watts measured
+ since the last reset (upsPhaseResetMaxMinValues), or
+ -1 if it's unsupported by this UPS.
+ Sampled every 30 seconds."
+ ::= { upsPhaseOutputPhaseEntry 15 }
+
+ upsPhaseOutputPercentPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The percentage of the UPS power capacity in Watts at
+ redundancy @ (n + x) presently being used on this
+ output phase, or -1 if it's unsupported by this UPS."
+ ::= { upsPhaseOutputPhaseEntry 16 }
+
+ upsPhaseOutputMaxPercentPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum percentage of the UPS power capacity
+ in Watts measured at redundancy @ (n + x) presently
+ being used on this output phase since the last
+ reset (upsPhaseResetMaxMinValues), or -1 if it's
+ unsupported by this UPS. Sampled every 30 seconds."
+ ::= { upsPhaseOutputPhaseEntry 17 }
+
+ upsPhaseOutputMinPercentPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum percentage of the UPS power capacity
+ in Watts measured at redundancy @ (n + x) presently
+ being used on this output phase since the last
+ reset (upsPhaseResetMaxMinValues), or -1 if it's
+ unsupported by this UPS. Sampled every 30 seconds."
+ ::= { upsPhaseOutputPhaseEntry 18 }
+
+-- the upsOutletGroupStatus group
+
+upsOutletGroupStatusTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of outlet groups for the UPS."
+ ::= { upsOutletGroupStatus 1 }
+
+upsOutletGroupStatusTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsOutletGroupStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting status of the outlet groups. The number of
+ entries is contained in the upsOutletGroupStatusTableSize OID."
+ ::= { upsOutletGroupStatus 2 }
+
+upsOutletGroupStatusEntry OBJECT-TYPE
+ SYNTAX UpsOutletGroupStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlet group status to get."
+ INDEX { upsOutletGroupStatusIndex}
+ ::= { upsOutletGroupStatusTable 1 }
+
+UpsOutletGroupStatusEntry ::=
+ SEQUENCE {
+ upsOutletGroupStatusIndex INTEGER,
+ upsOutletGroupStatusName DisplayString,
+ upsOutletGroupStatusGroupState INTEGER,
+ upsOutletGroupStatusCommandPending INTEGER
+ }
+
+upsOutletGroupStatusIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet group entry."
+ ::= { upsOutletGroupStatusEntry 1 }
+
+upsOutletGroupStatusName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet group. This OID is provided
+ for informational purposes only. This value is set
+ by the upsOutletGroupConfigName OID."
+ ::= { upsOutletGroupStatusEntry 2 }
+
+upsOutletGroupStatusGroupState OBJECT-TYPE
+ SYNTAX INTEGER {
+ upsOutletGroupStatusOn (1),
+ upsOutletGroupStatusOff (2),
+ upsOutletGroupStatusUnknown (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the outlet group state. If the outlet
+ group is on, the upsOutletGroupStatusOn (1) value will be returned. If
+ the outlet group is off, the upsOutletGroupStatusOff (2) value will be
+ returned. If the state of the outlet group cannot be determined, the
+ upsOutletGroupStatusUnknown (3) value will be returned."
+
+ ::= { upsOutletGroupStatusEntry 3 }
+
+upsOutletGroupStatusCommandPending OBJECT-TYPE
+ SYNTAX INTEGER {
+ upsOutletGroupCommandPending (1),
+ upsOutletGroupNoCommandPending (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the command pending
+ state of the outlet group. If a command is pending on the
+ outlet group, the upsOutletGroupCommandPending (1) value
+ will be returned. If there is not a command pending
+ on the outlet group, the upsOutletGroupNoCommandPending (2)
+ will be returned."
+ ::= { upsOutletGroupStatusEntry 4 }
+
+-- the upsOutletGroupConfig group
+
+upsOutletGroupConfigTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of outlet groups for the UPS."
+ ::= { upsOutletGroupConfig 1 }
+
+upsOutletGroupConfigTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsOutletGroupConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The list of outlet groups to configure. The number of entries
+ is defined by the upsOutletGroupConfigTableSize OID."
+ ::= { upsOutletGroupConfig 2 }
+
+upsOutletGroupConfigEntry OBJECT-TYPE
+ SYNTAX UpsOutletGroupConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlet groups to configure."
+ INDEX { upsOutletGroupConfigIndex}
+ ::= { upsOutletGroupConfigTable 1 }
+
+UpsOutletGroupConfigEntry ::=
+ SEQUENCE {
+ upsOutletGroupConfigIndex INTEGER,
+ upsOutletGroupConfigName DisplayString,
+ upsOutletGroupConfigPowerOnDelay INTEGER,
+ upsOutletGroupConfigPowerOffDelay INTEGER,
+ upsOutletGroupConfigRebootDuration INTEGER
+ }
+
+upsOutletGroupConfigIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet group entry."
+ ::= { upsOutletGroupConfigEntry 1 }
+
+upsOutletGroupConfigName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet group."
+ ::= { upsOutletGroupConfigEntry 2 }
+
+upsOutletGroupConfigPowerOnDelay OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The amount of time (in seconds) the outlet group will delay
+ powering on when the delayed on or reboot command is applied.
+ Allowed values are -1 (for Never) or 0 to 600 seconds."
+ ::= { upsOutletGroupConfigEntry 3 }
+
+upsOutletGroupConfigPowerOffDelay OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The amount of time (in seconds) the outlet group will delay
+ powering off when the delayed off command is applied.
+ Allowed values are 0 to 600 seconds."
+ ::= { upsOutletGroupConfigEntry 4 }
+
+upsOutletGroupConfigRebootDuration OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "During a reboot sequence, power is turned off and then
+ back on. This OID defines the amount of time to wait,
+ in seconds, after turning the power off, at the start
+ of the sequence, before initiating the power on sequence.
+ Allowed values are 0 to 600 seconds."
+ ::= { upsOutletGroupConfigEntry 5 }
+
+-- the upsOutletGroupControl group
+
+upsOutletGroupControlTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of outlet groups for the UPS."
+ ::= { upsOutletGroupControl 1 }
+
+upsOutletGroupControlTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsOutletGroupControlEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for control of individual outlet groups. The number of
+ entries is contained in the upsOutletGroupControlTableSize OID."
+ ::= { upsOutletGroupControl 2 }
+
+upsOutletGroupControlEntry OBJECT-TYPE
+ SYNTAX UpsOutletGroupControlEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlet group to control."
+ INDEX { upsOutletGroupControlIndex}
+ ::= { upsOutletGroupControlTable 1 }
+
+UpsOutletGroupControlEntry ::=
+ SEQUENCE {
+ upsOutletGroupControlIndex INTEGER,
+ upsOutletGroupControlName DisplayString,
+ upsOutletGroupControlCommand INTEGER
+ }
+
+upsOutletGroupControlIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet group entry."
+ ::= { upsOutletGroupControlEntry 1 }
+
+upsOutletGroupControlName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet group. This OID is provided
+ for informational purposes only. This value is set
+ by the upsOutletGroupConfigName OID."
+ ::= { upsOutletGroupControlEntry 2 }
+
+upsOutletGroupControlCommand OBJECT-TYPE
+ SYNTAX INTEGER {
+ upsOutletGroupImmediateOn (1),
+ upsOutletGroupImmediateOff (2),
+ upsOutletGroupImmediateReboot (3),
+ upsOutletGroupDelayedOn (4),
+ upsOutletGroupDelayedOff (5),
+ upsOutletGroupDelayedReboot (6),
+ upsOutletGroupCancelPendingCommand (7),
+ upsOutletGroupControlUnknown (8)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the outlet group state. If the outlet
+ group is on, the upsOutletGroupImmediateOn (1) value will be returned. If
+ the outlet group is off, the upsOutletGroupImmediateOff (2) value will be
+ returned.
+
+ If the state of the outlet group cannot be determined, the
+ upsOutletGroupControlUnknown (8) value will be returned.
+
+ Setting this variable to upsOutletGroupImmediateOn (1) will turn the
+ outlet group on.
+
+ Setting this variable to upsOutletGroupImmediateOff (2) will turn the
+ outlet group off.
+
+ Setting this variable to upsOutletGroupImmediateReboot (3) will turn the outlet
+ group off, wait the upsOutletGroupConfigRebootDuration OID time, wait the
+ upsOutletGroupConfigPowerOnDelay OID, and then turn the outlet group on.
+
+ Setting this variable to upsOutletGroupDelayedOn (4) will turn the outlet
+ group on after the upsOutletGroupConfigPowerOnDelay OID has elapsed.
+
+ Setting this variable to upsOutletGroupDelayedOff (5) will turn the outlet
+ group off after the upsOutletGroupConfigPowerOffDelay OID has elapsed.
+
+ Setting this variable to upsOutletGroupDelayedReboot (6) will turn the outlet
+ group off after the upsOutletGroupConfigPowerOffDelay OID has elapsed, wait the
+ upsOutletGroupConfigRebootDuration OID time, wait the
+ upsOutletGroupConfigPowerOnDelay OID, and then turn the outlet group on.
+
+ Setting this variable to upsOutletGroupCancelPendingCommand (7) will
+ cause any pending command to this outlet group to be canceled."
+ ::= { upsOutletGroupControlEntry 3 }
+
+-- the upsDiagnosticIM group
+
+upsDiagIMTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of Intelligence Modules in or attached to the UPS."
+ ::= { upsDiagnosticIM 1 }
+
+upsDiagIMTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsDiagIMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for diagnostics of individual Intelligence Modules. The number of
+ entries is contained in the upsDiagIMTableSize OID."
+ ::= { upsDiagnosticIM 2 }
+
+upsDiagIMEntry OBJECT-TYPE
+ SYNTAX UpsDiagIMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The diagnostics and information of an Intelligence Module."
+ INDEX { upsDiagIMIndex}
+ ::= { upsDiagIMTable 1 }
+
+UpsDiagIMEntry ::=
+ SEQUENCE {
+ upsDiagIMIndex INTEGER,
+ upsDiagIMType INTEGER,
+ upsDiagIMStatus INTEGER,
+ upsDiagIMFirmwareRev DisplayString,
+ upsDiagIMSlaveFirmwareRev DisplayString,
+ upsDiagIMHardwareRev DisplayString,
+ upsDiagIMSerialNum DisplayString,
+ upsDiagIMManufactureDate DisplayString
+ }
+
+upsDiagIMIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the Intelligence Module entry."
+ ::= { upsDiagIMEntry 1 }
+
+upsDiagIMType OBJECT-TYPE
+ SYNTAX INTEGER {
+ imUnknown (1),
+ imMIM (2),
+ imRIM (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The type of the Intelligence Module.
+ imUnknown(1) indicates the IM type is unknown.
+ imMIM(2) indicates the IM type is a Main Intelligence Module.
+ imRIM(3) indicates the IM type is Redundant Intelligence Module."
+ ::= { upsDiagIMEntry 2 }
+
+upsDiagIMStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ offOk (3),
+ onOk (4),
+ offFail (5),
+ onFail (6),
+ lostComm (7)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the Intelligence Module.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ offOk(3) indicates the device status is off and OK.
+ onOk(4) indicates the device status is on and OK.
+ offFail(5) indicates the device status is off and failed.
+ onFail(6) indicates the device status is on and failed.
+ lostComm(7) indicates the device has lost communication."
+ ::= { upsDiagIMEntry 3 }
+
+upsDiagIMFirmwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The firmware revision of the Intelligence Module."
+ ::= { upsDiagIMEntry 4 }
+
+upsDiagIMSlaveFirmwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The slave firmware revision of the Intelligence Module."
+ ::= { upsDiagIMEntry 5 }
+
+upsDiagIMHardwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware revision of the Intelligence Module."
+ ::= { upsDiagIMEntry 6 }
+
+upsDiagIMSerialNum OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The serial number of the Intelligence Module."
+ ::= { upsDiagIMEntry 7 }
+
+upsDiagIMManufactureDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The manufacture date of the Intelligence Module."
+ ::= { upsDiagIMEntry 8 }
+
+-- the upsDiagnosticPowerModules group
+
+upsDiagPMTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of Power Modules in or attached to the UPS."
+ ::= { upsDiagnosticPowerModules 1 }
+
+upsDiagPMTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsDiagPMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for diagnostics of Individual Power modules. The number of
+ entries is contained in the upsDiagPMTableSize OID."
+ ::= { upsDiagnosticPowerModules 2 }
+
+upsDiagPMEntry OBJECT-TYPE
+ SYNTAX UpsDiagPMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The diagnostics of an Power Module."
+ INDEX { upsDiagPMIndex}
+ ::= { upsDiagPMTable 1 }
+
+UpsDiagPMEntry ::=
+ SEQUENCE {
+ upsDiagPMIndex INTEGER,
+ upsDiagPMStatus INTEGER,
+ upsDiagPMFirmwareRev DisplayString,
+ upsDiagPMHardwareRev DisplayString,
+ upsDiagPMSerialNum DisplayString,
+ upsDiagPMManufactureDate DisplayString
+ }
+
+upsDiagPMIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the Power Module entry."
+ ::= { upsDiagPMEntry 1 }
+
+upsDiagPMStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ offOk (3),
+ onOk (4),
+ offFail (5),
+ onFail (6),
+ lostComm (7)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the Power Module.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ offOk(3) indicates the device status is off and OK.
+ onOk(4) indicates the device status is on and OK.
+ offFail(5) indicates the device status is off and failed.
+ onFail(6) indicates the device status is on and failed.
+ lostComm(7) indicates the device has lost communication."
+ ::= { upsDiagPMEntry 2 }
+
+upsDiagPMFirmwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The firmware revision of the Power Module."
+ ::= { upsDiagPMEntry 3 }
+
+upsDiagPMHardwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware revision of the Power Module."
+ ::= { upsDiagPMEntry 4 }
+
+upsDiagPMSerialNum OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The serial number of the Power Module."
+ ::= { upsDiagPMEntry 5 }
+
+upsDiagPMManufactureDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The manufacture date of the Power Module."
+ ::= { upsDiagPMEntry 6 }
+
+-- the upsDiagnosticBatteries group
+
+upsDiagBatteryTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of batteries in or attached to the UPS."
+ ::= { upsDiagnosticBatteries 1 }
+
+upsDiagBatteryTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsDiagBatteryEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for diagnostics of individual batteries. The number of
+ entries is contained in the upsDiagBattTableSize OID."
+ ::= { upsDiagnosticBatteries 2 }
+
+upsDiagBatteryEntry OBJECT-TYPE
+ SYNTAX UpsDiagBatteryEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The diagnostics of a battery."
+ INDEX { upsDiagBatteryIndex}
+ ::= { upsDiagBatteryTable 1 }
+
+UpsDiagBatteryEntry ::=
+ SEQUENCE {
+ upsDiagBatteryFrameIndex INTEGER,
+ upsDiagBatteryIndex INTEGER,
+ upsDiagBatteryStatus INTEGER,
+ upsDiagBatterySerialNumber DisplayString,
+ upsDiagBatteryFirmwareRev DisplayString,
+ upsDiagBatteryManufactureDate DisplayString,
+ upsDiagBatteryType DisplayString
+ }
+
+upsDiagBatteryFrameIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the battery frame entry.
+ Frame 0 indicates the Main frame. Extended Run (XR) frames
+ start from index 1."
+ ::= { upsDiagBatteryEntry 1 }
+
+upsDiagBatteryIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the battery entry."
+ ::= { upsDiagBatteryEntry 2 }
+
+upsDiagBatteryStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ ok (3),
+ failed (4),
+ highTemperature (5),
+ replaceImmediately (6),
+ lowCapacity (7)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the battery.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ ok(3) indicates the battery status is OK.
+ failed(4) indicates the battery status is failed.
+ highTemperature(5) indicates the battery has a high temperature condition.
+ replaceImmediately(6) indicates the battery must be replaced immediately.
+ lowCapacity(7) indicates the battery has a low capacity."
+ ::= { upsDiagBatteryEntry 3 }
+
+upsDiagBatterySerialNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The serial number of the battery."
+ ::= { upsDiagBatteryEntry 4 }
+
+upsDiagBatteryFirmwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The firmware revision of the battery."
+ ::= { upsDiagBatteryEntry 5 }
+
+upsDiagBatteryManufactureDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The manufacture date of the battery."
+ ::= { upsDiagBatteryEntry 6 }
+
+upsDiagBatteryType OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The battery type or rating for the battery."
+ ::= { upsDiagBatteryEntry 7 }
+
+-- the upsDiagnosticSubsystem group
+
+upsDiagSubSysFrameTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of frames attached to the UPS including the Main frame."
+ ::= { upsDiagnosticSubsystem 1 }
+
+upsDiagSubSysFrameTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsDiagSubSysFrameEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for diagnostics of individual XR Frames."
+ ::= { upsDiagnosticSubsystem 2 }
+
+upsDiagSubSysFrameEntry OBJECT-TYPE
+ SYNTAX UpsDiagSubSysFrameEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The diagnostics of an XR Frame."
+ INDEX { upsDiagSubSysFrameIndex}
+ ::= { upsDiagSubSysFrameTable 1 }
+
+UpsDiagSubSysFrameEntry ::=
+ SEQUENCE {
+ upsDiagSubSysFrameIndex INTEGER,
+ upsDiagSubSysFrameType INTEGER,
+ upsDiagSubSysFrameFirmwareRev DisplayString,
+ upsDiagSubSysFrameHardwareRev DisplayString,
+ upsDiagSubSysFrameSerialNum DisplayString,
+ upsDiagSubSysFrameManufactureDate DisplayString
+ }
+
+upsDiagSubSysFrameIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The frame index entry."
+ ::= { upsDiagSubSysFrameEntry 1 }
+
+upsDiagSubSysFrameType OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ frameTypeMain (3),
+ frameTypeXR (4),
+ frameTypeLXR (5)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The type of Frame.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ frameTypeMain(3) indicates the the frame type is the Main Frame.
+ frameTypeXR(4) indicates the frame type is an XR Frame.
+ frameTypeLXR(5) indicates the frame type is an LXR Frame."
+ ::= { upsDiagSubSysFrameEntry 2 }
+
+upsDiagSubSysFrameFirmwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The firmware revision of the frame."
+ ::= { upsDiagSubSysFrameEntry 3 }
+
+upsDiagSubSysFrameHardwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware revision of the frame."
+ ::= { upsDiagSubSysFrameEntry 4 }
+
+upsDiagSubSysFrameSerialNum OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The serial number of the frame."
+ ::= { upsDiagSubSysFrameEntry 5 }
+
+upsDiagSubSysFrameManufactureDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The manufacture date of the frame."
+ ::= { upsDiagSubSysFrameEntry 6 }
+
+upsDiagSubSysIntBypSwitchTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of Internal Bypass switches attached to the UPS."
+ ::= { upsDiagnosticSubsystem 3 }
+
+upsDiagSubSysIntBypSwitchTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsDiagSubSysIntBypSwitchEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for diagnostics of the Internal Bypass Switch."
+ ::= { upsDiagnosticSubsystem 4 }
+
+upsDiagSubSysIntBypSwitchEntry OBJECT-TYPE
+ SYNTAX UpsDiagSubSysIntBypSwitchEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The diagnostics of the Internal Bypass Switch."
+ INDEX { upsDiagSubSysIntBypSwitchIndex}
+ ::= { upsDiagSubSysIntBypSwitchTable 1 }
+
+UpsDiagSubSysIntBypSwitchEntry ::=
+ SEQUENCE {
+ upsDiagSubSysIntBypSwitchFrameIndex INTEGER,
+ upsDiagSubSysIntBypSwitchIndex INTEGER,
+ upsDiagSubSysIntBypSwitchStatus INTEGER,
+ upsDiagSubSysIntBypSwitchFirmwareRev DisplayString,
+ upsDiagSubSysIntBypSwitchHardwareRev DisplayString,
+ upsDiagSubSysIntBypSwitchSerialNum DisplayString,
+ upsDiagSubSysIntBypSwitchManufactureDate DisplayString
+ }
+
+upsDiagSubSysIntBypSwitchFrameIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The frame index entry."
+ ::= { upsDiagSubSysIntBypSwitchEntry 1 }
+
+upsDiagSubSysIntBypSwitchIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The Internal Bypass Switch index entry."
+ ::= { upsDiagSubSysIntBypSwitchEntry 2 }
+
+upsDiagSubSysIntBypSwitchStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ offOk (3),
+ onOk (4),
+ offFail (5),
+ onFail (6),
+ lostComm (7)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The Internal Bypass Switch status.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ offOk(3) indicates the device status is off and OK.
+ onOk(4) indicates the device status is on and OK.
+ offFail(5) indicates the device status is off and failed.
+ onFail(6) indicates the device status is on and failed.
+ lostComm(7) indicates the device has lost communication."
+ ::= { upsDiagSubSysIntBypSwitchEntry 3 }
+
+upsDiagSubSysIntBypSwitchFirmwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The firmware revision of the Internal Bypass Switch."
+ ::= { upsDiagSubSysIntBypSwitchEntry 4 }
+
+upsDiagSubSysIntBypSwitchHardwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware revision of the Internal Bypass Switch."
+ ::= { upsDiagSubSysIntBypSwitchEntry 5 }
+
+upsDiagSubSysIntBypSwitchSerialNum OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The serial number of the Internal Bypass Switch."
+ ::= { upsDiagSubSysIntBypSwitchEntry 6 }
+
+upsDiagSubSysIntBypSwitchManufactureDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The manufacture date of the Internal Bypass Switch."
+ ::= { upsDiagSubSysIntBypSwitchEntry 7 }
+
+upsDiagSubSysBattMonitorTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of Battery Monitor Boards attached to the UPS."
+ ::= { upsDiagnosticSubsystem 5 }
+
+upsDiagSubSysBattMonitorTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsDiagSubSysBattMonitorEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for diagnostics of the Battery Monitor Board."
+ ::= { upsDiagnosticSubsystem 6 }
+
+upsDiagSubSysBattMonitorEntry OBJECT-TYPE
+ SYNTAX UpsDiagSubSysBattMonitorEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The diagnostics of the Battery Monitor Board."
+ INDEX { upsDiagSubSysBattMonitorIndex}
+ ::= { upsDiagSubSysBattMonitorTable 1 }
+
+UpsDiagSubSysBattMonitorEntry ::=
+ SEQUENCE {
+ upsDiagSubSysBattMonitorFrameIndex INTEGER,
+ upsDiagSubSysBattMonitorIndex INTEGER,
+ upsDiagSubSysBattMonitorStatus INTEGER,
+ upsDiagSubSysBattMonitorFirmwareRev DisplayString,
+ upsDiagSubSysBattMonitorHardwareRev DisplayString,
+ upsDiagSubSysBattMonitorSerialNum DisplayString,
+ upsDiagSubSysBattMonitorManufactureDate DisplayString
+ }
+
+upsDiagSubSysBattMonitorFrameIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The frame index entry."
+ ::= { upsDiagSubSysBattMonitorEntry 1 }
+
+upsDiagSubSysBattMonitorIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of the Battery Monitor Board."
+ ::= { upsDiagSubSysBattMonitorEntry 2 }
+
+upsDiagSubSysBattMonitorStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ offOk (3),
+ onOk (4),
+ offFail (5),
+ onFail (6),
+ lostComm (7)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the Battery Monitor Board.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ offOk(3) indicates the device status is off and OK.
+ onOk(4) indicates the device status is on and OK.
+ offFail(5) indicates the device status is off and failed.
+ onFail(6) indicates the device status is on and failed.
+ lostComm(7) indicates the device has lost communication."
+ ::= { upsDiagSubSysBattMonitorEntry 3 }
+
+upsDiagSubSysBattMonitorFirmwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The firmware revision of the Battery Monitor Board."
+ ::= { upsDiagSubSysBattMonitorEntry 4 }
+
+upsDiagSubSysBattMonitorHardwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware revision of the Battery Monitor Board."
+ ::= { upsDiagSubSysBattMonitorEntry 5 }
+
+upsDiagSubSysBattMonitorSerialNum OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The serial number of the Battery Monitor Board."
+ ::= { upsDiagSubSysBattMonitorEntry 6 }
+
+upsDiagSubSysBattMonitorManufactureDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date of the manufacture for the Battery Monitor Board."
+ ::= { upsDiagSubSysBattMonitorEntry 7 }
+
+upsDiagSubSysExternalSwitchGearTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of External Switch Gears attached to the UPS."
+ ::= { upsDiagnosticSubsystem 7 }
+
+upsDiagSubSysExternalSwitchGearTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsDiagSubSysExternalSwitchGearEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for diagnostics of the individual External Switch Gear."
+ ::= { upsDiagnosticSubsystem 8 }
+
+upsDiagSubSysExternalSwitchGearEntry OBJECT-TYPE
+ SYNTAX UpsDiagSubSysExternalSwitchGearEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The diagnostics of an individual External Switch Gear."
+ INDEX { upsDiagSubSysExternalSwitchGearIndex}
+ ::= { upsDiagSubSysExternalSwitchGearTable 1 }
+
+UpsDiagSubSysExternalSwitchGearEntry ::=
+ SEQUENCE {
+ upsDiagSubSysExternalSwitchGearFrameIndex INTEGER,
+ upsDiagSubSysExternalSwitchGearIndex INTEGER,
+ upsDiagSubSysExternalSwitchGearStatus INTEGER,
+ upsDiagSubSysExternalSwitchGearFirmwareRev DisplayString,
+ upsDiagSubSysExternalSwitchGearHardwareRev DisplayString,
+ upsDiagSubSysExternalSwitchGearSerialNum DisplayString,
+ upsDiagSubSysExternalSwitchGearManufactureDate DisplayString
+ }
+
+upsDiagSubSysExternalSwitchGearFrameIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The frame index entry."
+ ::= { upsDiagSubSysExternalSwitchGearEntry 1 }
+
+upsDiagSubSysExternalSwitchGearIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of the External Switch Gear."
+ ::= { upsDiagSubSysExternalSwitchGearEntry 2 }
+
+upsDiagSubSysExternalSwitchGearStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ offOk (3),
+ onOk (4),
+ offFail (5),
+ onFail (6),
+ lostComm (7)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the External Switch Gear.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ offOk(3) indicates the device status is off and OK.
+ onOk(4) indicates the device status is on and OK.
+ offFail(5) indicates the device status is off and failed.
+ onFail(6) indicates the device status is on and failed.
+ lostComm(7) indicates the device has lost communication."
+ ::= { upsDiagSubSysExternalSwitchGearEntry 3 }
+
+upsDiagSubSysExternalSwitchGearFirmwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The firmware revision of the External Switch Gear monitor card."
+ ::= { upsDiagSubSysExternalSwitchGearEntry 4 }
+
+upsDiagSubSysExternalSwitchGearHardwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware revision of the External Switch Gear monitor card."
+ ::= { upsDiagSubSysExternalSwitchGearEntry 5 }
+
+upsDiagSubSysExternalSwitchGearSerialNum OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The serial number of the External Switch Gear monitor card."
+ ::= { upsDiagSubSysExternalSwitchGearEntry 6 }
+
+upsDiagSubSysExternalSwitchGearManufactureDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date of the manufacture for the External Switch Gear monitor card."
+ ::= { upsDiagSubSysExternalSwitchGearEntry 7 }
+
+upsDiagSubSysDisplayInterfaceCardTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of Display Interface Cards attached to the UPS."
+ ::= { upsDiagnosticSubsystem 9 }
+
+upsDiagSubSysDisplayInterfaceCardTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsDiagSubSysDisplayInterfaceCardEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for diagnostics of individual Display Interface Cards."
+ ::= { upsDiagnosticSubsystem 10 }
+
+upsDiagSubSysDisplayInterfaceCardEntry OBJECT-TYPE
+ SYNTAX UpsDiagSubSysDisplayInterfaceCardEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The diagnostics of a Display Interface Card."
+ INDEX { upsDiagSubSysDisplayInterfaceCardIndex}
+ ::= { upsDiagSubSysDisplayInterfaceCardTable 1 }
+
+UpsDiagSubSysDisplayInterfaceCardEntry ::=
+ SEQUENCE {
+ upsDiagSubSysDisplayInterfaceCardFrameIndex INTEGER,
+ upsDiagSubSysDisplayInterfaceCardIndex INTEGER,
+ upsDiagSubSysDisplayInterfaceCardStatus INTEGER
+ }
+
+upsDiagSubSysDisplayInterfaceCardFrameIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The frame index entry."
+ ::= { upsDiagSubSysDisplayInterfaceCardEntry 1 }
+
+upsDiagSubSysDisplayInterfaceCardIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of the Display Interface Card."
+ ::= { upsDiagSubSysDisplayInterfaceCardEntry 2 }
+
+upsDiagSubSysDisplayInterfaceCardStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ offOk (3),
+ onOk (4),
+ offFail (5),
+ onFail (6),
+ lostComm (7)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the Display Interface Card.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ offOk(3) indicates the device status is off and OK.
+ onOk(4) indicates the device status is on and OK.
+ offFail(5) indicates the device status is off and failed.
+ onFail(6) indicates the device status is on and failed.
+ lostComm(7) indicates the device has lost communication."
+ ::= { upsDiagSubSysDisplayInterfaceCardEntry 3 }
+
+upsDiagSubSysDCCircuitBreakerTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC Circuit Breakers attached to the UPS."
+ ::= { upsDiagnosticSubsystem 11 }
+
+upsDiagSubSysDCCircuitBreakerTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsDiagSubSysDCCircuitBreakerEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for diagnostics of individual DC Circuit Breakers."
+ ::= { upsDiagnosticSubsystem 12 }
+
+upsDiagSubSysDCCircuitBreakerEntry OBJECT-TYPE
+ SYNTAX UpsDiagSubSysDCCircuitBreakerEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The diagnostics of a DC Circuit Breaker."
+ INDEX { upsDiagSubSysDCCircuitBreakerIndex}
+ ::= { upsDiagSubSysDCCircuitBreakerTable 1 }
+
+UpsDiagSubSysDCCircuitBreakerEntry ::=
+ SEQUENCE {
+ upsDiagSubSysDCCircuitBreakerFrameIndex INTEGER,
+ upsDiagSubSysDCCircuitBreakerIndex INTEGER,
+ upsDiagSubSysDCCircuitBreakerStatus INTEGER
+ }
+
+upsDiagSubSysDCCircuitBreakerFrameIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The frame index entry."
+ ::= { upsDiagSubSysDCCircuitBreakerEntry 1 }
+
+upsDiagSubSysDCCircuitBreakerIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of the DC Circuit Breaker."
+ ::= { upsDiagSubSysDCCircuitBreakerEntry 2 }
+
+upsDiagSubSysDCCircuitBreakerStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ opened (3),
+ closed (4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the DC Circuit Breaker.
+ unknown(1) indicates the circuit breaker status is unknown.
+ notInstalled(2) indicates the circuit breaker is not installed.
+ opened(3) indicates the circuit breaker is opened.
+ closed(4) indicates the circuit breaker is closed."
+ ::= { upsDiagSubSysDCCircuitBreakerEntry 3 }
+
+upsDiagSubSysSystemPowerSupplyTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of System Power Supplies attached to the UPS."
+ ::= { upsDiagnosticSubsystem 13 }
+
+upsDiagSubSysSystemPowerSupplyTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsDiagSubSysSystemPowerSupplyEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for diagnostics of individual System Power Supplies."
+ ::= { upsDiagnosticSubsystem 14 }
+
+upsDiagSubSysSystemPowerSupplyEntry OBJECT-TYPE
+ SYNTAX UpsDiagSubSysSystemPowerSupplyEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The diagnostics of a System Power Supply."
+ INDEX { upsDiagSubSysSystemPowerSupplyIndex}
+ ::= { upsDiagSubSysSystemPowerSupplyTable 1 }
+
+UpsDiagSubSysSystemPowerSupplyEntry ::=
+ SEQUENCE {
+ upsDiagSubSysSystemPowerSupplyFrameIndex INTEGER,
+ upsDiagSubSysSystemPowerSupplyIndex INTEGER,
+ upsDiagSubSysSystemPowerSupplyStatus INTEGER
+ }
+
+upsDiagSubSysSystemPowerSupplyFrameIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The frame index entry."
+ ::= { upsDiagSubSysSystemPowerSupplyEntry 1 }
+
+upsDiagSubSysSystemPowerSupplyIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of a System Power Supply."
+ ::= { upsDiagSubSysSystemPowerSupplyEntry 2 }
+
+upsDiagSubSysSystemPowerSupplyStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ offOk (3),
+ onOk (4),
+ offFail (5),
+ onFail (6),
+ lostComm (7)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the System Power Supply.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ offOk(3) indicates the device status is off and OK.
+ onOk(4) indicates the device status is on and OK.
+ offFail(5) indicates the device status is off and failed.
+ onFail(6) indicates the device status is on and failed.
+ lostComm(7) indicates the device has lost communication."
+ ::= { upsDiagSubSysSystemPowerSupplyEntry 3 }
+
+upsDiagSubSysXRCommunicationCardTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of XR Communication Cards attached to the UPS."
+ ::= { upsDiagnosticSubsystem 15 }
+
+upsDiagSubSysXRCommunicationCardTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsDiagSubSysXRCommunicationCardEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for diagnostics of individual XR Communication Cards."
+ ::= { upsDiagnosticSubsystem 16 }
+
+upsDiagSubSysXRCommunicationCardEntry OBJECT-TYPE
+ SYNTAX UpsDiagSubSysXRCommunicationCardEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The diagnostics of an XR Communication Card."
+ INDEX { upsDiagSubSysXRCommunicationCardIndex}
+ ::= { upsDiagSubSysXRCommunicationCardTable 1 }
+
+UpsDiagSubSysXRCommunicationCardEntry ::=
+ SEQUENCE {
+ upsDiagSubSysXRCommunicationCardFrameIndex INTEGER,
+ upsDiagSubSysXRCommunicationCardIndex INTEGER,
+ upsDiagSubSysXRCommunicationCardStatus INTEGER
+ }
+
+upsDiagSubSysXRCommunicationCardFrameIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The frame index entry."
+ ::= { upsDiagSubSysXRCommunicationCardEntry 1 }
+
+upsDiagSubSysXRCommunicationCardIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of an XR Communication Card."
+ ::= { upsDiagSubSysXRCommunicationCardEntry 2 }
+
+upsDiagSubSysXRCommunicationCardStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ offOk (3),
+ onOk (4),
+ offFail (5),
+ onFail (6),
+ lostComm (7)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the XR Communication Card.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ offOk(3) indicates the device status is off and OK.
+ onOk(4) indicates the device status is on and OK.
+ offFail(5) indicates the device status is off and failed.
+ onFail(6) indicates the device status is on and failed.
+ lostComm(7) indicates the device has lost communication."
+ ::= { upsDiagSubSysXRCommunicationCardEntry 3 }
+
+upsDiagSubSysExternalPowerFrameBoardTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of External Power Frame Boards attached to the UPS."
+ ::= { upsDiagnosticSubsystem 17 }
+
+upsDiagSubSysExternalPowerFrameBoardTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsDiagSubSysExternalPowerFrameBoardEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for diagnostics of individual External Power Frame Boards."
+ ::= { upsDiagnosticSubsystem 18 }
+
+upsDiagSubSysExternalPowerFrameBoardEntry OBJECT-TYPE
+ SYNTAX UpsDiagSubSysExternalPowerFrameBoardEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The diagnostics of an External Power Frame Board."
+ INDEX { upsDiagSubSysExternalPowerFrameBoardIndex}
+ ::= { upsDiagSubSysExternalPowerFrameBoardTable 1 }
+
+UpsDiagSubSysExternalPowerFrameBoardEntry ::=
+ SEQUENCE {
+ upsDiagSubSysExternalPowerFrameBoardFrameIndex INTEGER,
+ upsDiagSubSysExternalPowerFrameBoardIndex INTEGER,
+ upsDiagSubSysExternalPowerFrameBoardStatus INTEGER
+ }
+
+upsDiagSubSysExternalPowerFrameBoardFrameIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The frame index entry."
+ ::= { upsDiagSubSysExternalPowerFrameBoardEntry 1 }
+
+upsDiagSubSysExternalPowerFrameBoardIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of an External Power Frame Board."
+ ::= { upsDiagSubSysExternalPowerFrameBoardEntry 2 }
+
+upsDiagSubSysExternalPowerFrameBoardStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ offOk (3),
+ onOk (4),
+ offFail (5),
+ onFail (6),
+ lostComm (7)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the External Power Frame Board.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ offOk(3) indicates the device status is off and OK.
+ onOk(4) indicates the device status is on and OK.
+ offFail(5) indicates the device status is off and failed.
+ onFail(6) indicates the device status is on and failed.
+ lostComm(7) indicates the device has lost communication."
+ ::= { upsDiagSubSysExternalPowerFrameBoardEntry 3 }
+
+upsDiagSubSysChargerTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of Chargers attached to the UPS."
+ ::= { upsDiagnosticSubsystem 19 }
+
+ upsDiagSubSysChargerTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF UpsDiagSubSysChargerEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for diagnostics of individual chargers."
+ ::= { upsDiagnosticSubsystem 20 }
+
+upsDiagSubSysChargerEntry OBJECT-TYPE
+ SYNTAX UpsDiagSubSysChargerEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The diagnostics of a charger."
+ INDEX { upsDiagSubSysChargerIndex}
+ ::= { upsDiagSubSysChargerTable 1 }
+
+UpsDiagSubSysChargerEntry ::=
+ SEQUENCE {
+ upsDiagSubSysChargerFrameIndex INTEGER,
+ upsDiagSubSysChargerIndex INTEGER,
+ upsDiagSubSysChargerStatus INTEGER
+ }
+
+upsDiagSubSysChargerFrameIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The frame index entry."
+ ::= { upsDiagSubSysChargerEntry 1 }
+
+upsDiagSubSysChargerIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of a charger."
+ ::= { upsDiagSubSysChargerEntry 2 }
+
+upsDiagSubSysChargerStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ offOk (3),
+ onOk (4),
+ offFail (5),
+ onFail (6),
+ lostComm (7)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the Charger.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ offOk(3) indicates the device status is off and OK.
+ onOk(4) indicates the device status is on and OK.
+ offFail(5) indicates the device status is off and failed.
+ onFail(6) indicates the device status is on and failed.
+ lostComm(7) indicates the device has lost communication."
+ ::= { upsDiagSubSysChargerEntry 3 }
+
+-- the upsDiagnosticExternalDevices group
+
+upsDiagSwitchGearStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ ok (3),
+ fail (4),
+ lostComm (5),
+ overtemp (6)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the Switch Gear.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ ok(3) indicates the device status is OK.
+ fail(4) indicates the device status has failed.
+ lostComm(5) indicates the device has lost communication.
+ overtemp(6) indicates the device has an over temperature condition."
+ ::= { upsDiagSwitchGear 1 }
+
+upsDiagSwitchGearInputSwitchStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ opened (3),
+ closed (4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the Switch Gear Input Switch.
+ unknown(1) indicates the switch status is unknown.
+ notInstalled(2) indicates the switch is not installed.
+ opened(3) indicates the switch is opened.
+ closed(4) indicates the switch is closed."
+ ::= { upsDiagSwitchGear 2 }
+
+upsDiagSwitchGearOutputSwitchStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ opened (3),
+ closed (4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the Switch Gear Output Switch.
+ unknown(1) indicates the switch status is unknown.
+ notInstalled(2) indicates the switch is not installed.
+ opened(3) indicates the switch is opened.
+ closed(4) indicates the switch is closed."
+ ::= { upsDiagSwitchGear 3 }
+
+upsDiagSwitchGearBypassSwitchStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ opened (3),
+ closed (4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the Switch Gear Bypass Switch.
+ unknown(1) indicates the switch status is unknown.
+ notInstalled(2) indicates the switch is not installed.
+ opened(3) indicates the switch is opened.
+ closed(4) indicates the switch is closed."
+ ::= { upsDiagSwitchGear 4 }
+
+upsDiagMCCBBoxStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ opened (3),
+ closed (4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the MCCB Box (Molded Case Circuit Breaker Box) external device.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ opened(3) indicates the circuit is opened.
+ closed(4) indicates the circuit is closed."
+ ::= { upsDiagMCCBBox 1 }
+
+upsDiagTransformerStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ ok (3),
+ fail (4),
+ lostComm (5),
+ overtemp (6),
+ opened (7),
+ closed (8)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the External Transformer.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ ok(3) indicates the device status is OK.
+ fail(4) indicates the device status has failed.
+ lostComm(5) indicates the device has lost communication.
+ overtemp(6) indicates the device has an over temperature condition.
+ opened(7) indicates the circuit is opened.
+ closed(8) indicates the circuit is closed."
+ ::= { upsDiagTransformer 1 }
+
+-- the upsDiagnosticComBus group
+
+upsDiagComBusInternalMIMStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ ok (3),
+ lostComm (4),
+ rxFailure (5),
+ txFailure (6)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the internal MIM communication bus.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ ok(3) indicates the device status is OK.
+ lostComm(4) indicates the device has lost communication.
+ rxFailure(5) indicates the device has a receive failure.
+ txFailure(6) indicates the device has a transmit failure."
+ ::= { upsDiagnosticComBus 1 }
+
+upsDiagComBusInternalRIMStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ ok (3),
+ lostComm (4),
+ rxFailure (5),
+ txFailure (6)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the internal RIM communication bus.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ ok(3) indicates the device status is OK.
+ lostComm(4) indicates the device has lost communication.
+ rxFailure(5) indicates the device has a receive failure.
+ txFailure(6) indicates the device has a transmit failure."
+ ::= { upsDiagnosticComBus 2 }
+
+upsDiagComBusMIMtoRIMStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ ok (3),
+ lostComm (4),
+ rxFailure (5),
+ txFailure (6)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the MIM to RIM communication bus.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ ok(3) indicates the device status is OK.
+ lostComm(4) indicates the device has lost communication.
+ rxFailure(5) indicates the device has a receive failure.
+ txFailure(6) indicates the device has a transmit failure."
+ ::= { upsDiagnosticComBus 3 }
+
+upsDiagComBusExternalMIMStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ ok (3),
+ lostComm (4),
+ rxFailure (5),
+ txFailure (6)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the external MIM communication bus.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ ok(3) indicates the device status is OK.
+ lostComm(4) indicates the device has lost communication.
+ rxFailure(5) indicates the device has a receive failure.
+ txFailure(6) indicates the device has a transmit failure."
+ ::= { upsDiagnosticComBus 4 }
+
+upsDiagComBusExternalRIMStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown (1),
+ notInstalled (2),
+ ok (3),
+ lostComm (4),
+ rxFailure (5),
+ txFailure (6)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the external RIM communication bus.
+ unknown(1) indicates the device status is unknown.
+ notInstalled(2) indicates the device is not installed.
+ ok(3) indicates the device status is OK.
+ lostComm(4) indicates the device has lost communication.
+ rxFailure(5) indicates the device has a receive failure.
+ txFailure(6) indicates the device has a transmit failure."
+ ::= { upsDiagnosticComBus 5 }
+
+-- the serialPort2Config group
+
+serialPort2Mode OBJECT-TYPE
+ SYNTAX INTEGER {
+ localConsole(1),
+ passthrough(2)
+ }
+ ACCESS read-write
+ STATUS obsolete
+ DESCRIPTION
+ "Setting this variable to passthrough will enable mini's port2
+ behave like a UPS port. Choosing localConsole will enable the port
+ to be used as local console."
+ ::= { serialPort2Config 1 }
+-- the serialPort2Control group
+
+setPulseOnTXD OBJECT-TYPE
+ SYNTAX INTEGER {
+ noSetPulseOnTXD(1),
+ setPulseOnTXD(2),
+ setTXDLow(3),
+ setTXDHigh(4)
+
+ }
+ ACCESS read-write
+ STATUS obsolete
+ DESCRIPTION
+ "Setting this variable to setPulseOnTXD(2)
+ causes adapter to generate a PULSE on TXD pin of serial port 2.
+ The duration in the prototype implementation will be 1 second.
+
+ Setting this value to noSetPulseOnTXD(1) has no
+ effect.
+
+ The value noSetPulseOnTXD(1) will always be returned
+ when the variable is read.
+
+ Setting this value to setTXDLow(3), or setTXDHigh(4) will keep TXD
+ always low or high respectively."
+ ::= { serialPort2Control 1 }
+
+-- the sPDUIdent group
+
+sPDUIdentHardwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware revision of the PDU. This value
+ is set at the factory."
+ ::= { sPDUIdent 1 }
+
+sPDUIdentFirmwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An 8 byte ID string identifying the PDU firmware revision.
+ This value is set at the factory."
+ ::= { sPDUIdent 2 }
+
+
+sPDUIdentDateOfManufacture OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date when the PDU was manufactured in mm/dd/yy format.
+ This value is set at the factory. The year 2000 will be
+ represented by 00."
+ ::= { sPDUIdent 3 }
+
+sPDUIdentModelNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A 10-character string identifying the model number of
+ the PDU internal. This value is set at the factory."
+ ::= { sPDUIdent 4 }
+
+sPDUIdentSerialNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A 12-character string identifying the serial number of
+ the PDU internal microprocessor. This value is set at
+ the factory."
+ ::= { sPDUIdent 5 }
+
+
+-- the sPDUMasterControl group
+
+sPDUMasterControlSwitch OBJECT-TYPE
+ SYNTAX INTEGER {
+ turnAllOnNow (1),
+ turnAllOnSequence (2),
+ turnAllOffNow (3),
+ rebootAllNow (4),
+ rebootAllSequence (5),
+ noCommand (6),
+ turnAllOffSequence (7)
+ }
+
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to turnAllOnNow (1) will turn all outlets
+ on immediately.
+
+ Setting this OID to turnAllOnSequence (2) will turn all outlets
+ on as defined by each outlet's sPDUOutletPowerOnTime OID value.
+
+ Setting this OID to turnAllOff (3) will turn all outlets
+ off immediately.
+
+ Setting this OID to rebootAllNow (4) will reboot all outlets
+ immediately.
+
+ For MasterSwitch firmware version 1.X, setting this OID to
+ rebootAllSequence (5) reboots all outlets, with power returned
+ to the outlets in the sequence defined by each outlet's
+ sPDUOutletPowerOnTime OID value.
+
+ For MasterSwitch firmware version 2.X, setting this OID to
+ rebootAllSequence (5) will cause a turnAllOffSequence to be performed.
+ Once all outlets are off, the MasterSwitch will then delay the
+ sPDUMasterConfigReboot OID time, and then perform a turnAllOnSequence.
+
+ For MasterSwitch firmware version 2.X, setting this OID to
+ turnAllOffSequence (7) will turn all outlets off as defined by
+ each outlet's sPDUOutletPowerOffTime OID value.
+
+ For MasterSwitch firmware version 1.X, setting this OID to
+ turnAllOffSequence (7) will have no effect.
+
+ Getting this OID will return the noCommand (6) value."
+
+ ::= { sPDUMasterControl 1 }
+
+
+sPDUMasterState OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will cause the status of all outlets to be
+ returned. This OID is provided for informational purposes only.
+ To change the outlet state, the user should use the sPDUOutletCtl
+ OID in the sPDUOutletControlTable.
+
+ The format of the data returned is a character string consisting
+ of the word 'On' if the outlet is on or 'Off' if the outlet is
+ off. At least one space will delimit each outlet entry in the
+ string.
+
+ If the outlet states are unknown, the character string 'Unknown'
+ will be returned. This signifies that there is an inconsistancy
+ in the PDU. In the rare case that this should happen, the user
+ is advised to shut down all equipment powered by the PDU and
+ then cycle the PDU's power. This will put the PDU in a consistent
+ state."
+
+ ::= { sPDUMasterControl 2 }
+
+sPDUMasterPending OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will cause the command pending status of all outlets to be returned.
+
+ The format of the data returned is a character string consisting
+ of the word 'Yes' if a command is pending for the outlet or 'No'
+ if there is no command pending for the outlet. At least one
+ space will delimit each outlet entry in the string.
+
+ If the pending states are unknown, the character string 'Unknown'
+ will be returned. This signifies that there is an inconsistancy
+ in the PDU. In the rare case that this should happen, the user
+ is advised to shut down all equipment powered by the PDU and then
+ cycle the PDU's power. This will put the PDU in a consistent state."
+ ::= { sPDUMasterControl 3 }
+
+
+-- the sPDUMasterConfig group
+
+sPDUMasterConfigPowerOn OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ " The amount of delay, in seconds, between when
+ power is provided to the PDU and when the PDU
+ provides basic master power to the outlets.
+
+ Allowed values are:
+
+ -1 never apply power automatically.
+ 0 apply power immediately.
+ 15 apply power in 15 seconds.
+ 30 apply power in 30 seconds.
+ 45 apply power in 45 seconds.
+ 60 apply power in 60 seconds (1 minute).
+ 120 apply power in 120 seconds (2 minutes).
+ 300 apply power in 300 seconds (5 minutes).
+
+ If a value other than a supported value is provided in a
+ set request, the PDU interprets it as the next lower
+ acceptable value. If the provided value is lower than
+ the lowest acceptable value, the lowest acceptable
+ value is used."
+
+ ::= { sPDUMasterConfig 1 }
+
+sPDUMasterConfigReboot OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "During a reboot sequence, power is turned off and then
+ back on. This OID defines the amount of time to wait,
+ in seconds, after turning the power off, at the start
+ of the sequence, before turning power back on, at the
+ end of the reboot sequence.
+
+ Allowed values are:
+
+ 5 wait 5 seconds between off/on.
+ 10 wait 10 seconds between off/on.
+ 15 wait 15 seconds between off/on.
+ 20 wait 20 seconds between off/on.
+ 30 wait 30 seconds between off/on.
+ 45 wait 45 seconds between off/on.
+ 60 wait 60 seconds (1 minute) between off/on.
+
+ If a value other than a supported value is provided in a
+ set request, the PDU interprets it as the next lower
+ acceptable value. If the provided value is lower than
+ the lowest acceptable value, the lowest acceptable
+ value is used.
+
+ This OID is read-only for the MasterSwitch version 2.X and is the
+ maximum sPDUOutletRebootDuration OID of the individual outlets."
+
+ ::= { sPDUMasterConfig 2 }
+
+sPDUMasterConfigPDUName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the PDU. The maximum value is 20 characters."
+ ::= { sPDUMasterConfig 3 }
+
+
+
+-- the sPDUOutletControl group
+sPDUOutletControlTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of outlets for the PDU."
+ ::= { sPDUOutletControl 1 }
+
+
+sPDUOutletControlTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF OutletControlEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for control of individual outlet switches. The number of
+ entries is contained in the sPDUOutletControlTableSize OID."
+ ::= { sPDUOutletControl 2 }
+
+sPDUOutletControlEntry OBJECT-TYPE
+ SYNTAX OutletControlEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlets to control."
+ INDEX { sPDUOutletControlIndex}
+ ::= { sPDUOutletControlTable 1 }
+
+OutletControlEntry ::=
+ SEQUENCE {
+ sPDUOutletControlIndex INTEGER,
+ sPDUOutletPending INTEGER,
+ sPDUOutletCtl INTEGER,
+ sPDUOutletCtlName DisplayString
+ }
+
+sPDUOutletControlIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { sPDUOutletControlEntry 1 }
+
+sPDUOutletPending OBJECT-TYPE
+ SYNTAX INTEGER{
+ commandPending (1),
+ noCommandPending (2),
+ commandPendingUnknown (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Reports whether the current outlet has a pending command.
+
+ If the commandPendingUnknown (3) value is returned, all
+ devices powered by the PDU should be shut down. The PDU's
+ power should then be cycled to clear this condition."
+
+ ::= { sPDUOutletControlEntry 2 }
+
+sPDUOutletCtl OBJECT-TYPE
+ SYNTAX INTEGER {
+ outletOn (1),
+ outletOff (2),
+ outletReboot (3),
+ outletUnknown (4),
+ outletOnWithDelay (5),
+ outletOffWithDelay (6),
+ outletRebootWithDelay (7)
+ }
+
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the outlet state. If
+ the outlet is on, the outletOn (1) value will be returned.
+ If the outlet is off, the outletOff (2) value will be
+ returned.
+
+ If the state of the outlet cannot be determined, the
+ outletUnknown (4) value will be returned. If the
+ outletUnknown condition should occur, all devices
+ powered by the PDU should be shut down. The PDU's power
+ should then be cycled to clear this condition.
+
+ Setting this variable to outletOn (1) will turn the outlet on.
+
+ Setting this variable to outletOff (2) will turn the outlet off.
+
+ Setting this variable to outletReboot (3) will reboot the outlet.
+
+ Setting this variable to outletOnWithDelay (5) will turn the outlet on
+ after the sPDUOutletPowerOnTime OID has elapsed. This option is not
+ valid for MasterSwitch firmware version 1.X.
+
+ Setting this variable to outletOffWithDelay (6) will turn the outlet off
+ after the sPDUOutletPowerOffTime OID has elapsed. This option is not valid
+ for MasterSwitch firmware version 1.X.
+
+ Setting this variable to outletRebootWithDelay (7) will turn the outlet off
+ after the sPDUOutletPowerOffTime OID has elapsed, wait the sPDUOutletRebootDuration
+ OID time, then turn the outlet back on.
+ This option is not valid for MasterSwitch firmware version 1.X."
+
+ ::= { sPDUOutletControlEntry 3 }
+
+sPDUOutletCtlName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet. Maximum size is 20 characters.
+ This OID is provided for informational purposes only.
+ This value is set by the sPDUOutletName OID."
+
+ ::= { sPDUOutletControlEntry 4 }
+
+-- the sPDUOutletConfig group
+sPDUOutletConfigTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of outlets for the PDU."
+ ::= { sPDUOutletConfig 1 }
+
+sPDUOutletConfigTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF SPDUOutletConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The list of outlets to configure. The number of
+ entries is defined by the sPDUOutletConfigTableSize
+ OID."
+
+ ::= { sPDUOutletConfig 2 }
+
+sPDUOutletConfigEntry OBJECT-TYPE
+ SYNTAX SPDUOutletConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlets to control."
+ INDEX { sPDUOutletConfigIndex}
+ ::= { sPDUOutletConfigTable 1 }
+
+SPDUOutletConfigEntry ::=
+ SEQUENCE {
+ sPDUOutletConfigIndex INTEGER,
+ sPDUOutletPowerOnTime INTEGER,
+ sPDUOutletName DisplayString,
+ sPDUOutletPowerOffTime INTEGER,
+ sPDUOutletRebootDuration INTEGER
+ }
+
+sPDUOutletConfigIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { sPDUOutletConfigEntry 1 }
+
+sPDUOutletPowerOnTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The amount of time (in seconds) the outlet will delay
+ powering on when the MasterSwitch is powered on.
+
+ Allowed values are:
+
+ -1 never power on automatically.
+ 0 power on with the Master Switch.
+ 15 power on 15 seconds after the MasterSwitch has power applied.
+ 30 power on 30 seconds after the MasterSwitch has power applied.
+ 45 power on 45 seconds after the MasterSwitch has power applied.
+ 60 power on 60 seconds (1 minute) after the MasterSwitch has power applied.
+ 120 power on 120 seconds (2 minutes) after the MasterSwitch has power applied.
+ 300 power on 300 seconds (5 minutes) after the MasterSwitch has power applied.
+
+ If a value other than a supported value is provided in a
+ set request, the PDU interprets it as the next lower
+ acceptable value. If the provided value is lower than
+ the lowest acceptable value, the lowest acceptable
+ value is used."
+
+ ::= { sPDUOutletConfigEntry 2 }
+
+sPDUOutletName OBJECT-TYPE
+ SYNTAX DisplayString ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet. Maximum size is 20 characters."
+
+ ::= { sPDUOutletConfigEntry 3 }
+
+sPDUOutletPowerOffTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The amount of time (in seconds) the outlet will delay
+ powering off.
+
+ Allowed values are:
+
+ -1 never power off automatically.
+ 0 power off with the MasterSwitch.
+ 15 power off 15 seconds after being commanded.
+ 30 power off 30 seconds after being commanded.
+ 45 power off 45 seconds after being commanded.
+ 60 power off 60 seconds (1 minute) after being commanded.
+ 120 power off 120 seconds (2 minutes) after being commanded.
+ 300 power off 300 seconds (5 minutes) after being commanded.
+
+ If a value other than a supported value is provided in a
+ set request, the PDU interprets it as the next lower
+ acceptable value. If the provided value is lower than
+ the lowest acceptable value, the lowest acceptable
+ value is used.
+
+ This OID is not available for MasterSwitch firmware version 1.X."
+
+ ::= { sPDUOutletConfigEntry 4 }
+
+sPDUOutletRebootDuration OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "During a reboot sequence, power is turned off and then
+ back on. This OID defines the amount of time to wait,
+ in seconds, after turning the power off, at the start
+ of the sequence, before turning power back on, at the
+ end of the reboot sequence.
+
+ Allowed values are:
+
+ 5 wait 5 seconds between off/on.
+ 10 wait 10 seconds between off/on.
+ 15 wait 15 seconds between off/on.
+ 20 wait 20 seconds between off/on.
+ 30 wait 30 seconds between off/on.
+ 45 wait 45 seconds between off/on.
+ 60 wait 60 seconds (1 minute) between off/on.
+
+ If a value other than a supported value is provided in a
+ set request, the PDU interprets it as the next lower
+ acceptable value. If the provided value is lower than
+ the lowest acceptable value, the lowest acceptable
+ value is used.
+
+ This OID is not available for MasterSwitch firmware version 1.X."
+
+ ::= { sPDUOutletConfigEntry 5 }
+
+
+-- the sPDUIdentVM group
+
+sPDUIdentVMTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of MasterSwitch VMs controllable
+ by this IP address."
+ ::= { sPDUIdentVM 1 }
+
+
+sPDUIdentVMTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF IdentVMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for query of the individual MasterSwitch VMs.
+ The number of entries is contained in the
+ sPDUIdentVMTableSize OID."
+ ::= { sPDUIdentVM 2 }
+
+sPDUIdentVMEntry OBJECT-TYPE
+ SYNTAX IdentVMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The MasterSwitch VMs to query."
+ INDEX { sPDUIdentVMIndex}
+ ::= { sPDUIdentVMTable 1 }
+
+IdentVMEntry ::=
+ SEQUENCE {
+ sPDUIdentVMIndex INTEGER,
+ sPDUIdentNameVM DisplayString,
+ sPDUIdentHardwareRevVM DisplayString,
+ sPDUIdentFirmwareRevVM DisplayString,
+ sPDUIdentDateOfManufactureVM DisplayString,
+ sPDUIdentModelNumberVM DisplayString,
+ sPDUIdentSerialNumberVM DisplayString
+ }
+
+sPDUIdentVMIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch VM entry."
+ ::= { sPDUIdentVMEntry 1 }
+
+sPDUIdentNameVM OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A 23-character string identifying the
+ MasterSwitch VM. "
+ ::= { sPDUIdentVMEntry 2 }
+
+sPDUIdentHardwareRevVM OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware version of the MasterSwitch VM.
+ This value is set at the factory."
+ ::= { sPDUIdentVMEntry 3 }
+
+sPDUIdentFirmwareRevVM OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An 6-character ID string identifying the MasterSwitch VM
+ firmware version. This value is set at the factory."
+ ::= { sPDUIdentVMEntry 4 }
+
+
+sPDUIdentDateOfManufactureVM OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date when the MasterSwitch VM was manufactured in mm/dd/yyyy format.
+ This value is set at the factory. "
+ ::= { sPDUIdentVMEntry 5 }
+
+sPDUIdentModelNumberVM OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A 17-character string identifying the model number of
+ the MasterSwitch VM. This value is set at the factory."
+ ::= { sPDUIdentVMEntry 6 }
+
+sPDUIdentSerialNumberVM OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A 17-character string identifying the serial number of
+ the MasterSwitch VM. This value is set at the factory."
+ ::= { sPDUIdentVMEntry 7 }
+
+
+-- the sPDUMasterControlVM group
+
+sPDUMasterControlVMTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of MasterSwitch VMs controllable
+ by this IP address."
+ ::= { sPDUMasterControlVM 1 }
+
+
+sPDUMasterControlVMTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF MasterControlVMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for control of the individual MasterSwitch VMs.
+ The number of entries is contained in the
+ sPDUMasterControlVMTableSize OID."
+ ::= { sPDUMasterControlVM 2 }
+
+sPDUMasterControlVMEntry OBJECT-TYPE
+ SYNTAX MasterControlVMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The MasterSwitch VMs to control."
+ INDEX { sPDUMasterControlVMIndex}
+ ::= { sPDUMasterControlVMTable 1 }
+
+MasterControlVMEntry ::=
+ SEQUENCE {
+ sPDUMasterControlVMIndex INTEGER,
+ sPDUMasterControlVMName DisplayString,
+ sPDUMasterControlVMCommand INTEGER
+ }
+
+sPDUMasterControlVMIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch VM entry."
+ ::= { sPDUMasterControlVMEntry 1 }
+
+sPDUMasterControlVMName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch VM. The maximum
+ value is 23 characters. The name is set by
+ using the sPDUMasterConfigVMName OID."
+ ::= { sPDUMasterControlVMEntry 2 }
+
+sPDUMasterControlVMCommand OBJECT-TYPE
+ SYNTAX INTEGER {
+ noCommandAllVM (1),
+ immediateAllOnVM (2),
+ immediateAllOffVM (3),
+ immediateAllRebootVM (4),
+ delayedAllOnVM (5),
+ delayedAllOffVM (6),
+ sequencedAllRebootVM (7),
+ delayedAllRebootVM (8),
+ delayedSequenceAllRebootVM (9),
+ cancelAllPendingCommandsVM (10),
+ audioAlarmMute (11)
+ }
+
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to immediateAllOnVM (2) will turn all outlets
+ on immediately.
+
+ Setting this OID to immediateAllOffVM (3) will turn all outlets
+ off immediately.
+
+ Setting this OID to immediateAllRebootVM (4) will reboot all outlets
+ immediately.
+
+ Setting this OID to delayedAllOnVM (5) will turn all outlets on as
+ defined by each outlet's sPDUOutletConfigVMPowerOnTime OID value.
+
+ Setting this OID to delayedAllOffVM (6) will turn all outlets
+ off as defined by each outlet's sPDUOutletConfigVMPowerOffTime OID value.
+
+ Setting this OID to sequencedAllRebootVM (7) will cause a
+ immediateAllOffVM command to be performed. The MasterSwitch VM will
+ then delay the sPDUMasterStatusVMRebootDuration OID time, and then
+ perform a delayedAllOnVM command.
+
+ Setting this OID to delayedAllRebootVM (8) will cause a delayedAllOffVM
+ command to be performed. Each outlet will then wait its
+ sPDUOutletConfigVMRebootDuration before returning power to the outlet.
+
+ Setting this OID to delayedSequenceAllRebootVM (9) will cause a
+ delayedAllOffVM command to be performed. Once all outlets are off,
+ the MasterSwitch VM will then delay the sPDUMasterStatusVMRebootDuration
+ OID time, and then perform a delayedAllOnVM command.
+
+ Setting this OID to cancelAllPendingCommandsVM (10) will cause all pending
+ commands on the MasterSwitch VM to be canceled.
+
+
+ Setting this OID to audioAlarmMute (11) will temporarily silence the audible
+ alarm for the duration of the current overload condition. The audible alarm
+ will be activated on subsequent overload alarms.
+
+ Getting this OID will return the noCommandAllVM (1) value."
+ ::= { sPDUMasterControlVMEntry 3 }
+
+
+-- the sPDUMasterConfigVM group
+
+sPDUMasterConfigVMTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of MasterSwitch VMs configurable
+ by this IP address."
+ ::= { sPDUMasterConfigVM 1 }
+
+
+sPDUMasterConfigVMTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF MasterConfigVMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of the individual MasterSwitch VMs.
+ The number of entries is contained in the
+ sPDUMasterConfigVMTableSize OID."
+ ::= { sPDUMasterConfigVM 2 }
+
+sPDUMasterConfigVMEntry OBJECT-TYPE
+ SYNTAX MasterConfigVMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The MasterSwitch VMs to configure."
+ INDEX { sPDUMasterConfigVMIndex}
+ ::= { sPDUMasterConfigVMTable 1 }
+
+MasterConfigVMEntry ::=
+ SEQUENCE {
+ sPDUMasterConfigVMIndex INTEGER,
+ sPDUMasterConfigVMName DisplayString,
+ sPDUMasterConfigVMColdstartDelay INTEGER,
+ sPDUMasterConfigVMAudioAlarmActivated INTEGER,
+ sPDUMasterConfigVMHighLoadWarningThreshold INTEGER,
+ sPDUMasterConfigVMLowLoadWarningThreshold INTEGER,
+ sPDUMasterConfigVMOverloadRestriction INTEGER
+ }
+
+sPDUMasterConfigVMIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch VM entry."
+ ::= { sPDUMasterConfigVMEntry 1 }
+
+
+sPDUMasterConfigVMName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch VM. Maximum size is 23 characters."
+ ::= { sPDUMasterConfigVMEntry 2 }
+
+sPDUMasterConfigVMColdstartDelay OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ " The amount of delay, in seconds, between when
+ power is provided to the MasterSwitch VM and
+ when the MasterSwitch VM provides basic master
+ power to the outlets.
+
+ Allowed values are:
+
+ -1 never apply power automatically.
+ 0 apply power immediately.
+ 15 apply power in 15 seconds.
+ 30 apply power in 30 seconds.
+ 45 apply power in 45 seconds.
+ 60 apply power in 60 seconds (1 minute).
+ 120 apply power in 120 seconds (2 minutes).
+ 300 apply power in 300 seconds (5 minutes).
+
+ If a value other than a supported value is provided in a
+ set request, the MasterSwitch VM interprets it as the next lower
+ acceptable value. If the provided value is lower than
+ the lowest acceptable value, the lowest acceptable
+ value is used."
+ ::= { sPDUMasterConfigVMEntry 3 }
+
+sPDUMasterConfigVMAudioAlarmActivated OBJECT-TYPE
+ SYNTAX INTEGER {
+ audioAlarmActiveNever (1),
+ audioAlarmActiveOnOverload (2),
+ audioAlarmActiveOnOverloadImminent (3)
+ }
+
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to audioAlarmActiveNever (1) will disable
+ the audio alarm on the MasterSwitch VM.
+
+ Setting this OID to audioAlarmActiveOnOverload (2) will
+ activate the audio alarm on the MasterSwitch VM when an
+ overload condition is present.
+
+ Setting this OID to audioAlarmActiveOnOverloadImminent (3)
+ will activate the audio alarm on the MasterSwitch VM when
+ the load on the MasterSwitch VM has surpassed the
+ sPDUMasterConfigVMHighLoadWarningThreshold OID value."
+ ::= { sPDUMasterConfigVMEntry 4 }
+
+sPDUMasterConfigVMHighLoadWarningThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..100)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A threshold that indicates the power consumption of
+ the load is nearing an overload condition. It is
+ represented as a percentage of full load."
+ ::= { sPDUMasterConfigVMEntry 5 }
+
+sPDUMasterConfigVMLowLoadWarningThreshold OBJECT-TYPE
+ SYNTAX INTEGER (0..100)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A threshold that indicates the power consumption of
+ the load is nearing a low consumption condition. It is
+ represented as a percentage of full load."
+ ::= { sPDUMasterConfigVMEntry 6 }
+
+sPDUMasterConfigVMOverloadRestriction OBJECT-TYPE
+ SYNTAX INTEGER {
+ alwaysAllowTurnON (1),
+ restrictOnWarning (2),
+ restrictOnOverload (3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This OID controls the behavior of the MasterSwitch VM
+ when an overload condition is possible and additional
+ outlets are requested to be turned on.
+
+ Setting this OID to alwaysAllowTurnON (1) will always allow
+ the outlets to turn on.
+
+ Setting this OID to restrictOnWarning (2) will not allow
+ outlets to turn on if the sPDUMasterConfigVMHighLoadWarningThreshold
+ OID is exceeded.
+
+ Setting this OID to restrictOnOverload (3) will not allow
+ outlets to turn on if the MasterSwitch Vm is in an
+ overload condition."
+ ::= { sPDUMasterConfigVMEntry 7 }
+
+-- the sPDUMasterStatusVM group
+
+sPDUMasterStatusVMTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of MasterSwitch VMs at
+ this IP address."
+ ::= { sPDUMasterStatusVM 1 }
+
+
+sPDUMasterStatusVMTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF MasterStatusVMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for gathering of status from the individual
+ MasterSwitch VMs. The number of entries is contained
+ in the sPDUMasterStatusVMTableSize OID."
+ ::= { sPDUMasterStatusVM 2 }
+
+sPDUMasterStatusVMEntry OBJECT-TYPE
+ SYNTAX MasterStatusVMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The MasterSwitch VMs to gather status from."
+ INDEX { sPDUMasterStatusVMIndex}
+ ::= { sPDUMasterStatusVMTable 1 }
+
+MasterStatusVMEntry ::=
+ SEQUENCE {
+ sPDUMasterStatusVMIndex INTEGER,
+ sPDUMasterStatusVMName DisplayString,
+ sPDUMasterStatusVMCommandPending INTEGER,
+ sPDUMasterStatusVMOverloadCondition INTEGER,
+ sPDUMasterStatusVMLowLoadCondition INTEGER,
+ sPDUMasterStatusVMCurrentLoad INTEGER,
+ sPDUMasterStatusVMMaxLoad INTEGER,
+ sPDUMasterStatusVMOutletCount INTEGER,
+ sPDUMasterStatusVMRebootDuration INTEGER
+ }
+
+sPDUMasterStatusVMIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch VM entry."
+ ::= { sPDUMasterStatusVMEntry 1 }
+
+sPDUMasterStatusVMName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch VM. Maximum size is 23 characters."
+ ::= { sPDUMasterStatusVMEntry 2 }
+
+sPDUMasterStatusVMCommandPending OBJECT-TYPE
+ SYNTAX INTEGER {
+ commandPendingMasterTrueVM (1),
+ commandPendingMasterFalseVM (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return commandPendingMasterTrueVM (1)
+ if the MasterSwitch VM has a pending command on any of its
+ outlets.
+
+ commandPendingMasterFalseVM (2) will be returned if there are
+ no pending commands."
+ ::= { sPDUMasterStatusVMEntry 3 }
+
+sPDUMasterStatusVMOverloadCondition OBJECT-TYPE
+ SYNTAX INTEGER {
+ overloadConditionTrueVM (1),
+ overloadConditionFalseVM (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return overloadConditionTrueVM (1)
+ if the sPDUMasterConfigVMHighLoadWarningThreshold OID is
+ violated.
+
+ overloadConditionFalseVM (2) will be returned if the
+ sPDUMasterConfigVMHighLoadWarningThreshold OID is not
+ violated."
+ ::= { sPDUMasterStatusVMEntry 4 }
+
+sPDUMasterStatusVMLowLoadCondition OBJECT-TYPE
+ SYNTAX INTEGER {
+ lowLoadConditionTrueVM (1),
+ lowLoadConditionFalseVM (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return lowLoadConditionTrueVM (1)
+ if the sPDUMasterConfigVMLowLoadWarningThreshold OID is
+ violated.
+
+ lowLoadConditionFalseVM (2) will be returned if the
+ sPDUMasterConfigVMHighLoadWarningThreshold OID is not
+ violated. "
+ ::= { sPDUMasterStatusVMEntry 5 }
+
+sPDUMasterStatusVMCurrentLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the total amount of power
+ being consumed by the load. It is represented as a
+ percentage of full load."
+ ::= { sPDUMasterStatusVMEntry 6 }
+
+sPDUMasterStatusVMMaxLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the total amount of power
+ that this MasterSwitch VM can provide. It is represented
+ in Amps."
+ ::= { sPDUMasterStatusVMEntry 7 }
+
+sPDUMasterStatusVMOutletCount OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the number of controllable
+ outlets for this MasterSwitch VM."
+ ::= { sPDUMasterStatusVMEntry 8 }
+
+sPDUMasterStatusVMRebootDuration OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the largest
+ sPDUOutletConfigVMRebootDuration OID time
+ for this MasterSwitch VM."
+ ::= { sPDUMasterStatusVMEntry 9 }
+
+-- the sPDUOutletControlVM group
+
+
+sPDUOutletControlVMTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF OutletControlVMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for control of individual outlet switches. The number of
+ entries is contained in the sPDUMasterStatusOutletCount OID."
+ ::= { sPDUOutletControlVM 1 }
+
+sPDUOutletControlVMEntry OBJECT-TYPE
+ SYNTAX OutletControlVMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlets to control."
+ INDEX { sPDUOutletControlVMIndex, sPDUOutletControlVMOutletIndex }
+ ::= { sPDUOutletControlVMTable 1 }
+
+OutletControlVMEntry ::=
+ SEQUENCE {
+ sPDUOutletControlVMIndex INTEGER,
+ sPDUOutletControlVMName DisplayString,
+ sPDUOutletControlVMOutletIndex INTEGER,
+ sPDUOutletControlVMOutletName DisplayString,
+ sPDUOutletControlVMOutletCommand INTEGER
+ }
+
+sPDUOutletControlVMIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch VM."
+ ::= { sPDUOutletControlVMEntry 1 }
+
+sPDUOutletControlVMName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch VM. Maximum size is 23 characters.
+ This OID is provided for informational purposes only."
+ ::= { sPDUOutletControlVMEntry 2 }
+
+sPDUOutletControlVMOutletIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { sPDUOutletControlVMEntry 3 }
+
+sPDUOutletControlVMOutletName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet. Maximum size is 23 characters.
+ This OID is provided for informational purposes only."
+ ::= { sPDUOutletControlVMEntry 4 }
+
+sPDUOutletControlVMOutletCommand OBJECT-TYPE
+ SYNTAX INTEGER {
+ immediateOnVM (1),
+ immediateOffVM (2),
+ immediateRebootVM (3),
+ delayedOnVM (4),
+ delayedOffVM (5),
+ delayedRebootVM (6),
+ cancelPendingCommandVM (7)
+
+ }
+
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the outlet state. If
+ the outlet is on, the immediateOnVM (1) value will be returned.
+ If the outlet is off, the immediateOffVM (2) value will be
+ returned.
+
+
+ Setting this variable to immediateOnVM (1) will immediately turn the outlet on.
+
+ Setting this variable to immediateOffVM (2) will immediately turn the outlet off.
+
+ Setting this variable to immediateRebootVM (3) will immediately reboot the outlet.
+
+ Setting this variable to delayedOnVM (4) will turn the outlet on
+ after the sPDUOutletConfigVMPowerOnTime OID time has elapsed.
+
+ Setting this variable to delayedOffVM (5) will turn the outlet off
+ after the sPDUOutletConfigVMPowerOffTime OID time has elapsed.
+
+ Setting this variable to delayedRebootVM (6) will cause the
+ MasterSwitch VM to perform a delayedOffVM command, wait the
+ sPDUOutletConfigVMRebootDuration OID time, and then perform the
+ immediateOnVM command.
+
+ Setting this variable to cancelPendingCommandVM (7) will cause any
+ pending command to this outlet to be canceled."
+ ::= { sPDUOutletControlVMEntry 5 }
+
+-- the sPDUOutletConfigVM group
+
+sPDUOutletConfigVMTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF OutletConfigVMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of individual outlets. The number of
+ entries is contained in the sPDUMasterStatusOutletCount OID."
+ ::= { sPDUOutletConfigVM 1 }
+
+sPDUOutletConfigVMEntry OBJECT-TYPE
+ SYNTAX OutletConfigVMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlets to configure."
+ INDEX { sPDUOutletConfigVMIndex, sPDUOutletConfigVMOutletIndex }
+ ::= { sPDUOutletConfigVMTable 1 }
+
+OutletConfigVMEntry ::=
+ SEQUENCE {
+ sPDUOutletConfigVMIndex INTEGER,
+ sPDUOutletConfigVMName DisplayString,
+ sPDUOutletConfigVMOutletIndex INTEGER,
+ sPDUOutletConfigVMOutletName DisplayString,
+ sPDUOutletConfigVMPowerOnTime INTEGER,
+ sPDUOutletConfigVMPowerOffTime INTEGER,
+ sPDUOutletConfigVMRebootDuration INTEGER
+ }
+
+sPDUOutletConfigVMIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch VM."
+ ::= { sPDUOutletConfigVMEntry 1 }
+
+sPDUOutletConfigVMName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch VM. Maximum size is 23 characters."
+ ::= { sPDUOutletConfigVMEntry 2 }
+
+sPDUOutletConfigVMOutletIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { sPDUOutletConfigVMEntry 3 }
+
+
+sPDUOutletConfigVMOutletName OBJECT-TYPE
+ SYNTAX DisplayString ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet. Maximum size is 23 characters."
+ ::= { sPDUOutletConfigVMEntry 4 }
+
+sPDUOutletConfigVMPowerOnTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The amount of time (in seconds) the outlet will delay
+ powering on at coldstart or when a command that requires
+ a turn-on delay is issued.
+
+ Allowed values are:
+
+ -1 never power on.
+ 0 power on immediately.
+ 15 power on 15 seconds after being commanded.
+ 30 power on 30 seconds after being commanded.
+ 45 power on 45 seconds after being commanded.
+ 60 power on 60 seconds (1 minute) after being commanded.
+ 120 power on 120 seconds (2 minutes) after being commanded.
+ 300 power on 300 seconds (5 minutes) after being commanded.
+
+ If a value other than a supported value is provided in a
+ set request, the MasterSwitch VM interprets it as the next lower
+ acceptable value. If the provided value is lower than
+ the lowest acceptable value, the lowest acceptable
+ value is used."
+ ::= { sPDUOutletConfigVMEntry 5 }
+
+
+sPDUOutletConfigVMPowerOffTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The amount of time (in seconds) the outlet will delay
+ powering off when a command that requires
+ a turn-off delay is issued.
+
+
+ Allowed values are:
+
+ -1 never power off automatically.
+ 0 power off immediately.
+ 15 power off 15 seconds after being commanded.
+ 30 power off 30 seconds after being commanded.
+ 45 power off 45 seconds after being commanded.
+ 60 power off 60 seconds (1 minute) after being commanded.
+ 120 power off 120 seconds (2 minutes) after being commanded.
+ 300 power off 300 seconds (5 minutes) after being commanded.
+
+ If a value other than a supported value is provided in a
+ set request, the MasterSwitch VM interprets it as the next lower
+ acceptable value. If the provided value is lower than
+ the lowest acceptable value, the lowest acceptable
+ value is used."
+ ::= { sPDUOutletConfigVMEntry 6 }
+
+sPDUOutletConfigVMRebootDuration OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "During a reboot sequence, power is turned off and then
+ back on. This OID defines the amount of time to wait,
+ in seconds, after turning the power off, at the start
+ of the sequence, before turning power back on, at the
+ end of the reboot sequence.
+
+ Allowed values are:
+
+ 5 wait 5 seconds between off/on.
+ 10 wait 10 seconds between off/on.
+ 15 wait 15 seconds between off/on.
+ 20 wait 20 seconds between off/on.
+ 30 wait 30 seconds between off/on.
+ 45 wait 45 seconds between off/on.
+ 60 wait 60 seconds (1 minute) between off/on.
+
+ If a value other than a supported value is provided in a
+ set request, the MasterSwitch VM interprets it as the next lower
+ acceptable value. If the provided value is lower than
+ the lowest acceptable value, the lowest acceptable
+ value is used."
+ ::= { sPDUOutletConfigVMEntry 7 }
+
+-- the sPDUOutletStatusVM group
+
+sPDUOutletStatusVMTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF OutletStatusVMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting of status of individual outlets. The number of
+ entries is contained in the sPDUMasterStatusOutletCount OID."
+ ::= { sPDUOutletStatusVM 1 }
+
+sPDUOutletStatusVMEntry OBJECT-TYPE
+ SYNTAX OutletStatusVMEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlets to gather status from."
+ INDEX { sPDUOutletStatusVMIndex, sPDUOutletStatusVMOutletIndex }
+ ::= { sPDUOutletStatusVMTable 1 }
+
+OutletStatusVMEntry ::=
+ SEQUENCE {
+ sPDUOutletStatusVMIndex INTEGER,
+ sPDUOutletStatusVMName DisplayString,
+ sPDUOutletStatusVMOutletIndex INTEGER,
+ sPDUOutletStatusVMOutletName DisplayString,
+ sPDUOutletStatusVMOutletState INTEGER,
+ sPDUOutletStatusVMCommandPending INTEGER
+ }
+
+sPDUOutletStatusVMIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch VM."
+ ::= { sPDUOutletStatusVMEntry 1 }
+
+sPDUOutletStatusVMName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch VM. Maximum size is 23 characters."
+ ::= { sPDUOutletStatusVMEntry 2 }
+
+sPDUOutletStatusVMOutletIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { sPDUOutletStatusVMEntry 3 }
+
+sPDUOutletStatusVMOutletName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet. Maximum size is 23 characters."
+ ::= { sPDUOutletStatusVMEntry 4 }
+
+sPDUOutletStatusVMOutletState OBJECT-TYPE
+ SYNTAX INTEGER {
+ outletStatusVMOn (1),
+ outletStatusVMOff (2)
+ }
+
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the outlet state. If
+ the outlet is on, the outletStatusOnVM (1) value will be returned.
+ If the outlet is off, the outletStatusOffVM (2) value will be
+ returned. "
+ ::= { sPDUOutletStatusVMEntry 5 }
+
+sPDUOutletStatusVMCommandPending OBJECT-TYPE
+ SYNTAX INTEGER {
+ outletStatusVMCommandPending (1),
+ outletStatusVMNoCommandPending (2)
+ }
+
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the command pending
+ state of the outlet. If a command is pending on the
+ outlet, the outletStatusVMCommandPending (1) value
+ will be returned. If there is not a command pending
+ on the outlet, the outletStatusVMNoCommandPending (2)
+ will be returned."
+ ::= { sPDUOutletStatusVMEntry 6 }
+
+-- the sPDUIdentMSP group
+
+sPDUIdentMSPTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of MasterSwitch pluses controllable
+ by this IP address."
+ ::= { sPDUIdentMSP 1 }
+
+
+sPDUIdentMSPTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF IdentMSPEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for query of the individual MasterSwitch pluses.
+ The number of entries is contained in the
+ sPDUIdentMSPTableSize OID."
+ ::= { sPDUIdentMSP 2 }
+
+sPDUIdentMSPEntry OBJECT-TYPE
+ SYNTAX IdentMSPEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The MasterSwitch pluses to query."
+ INDEX { sPDUIdentMSPIndex}
+ ::= { sPDUIdentMSPTable 1 }
+
+IdentMSPEntry ::=
+ SEQUENCE {
+ sPDUIdentMSPIndex INTEGER,
+ sPDUIdentNameMSP DisplayString,
+ sPDUIdentHardwareRevMSP DisplayString,
+ sPDUIdentFirmwareRevMSP DisplayString,
+ sPDUIdentDateOfManufactureMSP DisplayString,
+ sPDUIdentModelNumberMSP DisplayString,
+ sPDUIdentSerialNumberMSP DisplayString
+ }
+
+sPDUIdentMSPIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch plus entry."
+ ::= { sPDUIdentMSPEntry 1 }
+
+sPDUIdentNameMSP OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch plus. The maximum
+ value is 23 characters. The name is set by
+ using the sPDUMasterConfigMSPName OID."
+ ::= { sPDUIdentMSPEntry 2 }
+
+sPDUIdentHardwareRevMSP OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware version of the MasterSwitch plus.
+ This value is set at the factory."
+ ::= { sPDUIdentMSPEntry 3 }
+
+sPDUIdentFirmwareRevMSP OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An 6-character ID string identifying the MasterSwitch plus
+ firmware version. This value is set at the factory."
+ ::= { sPDUIdentMSPEntry 4 }
+
+sPDUIdentDateOfManufactureMSP OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date when the MasterSwitch plus was manufactured in mm/dd/yyyy format.
+ This value is set at the factory. "
+ ::= { sPDUIdentMSPEntry 5 }
+
+sPDUIdentModelNumberMSP OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A 17-character string identifying the model number of
+ the MasterSwitch plus. This value is set at the factory."
+ ::= { sPDUIdentMSPEntry 6 }
+
+sPDUIdentSerialNumberMSP OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A 17-character string identifying the serial number of
+ the MasterSwitch plus. This value is set at the factory."
+ ::= { sPDUIdentMSPEntry 7 }
+
+
+-- the sPDUMasterControlMSP group
+
+sPDUMasterControlMSPTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of MasterSwitch pluses controllable
+ by this IP address."
+ ::= { sPDUMasterControlMSP 1 }
+
+sPDUMasterControlMSPTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF MasterControlMSPEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for control of the individual MasterSwitch pluses.
+ The number of entries is contained in the
+ sPDUMasterControlMSPTableSize OID."
+ ::= { sPDUMasterControlMSP 2 }
+
+sPDUMasterControlMSPEntry OBJECT-TYPE
+ SYNTAX MasterControlMSPEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The MasterSwitch pluses to control."
+ INDEX { sPDUMasterControlMSPIndex}
+ ::= { sPDUMasterControlMSPTable 1 }
+
+MasterControlMSPEntry ::=
+ SEQUENCE {
+ sPDUMasterControlMSPIndex INTEGER,
+ sPDUMasterControlMSPName DisplayString,
+ sPDUMasterControlMSPCommand INTEGER
+ }
+
+sPDUMasterControlMSPIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch plus entry."
+ ::= { sPDUMasterControlMSPEntry 1 }
+
+sPDUMasterControlMSPName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch plus. The maximum
+ value is 23 characters. The name is set by
+ using the sPDUMasterConfigMSPName OID."
+ ::= { sPDUMasterControlMSPEntry 2 }
+
+sPDUMasterControlMSPCommand OBJECT-TYPE
+ SYNTAX INTEGER {
+ noCommandAllMSP (1),
+ immediateAllOnMSP (2),
+ sequencedAllOnMSP (3),
+ immediateAllOffMSP (4),
+ gracefulAllRebootMSP (5),
+ immediateAllRebootMSP (6),
+ gracefulAllShutdownMSP (7),
+ overrideAllBatCapThreshMSP (8),
+ cancelAllPendingCommandsMSP (9),
+ restoreFactoryDefaultsMSP (10)
+ }
+
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to immediateAllOnMSP (2) will turn all outlets
+ on immediately.
+
+ Setting this OID to sequencedAllOnMSP (3) will turn all outlets
+ on as defined by each outlet's sPDUOutletConfigMSPPowerOnDelay OID value.
+
+ Setting this OID to immediateAllOffMSP (4) will turn all outlets
+ off immediately.
+
+ Setting this OID to gracefulAllRebootMSP (5) will reboot all outlets
+ (after the device running PowerChute confirms shutdown) as defined
+ by each outlet's sPDUOutletConfigMSPRebootDuration OID time value.
+
+ Setting this OID to immediateAllRebootMSP (6) will reboot all outlets
+ immediately.
+
+ Setting this OID to gracefulAllShutdownMSP (7) will shutdown all outlets
+ (after the device running PowerChute confirms shutdown) as defined
+ by each outlet's sPDUOutletConfigMSPPowerOffDelay OID time value. Each
+ outlet will then turn on after the sum of its
+ sPDUOutletConfigMSPRestartDelay and sPDUOutletConfigMSPPowerOnDelay OID
+ values.
+
+ Setting this OID to overrideAllBatCapThreshMSP (8) will cause the
+ outlet to ignore the Battery Capacity Threshold and proceed turning on
+ the outlets as defined by each outlet's sPDUOutletConfigMSPPowerOnDelay
+ OID value.
+
+ Setting this OID to cancelAllPendingCommandsMSP (9) will cause all pending
+ commands on the MasterSwitch plus to be canceled.
+
+ Setting this OID to restoreFactoryDefaultsMSP (10) will cause the settings of
+ the MasterSwitch plus to be restored to the factory defaults.
+
+ Getting this OID will return the noCommandAllMSP (1) value."
+ ::= { sPDUMasterControlMSPEntry 3 }
+
+
+-- the sPDUMasterConfigMSP group
+
+sPDUMasterConfigMSPTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of MasterSwitch pluses configurable
+ by this IP address."
+ ::= { sPDUMasterConfigMSP 1 }
+
+sPDUMasterConfigMSPTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF MasterConfigMSPEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of the individual MasterSwitch pluses.
+ The number of entries is contained in the
+ sPDUMasterConfigMSPTableSize OID."
+ ::= { sPDUMasterConfigMSP 2 }
+
+sPDUMasterConfigMSPEntry OBJECT-TYPE
+ SYNTAX MasterConfigMSPEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The MasterSwitch pluses to configure."
+ INDEX { sPDUMasterConfigMSPIndex}
+ ::= { sPDUMasterConfigMSPTable 1 }
+
+MasterConfigMSPEntry ::=
+ SEQUENCE {
+ sPDUMasterConfigMSPIndex INTEGER,
+ sPDUMasterConfigMSPName DisplayString,
+ sPDUMasterConfigMSPPowerOnTimeDelay INTEGER,
+ sPDUMasterConfigMSPManualButton INTEGER
+ }
+
+sPDUMasterConfigMSPIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch plus entry."
+ ::= { sPDUMasterConfigMSPEntry 1 }
+
+sPDUMasterConfigMSPName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch plus. Maximum size is 23 characters."
+ ::= { sPDUMasterConfigMSPEntry 2 }
+
+sPDUMasterConfigMSPPowerOnTimeDelay OBJECT-TYPE
+ SYNTAX INTEGER (0..9999)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ " The amount of delay, in seconds, between when
+ power is provided to the MasterSwitch plus and
+ when the MasterSwitch plus provides basic master
+ power to the outlets.
+
+ Allowed values are:
+
+ 0 - 9999 seconds (0 - 2hrs, 46 mins, 39 secs).
+ 0 indicates to apply power immediately."
+ ::= { sPDUMasterConfigMSPEntry 3 }
+
+
+sPDUMasterConfigMSPManualButton OBJECT-TYPE
+ SYNTAX INTEGER {
+ manualButtonDisabled (1),
+ manualButtonEnabled (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to manualButtonDisabled (1) will disable
+ the manual button on the MasterSwitch plus.
+
+ Setting this OID to manualButtonEnabled (2) will enable
+ the manual button on the MasterSwitch plus."
+ ::= { sPDUMasterConfigMSPEntry 4 }
+
+-- the sPDUMasterStatusMSP group
+
+sPDUMasterStatusMSPTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of MasterSwitch pluses at
+ this IP address."
+ ::= { sPDUMasterStatusMSP 1 }
+
+
+sPDUMasterStatusMSPTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF MasterStatusMSPEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for gathering of status from the individual
+ MasterSwitch pluses. The number of entries is contained
+ in the sPDUMasterStatusMSPTableSize OID."
+ ::= { sPDUMasterStatusMSP 2 }
+
+sPDUMasterStatusMSPEntry OBJECT-TYPE
+ SYNTAX MasterStatusMSPEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The MasterSwitch pluses to gather status from."
+ INDEX { sPDUMasterStatusMSPIndex}
+ ::= { sPDUMasterStatusMSPTable 1 }
+
+MasterStatusMSPEntry ::=
+ SEQUENCE {
+ sPDUMasterStatusMSPIndex INTEGER,
+ sPDUMasterStatusMSPName DisplayString,
+ sPDUMasterStatusMSPOutletCount INTEGER
+ }
+
+sPDUMasterStatusMSPIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch plus entry."
+ ::= { sPDUMasterStatusMSPEntry 1 }
+
+sPDUMasterStatusMSPName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch plus. The maximum
+ value is 23 characters. The name is set by
+ using the sPDUMasterConfigMSPName OID."
+ ::= { sPDUMasterStatusMSPEntry 2 }
+
+sPDUMasterStatusMSPOutletCount OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the number of controllable
+ outlets for this MasterSwitch plus."
+ ::= { sPDUMasterStatusMSPEntry 3 }
+
+-- the sPDUOutletControlMSP group
+
+sPDUOutletControlMSPTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF OutletControlMSPEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for control of individual outlet switches. The number of
+ entries is contained in the sPDUMasterStatusMSPOutletCount OID."
+ ::= { sPDUOutletControlMSP 1 }
+
+sPDUOutletControlMSPEntry OBJECT-TYPE
+ SYNTAX OutletControlMSPEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlets to control."
+ INDEX { sPDUOutletControlMSPIndex, sPDUOutletControlMSPOutletIndex }
+ ::= { sPDUOutletControlMSPTable 1 }
+
+OutletControlMSPEntry ::=
+ SEQUENCE {
+ sPDUOutletControlMSPIndex INTEGER,
+ sPDUOutletControlMSPName DisplayString,
+ sPDUOutletControlMSPOutletIndex INTEGER,
+ sPDUOutletControlMSPOutletName DisplayString,
+ sPDUOutletControlMSPOutletCommand INTEGER
+ }
+
+sPDUOutletControlMSPIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch plus."
+ ::= { sPDUOutletControlMSPEntry 1 }
+
+sPDUOutletControlMSPName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch plus. The maximum
+ value is 23 characters. The name is set by
+ using the sPDUMasterConfigMSPName OID."
+ ::= { sPDUOutletControlMSPEntry 2 }
+
+sPDUOutletControlMSPOutletIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { sPDUOutletControlMSPEntry 3 }
+
+sPDUOutletControlMSPOutletName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet. The maximum size is
+ 23 characters. The name is set by using the
+ sPDUOutletConfigMSPallOutletName OID.
+ This OID is provided for informational purposes only."
+ ::= { sPDUOutletControlMSPEntry 4 }
+
+sPDUOutletControlMSPOutletCommand OBJECT-TYPE
+ SYNTAX INTEGER {
+ immediateOnMSP (1),
+ delayedOnMSP (2),
+ immediateOffMSP (3),
+ gracefulRebootMSP (4),
+ immediateRebootMSP (5),
+ gracefulshutdownMSP (6),
+ overrideBatCapThreshMSP (7),
+ cancelPendingCommandMSP (8)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the outlet state. If
+ the outlet is on, the immediateOnMSP (1) value will be returned.
+ If the outlet is off, the immediateOffMSP (3) value will be
+ returned.
+
+ Setting this variable to immediateOnMSP (1) will immediately turn the outlet on.
+
+ Setting this variable to delayedOnMSP (2) will turn the outlet on
+ after the sPDUOutletConfigMSPPowerOnDelay OID time has elapsed.
+
+ Setting this variable to immediateOffMSP (3) will immediately turn the outlet off.
+
+ Setting this variable to gracefulRebootMSP (4) will cause the outlet to wait for
+ device confirmation (if applicable) and then turn the outlet off after the
+ sPDUOutletConfigMSPPowerOffDelay OID time has elapsed. The outlet will then turn
+ on after the sPDUOutletConfigMSPRebootDuration OID time has elapsed.
+
+ Setting this variable to immediateRebootMSP (5) will immediately reboot the outlet.
+
+ Setting this variable to gracefulshutdownMSP (6) will cause the outlet to wait for
+ device confirmation (if applicable) and then turn the outlet off after the
+ sPDUOutletConfigMSPPowerOffDelay OID time has elapsed. The outlet will then turn
+ on after the sum of the sPDUOutletConfigMSPRestartTime OID time and the
+ sPDUOutletConfigMSPPowerOnDelay OID time has elapsed.
+
+ Setting this variable to overrideBatCapThreshMSP (7) will cause the outlet to
+ ignore the Battery Capacity Threshold and proceed waiting on the
+ sPDUOutletConfigMSPPowerOnDelay OID time before turning the outlet on.
+
+ Setting this variable to cancelPendingCommandMSP (8) will cause any
+ pending command to this outlet to be canceled."
+ ::= { sPDUOutletControlMSPEntry 5 }
+
+-- the sPDUOutletConfigMSPall group
+
+sPDUOutletConfigMSPallTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF OutletConfigMSPallEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of individual outlets. The number of
+ entries is contained in the sPDUMasterStatusMSPOutletCount OID."
+ ::= { sPDUOutletConfigMSPall 1 }
+
+sPDUOutletConfigMSPallEntry OBJECT-TYPE
+ SYNTAX OutletConfigMSPallEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlets to configure."
+ INDEX { sPDUOutletConfigMSPallIndex, sPDUOutletConfigMSPallOutletIndex }
+ ::= { sPDUOutletConfigMSPallTable 1 }
+
+OutletConfigMSPallEntry ::=
+ SEQUENCE {
+ sPDUOutletConfigMSPallIndex INTEGER,
+ sPDUOutletConfigMSPallName DisplayString,
+ sPDUOutletConfigMSPallOutletIndex INTEGER,
+ sPDUOutletConfigMSPallOutletName DisplayString,
+ sPDUOutletConfigMSPallOutletCtrlMode INTEGER
+ }
+
+sPDUOutletConfigMSPallIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch plus."
+ ::= { sPDUOutletConfigMSPallEntry 1 }
+
+sPDUOutletConfigMSPallName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch plus. The maximum
+ value is 23 characters. The name is set by
+ using the sPDUMasterConfigMSPName OID."
+ ::= { sPDUOutletConfigMSPallEntry 2 }
+
+sPDUOutletConfigMSPallOutletIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { sPDUOutletConfigMSPallEntry 3 }
+
+sPDUOutletConfigMSPallOutletName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet. Maximum size is 23 characters."
+ ::= { sPDUOutletConfigMSPallEntry 4 }
+
+sPDUOutletConfigMSPallOutletCtrlMode OBJECT-TYPE
+ SYNTAX INTEGER {
+ modeGracefulShutdown (1),
+ modeAnnunciator (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to modeGracefulShutdown (1) will put this
+ outlet into the Graceful Shutdown control mode.
+
+ Setting this OID to modeAnnunciator (2) will put this outlet
+ into the Annunciator control mode."
+ ::= { sPDUOutletConfigMSPallEntry 5 }
+
+
+-- the sPDUOutConfigMSPgs group
+
+sPDUOutletConfigMSPgsTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF OutletConfigMSPgsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of individual outlets. The number of
+ entries is contained in the sPDUMasterStatusMSPOutletCount OID."
+ ::= { sPDUOutletConfigMSPgs 1 }
+
+sPDUOutletConfigMSPgsEntry OBJECT-TYPE
+ SYNTAX OutletConfigMSPgsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlets to configure."
+ INDEX { sPDUOutletConfigMSPgsIndex, sPDUOutletConfigMSPgsOutletIndex }
+ ::= { sPDUOutletConfigMSPgsTable 1 }
+
+OutletConfigMSPgsEntry ::=
+ SEQUENCE {
+ sPDUOutletConfigMSPgsIndex INTEGER,
+ sPDUOutletConfigMSPgsName DisplayString,
+ sPDUOutletConfigMSPgsOutletIndex INTEGER,
+ sPDUOutletConfigMSPgsOutletName DisplayString,
+ sPDUOutletConfigMSPgsOutletCtrlMode INTEGER,
+ sPDUOutletConfigMSPgsDeviceConfirm INTEGER,
+ sPDUOutletConfigMSPgsLowBattWarning INTEGER,
+ sPDUOutletConfigMSPgsLowBattMult INTEGER,
+ sPDUOutletConfigMSPgsRestartDelay INTEGER,
+ sPDUOutletConfigMSPgsPowerOnDelay INTEGER,
+ sPDUOutletConfigMSPgsPowerOffDelay INTEGER,
+ sPDUOutletConfigMSPgsBattCapThresh INTEGER,
+ sPDUOutletConfigMSPgsRebootDuration INTEGER
+ }
+
+sPDUOutletConfigMSPgsIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch plus."
+ ::= { sPDUOutletConfigMSPgsEntry 1 }
+
+sPDUOutletConfigMSPgsName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch plus. The maximum
+ value is 23 characters. The name is set by
+ using the sPDUMasterConfigMSPName OID."
+ ::= { sPDUOutletConfigMSPgsEntry 2 }
+
+sPDUOutletConfigMSPgsOutletIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { sPDUOutletConfigMSPgsEntry 3 }
+
+sPDUOutletConfigMSPgsOutletName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet. The maximum size is
+ 23 characters. The name is set by using the
+ sPDUOutletConfigMSPallOutletName OID.
+ This OID is provided for informational purposes only."
+ ::= { sPDUOutletConfigMSPgsEntry 4 }
+
+sPDUOutletConfigMSPgsOutletCtrlMode OBJECT-TYPE
+ SYNTAX INTEGER {
+ modeGracefulShutdown (1),
+ modeAnnunciator (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The Control Mode of the outlet.
+ This OID is provided for informational purposes only."
+ ::= { sPDUOutletConfigMSPgsEntry 5 }
+
+sPDUOutletConfigMSPgsDeviceConfirm OBJECT-TYPE
+ SYNTAX INTEGER {
+ deviceConfirmNo (1),
+ deviceConfirmYes (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to deviceConfirmNo (1) cause the outlet to
+ NOT wait for device confirmation while performing graceful
+ operations.
+
+ Setting this OID to deviceConfirmYes (2) cause the outlet to
+ wait for device confirmation while performing graceful
+ operations."
+ ::= { sPDUOutletConfigMSPgsEntry 6 }
+
+sPDUOutletConfigMSPgsLowBattWarning OBJECT-TYPE
+ SYNTAX INTEGER (-2..9999)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ " The amount of delay, in 6 second intervals, between
+ when the UPS goes on battery and the power down sequence for
+ the outlet is initiated.
+
+ Allowed values are:
+
+ -2 - Never initiate the power down sequence on low battery warning.
+ -1 - Initiate power down sequence based on remaining runtime.
+ 1 - 9999 six second intervals (6 secs - 16hrs, 39 mins, 54 secs).
+ 0 indicates to immediately initiate power down sequence on low
+ battery warning."
+ ::= { sPDUOutletConfigMSPgsEntry 7 }
+
+sPDUOutletConfigMSPgsLowBattMult OBJECT-TYPE
+ SYNTAX INTEGER (1..7)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ " Only applicable if sPDUOutletConfigMSPgsLowBattWarning OID is
+ set to -1 (On Runtime Remaining).
+
+ Allows you to set the value to stagger the shutdown sequence of the outlets.
+ 1 provides the longest delay (the outlet to shutoff first), and 7 would
+ provide the shortest delay (the outlet to shut off last).
+
+ Allowed values are:
+ 1 - 7."
+ ::= { sPDUOutletConfigMSPgsEntry 8 }
+
+sPDUOutletConfigMSPgsRestartDelay OBJECT-TYPE
+ SYNTAX INTEGER (-1..9999)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ " The amount of delay, in 6 minute intervals, between
+ when the outlet is turned off and the outlet is turned back on
+ when performing a Graceful Shutdown.
+
+ Allowed values are:
+
+ -1 - Never turn outlet back on after a Graceful shutdown.
+ 0 - 9999 six minute intervals (0 - 999hrs, 54 mins)."
+ ::= { sPDUOutletConfigMSPgsEntry 9 }
+
+sPDUOutletConfigMSPgsPowerOnDelay OBJECT-TYPE
+ SYNTAX INTEGER (-1..9999)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ " The amount of delay, in seconds, between the UPS entering
+ normal (on-line) state and the outlet being powered on.
+
+ Allowed values are:
+
+ -1 - Remain Off when the UPS enters the on-line state.
+ 0 - 9999 seconds (0 - 2 hrs, 46 mins, 39 secs)."
+ ::= { sPDUOutletConfigMSPgsEntry 10 }
+
+
+sPDUOutletConfigMSPgsPowerOffDelay OBJECT-TYPE
+ SYNTAX INTEGER (0..9999)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ " The amount of delay, in seconds, between when the server
+ shuts down and the outlet is powered off.
+
+ Allowed values are:
+
+ 0 - 9999 seconds (0 - 2 hrs, 46 mins, 39 secs)."
+ ::= { sPDUOutletConfigMSPgsEntry 11 }
+
+sPDUOutletConfigMSPgsBattCapThresh OBJECT-TYPE
+ SYNTAX INTEGER (0..100)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ " The minimum battery capacity, as a percent (0-100%), required
+ of the UPS before an outlet will be allowed to power on.
+
+ Allowed values are:
+
+ 0 - 100 percent."
+ ::= { sPDUOutletConfigMSPgsEntry 12 }
+
+sPDUOutletConfigMSPgsRebootDuration OBJECT-TYPE
+ SYNTAX INTEGER (0..9999)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ " The amount of delay, in seconds, from outlet off until
+ outlet on during a reboot.
+
+ Allowed values are:
+
+ 0 - 9999 seconds (0 - 2 hrs, 46 mins, 39 secs)."
+ ::= { sPDUOutletConfigMSPgsEntry 13 }
+
+
+-- the sPDUOutConfigMSPannun group
+
+sPDUOutletConfigMSPannunTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF OutletConfigMSPannunEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of individual outlets. The number of
+ entries is contained in the sPDUMasterStatusMSPOutletCount OID."
+ ::= { sPDUOutletConfigMSPannun 1 }
+
+sPDUOutletConfigMSPannunEntry OBJECT-TYPE
+ SYNTAX OutletConfigMSPannunEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlets to configure."
+ INDEX { sPDUOutletConfigMSPannunIndex, sPDUOutletConfigMSPannunOutletIndex }
+ ::= { sPDUOutletConfigMSPannunTable 1 }
+
+OutletConfigMSPannunEntry ::=
+ SEQUENCE {
+ sPDUOutletConfigMSPannunIndex INTEGER,
+ sPDUOutletConfigMSPannunName DisplayString,
+ sPDUOutletConfigMSPannunOutletIndex INTEGER,
+ sPDUOutletConfigMSPannunOutletName DisplayString,
+ sPDUOutletConfigMSPannunOutletCtrlMode INTEGER,
+ sPDUOutletConfigMSPannunInitialState INTEGER,
+ sPDUOutletConfigMSPannunAlarmActionDly INTEGER
+ }
+
+sPDUOutletConfigMSPannunIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch plus."
+ ::= { sPDUOutletConfigMSPannunEntry 1 }
+
+sPDUOutletConfigMSPannunName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch plus. The maximum
+ value is 23 characters. The name is set by
+ using the sPDUMasterConfigMSPName OID."
+ ::= { sPDUOutletConfigMSPannunEntry 2 }
+
+sPDUOutletConfigMSPannunOutletIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { sPDUOutletConfigMSPannunEntry 3 }
+
+sPDUOutletConfigMSPannunOutletName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet. The maximum size is
+ 23 characters. The name is set by using the
+ sPDUOutletConfigMSPallOutletName OID.
+ This OID is provided for informational purposes only."
+ ::= { sPDUOutletConfigMSPannunEntry 4 }
+
+sPDUOutletConfigMSPannunOutletCtrlMode OBJECT-TYPE
+ SYNTAX INTEGER {
+ modeGracefulShutdown (1),
+ modeAnnunciator (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The Control Mode of the outlet.
+ This OID is provided for informational purposes only."
+ ::= { sPDUOutletConfigMSPannunEntry 5 }
+
+sPDUOutletConfigMSPannunInitialState OBJECT-TYPE
+ SYNTAX INTEGER {
+ initialStateOff (1),
+ initialStateOn (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to initialStateOff (1) causes the outlet
+ to default to off when in the non-alarmed condition.
+
+ Setting this OID to initialStateOn (2) causes the outlet
+ to default to on when in the non-alarmed condition."
+ ::= { sPDUOutletConfigMSPannunEntry 6 }
+
+sPDUOutletConfigMSPannunAlarmActionDly OBJECT-TYPE
+ SYNTAX INTEGER (0..9999)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ " The amount of time, in seconds, that an enabled Measure-UPS
+ alarm must be asserted before an alarm condition is recognized.
+
+ Allowed values are:
+
+ 0 - 9999 seconds (0 - 2 hrs, 46 mins, 39 secs)."
+ ::= { sPDUOutletConfigMSPannunEntry 7 }
+
+
+-- the sPDUOutConfigMSPmups group
+
+sPDUOutletConfigMSPmupsTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF OutletConfigMSPmupsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of individual outlets. The number of
+ entries is contained in the sPDUMasterStatusMSPOutletCount OID."
+ ::= { sPDUOutletConfigMSPmups 1 }
+
+sPDUOutletConfigMSPmupsEntry OBJECT-TYPE
+ SYNTAX OutletConfigMSPmupsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlets to configure."
+ INDEX { sPDUOutletConfigMSPmupsIndex, sPDUOutletConfigMSPmupsOutletIndex }
+ ::= { sPDUOutletConfigMSPmupsTable 1 }
+
+OutletConfigMSPmupsEntry ::=
+ SEQUENCE {
+ sPDUOutletConfigMSPmupsIndex INTEGER,
+ sPDUOutletConfigMSPmupsName DisplayString,
+ sPDUOutletConfigMSPmupsOutletIndex INTEGER,
+ sPDUOutletConfigMSPmupsOutletName DisplayString,
+ sPDUOutletConfigMSPmupsZone1 INTEGER,
+ sPDUOutletConfigMSPmupsZone2 INTEGER,
+ sPDUOutletConfigMSPmupsZone3 INTEGER,
+ sPDUOutletConfigMSPmupsZone4 INTEGER,
+ sPDUOutletConfigMSPmupsP1LowHum INTEGER,
+ sPDUOutletConfigMSPmupsP1HiHum INTEGER,
+ sPDUOutletConfigMSPmupsP1LowTemp INTEGER,
+ sPDUOutletConfigMSPmupsP1HiTemp INTEGER,
+ sPDUOutletConfigMSPmupsP2LowHum INTEGER,
+ sPDUOutletConfigMSPmupsP2HiHum INTEGER,
+ sPDUOutletConfigMSPmupsP2LowTemp INTEGER,
+ sPDUOutletConfigMSPmupsP2HiTemp INTEGER
+ }
+
+sPDUOutletConfigMSPmupsIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch plus."
+ ::= { sPDUOutletConfigMSPmupsEntry 1 }
+
+sPDUOutletConfigMSPmupsName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch plus. The maximum
+ value is 23 characters. The name is set by
+ using the sPDUMasterConfigMSPName OID."
+ ::= { sPDUOutletConfigMSPmupsEntry 2 }
+
+sPDUOutletConfigMSPmupsOutletIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { sPDUOutletConfigMSPmupsEntry 3 }
+
+sPDUOutletConfigMSPmupsOutletName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet. The maximum size is
+ 23 characters. The name is set by using the
+ sPDUOutletConfigMSPallOutletName OID.
+ This OID is provided for informational purposes only."
+ ::= { sPDUOutletConfigMSPmupsEntry 4 }
+
+sPDUOutletConfigMSPmupsZone1 OBJECT-TYPE
+ SYNTAX INTEGER {
+ disableAlarm (1),
+ enableAlarm (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to disableAlarm (1) disables the
+ Zone 1 alarm for this outlet.
+
+ Setting this OID to enableAlarm (2) enables the
+ Zone 1 alarm for this outlet."
+ ::= { sPDUOutletConfigMSPmupsEntry 5 }
+
+sPDUOutletConfigMSPmupsZone2 OBJECT-TYPE
+ SYNTAX INTEGER {
+ disableAlarm (1),
+ enableAlarm (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to disableAlarm (1) disables the
+ Zone 2 alarm for this outlet.
+
+ Setting this OID to enableAlarm (2) enables the
+ Zone 2 alarm for this outlet."
+ ::= { sPDUOutletConfigMSPmupsEntry 6 }
+
+sPDUOutletConfigMSPmupsZone3 OBJECT-TYPE
+ SYNTAX INTEGER {
+ disableAlarm (1),
+ enableAlarm (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to disableAlarm (1) disables the
+ Zone 3 alarm for this outlet.
+
+ Setting this OID to enableAlarm (2) enables the
+ Zone 3 alarm for this outlet."
+ ::= { sPDUOutletConfigMSPmupsEntry 7 }
+
+sPDUOutletConfigMSPmupsZone4 OBJECT-TYPE
+ SYNTAX INTEGER {
+ disableAlarm (1),
+ enableAlarm (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to disableAlarm (1) disables the
+ Zone 4 alarm for this outlet.
+
+ Setting this OID to enableAlarm (2) enables the
+ Zone 4 alarm for this outlet."
+ ::= { sPDUOutletConfigMSPmupsEntry 8 }
+
+sPDUOutletConfigMSPmupsP1LowHum OBJECT-TYPE
+ SYNTAX INTEGER {
+ disableAlarm (1),
+ enableAlarm (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to disableAlarm (1) disables the
+ Probe 1 low humidity alarm for this outlet.
+
+ Setting this OID to enableAlarm (2) enables the
+ Probe 1 low humidity alarm for this outlet."
+ ::= { sPDUOutletConfigMSPmupsEntry 9 }
+
+sPDUOutletConfigMSPmupsP1HiHum OBJECT-TYPE
+ SYNTAX INTEGER {
+ disableAlarm (1),
+ enableAlarm (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to disableAlarm (1) disables the
+ Probe 1 high humidity alarm for this outlet.
+
+ Setting this OID to enableAlarm (2) enables the
+ Probe 1 high humidity alarm for this outlet."
+ ::= { sPDUOutletConfigMSPmupsEntry 10 }
+
+sPDUOutletConfigMSPmupsP1LowTemp OBJECT-TYPE
+ SYNTAX INTEGER {
+ disableAlarm (1),
+ enableAlarm (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to disableAlarm (1) disables the
+ Probe 1 low temperature alarm for this outlet.
+
+ Setting this OID to enableAlarm (2) enables the
+ Probe 1 low temperature alarm for this outlet."
+ ::= { sPDUOutletConfigMSPmupsEntry 11 }
+
+sPDUOutletConfigMSPmupsP1HiTemp OBJECT-TYPE
+ SYNTAX INTEGER {
+ disableAlarm (1),
+ enableAlarm (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to disableAlarm (1) disables the
+ Probe 1 high temperature alarm for this outlet.
+
+ Setting this OID to enableAlarm (2) enables the
+ Probe 1 high temperature alarm for this outlet."
+ ::= { sPDUOutletConfigMSPmupsEntry 12 }
+
+sPDUOutletConfigMSPmupsP2LowHum OBJECT-TYPE
+ SYNTAX INTEGER {
+ disableAlarm (1),
+ enableAlarm (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to disableAlarm (1) disables the
+ Probe 2 low humidity alarm for this outlet.
+
+ Setting this OID to enableAlarm (2) enables the
+ Probe 2 low humidity alarm for this outlet."
+ ::= { sPDUOutletConfigMSPmupsEntry 13 }
+
+sPDUOutletConfigMSPmupsP2HiHum OBJECT-TYPE
+ SYNTAX INTEGER {
+ disableAlarm (1),
+ enableAlarm (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to disableAlarm (1) disables the
+ Probe 2 high humidity alarm for this outlet.
+
+ Setting this OID to enableAlarm (2) enables the
+ Probe 2 high humidity alarm for this outlet."
+ ::= { sPDUOutletConfigMSPmupsEntry 14 }
+
+sPDUOutletConfigMSPmupsP2LowTemp OBJECT-TYPE
+ SYNTAX INTEGER {
+ disableAlarm (1),
+ enableAlarm (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to disableAlarm (1) disables the
+ Probe 2 low temperature alarm for this outlet.
+
+ Setting this OID to enableAlarm (2) enables the
+ Probe 2 low temperature alarm for this outlet."
+ ::= { sPDUOutletConfigMSPmupsEntry 15 }
+
+sPDUOutletConfigMSPmupsP2HiTemp OBJECT-TYPE
+ SYNTAX INTEGER {
+ disableAlarm (1),
+ enableAlarm (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to disableAlarm (1) disables the
+ Probe 2 high temperature alarm for this outlet.
+
+ Setting this OID to enableAlarm (2) enables the
+ Probe 2 high temperature alarm for this outlet."
+ ::= { sPDUOutletConfigMSPmupsEntry 16 }
+
+-- the sPDUOutletStatusMSP group
+
+sPDUOutletStatusMSPTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF OutletStatusMSPEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting of status of individual outlets. The number of
+ entries is contained in the sPDUMasterStatusOutletCount OID."
+ ::= { sPDUOutletStatusMSP 1 }
+
+sPDUOutletStatusMSPEntry OBJECT-TYPE
+ SYNTAX OutletStatusMSPEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlets to gather status from."
+ INDEX { sPDUOutletStatusMSPIndex, sPDUOutletStatusMSPOutletIndex }
+ ::= { sPDUOutletStatusMSPTable 1 }
+
+OutletStatusMSPEntry ::=
+ SEQUENCE {
+ sPDUOutletStatusMSPIndex INTEGER,
+ sPDUOutletStatusMSPName DisplayString,
+ sPDUOutletStatusMSPOutletIndex INTEGER,
+ sPDUOutletStatusMSPOutletName DisplayString,
+ sPDUOutletStatusMSPOutletState INTEGER,
+ sPDUOutletStatusMSPCommandPending INTEGER,
+ sPDUOutletStatusMSPOutletCtrlMode INTEGER
+ }
+
+sPDUOutletStatusMSPIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the MasterSwitch MSP."
+ ::= { sPDUOutletStatusMSPEntry 1 }
+
+sPDUOutletStatusMSPName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the MasterSwitch plus. The maximum
+ value is 23 characters. The name is set by
+ using the sPDUMasterConfigMSPName OID."
+ ::= { sPDUOutletStatusMSPEntry 2 }
+
+sPDUOutletStatusMSPOutletIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { sPDUOutletStatusMSPEntry 3 }
+
+sPDUOutletStatusMSPOutletName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet. The maximum size is
+ 23 characters. The name is set by using the
+ sPDUOutletConfigMSPallOutletName OID.
+ This OID is provided for informational purposes only."
+ ::= { sPDUOutletStatusMSPEntry 4 }
+
+sPDUOutletStatusMSPOutletState OBJECT-TYPE
+ SYNTAX INTEGER {
+ outletStatusMSPOn (1),
+ outletStatusMSPOff (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the outlet state. If
+ the outlet is on, the outletStatusMSPOn (1) value will be returned.
+ If the outlet is off, the outletStatusMSPOff (2) value will be
+ returned. "
+ ::= { sPDUOutletStatusMSPEntry 5 }
+
+sPDUOutletStatusMSPCommandPending OBJECT-TYPE
+ SYNTAX INTEGER {
+ outletStatusMSPCommandPending (1),
+ outletStatusMSPNoCommandPending (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the command pending
+ state of the outlet. If a command is pending on the
+ outlet, the outletStatusMSPCommandPending (1) value
+ will be returned. If there is not a command pending
+ on the outlet, the outletStatusMSPNoCommandPending (2)
+ will be returned."
+ ::= { sPDUOutletStatusMSPEntry 6 }
+
+sPDUOutletStatusMSPOutletCtrlMode OBJECT-TYPE
+ SYNTAX INTEGER {
+ modeGracefulShutdown (1),
+ modeAnnunciator (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The Control Mode of the outlet.
+ This OID is provided for informational purposes only."
+ ::= { sPDUOutletStatusMSPEntry 7 }
+
+
+-- the rPDUIdent group
+
+rPDUIdentName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the Rack PDU.
+ The maximum string size is device dependent."
+ ::= { rPDUIdent 1 }
+
+rPDUIdentHardwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware revision of the Rack PDU.
+ This value is set at the factory."
+ ::= { rPDUIdent 2 }
+
+rPDUIdentFirmwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An 8-byte ID string identifying the Rack PDU firmware revision.
+ This value is set at the factory."
+ ::= { rPDUIdent 3 }
+
+
+rPDUIdentDateOfManufacture OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date when the Rack PDU was manufactured in mm/dd/yy format.
+ This value is set at the factory. The year 2000 will be
+ represented by 00."
+ ::= { rPDUIdent 4 }
+
+rPDUIdentModelNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A 10-character string identifying the model number of
+ the Rack PDU. This value is set at the factory."
+ ::= { rPDUIdent 5 }
+
+rPDUIdentSerialNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A 12-character string identifying the serial number of
+ the Rack PDU. This value is set at the factory."
+ ::= { rPDUIdent 6 }
+
+rPDUIdentDeviceRating OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the electrical rating of the device."
+
+ ::= { rPDUIdent 7 }
+
+rPDUIdentDeviceNumOutlets OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the number of outlets contained in the device."
+
+ ::= { rPDUIdent 8 }
+
+rPDUIdentDeviceNumPhases OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the number of phases supported by the device."
+
+ ::= { rPDUIdent 9 }
+
+rPDUIdentDeviceNumBreakers OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the number of circuit breakers supported by the device.
+ This is the same as the number of banks of outlets."
+
+ ::= { rPDUIdent 10 }
+
+rPDUIdentDeviceBreakerRating OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return rating of the circuit breakers on the device if it has any."
+
+ ::= { rPDUIdent 11 }
+
+rPDUIdentDeviceOrientation OBJECT-TYPE
+ SYNTAX INTEGER {
+ orientHorizontal (1),
+ orientVertical (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the intended physical orientation of the device.
+
+ OrientHorizonatal(1) indicates Horizontal.
+ OrientVertical(2) indicates Vertical."
+
+ ::= { rPDUIdent 12 }
+
+rPDUIdentDeviceOutletLayout OBJECT-TYPE
+ SYNTAX INTEGER {
+ seqPhaseToNeutral (1),
+ seqPhaseToPhase (2),
+ seqPhToNeu21PhToPh (3),
+ seqPhToPhGrouped (4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return outlet layout for the device.
+
+ SeqPhaseToNeutral(1) indicates outlet layout as follows:
+ 1:1-N,2:2-N,3:3-N,4:1-N,5:2-N,...
+
+ SeqPhaseToPhase(2) indicates outlet layout as follows:
+ 1:1-2,2:2-3,3:3-1,4:1-2,5:2-3,...
+
+ SeqPhToNeu21PhToPh(3) indicates outlet layout as follows:
+ 1:1-N,2:2-N...21:3-N,22:1-2,23:2-3,24:3-1,...
+
+ SeqPhToPhGrouped(4) indicates outlet layout as follows:
+ Otlts1-8::(3-1),Otlts9-16::(2-3),Otlts17-24::(1-2)."
+ ::= { rPDUIdent 13 }
+
+
+
+-- the rPDULoadDevice group
+
+rPDULoadDevMaxPhaseLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the maximum rated power
+ that each phase of the Rack PDU can provide. It is
+ represented in Amps."
+ ::= { rPDULoadDevice 1 }
+
+rPDULoadDevNumPhases OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of phases available with this Rack PDU."
+ ::= { rPDULoadDevice 2 }
+
+rPDULoadDevMaxBankLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the maximum rated power
+ that each bank of the Rack PDU can provide. It is
+ represented in Amps.
+
+ 0 will be returned if the device does not have any banks."
+
+ ::= { rPDULoadDevice 3 }
+
+rPDULoadDevNumBanks OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of banks of outlets available with this Rack PDU.
+ A bank of outlets has a unique circuit breaker for a subset
+ of the total number of outlets on the rPDU."
+ ::= { rPDULoadDevice 4 }
+
+-- the rPDULoadPhaseConfig group
+
+rPDULoadPhaseConfigTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF LoadPhaseConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of each Rack PDU phase.
+ The number of entries is contained in the
+ rPDULoadDevNumPhases OID."
+ ::= { rPDULoadPhaseConfig 1 }
+
+rPDULoadPhaseConfigEntry OBJECT-TYPE
+ SYNTAX LoadPhaseConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The Rack PDU phase to configure."
+ INDEX { rPDULoadPhaseConfigIndex}
+ ::= { rPDULoadPhaseConfigTable 1 }
+
+LoadPhaseConfigEntry ::=
+ SEQUENCE {
+ rPDULoadPhaseConfigIndex INTEGER,
+ rPDULoadPhaseConfigLowLoadThreshold INTEGER,
+ rPDULoadPhaseConfigNearOverloadThreshold INTEGER,
+ rPDULoadPhaseConfigOverloadThreshold INTEGER
+ }
+
+rPDULoadPhaseConfigIndex OBJECT-TYPE
+ SYNTAX INTEGER {
+ phase1 (1),
+ phase2 (2),
+ phase3 (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the Rack PDU phase entry."
+ ::= { rPDULoadPhaseConfigEntry 1 }
+
+rPDULoadPhaseConfigLowLoadThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A threshold that indicates the power consumption of
+ the load is nearing a low consumption condition. It is
+ represented in amps. A warning will be issued when the
+ load is less than the threshold value.
+
+ A threshold value of 0 amps effectively disables this
+ warning.
+
+ Maximum value must be less than the value returned
+ by the rPDULoadPhaseConfigNearOverloadThreshold OID."
+ ::= { rPDULoadPhaseConfigEntry 2 }
+
+rPDULoadPhaseConfigNearOverloadThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A threshold that indicates the power consumption of
+ the load is nearing an overload condition. It is
+ represented in amps. A warning will be issued when the
+ load is greater than or equal to the threshold value.
+
+ Minimum value must be greater than the value returned by
+ the rPDULoadPhaseConfigLowLoadThreshold OID.
+
+ Maximum value must be less than or equal to the value
+ returned by the rPDULoadPhaseConfigOverloadThreshold OID."
+ ::= { rPDULoadPhaseConfigEntry 3 }
+
+rPDULoadPhaseConfigOverloadThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A threshold that indicates the power consumption of
+ the load has entered an overload condition. It is
+ represented in amps. A warning will be issued when the
+ load is greater than or equal to the threshold value.
+
+ Minimum value must be greater than or equal to the value
+ returned by the rPDULoadPhaseConfigNearOverloadThreshold OID.
+
+ Maximum value must be less than or equal to the value
+ returned by the rPDULoadDevMaxPhaseLoad OID."
+ ::= { rPDULoadPhaseConfigEntry 4 }
+
+
+-- the rPDULoadStatus group
+
+rPDULoadStatusTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF LoadStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting of status of each Rack PDU phase/bank.
+ The number of entries is calculated by adding
+ the number of phases (rPDULoadDevNumPhases OID) and
+ the number of banks of outlets (rPDULoadDevNumBanks)
+ Number of entries = #phases + #banks.
+ NOTE: If a device has phase and bank information, all phase information
+ shall preceed the bank information."
+ ::= { rPDULoadStatus 1 }
+
+rPDULoadStatusEntry OBJECT-TYPE
+ SYNTAX LoadStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The Rack PDU phase/bank to gather status from."
+ INDEX { rPDULoadStatusIndex}
+ ::= { rPDULoadStatusTable 1 }
+
+LoadStatusEntry ::=
+ SEQUENCE {
+ rPDULoadStatusIndex INTEGER,
+ rPDULoadStatusLoad Gauge,
+ rPDULoadStatusLoadState INTEGER,
+ rPDULoadStatusPhaseNumber INTEGER,
+ rPDULoadStatusBankNumber INTEGER
+ }
+
+rPDULoadStatusIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the Rack PDU phase/bank entry. All phase information will preceed
+ any bank information"
+ ::= { rPDULoadStatusEntry 1 }
+
+rPDULoadStatusLoad OBJECT-TYPE
+ SYNTAX Gauge
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the phase/bank load measured
+ in tenths of amps."
+ ::= { rPDULoadStatusEntry 2 }
+
+rPDULoadStatusLoadState OBJECT-TYPE
+ SYNTAX INTEGER {
+ phaseLoadNormal (1),
+ phaseLoadLow (2),
+ phaseLoadNearOverload (3),
+ phaseLoadOverload (4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the phase/bank load state.
+
+ phaseLoadNormal(1) indicates that the phase/bank is
+ operating properly within the rPDULoadConfigLowLoadThreshold
+ and rPDULoadConfigNearOverloadThreshold OID values.
+
+ phaseLoadLow(2) indicates that the phase/bank load has
+ dropped below the rPDULoadConfigLowLoadThreshold OID value.
+ An SNMP trap will occur when this state is entered or cleared.
+
+ phaseLoadNearOverload(3) indicates that the phase/bank load
+ is greater than or equal to the
+ rPDULoadConfigNearOverloadThreshold OID value.
+ An SNMP trap will occur when this state is entered or cleared.
+
+ phaseLoadOverload(4) indicates that the phase/bank load is
+ greater than or equal to the rPDULoadConfigOverloadThreshold
+ OID value.
+ An SNMP trap will occur when this state is entered or cleared."
+ ::= { rPDULoadStatusEntry 3 }
+
+rPDULoadStatusPhaseNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The phase number to which this record refers. A value of 0 will be returned if
+ this is bank related information."
+ ::= { rPDULoadStatusEntry 4 }
+
+rPDULoadStatusBankNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The bank number to which this record refers. A value of 0 will be returned if
+ this is phase related information."
+ ::= { rPDULoadStatusEntry 5 }
+
+-- the rPDULoadBankConfig group
+
+rPDULoadBankConfigTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF LoadBankConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of each Rack PDU bank.
+ The number of entries is contained in the
+ rPDULoadDevNumBanks OID."
+ ::= { rPDULoadBankConfig 1 }
+
+rPDULoadBankConfigEntry OBJECT-TYPE
+ SYNTAX LoadBankConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The Rack PDU bank to configure."
+ INDEX { rPDULoadBankConfigIndex}
+ ::= { rPDULoadBankConfigTable 1 }
+
+LoadBankConfigEntry ::=
+ SEQUENCE {
+ rPDULoadBankConfigIndex INTEGER,
+ rPDULoadBankConfigLowLoadThreshold INTEGER,
+ rPDULoadBankConfigNearOverloadThreshold INTEGER,
+ rPDULoadBankConfigOverloadThreshold INTEGER
+ }
+
+rPDULoadBankConfigIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the Rack PDU bank entry."
+ ::= { rPDULoadBankConfigEntry 1 }
+
+rPDULoadBankConfigLowLoadThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A threshold that indicates the power consumption of
+ the load is nearing a low consumption condition. It is
+ represented in amps. A warning will be issued when the
+ load is less than the threshold value.
+
+ A threshold value of 0 amps effectively disables this
+ warning.
+
+ Maximum value must be less than the value returned
+ by the rPDULoadBankConfigNearOverloadThreshold OID.
+
+ -1 will be returned if the device has no banks."
+
+ ::= { rPDULoadBankConfigEntry 2 }
+
+rPDULoadBankConfigNearOverloadThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A threshold that indicates the power consumption of
+ the load is nearing an overload condition. It is
+ represented in amps. A warning will be issued when the
+ load is greater than or equal to the threshold value.
+
+ Minimum value must be greater than the value returned by
+ the rPDULoadBankConfigLowLoadThreshold OID.
+
+ Maximum value must be less than or equal to the value
+ returned by the rPDULoadBankConfigOverloadThreshold OID.
+
+ -1 will be returned if the device has no banks."
+
+ ::= { rPDULoadBankConfigEntry 3 }
+
+rPDULoadBankConfigOverloadThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A threshold that indicates the power consumption of
+ the load has entered an overload condition. It is
+ represented in amps. A warning will be issued when the
+ load is greater than or equal to the threshold value.
+
+ Minimum value must be greater than or equal to the value
+ returned by the rPDULoadBankConfigNearOverloadThreshold OID.
+
+ Maximum value must be less than or equal to the value
+ returned by the rPDULoadDevMaxBankLoad OID.
+
+ -1 will be returned if the device has no banks."
+
+ ::= { rPDULoadBankConfigEntry 4 }
+
+
+-- the rPDUOutletDevice group
+
+rPDUOutletDevCommand OBJECT-TYPE
+ SYNTAX INTEGER {
+ noCommandAll (1),
+ immediateAllOn (2),
+ immediateAllOff (3),
+ immediateAllReboot (4),
+ delayedAllOn (5),
+ delayedAllOff (6),
+ delayedAllReboot (7),
+ cancelAllPendingCommands (8),
+ gracefulAllOff (9),
+ gracefulAllReboot (10)
+ }
+
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this OID to immediateAllOn (2) will turn all outlets
+ on immediately.
+
+ Setting this OID to immediateAllOff (3) will turn all outlets
+ off immediately.
+
+ Setting this OID to immediateAllReboot (4) will reboot all outlets
+ immediately.
+
+ Setting this OID to delayedAllOn (5) will turn all outlets on as
+ defined by each outlet's rPDUOutletConfigPowerOnTime OID value.
+
+ Setting this OID to delayedAllOff (6) will turn all outlets
+ off as defined by each outlet's rPDUOutletConfigPowerOffTime OID value.
+
+ Setting this OID to delayedAllReboot (7) will cause a
+ delayedAllOff command to be performed. Once all outlets are off,
+ the Switched Rack PDU will then delay the largest
+ rPDUOutletConfigRebootDuration OID time, and then perform a
+ delayedAllOn command.
+
+ Setting this OID to cancelAllPendingCommands (8) will cause all pending
+ commands on the Switched Rack PDU to be canceled.
+
+ Setting this variable to gracefulAllOff (9) will cause the
+ Switched Rack PDU to shut all outlets off after it waits the
+ servers graceful shutdown time and each outlet's shutdown delay.
+
+ Setting this variable to gracefulAllReboot (10) will cause the
+ Switched Rack PDU to shut all outlets off after it waits the
+ servers graceful shutdown time and each outlet's shutdown delay.
+ Once all outlet are off, it will wait until the UPS reaches the
+ configured minimum return battery capacity, then each outlet's
+ return delay before it turns the outlet back on.
+
+ Getting this OID will return the noCommandAll (1) value."
+ ::= { rPDUOutletDevice 1 }
+
+rPDUOutletDevColdstartDelay OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The amount of delay, in seconds, between when
+ power is provided to the Switched Rack PDU and
+ when the Switched Rack PDU provides basic master
+ power to the outlets.
+
+ Allowed values are:
+
+ -1 - never apply power automatically.
+ 0 - apply power immediately.
+ 1 to 300 - delay up to 300 seconds (5 minutes)."
+ ::= { rPDUOutletDevice 2 }
+
+rPDUOutletDevNumCntrlOutlets OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of controlled outlets on this Switched Rack PDU."
+ ::= { rPDUOutletDevice 3 }
+
+rPDUOutletDevNumTotalOutlets OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The total number of outlets on this Rack PDU."
+ ::= { rPDUOutletDevice 4 }
+
+
+-- the rPDUOutletPhase group
+
+rPDUOutletPhaseTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF OutletPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for management of outlets on a per phase basis."
+ ::= { rPDUOutletPhase 1 }
+
+rPDUOutletPhaseEntry OBJECT-TYPE
+ SYNTAX OutletPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The phase to manage."
+ INDEX { rPDUOutletPhaseIndex}
+ ::= { rPDUOutletPhaseTable 1 }
+
+OutletPhaseEntry ::=
+ SEQUENCE {
+ rPDUOutletPhaseIndex INTEGER,
+ rPDUOutletPhaseOverloadRestriction INTEGER
+ }
+
+rPDUOutletPhaseIndex OBJECT-TYPE
+ SYNTAX INTEGER {
+ phase1 (1),
+ phase2 (2),
+ phase3 (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the Switched Rack PDU phase entry."
+ ::= { rPDUOutletPhaseEntry 1 }
+
+rPDUOutletPhaseOverloadRestriction OBJECT-TYPE
+ SYNTAX INTEGER {
+ alwaysAllowTurnON (1),
+ restrictOnNearOverload (2),
+ restrictOnOverload (3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This OID controls the behavior of a Switched Rack PDU
+ phase when an overload condition is possible and
+ additional outlets are requested to be turned on.
+
+ Setting this OID to alwaysAllowTurnON (1) will always allow
+ the outlets on the corresponding phase to turn on.
+
+ Setting this OID to restrictOnNearOverload (2) will not allow
+ outlets on the corresponding phase to turn on if the
+ rPDULoadConfigNearOverloadThreshold OID is exceeded.
+
+ Setting this OID to restrictOnOverload (3) will not allow
+ outlets on the corresponding phase to turn on if the
+ rPDULoadConfigOverloadThreshold OID is exceeded."
+ ::= { rPDUOutletPhaseEntry 2 }
+
+
+-- the rPDUOutletControl group
+
+rPDUOutletControlTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF RPDUOutletControlEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for control of the individual outlets.
+ The number of entries is contained in the
+ rPDUOutletDevNumCntrlOutlets OID."
+ ::= { rPDUOutletControl 1 }
+
+rPDUOutletControlEntry OBJECT-TYPE
+ SYNTAX RPDUOutletControlEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlet to control."
+ INDEX { rPDUOutletControlIndex}
+ ::= { rPDUOutletControlTable 1 }
+
+RPDUOutletControlEntry ::=
+ SEQUENCE {
+ rPDUOutletControlIndex INTEGER,
+ rPDUOutletControlOutletName DisplayString,
+ rPDUOutletControlOutletPhase INTEGER,
+ rPDUOutletControlOutletCommand INTEGER,
+ rPDUOutletControlOutletBank INTEGER
+ }
+
+rPDUOutletControlIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { rPDUOutletControlEntry 1 }
+
+rPDUOutletControlOutletName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet. Maximum size is dependent on device.
+ An error will be returned if the set request exceeds the max size.
+ This OID is provided for informational purposes only."
+ ::= { rPDUOutletControlEntry 2 }
+
+rPDUOutletControlOutletPhase OBJECT-TYPE
+ SYNTAX INTEGER {
+ phase1 (1),
+ phase2 (2),
+ phase3 (3),
+ phase1-2 (4),
+ phase2-3 (5),
+ phase3-1 (6)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The phase/s associated with this outlet.
+
+ For single phase devices, this object will always
+ return phase1(1).
+
+ For 3-phase devices, this object will return phase1 (1),
+ phase2 (2), or phase3 (3) for outlets tied to a single
+ phase. For outlets tied to two phases, this object will
+ return phase1-2 (4) for phases 1 and 2, phase2-3 (5) for
+ phases 2 and 3, and phase3-1 (6) for phases 3 and 1."
+ ::= { rPDUOutletControlEntry 3 }
+
+rPDUOutletControlOutletCommand OBJECT-TYPE
+ SYNTAX INTEGER {
+ immediateOn (1),
+ immediateOff (2),
+ immediateReboot (3),
+ delayedOn (4),
+ delayedOff (5),
+ delayedReboot (6),
+ cancelPendingCommand (7),
+ gracefulOff (8),
+ gracefulReboot (9)
+
+ }
+
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the outlet state. If
+ the outlet is on, the immediateOn (1) value will be returned.
+ If the outlet is off, the immediateOff (2) value will be
+ returned.
+
+
+ Setting this variable to immediateOn (1) will immediately turn
+ the outlet on.
+
+ Setting this variable to immediateOff (2) will immediately turn
+ the outlet off.
+
+ Setting this variable to immediateReboot (3) will immediately
+ reboot the outlet.
+
+ Setting this variable to delayedOn (4) will turn the outlet on
+ after the rPDUOutletConfigPowerOnTime OID time has elapsed.
+
+ Setting this variable to delayedOff (5) will turn the outlet off
+ after the rPDUOutletConfigPowerOffTime OID time has elapsed.
+
+ Setting this variable to delayedReboot (6) will cause the
+ Switched Rack PDU to perform a delayedOff command, wait the
+ rPDUOutletConfigRebootDuration OID time, and then perform a
+ delayedOn command.
+
+ Setting this variable to cancelPendingCommand (7) will cause any
+ pending command to this outlet to be canceled.
+
+ Setting this variable to gracefulOff (8) will cause the
+ Switched Rack PDU to shut the outlet off after it waits the
+ servers graceful shutdown time and the outlets shutdown delay.
+
+ Setting this variable to gracefulReboot (9) will cause the
+ Switched Rack PDU to shut the outlet off after it waits the
+ servers graceful shutdown time and the outlets shutdown delay.
+ Once the outlet is off, it will wait until the UPS reaches the
+ configured minimum return battery capacity, then the outlets
+ return delay before it turns the outlet back on."
+
+ ::= { rPDUOutletControlEntry 4 }
+
+rPDUOutletControlOutletBank OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The bank associated with this outlet."
+ ::= { rPDUOutletControlEntry 5 }
+
+
+-- the rPDUOutletConfig group
+
+rPDUOutletConfigTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF RPDUOutletConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of individual outlets. The number of
+ entries is contained in the rPDUOutletDevNumCntrlOutlets OID."
+ ::= { rPDUOutletConfig 1 }
+
+rPDUOutletConfigEntry OBJECT-TYPE
+ SYNTAX RPDUOutletConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlet to configure."
+ INDEX { rPDUOutletConfigIndex}
+ ::= { rPDUOutletConfigTable 1 }
+
+RPDUOutletConfigEntry ::=
+ SEQUENCE {
+ rPDUOutletConfigIndex INTEGER,
+ rPDUOutletConfigOutletName DisplayString,
+ rPDUOutletConfigOutletPhase INTEGER,
+ rPDUOutletConfigPowerOnTime INTEGER,
+ rPDUOutletConfigPowerOffTime INTEGER,
+ rPDUOutletConfigRebootDuration INTEGER,
+ rPDUOutletConfigOutletBank INTEGER
+ }
+
+rPDUOutletConfigIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { rPDUOutletConfigEntry 1 }
+
+rPDUOutletConfigOutletName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet. Maximum size is dependent on device.
+ An error will be returned if the set request exceeds the max size."
+ ::= { rPDUOutletConfigEntry 2 }
+
+rPDUOutletConfigOutletPhase OBJECT-TYPE
+ SYNTAX INTEGER {
+ phase1 (1),
+ phase2 (2),
+ phase3 (3),
+ phase1-2 (4),
+ phase2-3 (5),
+ phase3-1 (6)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The phase/s associated with this outlet.
+
+ For single phase devices, this object will always
+ return phase1(1).
+
+ For 3-phase devices, this object will return phase1 (1),
+ phase2 (2), or phase3 (3) for outlets tied to a single
+ phase. For outlets tied to two phases, this object will
+ return phase1-2 (4) for phases 1 and 2, phase2-3 (5) for
+ phases 2 and 3, and phase3-1 (6) for phases 3 and 1."
+ ::= { rPDUOutletConfigEntry 3 }
+
+rPDUOutletConfigPowerOnTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The amount of time (in seconds) the outlet will delay
+ powering on at coldstart or when a command that requires
+ a turn-on delay is issued.
+
+ Allowed values are:
+
+ -1 - never power on.
+ 0 - power on immediately.
+ 1 to 300 - power on up to 300 seconds (5 minutes) after being
+ commanded."
+ ::= { rPDUOutletConfigEntry 4 }
+
+rPDUOutletConfigPowerOffTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The amount of time (in seconds) the outlet will delay
+ powering off when a command that requires
+ a turn-off delay is issued.
+
+ Allowed values are:
+
+ -1 - never power off.
+ 0 - power off immediately.
+ 1 to 300 - power off up to 300 seconds (5 minutes) after being
+ commanded."
+ ::= { rPDUOutletConfigEntry 5 }
+
+rPDUOutletConfigRebootDuration OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "During a reboot sequence, power is turned off and then
+ back on. This OID defines the amount of time to wait,
+ in seconds, after turning the power off, at the start
+ of the sequence, before turning power back on, at the
+ end of the reboot sequence.
+
+ Allowed range is any value between 5 and 60 seconds (1 minute)."
+ ::= { rPDUOutletConfigEntry 6 }
+
+rPDUOutletConfigOutletBank OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The bank associated with this outlet."
+ ::= { rPDUOutletConfigEntry 7 }
+
+
+-- the rPDUOutletStatus group
+
+rPDUOutletStatusTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF RPDUOutletStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting of status of individual outlets. The number of
+ entries is contained in the rPDUOutletDevNumCntrlOutlets OID."
+ ::= { rPDUOutletStatus 1 }
+
+rPDUOutletStatusEntry OBJECT-TYPE
+ SYNTAX RPDUOutletStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlet to gather status from."
+ INDEX { rPDUOutletStatusIndex}
+ ::= { rPDUOutletStatusTable 1 }
+
+RPDUOutletStatusEntry ::=
+ SEQUENCE {
+ rPDUOutletStatusIndex INTEGER,
+ rPDUOutletStatusOutletName DisplayString,
+ rPDUOutletStatusOutletPhase INTEGER,
+ rPDUOutletStatusOutletState INTEGER,
+ rPDUOutletStatusCommandPending INTEGER,
+ rPDUOutletStatusOutletBank INTEGER
+ }
+
+rPDUOutletStatusIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { rPDUOutletStatusEntry 1 }
+
+rPDUOutletStatusOutletName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet. Maximum size is dependent on device.
+ An error will be returned if the set request exceeds the max size.
+ This OID is provided for informational purposes only."
+ ::= { rPDUOutletStatusEntry 2 }
+
+rPDUOutletStatusOutletPhase OBJECT-TYPE
+ SYNTAX INTEGER {
+ phase1 (1),
+ phase2 (2),
+ phase3 (3),
+ phase1-2 (4),
+ phase2-3 (5),
+ phase3-1 (6)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The phase/s associated with this outlet.
+
+ For single phase devices, this object will always
+ return phase1(1).
+
+ For 3-phase devices, this object will return phase1 (1),
+ phase2 (2), or phase3 (3) for outlets tied to a single
+ phase. For outlets tied to two phases, this object will
+ return phase1-2 (4) for phases 1 and 2, phase2-3 (5) for
+ phases 2 and 3, and phase3-1 (6) for phases 3 and 1."
+ ::= { rPDUOutletStatusEntry 3 }
+
+rPDUOutletStatusOutletState OBJECT-TYPE
+ SYNTAX INTEGER {
+ outletStatusOn (1),
+ outletStatusOff (2)
+ }
+
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the outlet state. If
+ the outlet is on, the outletStatusOn (1) value will be returned.
+ If the outlet is off, the outletStatusOff (2) value will be
+ returned. "
+ ::= { rPDUOutletStatusEntry 4 }
+
+rPDUOutletStatusCommandPending OBJECT-TYPE
+ SYNTAX INTEGER {
+ outletStatusCommandPending (1),
+ outletStatusNoCommandPending (2)
+ }
+
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the command pending
+ state of the outlet. If a command is pending on the
+ outlet, the outletStatusCommandPending (1) value
+ will be returned. If there is not a command pending
+ on the outlet, the outletStatusNoCommandPending (2)
+ will be returned."
+ ::= { rPDUOutletStatusEntry 5 }
+
+rPDUOutletStatusOutletBank OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The bank associated with this outlet."
+ ::= { rPDUOutletStatusEntry 6 }
+
+
+-- the rPDUOutletBank group
+
+rPDUOutletBankTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF OutletBankEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for management of outlets on a per bank basis."
+ ::= { rPDUOutletBank 1 }
+
+rPDUOutletBankEntry OBJECT-TYPE
+ SYNTAX OutletBankEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The bank to manage."
+ INDEX { rPDUOutletBankIndex}
+ ::= { rPDUOutletBankTable 1 }
+
+OutletBankEntry ::=
+ SEQUENCE {
+ rPDUOutletBankIndex INTEGER,
+ rPDUOutletBankOverloadRestriction INTEGER
+ }
+
+rPDUOutletBankIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the Switched Rack PDU bank entry."
+ ::= { rPDUOutletBankEntry 1 }
+
+rPDUOutletBankOverloadRestriction OBJECT-TYPE
+ SYNTAX INTEGER {
+ alwaysAllowTurnON (1),
+ restrictOnNearOverload (2),
+ restrictOnOverload (3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This OID controls the behavior of a Switched Rack PDU
+ bank when an overload condition is possible and
+ additional outlets are requested to be turned on.
+
+ Setting this OID to alwaysAllowTurnON (1) will always allow
+ the outlets on the corresponding bank to turn on.
+
+ Setting this OID to restrictOnNearOverload (2) will not allow
+ outlets on the corresponding bank to turn on if the
+ rPDULoadConfigNearOverloadThreshold OID is exceeded.
+
+ Setting this OID to restrictOnOverload (3) will not allow
+ outlets on the corresponding bank to turn on if the
+ rPDULoadConfigOverloadThreshold OID is exceeded."
+ ::= { rPDUOutletBankEntry 2 }
+
+-- the rPDUPowerSupplyDevice group
+
+rPDUPowerSupply1Status OBJECT-TYPE
+ SYNTAX INTEGER {
+ powerSupply1Ok (1),
+ powerSupply1Failed (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return powerSupply1Ok(1) if power
+ supply 1 is functioning normally. If not functioning normally,
+ this OID will return powerSupply1Failed(2)."
+ ::= { rPDUPowerSupplyDevice 1 }
+
+rPDUPowerSupply2Status OBJECT-TYPE
+ SYNTAX INTEGER {
+ powerSupply2Ok (1),
+ powerSupply2Failed (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return powerSupply2Ok(1) if power
+ supply 2 is functioning normally. If not functioning normally,
+ this OID will return powerSupply2Failed(2)."
+ ::= { rPDUPowerSupplyDevice 2 }
+
+
+
+-- the dm3IdentSystem group
+
+dm3IdentSysDescriptionTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC description records."
+ ::= { dm3IdentSystem 1 }
+
+dm3IdentSysDescriptionTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF IdentSysDescriptionEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for accessing description records of the powerplant. The number of
+ entries is contained in the dm3IdentSysDescriptionTableSize OID."
+ ::= { dm3IdentSystem 2 }
+
+dm3IdentSysDescriptionEntry OBJECT-TYPE
+ SYNTAX IdentSysDescriptionEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The powerplant description record to reference."
+ INDEX { dm3IdentSysDescriptionIndex }
+ ::= { dm3IdentSysDescriptionTable 1 }
+
+IdentSysDescriptionEntry ::=
+ SEQUENCE {
+ dm3IdentSysDescriptionIndex INTEGER,
+ dm3IdentSysDescriptionText DisplayString
+ }
+
+dm3IdentSysDescriptionIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant description record."
+ ::= { dm3IdentSysDescriptionEntry 1 }
+
+dm3IdentSysDescriptionText OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A 16 character text field describing the DC power plant device.
+ This field can be configured from the dm3ConfigSysDescriptionText OID."
+ ::= { dm3IdentSysDescriptionEntry 2 }
+
+dm3IdentSysModel OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Model type of the DC power plant."
+ ::= { dm3IdentSystem 3 }
+
+dm3IdentSysCntrlRev OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Integer representation of the hardware revision of the Master Controller board."
+ ::= { dm3IdentSystem 4 }
+
+dm3IdentSysFWVersion OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Integer representation of the power plant Master Controller firmware revision."
+ ::= { dm3IdentSystem 5 }
+
+-- the dm3ConfigSystem group
+
+dm3ConfigSysDescriptionTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC description records."
+ ::= { dm3ConfigSystem 1 }
+
+dm3ConfigSysDescriptionTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ConfigSysDescriptionEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for accessing description records of the powerplant. The number of
+ entries is contained in the dm3ConfigSysDescriptionTableSize OID."
+ ::= { dm3ConfigSystem 2 }
+
+dm3ConfigSysDescriptionEntry OBJECT-TYPE
+ SYNTAX ConfigSysDescriptionEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The powerplant description record to reference."
+ INDEX { dm3ConfigSysDescriptionIndex }
+ ::= { dm3ConfigSysDescriptionTable 1 }
+
+ConfigSysDescriptionEntry ::=
+ SEQUENCE {
+ dm3ConfigSysDescriptionIndex INTEGER,
+ dm3ConfigSysDescriptionText DisplayString
+ }
+
+dm3ConfigSysDescriptionIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant description record."
+
+ ::= { dm3ConfigSysDescriptionEntry 1 }
+
+dm3ConfigSysDescriptionText OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "16 character text field describing the DC power plant device."
+
+ ::= { dm3ConfigSysDescriptionEntry 2 }
+
+dm3ConfigSysHighTempThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Ambient high temperature threshold. Temperature sensor located on Master
+ Controller board.
+
+ Values are represented in thousandths of a degree.
+ Units are displayed in the scale shown in
+ the 'dm3StatusSysTempUnits' OID (Celsius or Fahrenheit).
+
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigSystem 3 }
+
+dm3ConfigSysHighTempAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the System High Temperature Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+ ::= { dm3ConfigSystem 4 }
+
+dm3ConfigSysLowTempThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Ambient low temperature threshold. Temperature sensor located on Master
+ Controller board.
+
+ Values are represented in thousandths of a degree.
+ Units are displayed in the scale shown in
+ the 'dm3StatusSysTempUnits' OID (Celsius or Fahrenheit).
+
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigSystem 5 }
+
+dm3ConfigSysLowTempAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the System Low Temperature Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+ ::= { dm3ConfigSystem 6 }
+
+dm3ConfigSysHardwareTempAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the System Hardware Temperature Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+ ::= { dm3ConfigSystem 7 }
+
+dm3ConfigSysRemoteAccess OBJECT-TYPE
+ SYNTAX INTEGER {
+ accessEnabled (1),
+ accessDisabled (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "
+ This OID is used to disable remote write access to the power plant.
+ Setting this OID to accessEnabled (1) will have no affect.
+ Setting this OID to accessDisabled (2) will disable the ability to
+ remotely configure the DC powerplant.
+
+ Once remote access is disabled, it can only be restored from the front
+ panel of the DC power plant."
+ ::= { dm3ConfigSystem 8 }
+
+
+-- the dm3ConfigLVD group
+
+dm3ConfigLVDTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant LVDs controllable
+ by this IP address."
+ ::= { dm3ConfigLVD 1 }
+
+dm3ConfigLVDTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ConfigLVDEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for accessing settings of the LVDs. The number of
+ entries is contained in the dm3ConfigLVDTableSize OID."
+ ::= { dm3ConfigLVD 2 }
+
+dm3ConfigLVDEntry OBJECT-TYPE
+ SYNTAX ConfigLVDEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The LVD to configure."
+ INDEX { dm3ConfigLVDIndex }
+ ::= { dm3ConfigLVDTable 1 }
+
+ConfigLVDEntry ::=
+ SEQUENCE {
+ dm3ConfigLVDIndex INTEGER,
+ dm3ConfigLVDName DisplayString,
+ dm3ConfigLVDEnable INTEGER,
+ dm3ConfigLVDTripThresh INTEGER,
+ dm3ConfigLVDResetThresh INTEGER,
+ dm3ConfigLVDOpenAlarm INTEGER,
+ dm3ConfigLVDHWAlarm INTEGER
+ }
+
+dm3ConfigLVDIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant LVD."
+ ::= { dm3ConfigLVDEntry 1 }
+
+dm3ConfigLVDName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the LVD. The maximum value is 16 characters."
+ ::= { dm3ConfigLVDEntry 2 }
+
+dm3ConfigLVDEnable OBJECT-TYPE
+ SYNTAX INTEGER {
+ enabledYes (1),
+ enabledNo (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This OID is used to control and indicate if the LVD is on or off.
+ Setting this OID to enabledYes (1) will enable (turn on) the LVD.
+ Setting this OID to enabledNo (2) will disable (turn off) the LVD."
+ ::= { dm3ConfigLVDEntry 3 }
+
+dm3ConfigLVDTripThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "LVD Trip threshold. If voltage exceeds threshold, the LVD will trip.
+
+ Values are represented in thousandths of Volts (mV).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigLVDEntry 4 }
+
+dm3ConfigLVDResetThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "LVD Reset threshold. If voltage exceeds threshold, the LVD will reset.
+
+ Values are represented in thousandths of Volts (mV).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigLVDEntry 5 }
+
+dm3ConfigLVDOpenAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the LVD Open Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+ ::= { dm3ConfigLVDEntry 6 }
+
+dm3ConfigLVDHWAlarm OBJECT-TYPE
+SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the LVD Hardware Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+ ::= { dm3ConfigLVDEntry 7 }
+
+
+-- the dm3ConfigBattery group
+
+dm3ConfigBattFloatVolt OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Battery Float Voltage. This setting controls the power plant voltage.
+
+ Values are represented in thousandths of Volts (mV).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigBattery 1 }
+
+dm3ConfigBattMaxRecharge OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Battery Maximum Recharge Rate. This setting controls the battery max
+ recharge rate. The value is based on C/20 for 240 AHr battery string.
+
+ Values are represented in thousandths of Amps (mA).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigBattery 2 }
+
+dm3ConfigBattDischargeThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Battery discharge threshold. If battery output current exceeds threshold
+ a battery discharge alarm will occur.
+
+ Values are represented in thousandths of Amps (mA).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigBattery 3 }
+
+dm3ConfigBattDischargeAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Battery Discharge Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigBattery 4 }
+
+dm3ConfigBattHighVoltThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Battery high voltage threshold. If system battery voltage exceeds threshold
+ a battery high voltage alarm will occur.
+
+ Values are represented in thousandths of Volts (mV).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigBattery 5 }
+
+dm3ConfigBattHighVoltAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Battery High Voltage Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigBattery 6 }
+
+dm3ConfigBattLowVoltThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Battery low voltage threshold. If system battery voltage is under threshold
+ a battery low voltage alarm will occur.
+
+ Values are represented in thousandths of Volts (mV).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigBattery 7 }
+
+dm3ConfigBattLowVoltAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Battery Low Voltage Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigBattery 8 }
+
+dm3ConfigBattHighTempThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Battery high temperature threshold. If system battery temperature exceeds threshold
+ a battery high temperature alarm will occur.
+
+ Values are represented in thousandths of a degree.
+ Units are displayed in the scale shown in
+ the 'dm3StatusSysTempUnits' OID (Celsius or Fahrenheit).
+
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+
+ ::= { dm3ConfigBattery 9 }
+
+dm3ConfigBattHighTempAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Battery High Temperature Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigBattery 10 }
+
+dm3ConfigBattLowTempThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Battery low temperature threshold. If system battery temperature is under threshold
+ a battery low temperature alarm will occur.
+
+ Values are represented in thousandths of a degree.
+ Units are displayed in the scale shown in
+ the 'dm3StatusSysTempUnits' OID (Celsius or Fahrenheit).
+
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+
+ ::= { dm3ConfigBattery 11 }
+
+dm3ConfigBattLowTempAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Battery Low Temperature Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigBattery 12 }
+
+dm3ConfigBattAmpHour OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Battery Amp-Hour Size. Units are thousandths of Amp hours (mAHr).
+
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigBattery 13 }
+
+dm3ConfigCompMethod OBJECT-TYPE
+ SYNTAX INTEGER {
+ tempcompOn (1),
+ tempcompOff (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This OID is used to configure and get the state of the battery
+ temperature compensation.
+
+ Setting this OID to tempcompOn (1) will enable/turn on the battery temperature compensation.
+ Setting this OID to tempcompOff (2) will disable/turn off the battery temperature compensation."
+ ::= { dm3ConfigBattery 14 }
+
+dm3ConfigCompTempCoeff OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Compensation Temperature Coefficient. (uV/degC/cell).
+
+ Units are presented in microvolts.
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigBattery 15 }
+
+dm3ConfigHighKneeTemp OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "High Knee for temperature compensation: Compensation temperature coefficient
+ becomes 0mV/degC/cell.
+
+ Values are represented in thousandths of degrees Celcius.
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigBattery 16 }
+
+dm3ConfigLowKneeTemp OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Low Knee for temperature compensation: Compensation temperature coefficient
+ becomes 0mV/degC/cell.
+
+ Values are represented in thousandths of degrees Celcius.
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigBattery 17 }
+
+dm3ConfigBattHwCurrentAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Battery Current Hardware Alarm (indicating current is outside realistic
+ limits, or a possible measurement fault;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigBattery 18 }
+
+dm3ConfigBattHwTempAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Battery Temperature Hardware Alarm (indicating temperature is outside realistic
+ limits, or a possible measurement fault;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigBattery 19 }
+
+
+-- the dm3ConfigRectThresh group
+dm3ConfigRectHighVoltThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Rectifier high voltage threshold. If rectifier voltage exceeds threshold
+ a rectifier high voltage alarm will occur.
+
+ Values are represented in thousandths of Volts (mV).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigRectThresh 1 }
+
+
+dm3ConfigRectLowVoltThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Rectifier low voltage threshold. If rectifier voltage is under threshold
+ a rectifier low voltage alarm will occur.
+
+ Values are represented in thousandths of Volts (mV).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigRectThresh 2 }
+
+dm3ConfigRectFailSafe OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Rectifier Fail Safe point. This OID represents the value sent to rectifier controllers
+ to use in the event of communications loss with the Master Controller or Master Controller
+ board failure.
+
+ Values are represented in thousandths of Volts (mV).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigRectThresh 3 }
+
+dm3ConfigRectFailComm OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Rectifier Communication Fail timeout. This OID represents the time interval in which there is no
+ communication between the rectifier and the master controller at which the rectifier will reset
+ all its values to default.
+
+ Values are represented in hundredths of Seconds.
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigRectThresh 4 }
+
+-- the dm3ConfigRectAlarms group
+
+dm3ConfigRectHighVoltAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Rectifier High Voltage Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigRectAlarms 1 }
+
+dm3ConfigRectLowVoltAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Rectifier Low Voltage Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigRectAlarms 2 }
+
+dm3ConfigRectConfigAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This alarm is activated when a new rectifier is detected;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigRectAlarms 3 }
+
+dm3ConfigRect1ofNAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This setting indicates the action if ONE rectifier of a N+1 system has failed;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigRectAlarms 4 }
+
+dm3ConfigRect2ofNAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This setting indicates the action if TWO OR MORE rectifiers of a N+1 system have failed;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigRectAlarms 5 }
+
+dm3ConfigRectDiagAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9),
+ alarmNofN (10)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Rectifier Controller Diagnostics Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmNofN (10) causes the alarm specified in the dm3ConfigRect1ofNAlarm OID
+ to be activated if ONE rectifier fails in an N+1 system. It causes the alarm specified in the
+ dm3ConfigRect2ofNAlarm OID to be activated if TWO OR MORE rectifiers fail in an N+1 system."
+
+ ::= { dm3ConfigRectAlarms 6 }
+
+dm3ConfigRectImbalanceAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Rectifier Imbalance Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigRectAlarms 7 }
+
+dm3ConfigRectCurrLimitAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9),
+ alarmNofN (10)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Rectifier Current Limit Alarm (indicating rectifier in the Current Limit state);
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmNofN (10) causes the alarm specified in the dm3ConfigRect1ofNAlarm OID
+ to be activated if ONE rectifier fails in an N+1 system. It causes the alarm specified in the
+ dm3ConfigRect2ofNAlarm OID to be activated if TWO OR MORE rectifiers fail in an N+1 system."
+
+ ::= { dm3ConfigRectAlarms 8 }
+
+dm3ConfigRectStandbyAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9),
+ alarmNofN (10)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Rectifier Standby Alarm (indicating output DC has been turned off);
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmNofN (10) causes the alarm specified in the dm3ConfigRect1ofNAlarm OID
+ to be activated if ONE rectifier fails in an N+1 system. It causes the alarm specified in the
+ dm3ConfigRect2ofNAlarm OID to be activated if TWO OR MORE rectifiers fail in an N+1 system."
+
+ ::= { dm3ConfigRectAlarms 9 }
+
+dm3ConfigRectFanFailAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9),
+ alarmNofN (10)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Rectifier Fan Fail Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmNofN (10) causes the alarm specified in the dm3ConfigRect1ofNAlarm OID
+ to be activated if ONE rectifier fails in an N+1 system. It causes the alarm specified in the
+ dm3ConfigRect2ofNAlarm OID to be activated if TWO OR MORE rectifiers fail in an N+1 system."
+
+ ::= { dm3ConfigRectAlarms 10 }
+
+dm3ConfigRectFailAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9),
+ alarmNofN (10)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Rectifier Fail Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmNofN (10) causes the alarm specified in the dm3ConfigRect1ofNAlarm OID
+ to be activated if ONE rectifier fails in an N+1 system. It causes the alarm specified in the
+ dm3ConfigRect2ofNAlarm OID to be activated if TWO OR MORE rectifiers fail in an N+1 system."
+
+ ::= { dm3ConfigRectAlarms 11 }
+
+dm3ConfigRectHwVoltAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Rectifier Hardware Voltage Alarm (indicating voltage outside realistic limits,
+ or a possible measurement fault);
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigRectAlarms 12 }
+
+
+-- the dm3ConfigConvThresh group
+
+dm3ConfigConvHighVoltThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Converter high voltage threshold. If converter voltage exceeds threshold
+ a converter high voltage alarm will occur.
+
+ Values are represented in thousandths of Volts (mV).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+
+ ::= { dm3ConfigConvThresh 1 }
+
+dm3ConfigConvLowVoltThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Converter low voltage threshold. If converter voltage exceeds threshold
+ a converter low voltage alarm will occur.
+
+ Values are represented in thousandths of Volts (mV).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigConvThresh 2 }
+
+dm3ConfigConvFailSafe OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Converter Fail Safe point. This OID represents the value sent to converter controllers
+ to use in the event of communications loss with the Master Controller or Master Controller
+ board failure.
+
+ Values are represented in thousandths of Volts (mV).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigConvThresh 3 }
+
+dm3ConfigConvSetPoint OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Converter Set point. This OID represents the initial set point used in the
+ voltage control loop.
+
+ Units are thousandths of Volts (mV).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigConvThresh 4 }
+
+dm3ConfigConvFailMax OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Converter Fail Maximum limit. This OID represents the value sent to the converter
+ controllers to define the maximum set point allowed.
+
+ Units are thousandths of Volts (mV).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigConvThresh 5 }
+
+dm3ConfigConvFailMin OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Converter Fail Minimum limit. This OID represents the value sent to the converter
+ controllers to define the minimum set point allowed.
+
+ Units are thousandths of Volts (mV).
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigConvThresh 6 }
+
+dm3ConfigConvFailComm OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Converter Communication Fail timeout. This OID represents the time interval in which there is no
+ communication between the converter and the master controller at which the converter will reset
+ all its values to default.
+
+ Values are represented in hundredths of Seconds.
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigConvThresh 7 }
+
+-- the dm3ConfigConvAlarms group
+dm3ConfigConvHighVoltAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Converter High Voltage Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigConvAlarms 1 }
+
+dm3ConfigConvLowVoltAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Converter Low Voltage Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigConvAlarms 2 }
+
+dm3ConfigConvConfigAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Converter Configuration Alarm (indicating a new converter has been detected);
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigConvAlarms 3 }
+
+dm3ConfigConv1ofNAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Converter 1ofN Alarm (indicating action if ONE converter of a N+1 system has failed);
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigConvAlarms 4 }
+
+dm3ConfigConv2ofNAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Converter 2ofN Alarm (indicating action if TWO OR MORE converters of a N+1 system has failed);
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigConvAlarms 5 }
+
+dm3ConfigConvDiagAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9),
+ alarmNofN (10)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Converter Diagnostics Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmNofN (10) causes the alarm specified in the dm3ConfigConv1ofNAlarm OID
+ to be activated if ONE converter fails in an N+1 system. It causes the alarm specified in the
+ dm3ConfigConv2ofNAlarm OID to be activated if TWO OR MORE converters fail in an N+1 system."
+
+ ::= { dm3ConfigConvAlarms 6 }
+
+dm3ConfigConvImbalanceAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9),
+ alarmNofN (10)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Converter Imbalance Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmNofN (10) causes the alarm specified in the dm3ConfigConv1ofNAlarm OID
+ to be activated if ONE converter fails in an N+1 system. It causes the alarm specified in the
+ dm3ConfigConv2ofNAlarm OID to be activated if TWO OR MORE converters fail in an N+1 system."
+
+ ::= { dm3ConfigConvAlarms 7 }
+
+dm3ConfigConvCurrLimitAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9),
+ alarmNofN (10)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Converter Current Limit Alarm (indicating the converter is in the Current Limit state);
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmNofN (10) causes the alarm specified in the dm3ConfigConv1ofNAlarm OID
+ to be activated if ONE converter fails in an N+1 system. It causes the alarm specified in the
+ dm3ConfigConv2ofNAlarm OID to be activated if TWO OR MORE converters fail in an N+1 system."
+
+ ::= { dm3ConfigConvAlarms 8 }
+
+dm3ConfigConvStandbyAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9),
+ alarmNofN (10)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Converter Standby Alarm (indicating the converter is in the Standby state);
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmNofN (10) causes the alarm specified in the dm3ConfigConv1ofNAlarm OID
+ to be activated if ONE converter fails in an N+1 system. It causes the alarm specified in the
+ dm3ConfigConv2ofNAlarm OID to be activated if TWO OR MORE converters fail in an N+1 system."
+
+ ::= { dm3ConfigConvAlarms 9 }
+
+dm3ConfigConvFanFailAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9),
+ alarmNofN (10)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Converter Fan Fail Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmNofN (10) causes the alarm specified in the dm3ConfigConv1ofNAlarm OID
+ to be activated if ONE converter fails in an N+1 system. It causes the alarm specified in the
+ dm3ConfigConv2ofNAlarm OID to be activated if TWO OR MORE converters fail in an N+1 system."
+
+ ::= { dm3ConfigConvAlarms 10 }
+
+dm3ConfigConvFailAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9),
+ alarmNofN (10)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Converter Fail Alarm;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmNofN (10) causes the alarm specified in the dm3ConfigConv1ofNAlarm OID
+ to be activated if ONE converter fails in an N+1 system. It causes the alarm specified in the
+ dm3ConfigConv2ofNAlarm OID to be activated if TWO OR MORE converters fail in an N+1 system."
+
+ ::= { dm3ConfigConvAlarms 11 }
+
+dm3ConfigConvHwVoltAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9),
+ alarmNofN (10)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "For the Converter Voltage Alarm (indicating voltage outside realistic limits, or a
+ possible measurement fault);
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmNofN (10) causes the alarm specified in the dm3ConfigConv1ofNAlarm OID
+ to be activated if ONE converter fails in an N+1 system. It causes the alarm specified in the
+ dm3ConfigConv2ofNAlarm OID to be activated if TWO OR MORE converters fail in an N+1 system."
+
+ ::= { dm3ConfigConvAlarms 12 }
+
+
+-- the dm3ConfigOutputRelays group
+
+dm3ConfigOutRlyTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant Output Relays controllable
+ by this IP address."
+ ::= { dm3ConfigOutputRelays 1 }
+
+dm3ConfigOutRlyTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ConfigOutRlyEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for accessing settings of the Output Relays. The number of
+ entries is contained in the dm3ConfigOutRlyTableSize OID."
+ ::= { dm3ConfigOutputRelays 2 }
+
+dm3ConfigOutRlyEntry OBJECT-TYPE
+ SYNTAX ConfigOutRlyEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The output relay to configure."
+ INDEX { dm3ConfigOutRlyIndex }
+ ::= { dm3ConfigOutRlyTable 1 }
+
+ConfigOutRlyEntry ::=
+ SEQUENCE {
+ dm3ConfigOutRlyIndex INTEGER,
+ dm3ConfigOutRlyName DisplayString,
+ dm3ConfigOutRlyDelay INTEGER,
+ dm3ConfigOutRlyAlarm INTEGER
+ }
+
+dm3ConfigOutRlyIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant output relay."
+ ::= { dm3ConfigOutRlyEntry 1 }
+
+dm3ConfigOutRlyName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the output relay. The maximum value is 16 characters."
+ ::= { dm3ConfigOutRlyEntry 2 }
+
+dm3ConfigOutRlyDelay OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Output Relay Delay. This OID represents the time delay from the initiation of an
+ output relay action to when the output relay action does occur. If the alarm condition
+ disappears before the end of the delay, no action will occur. Delay for Major
+ and Minor alarms is not configurable and is always set to 0.
+
+ Values are represented in hundredths of seconds.
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigOutRlyEntry 3 }
+
+dm3ConfigOutRlyAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Output Relay Alarm. This setting indicates what action to perform in the event of
+ an output relay alarm condition;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition.
+
+ Relay Alarm for Major and Minor alarms is not configurable and is always set to
+ alarmMajor and alarmMinor respectively."
+
+ ::= { dm3ConfigOutRlyEntry 4 }
+
+
+-- the dm3ConfigInputRelays group
+
+dm3ConfigInRlyTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant Input Relays controllable
+ by this IP address."
+ ::= { dm3ConfigInputRelays 1 }
+
+dm3ConfigInRlyTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ConfigInRlyEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for accessing settings of the Input Relays. The number of
+ entries is contained in the dm3ConfigInRlyTableSize OID."
+ ::= { dm3ConfigInputRelays 2 }
+
+dm3ConfigInRlyEntry OBJECT-TYPE
+ SYNTAX ConfigInRlyEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The input relay to configure."
+ INDEX { dm3ConfigInRlyIndex }
+ ::= { dm3ConfigInRlyTable 1 }
+
+ConfigInRlyEntry ::=
+ SEQUENCE {
+ dm3ConfigInRlyIndex INTEGER,
+ dm3ConfigInRlyName DisplayString,
+ dm3ConfigInRlyDelay INTEGER,
+ dm3ConfigInRlyAlarm INTEGER
+ }
+
+dm3ConfigInRlyIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant input relay."
+ ::= { dm3ConfigInRlyEntry 1 }
+
+dm3ConfigInRlyName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the input relay. The maximum value is 16 characters."
+
+ ::= { dm3ConfigInRlyEntry 2 }
+
+dm3ConfigInRlyDelay OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Input Relay Delay. This OID represents the time delay from the initiation of an
+ input relay action to when the input relay action does occur. If the alarm condition
+ disappears before the end of the delay, no action will occur.
+
+ Values are represented in hundredths of seconds.
+
+ Attempts to set the value above or below the acceptable range of the powerplant
+ will cause the value to be set at the high or low point of the range respectively."
+ ::= { dm3ConfigInRlyEntry 3 }
+
+dm3ConfigInRlyAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Input Relay Alarm. This setting indicates what action to perform in the event of
+ an input relay alarm condition;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigInRlyEntry 4 }
+
+-- the dm3ConfigBreakers group
+
+dm3ConfigBreakersTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant circuit breakers controllable
+ by this IP address."
+ ::= { dm3ConfigBreakers 1 }
+
+dm3ConfigBreakersTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ConfigBreakersEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for accessing settings of the circuit breakers. The number of
+ entries is contained in the dm3ConfigBreakersTableSize OID."
+ ::= { dm3ConfigBreakers 2 }
+
+dm3ConfigBreakersEntry OBJECT-TYPE
+ SYNTAX ConfigBreakersEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The circuit breaker to configure."
+ INDEX { dm3ConfigBreakersIndex }
+ ::= { dm3ConfigBreakersTable 1 }
+
+ConfigBreakersEntry ::=
+ SEQUENCE {
+ dm3ConfigBreakersIndex INTEGER,
+ dm3ConfigBreakersName DisplayString,
+ dm3ConfigBreakersAlarm INTEGER
+ }
+
+dm3ConfigBreakersIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant circuit breaker."
+ ::= { dm3ConfigBreakersEntry 1 }
+
+dm3ConfigBreakersName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the circuit breaker. The maximum value is 16 characters."
+ ::= { dm3ConfigBreakersEntry 2 }
+
+dm3ConfigBreakersAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Circuit Breaker Alarm. This setting indicates what action to perform in the event of
+ a circuit breaker alarm condition;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigBreakersEntry 3 }
+
+-- the dm3ConfigFuses group
+
+dm3ConfigFusesTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant Fuses controllable
+ by this IP address."
+ ::= { dm3ConfigFuses 1 }
+
+dm3ConfigFusesTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ConfigFusesEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for accessing settings of the Fuses. The number of
+ entries is contained in the dm3ConfigFusesTableSize OID."
+ ::= { dm3ConfigFuses 2 }
+
+dm3ConfigFusesEntry OBJECT-TYPE
+ SYNTAX ConfigFusesEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The fuse to configure."
+ INDEX { dm3ConfigFusesIndex }
+ ::= { dm3ConfigFusesTable 1 }
+
+ConfigFusesEntry ::=
+ SEQUENCE {
+ dm3ConfigFusesIndex INTEGER,
+ dm3ConfigFusesName DisplayString,
+ dm3ConfigFusesAlarm INTEGER
+ }
+
+dm3ConfigFusesIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant fuse."
+ ::= { dm3ConfigFusesEntry 1 }
+
+dm3ConfigFusesName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the fuse. The maximum value is 16 characters."
+ ::= { dm3ConfigFusesEntry 2 }
+
+dm3ConfigFusesAlarm OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmIgnore (1),
+ alarmRelay1 (2),
+ alarmRelay2 (3),
+ alarmRelay3 (4),
+ alarmRelay4 (5),
+ alarmRelay5 (6),
+ alarmRelay6 (7),
+ alarmMinor (8),
+ alarmMajor (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Fuses Alarm. This setting indicates what action to perform in the event of
+ a Fuse alarm condition;
+ Setting this OID to alarmIgnore (1) results in the alarm condition being ignored.
+ Setting this OID to alarmRelay1 (2) causes relay 1 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay2 (3) causes relay 2 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay3 (4) causes relay 3 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay4 (5) causes relay 4 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay5 (6) causes relay 5 to be activated for an
+ alarm condition.
+ Setting this OID to alarmRelay6 (7) causes relay 6 to be activated for an
+ alarm condition.
+ Setting this OID to alarmMinor (8) causes the Minor relay to be activated for an
+ alarm condition.
+ Setting this OID to alarmMajor (9) causes the Major relay to be activated for an
+ alarm condition."
+
+ ::= { dm3ConfigFusesEntry 3 }
+
+-- the dm3StatusSystem group
+
+dm3StatusSystemTemp OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "System temperature based on sensor on Master Controller PCB.
+
+ Values are represented in thousandths of a degree.
+ Units are displayed in the scale shown in
+ the 'dm3StatusSysTempUnits' OID (Celsius or Fahrenheit)."
+
+ ::= { dm3StatusSystem 1 }
+
+dm3StatusSystemStart OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Time stamp at DC powerplant initialization.
+ The time is represented as MMM,DD,YYYY,HH:MM:SS."
+ ::= { dm3StatusSystem 2 }
+
+dm3StatusSysRemoteAccess OBJECT-TYPE
+ SYNTAX INTEGER {
+ accessEnabled (1),
+ accessDisabled (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Remote Access indicator
+ This setting indicates if configuration (write) access to the powerplant is enabled or
+ disabled at the powerplant level.
+ This value will be accessEnabled (1) if remote configuration is enabled, and
+ accessDisabled (2) if remote configuration is disabled."
+ ::= { dm3StatusSystem 3 }
+
+dm3StatusSysSecurityLevel OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This variable shows the current active security access level of controller. This
+ can only be changed directly from the front panel."
+ ::= { dm3StatusSystem 4 }
+
+dm3StatusSysTempSanity OBJECT-TYPE
+ SYNTAX INTEGER{
+ saneYES (1),
+ saneNO (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "System temperature sanity indicator. Indicates if the system temperature is
+ reasonable. Reasonable is defined based on powerplant type. A value of saneYes (1)
+ indicates temperature is reasonable, a value of saneNo (2) indicates it is not."
+ ::= { dm3StatusSystem 5 }
+
+dm3StatusSysAlarmState OBJECT-TYPE
+ SYNTAX INTEGER{
+ alarmMinor (1),
+ alarmMajor (2),
+ alarmBoth (3),
+ alarmNone (4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "System Alarm State. Reflects the alarm status of the overall DC system.
+ If a minor alarm is present, the value will be alarmMinor(1).
+ If a major alarm is present, the value will be alarmMajor(2).
+ If both minor and a major alarm is present, the value will be alarmBoth(3).
+ If no alarm is present, the value will be alarmNone(4)."
+ ::= { dm3StatusSystem 6 }
+
+dm3StatusSysTempUnits OBJECT-TYPE
+ SYNTAX INTEGER {
+ celsius(1),
+ fahrenheit(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The temperature scale used to display the temperature
+ in the DC system, Celsius(1) or Fahrenheit(2).
+ This setting is based on the system preferences
+ configuration in the agent."
+ ::= { dm3StatusSystem 7 }
+
+
+-- the dm3StatusAlarms group
+
+dm3StatusAlarmsTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant alarms viewable
+ by this IP address."
+ ::= { dm3StatusAlarms 1 }
+
+dm3StatusAlarmsTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF StatusAlarmsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for accessing system alarms. The number of
+ entries is contained in the dm3StatusAlarmsTableSize OID."
+ ::= { dm3StatusAlarms 2 }
+
+dm3StatusAlarmsEntry OBJECT-TYPE
+ SYNTAX StatusAlarmsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The alarm to display."
+ INDEX { dm3StatusAlarmsIndex }
+ ::= { dm3StatusAlarmsTable 1 }
+
+StatusAlarmsEntry ::=
+ SEQUENCE {
+ dm3StatusAlarmsIndex INTEGER,
+ dm3StatusAlarmsText DisplayString
+ }
+
+dm3StatusAlarmsIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of the system alarm."
+ ::= { dm3StatusAlarmsEntry 1 }
+
+dm3StatusAlarmsText OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The 16 character text describing the active alarm condition."
+ ::= { dm3StatusAlarmsEntry 2 }
+
+-- the dm3StatusBattery group
+
+dm3StatusBattCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Battery Current: This OID shows the battery current in thousandths of Amps (mA)."
+ ::= { dm3StatusBattery 1 }
+
+dm3StatusBattTemp OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Battery Temperature:
+
+ Values are represented in thousandths of a degree.
+ Units are displayed in the scale shown in
+ the 'dm3StatusSysTempUnits' OID (Celsius or Fahrenheit)."
+
+ ::= { dm3StatusBattery 2 }
+
+dm3StatusBattCurrentSanity OBJECT-TYPE
+ SYNTAX INTEGER{
+ saneYES (1),
+ saneNO (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Battery current sanity indicator. Indicates if the battery current is
+ reasonable. Reasonable is defined based on powerplant type. A value of saneYes (1)
+ indicates current is reasonable, a value of saneNo (2) indicates it is not."
+ ::= { dm3StatusBattery 3 }
+
+dm3StatusBattTempSanity OBJECT-TYPE
+ SYNTAX INTEGER{
+ saneYES (1),
+ saneNO (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Battery temperature sanity indicator. Indicates if the battery temperature is
+ reasonable. Reasonable is defined based on powerplant type. A value of saneYes (1)
+ indicates temperature is reasonable, a value of saneNo (2) indicates it is not."
+ ::= { dm3StatusBattery 4 }
+
+-- the dm3StatusOEM group
+
+dm3StatusOEMrectOffset OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the rectifier offset value in thousandths of Volts (mV)."
+ ::= { dm3StatusOEM 1 }
+
+dm3StatusOEMrectGain OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the rectifier gain value in thousandths of Volts (mV/V)."
+ ::= { dm3StatusOEM 2 }
+
+dm3StatusOEMconvOffset OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the converter offset value in thousandths of Volts (mV)."
+ ::= { dm3StatusOEM 3 }
+
+dm3StatusOEMconvGain OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the converter gain value in thousandths of Volts (mV/V)."
+ ::= { dm3StatusOEM 4 }
+
+dm3StatusOEMshuntOffset OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the shunt offset value in thousandths of Amps (mA)."
+ ::= { dm3StatusOEM 5 }
+
+dm3StatusOEMshuntGain OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the shunt gain value in thousandths of Amps (mA/A)."
+ ::= { dm3StatusOEM 6 }
+
+-- the dm3StatusLVD group
+
+dm3StatusLVDTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant LVDs viewable
+ by this IP address."
+ ::= { dm3StatusLVD 1 }
+
+dm3StatusLVDTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF StatusLVDEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for accessing settings of the LVDs. The number of
+ entries is contained in the dm3StatusLVDTableSize OID."
+ ::= { dm3StatusLVD 2 }
+
+dm3StatusLVDEntry OBJECT-TYPE
+ SYNTAX StatusLVDEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The LVD to gather status from."
+ INDEX { dm3StatusLVDIndex }
+ ::= { dm3StatusLVDTable 1 }
+
+StatusLVDEntry ::=
+ SEQUENCE {
+ dm3StatusLVDIndex INTEGER,
+ dm3StatusLVDName DisplayString,
+ dm3StatusLVDState INTEGER,
+ dm3StatusLVDHwFault INTEGER
+ }
+
+dm3StatusLVDIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant LVD."
+ ::= { dm3StatusLVDEntry 1 }
+
+dm3StatusLVDName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the LVD. The maximum size is
+ 16 characters. The name is set by using the
+ dm3ConfigLVDName OID.
+ This OID is provided for informational purposes only."
+ ::= { dm3StatusLVDEntry 2 }
+
+dm3StatusLVDState OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusClosed (1),
+ statusOpened (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusClosed (1) if the LVD is closed.
+ statusOpened (2) will be returned if the LVD is opened."
+ ::= { dm3StatusLVDEntry 3 }
+
+dm3StatusLVDHwFault OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusFault (1),
+ statusNofault (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusFault (1) if the LVD is faulted.
+ statusNofault (2) will be returned if the LVD is not faulted."
+ ::= { dm3StatusLVDEntry 4 }
+
+-- the dm3StatusRectifier group
+
+dm3StatusRectTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant rectifiers viewable
+ by this IP address."
+ ::= { dm3StatusRectifier 1 }
+
+dm3StatusRectTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF StatusRectEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for accessing settings of the rectifiers. The number of
+ entries is contained in the dm3StatusRectTableSize OID."
+ ::= { dm3StatusRectifier 2 }
+
+dm3StatusRectEntry OBJECT-TYPE
+ SYNTAX StatusRectEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The rectifier to gather status from."
+ INDEX { dm3StatusRectIndex }
+ ::= { dm3StatusRectTable 1 }
+
+StatusRectEntry ::=
+ SEQUENCE {
+ dm3StatusRectIndex INTEGER,
+ dm3StatusRectID INTEGER,
+ dm3StatusRectDesc DisplayString,
+ dm3StatusRectCurrent INTEGER,
+ dm3StatusRectCurrentLimit INTEGER,
+ dm3StatusRectStandby INTEGER,
+ dm3StatusRectFanFail INTEGER,
+ dm3StatusRectFail INTEGER,
+ dm3StatusRectDevType INTEGER,
+ dm3StatusRectPhyAddr INTEGER,
+ dm3StatusRectCfg INTEGER,
+ dm3StatusRectPcbRev INTEGER,
+ dm3StatusRectFwVer INTEGER,
+ dm3StatusRectPresent INTEGER,
+ dm3StatusRectDiagPass INTEGER,
+ dm3StatusRectState INTEGER
+ }
+
+dm3StatusRectIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant rectifier."
+ ::= { dm3StatusRectEntry 1 }
+
+dm3StatusRectID OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the rectifier ID. This enumerates the number of the rectifier within
+ a group of rectifiers."
+ ::= { dm3StatusRectEntry 2 }
+
+dm3StatusRectDesc OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the 16-character rectifier description."
+ ::= { dm3StatusRectEntry 3 }
+
+dm3StatusRectCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the rectifier current in thousandths of Amps (mA)."
+ ::= { dm3StatusRectEntry 4 }
+
+dm3StatusRectCurrentLimit OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the rectifier is in the Current Limit state.
+ statusFalse (2) will be returned if the rectifier is not in the Current Limit state."
+ ::= { dm3StatusRectEntry 5 }
+
+dm3StatusRectStandby OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the rectifier is in the Standby state.
+ statusFalse (2) will be returned if the rectifier is not in the Standby state."
+ ::= { dm3StatusRectEntry 6 }
+
+dm3StatusRectFanFail OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the rectifier Fan has failed.
+ statusFalse (2) will be returned if the rectifier Fan has not failed."
+ ::= { dm3StatusRectEntry 7 }
+
+dm3StatusRectFail OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the rectifier has failed.
+ statusFalse (2) will be returned if the rectifier has not failed."
+ ::= { dm3StatusRectEntry 8 }
+
+dm3StatusRectDevType OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the rectifier device type."
+ ::= { dm3StatusRectEntry 9 }
+
+dm3StatusRectPhyAddr OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the rectifier physical address (the address on the bus)."
+ ::= { dm3StatusRectEntry 10 }
+
+dm3StatusRectCfg OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the rectifier is present after
+ power-up or set-configuration.
+ statusFalse (2) will be returned if the rectifier is not configured."
+ ::= { dm3StatusRectEntry 11 }
+
+dm3StatusRectPcbRev OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the rectifier device PCB serial number."
+ ::= { dm3StatusRectEntry 12 }
+
+dm3StatusRectFwVer OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the rectifier device firmware revision."
+ ::= { dm3StatusRectEntry 13 }
+
+dm3StatusRectPresent OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the rectifier is present.
+ statusFalse (2) will be returned if the rectifier is not present."
+ ::= { dm3StatusRectEntry 14 }
+
+dm3StatusRectDiagPass OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the rectifier diagnostics have passed.
+ statusFalse (2) will be returned if the rectifier diagnostics have not passed."
+ ::= { dm3StatusRectEntry 15 }
+
+dm3StatusRectState OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the rectifier device state as defined by the device status register."
+ ::= { dm3StatusRectEntry 16 }
+
+dm3StatusSysRectVoltSanity OBJECT-TYPE
+ SYNTAX INTEGER {
+ saneYES (1),
+ saneNO (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Rectifier voltage sanity indicator. Indicates if the rectifier voltage is
+ reasonable. Reasonable is defined based on powerplant type. A value of saneYes (1)
+ indicates voltage is reasonable, a value of saneNo (2) indicates it is not."
+ ::= { dm3StatusRectifier 3 }
+
+dm3StatusSysRectAvailable OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the rectifier is available.
+ statusFalse (2) will be returned if the rectifier is not available."
+ ::= { dm3StatusRectifier 4 }
+
+dm3StatusSysRectType OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the type of rectifier the system has. There can only be a single type of
+ rectifier in the power plant"
+ ::= { dm3StatusRectifier 5 }
+
+dm3StatusSysRectVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the system level rectifier voltage in thousandths of Volts (mV)."
+ ::= { dm3StatusRectifier 6 }
+
+dm3StatusSysRectCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the system level rectifier current in thousandths of Amps (mA)."
+ ::= { dm3StatusRectifier 7 }
+
+
+-- the dm3StatusConverter group
+
+dm3StatusConvTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant converters viewable
+ by this IP address."
+ ::= { dm3StatusConverter 1 }
+
+dm3StatusConvTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF StatusConvEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for viewing status of the converters. The number of
+ entries is contained in the dm3StatusConvTableSize OID."
+ ::= { dm3StatusConverter 2 }
+
+dm3StatusConvEntry OBJECT-TYPE
+ SYNTAX StatusConvEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The converter to gather status from."
+ INDEX { dm3StatusConvIndex }
+ ::= { dm3StatusConvTable 1 }
+
+StatusConvEntry ::=
+ SEQUENCE {
+ dm3StatusConvIndex INTEGER,
+ dm3StatusConvID INTEGER,
+ dm3StatusConvDesc DisplayString,
+ dm3StatusConvCurrent INTEGER,
+ dm3StatusConvCurrentLimit INTEGER,
+ dm3StatusConvStandby INTEGER,
+ dm3StatusConvFanFail INTEGER,
+ dm3StatusConvFail INTEGER,
+ dm3StatusConvDevType INTEGER,
+ dm3StatusConvPhyAddr INTEGER,
+ dm3StatusConvCfg INTEGER,
+ dm3StatusConvPcbRev INTEGER,
+ dm3StatusConvFwVer INTEGER,
+ dm3StatusConvPresent INTEGER,
+ dm3StatusConvDiagPass INTEGER,
+ dm3StatusConvState INTEGER
+ }
+
+dm3StatusConvIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant converter."
+ ::= { dm3StatusConvEntry 1 }
+
+dm3StatusConvID OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the converter ID. This enumerates the number of the converter within
+ a group of converters."
+ ::= { dm3StatusConvEntry 2 }
+
+dm3StatusConvDesc OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the 16 character converter description."
+ ::= { dm3StatusConvEntry 3 }
+
+dm3StatusConvCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the converter current in thousandths of Amps (mA)."
+ ::= { dm3StatusConvEntry 4 }
+
+dm3StatusConvCurrentLimit OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the converter is in the Current Limit state.
+ statusFalse (2) will be returned if the converter is not in the Current Limit state."
+ ::= { dm3StatusConvEntry 5 }
+
+dm3StatusConvStandby OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the converter is in the Standby state.
+ statusFalse (2) will be returned if the converter is not in the Standby state."
+ ::= { dm3StatusConvEntry 6 }
+
+dm3StatusConvFanFail OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the converter Fan has failed.
+ statusFalse (2) will be returned if the converter Fan has not failed."
+ ::= { dm3StatusConvEntry 7 }
+
+dm3StatusConvFail OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the converter has failed.
+ statusFalse (2) will be returned if the converter has not failed."
+ ::= { dm3StatusConvEntry 8 }
+
+dm3StatusConvDevType OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the converter device type."
+ ::= { dm3StatusConvEntry 9 }
+
+dm3StatusConvPhyAddr OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the converter physical address (the address on the bus)."
+ ::= { dm3StatusConvEntry 10 }
+
+dm3StatusConvCfg OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the converter is present after
+ power-up or set-configuration.
+ statusFalse (2) will be returned if the converter is not configured."
+ ::= { dm3StatusConvEntry 11 }
+
+dm3StatusConvPcbRev OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the converter device PCB serial number."
+ ::= { dm3StatusConvEntry 12 }
+
+dm3StatusConvFwVer OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the converter device firmware version."
+ ::= { dm3StatusConvEntry 13 }
+
+dm3StatusConvPresent OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the converter is present.
+ statusFalse (2) will be returned if the converter is not present."
+ ::= { dm3StatusConvEntry 14 }
+
+dm3StatusConvDiagPass OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the converter diagnostics have passed.
+ statusFalse (2) will be returned if the converter diagnostics have not passed."
+ ::= { dm3StatusConvEntry 15 }
+
+dm3StatusConvState OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the converter state as defined by the device status register."
+ ::= { dm3StatusConvEntry 16 }
+
+dm3StatusSysConvVoltSanity OBJECT-TYPE
+ SYNTAX INTEGER{
+ saneYES (1),
+ saneNO (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Converter voltage sanity indicator. Indicates if the converter voltage is
+ reasonable. Reasonable is defined based on powerplant type. A value of saneYes (1)
+ indicates voltage is reasonable, a value of saneNo (2) indicates it is not."
+ ::= { dm3StatusConverter 3 }
+
+dm3StatusSysConvAvailable OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the converter is available.
+ statusFalse (2) will be returned if the converter is not available."
+ ::= { dm3StatusConverter 4 }
+
+dm3StatusSysConvType OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the converter type."
+ ::= { dm3StatusConverter 5 }
+
+dm3StatusSysConvVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the system level converter voltage in thousandths of volts (mV)."
+ ::= { dm3StatusConverter 6 }
+
+dm3StatusSysConvCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the system level converter current in thousandths of Amps (mA)."
+ ::= { dm3StatusConverter 7 }
+
+-- the dm3StatusOutputRelays group
+
+dm3StatusOutRlyTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant output relays viewable
+ by this IP address."
+ ::= { dm3StatusOutputRelays 1 }
+
+dm3StatusOutRlyTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF StatusOutRlyEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for viewing status of the output relays. The number of
+ entries is contained in the dm3StatusOutRlyTableSize OID."
+ ::= { dm3StatusOutputRelays 2 }
+
+dm3StatusOutRlyEntry OBJECT-TYPE
+ SYNTAX StatusOutRlyEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The output relay to gather status from."
+ INDEX { dm3StatusOutRlyIndex }
+ ::= { dm3StatusOutRlyTable 1 }
+
+StatusOutRlyEntry ::=
+ SEQUENCE {
+ dm3StatusOutRlyIndex INTEGER,
+ dm3StatusOutRlyName DisplayString,
+ dm3StatusOutRlyStatus INTEGER
+ }
+
+dm3StatusOutRlyIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant output relay."
+ ::= { dm3StatusOutRlyEntry 1 }
+
+dm3StatusOutRlyName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the output relay. The maximum size is
+ 16 characters. The name is set by using the
+ dm3ConfigOutRlyName OID.
+ This OID is provided for informational purposes only."
+ ::= { dm3StatusOutRlyEntry 2 }
+
+dm3StatusOutRlyStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusOn (1),
+ statusOff (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusOn (1) if the output relay is enabled/on.
+ statusOff (2) will be returned if the output relay is disabled/off."
+ ::= { dm3StatusOutRlyEntry 3 }
+
+
+-- the dm3StatusInputRelays group
+
+dm3StatusInRlyTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant input relays viewable
+ by this IP address."
+ ::= { dm3StatusInputRelays 1 }
+
+dm3StatusInRlyTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF StatusInRlyEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for viewing status of the input relays. The number of
+ entries is contained in the dm3StatusInRlyTableSize OID."
+ ::= { dm3StatusInputRelays 2 }
+
+
+dm3StatusInRlyEntry OBJECT-TYPE
+ SYNTAX StatusInRlyEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The input relays to gather status from."
+ INDEX { dm3StatusInRlyIndex }
+ ::= { dm3StatusInRlyTable 1 }
+
+StatusInRlyEntry ::=
+ SEQUENCE {
+ dm3StatusInRlyIndex INTEGER,
+ dm3StatusInRlyName DisplayString,
+ dm3StatusInRlyStatus INTEGER
+ }
+
+dm3StatusInRlyIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant input relay."
+ ::= { dm3StatusInRlyEntry 1 }
+
+dm3StatusInRlyName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the input relay. The maximum size is
+ 16 characters. The name is set by using the
+ dm3ConfigInRlyName OID.
+ This OID is provided for informational purposes only."
+ ::= { dm3StatusInRlyEntry 2 }
+
+dm3StatusInRlyStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusOn (1),
+ statusOff (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusOn (1) if the input relay is enabled/on.
+ statusOff (2) will be returned if the input relay is disabled/off."
+ ::= { dm3StatusInRlyEntry 3 }
+
+-- the dm3StatusBreakers group
+
+dm3StatusBreakersTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant circuit breakers viewable
+ by this IP address."
+ ::= { dm3StatusBreakers 1 }
+
+dm3StatusBreakersTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF StatusBreakersEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for viewing status of the circuit breakers. The number of
+ entries is contained in the dm3StatusBreakersTableSize OID."
+ ::= { dm3StatusBreakers 2 }
+
+dm3StatusBreakersEntry OBJECT-TYPE
+ SYNTAX StatusBreakersEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The circuit breaker to gather status from."
+ INDEX { dm3StatusBreakersIndex }
+ ::= { dm3StatusBreakersTable 1 }
+
+StatusBreakersEntry ::=
+ SEQUENCE {
+ dm3StatusBreakersIndex INTEGER,
+ dm3StatusBreakersName DisplayString,
+ dm3StatusBreakersStatus INTEGER
+ }
+
+dm3StatusBreakersIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant circuit breaker."
+ ::= { dm3StatusBreakersEntry 1 }
+
+dm3StatusBreakersName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the circuit breaker. The maximum size is
+ 16 characters. The name is set by using the
+ dm3ConfigBreakersName OID.
+ This OID is provided for informational purposes only."
+ ::= { dm3StatusBreakersEntry 2 }
+
+dm3StatusBreakersStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusClosed (1),
+ statusOpen (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusClosed (1) if the circuit breaker is closed.
+ statusOpen (2) will be returned if the circuit breaker is open."
+ ::= { dm3StatusBreakersEntry 3 }
+
+-- the dm3StatusFuses group
+
+dm3StatusFusesTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant fuses controllable
+ by this IP address."
+ ::= { dm3StatusFuses 1 }
+
+dm3StatusFusesTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF StatusFusesEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for viewing status of the fuses. The number of
+ entries is contained in the dm3StatusFusesTableSize OID."
+ ::= { dm3StatusFuses 2 }
+
+dm3StatusFusesEntry OBJECT-TYPE
+ SYNTAX StatusFusesEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The fuse to gather status from."
+ INDEX { dm3StatusFusesIndex }
+ ::= { dm3StatusFusesTable 1 }
+
+StatusFusesEntry ::=
+ SEQUENCE {
+ dm3StatusFusesIndex INTEGER,
+ dm3StatusFusesName DisplayString,
+ dm3StatusFusesStatus INTEGER
+ }
+
+dm3StatusFusesIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant fuse."
+ ::= { dm3StatusFusesEntry 1 }
+
+dm3StatusFusesName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the fuse. The maximum size is
+ 16 characters. The name is set by using the
+ dm3ConfigFuseName OID.
+ This OID is provided for informational purposes only."
+ ::= { dm3StatusFusesEntry 2 }
+
+dm3StatusFusesStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusClosed (1),
+ statusOpen (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusClosed (1) if the fuse is closed.
+ statusOpen (2) will be returned if the fuse is open."
+ ::= { dm3StatusFusesEntry 3 }
+
+-- the atsIdent group
+
+atsIdentHardwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware version of the Automatic Transfer Switch.
+ This value is set at the factory."
+ ::= { atsIdent 1 }
+
+atsIdentFirmwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A string identifying the Automatic Transfer Switch
+ firmware version."
+ ::= { atsIdent 2 }
+
+atsIdentFirmwareDate OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date of release for this Automatic Transfer Switch
+ firmware version. "
+ ::= { atsIdent 3 }
+
+atsIdentDateOfManufacture OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date when the Automatic Transfer Switch was manufactured in mm/dd/yyyy format.
+ This value is set at the factory. "
+ ::= { atsIdent 4 }
+
+atsIdentModelNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A string identifying the model number of the Automatic Transfer Switch.
+ This value is set at the factory."
+ ::= { atsIdent 5 }
+
+atsIdentSerialNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A string identifying the serial number of
+ the Automatic Transfer Switch. This value is set at the factory."
+ ::= { atsIdent 6 }
+
+atsIdentNominalLineVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "RMS Utility Voltage measured in V."
+ ::= { atsIdent 7 }
+
+atsIdentNominalLineFrequency OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Utility Power Frequency measured in Hz."
+ ::= { atsIdent 8 }
+
+-- the atsCalibration group
+
+-- Input Voltage Calibration Factor table
+
+ atsCalibrationNumInputs OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of inputs to this device."
+ ::= { atsCalibrationInput 1 }
+
+ atsCalibrationNumInputPhases OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of phases per input for this device."
+ ::= { atsCalibrationInput 2 }
+
+ atsCalibrationInputTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ATSCalibrationInputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The number of phases per input line to this device."
+ ::= { atsCalibrationInput 3 }
+
+ atsCalibrationInputPhaseEntry OBJECT-TYPE
+ SYNTAX ATSCalibrationInputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing calibration information applicable to a
+ particular input phase."
+ INDEX { atsCalibrationInputTableIndex, atsCalibrationInputPhaseTableIndex }
+ ::= { atsCalibrationInputTable 1 }
+
+ ATSCalibrationInputPhaseEntry ::= SEQUENCE {
+ atsCalibrationInputTableIndex INTEGER,
+ atsCalibrationInputPhaseTableIndex INTEGER,
+ atsLineVoltageCalibrationFactor INTEGER
+ }
+
+ atsCalibrationInputTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input identifier."
+ ::= { atsCalibrationInputPhaseEntry 1 }
+
+ atsCalibrationInputPhaseTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input phase identifier."
+ ::= { atsCalibrationInputPhaseEntry 2 }
+
+ atsLineVoltageCalibrationFactor OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The Line Voltage Calibration factor.
+ This value is set at the factory."
+ ::= { atsCalibrationInputPhaseEntry 3 }
+
+-- Power Supply Voltage Calibration table
+
+ atsCalibrationPowerSupplyVoltages OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of power supply voltages supported by this device.
+ This variable indicates the number of rows in the
+ atsCalibrationPowerSupplyTable. There is one entry per
+ supported voltage: 24V, 12V and 5V"
+ ::= { atsCalibrationPowerSupply 1 }
+
+ atsCalibrationPowerSupplyVoltageTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ATSCalibrationPowerSupplyVoltageEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of Power Supply table entries."
+ ::= { atsCalibrationPowerSupply 2 }
+
+ atsCalibrationPowerSupplyVoltageEntry OBJECT-TYPE
+ SYNTAX ATSCalibrationPowerSupplyVoltageEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular Power Supply Voltage."
+ INDEX { atsCalibrationPowerSupplyVoltageTableIndex }
+ ::= { atsCalibrationPowerSupplyVoltageTable 1 }
+
+ ATSCalibrationPowerSupplyVoltageEntry ::= SEQUENCE {
+ atsCalibrationPowerSupplyVoltageTableIndex INTEGER,
+ atsCalibrationPowerSupplyVoltage INTEGER,
+ atsPowerSupplyVoltageCalibrationFactor INTEGER
+ }
+
+ atsCalibrationPowerSupplyVoltageTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The power supply voltage identifier.
+ Three power supply voltages are supported by the ATS:
+ 24V , 12V and 5V .
+ The value of this index indicates the power supply voltage:
+ 1 = 24V
+ 2 = 12V
+ 3 = 5V"
+ ::= { atsCalibrationPowerSupplyVoltageEntry 1 }
+
+ atsCalibrationPowerSupplyVoltage OBJECT-TYPE
+ SYNTAX INTEGER {
+ powerSupply24V(1),
+ powerSupply12V(2),
+ powerSupply(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This value describes the power supply voltage."
+ ::= { atsCalibrationPowerSupplyVoltageEntry 2 }
+
+ atsPowerSupplyVoltageCalibrationFactor OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The Line Voltage Calibration factor.
+ This value is set at the factory."
+ ::= { atsCalibrationPowerSupplyVoltageEntry 3 }
+
+-- Output Current Calibration table
+
+ atsCalibrationNumOutputs OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of output lines from this device.
+ This variable indicates the number of rows in the
+ atsCalibrationOutputTable."
+ ::= { atsCalibrationOutput 1 }
+
+ atsCalibrationNumOutputPhases OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of output phases utilized in this
+ device."
+ ::= { atsCalibrationOutput 2 }
+
+ atsCalibrationOutputTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ATSCalibrationOutputEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of output table entries."
+ ::= { atsCalibrationOutput 3 }
+
+ atsCalibrationOutputEntry OBJECT-TYPE
+ SYNTAX ATSCalibrationOutputEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular output."
+ INDEX { atsCalibrationOutputTableIndex, atsCalibrationOutputPhasesTableIndex }
+ ::= { atsCalibrationOutputTable 1 }
+
+ ATSCalibrationOutputEntry ::= SEQUENCE {
+ atsCalibrationOutputTableIndex INTEGER,
+ atsCalibrationOutputPhasesTableIndex INTEGER,
+ atsOutputCurrentCalibrationFactor INTEGER
+ }
+
+ atsCalibrationOutputTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output identifier."
+ ::= { atsCalibrationOutputEntry 1 }
+
+ atsCalibrationOutputPhasesTableIndex OBJECT-TYPE
+ SYNTAX INTEGER{
+ phase1(1),
+ phase2(2),
+ phase3(3),
+ neutral(4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Description of each calibration factor for each
+ output phase utilized in this device and one for neutral. "
+ ::= { atsCalibrationOutputEntry 2 }
+
+ atsOutputCurrentCalibrationFactor OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output current calibration factor measured in Amps."
+ ::= { atsCalibrationOutputEntry 3 }
+
+
+-- the atsControl group
+
+atsControlResetATS OBJECT-TYPE
+ SYNTAX INTEGER {
+ none(1),
+ reset(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this variable will cause the Automatic Transfer Switch to
+ perform a power-on reset."
+ ::= { atsControl 1 }
+
+atsControlClearAllAlarms OBJECT-TYPE
+ SYNTAX INTEGER {
+ none(1),
+ clear(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this variable will clear all alarms in the Automatic Transfer Switch."
+ ::= { atsControl 2 }
+
+-- the atsConfig group
+
+atsConfigProductName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A configurable character string."
+ ::= { atsConfig 1 }
+
+atsConfigPreferredSource OBJECT-TYPE
+ SYNTAX INTEGER {
+ sourceA(1),
+ sourceB(2),
+ none(3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This variable returns the preferred source of power when both sources are OK."
+ ::= { atsConfig 2 }
+
+atsConfigFrontPanelLockout OBJECT-TYPE
+ SYNTAX INTEGER {
+ disableFrontPanel(1),
+ enableFrontPanel(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Setting this variable to disableFrontPanel(1) will disallow source
+ preference configuration of the Automatic Transfer Switch via the
+ Front Panel. Once this value is set, it can only be re-enabled through
+ the serial interface of the ATS.
+ When this variable is set to enableFrontPanel(2), source preference
+ configuration of the Automatic Transfer Switch via the Front Panel
+ is allowed."
+ ::= { atsConfig 3 }
+
+atsConfigVoltageSensitivity OBJECT-TYPE
+ SYNTAX INTEGER {
+ high(1),
+ low(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This variable defines the sensitivity to changes in voltage:
+ high(1) for best protection, low(2) for frequent small line
+ voltage changes."
+ ::= { atsConfig 4 }
+
+atsConfigTransferVoltageRange OBJECT-TYPE
+ SYNTAX INTEGER {
+ wide(1),
+ medium(2),
+ narrow(3)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This variable defines the range of acceptable voltage from a power source.
+ If the voltage measured from the selected input source is not within this
+ range, the Automatic Transfer Switch will switch over (transfer) to the
+ alternate power source."
+
+ ::= { atsConfig 5 }
+
+atsConfigCurrentLimit OBJECT-TYPE
+ SYNTAX INTEGER (0..20)
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The threshold (in Amps) at which an Over Current Alarm will be generated."
+
+ ::= { atsConfig 6 }
+
+
+atsConfigResetValues OBJECT-TYPE
+ SYNTAX INTEGER {
+ none(1),
+ reset(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Resets the ATS configuration to its default values."
+
+ ::= { atsConfig 7 }
+
+-- the atsStatus group
+
+ atsStatusCommStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ atsNeverDiscovered(1),
+ atsCommEstablished(2),
+ atsCommLost(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This variable returns the current communication status
+ of the Automatic Transfer Switch. "
+ ::= { atsStatusDeviceStatus 1 }
+
+ atsStatusSelectedSource OBJECT-TYPE
+ SYNTAX INTEGER {
+ sourceA(1),
+ sourceB(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This variable returns the current source of power. "
+ ::= { atsStatusDeviceStatus 2 }
+
+ atsStatusRedundancyState OBJECT-TYPE
+ SYNTAX INTEGER {
+ atsRedundancyLost(1),
+ atsFullyRedundant(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This variable returns the current redundancy state of the ATS.
+ atsRedundancyLost(1) indicates that the ATS is unable to
+ switch over to the alternate power source if the current source fails.
+ atsFullyRedundant(2) indicates that the ATS will switch over to
+ the alternate power source if the current source fails."
+ ::= { atsStatusDeviceStatus 3 }
+
+ atsStatusOverCurrentState OBJECT-TYPE
+ SYNTAX INTEGER {
+ atsOverCurrent(1),
+ atsCurrentOK(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This variable returns the output current state of the ATS.
+ atsOverCurrent(1) indicates that the ATS has exceeded the output
+ current threshold and will not allow a switch over to the alternate power
+ source if the current source fails.
+ atsCurrentOK(2) indicates that the output current is below the
+ output current threshold."
+ ::= { atsStatusDeviceStatus 4 }
+
+ atsStatus5VPowerSupply OBJECT-TYPE
+ SYNTAX INTEGER {
+ atsPowerSupplyFailure(1),
+ atsPowerSupplyOK(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This variable returns the current state of the ATS 5-volt power supply.
+ atsPowerSupplyFailure(1) indicates the 5-volt power supply has failed
+ and that the ATS serial port Configuration Menu is not accessible .
+ atsPowerSupplyOK(2) indicates that the ATS 5-volt power supply
+ is operating within tolerance."
+ ::= { atsStatusDeviceStatus 5 }
+
+ atsStatus24VPowerSupply OBJECT-TYPE
+ SYNTAX INTEGER {
+ atsPowerSupplyFailure(1),
+ atsPowerSupplyOK(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This variable returns the current state of the ATS 24-volt power supply.
+ atsPowerSupplyFailure(1) indicates the 24-volt power supply has failed
+ and the ATS is unable to switch over to the alternate power source if
+ the current source fails.
+ atsPowerSupplyOK(2) indicates that the ATS 24-volt power supply
+ is operating within tolerance."
+ ::= { atsStatusDeviceStatus 6 }
+
+ atsStatusResetMaxMinValues OBJECT-TYPE
+ SYNTAX INTEGER {
+ none(1),
+ reset(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Resets the maximum and minimum ATS values:
+ atsInputMaxVoltage, atsInputMinVoltage,
+ atsInputMaxCurrent, atsInputMinCurrent,
+ atsInputMaxPower, atsInputMinPower,
+ atsOutputMaxCurrent, atsOutputMinCurrent,
+ atsOutputMaxLoad, atsOutputMinLoad,
+ atsOutputMaxPercentLoad, atsOutputMinPercentLoad,
+ atsOutputMaxPower, atsOutputMinPower,
+ atsOutputMaxPercentPower, atsOutputMinPercentPower.
+ These variables represent the maximum and minimum ATS values
+ since the last time they were read or reset by this OID.
+ Values unsupported by this ATS will return (-1)."
+ ::= { atsStatusResetValues 1 }
+
+--
+-- Input Group
+--
+
+-- Number of Inputs
+
+ atsNumInputs OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of input feeds to this device.
+ This variable indicates the number of rows in the
+ input table."
+ ::= { atsStatusInput 1 }
+
+-- Input Table
+
+ atsInputTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ATSPhaseInputEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of input table entries. The number of entries
+ is given by the value of atsNumInputs."
+ ::= { atsStatusInput 2 }
+
+ atsInputEntry OBJECT-TYPE
+ SYNTAX ATSPhaseInputEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular input."
+ INDEX { atsInputTableIndex }
+ ::= { atsInputTable 1 }
+
+ ATSPhaseInputEntry ::= SEQUENCE {
+ atsInputTableIndex INTEGER,
+ atsNumInputPhases INTEGER,
+ atsInputVoltageOrientation INTEGER,
+ atsInputFrequency INTEGER,
+ atsInputType INTEGER,
+ atsInputName DisplayString
+ }
+
+ atsInputTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input identifier."
+ ::= { atsInputEntry 1 }
+
+ atsNumInputPhases OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of input phases utilized in this
+ device. The sum of all the atsNumInputPhases
+ variable indicates the number of rows in the
+ input phase table."
+ ::= { atsInputEntry 2 }
+
+ atsInputVoltageOrientation OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown(1),
+ singlePhase(2),
+ splitPhase(3),
+ threePhasePhaseToNeutral(4),
+ threePhasePhaseToPhase(5)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input voltage orientation:
+ 1: unknown for this Source
+ 2: singlePhase - phase 1 voltage is between Phase 1
+ and Neutral.
+ 3: splitPhase - phase 1 voltage is between Phase 1 and
+ Neutral; phase 2 voltage is between Phase 2 and Neutral;
+ phase 3 voltage is between Phase 1 and Phase2.
+ 4: threePhasePhaseToNeutral - phase 1 voltage is between
+ Phase 1 and Neutral; phase 2 voltage is between Phase 2
+ and Neutral; phase 3 voltage is between Phase3 and
+ Neutral.
+ 5: threePhasePhaseToPhase - phase 1 voltage is between
+ Phase 1 and Phase 2; phase 2 voltage is between Phase 2
+ and Phase 3; phase 3 voltage is between Phase 3 and
+ Phase 1."
+ ::= { atsInputEntry 3 }
+
+ atsInputFrequency OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input frequency in Hertz, or -1 if it's unsupported
+ by this Source."
+ ::= { atsInputEntry 4 }
+
+ atsInputType OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown(1),
+ main(2),
+ bypass(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input type."
+ ::= { atsInputEntry 5 }
+
+ atsInputName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A name given to a particular input."
+ ::= { atsInputEntry 6 }
+
+-- Input Phase Table
+
+ atsInputPhaseTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ATSPhaseInputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of input table entries. The number of entries
+ is given by the sum of the atsNumInputPhases."
+ ::= { atsStatusInput 3 }
+
+ atsInputPhaseEntry OBJECT-TYPE
+ SYNTAX ATSPhaseInputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular input phase."
+ INDEX { atsInputPhaseTableIndex, atsInputPhaseIndex }
+ ::= { atsInputPhaseTable 1 }
+
+ ATSPhaseInputPhaseEntry ::= SEQUENCE {
+ atsInputPhaseTableIndex INTEGER,
+ atsInputPhaseIndex INTEGER,
+ atsInputVoltage INTEGER,
+ atsInputMaxVoltage INTEGER,
+ atsInputMinVoltage INTEGER,
+ atsInputCurrent INTEGER,
+ atsInputMaxCurrent INTEGER,
+ atsInputMinCurrent INTEGER,
+ atsInputPower INTEGER,
+ atsInputMaxPower INTEGER,
+ atsInputMinPower INTEGER
+ }
+
+ atsInputPhaseTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input identifier."
+ ::= { atsInputPhaseEntry 1 }
+
+ atsInputPhaseIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input phase identifier."
+ ::= { atsInputPhaseEntry 2 }
+
+ atsInputVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input voltage in VAC, or -1 if it's unsupported
+ by this Source."
+ ::= { atsInputPhaseEntry 3 }
+
+ atsInputMaxVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum input voltage in VAC measured
+ since the last time this variable was read
+ or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsInputPhaseEntry 4 }
+
+ atsInputMinVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum input voltage in VAC measured
+ since the last time this variable was read
+ or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsInputPhaseEntry 5 }
+
+ atsInputCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input current in amperes, or -1 if it's
+ unsupported by this Source."
+ ::= { atsInputPhaseEntry 6 }
+
+ atsInputMaxCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum input current in amperes measured
+ since the last time this variable was read
+ or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsInputPhaseEntry 7 }
+
+ atsInputMinCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum input current in amperes measured
+ since the last time this variable was read
+ or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsInputPhaseEntry 8 }
+
+ atsInputPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The input power in Watts, or -1 if it's unsupported
+ by this Source."
+ ::= { atsInputPhaseEntry 9 }
+
+ atsInputMaxPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum input power in Watts measured
+ since the last time this variable was read
+ or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsInputPhaseEntry 10 }
+
+ atsInputMinPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum input power in Watts measured
+ since the last time this variable was read
+ or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsInputPhaseEntry 11 }
+
+ --
+ -- The Output group.
+ --
+
+ -- Number of Outputs
+
+ atsNumOutputs OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of output feeds to this device.
+ This variable indicates the number of rows in the
+ output table."
+ ::= { atsStatusOutput 1 }
+
+ -- Output Table
+
+ atsOutputTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ATSPhaseOutputEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of output table entries. The number of entries
+ is given by the value of atsOutputNumPhases."
+ ::= { atsStatusOutput 2 }
+
+ atsOutputEntry OBJECT-TYPE
+ SYNTAX ATSPhaseOutputEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular output."
+ INDEX { atsOutputTableIndex }
+ ::= { atsOutputTable 1 }
+
+ ATSPhaseOutputEntry ::= SEQUENCE {
+ atsOutputTableIndex INTEGER,
+ atsNumOutputPhases INTEGER,
+ atsOutputVoltageOrientation INTEGER,
+ atsOutputFrequency INTEGER
+ }
+
+ atsOutputTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output identifier."
+ ::= { atsOutputEntry 1 }
+
+ atsNumOutputPhases OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of output phases utilized in this
+ device. The sum of all the atsNumOutputPhases
+ variable indicates the number of rows in the
+ output phase table."
+ ::= { atsOutputEntry 2 }
+
+ atsOutputVoltageOrientation OBJECT-TYPE
+ SYNTAX INTEGER {
+ unknown(1),
+ singlePhase(2),
+ splitPhase(3),
+ threePhasePhaseToNeutral(4),
+ threePhasePhaseToPhase(5)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output voltage orientation:
+ 1: unknown for this ATS
+ 2: singlePhase - phase 1 voltage is between Phase 1
+ and Neutral.
+ 3: splitPhase - phase 1 voltage is between Phase 1 and
+ Neutral; phase 2 voltage is between Phase 2 and Neutral;
+ phase 3 voltage is between Phase 1 and Phase2.
+ 4: threePhasePhaseToNeutral - phase 1 voltage is between
+ Phase 1 and Neutral; phase 2 voltage is between Phase 2
+ and Neutral; phase 3 voltage is between Phase3 and
+ Neutral.
+ 5: threePhasePhaseToPhase - phase 1 voltage is between
+ Phase 1 and Phase 2; phase 2 voltage is between Phase 2
+ and Phase 3; phase 3 voltage is between Phase 3 and
+ Phase 1."
+ ::= { atsOutputEntry 3 }
+
+ atsOutputFrequency OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output frequency in Hertz, or -1 if it's
+ unsupported by this ATS."
+ ::= { atsOutputEntry 4 }
+
+ -- Output Phase Table
+
+ atsOutputPhaseTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ATSPhaseOutputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of output table entries. The number of
+ entries is given by the sum of the atsNumOutputPhases."
+ ::= { atsStatusOutput 3 }
+
+ atsOutputPhaseEntry OBJECT-TYPE
+ SYNTAX ATSPhaseOutputPhaseEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "An entry containing information applicable to a
+ particular output phase."
+ INDEX { atsOutputPhaseTableIndex, atsOutputPhaseIndex }
+ ::= { atsOutputPhaseTable 1 }
+
+ ATSPhaseOutputPhaseEntry ::= SEQUENCE {
+ atsOutputPhaseTableIndex INTEGER,
+ atsOutputPhaseIndex INTEGER,
+ atsOutputVoltage INTEGER,
+ atsOutputCurrent INTEGER,
+ atsOutputMaxCurrent INTEGER,
+ atsOutputMinCurrent INTEGER,
+ atsOutputLoad INTEGER,
+ atsOutputMaxLoad INTEGER,
+ atsOutputMinLoad INTEGER,
+ atsOutputPercentLoad INTEGER,
+ atsOutputMaxPercentLoad INTEGER,
+ atsOutputMinPercentLoad INTEGER,
+ atsOutputPower INTEGER,
+ atsOutputMaxPower INTEGER,
+ atsOutputMinPower INTEGER,
+ atsOutputPercentPower INTEGER,
+ atsOutputMaxPercentPower INTEGER,
+ atsOutputMinPercentPower INTEGER
+ }
+
+ atsOutputPhaseTableIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output identifier."
+ ::= { atsOutputPhaseEntry 1 }
+
+ atsOutputPhaseIndex OBJECT-TYPE
+ SYNTAX INTEGER{
+ phase1(1),
+ phase2(2),
+ phase3(3),
+ neutral(4)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Description of each output phase utilized in
+ this device and one for neutral. "
+ ::= { atsOutputPhaseEntry 2 }
+
+ atsOutputVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output voltage in VAC, or -1 if it's unsupported
+ by this ATS."
+ ::= { atsOutputPhaseEntry 3 }
+
+ atsOutputCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output current in 0.1 amperes drawn
+ by the load on the ATS, or -1 if it's unsupported
+ by this ATS."
+ ::= { atsOutputPhaseEntry 4 }
+
+ atsOutputMaxCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum output current in 0.1 amperes measured
+ since the last time this variable was read
+ or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsOutputPhaseEntry 5 }
+
+ atsOutputMinCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum output current in 0.1 amperes measured
+ since the last time this variable was read
+ or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsOutputPhaseEntry 6 }
+
+ atsOutputLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output load in VA, or -1 if it's unsupported
+ by this ATS."
+ ::= { atsOutputPhaseEntry 7 }
+
+ atsOutputMaxLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum output load in VA measured
+ since the last time this variable was read
+ or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsOutputPhaseEntry 8 }
+
+ atsOutputMinLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum output load in VA measured
+ since the last time this variable was read
+ or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsOutputPhaseEntry 9 }
+
+ atsOutputPercentLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The percentage of the ATS load capacity in VA at
+ redundancy @ (n + x) presently being used on this
+ output phase, or -1 if it's unsupported by this ATS."
+ ::= { atsOutputPhaseEntry 10 }
+
+ atsOutputMaxPercentLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum percentage of the ATS load capacity in
+ VA measured at redundancy @ (n + x) presently
+ being used on this output phase since the last time
+ this variable was read or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsOutputPhaseEntry 11 }
+
+ atsOutputMinPercentLoad OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum percentage of the ATS load capacity in
+ VA measured at redundancy @ (n + x) presently
+ being used on this output phase since the last time
+ this variable was read or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsOutputPhaseEntry 12 }
+
+ atsOutputPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The output power in Watts, or -1 if it's
+ unsupported by this ATS."
+ ::= { atsOutputPhaseEntry 13 }
+
+ atsOutputMaxPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum output power in Watts measured
+ since the last time this variable was read
+ or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsOutputPhaseEntry 14 }
+
+ atsOutputMinPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum output power in Watts measured
+ since the last time this variable was read
+ or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsOutputPhaseEntry 15 }
+
+ atsOutputPercentPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The percentage of the ATSpower capacity in Watts at
+ redundancy @ (n + x) presently being used on this
+ output phase, or -1 if it's unsupported by this ATS."
+ ::= { atsOutputPhaseEntry 16 }
+
+ atsOutputMaxPercentPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The maximum percentage of the ATSpower capacity
+ in Watts measured at redundancy @ (n + x) presently
+ being used on this output phase since the last time
+ this variable was read or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsOutputPhaseEntry 17 }
+
+ atsOutputMinPercentPower OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The minimum percentage of the ATSpower capacity
+ in Watts measured at redundancy @ (n + x) presently
+ being used on this output phase since the last time
+ this variable was read or reset (atsStatusResetMaxMinValues).
+ Returns (-1) if unsupported."
+ ::= { atsOutputPhaseEntry 18 }
+
+-- the dcmim2IdentSystem group
+
+dcmim2IdentSysFWVersion OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Integer representation of the power plant Master Controller firmware revision."
+ ::= { dcmim2IdentSystem 1 }
+
+
+-- the dcmim2ControlSystem group
+
+dcmim2ControlRunFunctBatteryTest OBJECT-TYPE
+ SYNTAX INTEGER {
+ battTestOff (1),
+ battTestOn (2)
+}
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the battery functional test state. If
+ the test is off, the battTestOff (1) value will be returned.
+ If the test is on, the battTestOn (2) value will be
+ returned.
+
+ Setting this OID to battTestOff (1) will turn the battery functional test off.
+ Setting this OID to battTestOn (2) will turn the battery functional test on."
+
+ ::= { dcmim2ControlSystem 1 }
+
+dcmim2ControlRunCapacityBatteryTest OBJECT-TYPE
+ SYNTAX INTEGER {
+ battTestOff (1),
+ battTestOn (2)
+}
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return the battery capacity test state. If
+ the test is off, the battTestOff (1) value will be returned.
+ If the test is on, the battTestOn (2) value will be
+ returned.
+
+ Setting this OID to battTestOff (1) will turn the battery capacity test off.
+ Setting this OID to battTestOn (2) will turn the battery capacity test on."
+
+ ::= { dcmim2ControlSystem 2 }
+
+
+-- the dcmim2ConfigSystem group
+
+dcmim2ConfigSysHighTempTrip OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Trip level (threshold) at which System High Temp alarm condition is created.
+ Range 28 to 100 (degC).
+
+ Values are represented in thousandths of a degree.
+ Units are displayed in the scale shown in
+ the 'dcmim2StatusSysTempUnits' OID (Celsius or Fahrenheit)."
+
+
+ ::= { dcmim2ConfigSystem 1 }
+
+dcmim2ConfigSysHighTempReset OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Level at which System High Temp alarm condition is reset (cleared).
+ Range 25 to (upper temp - 3) (degC).
+
+ Values are represented in thousandths of a degree.
+ Units are displayed in the scale shown in
+ the 'dcmim2StatusSysTempUnits' OID (Celsius or Fahrenheit)."
+
+ ::= { dcmim2ConfigSystem 2 }
+
+dcmim2ConfigSysLowTempTrip OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Trip level (threshold) at which System Low Temp alarm condition is created.
+ Range -100 to 10 (degC).
+ Values are represented in thousandths of a degree.
+ Units are displayed in the scale shown in
+ the 'dcmim2StatusSysTempUnits' OID (Celsius or Fahrenheit)."
+
+ ::= { dcmim2ConfigSystem 3 }
+
+dcmim2ConfigSysLowTempReset OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Level at which System Low Temp alarm condition is reset (cleared).
+ Range (lower temp + 3) to 13 (degC).
+ Values are represented in thousandths of a degree.
+ Units are displayed in the scale shown in
+ the 'dcmim2StatusSysTempUnits' OID (Celsius or Fahrenheit)."
+
+ ::= { dcmim2ConfigSystem 4 }
+
+-- the dcmim2ConfigBattery group
+
+dcmim2ConfigBattFloatVolt OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Battery Float Voltage defined at 25 degrees Celsius.
+
+ Values are represented in thousandths of Volts (mV)."
+
+ ::= { dcmim2ConfigBattery 1 }
+
+dcmim2ConfigBattMaxRecharge OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Battery Maximum Recharge Rate. This is the maximum current used
+ during battery charging.
+
+ Values are represented in thousandths of Amps (mA)."
+
+ ::= { dcmim2ConfigBattery 2 }
+
+dcmim2ConfigBattMfgCapacity OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Battery capacity (Amp-Hour Size) as specified by the battery manufacturer.
+
+ Values are represented in thousandths of Amp hours (mAHr)."
+
+ ::= { dcmim2ConfigBattery 3 }
+
+dcmim2ConfigBattType OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Type of battery in the powerplant
+
+ Valid values range from 0 to 254."
+
+ ::= { dcmim2ConfigBattery 4 }
+
+dcmim2ConfigBattFunctTestDuration OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Duration of the battery functional test.
+
+ Values are represented in thousandths of seconds (mSecs)."
+
+ ::= { dcmim2ConfigBattery 5 }
+
+dcmim2ConfigBattFunctTestThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold the battery voltage of the system must remain above
+ in order to pass the battery functional test.
+
+ Values are represented in thousandths of Volts (mV)."
+
+ ::= { dcmim2ConfigBattery 6 }
+
+dcmim2ConfigBattCapacityTestPercent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Threshold for good battery capacity test results.
+
+ Values range from 0 to 100 percent."
+
+ ::= { dcmim2ConfigBattery 7 }
+
+dcmim2ConfigBattCapacityTestEndThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Safeguard voltage at which battery capacity test will end
+ if there is a battery problem.
+
+ Values are represented in thousandths of Volts (mV)."
+
+ ::= { dcmim2ConfigBattery 8 }
+
+dcmim2ConfigBattCapacityTestCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Constant current value used during battery capacity testing.
+
+ Values are represented in thousandths of Amps (mA)."
+
+ ::= { dcmim2ConfigBattery 9 }
+
+
+-- the dcmim2ConfigLVD group
+
+dcmim2ConfigLVDTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant LVDs controllable
+ by this IP address."
+ ::= { dcmim2ConfigLVD 1 }
+
+dcmim2ConfigLVDTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF DC2ConfigLVDEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for accessing settings of the LVDs. The number of
+ entries is contained in the dcmim2ConfigLVDTableSize OID."
+ ::= { dcmim2ConfigLVD 2 }
+
+dcmim2ConfigLVDEntry OBJECT-TYPE
+ SYNTAX DC2ConfigLVDEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The LVD to configure."
+ INDEX { dcmim2ConfigLVDIndex }
+ ::= { dcmim2ConfigLVDTable 1 }
+
+DC2ConfigLVDEntry ::=
+ SEQUENCE {
+ dcmim2ConfigLVDIndex INTEGER,
+ dcmim2ConfigLVDTrip INTEGER,
+ dcmim2ConfigLVDReset INTEGER,
+ dcmim2ConfigLVDState INTEGER
+ }
+
+dcmim2ConfigLVDIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant LVD."
+ ::= { dcmim2ConfigLVDEntry 1 }
+
+dcmim2ConfigLVDTrip OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "LVD Trip threshold. System bus voltage at which LVD will trip (open)
+ during a battery backup operation.
+
+ Values are represented in thousandths of Volts (mV)."
+ ::= { dcmim2ConfigLVDEntry 2 }
+
+dcmim2ConfigLVDReset OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "LVD Reset threshold. System bus voltage at which LVD will reset (close)
+ after AC power has been restored.
+
+ Values are represented in thousandths of Volts (mV)."
+ ::= { dcmim2ConfigLVDEntry 3 }
+
+dcmim2ConfigLVDState OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusClosed (1),
+ statusOpened (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusClosed (1) if the LVD is closed.
+ statusOpened (2) will be returned if the LVD is opened."
+ ::= { dcmim2ConfigLVDEntry 4 }
+
+
+-- the dcmim2StatusSystem group
+
+dcmim2StatusSysRectCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "System (Total Rectifier) current in thousandths of Amps (mA)."
+ ::= { dcmim2StatusSystem 1 }
+
+dcmim2StatusSysLoadCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Load current in thousandths of Amps (mA)."
+ ::= { dcmim2StatusSystem 2 }
+
+dcmim2StatusSysBusVoltage OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "System bus voltage in thousandths of Volts (mV)."
+ ::= { dcmim2StatusSystem 3 }
+
+dcmim2StatusSysAmbientTemp OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "System temperature based on sensor on Master Controller PCB.
+
+ Values are represented in thousandths of a degree.
+ Units are displayed in the scale shown in
+ the 'dcmim2StatusSysTempUnits' OID (Celsius or Fahrenheit)."
+ ::= { dcmim2StatusSystem 4 }
+
+dcmim2StatusSysUpTime OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Length of time since the DC Powerplant controller has been powered up."
+ ::= { dcmim2StatusSystem 5 }
+
+dcmim2StatusSysTempUnits OBJECT-TYPE
+ SYNTAX INTEGER {
+ celsius(1),
+ fahrenheit(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The temperature scale used to display the temperature
+ in the DC system, Celsius(1) or Fahrenheit(2).
+ This setting is based on the system preferences
+ configuration in the agent."
+ ::= { dcmim2StatusSystem 6 }
+
+
+-- the dcmim2StatusRectifier group
+
+dcmim2StatusRectTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant rectifiers viewable
+ by this IP address."
+ ::= { dcmim2StatusRectifier 1 }
+
+dcmim2StatusRectTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF DC2StatusRectEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for accessing settings of the rectifiers. The number of
+ entries is contained in the dcmim2StatusRectTableSize OID."
+ ::= { dcmim2StatusRectifier 2 }
+
+dcmim2StatusRectEntry OBJECT-TYPE
+ SYNTAX DC2StatusRectEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The rectifier to gather status from."
+ INDEX { dcmim2StatusRectIndex }
+ ::= { dcmim2StatusRectTable 1 }
+
+DC2StatusRectEntry ::=
+ SEQUENCE {
+ dcmim2StatusRectIndex INTEGER,
+ dcmim2StatusRectDevType INTEGER,
+ dcmim2StatusRectID INTEGER,
+ dcmim2StatusRectPhyAddr INTEGER,
+ dcmim2StatusRectFail INTEGER,
+ dcmim2StatusRectCurrent INTEGER
+ }
+
+dcmim2StatusRectIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant rectifier."
+ ::= { dcmim2StatusRectEntry 1 }
+
+dcmim2StatusRectDevType OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the rectifier device type."
+ ::= { dcmim2StatusRectEntry 2 }
+
+dcmim2StatusRectID OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the rectifier ID. This enumerates the number of the rectifier within
+ a group of rectifiers."
+ ::= { dcmim2StatusRectEntry 3 }
+
+dcmim2StatusRectPhyAddr OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the rectifier physical address (the address on the bus)."
+ ::= { dcmim2StatusRectEntry 4 }
+
+dcmim2StatusRectFail OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusTrue (1),
+ statusFalse (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusTrue (1) if the rectifier has failed.
+ statusFalse (2) will be returned if the rectifier has not failed."
+ ::= { dcmim2StatusRectEntry 5 }
+
+dcmim2StatusRectCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID shows the individual rectifier current in thousandths of Amps (mA)."
+ ::= { dcmim2StatusRectEntry 6 }
+
+
+-- the dcmim2StatusBattery group
+
+dcmim2StatusBattFloatVolt OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Battery Float Voltage represented in thousandths of Volts (mV)."
+ ::= { dcmim2StatusBattery 1 }
+
+dcmim2StatusBattCurrent OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Battery Current: This OID shows the battery current in thousandths of Amps (mA)."
+ ::= { dcmim2StatusBattery 2 }
+
+dcmim2StatusBattTemp OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Battery Temperature:
+
+ Values are represented in thousandths of a degree.
+ Units are displayed in the scale shown in
+ the 'dcmim2StatusSysTempUnits' OID (Celsius or Fahrenheit)."
+ ::= { dcmim2StatusBattery 3 }
+
+dcmim2StatusBattMfgCapacity OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Battery capacity (Amp-Hour Size) as specified by the battery manufacturer.
+ Values are represented in thousandths of Amp hours (mAHr)."
+ ::= { dcmim2StatusBattery 4 }
+
+dcmim2StatusBattTestCapacity OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Battery capacity (Amp-Hour Size) as determined by the battery capacity test.
+ Values are represented in thousandths of Amp hours (mAHr)."
+ ::= { dcmim2StatusBattery 5 }
+
+dcmim2StatusBattFunctTestResult OBJECT-TYPE
+ SYNTAX INTEGER{
+ functTestNotPerformed (1),
+ functTestInProcess (2),
+ functTestInterrupted (3),
+ functTestPass (4),
+ functTestFail (5)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Results of the last battery functional test that was run."
+ ::= { dcmim2StatusBattery 6 }
+
+dcmim2StatusBattCapacityTestResult OBJECT-TYPE
+ SYNTAX INTEGER{
+ capacityTestNotPerformed (1),
+ capacityTestInProcess (2),
+ capacityTestInterrupted (3),
+ capacityTestPass (4),
+ capacityTestFail (5)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Results of the last battery capacity test that was run."
+ ::= { dcmim2StatusBattery 7 }
+
+
+-- the dcmim2StatusLVD group
+
+dcmim2StatusLVDTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant LVDs accessible
+ by this IP address."
+ ::= { dcmim2StatusLVD 1 }
+
+dcmim2StatusLVDTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF DC2StatusLVDEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for accessing the LVDs. The number of
+ entries is contained in the dcmim2StatusLVDTableSize OID."
+ ::= { dcmim2StatusLVD 2 }
+
+dcmim2StatusLVDEntry OBJECT-TYPE
+ SYNTAX DC2StatusLVDEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The LVD to access."
+ INDEX { dcmim2StatusLVDIndex }
+ ::= { dcmim2StatusLVDTable 1 }
+
+DC2StatusLVDEntry ::=
+ SEQUENCE {
+ dcmim2StatusLVDIndex INTEGER,
+ dcmim2StatusLVDState INTEGER
+ }
+
+dcmim2StatusLVDIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the DC powerplant LVD."
+ ::= { dcmim2StatusLVDEntry 1 }
+
+dcmim2StatusLVDState OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusClosed (1),
+ statusOpened (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this OID will return statusClosed (1) if the LVD is closed.
+ statusOpened (2) will be returned if the LVD is opened."
+ ::= { dcmim2StatusLVDEntry 2 }
+
+
+-- the dcmim2StatusAlarms group
+
+dcmim2StatusAlarmsTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of DC powerplant alarms viewable
+ by this IP address."
+ ::= { dcmim2StatusAlarms 1 }
+
+dcmim2StatusAlarmsTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF DC2StatusAlarmsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for accessing system alarms. The number of
+ entries is contained in the dcmim2StatusAlarmsTableSize OID."
+ ::= { dcmim2StatusAlarms 2 }
+
+dcmim2StatusAlarmsEntry OBJECT-TYPE
+ SYNTAX DC2StatusAlarmsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The alarm to display."
+ INDEX { dcmim2StatusAlarmsIndex }
+ ::= { dcmim2StatusAlarmsTable 1 }
+
+DC2StatusAlarmsEntry ::=
+ SEQUENCE {
+ dcmim2StatusAlarmsIndex INTEGER,
+ dcmim2StatusAlarmsText DisplayString
+ }
+
+dcmim2StatusAlarmsIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of the system alarm."
+ ::= { dcmim2StatusAlarmsEntry 1 }
+
+dcmim2StatusAlarmsText OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The 16 character text describing the active alarm condition."
+ ::= { dcmim2StatusAlarmsEntry 2 }
+
+-- External Environmental Monitor
+
+emIdentFirmwareRevision OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The firmware revision of the Environmental Monitor."
+ ::= { emIdent 1 }
+
+emConfigProbesNumProbes OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of temperature and humidity probes available."
+ ::= { emConfig 1 }
+
+emConfigProbesTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EmConfigProbesEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of probes supported by the Environmental Monitor
+ and their configurations."
+ ::= { emConfig 2 }
+
+emConfigProbesEntry OBJECT-TYPE
+ SYNTAX EmConfigProbesEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The Environmental Monitor probe configurations."
+ INDEX { emConfigProbeNumber }
+ ::= { emConfigProbesTable 1 }
+
+EmConfigProbesEntry ::=
+ SEQUENCE {
+ emConfigProbeNumber
+ INTEGER,
+ emConfigProbeName
+ DisplayString,
+ emConfigProbeHighTempThreshold
+ INTEGER,
+ emConfigProbeLowTempThreshold
+ INTEGER,
+ emConfigProbeTempUnits
+ INTEGER,
+ emConfigProbeHighHumidThreshold
+ INTEGER,
+ emConfigProbeLowHumidThreshold
+ INTEGER,
+ emConfigProbeHighTempEnable
+ INTEGER,
+ emConfigProbeLowTempEnable
+ INTEGER,
+ emConfigProbeHighHumidEnable
+ INTEGER,
+ emConfigProbeLowHumidEnable
+ INTEGER
+ }
+
+emConfigProbeNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index into an Environmental Monitor probe entry."
+ ::= { emConfigProbesEntry 1 }
+
+emConfigProbeName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A descriptive name of the probe set by the user,
+ possibly denoting its location or purpose."
+ ::= { emConfigProbesEntry 2 }
+
+emConfigProbeHighTempThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The high temperature alarm threshold for the probe.
+ Units are displayed in the scale selected in
+ the 'emConfigProbeTempUnits' OID (Celsius or Fahrenheit)."
+ ::= { emConfigProbesEntry 3 }
+
+emConfigProbeLowTempThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The low temperature alarm threshold for the probe.
+ Units are displayed in the scale selected in
+ the 'emConfigProbeTempUnits' OID (Celsius or Fahrenheit)."
+ ::= { emConfigProbesEntry 4 }
+
+emConfigProbeTempUnits OBJECT-TYPE
+ SYNTAX INTEGER {
+ celsius(1),
+ fahrenheit(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The temperature scale used to display the temperature
+ thresholds of the probe, Celsius(1) or Fahrenheit(2).
+ This setting is based on the system preferences
+ configuration in the agent."
+ ::= { emConfigProbesEntry 5 }
+
+emConfigProbeHighHumidThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The high humidity alarm threshold for the probe in
+ percent relative humidity."
+ ::= { emConfigProbesEntry 6 }
+
+emConfigProbeLowHumidThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The low humidity alarm threshold for the probe in
+ percent relative humidity."
+ ::= { emConfigProbesEntry 7 }
+
+emConfigProbeHighTempEnable OBJECT-TYPE
+ SYNTAX INTEGER {
+ disabled(1),
+ enabled(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The high temperature alarm enable/disable for the
+ probe. No alarm will be generated if this value
+ is set to disabled(1). The alarm will be
+ generated if this value is set to enabled(2) and
+ the threshold has been violated."
+ ::= { emConfigProbesEntry 8 }
+
+emConfigProbeLowTempEnable OBJECT-TYPE
+ SYNTAX INTEGER {
+ disabled(1),
+ enabled(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The low temperature alarm enable/disable for the
+ probe. No alarm will be generated if this value
+ is set to disabled(1). The alarm will be
+ generated if this value is set to enabled(2) and
+ the threshold has been violated."
+ ::= { emConfigProbesEntry 9 }
+
+emConfigProbeHighHumidEnable OBJECT-TYPE
+ SYNTAX INTEGER {
+ disabled(1),
+ enabled(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The high humidity alarm enable/disable for the
+ probe. No alarm will be generated if this value
+ is set to disabled(1). The alarm will be
+ generated if this value is set to enabled(2) and
+ the threshold has been violated."
+ ::= { emConfigProbesEntry 10 }
+
+emConfigProbeLowHumidEnable OBJECT-TYPE
+ SYNTAX INTEGER {
+ disabled(1),
+ enabled(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The low humidity alarm enable/disable for the
+ probe. No alarm will be generated if this value
+ is set to disabled(1). The alarm will be
+ generated if this value is set to enabled(2) and
+ the threshold has been violated."
+ ::= { emConfigProbesEntry 11 }
+
+emConfigContactsNumContacts OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of contacts supported by the Environmental
+ Monitor."
+ ::= { emConfig 3 }
+
+emConfigContactsTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EmConfigContactsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of contacts supported by the Environmental Monitor
+ and their configurations."
+ ::= { emConfig 4 }
+
+emConfigContactsEntry OBJECT-TYPE
+ SYNTAX EmConfigContactsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The Environmental Monitor contact configurations."
+ INDEX { emConfigContactNumber }
+ ::= { emConfigContactsTable 1 }
+
+EmConfigContactsEntry ::=
+ SEQUENCE {
+ emConfigContactNumber
+ INTEGER,
+ emConfigContactName
+ DisplayString,
+ emConfigContactEnable
+ INTEGER
+ }
+
+emConfigContactNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of an Environmental Monitor contact."
+ ::= { emConfigContactsEntry 1 }
+
+emConfigContactName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A descriptive name for an Environmental Monitor
+ contact set by the user, possibly denoting its
+ location or purpose."
+ ::= { emConfigContactsEntry 2 }
+
+emConfigContactEnable OBJECT-TYPE
+ SYNTAX INTEGER {
+ disabled(1),
+ enabled(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "An Environmental Monitor contact alarm enable/disable.
+ No alarm will be generated if the contact is disabled(1).
+ An alarm will be generated if the contact is enabled(2)
+ and the contact has been faulted."
+ ::= { emConfigContactsEntry 3 }
+
+emStatusCommStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ noComm(1),
+ comm(2),
+ commLost(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The communication status between the agent
+ and the Environmental Monitor.
+
+ noComm(1), Communication has never been established.
+ comm(2), Communication has been established.
+ commLost(3), Communication was established, but was lost."
+ ::= { emStatus 1 }
+
+emStatusProbesNumProbes OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of available probes on the Environmental
+ Monitor."
+ ::= { emStatus 2 }
+
+emStatusProbesTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EmStatusProbesEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of probes supported by the Environmental Monitor
+ and their status."
+ ::= { emStatus 3 }
+
+emStatusProbesEntry OBJECT-TYPE
+ SYNTAX EmStatusProbesEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the probe."
+ INDEX { emStatusProbeNumber }
+ ::= { emStatusProbesTable 1 }
+
+EmStatusProbesEntry ::=
+ SEQUENCE {
+ emStatusProbeNumber
+ INTEGER,
+ emStatusProbeName
+ DisplayString,
+ emStatusProbeStatus
+ INTEGER,
+ emStatusProbeCurrentTemp
+ INTEGER,
+ emStatusProbeTempUnits
+ INTEGER,
+ emStatusProbeCurrentHumid
+ INTEGER,
+ emStatusProbeHighTempViolation
+ INTEGER,
+ emStatusProbeLowTempViolation
+ INTEGER,
+ emStatusProbeHighHumidViolation
+ INTEGER,
+ emStatusProbeLowHumidViolation
+ INTEGER
+ }
+
+emStatusProbeNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of the probe."
+ ::= { emStatusProbesEntry 1 }
+
+emStatusProbeName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A descriptive name for the probe set by the user,
+ possibly denoting its location or purpose."
+ ::= { emStatusProbesEntry 2 }
+
+emStatusProbeStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ disconnected(1),
+ connected(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The connected status of the probe, either
+ disconnected(1) or connected(2)."
+ ::= { emStatusProbesEntry 3 }
+
+emStatusProbeCurrentTemp OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current temperature reading from the probe displayed
+ in the units shown in the 'emStatusProbeTempUnits' OID
+ (Celsius or Fahrenheit)."
+ ::= { emStatusProbesEntry 4 }
+
+emStatusProbeTempUnits OBJECT-TYPE
+ SYNTAX INTEGER {
+ celsius(1),
+ fahrenheit(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The temperature scale used to display the temperature
+ thresholds of the probe, Celsius(1) or Fahrenheit(2).
+ This setting is based on the system preferences
+ configuration in the agent."
+ ::= { emStatusProbesEntry 5 }
+
+emStatusProbeCurrentHumid OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current humidity reading from the probe in
+ percent relative humidity."
+ ::= { emStatusProbesEntry 6 }
+
+emStatusProbeHighTempViolation OBJECT-TYPE
+ SYNTAX INTEGER {
+ noViolation(1),
+ highTempViolation(2),
+ disabled(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The high temperature violation status of the probe
+ temperature reading. This OID will show a highTempViolation(2)
+ if the current temperature reading shown in the
+ 'emStatusProbeCurrentTemp' OID is greater than or equal to
+ the high temperature threshold value, the
+ 'emConfigProbeHighTempThreshold' OID, and the value of the
+ 'emConfigProbeHighTempEnable' OID is enabled. Otherwise it will show
+ noViolation(1). If the 'emConfigProbeHighTempEnable' OID is disabled,
+ this OID will show disabled(3)."
+ ::= { emStatusProbesEntry 7 }
+
+emStatusProbeLowTempViolation OBJECT-TYPE
+ SYNTAX INTEGER {
+ noViolation(1),
+ lowTempViolation(2),
+ disabled(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The high temperature violation status of the probe
+ temperature reading. This OID will show a lowTempViolation(2)
+ if the current temperature reading shown in the
+ 'emStatusProbeCurrentTemp' OID is less than or equal to
+ the low temperature threshold value, the
+ 'emConfigProbeLowTempThreshold' OID, and the value of the
+ 'emConfigProbeLowTempEnable' OID is enabled. Otherwise it will show
+ noViolation(1). If the 'emConfigProbeLowTempEnable' OID is disabled,
+ this OID will show disabled(3)."
+ ::= { emStatusProbesEntry 8 }
+
+emStatusProbeHighHumidViolation OBJECT-TYPE
+ SYNTAX INTEGER {
+ noViolation(1),
+ highHumidViolation(2),
+ disabled(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The high humidity violation status of the probe humidity
+ reading. This OID will show a highTempViolation(2)
+ if the current humidity reading shown in the
+ 'emStatusProbeCurrentHumid' OID is greater than or equal to
+ the high humidity threshold value, the
+ 'emConfigProbeHighHumidThreshold' OID, and the value of the
+ 'emConfigProbeHighHumidEnable' OID is enabled. Otherwise it will
+ show noViolation(1). If the 'emConfigProbeHighHumidEnable' OID is
+ disabled, this OID will show disabled(3)"
+ ::= { emStatusProbesEntry 9 }
+
+emStatusProbeLowHumidViolation OBJECT-TYPE
+ SYNTAX INTEGER {
+ noViolation(1),
+ lowHumidViolation(2),
+ disabled(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The low humidity violation status of the probe humidity
+ reading. This OID will show a lowTempViolation(2)
+ if the current humidity reading shown in the
+ 'emStatusProbeCurrentHumid' OID is less than or equal to
+ the low humidity threshold value, the
+ 'emConfigProbeLowHumidThreshold' OID, and the value of the
+ 'emConfigProbeLowHumidEnable' OID is enabled. Otherwise it will
+ show noViolation(1). If the 'emConfigProbeLowHumidEnable' OID is
+ disabled, this OID will show disabled(3)."
+ ::= { emStatusProbesEntry 10 }
+
+emStatusContactsNumContacts OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of contacts supported by the
+ Environmental Monitor."
+ ::= { emStatus 4 }
+
+emStatusContactsTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EmStatusContactsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of contacts supported by the Environmental Monitor
+ and their status."
+ ::= { emStatus 5 }
+
+emStatusContactsEntry OBJECT-TYPE
+ SYNTAX EmStatusContactsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the contact."
+ INDEX { emStatusContactNumber }
+ ::= { emStatusContactsTable 1 }
+
+EmStatusContactsEntry ::=
+ SEQUENCE {
+ emStatusContactNumber
+ INTEGER,
+ emStatusContactName
+ DisplayString,
+ emStatusContactStatus
+ INTEGER
+ }
+
+emStatusContactNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of the Environmental Monitor contact."
+ ::= { emStatusContactsEntry 1 }
+
+emStatusContactName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A descriptive name for the Environmental Monitor contact
+ set by the user, possibly denoting its location or purpose."
+ ::= { emStatusContactsEntry 2 }
+
+emStatusContactStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ noFault(1),
+ fault(2),
+ disabled(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the Environmental Monitor contact. The status
+ will show noFault(1) if the contact is in the normal state
+ and the 'emConfigContactEnable' OID is enabled. The status will
+ show a fault(2) if the contact is faulted and the
+ 'emContactEnable' OID is enabled. If the 'emConfigContactEnable'
+ OID is disabled, the status will show disabled(3)."
+ ::= { emStatusContactsEntry 3 }
+
+-- Integrated Environmental Monitor (IEM)
+
+iemIdentHardwareRevision OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware revision of the Integrated Environmental
+ Monitor."
+ ::= { iemIdent 1 }
+
+iemConfigProbesNumProbes OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of temperature and humidity probes available."
+ ::= { iemConfig 1 }
+
+iemConfigProbesTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF IemConfigProbesEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of probes supported by the Environmental Monitor
+ and their configurations."
+ ::= { iemConfig 2 }
+
+iemConfigProbesEntry OBJECT-TYPE
+ SYNTAX IemConfigProbesEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The Environmental Monitor probe configurations."
+ INDEX { iemConfigProbeNumber }
+ ::= { iemConfigProbesTable 1 }
+
+IemConfigProbesEntry ::=
+ SEQUENCE {
+ iemConfigProbeNumber
+ INTEGER,
+ iemConfigProbeName
+ DisplayString,
+ iemConfigProbeHighTempThreshold
+ INTEGER,
+ iemConfigProbeLowTempThreshold
+ INTEGER,
+ iemConfigProbeTempUnits
+ INTEGER,
+ iemConfigProbeHighHumidThreshold
+ INTEGER,
+ iemConfigProbeLowHumidThreshold
+ INTEGER,
+ iemConfigProbeHighTempEnable
+ INTEGER,
+ iemConfigProbeLowTempEnable
+ INTEGER,
+ iemConfigProbeHighHumidEnable
+ INTEGER,
+ iemConfigProbeLowHumidEnable
+ INTEGER
+ }
+
+iemConfigProbeNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to a Environmental Monitor probe entry."
+ ::= { iemConfigProbesEntry 1 }
+
+iemConfigProbeName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A descriptive name for the probe set by the user,
+ possibly denoting its location or purpose."
+ ::= { iemConfigProbesEntry 2 }
+
+iemConfigProbeHighTempThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The high temperature alarm threshold for the probe.
+ Units are displayed in the scale selected in the
+ 'iemConfigProbeTempUnits' OID (Celsius or Fahrenheit)."
+ ::= { iemConfigProbesEntry 3 }
+
+iemConfigProbeLowTempThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The low temperature alarm threshold for the probe.
+ Units are displayed in the scale selected in the
+ 'iemConfigProbeTempUnits' OID (Celsius or Fahrenheit)."
+ ::= { iemConfigProbesEntry 4 }
+
+iemConfigProbeTempUnits OBJECT-TYPE
+ SYNTAX INTEGER {
+ celsius(1),
+ fahrenheit(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The temperature scale used to display the temperature
+ thresholds of the probe, Celsius(1) or Fahrenheit(2).
+ This setting is based on the system preferences
+ configuration in the agent."
+ ::= { iemConfigProbesEntry 5 }
+
+iemConfigProbeHighHumidThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The high humidity alarm threshold for the probe in
+ percent relative humidity."
+ ::= { iemConfigProbesEntry 6 }
+
+iemConfigProbeLowHumidThreshold OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The low humidity alarm threshold for the probe in
+ percent relative humidity."
+ ::= { iemConfigProbesEntry 7 }
+
+iemConfigProbeHighTempEnable OBJECT-TYPE
+ SYNTAX INTEGER {
+ disabled(1),
+ enabled(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The high temperature alarm enable/disable for the
+ probe. No alarm will be generated if this value
+ is set to disabled(1). The alarm will be
+ generated if this value is set to enabled(2) and
+ the threshold has been violated."
+ ::= { iemConfigProbesEntry 8 }
+
+iemConfigProbeLowTempEnable OBJECT-TYPE
+ SYNTAX INTEGER {
+ disabled(1),
+ enabled(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The low temperature alarm enable/disable for the
+ probe. No alarm will be generated if this value
+ is set to disabled(1). The alarm will be
+ generated if this value is set to enabled(2) and
+ the threshold has been violated."
+ ::= { iemConfigProbesEntry 9 }
+
+iemConfigProbeHighHumidEnable OBJECT-TYPE
+ SYNTAX INTEGER {
+ disabled(1),
+ enabled(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The high humidity alarm enable/disable for the
+ probe. No alarm will be generated if this value
+ is set to disabled(1). The alarm will be
+ generated if this value is set to enabled(2) and
+ the threshold has been violated."
+ ::= { iemConfigProbesEntry 10 }
+
+iemConfigProbeLowHumidEnable OBJECT-TYPE
+ SYNTAX INTEGER {
+ disabled(1),
+ enabled(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The low humidity alarm enable/disable for the
+ probe. No alarm will be generated if this value
+ is set to disabled(1). The alarm will be
+ generated if this value is set to enabled(2) and
+ the threshold has been violated."
+ ::= { iemConfigProbesEntry 11 }
+
+iemConfigContactsNumContacts OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of contacts available on the Environmental
+ Monitor."
+ ::= { iemConfig 3 }
+
+iemConfigContactsTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF IemConfigContactsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of contacts supported by the Environmental Monitor
+ and their configurations."
+ ::= { iemConfig 4 }
+
+iemConfigContactsEntry OBJECT-TYPE
+ SYNTAX IemConfigContactsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The Environmental Monitor contact configurations."
+ INDEX { iemConfigContactNumber }
+ ::= { iemConfigContactsTable 1 }
+
+IemConfigContactsEntry ::=
+ SEQUENCE {
+ iemConfigContactNumber
+ INTEGER,
+ iemConfigContactName
+ DisplayString,
+ iemConfigContactEnable
+ INTEGER
+ }
+
+iemConfigContactNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of an Environmental Monitor contact."
+ ::= { iemConfigContactsEntry 1 }
+
+iemConfigContactName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "A descriptive name for the Environmental Monitor contact
+ set by the user, possibly denoting its location or purpose."
+ ::= { iemConfigContactsEntry 2 }
+
+iemConfigContactEnable OBJECT-TYPE
+ SYNTAX INTEGER {
+ disabled(1),
+ enabled(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "An Environmental Monitor contact alarm enable/disable."
+ ::= { iemConfigContactsEntry 3 }
+
+
+iemStatusProbesNumProbes OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of available probes on the Environmental
+ Monitor."
+ ::= { iemStatus 1 }
+
+iemStatusProbesTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF IemStatusProbesEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of probes supported by the Environmental Monitor
+ and their status."
+ ::= { iemStatus 2 }
+
+iemStatusProbesEntry OBJECT-TYPE
+ SYNTAX IemStatusProbesEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the probe."
+ INDEX { iemStatusProbeNumber }
+ ::= { iemStatusProbesTable 1 }
+
+IemStatusProbesEntry ::=
+ SEQUENCE {
+ iemStatusProbeNumber
+ INTEGER,
+ iemStatusProbeName
+ DisplayString,
+ iemStatusProbeStatus
+ INTEGER,
+ iemStatusProbeCurrentTemp
+ INTEGER,
+ iemStatusProbeTempUnits
+ INTEGER,
+ iemStatusProbeCurrentHumid
+ INTEGER,
+ iemStatusProbeHighTempViolation
+ INTEGER,
+ iemStatusProbeLowTempViolation
+ INTEGER,
+ iemStatusProbeHighHumidViolation
+ INTEGER,
+ iemStatusProbeLowHumidViolation
+ INTEGER
+ }
+
+iemStatusProbeNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of the probe."
+ ::= { iemStatusProbesEntry 1 }
+
+iemStatusProbeName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A descriptive name for the probe set by the user,
+ denoting its location or purpose."
+ ::= { iemStatusProbesEntry 2 }
+
+iemStatusProbeStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ disconnected(1),
+ connected(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The connected status of the probe, either
+ disconnected(1) or connected(2)."
+ ::= { iemStatusProbesEntry 3 }
+
+iemStatusProbeCurrentTemp OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current temperature reading from the probe displayed
+ in the units shown in the 'iemStatusProbeTempUnits' OID
+ (Celsius or Fahrenheit)."
+ ::= { iemStatusProbesEntry 4 }
+
+iemStatusProbeTempUnits OBJECT-TYPE
+ SYNTAX INTEGER {
+ celsius(1),
+ fahrenheit(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The temperature scale used to display the temperature
+ thresholds of the probe, Celsius(1) or Fahrenheit(2).
+ This setting is based on the system preferences
+ configuration in the agent."
+ ::= { iemStatusProbesEntry 5 }
+
+iemStatusProbeCurrentHumid OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current humidity reading from the probe in percent
+ relative humidity."
+ ::= { iemStatusProbesEntry 6 }
+
+iemStatusProbeHighTempViolation OBJECT-TYPE
+ SYNTAX INTEGER {
+ noViolation(1),
+ highTempViolation(2),
+ disabled(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The high temperature violation status of the probe
+ temperature reading. This OID will show a highTempViolation(2)
+ if the current temperature reading shown in the
+ 'iemStatusProbeCurrentTemp' OID is greater than or equal to
+ the high temperature threshold value, the
+ 'iemConfigProbeHighTempThreshold' OID, and the value of the
+ 'iemConfigProbeHighTempEnable' OID is enabled. Otherwise it will show
+ noViolation(1). If the 'iemConfigProbeHighTempEnable' OID is disabled,
+ this OID will show disabled(3)."
+ ::= { iemStatusProbesEntry 7 }
+
+iemStatusProbeLowTempViolation OBJECT-TYPE
+ SYNTAX INTEGER {
+ noViolation(1),
+ lowTempViolation(2),
+ disabled(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The high temperature violation status of the probe
+ temperature reading. This OID will show a lowTempViolation(2)
+ if the current temperature reading shown in the
+ 'iemStatusProbeCurrentTemp' OID is less than or equal to
+ the low temperature threshold value, the
+ 'iemConfigProbeLowTempThreshold' OID, and the value of the
+ 'iemPConfigrobeLowTempEnable' OID is enabled. Otherwise it will show
+ noViolation(1). If the 'iemConfigProbeLowTempEnable' OID is disabled,
+ this OID will show disabled(3)."
+ ::= { iemStatusProbesEntry 8 }
+
+iemStatusProbeHighHumidViolation OBJECT-TYPE
+ SYNTAX INTEGER {
+ noViolation(1),
+ highHumidViolation(2),
+ disabled(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The high humidity violation status of the probe humidity
+ reading. This OID will show a highTempViolation(2)
+ if the current humidity reading shown in the
+ 'iemStatusProbeCurrentHumid' OID is greater than or equal to
+ the high humidity threshold value, the
+ 'iemConfigProbeHighHumidThreshold' OID, and the value of the
+ 'iemConfigProbeHighHumidEnable' OID is enabled. Otherwise it will
+ show noViolation(1). If the 'iemConfigProbeHighHumidEnable' OID is
+ disabled, this OID will show disabled(3)."
+ ::= { iemStatusProbesEntry 9 }
+
+iemStatusProbeLowHumidViolation OBJECT-TYPE
+ SYNTAX INTEGER {
+ noViolation(1),
+ lowHumidViolation(2),
+ disabled(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The low humidity violation status of the probe humidity
+ reading. This OID will show a lowTempViolation(2)
+ if the current humidity reading shown in the
+ 'iemStatusProbeCurrentHumid' OID is less than or equal to
+ the low humidity threshold value, the
+ 'iemConfigProbeLowHumidThreshold' OID, and the value of the
+ 'iemConfigProbeLowHumidEnable' OID is enabled. Otherwise it will
+ show noViolation(1). If the 'iemConfigProbeLowHumidEnable' OID is
+ disabled, this OID will show disabled(3)."
+ ::= { iemStatusProbesEntry 10 }
+
+iemStatusContactsNumContacts OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of contacts supported on the
+ Environmental Monitor."
+ ::= { iemStatus 3 }
+
+iemStatusContactsTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF IemStatusContactsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of contacts supported by the Environmental Monitor
+ and their status."
+ ::= { iemStatus 4 }
+
+iemStatusContactsEntry OBJECT-TYPE
+ SYNTAX IemStatusContactsEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the contact."
+ INDEX { iemStatusContactNumber }
+ ::= { iemStatusContactsTable 1 }
+
+IemStatusContactsEntry ::=
+ SEQUENCE {
+ iemStatusContactNumber
+ INTEGER,
+ iemStatusContactName
+ DisplayString,
+ iemStatusContactStatus
+ INTEGER
+ }
+
+iemStatusContactNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of the Environmental Monitor contact."
+ ::= { iemStatusContactsEntry 1 }
+
+iemStatusContactName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A descriptive name for the Environmental Monitor contact
+ set by the user, denoting its location or purpose."
+ ::= { iemStatusContactsEntry 2 }
+
+iemStatusContactStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ noFault(1),
+ fault(2),
+ disabled(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the Environmental Monitor contact. The status
+ will show noFault(1) if the contact is in the normal state
+ and the 'iemConfigContactEnable' OID is enabled. The status will
+ show a fault(2) if the contact is faulted and the
+ 'iemConfigContactEnable' OID is enabled. If the
+ 'iemConfigContactEnable' OID is disabled, the status will show
+ disabled(3)."
+ ::= { iemStatusContactsEntry 3 }
+
+iemStatusRelaysNumRelays OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of output relays supported on the
+ Environmental Monitor."
+ ::= { iemStatus 6 }
+
+iemStatusRelaysTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF IemStatusRelaysEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "A list of output relays supported by the
+ Environmental Monitor and their status."
+ ::= { iemStatus 7 }
+
+iemStatusRelaysEntry OBJECT-TYPE
+ SYNTAX IemStatusRelaysEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the relay."
+ INDEX { iemStatusRelayNumber }
+ ::= { iemStatusRelaysTable 1 }
+
+IemStatusRelaysEntry ::=
+ SEQUENCE {
+ iemStatusRelayNumber
+ INTEGER,
+ iemStatusRelayName
+ DisplayString,
+ iemStatusRelayStatus
+ INTEGER
+ }
+
+iemStatusRelayNumber OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of the output relay."
+ ::= { iemStatusRelaysEntry 1 }
+
+iemStatusRelayName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A descriptive name for the output relay set by the
+ user, denoting its location or purpose."
+ ::= { iemStatusRelaysEntry 2 }
+
+iemStatusRelayStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ faultState(1),
+ normalState(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the output relay, either faultState(1) or
+ normalState(2)."
+ ::= { iemStatusRelaysEntry 3 }
+
+-- Environmental Management System (EMS)
+
+-- EMS IDENT
+
+emsIdentEMSName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the
+ device. "
+ ::= { emsIdent 1 }
+
+emsIdentProductNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the model number of
+ the device. This value is set at the factory."
+ ::= { emsIdent 2 }
+
+emsIdentFirmwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The firmware revision of the device."
+ ::= { emsIdent 3 }
+
+emsIdentHardwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The hardware revision of the device.
+ This value is set at the factory."
+ ::= { emsIdent 4 }
+
+emsIdentDateOfManufacture OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The date when the device was manufactured in mm/dd/yyyy format.
+ This value is set at the factory. "
+ ::= { emsIdent 5 }
+
+emsIdentSerialNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the serial number of
+ the device. This value is set at the factory."
+ ::= { emsIdent 6 }
+
+-- EMS CONTROL
+
+-- EMS OUTPUT RELAY CONTROL STATUS TABLE
+
+emsOutputRelayControlTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF OutputRelayControlEMSEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for control of individual output relays. The number of
+ entries is contained in the emsStatusOutputRelayCount OID."
+ ::= { emsOutputRelayControl 1 }
+
+emsOutputRelayControlEntry OBJECT-TYPE
+ SYNTAX OutputRelayControlEMSEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The output relays to control."
+ INDEX { emsOutputRelayControlOutputRelayIndex }
+ ::= { emsOutputRelayControlTable 1 }
+
+OutputRelayControlEMSEntry ::=
+ SEQUENCE {
+ emsOutputRelayControlOutputRelayIndex INTEGER,
+ emsOutputRelayControlOutputRelayName DisplayString,
+ emsOutputRelayControlOutputRelayCommand INTEGER
+ }
+
+emsOutputRelayControlOutputRelayIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the output relay entry."
+ ::= { emsOutputRelayControlEntry 1 }
+
+emsOutputRelayControlOutputRelayName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the output relay.
+ This OID is provided for informational purposes only."
+ ::= { emsOutputRelayControlEntry 2 }
+
+emsOutputRelayControlOutputRelayCommand OBJECT-TYPE
+ SYNTAX INTEGER {
+ immediateCloseEMS (1),
+ immediateOpenEMS (2)
+ }
+
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the output relay state. If
+ the output relay is closed, the immediateCloseEMS (1) value will be returned.
+ If the output relay is open, the immediateOpenEMS (2) value will be
+ returned.
+
+ Setting this variable to immediateCloseEMS (1) will immediately close the relay.
+
+ Setting this variable to immediateOpenEMS (2) will immediately open the relay."
+ ::= { emsOutputRelayControlEntry 3 }
+
+-- EMS OUTLET CONTROL TABLE
+
+emsOutletControlTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF OutletControlEMSEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for control of individual outlet switches. The number of
+ entries is contained in the emsStatusOutletCount OID."
+ ::= { emsOutletControl 1 }
+
+emsOutletControlEntry OBJECT-TYPE
+ SYNTAX OutletControlEMSEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlets to control."
+ INDEX { emsOutletControlOutletIndex }
+ ::= { emsOutletControlTable 1 }
+
+OutletControlEMSEntry ::=
+ SEQUENCE {
+ emsOutletControlOutletIndex INTEGER,
+ emsOutletControlOutletName DisplayString,
+ emsOutletControlOutletCommand INTEGER
+ }
+
+emsOutletControlOutletIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { emsOutletControlEntry 1 }
+
+emsOutletControlOutletName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet.
+ This OID is provided for informational purposes only."
+ ::= { emsOutletControlEntry 2 }
+
+emsOutletControlOutletCommand OBJECT-TYPE
+ SYNTAX INTEGER {
+ immediateOnEMS (1),
+ immediateOffEMS (2)
+ }
+
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the outlet state. If
+ the outlet is on, the immediateOnEMS (1) value will be returned.
+ If the outlet is off, the immediateOffEMS (2) value will be
+ returned.
+
+ Setting this variable to immediateOnEMS (1) will immediately turn the outlet on.
+
+ Setting this variable to immediateOffEMS (2) will immediately turn the outlet off."
+ ::= { emsOutletControlEntry 3 }
+
+-- EMS SENSOR CONTROL TABLE
+
+emsSensorControlTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EMSSensorControlEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for control/reset of individual sensors. The number of
+ entries is contained in the emsStatusSensorCount OID."
+ ::= { emsSensorControl 1 }
+
+emsSensorControlEntry OBJECT-TYPE
+ SYNTAX EMSSensorControlEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The sensors to control/reset."
+ INDEX { emsSensorControlSensorIndex }
+ ::= { emsSensorControlTable 1 }
+
+EMSSensorControlEntry ::=
+ SEQUENCE {
+ emsSensorControlSensorIndex INTEGER,
+ emsSensorControlSensorSystemName DisplayString,
+ emsSensorControlSensorUserName DisplayString,
+ emsSensorControlSensorCommand INTEGER
+ }
+
+emsSensorControlSensorIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the sensor entry."
+ ::= { emsSensorControlEntry 1 }
+
+emsSensorControlSensorSystemName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system name of the sensor. This describes the hardware system
+ intent of this sensor."
+ ::= { emsSensorControlEntry 2 }
+
+emsSensorControlSensorUserName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the sensor as given by the system user."
+ ::= { emsSensorControlEntry 3 }
+
+emsSensorControlSensorCommand OBJECT-TYPE
+ SYNTAX INTEGER {
+ noCommandEMS (1),
+ resetCommandEMS (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return noCommandEMS(1).
+
+ Setting this variable to resetCommandEMS(2) will issue a reset command to the
+ sensor. Some sensors cannot be manually reset and will not be affected
+ by this command."
+ ::= { emsSensorControlEntry 4 }
+
+-- EMS ALARM DEVICE CONTROL TABLE
+
+emsAlarmDeviceControlTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF AlarmDeviceControlEMSEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for control of individual alarm devices.
+ Note: Some alarm devices are not controllable. The number of
+ entries is contained in the emsStatusAlarmDeviceCount OID."
+ ::= { emsAlarmDeviceControl 1 }
+
+emsAlarmDeviceControlEntry OBJECT-TYPE
+ SYNTAX AlarmDeviceControlEMSEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The alarm devices to control."
+ INDEX { emsAlarmDeviceControlDeviceIndex }
+ ::= { emsAlarmDeviceControlTable 1 }
+
+AlarmDeviceControlEMSEntry ::=
+ SEQUENCE {
+ emsAlarmDeviceControlDeviceIndex INTEGER,
+ emsAlarmDeviceControlDeviceName DisplayString,
+ emsAlarmDeviceControlDeviceCommand INTEGER
+ }
+
+emsAlarmDeviceControlDeviceIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the alarm device entry."
+ ::= { emsAlarmDeviceControlEntry 1 }
+
+emsAlarmDeviceControlDeviceName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the alarm device.
+ This OID is provided for informational purposes only."
+ ::= { emsAlarmDeviceControlEntry 2 }
+
+emsAlarmDeviceControlDeviceCommand OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmDeviceOnEMS (1),
+ alarmDeviceOffEMS (2),
+ alarmDeviceNotInstalledEMS (3)
+ }
+
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the device state. If
+ the device is active, the alarmDeviceOnEMS (1) value will be returned.
+ If the device is inactive, the alarmDeviceOffEMS (2) value will be
+ returned. If the device is not installed, the
+ alarmDeviceNotInstalledEMS (3) value will be returned.
+
+ Actions resulting from setting this variable are device-dependent.
+
+ Setting this variable to alarmDeviceOnEMS (1) will turn that device (ex. Beacon) on.
+ Setting this variable to alarmDeviceOffEMS (2) will turn that device off."
+
+ ::= { emsAlarmDeviceControlEntry 3 }
+
+
+-- EMS CONFIG
+
+emsConfigName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the device."
+ ::= { emsConfig 1 }
+
+emsConfigCheckLogLight OBJECT-TYPE
+ SYNTAX INTEGER {
+ lightDisabled (1),
+ lightOnInformational (2),
+ lightOnWarning (3),
+ lightOnSevere (4)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The setting of this OID determines the level of event that will
+ trigger the check-log light on the EMS. This is not available on the EMU2.
+
+ lightDisabled (1) disables the check-log light.
+ lightOnInformational (2) lights check-log for any event of
+ informational severity or above.
+ lightOnWarning (3) lights check-log for any event of
+ warning severity or above.
+ lightOnSevere (4) lights check-log for any event of severe severity."
+
+ ::= { emsConfig 2 }
+
+-- EMS PROBE CONFIG TABLE
+
+emsProbeConfigTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EMSProbeConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of individual probes. The number of
+ entries is contained in the emsStatusProbeCount OID."
+ ::= { emsProbeConfig 1 }
+
+emsProbeConfigEntry OBJECT-TYPE
+ SYNTAX EMSProbeConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The probes to configure."
+ INDEX { emsProbeConfigProbeIndex }
+ ::= { emsProbeConfigTable 1 }
+
+EMSProbeConfigEntry ::=
+ SEQUENCE {
+ emsProbeConfigProbeIndex INTEGER,
+ emsProbeConfigProbeName DisplayString,
+ emsProbeConfigProbeHighTempThresh INTEGER,
+ emsProbeConfigProbeLowTempThresh INTEGER,
+ emsProbeConfigProbeHighHumidityThresh INTEGER,
+ emsProbeConfigProbeLowHumidityThresh INTEGER,
+ emsProbeConfigProbeMaxTempThresh INTEGER,
+ emsProbeConfigProbeMinTempThresh INTEGER,
+ emsProbeConfigProbeDeltaTemp INTEGER,
+ emsProbeConfigProbeMaxHumidityThresh INTEGER,
+ emsProbeConfigProbeMinHumidityThresh INTEGER,
+ emsProbeConfigProbeDeltaHumidity INTEGER,
+ emsProbeConfigProbeSTIncTempVariance INTEGER,
+ emsProbeConfigProbeSTIncTempTime INTEGER,
+ emsProbeConfigProbeSTDecTempVariance INTEGER,
+ emsProbeConfigProbeSTDecTempTime INTEGER,
+ emsProbeConfigProbeLTIncTempVariance INTEGER,
+ emsProbeConfigProbeLTIncTempTime INTEGER,
+ emsProbeConfigProbeLTDecTempVariance INTEGER,
+ emsProbeConfigProbeLTDecTempTime INTEGER
+ }
+
+emsProbeConfigProbeIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the probe entry."
+ ::= { emsProbeConfigEntry 1 }
+
+emsProbeConfigProbeName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the probe."
+ ::= { emsProbeConfigEntry 2 }
+
+emsProbeConfigProbeHighTempThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe high temperature threshold.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the emsStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { emsProbeConfigEntry 3 }
+
+emsProbeConfigProbeLowTempThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe low temperature threshold.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the emsStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { emsProbeConfigEntry 4 }
+
+emsProbeConfigProbeHighHumidityThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe high humidity threshold.
+
+ Values are represented in whole number percentage."
+ ::= { emsProbeConfigEntry 5 }
+
+emsProbeConfigProbeLowHumidityThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe low humidity threshold.
+
+ Values are represented in whole number percentage."
+ ::= { emsProbeConfigEntry 6 }
+
+emsProbeConfigProbeMaxTempThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe maximum temperature threshold.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the emsStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { emsProbeConfigEntry 7 }
+
+emsProbeConfigProbeMinTempThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe minimum temperature threshold.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the emsStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { emsProbeConfigEntry 8 }
+
+emsProbeConfigProbeDeltaTemp OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe delta temperature.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the emsStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { emsProbeConfigEntry 9 }
+
+emsProbeConfigProbeMaxHumidityThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe maximum humidity threshold.
+
+ Values are represented in whole number percentage."
+ ::= { emsProbeConfigEntry 10 }
+
+emsProbeConfigProbeMinHumidityThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe minimum humidity threshold.
+
+ Values are represented in whole number percentage."
+ ::= { emsProbeConfigEntry 11 }
+
+emsProbeConfigProbeDeltaHumidity OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe delta humidity.
+
+ Values are represented in whole number percentage."
+ ::= { emsProbeConfigEntry 12 }
+
+emsProbeConfigProbeSTIncTempVariance OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe short-term increasing temperature variance used for rate of change alarms.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the emsStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { emsProbeConfigEntry 13 }
+
+emsProbeConfigProbeSTIncTempTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe short-term increasing temperature time used for rate of change alarms.
+
+ Values are represented in whole number minutes."
+ ::= { emsProbeConfigEntry 14 }
+
+emsProbeConfigProbeSTDecTempVariance OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe short-term decreasing temperature variance used for rate of change alarms.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the emsStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { emsProbeConfigEntry 15 }
+
+emsProbeConfigProbeSTDecTempTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe short-term decreasing temperature time used for rate of change alarms.
+
+ Values are represented in whole number minutes."
+ ::= { emsProbeConfigEntry 16 }
+
+emsProbeConfigProbeLTIncTempVariance OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe long-term increasing temperature variance used for rate of change alarms.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the emsStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { emsProbeConfigEntry 17 }
+
+emsProbeConfigProbeLTIncTempTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe long-term increasing temperature time used for rate of change alarms.
+
+ Values are represented in whole number hours."
+ ::= { emsProbeConfigEntry 18 }
+
+emsProbeConfigProbeLTDecTempVariance OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe long-term decreasing temperature variance used for rate of change alarms.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the emsStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { emsProbeConfigEntry 19 }
+
+emsProbeConfigProbeLTDecTempTime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Probe long-term decreasing temperature time used for rate of change alarms.
+
+ Values are represented in whole number hours."
+ ::= { emsProbeConfigEntry 20 }
+
+
+-- EMS INPUT CONTACT CONFIG STATUS TABLE
+
+emsInputContactConfigTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EMSInputContactConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of individual input contacts. The number of
+ entries is contained in the emsStatusInputContactCount OID."
+ ::= { emsInputContactConfig 1 }
+
+emsInputContactConfigEntry OBJECT-TYPE
+ SYNTAX EMSInputContactConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The input contacts to configure."
+ INDEX { emsInputContactConfigInputContactIndex }
+ ::= { emsInputContactConfigTable 1 }
+
+EMSInputContactConfigEntry ::=
+ SEQUENCE {
+ emsInputContactConfigInputContactIndex INTEGER,
+ emsInputContactConfigInputContactName DisplayString,
+ emsInputContactConfigInputContactNormalState INTEGER
+ }
+
+emsInputContactConfigInputContactIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the input contact entry."
+ ::= { emsInputContactConfigEntry 1 }
+
+emsInputContactConfigInputContactName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the input contact."
+ ::= { emsInputContactConfigEntry 2 }
+
+emsInputContactConfigInputContactNormalState OBJECT-TYPE
+ SYNTAX INTEGER {
+ normallyClosedEMS (1),
+ normallyOpenEMS (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the normal state of the input contact. If
+ the normal state is closed, the normallyClosedEMS (1) value will be returned.
+ If the normal state is closed, the normallyOpenEMS (2) value will be
+ returned.
+
+ Setting this variable will change the normal state of the input contact"
+ ::= { emsInputContactConfigEntry 3 }
+
+-- EMS OUTPUT RELAY CONFIG STATUS TABLE
+
+emsOutputRelayConfigTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EMSOutputRelayConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of individual output relays. The number of
+ entries is contained in the emsStatusOutputRelayCount OID."
+ ::= { emsOutputRelayConfig 1 }
+
+emsOutputRelayConfigEntry OBJECT-TYPE
+ SYNTAX EMSOutputRelayConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The output relays to configure."
+ INDEX { emsOutputRelayConfigOutputRelayIndex }
+ ::= { emsOutputRelayConfigTable 1 }
+
+EMSOutputRelayConfigEntry ::=
+ SEQUENCE {
+ emsOutputRelayConfigOutputRelayIndex INTEGER,
+ emsOutputRelayConfigOutputRelayName DisplayString,
+ emsOutputRelayConfigOutputRelayNormalState INTEGER
+ }
+
+emsOutputRelayConfigOutputRelayIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the output relay entry."
+ ::= { emsOutputRelayConfigEntry 1 }
+
+emsOutputRelayConfigOutputRelayName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the output relay."
+ ::= { emsOutputRelayConfigEntry 2 }
+
+emsOutputRelayConfigOutputRelayNormalState OBJECT-TYPE
+ SYNTAX INTEGER {
+ normallyClosedEMS (1),
+ normallyOpenEMS (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the normal state of the output relay. If
+ the normal state is closed, the normallyClosedEMS (1) value will be returned.
+ If the normal state is closed, the normallyOpenEMS (2) value will be
+ returned.
+
+ Setting this variable will change the normal state of the output relay"
+ ::= { emsOutputRelayConfigEntry 3 }
+
+-- EMS OUTLET CONFIG TABLE
+
+emsOutletConfigTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EMSOutletConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of individual outlets. The number of
+ entries is contained in the emsStatusOutletCount OID."
+ ::= { emsOutletConfig 1 }
+
+emsOutletConfigEntry OBJECT-TYPE
+ SYNTAX EMSOutletConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlets to configure."
+ INDEX { emsOutletConfigOutletIndex }
+ ::= { emsOutletConfigTable 1 }
+
+EMSOutletConfigEntry ::=
+ SEQUENCE {
+ emsOutletConfigOutletIndex INTEGER,
+ emsOutletConfigOutletName DisplayString,
+ emsOutletConfigOutletNormalState INTEGER
+ }
+
+emsOutletConfigOutletIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { emsOutletConfigEntry 1 }
+
+emsOutletConfigOutletName OBJECT-TYPE
+ SYNTAX DisplayString ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet."
+ ::= { emsOutletConfigEntry 2 }
+
+emsOutletConfigOutletNormalState OBJECT-TYPE
+ SYNTAX INTEGER {
+ normallyOnEMS (1),
+ normallyOffEMS (2)
+ }
+
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the normal state of the outlet. If
+ the normal state is on, the normallyOnEMS (1) value will be returned.
+ If the normal state is off, the normallyOffEMS (2) value will be
+ returned.
+
+ Setting this variable will change the normal state of the outlet"
+ ::= { emsOutletConfigEntry 3 }
+
+-- EMS SENSOR CONFIG TABLE
+
+emsSensorConfigTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EMSSensorConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of individual sensors. The number of
+ entries is contained in the emsStatusSensorCount OID."
+ ::= { emsSensorConfig 1 }
+
+emsSensorConfigEntry OBJECT-TYPE
+ SYNTAX EMSSensorConfigEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The sensors to configure."
+ INDEX { emsSensorConfigSensorIndex }
+ ::= { emsSensorConfigTable 1 }
+
+EMSSensorConfigEntry ::=
+ SEQUENCE {
+ emsSensorConfigSensorIndex INTEGER,
+ emsSensorConfigSensorSystemName DisplayString,
+ emsSensorConfigSensorUserName DisplayString,
+ emsSensorConfigSensorNormalState INTEGER,
+ emsSensorConfigSensorAlarmDelay INTEGER
+ }
+
+emsSensorConfigSensorIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the sensor entry."
+ ::= { emsSensorConfigEntry 1 }
+
+emsSensorConfigSensorSystemName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system name of the sensor. This describes the hardware system
+ intent of this sensor."
+ ::= { emsSensorConfigEntry 2 }
+
+emsSensorConfigSensorUserName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the sensor as given by the system user."
+ ::= { emsSensorConfigEntry 3 }
+
+emsSensorConfigSensorNormalState OBJECT-TYPE
+ SYNTAX INTEGER {
+ normallyClosedEMS (1),
+ normallyOpenEMS (2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the normal state of the sensor. If
+ the normal state is closed, the normallyClosedEMS (1) value will be returned.
+ If the normal state is closed, the normallyOpenEMS (2) value will be
+ returned.
+
+ Setting this variable will change the normal state of the sensor. Note:
+ Only the AUX sensor in the EMS has a configurable Normal State"
+ ::= { emsSensorConfigEntry 4 }
+
+emsSensorConfigSensorAlarmDelay OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The delay (in seconds) after a sensor detects an alarm condition before the
+ condition is reported."
+ ::= { emsSensorConfigEntry 5 }
+
+-- EMS STATUS
+--- EMS MASTER status
+
+emsStatusEMSName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the
+ device. "
+ ::= { emsStatus 1 }
+
+emsStatusCommStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ noComm(1),
+ comm(2),
+ commLost(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The communication status between the agent
+ and the device.
+
+ noComm(1), Communication has never been established.
+ comm(2), Communication has been established.
+ commLost(3), Communication was established, but was lost."
+ ::= { emsStatus 2 }
+
+emsStatusProbeCount OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The total number of T/H probes (both local and remote) that
+ is supported by this device."
+ ::= { emsStatus 3 }
+
+emsStatusInputContactCount OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The total number of Input Contacts that
+ is supported by this device."
+ ::= { emsStatus 4 }
+
+emsStatusOutputRelayCount OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The total number of Output Relays that
+ is supported by this device."
+ ::= { emsStatus 5 }
+
+emsStatusOutletCount OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The total number of AC Outlets that
+ is supported by this device."
+ ::= { emsStatus 6 }
+
+emsStatusSensorCount OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The total number of Sensors that
+ is supported by this device."
+ ::= { emsStatus 7 }
+
+emsStatusAlinkAruDeviceCount OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The total number of remote Aru's supported by this device."
+ ::= { emsStatus 8 }
+
+emsStatusAlinkProbeDeviceCount OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The total number of remote T/H probes supported by this device."
+ ::= { emsStatus 9 }
+
+emsStatusAlarmDeviceCount OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of alarm devices supported by this device."
+ ::= { emsStatus 10 }
+
+emsStatusSysTempUnits OBJECT-TYPE
+ SYNTAX INTEGER {
+ celsius(1),
+ fahrenheit(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The temperature scale used to display the temperature
+ in the system, Celsius(1) or Fahrenheit(2).
+ This setting is based on the system preferences
+ configuration in the agent."
+ ::= { emsStatus 11 }
+
+emsStatusCheckLogLight OBJECT-TYPE
+ SYNTAX INTEGER {
+ lightOff (1),
+ lightOn (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the check-log light on the device.
+ For the EMU2, this will always indicate lightOff(1).
+
+ lightOff (1) indicates the light is off (no new log entries).
+ lightOn (2) indicates the light is on (new log entries present)."
+
+ ::= { emsStatus 12 }
+
+emsStatusHardwareStatus OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the EMS hardware. This integer should be interpreted
+ as a bit map, with each bit representing the presence or absence of
+ a specific hardware error condition.
+
+ 0 indicates there are no error conditions detected in the EMS hardware.
+ 1 indicates a Current Limit error condition related to the Alink port.
+ 2 indicates incorrect hardware is plugged into an EMS port.
+ 3 indicates that both of these error conditions are present."
+
+ ::= { emsStatus 13 }
+
+-- EMS PROBE STATUS TABLE
+
+emsProbeStatusTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EMSProbeStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for access of individual probes. The number of
+ entries is contained in the emsStatusProbeCount OID."
+ ::= { emsProbeStatus 1 }
+
+emsProbeStatusEntry OBJECT-TYPE
+ SYNTAX EMSProbeStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The probes to access."
+ INDEX { emsProbeStatusProbeIndex }
+ ::= { emsProbeStatusTable 1 }
+
+EMSProbeStatusEntry ::=
+ SEQUENCE {
+ emsProbeStatusProbeIndex INTEGER,
+ emsProbeStatusProbeName DisplayString,
+ emsProbeStatusProbeTemperature INTEGER,
+ emsProbeStatusProbeHighTempThresh INTEGER,
+ emsProbeStatusProbeLowTempThresh INTEGER,
+ emsProbeStatusProbeHumidity INTEGER,
+ emsProbeStatusProbeHighHumidityThresh INTEGER,
+ emsProbeStatusProbeLowHumidityThresh INTEGER,
+ emsProbeStatusProbeSerialNumber DisplayString,
+ emsProbeStatusProbeCommStatus INTEGER,
+ emsProbeStatusProbeAlarmStatus INTEGER,
+ emsProbeStatusProbeMaxTempThresh INTEGER,
+ emsProbeStatusProbeMinTempThresh INTEGER,
+ emsProbeStatusProbeMaxHumidityThresh INTEGER,
+ emsProbeStatusProbeMinHumidityThresh INTEGER
+ }
+
+emsProbeStatusProbeIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the probe entry."
+ ::= { emsProbeStatusEntry 1 }
+
+emsProbeStatusProbeName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the probe."
+ ::= { emsProbeStatusEntry 2 }
+
+emsProbeStatusProbeTemperature OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Probe temperature reading.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the emsStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { emsProbeStatusEntry 3 }
+
+emsProbeStatusProbeHighTempThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Probe high temperature threshold.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the emsStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { emsProbeStatusEntry 4 }
+
+emsProbeStatusProbeLowTempThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Probe low temperature threshold.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the emsStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { emsProbeStatusEntry 5 }
+
+emsProbeStatusProbeHumidity OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Probe humidity reading.
+
+ Values are represented in whole number percentage."
+ ::= { emsProbeStatusEntry 6 }
+
+emsProbeStatusProbeHighHumidityThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Probe high humidity threshold.
+
+ Values are represented in whole number percentage."
+ ::= { emsProbeStatusEntry 7 }
+
+emsProbeStatusProbeLowHumidityThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Probe low humidity threshold.
+
+ Values are represented in whole number percentage."
+ ::= { emsProbeStatusEntry 8 }
+
+emsProbeStatusProbeSerialNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A label indicating the type (Local[L] or Remote[R]) and Number
+ of the probe. For example, the first local probe would be L1 and
+ the third remote probe would be R3."
+ ::= { emsProbeStatusEntry 9 }
+
+emsProbeStatusProbeCommStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ commsNeverDiscovered(1),
+ commsEstablished(2),
+ commsLost(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ " The state of communications to the probe.
+ commNeverDiscovered(1) indicates there has never been communications with this device.
+ commsEstablished(2) indicates communication is normal and active with this device.
+ commsLost(3) indicates communication had been established, but is no longer."
+ ::= { emsProbeStatusEntry 10 }
+
+emsProbeStatusProbeAlarmStatus OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The alarm status of the probe. This integer should be interpreted
+ as a bit map, with each bit representing the presence or absence of
+ the specific alarm conditions listed below. The bit will be '1' if
+ the condition is present, and '0' if the condition is not present.
+
+ Bit Hex. Value Description
+ 1 0x0001 Maximum temperature exceeded.
+ 2 0x0002 High temperature exceeded.
+ 3 0x0004 Low temperature exceeded.
+ 4 0x0008 Minimum temperature exceeded.
+ 5 0x0010 Short-term increasing temperature rate exceeded.
+ 6 0x0020 Short-term decreasing temperature rate exceeded.
+ 7 0x0040 Long-term increasing temperature rate exceeded.
+ 8 0x0080 Long-term decreasing temperature rate exceeded.
+ 9 0x0100 Maximum humidity exceeded.
+ 10 0x0200 High humidity exceeded.
+ 11 0x0400 Low humidity exceeded.
+ 12 0x0800 Minimum humidity exceeded."
+ ::= { emsProbeStatusEntry 11 }
+
+emsProbeStatusProbeMaxTempThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Probe maximum temperature threshold.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the emsStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { emsProbeStatusEntry 12 }
+
+emsProbeStatusProbeMinTempThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Probe minimum temperature threshold.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the emsStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { emsProbeStatusEntry 13 }
+
+emsProbeStatusProbeMaxHumidityThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Probe maximum humidity threshold.
+
+ Values are represented in whole number percentage."
+ ::= { emsProbeStatusEntry 14 }
+
+emsProbeStatusProbeMinHumidityThresh OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Probe minimum humidity threshold.
+
+ Values are represented in whole number percentage."
+ ::= { emsProbeStatusEntry 15 }
+
+
+-- EMS INPUT CONTACT STATUS TABLE
+
+emsInputContactStatusTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EMSInputContactStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for access of individual input contacts. The number of
+ entries is contained in the emsStatusInputContactCount OID."
+ ::= { emsInputContactStatus 1 }
+
+emsInputContactStatusEntry OBJECT-TYPE
+ SYNTAX EMSInputContactStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The input contacts to access."
+ INDEX { emsInputContactStatusInputContactIndex }
+ ::= { emsInputContactStatusTable 1 }
+
+EMSInputContactStatusEntry ::=
+ SEQUENCE {
+ emsInputContactStatusInputContactIndex INTEGER,
+ emsInputContactStatusInputContactName DisplayString,
+ emsInputContactStatusInputContactState INTEGER,
+ emsInputContactStatusInputContactNormalState INTEGER
+ }
+
+emsInputContactStatusInputContactIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the input contact entry."
+ ::= { emsInputContactStatusEntry 1 }
+
+emsInputContactStatusInputContactName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the input contact."
+ ::= { emsInputContactStatusEntry 2 }
+
+emsInputContactStatusInputContactState OBJECT-TYPE
+ SYNTAX INTEGER {
+ contactClosedEMS (1),
+ contactOpenEMS (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the state of the input contact. If
+ the input contact is closed, the contactClosedEMS (1) value will be returned.
+ If the input contact state is open, the contactOpenEMS (2) value will be
+ returned. "
+
+ ::= { emsInputContactStatusEntry 3 }
+
+emsInputContactStatusInputContactNormalState OBJECT-TYPE
+ SYNTAX INTEGER {
+ normallyClosedEMS (1),
+ normallyOpenEMS (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the normal state of the input contact. If
+ the normal state is closed, the normallyClosedEMS (1) value will be returned.
+ If the normal state is open, the normallyOpenEMS (2) value will be
+ returned. "
+
+ ::= { emsInputContactStatusEntry 4 }
+
+
+-- EMS OUTPUT RELAY STATUS TABLE
+
+emsOutputRelayStatusTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EMSOutputRelayStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for access of individual output relays. The number of
+ entries is contained in the emsStatusOutputRelayCount OID."
+ ::= { emsOutputRelayStatus 1 }
+
+emsOutputRelayStatusEntry OBJECT-TYPE
+ SYNTAX EMSOutputRelayStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The output relays to access."
+ INDEX { emsOutputRelayStatusOutputRelayIndex }
+ ::= { emsOutputRelayStatusTable 1 }
+
+EMSOutputRelayStatusEntry ::=
+ SEQUENCE {
+ emsOutputRelayStatusOutputRelayIndex INTEGER,
+ emsOutputRelayStatusOutputRelayName DisplayString,
+ emsOutputRelayStatusOutputRelayState INTEGER,
+ emsOutputRelayStatusOutputRelayNormalState INTEGER
+ }
+
+emsOutputRelayStatusOutputRelayIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the output relay entry."
+ ::= { emsOutputRelayStatusEntry 1 }
+
+emsOutputRelayStatusOutputRelayName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the output relay."
+ ::= { emsOutputRelayStatusEntry 2 }
+
+emsOutputRelayStatusOutputRelayState OBJECT-TYPE
+ SYNTAX INTEGER {
+ relayClosedEMS (1),
+ relayOpenEMS (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the state of the output relay. If
+ the output relay is closed, the relayClosedEMS (1) value will be returned.
+ If the output relay is open, the relayOpenEMS (2) value will be
+ returned. "
+
+ ::= { emsOutputRelayStatusEntry 3 }
+
+emsOutputRelayStatusOutputRelayNormalState OBJECT-TYPE
+ SYNTAX INTEGER {
+ normallyClosedEMS (1),
+ normallyOpenEMS (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the normal state of the output relay. If
+ the normal state is closed, the normallyClosedEMS (1) value will be returned.
+ If the normal state is open, the normallyOpenEMS (2) value will be
+ returned. "
+
+ ::= { emsOutputRelayStatusEntry 4 }
+
+-- EMS OUTLET STATUS TABLE
+
+emsOutletStatusTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EMSOutletStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for access of individual outlets. The number of
+ entries is contained in the emsStatusOutletCount OID."
+ ::= { emsOutletStatus 1 }
+
+emsOutletStatusEntry OBJECT-TYPE
+ SYNTAX EMSOutletStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The outlets to access."
+ INDEX { emsOutletStatusOutletIndex }
+ ::= { emsOutletStatusTable 1 }
+
+EMSOutletStatusEntry ::=
+ SEQUENCE {
+ emsOutletStatusOutletIndex INTEGER,
+ emsOutletStatusOutletName DisplayString,
+ emsOutletStatusOutletState INTEGER,
+ emsOutletStatusOutletNormalState INTEGER
+ }
+
+emsOutletStatusOutletIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the outlet entry."
+ ::= { emsOutletStatusEntry 1 }
+
+emsOutletStatusOutletName OBJECT-TYPE
+ SYNTAX DisplayString ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the outlet."
+ ::= { emsOutletStatusEntry 2 }
+
+emsOutletStatusOutletState OBJECT-TYPE
+ SYNTAX INTEGER {
+ outletOnEMS (1),
+ outletOffEMS (2)
+ }
+
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the state of the outlet. If
+ the outlet is on, the outletOnEMS (1) value will be returned.
+ If the outlet is off, the outletOffEMS (2) value will be
+ returned. "
+
+ ::= { emsOutletStatusEntry 3 }
+
+emsOutletStatusOutletNormalState OBJECT-TYPE
+ SYNTAX INTEGER {
+ normallyOnEMS (1),
+ normallyOffEMS (2)
+ }
+
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the normal state of the outlet. If
+ the normal state is on, the normallyOnEMS (1) value will be returned.
+ If the normal state is off, the normallyOffEMS (2) value will be
+ returned. "
+
+ ::= { emsOutletStatusEntry 4 }
+
+-- EMS ALARM DEVICE STATUS TABLE
+
+emsAlarmDeviceStatusTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EMSAlarmDeviceStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for access of individual alarm devices. The number of
+ entries is contained in the emsStatusAlarmDeviceCount OID."
+ ::= { emsAlarmDeviceStatus 1 }
+
+emsAlarmDeviceStatusEntry OBJECT-TYPE
+ SYNTAX EMSAlarmDeviceStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The alarm devices to access."
+ INDEX { emsAlarmDeviceStatusDeviceIndex }
+ ::= { emsAlarmDeviceStatusTable 1 }
+
+EMSAlarmDeviceStatusEntry ::=
+ SEQUENCE {
+ emsAlarmDeviceStatusDeviceIndex INTEGER,
+ emsAlarmDeviceStatusDeviceName DisplayString,
+ emsAlarmDeviceStatusDeviceState INTEGER
+ }
+
+emsAlarmDeviceStatusDeviceIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the alarm device entry."
+ ::= { emsAlarmDeviceStatusEntry 1 }
+
+emsAlarmDeviceStatusDeviceName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the alarm device.
+ This OID is provided for informational purposes only."
+ ::= { emsAlarmDeviceStatusEntry 2 }
+
+emsAlarmDeviceStatusDeviceState OBJECT-TYPE
+ SYNTAX INTEGER {
+ alarmDeviceOnEMS (1),
+ alarmDeviceOffEMS (2),
+ alarmDeviceNotInstalledEMS (3)
+ }
+
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the device state. If
+ the device is active, the alarmDeviceOnEMS (1) value will be returned.
+ If the device is inactive, the alarmDeviceOffEMS (2) value will be
+ returned. If the device is not installed, the
+ alarmDeviceNotInstalledEMS (3) value will be returned."
+
+ ::= { emsAlarmDeviceStatusEntry 3 }
+
+
+-- EMS SENSOR STATUS TABLE
+
+emsSensorStatusTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF EMSSensorStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for access of individual sensors. The number of
+ entries is contained in the emsStatusSensorCount OID."
+ ::= { emsSensorStatus 1 }
+
+emsSensorStatusEntry OBJECT-TYPE
+ SYNTAX EMSSensorStatusEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The sensors to access."
+ INDEX { emsSensorStatusSensorIndex }
+ ::= { emsSensorStatusTable 1 }
+
+EMSSensorStatusEntry ::=
+ SEQUENCE {
+ emsSensorStatusSensorIndex INTEGER,
+ emsSensorStatusSensorSystemName DisplayString,
+ emsSensorStatusSensorName DisplayString,
+ emsSensorStatusSensorState INTEGER,
+ emsSensorStatusSensorNormalState INTEGER,
+ emsSensorStatusSensorAlarmDelay INTEGER
+ }
+
+emsSensorStatusSensorIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the sensor entry."
+ ::= { emsSensorStatusEntry 1 }
+
+emsSensorStatusSensorSystemName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system name of the sensor. This describes the hardware system
+ intent of this sensor."
+ ::= { emsSensorStatusEntry 2 }
+
+emsSensorStatusSensorName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the sensor as given by the system user."
+ ::= { emsSensorStatusEntry 3 }
+
+emsSensorStatusSensorState OBJECT-TYPE
+ SYNTAX INTEGER {
+ sensorFaultedEMS (1),
+ sensorOKEMS (2),
+ sensorNotInstalledEMS (3)
+ }
+
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the sensor state. If the sensor is faulted,
+ the sensorFaultedEMS (1) value will be returned.
+ If the sensor is not faulted, the sensorOKEMS (2) value will be
+ returned. If the sensor is not installed, the sensorNotInstalledEMS (3)
+ value will be returned."
+ ::= { emsSensorStatusEntry 4 }
+
+emsSensorStatusSensorNormalState OBJECT-TYPE
+ SYNTAX INTEGER {
+ normallyClosedEMS (1),
+ normallyOpenEMS (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "Getting this variable will return the normal state of the sensor. If
+ the normal state is closed, the normallyClosedEMS (1) value will be returned.
+ If the normal state is closed, the normallyOpenEMS (2) value will be
+ returned."
+ ::= { emsSensorStatusEntry 5 }
+
+emsSensorStatusSensorAlarmDelay OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The delay (in seconds) after a sensor detects an alarm condition before the
+ condition is reported."
+ ::= { emsSensorStatusEntry 6 }
+
+
+
+-- airFM AIR CONDITIONER IDENT
+
+airFMIdentName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the
+ device. "
+ ::= { airFMIdent 1 }
+
+airFMIdentTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of entries in the airFMIdentTable. "
+ ::= { airFMIdent 2 }
+
+airFMIdentTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF AirFMIdentTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting identification information
+ from each module in the system. "
+ ::= { airFMIdent 3 }
+
+airFMIdentTableEntry OBJECT-TYPE
+ SYNTAX AirFMIdentTableEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The module to get information from."
+ INDEX { airFMIdentModuleIndex }
+ ::= { airFMIdentTable 1 }
+
+AirFMIdentTableEntry ::=
+ SEQUENCE {
+ airFMIdentModuleIndex INTEGER,
+ airFMIdentModuleModelNumber DisplayString,
+ airFMIdentModuleDateOfMfg DisplayString,
+ airFMIdentModuleSerialNumber DisplayString,
+ airFMIdentModuleFirmwareRev DisplayString,
+ airFMIdentModuleHardwareRev DisplayString
+ }
+
+airFMIdentModuleIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of the module information."
+ ::= { airFMIdentTableEntry 1 }
+
+airFMIdentModuleModelNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the
+ model number. "
+ ::= { airFMIdentTableEntry 2 }
+
+airFMIdentModuleDateOfMfg OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the
+ manufacture date. "
+ ::= { airFMIdentTableEntry 3 }
+
+airFMIdentModuleSerialNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the
+ unit serial number. "
+ ::= { airFMIdentTableEntry 4 }
+
+airFMIdentModuleFirmwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the
+ firmware revision. "
+ ::= { airFMIdentTableEntry 5 }
+
+airFMIdentModuleHardwareRev OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the
+ hardware revision. "
+ ::= { airFMIdentTableEntry 6 }
+
+-- airFM AIR CONDITIONER STATUS
+
+airFMStatusSystemOn OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusOn (1),
+ statusOff (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The operating state of the system. "
+ ::= { airFMStatus 1 }
+
+airFMStatusSystemAverageRetTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system average return air
+ temperature in tenths of degrees Celsius. "
+ ::= { airFMStatus 2 }
+
+airFMStatusSystemAverageRetTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system average return air
+ temperature in tenths of degrees Fahrenheit. "
+ ::= { airFMStatus 3 }
+
+airFMStatusSystemAverageRetHum OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system average return air
+ humidity. "
+ ::= { airFMStatus 4 }
+
+airFMStatusSystemActionTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system action air
+ temperature in tenths of degrees Celsius. "
+ ::= { airFMStatus 5 }
+
+airFMStatusSystemActionTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system action air
+ temperature in tenths of degrees Fahrenheit. "
+ ::= { airFMStatus 6 }
+
+airFMStatusSystemActionHum OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system action air humidity. "
+ ::= { airFMStatus 7 }
+
+airFMStatusSystemRemoteHighTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system remote high air
+ temperature in tenths of degrees Celsius. "
+ ::= { airFMStatus 8 }
+
+airFMStatusSystemRemoteHighTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system remote high air
+ temperature in tenths of degrees Fahrenheit. "
+ ::= { airFMStatus 9 }
+
+airFMStatusSystemRemoteAvgTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system remote average air
+ temperature in tenths of degrees Celsius. "
+ ::= { airFMStatus 10 }
+
+airFMStatusSystemRemoteAvgTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system remote average air
+ temperature in tenths of degrees Fahrenheit. "
+ ::= { airFMStatus 11 }
+
+airFMStatusSystemRemoteAvgHum OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system remote average air
+ humidity. "
+ ::= { airFMStatus 12 }
+
+airFMStatusSystemRemoteLowTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system remote low air
+ temperature in tenths of degrees Celsius. "
+ ::= { airFMStatus 13 }
+
+airFMStatusSystemRemoteLowTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The system remote low air
+ temperature in tenths of degrees Fahrenheit. "
+ ::= { airFMStatus 14 }
+
+airFMStatusSystemCoolingEnabled OBJECT-TYPE
+ SYNTAX INTEGER {
+ enabledYes (1),
+ enabledNo (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The state of the system cooling
+ function enable. "
+ ::= { airFMStatus 15 }
+
+airFMStatusSystemReheatingEnabled OBJECT-TYPE
+ SYNTAX INTEGER {
+ enabledYes (1),
+ enabledNo (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The state of the system reheating
+ function enable. "
+ ::= { airFMStatus 16 }
+
+airFMStatusSystemHumidifyEnabled OBJECT-TYPE
+ SYNTAX INTEGER {
+ enabledYes (1),
+ enabledNo (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The state of the system humidify
+ function enable. "
+ ::= { airFMStatus 17 }
+
+airFMStatusSystemDehumidifyEnabled OBJECT-TYPE
+ SYNTAX INTEGER {
+ enabledYes (1),
+ enabledNo (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The state of the system dehumidify
+ function enable. "
+ ::= { airFMStatus 18 }
+
+airFMStatusModuleTableSize OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of entries in the airFMStatusModuleTable. "
+ ::= { airFMStatus 19 }
+
+airFMStatusModuleTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF AirFMStatusModuleEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for getting information from each module
+ in the system. "
+ ::= { airFMStatus 20 }
+
+airFMStatusModuleEntry OBJECT-TYPE
+ SYNTAX AirFMStatusModuleEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The module to get status from."
+ INDEX { airFMStatusModuleIndex }
+ ::= { airFMStatusModuleTable 1 }
+
+AirFMStatusModuleEntry ::=
+ SEQUENCE {
+ airFMStatusModuleIndex INTEGER,
+ airFMStatusModuleOutputCapacity INTEGER,
+ airFMStatusModuleSupplyTempC INTEGER,
+ airFMStatusModuleSupplyTempF INTEGER,
+ airFMStatusModuleSupplyHum INTEGER,
+ airFMStatusModuleReturnTempC INTEGER,
+ airFMStatusModuleReturnTempF INTEGER,
+ airFMStatusModuleReturnHum INTEGER
+ }
+
+airFMStatusModuleIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index of the module information."
+ ::= { airFMStatusModuleEntry 1 }
+
+airFMStatusModuleOutputCapacity OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The module output capacity in kilowatts."
+ ::= { airFMStatusModuleEntry 2 }
+
+airFMStatusModuleSupplyTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The module supply air temperature in
+ tenths of degrees Celsius. "
+ ::= { airFMStatusModuleEntry 3 }
+
+airFMStatusModuleSupplyTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The module supply air temperature in
+ tenths of degrees Fahrenheit. "
+ ::= { airFMStatusModuleEntry 4 }
+
+airFMStatusModuleSupplyHum OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The module supply air humidity. "
+ ::= { airFMStatusModuleEntry 5 }
+
+airFMStatusModuleReturnTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The module return air temperature in
+ tenths of degrees Celsius. "
+ ::= { airFMStatusModuleEntry 6 }
+
+airFMStatusModuleReturnTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The module return air temperature in
+ tenths of degrees Fahrenheit. "
+ ::= { airFMStatusModuleEntry 7 }
+
+airFMStatusModuleReturnHum OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The module return air humidity. "
+ ::= { airFMStatusModuleEntry 8 }
+
+-- airFM AIR CONDITIONER GROUP DATA
+
+airFMGroupSysStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusOnLine (1),
+ statusIdle (2),
+ statusLoadShare (3),
+ statusOffLine (4),
+ statusFailed (5)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of this system within the group. "
+ ::= { airFMGroup 1 }
+
+airFMGroupSysRuntime OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The number of hours the system has been running. "
+ ::= { airFMGroup 2 }
+
+airFMGroupSysRole OBJECT-TYPE
+ SYNTAX INTEGER {
+ rolePrimary (1),
+ roleBackup (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The role of this system within the group. "
+ ::= { airFMGroup 3 }
+
+-- airPA Portable Air Conditioner Ident
+
+airPAIdentName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the device name. "
+ ::= { airPAIdent 1 }
+
+airPAModelNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the device model number. "
+ ::= { airPAIdent 2 }
+
+airPADateOfManufacture OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying when the device was produced. "
+ ::= { airPAIdent 3 }
+
+airPASerialNumber OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the device serial number. "
+ ::= { airPAIdent 4 }
+
+airPAFirmwareRevision OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the device firmware revision. "
+ ::= { airPAIdent 5 }
+
+airPAHardwareRevision OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the device hardware revision. "
+ ::= { airPAIdent 6 }
+
+-- airPA Portable Air Conditioner Status
+
+airPASystemPower OBJECT-TYPE
+ SYNTAX INTEGER {
+ powerON (1),
+ powerOFF (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The status of the unit's system power setting.
+
+ ON(1) The system power is turned on.
+ OFF(2) The system power is turned off. "
+ ::= { airPAStatus 1 }
+
+airPAOperatingMode OBJECT-TYPE
+ SYNTAX INTEGER {
+ modeOFF (1),
+ modeVENTING (2),
+ modeCOOLING (3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The current operating mode of the unit.
+
+ OFF(1) The system is off.
+ VENTING(2) The system's venting function is active.
+ COOLING(3) The system's cooling function is active. "
+ ::= { airPAStatus 2 }
+
+airPASetpointTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The temperature setpoint in Fahrenheit to which the unit is controlling. "
+ ::= { airPAStatus 3 }
+
+airPASetpointTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The temperature setpoint in Celsius to which the unity is controlling. "
+ ::= { airPAStatus 4 }
+
+airPABlowerSpeed OBJECT-TYPE
+ SYNTAX INTEGER {
+ speedLOW (1),
+ speedHIGH (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The unit's blower speed setting.
+
+ LOW(1) The blower speed is low.
+ HIGH(2) The blower speed is high. "
+ ::= { airPAStatus 5 }
+
+airPACompressor OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusON (1),
+ statusOFF (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The unit's compressor status.
+
+ ON(1) The compressor is turned on.
+ OFF(2) The compressor is turned off. "
+ ::= { airPAStatus 6 }
+
+airPACondenserFan OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusON (1),
+ statusOFF (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The unit's condenser fan status.
+
+ ON(1) The condenser fan is turned on.
+ OFF(2) The condenser fan is turned off. "
+ ::= { airPAStatus 7 }
+
+airPACondensatePump OBJECT-TYPE
+ SYNTAX INTEGER {
+ statusON (1),
+ statusOFF (2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The unit's condensate pump status.
+
+ ON(1) The condensate pump is turned on.
+ OFF(2) The condensate pump is turned off. "
+ ::= { airPAStatus 8 }
+
+airPASupplyTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The supply temperature in degrees Fahrenheit. "
+ ::= { airPAStatus 9 }
+
+airPASupplyTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The supply temperature in degrees Celsius. "
+ ::= { airPAStatus 10 }
+
+airPAReturnTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The return temperature in degrees Fahrenheit. "
+ ::= { airPAStatus 11 }
+
+airPAReturnTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The return temperature in degrees Celsius. "
+ ::= { airPAStatus 12 }
+
+airPARemoteTempF OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The remote temperature in degrees Fahrenheit. "
+ ::= { airPAStatus 13 }
+
+airPARemoteTempC OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The remote temperature in degrees Celsius. "
+ ::= { airPAStatus 14 }
+
+airPARemoteHumidity OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The remote humidity. "
+ ::= { airPAStatus 15 }
+
+-- RACK AIR REMOVAL UNIT IDENT
+
+rARUIdentTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF IdentRARUEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for query of the individual devices.
+ The number of entries is contained in the
+ rARUStatusAruDeviceCount OID."
+ ::= { rARUIdent 1 }
+
+rARUIdentEntry OBJECT-TYPE
+ SYNTAX IdentRARUEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The device to query."
+ INDEX { rARUIdentIndex}
+ ::= { rARUIdentTable 1 }
+
+IdentRARUEntry ::=
+ SEQUENCE {
+ rARUIdentIndex INTEGER,
+ rARUIdentName DisplayString
+ }
+
+rARUIdentIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the device entry."
+ ::= { rARUIdentEntry 1 }
+
+rARUIdentName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "A character string identifying the
+ device. "
+ ::= { rARUIdentEntry 2 }
+
+
+-- RACK AIR REMOVAL UNIT CONFIGURATION
+
+rARUConfigTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF ConfigRARUEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for configuration of individual ARUs. The number of
+ entries is contained in the rARUStatusAruDeviceCount OID."
+ ::= { rARUConfig 1 }
+
+rARUConfigEntry OBJECT-TYPE
+ SYNTAX ConfigRARUEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The ARUs to configure."
+ INDEX { rARUConfigAruIndex }
+ ::= { rARUConfigTable 1 }
+
+ConfigRARUEntry ::=
+ SEQUENCE {
+ rARUConfigAruIndex INTEGER,
+ rARUConfigAruName DisplayString,
+ rARUConfigAruRemoteSetpoint INTEGER,
+ rARUConfigAruTempOvrdEnableDisable INTEGER,
+ rARUConfigAruTempOvrdSetpoint INTEGER
+ }
+
+rARUConfigAruIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the device entry."
+ ::= { rARUConfigEntry 1 }
+
+rARUConfigAruName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the ARU."
+ ::= { rARUConfigEntry 2 }
+
+rARUConfigAruRemoteSetpoint OBJECT-TYPE
+ SYNTAX INTEGER {
+ aruOff (1),
+ aru85F-29C (2),
+ aru90F-32C (3),
+ aru95F-35C (4),
+ aru100F-38C (5),
+ aru7kW (6),
+ aru5kW (7),
+ aru3kW (8),
+ aru2kW (9)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This OID is the Remote setpoint of the ARU.
+ NOTE: -1 will be returned if the ARU is not communicating."
+
+ ::= { rARUConfigEntry 3 }
+
+rARUConfigAruTempOvrdEnableDisable OBJECT-TYPE
+ SYNTAX INTEGER {
+ disabled(1),
+ enabled(2)
+ }
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This OID is used to enable/disable the remote temperature override setting of the ARU.
+
+ If this OID is set to 1, the remote setting for temperature override is disabled.
+ If this OID is set to 2, the remote setting for temperature override is enabled."
+ ::= { rARUConfigEntry 4 }
+
+rARUConfigAruTempOvrdSetpoint OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-write
+ STATUS mandatory
+ DESCRIPTION
+ "This OID is the Temperature Override setpoint of the ARU.
+ NOTE: -1 will be returned if the ARU is not communicating."
+
+ ::= { rARUConfigEntry 5 }
+
+-- RACK AIR REMOVAL UNIT STATUS
+
+rARUStatusAruDeviceCount OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The total number of ARUs accessible from this IP."
+ ::= { rARUStatus 1 }
+
+rARUStatusSysTempUnits OBJECT-TYPE
+ SYNTAX INTEGER {
+ celsius(1),
+ fahrenheit(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The temperature scale used to display the temperature
+ in the system, Celsius(1) or Fahrenheit(2).
+ This setting is based on the system preferences
+ configuration in the agent."
+ ::= { rARUStatus 2 }
+
+rARUStatusTable OBJECT-TYPE
+ SYNTAX SEQUENCE OF StatusRARUEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "Allows for access of individual ARUs. The number of
+ entries is contained in the rARUStatusAruDeviceCount OID."
+ ::= { rARUStatus 3 }
+
+rARUStatusEntry OBJECT-TYPE
+ SYNTAX StatusRARUEntry
+ ACCESS not-accessible
+ STATUS mandatory
+ DESCRIPTION
+ "The ARUs to access."
+ INDEX { rARUStatusAruIndex }
+ ::= { rARUStatusTable 1 }
+
+StatusRARUEntry ::=
+ SEQUENCE {
+ rARUStatusAruIndex INTEGER,
+ rARUStatusAruName DisplayString,
+ rARUStatusAruRemoteSetpoint INTEGER,
+ rARUStatusAruManualSetpoint INTEGER,
+ rARUStatusAruTemp1 INTEGER,
+ rARUStatusAruTemp2 INTEGER,
+ rARUStatusAruTemp3 INTEGER,
+ rARUStatusAruTempOvrdEnableDisable INTEGER,
+ rARUStatusAruTempOvrdSetpoint INTEGER,
+ rARUStatusAruAlarmState DisplayString,
+ rARUStatusAruCommStatus INTEGER
+ }
+
+rARUStatusAruIndex OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The index to the ARU entry."
+ ::= { rARUStatusEntry 1 }
+
+rARUStatusAruName OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The name of the ARU."
+ ::= { rARUStatusEntry 2 }
+
+rARUStatusAruRemoteSetpoint OBJECT-TYPE
+ SYNTAX INTEGER {
+ aruOff (1),
+ aru85F-29C (2),
+ aru90F-32C (3),
+ aru95F-35C (4),
+ aru100F-38C (5),
+ aru7kW (6),
+ aru5kW (7),
+ aru3kW (8),
+ aru2kW (9)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "ARU remote setpoint temperature setting.
+
+ NOTE: -1 will be returned if the ARU is not communicating.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the rARUStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { rARUStatusEntry 3 }
+
+rARUStatusAruManualSetpoint OBJECT-TYPE
+ SYNTAX INTEGER {
+ aruOff (1),
+ aru85F-29C (2),
+ aru90F-32C (3),
+ aru95F-35C (4),
+ aru100F-38C (5),
+ aru7kW (6),
+ aru5kW (7),
+ aru3kW (8),
+ aru2kW (9),
+ aruRem (10)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "ARU manual setpoint temperature setting.
+
+ NOTE: -1 will be returned if the ARU is not communicating.
+
+ Values are represented in whole number degrees.
+ If the manual setpoint is set to Remote, this OID will return 0.
+ Units are displayed in the scale shown in
+ the rARUStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { rARUStatusEntry 4 }
+
+rARUStatusAruTemp1 OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "ARU temperature probe #1 reading.
+
+ NOTE: -1 will be returned if the ARU is not communicating.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the rARUStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { rARUStatusEntry 5 }
+
+rARUStatusAruTemp2 OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "ARU temperature probe #2 reading.
+
+ NOTE: -1 will be returned if the ARU is not communicating.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the rARUStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { rARUStatusEntry 6 }
+
+rARUStatusAruTemp3 OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "ARU temperature probe #3 reading.
+
+ NOTE: -1 will be returned if the ARU is not communicating.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the rARUStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { rARUStatusEntry 7 }
+
+rARUStatusAruTempOvrdEnableDisable OBJECT-TYPE
+ SYNTAX INTEGER {
+ disabled(1),
+ enabled(2)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "This OID indicates whether the ARU remote temperature override is enabled or disabled.
+ If this OID is a 1, the remote setting for temperature override is disabled.
+ If this OID is a 2, the remote setting for temperature override is enabled."
+ ::= { rARUStatusEntry 8 }
+
+rARUStatusAruTempOvrdSetpoint OBJECT-TYPE
+ SYNTAX INTEGER
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "ARU remote temperature override setpoint setting.
+
+ NOTE: -1 will be returned if the ARU is not communicating.
+
+ Values are represented in whole number degrees.
+ Units are displayed in the scale shown in
+ the rARUStatusSysTempUnits OID (Celsius or Fahrenheit)."
+ ::= { rARUStatusEntry 9 }
+
+rARUStatusAruAlarmState OBJECT-TYPE
+ SYNTAX DisplayString
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "An ASCII string containing the 8 flags representing
+ the current alarm state of the ARU. If the state of
+ the ARU is unknown, this variable is set to �UNKNOWN�.
+
+ The flags are numbered 1 to 8, read from left to
+ right. The flags are defined as follows:
+
+ Flag 1: Fan Fail 1
+ Flag 2: Fan Fail 2
+ Flag 3: Fan Fail 3
+ Flag 4: Smoke
+
+ Flag 5: High Temp (Out of Thermal Control)
+ Flag 6: Over Temp (Exhaust Temp. Exceeds Override Setpoint)
+ Flag 7: Reserved
+ Flag 8: Reserved"
+ ::= { rARUStatusEntry 10 }
+
+rARUStatusAruCommStatus OBJECT-TYPE
+ SYNTAX INTEGER {
+ commsNeverDiscovered(1),
+ commsEstablished(2),
+ commsLost(3)
+ }
+ ACCESS read-only
+ STATUS mandatory
+ DESCRIPTION
+ "The state of communications to the device.
+ commNeverDiscovered(1) indicates there has never been communications with this device.
+ commsEstablished(2) indicates communication is normal and active with this device.
+ commsLost(3) indicates communication had been established, but is no device."
+ ::= { rARUStatusEntry 11 }
+
+-- Traps
+-- Annotations are provided for Novell's NMS product
+--
+-- Each trap has at least one variable (mtrapargsString) which always appears
+-- as the last variable in the list. This variable contains either a static
+-- or dynamically-constructed string which provides an enhanced description of
+-- the trap's purpose and any pertinent information about the trap.
+
+communicationLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Communication to the UPS has been lost. Steps
+ to reestablish communication are in progress."
+ --#TYPE "APC UPS: Communication lost"
+ --#SUMMARY "Communication lost between the agent and the UPS."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 1
+
+upsOverload TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The UPS has sensed a load greater than 100 percent
+ of its rated capacity."
+ --#TYPE "APC UPS: Overload"
+ --#SUMMARY "The UPS has sensed a load greater than 100 percent of its rated capacity."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 2
+
+upsDiagnosticsFailed TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The UPS failed its internal diagnostic self-test."
+ --#TYPE "APC UPS: Failed self-test"
+ --#SUMMARY "The UPS has failed its internal self-test."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 3
+
+upsDischarged TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The UPS batteries are discharged; if utility power fails
+ an immediate low battery condition will exist. Sufficient runtime
+ for necessary action cannot be guaranteed."
+ --#TYPE "APC UPS: batteries are discharged"
+ --#SUMMARY "The UPS batteries are discharged."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 4
+
+upsOnBattery TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The UPS has switched to battery backup power."
+ --#TYPE "APC UPS: On battery"
+ --#SUMMARY "The UPS has switched to battery backup power."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 5
+
+smartBoostOn TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The UPS has enabled SmartBoost(TM)."
+ --#TYPE "APC UPS: SmartBoost(TM)"
+ --#SUMMARY "The UPS has enabled SmartBoost(TM); low incoming line voltage."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 6
+
+lowBattery TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The UPS batteries are low and will soon be exhausted.
+ If utility power is not restored the UPS will put itself
+ to 'sleep' and immediately cut power to the load."
+ --#TYPE "APC UPS: Low battery"
+ --#SUMMARY "The UPS system's batteries are low and will soon be exhausted."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 7
+
+communicationEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Communication with the UPS has been established."
+ --#TYPE "APC UPS: Communication established"
+ --#SUMMARY "UPS communication has been established."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 8
+
+powerRestored TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Utility power has been restored."
+ --#TYPE "APC UPS: Utility power restored"
+ --#SUMMARY "Returned from battery backup power; utility power restored."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 9
+
+upsDiagnosticsPassed TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The UPS passed its internal self-test."
+ --#TYPE "APC UPS: Passed self-test"
+ --#SUMMARY "The UPS passed internal self-test."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 10
+
+returnFromLowBattery TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The UPS has returned from a low battery
+ condition."
+ --#TYPE "APC UPS: Returned from Low-Battery condition"
+ --#SUMMARY "The UPS has returned from a Low-Battery condition."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 11
+
+upsTurnedOff TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The UPS has been turned 'off' by the management station."
+ --#TYPE "APC UPS: Turned off"
+ --#SUMMARY "The UPS has been switched off by a management station."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE NONOPERATIONAL
+ ::= 12
+
+upsSleeping TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The UPS is entering 'sleep' mode. Power
+ to the load will be cut off."
+ --#TYPE "APC UPS: Entered sleep mode"
+ --#SUMMARY "The UPS entered sleep mode. Power to the load will be cut off."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE NONOPERATIONAL
+ ::= 13
+
+upsWokeUp TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATION: The UPS has returned from 'sleep' mode. Power
+ to the load has been restored."
+ --#TYPE "APC UPS: Wake up"
+ --#SUMMARY "The UPS has returned from sleep mode. Power to the load has been restored."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 14
+
+upsRebootStarted TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The UPS has started its reboot sequence.
+ The UPS will reboot itself at this time."
+ --#TYPE "APC UPS: Starting reboot"
+ --#SUMMARY "The UPS has started its reboot sequence."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE NONOPERATIONAL
+ ::= 15
+
+upsDipSwitchChanged TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The dip switch settings on the UPS have been
+ changed, possibly altering UPS performance."
+ --#TYPE "APC UPS: DIP switch altered"
+ --#SUMMARY "The DIP switch settings on the UPS have been changed."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 16
+
+upsBatteryNeedsReplacement TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The batteries of the UPS need immediate replacement."
+ --#TYPE "APC UPS: UPS batteries need replacement"
+ --#SUMMARY "The UPS batteries require immediate replacement."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 17
+
+
+-- the Environmental Monitor traps
+
+contactFault TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: One of the contacts on the Environmental Monitor has
+ changed from its default position. The first variable is
+ the contact number that is faulted."
+ --#TYPE "APC Environment: Contact fault"
+ --#SUMMARY "An Environment contact closure has faulted."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 18
+
+contactFaultResolved TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A fault on one of the Environmental Monitor contacts
+ has been resolved. The first variable is
+ the contact number that has been resolved."
+ --#TYPE "APC Environment: Contact fault cleared."
+ --#SUMMARY "A Environment contact closure has returned to it's default state."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 19
+
+-- the Matrix-UPS traps
+
+hardwareFailureBypass TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: UPS on bypass due to internal fault"
+ --#TYPE "APC UPS: On bypass due to internal fault"
+ --#SUMMARY "The UPS is on bypass due to an internal fault."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 20
+
+softwareBypass TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: UPS on bypass - user set via software or panel"
+ --#TYPE "APC UPS: On bypass by user via software or panel"
+ --#SUMMARY "UPS put on bypass by user via software or front UPS panel."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 21
+
+switchedBypass TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: UPS on bypass - initiated by user"
+ --#TYPE "APC UPS: On bypass initiated by user"
+ --#SUMMARY "UPS put on bypass by user."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 22
+
+returnFromBypass TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: UPS has returned from bypass"
+ --#TYPE "APC UPS: UPS has returned from bypass"
+ --#SUMMARY "The UPS has returned from bypass mode."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 23
+
+bypassPowerSupplyFailure TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Base module bypass power supply needs repair"
+ --#TYPE "APC UPS: Base module bypass power supply needs repair"
+ --#SUMMARY "The base module bypass power supply needs repair."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE NONOPERATIONAL
+ ::= 24
+
+baseFanFailure TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Base module fan needs repair"
+ --#TYPE "APC UPS: Base module fan needs repair"
+ --#SUMMARY "The base module fan needs repair."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE NONOPERATIONAL
+ ::= 25
+
+batteryPackCommLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Check installation of external battery packs signal cable"
+ --#TYPE "APC UPS: Communication lost with battery packs"
+ --#SUMMARY "Communication lost with external battery packs, check battery signal cable."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 26
+
+batteryPackCommEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: UPS is communicating with the external battery packs."
+ --#TYPE "APC UPS: Communication established with battery packs"
+ --#SUMMARY "Communication established with external battery packs."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 27
+
+calibrationStart TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A battery calibration test has been initiated on the UPS."
+ --#TYPE "APC UPS: Calibration initiated"
+ --#SUMMARY "A battery run time calibration test has been initiated."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 28
+
+-- Misc. Traps
+
+restartAgent TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Agent restarting as commanded by manager."
+ --#TYPE "APC SNMP Agent: Agent restarting"
+ --#SUMMARY "Agent restarting as commanded by manager."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 29
+
+upsTurnedOn TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A UPS is turned on."
+ --#TYPE "APC UPS: A UPS is turned on."
+ --#SUMMARY " A UPS is turned on."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 30
+
+smartAvrReducing TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The UPS is reducing the line voltage via SmartTrim(TM)."
+ --#TYPE "APC UPS: SmartTrim(TM) reducing"
+ --#SUMMARY "The UPS has enabled SmartTrim(TM) voltage reduction."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 31
+
+codeAuthenticationDone TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mconfigTFTPServerIP, newCodeAuthentViaTFTP }
+ DESCRIPTION
+ "INFORMATIONAL: Authentication on agent code image is done."
+ --#TYPE "APC CODE: Authentication on agent code image is done."
+ --#SUMMARY "Authentication on agent code image is done."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 32
+
+upsOverloadCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The overload condition has been cleared."
+ --#TYPE "APC UPS: Overload cleared."
+ --#SUMMARY "The overload condition has been cleared. ."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 33
+
+smartBoostOff TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The UPS has returned from SmartBoost(TM)."
+ --#TYPE "APC UPS: SmartBoost(TM) off."
+ --#SUMMARY "The UPS has returned from SmartBoost(TM)."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 34
+
+smartAvrReducingOff TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The UPS has returned from SmartTrim(TM)."
+ --#TYPE "APC UPS: SmartTrim(TM) reducing off"
+ --#SUMMARY "The UPS has returned from SmartTrim(TM) voltage reduction."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 35
+
+upsBatteryReplaced TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A bad battery fault has been cleared."
+ --#TYPE "APC UPS: Bad battery replaced"
+ --#SUMMARY "The UPS has returned from a bad battery fault."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 36
+
+calibrationEnd TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The UPS has finished calibrating."
+ --#TYPE "APC UPS: Calibration end"
+ --#SUMMARY "The UPS has finished calibrating"
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 37
+
+dischargeCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A UPS discharge condition has been cleared."
+ --#TYPE "APC UPS: Discharge cleared."
+ --#SUMMARY "The UPS discharge condition has been cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 38
+
+gracefullShutdown TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A graceful shutdown has been initiated."
+ --#TYPE "APC UPS: A graceful shutdown has been initiated."
+ --#SUMMARY "A graceful shutdown has been initiated."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 39
+
+
+outletOn TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUOutletControlIndex }
+ DESCRIPTION
+ "WARNING: The specified PDU outlet has turned on.
+ If sPDUOutletControlIndex equals zero, then all outlets have
+ turned on."
+ --#TYPE "APC PDU: Outlet has been turned on."
+ --#SUMMARY "Outlet has been turned on"
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 41
+
+
+outletOff TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUOutletControlIndex }
+ DESCRIPTION
+ "WARNING: The specified PDU outlet has turned off.
+ If sPDUOutletControlIndex equals zero, then all outlets
+ have turned off."
+ --#TYPE "APC PDU: Outlet has turned off."
+ --#SUMMARY "Outlet has turned off."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 42
+
+outletReboot TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUOutletControlIndex }
+ DESCRIPTION
+ "WARNING: The specified PDU outlet has rebooted.
+ If sPDUOutletControlIndex equals zero, then all outlets
+ have rebooted."
+ --#TYPE "APC PDU: Outlet has rebooted."
+ --#SUMMARY "Outlet has rebooted."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 43
+
+configChangeSNMP TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The SNMP configuration has been changed."
+ --#TYPE "APC: The SNMP configuration has been changed."
+ --#SUMMARY "The SNMP configuration has been changed."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 44
+
+
+configChangeOutlet TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUOutletConfigIndex }
+ DESCRIPTION
+ "WARNING: The specified PDU outlet has changed configuration.
+ If sPDUOutletConfigIndex equals zero, then the Master outlet
+ has changed configuration."
+ --#TYPE "APC PDU: Outlet configuration has been changed."
+ --#SUMMARY "Outlet configuration has been changed."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 45
+
+accessViolationConsole TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: Someone has attempted to login via the console with the incorrect password."
+ --#TYPE "APC: Access violation via the console."
+ --#SUMMARY "Three unsuccessful logins have been attempted via the console."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 46
+
+accessViolationHTTP TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: Someone has attempted to login via HTTP with the incorrect password."
+ --#TYPE "APC: Access violation via HTTP."
+ --#SUMMARY "An unsuccessful attempt to login via HTTP."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 47
+
+passwordChange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The password for the device has been changed."
+ --#TYPE "APC: Password change for the device."
+ --#SUMMARY "Someone has changed the password on the device."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 48
+
+badVoltage TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The output voltage is not within acceptable range."
+ --#TYPE "APC UPS: Bad output voltage."
+ --#SUMMARY "The output voltage is not within acceptable range."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 49
+
+badVoltageCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The output voltage has returned to an acceptable level."
+ --#TYPE "APC UPS: The bad voltage output condition has been cleared."
+ --#SUMMARY "The output voltage has returned to an acceptable level."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 50
+
+chargerFailure TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The battery charger has failed."
+ --#TYPE "APC UPS: The battery charger has failed."
+ --#SUMMARY "The battery charger has failed."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 51
+
+chargerFailureCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The battery charger failure condition has been cleared."
+ --#TYPE "APC UPS: The battery charger failure condition cleared"
+ --#SUMMARY "The battery charger failure condition has been cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 52
+
+batteryOverTemperature TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The battery temperature threshold has been violated."
+ --#TYPE "APC UPS: The battery temperature threshold has been violated."
+ --#SUMMARY "The battery temperature threshold has been violated."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 53
+
+batteryOverTemperatureCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The battery over temperature has been cleared."
+ --#TYPE "APC UPS: The battery over temperature has been cleared."
+ --#SUMMARY "The battery over temperature has been cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 54
+
+ smartRelayFault TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: SmartBoost(TM) or SmartTrim(TM) relay fault."
+ --#TYPE "APC UPS: SmartBoost(TM) or SmartTrim(TM) relay fault."
+ --#SUMMARY "SmartBoost(TM) or SmartTrim(TM) relay fault."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 55
+
+smartRelayFaultCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: SmartBoost(TM) or SmartTrim(TM) relay fault has been cleared."
+ --#TYPE "APC UPS: SmartBoost(TM) or SmartTrim(TM) relay fault cleared."
+ --#SUMMARY "SmartBoost(TM) or SmartTrim(TM) relay fault has been cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 56
+
+humidityThresholdViolation1 TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Probe 1 humidity threshold violated. The
+ first variable is the current humidity."
+ --#TYPE "APC Environmental Monitor: Probe 1 humidity threshold violation"
+ --#SUMMARY "A humidity threshold has been violated on probe 1."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 57
+
+humidityThresholdViolationCleared1 TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An Environmental Monitor humidity threshold violation has been cleared on probe 1."
+ --#TYPE "APC Environmental Monitor: Probe 1 humidity violation cleared"
+ --#SUMMARY "A humidity threshold violation has been cleared on probe 1."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 58
+
+temperatureThresholdViolation1 TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: An Environmental Monitor temperature threshold has been violated on probe 1.
+ The first variable is the current temperature."
+ --#TYPE "APC Environmental Monitor: Probe 1 temperature violation"
+ --#SUMMARY "A temperature threshold has been violated on probe 1."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 59
+
+temperatureThresholdViolationCleared1 TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An Environmental Monitor temperature threshold violation has been cleared on probe 1."
+ --#TYPE "APC Environmental Monitor: Probe 1 temperature violation cleared"
+ --#SUMMARY "A temperature threshold violation has been cleared on probe 1."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 60
+
+humidityThresholdViolation2 TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: An Environmental Monitor humidity threshold has been violated on probe 2.
+ The first variable is the current humidity."
+ --#TYPE "APC Environmental Monitor: Probe 2 humidity violation"
+ --#SUMMARY "A humidity threshold has been violated on probe 2."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 61
+
+humidityThresholdViolationCleared2 TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An Environmental Monitor humidity threshold violation has been cleared on probe 2."
+ --#TYPE "APC Environmental Monitor: Probe 2 humidity violation cleared"
+ --#SUMMARY "A humidity threshold violation has been cleared on probe 2."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 62
+
+temperatureThresholdViolation2 TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: An Environmental Monitor temperature threshold has been violated on probe 2.
+ The first variable is the current temperature."
+ --#TYPE "APC Environmental Monitor: Probe 2 temperature violation"
+ --#SUMMARY "A temperature threshold has been violated on probe 2."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 63
+
+temperatureThresholdViolationCleared2 TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An Environmental Monitor temperature threshold violation has been cleared on probe 2."
+ --#TYPE "APC Environmental Monitor: Probe 2 temperature violation cleared"
+ --#SUMMARY "A temperature threshold violation has been cleared on probe 2."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 64
+
+mupsCommunicationEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Communication with the Environmental Monitor has been established."
+ --#TYPE "APC Environmental Monitor: Communication established"
+ --#SUMMARY "Communication established between the agent and the Environmental Monitor."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 65
+
+mupsCommunicationLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Communication to the Environmental Monitor has been lost. Steps
+ to reestablish communication are in progress."
+ --#TYPE "APC Environmental Monitor: Communication failure"
+ --#SUMMARY "Communication lost between the agent and the Environmental Monitor."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 66
+
+batteryIncrease TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The number of batteries has increased."
+ --#TYPE "APC UPS: The number of batteries has increased."
+ --#SUMMARY "The number of batteries has increased."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 67
+
+batteryDecrease TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The number of batteries has decreased."
+ --#TYPE "APC UPS: The number of batteries has decreased."
+ --#SUMMARY "The number of batteries has decreased."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 68
+
+powerModuleIncrease TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The number of power modules has increased."
+ --#TYPE "APC UPS: The number of power modules has increased."
+ --#SUMMARY "The number of power modules has increased."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 69
+
+powerModuleDecrease TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The number of power modules has decreased."
+ --#TYPE "APC UPS: The number of power modules has decreased."
+ --#SUMMARY "The number of power modules has decreased."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 70
+
+intelligenceModuleInserted TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An intelligence module has been inserted."
+ --#TYPE "APC UPS: An intelligence module has been inserted."
+ --#SUMMARY "An intelligence module has been inserted."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 71
+
+intelligenceModuleRemoved TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An intelligence module has been removed."
+ --#TYPE "APC UPS: An intelligence module has been removed."
+ --#SUMMARY "An intelligence module has been removed."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 72
+
+rintelligenceModuleInserted TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A redundant intelligence module has been inserted."
+ --#TYPE "APC UPS: A redundant intelligence module has been inserted."
+ --#SUMMARY "A redundant intelligence module has been inserted."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 73
+
+rintelligenceModuleRemoved TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A redundant intelligence module has been removed."
+ --#TYPE "APC UPS: A redundant intelligence module has been removed."
+ --#SUMMARY "A redundant intelligence module has been removed."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 74
+
+extBatteryFrameIncease TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An external battery frame has been added."
+ --#TYPE "APC UPS: An external battery frame has been added."
+ --#SUMMARY "An external battery frame has been added."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 75
+
+extBatteryFrameDecrease TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An external battery frame has been removed."
+ --#TYPE "APC UPS: An external battery frame has been removed."
+ --#SUMMARY "An external battery frame has been removed."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 76
+
+abnormalCondition TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: An abnormal condition has been detected.
+ The first variable is the fault condition."
+ --#TYPE "APC: An abnormal condition has been detected."
+ --#SUMMARY "An abnormal condition has been detected."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 77
+
+abnormalConditionCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An abnormal condition has been cleared.
+ The first variable is the fault condition."
+ --#TYPE "APC: An abnormal condition has been cleared."
+ --#SUMMARY "An abnormal condition has been cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 78
+
+deviceStatusChange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString}
+ DESCRIPTION
+ "INFORMATIONAL: The status of the device being monitored has changed."
+ --#TYPE "APC : The status of the device being monitored has changed."
+ --#SUMMARY "The status of the device being monitored has changed."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 79
+
+noBatteries TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The UPS has no batteries attached."
+ --#TYPE "APC UPS: No batteries attached."
+ --#SUMMARY "The UPS has no batteries attached."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 80
+
+noBatteriesCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The UPS's batteries have been attached."
+ --#TYPE "APC UPS: The no batteries attached condition has been cleared."
+ --#SUMMARY "The UPS's batteries have been attached."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 81
+
+userAdded TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A new user has been added."
+ --#TYPE "APC: A new user has been added."
+ --#SUMMARY "A new user has been added."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 82
+
+userDeleted TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A user has been deleted."
+ --#TYPE "APC: A user has been deleted."
+ --#SUMMARY "A user has been deleted."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 83
+
+userModified TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A user has been modified."
+ --#TYPE "APC: A user has been modified."
+ --#SUMMARY "A user has been modified."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 84
+
+-- MasterSwitch Vm Traps
+
+msvmCommunicationEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlVMIndex, sPDUMasterControlVMName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Communications with the MasterSwitch VM has been established."
+ --#TYPE "APC: Communications established with the MasterSwitch VM."
+ --#SUMMARY "Communications with the MasterSwitch VM has been established."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 85
+
+msvmCommunicationLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlVMIndex, sPDUMasterControlVMName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Communications with the MasterSwitch VM has been lost."
+ --#TYPE "APC: Communications lost with the MasterSwitch VM."
+ --#SUMMARY "Communications with the MasterSwitch VM has been lost."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 86
+
+msvmOverload TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlVMIndex, sPDUMasterControlVMName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The MasterSwitch VM in an overload condition."
+ --#TYPE "APC: The MasterSwitch VM is near or at an overload condition."
+ --#SUMMARY "The MasterSwitch VM is near or at an overload condition."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 87
+
+msvmOverloadCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlVMIndex, sPDUMasterControlVMName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The overload condition on the MasterSwitch VM has been cleared."
+ --#TYPE "APC: The overload condition cleared on the MasterSwitch VM."
+ --#SUMMARY "The overload condition on the MasterSwitch VM has been cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 88
+
+msvmOutletOn TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlVMIndex, sPDUMasterControlVMName,
+ sPDUOutletControlVMOutletIndex, sPDUOutletControlVMOutletName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An outlet on the MasterSwitch VM has turned on."
+ --#TYPE "APC: An outlet on the MasterSwitch VM has turned on."
+ --#SUMMARY "An outlet on the MasterSwitch VM has turned on."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 89
+
+msvmOutletOff TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlVMIndex, sPDUMasterControlVMName,
+ sPDUOutletControlVMOutletIndex, sPDUOutletControlVMOutletName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An outlet on the MasterSwitch VM has turned off."
+ --#TYPE "APC: An outlet on the MasterSwitch VM has turned off."
+ --#SUMMARY "An outlet on the MasterSwitch VM has turned off."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 90
+
+msvmDeviceConfigChange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlVMIndex, sPDUMasterControlVMName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A device configuration change has been made on a MasterSwitch VM."
+ --#TYPE "APC: A device configuration change on a MasterSwitch VM."
+ --#SUMMARY "A device configuration change has been made on a MasterSwitch VM."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 91
+
+msvmOutletConfigChange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlVMIndex, sPDUMasterControlVMName,
+ sPDUOutletControlVMOutletIndex, sPDUOutletControlVMOutletName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An outlet configuration change has been made on a MasterSwitch VM."
+ --#TYPE "APC: An outlet configuration change on a MasterSwitch VM."
+ --#SUMMARY "An outlet configuration change has been made on a MasterSwitch VM."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 92
+
+msvmLowLoad TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlVMIndex, sPDUMasterControlVMName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The MasterSwitch VM has violated the low load threshold."
+ --#TYPE "APC: The MasterSwitch VM has violated the low load threshold."
+ --#SUMMARY "The MasterSwitch VM has violated the low load threshold."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 93
+
+msvmLowLoadCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlVMIndex, sPDUMasterControlVMName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The low load condition on the MasterSwitch VM has been cleared."
+ --#TYPE "APC: The low load condition cleared on the MasterSwitch VM."
+ --#SUMMARY "The low load condition on the MasterSwitch VM has been cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 94
+
+msvmNearOverload TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlVMIndex, sPDUMasterControlVMName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The MasterSwitch VM is approaching an overload condition."
+ --#TYPE "APC: The MasterSwitch VM is near or at an overload condition."
+ --#SUMMARY "The MasterSwitch VM is near or at an overload condition."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 95
+
+msvmNearOverloadCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlVMIndex, sPDUMasterControlVMName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The near overload condition on the MasterSwitch VM has been cleared."
+ --#TYPE "APC: The overload condition cleared on the MasterSwitch VM."
+ --#SUMMARY "The overload condition on the MasterSwitch VM has been cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 96
+
+msvmPowerSupplyStatusChange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlVMIndex, sPDUMasterControlVMName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The power supply status of the MasterSwitch VM has changed."
+ --#TYPE "APC: The power supply status changed on MasterSwitch VM"
+ --#SUMMARY "The power supply status of the MasterSwitch VM has changed."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 97
+
+-- MasterSwitch plus (MSP) Traps
+
+mspCommunicationEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlMSPIndex, sPDUMasterControlMSPName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Communications with the MasterSwitch plus has been established."
+ --#TYPE "APC: Communications established with the MasterSwitch plus."
+ --#SUMMARY "Communications with the MasterSwitch plus has been established."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 98
+
+mspCommunicationLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlMSPIndex, sPDUMasterControlMSPName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Communications with the MasterSwitch plus has been lost."
+ --#TYPE "APC: Communications lost with the MasterSwitch plus."
+ --#SUMMARY "Communications with the MasterSwitch plus has been lost."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 99
+
+mspOutletOn TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlMSPIndex, sPDUMasterControlMSPName,
+ sPDUOutletControlMSPOutletIndex, sPDUOutletControlMSPOutletName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An outlet on the MasterSwitch plus has turned on."
+ --#TYPE "APC: An outlet on the MasterSwitch plus has turned on."
+ --#SUMMARY "An outlet on the MasterSwitch plus has turned on."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 100
+
+mspOutletOff TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlMSPIndex, sPDUMasterControlMSPName,
+ sPDUOutletControlMSPOutletIndex, sPDUOutletControlMSPOutletName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An outlet on the MasterSwitch plus has turned off."
+ --#TYPE "APC: An outlet on the MasterSwitch plus has turned off."
+ --#SUMMARY "An outlet on the MasterSwitch plus has turned off."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 101
+
+mspDeviceConfigChange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlMSPIndex, sPDUMasterControlMSPName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A device configuration change has been made on a MasterSwitch plus."
+ --#TYPE "APC: A device configuration change on a MasterSwitch plus."
+ --#SUMMARY "A device configuration change has been made on a MasterSwitch plus."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 102
+
+mspOutletConfigChange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { sPDUMasterControlMSPIndex, sPDUMasterControlMSPName, sPDUOutletControlMSPOutletIndex, sPDUOutletControlMSPOutletName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An outlet configuration change has been made on a MasterSwitch plus."
+ --#TYPE "APC: An outlet configuration change on a MasterSwitch plus."
+ --#SUMMARY "An outlet configuration change has been made on a MasterSwitch plus."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 103
+
+rsSourceSwitched TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger02, mtrapargsString03, mtrapargsInteger, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The Redundant Switch has switched source.
+ The first variable is an integer representing the current source: 0=A, 1=B.
+ The second variable is the 32-character name of the current source.
+ The third variable is an integer representing the transfer cause:
+ 0=No Transfers Recorded, 1=Due to user action or preferred switching,
+ 3=Due to line notch or spike, 5=Due to low line voltage,
+ 7=Transfer due to high line voltage,
+ 9=Transfer due to frequency out of range.
+ The fourth variable is a character string listing the transfer cause."
+ --#TYPE "APC Redundant Switch: The Redundant Switch has switched source"
+ --#SUMMARY "The Redundant Switch has switched source."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 104
+
+rsLostRedundancy TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The Redundant Switch has lost redundancy.
+ The first variable is an integer representing the source which is no longer available: 0=A, 1=B.
+ The second variable is the 32-character name of the source which is no longer available."
+ --#TYPE "APC Redundant Switch: The Redundant Switch has lost redundancy"
+ --#SUMMARY "The Redundant Switch has has lost redundancy."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 105
+
+rsRedundancyRestored TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Redundancy has been restored to the Redundant Switch .
+ The first variable is an integer representing the source which has been restored: 0=A, 1=B.
+ The second variable is the 32-character name of the source which has been restored."
+ --#TYPE "APC Redundant Switch: Redundancy has been restored."
+ --#SUMMARY "Redundancy has been restored to the Redundant Switch ."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 106
+
+rsConfigChange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A configuration change has been made on a Redundant Switch."
+ --#TYPE "APC: A configuration change on a Redundant Switch."
+ --#SUMMARY "A configuration change has been made on a Redundant Switch."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 107
+
+rsCommunicationEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Communications with the Redundant Switch has been established."
+ --#TYPE "APC: Communications established with the Redundant Switch."
+ --#SUMMARY "Communications with the Redundant Switch has been established."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 108
+
+rsCommunicationLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Communications with the Redundant Switch has been lost."
+ --#TYPE "APC: Communications lost with the Redundant Switch."
+ --#SUMMARY "Communications with the Redundant Switch has been lost."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 109
+
+dcCommunicationEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Communications with the DC power plant has been established."
+ --#TYPE "APC: Communications established with the DC power plant."
+ --#SUMMARY "Communications with the DC power plant has been established."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 110
+
+dcCommunicationLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Communications with the DC power plant has been lost."
+ --#TYPE "APC: Communications lost with the DC power plant."
+ --#SUMMARY "Communications with the DC power plant has been lost."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 111
+
+dcPINChanged TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The active PIN on the DC controller has been changed."
+ --#TYPE "APC: The active PIN on the DC controller has been changed."
+ --#SUMMARY "The active PIN on the DC controller has been changed."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 112
+
+dcMajorAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A Major alarm is active in the DC power plant."
+ --#TYPE "APC: A Major alarm is active in the DC power plant."
+ --#SUMMARY "A Major alarm is active in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 113
+
+dcMajorAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Major alarm is no longer active in the DC power plant."
+ --#TYPE "APC: A Major alarm is no longer active in the DC power plant."
+ --#SUMMARY "A Major alarm is no longer active in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 114
+
+dcMinorAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Minor alarm is active in the DC power plant."
+ --#TYPE "APC: A Minor alarm is active in the DC power plant."
+ --#SUMMARY "A Minor alarm is active in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 115
+
+dcMinorAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Minor alarm is no longer active in the DC power plant."
+ --#TYPE "APC: A Minor alarm is no longer active in the DC power plant."
+ --#SUMMARY "A Minor alarm is no longer active in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 116
+
+dcOutputRelayOn TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { dm3StatusOutRlyIndex, dm3StatusOutRlyName, mtrapargsString }
+ DESCRIPTION
+ "WARNING: An output relay for the powerplant has been activated (state changed to on).
+ The first variable is an integer representing the output relay number that has gone on.
+ The second variable is the 16-character name of the output relay."
+ --#TYPE "APC: An output relay has gone on."
+ --#SUMMARY "An output relay has gone on in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 117
+
+dcOutputRelayOff TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { dm3StatusOutRlyIndex, dm3StatusOutRlyName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An output relay for the powerplant has been deactivated (state changed to off).
+ The first variable is an integer representing the output relay number that has gone off.
+ The second variable is the 16-character name of the output relay."
+ --#TYPE "APC: An output relay has gone off."
+ --#SUMMARY "An output relay has gone off in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 118
+
+dcInputRelayOn TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { dm3StatusInRlyIndex, dm3StatusInRlyName, mtrapargsString }
+ DESCRIPTION
+ "WARNING: An input relay for the powerplant has been activated (state changed to on).
+ The first variable is an integer representing the input relay number that has gone on.
+ The second variable is the 16-character name of the input relay."
+ --#TYPE "APC: An input relay has gone on."
+ --#SUMMARY "An input relay has gone on in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 119
+
+dcInputRelayOff TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { dm3StatusInRlyIndex, dm3StatusInRlyName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An input relay for the powerplant has been deactivated (state changed to off).
+ The first variable is an integer representing the input relay number that has gone off.
+ The second variable is the 16-character name of the input relay."
+ --#TYPE "APC: An input relay has gone off."
+ --#SUMMARY "An input relay has gone off in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 120
+
+logicPowerSuppliesIncreased TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The number of system power supplies has increased."
+ --#TYPE "APC UPS: The number of system power supplies has increased."
+ --#SUMMARY "The number of system power supplies has increased."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 121
+
+logicPowerSuppliesDecreased TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The number of system power supplies has decreased."
+ --#TYPE "APC UPS: The number of system power supplies has decreased."
+ --#SUMMARY "The number of system power supplies has decreased."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 122
+
+externalSwitchGearClosed TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: External Switch Gear closed."
+ --#TYPE "APC UPS: External Switch Gear closed."
+ --#SUMMARY "External Switch Gear closed."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 123
+
+externalSwitchGearOpened TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: External Switch Gear opened."
+ --#TYPE "APC UPS: External Switch Gear opened."
+ --#SUMMARY "External Switch Gear opened."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 124
+
+generalDeviceEvent TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: APC Device event."
+ --#TYPE "APC Device event"
+ --#SUMMARY "APC Device event."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 125
+
+atsSourceSwitched TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The Automatic Transfer Switch has switched source.
+ The first variable is an integer representing the current source: 0=A, 1=B.
+ The second variable is the 32-character name of the current source."
+ --#TYPE "APC Automatic Transfer Switch: The ATS has switched source"
+ --#SUMMARY "The Automatic Transfer Switch has switched source."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 126
+
+atsLostRedundancy TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The Automatic Transfer Switch has lost redundancy.
+ The first variable is an integer representing the source which is no longer available: 0=A, 1=B.
+ The second variable is the 32-character name of the source which is no longer available."
+ --#TYPE "APC Automatic Transfer Switch: The ATS has lost redundancy. "
+ --#SUMMARY "The Automatic Transfer Switch has has lost redundancy."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 127
+
+atsRedundancyRestored TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Redundancy has been restored to the Automatic Transfer Switch .
+ The first variable is an integer representing the source which has been restored: 0=A, 1=B.
+ The second variable is the 32-character name of the source which has been restored."
+ --#TYPE "APC Automatic Transfer Switch: Redundancy has been restored."
+ --#SUMMARY "Redundancy has been restored to the Automatic Transfer Switch ."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 128
+
+atsConfigChange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A configuration change has been made on the Automatic Transfer Switch.
+ The first variable is an integer representing the configuration setting which changed:
+ 0=Transfer Voltage Range, 1=Sensitivity 2=Preferred Source
+ 3=Front Panel Lockout 4=Current Limit"
+ --#TYPE "APC Automatic Transfer Switch: ATS configuration changed."
+ --#SUMMARY "A configuration change has been made on a Automatic Transfer Switch."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 129
+
+atsCommunicationEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Communications with the Automatic Transfer Switch has been established."
+ --#TYPE "APC Automatic Transfer Switch: Communications established."
+ --#SUMMARY "Communications with the Automatic Transfer Switch has been established."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 130
+
+atsCommunicationLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Communications with the Automatic Transfer Switch has been lost."
+ --#TYPE "APC Automatic Transfer Switch: Communications lost."
+ --#SUMMARY "Communications with the Automatic Transfer Switch has been lost."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 131
+
+atsOverCurrent TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Output Current has exceeded threshold."
+ --#TYPE "APC Automatic Transfer Switch: Output Current exceeded threshold"
+ --#SUMMARY "Output Current has exceeded Threshold. "
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 132
+
+atsOverCurrentCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Output Current has returned below threshold."
+ --#TYPE "APC Automatic Transfer Switch: Output Current below threshold."
+ --#SUMMARY "Output Current has returned below threshold."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 133
+
+atsPowerSupplyFailure TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The Automatic Transfer Switch Power Supply has failed.
+ The first variable is an integer representing the Power Supply which
+ has failed: 0=24V, 1=12V 2=5V."
+ --#TYPE "APC Automatic Transfer Switch: The ATS Power Supply has failed."
+ --#SUMMARY "The Automatic Transfer Switch Power Supply has failed."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 134
+
+atsPowerSupplyFailureCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The Automatic Transfer Power Supply Failure Cleared.
+ The first variable is an integer representing the Power Supply which
+ has cleared: 0=24V, 1=12V 2=5V."
+ --#TYPE "APC Automatic Transfer Switch: Power Supply Failure Cleared."
+ --#SUMMARY "The Automatic Transfer Switch Power Supply Failure Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 135
+
+dcMainsFailAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Mains Fail alarm is active in the DC power plant."
+ --#TYPE "APC: A Mains Fail alarm is active in the DC power plant."
+ --#SUMMARY "A Mains Fail alarm is active in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 136
+
+dcMainsFailAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Mains Fail alarm is no longer active in the DC power plant."
+ --#TYPE "APC: Mains Fail alarm is no longer active in the DC power plant."
+ --#SUMMARY "Mains Fail alarm is no longer active in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 137
+
+dcFanFailAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Fan Fail alarm is active in the DC power plant."
+ --#TYPE "APC: A Fan Fail alarm is active in the DC power plant."
+ --#SUMMARY "A Fan Fail alarm is active in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 138
+
+dcFanFailAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Fan Fail alarm is no longer active in the DC power plant."
+ --#TYPE "APC: A Fan Fail alarm is no longer active in the DC power plant."
+ --#SUMMARY "A Fan Fail alarm is no longer active in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 139
+
+dcRectifierOvertempAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: Rect. Overtemp alarm is active in the power plant."
+ --#TYPE "APC: Rect. Overtemp alarm is active in the power plant."
+ --#SUMMARY "Rect. Overtemp alarm is active in the power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 140
+
+dcRectifierOvertempAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Rect. Overtemp alarm is no longer active in the power plant."
+ --#TYPE "APC: Rect. Overtmp alarm is no longer active in the power plant."
+ --#SUMMARY "Rect. Overtmp alarm is no longer active in the power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 141
+
+dcCurrentLimitAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Current Limit alarm is active in the power plant."
+ --#TYPE "APC: A Current Limit alarm is active in the power plant."
+ --#SUMMARY "A Current Limit alarm is active in the power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 142
+
+dcCurrentLimitAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Current Limit alarm is no longer active in the power plant."
+ --#TYPE "APC: Current Limit alarm is no longer active in the power plant."
+ --#SUMMARY "Current Limit alarm is no longer active in the power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 143
+
+dcRectifierFailAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Rect. Fail alarm is active in the power plant."
+ --#TYPE "APC: A Rect. Fail alarm is active in the power plant."
+ --#SUMMARY "A Rect. Fail alarm is active in the power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 144
+
+dcRectifierFailAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Rect. Fail alarm is no longer active in the power plant."
+ --#TYPE "APC: Rect. Fail alarm is no longer active in the power plant."
+ --#SUMMARY "Rect. Fail alarm is no longer active in the power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 145
+
+dcMultRectFailAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: Multiple Rect. Fail alarm is active in the powerplant."
+ --#TYPE "APC: Multiple Rect. Fail alarm is active in the powerplant."
+ --#SUMMARY "Multiple Rect. Fail alarm is active in the powerplant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 146
+
+dcMultRectFailAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Mult Rect Fail alarm is no longer active in the powerplant."
+ --#TYPE "APC: Mult Rect Fail alarm is no longer active in the powerplant."
+ --#SUMMARY "Mult Rect Fail alarm is no longer active in the powerplant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 147
+
+dcBatteryBreakerAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: Batt. Breaker alarm is active in the power plant."
+ --#TYPE "APC: Batt. Breaker alarm is active in the power plant."
+ --#SUMMARY "Batt. Breaker alarm is active in the power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 148
+
+dcBatteryBreakerAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Batt. Breaker alarm is no longer active in the power plant."
+ --#TYPE "APC: Batt. Breaker alarm is no longer active in the power plant."
+ --#SUMMARY "Batt. Breaker alarm is no longer active in the power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 149
+
+dcRectifierOVPAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Rect. OVP alarm is active in the power plant."
+ --#TYPE "APC: A Rect. OVP alarm is active in the power plant."
+ --#SUMMARY "A Rect. OVP alarm is active in the power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 150
+
+dcRectifierOVPAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Rect. OVP alarm is no longer active in the power plant."
+ --#TYPE "APC: A Rect. OVP alarm is no longer active in the power plant."
+ --#SUMMARY "A Rect. OVP alarm is no longer active in the power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 151
+
+dcLVDImminentAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: A LVD Imminent alarm is active in the powerplant."
+ --#TYPE "APC: A LVD Imminent alarm is active in the powerplant."
+ --#SUMMARY "A LVD Imminent alarm is active in the powerplant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 152
+
+dcLVDImminentAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A LVD Imminent alarm is no longer active in the powerplant."
+ --#TYPE "APC: A LVD Imminent alarm is no longer active in the powerplant."
+ --#SUMMARY "A LVD Imminent alarm is no longer active in the powerplant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 153
+
+dcFuseCBAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Fuse/CB alarm is active in the DC power plant."
+ --#TYPE "APC: A Fuse/CB alarm alarm is active in the DC power plant."
+ --#SUMMARY "A Fuse/CB alarm is active in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 154
+
+dcFuseCBAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Fuse/CB alarm is no longer active in the DC power plant."
+ --#TYPE "APC: A Fuse/CB alarm is no longer active in the DC power plant."
+ --#SUMMARY "A Fuse/CB alarm is no longer active in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 155
+
+dcBatteryTestFail TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Battery Test failed in the DC power plant."
+ --#TYPE "APC: A Battery Test failed in the DC power plant."
+ --#SUMMARY "A Battery Test failed in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 156
+
+dcTemperatureAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Temperature is active in the power plant."
+ --#TYPE "APC: A Temperature alarm is active in the power plant."
+ --#SUMMARY "A Temperature alarm is active in the power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 157
+
+dcTemperatureAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Temperature alarm is no longer active in the power plant."
+ --#TYPE "APC: A Temperature alarm is no longer active in the power plant."
+ --#SUMMARY "A Temperature alarm is no longer active in the power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 158
+
+dcHumidityAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Humidity alarm is active in the DC power plant."
+ --#TYPE "APC: A Humidity alarm is active in the DC power plant."
+ --#SUMMARY "A Humidity alarm is active in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 159
+
+dcHumidityAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Humidity alarm is no longer active in the DC power plant."
+ --#TYPE "APC: A Humidity alarm is no longer active in the DC power plant."
+ --#SUMMARY "A Humidity alarm is no longer active in the DC power plant."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 160
+
+dcBBCommunicationEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Power plant bridging board communications established."
+ --#TYPE "APC: Power plant bridging board communications established."
+ --#SUMMARY "Power plant bridging board communications established."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 161
+
+dcBBCommunicationLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Power plant bridging board communications lost."
+ --#TYPE "APC: Power plant bridging board communications lost."
+ --#SUMMARY "Power plant bridging board communications lost."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 162
+
+iemHighTempThresholdViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { iemStatusProbeCurrentTemp, iemStatusProbeTempUnits, iemStatusProbeNumber,
+ iemStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: High temperature threshold violated on Integrated
+ Environmental Monitor probe. The first variable is the
+ current temperature. The second variable is the temperature
+ scale. The third variable is the probe number. The fourth
+ variable is the probe name."
+ --#TYPE "APC IEM: High temperature threshold violation."
+ --#SUMMARY "High temperature threshold violation."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 163
+
+iemHighTempThresholdViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { iemStatusProbeNumber, iemStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: High temperature threshold violated on Integrated
+ Environmental Monitor probe has been cleared. The first variable
+ is the probe number. The second variable is the probe name."
+ --#TYPE "APC IEM: High temperature threshold violation cleared."
+ --#SUMMARY "High temperature threshold violation has been cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 164
+
+iemLowTempThresholdViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { iemStatusProbeCurrentTemp, iemStatusProbeTempUnits, iemStatusProbeNumber,
+ iemStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Low temperature threshold violated on integrated
+ probe. The first variable is the current temperature. The
+ second variable is the temperature scale. The third
+ variable is the probe number. The fourth variable is the
+ probe name."
+ --#TYPE "APC IEM: Low temperature threshold violation."
+ --#SUMMARY "Low temperature threshold violation."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 165
+
+iemLowTempThresholdViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { iemStatusProbeNumber, iemStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Low temperature threshold violated on integrated
+ probe has been cleared. The first variable is the probe number.
+ The second variable is the probe name."
+ --#TYPE "APC IEM: Low temperature threshold violation cleared."
+ --#SUMMARY "Low temperature threshold violation has been cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 166
+
+iemHighHumidThresholdViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { iemStatusProbeCurrentHumid, iemStatusProbeNumber, iemStatusProbeName,
+ mtrapargsString }
+ DESCRIPTION
+ "SEVERE: High humidity threshold violated on integrated
+ probe. The first variable is the current humidity. The
+ second variable is the probe number. The third variable
+ is the probe name."
+ --#TYPE "APC IEM: High humidity threshold violation."
+ --#SUMMARY "High humidity threshold violation."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 167
+
+iemHighHumidThresholdViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { iemStatusProbeNumber, iemStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: High humidity threshold violated on integrated
+ probe cleared. The first variable is the probe number. The second
+ variable is the probe name."
+ --#TYPE "APC IEM: High humidity threshold violation cleared."
+ --#SUMMARY "High humidity threshold violation has been cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 168
+
+iemLowHumidThresholdViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { iemStatusProbeCurrentHumid, iemStatusProbeNumber, iemStatusProbeName,
+ mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Low humidity threshold violated on integrated
+ probe. The first variable is the current humidity. The
+ second variable is the probe number. The third variable
+ is the probe name."
+ --#TYPE "APC IEM: Low humidity threshold violation."
+ --#SUMMARY "Low humidity threshold violation."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 169
+
+iemLowHumidThresholdViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { iemStatusProbeNumber, iemStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Low humidity threshold violated on integrated
+ probe cleared. The first variable is the probe number. The second
+ variable is the probe name."
+ --#TYPE "APC IEM: Low humidity threshold violation cleared."
+ --#SUMMARY "Low humidity threshold violation has been cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 170
+
+iemProbeDisconnected TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The temperature/humidity probe on the Integrated
+ Environmental Monitor has been disconnected. This trap is
+ generated when a probe that has been in communication with
+ the Environmental Monitor has been disconnected or can no
+ longer communicate."
+ --#TYPE "APC IEM: Probe disconnected."
+ --#SUMMARY "Probe has been disconnected."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 171
+
+iemProbeConnected TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The temperature/humidity probe on the Integrated
+ Environmental Monitor has been connected. This trap is generated
+ when the Environmental Monitor establishes communication with a
+ probe that had previously not been connected."
+ --#TYPE "APC IEM: Probe Connected."
+ --#SUMMARY "Probe has been connected."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 172
+
+iemContactFault TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { iemStatusContactNumber, iemStatusContactName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: There is a contact fault on the Integrated
+ Environmental Monitor. The first argument is the number
+ of the contact. The second argument is the name of the
+ contact."
+ --#TYPE "APC IEM: Contact fault."
+ --#SUMMARY "Contact fault."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 173
+
+iemContactFaultCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { iemStatusContactNumber, iemStatusContactName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The contact fault on the Integrated
+ Environmental Monitor has been cleared. The first
+ argument is the number of the contact. The second
+ argument is the name of the contact."
+ --#TYPE "APC IEM: Contact fault."
+ --#SUMMARY "Contact fault cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 174
+
+iemRelayFault TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { iemStatusRelayNumber, iemStatusRelayName, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The output relay on the Integrated Environmental
+ Monitor has switched to the fault state. The first
+ argument is the number of the output relay. The second
+ argument is the name of the output relay. The third
+ argument is the event that caused the fault."
+ --#TYPE "APC IEM: Output relay fault."
+ --#SUMMARY "Output relay has faulted."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 175
+
+iemRelayFaultCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { iemStatusRelayNumber, iemStatusRelayName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The fault condition on the output relay on the
+ Integrated Environmental Monitor has cleared. The first
+ argument is the number of the output relay. The second
+ argument is the name of the output relay."
+ --#TYPE "APC IEM: Output relay fault condition cleared."
+ --#SUMMARY "Output relay fault cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 176
+
+bmBatManCommEstab TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Serial Communications Established with Battery Manager."
+ --#TYPE "BatMan : Communications Established."
+ --#SUMMARY "Communications Established."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 177
+
+bmBatManCommLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Serial Communications Lost with Battery Manager."
+ --#TYPE "BatMan : Communications Lost."
+ --#SUMMARY "Communications Lost."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 178
+
+bmBatManKneeAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Battery Voltage Knee Threshold Alarm Detected."
+ --#TYPE "BatMan : Knee Alarm Detected."
+ --#SUMMARY "Knee Alarm Detected."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 179
+
+bmBatManKneeAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Battery Voltage Knee Threshold Alarm Cleared."
+ --#TYPE "BatMan : Knee Alarm Cleared."
+ --#SUMMARY "Knee Alarm Cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 180
+
+bmBatManChargerAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: Charger Alarm Detected."
+ --#TYPE "BatMan : Charger Alarm Detected."
+ --#SUMMARY "Charger Alarm Detected."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 181
+
+bmBatManChargerAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Charger Alarm Cleared."
+ --#TYPE "BatMan : Charger Alarm Cleared."
+ --#SUMMARY "Charger Alarm Cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 182
+
+bmBatManBatteryAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: Battery Alarm Detected."
+ --#TYPE "BatMan : Battery Alarm Detected."
+ --#SUMMARY "Battery Alarm Detected."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 183
+
+bmBatManBatteryAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Battery Alarm Cleared."
+ --#TYPE "BatMan : Battery Alarm Cleared."
+ --#SUMMARY "Battery Alarm Cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 184
+
+bmBatManEnvironmentAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: Environment Alarm Detected."
+ --#TYPE "BatMan : Environment Alarm Detected."
+ --#SUMMARY "Environment Alarm Detected."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 185
+
+bmBatManEnvironmentAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Environment Alarm Cleared."
+ --#TYPE "BatMan : Environment Alarm Cleared."
+ --#SUMMARY "Environment Alarm Cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 186
+
+bmBatManMaintenanceAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Maintenance Alarm Detected."
+ --#TYPE "BatMan : Maintenance Due Alarm Detected."
+ --#SUMMARY "Maintenance Due Alarm Detected."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 187
+
+bmBatManMaintenanceAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Maintenance Alarm Cleared."
+ --#TYPE "BatMan : Maintenance Due Alarm Cleared."
+ --#SUMMARY "Maintenance Due Alarm Cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 188
+
+pduCommunicationEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Communication Established.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: Communication Established."
+ --#SUMMARY "Communication Established."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 189
+
+pduCommunicationLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Communication Lost.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: Communication Lost."
+ --#SUMMARY "Communication Lost."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 190
+
+pduUtilityLineUndervoltage TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Utility Line Undervoltage.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC PDU: Utility Line Undervoltage."
+ --#SUMMARY "Utility Line Undervoltage."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 191
+
+pduUtilityLineUndervoltageCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Utility Line Undervoltage Cleared.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC PDU: Utility Line Undervoltage Cleared."
+ --#SUMMARY "Utility Line Undervoltage Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 192
+
+pduUtilityLineOvervoltage TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Utility Line Overvoltage.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC PDU: Utility Line Overvoltage."
+ --#SUMMARY "Utility Line Overvoltage."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 193
+
+pduUtilityLineOvervoltageCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Utility Line Overvoltage Cleared.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC PDU: Utility Line Overvoltage Cleared."
+ --#SUMMARY "Utility Line Overvoltage Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 194
+
+pduGroundOvercurrent TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Ground Overcurrent.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: Ground Overcurrent."
+ --#SUMMARY "Ground Overcurrent."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 195
+
+pduGroundOvercurrentCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Ground Overcurrent Cleared.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: Ground Overcurrent Cleared."
+ --#SUMMARY "Ground Overcurrent Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 196
+
+pduCircuitPanelInputUndervoltage TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Circuit Panel Input Undervoltage.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC PDU: Circuit Panel Input Undervoltage."
+ --#SUMMARY "Circuit Panel Input Undervoltage."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 197
+
+pduCircuitPanelInputUndervoltageCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Circuit Panel Input Undervoltage Cleared.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC PDU: Circuit Panel Input Undervoltage Cleared."
+ --#SUMMARY "Circuit Panel Input Undervoltage Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 198
+
+pduCircuitPanelInputOvervoltage TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Circuit Panel Input Overvoltage.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC PDU: Circuit Panel Input Overvoltage."
+ --#SUMMARY "Circuit Panel Input Overvoltage."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 199
+
+pduCircuitPanelInputOvervoltageCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Circuit Panel Input Overvoltage Cleared.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC PDU: Circuit Panel Input Overvoltage Cleared."
+ --#SUMMARY "Circuit Panel Input Overvoltage Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 200
+
+pduCircuitPanelInputUndercurrent TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Circuit Panel Input Undercurrent.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC PDU: Circuit Panel Input Undercurrent."
+ --#SUMMARY "Circuit Panel Input Undercurrent."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 201
+
+pduCircuitPanelInputUndercurrentCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Circuit Panel Input Undercurrent Cleared.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC PDU: Circuit Panel Input Undercurrent Cleared."
+ --#SUMMARY "Circuit Panel Input Undercurrent Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 202
+
+pduCircuitPanelInputOvercurrent TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Circuit Panel Input Overcurrent.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC PDU: Circuit Panel Input Overcurrent."
+ --#SUMMARY "Circuit Panel Input Overcurrent."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 203
+
+pduCircuitPanelInputOvercurrentCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Circuit Panel Input Overcurrent Cleared.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC PDU: Circuit Panel Input Overcurrent Cleared."
+ --#SUMMARY "Circuit Panel Input Overcurrent Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 204
+
+pduCircuitPanelFrequencyOutOfRange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Circuit Panel Input Frequency Out Of Range.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: Circuit Panel Input Frequency Out Of Range."
+ --#SUMMARY "Circuit Panel Input Frequency Out Of Range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 205
+
+pduCircuitPanelFrequencyOutofRangeCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Circuit Panel Input Frequency No Longer Out Of Range.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: Circuit Panel Input Frequency No Longer Out Of Range."
+ --#SUMMARY "Circuit Panel Input Frequency No Longer Out Of Range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 206
+
+pduCircuitPanelNeutralOvercurrent TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Circuit Panel Input Neutral Overcurrent.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: Circuit Panel Input Neutral Overcurrent."
+ --#SUMMARY "Circuit Panel Input Neutral Overcurrent."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 207
+
+pduCircuitPanelNeutralOvercurrentCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Circuit Panel Input Neutral Overcurrent Cleared.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: Circuit Panel Input Neutral Overcurrent Cleared."
+ --#SUMMARY "Circuit Panel Input Neutral Overcurrent Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 208
+
+pduSystemOff TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: PDU System Off.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: System Off."
+ --#SUMMARY "PDU System Off."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 209
+
+pduOnBatteryMode TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: PDU is in On Battery Mode.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: On Battery Mode."
+ --#SUMMARY "PDU is in On Battery Mode."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 210
+
+pduMaintenanceBypassMode TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: PDU is in Maintenance Bypass Mode.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: Maintenance Bypass Mode."
+ --#SUMMARY "PDU is in Maintenance Bypass Mode."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 211
+
+pduAtypicalBypassMode TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "WARNING: PDU is in Atypical Bypass Mode.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: Atypical Bypass Mode."
+ --#SUMMARY "PDU is in Atypical Bypass Mode."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 212
+
+pduNoPanelFeedMode TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: PDU is in No Panel Feed Mode.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: No Panel Feed Mode."
+ --#SUMMARY "PDU is in No Panel Feed Mode."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 213
+
+pduUpsOperationMode TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: PDU is in Ups Operation Mode.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: Ups Operation Mode."
+ --#SUMMARY "PDU is in Ups Operation Mode."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 214
+
+pduForcedBypassMode TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "WARNING: PDU is in Forced Bypass Mode.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: Forced Bypass Mode."
+ --#SUMMARY "PDU is in Forced Bypass Mode."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 215
+
+pduInputTransformerOverTemperature TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Input Transformer Over Temperature.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: Input Transformer Over Temperature."
+ --#SUMMARY "Input Transformer Over Temperature."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 216
+
+pduInputTransformerOverTemperatureCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Input Transformer Over Temperature Cleared.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC PDU: Input Transformer Over Temperature Cleared."
+ --#SUMMARY "Input Transformer Over Temperature Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 217
+
+pduUPSInputVoltageLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: UPS Input Voltage phase-N Lost.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC PDU: UPS Input Voltage phase-N Lost."
+ --#SUMMARY "UPS Input Voltage phase-N Lost."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 218
+
+pduUPSInputVoltageRestored TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: UPS Input Voltage phase-N Restored.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC PDU: UPS Input Voltage phase-N Restored."
+ --#SUMMARY "UPS Input Voltage phase-N Restored."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 219
+
+pduContactFault TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A contact closure in the PDU is in an abnormal position.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the number of the contact."
+ --#TYPE "APC PDU: Contact Abnormal."
+ --#SUMMARY "Contact Abnormal."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 220
+
+pduContactFaultCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A contact closure in the PDU is in a normal position.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the number of the contact."
+ --#TYPE "APC PDU: Contact Normal."
+ --#SUMMARY "Contact Normal."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 221
+
+rPDUBankPhaseLowLoad TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDULoadStatusBankNumber, rPDULoadStatusPhaseNumber, mtrapargsString }
+ DESCRIPTION
+ "WARNING: A bank or phase on the Rack PDU has violated the low load threshold.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the bank number (0 if this is phase data).
+ The fourth argument is the phase number (0 if this is bank data)."
+ --#TYPE "APC Rack PDU: Violation of bank or phase low load threshold."
+ --#SUMMARY "A bank or phase on the Rack PDU has violated the low load threshold."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 222
+
+rPDUBankPhaseLowLoadCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDULoadStatusBankNumber, rPDULoadStatusPhaseNumber, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The bank or phase low load condition on a Rack PDU has been
+ cleared.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the bank number (0 if this is phase data).
+ The fourth argument is the phase number (0 if this is bank data)."
+ --#TYPE "APC Rack PDU: Bank or phase low load condition cleared."
+ --#SUMMARY "The bank or phase low load condition on a Rack PDU has been cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 223
+
+rPDUBankPhaseNearOverload TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDULoadStatusBankNumber, rPDULoadStatusPhaseNumber, mtrapargsString }
+ DESCRIPTION
+ "WARNING: A bank or phase of the Rack PDU is near an overload condition.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the bank number (0 if this is phase data).
+ The fourth argument is the phase number (0 if this is bank data)."
+ --#TYPE "APC Rack PDU: Bank or phase near an overload condition."
+ --#SUMMARY "A bank or phase of the Rack PDU is near an overload condition."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 224
+
+rPDUBankPhaseNearOverloadCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDULoadStatusBankNumber, rPDULoadStatusPhaseNumber, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The bank or phase near overload condition on a Rack PDU has
+ been cleared.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the bank number (0 if this is phase data).
+ The fourth argument is the phase number (0 if this is bank data)."
+ --#TYPE "APC Rack PDU: Bank or phase near overload condition has cleared."
+ --#SUMMARY "Rack PDU bank or phase near overload condition has cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 225
+
+rPDUBankPhaseOverload TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDULoadStatusBankNumber, rPDULoadStatusPhaseNumber, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A bank or phase of the Rack PDU is in an overload condition.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number.
+ The third argument is the bank number (0 if this is phase data).
+ The fourth argument is the phase number (0 if this is bank data)."
+ --#TYPE "APC Rack PDU: Bank or phase overload condition."
+ --#SUMMARY "A bank or phase of the Rack PDU is in an overload condition."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 226
+
+rPDUBankPhaseOverloadCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDULoadStatusBankNumber, rPDULoadStatusPhaseNumber, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The bank or phase overload condition on a Rack PDU has been
+ cleared.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the bank number (0 if this is phase data).
+ The fourth argument is the phase number (0 if this is bank data)."
+ --#TYPE "APC Rack PDU: Bank or phase overload condition has cleared."
+ --#SUMMARY "The bank or phase overload condition on a Rack PDU has cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 227
+
+aruDeviceConfigChange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ rARUStatusAruIndex, rARUStatusAruName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Remote ARU Device Configurtion change.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the ARU number.
+ The fourth argument is the ARU name."
+ --#TYPE "APC ARU: ARU Device configuration change."
+ --#SUMMARY "ARU device configuration change."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 228
+
+rmPDUCommunicationLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString03, mtrapargsString02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Communication Lost.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC RM PDU: Communication Lost."
+ --#SUMMARY "Communication Lost."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 229
+
+emsCommunicationEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Communication Established.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC EMS: Communication Established."
+ --#SUMMARY "Communication Established."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 230
+
+emsCommunicationLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Communication Lost.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC EMS: Communication Lost."
+ --#SUMMARY "Communication Lost."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 231
+
+emsProbeConnected TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A probe has been connected to the EMS.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the probe number.
+ The fourth argument is the probe name."
+ --#TYPE "APC EMS: Probe Connected."
+ --#SUMMARY "Probe Connected."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 232
+
+emsProbeDisconnected TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A probe has been disconnected from the EMS.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the probe number.
+ The fourth argument is the probe name."
+ --#TYPE "APC EMS: Probe Disconnected."
+ --#SUMMARY "Probe Disconnected."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 233
+
+emsSensorConnected TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ emsSensorStatusSensorIndex, emsSensorStatusSensorName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A sensor has been connected to the EMS.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the sensor number.
+ The fourth argument is the sensor name."
+ --#TYPE "APC EMS: Sensor Connected."
+ --#SUMMARY "Sensor Connected."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 234
+
+emsSensorDisconnected TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ emsSensorStatusSensorIndex, emsSensorStatusSensorName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A sensor has been disconnected from the EMS.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the sensor number.
+ The fourth argument is the sensor name."
+ --#TYPE "APC EMS: Sensor Disconnected."
+ --#SUMMARY "Sensor Disconnected."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 235
+
+emsSensorFault TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ emsSensorStatusSensorIndex, emsSensorStatusSensorName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A EMS sensor is in the fault condition.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the sensor number.
+ The fourth argument is the sensor name."
+ --#TYPE "APC EMS: Sensor Fault."
+ --#SUMMARY "Sensor Fault."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 236
+
+emsSensorFaultCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ emsSensorStatusSensorIndex, emsSensorStatusSensorName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A EMS sensor fault condition has cleared.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the sensor number.
+ The fourth argument is the sensor name."
+ --#TYPE "APC EMS: Sensor Fault Cleared."
+ --#SUMMARY "Sensor Fault Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 237
+
+emsBeaconConnected TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A beacon has been connected to the EMS.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC EMS: Beacon Connected."
+ --#SUMMARY "Beacon Connected."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 238
+
+emsBeaconDisconnected TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A beacon has been disconnected from the EMS.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC EMS: Beacon Disconnected."
+ --#SUMMARY "Beacon Disconnected."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 239
+
+emsBeaconOn TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A EMS beacon has gone on.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC EMS: Beacon On."
+ --#SUMMARY "Beacon On."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 240
+
+emsBeaconOff TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A EMS beacon has gone off.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC EMS: Beacon Off."
+ --#SUMMARY "Beacon Off."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 241
+
+emsMajorAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A Major Alarm is present in the EMS.
+ The first argument is the EMS serial number.
+ The second argument is the EMS name."
+ --#TYPE "APC EMS: Major Alarm."
+ --#SUMMARY "Major Alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 242
+
+emsMajorAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Major Alarm condition has been cleared in the EMS.
+ The first argument is the EMS serial number.
+ The second argument is the EMS name."
+ --#TYPE "APC EMS: Major Alarm Cleared."
+ --#SUMMARY "Major Alarm Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 243
+
+emsMinorAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A Minor Alarm is present in the EMS.
+ The first argument is the EMS serial number.
+ The second argument is the EMS name."
+ --#TYPE "APC EMS: Minor Alarm."
+ --#SUMMARY "Minor Alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 244
+
+emsMinorAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Minor Alarm condition has been cleared in the EMS.
+ The first argument is the EMS serial number.
+ The second argument is the EMS name."
+ --#TYPE "APC EMS: Minor Alarm Cleared."
+ --#SUMMARY "Minor Alarm Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 245
+
+emsOutletStateAbnormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsOutletStatusOutletIndex, emsOutletStatusOutletName,
+ emsOutletStatusOutletState, emsOutletStatusOutletNormalState, mtrapargsString }
+ DESCRIPTION
+ "WARNING: An outlet on the EMS has changed to its abnormal state.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the outlet number.
+ The fourth argument is the outlet name.
+ The fifth argument is the current outlet state (1=ON, 2=OFF).
+ The sixth argument is the configured normal outlet state (1=ON, 2=OFF)."
+ --#TYPE "APC EMS: Outlet has changed to its abnormal state."
+ --#SUMMARY "Outlet has changed to its abnormal state."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 246
+
+emsOutletStateNormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsOutletStatusOutletIndex, emsOutletStatusOutletName,
+ emsOutletStatusOutletState, emsOutletStatusOutletNormalState, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An outlet on the EMS has changed to its normal state.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the outlet number.
+ The fourth argument is the outlet name.
+ The fifth argument is the current outlet state (1=ON, 2=OFF).
+ The sixth argument is the configured normal outlet state (1=ON, 2=OFF)."
+ --#TYPE "APC EMS: Outlet has changed to its normal state."
+ --#SUMMARY "Outlet has changed to its normal state."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 247
+
+emsInputContactStateAbnormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsInputContactStatusInputContactIndex,
+ emsInputContactStatusInputContactName, emsInputContactStatusInputContactState,
+ emsInputContactStatusInputContactNormalState, mtrapargsString }
+ DESCRIPTION
+ "WARNING: An input contact on the EMS has changed to its abnormal state.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the input contact number.
+ The fourth argument is the input contact name.
+ The fifth argument is the input contact state (1=CLOSED, 2=OPEN).
+ The sixth argument is the configured normal input contact state (1=CLOSED, 2=OPEN)."
+ --#TYPE "APC EMS: Input contact has changed to its abnormal state."
+ --#SUMMARY "Input contact has changed to its abnormal state."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 248
+
+emsInputContactStateNormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsInputContactStatusInputContactIndex,
+ emsInputContactStatusInputContactName, emsInputContactStatusInputContactState,
+ emsInputContactStatusInputContactNormalState, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An input contact on the EMS has changed to its normal state.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the input contact number.
+ The fourth argument is the input contact name.
+ The fifth argument is the input contact state (1=CLOSED, 2=OPEN).
+ The sixth argument is the configured normal input contact state (1=CLOSED, 2=OPEN)."
+ --#TYPE "APC EMS: Input contact has changed to its normal state."
+ --#SUMMARY "Input contact has changed to its normal state."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 249
+
+emsOutputRelayStateAbnormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsOutputRelayStatusOutputRelayIndex,
+ emsOutputRelayStatusOutputRelayName, emsOutputRelayStatusOutputRelayState,
+ emsOutputRelayStatusOutputRelayNormalState, mtrapargsString }
+ DESCRIPTION
+ "WARNING: An output relay on the EMS has changed to its abnormal state.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the output relay number.
+ The fourth argument is the output relay name.
+ The fifth argument is the current output relay state (1=CLOSED, 2=OPEN).
+ The sixth argument is the configured normal output relay state (1=CLOSED, 2=OPEN)."
+ --#TYPE "APC EMS: Output Relay has changed to its abnormal state."
+ --#SUMMARY "Output Relay has changed to its abnormal state."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 250
+
+emsOutputRelayStateNormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsOutputRelayStatusOutputRelayIndex,
+ emsOutputRelayStatusOutputRelayName, emsOutputRelayStatusOutputRelayState,
+ emsOutputRelayStatusOutputRelayNormalState, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An output relay on the EMS has changed to its normal state.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the output relay number.
+ The fourth argument is the output relay name.
+ The fifth argument is the current output relay state (1=CLOSED, 2=OPEN).
+ The sixth argument is the configured normal output relay state (1=CLOSED, 2=OPEN)."
+ --#TYPE "APC EMS: Output Relay has changed to its normal state."
+ --#SUMMARY "Output Relay has changed to its normal state."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 251
+
+emsDeviceConfigChange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A device configuration change has been made on the EMS.
+ The first argument is the EMS serial number.
+ The second argument is the EMS name."
+ --#TYPE "APC: A device configuration change on a EMS."
+ --#SUMMARY "A device configuration change has been made on a EMS."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 252
+
+envHighTempThresholdViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: High temperature threshold violated on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: High temperature threshold violation."
+ --#SUMMARY "High temperature threshold violation."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 253
+
+envHighTempThresholdViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: High temperature threshold violation cleared on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: High temperature threshold violation cleared."
+ --#SUMMARY "High temperature threshold violation cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 254
+
+envLowTempThresholdViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Low temperature threshold violated on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: Low temperature threshold violation."
+ --#SUMMARY "Low temperature threshold violation."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 255
+
+envLowTempThresholdViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Low temperature threshold violation cleared on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: Low temperature threshold violation cleared."
+ --#SUMMARY "Low temperature threshold violation cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 256
+
+envHighHumidityThresholdViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeHumidity,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: High humidity threshold violated on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current humidity
+ The fourth argument is the probe number.
+ The fifth argument is the probe name."
+ --#TYPE "APC ENV: High humidity threshold violation."
+ --#SUMMARY "High humidity threshold violation."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 257
+
+envHighHumidityThresholdViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeHumidity,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: High humidity threshold violation cleared on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current humidity.
+ The fourth argument is the probe number.
+ The fifth argument is the probe name."
+ --#TYPE "APC ENV: High humidity threshold violation cleared."
+ --#SUMMARY "High humidity threshold violation cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 258
+
+envLowHumidityThresholdViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeHumidity,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Low humidity threshold violated on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current humidity
+ The fourth argument is the probe number.
+ The fifth argument is the probe name."
+ --#TYPE "APC ENV: Low humidity threshold violation."
+ --#SUMMARY "Low humidity threshold violation."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 259
+
+envLowHumidityThresholdViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeHumidity,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Low humidity threshold violation cleared on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current humidity.
+ The fourth argument is the probe number.
+ The fifth argument is the probe name."
+ --#TYPE "APC ENV: Low humidity threshold violation cleared."
+ --#SUMMARY "Low humidity threshold violation cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 260
+
+
+-- Switched and Metered Rack PDU Traps
+
+rPDUCommunicationEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Communication with a Rack PDU has been established.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC Rack PDU: Communication established."
+ --#SUMMARY "Communication with a Rack PDU established."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 266
+
+rPDUCommunicationLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Communication with a Rack PDU has been lost.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC Rack PDU: Communication lost."
+ --#SUMMARY "Communication with a Rack PDU has been lost."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 267
+
+rPDUOutletOn TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDUOutletControlIndex, rPDUOutletControlOutletName,
+ mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An outlet on a Switched Rack PDU has turned on.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the outlet index number.
+ The fourth argument is the outlet name."
+ --#TYPE "APC Switched Rack PDU: An outlet has turned on."
+ --#SUMMARY "An outlet on a Switched Rack PDU has turned on."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 268
+
+rPDUOutletOff TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDUOutletControlIndex, rPDUOutletControlOutletName,
+ mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An outlet on a Switched Rack PDU has turned off.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the outlet index number.
+ The fourth argument is the outlet name."
+ --#TYPE "APC Switched Rack PDU: An outlet has turned off."
+ --#SUMMARY "An outlet on a Switched Rack PDU has turned off."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 269
+
+rPDUDeviceConfigChange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A device configuration change has been made on a
+ Rack PDU.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC Rack PDU: Device configuration change made."
+ --#SUMMARY "Device configuration change has been made on a Rack PDU."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 270
+
+rPDUOutletConfigChange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDUOutletControlIndex, rPDUOutletControlOutletName,
+ mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An outlet configuration change has been made on a
+ Switched Rack PDU.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the outlet index number.
+ The fourth argument is the outlet name."
+ --#TYPE "APC Switched Rack PDU: Outlet configuration change made."
+ --#SUMMARY "Outlet configuration change has been made on a Switched Rack PDU."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 271
+
+rPDULowLoad TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDULoadStatusPhaseNumber, mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Rack PDU has violated the low load threshold.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC Rack PDU: Violation of low load threshold."
+ --#SUMMARY "A Rack PDU has violated the low load threshold."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 272
+
+rPDULowLoadCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDULoadStatusPhaseNumber, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The low load condition on a Rack PDU has been
+ cleared.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC Rack PDU: Low load condition cleared."
+ --#SUMMARY "The low load condition on a Rack PDU has been cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 273
+
+rPDUNearOverload TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDULoadStatusPhaseNumber, mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Rack PDU is near an overload condition.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC Rack PDU: Near an overload condition."
+ --#SUMMARY "A Rack PDU is near an overload condition."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 274
+
+rPDUNearOverloadCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDULoadStatusPhaseNumber, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The near overload condition on a Rack PDU has
+ been cleared.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC Rack PDU: Near overload condition has cleared."
+ --#SUMMARY "Rack PDU near overload condition has cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 275
+
+rPDUOverload TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDULoadStatusPhaseNumber, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A Rack PDU is in an overload condition.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC Rack PDU: Overload condition."
+ --#SUMMARY "A Rack PDU is in an overload condition."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 276
+
+rPDUOverloadCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDULoadStatusPhaseNumber, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The overload condition on a Rack PDU has been
+ cleared.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase number."
+ --#TYPE "APC Rack PDU: Overload condition has cleared."
+ --#SUMMARY "The overload condition on a Rack PDU has cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 277
+
+rPDUPowerSupply1Fail TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Power Supply 1 on Rack PDU is in FAIL state.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC Rack PDU: Power Supply 1 is in FAIL state."
+ --#SUMMARY "Power Supply 1 on Rack PDU is in FAIL state."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 278
+
+rPDUPowerSupply1Ok TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Power Supply 1 on Rack PDU is operating normally.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC Rack PDU: Power Supply 1 is operating normally."
+ --#SUMMARY "Power Supply 1 on Rack PDU is operating normally."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 279
+
+rPDUPowerSupply2Fail TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Power Supply 2 on Rack PDU is in FAIL state.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC Rack PDU: Power Supply 2 is in FAIL state."
+ --#SUMMARY "Power Supply 2 on Rack PDU is in FAIL state."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 280
+
+rPDUPowerSupply2Ok TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Power Supply 2 on Rack PDU is operating normally.
+ The first argument is the serial number.
+ The second argument is the device name."
+ --#TYPE "APC Rack PDU: Power Supply 2 is operating normally."
+ --#SUMMARY "Power Supply 2 on Rack PDU is operating normally."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 281
+
+rPDUPhaseConfigChange TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDULoadPhaseConfigIndex, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A phase configuration change has been made on a
+ Rack PDU.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the phase index number."
+ --#TYPE "APC Rack PDU: Phase configuration change made."
+ --#SUMMARY "Phase configuration change has been made on a Rack PDU."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 282
+
+rPDUCancelPendingCommand TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { rPDUIdentSerialNumber, rPDUIdentName,
+ rPDUOutletControlIndex, rPDUOutletControlOutletName,
+ mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A cancel pending command has been made on a
+ Switched Rack PDU.
+ The first argument is the serial number.
+ The second argument is the device name.
+ The third argument is the outlet index number (0 indicates all outlets).
+ The fourth argument is the outlet name (or device name if all outlets)."
+ --#TYPE "APC Switched Rack PDU: Cancel Pending Command made."
+ --#SUMMARY "A Cancel Pending Command has been made on a Switched Rack PDU."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 283
+
+aruAlinkCommunicationEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ rARUStatusAruIndex, rARUStatusAruName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Remote ARU Communication Established.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the ARU number.
+ The fourth argument is the ARU name."
+ --#TYPE "APC ARU: Communication Established."
+ --#SUMMARY "Communication Established."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 284
+
+aruAlinkCommunicationLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ rARUStatusAruIndex, rARUStatusAruName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Remote ARU Communication Lost.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the ARU number.
+ The fourth argument is the ARU name."
+ --#TYPE "APC ARU: Communication Lost."
+ --#SUMMARY "Communication Lost."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 285
+
+aruFanFail TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ rARUStatusAruIndex, rARUStatusAruName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Remote ARU Fan Fail.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the ARU number.
+ The fourth argument is the ARU name."
+ --#TYPE "APC ARU: Fan Fail."
+ --#SUMMARY "Fan Fail."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 286
+
+aruFanFailCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ rARUStatusAruIndex, rARUStatusAruName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Remote ARU Fan Fail Cleared.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the ARU number.
+ The fourth argument is the ARU name."
+ --#TYPE "APC ARU: Fan Fail Cleared."
+ --#SUMMARY "Fan Fail Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 287
+
+aruSmokeAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ rARUStatusAruIndex, rARUStatusAruName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Remote ARU Smoke Alarm.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the ARU number.
+ The fourth argument is the ARU name."
+ --#TYPE "APC ARU: Smoke Alarm."
+ --#SUMMARY "Smoke Alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 288
+
+aruSmokeAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ rARUStatusAruIndex, rARUStatusAruName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Remote ARU Smoke Alarm Cleared.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the ARU number.
+ The fourth argument is the ARU name."
+ --#TYPE "APC ARU: Smoke Alarm Cleared."
+ --#SUMMARY "Smoke Alarm Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 289
+
+aruHighTemperatureAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ rARUStatusAruIndex, rARUStatusAruName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Remote ARU High Temperature Alarm.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the ARU number.
+ The fourth argument is the ARU name."
+ --#TYPE "APC ARU: High Temperature Alarm."
+ --#SUMMARY "High Temperature Alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 290
+
+aruHighTemperatureAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ rARUStatusAruIndex, rARUStatusAruName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Remote ARU High Temperature Alarm Cleared.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the ARU number.
+ The fourth argument is the ARU name."
+ --#TYPE "APC ARU: High Temperature Alarm Cleared."
+ --#SUMMARY "High Temperature Alarm Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 291
+
+aruExhaustTemperatureAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ rARUStatusAruIndex, rARUStatusAruName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Remote ARU Exhaust Temperature Alarm.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the ARU number.
+ The fourth argument is the ARU name."
+ --#TYPE "APC ARU: Exhaust Temperature Alarm."
+ --#SUMMARY "Exhaust Temperature Alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 292
+
+aruExhaustTemperatureAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ rARUStatusAruIndex, rARUStatusAruName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Remote ARU Exhaust Temperature Alarm Cleared.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the ARU number.
+ The fourth argument is the ARU name."
+ --#TYPE "APC ARU: Exhaust Temperature Alarm Cleared."
+ --#SUMMARY "Exhaust Temperature Alarm Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 293
+
+envAlinkCommunicationEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Remote Probe Communication Established.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the probe number.
+ The fourth argument is the probe name."
+ --#TYPE "APC ENV: Communication Established."
+ --#SUMMARY "Communication Established."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 294
+
+envAlinkCommunicationLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Remote Probe Communication Lost.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the probe number.
+ The fourth argument is the probe name."
+ --#TYPE "APC ENV: Communication Lost."
+ --#SUMMARY "Communication Lost."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 295
+
+emsAlinkPowerOverload TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Alink Power Overload.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC EMS: Alink Power Overload."
+ --#SUMMARY "Alink Power Overload."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 296
+
+emsAlinkPowerOverloadCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Alink Power Overload Cleared.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC EMS: Alink Power Overload Cleared."
+ --#SUMMARY "Alink Power Overload Cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 297
+
+upsOutletGroupTurnedOn TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { upsOutletGroupControlIndex, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The specified Outlet Group turned on."
+ --#TYPE "APC UPS: Outlet Group turned on."
+ --#SUMMARY "Outlet Group turned on"
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 298
+
+upsOutletGroupTurnedOff TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { upsOutletGroupControlIndex, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The specified Outlet Group turned off."
+ --#TYPE "APC UPS: Outlet Group turned off."
+ --#SUMMARY "Outlet Group turned off."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 299
+
+smwCriticalCondition TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsGauge, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A Symmetra MW UPS critical condition has been detected.
+ The first variable is the fault condition."
+ --#TYPE "APC Symmetra MW UPS: A critical condition has been detected."
+ --#SUMMARY "A critical condition has been detected."
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 300
+
+smwCriticalConditionCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsGauge, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Symmetra MW UPS critical condition has been cleared.
+ The first variable is the fault condition."
+ --#TYPE "APC Symmetra MW UPS: A critical condition has been cleared."
+ --#SUMMARY "A critical condition has been cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 301
+
+smwWarningCondition TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsGauge, mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Symmetra MW UPS warning condition has been detected.
+ The first variable is the fault condition."
+ --#TYPE "APC Symmetra MW UPS: A warning condition has been detected."
+ --#SUMMARY "A warning condition has been detected."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 302
+
+smwWarningConditionCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsGauge, mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Symmetra MW UPS warning condition has been cleared.
+ The first variable is the fault condition."
+ --#TYPE "APC Symmetra MW UPS: A warning condition has been cleared."
+ --#SUMMARY "A warning condition has been cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 303
+
+smwInformationalCondition TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsGauge, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Symmetra MW UPS informational condition has been detected.
+ The first variable is the fault condition."
+ --#TYPE "APC Symmetra MW UPS: Informational condition detected."
+ --#SUMMARY "An informational condition has been detected."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 304
+
+smwInformationalConditionCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsGauge, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Symmetra MW UPS informational condition has been cleared.
+ The first variable is the fault condition."
+ --#TYPE "APC Symmetra MW UPS: Informational condition cleared."
+ --#SUMMARY "An informational condition has been cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 305
+
+airCriticalCondition TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: An Air critical condition was detected.
+ The first variable is the error condition text message.
+ The second variable is the error number."
+ --#TYPE "APC Air: A critical condition was detected. "
+ --#SUMMARY "A critical condition was detected. "
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 306
+
+airCriticalConditionCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An Air critical condition was cleared.
+ The first variable is the error condition text message.
+ The second variable is the error number."
+ --#TYPE "APC Air: A critical condition was cleared. "
+ --#SUMMARY "A critical condition was cleared. "
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 307
+
+airWarningCondition TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: An Air warning condition was detected.
+ The first variable is the error condition text message.
+ The second variable is the error number."
+ --#TYPE "APC Air: A warning condition was detected. "
+ --#SUMMARY "A warning condition was detected. "
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 308
+
+airWarningConditionCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: An Air warning condition was cleared.
+ The first variable is the error condition text message.
+ The second variable is the error number."
+ --#TYPE "APC Air: A warning condition was cleared. "
+ --#SUMMARY "A warning condition was cleared. "
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 309
+
+airInformationalCondition TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An Air informational condition was detected.
+ The first variable is the error condition text message.
+ The second variable is the error number."
+ --#TYPE "APC Air: Informational condition detected. "
+ --#SUMMARY "An informational condition was detected. "
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 310
+
+airInformationalConditionCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An Air informational condition was cleared.
+ The first variable is the error condition text message.
+ The second variable is the error number."
+ --#TYPE "APC Air: Informational condition was cleared. "
+ --#SUMMARY "An informational condition was cleared. "
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 311
+
+-- xPDU Traps (part 1)
+
+xPDUInputVoltageLowAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "WARNING: Three-phase input voltage to the device is outside the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase
+ (1=L1-N, 2=L2-N, 3=L3-N, 4=unused, 5=L1-L2, 6=L2-L3, 7=L3-L1).
+ The fourth argument is the measured voltage in tenths of Volts.
+ The fifth argument is the threshold, in tenths of Volts, from which the alarm was generated."
+ --#TYPE "APC XPDU: Main input voltage out-of-range alarm."
+ --#SUMMARY "Input voltage is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 312
+
+xPDUInputVoltageLowAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Three-phase input voltage to the device is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1-N, 2=L2-N, 3=L3-N, 4=unused, 5=L1-L2, 6=L2-L3, 7=L3-L1).
+ The fourth argument is the measured voltage in tenths of Volts."
+ --#TYPE "APC XPDU: Main input voltage back in range."
+ --#SUMMARY "Input voltage in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 313
+
+
+xPDUInputVoltageHighAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "WARNING: Three-phase input voltage to the device is outside the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase
+ (1=L1-N, 2=L2-N, 3=L3-N, 4=unused, 5=L1-L2, 6=L2-L3, 7=L3-L1).
+ The fourth argument is the measured voltage in tenths of Volts.
+ The fifth argument is the threshold, in tenths of Volts, above which the alarm was generated."
+ --#TYPE "APC XPDU: Main input voltage out-of-range alarm."
+ --#SUMMARY "Input voltage is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 314
+
+xPDUInputVoltageHighAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Three-phase input voltage to the device is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1-N, 2=L2-N, 3=L3-N, 4=unused, 5=L1-L2, 6=L2-L3, 7=L3-L1).
+ The fourth argument is the measured voltage in tenths of Volts."
+ --#TYPE "APC XPDU: Main input voltage back in range."
+ --#SUMMARY "Input voltage in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 315
+
+xPDUBypassVoltageLowAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "WARNING: Three-phase bypass input voltage to the device is outside the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1-N, 2=L2-N, 3=L3-N).
+ The fourth argument is the measured voltage in tenths of Volts.
+ The fifth argument is the threshold, in tenths of Volts, from which the alarm was generated."
+ --#TYPE "APC XPDU: Bypass input voltage out-of-range alarm."
+ --#SUMMARY "Bypass input voltage is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 316
+
+xPDUBypassVoltageLowAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Three-phase bypass input voltage to the device is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1-N, 2=L2-N, 3=L3-N).
+ The fourth argument is the measured voltage in tenths of Volts."
+ --#TYPE "APC XPDU: Bypass input voltage back in range."
+ --#SUMMARY "Bypass input voltage in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 317
+
+xPDUBypassVoltageHighAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "WARNING: Three-phase bypass input voltage to the device is outside the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1-N, 2=L2-N, 3=L3-N).
+ The fourth argument is the measured voltage in tenths of Volts.
+ The fifth argument is the threshold, in tenths of Volts, above which the alarm was generated."
+ --#TYPE "APC XPDU: Bypass input voltage out-of-range alarm."
+ --#SUMMARY "Bypass input voltage is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 318
+
+xPDUBypassVoltageHighAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Three-phase bypass input voltage to the device is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1-N, 2=L2-N, 3=L3-N).
+ The fourth argument is the measured voltage in tenths of Volts."
+ --#TYPE "APC XPDU: Bypass input voltage back in range."
+ --#SUMMARY "Bypass input voltage in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 319
+
+xPDUOutputVoltageLowAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The device three-phase output voltage of the device is outside the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1-N, 2=L2-N, 3=L3-N).
+ The fourth argument is the measured voltage in tenths of Volts.
+ The fifth argument is the threshold, in tenths of Volts, from which the alarm was generated."
+ --#TYPE "APC XPDU: Output voltage out-of-range alarm."
+ --#SUMMARY "Output voltage is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 320
+
+xPDUOutputVoltageLowAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The devices three-phase output voltage is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1-N, 2=L2-N, 3=L3-N).
+ The fourth argument is the measured voltage in tenths of Volts."
+ --#TYPE "APC XPDU: Output voltage back in range."
+ --#SUMMARY "Output voltage in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 321
+
+xPDUOutputVoltageHighAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The device three-phase output voltage of the device is outside the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1-N, 2=L2-N, 3=L3-N).
+ The fourth argument is the measured voltage in tenths of Volts.
+ The fifth argument is the threshold, in tenths of Volts, above which the alarm was generated."
+ --#TYPE "APC XPDU: Output voltage out-of-range alarm."
+ --#SUMMARY "Output voltage is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 322
+
+xPDUOutputVoltageHighAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The devices three-phase output voltage is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1-N, 2=L2-N, 3=L3-N).
+ The fourth argument is the measured voltage in tenths of Volts."
+ --#TYPE "APC XPDU: Output voltage back in range."
+ --#SUMMARY "Output voltage in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 323
+
+xPDUOutputCurrentLowAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The devices three-phase load current is outside the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1, 2=L2, 3=L3).
+ The fourth argument is the measured current in tenths of Amps.
+ The fifth argument is the threshold, in Amps, from which the alarm was generated."
+ --#TYPE "APC XPDU: Output (load) current out-of-range alarm."
+ --#SUMMARY "Output current is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 324
+
+xPDUOutputCurrentLowAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The devices three-phase output current is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1, 2=L2, 3=L3).
+ The fourth argument is the measured current in tenths of Amps."
+ --#TYPE "APC XPDU: Output (load) current back in range."
+ --#SUMMARY "Output current in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 325
+
+xPDUOutputCurrentHighAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The devices three-phase load current is outside the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1, 2=L2, 3=L3).
+ The fourth argument is the measured current in tenths of Amps.
+ The fifth argument is the threshold, in Amps, above which the alarm was generated."
+ --#TYPE "APC XPDU: Output (load) current out-of-range alarm."
+ --#SUMMARY "Output current is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 326
+
+xPDUOutputCurrentHighAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The devices three-phase output current is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1, 2=L2, 3=L3).
+ The fourth argument is the measured current in tenths of Amps."
+ --#TYPE "APC XPDU: Output (load) current back in range."
+ --#SUMMARY "Output current in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 327
+
+xPDUOutputFrequencyAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The devices output frequency is outside the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the frequency deviation from the nominal in tenths of Hertz."
+ --#TYPE "APC XPDU: Output frequency out-of-range alarm."
+ --#SUMMARY "Output frequency is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 328
+
+xPDUOutputFrequencyAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The devices output frequency is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XPDU: Output frequency back in range."
+ --#SUMMARY "Output frequency in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 329
+
+xPDUSystemGroundCurrentAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The devices earth ground current is over the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the measured current in tenths of Amps."
+ --#TYPE "APC XPDU: Earth ground current over range alarm."
+ --#SUMMARY "Earth ground current is over limit."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 330
+
+xPDUSystemGroundCurrentAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The devices earth ground current is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the measured current in tenths of Amps."
+ --#TYPE "APC XPDU: Earth ground current back in range."
+ --#SUMMARY "Earth ground current in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 331
+
+xPDUInputContactStateAbnormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsString02, mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "WARNING: A user input contact on the device has changed to its abnormal state.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the input contact number.
+ The fourth argument is the input contact name.
+ The fifth argument is the input contact state (1=OPEN, 2=CLOSED).
+ The sixth argument is the configured normal input contact state (1=OPEN, 2=CLOSED)."
+ --#TYPE "APC XPDU: Input contact has changed to its abnormal state."
+ --#SUMMARY "Input contact has changed to its abnormal state."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 332
+
+xPDUInputContactStateNormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsString02, mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A user input contact on the device has changed to its normal state.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the input contact number.
+ The fourth argument is the input contact name.
+ The fifth argument is the input contact state (1=CLOSED, 2=OPEN).
+ The sixth argument is the configured normal input contact state (1=OPEN, 2=CLOSED)."
+ --#TYPE "APC XPDU: Input contact has changed to its normal state."
+ --#SUMMARY "Input contact has changed to its normal state."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 333
+
+xPDUOutputRelayStateAbnormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsString02, mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "WARNING: An Output Relay on the device has changed to its abnormal state.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the Output Relay number.
+ The fourth argument is the Output Relay name.
+ The fifth argument is the current Output Relay state (1=OPEN, 2=CLOSED).
+ The sixth argument is the configured normal Output Relay state (1=OPEN, 2=CLOSED)."
+ --#TYPE "APC XPDU: Output Relay has changed to its abnormal state."
+ --#SUMMARY "Output Relay has changed to its abnormal state."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 334
+
+xPDUOutputRelayStateNormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsString02, mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: An Output Relay on the device has changed to its normal state.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the Output Relay number.
+ The fourth argument is the Output Relay name.
+ The fifth argument is the current Output Relay state (1=OPEN, 2=CLOSED).
+ The sixth argument is the configured normal Output Relay state (1=OPEN, 2=CLOSED)."
+ --#TYPE "APC XPDU: Output Relay has changed to its normal state."
+ --#SUMMARY "Output Relay has changed to its normal state."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 335
+
+xPDUCoolingFanAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The device's internal cooling fans have failed.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XPDU: Cooling fan failure alarm."
+ --#SUMMARY "Cooling fan failure."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 336
+
+xPDUCoolingFanAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The device's cooling fans are now functioning properly.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XPDU: Cooling fan alarm cleared."
+ --#SUMMARY "Cooling fan alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 337
+
+xPDUTransformerTempAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The device's isolation transformer is over temperature.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XPDU: Isolation transformer over temperature alarm."
+ --#SUMMARY "Transformer temp alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 338
+
+xPDUTransformerTempAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The device's isolation transformer is no longer over temperature.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XPDU: Isolation transformer over temperature alarm cleared."
+ --#SUMMARY "Transformer temp alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 339
+
+xPDUBranchCurrentLowAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The current in a branch circuit is outside the limits specified for that
+ branch circuit.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the panel position of the branch circuit (1-based index).
+ The fourth argument is the measured current in tenths of Amps.
+ The fifth argument is the threshold, in tenth of Amps, from which the alarm was generated."
+ --#TYPE "APC XPDU: Branch circuit current out-of-range alarm."
+ --#SUMMARY "Branch circuit current is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 340
+
+xPDUBranchCurrentLowAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The current in a branch circuit is back within the limits
+ specified for that branch circuit.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the panel position of the branch circuit (1-based index).
+ The fourth argument is the measured current in tenths of Amps."
+ --#TYPE "APC XPDU: Branch circuit current back in range."
+ --#SUMMARY "Branch circuit current in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 341
+
+xPDUBranchCurrentHighAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The current in a branch circuit is outside the limits specified for that
+ branch circuit.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the panel position of the branch circuit (1-based index).
+ The fourth argument is the measured current in tenths of Amps.
+ The fifth argument is the threshold, in tenth of Amps, above which the alarm was generated."
+ --#TYPE "APC XPDU: Branch circuit current out-of-range alarm."
+ --#SUMMARY "Branch circuit current is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 342
+
+xPDUBranchCurrentHighAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The current in a branch circuit is back within the limits
+ specified for that branch circuit.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the panel position of the branch circuit (1-based index).
+ The fourth argument is the measured current in tenths of Amps."
+ --#TYPE "APC XPDU: Branch circuit current back in range."
+ --#SUMMARY "Branch circuit current in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 343
+
+
+xPDUInternalCommError TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: There is an internal communication error in the device.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XPDU: Internal communication error."
+ --#SUMMARY "Internal communication error."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 344
+
+emsHardwareStateAbnormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The device's hardware is improperly configured and operating outside
+ normal bounds for the hardware. This can be caused by improper devices being
+ connected to the EMS ports or Alink Current limit detection."
+ --#TYPE "APC EMS: Hardware is in an abnormal state."
+ --#SUMMARY "Hardware is in an abnormal state."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 345
+
+emsHardwareStateNormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The device's hardware is in its normal operational state.
+ The first argument is the host device serial number."
+ --#TYPE "APC EMS: Hardware is in a normal state."
+ --#SUMMARY "Hardware is in its normal state."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 346
+
+ceSevereCondition TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A Custom Event severe condition was detected.
+ The first variable is the custom event text message.
+ The second variable is the custom event number."
+ --#TYPE "APC CustomEvent: A severe condition was detected. "
+ --#SUMMARY "A severe condition was detected. "
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 347
+
+ceSevereConditionCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Custom Event severe condition was cleared.
+ The first variable is the custom event text message.
+ The second variable is the custom event number."
+ --#TYPE "APC CustomEvent: A severe condition was cleared. "
+ --#SUMMARY "A severe condition was cleared. "
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 348
+
+ceWarningCondition TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Custom Event warning condition was detected.
+ The first variable is the custom event text message.
+ The second variable is the custom event number."
+ --#TYPE "APC CustomEvent: A warning condition was detected. "
+ --#SUMMARY "A warning condition was detected. "
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 349
+
+ceWarningConditionCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Custom Event warning condition was cleared.
+ The first variable is the custom event text message.
+ The second variable is the custom event number."
+ --#TYPE "APC CustomEvent: A warning condition was cleared. "
+ --#SUMMARY "A warning condition was cleared. "
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 350
+
+ceInformationalCondition TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Custom Event informational condition was detected.
+ The first variable is the custom event text message.
+ The second variable is the custom event number."
+ --#TYPE "APC CustomEvent: Informational condition detected. "
+ --#SUMMARY "An informational condition was detected. "
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 351
+
+ceInformationalConditionCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Custom Event informational condition was cleared.
+ The first variable is the custom event text message.
+ The second variable is the custom event number."
+ --#TYPE "APC CustomEvent: Informational condition was cleared. "
+ --#SUMMARY "An informational condition was cleared. "
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 352
+
+upsInternalOverTemperature TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "WARNING: The internal over temperature condition exists."
+ --#TYPE "APC UPS: The internal over temperature condition exists."
+ --#SUMMARY "The internal over temperature condition exists."
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 353
+
+upsInternalOverTemperatureCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The internal over temperature condition cleared."
+ --#TYPE "APC UPS: The internal over temperature condition cleared."
+ --#SUMMARY "The internal over temperature condition cleared."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 354
+
+upsMpuReset TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The MPU has been reset."
+ --#TYPE "APC UPS: The MPU has been reset."
+ --#SUMMARY "The MPU has been reset."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 355
+
+upsOutputSwitchClosed TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The Output Switch is closed."
+ --#TYPE "APC UPS: The Output Switch is closed."
+ --#SUMMARY "The Output Switch is closed."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 356
+
+upsOutputSwitchOpened TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The Output Switch is open."
+ --#TYPE "APC UPS: The Output Switch is open."
+ --#SUMMARY "The Output Switch is open."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 357
+
+upsCalibrationStackChanged TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A calibration value in the stack was changed."
+ --#TYPE "APC UPS: A calibration value in the stack was changed."
+ --#SUMMARY "A calibration value in the stack was changed."
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 358
+
+
+-- Upgraded EMS now has more env traps
+
+envMaxTempThresholdViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Max temperature threshold violated on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: Max temperature threshold violation."
+ --#SUMMARY "Max temperature threshold violation."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 359
+
+envMaxTempThresholdViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Max temperature threshold violation cleared on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: Max temperature threshold violation cleared."
+ --#SUMMARY "Max temperature threshold violation cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 360
+
+envMinTempThresholdViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Min temperature threshold violated on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: Min temperature threshold violation."
+ --#SUMMARY "Min temperature threshold violation."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 361
+
+envMinTempThresholdViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Min temperature threshold violation cleared on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: Min temperature threshold violation cleared."
+ --#SUMMARY "Min temperature threshold violation cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 362
+
+envMaxHumidityThresholdViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeHumidity,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Max humidity threshold violated on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current humidity
+ The fourth argument is the probe number.
+ The fifth argument is the probe name."
+ --#TYPE "APC ENV: Max humidity threshold violation."
+ --#SUMMARY "Max humidity threshold violation."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 363
+
+envMaxHumidityThresholdViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeHumidity,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Max humidity threshold violation cleared on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current humidity.
+ The fourth argument is the probe number.
+ The fifth argument is the probe name."
+ --#TYPE "APC ENV: Max humidity threshold violation cleared."
+ --#SUMMARY "Max humidity threshold violation cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 364
+
+envMinHumidityThresholdViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeHumidity,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Min humidity threshold violated on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current humidity
+ The fourth argument is the probe number.
+ The fifth argument is the probe name."
+ --#TYPE "APC ENV: Min humidity threshold violation."
+ --#SUMMARY "Min humidity threshold violation."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 365
+
+envMinHumidityThresholdViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeHumidity,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Min humidity threshold violation cleared on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current humidity.
+ The fourth argument is the probe number.
+ The fifth argument is the probe name."
+ --#TYPE "APC ENV: Min humidity threshold violation cleared."
+ --#SUMMARY "Min humidity threshold violation cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 366
+
+envSTIncTempRateViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Short-term increasing temperature rate violated on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: Short-term inc. temp rate violation."
+ --#SUMMARY "Short-term inc. temp rate violation."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 367
+
+envSTIncTempRateViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Short-term increasing temperature rate cleared on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: Short-term inc. temp rate violation cleared."
+ --#SUMMARY "Short-term inc. temp rate violation cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 368
+
+envSTDecTempRateViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Short-term decreasing temperature rate violated on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: Short-term dec. temp rate violation."
+ --#SUMMARY "Short-term dec. temp rate violation."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 369
+
+envSTDecTempRateViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Short-term decreasing temperature rate cleared on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: Short-term dec. temp rate violation cleared."
+ --#SUMMARY "Short-term dec. temp rate violation cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 370
+
+envLTIncTempRateViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Long-term increasing temperature rate violated on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: Long-term inc. temp rate violation."
+ --#SUMMARY "Long-term inc. temp rate violation."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 371
+
+envLTIncTempRateViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Long-term increasing temperature rate cleared on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: Long-term inc. temp rate violation cleared."
+ --#SUMMARY "Long-term inc. temp rate violation cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 372
+
+envLTDecTempRateViolation TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Long-term decreasing temperature rate violated on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: Long-term dec. temp rate violation."
+ --#SUMMARY "Long-term dec. temp rate violation."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 373
+
+envLTDecTempRateViolationCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { emsIdentSerialNumber, emsIdentEMSName, emsProbeStatusProbeTemperature, emsStatusSysTempUnits,
+ emsProbeStatusProbeIndex, emsProbeStatusProbeName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Long-term decreasing temperature rate cleared on the probe.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the current temperature.
+ The fourth argument is the temperature scale.
+ The fifth argument is the probe number.
+ The sixth argument is the probe name."
+ --#TYPE "APC ENV: Long-term dec. temp rate violation cleared."
+ --#SUMMARY "Long-term dec. temp rate violation cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 374
+
+-- Battery Management System Traps
+
+bmsCriticalCondition TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A Battery Management System critical condition was detected.
+ The first variable is the error condition text message.
+ The second variable is the error number."
+ --#TYPE "APC BMS: A critical condition was detected. "
+ --#SUMMARY "A critical condition was detected. "
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 375
+
+bmsCriticalConditionCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Battery Management System critical condition was cleared.
+ The first variable is the error condition text message.
+ The second variable is the error number."
+ --#TYPE "APC BMS: A critical condition was cleared. "
+ --#SUMMARY "A critical condition was cleared. "
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 376
+
+bmsWarningCondition TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Battery Management System warning condition was detected.
+ The first variable is the error condition text message.
+ The second variable is the error number."
+ --#TYPE "APC BMS: A warning condition was detected. "
+ --#SUMMARY "A warning condition was detected. "
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 377
+
+bmsWarningConditionCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: A Battery Management System warning condition was cleared.
+ The first variable is the error condition text message.
+ The second variable is the error number."
+ --#TYPE "APC BMS: A warning condition was cleared. "
+ --#SUMMARY "A warning condition was cleared. "
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 378
+
+bmsInformationalCondition TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Battery Management System informational condition was detected.
+ The first variable is the error condition text message.
+ The second variable is the error number."
+ --#TYPE "APC BMS: Informational condition detected. "
+ --#SUMMARY "An informational condition was detected. "
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 379
+
+bmsInformationalConditionCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsString02, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A Battery Management System informational condition was cleared.
+ The first variable is the error condition text message.
+ The second variable is the error number."
+ --#TYPE "APC BMS: Informational condition was cleared. "
+ --#SUMMARY "An informational condition was cleared. "
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 380
+
+-- xATS Traps
+
+xATSOutputVoltageLowAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The device three-phase output voltage of the device is outside the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1-N, 2=L2-N, 3=L3-N, 4=unused, 5=L1-L2, 6=L2-L3, 7=L3-L1).
+ The fourth argument is the measured voltage in tenths of Volts.
+ The fifth argument is the threshold, in tenths of Volts, from which the alarm was generated."
+ --#TYPE "APC XATS: Output voltage out-of-range alarm."
+ --#SUMMARY "Output voltage is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 381
+
+xATSOutputVoltageLowAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The devices three-phase output voltage is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1-N, 2=L2-N, 3=L3-N, 4=unused, 5=L1-L2, 6=L2-L3, 7=L3-L1).
+ The fourth argument is the measured voltage in tenths of Volts."
+ --#TYPE "APC XATS: Output voltage back in range."
+ --#SUMMARY "Output voltage in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 382
+
+xATSOutputVoltageHighAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The device three-phase output voltage of the device is outside the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1-N, 2=L2-N, 3=L3-N, 4=unused, 5=L1-L2, 6=L2-L3, 7=L3-L1).
+ The fourth argument is the measured voltage in tenths of Volts.
+ The fifth argument is the threshold, in tenths of Volts, above which the alarm is generated."
+ --#TYPE "APC XATS: Output voltage out-of-range alarm."
+ --#SUMMARY "Output voltage is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 383
+
+xATSOutputVoltageHighAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The devices three-phase output voltage is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1-N, 2=L2-N, 3=L3-N, 4=unused, 5=L1-L2, 6=L2-L3, 7=L3-L1).
+ The fourth argument is the measured voltage in tenths of Volts."
+ --#TYPE "APC XATS: Output voltage back in range."
+ --#SUMMARY "Output voltage in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 384
+
+xATSOutputCurrentLowAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The devices three-phase load current is outside the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1, 2=L2, 3=L3, 4=Neutral, 5=L1-2, 6=L2-3, 7=L3-1).
+ The fourth argument is the measured current in Amps.
+ The fifth argument is the threshold, in Amps, from which the alarm was generated."
+ --#TYPE "APC XATS: Output (load) current out-of-range alarm."
+ --#SUMMARY "Output current is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 385
+
+xATSOutputCurrentLowAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The devices three-phase output current is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1, 2=L2, 3=L3, 4=Neutral).
+ The fourth argument is the measured current in Amps."
+ --#TYPE "APC XATS: Output (load) current back in range."
+ --#SUMMARY "Output current in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 386
+
+xATSOutputCurrentHighAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The devices three-phase load current is outside the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1, 2=L2, 3=L3, 4=Neutral).
+ The fourth argument is the measured current in Amps.
+ The fifth argument is the threshold, in Amps, from which the alarm was generated."
+ --#TYPE "APC XATS: Output (load) current out-of-range alarm."
+ --#SUMMARY "Output current is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 387
+
+xATSOutputCurrentHighAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The devices three-phase output current is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1, 2=L2, 3=L3, 4=Neutral).
+ The fourth argument is the measured current in Amps."
+ --#TYPE "APC XATS: Output (load) current back in range."
+ --#SUMMARY "Output current in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 388
+
+
+xATSOutputFrequencyAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The devices output frequency is outside the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the frequency deviation from the nominal in tenths of Hertz.
+ The fourth argument is the frequency deviation threshold in tenths of Hertz,
+ from which the alarm was generated."
+ --#TYPE "APC XATS: Output frequency out-of-range alarm."
+ --#SUMMARY "Output frequency is out-of-range."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 389
+
+xATSOutputFrequencyAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The devices output frequency is back within the specified limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Output frequency back in range."
+ --#SUMMARY "Output frequency in range."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 390
+
+xATSInternalCommError TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: There is an internal communication error in the device.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Internal communication error."
+ --#SUMMARY "Internal communication error."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 391
+
+xATSInternalCommErrorCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Internal communication has been restored.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Internal Communication error cleared."
+ --#SUMMARY "ATS Communication error cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 392
+
+xATSDataCommMismatchError TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A data incompatibility exists within the device. This
+ is typically the result of mismatches between firmware revisions
+ of the transfer switch controller and the Network Management interface.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Data mismatch error."
+ --#SUMMARY "ATS data mismatch error."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 393
+
+xATSDataCommMismatchErrorCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The internal data incompatibility has been resolved.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: data mismatch error cleared."
+ --#SUMMARY "ATS data mismatch error cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 394
+
+xATSGenCommLost TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The XATS cannot communicate with the generator.
+ This will make unavailable all the xATSGenerator OIDs.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: No communication with generator."
+ --#SUMMARY "ATS/Generator communication lost."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 395
+
+xATSGenCommEstablished TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The XATS has established communication with the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Communication with generator established."
+ --#SUMMARY "ATS/generator communication established."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 396
+
+xATSNeutralPosition TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger,
+ mtrapargsString }
+ DESCRIPTION
+ "WARNING: XATS has transferred to neutral position.
+ In this position neither Source 1 nor Source 2 is selected,
+ and the XATS will have no output voltage.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the mode in which the switch is operating
+ (1=Auto, 2=Not-in-Auto, Abnormal Condition 3=Not-in-Auto, manual)."
+ --#TYPE "APC XATS: Transferred to the neutral (no output power) position."
+ --#SUMMARY "Transferred to neutral."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 397
+
+xATSSwitchTransferEvent TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: XATS has transferred from one source to the other.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the mode in which the switch is operating.
+ (1=Auto, 2=Not-in-Auto, Abnormal Condition 3=Not-in-Auto, manual).
+ The fourth argument is the input source selected (1=Source 1, 2=Source 2).
+ The fifth argument is type of transfer that took place. (1=Closed, 2=Open, 3=Unknown)"
+ --#TYPE "APC XATS: Transferred from Source-X to Source-Y."
+ --#SUMMARY "Source-to-Source transfer."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 398
+
+xATSInternalATSFault TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: An internal XATS fault has been detected.
+ The XATS may have forced itself to not-in-auto mode (abnormal condition),
+ as indicated by the xATSSwitchStatusAutoSwitchOperationalMode OID.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument indicates the detected fault.
+
+ 1=Cannot Close S1
+ 2=Cannot Close S2
+ 3=Cannot Open S1
+ 4=Cannot Open S2
+ 5=Cannot Trip Open S1
+ 6=Cannot Trip Open S2
+ 7=Start Contact Failure
+ 8=Voltage Sensing Failure"
+
+ --#TYPE "APC XATS: Internal fault detected."
+ --#SUMMARY "ATS internal fault detected."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 399
+
+xATSInternalATSFaultCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The detected internal XATS fault has been cleared.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument indicates the detected fault.
+
+ 1=Cannot Close S1
+ 2=Cannot Close S2
+ 3=Cannot Open S1
+ 4=Cannot Open S2
+ 5=Cannot Trip Open S1
+ 6=Cannot Trip Open S2
+ 7=Start Contact Failure
+ 8=Voltage Sensing Failure"
+
+ --#TYPE "APC XATS: Internal fault cleared."
+ --#SUMMARY "ATS internal fault cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 400
+
+xATSEngineStartAsserted TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The XATS has asserted the Engine Start contact.
+ This should result in the generator producing output voltage.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument indicates the reason that the start signal was asserted
+ 1=Unknown, 2=S1 Low Voltage, 3=S1 High Voltage, 4=S1 Line Imbalance,
+ 5=S1 Freq Range, 6=S1 Bad Rotation."
+ --#TYPE "APC XATS: Engine Start signal asserted."
+ --#SUMMARY "Engine Start asserted."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 401
+
+xATSEngineStopAsserted TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The XATS has de-asserted the Engine Start contact.
+ This should result in the generator shutting down, and producing no output voltage.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Engine Stop signal asserted."
+ --#SUMMARY "Engine Stop asserted."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 402
+
+xATSStartFailure TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generator failed to start. After assertion of the
+ Engine Start signal, the quality of Source 2 was not seen as good.
+ This alarm can be cleared using the xATSSwitchStatusClearLatchedAlarms OID.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument indicates the line quality at S2
+ 1=Unknown, 2=S2 Low Voltage, 3=S2 High Voltage, 4=S2 Line Imbalance,
+ 4=S2 Freq Range, 5=S2 Bad Rotation."
+ --#TYPE "APC XATS: Generator failed to start alarm."
+ --#SUMMARY "Generator failed to start."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 403
+
+xATSStopFailure TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The generator failed to stop. After de-assertion of the
+ Engine Start signal, the quality of Source 2 continued to be seen as good.
+ This alarm can be cleared using the xATSSwitchStatusClearLatchedAlarms OID.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Generator failed to stop alarm."
+ --#SUMMARY "Generator failed to stop."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 404
+
+xATSNotInAutomaticMode TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Automatic Transfer Switch is not in automatic mode.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The xATSSwitchStatusAutoSwitchStatus OID and the
+ xATSSwitchStatusAutoSwitchOperationalMode OID
+ can provide more information about the state of the XATS."
+ --#TYPE "APC XATS: XATS is not-in-automatic mode."
+ --#SUMMARY "ATS not in auto."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 405
+
+xATSNotInAutomaticModeCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Automatic Transfer Switch is in automatic mode.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: XATS in auto mode."
+ --#SUMMARY "ATS in auto mode."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 406
+
+xATSEpoTripped TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The device's Emergency Power Off (EPO) circuit is tripped.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Emergency Power Off (EPO) tripped."
+ --#SUMMARY "EPO tripped."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 407
+
+xATSEpoReset TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The device's Emergency Power Off (EPO) circuit has been
+ reset to the armed position.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Emergency Power Off (EPO) reset."
+ --#SUMMARY "EPO armed."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 408
+
+xATSEpoTestMode TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The device's Emergency Power Off (EPO) circuit has been
+ switched back to the test position.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Emergency Power Off (EPO) in test mode."
+ --#SUMMARY "EPO disabled."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 409
+
+xATSEpoArmed TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The device's Emergency Power Off (EPO) circuit has been
+ switched back to the armed position.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Emergency Power Off (EPO) enabled."
+ --#SUMMARY "EPO armed."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 410
+
+xATSTestInitiated TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A scheduled test has been initiated.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the type of test initiated (1=scheduled, 2=manual)."
+ --#TYPE "APC XATS: Test initiated."
+ --#SUMMARY "Test initiated."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 411
+
+xATSTestCancelled TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The scheduled test has been canceled
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the type of test initiated (1=scheduled, 2=manual)."
+ --#TYPE "APC XATS: Test cancelled."
+ --#SUMMARY "Test cancelled."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 412
+
+xATSTestFailed TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The initiated test has failed.
+ This alarm can be cleared using the xATSSwitchStatusClearLatchedAlarms OID.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Initiated test failed."
+ --#SUMMARY "Initiated test failed."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 413
+
+xATSTestPassed TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The initiated test has passed
+ switched back to the armed position.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Initiated test passed."
+ --#SUMMARY "Initiated test passed."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 414
+
+xATSInputContactStateAbnormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger,
+ mtrapargsString02, mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A user input contact on the device has changed to its abnormal state.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the input contact number.
+ The fourth argument is the input contact name.
+ The fifth argument is the input contact state (1=OPEN, 2=CLOSED).
+ The sixth argument is the configured normal input contact state (1=OPEN, 2=CLOSED)."
+ --#TYPE "APC XATS: Input contact has changed to its abnormal state."
+ --#SUMMARY "Input contact has changed to its abnormal state."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 415
+
+xATSInputContactStateNormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger,
+ mtrapargsString02, mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A user input contact on the device has changed to its normal state.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the input contact number.
+ The fourth argument is the input contact name.
+ The fifth argument is the input contact state (1=OPEN, 2=CLOSED).
+ The sixth argument is the configured normal input contact state (1=OPEN, 2=CLOSED)."
+ --#TYPE "APC XATS: Input contact has changed to its normal state."
+ --#SUMMARY "Input contact has changed to its normal state."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 416
+
+xATSRemoteStartContactMismatch TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The state of the generator's Remote Start input
+ and the ATS's Engine Start output do not match.
+ This indicates something wrong in the Engine Start wiring,
+ which must be corrected. This condition will prevent the
+ generator from being started when needed.
+
+ (See also: xATSGeneratorStatusRemoteStart
+ and xATSSwitchStatusEngineStartSignal OIDs)
+
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Generator/ATS start contact mismatch."
+ --#SUMMARY "Generator/ATS start contact mismatch."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 417
+
+xATSRemoteStartContactMismatchCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Mismatch in the state of the generator's
+ Remote Start input and the ATS's Engine Start output as been resolved.
+ This indicates something wrong in the Engine Start wiring,
+ which must be corrected. This condition will prevent the
+ generator from being started when needed.
+
+ (See also: xATSGeneratorStatusRemoteStart
+ and xATSSwitchStatusEngineStartSignal OIDs)
+
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Generator/ATS start contact mismatch cleared."
+ --#SUMMARY "Generator/ATS start contact mismatch cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 418
+
+xATSDoorOpenAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The XATS exterior panel door is open.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Panel door is open alarm."
+ --#SUMMARY "Panel door open alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 419
+
+xATSDoorOpenAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The external door to the device is closed.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Panel door open alarm cleared."
+ --#SUMMARY "Panel door open alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 420
+
+xATSDCBackupAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The XATS's DC backup has been lost. The XATS will lose power
+ on Source 1 failure, causing the Engine Start signal to be asserted.
+ The XATS will then restart from Source 2.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: DC backup failure."
+ --#SUMMARY "ATS DC backup failure."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 421
+
+xATSDCBackupAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: DC backup alarm has been cleared in the device.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: DC backup alarm cleared."
+ --#SUMMARY "DC backup alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 422
+
+-- xATS Generator Traps
+
+xATSGeneratorLowCoolantLevelAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Low coolant level has been detected in the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator low coolant level alarm."
+ --#SUMMARY "Generator low coolant level alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 423
+
+xATSGeneratorLowCoolantLevelAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The detected low coolant level has been cleared in the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator low coolant level alarm cleared."
+ --#SUMMARY "Generator low coolant level alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 424
+
+xATSGeneratorVeryLowCoolantLevelAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Very low coolant level has been detected in the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator very low coolant level alarm."
+ --#SUMMARY "Generator very low coolant level alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 425
+
+xATSGeneratorVeryLowCoolantLevelAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The detected Very low coolant level has been cleared in the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator very low coolant level alarm cleared."
+ --#SUMMARY "Generator very low coolant level alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 426
+
+xATSGeneratorHighCoolantTempAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: High coolant temperature has been detected in the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator high coolant temperature alarm."
+ --#SUMMARY "Generator high coolant temperature alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 427
+
+xATSGeneratorHighCoolantTempAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The detected high coolant temperature has been cleared in the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator high coolant temperature alarm cleared."
+ --#SUMMARY "Generator high coolant temperature alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 428
+
+xATSGeneratorVeryHighCoolantTempAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Very high coolant temperature has been detected in the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator very high coolant temperature alarm."
+ --#SUMMARY "Generator very high coolant temperature alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 429
+
+xATSGeneratorVeryHighCoolantTempAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The Very high coolant temperature condition has been cleared in the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator very high coolant temperature alarm cleared."
+ --#SUMMARY "Generator very high coolant temperature alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 430
+
+xATSGeneratorLowCoolantTempAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: Low coolant temperature has been detected in the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator low coolant temperature alarm."
+ --#SUMMARY "Generator low coolant temperature alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 431
+
+xATSGeneratorLowCoolantTempAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The low coolant temperature condition has been cleared in the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator low coolant temperature alarm cleared."
+ --#SUMMARY "Generator low coolant temperature alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 432
+
+xATSGeneratorLowOilLevelAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Low oil level has been detected in the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator low oil level alarm."
+ --#SUMMARY "Generator low oil level alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 433
+
+xATSGeneratorLowOilLevelAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Low oil level alarm has been cleared in the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator low oil level alarm cleared."
+ --#SUMMARY "Generator low oil level alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 434
+
+xATSGeneratorLowBatteryVoltDuringCrankAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generator's battery voltage has been detected
+ as low while cranking the engine.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Low batt. voltage while cranking alarm."
+ --#SUMMARY "Generator low battery volts while cranking alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 435
+
+xATSGeneratorLowBatteryVoltDuringCrankAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The generator's low battery voltage while
+ cranking condition has been cleared.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "XGEN: Generator low batt. voltage while cranking alarm cleared."
+ --#SUMMARY "Generator low battery volts while cranking alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 436
+
+xATSGeneratorVeryLowBatteryVoltDuringCrankAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generator's battery voltage has been detected
+ as very low while cranking the engine.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "XGEN: Generator v.low battery voltage while cranking alarm."
+ --#SUMMARY "Generator v.low battery volts while cranking alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 437
+
+xATSGeneratorVeryLowBatteryVoltDuringCrankAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The generator's high battery voltage while
+ cranking condition has been cleared.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "XGEN: Generator v.low batt volt, while cranking alarm cleared."
+ --#SUMMARY "Generator v.low battery volts while cranking alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 438
+
+xATSGeneratorEStop TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generator's emergency stop input has been activated.
+ After the emergency stop signal has been removed, the E-Stop condition
+ must be cleared before the generator can be started again.
+ E-Stop conditions can only be cleared via the generator front panel.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code.
+ The fourth argument is the type of E-Stop (1=LOCAL, 2=REMOTE)."
+ --#TYPE "APC XGEN: Generator emergency stop engaged."
+ --#SUMMARY "Generator emergency stop engaged."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE NONOPERATIONAL
+ ::= 439
+
+xATSGeneratorEStopCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The generator's emergency stop condition has been cleared.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code.
+ The fourth argument is the type of E-Stop (1=LOCAL, 2=REMOTE)."
+ --#TYPE "APC XGEN: Generator emergency stop condition cleared."
+ --#SUMMARY "Generator emergency stop condition cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 440
+
+xATSGeneratorHighBatteryVolt TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The generator's battery voltage has been detected as high.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator high battery voltage."
+ --#SUMMARY "Generator high battery volts."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 441
+
+xATSGeneratorHighBatteryVoltCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The detected high battery voltage has been cleared, on the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator high battery voltage condition cleared."
+ --#SUMMARY "Generator high battery volts condition cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 442
+
+xATSGeneratorLowBatteryVolt TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generator's battery voltage has been detected as low.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator low battery voltage."
+ --#SUMMARY "Generator low battery volts."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 443
+
+xATSGeneratorLowBatteryVoltCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The detected low battery voltage has been cleared, on the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator low battery voltage condition cleared."
+ --#SUMMARY "Generator low battery volts condition cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 444
+
+xATSGeneratorControlSwitchNotAuto TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The control switch on the generator is not in auto position.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator not-in-automatic mode."
+ --#SUMMARY "Generator not-in-auto."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 445
+
+xATSGeneratorControlSwitchNotAutoCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The control switch on the generator is in auto position.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator automatic mode restored."
+ --#SUMMARY "Generator not-in-auto cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 446
+
+xATSGeneratorLowOilPressure TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generator's oil pressure has been detected as low.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator low oil pressure."
+ --#SUMMARY "Generator low oil pressure."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 447
+
+xATSGeneratorLowOilPressureCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The detected low oil pressure has been cleared, on the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator low oil pressure condition cleared."
+ --#SUMMARY "Generator low oil pressure condition cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 448
+
+xATSGeneratorVeryLowOilPressure TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generator's oil pressure has been detected as very low.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator v.low oil pressure."
+ --#SUMMARY "Generator v.low oil pressure."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 449
+
+xATSGeneratorVeryLowOilPressureCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The detected v.low oil pressure has been cleared, on the generator.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator v.low oil pressure condition cleared."
+ --#SUMMARY "Generator v.low oil pressure condition cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 450
+
+xATSGeneratorOverload TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generator is overloaded.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator is in overload event."
+ --#SUMMARY "Generator on overload event."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 451
+
+xATSGeneratorOverloadCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The generator is running within loading limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator is in overload event cleared."
+ --#SUMMARY "Generator on overload event cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 452
+
+xATSGeneratorLowACVEvent TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generator AC voltage is outside the acceptable bounds.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: State of the Generator ac voltage."
+ --#SUMMARY " State of the Generator ac voltage."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 453
+
+xATSGeneratorLowACVEventCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The generator AC voltage is within normal bounds.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: State of the Generator ac voltage cleared."
+ --#SUMMARY "State of the Generator ac voltage cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 454
+
+xATSGeneratorHighACVEvent TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generator AC voltage is outside the acceptable bounds.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: State of the Generator ac voltage."
+ --#SUMMARY " State of the Generator ac voltage."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 455
+
+xATSGeneratorHighACVEventCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The generator AC voltage is within normal bounds.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: State of the Generator ac voltage cleared."
+ --#SUMMARY "State of the Generator ac voltage cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 456
+
+xATSGeneratorOverspeed TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generator is running over the acceptable RPM.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator overspeed condition."
+ --#SUMMARY "Generator overspeed condition."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 457
+
+xATSGeneratorOverspeedCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The generator overspeed shutdown has been cleared.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator overspeed condition cleared."
+ --#SUMMARY "Generator overspeed condition cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 458
+
+xATSGeneratorEngineCold TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generator engine is cold, may not start.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator engine is cold, may not start."
+ --#SUMMARY "Generator engine is cold."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 459
+
+xATSGeneratorEngineColdCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The engine is not cold to start.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Engine is cold to start condition cleared."
+ --#SUMMARY "Engine is cold to start condition cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 460
+
+xATSGeneratorOutputBreakerOpen TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generators output breaker has been detected as open.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator output breaker open alarm."
+ --#SUMMARY "Generator output breaker open."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE NONOPERATIONAL
+ ::= 461
+
+xATSGeneratorOutputBreakerOpenCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The engine is not cold to start.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator output breaker open alarm cleared."
+ --#SUMMARY "Generator output breaker open cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 462
+
+xATSGeneratorLowFuelLevelAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The tank fuel level is below the limits specified
+ in the xATSGeneratorFuelSystemLowFuelLevelThreshold OID.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the measured fuel level in percent of full."
+ --#TYPE "APC XGEN: Low fuel level alarm."
+ --#SUMMARY "Generator low fuel level alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 463
+
+xATSGeneratorLowFuelLevelAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The tank fuel level is back above the specified limit.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XGEN: Low fuel level alarm cleared."
+ --#SUMMARY "Generator low fuel level alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 464
+
+xATSGeneratorVeryLowFuelLevelAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The tank fuel level is below the low threshold limits.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the measured tank fuel level in percent of full."
+ --#TYPE "APC XGEN: Very Low fuel level alarm."
+ --#SUMMARY "Generator very low fuel level alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 465
+
+xATSGeneratorVeryLowFuelLevelAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The detected low tank level has been cleared in the device.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XGEN: Very low fuel level alarm cleared."
+ --#SUMMARY "Generator very low fuel level alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 466
+
+xATSGeneratorLowRunTimeAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The estimated runtime is below the limits specified.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the estimated runtime in hours."
+ --#TYPE "APC XGEN: Low run time alarm."
+ --#SUMMARY "Generator low run time alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 467
+
+xATSGeneratorLowRunTimeAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The detected low runtime has been cleared in the device.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XGEN: Low run time alarm cleared."
+ --#SUMMARY "Generator low run time alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 468
+
+xATSGeneratorVeryLowRunTimeAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The estimated runtime is below the limits specified
+ in the xATSGeneratorFuelSystemVeryLowRunTimeThreshold OID.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the estimated runtime in hours."
+ --#TYPE "APC XGEN: Very low run time alarm."
+ --#SUMMARY "Generator very low run time alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 469
+
+xATSGeneratorVeryLowRunTimeAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The detected low runtime has been cleared in the device.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XGEN: Very low run time alarm cleared."
+ --#SUMMARY "Generator very low run time alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 470
+
+xATSGeneratorServiceDueAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The generator is due for scheduled service.
+ Generation of this alarm is based on calender days since
+ and/or actual generator run-hours since last service.
+ This alarm is cleared using the xATSGeneratorServiceResetRecord OID.
+
+ (See also: xATSGeneratorServiceCalendarIntervalThreshold
+ and xATSGeneratorServiceRunHoursThreshold OIDs)
+
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Generator scheduled maintenance is due."
+ --#SUMMARY "Generator maintenance due."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 471
+
+xATSGeneratorServiceDueAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The generator's service registers have been reset.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Generator service due alarm is cleared."
+ --#SUMMARY "Generator service alarm is cleard."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 472
+
+xATSGeneratorShutdown TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generator is shutdown.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator shutdown."
+ --#SUMMARY "Generator shutdown"
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 473
+
+xATSGeneratorShutdownCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The generator shutdown alarm is cleared.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator shutdown is cleared."
+ --#SUMMARY "Generator shutdown is cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 474
+
+xATSGeneratorBatteryCharger TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: The generator battery charger is nonfunctional.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator batt. charger is nonfunctional."
+ --#SUMMARY "Generator battery charger is nonfunctional"
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 475
+
+xATSGeneratorBatteryChargerCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: nonfunctionality of the generator battery is cleared.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: " Nonfunctionality of battery charger is cleared."
+ --#SUMMARY "non-functionality of Generator battery charger is cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 476
+
+xATSGeneratorGenericEvent TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: Any generic generator event.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generator generic event."
+ --#SUMMARY "Generator generic event."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 477
+
+xATSGeneratorGenericEventCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xATSIdentSerialNumber, xATSIdentProductName, mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Generated generic generator event is cleared.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the OEM's fault/event code."
+ --#TYPE "APC XGEN: Generic generator event is cleared."
+ --#SUMMARY "Generic generator event is cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 478
+
+-- xPDU Traps (part 2)
+
+xPDUInternalCommErrorCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Internal communication has been restored.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XPDU: Internal Communication error cleared."
+ --#SUMMARY "Communication error cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 479
+
+xPDUSystemStateAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName,
+ mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The PDU's breakers (Q1, Q2 & Q3) are in a configuration that might lead
+ to system unavailability. it may signify a temporary condition, when the breakers
+ are placed in an atypical manner as the user transitions to (UPS OPERATION or MAINTENANCE BYPASS)
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the type of alarm
+ (1=NO UPS INPUT, 2=NO PANEL FEED, 3=ATYPICAL BYPASS MODE)."
+ --#TYPE "APC XPDU: System state alarm ."
+ --#SUMMARY "PDU state alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 480
+
+xPDUSystemStateNormal TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName,
+ mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The PDU's breakers (Q1, Q2 & Q3) are set in a configuration
+ that is a non-alarm state.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the type of alarm (1=UPS OPERATION, 2=MAINTENANCE BYPASS)."
+ --#TYPE "APC XPDU: System state returned to normal."
+ --#SUMMARY "PDU state normal."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 481
+
+xPDUEpoTestMode TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "WARNING: The device's Emergency Power Off (EPO) circuit has been
+ switched back to the test position.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XPDU: Emergency Power Off (EPO) in test mode."
+ --#SUMMARY "EPO disabled."
+ --#ARGUMENTS { }
+ --#SEVERITY WARNING
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 482
+
+xPDUEpoArmed TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: The device's Emergency Power Off (EPO) circuit has been
+ switched back to the armed position.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XPDU: Emergency Power Off (EPO) enabled."
+ --#SUMMARY "EPO armed."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 483
+
+xPDUFuseBlownAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName,
+ mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: One or more fuses in this PDU have been detected as open.
+ These fuses are in the feed to the UPS associated with this PDU.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1, 2=L2, 3=L3)."
+ --#TYPE "APC XPDU: Check fuse alarm."
+ --#SUMMARY "Fuse detected opened."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 484
+
+xPDUFuseBlownAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName,
+ mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A previous check fuse alarm in this PDU has cleared.
+ These fuses are in the feed to the UPS associated with this PDU.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the phase (1=L1, 2=L2, 3=L3)."
+ --#TYPE "APC XPDU: Check fuse alarm cleared."
+ --#SUMMARY "Fuse alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 485
+
+xPDUBreakerPositionAlarm TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName,
+ mtrapargsInteger, mtrapargsInteger02, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: A PDU breaker is in a state that compromises system availability.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the breaker (1=MAIN INPUT, 2=BYPASS INPUT, 3=CROSS TIE).
+ The fourth argument is the breaker position (1=OPEN, 2=CLOSED)."
+ --#TYPE "APC XPDU: Breaker position alarm."
+ --#SUMMARY "Breaker position alarm."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 486
+
+xPDUBreakerPositionAlarmCleared TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName,
+ mtrapargsInteger, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A PDU breaker is no longer in a state that compromises system availability.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the breaker (1=MAIN INPUT, 2=BYPASS INPUT, 3=CROSS TIE)."
+ --#TYPE "APC XPDU: Breaker position alarm cleared."
+ --#SUMMARY "Breaker alarm cleared."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 487
+
+xPDUBreakerChangeEvent TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsInteger,
+ mtrapargsInteger02, mtrapargsInteger03, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: A system breaker or switch within the device has changed state.
+ They are generated when any of the Q1, Q2 or Q3 breakers have changed states.
+ The first argument is the host device serial number.
+ The second argument is the host device name.
+ The third argument is the breaker that has changed
+ (1=UPS FEED (Q1), 2=UPS OUTPUT(Q2), 3=MAINTENANCE BYPASS (Q3).
+ The fourth argument is the state of the breaker that has changed (1=OPEN, 2=CLOSED).
+ The fifth argument is a 8-bit field representing the state of all breakers in the system,
+ when any of one of the Q1, Q2 or Q3 breakers have changed state.
+
+ The bit map is represented in the following manner (b7, b6 ... b0)
+ b0 - UPS FEED (Q1)
+ b1 - MAINTENANCE BYPASS (Q3)
+ b2 - UPS OUTPUT (Q2)
+ b3 - MAIN INPUT
+ b4 - BYPASS INPUT
+ b5 - CROSS-TIE OUTPUT
+
+ Example: value of 60 (0x3C) indicates that the CROSS_TIE, BYPASS and MAIN INPUT, and Q2 breakers
+ are CLOSED and Q2, Q1 breakers are OPEN."
+ --#TYPE "APC XPDU: Breaker/switch change event."
+ --#SUMMARY "Breaker/switch change event."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 488
+
+xPDUControllerFirmwareUpdateTransferStart TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Start Controller firmware transfer in the device.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XPDU: Start controller firmware transfer."
+ --#SUMMARY "Start controller firmware transfer."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 489
+
+xPDUControllerFirmwareUpdateTransferComplete TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Transfer of Controller firmware was completed in the device.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XPDU: Controller firmware transfer completed."
+ --#SUMMARY "Controller firmware transfer completed."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 490
+
+xPDUControllerFirmwareUpdateTransferFailed TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Transfer of Controller firmware has failed in the PDU.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XPDU: Controller firmware transfer failed."
+ --#SUMMARY "Controller firmware transfer failed."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 491
+
+xATSControllerFirmwareUpdateTransferStart TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Start Controller firmware transfer in the device.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Start controller firmware transfer."
+ --#SUMMARY "Start controller firmware transfer."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 492
+
+xATSControllerFirmwareUpdateTransferComplete TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "INFORMATIONAL: Transfer of Controller firmware was completed in the device.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Controller firmware transfer completed."
+ --#SUMMARY "Controller firmware transfer completed."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 493
+
+xATSControllerFirmwareUpdateTransferFailed TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { xPDUIdentSerialNumber, xPDUIdentProductName, mtrapargsString }
+ DESCRIPTION
+ "SEVERE: Transfer of Controller firmware has failed in the device.
+ The first argument is the host device serial number.
+ The second argument is the host device name."
+ --#TYPE "APC XATS: Controller firmware transfer failed."
+ --#SUMMARY "Controller firmware transfer failed."
+ --#ARGUMENTS { }
+ --#SEVERITY SEVERE
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE DEGRADED
+ ::= 494
+
+apcDeviceShutdownHeartbeat TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { mtrapargsInteger, mtrapargsTimeTicks, mtrapargsString}
+ DESCRIPTION
+ "INFORMATIONAL: "
+ --#TYPE "APC X:"
+ --#SUMMARY "."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 999
+
+apcDiscoveryAlarmStateTableUpdate TRAP-TYPE
+ ENTERPRISE apc
+ VARIABLES { apcDiscoveryDeviceAlarmStateChangeCount }
+ DESCRIPTION
+ "INTERNAL: A Discovery Alarm State Table Update trap is sent
+ when any data alarm state is added, removed, or its parameters
+ are changed in the condition table. This trap is
+ only for machine-to-machine communication. "
+ --#TYPE "APC X:"
+ --#SUMMARY "."
+ --#ARGUMENTS { }
+ --#SEVERITY INFORMATIONAL
+ --#TIMEINDEX 1
+ --#HELP ""
+ --#HELPTAG 0
+ --#STATE OPERATIONAL
+ ::= 1000
+
+END
diff --git a/fence/agents/baytech/Makefile.am b/fence/agents/baytech/Makefile.am
new file mode 100644
index 0000000..c0b0b84
--- /dev/null
+++ b/fence/agents/baytech/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_baytech
+
+SRC = $(TARGET).pl
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fencemanperl.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/baytech/fence_baytech.pl b/fence/agents/baytech/fence_baytech.pl
new file mode 100644
index 0000000..bb7f42e
--- /dev/null
+++ b/fence/agents/baytech/fence_baytech.pl
@@ -0,0 +1,746 @@
+#!/usr/bin/perl
+
+# This fencing agent is written for the Baytech RPC27-20nc in conjunction with
+# a Cyclades terminal server. The Cyclades TS exports the RPC's serial port
+# via a Telnet interface. Other interfaces, such as SSH, are possible.
+# However, this script relys upon the assumption that Telnet is used. Future
+# features to this agent would allow the agent to work with a mulitude of
+# different communication protocols such as Telnet, SSH or Kermit.
+#
+# The other assumption that is made is that Outlet names do not end in space.
+# The name "Foo" and "Foo " are identical when the RPC prints them with
+# the status command.
+
+use Net::Telnet;
+use Getopt::Std;
+
+my $ME = $0;
+
+END {
+ defined fileno STDOUT or return;
+ close STDOUT and return;
+ warn "$ME: failed to close standard output: $!\n";
+ $? ||= 1;
+}
+
+# WARNING!! Do not add code bewteen "#BEGIN_VERSION_GENERATION" and
+# "#END_VERSION_GENERATION" It is generated by the Makefile
+
+#BEGIN_VERSION_GENERATION
+$RELEASE_VERSION="";
+$REDHAT_COPYRIGHT="";
+$BUILD_DATE="";
+#END_VERSION_GENERATION
+
+# Get the program name from $0 and strip directory names
+$_=$0;
+s/.*\///;
+my $pname = $_;
+
+
+sub rpc_error
+{
+ if (defined $error_message && $error_message ne "")
+ {
+ chomp $error_message;
+ die "$error_message\n";
+ }
+ else
+ {
+ die "read timed-out\n"
+ }
+}
+
+sub usage
+{
+
+ print "Usage:\n";
+ print "\n";
+ print "$pname [options]\n";
+ print "\n";
+ print "Options:\n";
+ print " -a host host to connect to\n";
+ print " -D debugging output\n";
+ print " -h usage\n";
+ print " -l string user name\n";
+ print " -o string action: on,off,status, reboot (default) or metadata\n";
+ print " -n string outlet name\n";
+ print " -p string password\n";
+ print " -S path script to run to retrieve password\n";
+ print " -V version\n";
+
+ exit 0;
+}
+
+sub fail
+{
+ ($msg)=@_;
+ print $msg."\n" unless defined $quiet;
+ $t->close if defined $t;
+ exit 1;
+}
+
+sub fail_usage
+{
+ ($msg)=@_;
+ print STDERR $msg."\n" if $msg;
+ print STDERR "Please use '-h' for usage.\n";
+ exit 1;
+}
+
+sub version
+{
+ print "$pname $RELEASE_VERSION $BUILD_DATE\n";
+ print "$REDHAT_COPYRIGHT\n" if ( $REDHAT_COPYRIGHT );
+
+ exit 0;
+}
+
+sub print_metadata
+{
+print '<?xml version="1.0" ?>
+<resource-agent name="fence_baytech" shortdesc="I/O Fencing agent for Baytech RPC switches in combination with a Cyclades Terminal Server" >
+<longdesc>
+This fencing agent is written for the Baytech RPC27-20nc in combination with a Cyclades terminal server. The Cyclades TS exports the RPC\'s serial port via a Telnet interface. Other interfaces, such as SSH, are possible. However, this script relies upon the assumption that Telnet is used.
+
+The other assumption that is made is that Outlet names do not end in space. The name "Foo" and "Foo " are identical when the RPC prints them with the status command.
+</longdesc>
+<vendor-url>http://www.baytech.net</vendor-url>
+<parameters>
+ <parameter name="action" unique="1" required="1">
+ <getopt mixed="-o [action]" />
+ <content type="string" default="disable" />
+ <shortdesc lang="en">Fencing Action</shortdesc>
+ </parameter>
+ <parameter name="ipaddr" unique="1" required="1">
+ <getopt mixed="-a [ip]" />
+ <content type="string" />
+ <shortdesc lang="en">IP Address or Hostname</shortdesc>
+ </parameter>
+ <parameter name="login" unique="1" required="1">
+ <getopt mixed="-l [name]" />
+ <content type="string" />
+ <shortdesc lang="en">Login Name</shortdesc>
+ </parameter>
+ <parameter name="passwd" unique="1" required="0">
+ <getopt mixed="-p [password]" />
+ <content type="string" />
+ <shortdesc lang="en">Login password or passphrase</shortdesc>
+ </parameter>
+ <parameter name="passwd_script" unique="1" required="0">
+ <getopt mixed="-S [script]" />
+ <content type="string" />
+ <shortdesc lang="en">Script to retrieve password</shortdesc>
+ </parameter>
+ <parameter name="port" unique="1" required="1">
+ <getopt mixed="-n [id]" />
+ <content type="string" />
+ <shortdesc lang="en">Physical plug number or name of virtual machine</shortdesc>
+ </parameter>
+ <parameter name="help" unique="1" required="0">
+ <getopt mixed="-h" />
+ <content type="string" />
+ <shortdesc lang="en">Display help and exit</shortdesc>
+ </parameter>
+</parameters>
+<actions>
+ <action name="enable" />
+ <action name="disable" />
+ <action name="status" />
+ <action name="metadata" />
+</actions>
+</resource-agent>
+';
+}
+
+
+# Get operating paramters, either with getopts or from STDIN
+sub get_options
+{
+ $action = "Reboot";
+ if (@ARGV > 0) {
+ getopts("n:l:p:S:o:a:VhD") || fail_usage ;
+
+ usage if defined $opt_h;
+ version if defined $opt_V;
+
+ fail_usage "Unkown parameter." if (@ARGV > 0);
+
+ } else {
+ get_options_stdin();
+ }
+
+ if ((defined $opt_o) && ($opt_o =~ /metadata/i)) {
+ print_metadata();
+ exit 0;
+ }
+
+ fail "failed: must specify hostname" unless defined $opt_a;
+ $host=$opt_a;
+ $port=23 unless ($opt_a =~ /:/);
+
+ $action = $opt_o if defined $opt_o;
+ fail "failed: unrecognised action: $action"
+ unless $action=~ /^(Off|On|Reboot|status)$/i;
+
+ fail "failed: no outletname" unless defined $opt_n;
+ $outlet = $opt_n;
+
+ $debug=$opt_D if defined $opt_D;
+ $quiet=$opt_q if defined $opt_q;
+ $user=$opt_l if defined $opt_l;
+ $passwd=$opt_p if defined $opt_p;
+ if (defined $opt_S) {
+ $pwd_script_out = `$opt_S`;
+ chomp($pwd_script_out);
+ if ($pwd_script_out) {
+ $passwd=$pwd_script_out;
+ }
+ }
+
+ if(defined $passwd && !defined $user)
+ {
+ fail "failed: password given without username";
+ }
+}
+
+# Get options from STDIN
+sub get_options_stdin
+{
+ my $opt;
+ my $line = 0;
+ while( defined($in = <>) )
+ {
+ $_ = $in;
+ chomp;
+
+ # strip leading and trailing whitespace
+ s/^\s*//;
+ s/\s*$//;
+
+ # skip comments
+ next if /^#/;
+
+ $line+=1;
+ $opt=$_;
+ next unless $opt;
+
+ ($name,$val)=split /\s*=\s*/, $opt;
+
+ if ( $name eq "" )
+ {
+ print STDERR "parse error: illegal name in option $line\n";
+ exit 2;
+ }
+
+ # DO NOTHING -- this field is used by fenced
+ elsif ($name eq "agent" ) { }
+
+ elsif ($name eq "host" )
+ {
+ $opt_a = $val;
+ }
+
+ elsif ($name eq "login" )
+ {
+ $opt_l = $val;
+ }
+
+ elsif ($name eq "passwd" )
+ {
+ $opt_p = $val;
+ }
+
+ elsif ($name eq "passwd_script") {
+ $opt_S = $val;
+ }
+
+ elsif ($name eq "action" )
+ {
+ $opt_o = $val;
+ }
+
+ elsif ($name eq "outlet" )
+ {
+ $opt_n = $val;
+ }
+
+ }
+}
+
+# Get a bunch of lines. The newlines must terminate complete lines.
+sub getlines
+{
+ my $data=$t->get();
+ return undef unless defined $data;
+ my @chars = split //,$data;
+ my @lines;
+ my $line="";
+
+ for (my $i=0;$i<@chars;$i++)
+ {
+ $line = $line.$chars[$i];
+ next unless $chars[$i] eq "\n";
+ $lines[@lines] = $line;
+ $line = "";
+ }
+ $lines[@lines] = $line unless $line eq "";
+
+ return @lines;
+}
+
+# Fill the global input buffer of lines read. All lines are terminated with
+# a newline. If a line is not terminated, the next call to fill buffer will
+# append the last line of the input buffer with the first line that it gets from
+# getlines()
+sub fill_buffer
+{
+ my @lines = getlines();
+ return undef unless @lines;
+
+ if(@buffer)
+ {
+ if ( $buffer[$#buffer]=~/\n/) { }
+ else
+ {
+ $buffer[$#buffer] = $buffer[$#buffer].$lines[0];
+ shift @lines;
+ }
+ }
+
+ foreach (@lines)
+ {
+ push @buffer,$_;
+ }
+}
+
+
+
+#
+# ($p_index, at data) = get_match @patterns;
+#
+# searches the input buffers for the patterns specified by the regeps in
+# @patterns, when a match is found, all the lines through the matched
+# pattern line are removed from the global input buffer and returned in the
+# array @data. The index into @patterns for the matching pattern is also
+# returned.
+sub get_match
+{
+ my (@patterns) = @_;
+ $b_index = 0 unless defined $b_index;
+
+ fill_buffer() unless defined @buffer;
+
+ for(;;)
+ {
+ for(my $bi=$b_index; $bi<@buffer; $bi++)
+ {
+ for(my $pat=0; $pat<@patterns; $pat++)
+ {
+ if($buffer[$bi] =~ /$patterns[$pat]/)
+ {
+ $b_index = 0;
+ my @rtrn = splice(@buffer,0,$bi);
+ shift @buffer;
+
+ if($debug)
+ {
+ foreach (@rtrn) { print $_ }
+ print "$patterns[$pat] ";
+ }
+
+ return ($pat, at rtrn);
+ }
+ }
+ $b_index = $bi;
+ }
+
+ fill_buffer();
+ }
+}
+
+#
+# ($bt_num,$bt_name,$bt_state,$bt_locked) = parse_status $outlet, at data;
+#
+# This parses the data @data and searches for an outlet named $outlet.
+# The data will be in the form:
+#
+# Average Power: 0 Watts Apparent Power: 17 VA
+#
+# True RMS Voltage: 120.0 Volts
+#
+# True RMS Current: 0.1 Amps Maximum Detected: 0.2 Amps
+#
+# Internal Temperature: 19.5 C
+#
+# Outlet Circuit Breaker: Good
+#
+# 1)...Outlet 1 : Off 2)...Outlet 2 : Off
+# 3)...Outlet 3 : On 4)...Outlet 4 : On
+# 5)...Outlet 5 : On 6)...Outlet 6 : On
+# 7)...Outlet 7 : On 8)...Outlet 8 : On
+# 9)...Outlet 9 : On 10)...Outlet 10 : On
+# 11)...Outlet 11 : On 12)...Outlet 12 : On
+# 13)...Outlet 13 : On 14)...Outlet 14 : On
+# 15)...Outlet 15 : On 16)...Outlet 16 : On
+# 17)...Outlet 17 : On 18)...Outlet 18 : On
+# 19)...Outlet 19 : On 20)...Outlet 20 : On Locked
+#
+sub parse_status
+{
+ my $outlet = shift;
+ my @data = @_;
+
+ my $bt_num="";
+ my $bt_name="";
+ my $bt_state="";
+ my $bt_locked="";
+
+ # Verify that the Outlet name exists
+ foreach my $line (@data)
+ {
+ next unless $line =~ /^[ 12][0-9]\)\.\.\./;
+
+ my @entries = split /([ 12][0-9])\)\.\.\./,$line;
+
+ foreach my $entry (@entries)
+ {
+ next if $entry eq "";
+
+ if($entry =~ /^([ 12][0-9])$/)
+ {
+ $bt_num = $1;
+ }
+ elsif($entry =~ /^(.{15}) : (On|Off)(.*)/)
+ {
+
+ $bt_name = $1;
+ $bt_state = $2;
+ $bt_locked = $3;
+
+ $_ = $bt_name;
+ s/\s*$//;
+ $bt_name = $_;
+
+ $_ = $bt_locked;
+ s/\s*$//;
+ $bt_locked = $_;
+
+ last if ($bt_name eq $outlet);
+
+ $bt_name = "";
+ next;
+ }
+ else
+ {
+ die "parse error: $entry";
+ }
+ }
+ last if ($bt_name ne "");
+ }
+
+ if ($bt_name eq "")
+ {
+ $bt_num=undef;
+ $bt_name=undef;
+ $bt_state=undef;
+ $bt_locked=undef;
+ }
+
+ return ($bt_num,$bt_name,$bt_state,$bt_locked);
+}
+
+##########################################################################
+#
+# Main
+
+get_options;
+
+
+if (defined $port)
+{
+ $t = new Net::Telnet(Host=>$host, Port=>$port) or
+ die "Unable to connect to $host:$port: ".($!?$!:$_)."\n";
+}
+else
+{
+ $t = new Net::Telnet(Host=>$host) or
+ die "Unable to connect to $host: ".($!?$!:$_)."\n";
+}
+
+
+
+#> DEBUG $t->dump_log("LOG");
+
+$t->print("\n");
+
+my @patterns;
+$prompt_user="^Enter user name:";
+$prompt_pass="^Enter Password:";
+$prompt_cmd="^RPC-27>";
+$prompt_confirm_yn="^.*\\(Y/N\\)\\?";
+
+$patterns[0]=$prompt_user;
+$patterns[1]=$prompt_pass;
+$patterns[2]=$prompt_cmd;
+$patterns[3]=$prompt_confirm_yn;
+
+my $p_index;
+my @data;
+
+my $bt_num="";
+my $bt_name="";
+my $bt_state="";
+my $bt_locked="";
+my $exit=1;
+
+($p_index, at data) = get_match @patterns;
+
+#
+# Set errmode after first get_match. This allows for more descriptive errors
+# when handling unexpected error conditions
+#
+$t->errmode(\&rpc_error);
+
+# At this point, the username is unknown. We'll just
+# pass in an empty passwd so that we can get back to the
+# login prompt.
+#
+# FIXME
+# If this is the third login failure for this switch, an
+# additional newline will need to be made sent. This script
+# does not handle that case at this time. This will cause
+# a timeout on read and cause this to fail. Rerunning the
+# script ought to work though.
+if ($patterns[$p_index] eq $prompt_pass)
+{
+ $t->print("\n");
+ ($p_index, at data) = get_match @patterns;
+}
+
+# Enter user name:
+#
+# Depending how the RPC is configured, a user name may not be required.
+# We will only deal with usernames if prompted.
+#
+# If there is no user/passwd given as a parameter, but the switch
+# expects one, rather than just fail, we will first try to
+# get the switch in a known state
+my $warn_user="yes";
+my $warn_passwd="yes";
+
+$error_message = "Invalid user/password";
+
+for (my $retrys=0; $patterns[$p_index] eq $prompt_user ; $retrys++)
+{
+ $warn_passwd = "yes";
+ if(defined $user)
+ {
+ $t->print("$user\n");
+ $warn_user = "no";
+ }
+ else
+ {
+ $t->print("\n");
+
+ }
+ ($p_index, at data) = get_match @patterns;
+
+ # Enter Password:
+ #
+ # Users don't have to have passwords either. We will only check
+ # that the user specified a password if we were prompted by the
+ # RPC.
+ if ($patterns[$p_index] eq $prompt_pass)
+ {
+ if(defined $passwd)
+ {
+ $t->print("$passwd\n");
+ $warn_passwd = "no";
+ }
+ else
+ {
+ $t->print("\n");
+ }
+
+ ($p_index, at data) = get_match @patterns;
+ }
+
+
+ #
+ # If a valid user name is given, but not a valid password, we
+ # will loop forever unless we limit the number of retries
+ #
+ # set the user to "" so we stop entering a valid username and
+ # force the login proccess to fail
+ #
+ if ($retrys>2)
+ {
+ $user = "";
+ }
+ elsif ($retrys>10)
+ {
+ die "maximum retry count exceeded\n";
+ }
+}
+
+#
+# reset errmode to die()
+#
+$t->errmode("die");
+
+# all through with the login/passwd. If we see any other prompt it is an
+# error.
+if ($patterns[$p_index] ne $prompt_cmd)
+{
+ $t->print("\n");
+ die "bad state: '$patterns[$p_index]'";
+}
+
+if (defined $user && ($warn_user eq "yes"))
+{
+ warn "warning: user parameter ignored\n";
+}
+
+if (defined $passwd && ($warn_passwd eq "yes"))
+{
+ warn "warning: passwd parameter ignored\n";
+}
+
+
+
+
+# We are now logged in, no need for these patterns. We'll strip these
+# so that we don't have to keep searching for patterns that shouldn't
+# appear.
+shift @patterns;
+shift @patterns;
+
+# Get the current status of a particular outlet. Explicitly pass
+# the status command in case the RPC is not configured to report the
+# status on each command completion.
+$t->print("status\n");
+($p_index, at data) = get_match @patterns;
+($bt_num,$bt_name,$bt_state,$bt_locked) = parse_status $outlet, at data;
+
+if (!defined $bt_name )
+{
+ # We have problems if there is not outlet named $outlet
+ print "Outlet \'$outlet\' not found\n";
+ $exit=1;
+}
+elsif ($action =~ /status/i)
+{
+ print "Outlet '$bt_name' is $bt_state and is ".
+ (($bt_locked eq "")?"not ":"")."Locked\n";
+
+ if ($bt_state =~ /on/i)
+ {
+ $exit=0;
+ } else {
+ $exit=2;
+ }
+}
+elsif ($bt_locked ne "")
+{
+ # Report an error if an outlet is locked since we can't actually
+ # issue commands on a Locked outlet. This will prevent false
+ # successes.
+ print "Outlet '$bt_name' is Locked\n";
+ $exit=1;
+}
+elsif (($action =~ /on/i && $bt_state eq "On") ||
+ ($action =~ /off/i && $bt_state eq "Off") )
+{
+ # No need to issue the on/off command since we are already in
+ # the desired state
+ print "Outlet '$bt_name' is already $bt_state\n";
+ $exit=0;
+}
+elsif ($action =~ /o(n|ff)/i)
+{
+ # On/Off command
+ $t->print("$action $bt_num\n");
+ ($p_index, at data) = get_match @patterns;
+
+ # Confirmation prompting maybe enabled in the switch. If it is,
+ # we enter 'Y' for yes.
+ if ($patterns[$p_index] eq $prompt_confirm_yn)
+ {
+ $t->print("y\n");
+ ($p_index, at data) = get_match @patterns;
+ }
+
+ $t->print("status\n");
+ ($p_index, at data) = get_match @patterns;
+
+ ($bt_num,$bt_name,$bt_state,$bt_locked) = parse_status $outlet, at data;
+
+ if ($bt_state =~ /$action/i)
+ {
+ print "success: outlet='$outlet' action='$action'\n";
+ $exit=0;
+ }
+ else
+ {
+ print "fail: outlet='$outlet' action='$action'\n";
+ $exit=1;
+ }
+}
+elsif ($action =~ /reboot/i)
+{
+ # Reboot command
+ $t->print("$action $bt_num\n");
+ ($p_index, at data) = get_match @patterns;
+
+ # Confirmation prompting maybe enabled in the switch. If it is,
+ # we enter 'Y' for yes.
+ if ($patterns[$p_index] eq $prompt_confirm_yn)
+ {
+ $t->print("y\n");
+ ($p_index, at data) = get_match @patterns;
+ }
+
+ # The reboot command is annoying. It reports that the outlet will
+ # reboot in 9 seconds. Then it has a countdown timer. We first
+ # look for the "Rebooting... 9" message, then we parse the remaining
+ # output to verify that it reaches 0 without skipping anything.
+ my $pass=0;
+ foreach (@data)
+ {
+ chomp;
+ my $line = $_;
+
+ # There is a countdown timer that prints a number, then sleeps a
+ # second, then prints a backspace and then another number
+ #
+ # /^Rebooting\.\.\. 9\b8\b7\b6\b5\b4\b3\b2\b1\b0\b$/
+ if($line =~/^Rebooting\.\.\..*0[\b]$/)
+ {
+ $pass=1;
+ last;
+ }
+ }
+
+ if ($pass)
+ {
+ print "success: outlet='$outlet' action='$action'\n";
+ $exit=0;
+ }
+ else
+ {
+ print "fail: outlet='$outlet' action='$action'\n";
+ $exit=1;
+ }
+}
+else
+{
+ die "bad state";
+}
+
+# Clean up. If we don't tell it to logout, then anybody else can log onto
+# the serial port and have access to the switch without authentication (when
+# enabled)
+$t->print("logout\n");
+$t->close;
+exit $exit;
diff --git a/fence/agents/bladecenter/Makefile.am b/fence/agents/bladecenter/Makefile.am
new file mode 100644
index 0000000..d910196
--- /dev/null
+++ b/fence/agents/bladecenter/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_bladecenter
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/bladecenter/fence_bladecenter.py b/fence/agents/bladecenter/fence_bladecenter.py
new file mode 100644
index 0000000..14a152b
--- /dev/null
+++ b/fence/agents/bladecenter/fence_bladecenter.py
@@ -0,0 +1,118 @@
+#!/usr/bin/python
+
+#####
+##
+## The Following Agent Has Been Tested On:
+##
+## Model Firmware
+## +--------------------+---------------------------+
+## (1) Main application BRET85K, rev 16
+## Boot ROM BRBR67D, rev 16
+## Remote Control BRRG67D, rev 16
+##
+#####
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="New Bladecenter Agent - test release on steroids"
+REDHAT_COPYRIGHT=""
+BUILD_DATE="March, 2008"
+#END_VERSION_GENERATION
+
+def get_power_status(conn, options):
+ node_cmd = "system:blade\[" + options["--plug"] + "\]>"
+
+ conn.send_eol("env -T system:blade[" + options["--plug"] + "]")
+ i = conn.log_expect(options, [ node_cmd, "system>" ] , int(options["--shell-timeout"]))
+ if i == 1:
+ ## Given blade number does not exist
+ if options.has_key("--missing-as-off"):
+ return "off"
+ else:
+ fail(EC_STATUS)
+ conn.send_eol("power -state")
+ conn.log_expect(options, node_cmd, int(options["--shell-timeout"]))
+ status = conn.before.splitlines()[-1]
+ conn.send_eol("env -T system")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ return status.lower().strip()
+
+def set_power_status(conn, options):
+ node_cmd = "system:blade\[" + options["--plug"] + "\]>"
+
+ conn.send_eol("env -T system:blade[" + options["--plug"] + "]")
+ i = conn.log_expect(options, [ node_cmd, "system>" ] , int(options["--shell-timeout"]))
+ if i == 1:
+ ## Given blade number does not exist
+ if options.has_key("--missing-as-off"):
+ return
+ else:
+ fail(EC_GENERIC_ERROR)
+
+ conn.send_eol("power -"+options["--action"])
+ conn.log_expect(options, node_cmd, int(options["--shell-timeout"]))
+ conn.send_eol("env -T system")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+def get_blades_list(conn, options):
+ outlets = { }
+
+ node_cmd = "system>"
+
+ conn.send_eol("env -T system")
+ conn.log_expect(options, node_cmd, int(options["--shell-timeout"]))
+ conn.send_eol("list -l 2")
+ conn.log_expect(options, node_cmd, int(options["--shell-timeout"]))
+
+ lines = conn.before.split("\r\n")
+ filter_re = re.compile("^\s*blade\[(\d+)\]\s+(.*?)\s*$")
+ for blade_line in lines:
+ res = filter_re.search(blade_line)
+ if res != None:
+ outlets[res.group(1)] = (res.group(2), "")
+
+ return outlets
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "cmd_prompt", "secure", \
+ "port", "missing_as_off" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["power_wait"]["default"] = "10"
+ all_opt["cmd_prompt"]["default"] = [ "system>" ]
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for IBM BladeCenter"
+ docs["longdesc"] = "fence_bladecenter is an I/O Fencing agent \
+which can be used with IBM Bladecenters with recent enough firmware that \
+includes telnet support. It logs into a Brocade chasis via telnet or ssh \
+and uses the command line interface to power on and off blades."
+ docs["vendorurl"] = "http://www.ibm.com"
+ show_docs(options, docs)
+
+ ##
+ ## Operate the fencing device
+ ######
+ conn = fence_login(options, "(username: )")
+ result = fence_action(conn, options, set_power_status, get_power_status, get_blades_list)
+
+ ##
+ ## Logout from system
+ ######
+ try:
+ conn.send_eol("exit")
+ conn.close()
+ except:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/brocade/Makefile.am b/fence/agents/brocade/Makefile.am
new file mode 100644
index 0000000..171425f
--- /dev/null
+++ b/fence/agents/brocade/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_brocade
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/brocade/fence_brocade.py b/fence/agents/brocade/fence_brocade.py
new file mode 100644
index 0000000..25581fd
--- /dev/null
+++ b/fence/agents/brocade/fence_brocade.py
@@ -0,0 +1,86 @@
+#!/usr/bin/python
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="New Brocade Agent - test release on steroids"
+REDHAT_COPYRIGHT=""
+BUILD_DATE="March, 20013"
+#END_VERSION_GENERATION
+
+def get_power_status(conn, options):
+ conn.send_eol("portCfgShow " + options["--plug"])
+
+ exp_result = conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ show_re = re.compile('^\s*Persistent Disable\s*(ON|OFF)\s*$', re.IGNORECASE)
+ lines = conn.before.split("\n")
+
+ for x in lines:
+ res = show_re.search(x)
+ if (res != None):
+ # We queried if it is disabled, so we have to negate answer
+ if res.group(1) == "ON":
+ return "off"
+ else:
+ return "on"
+
+ fail(EC_STATUS)
+def set_power_status(conn, options):
+ action = {
+ 'on' : "portCfgPersistentEnable",
+ 'off': "portCfgPersistentDisable"
+ }[options["--action"]]
+
+ conn.send_eol(action + " " + options["--plug"])
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "cmd_prompt", "secure", "port", "fabric_fencing" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["cmd_prompt"]["default"] = [ "> " ]
+
+ options = check_input(device_opt, process_input(device_opt))
+ options["eol"] = "\n"
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for HP Brocade over telnet/ssh"
+ docs["longdesc"] = "fence_brocade is an I/O Fencing agent which can be used with Brocade FC switches. \
+It logs into a Brocade switch via telnet and disables a specified port. Disabling the port which a machine is \
+connected to effectively fences that machine. Lengthy telnet connections to the switch should be avoided while \
+a GFS cluster is running because the connection will block any necessary fencing actions. \
+\
+After a fence operation has taken place the fenced machine can no longer connect to the Brocade FC switch. \
+When the fenced machine is ready to be brought back into the GFS cluster (after reboot) the port on the Brocade \
+FC switch needs to be enabled. This can be done by running fence_brocade and specifying the enable action"
+ docs["vendorurl"] = "http://www.brocade.com"
+ show_docs(options, docs)
+
+ ##
+ ## Operate the fencing device
+ ####
+ conn = fence_login(options)
+
+ result = fence_action(conn, options, set_power_status, get_power_status, None)
+
+ ##
+ ## Logout from system
+ ##
+ ## In some special unspecified cases it is possible that
+ ## connection will be closed before we run close(). This is not
+ ## a problem because everything is checked before.
+ ######
+ try:
+ conn.send_eol("exit")
+ conn.close()
+ except:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/bullpap/Makefile.am b/fence/agents/bullpap/Makefile.am
new file mode 100644
index 0000000..a602b5e
--- /dev/null
+++ b/fence/agents/bullpap/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_bullpap
+
+SRC = $(TARGET).pl
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fencemanperl.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/bullpap/fence_bullpap.pl b/fence/agents/bullpap/fence_bullpap.pl
new file mode 100644
index 0000000..3012fa2
--- /dev/null
+++ b/fence/agents/bullpap/fence_bullpap.pl
@@ -0,0 +1,433 @@
+#!/usr/bin/perl
+
+use Getopt::Std;
+use POSIX;
+
+my $ME = $0;
+
+END {
+ defined fileno STDOUT or return;
+ close STDOUT and return;
+ warn "$ME: failed to close standard output: $!\n";
+ $? ||= 1;
+}
+
+# Get the program name from $0 and strip directory names
+$_=$0;
+s/.*\///;
+my $pname = $_;
+
+$action = "reboot"; # Default fence action
+my $bulldir = "/usr/local/bull/NSMasterHW/bin";
+
+
+# WARNING!! Do not add code bewteen "#BEGIN_VERSION_GENERATION" and
+# "#END_VERSION_GENERATION" It is generated by the Makefile
+
+#BEGIN_VERSION_GENERATION
+$RELEASE_VERSION="";
+$REDHAT_COPYRIGHT="";
+$BUILD_DATE="";
+#END_VERSION_GENERATION
+
+
+sub usage
+{
+ print "Usage:\n";
+ print "\n";
+ print "$pname [options]\n";
+ print "\n";
+ print "Options:\n";
+ print " -a <ip> IP address or hostname of PAP console\n";
+ print " -h usage\n";
+ print " -l <name> Login name\n";
+ print " -d <domain> Domain to operate on\n";
+ print " -o <string> Action: on, off, reboot (default), status or metadata\n";
+ print " -p <string> Password for login\n";
+ print " -S <path> Script to run to retrieve password\n";
+ print " -q quiet mode\n";
+ print " -V version\n";
+ print "\n";
+ print "When run with no arguments, $pname takes arguments from ";
+ print "standard\ninput, one line per option. They are as follows:\n";
+ print "\n";
+ print " ipaddr=<ip> Same as -a command line option\n";
+ print " login=<name> Same as -l command line option\n";
+ print " domain=<domain> Same as -d command line option\n";
+ print " option=<string> Same as -o command line option\n";
+ print " passwd=<string> Same as -p command line option\n";
+ print " passwd_script=<path> Same as -S command line option\n\n";
+
+ exit 0;
+}
+
+sub fail
+{
+ ($msg) = @_;
+ print $msg."\n" unless defined $quiet;
+ exit 1;
+}
+
+sub fail_usage
+{
+ ($msg)=@_;
+ print STDERR $msg."\n" if $msg;
+ print STDERR "Please use '-h' for usage.\n";
+ exit 1;
+}
+
+sub version
+{
+ print "$pname $RELEASE_VERSION $BUILD_DATE\n";
+ print "$REDHAT_COPYRIGHT\n" if ( $REDHAT_COPYRIGHT );
+
+ exit 0;
+}
+
+sub print_metadata
+{
+print '<?xml version="1.0" ?>
+<resource-agent name="fence_bullpap" shortdesc="I/O Fencing agent for Bull FAME architecture controlled by a PAP management console." >
+<longdesc>
+fence_bullpap is an I/O Fencing agent which can be used with Bull\'s NovaScale machines controlled by PAP management consoles. This agent calls Bull\'s support software provided by the NSMasterHW RPM available from Bull.
+</longdesc>
+<vendor-url>http://www.bull.com</vendor-url>
+<parameters>
+ <parameter name="action" unique="1" required="1">
+ <getopt mixed="-o [action]" />
+ <content type="string" default="reboot" />
+ <shortdesc lang="en">Fencing Action</shortdesc>
+ </parameter>
+ <parameter name="ipaddr" unique="1" required="1">
+ <getopt mixed="-a [ip]" />
+ <content type="string" />
+ <shortdesc lang="en">IP Address or Hostname</shortdesc>
+ </parameter>
+ <parameter name="login" unique="1" required="1">
+ <getopt mixed="-l [name]" />
+ <content type="string" />
+ <shortdesc lang="en">Login Name</shortdesc>
+ </parameter>
+ <parameter name="passwd" unique="1" required="0">
+ <getopt mixed="-p [password]" />
+ <content type="string" />
+ <shortdesc lang="en">Login password or passphrase</shortdesc>
+ </parameter>
+ <parameter name="passwd_script" unique="1" required="0">
+ <getopt mixed="-S [script]" />
+ <content type="string" />
+ <shortdesc lang="en">Script to retrieve password</shortdesc>
+ </parameter>
+ <parameter name="domain" unique="1" required="1">
+ <getopt mixed="-d [domain]" />
+ <content type="string" />
+ <shortdesc lang="en">Domain name of the Bull machine to power-cycle</shortdesc>
+ </parameter>
+ <parameter name="help" unique="1" required="0">
+ <getopt mixed="-h" />
+ <content type="string" />
+ <shortdesc lang="en">Display help and exit</shortdesc>
+ </parameter>
+</parameters>
+<actions>
+ <action name="on" />
+ <action name="off" />
+ <action name="reboot" />
+ <action name="status" />
+ <action name="metadata" />
+</actions>
+</resource-agent>
+';
+}
+
+sub get_options_stdin
+{
+ my $opt;
+ my $line = 0;
+ while( defined($in = <>) )
+ {
+ $_ = $in;
+ chomp;
+
+ # strip leading and trailing whitespace
+ s/^\s*//;
+ s/\s*$//;
+
+ # skip comments
+ next if /^#/;
+
+ $line+=1;
+ $opt=$_;
+ next unless $opt;
+
+ ($name,$val)=split /\s*=\s*/, $opt;
+
+ if ( $name eq "" )
+ {
+ print STDERR "parse error: illegal name in option $line\n";
+ exit 2;
+ }
+
+ # DO NOTHING -- this field is used by fenced
+ elsif ($name eq "agent" ) { }
+
+ elsif ($name eq "ipaddr" )
+ {
+ $host = $val;
+ }
+ elsif ($name eq "login" )
+ {
+ $login = $val;
+ }
+ elsif (($name eq "option" ) || ($name eq "action"))
+ {
+ $action = $val;
+ }
+ elsif ($name eq "passwd" )
+ {
+ $passwd = $val;
+ }
+ elsif ($name eq "password" )
+ {
+ $passwd = $val;
+ }
+ elsif ($name eq "passwd_script" ) {
+ $passwd_script = $val;
+ }
+ elsif ($name eq "domain" )
+ {
+ $domain = $val;
+ }
+ elsif ($name eq "debuglog" )
+ {
+ $verbose = $val;
+ }
+ }
+}
+
+sub get_power_state
+{
+ my ($ip,$dom,$user,$pass,$junk) = @_;
+ fail "missing IP address in get_power_state()" unless defined $ip;
+ fail "missing domain to get_power_state()" unless defined $dom;
+ fail "illegal argument to get_power_state()" if defined $junk;
+
+ my $state="";
+ my $cmd = $bulldir . "/pampower.pl";
+
+ $cmd = $cmd . " -a status";
+ $cmd = $cmd . " -M $ip -D $dom";
+ if (defined $user) {
+ $cmd = $cmd . " -u $user";
+ }
+ if (defined $pass) {
+ $cmd = $cmd . " -p $pass";
+ }
+
+ $state=system($cmd);
+ WIFEXITED($state) || die "child killed abnormally";
+
+ $state=WEXITSTATUS($state);
+ if ($state == 0) {
+ $state = "ON";
+ } elsif ($state == 1) {
+ $state = "OFF";
+ } else {
+ $state = "$state TRANSITION";
+ }
+
+ $_=$state;
+}
+
+sub set_power_state
+{
+ my ($ip,$dom,$set,$user,$pass,$junk) = @_;
+ fail "missing action to set_power_state()" unless defined $set;
+ fail "missing IP address in set_power_state()" unless defined $ip;
+ fail "missing domain to set_power_state()" unless defined $dom;
+ fail "illegal argument to set_power_state()" if defined $junk;
+
+ my $state="";
+ my $cmd = $bulldir . "/pampower.pl";
+
+ if ($set =~ /on/) {
+ $cmd = $cmd . " -a on";
+ } else {
+ $cmd = $cmd . " -a off_force";
+ }
+
+ $cmd = $cmd . " -M $ip -D $dom";
+ if (defined $user) {
+ $cmd = $cmd . " -u $user";
+ }
+ if (defined $pass) {
+ $cmd = $cmd . " -p $pass";
+ }
+
+ $state=system "$cmd";
+
+ $_=$state;
+}
+
+# MAIN
+
+if (@ARGV > 0)
+{
+ getopts("a:hl:d:o:p:S:qv:V") || fail_usage ;
+
+ usage if defined $opt_h;
+ version if defined $opt_V;
+
+ if ((defined $opt_o) && ($opt_o =~ /metadata/i)) {
+ print_metadata();
+ exit 0;
+ }
+
+ $host = $opt_a if defined $opt_a;
+ $login = $opt_l if defined $opt_l;
+ $passwd = $opt_p if defined $opt_p;
+ $action = $opt_o if defined $opt_o;
+ $domain = $opt_d if defined $opt_d;
+ $verbose = $opt_v if defined $opt_v;
+ $quiet = $opt_q if defined $opt_q;
+
+ if (defined $opt_S) {
+ $pwd_script_out = `$opt_S`;
+ chomp($pwd_script_out);
+ if ($pwd_script_out) {
+ $passwd = $pwd_script_out;
+ }
+ }
+
+ fail_usage "Unknown parameter." if (@ARGV > 0);
+
+ fail_usage "No '-a' flag specified." unless defined $host;
+ fail_usage "No '-d' flag specified." unless defined $domain;
+ fail_usage "No '-l' flag specified." unless defined $login;
+ fail_usage "No '-p' or '-S' flag specified." unless defined $passwd;
+ fail_usage "Unrecognised action '$action' for '-o' flag"
+ unless $action =~ /^(on|off|reboot|status)$/i;
+}
+else
+{
+ get_options_stdin();
+
+ if ((defined $action) && ($action =~ /metadata/i)) {
+ print_metadata();
+ exit 0;
+ }
+
+ fail "failed: no IP address" unless defined $host;
+ fail "failed: no domain" unless defined $domain;
+ fail "failed: no login name" unless defined $login;
+ fail "failed: unrecognized action: $action"
+ unless $action =~ /^(on|off|reboot|status)$/i;
+
+ if (defined $passwd_script) {
+ $pwd_script_out = `$passwd_script`;
+ chomp($pwd_script_out);
+ if ($pwd_script_out) {
+ $passwd = $pwd_script_out;
+ }
+ }
+ fail "failed: no password" unless defined $passwd;
+}
+
+stat($bulldir);
+die "NSMasterHW not installed correctly" if ! -d _;
+
+# convert $action to lower case
+$_=$action;
+if (/^on$/i) { $action = "on"; }
+elsif (/^off$/i) { $action = "off"; }
+elsif (/^reboot$/i) { $action = "reboot"; }
+elsif (/^status$/i) { $action = "status"; }
+
+#
+# If if pampower / pamreset don't exist, we're done.
+#
+# -M -- the maintenance port on the NovaScale Windows 2000 master server
+# -D -- the Domain to reboot
+# -u -- User name
+# -p -- Password
+#
+#/usr/local/bull/NSMasterHW/bin/pamreset.pl
+# -M 192.168.78.169 -D Domaine2-8CPU -u Administrator -p administrator
+#
+#/usr/local/bull/NSMasterHW/bin/pampower.pl -a off_force
+# -M 192.168.78.169 -D Domaine2-8CPU -u Administrator -p administrator
+#
+#/usr/local/bull/NSMasterHW/bin/pampower.pl -a on
+# -M 192.168.78.169 -D Domaine2-8CPU -u Administrator -p administrator
+#
+# Do the command
+#
+$success=0;
+$_ = $action;
+my $exit_code=0;
+if (/(on|off)/)
+{
+ my $timeout = 120; # 120 = max of (60, 120). Max timeout for "on"
+ # on 32-way bull machines
+
+ set_power_state $host,$domain,$action,$login,$passwd;
+ do {
+ sleep 5;
+ $state=get_power_state $host,$domain,$login,$passwd;
+ $timeout -= 5;
+ } while ($timeout > 0 && !($state =~ /^$action$/i));
+
+ $success = 1 if ($state=~/^$action$/i);
+}
+elsif (/reboot/)
+{
+ my $timeout = 60; # 60 seconds for "off" for 32-way bull machines
+
+ set_power_state $host,$domain,"off",$login,$passwd;
+ do {
+ sleep 5;
+ $state=get_power_state $host,$domain,$login,$passwd;
+ $timeout -= 5;
+ } while ($timeout > 0 && $state != 0);
+
+ if ($timeout <= 0) {
+ $success = 0;
+ } else {
+ $timeout = 120; # 120 seconds for on, for 32-way bull machines
+ set_power_state $host,$domain,"on",$login,$passwd;
+ do {
+ sleep 5;
+ $state=get_power_state $host,$domain,$login,$passwd;
+ $timeout -= 5;
+ } while ($timeout > 0 && $state != 0);
+
+ $success = 1 if ($state == 0);
+ }
+}
+elsif (/status/)
+{
+ get_power_state $host,$domain,$login,$passwd;
+ $state=$_;
+ $success = 1 if defined $state;
+ if ($state eq "OFF") {
+ $exit_code = 2;
+ }
+}
+else
+{
+ fail "fail: illegal action";
+}
+
+if ($success)
+{
+ print "success: domain $domain $action". ((defined $state) ? ": $state":"")
+ ."\n" unless defined $quiet;
+ exit $exit_code;
+}
+else
+{
+ fail "fail: domain $domain $action";
+ exit 1
+}
+
+
diff --git a/fence/agents/cisco_mds/Makefile.am b/fence/agents/cisco_mds/Makefile.am
new file mode 100644
index 0000000..3d262f6
--- /dev/null
+++ b/fence/agents/cisco_mds/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_cisco_mds
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/cisco_mds/fence_cisco_mds.py b/fence/agents/cisco_mds/fence_cisco_mds.py
new file mode 100644
index 0000000..4acce4f
--- /dev/null
+++ b/fence/agents/cisco_mds/fence_cisco_mds.py
@@ -0,0 +1,105 @@
+#!/usr/bin/python
+
+# The Following agent has been tested on:
+# - Cisco MDS UROS 9134 FC (1 Slot) Chassis ("1/2/4 10 Gbps FC/Supervisor-2") Motorola, e500v2
+# with BIOS 1.0.16, kickstart 4.1(1c), system 4.1(1c)
+# - Cisco MDS 9124 (1 Slot) Chassis ("1/2/4 Gbps FC/Supervisor-2") Motorola, e500
+# with BIOS 1.0.16, kickstart 4.1(1c), system 4.1(1c)
+
+import sys, re
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+from fencing_snmp import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="Cisco MDS 9xxx SNMP fence agent"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+### CONSTANTS ###
+# Cisco admin status
+PORT_ADMIN_STATUS_OID = ".1.3.6.1.2.1.75.1.2.2.1.1"
+
+# IF-MIB trees for alias, status and port
+ALIASES_OID = ".1.3.6.1.2.1.31.1.1.1.18"
+PORTS_OID = ".1.3.6.1.2.1.2.2.1.2"
+
+### GLOBAL VARIABLES ###
+# OID converted from fc port name (fc(x)/(y))
+PORT_OID = ""
+
+### FUNCTIONS ###
+
+# Convert cisco port name (fc(x)/(y)) to OID
+def cisco_port2oid(port):
+ port = port.lower()
+
+ nums = re.match('^fc(\d+)/(\d+)$', port)
+
+ if ((nums) and (len(nums.groups()))==2):
+ return "%s.%d.%d"% (PORT_ADMIN_STATUS_OID, int(nums.group(1))+21, int(nums.group(2))-1)
+ else:
+ fail_usage("Mangled port number: %s"%(port))
+
+def get_power_status(conn, options):
+ (oid, status) = conn.get(PORT_OID)
+ return (status=="1" and "on" or "off")
+
+def set_power_status(conn, options):
+ conn.set(PORT_OID, (options["--action"]=="on" and 1 or 2))
+
+# Convert array of format [[key1, value1], [key2, value2], ... [keyN, valueN]] to dict, where key is
+# in format a.b.c.d...z and returned dict has key only z
+def array_to_dict(ar):
+ return dict(map(lambda y:[y[0].split('.')[-1], y[1]], ar))
+
+def get_outlets_status(conn, options):
+ result = {}
+
+ res_fc = conn.walk(PORTS_OID, 30)
+ res_aliases = array_to_dict(conn.walk(ALIASES_OID, 30))
+
+ fc_re = re.compile('^"fc\d+/\d+"$')
+
+ for x in res_fc:
+ if fc_re.match(x[1]):
+ port_num = x[0].split('.')[-1]
+
+ port_name = x[1].strip('"')
+ port_alias = (res_aliases.has_key(port_num) and res_aliases[port_num].strip('"') or "")
+ port_status = ""
+ result[port_name] = (port_alias, port_status)
+
+ return result
+
+# Main agent method
+def main():
+ global PORT_OID
+
+ device_opt = [ "fabric_fencing", "ipaddr", "login", "passwd", "no_login", "no_password", \
+ "port", "snmp_version", "community" ]
+
+ atexit.register(atexit_handler)
+
+ snmp_define_defaults ()
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for Cisco MDS"
+ docs["longdesc"] = "fence_cisco_mds is an I/O Fencing agent \
+which can be used with any Cisco MDS 9000 series with SNMP enabled device."
+ docs["vendorurl"] = "http://www.cisco.com"
+ show_docs(options, docs)
+
+ if (not (options["--action"] in ["list","monitor"])):
+ PORT_OID = cisco_port2oid(options["--plug"])
+
+ # Operate the fencing device
+ result = fence_action(FencingSnmp(options), options, set_power_status, get_power_status, get_outlets_status)
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/cisco_ucs/Makefile.am b/fence/agents/cisco_ucs/Makefile.am
new file mode 100644
index 0000000..c12e5ef
--- /dev/null
+++ b/fence/agents/cisco_ucs/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_cisco_ucs
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/cisco_ucs/fence_cisco_ucs.py b/fence/agents/cisco_ucs/fence_cisco_ucs.py
new file mode 100644
index 0000000..f70a835
--- /dev/null
+++ b/fence/agents/cisco_ucs/fence_cisco_ucs.py
@@ -0,0 +1,158 @@
+#!/usr/bin/python
+
+import sys, re
+import pycurl, StringIO
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="New Cisco UCS Agent - test release on steroids"
+REDHAT_COPYRIGHT=""
+BUILD_DATE="March, 2008"
+#END_VERSION_GENERATION
+
+RE_COOKIE = re.compile("<aaaLogin .* outCookie=\"(.*?)\"", re.IGNORECASE)
+RE_STATUS = re.compile("<lsPower .*? state=\"(.*?)\"", re.IGNORECASE)
+RE_GET_DN = re.compile(" dn=\"(.*?)\"", re.IGNORECASE)
+RE_GET_DESC = re.compile(" descr=\"(.*?)\"", re.IGNORECASE)
+
+def get_power_status(conn, options):
+ res = send_command(options, \
+ "<configResolveDn cookie=\"" + options["cookie"] + "\" inHierarchical=\"false\" dn=\"org-root" + options["--suborg"] + \
+ "/ls-" + options["--plug"] + "/power\"/>", \
+ int(options["--shell-timeout"]))
+
+ result = RE_STATUS.search(res)
+ if (result == None):
+ fail(EC_STATUS)
+ else:
+ status = result.group(1)
+
+ if (status == "up"):
+ return "on"
+ else:
+ return "off"
+
+def set_power_status(conn, options):
+ action = {
+ 'on' : "up",
+ 'off' : "down"
+ }[options["--action"]]
+
+ res = send_command(options, \
+ "<configConfMos cookie=\"" + options["cookie"] + "\" inHierarchical=\"no\">" + \
+ "<inConfigs><pair key=\"org-root" + options["--suborg"] + "/ls-" + options["--plug"] + "/power\">" + \
+ "<lsPower dn=\"org-root/ls-" + options["--plug"] + "/power\" state=\"" + action + "\" status=\"modified\" />" + \
+ "</pair></inConfigs></configConfMos>", \
+ int(options["--shell-timeout"]))
+
+ return
+
+def get_list(conn, options):
+ outlets = { }
+
+ try:
+ res = send_command(options, \
+ "<configResolveClass cookie=\"" + options["cookie"] + "\" inHierarchical=\"false\" classId=\"lsServer\"/>", \
+ int(options["--shell-timeout"]))
+
+ lines = res.split("<lsServer ")
+ for i in range(1, len(lines)):
+ dn = RE_GET_DN.search(lines[i]).group(1)
+ desc = RE_GET_DESC.search(lines[i]).group(1)
+ outlets[dn] = (desc, None)
+ except AttributeError:
+ return { }
+ except IndexError:
+ return { }
+
+ return outlets
+
+def send_command(opt, command, timeout):
+ ## setup correct URL
+ if opt.has_key("--ssl"):
+ url = "https:"
+ else:
+ url = "http:"
+
+ url += "//" + opt["--ip"] + ":" + str(opt["--ipport"]) + "/nuova"
+
+ ## send command through pycurl
+ c = pycurl.Curl()
+ b = StringIO.StringIO()
+ c.setopt(pycurl.URL, url)
+ c.setopt(pycurl.HTTPHEADER, [ "Content-type: text/xml" ])
+ c.setopt(pycurl.POSTFIELDS, command)
+ c.setopt(pycurl.WRITEFUNCTION, b.write)
+ c.setopt(pycurl.TIMEOUT, timeout)
+ c.setopt(pycurl.SSL_VERIFYPEER, 0)
+ c.setopt(pycurl.SSL_VERIFYHOST, 0)
+ c.perform()
+ result = b.getvalue()
+
+ if opt["log"] >= LOG_MODE_VERBOSE:
+ opt["debug_fh"].write(command + "\n")
+ opt["debug_fh"].write(result + "\n")
+
+ return result
+
+def define_new_opts():
+ all_opt["suborg"] = {
+ "getopt" : "s:",
+ "longopt" : "suborg",
+ "help" : "--suborg=[path] Additional path needed to access suborganization",
+ "required" : "0",
+ "shortdesc" : "Additional path needed to access suborganization",
+ "default" : "",
+ "order" : 1 }
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "ssl", "port", "web", "suborg" ]
+
+ atexit.register(atexit_handler)
+
+ define_new_opts()
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for Cisco UCS"
+ docs["longdesc"] = "fence_cisco_ucs is an I/O Fencing agent which can be \
+used with Cisco UCS to fence machines."
+ docs["vendorurl"] = "http://www.cisco.com"
+ show_docs(options, docs)
+
+ ## Do the delay of the fence device before logging in
+ ## Delay is important for two-node clusters fencing but we do not need to delay 'status' operations
+ if options["--action"] in ["off", "reboot"]:
+ time.sleep(int(options["--delay"]))
+
+ ### Login
+ try:
+ res = send_command(options, "<aaaLogin inName=\"" + options["--username"] + "\" inPassword=\"" + options["--password"] + "\" />", int(options["--login-timeout"]))
+ result = RE_COOKIE.search(res)
+ if (result == None):
+ ## Cookie is absenting in response
+ fail(EC_LOGIN_DENIED)
+ except:
+ fail(EC_LOGIN_DENIED)
+
+ options["cookie"] = result.group(1)
+
+ ##
+ ## Modify suborg to format /suborg
+ if options["--suborg"] != "":
+ options["--suborg"] = "/" + options["--suborg"].lstrip("/").rstrip("/")
+
+ ##
+ ## Fence operations
+ ####
+ result = fence_action(None, options, set_power_status, get_power_status, get_list)
+
+ ### Logout; we do not care about result as we will end in any case
+ send_command(options, "<aaaLogout inCookie=\"" + options["cookie"] + "\" />", int(options["--shell-timeout"]))
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/cpint/Makefile.am b/fence/agents/cpint/Makefile.am
new file mode 100644
index 0000000..c9680bd
--- /dev/null
+++ b/fence/agents/cpint/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_cpint
+
+SRC = $(TARGET).pl
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fencemanperl.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/cpint/fence_cpint.pl b/fence/agents/cpint/fence_cpint.pl
new file mode 100644
index 0000000..7a7a5f5
--- /dev/null
+++ b/fence/agents/cpint/fence_cpint.pl
@@ -0,0 +1,188 @@
+#!/usr/bin/perl
+
+use Getopt::Std;
+
+my $ME = $0;
+
+END {
+ defined fileno STDOUT or return;
+ close STDOUT and return;
+ warn "$ME: failed to close standard output: $!\n";
+ $? ||= 1;
+}
+
+# Get the program name from $0 and strip directory names
+$_=$0;
+s/.*\///;
+my $pname = $_;
+
+$comm_prog = "hcp";
+
+# WARNING!! Do not add code bewteen "#BEGIN_VERSION_GENERATION" and
+# "#END_VERSION_GENERATION" It is generated by the Makefile
+
+#BEGIN_VERSION_GENERATION
+$RELEASE_VERSION="";
+$REDHAT_COPYRIGHT="";
+$BUILD_DATE="";
+#END_VERSION_GENERATION
+
+
+sub usage
+{
+ print "Usage:\n";
+ print "\n";
+ print "$pname [options]\n";
+ print "\n";
+ print "Options:\n";
+ print " -h usage\n";
+ print " -o metadata print XML metadata for fence agent\n";
+ print " -u <string> userid of the virtual machine to fence\n";
+ print " -q quiet mode\n";
+ print " -V Version\n";
+
+ exit 0;
+}
+
+sub fail
+{
+ ($msg)=@_;
+ print "failed: " . $msg . "\n" unless defined $opt_q;
+ exit 1;
+}
+
+sub fail_usage
+{
+ ($msg)=@_q;
+ print stderr $msg."\n" if $msg;
+ print stderr "Please use '-h' for usage.\n";
+ exit 1;
+}
+
+sub version
+{
+ print "$pname $RELEASE_VERSION $BUILD_DATE\n";
+ print "$REDHAT_COPYRIGHT\n" if ( $REDHAT_COPYRIGHT );
+
+ exit 0;
+}
+
+sub print_metadata
+{
+print '<?xml version="1.0" ?>
+<resource-agent name="fence_cpint" shortdesc="I/O Fencing agent for GFS on s390 and zSeries VM clusters" >
+<longdesc>
+fence_cpint is an I/O Fencing agent used on a virtual machine running GFS in a s390 or zSeries VM cluster. It uses the cpint package to send a CP LOGOFF command to the specified virtual machine. For fence_cpint to execute correctly, you must have the cpint module installed, and hcp in your PATH.
+
+NOTE: for fence_cpint to send a command to another virtual machine, the machine executing it must either be a privilege class C user or it must be the secondary user of the virtual machine to be fenced. This means that unless all of you GULM server nodes are privilege class C, fence_cpint can only be used with SLM.
+</longdesc>
+<vendor-url>http://www.ibm.com</vendor-url>
+<parameters>
+ <parameter name="userid" unique="1" required="1">
+ <getopt mixed="-u [userid]" />
+ <content type="string" />
+ <shortdesc lang="en">Userid of the virtual machine to fence</shortdesc>
+ </parameter>
+ <parameter name="help" unique="1" required="0">
+ <getopt mixed="-h" />
+ <content type="string" />
+ <shortdesc lang="en">Display help and exit</shortdesc>
+ </parameter>
+</parameters>
+<actions>
+ <action name="metadata" />
+</actions>
+</resource-agent>
+';
+}
+
+sub get_options_stdin
+{
+ my $opt;
+ my $line = 0;
+ while( defined($in = <>) )
+ {
+ $_ = $in;
+ chomp;
+
+ # strip leading and trailing whitespace
+ s/^\s*//;
+ s/\s*$//;
+
+ # skip comments
+ next if /^#/;
+
+ $line+=1;
+ $opt=$_;
+ next unless $opt;
+
+ ($name,$val)=split /\s*=\s*/, $opt;
+
+ if ( $name eq "" )
+ {
+ print stderr "parse error: illegal name in option $line\n";
+ exit 2;
+ }
+
+ # DO NOTHING -- this field is used by fenced or stomithd
+ elsif ($name eq "agent" ) { }
+
+ # FIXME -- depricated. use "userid" and "password" instead.
+ elsif ($name eq "fm" )
+ {
+ (my $dummy,$opt_u,$opt_p) = split /\s+/,$val;
+ print STDERR "Depricated \"fm\" entry detected. refer to man page.\n";
+ }
+
+ # FIXME -- depreicated residue of old fencing system
+ elsif ($name eq "name" ) { }
+
+ elsif ($name eq "userid" )
+ {
+ $opt_u = $val;
+ }
+
+ elsif ($name eq "action" )
+ {
+ $opt_o = $val;
+ }
+
+ else
+ {
+ print stderr "parse error: unknown option \"$opt\"\n";
+ #> exit 2;
+ }
+ }
+}
+
+if (@ARGV > 0){
+ getopts("hqu:Vo:") || fail_usage;
+ usage if defined $opt_h;
+ version if defined $opt_V;
+
+ fail_usage "Unkown parameter." if (@ARGV > 0);
+
+ if ((defined $opt_o) && ($opt_o =~ /metadata/i)) {
+ print_metadata();
+ exit 0;
+ }
+
+ fail_usage "No '-u' flag specified." unless defined $opt_u;
+} else {
+ get_options_stdin();
+
+ if ((defined $opt_o) && ($opt_o =~ /metadata/i)) {
+ print_metadata();
+ exit 0;
+ }
+
+ fail "no userid" unless defined $opt_u;
+}
+
+$ret_val = system("$comm_prog send cp $opt_u logoff > /dev/null 2>&1") >> 8;
+fail "$comm_prog failed ($ret_val)" unless ($ret_val == 0 || $ret_val == 45);
+$ret_val = system("$comm_prog send cp $opt_u > /dev/null 2>&1") >> 8;
+fail "$userid isn't logged off. $comm_prog return ($ret_val)" unless ($ret_val == 45);
+
+print "success: booted userid $opt_u\n" unless defined $opt_q;
+exit 0;
diff --git a/fence/agents/drac/Makefile.am b/fence/agents/drac/Makefile.am
new file mode 100644
index 0000000..0616c57
--- /dev/null
+++ b/fence/agents/drac/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_drac
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/drac/fence_drac.py b/fence/agents/drac/fence_drac.py
new file mode 100644
index 0000000..c690b21
--- /dev/null
+++ b/fence/agents/drac/fence_drac.py
@@ -0,0 +1,80 @@
+#!/usr/bin/python
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION=""
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+def get_power_status(conn, options):
+ conn.send_eol("getmodinfo")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ status = re.compile("\s+(on|off)\s+", re.IGNORECASE).search(conn.before).group(1)
+ return (status.lower().strip())
+
+def set_power_status(conn, options):
+ action = {
+ 'on' : "powerup",
+ 'off': "powerdown"
+ }[options["--action"]]
+
+ conn.send_eol("serveraction -d 0 " + action)
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "cmd_prompt" ]
+
+ atexit.register(atexit_handler)
+
+ opt = process_input(device_opt)
+ if "--username" in opt:
+ all_opt["cmd_prompt"]["default"] = [ "\\[" + opt["--username"] + "\\]# " ]
+ else:
+ all_opt["cmd_prompt"]["default"] = [ "\\[" "username" + "\\]# " ]
+
+ options = check_input(device_opt, opt)
+
+ docs = { }
+ docs["shortdesc"] = "I/O Fencing agent for Dell DRAC IV"
+ docs["longdesc"] = "fence_drac is an I/O Fencing agent which can be used with \
+the Dell Remote Access Card (DRAC). This card provides remote access to controlling \
+power to a server. It logs into the DRAC through the telnet interface of the card. By \
+default, the telnet interface is not enabled. To enable the interface, you will need \
+to use the racadm command in the racser-devel rpm available from Dell. \
+\
+To enable telnet on the DRAC: \
+\
+[root]# racadm config -g cfgSerial -o cfgSerialTelnetEnable 1 \
+\
+[root]# racadm racreset \
+"
+ docs["vendorurl"] = "http://www.dell.com"
+ show_docs(options, docs)
+
+ ##
+ ## Operate the fencing device
+ ####
+ conn = fence_login(options)
+ result = fence_action(conn, options, set_power_status, get_power_status, None)
+
+ ##
+ ## Logout from system
+ ##
+ ## In some special unspecified cases it is possible that
+ ## connection will be closed before we run close(). This is not
+ ## a problem because everything is checked before.
+ ######
+ try:
+ conn.send_eol("exit")
+ conn.close()
+ except:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/drac5/Makefile.am b/fence/agents/drac5/Makefile.am
new file mode 100644
index 0000000..2654360
--- /dev/null
+++ b/fence/agents/drac5/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_drac5
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/drac5/fence_drac5.py b/fence/agents/drac5/fence_drac5.py
new file mode 100644
index 0000000..2c067a7
--- /dev/null
+++ b/fence/agents/drac5/fence_drac5.py
@@ -0,0 +1,160 @@
+#!/usr/bin/python
+
+#####
+##
+## The Following Agent Has Been Tested On:
+##
+## DRAC Version Firmware
+## +-----------------+---------------------------+
+## DRAC 5 1.0 (Build 06.05.12)
+## DRAC 5 1.21 (Build 07.05.04)
+##
+## @note: drac_version was removed
+#####
+
+import sys, re, pexpect, exceptions, time
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="New Drac5 Agent - test release on steroids"
+REDHAT_COPYRIGHT=""
+BUILD_DATE="March, 2008"
+#END_VERSION_GENERATION
+
+def get_power_status(conn, options):
+ if options["--drac-version"] == "DRAC MC":
+ (_, status) = get_list_devices(conn,options)[options["--plug"]]
+ else:
+ if options["--drac-version"] == "DRAC CMC":
+ conn.send_eol("racadm serveraction powerstatus -m " + options["--plug"])
+ elif options["--drac-version"] == "DRAC 5":
+ conn.send_eol("racadm serveraction powerstatus")
+
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ status = re.compile("(^|: )(ON|OFF|Powering ON|Powering OFF)\s*$", re.IGNORECASE | re.MULTILINE).search(conn.before).group(2)
+
+ if status.lower().strip() in ["on", "powering on", "powering off"]:
+ return "on"
+ else:
+ return "off"
+
+def set_power_status(conn, options):
+ action = {
+ 'on' : "powerup",
+ 'off': "powerdown"
+ }[options["--action"]]
+
+ if options["--drac-version"] == "DRAC CMC":
+ conn.send_eol("racadm serveraction " + action + " -m " + options["--plug"])
+ elif options["--drac-version"] == "DRAC 5":
+ conn.send_eol("racadm serveraction " + action)
+ elif options["--drac-version"] == "DRAC MC":
+ conn.send_eol("racadm serveraction -s " + options["--plug"] + " " + action)
+
+ ## Fix issue with double-enter [CR/LF]
+ ## We need to read two additional command prompts (one from get + one from set command)
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+ if len(conn.before.strip()) == 0:
+ options["eol"] = options["eol"][:-1]
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+
+def get_list_devices(conn, options):
+ outlets = { }
+
+ if options["--drac-version"] == "DRAC CMC":
+ conn.send_eol("getmodinfo")
+
+ list_re = re.compile("^([^\s]*?)\s+Present\s*(ON|OFF)\s*.*$")
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+ for line in conn.before.splitlines():
+ if (list_re.search(line)):
+ outlets[list_re.search(line).group(1)] = ("", list_re.search(line).group(2))
+ elif options["--drac-version"] == "DRAC MC":
+ conn.send_eol("getmodinfo")
+
+ list_re = re.compile("^\s*([^\s]*)\s*---->\s*(.*?)\s+Present\s*(ON|OFF)\s*.*$")
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+ for line in conn.before.splitlines():
+ if (list_re.search(line)):
+ outlets[list_re.search(line).group(2)] = ("", list_re.search(line).group(3))
+ elif options["--drac-version"] == "DRAC 5":
+ ## DRAC 5 can be used only for one computer
+ ## standard fence library can't handle correctly situation
+ ## when some fence devices supported by fence agent
+ ## works with 'list' and other should returns 'N/A'
+ print "N/A"
+
+ return outlets
+
+def define_new_opts():
+ all_opt["drac_version"] = {
+ "getopt" : "d:",
+ "longopt" : "drac-version",
+ "help" : "-d, --drac-version=[version] Force DRAC version to use (DRAC 5, DRAC CMC, DRAC MC)",
+ "required" : "0",
+ "shortdesc" : "Force DRAC version to use (DRAC 5, DRAC CMC, DRAC MC)",
+ "choices" : [ "DRAC CMC", "DRAC MC", "DRAC 5" ],
+ "order" : 1 }
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "cmd_prompt", "secure", \
+ "drac_version", "port", "no_port" ]
+
+ atexit.register(atexit_handler)
+
+ define_new_opts()
+
+ all_opt["cmd_prompt"]["default"] = [ "\$", "DRAC\/MC:" ]
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for Dell DRAC CMC/5"
+ docs["longdesc"] = "fence_drac5 is an I/O Fencing agent \
+which can be used with the Dell Remote Access Card v5 or CMC (DRAC). \
+This device provides remote access to controlling power to a server. \
+It logs into the DRAC through the telnet/ssh interface of the card. \
+By default, the telnet interface is not enabled."
+ docs["vendorurl"] = "http://www.dell.com"
+ show_docs(options, docs)
+
+ ##
+ ## Operate the fencing device
+ ######
+ conn = fence_login(options)
+
+ if options.has_key("--drac-version") == False:
+ ## autodetect from text issued by fence device
+ if conn.before.find("CMC") >= 0:
+ options["--drac-version"] = "DRAC CMC"
+ elif conn.before.find("DRAC 5") >= 0:
+ options["--drac-version"] = "DRAC 5"
+ elif conn.after.find("DRAC/MC") >= 0:
+ options["--drac-version"] = "DRAC MC"
+ else:
+ ## Assume this is DRAC 5 by default as we don't want to break anything
+ options["--drac-version"] = "DRAC 5"
+
+ if options["--drac-version"] in ["DRAC MC", "DRAC CMC"]:
+ if 0 == options.has_key("--plug") and 0 == ["monitor", "list"].count(options["--action"].lower()):
+ fail_usage("Failed: You have to enter module name (-n)")
+
+ result = fence_action(conn, options, set_power_status, get_power_status, get_list_devices)
+
+ ##
+ ## Logout from system
+ ######
+ try:
+ conn.send_eol("exit")
+ time.sleep(1)
+ conn.close()
+ except:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/dummy/Makefile.am b/fence/agents/dummy/Makefile.am
new file mode 100644
index 0000000..11405eb
--- /dev/null
+++ b/fence/agents/dummy/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_dummy
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/dummy/fence_dummy.py b/fence/agents/dummy/fence_dummy.py
new file mode 100644
index 0000000..d5bb748
--- /dev/null
+++ b/fence/agents/dummy/fence_dummy.py
@@ -0,0 +1,131 @@
+#!/usr/bin/python
+
+import sys, re, pexpect, exceptions, random
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="New Dummy Agent - test release on steroids"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+plug_status="on"
+
+def get_power_status_file(conn, options):
+ try:
+ status_file = open(options["--status-file"], 'r')
+ except:
+ return "off"
+
+ status = status_file.read()
+ status_file.close()
+
+ return status.lower()
+
+def set_power_status_file(conn, options):
+ if not (options["--action"] in [ "on", "off" ]):
+ return
+
+ status_file = open(options["--status-file"], 'w')
+ status_file.write(options["--action"])
+ status_file.close()
+
+def get_power_status_fail(conn, options):
+ outlets = get_outlets_fail(conn,options)
+
+ if len(outlets) == 0 or options.has_key("--plug") == 0:
+ fail_usage("Failed: You have to enter existing machine!")
+ else:
+ return outlets[options["--plug"]][0]
+
+def set_power_status_fail(conn, options):
+ global plug_status
+
+ plug_status = "unknown"
+ if options["--action"] == "on":
+ plug_status = "off"
+
+def get_outlets_fail(conn, options):
+ result = {}
+ global plug_status
+
+ if options["--action"] == "on":
+ plug_status = "off"
+
+ # This fake agent has no port data to list, so we have to make
+ # something up for the list action.
+ if options.has_key("--action") and options["--action"] == "list":
+ result["fake_port_1"] = [plug_status, "fake"]
+ result["fake_port_2"] = [plug_status, "fake"]
+ elif (options.has_key("--plug") == 0):
+ fail_usage("Failed: You have to enter existing machine!")
+ else:
+ port = options["--plug"]
+ result[port] = [plug_status, "fake"]
+
+ return result
+
+def main():
+ device_opt = [ "no_password", "status_file", "random_sleep_range", "type", "port" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["status_file"] = {
+ "getopt" : "s:",
+ "longopt" : "status-file",
+ "help":"--status-file=[file] Name of file that holds current status",
+ "required" : "0",
+ "shortdesc" : "File with status",
+ "default" : "/tmp/fence_dummy.status",
+ "order": 1
+ }
+
+ all_opt["random_sleep_range"] = {
+ "getopt" : "r:",
+ "longopt" : "random_sleep_range",
+ "help":"--random_sleep_range=[seconds] Issue a sleep between 1 and [seconds]",
+ "required" : "0",
+ "shortdesc" : "Issue a sleep between 1 and X seconds. Used for testing.",
+ "order": 1
+ }
+
+ all_opt["type"] = {
+ "getopt" : "t:",
+ "longopt" : "type",
+ "help":"--type=[type] Possible types are: file and fail",
+ "required" : "0",
+ "shortdesc" : "Type of the dummy fence agent",
+ "default" : "file",
+ "order": 1
+ }
+
+ pinput = process_input(device_opt)
+ if (pinput.has_key("--type") and pinput["--type"] == "file") or (pinput.has_key("--type") == False):
+ # hack to have fence agents that require ports 'fail' and one that do not 'file'
+ device_opt.remove("port")
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Dummy fence agent"
+ docs["longdesc"] = "fence_dummy"
+ docs["vendorurl"] = "http://www.example.com"
+ show_docs(options, docs)
+
+ # random sleep for testing
+ if options.has_key("--random_sleep_range"):
+ val = int(options["--random_sleep_range"])
+ ran = random.randint(1, val)
+ sys.stderr.write("random sleep for %d seconds\n" % ran)
+ time.sleep(ran)
+
+ if options["--type"] == "fail":
+ result = fence_action(None, options, set_power_status_fail, get_power_status_fail, get_outlets_fail)
+ else:
+ result = fence_action(None, options, set_power_status_file, get_power_status_file, None)
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/eaton_snmp/Makefile.am b/fence/agents/eaton_snmp/Makefile.am
new file mode 100644
index 0000000..0390800
--- /dev/null
+++ b/fence/agents/eaton_snmp/Makefile.am
@@ -0,0 +1,18 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_eaton_snmp
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC) \
+ README
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/eaton_snmp/README b/fence/agents/eaton_snmp/README
new file mode 100644
index 0000000..82619d7
--- /dev/null
+++ b/fence/agents/eaton_snmp/README
@@ -0,0 +1,20 @@
+This is an snmp based fence agent for Eaton power distribution units to be used
+with RHEL4 Red Hat Cluster Suite.
+
+In order to use this agent, you will need to have net-snmp-utils installed
+on every node in your cluster. net-snmp-utils is scheduled for inclusion
+in the base RHEL distribution for Update 4, and is yummable in FC5.
+
+To use the agent, cp the agent to the /sbin directory on every
+cluster node.
+
+Then define a <fencedevice> in the cluster.conf file with
+agent="fence_eaton_snmp" as an attribute, and use it that way.
+Note, please, that the GUI does not support this agent yet, and you will have
+to edit your cluster.conf by hand and then propagate it yourself. If you need
+help with this, email me at the address below.
+
+The interface for the fence_eaton_snmp agent is identical to the existing
+fence_apc_snmp agent, upon which it has been derived.
+
+--Arnaud Quette - ArnaudQuette at Eaton.com
diff --git a/fence/agents/eaton_snmp/fence_eaton_snmp.py b/fence/agents/eaton_snmp/fence_eaton_snmp.py
new file mode 100644
index 0000000..462d541
--- /dev/null
+++ b/fence/agents/eaton_snmp/fence_eaton_snmp.py
@@ -0,0 +1,233 @@
+#!/usr/bin/python
+
+# The Following agent has been tested on:
+# - Eaton ePDU Managed - SNMP v1
+# EATON | Powerware ePDU model: Managed ePDU (PW104MA0UB99), firmware: 01.01.01
+# - Eaton ePDU Switched - SNMP v1
+# EATON | Powerware ePDU model: Switched ePDU (IPV3600), firmware: 2.0.K
+
+import sys
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+from fencing_snmp import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="Eaton SNMP fence agent"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+### CONSTANTS ###
+# oid defining fence device
+OID_SYS_OBJECT_ID = '.1.3.6.1.2.1.1.2.0'
+
+### GLOBAL VARIABLES ###
+# Device - see EatonManagedePDU, EatonSwitchedePDU
+device = None
+
+# Port ID
+port_id = None
+# Switch ID
+switch_id = None
+
+# Did we issue a set before get (to adjust OID with Switched ePDU)
+after_set = False
+
+# Classes describing Device params
+# Managed ePDU
+class EatonManagedePDU:
+ status_oid = '.1.3.6.1.4.1.534.6.6.6.1.2.2.1.3.%d'
+ control_oid = '.1.3.6.1.4.1.534.6.6.6.1.2.2.1.3.%d'
+ outlet_table_oid = '.1.3.6.1.4.1.534.6.6.6.1.2.2.1.1'
+ ident_str = "Eaton Managed ePDU"
+ state_off = 0
+ state_on = 1
+ state_cycling = 2 # FIXME: not usable with fence-agents
+ turn_off = 0
+ turn_on = 1
+ turn_cycle = 2 # FIXME: not usable with fence-agents
+ has_switches = False
+
+# Switched ePDU (Pulizzi 2)
+# NOTE: sysOID reports "20677.1", while data are actually at "20677.2"
+class EatonSwitchedePDU:
+ status_oid = '.1.3.6.1.4.1.20677.2.6.3.%d.0'
+ control_oid = '.1.3.6.1.4.1.20677.2.6.2.%d.0'
+ outlet_table_oid = '.1.3.6.1.4.1.20677.2.6.3'
+ ident_str = "Eaton Switched ePDU"
+ state_off = 2
+ state_on = 1
+ state_cycling = 0 # Note: this status doesn't exist on this device
+ turn_off = 2
+ turn_on = 1
+ turn_cycle = 3 # FIXME: not usable with fence-agents
+ has_switches = False
+
+### FUNCTIONS ###
+def eaton_set_device(conn, options):
+ global device
+
+ agents_dir = {'.1.3.6.1.4.1.534.6.6.6':EatonManagedePDU,
+ '.1.3.6.1.4.1.20677.1':EatonSwitchedePDU,
+ '.1.3.6.1.4.1.20677.2':EatonSwitchedePDU }
+
+ # First resolve type of Eaton
+ eaton_type = conn.walk(OID_SYS_OBJECT_ID)
+
+ if (not ((len(eaton_type)==1) and (agents_dir.has_key(eaton_type[0][1])))):
+ eaton_type = [[None, None]]
+
+ device = agents_dir[eaton_type[0][1]]
+
+ conn.log_command("Trying %s"%(device.ident_str))
+
+def eaton_resolv_port_id(conn, options):
+ global port_id, switch_id
+
+ if (device==None):
+ eaton_set_device(conn, options)
+
+ # Restore the increment, that was removed in main for ePDU Managed
+ if (device.ident_str == "Eaton Switched ePDU"):
+ options["--plug"] = str(int(options["--plug"]) + 1)
+
+ # Now we resolv port_id/switch_id
+ if ((options["--plug"].isdigit()) and ((not device.has_switches) or (options["--switch"].isdigit()))):
+ port_id = int(options["--plug"])
+
+ if (device.has_switches):
+ switch_id = int(options["--switch"])
+ else:
+ table = conn.walk(device.outlet_table_oid, 30)
+
+ for x in table:
+ if (x[1].strip('"')==options["--plug"]):
+ t = x[0].split('.')
+ if (device.has_switches):
+ port_id = int(t[len(t)-1])
+ switch_id = int(t[len(t)-3])
+ else:
+ if (device.ident_str == "Eaton Switched ePDU"):
+ port_id = int(t[len(t)-3])
+ else:
+ port_id = int(t[len(t)-1])
+
+ if (port_id==None):
+ # Restore index offset, to provide a valid error output on Managed ePDU
+ if (device.ident_str != "Eaton Switched ePDU"):
+ options["--plug"] = str(int(options["--plug"]) + 1)
+ fail_usage("Can't find port with name %s!"%(options["--plug"]))
+
+def get_power_status(conn, options):
+ global port_id, after_set
+
+ if (port_id==None):
+ eaton_resolv_port_id(conn, options)
+
+ # Ajust OID for Switched ePDU when the get is after a set
+ if ((after_set == True) and (device.ident_str == "Eaton Switched ePDU")):
+ port_id -= 1
+ after_set = False
+
+ oid = ((device.has_switches) and device.status_oid%(switch_id, port_id) or device.status_oid%(port_id))
+
+ try:
+ (oid, status)=conn.get(oid)
+ if (status==str(device.state_on)):
+ return "on"
+ elif (status==str(device.state_off)):
+ return "off"
+ else:
+ return None
+ except:
+ return None
+
+def set_power_status(conn, options):
+ global port_id, after_set
+
+ after_set = True
+
+ if (port_id==None):
+ eaton_resolv_port_id(conn, options)
+
+ # Controls start at #2 on Switched ePDU, since #1 is the global command
+ if (device.ident_str == "Eaton Switched ePDU"):
+ port_id = int(port_id)+1
+
+ oid = ((device.has_switches) and device.control_oid%(switch_id, port_id) or device.control_oid%(port_id))
+
+ conn.set(oid,(options["--action"]=="on" and device.turn_on or device.turn_off))
+
+
+def get_outlets_status(conn, options):
+ outletCount = 0
+ result = {}
+
+ if (device==None):
+ eaton_set_device(conn, options)
+
+ res_ports = conn.walk(device.outlet_table_oid, 30)
+
+ for x in res_ports:
+ outletCount += 1
+ status = x[1]
+ t = x[0].split('.')
+
+ # Plug indexing start from zero, so we substract '1' from the
+ # user's given plug number
+ if (device.ident_str == "Eaton Managed ePDU"):
+ port_num = str(int(((device.has_switches) and "%s:%s"%(t[len(t)-3], t[len(t)-1]) or "%s"%(t[len(t)-1]))) + 1)
+
+ # Plug indexing start from zero, so we add '1'
+ # for the user's exposed plug number
+ port_name = str(int(x[1].strip('"')) + 1)
+ port_status = ""
+ result[port_num] = (port_name, port_status)
+ else:
+ # Switched ePDU do not propose an outletCount OID!
+ # Invalid status (ie value == '0'), retrieved via the walk,
+ # means the outlet is absent
+ port_num = str(outletCount)
+ port_name = str(outletCount)
+ port_status = ""
+ if (status != '0'):
+ result[port_num] = (port_name, port_status)
+
+ return result
+
+# Main agent method
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "no_login", "no_password", \
+ "port", "snmp_version", "community" ]
+
+ atexit.register(atexit_handler)
+
+ snmp_define_defaults ()
+
+ all_opt["switch"]["default"] = 1
+ all_opt["power_wait"]["default"] = 2
+ all_opt["snmp_version"]["default"] = "1"
+ all_opt["community"]["default"] = "private"
+ options = check_input(device_opt, process_input(device_opt))
+
+ # Plug indexing start from zero on ePDU Managed, so we substract '1' from
+ # the user's given plug number.
+ # For Switched ePDU, we will add this back again later.
+ if ((options.has_key("--plug")) and (options["--plug"].isdigit())):
+ options["--plug"] = str(int(options["--plug"]) - 1)
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for Eaton over SNMP"
+ docs["longdesc"] = "fence_eaton_snmp is an I/O Fencing agent \
+which can be used with the Eaton network power switch. It logs \
+into a device via SNMP and reboots a specified outlet. It supports \
+SNMP v1 and v3 with all combinations of authenticity/privacy settings."
+ docs["vendorurl"] = "http://powerquality.eaton.com"
+ show_docs(options, docs)
+
+ # Operate the fencing device
+ result = fence_action(FencingSnmp(options), options, set_power_status, get_power_status, get_outlets_status)
+
+ sys.exit(result)
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/egenera/Makefile.am b/fence/agents/egenera/Makefile.am
new file mode 100644
index 0000000..c69f805
--- /dev/null
+++ b/fence/agents/egenera/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_egenera
+
+SRC = $(TARGET).pl
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fencemanperl.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/egenera/fence_egenera.pl b/fence/agents/egenera/fence_egenera.pl
new file mode 100644
index 0000000..2ea4d0c
--- /dev/null
+++ b/fence/agents/egenera/fence_egenera.pl
@@ -0,0 +1,501 @@
+#!/usr/bin/perl
+
+use Getopt::Std;
+use IPC::Open3;
+
+my $ME = $0;
+
+END {
+ defined fileno STDOUT or return;
+ close STDOUT and return;
+ warn "$ME: failed to close standard output: $!\n";
+ $? ||= 1;
+}
+
+# WARNING!! Do not add code bewteen "#BEGIN_VERSION_GENERATION" and
+# "#END_VERSION_GENERATION" It is generated by the Makefile
+
+#BEGIN_VERSION_GENERATION
+$RELEASE_VERSION="";
+$REDHAT_COPYRIGHT="";
+$BUILD_DATE="";
+#END_VERSION_GENERATION
+
+# Get the program name from $0 and strip directory names
+$_=$0;
+$|=1;
+s/.*\///;
+my $pname = $_;
+
+$esh="/opt/panmgr/bin/esh";
+
+sub usage
+{
+ print "Usage:\n";
+ print "\n";
+ print "$pname [options]\n";
+ print "\n";
+ print "Options:\n";
+ print " -c <string> cserver\n";
+ print " -h help\n";
+ print " -l <string> lpan\n";
+ print " -o <string> Action: reboot (default), off, on or status\n";
+ print " -p <string> pserver\n";
+ print " -u <string> username (default=root)\n";
+ print " -f <seconds> Wait X seconds before fencing is started\n";
+ print " -q quiet mode\n";
+ print " -V version\n";
+
+ exit 0;
+}
+
+sub fail
+{
+ ($msg)=@_;
+ print $msg."\n" unless defined $opt_q;
+ $t->close if defined $t;
+ exit 1;
+}
+
+sub fail_usage
+{
+ ($msg)=@_;
+ print STDERR $msg."\n" if $msg;
+ print STDERR "Please use '-h' for usage.\n";
+ exit 1;
+}
+
+
+sub version
+{
+ print "$pname $RELEASE_VERSION $BUILD_DATE\n";
+ print "$REDHAT_COPYRIGHT\n" if ( $REDHAT_COPYRIGHT );
+
+ exit 0;
+}
+
+sub print_metadata
+{
+print '<?xml version="1.0" ?>
+<resource-agent name="fence_egenera" shortdesc="I/O Fencing agent for the Egenera BladeFrame" >
+<longdesc>
+fence_egenera is an I/O Fencing agent which can be used with the Egenera BladeFrame. It logs into a control blade (cserver) via ssh and operates on a process ing blade (pserver) identified by the pserver name and the logical process area network (LPAN) that it is in. fence_egenera requires that ssh keys have been setup so that the fence_egenera does not require a password to authenticate. Refer to ssh(8) for more information on setting up ssh keys.
+</longdesc>
+<vendor-url>http://www.bull.com</vendor-url>
+<parameters>
+ <parameter name="action" unique="0" required="1">
+ <getopt mixed="-o [action]" />
+ <content type="string" default="reboot" />
+ <shortdesc lang="en">Fencing Action</shortdesc>
+ </parameter>
+ <parameter name="cserver" unique="0" required="1">
+ <getopt mixed="-c [cserver]" />
+ <content type="string" />
+ <shortdesc lang="en">The cserver to ssh to. cserver can be in the form user at hostname to specify a different user to login as.</shortdesc>
+ </parameter>
+ <parameter name="pserver" unique="0" required="1">
+ <getopt mixed="-p [pserver]" />
+ <content type="string" />
+ <shortdesc lang="en">The pserver to operate on.</shortdesc>
+ </parameter>
+ <parameter name="user" unique="0" required="1">
+ <getopt mixed="-u [name]" />
+ <content type="string" default="root" />
+ <shortdesc lang="en">Login Name</shortdesc>
+ </parameter>
+ <parameter name="lpan" unique="0" required="1">
+ <getopt mixed="-l [lpan]" />
+ <content type="string" />
+ <shortdesc lang="en">The lpan to operate on.</shortdesc>
+ </parameter>
+ <parameter name="delay" unique="0" required="0">
+ <getopt mixed="-f [seconds]" />
+ <content type="string" default="0"/>
+ <shortdesc lang="en">Wait X seconds before fencing is started</shortdesc>
+ </parameter>
+ <parameter name="help" unique="0" required="0">
+ <getopt mixed="-h" />
+ <content type="string" />
+ <shortdesc lang="en">Display help and exit</shortdesc>
+ </parameter>
+</parameters>
+<actions>
+ <action name="on" />
+ <action name="off" />
+ <action name="reboot" />
+ <action name="status" />
+ <action name="metadata" />
+</actions>
+</resource-agent>
+';
+}
+
+if (@ARGV > 0)
+{
+ getopts("c:hl:o:p:u:qVf:") || fail_usage ;
+
+ usage if defined $opt_h;
+ version if defined $opt_V;
+
+ fail_usage "Unkown parameter." if (@ARGV > 0);
+
+
+ $cserv = $opt_c if defined $opt_c;
+ $lpan = $opt_l if defined $opt_l;
+ $pserv = $opt_p if defined $opt_p;
+ $action = $opt_o if defined $opt_o;
+ $user = $opt_u if defined $opt_u;
+ $delay = $opt_f if defined $opt_f;
+}
+else
+{
+ get_options_stdin();
+}
+
+if (((defined $opt_o) && ($opt_o =~ /metadata/i)) || ((defined $action) && ($action =~ /metadata/i))) {
+ print_metadata();
+ exit 0;
+}
+
+$action = "reboot" unless defined $action;
+$user = "root" unless defined $user;
+
+fail "failed: no cserver defined" unless defined $cserv;
+fail "failed: no lpan defined" unless defined $lpan;
+fail "failed: no pserver defined" unless defined $pserv;
+
+fail "failed: unrecognised action: $action"
+ unless $action =~ /^(off|on|reboot|status|pblade)$/i;
+
+sub get_options_stdin
+{
+ my $opt;
+ my $line = 0;
+ while( defined($in = <>) )
+ {
+ $_ = $in;
+ chomp;
+
+ # strip leading and trailing whitespace
+ s/^\s*//;
+ s/\s*$//;
+
+ # skip comments
+ next if /^#/;
+
+ $line+=1;
+ $opt=$_;
+ next unless $opt;
+
+ ($name,$val)=split /\s*=\s*/, $opt;
+
+ if ( $name eq "" )
+ {
+ print STDERR "parse error: illegal name in option $line\n";
+ exit 2;
+ }
+
+ elsif ($name eq "agent" )
+ {
+ # DO NOTHING -- this field is used by fenced
+ }
+
+ elsif ($name eq "cserver" )
+ {
+ $cserv = $val;
+ }
+
+ elsif ($name eq "lpan" )
+ {
+ $lpan = $val;
+ }
+
+ elsif ($name eq "pserver" )
+ {
+ $pserv = $val;
+ }
+
+ elsif ($name eq "action" )
+ {
+ $action = $val;
+ }
+
+ elsif ($name eq "esh" )
+ {
+ $esh = $val;
+ }
+ elsif ($name eq "user" )
+ {
+ $user = $val;
+ }
+ elsif ($name eq "delay" )
+ {
+ $delay = $val;
+ }
+ }
+}
+
+# _pserver_query_field -- query the state of the pBlade or Status field
+# and return it's value in $_.
+# Return 0 on success, or non-zero on error
+sub _pserver_query_field
+{
+ my ($field,$junk) = @_;
+
+ if ($field ne "pBlade" && $field ne "Status")
+ {
+ $_="Error _pserver_query_field: unknown field of type '$field'";
+ return 1;
+ }
+
+ my $val;
+
+ my $cmd = "ssh -l $user $cserv $esh pserver $lpan/$pserv";
+ my $pid = open3 (\*WTR, \*RDR,\*RDR, $cmd)
+ or die "error open3(): $!";
+
+ while(<RDR>)
+ {
+ chomp;
+ my $line = $_;
+ my @fields = split /\s+/,$line;
+
+ if ($fields[0] eq "Error:")
+ {
+ $val=$line;
+ print "Debug ERROR: $val\n";
+ last;
+ }
+ elsif ($fields[0] eq $pserv)
+ {
+ if ( $field eq "Status" )
+ {
+ $val=$fields[1];
+ }
+ elsif ($field eq "pBlade" )
+ {
+ # grrr... Status can be "Shutting down"
+ if ($fields[1] ne "Shutting")
+ {
+ $val=$fields[3];
+ }
+ else
+ {
+ $val=$fields[4];
+ }
+ }
+ }
+ }
+
+ close WTR;
+ close RDR;
+
+ waitpid $pid,0;
+ my $rtrn = $?>>8;
+ $_=$val if defined $val;
+ return $rtrn;
+}
+
+# return the pBlade of an lpan/pserver in $_.
+# Return 0 on success or non=zero on error
+sub pserver_pblade
+{
+ _pserver_query_field "pBlade";
+}
+
+# return the Status of an lpan/pserver in $_.
+# Return 0 on success or non=zero on error
+sub pserver_status
+{
+ _pserver_query_field "Status";
+}
+
+# boot an lpan/pserver.
+# Return 0 if the status is "Booted" or "Booting" or non-zero on failure.
+# Continue checking the value until the status is "Boot" or "Booting" or
+# until a timeout of 120 seconds has been reached.
+sub pserver_boot
+{
+ my $rtrn=1;
+
+ # It seems it can take a while for a pBlade to
+ # boot sometimes. We shall wait for 120 seconds
+ # before giving up on a node returning failure
+ for (my $trys=0; $trys<120; $trys++)
+ {
+ last if (pserver_status != 0);
+
+ my $status = $_;
+ if ( $status eq "Booted" || $status eq "Booting")
+ {
+ $rtrn=0;
+ last;
+ }
+
+ if(pserver_pblade)
+ {
+ die "error getting pBlade info";
+ }
+
+ # Is there any harm in sending this command multiple times?
+ my $cmd = "ssh -l $user $cserv $esh pserver -b $lpan/$pserv";
+ my $pid = open3 (\*WTR, \*RDR,\*RDR, $cmd)
+ or die "error open3(): $!";
+
+ close WTR;
+ close RDR;
+
+ waitpid $pid,0;
+ $rtrn = $?>>8;
+
+ sleep 1;
+ }
+ return $rtrn;
+}
+
+# boot an lpan/pserver.
+# Return 0 if the status is "Shutdown" or non-zero on failure.
+# Continue checking the value until the status is "Shutdown" or
+# until a timeout of 20 seconds has been reached.
+sub pserver_shutdown
+{
+ my $rtrn=1;
+ local *egen_log;
+ open(egen_log,">>/@LOGDIR@/fence_egenera.log");
+ print egen_log "Attempting shutdown at ".`date`."\n";
+ for (my $trys=0; $trys<20; $trys++)
+ {
+ last if (pserver_status != 0);
+
+
+ my $status = $_;
+ print egen_log "shutdown: $trys $status\n";
+ if (/^Shutdown/)
+ {
+ $rtrn=0;
+ last;
+ }
+ elsif (/^Shutting/)
+ {
+ # We are already in the process of shutting down.
+ # do I need to do anything here?
+ # We'll just wait for now
+ }
+ elsif (/^Booting/)
+ {
+ # Server is already on the way back up. Do nothing
+ $rtrn=0;
+ last;
+ }
+ elsif (/^Booted\(KDB\)/ || /^Debugging/ )
+ {
+ print egen_log "shutdown: crash dump being performed. Waiting\n";
+ $rtrn=0;
+ last;
+ }
+ else
+ {
+ if (pserver_pblade)
+ {
+ die "error getting pBlade info: $_";
+ }
+
+ # is there any harm in sending this command multiple
+ # times?
+ my $cmd = "ssh -l $user $cserv $esh blade -s $_";
+ print egen_log "shutdown: $cmd being called, before open3\n";
+ my $pid = open3 (\*WTR, \*RDR,\*RDR, $cmd)
+ or die "error open3(): $!";
+ print egen_log "shutdown: after calling open3\n";
+ @outlines = <RDR>;
+ print egen_log "shutdown: Open3 result: ", @outlines, "\n";
+
+ close WTR;
+ close RDR;
+
+ waitpid $pid,0;
+ $rtrn = $?>>8;
+ }
+
+ sleep 1;
+ }
+ print egen_log "shutdown: Returning from pserver_shutdown with return code $rtrn\n";
+ return $rtrn;
+}
+
+
+$_=$action;
+if (/^status$/i)
+{
+ if (pserver_status==0)
+ {
+ print "$lpan/$pserv is $_\n" unless defined $opt_q;
+ exit 0;
+ }
+ else
+ {
+ fail "failed to get status of $lpan/$pserv: $_";
+ }
+}
+elsif (/^pblade$/i)
+{
+ if (pserver_pblade==0)
+ {
+ print "$lpan/$pserv is $_\n" unless defined $opt_q;
+ exit 0;
+ }
+ else
+ {
+ fail "failed to get pblade of $lpan/$pserv: $_";
+ }
+}
+elsif (/^off$/i)
+{
+ sleep ($delay) if defined($delay);
+ if (pserver_shutdown==0)
+ {
+ print "success: $lpan/$pserv has been shutdown\n"
+ unless defined $opt_q;
+ exit 0;
+ }
+ else
+ {
+ fail "failed to shutdown $lpan/$pserv";
+ }
+}
+elsif (/^on$/i)
+{
+ if (pserver_boot==0)
+ {
+ print "success: $lpan/$pserv has been turned on\n"
+ unless defined $opt_q;
+ exit 0;
+ }
+ else
+ {
+ fail "failed to turn on $lpan/$pserv";
+ }
+}
+elsif (/^reboot$/i)
+{
+ sleep ($delay) if defined($delay);
+ if (pserver_shutdown!=0)
+ {
+ fail "failed to shutdown $lpan/$pserv";
+ }
+
+ if (pserver_boot==0)
+ {
+ print "success: $lpan/$pserv has been rebooted\n"
+ unless defined $opt_q;
+ exit 0;
+ }
+ else
+ {
+ fail "failed to turn on $lpan/$pserv";
+ }
+}
+else
+{
+ die "unknown action: $action";
+}
diff --git a/fence/agents/eps/Makefile.am b/fence/agents/eps/Makefile.am
new file mode 100644
index 0000000..59fdd07
--- /dev/null
+++ b/fence/agents/eps/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_eps
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/eps/fence_eps.py b/fence/agents/eps/fence_eps.py
new file mode 100644
index 0000000..0e7709d
--- /dev/null
+++ b/fence/agents/eps/fence_eps.py
@@ -0,0 +1,129 @@
+#!/usr/bin/python
+
+# The Following Agent Has Been Tested On:
+# ePowerSwitch 8M+ version 1.0.0.4
+
+import sys, re
+import httplib, base64, string, socket
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="ePowerSwitch 8M+ (eps)"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+# Log actions and results from EPS device
+def eps_log(options, str):
+ if options["log"] >= LOG_MODE_VERBOSE:
+ options["debug_fh"].write(str)
+
+# Run command on EPS device.
+# @param options Device options
+# @param params HTTP GET parameters (without ?)
+def eps_run_command(options, params):
+ try:
+ # New http connection
+ conn = httplib.HTTPConnection(options["--ip"])
+
+ request_str = "/"+options["--page"]
+
+ if (params!=""):
+ request_str += "?"+params
+
+ eps_log(options, "GET "+request_str+"\n")
+ conn.putrequest('GET', request_str)
+
+ if (options.has_key("--username")):
+ if (not options.has_key("--password")):
+ options["--password"] = "" # Default is empty password
+
+ # String for Authorization header
+ auth_str = 'Basic ' + string.strip(base64.encodestring(options["--username"]+':'+options["--password"]))
+ eps_log(options, "Authorization:"+auth_str+"\n")
+ conn.putheader('Authorization', auth_str)
+
+ conn.endheaders()
+
+ response = conn.getresponse()
+
+ eps_log(options, "%d %s\n"%(response.status, response.reason))
+
+ #Response != OK -> couldn't login
+ if (response.status!=200):
+ fail(EC_LOGIN_DENIED)
+
+ result = response.read()
+ eps_log(options, result+"\n")
+ conn.close()
+
+ except socket.timeout:
+ fail(EC_TIMED_OUT)
+ except socket.error:
+ fail(EC_LOGIN_DENIED)
+
+ return result
+
+def get_power_status(conn, options):
+ ret_val = eps_run_command(options,"")
+
+ result = {}
+ status = re.findall("p(\d{2})=(0|1)\s*\<br\>", ret_val.lower())
+ for out_num, out_stat in status:
+ result[out_num] = ("",(out_stat=="1" and "on" or "off"))
+
+ if (not (options["--action"] in ['monitor','list'])):
+ if (not (options["--plug"] in result)):
+ fail_usage("Failed: You have to enter existing physical plug!")
+ else:
+ return result[options["--plug"]][1]
+ else:
+ return result
+
+def set_power_status(conn, options):
+ ret_val = eps_run_command(options, "P%s=%s"%(options["--plug"], (options["--action"]=="on" and "1" or "0")))
+
+# Define new option
+def eps_define_new_opts():
+ all_opt["hidden_page"] = {
+ "getopt" : "c:",
+ "longopt" : "page",
+ "help":"-c, --page=[page] Name of hidden page (default hidden.htm)",
+ "required" : "0",
+ "shortdesc" : "Name of hidden page",
+ "default" : "hidden.htm",
+ "order": 1
+ }
+
+# Starting point of fence agent
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "no_login", "no_password", \
+ "port", "hidden_page" ]
+
+ atexit.register(atexit_handler)
+
+ eps_define_new_opts()
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for ePowerSwitch"
+ docs["longdesc"] = "fence_eps is an I/O Fencing agent \
+which can be used with the ePowerSwitch 8M+ power switch to fence \
+connected machines. Fence agent works ONLY on 8M+ device, because \
+this is only one, which has support for hidden page feature. \
+\n.TP\n\
+Agent basically works by connecting to hidden page and pass \
+appropriate arguments to GET request. This means, that hidden \
+page feature must be enabled and properly configured."
+ docs["vendorurl"] = "http://www.epowerswitch.com"
+ show_docs(options, docs)
+
+ #Run fence action. Conn is None, beacause we always need open new http connection
+ result = fence_action(None, options, set_power_status, get_power_status, get_power_status)
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/hds_cb/Makefile.am b/fence/agents/hds_cb/Makefile.am
new file mode 100644
index 0000000..0763d5a
--- /dev/null
+++ b/fence/agents/hds_cb/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_hds_cb
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/hds_cb/fence_hds_cb.py b/fence/agents/hds_cb/fence_hds_cb.py
new file mode 100755
index 0000000..0e15af3
--- /dev/null
+++ b/fence/agents/hds_cb/fence_hds_cb.py
@@ -0,0 +1,146 @@
+#!/usr/bin/python
+
+#####
+##
+## The Following Agent Has Been Tested On:
+##
+## Model Modle/Firmware
+## +--------------------+---------------------------+
+## (1) Main application CB2000/A0300-E-6617
+##
+#####
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="New Compute Blade 2000 Agent - test release on steroids"
+REDHAT_COPYRIGHT=""
+BUILD_DATE="November, 2012"
+#END_VERSION_GENERATION
+
+RE_STATUS_LINE = "^([0-9]+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(\S+).*$"
+
+def get_power_status(conn, options):
+ #### Maybe should put a conn.log_expect here to make sure
+ #### we have properly entered into the main menu
+ conn.sendline("S") # Enter System Command Mode
+ conn.log_expect(options, "SVP>", int(options["--shell-timeout"]))
+ conn.sendline("PC") # Enter partition control
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ result = {}
+ # Status can now be obtained from the output of the PC
+ # command. Line looks like the following:
+ # "P Power Condition LID lamp Mode Auto power on"
+ # "0 On Normal Off Basic Synchronized"
+ # "1 On Normal Off Basic Synchronized"
+ for line in conn.before.splitlines():
+ # populate the relevant fields based on regex
+ partition = re.search(RE_STATUS_LINE, line)
+ if( partition != None):
+ # find the blade number defined in args
+ if( partition.group(1) == options["--plug"] ):
+ result = partition.group(2).lower()
+ # We must make sure we go back to the main menu as the
+ # status is checked before any fencing operations are
+ # executed. We could in theory save some time by staying in
+ # the partition control, but the logic is a little cleaner
+ # this way.
+ conn.sendline("Q") # Back to system command mode
+ conn.log_expect(options, "SVP>", int(options["--shell-timeout"]))
+ conn.sendline("EX") # Back to system console main menu
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ return result
+
+def set_power_status(conn, options):
+ action = {
+ 'on' : "P",
+ 'off': "F",
+ 'reboot' : "H",
+ }[options["--action"]]
+
+
+ conn.sendline("S") # Enter System Command Mode
+ conn.log_expect(options, "SVP>", int(options["--shell-timeout"]))
+ conn.sendline("PC") # Enter partition control
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ conn.sendline("P") # Enter power control menu
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ conn.sendline(action) # Execute action from array above
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ conn.sendline(options["--plug"]) # Select blade number from args
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ conn.sendline("Y") # Confirm action
+ conn.log_expect(options, "Hit enter key.", int(options["--shell-timeout"]))
+ conn.sendline("") # Press the any key
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ conn.sendline("Q") # Quit back to partition control
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ conn.sendline("Q") # Quit back to system command mode
+ conn.log_expect(options, "SVP>", int(options["--shell-timeout"]))
+ conn.sendline("EX") # Quit back to system console menu
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+def get_blades_list(conn, options):
+ outlets = { }
+
+ conn.sendline("S") # Enter System Command Mode
+ conn.log_expect(options, "SVP>", int(options["--shell-timeout"]))
+ conn.sendline("PC") # Enter partition control
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ # Status can now be obtained from the output of the PC
+ # command. Line looks like the following:
+ # "P Power Condition LID lamp Mode Auto power on"
+ # "0 On Normal Off Basic Synchronized"
+ # "1 On Normal Off Basic Synchronized"
+ for line in conn.before.splitlines():
+ partition = re.search(RE_STATUS_LINE, line)
+ if( partition != None):
+ outlets[partition.group(1)] = (partition.group(2), "")
+ conn.sendline("Q") # Quit back to system command mode
+ conn.log_expect(options, "SVP>", int(options["--shell-timeout"]))
+ conn.sendline("EX") # Quit back to system console menu
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ return outlets
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "cmd_prompt", "secure", \
+ "port", "missing_as_off" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["power_wait"]["default"] = "5"
+ all_opt["cmd_prompt"]["default"] = [ "\) :" ]
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for Hitachi Compute Blade systems"
+ docs["longdesc"] = "fence_hds_cb is an I/O Fencing agent \
+which can be used with Hitachi Compute Blades with recent enough firmware that \
+includes telnet support."
+ docs["vendorurl"] = "http://www.hds.com"
+ show_docs(options, docs)
+
+ ##
+ ## Operate the fencing device
+ ######
+ conn = fence_login(options)
+ result = fence_action(conn, options, set_power_status, get_power_status, get_blades_list)
+
+ ##
+ ## Logout from system
+ ######
+ try:
+ conn.sendline("X")
+ conn.close()
+ except:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/hpblade/Makefile.am b/fence/agents/hpblade/Makefile.am
new file mode 100644
index 0000000..e8ae6ff
--- /dev/null
+++ b/fence/agents/hpblade/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_hpblade
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/hpblade/fence_hpblade.py b/fence/agents/hpblade/fence_hpblade.py
new file mode 100644
index 0000000..42f5309
--- /dev/null
+++ b/fence/agents/hpblade/fence_hpblade.py
@@ -0,0 +1,95 @@
+#!/usr/bin/python
+
+#####
+##
+## The Following Agent Has Been Tested On:
+## * BladeSystem c7000 Enclosure
+#####
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="New Bladecenter Agent - test release on steroids"
+REDHAT_COPYRIGHT=""
+BUILD_DATE="March, 2008"
+#END_VERSION_GENERATION
+
+def get_power_status(conn, options):
+ conn.send_eol("show server status " + options["--plug"])
+ conn.log_expect(options, options["--command-prompt"] , int(options["--shell-timeout"]))
+
+ power_re = re.compile("^\s*Power: (.*?)\s*$")
+ status = "unknown"
+ for line in conn.before.splitlines():
+ res = power_re.search(line)
+ if res != None:
+ status = res.group(1)
+
+ if status == "unknown":
+ if options.has_key("--missing-as-off"):
+ return "off"
+ else:
+ fail(EC_STATUS)
+
+ return status.lower().strip()
+
+def set_power_status(conn, options):
+ if options["--action"] == "on":
+ conn.send_eol("poweron server " + options["--plug"])
+ elif options["--action"] == "off":
+ conn.send_eol("poweroff server " + options["--plug"] + " force")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+def get_blades_list(conn, options):
+ outlets = { }
+
+ conn.send_eol("show server list" )
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ list_re = re.compile("^\s*(.*?)\s+(.*?)\s+(.*?)\s+OK\s+(.*?)\s+(.*?)\s*$")
+ for line in conn.before.splitlines():
+ res = list_re.search(line)
+ if res != None:
+ outlets[res.group(1)] = (res.group(2), res.group(4).lower())
+
+ return outlets
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "cmd_prompt", "secure", "port", "missing_as_off" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["cmd_prompt"]["default"] = [ "c7000oa>" ]
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for HP BladeSystem"
+ docs["longdesc"] = "fence_hpblade is an I/O Fencing agent \
+which can be used with HP BladeSystem. It logs into an enclosure via telnet or ssh \
+and uses the command line interface to power on and off blades."
+ docs["vendorurl"] = "http://www.hp.com"
+ show_docs(options, docs)
+
+ ##
+ ## Operate the fencing device
+ ######
+ options["eol"] = "\n"
+ conn = fence_login(options)
+ result = fence_action(conn, options, set_power_status, get_power_status, get_blades_list)
+
+ ##
+ ## Logout from system
+ ######
+ try:
+ conn.send_eol("exit")
+ conn.close()
+ except:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/ibmblade/Makefile.am b/fence/agents/ibmblade/Makefile.am
new file mode 100644
index 0000000..f1c94de
--- /dev/null
+++ b/fence/agents/ibmblade/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_ibmblade
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/ibmblade/fence_ibmblade.py b/fence/agents/ibmblade/fence_ibmblade.py
new file mode 100644
index 0000000..1787ae2
--- /dev/null
+++ b/fence/agents/ibmblade/fence_ibmblade.py
@@ -0,0 +1,77 @@
+#!/usr/bin/python
+
+import sys
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+from fencing_snmp import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="IBM Blade SNMP fence agent"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+### CONSTANTS ###
+# From fence_ibmblade.pl
+STATUSES_OID = ".1.3.6.1.4.1.2.3.51.2.22.1.5.1.1.4" # remoteControlBladePowerState
+CONTROL_OID = ".1.3.6.1.4.1.2.3.51.2.22.1.6.1.1.7" # powerOnOffBlade
+
+# Status constants returned as value from SNMP
+STATUS_DOWN = 0
+STATUS_UP = 1
+
+# Status constants to set as value to SNMP
+STATUS_SET_OFF = 0
+STATUS_SET_ON = 1
+
+### FUNCTIONS ###
+
+def get_power_status(conn, options):
+ (_, status) = conn.get("%s.%s"% (STATUSES_OID, options["--plug"]))
+ return (status == str(STATUS_UP) and "on" or "off")
+
+def set_power_status(conn, options):
+ conn.set("%s.%s"%(CONTROL_OID, options["--plug"]), (options["--action"]=="on" and STATUS_SET_ON or STATUS_SET_OFF))
+
+def get_outlets_status(conn, _):
+ result = {}
+
+ res_blades = conn.walk(STATUSES_OID, 30)
+
+ for blade_info in res_blades:
+ port_num = blade_info[0].split('.')[-1]
+
+ port_alias = ""
+ port_status = (blade_info[1]==str(STATUS_UP) and "on" or "off")
+
+ result[port_num] = (port_alias, port_status)
+
+ return result
+
+# Main agent method
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "no_login", "no_password", \
+ "port", "snmp_version", "community" ]
+
+ atexit.register(atexit_handler)
+
+ snmp_define_defaults()
+ all_opt["snmp_version"]["default"] = "1"
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for IBM BladeCenter over SNMP"
+ docs["longdesc"] = "fence_ibmblade is an I/O Fencing agent \
+which can be used with IBM BladeCenter chassis. It issues SNMP Set \
+request to BladeCenter chassis, rebooting, powering up or down \
+the specified Blade Server."
+ docs["vendorurl"] = "http://www.ibm.com"
+ show_docs(options, docs)
+
+ # Operate the fencing device
+ result = fence_action(FencingSnmp(options), options, set_power_status, get_power_status, get_outlets_status)
+
+ sys.exit(result)
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/ifmib/Makefile.am b/fence/agents/ifmib/Makefile.am
new file mode 100644
index 0000000..a07f264
--- /dev/null
+++ b/fence/agents/ifmib/Makefile.am
@@ -0,0 +1,18 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_ifmib
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC) \
+ README
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/ifmib/README b/fence/agents/ifmib/README
new file mode 100644
index 0000000..cd2a3c1
--- /dev/null
+++ b/fence/agents/ifmib/README
@@ -0,0 +1,45 @@
+Intro:
+------
+This is an SNMP-based fencing agent for RHCS. It was designed with the use-case
+of disabling ethernet ports on an iSCSI SAN, but could be used to disable any
+port on any SNMP v1/2c/3 device that implementes the IF-MIB.
+
+The script requires NetSNMP to be installed and working on all nodes
+in the cluster. There are no requirements for any MIBs to be setup --- all of
+the required OIDs are hard-coded into the script. Since the IF-MIB is an IETF
+standard, these identifiers are very widely supported and will not change.
+
+
+Typical usage:
+--------------
+To use this agen with the switch used on the iSCSI network, you'll require:
+ 1) A managed switch running SNMP.
+ 2) An SNMP community with write privileges.
+ 3) Permission to send SNMP through any ACLs or firewalls from the nodes.
+ 4) The ifIndex or ifPort associated with the ports being used by the cluster nodes.
+
+Consider a three-node cluster composed of A, B, and C. Each node has two
+network interfaces - one used for network and cluster communication, the second
+used for iSCSI traffic. If A needs to be fenced, B and C will run this script
+to administratively disable the switchport for A's connection to the iSCSI
+storage.
+
+If you are using a single interface for cluster and iSCSI traffic, this will
+still work, but you will lose network connectivity to the fenced host.
+
+
+cluster.conf:
+-------------
+There is no GUI support for this fence agent at this time. To use it, you will
+need something like this cluster.conf
+
+<fencedevice agent="fence_ifmib" name="myswitch" comm="fencing" ipaddr="sw1"/>
+
+In a node's fencing methods, you'll include a line like this:
+
+<device name="myswitch" port="43" option="off"/>
+
+This node will be fenced by disabling the port with ifIndex 43 on the host sw1.
+In SNMP speak, we set IF-MIB::ifAdminStatus.43 = down(2).
+
+If you will use port name (like fc1/1), script will try to find ifIndex.
diff --git a/fence/agents/ifmib/fence_ifmib.py b/fence/agents/ifmib/fence_ifmib.py
new file mode 100644
index 0000000..2184a85
--- /dev/null
+++ b/fence/agents/ifmib/fence_ifmib.py
@@ -0,0 +1,126 @@
+#!/usr/bin/python
+
+# The Following agent has been tested on:
+# - Cisco MDS UROS 9134 FC (1 Slot) Chassis ("1/2/4 10 Gbps FC/Supervisor-2") Motorola, e500v2
+# with BIOS 1.0.16, kickstart 4.1(1c), system 4.1(1c)
+# - Cisco MDS 9124 (1 Slot) Chassis ("1/2/4 Gbps FC/Supervisor-2") Motorola, e500
+# with BIOS 1.0.16, kickstart 4.1(1c), system 4.1(1c)
+# - Partially with APC PDU (Network Management Card AOS v2.7.0, Rack PDU APP v2.7.3)
+# Only lance if is visible
+
+import sys
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+from fencing_snmp import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="IF:MIB SNMP fence agent"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+### CONSTANTS ###
+# IF-MIB trees for alias, status and port
+ALIASES_OID = ".1.3.6.1.2.1.31.1.1.1.18"
+PORTS_OID = ".1.3.6.1.2.1.2.2.1.2"
+STATUSES_OID = ".1.3.6.1.2.1.2.2.1.7"
+
+# Status constants returned as value from SNMP
+STATUS_UP = 1
+STATUS_DOWN = 2
+STATUS_TESTING = 3
+
+### GLOBAL VARIABLES ###
+# Port number converted from port name or index
+port_num = None
+
+### FUNCTIONS ###
+
+# Convert port index or name to port index
+def port2index(conn, port):
+ res = None
+
+ if (port.isdigit()):
+ res = int(port)
+ else:
+ ports = conn.walk(PORTS_OID, 30)
+
+ for x in ports:
+ if (x[1].strip('"')==port):
+ res = int(x[0].split('.')[-1])
+ break
+
+ if (res==None):
+ fail_usage("Can't find port with name %s!"%(port))
+
+ return res
+
+def get_power_status(conn, options):
+ global port_num
+
+ if (port_num==None):
+ port_num = port2index(conn, options["--plug"])
+
+ (oid, status) = conn.get("%s.%d"%(STATUSES_OID, port_num))
+ return (status==str(STATUS_UP) and "on" or "off")
+
+def set_power_status(conn, options):
+ global port_num
+
+ if (port_num==None):
+ port_num = port2index(conn, options["--plug"])
+
+ conn.set("%s.%d"%(STATUSES_OID, port_num), (options["--action"]=="on" and STATUS_UP or STATUS_DOWN))
+
+# Convert array of format [[key1, value1], [key2, value2], ... [keyN, valueN]] to dict, where key is
+# in format a.b.c.d...z and returned dict has key only z
+def array_to_dict(ar):
+ return dict(map(lambda y:[y[0].split('.')[-1], y[1]], ar))
+
+def get_outlets_status(conn, options):
+ result = {}
+
+ res_fc = conn.walk(PORTS_OID, 30)
+ res_aliases = array_to_dict(conn.walk(ALIASES_OID, 30))
+
+ for x in res_fc:
+ port_num = x[0].split('.')[-1]
+
+ port_name = x[1].strip('"')
+ port_alias = (res_aliases.has_key(port_num) and res_aliases[port_num].strip('"') or "")
+ port_status = ""
+ result[port_name] = (port_alias, port_status)
+
+ return result
+
+# Main agent method
+def main():
+ device_opt = [ "fabric_fencing", "ipaddr", "login", "passwd", "no_login", "no_password", \
+ "port", "snmp_version", "community" ]
+
+ atexit.register(atexit_handler)
+
+ snmp_define_defaults ()
+ all_opt["snmp_version"]["default"] = "2c"
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for IF MIB"
+ docs["longdesc"] = "fence_ifmib is an I/O Fencing agent \
+which can be used with any SNMP IF-MIB capable device. \
+\n.P\n\
+It was written with managed ethernet switches in mind, in order to \
+fence iSCSI SAN connections. However, there are many devices that \
+support the IF-MIB interface. The agent uses IF-MIB::ifAdminStatus \
+to control the state of an interface."
+ docs["vendorurl"] = "http://www.ietf.org/wg/concluded/ifmib.html"
+ show_docs(options, docs)
+
+ # Operate the fencing device
+ result = fence_action(FencingSnmp(options), options, set_power_status, get_power_status, get_outlets_status)
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/ilo/Makefile.am b/fence/agents/ilo/Makefile.am
new file mode 100644
index 0000000..8df9a39
--- /dev/null
+++ b/fence/agents/ilo/Makefile.am
@@ -0,0 +1,23 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_ilo
+
+SYMTARGET = fence_ilo2
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET) $(SYMTARGET)
+
+man_MANS = $(TARGET).8 $(SYMTARGET).8
+
+$(SYMTARGET): $(TARGET)
+ cp $^ $@
+
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET) $(SYMTARGET)
diff --git a/fence/agents/ilo/fence_ilo.py b/fence/agents/ilo/fence_ilo.py
new file mode 100644
index 0000000..ab6e342
--- /dev/null
+++ b/fence/agents/ilo/fence_ilo.py
@@ -0,0 +1,128 @@
+#!/usr/bin/python
+
+#####
+##
+## The Following Agent Has Been Tested On:
+##
+## iLO Version
+## +---------------------------------------------+
+## iLO / firmware 1.91 / RIBCL 2.22
+## iLO2 / firmware 1.22 / RIBCL 2.22
+## iLO2 / firmware 1.50 / RIBCL 2.22
+#####
+
+import sys, re, pexpect
+from xml.sax.saxutils import quoteattr
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="New ILO Agent - test release on steroids"
+REDHAT_COPYRIGHT=""
+BUILD_DATE="March, 2008"
+#END_VERSION_GENERATION
+
+def get_power_status(conn, options):
+ conn.send("<LOGIN USER_LOGIN = " + quoteattr(options["--username"]) + \
+ " PASSWORD = " + quoteattr(options["--password"]) + ">\r\n")
+ conn.send("<SERVER_INFO MODE = \"read\"><GET_HOST_POWER_STATUS/>\r\n")
+ conn.send("</SERVER_INFO></LOGIN>\r\n")
+ conn.log_expect(options, "HOST_POWER=\"(.*?)\"", int(options["--power-timeout"]))
+
+ status = conn.match.group(1)
+ return status.lower().strip()
+
+def set_power_status(conn, options):
+ conn.send("<LOGIN USER_LOGIN = " + quoteattr(options["--username"]) + \
+ " PASSWORD = " + quoteattr(options["--password"]) + ">\r\n")
+ conn.send("<SERVER_INFO MODE = \"write\">")
+
+ if options.has_key("fw_processor") and options["fw_processor"] == "iLO2":
+ if options["fw_version"] > 1.29:
+ conn.send("<HOLD_PWR_BTN TOGGLE=\"yes\" />\r\n")
+ else:
+ conn.send("<HOLD_PWR_BTN />\r\n")
+ elif options["--ribcl-version"] < 2.21:
+ conn.send("<SET_HOST_POWER HOST_POWER = \"" + options["--action"] + "\" />\r\n")
+ else:
+ if options["--action"] == "off":
+ conn.send("<HOLD_PWR_BTN/>\r\n")
+ else:
+ conn.send("<PRESS_PWR_BTN/>\r\n")
+ conn.send("</SERVER_INFO></LOGIN>\r\n")
+
+ return
+
+def define_new_opts():
+ all_opt["ribcl"] = {
+ "getopt" : "r:",
+ "longopt" : "ribcl-version",
+ "help" : "-r, --ribcl-version=[version] Force ribcl version to use",
+ "required" : "0",
+ "shortdesc" : "Force ribcl version to use",
+ "order" : 1 }
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "ssl", "ribcl" ]
+
+ atexit.register(atexit_handler)
+
+ define_new_opts()
+
+ all_opt["login_timeout"]["default"] = "10"
+ all_opt["retry_on"]["default"] = "3"
+ all_opt["ssl"]["default"] = "1"
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for HP iLO"
+ docs["longdesc"] = "fence_ilo is an I/O Fencing agent \
+used for HP servers with the Integrated Light Out (iLO) PCI card.\
+The agent opens an SSL connection to the iLO card. Once the SSL \
+connection is established, the agent is able to communicate with \
+the iLO card through an XML stream."
+ docs["vendorurl"] = "http://www.hp.com"
+ docs["symlink"] = [("fence_ilo2", "Fence agent for HP iLO2")]
+ show_docs(options, docs)
+
+ ##
+ ## Login and get version number
+ ####
+ conn = fence_login(options)
+ try:
+ conn.send("<?xml version=\"1.0\"?>\r\n")
+ conn.log_expect(options, [ "</RIBCL>", "<END_RIBCL/>" ], int(options["--login-timeout"]))
+ version = re.compile("<RIBCL VERSION=\"(.*?)\"", re.IGNORECASE).search(conn.before).group(1)
+ if options.has_key("--ribcl-version") == 0:
+ options["--ribcl-version"] = float(version)
+
+ if options["--ribcl-version"] >= 2:
+ conn.send("<RIBCL VERSION=\"2.0\">\r\n")
+ else:
+ conn.send("<RIBCL VERSION=\"1.2\">\r\n")
+
+ conn.send("<LOGIN USER_LOGIN = " + quoteattr(options["--username"]) + \
+ " PASSWORD = " + quoteattr(options["--password"]) + ">\r\n")
+ if options["--ribcl-version"] >= 2:
+ conn.send("<RIB_INFO MODE=\"read\"><GET_FW_VERSION />\r\n")
+ conn.send("</RIB_INFO>\r\n")
+ conn.log_expect(options, "<GET_FW_VERSION\s*\n", int(options["--shell-timeout"]))
+ conn.log_expect(options, "/>", int(options["--shell-timeout"]))
+ options["fw_version"] = float(re.compile("FIRMWARE_VERSION\s*=\s*\"(.*?)\"", re.IGNORECASE).search(conn.before).group(1))
+ options["fw_processor"] = re.compile("MANAGEMENT_PROCESSOR\s*=\s*\"(.*?)\"", re.IGNORECASE).search(conn.before).group(1)
+ conn.send("</LOGIN>\r\n")
+ except pexpect.TIMEOUT:
+ fail(EC_LOGIN_DENIED)
+ except pexpect.EOF:
+ fail(EC_LOGIN_DENIED)
+
+ ##
+ ## Fence operations
+ ####
+ result = fence_action(conn, options, set_power_status, get_power_status, None)
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/ilo_mp/Makefile.am b/fence/agents/ilo_mp/Makefile.am
new file mode 100644
index 0000000..4e8b18e
--- /dev/null
+++ b/fence/agents/ilo_mp/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_ilo_mp
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/ilo_mp/fence_ilo_mp.py b/fence/agents/ilo_mp/fence_ilo_mp.py
new file mode 100644
index 0000000..b1202bb
--- /dev/null
+++ b/fence/agents/ilo_mp/fence_ilo_mp.py
@@ -0,0 +1,68 @@
+#!/usr/bin/python
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION=""
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+def get_power_status(conn, options):
+ conn.send_eol("show /system1")
+
+ re_state = re.compile('EnabledState=(.*)', re.IGNORECASE)
+ conn.log_expect(options, re_state, int(options["--shell-timeout"]))
+
+ status = conn.match.group(1).lower()
+
+ if status.startswith("enabled"):
+ return "on"
+ else:
+ return "off"
+
+def set_power_status(conn, options):
+ if options["--action"] == "on":
+ conn.send_eol("start /system1")
+ else:
+ conn.send_eol("stop -f /system1")
+
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+
+ return
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "secure", "cmd_prompt" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["cmd_prompt"]["default"] = [ "MP>", "hpiLO->" ]
+ all_opt["power_wait"]["default"] = 5
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for HP iLO MP"
+ docs["longdesc"] = ""
+ docs["vendorurl"] = "http://www.hp.com"
+ show_docs(options, docs)
+
+ conn = fence_login(options)
+ conn.send_eol("SMCLP")
+
+ ##
+ ## Fence operations
+ ####
+ result = fence_action(conn, options, set_power_status, get_power_status)
+
+ try:
+ conn.send_eol("exit")
+ except:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/intelmodular/Makefile.am b/fence/agents/intelmodular/Makefile.am
new file mode 100644
index 0000000..f1e4690
--- /dev/null
+++ b/fence/agents/intelmodular/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_intelmodular
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/intelmodular/fence_intelmodular.py b/fence/agents/intelmodular/fence_intelmodular.py
new file mode 100644
index 0000000..192d2e3
--- /dev/null
+++ b/fence/agents/intelmodular/fence_intelmodular.py
@@ -0,0 +1,92 @@
+#!/usr/bin/python
+
+# Tested with an Intel MFSYS25 using firmware package 2.6 Should work with an
+# MFSYS35 as well.
+#
+# Notes:
+#
+# The manual and firmware release notes says SNMP is read only. This is not
+# true, as per the MIBs that ship with the firmware you can write to
+# the bladePowerLed oid to control the servers.
+#
+# Thanks Matthew Kent for original agent and testing.
+
+import sys
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+from fencing_snmp import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="Intel Modular SNMP fence agent"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+### CONSTANTS ###
+# From INTELCORPORATION-MULTI-FLEX-SERVER-BLADES-MIB.my that ships with
+# firmware updates
+STATUSES_OID = ".1.3.6.1.4.1.343.2.19.1.2.10.202.1.1.6"
+
+# Status constants returned as value from SNMP
+STATUS_UP = 2
+STATUS_DOWN = 0
+
+# Status constants to set as value to SNMP
+STATUS_SET_ON = 2
+STATUS_SET_OFF = 3
+
+### FUNCTIONS ###
+
+def get_power_status(conn, options):
+ (oid, status) = conn.get("%s.%s"% (STATUSES_OID, options["--plug"]))
+ return (status==str(STATUS_UP) and "on" or "off")
+
+def set_power_status(conn, options):
+ conn.set("%s.%s"%(STATUSES_OID, options["--plug"]), (options["--action"]=="on" and STATUS_SET_ON or STATUS_SET_OFF))
+
+def get_outlets_status(conn, options):
+ result = {}
+
+ res_blades = conn.walk(STATUSES_OID, 30)
+
+ for x in res_blades:
+ port_num = x[0].split('.')[-1]
+
+ port_alias = ""
+ port_status = (x[1]==str(STATUS_UP) and "on" or "off")
+
+ result[port_num] = (port_alias, port_status)
+
+ return result
+
+# Main agent method
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "no_login", "no_password",
+ "port", "snmp_version", "community" ]
+
+ atexit.register(atexit_handler)
+
+ snmp_define_defaults ()
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for Intel Modular"
+ docs["longdesc"] = "fence_intelmodular is an I/O Fencing agent \
+which can be used with Intel Modular device (tested on Intel MFSYS25, should \
+work with MFSYS35 as well). \
+\n.P\n\
+Note: Since firmware update version 2.7, SNMP v2 write support is \
+removed, and replaced by SNMP v3 support. So agent now has default \
+SNMP version 3. If you are using older firmware, please supply -d \
+for command line and snmp_version option for your cluster.conf."
+ docs["vendorurl"] = "http://www.intel.com"
+ show_docs(options, docs)
+
+ # Operate the fencing device
+ result = fence_action(FencingSnmp(options), options, set_power_status, get_power_status, get_outlets_status)
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/ipdu/Makefile.am b/fence/agents/ipdu/Makefile.am
new file mode 100644
index 0000000..fb02cc8
--- /dev/null
+++ b/fence/agents/ipdu/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_ipdu
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/ipdu/fence_ipdu.py b/fence/agents/ipdu/fence_ipdu.py
new file mode 100644
index 0000000..7f08656
--- /dev/null
+++ b/fence/agents/ipdu/fence_ipdu.py
@@ -0,0 +1,155 @@
+#!/usr/bin/python
+
+# The Following agent has been tested on:
+# IBM iPDU model 46M4002
+# Firmware release OPDP_sIBM_v01.2_1
+#
+
+import sys
+sys.path.append("/usr/share/fence")
+from fencing import *
+from fencing_snmp import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="IBM iPDU SNMP fence agent"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+### CONSTANTS ###
+# oid defining fence device
+OID_SYS_OBJECT_ID = '.1.3.6.1.2.1.1.2.0'
+
+### GLOBAL VARIABLES ###
+# Device - see IBM iPDU
+device = None
+
+# Port ID
+port_id = None
+# Switch ID
+switch_id = None
+
+# Classes describing Device params
+class IBMiPDU:
+ # iPDU
+ status_oid = '.1.3.6.1.4.1.2.6.223.8.2.2.1.11.%d'
+ control_oid = '.1.3.6.1.4.1.2.6.223.8.2.2.1.11.%d'
+ outlet_table_oid = '.1.3.6.1.4.1.2.6.223.8.2.2.1.2'
+ ident_str = "IBM iPDU"
+ state_on = 1
+ state_off = 0
+ turn_on = 1
+ turn_off = 0
+ has_switches = False
+
+### FUNCTIONS ###
+def ipdu_set_device(conn, options):
+ global device
+
+ agents_dir = {'.1.3.6.1.4.1.2.6.223':IBMiPDU,
+ None:IBMiPDU}
+
+ # First resolve type of PDU device
+ pdu_type = conn.walk(OID_SYS_OBJECT_ID)
+
+ if (not ((len(pdu_type)==1) and (agents_dir.has_key(pdu_type[0][1])))):
+ pdu_type = [[None, None]]
+
+ device = agents_dir[pdu_type[0][1]]
+
+ conn.log_command("Trying %s"%(device.ident_str))
+
+def ipdu_resolv_port_id(conn, options):
+ global port_id, switch_id
+
+ if (device==None):
+ ipdu_set_device(conn, options)
+
+ # Now we resolv port_id/switch_id
+ if ((options["--plug"].isdigit()) and ((not device.has_switches) or (options["--switch"].isdigit()))):
+ port_id = int(options["--plug"])
+
+ if (device.has_switches):
+ switch_id = int(options["--switch"])
+ else:
+ table = conn.walk(device.outlet_table_oid, 30)
+
+ for x in table:
+ if (x[1].strip('"')==options["--plug"]):
+ t = x[0].split('.')
+ if (device.has_switches):
+ port_id = int(t[len(t)-1])
+ switch_id = int(t[len(t)-3])
+ else:
+ port_id = int(t[len(t)-1])
+
+ if (port_id==None):
+ fail_usage("Can't find port with name %s!"%(options["--plug"]))
+
+def get_power_status(conn, options):
+ if (port_id==None):
+ ipdu_resolv_port_id(conn, options)
+
+ oid = ((device.has_switches) and device.status_oid%(switch_id, port_id) or device.status_oid%(port_id))
+
+ (oid, status) = conn.get(oid)
+ return (status==str(device.state_on) and "on" or "off")
+
+def set_power_status(conn, options):
+ if (port_id==None):
+ ipdu_resolv_port_id(conn, options)
+
+ oid = ((device.has_switches) and device.control_oid%(switch_id, port_id) or device.control_oid%(port_id))
+
+ conn.set(oid,(options["--action"]=="on" and device.turn_on or device.turn_off))
+
+
+def get_outlets_status(conn, options):
+ result = {}
+
+ if (device == None):
+ ipdu_set_device(conn, options)
+
+ res_ports = conn.walk(device.outlet_table_oid, 30)
+
+ for x in res_ports:
+ t = x[0].split('.')
+
+ port_num = ((device.has_switches) and "%s:%s"%(t[len(t)-3], t[len(t)-1]) or "%s"%(t[len(t)-1]))
+
+ port_name = x[1].strip('"')
+ port_status = ""
+ result[port_num] = (port_name, port_status)
+
+ return result
+
+# Main agent method
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "no_login", "no_password", \
+ "port", "snmp_version", "community" ]
+
+ atexit.register(atexit_handler)
+
+ snmp_define_defaults ()
+ all_opt["snmp_version"]["default"] = "3"
+ all_opt["community"]["default"] = "private"
+ all_opt["switch"]["default"] = "1"
+ device = IBMiPDU
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for iPDU over SNMP"
+ docs["longdesc"] = "fence_ipdu is an I/O Fencing agent \
+which can be used with the IBM iPDU network power switch. It logs \
+into a device via SNMP and reboots a specified outlet. It supports \
+SNMP v3 with all combinations of authenticity/privacy settings."
+ docs["vendorurl"] = "http://www.ibm.com"
+ show_docs(options, docs)
+
+ # Operate the fencing device
+ result = fence_action(FencingSnmp(options), options, set_power_status, get_power_status, get_outlets_status)
+
+ sys.exit(result)
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/ipmilan/Makefile.am b/fence/agents/ipmilan/Makefile.am
new file mode 100644
index 0000000..be3509e
--- /dev/null
+++ b/fence/agents/ipmilan/Makefile.am
@@ -0,0 +1,22 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_ipmilan
+
+SYMTARGET = fence_ilo3 fence_ilo4 fence_imm fence_idrac
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET) $(SYMTARGET)
+
+man_MANS = $(TARGET).8 $(SYMTARGET:%=%.8)
+
+$(SYMTARGET): $(TARGET)
+ cp $^ $@
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET) $(SYMTARGET)
diff --git a/fence/agents/ipmilan/fence_ipmilan.py b/fence/agents/ipmilan/fence_ipmilan.py
new file mode 100644
index 0000000..de42524
--- /dev/null
+++ b/fence/agents/ipmilan/fence_ipmilan.py
@@ -0,0 +1,200 @@
+#!/usr/bin/python
+
+import sys, shlex, stat, subprocess, re, os
+from pipes import quote
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION=""
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+def get_power_status(_, options):
+
+ cmd = create_command(options, "status")
+
+ if options["log"] >= LOG_MODE_VERBOSE:
+ options["debug_fh"].write("executing: " + cmd + "\n")
+
+ try:
+ process = subprocess.Popen(shlex.split(cmd), stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+ except OSError:
+ fail_usage("Ipmitool not found or not accessible")
+
+ process.wait()
+
+ out = process.communicate()
+ process.stdout.close()
+ options["debug_fh"].write(str(out) + "\n")
+
+ match = re.search('[Cc]hassis [Pp]ower is [\\s]*([a-zA-Z]{2,3})', str(out))
+ status = match.group(1) if match else None
+
+ return status
+
+def set_power_status(_, options):
+
+ cmd = create_command(options, options["--action"])
+
+ if options["log"] >= LOG_MODE_VERBOSE:
+ options["debug_fh"].write("executing: " + cmd + "\n")
+
+ try:
+ process = subprocess.Popen(shlex.split(cmd), stdout=options["debug_fh"], stderr=options["debug_fh"])
+ except OSError:
+ fail_usage("Ipmitool not found or not accessible")
+
+ process.wait()
+
+ return
+
+def reboot_cycle(_, options):
+ cmd = create_command(options, "cycle")
+
+ if options["log"] >= LOG_MODE_VERBOSE:
+ options["debug_fh"].write("executing: " + cmd + "\n")
+
+ try:
+ process = subprocess.Popen(shlex.split(cmd), stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+ except OSError:
+ fail_usage("Ipmitool not found or not accessible")
+
+ process.wait()
+
+ out = process.communicate()
+ process.stdout.close()
+ options["debug_fh"].write(str(out) + "\n")
+
+ return bool(re.search('chassis power control: cycle', str(out).lower()))
+
+def create_command(options, action):
+ cmd = options["--ipmitool-path"]
+
+ # --lanplus / -L
+ if options.has_key("--lanplus") and options["--lanplus"] in ["", "1"]:
+ cmd += " -I lanplus"
+ else:
+ cmd += " -I lan"
+ # --ip / -a
+ cmd += " -H " + options["--ip"]
+
+ # --username / -l
+ if options.has_key("--username") and len(options["--username"]) != 0:
+ cmd += " -U " + quote(options["--username"])
+
+ # --auth / -A
+ if options.has_key("--auth"):
+ cmd += " -A " + options["--auth"]
+
+ # --password / -p
+ if options.has_key("--password"):
+ cmd += " -P " + quote(options["--password"])
+
+ # --cipher / -C
+ cmd += " -C " + options["--cipher"]
+
+ # --port / -n
+ if options.has_key("--ipport"):
+ cmd += " -p " + options["--ipport"]
+
+ if options.has_key("--privlvl"):
+ cmd += " -L " + options["--privlvl"]
+
+ # --action / -o
+ cmd += " chassis power " + action
+
+ # --use-sudo / -d
+ if options.has_key("--use-sudo"):
+ cmd = SUDO_PATH + " " + cmd
+
+ return cmd
+
+def define_new_opts():
+ all_opt["lanplus"] = {
+ "getopt" : "P",
+ "longopt" : "lanplus",
+ "help" : "-P, --lanplus Use Lanplus to improve security of connection",
+ "required" : "0",
+ "default" : "0",
+ "shortdesc" : "Use Lanplus to improve security of connection",
+ "order": 1
+ }
+ all_opt["auth"] = {
+ "getopt" : "A:",
+ "longopt" : "auth",
+ "help" : "-A, --auth=[auth] IPMI Lan Auth type (md5|password|none)",
+ "required" : "0",
+ "shortdesc" : "IPMI Lan Auth type.",
+ "choices" : ["md5", "password", "none"],
+ "order": 1
+ }
+ all_opt["cipher"] = {
+ "getopt" : "C:",
+ "longopt" : "cipher",
+ "help" : "-C, --cipher=[cipher] Ciphersuite to use (same as ipmitool -C parameter)",
+ "required" : "0",
+ "shortdesc" : "Ciphersuite to use (same as ipmitool -C parameter)",
+ "default" : "0",
+ "order": 1
+ }
+ all_opt["privlvl"] = {
+ "getopt" : "L:",
+ "longopt" : "privlvl",
+ "help" : "-L, --privlvl=[level] Privilege level on IPMI device (callback|user|operator|administrator)",
+ "required" : "0",
+ "shortdesc" : "Privilege level on IPMI device",
+ "default" : "administrator",
+ "choices" : ["callback", "user", "operator", "administrator"],
+ "order": 1
+ }
+ all_opt["ipmitool_path"] = {
+ "getopt" : "i:",
+ "longopt" : "ipmitool-path",
+ "help" : "--ipmitool-path=[path] Path to ipmitool binary",
+ "required" : "0",
+ "shortdesc" : "Path to ipmitool binary",
+ "default" : "@IPMITOOL_PATH@",
+ "order": 200
+ }
+
+def main():
+
+ atexit.register(atexit_handler)
+
+ device_opt = ["ipaddr", "login", "no_login", "no_password", "passwd",
+ "lanplus", "auth", "cipher", "privlvl", "sudo", "ipmitool_path", "method"]
+ define_new_opts()
+
+ if os.path.basename(sys.argv[0]) == "fence_ilo3":
+ all_opt["power_wait"]["default"] = "4"
+ all_opt["method"]["default"] = "cycle"
+ all_opt["lanplus"]["default"] = "1"
+ elif os.path.basename(sys.argv[0]) == "fence_ilo4":
+ all_opt["lanplus"]["default"] = "1"
+
+ all_opt["ipport"]["default"] = "623"
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for IPMI"
+ docs["longdesc"] = "fence_ipmilan is an I/O Fencing agent\
+which can be used with machines controlled by IPMI.\
+This agent calls support software ipmitool (http://ipmitool.sf.net/)."
+ docs["vendorurl"] = ""
+ docs["symlink"] = [("fence_ilo3", "Fence agent for HP iLO3"),
+ ("fence_ilo4", "Fence agent for HP iLO4"),
+ ("fence_imm", "Fence agent for IBM Integrated Management Module"),
+ ("fence_idrac", "Fence agent for Dell iDRAC")]
+ show_docs(options, docs)
+
+ if not is_executable(options["--ipmitool-path"]):
+ fail_usage("Ipmitool not found or not accessible")
+
+ result = fence_action(None, options, set_power_status, get_power_status, None, reboot_cycle)
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/kdump/Makefile.am b/fence/agents/kdump/Makefile.am
new file mode 100644
index 0000000..26e452c
--- /dev/null
+++ b/fence/agents/kdump/Makefile.am
@@ -0,0 +1,14 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+sbin_PROGRAMS = fence_kdump
+libexec_PROGRAMS = fence_kdump_send
+
+noinst_HEADERS = list.h message.h options.h version.h
+
+fence_kdump_SOURCES = fence_kdump.c
+fence_kdump_CFLAGS = -D_GNU_SOURCE
+
+fence_kdump_send_SOURCES = fence_kdump_send.c
+fence_kdump_send_CFLAGS = -D_GNU_SOURCE
+
+dist_man_MANS = fence_kdump.8 fence_kdump_send.8
diff --git a/fence/agents/kdump/fence_kdump.8 b/fence/agents/kdump/fence_kdump.8
new file mode 100644
index 0000000..768f2d3
--- /dev/null
+++ b/fence/agents/kdump/fence_kdump.8
@@ -0,0 +1,85 @@
+.TH fence_kdump 8
+.SH NAME
+fence_kdump - fencing agent for use with kdump crash recovery service
+.SH SYNOPSIS
+.B
+fence_kdump
+[\fIOPTIONS\fR]...
+.SH DESCRIPTION
+\fIfence_kdump\fP is an I/O fencing agent to be used with the kdump
+crash recovery service. When the \fIfence_kdump\fP agent is invoked,
+it will listen for a message from the failed node that acknowledges
+that the failed node it executing the kdump crash kernel.
+Note that \fIfence_kdump\fP is not a replacement for traditional
+fencing methods. The \fIfence_kdump\fP agent can only detect that a
+node has entered the kdump crash recovery service. This allows the
+kdump crash recovery service complete without being preempted by
+traditional power fencing methods.
+.SH OPTIONS
+.TP
+.B -n, --nodename=\fINODE\fP
+Name or IP address of node to be fenced. This option is required for
+the "off" action. (default: none)
+.TP
+.B -p, --ipport=\fIPORT\fP
+IP port number that the \fIfence_kdump\fP agent will use to listen for
+messages. (default: 7410)
+.TP
+.B -f, --family=\fIFAMILY\fP
+IP network family. Force the \fIfence_kdump\fP agent to use a specific
+family. The value for \fIFAMILY\fP can be "auto", "ipv4", or
+"ipv6". (default: auto)
+.TP
+.B -o, --action=\fIACTION\fP
+Fencing action to perform. The value for \fIACTION\fP can be either
+"off" or "metadata". (default: off)
+.TP
+.B -t, --timeout=\fITIMEOUT\fP
+Numer of seconds to wait for message from failed node. If no message
+is received within \fITIMEOUT\fP seconds, the \fIfence_kdump\fP agent
+returns failure. (default: 60)
+.TP
+.B -v, --verbose
+Print verbose output.
+.TP
+.B -V, --version
+Print version and exit.
+.TP
+.B -h, --help
+Print usage and exit.
+.SH STDIN PARAMETERS
+.PP
+These parameters are passed to \fIfence_kdump\fP via standard input if
+no command-line options are present.
+.TP
+.B nodename=\fINODE\fP
+Name or IP address of node to be fenced. This option is required for
+the "off" action. (default: none)
+.TP
+.B ipport=\fIPORT\fP
+IP port number that the \fIfence_kdump\fP agent will use to listen for
+messages. (default: 7410)
+.TP
+.B action=\fIACTION\fP
+Fencing action to perform. The value for \fIACTION\fP can be either
+"off" or "metadata". (default: off)
+.TP
+.B timeout=\fITIMEOUT\fP
+Numer of seconds to wait for message from failed node. If no message
+is received within \fITIMEOUT\fP seconds, the \fIfence_kdump\fP agent
+returns failure. (default: 60)
+.SH ACTIONS
+.TP
+.B off
+Listen for message from failed node that acknowledges node has entered
+kdump crash recovery service. If a valid message is received from the
+failed node, the node is considered to be fenced and the agent returns
+success. Failure to receive a valid message from the failed node in
+the given timeout period results in fencing failure.
+.TP
+.B metadata
+Print XML metadata to standard output.
+.SH AUTHOR
+Ryan O'Hara <rohara at redhat.com>
+.SH SEE ALSO
+fence_kdump_send(8), fenced(8), fence_node(8)
diff --git a/fence/agents/kdump/fence_kdump.c b/fence/agents/kdump/fence_kdump.c
new file mode 100644
index 0000000..cae9842
--- /dev/null
+++ b/fence/agents/kdump/fence_kdump.c
@@ -0,0 +1,511 @@
+/* -*- mode: C; c-basic-offset: 4; indent-tabs-mode: nil -*-
+ *
+ * Copyright (c) Ryan O'Hara (rohara at redhat.com)
+ * Copyright (c) Red Hat, Inc.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ *
+ */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <stddef.h>
+#include <stdint.h>
+#include <string.h>
+#include <getopt.h>
+#include <unistd.h>
+#include <syslog.h>
+#include <ctype.h>
+#include <errno.h>
+#include <netdb.h>
+#include <sys/types.h>
+#include <sys/socket.h>
+
+#include "options.h"
+#include "message.h"
+#include "version.h"
+
+static int verbose = 0;
+
+#define log_debug(lvl, fmt, args...) \
+do { \
+ if (lvl <= verbose) { \
+ fprintf (stdout, "[debug]: " fmt, ##args); \
+ syslog (LOG_INFO, fmt, ##args); \
+ } \
+} while (0);
+
+#define log_error(lvl, fmt, args...) \
+do { \
+ if (lvl <= verbose) { \
+ fprintf (stderr, "[error]: " fmt, ##args); \
+ syslog (LOG_ERR, fmt, ##args); \
+ } \
+} while (0);
+
+static int
+trim (char *str)
+{
+ char *p;
+ int len;
+
+ if (!str) return (0);
+
+ len = strlen (str);
+
+ while (len--) {
+ if (isspace (str[len])) {
+ str[len] = 0;
+ } else {
+ break;
+ }
+ }
+
+ for (p = str; *p && isspace (*p); p++);
+
+ memmove (str, p, strlen (p) + 1);
+
+ return (strlen (str));
+}
+
+static int
+read_message (const fence_kdump_node_t *node, void *msg, int len)
+{
+ int error;
+ char addr[NI_MAXHOST];
+ char port[NI_MAXSERV];
+ struct sockaddr_storage ss;
+ socklen_t size = sizeof (ss);
+
+ error = recvfrom (node->socket, msg, len, 0, (struct sockaddr *) &ss, &size);
+ if (error < 0) {
+ log_error (2, "recvfrom (%s)\n", strerror (errno));
+ goto out;
+ }
+
+ error = getnameinfo ((struct sockaddr *) &ss, size,
+ addr, sizeof (addr),
+ port, sizeof (port),
+ NI_NUMERICHOST | NI_NUMERICSERV);
+ if (error != 0) {
+ log_error (2, "getnameinfo (%s)\n", gai_strerror (error));
+ goto out;
+ }
+
+ error = strcasecmp (node->addr, addr);
+ if (error != 0) {
+ log_debug (1, "discard message from '%s'\n", addr);
+ }
+
+out:
+ return (error);
+}
+
+static int
+do_action_off (const fence_kdump_opts_t *opts)
+{
+ int error;
+ fd_set rfds;
+ fence_kdump_msg_t msg;
+ fence_kdump_node_t *node;
+ struct timeval timeout;
+
+ if (list_empty (&opts->nodes)) {
+ return (1);
+ } else {
+ node = list_first_entry (&opts->nodes, fence_kdump_node_t, list);
+ }
+
+ timeout.tv_sec = opts->timeout;
+ timeout.tv_usec = 0;
+
+ FD_ZERO (&rfds);
+ FD_SET (node->socket, &rfds);
+
+ log_debug (0, "waiting for message from '%s'\n", node->addr);
+
+ for (;;) {
+ error = select (node->socket + 1, &rfds, NULL, NULL, &timeout);
+ if (error < 0) {
+ log_error (2, "select (%s)\n", strerror (errno));
+ break;
+ }
+ if (error == 0) {
+ log_debug (0, "timeout after %d seconds\n", opts->timeout);
+ break;
+ }
+
+ if (read_message (node, &msg, sizeof (msg)) != 0) {
+ continue;
+ }
+
+ if (msg.magic != FENCE_KDUMP_MAGIC) {
+ log_debug (1, "invalid magic number '0x%X'\n", msg.magic);
+ continue;
+ }
+
+ switch (msg.version) {
+ case FENCE_KDUMP_MSGV1:
+ log_debug (0, "received valid message from '%s'\n", node->addr);
+ return (0);
+ default:
+ log_debug (1, "invalid message version '0x%X'\n", msg.version);
+ continue;
+ }
+ }
+
+ return (1);
+}
+
+static int
+do_action_metadata (const char *self)
+{
+ fprintf (stdout, "<?xml version=\"1.0\" ?>\n");
+ fprintf (stdout, "<resource-agent name=\"%s\"", basename (self));
+ fprintf (stdout, " shortdesc=\"Fence agent for use with kdump\">\n");
+ fprintf (stdout, "<longdesc>");
+ fprintf (stdout, "The fence_kdump agent is intended to be used with with kdump service.");
+ fprintf (stdout, "</longdesc>\n");
+ fprintf (stdout, "<vendor-url>http://www.kernel.org/pub/linux/utils/kernel/kexec/</vendor-url>\n");
+
+ fprintf (stdout, "<parameters>\n");
+
+ fprintf (stdout, "\t<parameter name=\"nodename\" unique=\"0\" required=\"0\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-n, --nodename\" />\n");
+ fprintf (stdout, "\t\t<content type=\"string\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Name or IP address of node to be fenced");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"ipport\" unique=\"0\" required=\"0\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-p, --ipport\" />\n");
+ fprintf (stdout, "\t\t<content type=\"string\" default=\"7410\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Port number");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"family\" unique=\"0\" required=\"0\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-f, --family\" />\n");
+ fprintf (stdout, "\t\t<content type=\"string\" default=\"auto\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Network family");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"action\" unique=\"0\" required=\"0\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-o, --action\" />\n");
+ fprintf (stdout, "\t\t<content type=\"string\" default=\"off\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Fencing action");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"timeout\" unique=\"0\" required=\"0\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-t, --timeout\" />\n");
+ fprintf (stdout, "\t\t<content type=\"string\" default=\"60\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Timeout in seconds");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"verbose\" unique=\"0\" required=\"0\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-v, --verbose\" />\n");
+ fprintf (stdout, "\t\t<content type=\"boolean\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Print verbose output");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"version\" unique=\"0\" required=\"0\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-V, --version\" />\n");
+ fprintf (stdout, "\t\t<content type=\"boolean\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Print version");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"usage\" unique=\"0\" required=\"0\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-h, --help\" />\n");
+ fprintf (stdout, "\t\t<content type=\"boolean\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Print usage");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "</parameters>\n");
+
+ fprintf (stdout, "<actions>\n");
+ fprintf (stdout, "\t<action name=\"off\" />\n");
+ fprintf (stdout, "\t<action name=\"metadata\" />\n");
+ fprintf (stdout, "</actions>\n");
+
+ fprintf (stdout, "</resource-agent>\n");
+
+ return (0);
+}
+
+static void
+print_usage (const char *self)
+{
+ fprintf (stdout, "Usage: %s [options]\n", basename (self));
+ fprintf (stdout, "\n");
+ fprintf (stdout, "Options:\n");
+ fprintf (stdout, "\n");
+ fprintf (stdout, "%s\n",
+ " -n, --nodename=NODE Name or IP address of node to be fenced");
+ fprintf (stdout, "%s\n",
+ " -p, --ipport=PORT IP port number (default: 7410)");
+ fprintf (stdout, "%s\n",
+ " -f, --family=FAMILY Network family: ([auto], ipv4, ipv6)");
+ fprintf (stdout, "%s\n",
+ " -o, --action=ACTION Fencing action: ([off], metadata)");
+ fprintf (stdout, "%s\n",
+ " -t, --timeout=TIMEOUT Timeout in seconds (default: 60)");
+ fprintf (stdout, "%s\n",
+ " -v, --verbose Print verbose output");
+ fprintf (stdout, "%s\n",
+ " -V, --version Print version");
+ fprintf (stdout, "%s\n",
+ " -h, --help Print usage");
+ fprintf (stdout, "\n");
+
+ return;
+}
+
+static int
+get_options_node (fence_kdump_opts_t *opts)
+{
+ int error;
+ struct addrinfo hints;
+ fence_kdump_node_t *node;
+
+ node = malloc (sizeof (fence_kdump_node_t));
+ if (!node) {
+ log_error (2, "malloc (%s)\n", strerror (errno));
+ return (1);
+ }
+
+ memset (node, 0, sizeof (fence_kdump_node_t));
+ memset (&hints, 0, sizeof (hints));
+
+ hints.ai_family = opts->family;
+ hints.ai_socktype = SOCK_DGRAM;
+ hints.ai_protocol = IPPROTO_UDP;
+ hints.ai_flags = AI_NUMERICSERV;
+
+ strncpy (node->name, opts->nodename, sizeof (node->name));
+ snprintf (node->port, sizeof (node->port), "%d", opts->ipport);
+
+ node->info = NULL;
+ error = getaddrinfo (node->name, node->port, &hints, &node->info);
+ if (error != 0) {
+ log_error (2, "getaddrinfo (%s)\n", gai_strerror (error));
+ free_node (node);
+ return (1);
+ }
+
+ error = getnameinfo (node->info->ai_addr, node->info->ai_addrlen,
+ node->addr, sizeof (node->addr),
+ node->port, sizeof (node->port),
+ NI_NUMERICHOST | NI_NUMERICSERV);
+ if (error != 0) {
+ log_error (2, "getnameinfo (%s)\n", gai_strerror (error));
+ free_node (node);
+ return (1);
+ }
+
+ hints.ai_family = node->info->ai_family;
+ hints.ai_flags |= AI_PASSIVE;
+
+ freeaddrinfo (node->info);
+
+ node->info = NULL;
+ error = getaddrinfo (NULL, node->port, &hints, &node->info);
+ if (error != 0) {
+ log_error (2, "getaddrinfo (%s)\n", gai_strerror (error));
+ free_node (node);
+ return (1);
+ }
+
+ node->socket = socket (node->info->ai_family,
+ node->info->ai_socktype,
+ node->info->ai_protocol);
+ if (node->socket < 0) {
+ log_error (2, "socket (%s)\n", strerror (errno));
+ free_node (node);
+ return (1);
+ }
+
+ error = bind (node->socket, node->info->ai_addr, node->info->ai_addrlen);
+ if (error != 0) {
+ log_error (2, "bind (%s)\n", strerror (errno));
+ free_node (node);
+ return (1);
+ }
+
+ list_add_tail (&node->list, &opts->nodes);
+
+ return (0);
+}
+
+static void
+get_options (int argc, char **argv, fence_kdump_opts_t *opts)
+{
+ int opt;
+
+ struct option options[] = {
+ { "nodename", required_argument, NULL, 'n' },
+ { "ipport", required_argument, NULL, 'p' },
+ { "family", required_argument, NULL, 'f' },
+ { "action", required_argument, NULL, 'o' },
+ { "timeout", required_argument, NULL, 't' },
+ { "verbose", optional_argument, NULL, 'v' },
+ { "version", no_argument, NULL, 'V' },
+ { "help", no_argument, NULL, 'h' },
+ { 0, 0, 0, 0 }
+ };
+
+ while ((opt = getopt_long (argc, argv, "n:p:f:o:t:v::Vh", options, NULL)) != EOF) {
+ switch (opt) {
+ case 'n':
+ set_option_nodename (opts, optarg);
+ break;
+ case 'p':
+ set_option_ipport (opts, optarg);
+ break;
+ case 'f':
+ set_option_family (opts, optarg);
+ break;
+ case 'o':
+ set_option_action (opts, optarg);
+ break;
+ case 't':
+ set_option_timeout (opts, optarg);
+ break;
+ case 'v':
+ set_option_verbose (opts, optarg);
+ break;
+ case 'V':
+ print_version (argv[0]);
+ exit (0);
+ case 'h':
+ print_usage (argv[0]);
+ exit (0);
+ default:
+ print_usage (argv[0]);
+ exit (1);
+ }
+ }
+
+ verbose = opts->verbose;
+
+ return;
+}
+
+static void
+get_options_stdin (fence_kdump_opts_t *opts)
+{
+ char buf[1024];
+ char *opt;
+ char *arg;
+
+ while (fgets (buf, sizeof (buf), stdin) != 0) {
+ if (trim (buf) == 0) {
+ continue;
+ }
+ if (buf[0] == '#') {
+ continue;
+ }
+
+ opt = buf;
+
+ if ((arg = strchr (opt, '=')) != 0) {
+ *arg = 0;
+ arg += 1;
+ } else {
+ continue;
+ }
+
+ if (!strcasecmp (opt, "nodename")) {
+ set_option_nodename (opts, arg);
+ continue;
+ }
+ if (!strcasecmp (opt, "ipport")) {
+ set_option_ipport (opts, arg);
+ continue;
+ }
+ if (!strcasecmp (opt, "family")) {
+ set_option_family (opts, arg);
+ continue;
+ }
+ if (!strcasecmp (opt, "action")) {
+ set_option_action (opts, arg);
+ continue;
+ }
+ if (!strcasecmp (opt, "timeout")) {
+ set_option_timeout (opts, arg);
+ continue;
+ }
+ if (!strcasecmp (opt, "verbose")) {
+ set_option_verbose (opts, arg);
+ continue;
+ }
+ }
+
+ verbose = opts->verbose;
+
+ return;
+}
+
+int
+main (int argc, char **argv)
+{
+ int error = 1;
+ fence_kdump_opts_t opts;
+
+ init_options (&opts);
+
+ if (argc > 1) {
+ get_options (argc, argv, &opts);
+ } else {
+ get_options_stdin (&opts);
+ }
+
+ openlog ("fence_kdump", LOG_CONS|LOG_PID, LOG_DAEMON);
+
+ if (opts.action == FENCE_KDUMP_ACTION_OFF) {
+ if (opts.nodename == NULL) {
+ log_error (0, "action 'off' requires nodename\n");
+ exit (1);
+ }
+ if (get_options_node (&opts) != 0) {
+ log_error (0, "failed to get node '%s'\n", opts.nodename);
+ exit (1);
+ }
+ }
+
+ if (verbose != 0) {
+ print_options (&opts);
+ }
+
+ switch (opts.action) {
+ case FENCE_KDUMP_ACTION_OFF:
+ error = do_action_off (&opts);
+ break;
+ case FENCE_KDUMP_ACTION_METADATA:
+ error = do_action_metadata (argv[0]);
+ break;
+ default:
+ break;
+ }
+
+ free_options (&opts);
+
+ return (error);
+}
diff --git a/fence/agents/kdump/fence_kdump_send.8 b/fence/agents/kdump/fence_kdump_send.8
new file mode 100644
index 0000000..ab95836
--- /dev/null
+++ b/fence/agents/kdump/fence_kdump_send.8
@@ -0,0 +1,50 @@
+.TH fence_kdump_send 8
+.SH NAME
+fence_kdump_send - send kdump acknowlegement message to cluster nodes
+.SH SYNOPSIS
+.B
+fence_kdump_send
+[\fIOPTIONS]\fR... [NODE]...
+.SH DESCRIPTION
+\fIfence_kdump_send\fP is a utility used to send messages that
+acknowledge that the node has entered the kdump crash recovery
+service. This utility is intended to be used the the \fIfence_kdump\fP
+agent as a means detect that a failed node has entered the kdump crash
+recovery service.
+The \fIfence_kdump_send\fP utility is typically run from within the
+kdump kernel after a cluster node has encountered a kernel panic. Once
+the cluster node has entered the kdump crash recovery service,
+\fIfence_kdump_send\fP will periodically send messages to all cluster
+nodes. When the \fIfence_kdump\fP agent receives a valid message from
+the failed node, fencing is complete.
+.SH OPTIONS
+.TP
+.B -p, --ipport=\fIPORT\fP
+IP port number that the \fIfence_kdump\fP agent is using to listen for
+messages. (default: 7410)
+.TP
+.B -f, --family=\fIFAMILY\fP
+IP network family. Force the \fIfence_kdump_send\fP utility to use a
+particular network family. Value for \fIFAMILY\fP can be "auto",
+"ipv4", or "ipv6". (default: auto)
+.TP
+.B -c, --count=\fICOUNT\fP
+Number of messages to send. If \fICOUNT\fP is zero,
+\fIfence_kdump_send\fP will send messages indefinitely. (default: 0)
+.TP
+.B -i, --interval=\fIINTERVAL\fP
+Time to wait between sending a message. The value for \fIINTERVAL\fP
+must be greater than zero. (default: 10)
+.TP
+.B -v, --verbose
+Print verbose output.
+.TP
+.B -V, --version
+Print version and exit.
+.TP
+.B -h, --help
+Print usage and exit.
+.SH AUTHOR
+Ryan O'Hara <rohara at redhat.com>
+.SH SEE ALSO
+fence_kdump(8), mkdumprd(8), kdump.conf(5)
diff --git a/fence/agents/kdump/fence_kdump_send.c b/fence/agents/kdump/fence_kdump_send.c
new file mode 100644
index 0000000..fab3d36
--- /dev/null
+++ b/fence/agents/kdump/fence_kdump_send.c
@@ -0,0 +1,254 @@
+/* -*- mode: C; c-basic-offset: 4; indent-tabs-mode: nil -*-
+ *
+ * Copyright (c) Ryan O'Hara (rohara at redhat.com)
+ * Copyright (c) Red Hat, Inc.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ *
+ */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <stddef.h>
+#include <stdint.h>
+#include <string.h>
+#include <getopt.h>
+#include <unistd.h>
+#include <syslog.h>
+#include <ctype.h>
+#include <errno.h>
+#include <netdb.h>
+#include <sys/types.h>
+#include <sys/socket.h>
+
+#include "options.h"
+#include "message.h"
+#include "version.h"
+
+static int verbose = 0;
+
+#define log_debug(lvl, fmt, args...) \
+do { \
+ if (lvl <= verbose) \
+ fprintf (stdout, "[debug]: " fmt, ##args); \
+} while (0);
+
+#define log_error(lvl, fmt, args...) \
+do { \
+ if (lvl <= verbose) \
+ fprintf (stderr, "[error]: " fmt, ##args); \
+} while (0);
+
+static int
+send_message (const fence_kdump_node_t *node, void *msg, int len)
+{
+ int error;
+
+ error = sendto (node->socket, msg, len, 0, node->info->ai_addr, node->info->ai_addrlen);
+ if (error < 0) {
+ log_error (2, "sendto (%s)\n", strerror (errno));
+ goto out;
+ }
+
+ log_debug (1, "message sent to node '%s'\n", node->addr);
+
+out:
+ return (error);
+}
+
+static void
+print_usage (const char *self)
+{
+ fprintf (stdout, "Usage: %s [options] [nodes]\n", basename (self));
+ fprintf (stdout, "\n");
+ fprintf (stdout, "Options:\n");
+ fprintf (stdout, "\n");
+ fprintf (stdout, "%s\n",
+ " -p, --ipport=PORT Port number (default: 7410)");
+ fprintf (stdout, "%s\n",
+ " -f, --family=FAMILY Network family ([auto], ipv4, ipv6)");
+ fprintf (stdout, "%s\n",
+ " -c, --count=COUNT Number of messages to send (default: 0)");
+ fprintf (stdout, "%s\n",
+ " -i, --interval=INTERVAL Interval in seconds (default: 10)");
+ fprintf (stdout, "%s\n",
+ " -v, --verbose Print verbose output");
+ fprintf (stdout, "%s\n",
+ " -V, --version Print version");
+ fprintf (stdout, "%s\n",
+ " -h, --help Print usage");
+ fprintf (stdout, "\n");
+
+ return;
+}
+
+static int
+get_options_node (fence_kdump_opts_t *opts)
+{
+ int error;
+ struct addrinfo hints;
+ fence_kdump_node_t *node;
+
+ node = malloc (sizeof (fence_kdump_node_t));
+ if (!node) {
+ log_error (2, "malloc (%s)\n", strerror (errno));
+ return (1);
+ }
+
+ memset (node, 0, sizeof (fence_kdump_node_t));
+ memset (&hints, 0, sizeof (hints));
+
+ hints.ai_family = opts->family;
+ hints.ai_socktype = SOCK_DGRAM;
+ hints.ai_protocol = IPPROTO_UDP;
+ hints.ai_flags = AI_NUMERICSERV;
+
+ strncpy (node->name, opts->nodename, sizeof (node->name));
+ snprintf (node->port, sizeof (node->port), "%d", opts->ipport);
+
+ node->info = NULL;
+ error = getaddrinfo (node->name, node->port, &hints, &node->info);
+ if (error != 0) {
+ log_error (2, "getaddrinfo (%s)\n", gai_strerror (error));
+ free_node (node);
+ return (1);
+ }
+
+ error = getnameinfo (node->info->ai_addr, node->info->ai_addrlen,
+ node->addr, sizeof (node->addr),
+ node->port, sizeof (node->port),
+ NI_NUMERICHOST | NI_NUMERICSERV);
+ if (error != 0) {
+ log_error (2, "getnameinfo (%s)\n", gai_strerror (error));
+ free_node (node);
+ return (1);
+ }
+
+ node->socket = socket (node->info->ai_family,
+ node->info->ai_socktype,
+ node->info->ai_protocol);
+ if (node->socket < 0) {
+ log_error (2, "socket (%s)\n", strerror (errno));
+ free_node (node);
+ return (1);
+ }
+
+ list_add_tail (&node->list, &opts->nodes);
+
+ return (0);
+}
+
+static void
+get_options (int argc, char **argv, fence_kdump_opts_t *opts)
+{
+ int opt;
+
+ struct option options[] = {
+ { "ipport", required_argument, NULL, 'p' },
+ { "family", required_argument, NULL, 'f' },
+ { "count", required_argument, NULL, 'c' },
+ { "interval", required_argument, NULL, 'i' },
+ { "verbose", optional_argument, NULL, 'v' },
+ { "version", no_argument, NULL, 'V' },
+ { "help", no_argument, NULL, 'h' },
+ { 0, 0, 0, 0 }
+ };
+
+ while ((opt = getopt_long (argc, argv, "p:f:c:i:v::Vh", options, NULL)) != EOF) {
+ switch (opt) {
+ case 'p':
+ set_option_ipport (opts, optarg);
+ break;
+ case 'f':
+ set_option_family (opts, optarg);
+ break;
+ case 'c':
+ set_option_count (opts, optarg);
+ break;
+ case 'i':
+ set_option_interval (opts, optarg);
+ break;
+ case 'v':
+ set_option_verbose (opts, optarg);
+ break;
+ case 'V':
+ print_version (argv[0]);
+ exit (0);
+ case 'h':
+ print_usage (argv[0]);
+ exit (0);
+ default:
+ print_usage (argv[0]);
+ exit (1);
+ }
+ }
+
+ verbose = opts->verbose;
+
+ return;
+}
+
+int
+main (int argc, char **argv)
+{
+ int count = 1;
+ fence_kdump_msg_t msg;
+ fence_kdump_opts_t opts;
+ fence_kdump_node_t *node;
+
+ init_options (&opts);
+
+ if (argc > 1) {
+ get_options (argc, argv, &opts);
+ } else {
+ print_usage (argv[0]);
+ exit (1);
+ }
+
+ for (; optind < argc; optind++) {
+ opts.nodename = argv[optind];
+ if (get_options_node (&opts) != 0) {
+ log_error (1, "failed to get node '%s'\n", opts.nodename);
+ }
+ opts.nodename = NULL;
+ }
+
+ if (list_empty (&opts.nodes)) {
+ print_usage (argv[0]);
+ exit (1);
+ }
+
+ if (verbose != 0) {
+ print_options (&opts);
+ }
+
+ init_message (&msg);
+
+ for (;;) {
+ list_for_each_entry (node, &opts.nodes, list) {
+ send_message (node, &msg, sizeof (msg));
+ }
+
+ if ((opts.count != 0) && (++count > opts.count)) {
+ break;
+ }
+
+ sleep (opts.interval);
+ }
+
+ free_options (&opts);
+
+ return (0);
+}
diff --git a/fence/agents/kdump/list.h b/fence/agents/kdump/list.h
new file mode 100644
index 0000000..8945a62
--- /dev/null
+++ b/fence/agents/kdump/list.h
@@ -0,0 +1,573 @@
+#ifndef _LINUX_LIST_H
+#define _LINUX_LIST_H
+
+#include <stddef.h>
+
+/*
+ * These are non-NULL pointers that will result in page faults
+ * under normal circumstances, used to verify that nobody uses
+ * non-initialized list entries.
+ */
+#define LIST_POISON1 ((void *) 0x00100100)
+#define LIST_POISON2 ((void *) 0x00200200)
+
+/*
+ * Simple doubly linked list implementation.
+ *
+ * Some of the internal functions ("__xxx") are useful when
+ * manipulating whole lists rather than single entries, as
+ * sometimes we already know the next/prev entries and we can
+ * generate better code by using them directly rather than
+ * using the generic single-entry routines.
+ */
+struct list_head {
+ struct list_head *next, *prev;
+};
+
+#define LIST_HEAD_INIT(name) { &(name), &(name) }
+
+#define LIST_HEAD(name) \
+ struct list_head name = LIST_HEAD_INIT(name)
+
+static inline void INIT_LIST_HEAD(struct list_head *list)
+{
+ list->next = list;
+ list->prev = list;
+}
+
+/*
+ * Insert a new entry between two known consecutive entries.
+ *
+ * This is only for internal list manipulation where we know
+ * the prev/next entries already!
+ */
+static inline void __list_add(struct list_head *new,
+ struct list_head *prev,
+ struct list_head *next)
+{
+ next->prev = new;
+ new->next = next;
+ new->prev = prev;
+ prev->next = new;
+}
+
+/**
+ * list_add - add a new entry
+ * @new: new entry to be added
+ * @head: list head to add it after
+ *
+ * Insert a new entry after the specified head.
+ * This is good for implementing stacks.
+ */
+static inline void list_add(struct list_head *new,
+ struct list_head *head)
+{
+ __list_add(new, head, head->next);
+}
+
+/**
+ * list_add_tail - add a new entry
+ * @new: new entry to be added
+ * @head: list head to add it before
+ *
+ * Insert a new entry before the specified head.
+ * This is useful for implementing queues.
+ */
+static inline void list_add_tail(struct list_head *new,
+ struct list_head *head)
+{
+ __list_add(new, head->prev, head);
+}
+
+/*
+ * Delete a list entry by making the prev/next entries
+ * point to each other.
+ *
+ * This is only for internal list manipulation where we know
+ * the prev/next entries already!
+ */
+static inline void __list_del(struct list_head * prev,
+ struct list_head * next)
+{
+ next->prev = prev;
+ prev->next = next;
+}
+
+/**
+ * list_del - deletes entry from list.
+ * @entry: the element to delete from the list.
+ * Note: list_empty() on entry does not return true after this, the entry is
+ * in an undefined state.
+ */
+static inline void __list_del_entry(struct list_head *entry)
+{
+ __list_del(entry->prev, entry->next);
+}
+
+static inline void list_del(struct list_head *entry)
+{
+ __list_del(entry->prev, entry->next);
+ entry->next = LIST_POISON1;
+ entry->prev = LIST_POISON2;
+}
+
+/**
+ * list_replace - replace old entry by new one
+ * @old : the element to be replaced
+ * @new : the new element to insert
+ *
+ * If @old was empty, it will be overwritten.
+ */
+static inline void list_replace(struct list_head *old,
+ struct list_head *new)
+{
+ new->next = old->next;
+ new->next->prev = new;
+ new->prev = old->prev;
+ new->prev->next = new;
+}
+
+static inline void list_replace_init(struct list_head *old,
+ struct list_head *new)
+{
+ list_replace(old, new);
+ INIT_LIST_HEAD(old);
+}
+
+/**
+ * list_del_init - deletes entry from list and reinitialize it.
+ * @entry: the element to delete from the list.
+ */
+static inline void list_del_init(struct list_head *entry)
+{
+ __list_del_entry(entry);
+ INIT_LIST_HEAD(entry);
+}
+
+/**
+ * list_move - delete from one list and add as another's head
+ * @list: the entry to move
+ * @head: the head that will precede our entry
+ */
+static inline void list_move(struct list_head *list,
+ struct list_head *head)
+{
+ __list_del_entry(list);
+ list_add(list, head);
+}
+
+/**
+ * list_move_tail - delete from one list and add as another's tail
+ * @list: the entry to move
+ * @head: the head that will follow our entry
+ */
+static inline void list_move_tail(struct list_head *list,
+ struct list_head *head)
+{
+ __list_del_entry(list);
+ list_add_tail(list, head);
+}
+
+/**
+ * list_is_last - tests whether @list is the last entry in list @head
+ * @list: the entry to test
+ * @head: the head of the list
+ */
+static inline int list_is_last(const struct list_head *list,
+ const struct list_head *head)
+{
+ return list->next == head;
+}
+
+/**
+ * list_empty - tests whether a list is empty
+ * @head: the list to test.
+ */
+static inline int list_empty(const struct list_head *head)
+{
+ return head->next == head;
+}
+
+/**
+ * list_empty_careful - tests whether a list is empty and not being modified
+ * @head: the list to test
+ *
+ * Description:
+ * tests whether a list is empty _and_ checks that no other CPU might be
+ * in the process of modifying either member (next or prev)
+ *
+ * NOTE: using list_empty_careful() without synchronization
+ * can only be safe if the only activity that can happen
+ * to the list entry is list_del_init(). Eg. it cannot be used
+ * if another CPU could re-list_add() it.
+ */
+static inline int list_empty_careful(const struct list_head *head)
+{
+ struct list_head *next = head->next;
+
+ return (next == head) && (next == head->prev);
+}
+
+/**
+ * list_rotate_left - rotate the list to the left
+ * @head: the head of the list
+ */
+static inline void list_rotate_left(struct list_head *head)
+{
+ struct list_head *first;
+
+ if (!list_empty(head)) {
+ first = head->next;
+ list_move_tail(first, head);
+ }
+}
+
+/**
+ * list_is_singular - tests whether a list has just one entry.
+ * @head: the list to test.
+ */
+static inline int list_is_singular(const struct list_head *head)
+{
+ return !list_empty(head) && (head->next == head->prev);
+}
+
+static inline void __list_cut_position(struct list_head *list,
+ struct list_head *head,
+ struct list_head *entry)
+{
+ struct list_head *new_first = entry->next;
+
+ list->next = head->next;
+ list->next->prev = list;
+ list->prev = entry;
+ entry->next = list;
+ head->next = new_first;
+ new_first->prev = head;
+}
+
+/**
+ * list_cut_position - cut a list into two
+ * @list: a new list to add all removed entries
+ * @head: a list with entries
+ * @entry: an entry within head, could be the head itself
+ * and if so we won't cut the list
+ *
+ * This helper moves the initial part of @head, up to and
+ * including @entry, from @head to @list. You should
+ * pass on @entry an element you know is on @head. @list
+ * should be an empty list or a list you do not care about
+ * losing its data.
+ */
+static inline void list_cut_position(struct list_head *list,
+ struct list_head *head,
+ struct list_head *entry)
+{
+ if (list_empty(head))
+ return;
+ if (list_is_singular(head) &&
+ (head->next != entry && head != entry))
+ return;
+ if (entry == head)
+ INIT_LIST_HEAD(list);
+ else
+ __list_cut_position(list, head, entry);
+}
+
+static inline void __list_splice(const struct list_head *list,
+ struct list_head *prev,
+ struct list_head *next)
+{
+ struct list_head *first = list->next;
+ struct list_head *last = list->prev;
+
+ first->prev = prev;
+ prev->next = first;
+ last->next = next;
+ next->prev = last;
+}
+
+/**
+ * list_splice - join two lists, this is designed for stacks
+ * @list: the new list to add.
+ * @head: the place to add it in the first list.
+ */
+static inline void list_splice(const struct list_head *list,
+ struct list_head *head)
+{
+ if (!list_empty(list))
+ __list_splice(list, head, head->next);
+}
+
+/**
+ * list_splice_tail - join two lists, each list being a queue
+ * @list: the new list to add.
+ * @head: the place to add it in the first list.
+ */
+static inline void list_splice_tail(struct list_head *list,
+ struct list_head *head)
+{
+ if (!list_empty(list))
+ __list_splice(list, head->prev, head);
+}
+
+/**
+ * list_splice_init - join two lists and reinitialise the emptied list.
+ * @list: the new list to add.
+ * @head: the place to add it in the first list.
+ *
+ * The list at @list is reinitialised
+ */
+static inline void list_splice_init(struct list_head *list,
+ struct list_head *head)
+{
+ if (!list_empty(list)) {
+ __list_splice(list, head, head->next);
+ INIT_LIST_HEAD(list);
+ }
+}
+
+/**
+ * list_splice_tail_init - join two lists and reinitialise the emptied list
+ * @list: the new list to add.
+ * @head: the place to add it in the first list.
+ *
+ * Each of the lists is a queue.
+ * The list at @list is reinitialised
+ */
+static inline void list_splice_tail_init(struct list_head *list,
+ struct list_head *head)
+{
+ if (!list_empty(list)) {
+ __list_splice(list, head->prev, head);
+ INIT_LIST_HEAD(list);
+ }
+}
+
+/**
+ * container_of - cast a member of a structure out to the containing structure
+ * @ptr: the pointer to the member.
+ * @type: the type of the container struct this is embedded in.
+ * @member: the name of the member within the struct.
+ */
+#define container_of(ptr, type, member) ({ \
+ const typeof( ((type *)0)->member ) *__mptr = (ptr); \
+ (type *)( (char *)__mptr - offsetof(type,member) );})
+
+/**
+ * list_entry - get the struct for this entry
+ * @ptr: the &struct list_head pointer.
+ * @type: the type of the struct this is embedded in.
+ * @member: the name of the list_struct within the struct.
+ */
+#define list_entry(ptr, type, member) \
+ container_of(ptr, type, member)
+
+/**
+ * list_first_entry - get the first element from a list
+ * @ptr: the list head to take the element from.
+ * @type: the type of the struct this is embedded in.
+ * @member: the name of the list_struct within the struct.
+ *
+ * Note, that list is expected to be not empty.
+ */
+#define list_first_entry(ptr, type, member) \
+ list_entry((ptr)->next, type, member)
+
+/**
+ * list_for_each - iterate over a list
+ * @pos: the &struct list_head to use as a loop cursor.
+ * @head: the head for your list.
+ */
+#define list_for_each(pos, head) \
+ for (pos = (head)->next; pos != (head); pos = pos->next)
+
+/**
+ * __list_for_each - iterate over a list
+ * @pos: the &struct list_head to use as a loop cursor.
+ * @head: the head for your list.
+ *
+ * This variant differs from list_for_each() in that it's the
+ * simplest possible list iteration code, no prefetching is done.
+ * Use this for code that knows the list to be very short (empty
+ * or 1 entry) most of the time.
+ */
+#define __list_for_each(pos, head) \
+ for (pos = (head)->next; pos != (head); pos = pos->next)
+
+/**
+ * list_for_each_prev - iterate over a list backwards
+ * @pos: the &struct list_head to use as a loop cursor.
+ * @head: the head for your list.
+ */
+#define list_for_each_prev(pos, head) \
+ for (pos = (head)->prev; pos != (head); pos = pos->prev)
+
+/**
+ * list_for_each_safe - iterate over a list safe against removal of list entry
+ * @pos: the &struct list_head to use as a loop cursor.
+ * @n: another &struct list_head to use as temporary storage
+ * @head: the head for your list.
+ */
+#define list_for_each_safe(pos, n, head) \
+ for (pos = (head)->next, n = pos->next; pos != (head); \
+ pos = n, n = pos->next)
+
+/**
+ * list_for_each_prev_safe - iterate over a list backwards safe against removal of list entry
+ * @pos: the &struct list_head to use as a loop cursor.
+ * @n: another &struct list_head to use as temporary storage
+ * @head: the head for your list.
+ */
+#define list_for_each_prev_safe(pos, n, head) \
+ for (pos = (head)->prev, n = pos->prev; pos != (head); \
+ pos = n, n = pos->prev)
+
+/**
+ * list_for_each_entry - iterate over list of given type
+ * @pos: the type * to use as a loop cursor.
+ * @head: the head for your list.
+ * @member: the name of the list_struct within the struct.
+ */
+#define list_for_each_entry(pos, head, member) \
+ for (pos = list_entry((head)->next, typeof(*pos), member); \
+ &pos->member != (head); \
+ pos = list_entry(pos->member.next, typeof(*pos), member))
+
+/**
+ * list_for_each_entry_reverse - iterate backwards over list of given type.
+ * @pos: the type * to use as a loop cursor.
+ * @head: the head for your list.
+ * @member: the name of the list_struct within the struct.
+ */
+#define list_for_each_entry_reverse(pos, head, member) \
+ for (pos = list_entry((head)->prev, typeof(*pos), member); \
+ &pos->member != (head); \
+ pos = list_entry(pos->member.prev, typeof(*pos), member))
+
+/**
+ * list_prepare_entry - prepare a pos entry for use in list_for_each_entry_continue()
+ * @pos: the type * to use as a start point
+ * @head: the head of the list
+ * @member: the name of the list_struct within the struct.
+ *
+ * Prepares a pos entry for use as a start point in list_for_each_entry_continue().
+ */
+#define list_prepare_entry(pos, head, member) \
+ ((pos) ? : list_entry(head, typeof(*pos), member))
+
+/**
+ * list_for_each_entry_continue - continue iteration over list of given type
+ * @pos: the type * to use as a loop cursor.
+ * @head: the head for your list.
+ * @member: the name of the list_struct within the struct.
+ *
+ * Continue to iterate over list of given type, continuing after
+ * the current position.
+ */
+#define list_for_each_entry_continue(pos, head, member) \
+ for (pos = list_entry(pos->member.next, typeof(*pos), member); \
+ &pos->member != (head); \
+ pos = list_entry(pos->member.next, typeof(*pos), member))
+
+/**
+ * list_for_each_entry_continue_reverse - iterate backwards from the given point
+ * @pos: the type * to use as a loop cursor.
+ * @head: the head for your list.
+ * @member: the name of the list_struct within the struct.
+ *
+ * Start to iterate over list of given type backwards, continuing after
+ * the current position.
+ */
+#define list_for_each_entry_continue_reverse(pos, head, member) \
+ for (pos = list_entry(pos->member.prev, typeof(*pos), member); \
+ &pos->member != (head); \
+ pos = list_entry(pos->member.prev, typeof(*pos), member))
+
+/**
+ * list_for_each_entry_from - iterate over list of given type from the current point
+ * @pos: the type * to use as a loop cursor.
+ * @head: the head for your list.
+ * @member: the name of the list_struct within the struct.
+ *
+ * Iterate over list of given type, continuing from current position.
+ */
+#define list_for_each_entry_from(pos, head, member) \
+ for (; &pos->member != (head); \
+ pos = list_entry(pos->member.next, typeof(*pos), member))
+
+/**
+ * list_for_each_entry_safe - iterate over list of given type safe against removal of list entry
+ * @pos: the type * to use as a loop cursor.
+ * @n: another type * to use as temporary storage
+ * @head: the head for your list.
+ * @member: the name of the list_struct within the struct.
+ */
+#define list_for_each_entry_safe(pos, n, head, member) \
+ for (pos = list_entry((head)->next, typeof(*pos), member), \
+ n = list_entry(pos->member.next, typeof(*pos), member); \
+ &pos->member != (head); \
+ pos = n, n = list_entry(n->member.next, typeof(*n), member))
+
+/**
+ * list_for_each_entry_safe_continue - continue list iteration safe against removal
+ * @pos: the type * to use as a loop cursor.
+ * @n: another type * to use as temporary storage
+ * @head: the head for your list.
+ * @member: the name of the list_struct within the struct.
+ *
+ * Iterate over list of given type, continuing after current point,
+ * safe against removal of list entry.
+ */
+#define list_for_each_entry_safe_continue(pos, n, head, member) \
+ for (pos = list_entry(pos->member.next, typeof(*pos), member), \
+ n = list_entry(pos->member.next, typeof(*pos), member); \
+ &pos->member != (head); \
+ pos = n, n = list_entry(n->member.next, typeof(*n), member))
+
+/**
+ * list_for_each_entry_safe_from - iterate over list from current point safe against removal
+ * @pos: the type * to use as a loop cursor.
+ * @n: another type * to use as temporary storage
+ * @head: the head for your list.
+ * @member: the name of the list_struct within the struct.
+ *
+ * Iterate over list of given type from current point, safe against
+ * removal of list entry.
+ */
+#define list_for_each_entry_safe_from(pos, n, head, member) \
+ for (n = list_entry(pos->member.next, typeof(*pos), member); \
+ &pos->member != (head); \
+ pos = n, n = list_entry(n->member.next, typeof(*n), member))
+
+/**
+ * list_for_each_entry_safe_reverse - iterate backwards over list safe against removal
+ * @pos: the type * to use as a loop cursor.
+ * @n: another type * to use as temporary storage
+ * @head: the head for your list.
+ * @member: the name of the list_struct within the struct.
+ *
+ * Iterate backwards over list of given type, safe against removal
+ * of list entry.
+ */
+#define list_for_each_entry_safe_reverse(pos, n, head, member) \
+ for (pos = list_entry((head)->prev, typeof(*pos), member), \
+ n = list_entry(pos->member.prev, typeof(*pos), member); \
+ &pos->member != (head); \
+ pos = n, n = list_entry(n->member.prev, typeof(*n), member))
+
+/**
+ * list_safe_reset_next - reset a stale list_for_each_entry_safe loop
+ * @pos: the loop cursor used in the list_for_each_entry_safe loop
+ * @n: temporary storage used in list_for_each_entry_safe
+ * @member: the name of the list_struct within the struct.
+ *
+ * list_safe_reset_next is not safe to use in general if the list may be
+ * modified concurrently (eg. the lock is dropped in the loop body). An
+ * exception to this is if the cursor element (pos) is pinned in the list,
+ * and list_safe_reset_next is called after re-taking the lock and before
+ * completing the current iteration of the loop body.
+ */
+#define list_safe_reset_next(pos, n, member) \
+ n = list_entry(pos->member.next, typeof(*pos), member)
+
+#endif /* _LINUX_LIST_H */
diff --git a/fence/agents/kdump/message.h b/fence/agents/kdump/message.h
new file mode 100644
index 0000000..2c82229
--- /dev/null
+++ b/fence/agents/kdump/message.h
@@ -0,0 +1,41 @@
+/* -*- mode: C; c-basic-offset: 4; indent-tabs-mode: nil -*-
+ *
+ * Copyright (c) Ryan O'Hara (rohara at redhat.com)
+ * Copyright (c) Red Hat, Inc.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ *
+ */
+
+#ifndef _FENCE_KDUMP_MESSAGE_H
+#define _FENCE_KDUMP_MESSAGE_H
+
+#define FENCE_KDUMP_MAGIC 0x1B302A40
+
+#define FENCE_KDUMP_MSGV1 0x1
+
+typedef struct __attribute__ ((packed)) fence_kdump_msg {
+ uint32_t magic;
+ uint32_t version;
+} fence_kdump_msg_t;
+
+static inline void
+init_message (fence_kdump_msg_t *msg)
+{
+ msg->magic = FENCE_KDUMP_MAGIC;
+ msg->version = FENCE_KDUMP_MSGV1;
+}
+
+#endif /* _FENCE_KDUMP_MESSAGE_H */
diff --git a/fence/agents/kdump/options.h b/fence/agents/kdump/options.h
new file mode 100644
index 0000000..10fa2a2
--- /dev/null
+++ b/fence/agents/kdump/options.h
@@ -0,0 +1,241 @@
+/* -*- mode: C; c-basic-offset: 4; indent-tabs-mode: nil -*-
+ *
+ * Copyright (c) Ryan O'Hara (rohara at redhat.com)
+ * Copyright (c) Red Hat, Inc.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ *
+ */
+
+#ifndef _FENCE_KDUMP_OPTIONS_H
+#define _FENCE_KDUMP_OPTIONS_H
+
+#include "list.h"
+
+#define FENCE_KDUMP_NAME_LEN 256
+#define FENCE_KDUMP_ADDR_LEN 46
+#define FENCE_KDUMP_PORT_LEN 6
+
+enum {
+ FENCE_KDUMP_ACTION_OFF = 0,
+ FENCE_KDUMP_ACTION_ON = 1,
+ FENCE_KDUMP_ACTION_REBOOT = 2,
+ FENCE_KDUMP_ACTION_STATUS = 3,
+ FENCE_KDUMP_ACTION_LIST = 4,
+ FENCE_KDUMP_ACTION_MONITOR = 5,
+ FENCE_KDUMP_ACTION_METADATA = 6,
+};
+
+enum {
+ FENCE_KDUMP_FAMILY_AUTO = AF_UNSPEC,
+ FENCE_KDUMP_FAMILY_IPV6 = AF_INET6,
+ FENCE_KDUMP_FAMILY_IPV4 = AF_INET,
+};
+
+#define FENCE_KDUMP_DEFAULT_IPPORT 7410
+#define FENCE_KDUMP_DEFAULT_FAMILY 0
+#define FENCE_KDUMP_DEFAULT_ACTION 0
+#define FENCE_KDUMP_DEFAULT_COUNT 0
+#define FENCE_KDUMP_DEFAULT_INTERVAL 10
+#define FENCE_KDUMP_DEFAULT_TIMEOUT 60
+#define FENCE_KDUMP_DEFAULT_VERBOSE 0
+
+typedef struct fence_kdump_opts {
+ char *nodename;
+ int ipport;
+ int family;
+ int action;
+ int count;
+ int interval;
+ int timeout;
+ int verbose;
+ struct list_head nodes;
+} fence_kdump_opts_t;
+
+typedef struct fence_kdump_node {
+ char name[FENCE_KDUMP_NAME_LEN];
+ char addr[FENCE_KDUMP_ADDR_LEN];
+ char port[FENCE_KDUMP_PORT_LEN];
+ int socket;
+ struct addrinfo *info;
+ struct list_head list;
+} fence_kdump_node_t;
+
+static inline void
+init_node (fence_kdump_node_t *node)
+{
+ node->info = NULL;
+}
+
+static inline void
+free_node (fence_kdump_node_t *node)
+{
+ freeaddrinfo (node->info);
+ free (node);
+}
+
+static inline void
+print_node (const fence_kdump_node_t *node)
+{
+ fprintf (stdout, "[debug]: node { \n");
+ fprintf (stdout, "[debug]: name = %s\n", node->name);
+ fprintf (stdout, "[debug]: addr = %s\n", node->addr);
+ fprintf (stdout, "[debug]: port = %s\n", node->port);
+ fprintf (stdout, "[debug]: info = %p\n", node->info);
+ fprintf (stdout, "[debug]: } \n");
+}
+
+static inline void
+init_options (fence_kdump_opts_t *opts)
+{
+ opts->nodename = NULL;
+ opts->ipport = FENCE_KDUMP_DEFAULT_IPPORT;
+ opts->family = FENCE_KDUMP_DEFAULT_FAMILY;
+ opts->action = FENCE_KDUMP_DEFAULT_ACTION;
+ opts->count = FENCE_KDUMP_DEFAULT_COUNT;
+ opts->interval = FENCE_KDUMP_DEFAULT_INTERVAL;
+ opts->timeout = FENCE_KDUMP_DEFAULT_TIMEOUT;
+ opts->verbose = FENCE_KDUMP_DEFAULT_VERBOSE;
+
+ INIT_LIST_HEAD (&opts->nodes);
+}
+
+static inline void
+free_options (fence_kdump_opts_t *opts)
+{
+ fence_kdump_node_t *node;
+ fence_kdump_node_t *safe;
+
+ list_for_each_entry_safe (node, safe, &opts->nodes, list) {
+ list_del (&node->list);
+ free_node (node);
+ }
+
+ free (opts->nodename);
+}
+
+static inline void
+print_options (fence_kdump_opts_t *opts)
+{
+ fence_kdump_node_t *node;
+
+ fprintf (stdout, "[debug]: options { \n");
+ fprintf (stdout, "[debug]: nodename = %s\n", opts->nodename);
+ fprintf (stdout, "[debug]: ipport = %d\n", opts->ipport);
+ fprintf (stdout, "[debug]: family = %d\n", opts->family);
+ fprintf (stdout, "[debug]: count = %d\n", opts->count);
+ fprintf (stdout, "[debug]: interval = %d\n", opts->interval);
+ fprintf (stdout, "[debug]: timeout = %d\n", opts->timeout);
+ fprintf (stdout, "[debug]: verbose = %d\n", opts->verbose);
+ fprintf (stdout, "[debug]: } \n");
+
+ list_for_each_entry (node, &opts->nodes, list) {
+ print_node (node);
+ }
+}
+
+static inline void
+set_option_nodename (fence_kdump_opts_t *opts, const char *arg)
+{
+ if (opts->nodename != NULL) {
+ free (opts->nodename);
+ }
+
+ opts->nodename = strdup (arg);
+}
+
+static inline void
+set_option_ipport (fence_kdump_opts_t *opts, const char *arg)
+{
+ opts->ipport = atoi (arg);
+
+ if ((opts->ipport < 1) || (opts->ipport > 65535)) {
+ fprintf (stderr, "[error]: invalid ipport '%s'\n", arg);
+ exit (1);
+ }
+}
+
+static inline void
+set_option_family (fence_kdump_opts_t *opts, const char *arg)
+{
+ if (!strcasecmp (arg, "auto")) {
+ opts->family = FENCE_KDUMP_FAMILY_AUTO;
+ } else if (!strcasecmp (arg, "ipv6")) {
+ opts->family = FENCE_KDUMP_FAMILY_IPV6;
+ } else if (!strcasecmp (arg, "ipv4")) {
+ opts->family = FENCE_KDUMP_FAMILY_IPV4;
+ } else {
+ fprintf (stderr, "[error]: unsupported family '%s'\n", arg);
+ exit (1);
+ }
+}
+
+static inline void
+set_option_action (fence_kdump_opts_t *opts, const char *arg)
+{
+ if (!strcasecmp (arg, "off")) {
+ opts->action = FENCE_KDUMP_ACTION_OFF;
+ } else if (!strcasecmp (arg, "metadata")) {
+ opts->action = FENCE_KDUMP_ACTION_METADATA;
+ } else {
+ fprintf (stderr, "[error]: unsupported action '%s'\n", arg);
+ exit (1);
+ }
+}
+
+static inline void
+set_option_count (fence_kdump_opts_t *opts, const char *arg)
+{
+ opts->count = atoi (arg);
+
+ if (opts->count < 0) {
+ fprintf (stderr, "[error]: invalid count '%s'\n", arg);
+ exit (1);
+ }
+}
+
+static inline void
+set_option_interval (fence_kdump_opts_t *opts, const char *arg)
+{
+ opts->interval = atoi (arg);
+
+ if (opts->interval < 1) {
+ fprintf (stderr, "[error]: invalid interval '%s'\n", arg);
+ exit (1);
+ }
+}
+
+static inline void
+set_option_timeout (fence_kdump_opts_t *opts, const char *arg)
+{
+ opts->timeout = atoi (arg);
+
+ if (opts->timeout < 1) {
+ fprintf (stderr, "[error]: invalid timeout '%s'\n", arg);
+ exit (1);
+ }
+}
+
+static inline void
+set_option_verbose (fence_kdump_opts_t *opts, const char *arg)
+{
+ if (arg != NULL) {
+ opts->verbose = atoi (arg);
+ } else {
+ opts->verbose += 1;
+ }
+}
+
+#endif /* _FENCE_KDUMP_OPTIONS_H */
diff --git a/fence/agents/kdump/version.h b/fence/agents/kdump/version.h
new file mode 100644
index 0000000..ed178b1
--- /dev/null
+++ b/fence/agents/kdump/version.h
@@ -0,0 +1,33 @@
+/* -*- mode: C; c-basic-offset: 4; indent-tabs-mode: nil -*-
+ *
+ * Copyright (c) Ryan O'Hara (rohara at redhat.com)
+ * Copyright (c) Red Hat, Inc.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ *
+ */
+
+#ifndef _FENCE_KDUMP_VERSION_H
+#define _FENCE_KDUMP_VERSION_H
+
+#define FENCE_KDUMP_VERSION "0.1"
+
+static inline void
+print_version (const char *self)
+{
+ fprintf (stdout, "%s %s\n", basename (self), FENCE_KDUMP_VERSION);
+}
+
+#endif /* _FENCE_KDUMP_VERSION_H */
diff --git a/fence/agents/ldom/Makefile.am b/fence/agents/ldom/Makefile.am
new file mode 100644
index 0000000..a229934
--- /dev/null
+++ b/fence/agents/ldom/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_ldom
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/ldom/fence_ldom.py b/fence/agents/ldom/fence_ldom.py
new file mode 100644
index 0000000..722bfda
--- /dev/null
+++ b/fence/agents/ldom/fence_ldom.py
@@ -0,0 +1,118 @@
+#!/usr/bin/python
+
+##
+## The Following Agent Has Been Tested On - LDOM 1.0.3
+## The interface is backward compatible so it will work
+## with 1.0, 1.0.1 and .2 too.
+##
+#####
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="Logical Domains (LDoms) fence Agent"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+COMMAND_PROMPT_REG = "\[PEXPECT\]$"
+COMMAND_PROMPT_NEW = "[PEXPECT]"
+
+# Start comunicating after login. Prepare good environment.
+def start_communication(conn, options):
+ conn.send_eol ("PS1='"+COMMAND_PROMPT_NEW+"'")
+ res = conn.expect([pexpect.TIMEOUT, COMMAND_PROMPT_REG], int(options["--shell-timeout"]))
+ if res == 0:
+ #CSH stuff
+ conn.send_eol("set prompt='"+COMMAND_PROMPT_NEW+"'")
+ conn.log_expect(options, COMMAND_PROMPT_REG, int(options["--shell-timeout"]))
+
+
+def get_power_status(conn, options):
+ start_communication(conn, options)
+
+ conn.send_eol("ldm ls")
+
+ conn.log_expect(options, COMMAND_PROMPT_REG, int(options["--shell-timeout"]))
+
+ result = {}
+
+ #This is status of mini finite automata. 0 = we didn't found NAME and STATE, 1 = we did
+ fa_status = 0
+
+ for line in conn.before.splitlines():
+ domain = re.search("^(\S+)\s+(\S+)\s+.*$", line)
+
+ if (domain!=None):
+ if ((fa_status==0) and (domain.group(1)=="NAME") and (domain.group(2)=="STATE")):
+ fa_status = 1
+ elif (fa_status==1):
+ result[domain.group(1)] = ("", (domain.group(2).lower()=="bound" and "off" or "on"))
+
+ if (not (options["--action"] in ['monitor','list'])):
+ if (not (options["--plug"] in result)):
+ fail_usage("Failed: You have to enter existing logical domain!")
+ else:
+ return result[options["--plug"]][1]
+ else:
+ return result
+
+def set_power_status(conn, options):
+ start_communication(conn, options)
+
+ cmd_line = "ldm "+(options["--action"]=="on" and "start" or "stop -f")+" \""+options["--plug"]+"\""
+
+ conn.send_eol(cmd_line)
+
+ conn.log_expect(options, COMMAND_PROMPT_REG, int(options["--power-timeout"]))
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "cmd_prompt", "secure", "port" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["secure"]["default"] = "1"
+ all_opt["cmd_prompt"]["default"] = [ "\ $" ]
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for Sun LDOM"
+ docs["longdesc"] = "fence_ldom is an I/O Fencing agent \
+which can be used with LDoms virtual machines. This agent works \
+so, that run ldm command on host machine. So ldm must be directly \
+runnable.\
+\n.P\n\
+Very useful parameter is -c (or cmd_prompt in stdin mode). This \
+must be set to something, what is displayed after successful login \
+to host machine. Default string is space on end of string (default \
+for root in bash). But (for example) csh use ], so in that case you \
+must use parameter -c with argument ]. Very similar situation is, \
+if you use bash and login to host machine with other user than \
+root. Than prompt is $, so again, you must use parameter -c."
+ docs["vendorurl"] = "http://www.sun.com"
+ show_docs(options, docs)
+
+ ##
+ ## Operate the fencing device
+ ####
+ conn = fence_login(options)
+ result = fence_action(conn, options, set_power_status, get_power_status, get_power_status)
+
+ ##
+ ## Logout from system
+ ######
+ try:
+ conn.send_eol("logout")
+ conn.close()
+ except exceptions.OSError:
+ pass
+ except pexpect.ExceptionPexpect:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/lib/Makefile.am b/fence/agents/lib/Makefile.am
new file mode 100644
index 0000000..4cf4b9f
--- /dev/null
+++ b/fence/agents/lib/Makefile.am
@@ -0,0 +1,28 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fencing.py fencing_snmp.py
+
+if BUILD_XENAPILIB
+TARGET += XenAPI.py
+endif
+
+SRC = fencing.py.py fencing_snmp.py.py XenAPI.py.py check_used_options.py
+
+XSL = fence2man.xsl fence2rng.xsl
+
+FASRNG = fence.rng.head fence.rng.tail metadata.rng
+
+EXTRA_DIST = $(SRC) $(XSL) $(FASRNG)
+
+fencelibdir = ${FENCEAGENTSLIBDIR}
+
+fencelib_DATA = $(TARGET)
+
+rngdir = ${CLUSTERDATA}/relaxng
+
+rng_DATA = $(XSL) $(FASRNG)
+
+include $(top_srcdir)/make/fencebuild.mk
+
+clean-local:
+ rm -f $(TARGET) *.pyc
diff --git a/fence/agents/lib/XenAPI.py.py b/fence/agents/lib/XenAPI.py.py
new file mode 100644
index 0000000..ce905fd
--- /dev/null
+++ b/fence/agents/lib/XenAPI.py.py
@@ -0,0 +1,209 @@
+#============================================================================
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of version 2.1 of the GNU Lesser General Public
+# License as published by the Free Software Foundation.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+#============================================================================
+# Copyright (C) 2006 XenSource Inc.
+#============================================================================
+#
+# Parts of this file are based upon xmlrpclib.py, the XML-RPC client
+# interface included in the Python distribution.
+#
+# Copyright (c) 1999-2002 by Secret Labs AB
+# Copyright (c) 1999-2002 by Fredrik Lundh
+#
+# By obtaining, using, and/or copying this software and/or its
+# associated documentation, you agree that you have read, understood,
+# and will comply with the following terms and conditions:
+#
+# Permission to use, copy, modify, and distribute this software and
+# its associated documentation for any purpose and without fee is
+# hereby granted, provided that the above copyright notice appears in
+# all copies, and that both that copyright notice and this permission
+# notice appear in supporting documentation, and that the name of
+# Secret Labs AB or the author not be used in advertising or publicity
+# pertaining to distribution of the software without specific, written
+# prior permission.
+#
+# SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
+# TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT-
+# ABILITY AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR
+# BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY
+# DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
+# WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
+# ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
+# OF THIS SOFTWARE.
+# --------------------------------------------------------------------
+
+import gettext
+import xmlrpclib
+import httplib
+import socket
+
+translation = gettext.translation('xen-xm', fallback = True)
+
+class Failure(Exception):
+ def __init__(self, details):
+ try:
+ # If this failure is MESSAGE_PARAMETER_COUNT_MISMATCH, then we
+ # correct the return values here, to account for the fact that we
+ # transparently add the session handle as the first argument.
+ if details[0] == 'MESSAGE_PARAMETER_COUNT_MISMATCH':
+ details[2] = str(int(details[2]) - 1)
+ details[3] = str(int(details[3]) - 1)
+
+ self.details = details
+ except Exception, exn:
+ self.details = ['INTERNAL_ERROR', 'Client-side: ' + str(exn)]
+
+ def __str__(self):
+ try:
+ return translation.ugettext(self.details[0]) % self._details_map()
+ except TypeError, exn:
+ return "Message database broken: %s.\nXen-API failure: %s" % \
+ (exn, str(self.details))
+ except Exception, exn:
+ import sys
+ print >> sys.stderr, exn
+ return "Xen-API failure: %s" % str(self.details)
+
+ def _details_map(self):
+ return dict([(str(i), self.details[i])
+ for i in range(len(self.details))])
+
+
+_RECONNECT_AND_RETRY = (lambda _ : ())
+
+class UDSHTTPConnection(httplib.HTTPConnection):
+ """ Stupid hacked up HTTPConnection subclass to allow HTTP over Unix domain
+ sockets. """
+ def connect(self):
+ path = self.host.replace("_", "/")
+ self.sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
+ self.sock.connect(path)
+
+class UDSHTTP(httplib.HTTP):
+ _connection_class = UDSHTTPConnection
+
+class UDSTransport(xmlrpclib.Transport):
+ def make_connection(self, host):
+ return UDSHTTP(host)
+
+class Session(xmlrpclib.ServerProxy):
+ """A server proxy and session manager for communicating with Xend using
+ the Xen-API.
+
+ Example:
+
+ session = Session('http://localhost:9363/')
+ session.login_with_password('me', 'mypassword')
+ session.xenapi.VM.start(vm_uuid)
+ session.xenapi.session.logout()
+
+ For now, this class also supports the legacy XML-RPC API, using
+ session.xend.domain('Domain-0') and similar. This support will disappear
+ once there is a working Xen-API replacement for every call in the legacy
+ API.
+ """
+
+ def __init__(self, uri, transport=None, encoding=None, verbose=0,
+ allow_none=1):
+ xmlrpclib.ServerProxy.__init__(self, uri, transport, encoding,
+ verbose, allow_none)
+ self._session = None
+ self.last_login_method = None
+ self.last_login_params = None
+
+
+ def xenapi_request(self, methodname, params):
+ if methodname.startswith('login'):
+ self._login(methodname, params)
+ return None
+ else:
+ retry_count = 0
+ while retry_count < 3:
+ full_params = (self._session,) + params
+ result = _parse_result(getattr(self, methodname)(*full_params))
+ if result == _RECONNECT_AND_RETRY:
+ retry_count += 1
+ if self.last_login_method:
+ self._login(self.last_login_method,
+ self.last_login_params)
+ else:
+ raise xmlrpclib.Fault(401, 'You must log in')
+ else:
+ return result
+ raise xmlrpclib.Fault(
+ 500, 'Tried 3 times to get a valid session, but failed')
+
+
+ def _login(self, method, params):
+ result = _parse_result(getattr(self, 'session.%s' % method)(*params))
+ if result == _RECONNECT_AND_RETRY:
+ raise xmlrpclib.Fault(
+ 500, 'Received SESSION_INVALID when logging in')
+ self._session = result
+ self.last_login_method = method
+ self.last_login_params = params
+
+
+ def __getattr__(self, name):
+ if name == 'xenapi':
+ return _Dispatcher(self.xenapi_request, None)
+ elif name.startswith('login'):
+ return lambda *params: self._login(name, params)
+ else:
+ return xmlrpclib.ServerProxy.__getattr__(self, name)
+
+def xapi_local():
+ return Session("http://_var_xapi_xapi/", transport=UDSTransport())
+
+def _parse_result(result):
+ if type(result) != dict or 'Status' not in result:
+ raise xmlrpclib.Fault(500, 'Missing Status in response from server' + result)
+ if result['Status'] == 'Success':
+ if 'Value' in result:
+ return result['Value']
+ else:
+ raise xmlrpclib.Fault(500,
+ 'Missing Value in response from server')
+ else:
+ if 'ErrorDescription' in result:
+ if result['ErrorDescription'][0] == 'SESSION_INVALID':
+ return _RECONNECT_AND_RETRY
+ else:
+ raise Failure(result['ErrorDescription'])
+ else:
+ raise xmlrpclib.Fault(
+ 500, 'Missing ErrorDescription in response from server')
+
+
+# Based upon _Method from xmlrpclib.
+class _Dispatcher:
+ def __init__(self, send, name):
+ self.__send = send
+ self.__name = name
+
+ def __repr__(self):
+ if self.__name:
+ return '<XenAPI._Dispatcher for %s>' % self.__name
+ else:
+ return '<XenAPI._Dispatcher>'
+
+ def __getattr__(self, name):
+ if self.__name is None:
+ return _Dispatcher(self.__send, name)
+ else:
+ return _Dispatcher(self.__send, "%s.%s" % (self.__name, name))
+
+ def __call__(self, *args):
+ return self.__send(self.__name, args)
diff --git a/fence/agents/lib/check_used_options.py b/fence/agents/lib/check_used_options.py
new file mode 100755
index 0000000..2d75756
--- /dev/null
+++ b/fence/agents/lib/check_used_options.py
@@ -0,0 +1,65 @@
+#!/usr/bin/python
+
+## Check if fence agent uses only options["--??"] which are defined in fencing library or
+## fence agent itself
+##
+## Usage: ./check_used_options.py fence-agent (e.g. lpar/fence_lpar.py)
+##
+
+import sys, re
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import all_opt
+
+def main():
+ agent = sys.argv[1]
+
+ available = { }
+
+ ## all_opt from fencing library are imported
+ for k in all_opt.keys():
+ if all_opt[k].has_key("longopt"):
+ available["--" + all_opt[k]["longopt"]] = True
+
+ ## add UUID which is derived automatically from --plug if possible
+ available["--uuid"] = True
+
+ ## all_opt defined in fence agent are found
+ agent_file = open(agent)
+ opt_re = re.compile("\s*all_opt\[\"([^\"]*)\"\] = {")
+ opt_longopt_re = re.compile("\s*\"longopt\" : \"([^\"]*)\"")
+
+ in_opt = False
+ for line in agent_file:
+ if opt_re.search(line) != None:
+ in_opt = True
+ if in_opt and opt_longopt_re.search(line) != None:
+ available["--" + opt_longopt_re.search(line).group(1)] = True
+ in_opt = False
+
+ ## check if all options are defined
+ agent_file = open(agent)
+ option_use_re = re.compile("options\[\"(--[^\"]*)\"\]")
+ option_has_re = re.compile("options.has_key\(\"(--[^\"]*)\"\)")
+
+ counter = 0
+ without_errors = True
+ for line in agent_file:
+ counter += 1
+
+ for x in option_use_re.findall(line):
+ if not available.has_key(x):
+ print "ERROR on line %d in %s: option %s is not defined" % (counter, agent, option_use_re.search(line).group(1))
+ without_errors = False
+
+ for x in option_has_re.findall(line):
+ if not available.has_key(x):
+ print "ERROR on line %d in %s: option %s is not defined" % (counter, agent, option_has_re.search(line).group(1))
+ without_errors = False
+
+ if without_errors:
+ sys.exit(0)
+ else:
+ sys.exit(1)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/lib/fence.rng.head b/fence/agents/lib/fence.rng.head
new file mode 100644
index 0000000..22f4452
--- /dev/null
+++ b/fence/agents/lib/fence.rng.head
@@ -0,0 +1,7 @@
+<!-- Autogenerated fence definitions -->
+ <define name="FENCEDEVICEOPTIONS">
+ <optional>
+ <choice>
+ <!-- begin specific fence devices -->
+
+ <!-- begin auto-generated device definitions -->
diff --git a/fence/agents/lib/fence.rng.tail b/fence/agents/lib/fence.rng.tail
new file mode 100644
index 0000000..2feab91
--- /dev/null
+++ b/fence/agents/lib/fence.rng.tail
@@ -0,0 +1,13 @@
+ <!-- end auto-generated device definitions -->
+
+ <group>
+ <optional>
+ <empty/>
+ </optional>
+ </group>
+
+ <!-- end specific fence devices -->
+ </choice>
+ </optional>
+ </define>
+<!-- end fence attribute group definitions -->
diff --git a/fence/agents/lib/fence2man.xsl b/fence/agents/lib/fence2man.xsl
new file mode 100644
index 0000000..13e24da
--- /dev/null
+++ b/fence/agents/lib/fence2man.xsl
@@ -0,0 +1,59 @@
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+<xsl:output method="text" indent="no"/>
+<xsl:template match="parameter">
+<xsl:param name="show" />
+.TP
+<xsl:if test="$show = 'getopt'">.B <xsl:value-of select="getopt/@mixed" /></xsl:if>
+<xsl:if test="$show = 'stdin'">.B <xsl:value-of select="@name"/></xsl:if>
+.
+<xsl:value-of select="normalize-space(shortdesc)"/>
+<xsl:if test="not(content/@default)"><xsl:if test="@required = 1"> This parameter is always required.</xsl:if></xsl:if>
+<xsl:if test="content/@default"> (Default Value: <xsl:value-of select="content/@default"/>)</xsl:if>
+</xsl:template>
+
+<xsl:template match="action">
+.TP
+\fB<xsl:value-of select="@name"/> \fP
+<xsl:choose>
+<xsl:when test="@name = 'on'">Power on machine.</xsl:when>
+<xsl:when test="@name = 'off'">Power off machine.</xsl:when>
+<xsl:when test="@name = 'enable'">Enable fabric access.</xsl:when>
+<xsl:when test="@name = 'disable'">Disable fabric access.</xsl:when>
+<xsl:when test="@name = 'reboot'">Reboot machine.</xsl:when>
+<xsl:when test="@name = 'monitor'">Check the health of fence device</xsl:when>
+<xsl:when test="@name = 'metadata'">Display the XML metadata describing this resource.</xsl:when>
+<xsl:when test="@name = 'list'">List available plugs with aliases/virtual machines if there is support for more then one device. Returns N/A otherwise.</xsl:when>
+<xsl:when test="@name = 'status'">This returns the status of the plug/virtual machine.</xsl:when>
+<!-- Ehhh -->
+<xsl:otherwise> The operational behavior of this is not known.</xsl:otherwise>
+</xsl:choose>
+</xsl:template>
+
+<xsl:template match="/resource-agent">
+.TH FENCE_AGENT 8 2009-10-20 "<xsl:value-of select="@name"/> (Fence Agent)"
+.SH NAME
+<xsl:value-of select="@name" /> - <xsl:value-of select="@shortdesc" />
+<xsl:for-each select="symlink">
+.P
+<xsl:value-of select="@name" /> - <xsl:value-of select="@shortdesc" /> (symlink)
+</xsl:for-each>
+.SH DESCRIPTION
+.P
+<xsl:value-of select="longdesc"/>
+.P
+<xsl:value-of select="@name" /> accepts options on the command line as well
+as from stdin. Fenced sends parameters through stdin when it execs the
+agent. <xsl:value-of select="@name" /> can be run by itself with command
+line options. This is useful for testing and for turning outlets on or off
+from scripts.
+<xsl:if test="vendor-url">
+Vendor URL: <xsl:value-of select="vendor-url" />
+</xsl:if>
+.SH PARAMETERS
+<xsl:apply-templates select="parameters"><xsl:with-param name="show">getopt</xsl:with-param></xsl:apply-templates>
+.SH ACTIONS
+<xsl:apply-templates select="actions"/>
+.SH STDIN PARAMETERS
+<xsl:apply-templates select="parameters"><xsl:with-param name="show">stdin</xsl:with-param></xsl:apply-templates>
+</xsl:template>
+</xsl:stylesheet>
diff --git a/fence/agents/lib/fence2rng.xsl b/fence/agents/lib/fence2rng.xsl
new file mode 100644
index 0000000..432bc89
--- /dev/null
+++ b/fence/agents/lib/fence2rng.xsl
@@ -0,0 +1,161 @@
+<xsl:stylesheet version="1.0"
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+<xsl:output method="text" indent="no"/>
+
+<xsl:param name="init-indent" select="' '"/>
+<xsl:param name="indent" select="' '"/>
+
+
+<!--
+ helpers
+ -->
+
+<xsl:variable name="SP" select="' '"/>
+<xsl:variable name="NL" select="'
'"/>
+<xsl:variable name="Q" select="'"'"/>
+<xsl:variable name="TS" select="'<'"/>
+<xsl:variable name="TSc" select="'</'"/>
+<xsl:variable name="TE" select="'>'"/>
+<xsl:variable name="TEc" select="'/>'"/>
+
+<xsl:template name="comment">
+ <xsl:param name="text" select="''"/>
+ <xsl:param name="indent" select="''"/>
+ <xsl:if test="$indent != 'none'">
+ <xsl:value-of select="concat($init-indent, $indent)"/>
+ </xsl:if>
+ <xsl:value-of select="concat($TS, '!-- ', $text, ' --',$TE)"/>
+</xsl:template>
+
+<xsl:template name="tag-start">
+ <xsl:param name="name"/>
+ <xsl:param name="attrs" select="''"/>
+ <xsl:param name="indent" select="''"/>
+ <xsl:if test="$indent != 'none'">
+ <xsl:value-of select="concat($init-indent, $indent)"/>
+ </xsl:if>
+ <xsl:value-of select="concat($TS, $name)"/>
+ <xsl:if test="$attrs != ''">
+ <xsl:value-of select="concat($SP, $attrs)"/>
+ </xsl:if>
+ <xsl:value-of select="$TE"/>
+</xsl:template>
+
+<xsl:template name="tag-end">
+ <xsl:param name="name"/>
+ <xsl:param name="attrs" select="''"/>
+ <xsl:param name="indent" select="''"/>
+ <xsl:if test="$indent != 'none'">
+ <xsl:value-of select="concat($init-indent, $indent)"/>
+ </xsl:if>
+ <xsl:value-of select="concat($TSc, $name)"/>
+ <xsl:if test="$attrs != ''">
+ <xsl:value-of select="concat($SP, $attrs)"/>
+ </xsl:if>
+ <xsl:value-of select="$TE"/>
+</xsl:template>
+
+<xsl:template name="tag-self">
+ <xsl:param name="name"/>
+ <xsl:param name="attrs" select="''"/>
+ <xsl:param name="indent" select="''"/>
+ <xsl:if test="$indent != 'none'">
+ <xsl:value-of select="concat($init-indent, $indent)"/>
+ </xsl:if>
+ <xsl:value-of select="concat($TS, $name)"/>
+ <xsl:if test="$attrs != ''">
+ <xsl:value-of select="concat($SP, $attrs)"/>
+ </xsl:if>
+ <xsl:value-of select="$TEc"/>
+</xsl:template>
+
+
+<!--
+ proceed
+ -->
+
+<xsl:template match="/resource-agent">
+ <xsl:value-of select="$NL"/>
+
+ <!-- (comment denoting the fence agent name) -->
+ <xsl:call-template name="comment">
+ <xsl:with-param name="text" select="@name"/>
+ </xsl:call-template>
+ <xsl:value-of select="$NL"/>
+
+ <!-- group rha:name=... rha:description=... (start) -->
+ <xsl:call-template name="tag-start">
+ <xsl:with-param name="name" select="'group'"/>
+ <xsl:with-param name="attrs" select="concat(
+ 'rha:name=', $Q, @name, $Q, $SP,
+ 'rha:description=', $Q, @shortdesc, $Q)"/>
+ </xsl:call-template>
+ <xsl:value-of select="$NL"/>
+
+ <!-- optional (start) -->
+ <xsl:call-template name="tag-start">
+ <xsl:with-param name="name" select="'optional'"/>
+ <xsl:with-param name="indent" select="$indent"/>
+ </xsl:call-template>
+ <xsl:value-of select="$NL"/>
+
+ <!-- attribute name="option" -->
+ <xsl:call-template name="tag-self">
+ <xsl:with-param name="name" select="'attribute'"/>
+ <xsl:with-param name="attrs" select="concat(
+ 'name=', $Q, 'option', $Q)"/>
+ <xsl:with-param name="indent" select="concat($indent, $indent)"/>
+ </xsl:call-template>
+ <xsl:value-of select="$SP"/>
+ <!-- (comment mentioning that "option" is deprecated) -->
+ <xsl:call-template name="comment">
+ <xsl:with-param name="text">
+ <xsl:text>deprecated; for compatibility. use "action"</xsl:text>
+ </xsl:with-param>
+ <xsl:with-param name="indent" select="'none'"/>
+ </xsl:call-template>
+ <xsl:value-of select="$NL"/>
+
+ <!-- optional (end) -->
+ <xsl:call-template name="tag-end">
+ <xsl:with-param name="name" select="'optional'"/>
+ <xsl:with-param name="indent" select="$indent"/>
+ </xsl:call-template>
+ <xsl:value-of select="$NL"/>
+
+ <xsl:for-each select="parameters/parameter">
+ <!-- optional (start) -->
+ <xsl:call-template name="tag-start">
+ <xsl:with-param name="name" select="'optional'"/>
+ <xsl:with-param name="indent" select="$indent"/>
+ </xsl:call-template>
+ <xsl:value-of select="$NL"/>
+
+ <!-- attribute name=... rha:description=... -->
+ <xsl:call-template name="tag-self">
+ <xsl:with-param name="name" select="'attribute'"/>
+ <xsl:with-param name="attrs" select="concat(
+ 'name=', $Q, @name, $Q, $SP,
+ 'rha:description=', $Q, normalize-space(shortdesc), $Q, $SP)"/>
+ <xsl:with-param name="indent" select="concat($indent, $indent)"/>
+ </xsl:call-template>
+ <xsl:value-of select="$NL"/>
+
+ <!-- optional (end) -->
+ <xsl:call-template name="tag-end">
+ <xsl:with-param name="name" select="'optional'"/>
+ <xsl:with-param name="indent" select="$indent"/>
+ </xsl:call-template>
+ <xsl:value-of select="$NL"/>
+ </xsl:for-each>
+
+ <!-- group rha:name=... rha:description=... (end) -->
+ <xsl:call-template name="tag-end">
+ <xsl:with-param name="name" select="'group'"/>
+ </xsl:call-template>
+ <xsl:value-of select="$NL"/>
+
+ <xsl:value-of select="$NL"/>
+</xsl:template>
+
+</xsl:stylesheet>
diff --git a/fence/agents/lib/fencing.py.py b/fence/agents/lib/fencing.py.py
new file mode 100644
index 0000000..798f855
--- /dev/null
+++ b/fence/agents/lib/fencing.py.py
@@ -0,0 +1,1077 @@
+#!/usr/bin/python
+
+import sys, getopt, time, os, uuid, pycurl, stat
+import pexpect, re, atexit, syslog
+import __main__
+
+## do not add code here.
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION = "New fence lib agent - test release on steroids"
+REDHAT_COPYRIGHT = ""
+BUILD_DATE = "March, 2008"
+#END_VERSION_GENERATION
+
+LOG_MODE_VERBOSE = 100
+LOG_MODE_QUIET = 0
+
+EC_GENERIC_ERROR = 1
+EC_BAD_ARGS = 2
+EC_LOGIN_DENIED = 3
+EC_CONNECTION_LOST = 4
+EC_TIMED_OUT = 5
+EC_WAITING_ON = 6
+EC_WAITING_OFF = 7
+EC_STATUS = 8
+EC_STATUS_HMC = 9
+EC_PASSWORD_MISSING = 10
+EC_INVALID_PRIVILEGES = 11
+
+TELNET_PATH = "/usr/bin/telnet"
+SSH_PATH = "/usr/bin/ssh"
+SSL_PATH = "@GNUTLSCLI_PATH@"
+SUDO_PATH = "/usr/bin/sudo"
+
+all_opt = {
+ "help" : {
+ "getopt" : "h",
+ "longopt" : "help",
+ "help" : "-h, --help Display this help and exit",
+ "required" : "0",
+ "shortdesc" : "Display help and exit",
+ "order" : 54 },
+ "version" : {
+ "getopt" : "V",
+ "longopt" : "version",
+ "help" : "-V, --version Output version information and exit",
+ "required" : "0",
+ "shortdesc" : "Display version information and exit",
+ "order" : 53 },
+ "verbose" : {
+ "getopt" : "v",
+ "longopt" : "verbose",
+ "help" : "-v, --verbose Verbose mode",
+ "required" : "0",
+ "shortdesc" : "Verbose mode",
+ "order" : 51 },
+ "debug" : {
+ "getopt" : "D:",
+ "longopt" : "debug-file",
+ "help" : "-D, --debug-file=[debugfile] Debugging to output file",
+ "required" : "0",
+ "shortdesc" : "Write debug information to given file",
+ "order" : 52 },
+ "delay" : {
+ "getopt" : "f:",
+ "longopt" : "delay",
+ "help" : "--delay=[seconds] Wait X seconds before fencing is started",
+ "required" : "0",
+ "shortdesc" : "Wait X seconds before fencing is started",
+ "default" : "0",
+ "order" : 200 },
+ "agent" : {
+ "getopt" : "",
+ "help" : "",
+ "order" : 1 },
+ "web" : {
+ "getopt" : "",
+ "help" : "",
+ "order" : 1 },
+ "action" : {
+ "getopt" : "o:",
+ "longopt" : "action",
+ "help" : "-o, --action=[action] Action: status, reboot (default), off or on",
+ "required" : "1",
+ "shortdesc" : "Fencing Action",
+ "default" : "reboot",
+ "order" : 1 },
+ "fabric_fencing" : {
+ "getopt" : "",
+ "help" : "",
+ "order" : 1 },
+ "ipaddr" : {
+ "getopt" : "a:",
+ "longopt" : "ip",
+ "help" : "-a, --ip=[ip] IP address or hostname of fencing device",
+ "required" : "1",
+ "shortdesc" : "IP Address or Hostname",
+ "order" : 1 },
+ "ipport" : {
+ "getopt" : "u:",
+ "longopt" : "ipport",
+ "help" : "-u, --ipport=[port] TCP/UDP port to use",
+ "required" : "0",
+ "shortdesc" : "TCP/UDP port to use for connection with device",
+ "order" : 1 },
+ "login" : {
+ "getopt" : "l:",
+ "longopt" : "username",
+ "help" : "-l, --username=[name] Login name",
+ "required" : "?",
+ "shortdesc" : "Login Name",
+ "order" : 1 },
+ "no_login" : {
+ "getopt" : "",
+ "help" : "",
+ "order" : 1 },
+ "no_password" : {
+ "getopt" : "",
+ "help" : "",
+ "order" : 1 },
+ "no_port" : {
+ "getopt" : "",
+ "help" : "",
+ "order" : 1 },
+ "passwd" : {
+ "getopt" : "p:",
+ "longopt" : "password",
+ "help" : "-p, --password=[password] Login password or passphrase",
+ "required" : "0",
+ "shortdesc" : "Login password or passphrase",
+ "order" : 1 },
+ "passwd_script" : {
+ "getopt" : "S:",
+ "longopt" : "password-script",
+ "help" : "-S, --password-script=[script] Script to run to retrieve password",
+ "required" : "0",
+ "shortdesc" : "Script to retrieve password",
+ "order" : 1 },
+ "identity_file" : {
+ "getopt" : "k:",
+ "longopt" : "identity-file",
+ "help" : "-k, --identity-file=[filename] Identity file (private key) for ssh ",
+ "required" : "0",
+ "shortdesc" : "Identity file for ssh",
+ "order" : 1 },
+ "cmd_prompt" : {
+ "getopt" : "c:",
+ "longopt" : "command-prompt",
+ "help" : "-c, --command-prompt=[prompt] Force Python regex for command prompt",
+ "shortdesc" : "Force Python regex for command prompt",
+ "required" : "0",
+ "order" : 1 },
+ "secure" : {
+ "getopt" : "x",
+ "longopt" : "ssh",
+ "help" : "-x, --ssh Use ssh connection",
+ "shortdesc" : "SSH connection",
+ "required" : "0",
+ "order" : 1 },
+ "ssh_options" : {
+ "getopt" : "X:",
+ "longopt" : "ssh-options",
+ "help" : "--ssh-options=[options] SSH options to use",
+ "shortdesc" : "SSH options to use",
+ "required" : "0",
+ "order" : 1 },
+ "ssl" : {
+ "getopt" : "z",
+ "longopt" : "ssl",
+ "help" : "-z, --ssl Use ssl connection",
+ "required" : "0",
+ "shortdesc" : "SSL connection",
+ "order" : 1 },
+ "port" : {
+ "getopt" : "n:",
+ "longopt" : "plug",
+ "help" : "-n, --plug=[id] Physical plug number on device, UUID or\n" +
+ " identification of machine",
+ "required" : "1",
+ "shortdesc" : "Physical plug number, name of virtual machine or UUID",
+ "order" : 1 },
+ "switch" : {
+ "getopt" : "s:",
+ "longopt" : "switch",
+ "help" : "-s, --switch=[id] Physical switch number on device",
+ "required" : "0",
+ "shortdesc" : "Physical switch number on device",
+ "order" : 1 },
+ "exec" : {
+ "getopt" : "e:",
+ "longopt" : "exec",
+ "help" : "-e, --exec=[command] Command to execute",
+ "required" : "0",
+ "shortdesc" : "Command to execute",
+ "order" : 1 },
+ "vmware_type" : {
+ "getopt" : "d:",
+ "longopt" : "vmware_type",
+ "help" : "-d, --vmware_type=[type] Type of VMware to connect",
+ "required" : "0",
+ "shortdesc" : "Type of VMware to connect",
+ "order" : 1 },
+ "vmware_datacenter" : {
+ "getopt" : "s:",
+ "longopt" : "vmware-datacenter",
+ "help" : "-s, --vmware-datacenter=[dc] VMWare datacenter filter",
+ "required" : "0",
+ "shortdesc" : "Show only machines in specified datacenter",
+ "order" : 2 },
+ "snmp_version" : {
+ "getopt" : "d:",
+ "longopt" : "snmp-version",
+ "help" : "-d, --snmp-version=[version] Specifies SNMP version to use",
+ "required" : "0",
+ "shortdesc" : "Specifies SNMP version to use (1,2c,3)",
+ "choices" : [ "1", "2c", "3" ],
+ "order" : 1 },
+ "community" : {
+ "getopt" : "c:",
+ "longopt" : "community",
+ "help" : "-c, --community=[community] Set the community string",
+ "required" : "0",
+ "shortdesc" : "Set the community string",
+ "order" : 1},
+ "snmp_auth_prot" : {
+ "getopt" : "b:",
+ "longopt" : "snmp-auth-prot",
+ "help" : "-b, --snmp-auth-prot=[prot] Set authentication protocol (MD5|SHA)",
+ "required" : "0",
+ "shortdesc" : "Set authentication protocol (MD5|SHA)",
+ "choices" : [ "MD5" , "SHA" ],
+ "order" : 1},
+ "snmp_sec_level" : {
+ "getopt" : "E:",
+ "longopt" : "snmp-sec-level",
+ "help" : "-E, --snmp-sec-level=[level] Set security level\n"+
+ " (noAuthNoPriv|authNoPriv|authPriv)",
+ "required" : "0",
+ "shortdesc" : "Set security level (noAuthNoPriv|authNoPriv|authPriv)",
+ "choices" : [ "noAuthNoPriv", "authNoPriv", "authPriv" ],
+ "order" : 1},
+ "snmp_priv_prot" : {
+ "getopt" : "B:",
+ "longopt" : "snmp-priv-prot",
+ "help" : "-B, --snmp-priv-prot=[prot] Set privacy protocol (DES|AES)",
+ "required" : "0",
+ "shortdesc" : "Set privacy protocol (DES|AES)",
+ "choices" : [ "DES", "AES" ],
+ "order" : 1},
+ "snmp_priv_passwd" : {
+ "getopt" : "P:",
+ "longopt" : "snmp-priv-passwd",
+ "help" : "-P, --snmp-priv-passwd=[pass] Set privacy protocol password",
+ "required" : "0",
+ "shortdesc" : "Set privacy protocol password",
+ "order" : 1},
+ "snmp_priv_passwd_script" : {
+ "getopt" : "R:",
+ "longopt" : "snmp-priv-passwd-script",
+ "help" : "-R, --snmp-priv-passwd-script Script to run to retrieve privacy password",
+ "required" : "0",
+ "shortdesc" : "Script to run to retrieve privacy password",
+ "order" : 1},
+ "inet4_only" : {
+ "getopt" : "4",
+ "longopt" : "inet4-only",
+ "help" : "-4, --inet4-only Forces agent to use IPv4 addresses only",
+ "required" : "0",
+ "shortdesc" : "Forces agent to use IPv4 addresses only",
+ "order" : 1 },
+ "inet6_only" : {
+ "getopt" : "6",
+ "longopt" : "inet6-only",
+ "help" : "-6, --inet6-only Forces agent to use IPv6 addresses only",
+ "required" : "0",
+ "shortdesc" : "Forces agent to use IPv6 addresses only",
+ "order" : 1 },
+ "separator" : {
+ "getopt" : "C:",
+ "longopt" : "separator",
+ "help" : "-C, --separator=[char] Separator for CSV created by 'list' operation",
+ "default" : ",",
+ "required" : "0",
+ "shortdesc" : "Separator for CSV created by operation list",
+ "order" : 100 },
+ "login_timeout" : {
+ "getopt" : "y:",
+ "longopt" : "login-timeout",
+ "help" : "--login-timeout=[seconds] Wait X seconds for cmd prompt after login",
+ "default" : "5",
+ "required" : "0",
+ "shortdesc" : "Wait X seconds for cmd prompt after login",
+ "order" : 200 },
+ "shell_timeout" : {
+ "getopt" : "Y:",
+ "longopt" : "shell-timeout",
+ "help" : "--shell-timeout=[seconds] Wait X seconds for cmd prompt after issuing command",
+ "default" : "3",
+ "required" : "0",
+ "shortdesc" : "Wait X seconds for cmd prompt after issuing command",
+ "order" : 200 },
+ "power_timeout" : {
+ "getopt" : "g:",
+ "longopt" : "power-timeout",
+ "help" : "--power-timeout=[seconds] Test X seconds for status change after ON/OFF",
+ "default" : "20",
+ "required" : "0",
+ "shortdesc" : "Test X seconds for status change after ON/OFF",
+ "order" : 200 },
+ "power_wait" : {
+ "getopt" : "G:",
+ "longopt" : "power-wait",
+ "help" : "--power-wait=[seconds] Wait X seconds after issuing ON/OFF",
+ "default" : "0",
+ "required" : "0",
+ "shortdesc" : "Wait X seconds after issuing ON/OFF",
+ "order" : 200 },
+ "missing_as_off" : {
+ "getopt" : "M",
+ "longopt" : "missing-as-off",
+ "help" : "--missing-as-off Missing port returns OFF instead of failure",
+ "required" : "0",
+ "shortdesc" : "Missing port returns OFF instead of failure",
+ "order" : 200 },
+ "retry_on" : {
+ "getopt" : "F:",
+ "longopt" : "retry-on",
+ "help" : "--retry-on=[attempts] Count of attempts to retry power on",
+ "default" : "1",
+ "required" : "0",
+ "shortdesc" : "Count of attempts to retry power on",
+ "order" : 201 },
+ "session_url" : {
+ "getopt" : "s:",
+ "longopt" : "session-url",
+ "help" : "-s, --session-url URL to connect to XenServer on",
+ "required" : "1",
+ "shortdesc" : "The URL of the XenServer host.",
+ "order" : 1},
+ "sudo" : {
+ "getopt" : "d",
+ "longopt" : "use-sudo",
+ "help" : "--use-sudo Use sudo (without password) when calling 3rd party software",
+ "required" : "0",
+ "shortdesc" : "Use sudo (without password) when calling 3rd party sotfware.",
+ "order" : 205},
+ "method" : {
+ "getopt" : "m:",
+ "longopt" : "method",
+ "help" : "-m, --method=[method] Method to fence (onoff|cycle) (Default: onoff)",
+ "required" : "0",
+ "shortdesc" : "Method to fence (onoff|cycle)",
+ "default" : "onoff",
+ "choices" : [ "onoff", "cycle" ],
+ "order" : 1}
+}
+
+# options which are added automatically if 'key' is encountered ("default" is always added)
+DEPENDENCY_OPT = {
+ "default" : [ "help", "debug", "verbose", "version", "action", "agent", \
+ "power_timeout", "shell_timeout", "login_timeout", "power_wait", "retry_on", "delay" ],
+ "passwd" : [ "passwd_script" ],
+ "secure" : [ "identity_file", "ssh_options" ],
+ "ipaddr" : [ "ipport", "inet4_only", "inet6_only" ],
+ "port" : [ "separator" ],
+ "community" : [ "snmp_auth_prot", "snmp_sec_level", "snmp_priv_prot", \
+ "snmp_priv_passwd", "snmp_priv_passwd_script" ]
+ }
+
+class fspawn(pexpect.spawn):
+ def __init__(self, options, command):
+ pexpect.spawn.__init__(self, command)
+ self.opt = options
+
+ def log_expect(self, options, pattern, timeout):
+ result = self.expect(pattern, timeout)
+ if options["log"] >= LOG_MODE_VERBOSE:
+ options["debug_fh"].write(self.before + self.after)
+ return result
+
+ # send EOL according to what was detected in login process (telnet)
+ def send_eol(self, message):
+ self.send(message + self.opt["eol"])
+
+def atexit_handler():
+ try:
+ sys.stdout.close()
+ os.close(1)
+ except IOError:
+ sys.stderr.write("%s failed to close standard output\n"%(sys.argv[0]))
+ syslog.syslog(syslog.LOG_ERR, "Failed to close standard output")
+ sys.exit(EC_GENERIC_ERROR)
+
+def add_dependency_options(options):
+ ## Add options which are available for every fence agent
+ added_opt = []
+ for x in options + ["default"]:
+ if DEPENDENCY_OPT.has_key(x):
+ added_opt.extend([y for y in DEPENDENCY_OPT[x] if options.count(y) == 0])
+ return added_opt
+
+
+def version(command, release, build_date, copyright_notice):
+ print command, " ", release, " ", build_date
+ if len(copyright_notice) > 0:
+ print copyright_notice
+
+def fail_usage(message = ""):
+ if len(message) > 0:
+ sys.stderr.write(message+"\n")
+ sys.stderr.write("Please use '-h' for usage\n")
+ sys.exit(EC_GENERIC_ERROR)
+
+def fail(error_code):
+ message = {
+ EC_LOGIN_DENIED : "Unable to connect/login to fencing device",
+ EC_CONNECTION_LOST : "Connection lost",
+ EC_TIMED_OUT : "Connection timed out",
+ EC_WAITING_ON : "Failed: Timed out waiting to power ON",
+ EC_WAITING_OFF : "Failed: Timed out waiting to power OFF",
+ EC_STATUS : "Failed: Unable to obtain correct plug status or plug is not available",
+ EC_STATUS_HMC :
+ "Failed: Either unable to obtain correct plug status, partition is not available or incorrect HMC version used",
+ EC_PASSWORD_MISSING : "Failed: You have to set login password",
+ EC_INVALID_PRIVILEGES : "Failed: The user does not have the correct privileges to do the requested action."
+ }[error_code] + "\n"
+ sys.stderr.write(message)
+ syslog.syslog(syslog.LOG_ERR, message)
+ sys.exit(EC_GENERIC_ERROR)
+
+def usage(avail_opt):
+ print "Usage:"
+ print "\t" + os.path.basename(sys.argv[0]) + " [options]"
+ print "Options:"
+
+ sorted_list = [ (key, all_opt[key]) for key in avail_opt ]
+ sorted_list.sort(lambda x, y: cmp(x[1]["order"], y[1]["order"]))
+
+ for key, value in sorted_list:
+ if len(value["help"]) != 0:
+ print " " + value["help"]
+
+def metadata(avail_opt, options, docs):
+ # avail_opt has to be unique, if there are duplicities then they should be removed
+ sorted_list = [ (key, all_opt[key]) for key in list(set(avail_opt)) ]
+ sorted_list.sort(lambda x, y: cmp(x[1]["order"], y[1]["order"]))
+
+ print "<?xml version=\"1.0\" ?>"
+ print "<resource-agent name=\"" + os.path.basename(sys.argv[0]) + "\" shortdesc=\"" + docs["shortdesc"] + "\" >"
+ if "symlink" in docs:
+ for (symlink, desc) in docs["symlink"]:
+ print "<symlink name=\"" + symlink + "\" shortdesc=\"" + desc + "\"/>"
+ print "<longdesc>" + docs["longdesc"] + "</longdesc>"
+ if docs.has_key("vendorurl"):
+ print "<vendor-url>" + docs["vendorurl"] + "</vendor-url>"
+ print "<parameters>"
+ for option, _value in sorted_list:
+ if all_opt[option].has_key("shortdesc"):
+ print "\t<parameter name=\"" + option + "\" unique=\"0\" required=\"" + all_opt[option]["required"] + "\">"
+
+ default = ""
+ if all_opt[option].has_key("default"):
+ default = str(all_opt[option]["default"])
+ elif options.has_key("--" + all_opt[option]["longopt"]) and all_opt[option]["getopt"].endswith(":"):
+ if options["--" + all_opt[option]["longopt"]]:
+ try:
+ default = options["--" + all_opt[option]["longopt"]]
+ except TypeError:
+ ## @todo/@note: Currently there is no clean way how to handle lists
+ ## we can create a string from it but we can't set it on command line
+ default = str(options["--" + all_opt[option]["longopt"]])
+ elif options.has_key("--" + all_opt[option]["longopt"]):
+ default = "true"
+
+ if default:
+ default = default.replace("&", "&" )
+ default = default.replace('"', """ )
+ default = default.replace('<', "<" )
+ default = default.replace('>', ">" )
+ default = default.replace("'", "'" )
+ default = "default=\"" + default + "\" "
+
+ mixed = all_opt[option]["help"]
+ ## split it between option and help text
+ res = re.compile("^(.*--\S+)\s+", re.IGNORECASE | re.S).search(mixed)
+ if (None != res):
+ mixed = res.group(1)
+ mixed = mixed.replace("<", "<").replace(">", ">")
+ print "\t\t<getopt mixed=\"" + mixed + "\" />"
+
+ if all_opt[option].has_key("choices"):
+ print "\t\t<content type=\"select\" "+default+" >"
+ for choice in all_opt[option]["choices"]:
+ print "\t\t\t<option value=\"%s\" />" % (choice)
+ print "\t\t</content>"
+ elif all_opt[option]["getopt"].count(":") > 0:
+ print "\t\t<content type=\"string\" "+default+" />"
+ else:
+ print "\t\t<content type=\"boolean\" "+default+" />"
+
+ print "\t\t<shortdesc lang=\"en\">" + all_opt[option]["shortdesc"] + "</shortdesc>"
+ print "\t</parameter>"
+ print "</parameters>"
+ print "<actions>"
+ if avail_opt.count("fabric_fencing") == 1:
+ ## do 'unfence' at the start
+ print "\t<action name=\"on\" automatic=\"1\"/>"
+ else:
+ print "\t<action name=\"on\" automatic=\"0\"/>"
+ print "\t<action name=\"off\" />"
+
+ if avail_opt.count("fabric_fencing") == 0:
+ print "\t<action name=\"reboot\" />"
+
+ print "\t<action name=\"status\" />"
+ print "\t<action name=\"list\" />"
+ print "\t<action name=\"monitor\" />"
+ print "\t<action name=\"metadata\" />"
+ print "</actions>"
+ print "</resource-agent>"
+
+def process_input(avail_opt):
+ avail_opt.extend(add_dependency_options(avail_opt))
+
+ ##
+ ## Set standard environment
+ #####
+ os.putenv("LANG", "C")
+ os.putenv("LC_ALL", "C")
+
+ ##
+ ## Prepare list of options for getopt
+ #####
+ getopt_string = ""
+ longopt_list = [ ]
+ for k in avail_opt:
+ if all_opt.has_key(k):
+ getopt_string += all_opt[k]["getopt"]
+ else:
+ fail_usage("Parse error: unknown option '"+k+"'")
+
+ if all_opt.has_key(k) and all_opt[k].has_key("longopt"):
+ if all_opt[k]["getopt"].endswith(":"):
+ longopt_list.append(all_opt[k]["longopt"] + "=")
+ else:
+ longopt_list.append(all_opt[k]["longopt"])
+
+ ##
+ ## Read options from command line or standard input
+ #####
+ if len(sys.argv) > 1:
+ try:
+ opt, _args = getopt.gnu_getopt(sys.argv[1:], getopt_string, longopt_list)
+ except getopt.GetoptError, error:
+ fail_usage("Parse error: " + error.msg)
+
+ ## Transform short getopt to long one which are used in fencing agents
+ #####
+ old_opt = opt
+ opt = { }
+ for o in dict(old_opt).keys():
+ if o.startswith("--"):
+ for x in all_opt.keys():
+ if all_opt[x].has_key("longopt") and "--" + all_opt[x]["longopt"] == o:
+ opt["--" + all_opt[x]["longopt"]] = dict(old_opt)[o]
+ else:
+ for x in all_opt.keys():
+ if all_opt[x].has_key("getopt") and all_opt[x].has_key("longopt") and \
+ ("-" + all_opt[x]["getopt"] == o or "-" + all_opt[x]["getopt"].rstrip(":") == o):
+ opt["--" + all_opt[x]["longopt"]] = dict(old_opt)[o]
+ opt[o] = dict(old_opt)[o]
+
+ ## Compatibility Layer
+ #####
+ z = dict(opt)
+ if z.has_key("--plug") == 1:
+ z["-m"] = z["--plug"]
+
+ opt = z
+ ##
+ #####
+ else:
+ opt = { }
+ name = ""
+ for line in sys.stdin.readlines():
+ line = line.strip()
+ if ((line.startswith("#")) or (len(line) == 0)):
+ continue
+
+ (name, value) = (line + "=").split("=", 1)
+ value = value[:-1]
+
+ if avail_opt.count(name) == 0:
+ sys.stderr.write("Parse error: Ignoring unknown option '"+line+"'\n")
+ syslog.syslog(syslog.LOG_WARNING, "Parse error: Ignoring unknown option '"+line)
+ continue
+
+ if all_opt[name]["getopt"].endswith(":"):
+ opt["--"+all_opt[name]["longopt"].rstrip(":")] = value
+ elif value.lower() in [ "1", "yes", "on", "true" ]:
+ opt["--"+all_opt[name]["longopt"]] = "1"
+ return opt
+
+##
+## This function checks input and answers if we want to have same answers
+## in each of the fencing agents. It looks for possible errors and run
+## password script to set a correct password
+######
+def check_input(device_opt, opt):
+
+ device_opt.extend(add_dependency_options(device_opt))
+
+ options = dict(opt)
+ options["device_opt"] = device_opt
+
+ ## Set requirements that should be included in metadata
+ #####
+ if device_opt.count("login") and device_opt.count("no_login") == 0:
+ all_opt["login"]["required"] = "1"
+ else:
+ all_opt["login"]["required"] = "0"
+
+ if device_opt.count("fabric_fencing"):
+ all_opt["action"]["default"] = "off"
+ all_opt["action"]["help"] = "-o, --action=[action] Action: status, off (default) or on"
+
+ ## Set default values
+ #####
+ for opt in device_opt:
+ if all_opt[opt].has_key("default"):
+ getopt_long = "--" + all_opt[opt]["longopt"]
+ if 0 == options.has_key(getopt_long):
+ options[getopt_long] = all_opt[opt]["default"]
+
+ if device_opt.count("ipport"):
+ if options.has_key("--ipport"):
+ all_opt["ipport"]["help"] = "-u, --ipport=[port] TCP/UDP port to use (default "+ options["--ipport"] +")"
+ elif options.has_key("--ssh"):
+ all_opt["ipport"]["default"] = 22
+ all_opt["ipport"]["help"] = "-u, --ipport=[port] TCP/UDP port to use (default 22)"
+ elif options.has_key("--ssl"):
+ all_opt["ipport"]["default"] = 443
+ all_opt["ipport"]["help"] = "-u, --ipport=[port] TCP/UDP port to use (default 443)"
+ elif device_opt.count("web"):
+ all_opt["ipport"]["default"] = 80
+ if device_opt.count("ssl") == 0:
+ all_opt["ipport"]["help"] = "-u, --ipport=[port] TCP/UDP port to use (default 80)"
+ else:
+ all_opt["ipport"]["help"] = "-u, --ipport=[port] TCP/UDP port to use\n\
+ (default 80, 443 if --ssl option is used)"
+ else:
+ all_opt["ipport"]["default"] = 23
+ if device_opt.count("secure") == 0:
+ all_opt["ipport"]["help"] = "-u, --ipport=[port] TCP/UDP port to use (default 23)"
+ else:
+ all_opt["ipport"]["help"] = "-u, --ipport=[port] TCP/UDP port to use\n\
+ (default 23, 22 if --ssh option is used)"
+
+
+ ## In special cases (show help, metadata or version) we don't need to check anything
+ #####
+ if options.has_key("--help") or options.has_key("--version") or (options.has_key("--action") and options["--action"].lower() == "metadata"):
+ return options
+
+ options["--action"] = options["--action"].lower()
+
+ if options.has_key("--verbose"):
+ options["log"] = LOG_MODE_VERBOSE
+ else:
+ options["log"] = LOG_MODE_QUIET
+
+ acceptable_actions = [ "on", "off", "status", "list", "monitor" ]
+ if 1 == device_opt.count("fabric_fencing"):
+ ## Compatibility layer
+ #####
+ acceptable_actions.extend(["enable", "disable"])
+ else:
+ acceptable_actions.extend(["reboot"])
+
+ if 0 == acceptable_actions.count(options["--action"]):
+ fail_usage("Failed: Unrecognised action '" + options["--action"] + "'")
+
+ ## Compatibility layer
+ #####
+ if options["--action"] == "enable":
+ options["--action"] = "on"
+ if options["--action"] == "disable":
+ options["--action"] = "off"
+
+ ## automatic detection and set of valid UUID from --plug
+ if (0 == options.has_key("--username")) and device_opt.count("login") and (device_opt.count("no_login") == 0):
+ fail_usage("Failed: You have to set login name")
+
+ if device_opt.count("ipaddr") and 0 == options.has_key("--ip") and 0 == options.has_key("--managed"):
+ fail_usage("Failed: You have to enter fence address")
+
+ if (device_opt.count("no_password") == 0):
+ if 0 == device_opt.count("identity_file"):
+ if 0 == (options.has_key("--password") or options.has_key("--password-script")):
+ fail_usage("Failed: You have to enter password or password script")
+ else:
+ if 0 == (options.has_key("--password") or options.has_key("--password-script") or options.has_key("--identity-file")):
+ fail_usage("Failed: You have to enter password, password script or identity file")
+
+ if 0 == options.has_key("--ssh") and 1 == options.has_key("--identity-file"):
+ fail_usage("Failed: You have to use identity file together with ssh connection (-x)")
+
+ if 1 == options.has_key("--identity-file"):
+ if 0 == os.path.isfile(options["--identity-file"]):
+ fail_usage("Failed: Identity file " + options["--identity-file"] + " does not exist")
+
+ if (0 == ["list", "monitor"].count(options["--action"].lower())) and \
+ 0 == options.has_key("--plug") and device_opt.count("port") and device_opt.count("no_port") == 0:
+ fail_usage("Failed: You have to enter plug number or machine identification")
+
+ if options.has_key("--password-script"):
+ options["--password"] = os.popen(options["--password-script"]).read().rstrip()
+
+ if options.has_key("--debug-file"):
+ try:
+ options["debug_fh"] = file (options["--debug-file"], "w")
+ except IOError:
+ fail_usage("Failed: Unable to create file " + options["--debug-file"])
+
+ if options.has_key("debug_fh") == 0:
+ options["debug_fh"] = sys.stderr
+
+ if options.has_key("--snmp-priv-passwd-script"):
+ options["--snmp-priv-passwd"] = os.popen(options["--snmp-priv-passwd-script"]).read().rstrip()
+
+ if options.has_key("--ipport") == False:
+ if options.has_key("--ssh"):
+ options["--ipport"] = 22
+ elif options.has_key("--ssl"):
+ options["--ipport"] = 443
+ elif device_opt.count("web"):
+ options["--ipport"] = 80
+ else:
+ options["--ipport"] = 23
+
+ if options.has_key("--plug") and len(options["--plug"].split(",")) > 1 and options.has_key("--method") and options["--method"] == "cycle":
+ fail_usage("Failed: Cannot use --method cycle for more than 1 plug")
+
+ for opt in device_opt:
+ if all_opt[opt].has_key("choices"):
+ long = "--" + all_opt[opt]["longopt"]
+ possible_values_upper = map (lambda y : y.upper(), all_opt[opt]["choices"])
+ if options.has_key(long):
+ options[long] = options[long].upper()
+ if not options["--" + all_opt[opt]["longopt"]] in possible_values_upper:
+ fail_usage("Failed: You have to enter a valid choice for %s from the valid values: %s" % ("--" + all_opt[opt]["longopt"] , str(all_opt[opt]["choices"])))
+
+ return options
+
+def wait_power_status(tn, options, get_power_fn):
+ for dummy in xrange(int(options["--power-timeout"])):
+ if get_multi_power_fn(tn, options, get_power_fn) != options["--action"]:
+ time.sleep(1)
+ else:
+ return 1
+ return 0
+
+## Obtain a power status from possibly more than one plug
+## "on" is returned if at least one plug is ON
+######
+def get_multi_power_fn(tn, options, get_power_fn):
+ status = "off"
+
+ if options.has_key("--plugs"):
+ for plug in options["--plugs"]:
+ try:
+ options["--uuid"] = str(uuid.UUID(plug))
+ except ValueError:
+ pass
+ except KeyError:
+ pass
+
+ options["--plug"] = plug
+ plug_status = get_power_fn(tn, options)
+ if plug_status != "off":
+ status = plug_status
+ else:
+ status = get_power_fn(tn, options)
+
+ return status
+
+def set_multi_power_fn(tn, options, set_power_fn):
+ if options.has_key("--plugs"):
+ for plug in options["--plugs"]:
+ try:
+ options["--uuid"] = str(uuid.UUID(plug))
+ except ValueError:
+ pass
+ except KeyError:
+ pass
+ options["--plug"] = plug
+ set_power_fn(tn, options)
+ else:
+ set_power_fn(tn, options)
+
+def show_docs(options, docs = None):
+ device_opt = options["device_opt"]
+
+ if docs == None:
+ docs = { }
+ docs["shortdesc"] = "Fence agent"
+ docs["longdesc"] = ""
+
+ ## Process special options (and exit)
+ #####
+ if options.has_key("--help"):
+ usage(device_opt)
+ sys.exit(0)
+
+ if options.has_key("--action") and options["--action"].lower() == "metadata":
+ metadata(device_opt, options, docs)
+ sys.exit(0)
+
+ if options.has_key("--version"):
+ print __main__.RELEASE_VERSION, __main__.BUILD_DATE
+ print __main__.REDHAT_COPYRIGHT
+ sys.exit(0)
+
+def fence_action(tn, options, set_power_fn, get_power_fn, get_outlet_list = None, reboot_cycle_fn = None):
+ result = 0
+
+ try:
+ if options.has_key("--plug"):
+ options["--plugs"] = options["--plug"].split(",")
+
+ ## Process options that manipulate fencing device
+ #####
+ if (options["--action"] == "list") and 0 == options["device_opt"].count("port"):
+ print "N/A"
+ return
+ elif (options["--action"] == "list" and get_outlet_list == None):
+ ## @todo: exception?
+ ## This is just temporal solution, we will remove default value
+ ## None as soon as all existing agent will support this operation
+ print "NOTICE: List option is not working on this device yet"
+ return
+ elif (options["--action"] == "list") or ((options["--action"] == "monitor") and 1 == options["device_opt"].count("port")):
+ outlets = get_outlet_list(tn, options)
+ ## keys can be numbers (port numbers) or strings (names of VM)
+ for o in outlets.keys():
+ (alias, status) = outlets[o]
+ if options["--action"] != "monitor":
+ print o + options["--separator"] + alias
+ return
+
+ status = get_multi_power_fn(tn, options, get_power_fn)
+
+ if status != "on" and status != "off":
+ fail(EC_STATUS)
+
+ if options["--action"] == "on":
+ if status == "on":
+ print "Success: Already ON"
+ else:
+ power_on = False
+ for _ in range(1, 1 + int(options["--retry-on"])):
+ set_multi_power_fn(tn, options, set_power_fn)
+ time.sleep(int(options["--power-wait"]))
+ if wait_power_status(tn, options, get_power_fn):
+ power_on = True
+ break
+
+ if power_on:
+ print "Success: Powered ON"
+ else:
+ fail(EC_WAITING_ON)
+ elif options["--action"] == "off":
+ if status == "off":
+ print "Success: Already OFF"
+ else:
+ set_multi_power_fn(tn, options, set_power_fn)
+ time.sleep(int(options["--power-wait"]))
+ if wait_power_status(tn, options, get_power_fn):
+ print "Success: Powered OFF"
+ else:
+ fail(EC_WAITING_OFF)
+ elif options["--action"] == "reboot":
+ power_on = False
+ if options.has_key("--method") and options["--method"].lower() == "cycle" and reboot_cycle_fn is not None:
+ for _ in range(1, 1 + int(options["--retry-on"])):
+ if reboot_cycle_fn(tn, options):
+ power_on = True
+ break
+
+ if not power_on:
+ fail(EC_TIMED_OUT)
+
+ else:
+ if status != "off":
+ options["--action"] = "off"
+ set_multi_power_fn(tn, options, set_power_fn)
+ time.sleep(int(options["--power-wait"]))
+ if wait_power_status(tn, options, get_power_fn) == 0:
+ fail(EC_WAITING_OFF)
+ options["--action"] = "on"
+
+ try:
+ for _ in range(1, 1 + int(options["--retry-on"])):
+ set_multi_power_fn(tn, options, set_power_fn)
+ time.sleep(int(options["--power-wait"]))
+ if wait_power_status(tn, options, get_power_fn) == 1:
+ power_on = True
+ break
+ except Exception, ex:
+ # an error occured during power ON phase in reboot
+ # fence action was completed succesfully even in that case
+ sys.stderr.write(str(ex))
+ syslog.syslog(syslog.LOG_NOTICE, str(ex))
+ pass
+
+ if power_on == False:
+ # this should not fail as node was fenced succesfully
+ sys.stderr.write('Timed out waiting to power ON\n')
+ syslog.syslog(syslog.LOG_NOTICE, "Timed out waiting to power ON")
+
+ print "Success: Rebooted"
+ elif options["--action"] == "status":
+ print "Status: " + status.upper()
+ if status.upper() == "OFF":
+ result = 2
+ elif options["--action"] == "monitor":
+ pass
+ except pexpect.EOF:
+ fail(EC_CONNECTION_LOST)
+ except pexpect.TIMEOUT:
+ fail(EC_TIMED_OUT)
+ except pycurl.error, ex:
+ sys.stderr.write(ex[1] + "\n")
+ syslog.syslog(syslog.LOG_ERR, ex[1])
+ fail(EC_TIMED_OUT)
+
+ return result
+
+def fence_login(options, re_login_string = "(login\s*: )|(Login Name: )|(username: )|(User Name :)"):
+ force_ipvx=""
+
+ if (options.has_key("--inet6-only")):
+ force_ipvx = "-6 "
+
+ if (options.has_key("--inet4-only")):
+ force_ipvx = "-4 "
+
+ if (options.has_key("eol") == False):
+ options["eol"] = "\r\n"
+
+ if options.has_key("--command-prompt") and type(options["--command-prompt"]) is not list:
+ options["--command-prompt"] = [ options["--command-prompt"] ]
+
+ ## Do the delay of the fence device before logging in
+ ## Delay is important for two-node clusters fencing but we do not need to delay 'status' operations
+ if options["--action"] in ["off", "reboot"]:
+ time.sleep(int(options["--delay"]))
+
+ try:
+ re_login = re.compile(re_login_string, re.IGNORECASE)
+ re_pass = re.compile("(password)|(pass phrase)", re.IGNORECASE)
+
+ if options.has_key("--ssl"):
+ command = '%s --insecure --crlf -p %s %s' % (SSL_PATH, options["--ipport"], options["--ip"])
+ try:
+ conn = fspawn(options, command)
+ except pexpect.ExceptionPexpect, ex:
+ sys.stderr.write(str(ex) + "\n")
+ syslog.syslog(syslog.LOG_ERR, str(ex))
+ sys.exit(EC_GENERIC_ERROR)
+ elif options.has_key("--ssh") and 0 == options.has_key("--identity-file"):
+ command = '%s %s %s@%s -p %s -o PubkeyAuthentication=no' % (SSH_PATH, force_ipvx, options["--username"], options["--ip"], options["--ipport"])
+ if options.has_key("--ssh-options"):
+ command += ' ' + options["--ssh-options"]
+ try:
+ conn = fspawn(options, command)
+ except pexpect.ExceptionPexpect, ex:
+ sys.stderr.write(str(ex) + "\n")
+ syslog.syslog(syslog.LOG_ERR, str(ex))
+ sys.stderr.write("Due to limitations, binary dependencies on fence agents "
+ "are not in the spec file and must be installed separately." + "\n")
+ sys.exit(EC_GENERIC_ERROR)
+
+ if options.has_key("telnet_over_ssh"):
+ #This is for stupid ssh servers (like ALOM) which behave more like telnet (ignore name and display login prompt)
+ result = conn.log_expect(options, [ re_login, "Are you sure you want to continue connecting (yes/no)?" ], int(options["--login-timeout"]))
+ if result == 1:
+ conn.sendline("yes") # Host identity confirm
+ conn.log_expect(options, re_login, int(options["--login-timeout"]))
+
+ conn.sendline(options["--username"])
+ conn.log_expect(options, re_pass, int(options["--login-timeout"]))
+ else:
+ result = conn.log_expect(options, [ "ssword:", "Are you sure you want to continue connecting (yes/no)?" ], int(options["--login-timeout"]))
+ if result == 1:
+ conn.sendline("yes")
+ conn.log_expect(options, "ssword:", int(options["--login-timeout"]))
+
+ conn.sendline(options["--password"])
+ conn.log_expect(options, options["--command-prompt"], int(options["--login-timeout"]))
+ elif options.has_key("--ssh") and options.has_key("--identity-file"):
+ command = '%s %s %s@%s -i %s -p %s' % (SSH_PATH, force_ipvx, options["--username"], options["--ip"], options["--identity-file"], options["--ipport"])
+ if options.has_key("--ssh-options"):
+ command += ' ' + options["--ssh-options"]
+ try:
+ conn = fspawn(options, command)
+ except pexpect.ExceptionPexpect, ex:
+ sys.stderr.write(str(ex) + "\n")
+ syslog.syslog(syslog.LOG_ERR, str(ex))
+ sys.stderr.write("Due to limitations, binary dependencies on fence agents "
+ "are not in the spec file and must be installed separately." + "\n")
+ sys.exit(EC_GENERIC_ERROR)
+
+ result = conn.log_expect(options, [ options["--command-prompt"], \
+ "Are you sure you want to continue connecting (yes/no)?", \
+ "Enter passphrase for key '" + options["--identity-file"] + "':" ], int(options["--login-timeout"]))
+ if result == 1:
+ conn.sendline("yes")
+ conn.log_expect(options, [ options["--command-prompt"], "Enter passphrase for key '"+options["--identity-file"]+"':"] , int(options["--login-timeout"]))
+ if result != 0:
+ if options.has_key("--password"):
+ conn.sendline(options["--password"])
+ conn.log_expect(options, options["--command-prompt"], int(options["--login-timeout"]))
+ else:
+ fail_usage("Failed: You have to enter passphrase (-p) for identity file")
+ else:
+ try:
+ conn = fspawn(options, TELNET_PATH)
+ conn.send("set binary\n")
+ conn.send("open %s -%s\n"%(options["--ip"], options["--ipport"]))
+ except pexpect.ExceptionPexpect, ex:
+ sys.stderr.write(str(ex) + "\n")
+ syslog.syslog(syslog.LOG_ERR, str(ex))
+ sys.stderr.write("Due to limitations, binary dependencies on fence agents "
+ "are not in the spec file and must be installed separately." + "\n")
+ sys.exit(EC_GENERIC_ERROR)
+
+ result = conn.log_expect(options, re_login, int(options["--login-timeout"]))
+ conn.send_eol(options["--username"])
+
+ ## automatically change end of line separator
+ screen = conn.read_nonblocking(size=100, timeout=int(options["--shell-timeout"]))
+ if (re_login.search(screen) != None):
+ options["eol"] = "\n"
+ conn.send_eol(options["--username"])
+ result = conn.log_expect(options, re_pass, int(options["--login-timeout"]))
+ elif (re_pass.search(screen) == None):
+ conn.log_expect(options, re_pass, int(options["--shell-timeout"]))
+
+ try:
+ conn.send_eol(options["--password"])
+ valid_password = conn.log_expect(options, [ re_login ] + options["--command-prompt"], int(options["--shell-timeout"]))
+ if valid_password == 0:
+ ## password is invalid or we have to change EOL separator
+ options["eol"] = "\r"
+ conn.send_eol("")
+ screen = conn.read_nonblocking(size=100, timeout=int(options["--shell-timeout"]))
+ ## after sending EOL the fence device can either show 'Login' or 'Password'
+ if (re_login.search(screen) != None):
+ conn.send_eol("")
+ conn.send_eol(options["--username"])
+ conn.log_expect(options, re_pass, int(options["--login-timeout"]))
+ conn.send_eol(options["--password"])
+ conn.log_expect(options, options["--command-prompt"], int(options["--login-timeout"]))
+ except KeyError:
+ fail(EC_PASSWORD_MISSING)
+ except pexpect.EOF:
+ fail(EC_LOGIN_DENIED)
+ except pexpect.TIMEOUT:
+ fail(EC_LOGIN_DENIED)
+ return conn
+
+def is_executable(path):
+ if os.path.exists(path):
+ stats = os.stat(path)
+ if stat.S_ISREG(stats.st_mode) and os.access(path, os.X_OK):
+ return True
+ return False
diff --git a/fence/agents/lib/fencing_snmp.py.py b/fence/agents/lib/fencing_snmp.py.py
new file mode 100644
index 0000000..0112494
--- /dev/null
+++ b/fence/agents/lib/fencing_snmp.py.py
@@ -0,0 +1,131 @@
+#!/usr/bin/python
+
+# For example of use please see fence_cisco_mds
+
+import re, pexpect
+from fencing import *
+
+## do not add code here.
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION = ""
+REDHAT_COPYRIGHT = ""
+BUILD_DATE = ""
+#END_VERSION_GENERATION
+
+# Fix for RHBZ#527844
+def snmp_define_defaults ():
+ all_opt["ipport"]["default"] = "161"
+
+class FencingSnmp:
+ def __init__(self, options):
+ self.options = options
+
+ # Log message if user set verbose option
+ def log_command(self, message):
+ if self.options["log"] >= LOG_MODE_VERBOSE:
+ self.options["debug_fh"].write(message+"\n")
+
+ def quote_for_run(self, string):
+ return ''.join(map(lambda x:x==r"'" and "'\\''" or x, string))
+
+ def complete_missed_params(self):
+ mapping = [
+ [['snmp-priv-passwd','password','!snmp-sec-level'],'self.options["--snmp-sec-level"]="authPriv"'],
+ [['!snmp-version','community','!username','!snmp-priv-passwd','!password'],'self.options["--snmp-version"]="2c"']
+ ]
+
+ for val in mapping:
+ e = val[0]
+
+ res = True
+
+ for item in e:
+ if ((item[0]=='!') and (self.options.has_key("--"+item[1:]))):
+ res = False
+ break
+
+ if ((item[0]!='!') and (not self.options.has_key("--"+item[0:]))):
+ res = False
+ break
+
+ if res:
+ exec(val[1])
+
+ def prepare_cmd(self, command):
+ cmd = "@SNMPBIN@/%s -m '' -Oeqn "% (command)
+
+ self.complete_missed_params()
+
+ #mapping from our option to snmpcmd option
+ mapping = (('snmp-version', 'v'),('community', 'c'))
+
+ for item in mapping:
+ if (self.options.has_key("--" + item[0])):
+ cmd += " -%s '%s'"% (item[1], self.quote_for_run(self.options["--" + item[0]]))
+
+ # Some options make sense only for v3 (and for v1/2c can cause "problems")
+ if (self.options.has_key("--snmp-version")) and (self.options["--snmp-version"] == "3"):
+ # Mapping from our options to snmpcmd options for v3
+ mapping_v3 = (('snmp-auth-prot','a'), ('snmp-sec-level','l'), ('snmp-priv-prot','x'), \
+ ('snmp-priv-passwd','X'),('password','A'),('username','u'))
+ for item in mapping_v3:
+ if (self.options.has_key("--"+item[0])):
+ cmd += " -%s '%s'"% (item[1], self.quote_for_run(self.options["--" + item[0]]))
+
+ force_ipvx = ""
+
+ if (self.options.has_key("--inet6-only")):
+ force_ipvx = "udp6:"
+
+ if (self.options.has_key("--inet4-only")):
+ force_ipvx = "udp:"
+
+ cmd += " '%s%s%s'"% (force_ipvx, self.quote_for_run(self.options["--ip"]),
+ self.options.has_key("--ipport") and self.quote_for_run(":" + str (self.options["--ipport"])) or "")
+ return cmd
+
+ def run_command(self, command, additional_timemout=0):
+ try:
+ self.log_command(command)
+
+ (res_output, res_code) = pexpect.run(command, int(self.options["--shell-timeout"]) + int(self.options["--login-timeout"]) + additional_timemout, True)
+
+ if (res_code==None):
+ fail(EC_TIMED_OUT)
+
+ self.log_command(res_output)
+
+ if (res_code!=0) or (re.search("^Error ", res_output, re.MULTILINE) != None):
+ fail_usage("Returned %d: %s"% (res_code, res_output))
+ except pexpect.ExceptionPexpect:
+ fail_usage("Cannot run command %s"%(command))
+
+ return res_output
+
+ def get(self, oid, additional_timemout=0):
+ cmd = "%s '%s'"% (self.prepare_cmd("snmpget"), self.quote_for_run(oid))
+
+ output = self.run_command(cmd, additional_timemout).splitlines()
+
+ return output[len(output)-1].split(None, 1)
+
+ def set(self, oid, value, additional_timemout=0):
+ mapping = ((int, 'i'), (str, 's'))
+
+ type_of_value = ''
+
+ for item in mapping:
+ if (isinstance(value, item[0])):
+ type_of_value = item[1]
+ break
+
+ cmd = "%s '%s' %s '%s'"% (self.prepare_cmd("snmpset"), self.quote_for_run(oid), type_of_value, self.quote_for_run(str(value)))
+
+ self.run_command(cmd, additional_timemout)
+
+ def walk(self, oid, additional_timemout=0):
+ cmd = "%s '%s'"% (self.prepare_cmd("snmpwalk"), self.quote_for_run(oid))
+
+ output = self.run_command(cmd, additional_timemout).splitlines()
+
+ return map(lambda x:x.split(None, 1), filter(lambda y:len(y)>0 and y[0]=='.', output))
diff --git a/fence/agents/lib/metadata.rng b/fence/agents/lib/metadata.rng
new file mode 100644
index 0000000..c7758e6
--- /dev/null
+++ b/fence/agents/lib/metadata.rng
@@ -0,0 +1,77 @@
+<grammar xmlns="http://relaxng.org/ns/structure/1.0">
+
+<start><element name="resource-agent">
+ <attribute name="name" />
+ <attribute name="shortdesc" />
+
+ <zeroOrMore>
+ <element name="symlink">
+ <attribute name="name" />
+ <attribute name="shortdesc" />
+ </element>
+ </zeroOrMore>
+
+ <element name="longdesc"> <text /> </element>
+ <element name="vendor-url"> <text /> </element>
+
+ <element name="parameters"> <oneOrMore>
+ <element name="parameter">
+ <attribute name="name" />
+ <attribute name="unique"> <ref name="boolean-values" /> </attribute>
+ <attribute name="required"> <ref name="boolean-values" /> </attribute>
+
+ <element name="getopt">
+ <attribute name="mixed" />
+ </element>
+ <element name="content">
+ <choice>
+ <attribute name="type">
+ <choice>
+ <value>boolean</value>
+ <value>string</value>
+ </choice>
+ </attribute>
+ <group>
+ <attribute name="type">
+ <value>select</value>
+ </attribute>
+ <zeroOrMore>
+ <element name="option">
+ <attribute name="value" />
+ </element>
+ </zeroOrMore>
+ </group>
+ </choice>
+ <optional>
+ <attribute name="default"> <text /> </attribute>
+ </optional>
+ </element>
+
+ <oneOrMore> <element name="shortdesc">
+ <attribute name="lang" />
+ <text />
+ </element> </oneOrMore>
+ </element>
+ </oneOrMore> </element>
+
+ <element name="actions"> <oneOrMore>
+ <element name="action">
+ <attribute name="name" />
+ <optional>
+ <attribute name="on_target"> <ref name="boolean-values" /> </attribute>
+ </optional>
+ <optional>
+ <attribute name="automatic"> <ref name="boolean-values" /> </attribute>
+ </optional>
+ </element>
+ </oneOrMore> </element>
+</element></start>
+
+<define name="boolean-values">
+ <choice>
+ <value>0</value>
+ <value>1</value>
+ </choice>
+</define>
+
+</grammar>
diff --git a/fence/agents/lib/transfer.py b/fence/agents/lib/transfer.py
new file mode 100755
index 0000000..ddf2486
--- /dev/null
+++ b/fence/agents/lib/transfer.py
@@ -0,0 +1,16 @@
+#!/usr/bin/python
+
+from fencing import *
+
+def main():
+ for key in all_opt.keys():
+ if all_opt[key].has_key("getopt") and all_opt[key].has_key("longopt"):
+ print "s/options\[\"-" + all_opt[key]["getopt"].rstrip(":") + "\"\]/options[\"--" + \
+ all_opt[key]["longopt"] + "\"]/g"
+ print "s/options.has_key(\"-" + all_opt[key]["getopt"].rstrip(":") + "\")/options.has_key(" + \
+ "\"--" + all_opt[key]["longopt"] + "\")/g"
+
+
+
+if __name__ == "__main__":
+ main()
\ No newline at end of file
diff --git a/fence/agents/lpar/Makefile.am b/fence/agents/lpar/Makefile.am
new file mode 100644
index 0000000..2af387c
--- /dev/null
+++ b/fence/agents/lpar/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_lpar
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/lpar/fence_lpar.py b/fence/agents/lpar/fence_lpar.py
new file mode 100644
index 0000000..1d7e09c
--- /dev/null
+++ b/fence/agents/lpar/fence_lpar.py
@@ -0,0 +1,160 @@
+#!/usr/bin/python
+
+#####
+##
+## The Following Agent Has Been Tested On:
+##
+## Version
+## +---------------------------------------------+
+## Tested on HMC
+##
+#####
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION=""
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+def get_power_status(conn, options):
+ if options["--hmc-version"] == "3":
+ conn.send("lssyscfg -r lpar -m " + options["--managed"] + " -n " + options["--plug"] + " -F name,state\n")
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+
+ try:
+ status = re.compile("^" + options["--plug"] + ",(.*?),.*$", re.IGNORECASE | re.MULTILINE).search(conn.before).group(1)
+ except AttributeError:
+ fail(EC_STATUS_HMC)
+ elif options["--hmc-version"] == "4":
+ conn.send("lssyscfg -r lpar -m "+ options["--managed"] +" --filter 'lpar_names=" + options["--plug"] + "'\n")
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+
+ try:
+ status = re.compile(",state=(.*?),", re.IGNORECASE).search(conn.before).group(1)
+ except AttributeError:
+ fail(EC_STATUS_HMC)
+
+ ##
+ ## Transformation to standard ON/OFF status if possible
+ if status in ["Running", "Open Firmware", "Shutting Down", "Starting"]:
+ status = "on"
+ else:
+ status = "off"
+
+ return status
+
+def set_power_status(conn, options):
+ if options["--hmc-version"] == "3":
+ conn.send("chsysstate -o " + options["--action"] + " -r lpar -m " + options["--managed"]
+ + " -n " + options["--plug"] + "\n")
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+ elif options["--hmc-version"] == "4":
+ if options["--action"] == "on":
+ conn.send("chsysstate -o on -r lpar -m " + options["--managed"] +
+ " -n " + options["--plug"] +
+ " -f `lssyscfg -r lpar -F curr_profile " +
+ " -m " + options["--managed"] +
+ " --filter \"lpar_names="+ options["--plug"] +"\"`\n" )
+ else:
+ conn.send("chsysstate -o shutdown -r lpar --immed" +
+ " -m " + options["--managed"] + " -n " + options["--plug"] + "\n")
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+
+def get_lpar_list(conn, options):
+ outlets = { }
+ if options["--hmc-version"] == "3":
+ conn.send("query_partition_names -m " + options["--managed"] + "\n")
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+
+ ## We have to remove first 3 lines (command + header) and last line (part of new prompt)
+ ####
+ res = re.search("^.+?\n(.+?\n){2}(.*)\n.*$", conn.before, re.S)
+
+ if res == None:
+ fail_usage("Unable to parse output of list command")
+
+ lines = res.group(2).split("\n")
+ for outlet_line in lines:
+ outlets[outlet_line.rstrip()] = ("", "")
+ elif options["--hmc-version"] == "4":
+ conn.send("lssyscfg -r lpar -m " + options["--managed"] +
+ " -F name:state\n")
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+
+ ## We have to remove first line (command) and last line (part of new prompt)
+ ####
+ res = re.search("^.+?\n(.*)\n.*$", conn.before, re.S)
+
+ if res == None:
+ fail_usage("Unable to parse output of list command")
+
+ lines = res.group(1).split("\n")
+ for outlet_line in lines:
+ (port, status) = outlet_line.split(":")
+ outlets[port] = ("", status)
+
+ return outlets
+
+def define_new_opts():
+ all_opt["managed"] = {
+ "getopt" : "s:",
+ "longopt" : "managed",
+ "help" : "-s, --managed=[id] Name of the managed system",
+ "required" : "0",
+ "shortdesc" : "Managed system name",
+ "order" : 1 }
+ all_opt["hmc_version"] = {
+ "getopt" : "H:",
+ "longopt" : "hmc-version",
+ "help" : "-H, --hmc-version=[version] Force HMC version to use: 3, 4 (default)",
+ "required" : "0",
+ "shortdesc" : "Force HMC version to use (3 or 4)",
+ "default" : "4",
+ "choices" : [ "3", "4" ],
+ "order" : 1 }
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "secure", "cmd_prompt", \
+ "port", "managed", "hmc_version" ]
+
+ atexit.register(atexit_handler)
+
+ define_new_opts()
+
+ all_opt["login_timeout"]["default"] = "15"
+ all_opt["secure"]["default"] = "1"
+ all_opt["cmd_prompt"]["default"] = [ ":~>", "]\$", "\$ " ]
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for IBM LPAR"
+ docs["longdesc"] = ""
+ docs["vendorurl"] = "http://www.ibm.com"
+ show_docs(options, docs)
+
+ if 0 == options.has_key("--managed"):
+ fail_usage("Failed: You have to enter name of managed system")
+
+ ##
+ ## Operate the fencing device
+ ####
+ conn = fence_login(options)
+ result = fence_action(conn, options, set_power_status, get_power_status, get_lpar_list)
+
+ ##
+ ## Logout from system
+ ######
+ try:
+ conn.send("quit\r\n")
+ conn.close()
+ except:
+ pass
+
+ sys.exit(result)
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/manual/Makefile.am b/fence/agents/manual/Makefile.am
new file mode 100644
index 0000000..1eb2971
--- /dev/null
+++ b/fence/agents/manual/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_ack_manual
+
+sbin_SCRIPTS = $(TARGET)
+
+EXTRA_DIST = $(TARGET).in
+
+dist_man_MANS = $(TARGET).8
+
+$(TARGET): $(TARGET).in
+ cat $^ | sed \
+ -e 's#@clustervarrun@#${CLUSTERVARRUN}#g' \
+ > $@
+
+clean-local:
+ rm -f $(TARGET)
diff --git a/fence/agents/manual/fence_ack_manual.8 b/fence/agents/manual/fence_ack_manual.8
new file mode 100644
index 0000000..6b4cd14
--- /dev/null
+++ b/fence/agents/manual/fence_ack_manual.8
@@ -0,0 +1,39 @@
+.TH FENCE_ACK_MANUAL 8 2009-12-21 cluster cluster
+
+.SH NAME
+fence_ack_manual \- a program to override fenced fencing operations
+
+.SH SYNOPSIS
+.B fence_ack_manual
+[OPTIONS]
+.I nodename
+
+.SH DESCRIPTION
+When
+.BR fenced (8)
+fails to fence a node, it retries indefinately.
+.BR fence_ack_manual (8)
+tells fenced to stop retrying and consider the node fenced.
+
+.P
+It is important that this only be done after the node has been manually
+turned off or prevented from writing to shared storage.
+Without this manual action and verification, the storage that fencing
+protects may become corrupted.
+
+.P
+When fenced fences a node that has no fence devices defined in the cluster
+configuration, the fencing operation fails. This failure will be repeated
+indefinately until fence_ack_manual is run by an operator to indicate
+the node is in a safe state to proceed.
+(Defining no fencing devices for node is the equivalent of using the
+fence_manual agent in previous versions.)
+
+.SH OPTIONS
+.TP
+.B \-h
+Print a help message describing available options, then exit.
+
+.SH SEE ALSO
+.BR fenced (8)
+
diff --git a/fence/agents/manual/fence_ack_manual.in b/fence/agents/manual/fence_ack_manual.in
new file mode 100644
index 0000000..e8b4998
--- /dev/null
+++ b/fence/agents/manual/fence_ack_manual.in
@@ -0,0 +1,37 @@
+#!/bin/bash
+#
+# Manual override after fencing has failed.
+#
+
+if [ "$1" = "-n" ]; then
+ shift
+fi
+
+if [ -z "$1" ] || [ "${1:0:1}" = "-" ]; then
+ echo "usage:"
+ echo " $0 <nodename>"
+ echo " $0 -n <nodename>"
+ echo
+ echo "The -n flag exists to preserve compatibility with previous "
+ echo "releases of $0, and is no longer required."
+ exit 1
+fi
+
+declare answer
+
+echo "About to override fencing for $1."
+echo "Improper use of this command can cause severe file system damage."
+echo
+read -p "Continue [NO/absolutely]? " answer
+
+if [ "$answer" != "absolutely" ]; then
+ echo "Aborted."
+ exit 1
+fi
+
+while ! [ -e @clustervarrun@/fenced_override ]; do
+ sleep 1
+done
+
+echo $1>@clustervarrun@/fenced_override
+echo Done
diff --git a/fence/agents/mcdata/Makefile.am b/fence/agents/mcdata/Makefile.am
new file mode 100644
index 0000000..54b64fc
--- /dev/null
+++ b/fence/agents/mcdata/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_mcdata
+
+SRC = $(TARGET).pl
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fencemanperl.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/mcdata/fence_mcdata.pl b/fence/agents/mcdata/fence_mcdata.pl
new file mode 100644
index 0000000..3148a99
--- /dev/null
+++ b/fence/agents/mcdata/fence_mcdata.pl
@@ -0,0 +1,361 @@
+#!/usr/bin/perl
+
+# This works on the following firmware versions:
+# 01.03.00
+# 02.00.00
+# 04.01.00
+# 04.01.02
+
+use Getopt::Std;
+use Net::Telnet ();
+
+my $ME = $0;
+
+END {
+ defined fileno STDOUT or return;
+ close STDOUT and return;
+ warn "$ME: failed to close standard output: $!\n";
+ $? ||= 1;
+}
+
+# Get the program name from $0 and strip directory names
+$_=$0;
+s/.*\///;
+my $pname = $_;
+
+$opt_o = 'disable'; # Default fence action
+
+# WARNING!! Do not add code bewteen "#BEGIN_VERSION_GENERATION" and
+# "#END_VERSION_GENERATION" It is generated by the Makefile
+
+#BEGIN_VERSION_GENERATION
+$RELEASE_VERSION="";
+$REDHAT_COPYRIGHT="";
+$BUILD_DATE="";
+#END_VERSION_GENERATION
+
+
+sub usage
+{
+ print "Usage:\n";
+ print "\n";
+ print "$pname [options]\n";
+ print "\n";
+ print "Options:\n";
+ print " -a <ip> IP address or hostname of switch\n";
+ print " -h usage\n";
+ print " -l <name> Login name\n";
+ print " -n <num> Port number to disable\n";
+ print " -o <string> Action: disable (default), enable or metadata\n";
+ print " -p <string> Password for login\n";
+ print " -S <path> Script to run to retrieve login password\n";
+ print " -q quiet mode\n";
+ print " -V version\n";
+
+ exit 0;
+}
+
+sub fail
+{
+ ($msg) = @_;
+ print $msg."\n" unless defined $opt_q;
+ $t->close if defined $t;
+ exit 1;
+}
+
+sub fail_usage
+{
+ ($msg)=@_;
+ print STDERR $msg."\n" if $msg;
+ print STDERR "Please use '-h' for usage.\n";
+ exit 1;
+}
+
+sub version
+{
+ print "$pname $RELEASE_VERSION $BUILD_DATE\n";
+ print "$REDHAT_COPYRIGHT\n" if ( $REDHAT_COPYRIGHT );
+
+ exit 0;
+}
+
+sub print_metadata
+{
+print '<?xml version="1.0" ?>
+<resource-agent name="fence_mcdata" shortdesc="I/O Fencing agent for McData FC switches" >
+<longdesc>
+fence_mcdata is an I/O Fencing agent which can be used with McData FC switches. It logs into a McData switch via telnet and disables a specified port. Disabling the port which a machine is connected to effectively fences that machine. Lengthy telnet connections to the switch should be avoided while a GFS cluster is running because the connection will block any necessary fencing actions.
+
+After a fence operation has taken place the fenced machine can no longer connect to the McData FC switch. When the fenced machine is ready to be brought back into the GFS cluster (after reboot) the port on the McData FC switch needs to be enabled. This can be done by running fence_mcdata and specifying the enable action.
+</longdesc>
+<vendor-url>http://www.brocade.com</vendor-url>
+<parameters>
+ <parameter name="action" unique="1" required="1">
+ <getopt mixed="-o [action]" />
+ <content type="string" default="disable" />
+ <shortdesc lang="en">Fencing Action</shortdesc>
+ </parameter>
+ <parameter name="ipaddr" unique="1" required="1">
+ <getopt mixed="-a [ip]" />
+ <content type="string" />
+ <shortdesc lang="en">IP Address or Hostname</shortdesc>
+ </parameter>
+ <parameter name="login" unique="1" required="1">
+ <getopt mixed="-l [name]" />
+ <content type="string" />
+ <shortdesc lang="en">Login Name</shortdesc>
+ </parameter>
+ <parameter name="passwd" unique="1" required="0">
+ <getopt mixed="-p [password]" />
+ <content type="string" />
+ <shortdesc lang="en">Login password or passphrase</shortdesc>
+ </parameter>
+ <parameter name="passwd_script" unique="1" required="0">
+ <getopt mixed="-S [script]" />
+ <content type="string" />
+ <shortdesc lang="en">Script to retrieve password</shortdesc>
+ </parameter>
+ <parameter name="port" unique="1" required="1">
+ <getopt mixed="-n [id]" />
+ <content type="string" />
+ <shortdesc lang="en">Physical plug number or name of virtual machine</shortdesc>
+ </parameter>
+ <parameter name="help" unique="1" required="0">
+ <getopt mixed="-h" />
+ <content type="string" />
+ <shortdesc lang="en">Display help and exit</shortdesc>
+ </parameter>
+</parameters>
+<actions>
+ <action name="enable" />
+ <action name="disable" />
+ <action name="status" />
+ <action name="metadata" />
+</actions>
+</resource-agent>
+';
+}
+
+
+sub get_options_stdin
+{
+ my $opt;
+ my $line = 0;
+ while( defined($in = <>) )
+ {
+ $_ = $in;
+ chomp;
+
+ # strip leading and trailing whitespace
+ s/^\s*//;
+ s/\s*$//;
+
+ # skip comments
+ next if /^#/;
+
+ $line+=1;
+ $opt=$_;
+ next unless $opt;
+
+ ($name,$val)=split /\s*=\s*/, $opt;
+
+ if ( $name eq "" )
+ {
+ print STDERR "parse error: illegal name in option $line\n";
+ exit 2;
+ }
+
+ # DO NOTHING -- this field is used by fenced
+ elsif ($name eq "agent" ) { }
+
+ elsif ($name eq "ipaddr" )
+ {
+ $opt_a = $val;
+ }
+ elsif ($name eq "login" )
+ {
+ $opt_l = $val;
+ }
+ elsif (($name eq "option" ) || ($name eq "action"))
+ {
+ $opt_o = $val;
+ }
+ elsif ($name eq "passwd" )
+ {
+ $opt_p = $val;
+ }
+ elsif ($name eq "passwd_script" )
+ {
+ $opt_S = $val;
+ }
+ elsif ($name eq "port" )
+ {
+ $opt_n = $val;
+ }
+ }
+}
+
+sub telnet_error
+{
+ fail "failed: telnet returned: ".$t->errmsg;
+}
+
+######################################################################33
+# MAIN
+
+if (@ARGV > 0) {
+ getopts("a:hl:n:o:p:S:qV") || fail_usage ;
+
+ usage if defined $opt_h;
+ version if defined $opt_V;
+
+ fail_usage "Unknown parameter." if (@ARGV > 0);
+
+ if ((defined $opt_o) && ($opt_o =~ /metadata/i)) {
+ print_metadata();
+ exit 0;
+ }
+
+ fail_usage "No '-a' flag specified." unless defined $opt_a;
+ fail_usage "No '-n' flag specified." unless defined $opt_n;
+ fail_usage "No '-l' flag specified." unless defined $opt_l;
+
+ if (defined $opt_S) {
+ $pwd_script_out = `$opt_S`;
+ chomp($pwd_script_out);
+ if ($pwd_script_out) {
+ $opt_p = $pwd_script_out;
+ }
+ }
+
+ fail_usage "No '-p' or '-S' flag specified." unless defined $opt_p;
+ fail_usage "Unrecognised action '$opt_o' for '-o' flag"
+ unless $opt_o =~ /^(disable|enable)$/i;
+
+} else {
+ get_options_stdin();
+
+ if ((defined $opt_o) && ($opt_o =~ /metadata/i)) {
+ print_metadata();
+ exit 0;
+ }
+
+ fail "failed: no IP address" unless defined $opt_a;
+ fail "failed: no plug number" unless defined $opt_n;
+ fail "failed: no login name" unless defined $opt_l;
+
+ if (defined $opt_S) {
+ $pwd_script_out = `$opt_S`;
+ chomp($pwd_script_out);
+ if ($pwd_script_out) {
+ $opt_p = $pwd_script_out;
+ }
+ }
+
+ fail "failed: no password" unless defined $opt_p;
+ fail "failed: unrecognised action: $opt_o"
+ unless $opt_o =~ /^(disable|enable)$/i;
+}
+
+
+my $block=1;
+$_=$opt_o;
+if(/disable/)
+{
+ $block=1
+}
+elsif(/enable/)
+{
+ $block=0
+}
+else
+{
+ fail "failed: unrecognised action: $opt_o"
+}
+
+#
+# Set up and log in
+#
+
+$t = new Net::Telnet;
+
+$t->errmode(\&telnet_error);
+$t->open($opt_a);
+
+$t->waitfor('/sername:/');
+
+# Send Username
+$t->print($opt_l);
+
+# Send Password
+$t->waitfor('/assword:/');
+$t->print($opt_p);
+$t->waitfor('/\>/');
+
+#> # Set switch to comma delimited output
+#> $t->print("commadelim 1");
+#> $t->waitfor('/\>/');
+
+# Block/Unblock the desired port
+$t->print("config port blocked $opt_n $block");
+($text, $match) = $t->waitfor('/\>/');
+
+# Verfiy that the port has been blocked/unblocked
+$t->print("config port show $opt_n");
+($text, $match) = $t->waitfor('/\>/');
+
+# scan the port configurations to make sure that
+# the port is in the state we told it to be in
+#
+# Output from the prvious command will look like:
+#
+# Root> config port show 0
+#
+# Port Information
+# Port Number: 0
+# Name: name
+# Blocked: true
+# Extended Distance: false
+# Type: gPort
+#
+my $fail=1;
+
+ at lines = split /\n/,$text;
+foreach my $line (@lines)
+{
+ my $field = "";
+ my $b_state = "";
+
+ if ( $line =~ /^(.*):\s*(\S*)/ )
+ {
+ $field = $1;
+ $b_state = $2;
+ }
+ next unless ( $field eq "Blocked" );
+ if ( ($block && $b_state eq "true") ||
+ (!$block && $b_state eq "false") ||
+ ($block && $b_state eq "Blocked") ||
+ (!$block && $b_state eq "Unblocked") )
+ {
+ $fail = 0;
+ }
+ last;
+}
+
+# log out of the switch
+$t->print("logout");
+$t->close();
+
+if($fail)
+{
+ print "failed: unexpected port state\n" unless $opt_q;
+}
+else
+{
+ print "success: port $opt_n ".($block?"disabled":"enabled")."\n"
+ unless defined $opt_q;
+}
+
+exit $fail;
+
+
diff --git a/fence/agents/netio/Makefile.am b/fence/agents/netio/Makefile.am
new file mode 100644
index 0000000..3e1a1d9
--- /dev/null
+++ b/fence/agents/netio/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_netio
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/netio/fence_netio.py b/fence/agents/netio/fence_netio.py
new file mode 100755
index 0000000..ffb6e30
--- /dev/null
+++ b/fence/agents/netio/fence_netio.py
@@ -0,0 +1,119 @@
+#!/usr/bin/python
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION=""
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+def get_power_status(conn, options):
+ conn.send_eol("port %s" % options["--plug"])
+ re_status = re.compile("250 [01imt]")
+ conn.log_expect(options, re_status, int(options["--shell-timeout"]))
+ status = {
+ "0" : "off",
+ "1" : "on",
+ "i" : "reboot",
+ "m" : "manual",
+ "t" : "timer"
+ }[conn.after.split()[1]]
+
+ return status
+
+def set_power_status(conn, options):
+ action = {
+ "on" : "1",
+ "off" : "0",
+ "reboot" : "i"
+ }[options["--action"]]
+
+ conn.send_eol("port %s %s" % (options["--plug"], action))
+ conn.log_expect(options, "250 OK", int(options["--shell-timeout"]))
+
+def get_outlet_list(conn, options):
+ result = {}
+
+ try:
+ # the NETIO-230B has 4 ports, counting start at 1
+ for plug in ["1", "2", "3", "4"]:
+ conn.send_eol("port setup %s" % plug)
+ conn.log_expect(options, "250 .+", int(options["--shell-timeout"]))
+ # the name is enclosed in "", drop those with [1:-1]
+ name = conn.after.split()[1][1:-1]
+ result[plug] = (name, "unknown")
+ except Exception, exn:
+ print str(exn)
+
+ return result
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "port" ]
+
+ atexit.register(atexit_handler)
+
+ opt = process_input(device_opt)
+
+ # set default port for telnet only
+ if 0 == opt.has_key("--ipport"):
+ opt["--ipport"] = "1234"
+
+ opt["eol"] = "\r\n"
+ options = check_input(device_opt, opt)
+
+ docs = { }
+ docs["shortdesc"] = "I/O Fencing agent for Koukaam NETIO-230B"
+ docs["longdesc"] = "fence_netio is an I/O Fencing agent which can be \
+used with the Koukaam NETIO-230B Power Distribution Unit. It logs into \
+device via telnet and reboots a specified outlet. Lengthy telnet connections \
+should be avoided while a GFS cluster is running because the connection will \
+block any necessary fencing actions."
+ docs["vendorurl"] = "http://www.koukaam.se/"
+ show_docs(options, docs)
+
+ ##
+ ## Operate the fencing device
+ ## We can not use fence_login(), username and passwd are sent on one line
+ ####
+ try:
+ try:
+ conn = fspawn(options, TELNET_PATH)
+ conn.send("set binary\n")
+ conn.send("open %s -%s\n"%(options["--ip"], options["--ipport"]))
+ except pexpect.ExceptionPexpect, ex:
+ sys.stderr.write(str(ex) + "\n")
+ sys.stderr.write("Due to limitations, binary dependencies on fence agents "
+ "are not in the spec file and must be installed separately." + "\n")
+ sys.exit(EC_GENERIC_ERROR)
+
+ screen = conn.read_nonblocking(size=100, timeout=int(options["--shell-timeout"]))
+ conn.log_expect(options, "100 HELLO .*", int(options["--shell-timeout"]))
+ conn.send_eol("login %s %s" % (options["--username"], options["--password"]))
+ conn.log_expect(options, "250 OK", int(options["--shell-timeout"]))
+ except pexpect.EOF:
+ fail(EC_LOGIN_DENIED)
+ except pexpect.TIMEOUT:
+ fail(EC_LOGIN_DENIED)
+ result = fence_action(conn, options, set_power_status, get_power_status, get_outlet_list)
+
+ ##
+ ## Logout from system
+ ##
+ ## In some special unspecified cases it is possible that
+ ## connection will be closed before we run close(). This is not
+ ## a problem because everything is checked before.
+ ######
+ try:
+ conn.send("quit\n")
+ conn.log_expect(options, "110 BYE", int(options["--shell-timeout"]))
+ conn.close()
+ except:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/ovh/Makefile.am b/fence/agents/ovh/Makefile.am
new file mode 100644
index 0000000..c6d7d01
--- /dev/null
+++ b/fence/agents/ovh/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_ovh
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/ovh/fence_ovh.py b/fence/agents/ovh/fence_ovh.py
new file mode 100644
index 0000000..2ec3fa0
--- /dev/null
+++ b/fence/agents/ovh/fence_ovh.py
@@ -0,0 +1,144 @@
+#!/usr/bin/python
+# Copyright 2013 Adrian Gibanel Lopez (bTactic)
+# Adrian Gibanel improved this script at 2013 to add verification of success and to output metadata
+
+# Based on:
+# This is a fence agent for use at OVH
+# As there are no other fence devices available, we must use OVH's SOAP API #Quick-and-dirty
+# assemled by Dennis Busch, secofor GmbH, Germany
+# This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.
+
+import sys, time
+import shutil, tempfile
+from datetime import datetime
+from suds.client import Client
+from suds.xsd.doctor import ImportDoctor, Import
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+OVH_RESCUE_PRO_NETBOOT_ID = '28'
+OVH_HARD_DISK_NETBOOT_ID = '1'
+
+STATUS_HARD_DISK_SLEEP = 240 # Wait 4 minutes to SO to boot
+STATUS_RESCUE_PRO_SLEEP = 150 # Wait 2 minutes 30 seconds to Rescue-Pro to run
+
+def define_new_opts():
+ all_opt["email"] = {
+ "getopt" : "Z:",
+ "longopt" : "email",
+ "help" : "-Z, --email=<email> email for reboot message: admin at domain.com",
+ "required" : "1",
+ "shortdesc" : "Reboot email",
+ "default" : "",
+ "order" : 1 }
+
+def netboot_reboot(options, mode):
+ conn = soap_login(options)
+
+ # dedicatedNetbootModifyById changes the mode of the next reboot
+ conn.service.dedicatedNetbootModifyById(options["session"], options["--plug"], mode, '', options["--email"])
+
+ # dedicatedHardRebootDo initiates a hard reboot on the given node
+ conn.service.dedicatedHardRebootDo(options["session"], options["--plug"], 'Fencing initiated by cluster', '', 'en')
+
+ conn.logout(options["session"])
+
+def reboot_time(options):
+ conn = soap_login(options)
+
+ result = conn.service.dedicatedHardRebootStatus(options["session"], options["--plug"])
+ tmpstart = datetime.strptime(result.start,'%Y-%m-%d %H:%M:%S')
+ tmpend = datetime.strptime(result.end,'%Y-%m-%d %H:%M:%S')
+ result.start = tmpstart
+ result.end = tmpend
+
+ conn.logout(options["session"])
+
+ return result
+
+def soap_login(options):
+ imp = Import('http://schemas.xmlsoap.org/soap/encoding/')
+ url = 'https://www.ovh.com/soapi/soapi-re-1.59.wsdl'
+ imp.filter.add('http://soapi.ovh.com/manager')
+ d = ImportDoctor(imp)
+
+ tmp_dir = tempfile.mkdtemp()
+ tempfile.tempdir = tmp_dir
+ atexit.register(remove_tmp_dir, tmp_dir)
+
+ try:
+ soap = Client(url, doctor=d)
+ session = soap.service.login(options["--username"], options["--password"], 'en', 0)
+ except Exception, ex:
+ fail(EC_LOGIN_DENIED)
+
+ options["session"] = session
+ return soap
+
+def remove_tmp_dir(tmp_dir):
+ shutil.rmtree(tmp_dir)
+
+def main():
+ device_opt = [ "login", "passwd", "port", "email" ]
+
+ atexit.register(atexit_handler)
+
+ define_new_opts()
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for OVH"
+ docs["longdesc"] = "fence_ovh is an Power Fencing agent \
+which can be used within OVH datecentre. \
+Poweroff is simulated with a reboot into rescue-pro mode."
+
+ docs["vendorurl"] = "http://www.ovh.net"
+ show_docs(options, docs)
+
+ if options["--action"] in [ "list", "status"]:
+ fail_usage("Action '" + options["--action"] + "' is not supported in this fence agent")
+
+ if options["--plug"].endswith(".ovh.net") == False:
+ options["--plug"] += ".ovh.net"
+
+ if options.has_key("--email") == False:
+ fail_usage("You have to enter e-mail address which is notified by fence agent")
+
+ # Save datetime just before changing netboot
+ before_netboot_reboot = datetime.now()
+
+ if options["--action"] == 'off':
+ # Reboot in Rescue-pro
+ netboot_reboot(options,OVH_RESCUE_PRO_NETBOOT_ID)
+ time.sleep(STATUS_RESCUE_PRO_SLEEP)
+ elif options["--action"] in ['on', 'reboot' ]:
+ # Reboot from HD
+ netboot_reboot(options,OVH_HARD_DISK_NETBOOT_ID)
+ time.sleep(STATUS_HARD_DISK_SLEEP)
+
+ # Save datetime just after reboot
+ after_netboot_reboot = datetime.now()
+
+ # Verify that action was completed sucesfully
+ reboot_t = reboot_time(options)
+
+ if options.has_key("--verbose"):
+ options["debug_fh"].write("reboot_start_end.start: "+ reboot_t.start.strftime('%Y-%m-%d %H:%M:%S')+"\n")
+ options["debug_fh"].write("before_netboot_reboot: " + before_netboot_reboot.strftime('%Y-%m-%d %H:%M:%S')+"\n")
+ options["debug_fh"].write("reboot_start_end.end: " + reboot_t.end.strftime('%Y-%m-%d %H:%M:%S')+"\n")
+ options["debug_fh"].write("after_netboot_reboot: " + after_netboot_reboot.strftime('%Y-%m-%d %H:%M:%S')+"\n")
+
+ if reboot_t.start < after_netboot_reboot < reboot_t.end:
+ result = 0
+ if options.has_key("--verbose"):
+ options["debug_fh"].write("Netboot reboot went OK.\n")
+ else:
+ result = 1
+ if options.has_key("--verbose"):
+ options["debug_fh"].write("ERROR: Netboot reboot wasn't OK.\n")
+
+ sys.exit(result)
+
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/rackswitch/Makefile.am b/fence/agents/rackswitch/Makefile.am
new file mode 100644
index 0000000..8c435c0
--- /dev/null
+++ b/fence/agents/rackswitch/Makefile.am
@@ -0,0 +1,16 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_rackswitch
+
+sbin_PROGRAMS = $(TARGET)
+
+noinst_HEADERS = do_rack.h
+
+fence_rackswitch_SOURCES = do_rack.c
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencemanc.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/rackswitch/do_rack.c b/fence/agents/rackswitch/do_rack.c
new file mode 100644
index 0000000..ee29153
--- /dev/null
+++ b/fence/agents/rackswitch/do_rack.c
@@ -0,0 +1,807 @@
+#include "clusterautoconfig.h"
+
+#include "do_rack.h"
+
+const char *pname = "fence_rack";
+
+int quiet_flag = 0;
+int verbose_flag = 0;
+int debug_flag = 0;
+
+char ipaddr[256];
+char portnumber[256];
+char username[256];
+char password[256];
+char arg[256];
+char name[256];
+char pwd_script[PATH_MAX] = { 0, };
+
+char readbuf[MAXBUF];
+char writebuf[MAXBUF];
+int sock;
+
+char op_login = 0x7e; /* 126*/
+char op_action = 0x66; /* 102 */
+char ack_login = 0x7D; /* 125 */
+
+char action_idle = 0x00;
+char action_reset = 0x01;
+char action_off = 0x02;
+char action_offon = 0x03;
+
+char configuration_request = 0x5b; /* 91 */
+char config_reply = 0x5c; /* 92 */
+char config_general = 0x01;
+char config_section1 = 0x02;
+char config_section2 = 0x03;
+char config_section3 = 0x04;
+
+char message_status = 0x65; /* 101 */
+
+char login_deny = 0xFF;
+
+int time_out = 60;
+
+void ignore_message_status(void);
+int wait_frame(char);
+
+/*
+ * scan input, waiting for a given frame
+ */
+int wait_frame(char frame_id)
+{
+ int read_more = 1;
+ int success = 0;
+ int n;
+ char target = frame_id;
+
+ if(debug_flag){printf("%s: Looking for frametype 0x%.2x\n",name,target);}
+ read_more = 1;
+ while(read_more){
+ n = read(sock,readbuf,1);
+ if(debug_flag){printf("%s: Found frametype 0x%.2x\n",name,readbuf[0]);}
+ if(readbuf[0] == target){
+ read_more = 0;
+ success = 1;
+ }
+ else{
+ if(readbuf[0] == message_status){
+ ignore_message_status();
+ read_more = 1;
+ }
+ else{
+ if(debug_flag){printf("%s: Got unexpected frame from switch\n",name);}
+ read_more = 0;
+ success = 0;
+ }
+ }
+ }
+ return(success);
+}
+
+void ignore_message_status(void)
+{
+ int n,i;
+ int read_more = 1;
+ int number_of_temp;
+ int number_of_config_mobo;
+
+ if(debug_flag){printf("%s: Ignoring message-status\n",name);}
+ read_more=1;
+ while(read_more){
+ n = read(sock,readbuf,1); /* status */
+ if(n == 1)
+ read_more = 0;
+ }
+
+ read_more = 1;
+ while(read_more){ /* Date & time */
+ n = read(sock,readbuf,1);
+ if(readbuf[0] == '\0'){
+ read_more = 0;
+ }
+ else{
+ read_more = 1;
+ }
+ }
+
+ read_more = 1;
+ number_of_temp = 0;
+ n = read(sock,readbuf,1); /* Temprature Input count */
+ number_of_temp = (int)readbuf[0];
+
+ for(i=0;i<number_of_temp;i++){
+ read_more = 1;
+ while(read_more){
+ n = read(sock,readbuf,1); /* Temprature input ID */
+ n = read(sock,readbuf,8); /* Temprature Value, Fahrenheit */
+ n = read(sock,readbuf,8); /* Temprature Vaule, Celcius */
+ n = read(sock,readbuf,1); /* Temprature Alarm */
+ }
+ }
+ number_of_config_mobo = 0;
+ for(i=4;i>0;i--){
+ read_more = 1;
+ while(read_more){
+ n=read(sock,readbuf,1);
+ if(n == 1){
+ read_more = 0;
+ number_of_config_mobo = number_of_config_mobo + (int)(readbuf[0]<<(8*(i-1)));
+ }
+ }
+ }
+ for(i=0;i<number_of_config_mobo;i++){
+ n = read(sock,readbuf,4); /* Motherboard ID */
+ n = read(sock,readbuf,1); /* Motherboard status */
+ }
+}
+
+
+
+static void print_usage(void)
+{
+ printf("Usage:\n");
+ printf("\n");
+ printf("%s [options]\n"
+ "\n"
+ "Options:\n"
+ " -h usage\n"
+ " -a <ip> IP address for RackSwitch\n"
+ " -n <dec num> Physical plug number on RackSwitch\n"
+ " -l <string> Username\n"
+ " -p <string> Password\n"
+ " -S <path> Script to retrieve password\n"
+ " -v Verbose\n"
+ " -q Quiet\n"
+ " -V Version information\n", pname);
+}
+
+
+
+static void print_metadata(void)
+{
+ printf("<?xml version=\"1.0\" ?>\n"
+ "<resource-agent name=\"fence_rackswitch\" shortdesc=\"fence_rackswitch - I/O Fencing agent for RackSaver RackSwitch\" >\n"
+ "<longdesc>fence_rackswitch is an I/O Fencing agent which can be used with the RackSaver RackSwitch. It logs into the RackSwitch and boots a specified plug. Using the http interface to the RackSwitch should be avoided while a GFS cluster is running because the connection may interfere with the operation of this agent.</longdesc>\n"
+ "<vendor-url>http://www.bladenetwork.net</vendor-url>\n"
+ "<parameters>\n"
+ "<parameter name=\"ipaddr\" unique=\"1\" required=\"1\">\n"
+ "\t<getopt mixed=\"-a [ip]\" />\n"
+ "\t<content type=\"string\" />\n"
+ "\t<shortdesc lang=\"en\">IP Address or Hostname</shortdesc>\n"
+ "</parameter>\n"
+ "<parameter name=\"login\" unique=\"1\" required=\"1\">\n"
+ "\t<getopt mixed=\"-l [name]\" />\n"
+ "\t<content type=\"string\" />\n"
+ "\t<shortdesc lang=\"en\">Login Name</shortdesc>\n"
+ "</parameter>\n"
+ "<parameter name=\"passwd\" unique=\"1\" required=\"0\">\n"
+ "\t<getopt mixed=\"-p [password]\" />\n"
+ "\t<content type=\"string\" />\n"
+ "\t<shortdesc lang=\"en\">Login password or passphrase</shortdesc>\n"
+ "</parameter>\n"
+ "<parameter name=\"passwd_script\" unique=\"1\" required=\"0\">\n"
+ "\t<getopt mixed=\"-S [script]\" />\n"
+ "\t<content type=\"string\" />\n"
+ "\t<shortdesc lang=\"en\">Script to retrieve password</shortdesc>\n"
+ "</parameter>\n"
+ "</parameters>\n"
+ "<actions>\n"
+ "\t<action name=\"metadata\" />\n"
+ "</actions>\n"
+ "</resource-agent>\n");
+}
+
+static void get_options(int argc, char **argv)
+{
+ int c;
+ char *value;
+
+ if (argc > 1){
+ /*
+ * Command line input
+ */
+ while ((c = getopt(argc, argv, "ha:n:l:p:S:vqVdo:")) != -1)
+ {
+ switch(c)
+ {
+ case 'h':
+ print_usage();
+ exit(DID_SUCCESS);
+
+ case 'a':
+ strncpy(ipaddr,optarg,254);
+ break;
+
+ case 'n':
+ strncpy(portnumber,optarg,254);
+ break;
+
+ case 'l':
+ strncpy(username,optarg,254);
+ break;
+
+ case 'p':
+ strncpy(password,optarg,254);
+ break;
+
+ case 'S':
+ strncpy(pwd_script, optarg, sizeof(pwd_script));
+ pwd_script[sizeof(pwd_script) - 1] = '\0';
+ break;
+
+ case 'v':
+ verbose_flag = 1;
+ break;
+
+ case 'q':
+ quiet_flag = 1;
+ break;
+
+ case 'd':
+ debug_flag = 1;
+ break;
+
+ case 'V':
+ printf("%s %s (built %s %s)\n", pname, VERSION,
+ __DATE__, __TIME__);
+ printf("%s\n", REDHAT_COPYRIGHT);
+ exit(DID_SUCCESS);
+ break;
+
+ case ':':
+ case '?':
+ fprintf(stderr, "Please use '-h' for usage.\n");
+ exit(DID_FAILURE);
+ break;
+
+ case 'o':
+ if (strncasecmp(optarg, "metadata", 254) == 0) {
+ print_metadata();
+ exit(DID_SUCCESS);
+ } else {
+ fprintf(stderr, "Only 'metadata' option is aviable for this fence agent\n");
+ exit(DID_FAILURE);
+ }
+ break;
+
+ default:
+ fprintf(stderr, "Bad programmer! You forgot to catch the %c flag\n", c);
+ exit(DID_FAILURE);
+ break;
+
+ }
+ }
+ strcpy(name, pname);
+ }
+ else{
+ errno = 0;
+ while(fgets(arg, 256, stdin) != NULL){
+ if( (value = strchr(arg, '\n')) == NULL){
+ fprintf(stderr, "line too long: '%s'\n", arg);
+ exit(DID_FAILURE);
+ }
+ *value = 0;
+ if( (value = strchr(arg, '=')) == NULL){
+ /* in this agent we can ignore options without value
+ * as we don't need any of them, here. But we should
+ * accept and ignore them.
+ */
+ fprintf(stderr, "invalid input: '%s'\n", arg);
+ continue;
+ }
+ *value = 0;
+ value++;
+ /* bahfuck. "agent" is not passed to us anyway
+ * if (!strcmp(arg, "agent")){
+ * strcpy(name, value);
+ * pname = name;
+ *}
+ */
+ strcpy(name, pname);
+ if (!strcmp(arg, "ipaddr"))
+ strcpy(ipaddr, value);
+
+ if (!strcmp(arg, "action"))
+ if (strncasecmp(value, "metadata", 254) == 0) {
+ print_metadata();
+ exit(DID_SUCCESS);
+ } else {
+ fprintf(stderr, "Only 'metadata' option is aviable for this fence agent\n");
+ exit(DID_FAILURE);
+ }
+
+ if (!strcmp(arg, "portnumber"))
+ strcpy(portnumber, value);
+
+ if (!strcmp(arg, "username"))
+ strcpy(username, value);
+
+ if (!strcmp(arg, "password"))
+ strcpy(password, value);
+
+ if (!strcasecmp(arg, "passwd_script")) {
+ strncpy(pwd_script, optarg, sizeof(pwd_script));
+ pwd_script[sizeof(pwd_script) - 1] = '\0';
+ }
+ }
+ errno = 0;
+
+ }
+
+ if (pwd_script[0] != '\0') {
+ FILE *fp;
+ char pwd_buf[1024];
+
+ fp = popen(pwd_script, "r");
+ if (fp != NULL) {
+ ssize_t len = fread(pwd_buf, 1, sizeof(pwd_buf), fp);
+ if (len > 0) {
+ char *p;
+ p = strchr(pwd_buf, '\n');
+ if (p != NULL)
+ *p = '\0';
+ p = strchr(pwd_buf, '\r');
+ if (p != NULL)
+ *p = '\0';
+ strncpy(password, pwd_buf, sizeof(password));
+ password[sizeof(password) - 1] = '\0';
+ }
+ pclose(fp);
+ }
+ }
+}
+
+static void sig_alarm(int sig)
+{
+ if(!quiet_flag){
+ fprintf(stderr,"failed: %s: Timeout, nothing happened for %d seconds.\n", pname, time_out);
+ fprintf(stderr,"failed: %s: Perhaps you should inspect the RackSwitch at %s\n",pname,ipaddr);
+ }
+ exit(DID_FAILURE);
+}
+
+
+int main(int argc, char **argv)
+{
+ int n,i,j,pnumb;
+ int ip_portnumber = 1025;
+ char boardnum = 0x00;
+ /*char number_of_action = 0x01;*/
+ int number_of_config_mobo = 0;
+ int number_of_section_config_mobo = 0;
+ int exit_status= 0;
+ int success_off = 0;
+ /*int success_on = 0;*/
+ int read_more = 1;
+ struct sockaddr_in rackaddr;
+
+ /*char mobo_enabled = 0x01;*/
+ /*char mobo_default_status = 0x00;*/
+ /*char mobo_output_status = 0x00;*/
+ int this_mobo = 0;
+ /*int mobo_id = 0;*/
+ /*int our_mobo = 0;*/
+ int number_of_temp = 0;
+
+ memset(arg, 0, 256);
+ memset(name, 0, 256);
+ memset(ipaddr, 0, 256);
+ memset(portnumber,0,256);
+ memset(username,0,256);
+ memset(password,0,256);
+
+ /*
+ * Ensure that we always get out of the fencing agent
+ * even if things get fucked up and we get no replies
+ */
+ signal(SIGALRM, &sig_alarm);
+ alarm(time_out);
+ get_options(argc, argv);
+
+ if(name[0] == '\0')
+ {
+ if(!quiet_flag)
+ fprintf(stderr,"failed: no name for this program\n");
+ exit(DID_FAILURE);
+ }
+
+ if(ipaddr[0] == '\0')
+ {
+ if(!quiet_flag)
+ fprintf(stderr,"failed: %s, no IP address given\n",name);
+ exit(DID_FAILURE);
+ }
+ if (portnumber[0] == '\0')
+ {
+ if(!quiet_flag)
+ fprintf(stderr,"failed: %s, no portnumber given\n",name);
+ exit(DID_FAILURE);
+ }
+ if (username[0] == '\0')
+ {
+ if(!quiet_flag)
+ fprintf(stderr,"failed: %s, no username given\n",name);
+ exit(DID_FAILURE);
+ }
+
+ if (password[0] == '\0')
+ {
+ if(!quiet_flag)
+ fprintf(stderr,"failed: %s, no password given\n",name);
+ exit(DID_FAILURE);
+ }
+ /*
+ * Port number given to us as a string.
+ * Does the number make sense?
+ */
+ pnumb = 0;
+ for(n=0;(portnumber[n]!='\0');n++){
+ if((portnumber[n] < 48) || (portnumber[n] > 57)){
+ if(!quiet_flag)
+ fprintf(stderr,"failed: %s, invalid port number\n",name);
+ exit(1);
+ }
+ pnumb = ((pnumb * 10) + ((int)(portnumber[n]) - 48));
+ }
+ /*
+ * what section of the rack is this port part of?
+ * The switch has 4 "subsections", called boardnum here
+ */
+ if((pnumb > 0) && (pnumb < 47))
+ boardnum = 0x02;
+ if((pnumb > 46) && (pnumb < 94))
+ boardnum = 0x03;
+ if((pnumb > 93) && (pnumb < 137))
+ boardnum = 0x04;
+ if((pnumb < 1) || (pnumb> 136)){
+ boardnum = 0x00;
+ if(!quiet_flag)
+ fprintf(stderr,"failed: %s, the portnumber given is not in the range [1 - 136]\n",name);
+ exit(DID_FAILURE);
+ }
+ /*********************************************
+ ***
+ *** set up TCP connection to the rackswitch
+ ***
+ ********************************************/
+ if ((sock = socket(AF_INET,SOCK_STREAM,0)) < 0){
+ fprintf(stderr,"failed: %s: socket error, %s\n",name,strerror(errno));
+ exit(DID_FAILURE);
+ }
+
+ bzero(&rackaddr,sizeof(rackaddr));
+ rackaddr.sin_family = AF_INET;
+ rackaddr.sin_port = htons(ip_portnumber);
+
+ if(inet_pton(AF_INET,ipaddr,&rackaddr.sin_addr) <= 0){
+ fprintf(stderr,"failed: %s: inet_pton error\n", name);
+ }
+
+ if(connect(sock,(SA *) &rackaddr,sizeof(rackaddr)) < 0){
+ fprintf(stderr,"failed: %s: connect error to %s, %s\n", name, ipaddr,strerror(errno));
+ exit(DID_FAILURE);
+ }
+ /**********************************************
+ ***
+ *** Send Login Frame
+ ***
+ *********************************************/
+ writebuf[0] = op_login;
+
+ for(n=0;n<=(strlen(username));n++){
+ writebuf[sizeof(char)+n] = username[n];
+ }
+ writebuf[sizeof(char)+(strlen(username))+1] ='\n';
+
+ for(n=0;n<=(strlen(password))+1;n++){
+ writebuf[sizeof(char)+strlen(username)+1+n] = password[n];
+ }
+ writebuf[sizeof(char)+(strlen(username))+1+(strlen(password))+1] ='\n';
+
+ if(write(sock,writebuf,sizeof(char)+strlen(username)+strlen(password)+2) < 0) {
+ fprintf(stderr,"failed to write to socket\n");
+ exit(DID_FAILURE);
+ }
+
+ /********************************************
+ ***
+ *** Read Login Reply
+ ***
+ *******************************************/
+ if(wait_frame(ack_login)){
+ n=read(sock,readbuf,1);
+ if(readbuf[0] == login_deny){
+ if(!quiet_flag){fprintf(stderr,"failed: %s: Not able to log into RackSwitch\n",name);}
+ exit(DID_FAILURE);
+ }
+ else{
+ if(verbose_flag){printf("%s: Successfully logged into RackSwitch\n",name);}
+ }
+ }
+
+ /********************************************
+ ***
+ *** Send Configuration Request Message
+ ***
+ *******************************************/
+
+ writebuf[0] = configuration_request;
+ writebuf[1] = config_general;
+ if(write(sock,writebuf,2*(sizeof(char))) < 0) {
+ fprintf(stderr,"failed to write to socket\n");
+ exit(DID_FAILURE);
+ }
+
+ /********************************************
+ ***
+ *** Read General Configuration Message
+ ***
+ *******************************************/
+
+ if(wait_frame(config_reply)){
+ n = read(sock,readbuf,1);
+ if(readbuf[0] == config_general){
+
+ /* Configuration Status, one byte */
+ n = read(sock,readbuf,1);
+
+ /* Switch description, string */
+ read_more = 1;
+ while(read_more){
+ n = read(sock,readbuf,1);
+ if(readbuf[0] == '\0'){
+ read_more = 0;
+ }
+ else{
+ read_more = 1;
+ }
+ }
+
+ /* Serial number, string */
+ read_more = 1;
+ while(read_more){
+ n = read(sock,readbuf,1);
+ if(readbuf[0] == '\0'){
+ read_more = 0;
+ }
+ else{
+ read_more = 1;
+ }
+ }
+
+ /* Version number, string */
+ read_more = 1;
+ while(read_more){
+ n = read(sock,readbuf,1);
+ if(readbuf[0] == '\0'){
+ read_more = 0;
+ }
+ else{
+ read_more = 1;
+ }
+ }
+
+ /* number of configured temps, 1 byte */
+ number_of_temp = 0;
+ n = read(sock,readbuf,1);
+ number_of_temp = (int)readbuf[0];
+
+ for(i=0;i<number_of_temp;i++){
+
+ /* Temprature description, string */
+ read_more = 1;
+ while(read_more){
+ read_more = 1;
+ while(read_more){
+ n = read(sock,readbuf,1);
+ if(readbuf[0] == '\0'){
+ read_more = 0;
+ }
+ else{
+ read_more = 1;
+ }
+ }
+ }
+
+ n = read(sock,readbuf,1); /* Temprature input ID */
+ n = read(sock,readbuf,1); /* Tempratue unit */
+ n = read(sock,readbuf,8); /* Temprature HI alarm */
+ n = read(sock,readbuf,8); /* Temprature LO alarm */
+ n = read(sock,readbuf,1); /* Temprature HI Alarm */
+ n = read(sock,readbuf,1); /* Temprature LO Alarm */
+ n = read(sock,readbuf,1); /* Temprature Alarm email */
+ }
+ /* Number of configured motherboards */
+ number_of_config_mobo = 0;
+ for(i=4;i>0;i--){
+ read_more = 1;
+ while(read_more){
+ n=read(sock,readbuf,1);
+ if(n == 1){
+ read_more = 0;
+ number_of_config_mobo = number_of_config_mobo + (int)(readbuf[0]<<(8*(i-1)));
+ }
+ }
+ }
+ /*
+ * make sure the motherboard we are asked to turn of is configured
+ */
+ if(pnumb > number_of_config_mobo){
+ if(!quiet_flag){
+ fprintf(stderr,"failed: %s asked to reboot port %d, but there are only %d ports configured\n",name,pnumb,number_of_config_mobo);
+ exit(DID_FAILURE);
+ }
+ }
+ n = read(sock,readbuf,1); /* email alarms */
+ n = read(sock,readbuf,4); /* email alarm delay */
+
+ /* email addresses, string */
+ read_more = 1;
+ while(read_more){
+ n = read(sock,readbuf,1);
+ if(readbuf[0] == '\0'){
+ read_more = 0;
+ }
+ else{
+ read_more = 1;
+ }
+ }
+
+ n = read(sock,readbuf,4); /* reset action duration */
+ n = read(sock,readbuf,4); /* power off action duration */
+ n = read(sock,readbuf,4); /* power on action duration */
+ }
+ else{
+ if(debug_flag){fprintf(stderr,"failed: %s: Did not receive general configuration frame when requested\n",name);}
+ exit(DID_FAILURE);
+ }
+ }
+ else{
+ if(debug_flag){fprintf(stderr,"failed: %s: Did not receive configuration frame when requested\n",name);}
+ exit(DID_FAILURE);
+ }
+
+
+
+ /******************************************
+ ***
+ *** Send Action packet to switch
+ *** Off/On port <portnum>
+ ***
+ *****************************************/
+ memset(writebuf,0,sizeof(writebuf));
+ writebuf[0] = op_action;
+ writebuf[1] = (char)(number_of_config_mobo >> 24);
+ writebuf[2] = (char)(number_of_config_mobo >> 16);
+ writebuf[3] = (char)(number_of_config_mobo >> 8);
+ writebuf[4] = (char)(number_of_config_mobo);
+
+ writebuf[(pnumb*5)+0] = (char)(pnumb >> 24);
+ writebuf[(pnumb*5)+1] = (char)(pnumb >> 16);
+ writebuf[(pnumb*5)+2] = (char)(pnumb >> 8);
+ writebuf[(pnumb*5)+3] = (char)(pnumb);
+ writebuf[(pnumb*5)+4] = action_offon;
+
+ if(write(sock,writebuf,(pnumb*5)+5) < 0) {
+ fprintf(stderr,"failed to write to socket\n");
+ exit(DID_FAILURE);
+ }
+ if(verbose_flag){
+ printf("%s: sending action frame to switch:\n",name);
+ for(i=0;i<(pnumb*5)+5;i++)
+ printf("0x%.2x ",writebuf[i]);
+ printf("\n");
+ }
+
+ /******************************************
+ ***
+ *** Send Configuration Request packet to switch
+ ***
+ *****************************************/
+ memset(writebuf,0,sizeof(writebuf));
+ writebuf[0] = configuration_request;
+ writebuf[1] = boardnum;
+
+ if(write(sock,writebuf,2*(sizeof(char))) < 0) {
+ fprintf(stderr,"failed to write to socket\n");
+ exit(DID_FAILURE);
+ }
+ if(verbose_flag){
+ printf("%s: sending Request Configuration Frame from switch:\n",name);
+ printf("0x%.2x 0x%.2x\n",writebuf[0],writebuf[1]);
+ }
+
+ /*******************************************
+ ***
+ *** Read Switch Status Message
+ ***
+ ******************************************/
+ while(success_off == 0){
+ if(debug_flag){
+ printf("%s: Status does not indicate port %d being rebooted. Looking again\n",name,pnumb);}
+ if(wait_frame(message_status)){
+ n = read(sock,readbuf,1); /* Rackswitch status */
+
+ read_more = 1;
+ while(read_more){ /* Date & time */
+ n = read(sock,readbuf,1);
+ if(readbuf[0] == '\0'){
+ read_more = 0;
+ }
+ else{
+ read_more = 1;
+ }
+ }
+ number_of_temp = 0;
+ n = read(sock,readbuf,1);
+ number_of_temp = readbuf[0];
+ for(i=0;i<number_of_temp;i++){
+ read_more = 1;
+ while(read_more){
+ n = read(sock,readbuf,1); /* Temprature input ID */
+ n = read(sock,readbuf,8); /* Temprature Value, Fahrenheit */
+ n = read(sock,readbuf,8); /* Temprature Vaule, Celcius */
+ n = read(sock,readbuf,1); /* Temprature Alarm */
+ }
+ }
+
+ /* number of motherboards, 4 byte */
+ number_of_section_config_mobo = 0;
+ for(i=4;i>0;i--){
+ read_more = 1;
+ while(read_more){
+ n=read(sock,readbuf,1);
+ if(n == 1){
+ read_more = 0;
+ number_of_section_config_mobo = number_of_section_config_mobo + (int)(readbuf[0]<<(8*(i-1)));
+ }
+ }
+ }
+
+ for(i=0;i<number_of_section_config_mobo;i++){
+
+ this_mobo = 0;
+ for(j=4;j>0;j--){
+ read_more = 1;
+ while(read_more){
+ n=read(sock,readbuf,1);
+ if(n == 1){
+ read_more = 0;
+ this_mobo = this_mobo + (int)(readbuf[0]<<(8*(j-1)));
+ }
+ }
+ }
+ if(debug_flag){printf("%s: port %d is currently ",name,this_mobo);}
+ n = read(sock,readbuf,1); /* Motherboard status */
+ if(debug_flag){printf("0x%.2x\n",readbuf[0]);}
+ if((pnumb == this_mobo) && ((readbuf[0] == 0x02)||(readbuf[0] == 0x03))){
+ success_off = 1;
+ if(verbose_flag){printf("%s: Status shows port %d being rebooted\n",name,this_mobo);}
+ }
+ } /* end number_of_section_mobo loop */
+ if(!success_off){
+ if(verbose_flag){printf("%s: Status shows port %d NOT being rebooted, asking for status again\n",name,pnumb);}
+ }
+ }
+ else{
+ if(debug_flag){fprintf(stderr,"%s: Did not receive Switch Status Message\n",name);}
+ exit(DID_FAILURE);
+ }
+ }
+
+
+ if(success_off){
+ if(!quiet_flag){
+ printf("success: %s: successfully told RackSwitch to reboot port %d\n",name,pnumb);
+ }
+ alarm(0);
+ exit_status = DID_SUCCESS;
+ }
+ return(exit_status);
+}
+/* And that is it. There is no more.
+ * Maybe there should be more?
+ * Or maybe not?
+ * But there is no more
+ */
diff --git a/fence/agents/rackswitch/do_rack.h b/fence/agents/rackswitch/do_rack.h
new file mode 100644
index 0000000..63c1365
--- /dev/null
+++ b/fence/agents/rackswitch/do_rack.h
@@ -0,0 +1,27 @@
+
+#include <unistd.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <limits.h>
+#include <fcntl.h>
+#include <errno.h>
+#include <ctype.h>
+
+#include <sys/socket.h>
+#include <sys/types.h>
+
+#include <arpa/inet.h>
+
+#include <signal.h>
+
+#include "copyright.cf"
+
+#define SA struct sockaddr
+
+
+#define MAXBUF 1200
+
+#define DID_SUCCESS 0
+#define DID_FAILURE 1
+
diff --git a/fence/agents/rhevm/Makefile.am b/fence/agents/rhevm/Makefile.am
new file mode 100644
index 0000000..9552181
--- /dev/null
+++ b/fence/agents/rhevm/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_rhevm
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/rhevm/fence_rhevm.py b/fence/agents/rhevm/fence_rhevm.py
new file mode 100644
index 0000000..d7fc326
--- /dev/null
+++ b/fence/agents/rhevm/fence_rhevm.py
@@ -0,0 +1,127 @@
+#!/usr/bin/python
+
+import sys, re
+import pycurl, StringIO
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="New RHEV-M Agent - test release on steroids"
+REDHAT_COPYRIGHT=""
+BUILD_DATE="March, 2008"
+#END_VERSION_GENERATION
+
+
+RE_GET_ID = re.compile("<vm( .*)? id=\"(.*?)\"", re.IGNORECASE)
+RE_STATUS = re.compile("<state>(.*?)</state>", re.IGNORECASE)
+RE_GET_NAME = re.compile("<name>(.*?)</name>", re.IGNORECASE)
+
+def get_power_status(conn, options):
+ ### Obtain real ID from name
+ res = send_command(options, "vms/?search=name%3D" + options["--plug"])
+
+ result = RE_GET_ID.search(res)
+ if (result == None):
+ # Unable to obtain ID needed to access virtual machine
+ fail(EC_STATUS)
+
+ options["id"] = result.group(2)
+
+ result = RE_STATUS.search(res)
+ if (result == None):
+ # We were able to parse ID so output is correct
+ # in some cases it is possible that RHEV-M output does not
+ # contain <status> line. We can assume machine is OFF then
+ return "off"
+ else:
+ status = result.group(1)
+
+ if (status.lower() == "down"):
+ return "off"
+ else:
+ return "on"
+
+def set_power_status(conn, options):
+ action = {
+ 'on' : "start",
+ 'off' : "stop"
+ }[options["--action"]]
+
+ url = "vms/" + options["id"] + "/" + action
+ res = send_command(options, url, "POST")
+
+def get_list(conn, options):
+ outlets = { }
+
+ try:
+ res = send_command(options, "vms")
+
+ lines = res.split("<vm ")
+ for i in range(1, len(lines)):
+ name = RE_GET_NAME.search(lines[i]).group(1)
+ outlets[name] = ("", None)
+ except AttributeError:
+ return { }
+ except IndexError:
+ return { }
+
+ return outlets
+
+def send_command(opt, command, method = "GET"):
+ ## setup correct URL
+ if opt.has_key("--ssl"):
+ url = "https:"
+ else:
+ url = "http:"
+
+ url += "//" + opt["--ip"] + ":" + str(opt["--ipport"]) + "/api/" + command
+
+ ## send command through pycurl
+ c = pycurl.Curl()
+ b = StringIO.StringIO()
+ c.setopt(pycurl.URL, url)
+ c.setopt(pycurl.HTTPHEADER, [ "Content-type: application/xml", "Accept: application/xml" ])
+ c.setopt(pycurl.HTTPAUTH, pycurl.HTTPAUTH_BASIC)
+ c.setopt(pycurl.USERPWD, opt["--username"] + ":" + opt["--password"])
+ c.setopt(pycurl.TIMEOUT, int(opt["--shell-timeout"]))
+ c.setopt(pycurl.SSL_VERIFYPEER, 0)
+ c.setopt(pycurl.SSL_VERIFYHOST, 0)
+
+ if (method == "POST"):
+ c.setopt(pycurl.POSTFIELDS, "<action />")
+
+ c.setopt(pycurl.WRITEFUNCTION, b.write)
+ c.perform()
+ result = b.getvalue()
+
+ if opt["log"] >= LOG_MODE_VERBOSE:
+ opt["debug_fh"].write(command + "\n")
+ opt["debug_fh"].write(result + "\n")
+
+ return result
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "ssl", "web", "port" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["power_wait"]["default"] = "1"
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for RHEV-M REST API"
+ docs["longdesc"] = "fence_rhevm is an I/O Fencing agent which can be \
+used with RHEV-M REST API to fence virtual machines."
+ docs["vendorurl"] = "http://www.redhat.com"
+ show_docs(options, docs)
+
+ ##
+ ## Fence operations
+ ####
+ result = fence_action(None, options, set_power_status, get_power_status, get_list)
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/rsa/Makefile.am b/fence/agents/rsa/Makefile.am
new file mode 100644
index 0000000..4bf1f1f
--- /dev/null
+++ b/fence/agents/rsa/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_rsa
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/rsa/fence_rsa.py b/fence/agents/rsa/fence_rsa.py
new file mode 100644
index 0000000..117dd67
--- /dev/null
+++ b/fence/agents/rsa/fence_rsa.py
@@ -0,0 +1,77 @@
+#!/usr/bin/python
+
+#####
+##
+## The Following Agent Has Been Tested On:
+## Main GFEP25A & Boot GFBP25A
+##
+#####
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="New RSA2 Agent - test release on steroids"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+def get_power_status(conn, options):
+ conn.send_eol("power state")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ match = re.compile("Power: (.*)", re.IGNORECASE).search(conn.before)
+ if (match != None):
+ status = match.group(1)
+ else:
+ status = "undefined"
+
+ return status.lower().strip()
+
+def set_power_status(conn, options):
+ conn.send_eol("power " + options["--action"])
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "cmd_prompt", "secure" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["login_timeout"]["default"] = 10
+ all_opt["cmd_prompt"]["default"] = [ ">" ]
+ # This device will not allow us to login even with LANG=C
+ all_opt["ssh_options"]["default"] = "-F /dev/null"
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for IBM RSA"
+ docs["longdesc"] = "fence_rsa is an I/O Fencing agent \
+which can be used with the IBM RSA II management interface. It \
+logs into an RSA II device via telnet and reboots the associated \
+machine. Lengthy telnet connections to the RSA II device should \
+be avoided while a GFS cluster is running because the connection \
+will block any necessary fencing actions."
+ docs["vendorurl"] = "http://www.ibm.com"
+ show_docs(options, docs)
+
+ ##
+ ## Operate the fencing device
+ ######
+ conn = fence_login(options)
+ result = fence_action(conn, options, set_power_status, get_power_status, None)
+
+ ##
+ ## Logout from system
+ ######
+ try:
+ conn.send_eol("exit")
+ conn.close()
+ except:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/rsb/Makefile.am b/fence/agents/rsb/Makefile.am
new file mode 100644
index 0000000..939db98
--- /dev/null
+++ b/fence/agents/rsb/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_rsb
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/rsb/fence_rsb.py b/fence/agents/rsb/fence_rsb.py
new file mode 100755
index 0000000..da60a61
--- /dev/null
+++ b/fence/agents/rsb/fence_rsb.py
@@ -0,0 +1,86 @@
+#!/usr/bin/python
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION=""
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+def get_power_status(conn, options):
+ conn.send("2")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ status = re.compile("Power Status[\s]*: (on|off)", re.IGNORECASE).search(conn.before).group(1)
+ conn.send("0")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ return (status.lower().strip())
+
+def set_power_status(conn, options):
+ action = {
+ 'on' : "4",
+ 'off': "1"
+ }[options["--action"]]
+
+ conn.send("2")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ conn.send_eol(action)
+ conn.log_expect(options, ["want to power off", "'yes' or 'no'"], int(options["--shell-timeout"]))
+ conn.send_eol("yes")
+ conn.log_expect(options, "any key to continue", int(options["--power-timeout"]))
+ conn.send_eol("")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ conn.send_eol("0")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "secure", "cmd_prompt" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["cmd_prompt"]["default"] = [ "to quit:" ]
+
+ opt = process_input(device_opt)
+
+ # set default port for telnet only
+ if 0 == opt.has_key("--ssh") and 0 == opt.has_key("--ipport"):
+ opt["--ipport"] = "3172"
+
+ options = check_input(device_opt, opt)
+
+ docs = { }
+ docs["shortdesc"] = "I/O Fencing agent for Fujitsu-Siemens RSB"
+ docs["longdesc"] = "fence_rsb is an I/O Fencing agent \
+which can be used with the Fujitsu-Siemens RSB management interface. It logs \
+into device via telnet/ssh and reboots a specified outlet. Lengthy telnet/ssh \
+connections should be avoided while a GFS cluster is running because the connection \
+will block any necessary fencing actions."
+ docs["vendorurl"] = "http://www.fujitsu.com"
+ show_docs(options, docs)
+
+ ##
+ ## Operate the fencing device
+ ####
+ conn = fence_login(options)
+ result = fence_action(conn, options, set_power_status, get_power_status, None)
+
+ ##
+ ## Logout from system
+ ##
+ ## In some special unspecified cases it is possible that
+ ## connection will be closed before we run close(). This is not
+ ## a problem because everything is checked before.
+ ######
+ try:
+ conn.send_eol("0")
+ conn.close()
+ except:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/sanbox2/Makefile.am b/fence/agents/sanbox2/Makefile.am
new file mode 100644
index 0000000..9564bc8
--- /dev/null
+++ b/fence/agents/sanbox2/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_sanbox2
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/sanbox2/fence_sanbox2.py b/fence/agents/sanbox2/fence_sanbox2.py
new file mode 100644
index 0000000..5221d49
--- /dev/null
+++ b/fence/agents/sanbox2/fence_sanbox2.py
@@ -0,0 +1,152 @@
+#!/usr/bin/python
+
+#####
+##
+## The Following Agent Has Been Tested On:
+##
+## Version Firmware
+## +-----------------+---------------------------+
+#####
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="New Sanbox2 Agent - test release on steroids"
+REDHAT_COPYRIGHT=""
+BUILD_DATE="March, 2008"
+#END_VERSION_GENERATION
+
+def get_power_status(conn, options):
+ status_trans = {
+ 'online' : "on",
+ 'offline' : "off"
+ }
+ try:
+ conn.send_eol("show port " + options["--plug"])
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ except pexpect.TIMEOUT:
+ try:
+ conn.send_eol("admin end")
+ conn.send_eol("exit")
+ conn.close()
+ except:
+ pass
+ fail(EC_TIMED_OUT)
+
+ status = re.compile(".*AdminState\s+(online|offline)\s+", re.IGNORECASE | re.MULTILINE).search(conn.before).group(1)
+
+ try:
+ return status_trans[status.lower().strip()]
+ except KeyError:
+ return "PROBLEM"
+
+def set_power_status(conn, options):
+ action = {
+ 'on' : "online",
+ 'off' : "offline"
+ }[options["--action"]]
+
+ try:
+ conn.send_eol("set port " + options["--plug"] + " state " + action)
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+ except pexpect.TIMEOUT:
+ try:
+ conn.send_eol("admin end")
+ conn.send_eol("exit")
+ conn.close()
+ except:
+ pass
+ fail(EC_TIMED_OUT)
+
+ try:
+ conn.send_eol("set port " + options["--plug"] + " state " + action)
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+ except pexpect.TIMEOUT:
+ try:
+ conn.send_eol("admin end")
+ conn.send_eol("exit")
+ conn.close()
+ except:
+ pass
+ fail(EC_TIMED_OUT)
+
+def get_list_devices(conn, options):
+ outlets = { }
+
+ try:
+ conn.send_eol("show port")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ list_re = re.compile("^\s+(\d+?)\s+(Online|Offline)\s+", re.IGNORECASE)
+ for line in conn.before.splitlines():
+ if (list_re.search(line)):
+ status = {
+ 'online' : "ON",
+ 'offline' : "OFF"
+ }[list_re.search(line).group(2).lower()]
+ outlets[list_re.search(line).group(1)] = ("", status)
+
+ except pexpect.TIMEOUT:
+ try:
+ conn.send_eol("admin end")
+ conn.send_eol("exit")
+ conn.close()
+ except:
+ pass
+ fail(EC_TIMED_OUT)
+
+ return outlets
+
+def main():
+ device_opt = [ "fabric_fencing", "ipaddr", "login", "passwd", "cmd_prompt", "port" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["cmd_prompt"]["default"] = [ " #> " ]
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for QLogic SANBox2 FC switches"
+ docs["longdesc"] = "fence_sanbox2 is an I/O Fencing agent which can be used with \
+QLogic SANBox2 FC switches. It logs into a SANBox2 switch via telnet and disables a specified \
+port. Disabling the port which a machine is connected to effectively fences that machine. \
+Lengthy telnet connections to the switch should be avoided while a GFS cluster is running \
+because the connection will block any necessary fencing actions."
+ docs["vendorurl"] = "http://www.qlogic.com"
+ show_docs(options, docs)
+
+ ##
+ ## Operate the fencing device
+ ##
+ conn = fence_login(options)
+
+ conn.send_eol("admin start")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ if (re.search("\(admin\)", conn.before, re.MULTILINE) == None):
+ ## Someone else is in admin section, we can't enable/disable
+ ## ports so we will rather exit
+ sys.stderr.write("Failed: Unable to switch to admin section\n")
+ sys.exit(EC_GENERIC_ERROR)
+
+ result = fence_action(conn, options, set_power_status, get_power_status, get_list_devices)
+
+ ##
+ ## Logout from system
+ ######
+ try:
+ conn.send_eol("admin end")
+ conn.send_eol("exit\n")
+ conn.close()
+ except exceptions.OSError:
+ pass
+ except pexpect.ExceptionPexpect:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/scsi/Makefile.am b/fence/agents/scsi/Makefile.am
new file mode 100644
index 0000000..5652bda
--- /dev/null
+++ b/fence/agents/scsi/Makefile.am
@@ -0,0 +1,21 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_scsi
+
+SRC = $(TARGET).pl
+
+EXTRA_DIST = $(SRC) \
+ $(TARGET)_check.pl
+
+scsidatadir = $(CLUSTERDATA)
+
+scsidata_SCRIPTS = $(TARGET)_check.pl
+
+sbin_SCRIPTS = $(TARGET)
+
+dist_man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+
+clean-local:
+ rm -f $(TARGET)
diff --git a/fence/agents/scsi/fence_scsi.8 b/fence/agents/scsi/fence_scsi.8
new file mode 100644
index 0000000..180de4f
--- /dev/null
+++ b/fence/agents/scsi/fence_scsi.8
@@ -0,0 +1,119 @@
+.TH fence_scsi 8
+
+.SH NAME
+fence_scsi - I/O fencing agent for SCSI persistent reservations
+
+.SH SYNOPSIS
+.B
+fence_scsi
+[\fIOPTION\fR]...
+
+.SH DESCRIPTION
+fence_scsi is an I/O fencing agent that uses SCSI-3 persistent
+reservations to control access to shared storage devices. These
+devices must support SCSI-3 persistent reservations (SPC-3 or greater)
+as well as the "preempt-and-abort" subcommand.
+
+The fence_scsi agent works by having each node in the cluster register
+a unique key with the SCSI devive(s). Once registered, a single node
+will become the reservation holder by creating a "write exclusive,
+registrants only" reservation on the device(s). The result is that
+only registered nodes may write to the device(s). When a node failure
+occurs, the fence_scsi agent will remove the key belonging to the
+failed node from the device(s). The failed node will no longer be able
+to write to the device(s). A manual reboot is required. In the cluster
+environment unfence action should be configured also.
+
+Keys are either be specified manually (see -k option) or generated
+automatically (see -n option). Automatic key generation requires that
+cman be running. Keys will then be generated using the cluster ID and
+node ID such that each node has a unique key that can be determined by
+any other node in the cluster.
+
+Devices can either be specified manually (see -d option) or discovered
+automatically. Multiple devices can be specified manually by using a
+comma-separated list. If no devices are specified, the fence_scsi
+agent will attempt to discover devices by looking for cluster volumes
+and extracting the underlying devices. Devices may be device-mapper
+multipath devices or raw devices. If using a device-mapper multipath
+device, the fence_scsi agent will find the underlying devices (paths)
+and created registrations for each path.
+
+.SH OPTIONS
+.TP
+\fB-o\fP \fIaction\fR
+Fencing action. This value can be "on", "off", "status", or
+"metadata". The "on", "off", and "status" actions require either a key
+(see -k option) or node name (see -n option). For "on", the agent will
+attempt to register with the device(s) and create a reservation if
+none exists. The "off" action will attempt to remove a node's key from
+the device(s). The "status" action will report whether or not a node's
+key is currently register with one or more of the devices. The
+"metadata" action will display the XML metadata. The default action if
+"off".
+.TP
+\fB-d\fP \fIdevices\fR
+List of devices to use for current operation. Devices can be
+comma-separated list of raw device (eg. /dev/sdc) or device-mapper
+multipath devices (eg. /dev/dm-3). Each device must support SCSI-3
+persistent reservations.
+.TP
+\fB-f\fP \fIlogfile\fR
+Log output to file.
+.TP
+\fB-n\fP \fInodename\fR
+Name of the node to be fenced. The node name is used to generate the
+key value used for the current operation. This option will be ignored
+when used with the -k option.
+.TP
+\fB-k\fP \fIkey\fR
+Key to use for the current operation. This key should be unique to a
+node. For the "on" action, the key specifies the key use to register
+the local node. For the "off" action, this key specifies the key to be
+removed from the device(s).
+.TP
+\fB-H\fP \fIdelay\fR
+Wait X seconds before fencing is started (Default Value: 0)
+
+.TP
+\fB-a\fP
+Use the APTPL flag for registrations. This option is only used for the
+"on" action.
+.TP
+\fB-h\fP
+Print out a help message describing available options, then exit.
+.TP
+\fB-v\fP
+Verbose output.
+.TP
+\fB-V\fP
+Print out a version message, then exit.
+
+.SH STDIN PARAMETERS
+.TP
+\fIagent = "param"\fR
+This option is used by fence_node(8) and is ignored by fence_scsi.
+.TP
+\fInodename = "param"\fR
+Same as -n option.
+.TP
+\fIaction = "param" \fR
+Same as -o option.
+.TP
+\fIdevices = "param"\fR
+Same as -d option.
+.TP
+\fIlogfile = "param"\fR
+Same as -f option
+.TP
+\fIkey = "param"\fR
+Same as -k option.
+.TP
+\fIdelay = "param"\fR
+Same as -H option.
+.TP
+\fIaptpl = "1"
+Enable the APTPL flag. Default is 0 (disable).
+
+.SH SEE ALSO
+fence(8), fence_node(8), sg_persist(8), vgs(8), cman_tool(8), cman(5)
diff --git a/fence/agents/scsi/fence_scsi.pl b/fence/agents/scsi/fence_scsi.pl
new file mode 100644
index 0000000..6808ff5
--- /dev/null
+++ b/fence/agents/scsi/fence_scsi.pl
@@ -0,0 +1,875 @@
+#!/usr/bin/perl
+
+use Cwd 'realpath';
+use File::Basename;
+use File::Path;
+use Getopt::Std;
+use POSIX;
+use B;
+
+#BEGIN_VERSION_GENERATION
+$RELEASE_VERSION="";
+$REDHAT_COPYRIGHT="";
+$BUILD_DATE="";
+#END_VERSION_GENERATION
+
+my $ME = fileparse ($0, ".pl");
+
+################################################################################
+
+sub log_debug ($)
+{
+ my $time = strftime "%b %e %T", localtime;
+ my ($msg) = @_;
+
+ print STDOUT "$time $ME: [debug] $msg\n" unless defined ($opt_q);
+
+ return;
+}
+
+sub log_error ($)
+{
+ my $time = strftime "%b %e %T", localtime;
+ my ($msg) = @_;
+
+ print STDERR "$time $ME: [error] $msg\n" unless defined ($opt_q);
+
+ exit (1);
+}
+
+sub do_action_on ($@)
+{
+ my $self = (caller(0))[3];
+ my ($node_key, @devices) = @_;
+
+ key_write ($node_key);
+
+ foreach $dev (@devices) {
+ log_error ("device $dev does not exist") if (! -e $dev);
+ log_error ("device $dev is not a block device") if (! -b $dev);
+
+ if (do_register_ignore ($node_key, $dev) != 0) {
+ log_error ("failed to create registration (key=$node_key, device=$dev)");
+ }
+
+ if (!get_reservation_key ($dev)) {
+ if (do_reserve ($node_key, $dev) != 0) {
+ if (!get_reservation_key ($dev)) {
+ log_error ("failed to create reservation (key=$node_key, device=$dev)");
+ }
+ }
+ }
+ }
+
+ return;
+}
+
+sub do_action_off ($@)
+{
+ my $self = (caller(0))[3];
+ my ($node_key, @devices) = @_;
+
+ my $host_key = key_read ();
+
+ if ($host_key eq $node_key) {
+ log_error ($self);
+ }
+
+ foreach $dev (@devices) {
+ log_error ("device $dev does not exist") if (! -e $dev);
+ log_error ("device $dev is not a block device") if (! -b $dev);
+
+ my @keys = grep { /^$node_key$/i } get_registration_keys ($dev);
+
+ if (scalar (@keys) != 0) {
+ do_preempt_abort ($host_key, $node_key, $dev);
+ }
+ }
+
+ return;
+}
+
+sub do_action_status ($@)
+{
+ my $self = (caller(0))[3];
+ my ($node_key, @devices) = @_;
+
+ my $dev_count = 0;
+ my $key_count = 0;
+
+ foreach $dev (@devices) {
+ log_error ("device $dev does not exist") if (! -e $dev);
+ log_error ("device $dev is not a block device") if (! -b $dev);
+
+ do_reset ($dev);
+
+ my @keys = grep { /^$node_key$/i } get_registration_keys ($dev);
+
+ if (scalar (@keys) != 0) {
+ $dev_count++;
+ }
+ }
+
+ if ($dev_count != 0) {
+ exit (0);
+ } else {
+ exit (2);
+ }
+}
+
+sub do_verify_on ($@)
+{
+ my $self = (caller(0))[3];
+ my ($node_key, @devices) = @_;
+ my $count = 0;
+
+ for $dev (@devices) {
+ my @keys = grep { /^$node_key$/i } get_registration_keys ($dev);
+
+ ## check that our key is registered
+ if (scalar (@keys) == 0) {
+ log_debug ("failed to register key $node_key on device $dev");
+ $count++;
+ next;
+ }
+
+ ## write dev to device file once registration is verified
+ dev_write ($dev);
+
+ ## check that a reservation exists
+ if (!get_reservation_key ($dev)) {
+ log_debug ("no reservation exists on device $dev");
+ $count++;
+ }
+ }
+
+ if ($count != 0) {
+ log_error ("$self: failed to verify $count devices");
+ }
+}
+
+sub do_verify_off ($@)
+{
+ my $self = (caller(0))[3];
+ my ($node_key, @devices) = @_;
+ my $count = 0;
+
+ for $dev (@devices) {
+ my @keys = grep { /^$node_key$/i } get_registration_keys ($dev);
+
+ ## check that our key is not registered
+ if (scalar (@keys) != 0) {
+ log_debug ("failed to remove key $node_key from device $dev");
+ $count++;
+ next;
+ }
+
+ ## check that a reservation exists
+ if (!get_reservation_key ($dev)) {
+ log_debug ("no reservation exists on device $dev");
+ $count++;
+ }
+ }
+
+ if ($count != 0) {
+ log_error ("$self: failed to verify $count devices");
+ }
+}
+
+sub do_register ($$$)
+{
+ my $self = (caller(0))[3];
+ my ($host_key, $node_key, $dev) = @_;
+
+ $dev = realpath ($dev);
+
+ if (substr ($dev, 5) =~ /^dm/) {
+ my @slaves = get_mpath_slaves ($dev);
+ foreach (@slaves) {
+ do_register ($node_key, $_);
+ }
+ return;
+ }
+
+ log_debug ("$self (host_key=$host_key, node_key=$node_key, dev=$dev)");
+
+ my $cmd;
+ my $out;
+ my $err;
+
+ do_reset ($dev);
+
+ $cmd = "sg_persist -n -o -G -K $host_key -S $node_key -d $dev";
+ $cmd .= " -Z" if (defined $opt_a);
+ $out = qx { $cmd 2> /dev/null };
+ $err = ($?>>8);
+
+ # if ($err != 0) {
+ # log_error ("$self (err=$err)");
+ # }
+
+ log_debug ("$self (err=$err)");
+
+ return ($err);
+}
+
+sub do_register_ignore ($$)
+{
+ my $self = (caller(0))[3];
+ my ($node_key, $dev) = @_;
+
+ $dev = realpath ($dev);
+
+ if (substr ($dev, 5) =~ /^dm/) {
+ my @slaves = get_mpath_slaves ($dev);
+ foreach (@slaves) {
+ do_register_ignore ($node_key, $_);
+ }
+ return;
+ }
+
+ log_debug ("$self (node_key=$node_key, dev=$dev)");
+
+ my $cmd;
+ my $out;
+ my $err;
+
+ do_reset ($dev);
+
+ $cmd = "sg_persist -n -o -I -S $node_key -d $dev";
+ $cmd .= " -Z" if (defined $opt_a);
+ $out = qx { $cmd 2> /dev/null };
+ $err = ($?>>8);
+
+ # if ($err != 0) {
+ # log_error ("$self (err=$err)");
+ # }
+
+ log_debug ("$self (err=$err)");
+
+ return ($err);
+}
+
+sub do_reserve ($$)
+{
+ my $self = (caller(0))[3];
+ my ($host_key, $dev) = @_;
+
+ log_debug ("$self (host_key=$host_key, dev=$dev)");
+
+ my $cmd = "sg_persist -n -o -R -T 5 -K $host_key -d $dev";
+ my $out = qx { $cmd 2> /dev/null };
+ my $err = ($?>>8);
+
+ # if ($err != 0) {
+ # log_error ("$self (err=$err)");
+ # }
+
+ log_debug ("$self (err=$err)");
+
+ return ($err);
+}
+
+sub do_release ($$)
+{
+ my $self = (caller(0))[3];
+ my ($host_key, $dev) = @_;
+
+ log_debug ("$self (host_key=$host_key, dev=$dev)");
+
+ my $cmd = "sg_persist -n -o -L -T 5 -K $host_key -d $dev";
+ my $out = qx { $cmd 2> /dev/null };
+ my $err = ($?>>8);
+
+ # if ($err != 0) {
+ # log_error ("$self (err=$err)");
+ # }
+
+ log_debug ("$self (err=$err)");
+
+ return ($err);
+}
+
+sub do_preempt ($$$)
+{
+ my $self = (caller(0))[3];
+ my ($host_key, $node_key, $dev) = @_;
+
+ log_debug ("$self (host_key=$host_key, node_key=$node_key, dev=$dev)");
+
+ my $cmd = "sg_persist -n -o -P -T 5 -K $host_key -S $node_key -d $dev";
+ my $out = qx { $cmd 2> /dev/null };
+ my $err = ($?>>8);
+
+ # if ($err != 0) {
+ # log_error ("$self (err=$err)");
+ # }
+
+ log_debug ("$self (err=$err)");
+
+ return ($err);
+}
+
+sub do_preempt_abort ($$$)
+{
+ my $self = (caller(0))[3];
+ my ($host_key, $node_key, $dev) = @_;
+
+ log_debug ("$self (host_key=$host_key, node_key=$node_key, dev=$dev)");
+
+ my $cmd = "sg_persist -n -o -A -T 5 -K $host_key -S $node_key -d $dev";
+ my $out = qx { $cmd 2> /dev/null };
+ my $err = ($?>>8);
+
+ # if ($err != 0) {
+ # log_error ("$self (err=$err)");
+ # }
+
+ log_debug ("$self (err=$err)");
+
+ return ($err);
+}
+
+sub do_reset (S)
+{
+ my $self = (caller(0))[3];
+ my ($dev) = @_;
+
+ my $cmd = "sg_turs $dev";
+ my @out = qx { $cmd 2> /dev/null };
+ my $err = ($?>>8);
+
+ ## note that it is not necessarily an error is $err is non-zero,
+ ## so just log the device and status and continue.
+
+ log_debug ("$self (dev=$dev, status=$err)");
+
+ return ($err);
+}
+
+sub dev_unlink ()
+{
+ my $self = (caller(0))[3];
+ my $file = "/var/run/cluster/fence_scsi.dev";
+
+ if (-e $file) {
+ unlink ($file) or die "$!\n";
+ }
+
+ return;
+}
+
+sub dev_write ($)
+{
+ my $self = (caller(0))[3];
+ my $file = "/var/run/cluster/fence_scsi.dev";
+ my $dev = shift;
+
+ if (! -d "/var/run/cluster") {
+ mkpath ("/var/run/cluster");
+ }
+
+ open (\*FILE, "+>>$file") or die "$!\n";
+
+ ## since the file is opened for read, write and append,
+ ## we need to seek to the beginning of the file before grep.
+
+ seek (FILE, 0, 0);
+
+ if (! grep { /^$dev$/ } <FILE>) {
+ print FILE "$dev\n";
+ }
+
+ close (FILE);
+
+ return;
+}
+
+sub key_read ()
+{
+ my $self = (caller(0))[3];
+ my $file = "/var/run/cluster/fence_scsi.key";
+ my $key;
+
+ open (\*FILE, "<$file") or die "$!\n";
+ chomp ($key = <FILE>);
+ close (FILE);
+
+ return ($key);
+}
+
+sub key_write ($)
+{
+ my $self = (caller(0))[3];
+ my $file = "/var/run/cluster/fence_scsi.key";
+ my $key = shift;
+
+ if (! -d "/var/run/cluster") {
+ mkpath ("/var/run/cluster");
+ }
+
+ open (\*FILE, ">$file") or die "$!\n";
+ print FILE "$key\n";
+ close (FILE);
+
+ return;
+}
+
+sub get_key ($)
+{
+ my $self = (caller(0))[3];
+
+ my $key = sprintf ("%.4x%.4x", get_cluster_id (), get_node_id ($_[0]));
+
+ return ($key);
+}
+
+sub get_node_id ($)
+{
+ my $self = (caller(0))[3];
+ my $node = $_[0];
+
+ my $cmd = "/usr/sbin/corosync-cmapctl nodelist.";
+ my @out = qx { $cmd 2> /dev/null };
+ my $err = ($?>>8);
+
+ if ($err != 0) {
+ log_error ("$self (err=$err)");
+ }
+
+ # die "[error]: $self\n" if ($?>>8);
+
+ foreach my $line (@out) {
+ chomp($line);
+ if ($line =~ /.(\d+?).ring._addr \(str\) = ${node}$/) {
+ return $1;
+ }
+ }
+
+ log_error("$self (unable to parse output of corosync-cmapctl or node does not exist)");
+}
+
+sub get_cluster_id ()
+{
+ my $self = (caller(0))[3];
+ my $cluster_id;
+
+ my $cmd = "/usr/sbin/corosync-cmapctl totem.cluster_name";
+ my $out = qx { $cmd 2> /dev/null };
+ my $err = ($?>>8);
+
+ if ($err != 0) {
+ log_error ("$self (err=$err)");
+ }
+
+ # die "[error]: $self\n" if ($?>>8);
+
+ chomp($out);
+
+ if ($out =~ /=\s(.*?)$/) {
+ my $cluster_name = $1;
+ # tranform string to a number
+ $cluster_id = (hex B::hash($cluster_name)) % 65536;
+ } else {
+ log_error("$self (unable to parse output of corosync-cmapctl)");
+ }
+
+ return ($cluster_id);
+}
+
+sub get_devices_clvm ()
+{
+ my $self = (caller(0))[3];
+ my @devices;
+
+ my $cmd = "vgs --noheadings " .
+ " --separator : " .
+ " --sort pv_uuid " .
+ " --options vg_attr,pv_name " .
+ " --config 'global { locking_type = 0 } " .
+ " devices { preferred_names = [ \"^/dev/dm\" ] }'";
+
+ my @out = qx { $cmd 2> /dev/null };
+ my $err = ($?>>8);
+
+ if ($err != 0) {
+ log_error ("$self (err=$err)");
+ }
+
+ # die "[error]: $self\n" if ($?>>8);
+
+ foreach (@out) {
+ chomp;
+ my ($vg_attr, $pv_name) = split (/:/, $_);
+ if ($vg_attr =~ /c$/) {
+ push (@devices, $pv_name);
+ }
+ }
+
+ return (@devices);
+}
+
+sub get_devices_scsi ()
+{
+ my $self = (caller(0))[3];
+ my @devices;
+
+ opendir (\*DIR, "/sys/block/") or die "$!\n";
+ @devices = grep { /^sd/ } readdir (DIR);
+ closedir (DIR);
+
+ return (@devices);
+}
+
+sub get_mpath_name ($)
+{
+ my $self = (caller(0))[3];
+ my ($dev) = @_;
+ my $name;
+
+ if ($dev =~ /^\/dev\//) {
+ $dev = substr ($dev, 5);
+ }
+
+ open (\*FILE, "/sys/block/$dev/dm/name") or die "$!\n";
+ chomp ($name = <FILE>);
+ close (FILE);
+
+ return ($name);
+}
+
+sub get_mpath_uuid ($)
+{
+ my $self = (caller(0))[3];
+ my ($dev) = @_;
+ my $uuid;
+
+ if ($dev =~ /^\/dev\//) {
+ $dev = substr ($dev, 5);
+ }
+
+ open (\*FILE, "/sys/block/$dev/dm/uuid") or die "$!\n";
+ chomp ($uuid = <FILE>);
+ close (FILE);
+
+ return ($name);
+}
+
+sub get_mpath_slaves ($)
+{
+ my $self = (caller(0))[3];
+ my ($dev) = @_;
+ my @slaves;
+
+ if ($dev =~ /^\/dev\//) {
+ $dev = substr ($dev, 5);
+ }
+
+ opendir (\*DIR, "/sys/block/$dev/slaves/") or die "$!\n";
+
+ @slaves = grep { !/^\./ } readdir (DIR);
+ if ($slaves[0] =~ /^dm/) {
+ @slaves = get_mpath_slaves ($slaves[0]);
+ } else {
+ @slaves = map { "/dev/$_" } @slaves;
+ }
+
+ closedir (DIR);
+
+ return (@slaves);
+}
+
+sub get_registration_keys ($)
+{
+ my $self = (caller(0))[3];
+ my ($dev) = @_;
+ my @keys;
+
+ my $cmd = "sg_persist -n -i -k -d $dev";
+ my @out = qx { $cmd 2> /dev/null };
+ my $err = ($?>>8);
+
+ if ($err != 0) {
+ log_error ("$self (err=$err)");
+ }
+
+ # die "[error]: $self\n" if ($?>>8);
+
+ foreach (@out) {
+ chomp;
+ if ($_ =~ s/^\s+0x//i) {
+ push (@keys, $_);
+ }
+ }
+
+ return (@keys);
+}
+
+sub get_reservation_key ($)
+{
+ my $self = (caller(0))[3];
+ my ($dev) = @_;
+ my $key;
+
+ my $cmd = "sg_persist -n -i -r -d $dev";
+ my @out = qx { $cmd 2> /dev/null };
+ my $err = ($?>>8);
+
+ if ($err != 0) {
+ log_error ("$self (err=$err)");
+ }
+
+ # die "[error]: $self\n" if ($?>>8);
+
+ foreach (@out) {
+ chomp;
+ if ($_ =~ s/^\s+key=0x//i) {
+ $key = $_;
+ last;
+ }
+ }
+
+ return ($key)
+}
+
+sub get_options_stdin ()
+{
+ my $num = 0;
+
+ while (<STDIN>) {
+ chomp;
+ s/^\s*//;
+ s/\s*$//;
+
+ next if (/^#/);
+
+ $num++;
+
+ next unless ($_);
+
+ my ($opt, $arg) = split (/\s*=\s*/, $_);
+
+ if ($opt eq "") {
+ exit (1);
+ }
+ elsif ($opt eq "aptpl") {
+ $opt_a = $arg;
+ }
+ elsif ($opt eq "devices") {
+ $opt_d = $arg;
+ }
+ elsif ($opt eq "logfile") {
+ $opt_f = $arg;
+ }
+ elsif ($opt eq "key") {
+ $opt_k = $arg;
+ }
+ elsif ($opt eq "nodename") {
+ $opt_n = $arg;
+ }
+ elsif ($opt eq "action") {
+ $opt_o = $arg;
+ }
+ elsif ($opt eq "delay") {
+ $opt_H = $arg;
+ }
+ }
+}
+
+sub print_usage ()
+{
+ print "Usage:\n";
+ print "\n";
+ print "$ME [options]\n";
+ print "\n";
+ print "Options:\n";
+ print " -a Use APTPL flag\n";
+ print " -d <devices> Devices to be used for action\n";
+ print " -f <logfile> File to write debug/error output\n";
+ print " -H <timeout> Wait X seconds before fencing is started\n";
+ print " -h Usage\n";
+ print " -k <key> Key to be used for current action\n";
+ print " -n <nodename> Name of node to operate on\n";
+ print " -o <action> Action: off (default), on, or status\n";
+ print " -q Quiet mode\n";
+ print " -V Version\n";
+
+ exit (0);
+}
+
+sub print_version ()
+{
+ print "$ME $RELEASE_VERSION $BUILD_DATE\n";
+ print "$REDHAT_COPYRIGHT\n" if ( $REDHAT_COPYRIGHT );
+
+ exit (0);
+}
+
+sub print_metadata ()
+{
+ print "<?xml version=\"1.0\" ?>\n";
+ print "<resource-agent name=\"fence_scsi\"" .
+ " shortdesc=\"fence agent for SCSI-3 persistent reservations\">\n";
+ print "<longdesc>fence_scsi</longdesc>\n";
+ print "<vendor-url>http://www.t10.org</vendor-url>\n";
+ print "<parameters>\n";
+ print "\t<parameter name=\"aptpl\" unique=\"0\" required=\"0\">\n";
+ print "\t\t<getopt mixed=\"-a\"/>\n";
+ print "\t\t<content type=\"boolean\"/>\n";
+ print "\t\t<shortdesc lang=\"en\">" .
+ "Use APTPL flag for registrations" .
+ "</shortdesc>\n";
+ print "\t</parameter>\n";
+ print "\t<parameter name=\"devices\" unique=\"0\" required=\"0\">\n";
+ print "\t\t<getopt mixed=\"-d\"/>\n";
+ print "\t\t<content type=\"string\"/>\n";
+ print "\t\t<shortdesc lang=\"en\">" .
+ "List of devices to be used for fencing action" .
+ "</shortdesc>\n";
+ print "\t</parameter>\n";
+ print "\t<parameter name=\"logfile\" unique=\"0\" required=\"0\">\n";
+ print "\t\t<getopt mixed=\"-f\"/>\n";
+ print "\t\t<content type=\"string\"/>\n";
+ print "\t\t<shortdesc lang=\"en\">" .
+ "File to write error/debug messages" .
+ "</shortdesc>\n";
+ print "\t</parameter>\n";
+ print "\t<parameter name=\"delay\" unique=\"0\" required=\"0\">\n";
+ print "\t\t<getopt mixed=\"-H\"/>\n";
+ print "\t\t<content type=\"string\"/>\n";
+ print "\t\t<shortdesc lang=\"en\">" .
+ "Wait X seconds before fencing is started" .
+ "</shortdesc>\n";
+ print "\t</parameter>\n";
+ print "\t<parameter name=\"key\" unique=\"0\" required=\"0\">\n";
+ print "\t\t<getopt mixed=\"-k\"/>\n";
+ print "\t\t<content type=\"string\"/>\n";
+ print "\t\t<shortdesc lang=\"en\">" .
+ "Key value to be used for fencing action" .
+ "</shortdesc>\n";
+ print "\t</parameter>\n";
+ print "\t<parameter name=\"action\" unique=\"0\" required=\"0\">\n";
+ print "\t\t<getopt mixed=\"-o\"/>\n";
+ print "\t\t<content type=\"string\" default=\"off\"/>\n";
+ print "\t\t<shortdesc lang=\"en\">" .
+ "Fencing action" .
+ "</shortdesc>\n";
+ print "\t</parameter>\n";
+ print "\t<parameter name=\"nodename\" unique=\"0\" required=\"0\">\n";
+ print "\t\t<getopt mixed=\"-n\"/>\n";
+ print "\t\t<content type=\"string\"/>\n";
+ print "\t\t<shortdesc lang=\"en\">" .
+ "Name of node" .
+ "</shortdesc>\n";
+ print "\t</parameter>\n";
+ print "</parameters>\n";
+ print "<actions>\n";
+ print "\t<action name=\"on\" on_target=\"1\" automatic=\"1\"/>\n";
+ print "\t<action name=\"off\"/>\n";
+ print "\t<action name=\"status\"/>\n";
+ print "\t<action name=\"metadata\"/>\n";
+ print "</actions>\n";
+ print "</resource-agent>\n";
+
+ exit (0);
+}
+
+################################################################################
+
+if (@ARGV > 0) {
+ getopts ("ad:f:H:hk:n:o:qV") or print_usage;
+ print_usage if (defined $opt_h);
+ print_version if (defined $opt_V);
+} else {
+ get_options_stdin ();
+}
+
+## handle the metadata action here to avoid other parameter checks
+##
+if ($opt_o =~ /^metadata$/i) {
+ print_metadata;
+}
+
+## if the logfile (-f) parameter was specified, open the logfile
+## and redirect STDOUT and STDERR to the logfile.
+##
+if (defined $opt_f) {
+ open (LOG, ">>$opt_f") or die "$!\n";
+ open (STDOUT, ">&LOG");
+ open (STDERR, ">&LOG");
+}
+
+## verify that either key or nodename have been specified
+##
+if ((!defined $opt_n) && (!defined $opt_k)) {
+ print_usage ();
+}
+
+## determine key value
+##
+if (defined $opt_k) {
+ $key = $opt_k;
+} else {
+ $key = get_key ($opt_n);
+}
+
+## verify that key is not zero
+##
+if (hex($key) == 0) {
+ log_error ("key cannot be zero");
+}
+
+## remove any leading zeros from key
+##
+if ($key =~ /^0/) {
+ $key =~ s/^0+//;
+}
+
+## get devices
+##
+if (defined $opt_d) {
+ @devices = split (/\s*,\s*/, $opt_d);
+} else {
+ @devices = get_devices_clvm ();
+}
+
+## verify that device list is not empty
+##
+if (scalar (@devices) == 0) {
+ log_error ("no devices found");
+}
+
+## default action is "off"
+##
+if (!defined $opt_o) {
+ $opt_o = "off";
+}
+
+## Wait for defined period (-H / delay= )
+##
+if ((defined $opt_H) && ($opt_H =~ /^[0-9]+/)) {
+ sleep($opt_H);
+}
+
+## determine the action to perform
+##
+if ($opt_o =~ /^on$/i) {
+ do_action_on ($key, @devices);
+ do_verify_on ($key, @devices);
+}
+elsif ($opt_o =~ /^off$/i) {
+ do_action_off ($key, @devices);
+ do_verify_off ($key, @devices);
+}
+elsif ($opt_o =~ /^status/i) {
+ do_action_status ($key, @devices);
+} else {
+ log_error ("unknown action '$opt_o'");
+ exit (1);
+}
+
+## close the logfile
+##
+if (defined $opt_f) {
+ close (LOG);
+}
diff --git a/fence/agents/scsi/fence_scsi_check.pl b/fence/agents/scsi/fence_scsi_check.pl
new file mode 100644
index 0000000..9ecd7a5
--- /dev/null
+++ b/fence/agents/scsi/fence_scsi_check.pl
@@ -0,0 +1,170 @@
+#!/usr/bin/perl
+
+use POSIX;
+
+################################################################################
+
+my $dev_file = "/var/run/cluster/fence_scsi.dev";
+my $key_file = "/var/run/cluster/fence_scsi.key";
+
+################################################################################
+
+sub log_debug ($)
+{
+ my $time = strftime ("%b %e %T", localtime);
+ my $msg = shift;
+
+ print STDOUT "$time [$0] debug: $msg\n" if ($verbose);
+
+ return;
+}
+
+sub log_error ($)
+{
+ my $time = strftime ("%b %e %T", localtime);
+ my $msg = shift;
+
+ print STDERR "$time [$0] error: $msg\n";
+
+ return;
+}
+
+sub do_reset ($)
+{
+ my $dev = shift;
+
+ my $cmd = "sg_turs $dev";
+ my @out = qx { $cmd 2> /dev/null };
+
+ return;
+}
+
+sub get_registration_keys ($)
+{
+ my $dev = shift;
+ my @keys = ();
+
+ do_reset ($dev);
+
+ my $cmd = "sg_persist -n -i -k -d $dev";
+ my @out = qx { $cmd 2> /dev/null };
+
+ if ($?>>8 != 0) {
+ log_error ("$cmd");
+ exit (0);
+ }
+
+ foreach (@out) {
+ chomp;
+ if (s/^\s+0x//i) {
+ push (@keys, $_);
+ }
+ }
+
+ return (@keys);
+}
+
+sub get_reservation_keys ($)
+{
+ my $dev = shift;
+ my @keys = ();
+
+ do_reset ($dev);
+
+ my $cmd = "sg_persist -n -i -r -d $dev";
+ my @out = qx { $cmd 2> /dev/null };
+
+ if ($?>>8 != 0) {
+ log_error ("$cmd");
+ exit (0);
+ }
+
+ foreach (@out) {
+ chomp;
+ if (s/^\s+key=0x//i) {
+ push (@keys, $_);
+ }
+ }
+
+ return (@keys);
+}
+
+sub get_verbose ()
+{
+ open (\*FILE, "</etc/sysconfig/watchdog") or return;
+ chomp (my @opt = <FILE>);
+ close (FILE);
+
+ foreach (@opt) {
+ next if (/^#/);
+ next unless ($_);
+
+ if (/^verbose=yes$/i) {
+ return (1);
+ }
+ }
+
+ return (0);
+}
+
+sub key_read ()
+{
+ open (\*FILE, "<$key_file") or exit (0);
+ chomp (my $key = <FILE>);
+ close (FILE);
+
+ return ($key);
+}
+
+sub dev_read ()
+{
+ open (\*FILE, "<$dev_file") or exit (0);
+ chomp (my @dev = <FILE>);
+ close (FILE);
+
+ return (@dev);
+}
+
+################################################################################
+
+if ($ARGV[0] =~ /^repair$/i) {
+ exit ($ARGV[1]);
+}
+
+if (-e "/etc/sysconfig/watchdog") {
+ $verbose = get_verbose ();
+}
+
+if (! -e $dev_file) {
+ log_debug ("$dev_file does not exit");
+ exit (0);
+} elsif (-z $dev_file) {
+ log_debug ("$dev_file is empty");
+ exit (0);
+}
+
+if (! -e $key_file) {
+ log_debug ("$key_file does not exist");
+ exit (0);
+} elsif (-z $key_file) {
+ log_debug ("$key_file is empty");
+ exit (0);
+}
+
+my $key = key_read ();
+my @dev = dev_read ();
+
+foreach (@dev) {
+ my @keys = grep { /^$key$/i } get_registration_keys ($_);
+
+ if (scalar (@keys) != 0) {
+ log_debug ("key $key registered with device $_");
+ exit (0);
+ } else {
+ log_debug ("key $key not registered with device $_");
+ }
+}
+
+log_debug ("key $key not registered with any devices");
+
+exit (2);
diff --git a/fence/agents/virsh/Makefile.am b/fence/agents/virsh/Makefile.am
new file mode 100644
index 0000000..0f12744
--- /dev/null
+++ b/fence/agents/virsh/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_virsh
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/virsh/fence_virsh.py b/fence/agents/virsh/fence_virsh.py
new file mode 100644
index 0000000..1ec5310
--- /dev/null
+++ b/fence/agents/virsh/fence_virsh.py
@@ -0,0 +1,101 @@
+#!/usr/bin/python
+
+# The Following Agent Has Been Tested On:
+#
+# Virsh 0.3.3 on RHEL 5.2 with xen-3.0.3-51
+#
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="Virsh fence agent"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+def get_name_or_uuid(options):
+ return options["--uuid"] if options.has_key("--uuid") else options["--plug"]
+
+def get_outlets_status(conn, options):
+ if options.has_key("--use-sudo"):
+ prefix = SUDO_PATH + " "
+ else:
+ prefix = ""
+
+ conn.sendline(prefix + "virsh list --all")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ result = {}
+
+ #This is status of mini finite automata. 0 = we didn't found Id and Name, 1 = we did
+ fa_status = 0
+
+ for line in conn.before.splitlines():
+ domain = re.search("^\s*(\S+)\s+(\S+)\s+(\S+).*$", line)
+
+ if (domain!=None):
+ if ((fa_status==0) and (domain.group(1).lower()=="id") and (domain.group(2).lower()=="name")):
+ fa_status = 1
+ elif (fa_status==1):
+ result[domain.group(2)] = ("", (domain.group(3).lower() in ["running", "blocked", "idle", "no state", "paused"] and "on" or "off"))
+ return result
+
+def get_power_status(conn, options):
+ prefix = SUDO_PATH + " " if options.has_key("--use-sudo") else ""
+ conn.sendline(prefix + "virsh domstate %s" % (get_name_or_uuid(options)))
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+
+ for line in conn.before.splitlines():
+ if line.strip() in ["running", "blocked", "idle", "no state", "paused"]:
+ return "on"
+ if "error:" in line.strip():
+ fail_usage("Failed: You have to enter existing name/UUID of virtual machine!")
+
+ return "off"
+
+def set_power_status(conn, options):
+ prefix = SUDO_PATH + " " if options.has_key("--use-sudo") else ""
+ conn.sendline(prefix + "virsh %s "%(options["--action"] == "on" and "start" or "destroy") + get_name_or_uuid(options))
+
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+ time.sleep(int(options["--power-wait"]))
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "cmd_prompt", "secure", "port", "sudo" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["secure"]["default"] = "1"
+ all_opt["cmd_prompt"]["default"] = [ "\[EXPECT\]#\ " ]
+ all_opt["ssh_options"]["default"] = "-t '/bin/bash -c \"PS1=\[EXPECT\]#\ /bin/bash --noprofile --norc\"'"
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for virsh"
+ docs["longdesc"] = "fence_virsh is an I/O Fencing agent \
+which can be used with the virtual machines managed by libvirt. \
+It logs via ssh to a dom0 and there run virsh command, which does \
+all work. \
+\n.P\n\
+By default, virsh needs root account to do properly work. So you \
+must allow ssh login in your sshd_config."
+ docs["vendorurl"] = "http://libvirt.org"
+ show_docs(options, docs)
+
+ ## Operate the fencing device
+ conn = fence_login(options)
+ result = fence_action(conn, options, set_power_status, get_power_status, get_outlets_status)
+
+ ## Logout from system
+ try:
+ conn.sendline("quit")
+ conn.close()
+ except:
+ pass
+
+ sys.exit(result)
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/vixel/Makefile.am b/fence/agents/vixel/Makefile.am
new file mode 100644
index 0000000..3159e50
--- /dev/null
+++ b/fence/agents/vixel/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_vixel
+
+SRC = $(TARGET).pl
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fencemanperl.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/vixel/fence_vixel.pl b/fence/agents/vixel/fence_vixel.pl
new file mode 100644
index 0000000..2080909
--- /dev/null
+++ b/fence/agents/vixel/fence_vixel.pl
@@ -0,0 +1,267 @@
+#!/usr/bin/perl
+
+use Getopt::Std;
+use Net::Telnet ();
+
+my $ME = $0;
+
+END {
+ defined fileno STDOUT or return;
+ close STDOUT and return;
+ warn "$ME: failed to close standard output: $!\n";
+ $? ||= 1;
+}
+
+# Get the program name from $0 and strip directory names
+$_=$0;
+s/.*\///;
+my $pname = $_;
+
+# WARNING!! Do not add code bewteen "#BEGIN_VERSION_GENERATION" and
+# "#END_VERSION_GENERATION" It is generated by the Makefile
+
+#BEGIN_VERSION_GENERATION
+$RELEASE_VERSION="";
+$REDHAT_COPYRIGHT="";
+$BUILD_DATE="";
+#END_VERSION_GENERATION
+
+
+sub usage
+{
+ print "Usage:\n\n";
+ print "$pname [options]\n\n";
+ print "Options:\n";
+ print " -a <ip> IP address or hostname of switch\n";
+ print " -h Usage\n";
+ print " -o metadata print XML metadata for fence agent\n";
+ print " -n <num> Port number to disable\n";
+ print " -p <string> Password for login\n";
+ print " -S <path> Script to run to retrieve login password\n";
+ print " -V version\n\n";
+
+ exit 0;
+}
+
+sub fail
+{
+ ($msg) = @_;
+ print $msg."\n" unless defined $opt_q;
+ $t->close if defined $t;
+ exit 1;
+}
+
+sub fail_usage
+{
+ ($msg) = @_;
+ print STDERR $msg."\n" if $msg;
+ print STDERR "Please use '-h' for usage.\n";
+ exit 1;
+}
+
+sub version
+{
+ print "$pname $RELEASE_VERSION $BUILD_DATE\n";
+ print "$REDHAT_COPYRIGHT\n" if ( $REDHAT_COPYRIGHT );
+
+ exit 0;
+}
+
+sub print_metadata
+{
+print '<?xml version="1.0" ?>
+<resource-agent name="fence_vixel" shortdesc="I/O Fencing agent for Vixel FC switches" >
+<longdesc>
+fence_vixel is an I/O Fencing agent which can be used with Vixel FC switches. It logs into a Vixel switch via telnet and removes the specified port from the zone. Removing the zone access from the port disables the port from being able to access the storage.
+
+After a fence operation has taken place the fenced machine can no longer connect to the Vixel FC switch. When the fenced machine is ready to be brought back into the GFS cluster (after reboot) the port on the Vixel FC switch needs to be enabled. In order to do this, log into the Vixel FC switch. Then go to:
+
+config->zones->config [port] [comma-separated-list-of-ports-in-the-zone]
+
+Then apply. Consult the Vixel manual for details.
+</longdesc>
+<vendor-url>http://www.emulex.com</vendor-url>
+<parameters>
+ <parameter name="ipaddr" unique="1" required="1">
+ <getopt mixed="-a [ip]" />
+ <content type="string" />
+ <shortdesc lang="en">IP Address or Hostname</shortdesc>
+ </parameter>
+ <parameter name="passwd" unique="1" required="0">
+ <getopt mixed="-p [password]" />
+ <content type="string" />
+ <shortdesc lang="en">Login password or passphrase</shortdesc>
+ </parameter>
+ <parameter name="passwd_script" unique="1" required="0">
+ <getopt mixed="-S [script]" />
+ <content type="string" />
+ <shortdesc lang="en">Script to retrieve password</shortdesc>
+ </parameter>
+ <parameter name="port" unique="1" required="1">
+ <getopt mixed="-n [id]" />
+ <content type="string" />
+ <shortdesc lang="en">Physical plug number or name of virtual machine</shortdesc>
+ </parameter>
+ <parameter name="help" unique="1" required="0">
+ <getopt mixed="-h" />
+ <content type="string" />
+ <shortdesc lang="en">Display help and exit</shortdesc>
+ </parameter>
+</parameters>
+<actions>
+ <action name="metadata" />
+</actions>
+</resource-agent>
+';
+}
+
+
+if (@ARGV > 0) {
+ getopts("a:hn:p:S:Vo:") || fail_usage ;
+
+ usage if defined $opt_h;
+ version if defined $opt_V;
+
+ fail_usage "Unknown parameter." if (@ARGV > 0);
+
+ if ((defined $opt_o) && ($opt_o =~ /metadata/i)) {
+ print_metadata();
+ exit 0;
+ }
+
+ fail_usage "No '-a' flag specified." unless defined $opt_a;
+
+ if (defined $opt_S) {
+ $pwd_script_out = `$opt_S`;
+ chomp($pwd_script_out);
+ if ($pwd_script_out) {
+ $opt_p = $pwd_script_out;
+ }
+ }
+
+ fail_usage "No '-p' or '-S' flag specified." unless defined $opt_p;
+ fail_usage "No '-n' flag specified." unless defined $opt_n;
+
+} else {
+ get_options_stdin();
+
+ fail "failed: no IP address for the Vixel." unless defined $opt_a;
+
+ if (defined $opt_S) {
+ $pwd_script_out = `$opt_S`;
+ chomp($pwd_script_out);
+ if ($pwd_script_out) {
+ $opt_p = $pwd_script_out;
+ }
+ }
+
+ fail "failed: no password provided." unless defined $opt_p;
+ fail "failed: no port number specified." unless defined $opt_n;
+}
+
+#
+# Set up and log in
+#
+
+$t = new Net::Telnet;
+
+$t->open($opt_a);
+
+$t->waitfor('/assword:/');
+
+$t->print($opt_p);
+
+($out, $match)= $t->waitfor(Match => '/\>/', Match => '/assword:/');
+
+if ($match =~ /assword:/) {
+ fail "failed: incorrect password\n";
+} elsif ( $match !~ />/ ) {
+ fail "failed: timed out waiting for prompt\n";
+}
+
+$t->print("config");
+
+$t->waitfor('/\(config\)\>/');
+
+$t->print("zone");
+
+$t->waitfor('/\(config\/zone\)\>/');
+
+#
+# Do the command
+#
+
+$cmd = "config $opt_n \"\"";
+$t->print($cmd);
+
+$t->waitfor('/\(config\/zone\)\>/');
+
+$t->print("apply");
+
+($text, $match) = $t->waitfor('/\>/');
+if ($text !~ /[Oo][Kk]/) {
+ fail "failed: error from switch\n";
+}
+
+$t->print("exit");
+
+print "success: zonedisable $opt_n\n";
+exit 0;
+
+
+sub get_options_stdin
+{
+ my $opt;
+ my $line = 0;
+
+ while( defined($in = <>) )
+ {
+ $_ = $in;
+ chomp;
+
+ # strip leading and trailing whitespace
+ s/^\s*//;
+ s/\s*$//;
+
+ # skip comments
+ next if /^#/;
+
+ $line+=1;
+ $opt=$_;
+ next unless $opt;
+
+ ($name,$val)=split /\s*=\s*/, $opt;
+
+ if ( $name eq "" ) {
+ print("parse error: illegal name in option $line\n");
+ exit 2;
+ }
+
+ # DO NOTHING -- this field is used by fenced
+ elsif ($name eq "agent" ) { }
+
+ # FIXME -- depricated. use "port" instead.
+ elsif ($name eq "fm" ) {
+ (my $dummy,$opt_n) = split /\s+/,$val;
+ print STDERR "Depricated \"fm\" entry detected. Refer to man page.\n";
+ }
+ elsif ($name eq "ipaddr" )
+ {
+ $opt_a = $val;
+ }
+ elsif ($name eq "name" ) { }
+ elsif ($name eq "passwd" )
+ {
+ $opt_p = $val;
+ }
+ elsif ($name eq "passwd_script" )
+ {
+ $opt_S = $val;
+ }
+ elsif ($name eq "port" )
+ {
+ $opt_n = $val;
+ }
+ }
+}
+
diff --git a/fence/agents/vmware/Makefile.am b/fence/agents/vmware/Makefile.am
new file mode 100644
index 0000000..9f41c0d
--- /dev/null
+++ b/fence/agents/vmware/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_vmware fence_vmware_helper
+
+SRC = fence_vmware.py fence_vmware_helper.pl
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = fence_vmware.8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/vmware/fence_vmware.py b/fence/agents/vmware/fence_vmware.py
new file mode 100644
index 0000000..dc4ef0f
--- /dev/null
+++ b/fence/agents/vmware/fence_vmware.py
@@ -0,0 +1,333 @@
+#!/usr/bin/python
+
+#
+# The Following agent has been tested on:
+# vmrun 2.0.0 build-116503 (from VMware Server 2.0) against:
+# VMware ESX 4.0.0
+# VMware vCenter 4.0.0
+# VMware ESX 3.5
+# VMware Server 2.0.0
+# VMware ESXi 3.5 update 2
+# VMware Server 1.0.7 (works but list/status show only running VMs)
+#
+# VI Perl API 1.6 against:
+# VMware ESX 4.0.0
+# VMware vCenter 4.0.0
+# VMware ESX 3.5
+# VMware ESXi 3.5 update 2
+# VMware Virtual Center 2.5
+#
+# VMware vSphere SDK for Perl 4.0.0 against:
+# VMware ESX 4.0.0
+# VMware vCenter 4.0.0
+#
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="VMware Agent using VI Perl API and/or VIX vmrun command"
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+### CONSTANTS ####
+# VMware type is ESX/ESXi/VC
+VMWARE_TYPE_ESX = 0
+# VMware type is Server 1.x
+VMWARE_TYPE_SERVER1 = 1
+# VMware type is Server 2.x and/or ESX 3.5 up2, ESXi 3.5 up2, VC 2.5 up2
+VMWARE_TYPE_SERVER2 = 2
+
+# Minimum required version of vmrun command
+VMRUN_MINIMUM_REQUIRED_VERSION = 2
+
+# Default path to vmhelper command
+VMHELPER_COMMAND = "fence_vmware_helper"
+# Default path to vmrun command
+VMRUN_COMMAND = "/usr/bin/vmrun"
+# Default type of vmware
+VMWARE_DEFAULT_TYPE = "esx"
+
+#### GLOBAL VARIABLES ####
+# Internal type. One of VMWARE_TYPE_, set by #vmware_check_vmware_type
+vmware_internal_type = VMWARE_TYPE_ESX
+
+# If ESX is disconnected, say, that VM is off (don't return previous state)
+vmware_disconnected_hack = False
+
+### FUNCTIONS ####
+
+#Split string in simplified DSV format to array of items
+def dsv_split(dsv_str):
+ delimiter_c = ':'
+ escape_c = '\\'
+
+ res = []
+ status = 0
+ tmp_str = ""
+
+ for x in dsv_str:
+ if (status==0):
+ if (x==delimiter_c):
+ res.append(tmp_str)
+ tmp_str = ""
+ elif (x==escape_c):
+ status = 1
+ else:
+ tmp_str += x
+ elif (status==1):
+ if (x==delimiter_c):
+ tmp_str += delimiter_c
+ elif (x==escape_c):
+ tmp_str += escape_c
+ else:
+ tmp_str += escape_c+x
+ status = 0
+
+ if (tmp_str != ""):
+ res.append(tmp_str)
+
+ return res
+
+# Quote string for proper existence in quoted string used for pexpect.run function
+# Ex. test'this will return test'\''this. So pexpect run will really pass ' to argument
+def quote_for_run(str):
+ dstr = ''
+
+ for c in str:
+ if c == r"'":
+ dstr += "'\\''"
+ else:
+ dstr += c
+
+ return dstr
+
+# Return string with command and additional parameters (something like vmrun -h 'host'
+def vmware_prepare_command(options, add_login_params, additional_params):
+ res = options["--exec"]
+
+ if (add_login_params):
+ if (vmware_internal_type==VMWARE_TYPE_ESX):
+ res += " --server '%s' --username '%s' --password '%s' "% (quote_for_run(options["--ip"]),
+ quote_for_run(options["--username"]),
+ quote_for_run(options["--password"]))
+ elif (vmware_internal_type==VMWARE_TYPE_SERVER2):
+ res += " -h 'https://%s/sdk' -u '%s' -p '%s' -T server "% (quote_for_run(options["--ip"]),
+ quote_for_run(options["--username"]),
+ quote_for_run(options["--password"]))
+ elif (vmware_internal_type==VMWARE_TYPE_SERVER1):
+ host_name_array = options["--ip"].split(':')
+
+ res += " -h '%s' -u '%s' -p '%s' -T server1 "% (quote_for_run(host_name_array[0]),
+ quote_for_run(options["--username"]),
+ quote_for_run(options["--password"]))
+ if (len(host_name_array)>1):
+ res += "-P '%s' "% (quote_for_run(host_name_array[1]))
+
+ if ((options.has_key("--vmware-datacenter")) and (vmware_internal_type==VMWARE_TYPE_ESX)):
+ res += "--datacenter '%s' "% (quote_for_run(options["--vmware-datacenter"]))
+
+ if (additional_params != ""):
+ res += additional_params
+
+ return res
+
+# Log message if user set verbose option
+def vmware_log(options, message):
+ if options["log"] >= LOG_MODE_VERBOSE:
+ options["debug_fh"].write(message+"\n")
+
+# Run command with timeout and parameters. Internaly uses vmware_prepare_command. Returns string
+# with output from vmrun command. If something fails (command not found, exit code is not 0), fail_usage
+# function is called (and never return).
+def vmware_run_command(options, add_login_params, additional_params, additional_timeout):
+ command = vmware_prepare_command(options, add_login_params, additional_params)
+
+ try:
+ vmware_log(options, command)
+
+ (res_output, res_code) = pexpect.run(command, int(options["--shell-timeout"])+int(options["--login-timeout"])+additional_timeout, True)
+
+ if (res_code==None):
+ fail(EC_TIMED_OUT)
+ if ((res_code!=0) and (add_login_params)):
+ vmware_log(options, res_output)
+ fail_usage("%s returned %s"% (options["--exec"], res_output))
+ else:
+ vmware_log(options, res_output)
+
+ except pexpect.ExceptionPexpect:
+ fail_usage("Cannot run command %s"% (options["--exec"]))
+
+ return res_output
+
+# Get outlet list with status as hash table. If you will use add_vm_name, only VM with vmname is
+# returned. This is used in get_status function
+def vmware_get_outlets_vi(conn, options, add_vm_name):
+ outlets = {}
+
+ if (add_vm_name):
+ all_machines = vmware_run_command(options, True, ("--operation status --vmname '%s'"% (quote_for_run(options["--plug"]))), 0)
+ else:
+ all_machines = vmware_run_command(options, True, "--operation list", int(options["--power-timeout"]))
+
+ all_machines_array = all_machines.splitlines()
+
+ for machine in all_machines_array:
+ machine_array = dsv_split(machine)
+ if (len(machine_array) == 4):
+ if (machine_array[0] in outlets):
+ fail_usage("Failed. More machines with same name %s found!"%(machine_array[0]))
+
+ if (vmware_disconnected_hack):
+ outlets[machine_array[0]] = ("", (
+ ((machine_array[2].lower() in ["poweredon"]) and
+ (machine_array[3].lower()=="connected"))
+ and "on" or "off"))
+ else:
+ outlets[machine_array[0]] = ("", ((machine_array[2].lower() in ["poweredon"]) and "on" or "off"))
+ return outlets
+
+# Get outlet list with status as hash table.
+def vmware_get_outlets_vix(conn, options):
+ outlets = {}
+
+ running_machines = vmware_run_command(options, True, "list", 0)
+ running_machines_array = running_machines.splitlines()[1:]
+
+ if (vmware_internal_type==VMWARE_TYPE_SERVER2):
+ all_machines = vmware_run_command(options, True, "listRegisteredVM", 0)
+ all_machines_array = all_machines.splitlines()[1:]
+ elif (vmware_internal_type==VMWARE_TYPE_SERVER1):
+ all_machines_array = running_machines_array
+
+ for machine in all_machines_array:
+ if (machine!=""):
+ outlets[machine] = ("", ((machine in running_machines_array) and "on" or "off"))
+
+ return outlets
+
+def get_outlets_status(conn, options):
+ if (vmware_internal_type==VMWARE_TYPE_ESX):
+ return vmware_get_outlets_vi(conn, options, False)
+ if ((vmware_internal_type==VMWARE_TYPE_SERVER1) or (vmware_internal_type==VMWARE_TYPE_SERVER2)):
+ return vmware_get_outlets_vix(conn, options)
+
+def get_power_status(conn, options):
+ if (vmware_internal_type==VMWARE_TYPE_ESX):
+ outlets = vmware_get_outlets_vi(conn, options, True)
+ else:
+ outlets = get_outlets_status(conn, options)
+
+ if ((vmware_internal_type==VMWARE_TYPE_SERVER2) or (vmware_internal_type==VMWARE_TYPE_ESX)):
+ if (not (options["--plug"] in outlets)):
+ fail_usage("Failed: You have to enter existing name of virtual machine!")
+ else:
+ return outlets[options["--plug"]][1]
+ elif (vmware_internal_type==VMWARE_TYPE_SERVER1):
+ return ((options["--plug"] in outlets) and "on" or "off")
+
+def set_power_status(conn, options):
+ if (vmware_internal_type==VMWARE_TYPE_ESX):
+ additional_params = "--operation %s --vmname '%s'"% ((options["--action"]=="on" and "on" or "off"), quote_for_run(options["--plug"]))
+ elif ((vmware_internal_type==VMWARE_TYPE_SERVER1) or (vmware_internal_type==VMWARE_TYPE_SERVER2)):
+ additional_params = "%s '%s'"% ((options["--action"]=="on" and "start" or "stop"), quote_for_run(options["--plug"]))
+ if (options["--action"]=="off"):
+ additional_params += " hard"
+
+ vmware_run_command(options, True, additional_params, int(options["--power-timeout"]))
+
+# Returns True, if user uses supported vmrun version (currently >=2.0.0) otherwise False.
+def vmware_is_supported_vmrun_version(options):
+ vmware_help_str = vmware_run_command(options, False, "", 0)
+ version_re = re.search("vmrun version (\d\.(\d[\.]*)*)", vmware_help_str.lower())
+ if (version_re==None):
+ return False # Looks like this "vmrun" is not real vmrun
+
+ version_array = version_re.group(1).split(".")
+
+ try:
+ if (int(version_array[0]) < VMRUN_MINIMUM_REQUIRED_VERSION):
+ return False
+ except Exception:
+ return False
+
+ return True
+
+# Check vmware type, set vmware_internal_type to one of VMWARE_TYPE_ value and
+# options["--exec"] to path (if not specified)
+def vmware_check_vmware_type(options):
+ global vmware_internal_type
+
+ options["--vmware_type"] = options["--vmware_type"].lower()
+
+ if (options["--vmware_type"]=="esx"):
+ vmware_internal_type = VMWARE_TYPE_ESX
+ if (not options.has_key("--exec")):
+ options["--exec"] = VMHELPER_COMMAND
+ elif (options["--vmware_type"]=="server2"):
+ vmware_internal_type = VMWARE_TYPE_SERVER2
+ if (not options.has_key("--exec")):
+ options["--exec"] = VMRUN_COMMAND
+ elif (options["--vmware_type"]=="server1"):
+ vmware_internal_type = VMWARE_TYPE_SERVER1
+ if (not options.has_key("--exec")):
+ options["--exec"] = VMRUN_COMMAND
+ else:
+ fail_usage("vmware_type can be esx,server2 or server1!")
+
+# Main agent method
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "secure",
+ "exec", "vmware_type", "vmware_datacenter"]
+
+ atexit.register(atexit_handler)
+
+ all_opt["secure"]["default"] = "1"
+ all_opt["vmware_type"]["default"] = VMWARE_DEFAULT_TYPE
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for VMWare"
+ docs["longdesc"] = "fence_vmware is an I/O Fencing agent \
+which can be used with the VMware ESX, VMware ESXi or VMware Server \
+to fence virtual machines.\
+\n.P\n\
+Before you can use this agent, it must be installed VI Perl Toolkit or \
+vmrun command on every node you want to make fencing.\
+\n.P\n\
+VI Perl Toolkit is preferred for VMware ESX/ESXi and Virtual Center. Vmrun \
+command is only solution for VMware Server 1/2 (this command will works against \
+ESX/ESXi 3.5 up2 and VC up2 too, but not cluster aware!) and is available as part \
+of VMware VIX API SDK package. VI Perl and VIX API SDK are both available from \
+VMware web pages (not int RHEL repository!). \
+\n.P\n\
+You can specify type of VMware you are connecting to with \\fB-d\\fP switch \
+(or \\fIvmware_type\\fR for stdin). Possible values are esx, server2 and server1.\
+Default value is esx, which will use VI Perl. With server1 and server2, vmrun \
+command is used.\
+\n.P\n\
+After you have successfully installed VI Perl Toolkit or VIX API, you should \
+be able to run fence_vmware_helper (part of this agent) or vmrun command. \
+This agent supports only vmrun from version 2.0.0 (VIX API 1.6.0)."
+ docs["vendorurl"] = "http://www.vmware.com"
+ show_docs(options, docs)
+
+ # Check vmware type and set path
+ vmware_check_vmware_type(options)
+
+ # Test user vmrun command version
+ if ((vmware_internal_type==VMWARE_TYPE_SERVER1) or (vmware_internal_type==VMWARE_TYPE_SERVER2)):
+ if (not (vmware_is_supported_vmrun_version(options))):
+ fail_usage("Unsupported version of vmrun command! You must use at least version %d!"%(VMRUN_MINIMUM_REQUIRED_VERSION))
+
+ # Operate the fencing device
+ result = fence_action(None, options, set_power_status, get_power_status, get_outlets_status)
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/vmware/fence_vmware_helper.pl b/fence/agents/vmware/fence_vmware_helper.pl
new file mode 100644
index 0000000..a0b5cea
--- /dev/null
+++ b/fence/agents/vmware/fence_vmware_helper.pl
@@ -0,0 +1,276 @@
+#!/usr/bin/perl
+
+use strict;
+use warnings;
+
+my $ME = $0;
+
+END {
+ defined fileno STDOUT or return;
+ close STDOUT and return;
+ warn "$ME: failed to close standard output: $!\n";
+ $? ||= 1;
+}
+
+my ($RELEASE_VERSION, $REDHAT_COPYRIGHT, $BUILD_DATE);
+
+#BEGIN_VERSION_GENERATION
+$RELEASE_VERSION="";
+$REDHAT_COPYRIGHT="";
+$BUILD_DATE="";
+#END_VERSION_GENERATION
+
+#### FUNCTIONS #####
+# Show error message
+sub show_error {
+ print STDERR @_;
+}
+
+sub my_exit {
+ my ($exit_code)=@_;
+
+ # Disconnect from server
+ Util::disconnect();
+
+ exit $exit_code;
+}
+
+# Convert one field (string) to format acceptable by DSV. This
+# means replace any : with \: and \ with \\.
+sub convert_field_to_dsv {
+ my ($input_line)=@_;
+
+ $input_line =~ s/([\\:])/\\$1/g;
+ return $input_line
+}
+
+#### Global variables #####
+# Aditional options
+my %opts = (
+ 'operation' => {
+ type => "=s",
+ help => "The operation to perform (on,off,list,status). "
+ . "Operations on/off/status require name of the virtual machine",
+ default => "list",
+ required => 0,
+ },
+ 'vmname' => {
+ type => "=s",
+ help => "The name of the virtual machine",
+ required => 0,
+ },
+ 'datacenter' => {
+ type => "=s",
+ help => "The name of the datacenter",
+ required => 0,
+ }
+);
+
+#################
+##### MAIN ######
+#################
+
+# Conditional use of VIRuntime
+eval "use VMware::VIRuntime;";
+
+if ($@) {
+ show_error "Please install VI Perl API package to use this tool!\nPerl error: $@";
+ exit 1;
+}
+
+# Parse options
+Opts::add_options(%opts);
+Opts::parse();
+Opts::validate();
+
+if (!(Opts::get_option('operation')=~/^(on|off|list|status)$/i)) {
+ show_error "Operation should be on, off, list or status!\n";
+ exit 2;
+}
+
+my $operation=lc(Opts::get_option('operation'));
+
+if (($operation ne 'list') && (!defined Opts::get_option('vmname'))) {
+ show_error "Operation on, off, status require vmname parameter!\n";
+ exit 2;
+}
+
+
+# Try connect to machine
+eval {
+ Util::connect();
+};
+
+if ($@) {
+ show_error "Cannot connect to server!\nVMware error:".$@;
+ exit 3;
+}
+
+my ($datacenter, $datacenter_view, $vm_views,$vm);
+# We are connected to machine
+
+# If user want's datacenter, we must first find datacenter
+my %filter=(view_type => 'VirtualMachine');
+
+if( defined (Opts::get_option('datacenter')) ) {
+ $datacenter = Opts::get_option('datacenter');
+ $datacenter_view = Vim::find_entity_view(view_type => 'Datacenter',
+ filter => { name => $datacenter });
+ if (!$datacenter_view) {
+ show_error "Cannot find datacenter ".$datacenter."!\n";
+
+ my_exit 4;
+ }
+
+ $filter{'begin_entity'}=$datacenter_view;
+}
+
+if ($operation ne 'list') {
+ $filter{'filter'}= {"config.name" => Opts::get_option('vmname')};
+}
+
+$vm_views = Vim::find_entity_views(%filter);
+
+my $found=0;
+
+# Traverse all found vm
+foreach $vm(@$vm_views) {
+ if (($operation eq 'list') or ($operation eq 'status')) {
+ if (!$vm->summary->config->template) {
+ print convert_field_to_dsv($vm->name).":".
+ convert_field_to_dsv($vm->summary->config->vmPathName).":".
+ convert_field_to_dsv($vm->runtime->powerState->val).":".
+ convert_field_to_dsv($vm->runtime->connectionState->val)."\n";
+ }
+ } elsif ($operation eq 'on') {
+ eval {
+ $vm->PowerOnVM();
+ };
+
+ if ($@) {
+ # If error is SoapFault with InvalidPowerState, user maybe use some auto power on tool.
+ # This is not error, warning is enought.
+ if (ref($@) eq 'SoapFault') {
+ if (ref($@->detail) eq 'InvalidPowerState') {
+ show_error "Warning: Cannot power on vm (somebody done it before???) ".Opts::get_option('vmname').
+ "!\nVMware error:".$@."\n";
+ }
+ } else {
+ # Some other more serious problem
+ show_error "Cannot power on vm ".Opts::get_option('vmname')."!\nVMware error:".$@."\n";
+ my_exit 6;
+ }
+ }
+ } elsif ($operation eq 'off') {
+ eval {
+ $vm->PowerOffVM();
+ };
+
+ if ($@) {
+ # If error is SoapFault with InvalidPowerState, user maybe use some auto power off tool.
+ # This is not error, warning is enought.
+ if (ref($@) eq 'SoapFault') {
+ if (ref($@->detail) eq 'InvalidPowerState') {
+ show_error "Warning: Cannot power off vm (somebody done it before???) ".Opts::get_option('vmname').
+ "!\nVMware error:".$@."\n";
+ }
+ } else {
+ # Some other more serious problem
+ show_error "Cannot power off vm ".Opts::get_option('vmname')."!\nVMware error:".$@."\n";
+ my_exit 6;
+ }
+ }
+ } else {
+ show_error "Operation should be on, off or list!\n";
+ my_exit 2;
+ }
+ $found++;
+}
+
+if ((!$found) && ($operation ne 'list')) {
+ show_error "Cannot find vm ".Opts::get_option('vmname')."!\n";
+ my_exit 5;
+}
+
+# Should be 0 -> success all, or 6 in case of error
+my_exit 0;
+
+__END__
+
+=head1 NAME
+
+fence_vmware_helper - Perform list of virtual machines and
+ poweron, poweroff of operations on virtual machines.
+
+=head1 SYNOPSIS
+
+ fence_vmware_helper --operation <on|off|list|status> [options]
+
+=head1 DESCRIPTION
+
+This VI Perl command-line utility provides an interface for
+seven common provisioning operations on one or more virtual
+machines: powering on, powering off and listing virtual mode.
+
+=head1 OPTIONS
+
+=head2 GENERAL OPTIONS
+
+=over
+
+=item B<operation>
+
+Operation to be performed. One of the following:
+
+ <on> (power on one or more virtual machines),
+ <off> (power off one or more virtual machines),
+ <list> (list virtual machines and their status)
+ <status> (same as list, but show only machines with vmname)
+
+=item B<vmname>
+
+Optional. Name of the virtual machine on which the
+operation is to be performed.
+
+=item B<datacenter>
+
+Optional. Name of the datacenter for the virtual machine(s).
+Operations will be performed on all the virtual machines under the given datacenter.
+
+=back
+
+=head1 EXAMPLES
+
+Power on a virtual machine
+
+ fence_vmware_helper --username administrator --password administrator --operation on
+ --vmname rhel --server win1
+
+ fence_vmware_helper --username administrator --password administrator --operation on
+ --vmname rhel --server win1 --datacenter Datacenter
+
+Power off a virtual machine
+
+ fence_vmware_helper --username administrator --password administrator --operation off
+ --vmname rhel --server win1
+
+ perl fence_vmware_helper --username administrator --password administrator --operation off
+ --vmname rhel --server win1 --datacenter Datacenter
+
+List of virtual machines
+
+ fence_vmware_helper --username administrator --password administrator --server win1
+
+ fence_vmware_helper --username administrator --password administrator --server win1
+ --operation list
+
+Get status of virtual machine
+
+ fence_vmware_helper --username administrator --password administrator --server win1
+ --vmname rhel --operation status
+
+=head1 SUPPORTED PLATFORMS
+
+All operations supported on ESX 3.0.1
+
+All operations supported on Virtual Center 2.0.1
diff --git a/fence/agents/vmware_soap/Makefile.am b/fence/agents/vmware_soap/Makefile.am
new file mode 100644
index 0000000..8e4e061
--- /dev/null
+++ b/fence/agents/vmware_soap/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_vmware_soap
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/vmware_soap/fence_vmware_soap.py b/fence/agents/vmware_soap/fence_vmware_soap.py
new file mode 100644
index 0000000..776273e
--- /dev/null
+++ b/fence/agents/vmware_soap/fence_vmware_soap.py
@@ -0,0 +1,220 @@
+#!/usr/bin/python
+
+import sys, exceptions, time
+import shutil, tempfile, suds
+sys.path.append("@FENCEAGENTSLIBDIR@")
+
+from suds.client import Client
+from suds.sudsobject import Property
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="New VMWare Agent - test release on steroids"
+REDHAT_COPYRIGHT=""
+BUILD_DATE="April, 2011"
+#END_VERSION_GENERATION
+
+def soap_login(options):
+ if options["-o"] in ["off", "reboot"]:
+ time.sleep(int(options["--delay"]))
+
+ if options.has_key("--ssl"):
+ url = "https://"
+ else:
+ url = "http://"
+
+ url += options["--ip"] + ":" + str(options["--ipport"]) + "/sdk"
+
+ tmp_dir = tempfile.mkdtemp()
+ tempfile.tempdir = tmp_dir
+ atexit.register(remove_tmp_dir, tmp_dir)
+
+ try:
+ conn = Client(url + "/vimService.wsdl")
+ conn.set_options(location = url)
+
+ mo_ServiceInstance = Property('ServiceInstance')
+ mo_ServiceInstance._type = 'ServiceInstance'
+ ServiceContent = conn.service.RetrieveServiceContent(mo_ServiceInstance)
+ mo_SessionManager = Property(ServiceContent.sessionManager.value)
+ mo_SessionManager._type = 'SessionManager'
+
+ SessionManager = conn.service.Login(mo_SessionManager, options["--username"], options["--password"])
+ except Exception, ex:
+ fail(EC_LOGIN_DENIED)
+
+ options["ServiceContent"] = ServiceContent
+ options["mo_SessionManager"] = mo_SessionManager
+ return conn
+
+def process_results(results, machines, uuid, mappingToUUID):
+ for m in results.objects:
+ info = {}
+ for i in m.propSet:
+ info[i.name] = i.val
+ # Prevent error KeyError: 'config.uuid' when reaching systems which P2V failed,
+ # since these systems don't have a valid UUID
+ if info.has_key("config.uuid"):
+ machines[info["name"]] = (info["config.uuid"], info["summary.runtime.powerState"])
+ uuid[info["config.uuid"]] = info["summary.runtime.powerState"]
+ mappingToUUID[m.obj.value] = info["config.uuid"]
+
+ return (machines, uuid, mappingToUUID)
+
+def get_power_status(conn, options):
+ mo_ViewManager = Property(options["ServiceContent"].viewManager.value)
+ mo_ViewManager._type = "ViewManager"
+
+ mo_RootFolder = Property(options["ServiceContent"].rootFolder.value)
+ mo_RootFolder._type = "Folder"
+
+ mo_PropertyCollector = Property(options["ServiceContent"].propertyCollector.value)
+ mo_PropertyCollector._type = 'PropertyCollector'
+
+ ContainerView = conn.service.CreateContainerView(mo_ViewManager, recursive = 1, container = mo_RootFolder, type = ['VirtualMachine'])
+ mo_ContainerView = Property(ContainerView.value)
+ mo_ContainerView._type = "ContainerView"
+
+ FolderTraversalSpec = conn.factory.create('ns0:TraversalSpec')
+ FolderTraversalSpec.name = "traverseEntities"
+ FolderTraversalSpec.path = "view"
+ FolderTraversalSpec.skip = False
+ FolderTraversalSpec.type = "ContainerView"
+
+ objSpec = conn.factory.create('ns0:ObjectSpec')
+ objSpec.obj = mo_ContainerView
+ objSpec.selectSet = [ FolderTraversalSpec ]
+ objSpec.skip = True
+
+ propSpec = conn.factory.create('ns0:PropertySpec')
+ propSpec.all = False
+ propSpec.pathSet = ["name", "summary.runtime.powerState", "config.uuid"]
+ propSpec.type = "VirtualMachine"
+
+ propFilterSpec = conn.factory.create('ns0:PropertyFilterSpec')
+ propFilterSpec.propSet = [ propSpec ]
+ propFilterSpec.objectSet = [ objSpec ]
+
+ try:
+ raw_machines = conn.service.RetrievePropertiesEx(mo_PropertyCollector, propFilterSpec)
+ except Exception, ex:
+ fail(EC_STATUS)
+
+ (machines, uuid, mappingToUUID) = process_results(raw_machines, {}, {}, {})
+
+ # Probably need to loop over the ContinueRetreive if there are more results after 1 iteration.
+ while (hasattr(raw_machines, 'token') == True):
+ try:
+ raw_machines = conn.service.ContinueRetrievePropertiesEx(mo_PropertyCollector, raw_machines.token)
+ except Exception, ex:
+ fail(EC_STATUS)
+ (more_machines, more_uuid, more_mappingToUUID) = process_results(raw_machines, {}, {}, {})
+ machines.update(more_machines)
+ uuid.update(more_uuid)
+ mappingToUUID.update(more_mappingToUUID)
+ # Do not run unnecessary SOAP requests
+ if options.has_key("--uuid") and options["--uuid"] in uuid:
+ break
+
+ if ["list", "monitor"].count(options["--action"]) == 1:
+ return machines
+ else:
+ if options.has_key("--uuid") == False:
+ if options["--plug"].startswith('/'):
+ ## Transform InventoryPath to UUID
+ mo_SearchIndex = Property(options["ServiceContent"].searchIndex.value)
+ mo_SearchIndex._type = "SearchIndex"
+
+ vm = conn.service.FindByInventoryPath(mo_SearchIndex, options["--plug"])
+
+ try:
+ options["--uuid"] = mappingToUUID[vm.value]
+ except KeyError, ex:
+ fail(EC_STATUS)
+ except AttributeError, ex:
+ fail(EC_STATUS)
+ else:
+ ## Name of virtual machine instead of path
+ ## warning: if you have same names of machines this won't work correctly
+ try:
+ (options["--uuid"], _) = machines[options["--plug"]]
+ except KeyError, ex:
+ fail(EC_STATUS)
+ except AttributeError, ex:
+ fail(EC_STATUS)
+
+ try:
+ if uuid[options["--uuid"]] == "poweredOn":
+ return "on"
+ else:
+ return "off"
+ except KeyError, ex:
+ fail(EC_STATUS)
+
+def set_power_status(conn, options):
+ mo_SearchIndex = Property(options["ServiceContent"].searchIndex.value)
+ mo_SearchIndex._type = "SearchIndex"
+ vm = conn.service.FindByUuid(mo_SearchIndex, vmSearch = 1, uuid = options["--uuid"])
+
+ mo_machine = Property(vm.value)
+ mo_machine._type = "VirtualMachine"
+
+ try:
+ if options["--action"] == "on":
+ conn.service.PowerOnVM_Task(mo_machine)
+ else:
+ conn.service.PowerOffVM_Task(mo_machine)
+ except suds.WebFault, ex:
+ if ((str(ex).find("Permission to perform this operation was denied")) >= 0):
+ fail(EC_INVALID_PRIVILEGES)
+ else:
+ if options["--action"] == "on":
+ fail(EC_WAITING_ON)
+ else:
+ fail(EC_WAITING_OFF)
+
+def remove_tmp_dir(tmp_dir):
+ shutil.rmtree(tmp_dir)
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "web", "ssl", "port" ]
+
+ atexit.register(atexit_handler)
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ ##
+ ## Fence agent specific defaults
+ #####
+ docs = { }
+ docs["shortdesc"] = "Fence agent for VMWare over SOAP API"
+ docs["longdesc"] = "fence_vmware_soap is an I/O Fencing agent \
+which can be used with the virtual machines managed by VMWare products \
+that have SOAP API v4.1+. \
+\n.P\n\
+Name of virtual machine (-n / port) has to be used in inventory path \
+format (e.g. /datacenter/vm/Discovered virtual machine/myMachine). \
+In the cases when name of yours VM is unique you can use it instead. \
+Alternatively you can always use UUID to access virtual machine."
+ docs["vendorurl"] = "http://www.vmware.com"
+ show_docs(options, docs)
+
+ ##
+ ## Operate the fencing device
+ ####
+ conn = soap_login(options)
+
+ result = fence_action(conn, options, set_power_status, get_power_status, get_power_status)
+
+ ##
+ ## Logout from system
+ #####
+ try:
+ conn.service.Logout(options["mo_SessionManager"])
+ except Exception, ex:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/wti/Makefile.am b/fence/agents/wti/Makefile.am
new file mode 100644
index 0000000..04f556c
--- /dev/null
+++ b/fence/agents/wti/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_wti
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/wti/fence_wti.py b/fence/agents/wti/fence_wti.py
new file mode 100644
index 0000000..c9c5237
--- /dev/null
+++ b/fence/agents/wti/fence_wti.py
@@ -0,0 +1,241 @@
+#!/usr/bin/python
+
+#####
+##
+## The Following Agent Has Been Tested On:
+##
+## Version Firmware
+## +-----------------+---------------------------+
+## WTI RSM-8R4 ?? unable to find out ??
+## WTI MPC-??? ?? unable to find out ??
+## WTI IPS-800-CE v1.40h (no username) ('list' tested)
+#####
+
+import sys, re, pexpect, exceptions
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION="New WTI Agent - test release on steroids"
+REDHAT_COPYRIGHT=""
+BUILD_DATE="March, 2008"
+#END_VERSION_GENERATION
+
+def get_listing(conn, options, listing_command):
+ listing = ""
+
+ conn.send(listing_command + "\r\n")
+
+ if isinstance(options["--command-prompt"], list):
+ re_all = list(options["--command-prompt"])
+ else:
+ re_all = [options["--command-prompt"]]
+ re_next = re.compile("Enter: ", re.IGNORECASE)
+ re_all.append(re_next)
+
+ result = conn.log_expect(options, re_all, int(options["--shell-timeout"]))
+ listing = conn.before
+ if result == (len(re_all) - 1):
+ conn.send("\r\n")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ listing += conn.before
+
+ return listing
+
+def get_plug_status(conn, options):
+ listing = get_listing(conn, options, "/S")
+
+ plug_section = 0
+ plug_index = -1
+ name_index = -1
+ status_index = -1
+ plug_header = list()
+ outlets = {}
+
+ for line in listing.splitlines():
+ if (plug_section == 2) and line.find("|") >= 0 and line.startswith("PLUG") == False:
+ plug_line = [x.strip().lower() for x in line.split("|")]
+ if len(plug_line) < len(plug_header):
+ plug_section = -1
+ if ["list", "monitor"].count(options["--action"]) == 0 and options["--plug"].lower() == plug_line[plug_index]:
+ return plug_line[status_index]
+ else:
+ ## We already believe that first column contains plug number
+ if len(plug_line[0]) != 0:
+ outlets[plug_line[0]] = (plug_line[name_index], plug_line[status_index])
+ elif (plug_section == 1):
+ plug_section = 2
+ elif (line.upper().startswith("PLUG")):
+ plug_section = 1
+ plug_header = [x.strip().lower() for x in line.split("|")]
+ plug_index = plug_header.index("plug")
+ name_index = plug_header.index("name")
+ status_index = plug_header.index("status")
+
+ if ["list", "monitor"].count(options["--action"]) == 1:
+ return outlets
+ else:
+ return "PROBLEM"
+
+def get_plug_group_status_from_list(status_list):
+ for status in status_list:
+ if status == "on":
+ return status
+ return "off"
+
+def get_plug_group_status(conn, options):
+ listing = get_listing(conn, options, "/SG")
+
+ plug_section = 0
+ outlets = {}
+ current_outlet = ""
+ line_index = 0
+ lines = listing.splitlines()
+ while line_index < len(lines) and line_index >= 0:
+ line = lines[line_index]
+ if (line.find("|") >= 0 and line.lstrip().startswith("GROUP NAME") == False):
+ plug_line = [x.strip().lower() for x in line.split("|")]
+ if ["list", "monitor"].count(options["--action"]) == 0 and options["--plug"].lower() == plug_line[name_index]:
+ plug_status = []
+ while line_index < len(lines) and line_index >= 0:
+ plug_line = [x.strip().lower() for x in lines[line_index].split("|")]
+ if len(plug_line) >= max(name_index, status_index) and len(plug_line[plug_index]) > 0 and (len(plug_line[name_index]) == 0 or options["--plug"].lower() == plug_line[name_index]):
+ ## Firmware 1.43 does not have a valid value of plug on first line as only name is defined on that line
+ if not "---" in plug_line[status_index]:
+ plug_status.append(plug_line[status_index])
+ line_index += 1
+ else:
+ line_index = -1
+
+ return get_plug_group_status_from_list(plug_status)
+
+ else:
+ ## We already believe that first column contains plug number
+ if len(plug_line[0]) != 0:
+ group_name = plug_line[0]
+ plug_line_index = line_index + 1
+ plug_status = []
+ while plug_line_index < len(lines) and plug_line_index >= 0:
+ plug_line = [x.strip().lower() for x in lines[plug_line_index].split("|")]
+ if len(plug_line[name_index]) > 0:
+ plug_line_index = -1
+ break
+ if len(plug_line[plug_index]) > 0:
+ plug_status.append(plug_line[status_index])
+ plug_line_index += 1
+ else:
+ plug_line_index = -1
+ outlets[group_name] = (group_name, get_plug_group_status_from_list(plug_status))
+ line_index += 1
+
+ elif (line.upper().lstrip().startswith("GROUP NAME")):
+ plug_header = [x.strip().lower() for x in line.split("|")]
+ name_index = plug_header.index("group name")
+ plug_index = plug_header.index("plug")
+ status_index = plug_header.index("status")
+ line_index += 2
+ else:
+ line_index += 1
+
+
+ if ["list", "monitor"].count(options["--action"]) == 1:
+ for group, status in outlet_groups:
+ outlets[group] = (group, status[0])
+
+ return outlets
+ else:
+ return "PROBLEM"
+
+def get_power_status(conn, options):
+ ret = get_plug_status(conn, options)
+
+ if ret == "PROBLEM":
+ ret = get_plug_group_status(conn, options)
+
+ return ret
+
+def set_power_status(conn, options):
+ action = {
+ 'on' : "/on",
+ 'off': "/off"
+ }[options["--action"]]
+
+ conn.send(action + " " + options["--plug"] + ",y\r\n")
+ conn.log_expect(options, options["--command-prompt"], int(options["--power-timeout"]))
+
+def main():
+ device_opt = [ "ipaddr", "login", "passwd", "no_login", "no_password", \
+ "cmd_prompt", "secure", "port" ]
+
+ atexit.register(atexit_handler)
+
+ all_opt["cmd_prompt"]["default"] = [ "RSM>", "MPC>", "IPS>", "TPS>", "NBB>", "NPS>", "VMR>" ]
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "Fence agent for WTI"
+ docs["longdesc"] = "fence_wti is an I/O Fencing agent \
+which can be used with the WTI Network Power Switch (NPS). It logs \
+into an NPS via telnet or ssh and boots a specified plug. \
+Lengthy telnet connections to the NPS should be avoided while a GFS cluster \
+is running because the connection will block any necessary fencing actions."
+ docs["vendorurl"] = "http://www.wti.com"
+ show_docs(options, docs)
+
+ ##
+ ## Operate the fencing device
+ ##
+ ## @note: if it possible that this device does not need either login, password or both of them
+ #####
+ if 0 == options.has_key("--ssh"):
+ try:
+ try:
+ conn = fspawn(options, TELNET_PATH)
+ conn.send("set binary\n")
+ conn.send("open %s -%s\n"%(options["--ip"], options["--ipport"]))
+ except pexpect.ExceptionPexpect, ex:
+ sys.stderr.write(str(ex) + "\n")
+ sys.stderr.write("Due to limitations, binary dependencies on fence agents "
+ "are not in the spec file and must be installed separately." + "\n")
+ sys.exit(EC_GENERIC_ERROR)
+
+ re_login = re.compile("(login: )|(Login Name: )|(username: )|(User Name :)", re.IGNORECASE)
+ re_prompt = re.compile("|".join(map (lambda x: "(" + x + ")", options["--command-prompt"])), re.IGNORECASE)
+
+ result = conn.log_expect(options, [ re_login, "Password: ", re_prompt ], int(options["--shell-timeout"]))
+ if result == 0:
+ if options.has_key("--username"):
+ conn.send(options["--username"]+"\r\n")
+ result = conn.log_expect(options, [ re_login, "Password: ", re_prompt ], int(options["--shell-timeout"]))
+ else:
+ fail_usage("Failed: You have to set login name")
+
+ if result == 1:
+ if options.has_key("--password"):
+ conn.send(options["--password"]+"\r\n")
+ conn.log_expect(options, options["--command-prompt"], int(options["--shell-timeout"]))
+ else:
+ fail_usage("Failed: You have to enter password or password script")
+ except pexpect.EOF:
+ fail(EC_LOGIN_DENIED)
+ except pexpect.TIMEOUT:
+ fail(EC_LOGIN_DENIED)
+ else:
+ conn = fence_login(options)
+
+ result = fence_action(conn, options, set_power_status, get_power_status, get_power_status)
+
+ ##
+ ## Logout from system
+ ######
+ try:
+ conn.send("/X"+"\r\n")
+ conn.close()
+ except:
+ pass
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/xcat/Makefile.am b/fence/agents/xcat/Makefile.am
new file mode 100644
index 0000000..ef99def
--- /dev/null
+++ b/fence/agents/xcat/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_xcat
+
+SRC = $(TARGET).pl
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fencemanperl.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/xcat/fence_xcat.pl b/fence/agents/xcat/fence_xcat.pl
new file mode 100644
index 0000000..c2937c9
--- /dev/null
+++ b/fence/agents/xcat/fence_xcat.pl
@@ -0,0 +1,250 @@
+#!/usr/bin/perl
+
+use Getopt::Std;
+
+my $ME = $0;
+
+END {
+ defined fileno STDOUT or return;
+ close STDOUT and return;
+ warn "$ME: failed to close standard output: $!\n";
+ $? ||= 1;
+}
+
+# Get the program name from $0 and strip directory names
+$_=$0;
+s/.*\///;
+my $pname = $_;
+
+$opt_o = 'reset'; # Default fence action
+$opt_r = 'rpower'; # Default fence action
+
+# WARNING!! Do not add code bewteen "#BEGIN_VERSION_GENERATION" and
+# "#END_VERSION_GENERATION" It is generated by the Makefile
+
+#BEGIN_VERSION_GENERATION
+$RELEASE_VERSION="";
+$REDHAT_COPYRIGHT="";
+$BUILD_DATE="";
+#END_VERSION_GENERATION
+
+
+sub usage
+{
+ print "Usage:\n";
+ print "\n";
+ print "$pname [options]\n";
+ print "\n";
+ print "Options:\n";
+ print " -h usage\n";
+ print " -n <name> nodename\n";
+ print " -o <string> Action: on, off, reset (default), status or metadata\n";
+ print " -r <rpower> rpower command\n";
+ print " -q quiet mode\n";
+ print " -V version\n";
+
+ exit 0;
+}
+
+sub fail
+{
+ ($msg) = @_;
+ print $msg."\n" unless defined $opt_q;
+ $t->close if defined $t;
+ exit 1;
+}
+
+sub fail_usage
+{
+ ($msg)=@_;
+ print STDERR $msg."\n" if $msg;
+ print STDERR "Please use '-h' for usage.\n";
+ exit 1;
+}
+
+sub version
+{
+ print "$pname $RELEASE_VERSION $BUILD_DATE\n";
+ print "$REDHAT_COPYRIGHT\n" if ( $REDHAT_COPYRIGHT );
+
+ exit 0;
+}
+
+sub print_metadata
+{
+print '<?xml version="1.0" ?>
+<resource-agent name="fence_xcat" shortdesc="I/O Fencing agent for xcat environments" >
+<longdesc>
+fence_xcat is a wrapper to the rpower(1) command that is distributed with the xCAT project available at http://www.xcat.org. Use of fence_xcat requires that xcat has already been properly configured for your environment. Refer to xCAT(1) for more information on configuring xCAT.
+
+NOTE: It is recommended that fence_bladecenter(8) is used instead of fence_xcat if the bladecenter firmware supports telnet. This interface is much cleaner and easier to setup.
+</longdesc>
+<vendor-url>http://www.xcat.org</vendor-url>
+<parameters>
+ <parameter name="action" unique="1" required="1">
+ <getopt mixed="-o [action]" />
+ <content type="string" default="restart" />
+ <shortdesc lang="en">Fencing Action</shortdesc>
+ </parameter>
+ <parameter name="nodename" unique="1" required="1">
+ <getopt mixed="-n [nodename]" />
+ <content type="string" />
+ <shortdesc lang="en">The nodename as defined in nodelist.tab of the xCAT setup.</shortdesc>
+ </parameter>
+ <parameter name="rpower" unique="1" required="0">
+ <getopt mixed="-r [rpower]" />
+ <content type="string" />
+ <shortdesc lang="en">The path to the rpower binary.</shortdesc>
+ </parameter>
+ <parameter name="help" unique="1" required="0">
+ <getopt mixed="-h" />
+ <content type="string" />
+ <shortdesc lang="en">Display help and exit</shortdesc>
+ </parameter>
+</parameters>
+<actions>
+ <action name="on" />
+ <action name="off" />
+ <action name="status" />
+ <action name="metadata" />
+</actions>
+</resource-agent>
+';
+}
+
+
+sub get_options_stdin
+{
+ my $opt;
+ my $line = 0;
+ while( defined($in = <>) )
+ {
+ $_ = $in;
+ chomp;
+
+ # strip leading and trailing whitespace
+ s/^\s*//;
+ s/\s*$//;
+
+ # skip comments
+ next if /^#/;
+
+ $line+=1;
+ $opt=$_;
+ next unless $opt;
+
+ ($name,$val)=split /\s*=\s*/, $opt;
+
+ if ( $name eq "" )
+ {
+ print STDERR "parse error: illegal name in option $line\n";
+ exit 2;
+ }
+
+ # DO NOTHING -- this field is used by fenced
+ elsif ($name eq "agent" ) { }
+
+ elsif ($name eq "action" )
+ {
+ $opt_o = $val;
+ }
+ elsif ($name eq "nodename" )
+ {
+ $opt_n = $val;
+ }
+ elsif ($name eq "rpower" )
+ {
+ $opt_r = $val;
+ }
+
+ }
+}
+
+######################################################################33
+# MAIN
+
+if (@ARGV > 0) {
+ getopts("hn:o:r:qV") || fail_usage ;
+
+ usage if defined $opt_h;
+ version if defined $opt_V;
+
+ fail_usage "Unknown parameter." if (@ARGV > 0);
+
+ if ((defined $opt_o) && ($opt_o =~ /metadata/i)) {
+ print_metadata();
+ exit 0;
+ }
+
+ fail_usage "No '-n' flag specified." unless defined $opt_n;
+ $opt_o=lc($opt_o);
+ fail_usage "Unrecognised action '$opt_o' for '-o' flag"
+ unless $opt_o =~ /^(on|off|reset|stat|status)$/;
+
+} else {
+ get_options_stdin();
+
+ if ((defined $opt_o) && ($opt_o =~ /metadata/i)) {
+ print_metadata();
+ exit 0;
+ }
+
+ fail "failed: no plug number" unless defined $opt_n;
+ $opt_o=lc($opt_o);
+ fail "failed: unrecognised action: $opt_o"
+ unless $opt_o =~ /^(on|off|reset|stat|status)$/;
+}
+
+pipe (RDR,WTR);
+
+if ( $pid=fork() == 0 )
+{
+ close RDR;
+
+ open STDOUT, ">&WTR";
+ exec "$opt_r $opt_n $opt_o" or die "failed to exec \"$opt_r\"\n";
+}
+
+close WTR;
+
+wait;
+
+if ( $? != 0 )
+{
+ die "failed: rpower error: exit $?\n"
+}
+
+$found=0;
+$status="";
+while (<RDR>)
+{
+ chomp;
+
+ if ( $_ =~ /^(\S+): (\S+)$/)
+ {
+ if ($opt_n eq $1)
+ {
+ $status = $2;
+
+ if (($opt_o eq $2) || ($opt_o =~ /stat/i) || ($opt_o =~ /status/i))
+ {
+ $found=1;
+ last;
+ }
+ }
+ }
+}
+
+print (($found ? "success":"failed") . ": $opt_n $status\n")
+ unless defined $opt_q;
+
+exit ($found ? 0 : 1 );
+
+
+
+
+
+
+
+
+
diff --git a/fence/agents/xenapi/Makefile.am b/fence/agents/xenapi/Makefile.am
new file mode 100644
index 0000000..781975e
--- /dev/null
+++ b/fence/agents/xenapi/Makefile.am
@@ -0,0 +1,17 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+TARGET = fence_xenapi
+
+SRC = $(TARGET).py
+
+EXTRA_DIST = $(SRC)
+
+sbin_SCRIPTS = $(TARGET)
+
+man_MANS = $(TARGET).8
+
+include $(top_srcdir)/make/fencebuild.mk
+include $(top_srcdir)/make/fenceman.mk
+
+clean-local: clean-man
+ rm -f $(TARGET)
diff --git a/fence/agents/xenapi/fence_xenapi.py b/fence/agents/xenapi/fence_xenapi.py
new file mode 100644
index 0000000..9cf200a
--- /dev/null
+++ b/fence/agents/xenapi/fence_xenapi.py
@@ -0,0 +1,228 @@
+#!/usr/bin/python
+#
+#############################################################################
+# Copyright 2011 Matthew Clark
+# This file is part of fence-xenserver
+#
+# fence-xenserver is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 2 of the License, or
+# (at your option) any later version.
+#
+# fence-xenserver is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+# Please let me know if you are using this script so that I can work out
+# whether I should continue support for it. mattjclark0407 at hotmail dot com
+#############################################################################
+
+#############################################################################
+# It's only just begun...
+# Current status: completely usable. This script is now working well and,
+# has a lot of functionality as a result of the fencing.py library and the
+# XenAPI libary.
+
+#############################################################################
+# Please let me know if you are using this script so that I can work out
+# whether I should continue support for it. mattjclark0407 at hotmail dot com
+
+import sys
+sys.path.append("@FENCEAGENTSLIBDIR@")
+from fencing import *
+import XenAPI
+
+#BEGIN_VERSION_GENERATION
+RELEASE_VERSION=""
+REDHAT_COPYRIGHT=""
+BUILD_DATE=""
+#END_VERSION_GENERATION
+
+EC_BAD_SESSION = 1
+# Find the status of the port given in the -U flag of options.
+def get_power_fn(session, options):
+ if options.has_key("--verbose"):
+ verbose = True
+ else:
+ verbose = False
+
+ try:
+ # Get a reference to the vm specified in the UUID or vm_name/port parameter
+ vm = return_vm_reference(session, options)
+ # Query the VM for its' associated parameters
+ record = session.xenapi.VM.get_record(vm)
+ # Check that we are not trying to manipulate a template or a control
+ # domain as they show up as VM's with specific properties.
+ if not(record["is_a_template"]) and not(record["is_control_domain"]):
+ status = record["power_state"]
+ if verbose:
+ print "UUID:", record["uuid"], "NAME:", record["name_label"], "POWER STATUS:", record["power_state"]
+ # Note that the VM can be in the following states (from the XenAPI document)
+ # Halted: VM is offline and not using any resources.
+ # Paused: All resources have been allocated but the VM itself is paused and its vCPUs are not running
+ # Running: Running
+ # Paused: VM state has been saved to disk and it is nolonger running. Note that disks remain in-Use while
+ # We want to make sure that we only return the status "off" if the machine is actually halted as the status
+ # is checked before a fencing action. Only when the machine is Halted is it not consuming resources which
+ # may include whatever you are trying to protect with this fencing action.
+ return (status=="Halted" and "off" or "on")
+ except Exception, exn:
+ print str(exn)
+
+ return "Error"
+
+# Set the state of the port given in the -U flag of options.
+def set_power_fn(session, options):
+ action = options["--action"].lower()
+
+ try:
+ # Get a reference to the vm specified in the UUID or vm_name/port parameter
+ vm = return_vm_reference(session, options)
+ # Query the VM for its' associated parameters
+ record = session.xenapi.VM.get_record(vm)
+ # Check that we are not trying to manipulate a template or a control
+ # domain as they show up as VM's with specific properties.
+ if not(record["is_a_template"]) and not(record["is_control_domain"]):
+ if( action == "on" ):
+ # Start the VM
+ session.xenapi.VM.start(vm, False, True)
+ elif( action == "off" ):
+ # Force shutdown the VM
+ session.xenapi.VM.hard_shutdown(vm)
+ elif( action == "reboot" ):
+ # Force reboot the VM
+ session.xenapi.VM.hard_reboot(vm)
+ except Exception, exn:
+ print str(exn)
+
+# Function to populate an array of virtual machines and their status
+def get_outlet_list(session, options):
+ result = {}
+ if options.has_key("--verbose"):
+ verbose = True
+ else:
+ verbose = False
+
+ try:
+ # Return an array of all the VM's on the host
+ vms = session.xenapi.VM.get_all()
+ for vm in vms:
+ # Query the VM for its' associated parameters
+ record = session.xenapi.VM.get_record(vm)
+ # Check that we are not trying to manipulate a template or a control
+ # domain as they show up as VM's with specific properties.
+ if not(record["is_a_template"]) and not(record["is_control_domain"]):
+ name = record["name_label"]
+ uuid = record["uuid"]
+ status = record["power_state"]
+ result[uuid] = (name, status)
+ if verbose:
+ print "UUID:", record["uuid"], "NAME:", name, "POWER STATUS:", record["power_state"]
+ except Exception, exn:
+ print str(exn)
+
+ return result
+
+# Function to initiate the XenServer session via the XenAPI library.
+def connect_and_login(options):
+ url = options["--session-url"]
+ username = options["--username"]
+ password = options["--password"]
+
+ try:
+ # Create the XML RPC session to the specified URL.
+ session = XenAPI.Session(url)
+ # Login using the supplied credentials.
+ session.xenapi.login_with_password(username, password)
+ except Exception, exn:
+ print str(exn)
+ # http://sources.redhat.com/cluster/wiki/FenceAgentAPI says that for no connectivity
+ # the exit value should be 1. It doesn't say anything about failed logins, so
+ # until I hear otherwise it is best to keep this exit the same to make sure that
+ # anything calling this script (that uses the same information in the web page
+ # above) knows that this is an error condition, not a msg signifying a down port.
+ sys.exit(EC_BAD_SESSION)
+ return session
+
+# return a reference to the VM by either using the UUID or the vm_name/port. If the UUID is set then
+# this is tried first as this is the only properly unique identifier.
+# Exceptions are not handled in this function, code that calls this must be ready to handle them.
+def return_vm_reference(session, options):
+ if options.has_key("--verbose"):
+ verbose = True
+ else:
+ verbose = False
+
+ # Case where the UUID has been specified
+ if options.has_key("--uuid"):
+ uuid = options["--uuid"].lower()
+ # When using the -n parameter for name, we get an error message (in verbose
+ # mode) that tells us that we didn't find a VM. To immitate that here we
+ # need to catch and re-raise the exception produced by get_by_uuid.
+ try:
+ return session.xenapi.VM.get_by_uuid(uuid)
+ except Exception, exn:
+ if verbose:
+ print "No VM's found with a UUID of \"%s\"" % uuid
+ raise
+
+
+ # Case where the vm_name/port has been specified
+ if options.has_key("--plug"):
+ vm_name = options["--plug"]
+ vm_arr = session.xenapi.VM.get_by_name_label(vm_name)
+ # Need to make sure that we only have one result as the vm_name may
+ # not be unique. Average case, so do it first.
+ if len(vm_arr) == 1:
+ return vm_arr[0]
+ else:
+ if len(vm_arr) == 0:
+ if verbose:
+ print "No VM's found with a name of \"%s\"" % vm_name
+ # NAME_INVALID used as the XenAPI throws a UUID_INVALID if it can't find
+ # a VM with the specified UUID. This should make the output look fairly
+ # consistent.
+ raise Exception("NAME_INVALID")
+ else:
+ if verbose:
+ print "Multiple VM's have the name \"%s\", use UUID instead" % vm_name
+ raise Exception("MULTIPLE_VMS_FOUND")
+
+ # We should never get to this case as the input processing checks that either the UUID or
+ # the name parameter is set. Regardless of whether or not a VM is found the above if
+ # statements will return to the calling function (either by exception or by a reference
+ # to the VM).
+ raise Exception("VM_LOGIC_ERROR")
+
+def main():
+
+ device_opt = [ "login", "passwd", "port", "no_login", "no_password", "session_url" ]
+
+ atexit.register(atexit_handler)
+
+ options = check_input(device_opt, process_input(device_opt))
+
+ docs = { }
+ docs["shortdesc"] = "XenAPI based fencing for the Citrix XenServer virtual machines."
+ docs["longdesc"] = "\
+fence_cxs is an I/O Fencing agent used on Citrix XenServer hosts. \
+It uses the XenAPI, supplied by Citrix, to establish an XML-RPC sesssion \
+to a XenServer host. Once the session is established, further XML-RPC \
+commands are issued in order to switch on, switch off, restart and query \
+the status of virtual machines running on the host."
+ docs["vendorurl"] = "http://www.xenproject.org"
+ show_docs(options, docs)
+
+ xenSession = connect_and_login(options)
+
+ # Operate the fencing device
+ result = fence_action(xenSession, options, set_power_fn, get_power_fn, get_outlet_list)
+
+ sys.exit(result)
+
+if __name__ == "__main__":
+ main()
diff --git a/fence/agents/zvm/Makefile.am b/fence/agents/zvm/Makefile.am
new file mode 100644
index 0000000..2dc0005
--- /dev/null
+++ b/fence/agents/zvm/Makefile.am
@@ -0,0 +1,13 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+sbin_PROGRAMS = fence_zvm fence_zvmip
+
+noinst_HEADERS = fence_zvm.h
+
+fence_zvm_SOURCES = fence_zvm.c
+fence_zvm_CFLAGS = -D_GNU_SOURCE
+
+fence_zvmip_SOURCES = fence_zvmip.c
+fence_zvmip_CFLAGS = -D_GNU_SOURCE
+
+dist_man_MANS = fence_zvm.8 fence_zvmip.8
diff --git a/fence/agents/zvm/fence_zvm.8 b/fence/agents/zvm/fence_zvm.8
new file mode 100644
index 0000000..46bfe3f
--- /dev/null
+++ b/fence/agents/zvm/fence_zvm.8
@@ -0,0 +1,81 @@
+.TH fence_zvm 8
+
+.SH NAME
+fence_zvm - Power Fencing agent for GFS on System z z/VM Clusters
+
+.SH SYNOPSIS
+.B
+fence_zvm
+[\fIOPTION\fR]...
+
+.SH DESCRIPTION
+fence_zvm is a Power Fencing agent used on a GFS virtual machine in a System z z/VM cluster.
+It uses the SMAPI interface to recycle an active image.
+
+fence_zvm accepts options on the command line as well as from stdin.
+fence_node sends the options through stdin when it execs the agent.
+fence_zvm can be run by itself with command line options which is useful
+for testing.
+
+Vendor URL: http://www.sinenomine.net
+
+.SH OPTIONS
+.TP
+\fB-o --action\fP
+Fencing action: "off" - fence off device; "metadata" - display device metadata
+.TP
+\fB-n --plug\fP \fItarget\fP
+Name of virtual machine to recycle.
+.TP
+\fB-h --help\fP
+Print out a help message describing available options, then exit.
+.TP
+\fB-a --ip\fP \fIsmapi Server\fP
+\fBName\fP of SMAPI server virtual machine. To be consistent with other fence agents thisname is a little misleading: it is the name of the virtual machine not its IP address or hostname.
+.TP
+\fB-h --help\fP
+Display usage information
+.TP
+\fI-t --timeout = < shutdown timeout >\fP
+Amount of \fIgrace\fP time to give the virtual machine to shutdown cleanly before being
+forcibly terminated. Currently, this option is ignored.
+
+.SH STDIN PARAMETERS
+.TP
+\fIagent = < param >\fP
+This option is used by fence_node(8) and is ignored by fence_zvm.
+.TP
+\fIaction = < action >\fP
+Fencing action: "off" - fence off device; "metadata" - display device metadata
+.TP
+\fIport = < target >\fP
+Name of virtual machine to recycle.
+.TP
+\fIipaddr= < server name >\fP
+\fBName\fP of SMAPI server virtual machine. To be consistent with other fence agents thisname is a little misleading: it is the name of the virtual machine not its IP address or hostname.
+.TP
+\fItimeout = < shutdown timeout >\fP
+Amount of \fIgrace\fP time to give the virtual machine to shutdown cleanly before being
+forcibly terminated. Currently, this option is ignored.
+
+.SH SEE ALSO
+fence(8), fenced(8), fence_node(8)
+
+.SH NOTES
+To use this agent the z/VM SMAPI service needs to be configured to allow the virtual
+machine running this agent to connect to it and issue the image_recycle operation.
+This involves updating the VSMWORK1 AUTHLIST VMSYS:VSMWORK1. file. The entry should look
+something similar to this:
+
+.nf
+Column 1 Column 66 Column 131
+| | |
+V V V
+XXXXXXXX ALL IMAGE_OPERATIONS
+.fi
+
+Where XXXXXXX is the name of the virtual machine where the agent resides.
+
+In addition, the VM directory entry that defines this virtual machine requires the
+IUCV ANY statement (or IUCV <userid of SMAPI Server>). This authorizes use of IUCV
+to connect to the SMAPI server.
diff --git a/fence/agents/zvm/fence_zvm.c b/fence/agents/zvm/fence_zvm.c
new file mode 100644
index 0000000..e553b85
--- /dev/null
+++ b/fence/agents/zvm/fence_zvm.c
@@ -0,0 +1,601 @@
+/*
+ * fence_zvm.c: SMAPI interface for managing zVM Guests
+ *
+ * Copyright (C) 2012 Sine Nomine Associates
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see
+ * <http://www.gnu.org/licenses/>.
+ *
+ * Authors:
+ * Neale Ferguson <neale at sinenomine.net>
+ *
+ */
+
+#ifdef __s390__
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+#include <fcntl.h>
+#include <sys/types.h>
+#include <dirent.h>
+#include <time.h>
+#include <sys/stat.h>
+#include <unistd.h>
+#include <limits.h>
+#include <errno.h>
+#include <string.h>
+#include <sys/wait.h>
+#include <sys/socket.h>
+#include <netinet/in.h>
+#include <netiucv/iucv.h>
+#include <arpa/inet.h>
+#include <netdb.h>
+#include <getopt.h>
+#include <ctype.h>
+#include <syslog.h>
+#include "fence_zvm.h"
+
+#define MIN(a,b) ((a) < (b) ? (a) : (b))
+#define DEFAULT_TIMEOUT 300
+
+static int zvm_smapi_reportError(void *, void *);
+
+static struct option longopts[] = {
+ {"action", required_argument, NULL, 'o'},
+ {"help", no_argument, NULL, 'h'},
+ {"ip", required_argument, NULL, 'a'},
+ {"plug", required_argument, NULL, 'n'},
+ {"timeout", required_argument, NULL, 'T'},
+ {NULL, 0, NULL, 0}
+};
+
+static char *optString = "a:ho:n:T:";
+
+static int zvm_metadata(void);
+static int usage(void);
+
+/**
+ * zvm_smapi_open:
+ * @zvm: z/VM driver information
+ *
+ * Opens a connection with the z/VM SMAPI server
+ */
+int
+zvm_smapi_open(zvm_driver_t *zvm)
+{
+ int rc = -1,
+ sockaddrlen;
+ static char iucvprog[9] = "DMSRSRQU\0";
+ struct sockaddr_iucv siucv_addr;
+ const struct sockaddr *siucv_ptr = (void *) &siucv_addr;
+
+ if ((zvm->sd = socket(AF_IUCV, SOCK_STREAM, IPPROTO_IP)) != -1) {
+ memset(&siucv_addr,0,sizeof(siucv_addr));
+ siucv_addr.siucv_family = AF_IUCV;
+ siucv_addr.siucv_port = 0;
+ siucv_addr.siucv_addr = 0;
+ memset(&siucv_addr.siucv_nodeid,' ',8);
+ memset(&siucv_addr.siucv_user_id,' ',8);
+ memset(&siucv_addr.siucv_name,' ',8);
+ sockaddrlen = sizeof(siucv_addr);
+ if ((rc = bind(zvm->sd,siucv_ptr,sockaddrlen)) != -1) {
+ memcpy(&siucv_addr.siucv_user_id,zvm->smapiSrv,strlen(zvm->smapiSrv));
+ memcpy(&siucv_addr.siucv_name,&iucvprog,8);
+ rc = connect(zvm->sd,(__CONST_SOCKADDR_ARG)siucv_ptr,sockaddrlen);
+ }
+ if (rc == -1) {
+ syslog(LOG_ERR, "Error connecting to %s - %m", zvm->smapiSrv);
+ close(zvm->sd);
+ }
+ }
+ return(rc);
+}
+
+/**
+ * zvm_smapi_imageRecycle
+ * @zvm: z/VM driver information
+ *
+ * Deactivates a virtual image
+ */
+int
+zvm_smapi_imageRecycle(zvm_driver_t *zvm)
+{
+ struct _inPlist {
+ int32_t lPlist;
+ int32_t lFName;
+ char fName[13];
+ int32_t lUser;
+ int32_t lPass;
+ int32_t lTarget;
+ char target[0];
+ } __attribute__ ((__packed__)) *inPlist;
+ int32_t lInPlist;
+ struct _outPlist {
+ smapiOutHeader_t hdr;
+ int32_t nActive;
+ int32_t nInActive;
+ int32_t lFail;
+ char failArray[0];
+ } *outPlist = NULL;
+ void *pOut = NULL;
+ int32_t lRsp;
+ uint32_t reqId;
+ int rc;
+
+ lInPlist = sizeof(*inPlist) + strlen(zvm->target);
+ inPlist = malloc(lInPlist);
+ if (inPlist != NULL) {
+ inPlist->lPlist = lInPlist - sizeof(inPlist->lPlist);
+ inPlist->lFName = sizeof(inPlist->fName);
+ memcpy(inPlist->fName, Image_Recycle, sizeof(inPlist->fName));
+ inPlist->lUser = inPlist->lPass = 0;
+ inPlist->lTarget = strlen(zvm->target);
+ memcpy(inPlist->target, zvm->target, inPlist->lTarget);
+ if ((rc = zvm_smapi_send(zvm, inPlist, &reqId, lInPlist)) != -1) {
+ if ((rc = zvm_smapi_recv(zvm, &pOut, &lRsp)) != -1) {
+ outPlist = pOut;
+ if (outPlist->hdr.rc == 0) {
+ syslog(LOG_INFO, "Recycling of %s successful",
+ zvm->target);
+ rc = 0;
+ } else {
+ if ((outPlist->hdr.rc == RCERR_IMAGEOP) &
+ ((outPlist->hdr.reason == RS_NOT_ACTIVE) |
+ (outPlist->hdr.reason == RS_BEING_DEACT))) {
+ syslog(LOG_INFO, "Recycling of %s successful",
+ zvm->target);
+ rc = 0;
+ } else {
+ rc = outPlist->hdr.rc;
+ zvm->reason = outPlist->hdr.reason;
+ (void) zvm_smapi_reportError(inPlist, outPlist);
+ }
+ }
+ }
+ }
+ free(inPlist);
+ free(outPlist);
+ } else {
+ syslog(LOG_ERR, "%s - cannot allocate parameter list", __func__);
+ rc = -1;
+ }
+ return(rc);
+}
+
+/**
+ * zvm_smapi_send:
+ * @zvm: z/VM driver information
+ * @reqid: Returned request id
+ * @req: Request parameter list
+ * @lSend: Length of request
+ *
+ * Send a request to the SMAPI server and retrieve the request id
+ */
+int
+zvm_smapi_send(zvm_driver_t *zvm, void *req, uint32_t *reqId, int32_t lSend)
+{
+ int rc,
+ nFds;
+ fd_set readFds;
+ struct timeval timeout;
+
+ timeout.tv_sec = 30;
+ timeout.tv_usec = 0;
+ zvm->reason = -1;
+ if ((rc = zvm_smapi_open(zvm)) == 0) {
+ rc = send(zvm->sd,req,lSend,0);
+ if (rc != -1) {
+ FD_ZERO(&readFds);
+ FD_SET(zvm->sd,&readFds);
+ nFds = zvm->sd + 1;
+
+ if ((rc = select(nFds,&readFds,NULL,NULL,&timeout)) != -1) {
+ /*
+ * Get request ID
+ */
+ rc = recv(zvm->sd,reqId,sizeof(*reqId),0);
+ if (rc == -1)
+ syslog(LOG_ERR, "Error receiving from SMAPI - %m");
+ }
+ } else
+ syslog(LOG_ERR, "Error sending to SMAPI - %m");
+ }
+ return(rc);
+}
+
+/**
+ * zvm_smapi_recv:
+ * @zvm: z/VM driver information
+ * @req: Returned response parameter list
+ * @lRsp: Length of response
+ *
+ * Receive a response from the SMAPI server
+ */
+int
+zvm_smapi_recv(zvm_driver_t *zvm, void **rsp, int32_t *lRsp)
+{
+ int rc,
+ lRem = 0,
+ nFds;
+ void *pRecv = rsp;
+ fd_set readFds;
+ smapiOutHeader_t *out;
+ struct timeval timeout;
+
+ timeout.tv_sec = 30;
+ timeout.tv_usec = 0;
+ FD_ZERO(&readFds);
+ FD_SET(zvm->sd,&readFds);
+ nFds = zvm->sd + 1;
+
+ zvm->reason = -1;
+ if ((rc = select(nFds,&readFds,NULL,NULL,&timeout)) != -1) {
+ /*
+ * Get response length
+ */
+ if ((rc = recv(zvm->sd,lRsp,sizeof(*lRsp),0)) != -1) {
+ lRem = *lRsp;
+ if (*rsp == NULL)
+ *rsp = malloc(*lRsp + sizeof(out->outLen));
+ out = *rsp;
+ out->outLen = *lRsp;
+ pRecv = &out->reqId;
+ while (lRem > 0) {
+ if ((rc = recv(zvm->sd,pRecv,lRem,0)) != -1) {
+ lRem -= rc;
+ pRecv = (void *) ((uintptr_t) pRecv + rc);
+ } else
+ syslog(LOG_ERR, "Error receiving from SMAPI - %m");
+ (void) zvm_smapi_close(zvm);
+ return(rc);
+ }
+ zvm->reason = out->reason;
+ }
+ } else
+ syslog(LOG_ERR, "Error receiving from SMAPI - %m");
+
+ (void) zvm_smapi_close(zvm);
+
+ return(rc);
+}
+
+/**
+ * zvm_smapi_close:
+ * @zvm: z/VM driver information
+ *
+ * Close a connection with the z/VM SMAPI server
+ */
+int
+zvm_smapi_close(zvm_driver_t *zvm)
+{
+ close(zvm->sd);
+ return(0);
+}
+
+/**
+ * zvm_smapi_reportError
+ * @inHdr - Input parameter list header
+ * @outHdr - Output parameter list header
+ *
+ * Report an error from the SMAPI server
+ */
+static int
+zvm_smapi_reportError(void *inHdr, void *oHdr)
+{
+ struct _inParm {
+ int32_t lPlist;
+ int32_t lFName;
+ char fName[0];
+ } *inParm = inHdr;
+ smapiOutHeader_t *outHdr = oHdr;
+ char fName[64];
+
+ memset(fName, 0, sizeof(fName));
+ memcpy(fName, inParm->fName, inParm->lFName);
+ syslog(LOG_ERR, "%s - returned (%d,%d)",
+ fName, outHdr->rc, outHdr->reason);
+ return(-1);
+}
+
+
+/**
+ * trim - Trim spaces from string
+ * @str - Pointer to string
+ *
+ */
+static int
+trim(char *str)
+{
+ char *p;
+ int len;
+
+ if (!str)
+ return (0);
+
+ len = strlen (str);
+
+ while (len--) {
+ if (isspace (str[len])) {
+ str[len] = 0;
+ } else {
+ break;
+ }
+ }
+
+ for (p = str; *p && isspace (*p); p++);
+
+ memmove(str, p, strlen (p) + 1);
+
+ return (strlen (str));
+}
+
+/**
+ * zvm_metadata - Show fence metadata
+ * @self - Path to this executable
+ *
+ */
+static int
+zvm_metadata()
+{
+ fprintf (stdout, "<?xml version=\"1.0\" ?>\n");
+ fprintf (stdout, "<resource-agent name=\"fence_zvm\"");
+ fprintf (stdout, " shortdesc=\"Fence agent for use with z/VM Virtual Machines\">\n");
+ fprintf (stdout, "<longdesc>");
+ fprintf (stdout, "The fence_zvm agent is intended to be used with with z/VM SMAPI service.");
+ fprintf (stdout, "</longdesc>\n");
+
+ fprintf (stdout, "<parameters>\n");
+
+ fprintf (stdout, "\t<parameter name=\"port\" unique=\"1\" required=\"1\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-n, --plug\" />\n");
+ fprintf (stdout, "\t\t<content type=\"string\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Name of the Virtual Machine to be fenced");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"ipaddr\" unique=\"1\" required=\"1\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-a, --ip\" />\n");
+ fprintf (stdout, "\t\t<content type=\"string\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Name of the SMAPI IUCV Server Virtual Machine");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"action\" unique=\"1\" required=\"0\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-o, --action\" />\n");
+ fprintf (stdout, "\t\t<content type=\"string\" default=\"off\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Fencing action");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"usage\" unique=\"1\" required=\"0\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-h, --help\" />\n");
+ fprintf (stdout, "\t\t<content type=\"boolean\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Print usage");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "</parameters>\n");
+
+ fprintf (stdout, "<actions>\n");
+ fprintf (stdout, "\t<action name=\"off\" />\n");
+ fprintf (stdout, "\t<action name=\"metadata\" />\n");
+ fprintf (stdout, "</actions>\n");
+
+ fprintf (stdout, "</resource-agent>\n");
+
+ return(0);
+
+}
+
+/**
+ * get_options_stdin - get options from stdin
+ * @zvm - Pointer to driver information
+ *
+ */
+static int
+get_options_stdin (zvm_driver_t *zvm)
+{
+ char buf[1024],
+ *endPtr,
+ *opt,
+ *arg;
+ int32_t lSrvName,
+ lTarget;
+ int fence = 0;
+
+ while (fgets (buf, sizeof (buf), stdin) != 0) {
+ if (trim(buf) == 0) {
+ continue;
+ }
+ if (buf[0] == '#') {
+ continue;
+ }
+
+ opt = buf;
+
+ if ((arg = strchr(opt, '=')) != 0) {
+ *arg = 0;
+ arg++;
+ } else {
+ continue;
+ }
+
+ if (trim(arg) == 0)
+ continue;
+
+ if (!strcasecmp (opt, "action")) {
+ if (strcasecmp(arg, "off") == 0) {
+ fence = 0;
+ } else if (strcasecmp(arg, "metadata") == 0) {
+ fence = 1;
+ } else {
+ fence = 2;
+ }
+ } else if (!strcasecmp (opt, "ipaddr")) {
+ lSrvName = MIN(strlen(arg), sizeof(zvm->smapiSrv));
+ memcpy(zvm->smapiSrv, arg, lSrvName);
+ continue;
+ } else if (!strcasecmp (opt, "port")) {
+ lTarget = MIN(strlen(arg), sizeof(zvm->target)-1);
+ strncpy(zvm->target, arg, lTarget);
+ continue;
+ } else if (!strcasecmp (opt, "timeout")) {
+ zvm->timeOut = strtoul(arg, &endPtr, 10);
+ if (*endPtr != 0) {
+ syslog(LOG_WARNING, "Invalid timeout value specified %s "
+ "defaulting to %d",
+ arg, DEFAULT_TIMEOUT);
+ zvm->timeOut = DEFAULT_TIMEOUT;
+ }
+ } else if (!strcasecmp (opt, "help")) {
+ fence = 2;
+ }
+ }
+ return(fence);
+}
+
+/**
+ * get_options - get options from the command line
+ * @argc - Count of arguments
+ * @argv - Array of character strings
+ * @zvm - Pointer to driver information
+ *
+ */
+static int
+get_options(int argc, char **argv, zvm_driver_t *zvm)
+{
+ int c,
+ fence = 0;
+ int32_t lSrvName,
+ lTarget;
+ char *endPtr;
+
+ while ((c = getopt_long(argc, argv, optString, longopts, NULL)) != -1) {
+ switch (c) {
+ case 'n' :
+ lTarget = MIN(strlen(optarg), sizeof(zvm->target));
+ memcpy(zvm->target, optarg, lTarget);
+ break;
+ case 'o' :
+ if (strcasecmp(optarg, "off") == 0) {
+ fence = 0;
+ } else if (strcasecmp(optarg, "metadata") == 0) {
+ fence = 1;
+ } else {
+ fence = 2;
+ }
+ break;
+ case 's' :
+ lSrvName = MIN(strlen(optarg), sizeof(zvm->smapiSrv));
+ memcpy(zvm->smapiSrv, optarg, lSrvName);
+ break;
+ case 't' :
+ zvm->timeOut = strtoul(optarg, &endPtr, 10);
+ if (*endPtr != 0) {
+ syslog(LOG_WARNING, "Invalid timeout value specified: %s - "
+ "defaulting to %d",
+ optarg, DEFAULT_TIMEOUT);
+ zvm->timeOut = DEFAULT_TIMEOUT;
+ }
+ break;
+ default :
+ fence = 2;
+ }
+ }
+ return(fence);
+}
+
+/**
+ * usage - display command syntax and parameters
+ *
+ */
+static int
+usage()
+{
+ fprintf(stderr,"Usage: fence_zvm [options]\n\n"
+ "\tWhere [options] =\n"
+ "\t-o --action [action] - \"off\", \"metadata\"\n"
+ "\t-n --plug [target] - Name of virtual machine to fence\n"
+ "\t-s --server [server] - Name of SMAPI IUCV Request server\n"
+ "\t-T --timeout [secs] - Time to wait for fence in seconds - currently ignored\n"
+ "\t-h --help - Display this usage information\n");
+ return(1);
+}
+
+/**
+ * check_param - Check that mandatory parameters have been specified
+ * @zvm - Pointer to driver information
+ *
+ */
+static int
+check_parm(zvm_driver_t *zvm)
+{
+ int rc;
+
+ if (zvm->smapiSrv[0] != 0) {
+ if (zvm->target[0] != 0) {
+ rc = 0;
+ } else {
+ syslog(LOG_ERR, "Missing fence target name");
+ rc = 2;
+ }
+ } else {
+ syslog(LOG_ERR, "Missing SMAPI server name");
+ rc = 1;
+ }
+ return(rc);
+}
+
+int
+main(int argc, char **argv)
+{
+ zvm_driver_t zvm;
+ int fence,
+ rc = 0;
+
+ openlog ("fence_zvm", LOG_CONS|LOG_PID, LOG_DAEMON);
+ memset(&zvm, 0, sizeof(zvm));
+ zvm.timeOut = DEFAULT_TIMEOUT;
+
+ if (argc > 1)
+ fence = get_options(argc, argv, &zvm);
+ else
+ fence = get_options_stdin(&zvm);
+
+ switch(fence) {
+ case 0 :
+ if ((rc = check_parm(&zvm)) == 0)
+ rc = zvm_smapi_imageRecycle(&zvm);
+ break;
+ case 1 :
+ rc = zvm_metadata();
+ break;
+ case 2 :
+ rc = usage();
+ }
+ closelog();
+ return (rc);
+}
+#else
+#include <syslog.h>
+int
+main(int argc, char **argv)
+{
+ openlog ("fence_zvm", LOG_CONS|LOG_PID, LOG_DAEMON);
+ syslog(LOG_ERR,"Fencing of a z/VM agent is not possible on this platform\n");
+ closelog();
+ return(-1);
+}
+#endif
diff --git a/fence/agents/zvm/fence_zvm.h b/fence/agents/zvm/fence_zvm.h
new file mode 100644
index 0000000..3c00c1c
--- /dev/null
+++ b/fence/agents/zvm/fence_zvm.h
@@ -0,0 +1,580 @@
+/*
+ * fence_zvm.h: SMAPI interface for z/VM Guests
+ *
+ * Copyright (C) 2012 Sine Nomine Associates
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see
+ * <http://www.gnu.org/licenses/>.
+ *
+ * Authors:
+ * Neale Ferguson <neale at sinenomine.net>
+ *
+ */
+
+#ifndef FENCE_ZVM_H
+# define FENCE_ZVM_H
+
+# include <sys/types.h>
+
+# define SMAPI_TARGET "OVIRTADM"
+# define SMAPI_MAXCPU 96
+
+/*
+ * Return codes
+ */
+# define RC_OK 0 /* Request successful */
+# define RC_WNG 4 /* Warning */
+# define RC_ERR 8 /* Error */
+# define RCERR_SYNTAX 24 /* Function parameter syntax error */
+# define RCERR_FILE_NOT_FOUND 28 /* File not found */
+# define RCERR_FILE_CANNOT_BE_UPDATED 36 /* Name list file cannot be updated */
+# define RCERR_AUTH 100 /* Request not authorized by ESM */
+# define RCERR_NO_AUTHFILE 104 /* Authorization file not found */
+# define RCERR_AUTHFILE_RO 106 /* Authorization file cannot be updated */
+# define RCERR_EXISTS 108 /* Authorization file entry already exists */
+# define RCERR_NO_ENTRY 112 /* Authorization file entry does not exist */
+# define RCERR_USER_PW_BAD 120 /* Authentication error: Userid or pwd invalid */
+# define RCERR_PW_EXPIRED 128 /* Authentication error: password expired */
+# define RCERR_ESM 188 /* ESM failure */
+# define RCERR_PW_CHECK 192 /* Internal error: can't authenticate user or pwd */
+# define RCERR_DMSCSL 196 /* Internal Callable Services error */
+# define RCERR_IMAGEOP 200 /* Image Operation error */
+# define RCERR_LIST 200 /* Bad rc for list or list function */
+# define RCERR_IMAGEDEVU 204 /* Image Device Usage error */
+# define RCERR_IMAGEDISKU 208 /* Image Disk Usage error */
+# define RCERR_IMAGECONN 212 /* Image Connectivity Definition error */
+# define RCERR_IMAGECPU 216 /* Image CPU definition error */
+# define RCERR_VOLUME 300 /* Image Volume function error */
+# define RCERR_INTERNAL 396 /* Internal product-specific error */
+# define RCERR_IMAGE_NAME 400 /* Image Name error */
+# define RCERR_IMAGEDEF 400 /* Image Definition error */
+# define RCERR_IMAGEDEVD 404 /* Image Device Definition error */
+# define RCERR_IMAGEDISKD 408 /* Image Disk Definition error */
+# define RCERR_IMAGECONND 412 /* Image Connectivity Definition error */
+# define RCERR_PROTODEF 416 /* Prototype Definition error */
+# define RCERR_DASD_DM 420 /* Volume/region name already defined or region in group */
+# define RCERR_SEGMENT_DM 424 /* Segment definition errors */
+# define RCERR_NOTIFY 428 /* Notification subscription errors */
+# define RCERR_TAG 432 /* Local tag definition errors */
+# define RCERR_PROFILED 436 /* Profile definition errors */
+# define RCERR_POLICY_PW 444 /* Password policy error */
+# define RCERR_POLICY_ACCT 448 /* Account number policy error */
+# define RCERR_TASK 452 /* Task error */
+# define RCERR_SCSI 456 /* SCSI error */
+# define RCERR_DM 500 /* Directory Manager error */
+# define RCERR_LIST_DM 504 /* Directory Manager list error */
+# define RCERR_ASYNC_DM 592 /* Asynchronous Operation error */
+# define RCERR_INTERNAL_DM 596 /* Internal Directory Manager error */
+# define RCERR_SHSTOR 600 /* Shared Memory function error */
+# define RCERR_VIRTUALNETWORKD 620 /* Vswitch function error */
+# define RCERR_VMRM 800 /* Error from VMRM functions */
+# define RCERR_SERVER 900 /* Socket-Server error */
+
+/*
+ * Syntax error reason codes
+ */
+# define RS_NONE 0
+# define RS_TOOMANY 0
+# define RS_TANY 0
+# define RS_TBIN 2
+# define RS_UNSIGNEDINT 10
+# define RS_TNUM 10
+# define RS_UNSUPPORTED 11
+# define RS_SHORT 14
+# define RS_LESSTHANMIN 15
+# define RS_HEX 16
+# define RS_THEX 16
+# define RS_THEXHY 17
+# define RS_LONG 13
+# define RS_MORETHANMAX 18
+# define RS_UNRECOG 19
+# define RS_CONFLICTING 23
+# define RS_UNSPECIFIED 24
+# define RS_EXTRANEOUS 25
+# define RS_ALPHABETIC 26
+# define RS_TALPHA 26
+# define RS_FUNCTIONNAME 27
+# define RS_TALPHA_ 27
+# define RS_ALPHANUMERIC 36
+# define RS_TNUMALPHA 36
+# define RS_ALPHANUMERIC_ 37
+# define RS_TNUMALPHAHY 37
+# define RS_TLIST 38
+# define RS_DIRMAINTFILE 42
+# define RS_TFILE 42
+# define RS_DIRMAINTFILE_ 43
+# define RS_TFILE_ 43
+# define RS_DIRMAINTFILE_EQ 44
+# define RS_TFILE_EQ 44
+# define RS_UNEXPECTED_END 88
+# define RS_NON_BREAKING_CHAR 99
+# define RS_TNONBLANK 99
+
+/*
+ * Non-syntax related reason codes
+ */
+# define RS_NONE 0 /* Request successful */
+# define RS_INVALID_USER 2 /* Invalid user */
+# define RS_INVALID_DEVICE 2 /* invalid device */
+# define RS_NO_OSAS 4 /* No OSAs exist */
+# define RS_INVALID_OP 3 /* Invalid LAN operation */
+# define RS_INVALID_PRO 4 /* Invalid LAN promiscuity */
+# define RS_NO_DEV 4 /* No IPL device */
+# define RS_DEFERRED_SERVER 4 /* Authorization deferred to server */
+# define RS_DUP_NAME 4 /* Duplicate tag name */
+# define RS_EXISTS 4 /* Device already exists*/
+# define RS_IN_USE 4 /* Image Disk already in use */
+# define RS_IVS_NAME_USED 4 /* Group/region/volume already defined */
+# define RS_LOADDEV_NOT_FOUND 4 /* LOADDEV statement not found */
+# define RS_NO_PARTNER 4 /* Partner image not found */
+# define RS_NO_UPDATES 4 /* Directory manager not accepting update*/
+# define RS_NOT_FOUND 4 /* Image/Task Not Found */
+# define RS_NOTIFY_DUPLICATE 4 /* Duplicate subscription */
+# define RS_SEG_NAME_DUPLICATE 4 /* Segment name already used */
+# define RS_AFFINITY_SUPPRESSED 4 /* CPU defined but affinity suppressed */
+# define RS_WORK_OUTSTANDING 4 /* Image_Defintion_* asynch */
+# define RS_UNRESTRICTED_LAN 5 /* LAN is unrestricted */
+# define RS_NO_USERS 6 /* No users authorized for LAN */
+# define RS_ADAPTER_NOT_EXIST 8 /* Adapter does not exist */
+# define RS_ALREADY_ACTIVE 8 /* Image already active */
+# define RS_AUTHERR_CONNECT 8 /* Not authorized to connect */
+# define RS_AUTHERR_ESM 8 /* Request not authorized by an ESM */
+# define RS_BAD_RANGE 8 /* Bad page range */
+# define RS_DEV_NOT_FOUND 8 /* Device not found */
+# define RS_IVS_NAME_NOT_USED 8 /* Group/region/volume is not defined */
+# define RS_NAME_EXISTS 8 /* Image Name already defined */
+# define RS_NO_MEASUREMENT_DATA 8 /* No VMRM measurement query data */
+# define RS_NOT_AVAILABLE 8 /* Directory manager not available */
+# define RS_NOT_DEFINED 8 /* Image Device/Volume/Region/Group/Tag name not defined */
+# define RS_NOT_EXIST 8 /* Device does not exist */
+# define RS_NOTIFY_NOT_FOUND 8 /* No matching entries */
+# define RS_NOT_IN_USE 8 /* Image disk not in use */
+# define RS_OFFLINE 8 /* Successful; Object directory offline */
+# define RS_SEG_NAME_NOT_FOUND 8 /* Segment name not used */
+# define RS_WORKER_NOT_FOUND 8 /* Worker server not found */
+# define RS_DEV_NOT_AVAIL_TO_ATTACH 10 /* Device not found */
+# define RS_TOO_MANY_PARM 10 /* Too many parms in parameter list */
+# define RS_TOO_FEW_PARM 11 /* Too few parms in parameter list */
+# define RS_ALREADY_LOCKED 12 /* Image definition already locked */
+# define RS_AUTHERR_DM 12 /* Request not authorized by Directory Manager */
+# define RS_BUSY 12 /* Image device is busy */
+# define RS_DUP_ORDINAL 12 /* Duplicate tag ordinal */
+# define RS_FUNCTION_NOT_VALID 12 /* Not a valid SMAPI function */
+# define RS_IVS_NAME_NOT_INCLUDED 12 /* Name not included (ISR,ISQ)*/
+# define RS_LAN_NOT_EXIST 12 /* LAN does not exist */
+# define RS_LOCKED 12 /* Image definition is locked */
+# define RS_NAMESAVE_EXISTS 12 /* Namesave statementt already in directory*/
+# define RS_NEW_LIST 12 /* Successful new list created */
+# define RS_NOT_ACTIVE 12 /* Image not active */
+# define RS_NOT_INCLUDED 12 /* Region not included in group */
+# define RS_NOT_LOGGED_ON 12 /* User not logged on */
+# define RS_DEV_NOT_VOLUME 12 /* Device not a volume */
+# define RS_UPDATE_SYNTAX_ERROR 12 /* Errors in configuration update buffer */
+# define RS_FREE_MODE_NOT_AVAIL 14 /* Free mode not available */
+# define RS_AUTHERR_SERVER 16 /* Request not authorized by server */
+# define RS_BEING_DEACT 16 /* Image being deactivated */
+# define RS_CANNOT_ACCESS_DATA 16 /* Cannot access configuration or VMRM measurement data */
+# define RS_CANNOT_DELETE 16 /* Cannot delete image definition */
+# define RS_CANNOT_REVOKE 16 /* Cannot revoke tag definition */
+# define RS_CANNOT_SHARE 16 /* Image disk cannot be shared */
+# define RS_DEV_NOT_ONLINE 16 /* Device not online */
+# define RS_LIST_DESTROYED 16 /* Successful no more entries: list destroyed */
+# define RS_NO_MATCH 16 /* Parameters don't match existing directory statement */
+# define RS_NO_SHARING 16 /* Image disk sharing not allowed by target image definition */
+# define RS_NOSAVE 16 /* Could not save segment */
+# define RS_PTS_ENTRY_NOT_VALID 16 /* Parser entry not valid */
+# define RS_TAG_LONG 16 /* Tag too long */
+# define RS_VOLID_NOT_FOUND 18 /* Volid not found */
+# define RS_IS_CONNECTED 20 /* Device already connected */
+# define RS_NOT_AUTHORIZED 20 /* Not authorized for function */
+# define RS_OWNER_NOT_ACTIVE 20 /* Owner of reqested LAN not active */
+# define RS_PARM_LIST_NOT_VALID 20 /* Parameter list not valid */
+# define RS_PW_FORMAT_NOT_SUPPORTED 20 /* Directory manager does not support password format */
+# define RS_SHARE_DIFF_MODE 20 /* Image disk shared in different mode */
+# define RS_VOLID_IN_USE 20 /* Volid is in use */
+# define RS_TARGET_IMG_NOT_AUTH 20 /* Target Image not authorized to issue the command */
+# define RS_PDISKS_SAME 22 /* Parm disk 1 and 2 are same */
+# define RS_CONFLICTING_PARMS 24 /* Conflicting storage parameters */
+# define RS_LAN_NAME_EXISTS 24 /* Same name as an existing LAN */
+# define RS_LIST_NOT_FOUND 24 /* List not found */
+# define RS_NO_SPACE 24 /* Image disk space not available */
+# define RS_NOT_LOCKED 24 /* Image name is not locked */
+# define RS_PARM_DISK_LINK_ERR 24 /* Error linking parm disk (1 or 2)*/
+# define RS_SFS_ERROR 24 /* Shared File System error */
+# define RS_TYPE_NOT_SAME 24 /* Image device type not same as source */
+# define RS_UPDATE_WRITE_ERROR 24 /* Configuration update could not write files */
+# define RS_TAPE_NOT_ASSIGNED 24 /* Tape not assigned */
+# define RS_VCPU_ALREADY_EXISTS 24 /* Virtual CPU already defined */
+# define RS_VCPU_OUT_OF_RANGE 28 /* CPU beyond range defined in directory */
+# define RS_DEV_INCOMPATIBLE 28 /* Incorrect device type */
+# define RS_EMPTY 28 /* Return buffer is empty */
+# define RS_FILE_NOT_FOUND 28 /* File not found */
+# define RS_NO_MATCH_ON_SEARCH 28 /* No entries match search criteria */
+# define RS_NOT_ALL 28 /* Some images in list not activated */
+# define RS_OUTPUT_NOT_VALID 28 /* Output from function not valid */
+# define RS_PARM_DISK_NOT_RW 28 /* Parm Disk (1 or 2) not R/W */
+# define RS_PW_NEEDED 28 /* Image Disk does not have required password */
+# define RS_SEGMENT_NOT_FOUND 28 /* Shared Storage Segment not found */
+# define RS_SIZE_NOT_SAME 28 /* Image device size not same as source */
+# define RS_DEV_NOT_SHARED 28 /* Device not shared */
+# define RS_BAD_PW 32 /* Incorrect password specified for image disk */
+# define RS_NOT_CONNECTED 32 /* Device not connected */
+# define RS_NOT_IN_LIST 32 /* Name was not in list */
+# define RS_SOME_NOT_DEACT 32 /* Some Images in list not deactivated */
+# define RS_UPDATE_PROCESS_ERROR 32 /* Configuration update internal processer */
+# define RS_SYS_CONF_NOT_FOUND 32 /* System configuration file not found on PARM disk */
+# define RS_DEV_NOT_RESERVED 32 /* Device not reserved */
+# define RS_REQRESP_NOT_VALID 32 /* Internal request error */
+# define RS_SYS_CONF_BAD_DATA 34 /* Syntax Errors with original system configuration */
+# define RS_IVS_NAME_NOT_DASD 36 /* Name not DASD (for ISD) */
+# define RS_LENGTH_NOT_VALID 36 /* Length on input/output not valid */
+# define RS_NAME_IN_LIST 36 /* Name is already in list */
+# define RS_NO_VOLUME 36 /* No such DASD vol mounted on system; Unable to determine dev type */
+# define RS_SOME_NOT_RECYC 36 /* Some images in list not recycled */
+# define RS_SYS_CONF_SYNTX_ERR 36 /* Syntax errors with system configuration update*/
+# define RS_TIME_NOT_VALID 36 /* Force time for deactvation not valid */
+# define RS_VSWITCH_EXISTS 36 /* VSwitch already exists */
+# define RS_DEV_IO_ERROR 36 /* Device I/O error */
+# define RS_NO_DIR_AUTH_TO_LINK 36 /* No directory authority to link */
+# define RS_CPDISK_MODE_NOT_AVAIL 38 /* CP disk modes not available */
+# define RS_PARM_DISK_FULL 40 /* Parm Disk (1 or 2) is full */
+# define RS_VSWITCH_NOT_EXISTS 40 /* VSwitch doesn't exist */
+# define RS_NWDEV_NOT_DETACHED 40 /* Device not detached */
+# define RS_MULTIPLE 40 /* Multiple - multiple what? */
+# define RS_SOCKET 40 /* Socket error */
+# define RS_TYPE_NOT_SUPPORTED 40 /* CPU type not supported on your system */
+# define RS_PDISK_ACC_NOT_ALLOWED 42 /* Parm Disk 1 or 2 - access not allowed */
+# define RS_ALREADY_AUTH 44 /* Image already granted */
+# define RS_PDISK_PW_NOT_SUPPLIED 44 /* Parm Disk (1 or 2) password not supplied */
+# define RS_DASD_IN_USE 44 /* DASD in use */
+# define RS_IS_DISCONNECTED 48 /* Disconnected */
+# define RS_PDISK_PW_INCORRECT 46 /* Parm Disk (1 or 2) password is incorrect */
+# define RS_PARM_DISK_NOT_IN_SRVR_DIR 48 /* Parm Disk (1 or 2) is not in server's user directory */
+# define RS_VLAN_NOT_FOUND 48 /* vLAN not found */
+# define RS_MAX_CONN 52 /* Max connections reached */
+# define RS_CPRELEASE_ERROR 50 /* CPRELEASE error for Parm Disk (1 or 2) */
+# define RS_CPACCESS_ERROR 52 /* CPACCESS error for Parm Disk (1 or 2) */
+# define RS_DEF_VSWITCH_EXISTS 54 /* DEFINE exists in System Config */
+# define RS_GRANT_EXISTS 56 /* GRANT exists in System Config */
+# define RS_REVOKE_FAILED 58 /* MODIFY does not exist in System Config */
+# define RS_DEF_VSWITCH_NOT_EXIST 60 /* DEFINE does not exist in System config */
+# define RS_VSWITCH_CONFLICT 62 /* VSwitch conflict for set API */
+# define RS_DEF_MOD_MULTI_FOUND 64 /* Multiple Define or Modify statements found */
+# define RS_DEF_MOD_MULTI_ERASED 66 /* Multiple Define or Modify statements erased */
+# define RS_DATABASE 68 /* Unable to access database */
+# define RS_UNKNOWN 96 /* Connect request failed for unknown reason */
+# define RS_RETRY 99 /* Suggest retry API call */
+# define RS_ASYNC_OP_SUCCEEDED 100 /* Asynch operation succeeded */
+# define RS_ASYNC_OP_IN_PROGRESS 104 /* Asynch operation in progress */
+# define RS_ASYNC_OP_FAILED 108 /* Asynch operation failed */
+# define RS_CLASS_S_ALREADY_DEFINED 299 /* DEFSEG class S file exists */
+# define RS_NOT_YET_AVAILABLE 999 /* Function not yet available */
+# define RS_DEVNO_REQUIRES_FREE_DISK 1157 /* DEVNO parameter requires the device to be a free volume*/
+# define RS_INVALID_LANID 2783 /* invalid LAN id */
+# define RS_INVALID_LAN_PARM 2795 /* LAN parameter for this LAN id */
+# define RS_RELOCATION_ERRORS 3000 /* Relocation error(s) encountered */
+# define RS_NO_RELOCATION_ACTIVE 3001 /* No active relocations found */
+# define RS_INVALID_PARAMETER 3002 /* Invalid parameter name */
+# define RS_INVALID_OPERAND 3003 /* Invalid parameter operand */
+# define RS_MISSING_PARAMETER 3004 /* Missing parameter */
+# define RS_NOT_IN_SSI 3005 /* System not in an SSI */
+# define RS_SSI_UNSTABLE 3006 /* SSI is not in a stable state */
+# define RS_SSI_CPOWNED_CONFLICT 3007 /* The volume or slot is not on all systems in SSI */
+# define RS_NOT_SSI_MEMBER 3008 /* Not a member of an SSI cluster */
+# define RS_REPAIR_IPL_PARAM 3009 /* IPLed with the REPAIR IPL param */
+# define RS_RELOCATION_MODIFY_ERROR 3010 /* VMRELOCATE Modify error */
+# define RS_NO_SLOTS_AVAILABLE 3011 /* No unique CP_OWNED slot available on system and in config */
+# define RS_VOLUME_NOT_FOUND 3012 /* VOLUME cannot be found */
+# define RS_VOLUME_OFFLINE 3013 /* The volume is offline */
+# define RS_SHARE_UNSUPPORTED 3014 /* Volume does not support sharing */
+
+/*
+ * API functional level
+ */
+# define RS_530 0 /* 5.3.0 level */
+# define RS_540 540 /* 5.4.0 level */
+# define RS_610 610 /* 6.1.0 level */
+# define RS_611 611 /* 6.1.1 level */
+# define RS_620 620 /* 6.2.0 level */
+# define RS_621 621 /* 6.2.1 level */
+# define RS_630 630 /* 6.3.0 level */
+
+/*
+ * SMAPI Operations
+ */
+# define Asynchronous_Notification_Disable_DM "Asynchronous_Notification_Disable_DM"
+# define Asynchronous_Notification_Enable_DM "Asynchronous_Notification_Enable_DM"
+# define Asynchronous_Notification_Query_DM "Asynchronous_Notification_Query_DM"
+# define Authorization_List_Add "Authorization_List_Add"
+# define Authorization_List_Query "Authorization_List_Query"
+# define Authorization_List_Remove "Authorization_List_Remove"
+# define Check_Authentication "Check_Authentication"
+# define Delete_ABEND_Dump "Delete_ABEND_Dump"
+# define Directory_Manager_Local_Tag_Define_DM "Directory_Manager_Local_Tag_Define_DM"
+# define Directory_Manager_Local_Tag_Delete_DM "Directory_Manager_Local_Tag_Delete_DM"
+# define Directory_Manager_Local_Tag_Query_DM "Directory_Manager_Local_Tag_Query_DM"
+# define Directory_Manager_Local_Tag_Set_DM "Directory_Manager_Local_Tag_Set_DM"
+# define Directory_Manager_Search_DM "Directory_Manager_Search_DM"
+# define Directory_Manager_Task_Cancel_DM "Directory_Manager_Task_Cancel_DM"
+# define Event_Stream_Add "Event_Stream_Add"
+# define Event_Subscribe "Event_Subscribe"
+# define Event_Unsubscribe "Event_Unsubscribe"
+# define Image_Activate "Image_Activate"
+# define Image_Active_Configuration_Query "Image_Active_Configuration_Query"
+# define Image_CPU_Define "Image_CPU_Define"
+# define Image_CPU_Define_DM "Image_CPU_Define_DM"
+# define Image_CPU_Delete "Image_CPU_Delete"
+# define Image_CPU_Delete_DM "Image_CPU_Delete_DM"
+# define Image_CPU_Query "Image_CPU_Query"
+# define Image_CPU_Query_DM "Image_CPU_Query_DM"
+# define Image_CPU_Set_Maximum_DM "Image_CPU_Set_Maximum_DM"
+# define Image_Create_DM "Image_Create_DM"
+# define Image_Deactivate "Image_Deactivate"
+# define Image_Definition_Async_Updates "Image_Definition_Async_Updates"
+# define Image_Definition_Create_DM "Image_Definition_Create_DM"
+# define Image_Definition_Delete_DM "Image_Definition_Delete_DM"
+# define Image_Definition_Query_DM "Image_Definition_Query_DM"
+# define Image_Definition_Update_DM "Image_Definition_Update_DM"
+# define Image_Delete_DM "Image_Delete_DM"
+# define Image_Device_Dedicate "Image_Device_Dedicate"
+# define Image_Device_Dedicate_DM "Image_Device_Dedicate_DM"
+# define Image_Device_Reset "Image_Device_Reset"
+# define Image_Device_Undedicate "Image_Device_Undedicate"
+# define Image_Device_Undedicate_DM "Image_Device_Undedicate_DM"
+# define Image_Disk_Copy "Image_Disk_Copy"
+# define Image_Disk_Copy_DM "Image_Disk_Copy_DM"
+# define Image_Disk_Create "Image_Disk_Create"
+# define Image_Disk_Create_DM "Image_Disk_Create_DM"
+# define Image_Disk_Delete "Image_Disk_Delete"
+# define Image_Disk_Delete_DM "Image_Disk_Delete_DM"
+# define Image_Disk_Query "Image_Disk_Query"
+# define Image_Disk_Share "Image_Disk_Share"
+# define Image_Disk_Share_DM "Image_Disk_Share_DM"
+# define Image_Disk_Unshare "Image_Disk_Unshare"
+# define Image_Disk_Unshare_DM "Image_Disk_Unshare_DM"
+# define Image_IPL_Delete_DM "Image_IPL_Delete_DM"
+# define Image_IPL_Query_DM "Image_IPL_Query_DM"
+# define Image_IPL_Set_DM "Image_IPL_Set_DM"
+# define Image_Lock_DM "Image_Lock_DM"
+# define Image_Name_Query_DM "Image_Name_Query_DM"
+# define Image_Password_Set_DM "Image_Password_Set_DM"
+# define Image_Query_Activate_Time "Image_Query_Activate_Time"
+# define Image_Query_DM "Image_Query_DM"
+# define Image_Recycle "Image_Recycle"
+# define Image_Replace_DM "Image_Replace_DM"
+# define Image_SCSI_Characteristics_Define_DM "Image_SCSI_Characteristics_Define_DM"
+# define Image_SCSI_Characteristics_Query_DM "Image_SCSI_Characteristics_Query_DM"
+# define Image_Status_Query "Image_Status_Query"
+# define Image_Unlock_DM "Image_Unlock_DM"
+# define Image_Volume_Add "Image_Volume_Add"
+# define Image_Volume_Delete "Image_Volume_Delete"
+# define Image_Volume_Share "Image_Volume_Share"
+# define Image_Volume_Space_Define_DM "Image_Volume_Space_Define_DM"
+# define Image_Volume_Space_Define_Extended_DM "Image_Volume_Space_Define_Extended_DM"
+# define Image_Volume_Space_Query_DM "Image_Volume_Space_Query_DM"
+# define Image_Volume_Space_Query_Extended_DM "Image_Volume_Space_Query_Extended_DM"
+# define Image_Volume_Space_Remove_DM "Image_Volume_Space_Remove_DM"
+# define Metadata_Delete "Metadata_Delete"
+# define Metadata_Get "Metadata_Get"
+# define Metadata_Set "Metadata_Set"
+# define Name_List_Add "Name_List_Add"
+# define Name_List_Destroy "Name_List_Destroy"
+# define Name_List_Query "Name_List_Query"
+# define Name_List_Remove "Name_List_Remove"
+# define Page_or_Spool_Volume_Add "Page_or_Spool_Volume_Add"
+# define Process_ABEND_Dump "Process_ABEND_Dump"
+# define Profile_Create_DM "Profile_Create_DM"
+# define Profile_Delete_DM "Profile_Delete_DM"
+# define Profile_Lock_DM "Profile_Lock_DM"
+# define Profile_Query_DM "Profile_Query_DM"
+# define Profile_Replace_DM "Profile_Replace_DM"
+# define Profile_Unlock_DM "Profile_Unlock_DM"
+# define Prototype_Create_DM "Prototype_Create_DM"
+# define Prototype_Delete_DM "Prototype_Delete_DM"
+# define Prototype_Name_Query_DM "Prototype_Name_Query_DM"
+# define Prototype_Query_DM "Prototype_Query_DM"
+# define Prototype_Replace_DM "Prototype_Replace_DM"
+# define Query_ABEND_Dump "Query_ABEND_Dump"
+# define Query_All_DM "Query_All_DM"
+# define Query_API_Functional_Level "Query_API_Functional_Level"
+# define Query_Asynchronous_Operation_DM "Query_Asynchronous_Operation_DM"
+# define Query_Directory_Manager_Level_DM "Query_Directory_Manager_Level_DM"
+# define Response_Recovery "Response_Recovery"
+# define Shared_Memory_Access_Add_DM "Shared_Memory_Access_Add_DM"
+# define Shared_Memory_Access_Query_DM "Shared_Memory_Access_Query_DM"
+# define Shared_Memory_Access_Remove_DM "Shared_Memory_Access_Remove_DM"
+# define Shared_Memory_Create "Shared_Memory_Create"
+# define Shared_Memory_Delete "Shared_Memory_Delete"
+# define Shared_Memory_Query "Shared_Memory_Query"
+# define Shared_Memory_Replace "Shared_Memory_Replace"
+# define SSI_Query "SSI_Query"
+# define Static_Image_Changes_Activate_DM "Static_Image_Changes_Activate_DM"
+# define Static_Image_Changes_Deactivate_DM "Static_Image_Changes_Deactivate_DM"
+# define Static_Image_Changes_Immediate_DM "Static_Image_Changes_Immediate_DM"
+# define System_Config_Syntax_Check "System_Config_Syntax_Check"
+# define System_Disk_Accessibility "System_Disk_Accessibility"
+# define System_Disk_Add "System_Disk_Add"
+# define System_Disk_Query "System_Disk_Query"
+# define System_FCP_Free_Query "System_FCP_Free_Query"
+# define System_Performance_Threshold_Disable "System_Performance_Threshold_Disable"
+# define System_Performance_Threshold_Enable "System_Performance_Threshold_Enable"
+# define System_SCSI_Disk_Add "System_SCSI_Disk_Add"
+# define System_SCSI_Disk_Delete "System_SCSI_Disk_Delete"
+# define System_SCSI_Disk_Query "System_SCSI_Disk_Query"
+# define System_WWPN_Query "System_WWPN_Query"
+# define Virtual_Channel_Connection_Create "Virtual_Channel_Connection_Create"
+# define Virtual_Channel_Connection_Create_DM "Virtual_Channel_Connection_Create_DM"
+# define Virtual_Channel_Connection_Delete "Virtual_Channel_Connection_Delete"
+# define Virtual_Channel_Connection_Delete_DM "Virtual_Channel_Connection_Delete_DM"
+# define Virtual_Network_Adapter_Connect_LAN "Virtual_Network_Adapter_Connect_LAN"
+# define Virtual_Network_Adapter_Connect_LAN_DM "Virtual_Network_Adapter_Connect_LAN_DM"
+# define Virtual_Network_Adapter_Connect_Vswitch "Virtual_Network_Adapter_Connect_Vswitch"
+# define Virtual_Network_Adapter_Connect_Vswitch_DM "Virtual_Network_Adapter_Connect_Vswitch_DM"
+# define Virtual_Network_Adapter_Connect_Vswitch_Extended "Virtual_Network_Adapter_Connect_Vswitch_Extended"
+# define Virtual_Network_Adapter_Create "Virtual_Network_Adapter_Create"
+# define Virtual_Network_Adapter_Create_DM "Virtual_Network_Adapter_Create_DM"
+# define Virtual_Network_Adapter_Create_Extended "Virtual_Network_Adapter_Create_Extended"
+# define Virtual_Network_Adapter_Create_Extended_DM "Virtual_Network_Adapter_Create_Extended_DM"
+# define Virtual_Network_Adapter_Delete "Virtual_Network_Adapter_Delete"
+# define Virtual_Network_Adapter_Delete_DM "Virtual_Network_Adapter_Delete_DM"
+# define Virtual_Network_Adapter_Disconnect "Virtual_Network_Adapter_Disconnect"
+# define Virtual_Network_Adapter_Disconnect_DM "Virtual_Network_Adapter_Disconnect_DM"
+# define Virtual_Network_Adapter_Query "Virtual_Network_Adapter_Query"
+# define Virtual_Network_LAN_Access "Virtual_Network_LAN_Access"
+# define Virtual_Network_LAN_Access_Query "Virtual_Network_LAN_Access_Query"
+# define Virtual_Network_LAN_Create "Virtual_Network_LAN_Create"
+# define Virtual_Network_LAN_Delete "Virtual_Network_LAN_Delete"
+# define Virtual_Network_LAN_Query "Virtual_Network_LAN_Query"
+# define Virtual_Network_OSA_Query "Virtual_Network_OSA_Query"
+# define Virtual_Network_VLAN_Query_Stats "Virtual_Network_VLAN_Query_Stats"
+# define Virtual_Network_Vswitch_Create "Virtual_Network_Vswitch_Create"
+# define Virtual_Network_Vswitch_Create_Extended "Virtual_Network_Vswitch_Create_Extended"
+# define Virtual_Network_Vswitch_Delete "Virtual_Network_Vswitch_Delete"
+# define Virtual_Network_Vswitch_Delete_Extended "Virtual_Network_Vswitch_Delete_Extended"
+# define Virtual_Network_Vswitch_Query "Virtual_Network_Vswitch_Query"
+# define Virtual_Network_Vswitch_Query_Extended "Virtual_Network_Vswitch_Query_Extended"
+# define Virtual_Network_Vswitch_Query_Stats "Virtual_Network_Vswitch_Query_Stats"
+# define Virtual_Network_Vswitch_Set "Virtual_Network_Vswitch_Set"
+# define Virtual_Network_Vswitch_Set_Extended "Virtual_Network_Vswitch_Set_Extended"
+# define VMRELOCATE "VMRELOCATE"
+# define VMRELOCATE_Image_Attributes "VMRELOCATE_Image_Attributes"
+# define VMRELOCATE_Modify "VMRELOCATE_Modify"
+# define VMRELOCATE_Status "VMRELOCATE_Status"
+# define VMRM_Configuration_Query "VMRM_Configuration_Query"
+# define VMRM_Configuration_Update "VMRM_Configuration_Update"
+# define VMRM_Measurement_Query "VMRM_Measurement_Query"
+
+# define FORCE_IMMED "IMMED"
+# define FORCE_WITHIN "WITHIN 99999"
+
+/*
+ * Standard fields in a response from SMAPI server
+ */
+typedef struct {
+ uint32_t outLen; /* Length of output data */
+ uint32_t reqId; /* Request ID to which response refers */
+ uint32_t rc; /* Return code */
+ uint32_t reason; /* Reason code */
+} smapiOutHeader_t;
+
+typedef struct {
+ smapiOutHeader_t hdr; /* Output header */
+ uint32_t lArray; /* Length of array output */
+ char array[0]; /* Start of array output */
+} smapiArrayHeader_t;
+
+/*
+ * Structures returned from Image_Active_Configuration_Query
+ */
+typedef struct {
+ smapiOutHeader_t hdr;
+ int32_t memSize;
+ uint8_t memUnit;
+# define SMAPI_MEMUNIT_KB 1
+# define SMAPI_MEMUNIT_MB 2
+# define SMAPI_MEMUNIT_GB 3
+ uint8_t shareType;
+# define SMAPI_SHRTYPE_R 1
+# define SMAPI_SHRTYPE_A 2
+ int32_t lShare;
+ char share[0];
+} __attribute__ ((__packed__)) zvm_actImgHdr_t;
+
+typedef struct {
+ char share[5];
+} zvm_actImgShr_t;
+
+typedef struct {
+ int32_t nCPU;
+ int32_t lCPUArray;
+ char cpuArray[0];
+} zvm_actImgCPUArr_t;
+
+typedef struct {
+ int32_t lCPUStruct;
+ char cpuStruct[0];
+} zvm_actImgCPUHdr_t;
+
+typedef struct {
+ int32_t cpuNumber;
+ int32_t lCPUId;
+ char cpuId[16];
+} zvm_actImgCPUId_t;
+
+typedef struct {
+ uint8_t cpuState;
+# define SMAPI_CPUSTATE_BASE 1
+# define SMAPI_CPUSTATE_STOPPED 2
+# define SMAPI_CPUSTATE_CHECK 3
+# define SMAPI_CPUSTATE_ACTIVE 4
+ int32_t lDevArray;
+ char devArray[0];
+} __attribute__ ((__packed__)) zvm_actImgCPUState_t;
+
+typedef struct {
+ int32_t lDevStruct;
+ char devStruct[0];
+} zvm_actImgDevHdr_t;
+
+typedef struct {
+ uint8_t devType;
+# define SMAPI_DEVTYPE_CONS 1
+# define SMAPI_DEVTYPE_RDR 2
+# define SMAPI_DEVTYPE_PUN 3
+# define SMAPI_DEVTYPE_PRT 4
+# define SMAPI_DEVTYPE_DASD 5
+ int32_t lDevAddr;
+ uint8_t devAddr[4];
+} __attribute__ ((__packed__)) zvm_actImgDev_t;
+
+typedef struct {
+ int sd;
+ int reason;
+ uint32_t timeOut;
+ char target[9];
+ char authUser[9];
+ char authPass[9];
+ char smapiSrv[128];
+} zvm_driver_t;
+
+int zvm_smapi_open(zvm_driver_t *);
+int zvm_smapi_send(zvm_driver_t *, void *, uint32_t *, int32_t);
+int zvm_smapi_recv(zvm_driver_t *, void **, int32_t *);
+int zvm_smapi_close(zvm_driver_t *);
+int zvm_smapi_imageActivate(zvm_driver_t *);
+int zvm_smapi_imageActiveQuery(zvm_driver_t *);
+int zvm_smapi_imageDeactivate(zvm_driver_t *);
+int zvm_smapi_imageRecycle(zvm_driver_t *);
+
+#endif /* FENCE_ZVM_H */
diff --git a/fence/agents/zvm/fence_zvmip.8 b/fence/agents/zvm/fence_zvmip.8
new file mode 100644
index 0000000..222b483
--- /dev/null
+++ b/fence/agents/zvm/fence_zvmip.8
@@ -0,0 +1,86 @@
+.TH fence_zvmip 8
+
+.SH NAME
+fence_zvmip - Power Fencing agent for GFS on System z z/VM Clusters using IP interface to SMAPI
+
+.SH SYNOPSIS
+.B
+fence_zvmip
+[\fIOPTION\fR]...
+
+.SH DESCRIPTION
+fence_zvmip is a Power Fencing agent used on a GFS virtual machine in a System z z/VM cluster.
+It uses the TCP/IP SMAPI interface to recycle an active image.
+
+fence_zvmip accepts options on the command line as well as from stdin.
+fence_node sends the options through stdin when it execs the agent.
+fence_zvmip can be run by itself with command line options which is useful
+for testing.
+
+Vendor URL: http://www.sinenomine.net
+
+.SH OPTIONS
+.TP
+\fB-o --action\fP
+Fencing action: "off" - fence off device; "metadata" - display device metadata
+.TP
+\fB-n --plug\fP \fItarget\fP
+Name of target virtual machine to fence
+.TP
+\fB-h --help\fP
+Print out a help message describing available options, then exit.
+.TP
+\fB-a --ip\fP \fIsmapi Server\fP
+Host name or IP address of SMAPI server
+.TP
+\fB-u --username\fP \fISMAPI authorized user\fP
+Name of an authorized SMAPI user
+.TP
+\fB-p --password\fP \fISMAPI authorized user's password\fP
+Password of the authorized SMAPI user
+.TP
+\fB-t --timeout\fP \fIRecycle timeout\fP
+Amount of \fIgrace\fP time to give the virtual machine to shutdown cleanly before being
+forcibly terminated. Currently this is ignored.
+.TP
+\fB-h --help\fP
+Display usage information
+
+.SH STDIN PARAMETERS
+.TP
+\fIagent = < param >\fP
+This option is used by fence_node(8) and is ignored by fence_zvmip.
+.TP
+\fIplug = < plug >\fP
+Name of virtual machine to recycle.
+.TP
+\fIipaddr = < server host name or IP address >\fP
+Host name or IP address of SMAPI server
+.TP
+\fIlogin = < SMAPI authorized user >\fP
+Name of an authorized SMAPI user
+.TP
+\fIpasswd = < SMAPI authorized user's password >\fP
+Password of the authorized SMAPI user
+.TP
+\fItimeout = < shutdown timeout >\fP
+Amount of \fIgrace\fP time to give the virtual machine to shutdown cleanly before being
+forcibly terminated. Currently this is ignored.
+
+.SH SEE ALSO
+fence(8), fenced(8), fence_node(8)
+
+.SH NOTES
+To use this agent the z/VM SMAPI service needs to be configured to allow the virtual
+machine running this agent to connect to it and issue the image_recycle operation.
+This involves updating the VSMWORK1 AUTHLIST VMSYS:VSMWORK1. file. The entry should look
+something similar to this:
+
+.nf
+Column 1 Column 66 Column 131
+| | |
+V V V
+XXXXXXXX ALL IMAGE_OPERATIONS
+.fi
+
+Where XXXXXXX is the name of the virtual machine used in the authuser field of the request.
diff --git a/fence/agents/zvm/fence_zvmip.c b/fence/agents/zvm/fence_zvmip.c
new file mode 100644
index 0000000..1fa2119
--- /dev/null
+++ b/fence/agents/zvm/fence_zvmip.c
@@ -0,0 +1,651 @@
+/*
+ * fence_zvmip.c: SMAPI interface for managing zVM Guests
+ *
+ * Copyright (C) 2012 Sine Nomine Associates
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see
+ * <http://www.gnu.org/licenses/>.
+ *
+ * Authors:
+ * Neale Ferguson <neale at sinenomine.net>
+ *
+ */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <string.h>
+#include <fcntl.h>
+#include <sys/types.h>
+#include <dirent.h>
+#include <time.h>
+#include <sys/stat.h>
+#include <unistd.h>
+#include <limits.h>
+#include <errno.h>
+#include <string.h>
+#include <sys/wait.h>
+#include <sys/socket.h>
+#include <netinet/in.h>
+#include <netiucv/iucv.h>
+#include <arpa/inet.h>
+#include <netdb.h>
+#include <getopt.h>
+#include <ctype.h>
+#include <syslog.h>
+#include "fence_zvm.h"
+
+#define MIN(a,b) ((a) < (b) ? (a) : (b))
+#define DEFAULT_TIMEOUT 300
+
+static int zvm_smapi_reportError(void *, void *);
+
+static struct option longopts[] = {
+ {"action", required_argument, NULL, 'o'},
+ {"help", no_argument, NULL, 'h'},
+ {"ipaddr", required_argument, NULL, 'a'},
+ {"password", required_argument, NULL, 'p'},
+ {"plug", required_argument, NULL, 'n'},
+ {"timeout", required_argument, NULL, 't'},
+ {"username", required_argument, NULL, 'u'},
+ {NULL, 0, NULL, 0}
+};
+
+static char *optString = "a:o:hn:p:t:u:";
+
+static int zvm_metadata(void);
+static int usage(void);
+
+/**
+ * zvm_smapi_open:
+ * @zvm: z/VM driver information
+ *
+ * Opens a connection with the z/VM SMAPI server
+ */
+int
+zvm_smapi_open(zvm_driver_t *zvm)
+{
+ int rc = -1,
+ option = SO_REUSEADDR,
+ optVal = 1,
+ lOption = sizeof(optVal);
+ struct addrinfo hints, *ai;
+
+ hints.ai_family = AF_UNSPEC;
+ hints.ai_socktype = SOCK_STREAM;
+ hints.ai_flags = AI_PASSIVE;
+ hints.ai_protocol = IPPROTO_TCP;
+ if ((rc = getaddrinfo(zvm->smapiSrv, "44444", &hints, &ai)) == 0) {
+ if ((zvm->sd = socket(ai->ai_family, ai->ai_socktype, ai->ai_protocol)) != -1) {
+ rc = setsockopt(zvm->sd,SOL_SOCKET,option,&optVal,lOption);
+
+ if ((rc = connect(zvm->sd, ai->ai_addr, ai->ai_addrlen)) == -1) {
+ syslog(LOG_ERR, "Error connecting to %s - %m", zvm->smapiSrv);
+ close(zvm->sd);
+ }
+ } else {
+ syslog(LOG_ERR, "Error creating socket - %m");
+ }
+ } else {
+ syslog(LOG_ERR, "Error resolving server address: %s", gai_strerror(rc));
+ }
+ return(rc);
+}
+
+/**
+ * zvm_smapi_imageRecycle
+ * @zvm: z/VM driver information
+ *
+ * Deactivates a virtual image
+ */
+int
+zvm_smapi_imageRecycle(zvm_driver_t *zvm)
+{
+ struct _inPlist {
+ int32_t lPlist;
+ int32_t lFName;
+ char fName[13];
+ } __attribute__ ((packed)) *inPlist;
+ struct _authUser {
+ int32_t lAuthUser;
+ char userId[0];
+ } __attribute__ ((packed)) *authUser;
+ struct _authPass {
+ int32_t lAuthPass;
+ char password[0];
+ } __attribute__ ((packed)) *authPass;
+ struct _image {
+ int32_t lTarget;
+ char target[0];
+ } __attribute__ ((packed)) *image;
+ int32_t lInPlist;
+ struct _outPlist {
+ smapiOutHeader_t hdr;
+ int32_t nActive;
+ int32_t nInActive;
+ int32_t lFail;
+ char failArray[0];
+ } *outPlist = NULL;
+ void *pOut = NULL;
+ int32_t lRsp;
+ uint32_t reqId;
+ int rc;
+
+ lInPlist = sizeof(*inPlist) + sizeof(*authUser) + strlen(zvm->authUser) +
+ sizeof(*authPass) + strlen(zvm->authPass) + sizeof(*image) +
+ + strlen(zvm->target);
+ inPlist = malloc(lInPlist);
+ if (inPlist != NULL) {
+ authUser = (void *) ((uintptr_t) inPlist + sizeof(*inPlist));
+ authPass = (void *) ((uintptr_t) authUser + sizeof(*authUser) +
+ strlen(zvm->authUser));
+ image = (void *) ((uintptr_t) authPass + sizeof(*authPass) +
+ strlen(zvm->authPass));
+ inPlist->lPlist = lInPlist - sizeof(inPlist->lPlist);
+ inPlist->lFName = sizeof(inPlist->fName);
+ memcpy(inPlist->fName, Image_Recycle, sizeof(inPlist->fName));
+ authUser->lAuthUser = strlen(zvm->authUser);
+ memcpy(authUser->userId, zvm->authUser, strlen(zvm->authUser));
+ authPass->lAuthPass = strlen(zvm->authPass);
+ memcpy(authPass->password, zvm->authPass, strlen(zvm->authPass));
+ image->lTarget = strlen(zvm->target);
+ strncpy(image->target, zvm->target, strlen(zvm->target));
+ if ((rc = zvm_smapi_send(zvm, inPlist, &reqId, lInPlist)) != -1) {
+ if ((rc = zvm_smapi_recv(zvm, &pOut, &lRsp)) != -1) {
+ outPlist = pOut;
+ if (outPlist->hdr.rc == 0) {
+ syslog(LOG_INFO, "Recycling of %s successful",
+ zvm->target);
+ rc = 0;
+ } else {
+ if ((ntohl(outPlist->hdr.rc) == RCERR_IMAGEOP) &
+ ((ntohl(outPlist->hdr.reason) == RS_NOT_ACTIVE) |
+ (ntohl(outPlist->hdr.reason) == RS_BEING_DEACT))) {
+ syslog(LOG_INFO, "Recycling of %s successful",
+ zvm->target);
+ rc = 0;
+ } else {
+ rc = ntohl(outPlist->hdr.rc);
+ zvm->reason = ntohl(outPlist->hdr.reason);
+ (void) zvm_smapi_reportError(inPlist, outPlist);
+ }
+ }
+ }
+ }
+ free(inPlist);
+ free(outPlist);
+ } else {
+ syslog(LOG_ERR, "%s - cannot allocate parameter list", __func__);
+ rc = -1;
+ }
+ return(rc);
+}
+
+/**
+ * zvm_smapi_send:
+ * @zvm: z/VM driver information
+ * @reqid: Returned request id
+ * @req: Request parameter list
+ * @lSend: Length of request
+ *
+ * Send a request to the SMAPI server and retrieve the request id
+ */
+int
+zvm_smapi_send(zvm_driver_t *zvm, void *req, uint32_t *reqId, int32_t lSend)
+{
+ int rc,
+ nFds;
+ fd_set readFds;
+ struct timeval timeout;
+
+ timeout.tv_sec = 30;
+ timeout.tv_usec = 0;
+ zvm->reason = -1;
+ if ((rc = zvm_smapi_open(zvm)) == 0) {
+ rc = send(zvm->sd,req,lSend,0);
+ if (rc != -1) {
+ FD_ZERO(&readFds);
+ FD_SET(zvm->sd,&readFds);
+ nFds = zvm->sd + 1;
+
+ if ((rc = select(nFds,&readFds,NULL,NULL,&timeout)) != -1) {
+ /*
+ * Get request ID
+ */
+ rc = recv(zvm->sd,reqId,sizeof(*reqId),0);
+ if (rc == -1)
+ syslog(LOG_ERR, "Error receiving from SMAPI - %m");
+ }
+ } else
+ syslog(LOG_ERR, "Error sending to SMAPI - %m");
+ }
+ return(rc);
+}
+
+/**
+ * zvm_smapi_recv:
+ * @zvm: z/VM driver information
+ * @req: Returned response parameter list
+ * @lRsp: Length of response
+ *
+ * Receive a response from the SMAPI server
+ */
+int
+zvm_smapi_recv(zvm_driver_t *zvm, void **rsp, int32_t *lRsp)
+{
+ int rc,
+ lRem = 0,
+ nFds;
+ void *pRecv = rsp;
+ fd_set readFds;
+ smapiOutHeader_t *out;
+ struct timeval timeout;
+
+ timeout.tv_sec = 30;
+ timeout.tv_usec = 0;
+ FD_ZERO(&readFds);
+ FD_SET(zvm->sd,&readFds);
+ nFds = zvm->sd + 1;
+
+ zvm->reason = -1;
+ if ((rc = select(nFds,&readFds,NULL,NULL,&timeout)) != -1) {
+ /*
+ * Get response length
+ */
+ if ((rc = recv(zvm->sd,lRsp,sizeof(*lRsp),0)) != -1) {
+ *lRsp = ntohl(*lRsp);
+ lRem = *lRsp;
+ if (*rsp == NULL)
+ *rsp = malloc(*lRsp + sizeof(out->outLen));
+ out = *rsp;
+ out->outLen = *lRsp;
+ pRecv = &out->reqId;
+ while (lRem > 0) {
+ if ((rc = recv(zvm->sd,pRecv,lRem,0)) != -1) {
+ lRem -= rc;
+ pRecv = (void *) ((uintptr_t) pRecv + rc);
+ } else
+ syslog(LOG_ERR, "Error receiving from SMAPI - %m");
+ (void) zvm_smapi_close(zvm);
+ return(rc);
+ }
+ zvm->reason = out->reason;
+ }
+ } else
+ syslog(LOG_ERR, "Error receiving from SMAPI - %m");
+
+ (void) zvm_smapi_close(zvm);
+
+ return(rc);
+}
+
+/**
+ * zvm_smapi_close:
+ * @zvm: z/VM driver information
+ *
+ * Close a connection with the z/VM SMAPI server
+ */
+int
+zvm_smapi_close(zvm_driver_t *zvm)
+{
+ close(zvm->sd);
+ return(0);
+}
+
+/**
+ * zvm_smapi_reportError
+ * @inHdr - Input parameter list header
+ * @outHdr - Output parameter list header
+ *
+ * Report an error from the SMAPI server
+ */
+static int
+zvm_smapi_reportError(void *inHdr, void *oHdr)
+{
+ struct _inParm {
+ int32_t lPlist;
+ int32_t lFName;
+ char fName[0];
+ } *inParm = inHdr;
+ smapiOutHeader_t *outHdr = oHdr;
+ char fName[64];
+
+ memset(fName, 0, sizeof(fName));
+ memcpy(fName, inParm->fName, inParm->lFName);
+ syslog(LOG_ERR, "%s - returned (%d,%d)",
+ fName, ntohl(outHdr->rc), ntohl(outHdr->reason));
+ return(-1);
+}
+
+
+/**
+ * trim - Trim spaces from string
+ * @str - Pointer to string
+ *
+ */
+static int
+trim(char *str)
+{
+ char *p;
+ int len;
+
+ if (!str)
+ return (0);
+
+ len = strlen (str);
+
+ while (len--) {
+ if (isspace (str[len])) {
+ str[len] = 0;
+ } else {
+ break;
+ }
+ }
+
+ for (p = str; *p && isspace (*p); p++);
+
+ memmove(str, p, strlen (p) + 1);
+
+ return (strlen (str));
+}
+
+/**
+ * get_options_stdin - get options from stdin
+ * @zvm - Pointer to driver information
+ *
+ */
+static int
+get_options_stdin (zvm_driver_t *zvm)
+{
+ char buf[1024],
+ *endPtr,
+ *opt,
+ *arg;
+ int32_t lSrvName,
+ lTarget;
+ int fence = 0;
+
+ while (fgets (buf, sizeof (buf), stdin) != 0) {
+ if (trim(buf) == 0) {
+ continue;
+ }
+ if (buf[0] == '#') {
+ continue;
+ }
+
+ opt = buf;
+
+ if ((arg = strchr(opt, '=')) != 0) {
+ *arg = 0;
+ arg++;
+ } else {
+ continue;
+ }
+
+ if (trim(arg) == 0)
+ continue;
+
+ if (!strcasecmp (opt, "action")) {
+ if (strcasecmp(arg, "off") == 0) {
+ fence = 0;
+ } else if (strcasecmp(arg, "metadata") == 0) {
+ fence = 1;
+ } else {
+ fence = 2;
+ }
+ } else if (!strcasecmp (opt, "ipaddr")) {
+ lSrvName = MIN(strlen(arg), sizeof(zvm->smapiSrv)-1);
+ memcpy(zvm->smapiSrv, arg, lSrvName);
+ continue;
+ } else if (!strcasecmp (opt, "login")) {
+ lSrvName = MIN(strlen(arg), sizeof(zvm->authUser)-1);
+ memcpy(zvm->authUser, arg, lSrvName);
+ continue;
+ } else if (!strcasecmp (opt, "passwd")) {
+ lSrvName = MIN(strlen(arg), sizeof(zvm->authPass)-1);
+ memcpy(zvm->authPass, arg, lSrvName);
+ continue;
+ } else if (!strcasecmp (opt, "port")) {
+ lTarget = MIN(strlen(arg), sizeof(zvm->target)-1);
+ strncpy(zvm->target, arg, lTarget);
+ continue;
+ } if (!strcasecmp (opt, "timeout")) {
+ zvm->timeOut = strtoul(arg, &endPtr, 10);
+ if (*endPtr != 0) {
+ syslog(LOG_WARNING, "Invalid timeout value specified %s "
+ "defaulting to %d",
+ arg, DEFAULT_TIMEOUT);
+ zvm->timeOut = DEFAULT_TIMEOUT;
+ }
+ } else if (!strcasecmp (opt, "help")) {
+ fence = 2;
+ }
+ }
+ return(fence);
+}
+
+/**
+ * get_options - get options from the command line
+ * @argc - Count of arguments
+ * @argv - Array of character strings
+ * @zvm - Pointer to driver information
+ *
+ */
+static int
+get_options(int argc, char **argv, zvm_driver_t *zvm)
+{
+ int c,
+ fence = 0;
+ int32_t lSrvName,
+ lTarget;
+ char *endPtr;
+
+ while ((c = getopt_long(argc, argv, optString, longopts, NULL)) != -1) {
+ switch (c) {
+ case 'a' :
+ lSrvName = MIN(strlen(optarg), sizeof(zvm->smapiSrv)-1);
+ memcpy(zvm->smapiSrv, optarg, lSrvName);
+ break;
+ case 'n' :
+ lTarget = MIN(strlen(optarg), sizeof(zvm->target)-1);
+ memcpy(zvm->target, optarg, lTarget);
+ break;
+ case 'o' :
+ if (strcasecmp(optarg, "off") == 0) {
+ fence = 0;
+ } else if (strcasecmp(optarg, "metadata") == 0) {
+ fence = 1;
+ } else {
+ fence = 2;
+ }
+ break;
+ case 'p' :
+ lSrvName = MIN(strlen(optarg), 8);
+ memcpy(zvm->authPass, optarg, lSrvName);
+ break;
+ case 'u' :
+ lSrvName = MIN(strlen(optarg), 8);
+ memcpy(zvm->authUser, optarg, lSrvName);
+ break;
+ case 't' :
+ zvm->timeOut = strtoul(optarg, &endPtr, 10);
+ if (*endPtr != 0) {
+ syslog(LOG_WARNING, "Invalid timeout value specified: %s - "
+ "defaulting to %d",
+ optarg, DEFAULT_TIMEOUT);
+ zvm->timeOut = DEFAULT_TIMEOUT;
+ }
+ break;
+ default :
+ fence = 2;
+ }
+ }
+ return(fence);
+}
+
+/**
+ * zvm_metadata - Show fence metadata
+ * @self - Path to this executable
+ *
+ */
+static int
+zvm_metadata()
+{
+ fprintf (stdout, "<?xml version=\"1.0\" ?>\n");
+ fprintf (stdout, "<resource-agent name=\"fence_zvmip\"");
+ fprintf (stdout, " shortdesc=\"Fence agent for use with z/VM Virtual Machines\">\n");
+ fprintf (stdout, "<longdesc>");
+ fprintf (stdout, "The fence_zvm agent is intended to be used with with z/VM SMAPI service via TCP/IP");
+ fprintf (stdout, "</longdesc>\n");
+
+ fprintf (stdout, "<parameters>\n");
+
+ fprintf (stdout, "\t<parameter name=\"port\" unique=\"1\" required=\"1\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-n, --plug\" />\n");
+ fprintf (stdout, "\t\t<content type=\"string\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Name of the Virtual Machine to be fenced");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"ipaddr\" unique=\"1\" required=\"1\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-i, --ip\" />\n");
+ fprintf (stdout, "\t\t<content type=\"string\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "IP Name or Address of SMAPI Server");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"login\" unique=\"1\" required=\"1\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-u, --username\" />\n");
+ fprintf (stdout, "\t\t<content type=\"string\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Name of authorized SMAPI user\n");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"passwd\" unique=\"1\" required=\"1\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-p, --password\" />\n");
+ fprintf (stdout, "\t\t<content type=\"string\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Password of authorized SMAPI user\n");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"action\" unique=\"1\" required=\"0\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-o, --action\" />\n");
+ fprintf (stdout, "\t\t<content type=\"string\" default=\"off\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Fencing action");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "\t<parameter name=\"usage\" unique=\"1\" required=\"0\">\n");
+ fprintf (stdout, "\t\t<getopt mixed=\"-h, --help\" />\n");
+ fprintf (stdout, "\t\t<content type=\"boolean\" />\n");
+ fprintf (stdout, "\t\t<shortdesc lang=\"en\">%s</shortdesc>\n",
+ "Print usage");
+ fprintf (stdout, "\t</parameter>\n");
+
+ fprintf (stdout, "</parameters>\n");
+
+ fprintf (stdout, "<actions>\n");
+ fprintf (stdout, "\t<action name=\"off\" />\n");
+ fprintf (stdout, "\t<action name=\"metadata\" />\n");
+ fprintf (stdout, "</actions>\n");
+
+ fprintf (stdout, "</resource-agent>\n");
+
+ return(0);
+
+}
+
+/**
+ * usage - display command syntax and parameters
+ *
+ */
+static int
+usage()
+{
+ fprintf(stderr,"Usage: fence_zvmip [options]\n\n"
+ "\tWhere [options] =\n"
+ "\t-o --action [action] - \"off\", \"metadata\"\n"
+ "\t-n --plug [target] - Name of virtual machine to fence\n"
+ "\t-a --ip [server] - IP Name/Address of SMAPI Server\n"
+ "\t-u --username [user] - Name of autorized SMAPI user\n"
+ "\t-p --password [pass] - Password of autorized SMAPI user\n"
+ "\t-t --timeout [secs] - Time to wait for fence in seconds - currently ignored\n"
+ "\t-h --help - Display this usage information\n");
+ return(1);
+}
+
+/**
+ * check_param - Check that mandatory parameters have been specified
+ * @zvm - Pointer to driver information
+ *
+ */
+static int
+check_parm(zvm_driver_t *zvm)
+{
+ int rc;
+
+ if (zvm->smapiSrv[0] != 0) {
+ if (zvm->target[0] != 0) {
+ if (zvm->authUser[0] != 0) {
+ if (zvm->authPass[0] != 0) {
+ rc = 0;
+ } else {
+ syslog(LOG_ERR, "Missing authorized password");
+ rc = 4;
+ }
+ } else {
+ syslog(LOG_ERR, "Missing authorized user name");
+ rc = 3;
+ }
+ } else {
+ syslog(LOG_ERR, "Missing fence target name");
+ rc = 2;
+ }
+ } else {
+ syslog(LOG_ERR, "Missing SMAPI server name");
+ rc = 1;
+ }
+ return(rc);
+}
+
+int
+main(int argc, char **argv)
+{
+ zvm_driver_t zvm;
+ int fence = 1,
+ rc = 0;
+
+ openlog ("fence_zvmip", LOG_CONS|LOG_PID, LOG_DAEMON);
+ memset(&zvm, 0, sizeof(zvm));
+ zvm.timeOut = DEFAULT_TIMEOUT;
+
+ if (argc > 1)
+ fence = get_options(argc, argv, &zvm);
+ else
+ fence = get_options_stdin(&zvm);
+
+ switch(fence) {
+ case 0 :
+ if ((rc = check_parm(&zvm)) == 0)
+ rc = zvm_smapi_imageRecycle(&zvm);
+ break;
+ case 1 :
+ rc = zvm_metadata();
+ break;
+ case 2 :
+ rc = usage();
+ }
+ closelog();
+ return (rc);
+}
diff --git a/make/copyright.cf b/make/copyright.cf
new file mode 100644
index 0000000..3801aa9
--- /dev/null
+++ b/make/copyright.cf
@@ -0,0 +1,6 @@
+#ifndef __COPYRIGHT_DOT_CF__
+#define __COPYRIGHT_DOT_CF__
+
+#define REDHAT_COPYRIGHT "Copyright (C) Red Hat, Inc. 2004-2010 All rights reserved."
+
+#endif /* __COPYRIGHT_DOT_CF__ */
diff --git a/make/fencebuild.mk b/make/fencebuild.mk
new file mode 100644
index 0000000..819ac36
--- /dev/null
+++ b/make/fencebuild.mk
@@ -0,0 +1,19 @@
+$(TARGET): $(SRC)
+ bash $(top_srcdir)/scripts/fenceparse \
+ $(top_srcdir)/make/copyright.cf REDHAT_COPYRIGHT \
+ $(VERSION) \
+ $(abs_srcdir) $@ | \
+ sed \
+ -e 's#@''FENCEAGENTSLIBDIR@#${FENCEAGENTSLIBDIR}#g' \
+ -e 's#@''SNMPBIN@#${SNMPBIN}#g' \
+ -e 's#@''LOGDIR@#${LOGDIR}#g' \
+ -e 's#@''SBINDIR@#${sbindir}#g' \
+ -e 's#@''LIBEXECDIR@#${libexecdir}#g' \
+ -e 's#@''IPMITOOL_PATH@#${IPMITOOL_PATH}#g' \
+ -e 's#@''AMTTOOL_PATH@#${AMTTOOL_PATH}#g' \
+ -e 's#@''GNUTLSCLI_PATH@#${GNUTLSCLI_PATH}#g' \
+ > $@
+
+ if [ 0 -eq `echo "$(SRC)" | grep fence_ &> /dev/null; echo $$?` ]; then \
+ PYTHONPATH=$(abs_srcdir)/../lib:$(abs_builddir)/../lib $(top_srcdir)/fence/agents/lib/check_used_options.py $@; \
+ else true ; fi
diff --git a/make/fenceman.mk b/make/fenceman.mk
new file mode 100644
index 0000000..d4f0377
--- /dev/null
+++ b/make/fenceman.mk
@@ -0,0 +1,9 @@
+%.8: $(TARGET) $(top_srcdir)/fence/agents/lib/fence2man.xsl
+ set -e && \
+ PYTHONPATH=$(abs_srcdir)/../lib:$(abs_builddir)/../lib \
+ python $^ -o metadata > .$@.tmp && \
+ xmllint --noout --relaxng $(abs_srcdir)/../lib/metadata.rng .$@.tmp && \
+ xsltproc $(top_srcdir)/fence/agents/lib/fence2man.xsl .$@.tmp > $@
+
+clean-man:
+ rm -f *.8 .*.8.tmp
diff --git a/make/fencemanc.mk b/make/fencemanc.mk
new file mode 100644
index 0000000..27e1aae
--- /dev/null
+++ b/make/fencemanc.mk
@@ -0,0 +1,8 @@
+%.8: $(TARGET) $(top_srcdir)/fence/agents/lib/fence2man.xsl
+ set -e && \
+ ./$^ -o metadata > .$@.tmp && \
+ xmllint --noout --relaxng $(top_srcdir)/fence/agents/lib/metadata.rng .$@.tmp && \
+ xsltproc $(top_srcdir)/fence/agents/lib/fence2man.xsl .$@.tmp > $@
+
+clean-man:
+ rm -f *.8 .*.8.tmp
diff --git a/make/fencemanperl.mk b/make/fencemanperl.mk
new file mode 100644
index 0000000..ed7c9cc
--- /dev/null
+++ b/make/fencemanperl.mk
@@ -0,0 +1,8 @@
+%.8: $(TARGET) $(top_srcdir)/fence/agents/lib/fence2man.xsl
+ set -e && \
+ perl $(TARGET) -o metadata > .$@.tmp && \
+ xmllint --noout --relaxng $(top_srcdir)/fence/agents/lib/metadata.rng .$@.tmp && \
+ xsltproc $(top_srcdir)/fence/agents/lib/fence2man.xsl .$@.tmp > $@
+
+clean-man:
+ rm -f *.8 .*.8.tmp
diff --git a/make/git-version-gen b/make/git-version-gen
new file mode 100755
index 0000000..795a98b
--- /dev/null
+++ b/make/git-version-gen
@@ -0,0 +1,161 @@
+#!/bin/sh
+# Print a version string.
+scriptversion=2010-10-13.20; # UTC
+
+# Copyright (C) 2007-2010 Free Software Foundation, Inc.
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+# This script is derived from GIT-VERSION-GEN from GIT: http://git.or.cz/.
+# It may be run two ways:
+# - from a git repository in which the "git describe" command below
+# produces useful output (thus requiring at least one signed tag)
+# - from a non-git-repo directory containing a .tarball-version file, which
+# presumes this script is invoked like "./git-version-gen .tarball-version".
+
+# In order to use intra-version strings in your project, you will need two
+# separate generated version string files:
+#
+# .tarball-version - present only in a distribution tarball, and not in
+# a checked-out repository. Created with contents that were learned at
+# the last time autoconf was run, and used by git-version-gen. Must not
+# be present in either $(srcdir) or $(builddir) for git-version-gen to
+# give accurate answers during normal development with a checked out tree,
+# but must be present in a tarball when there is no version control system.
+# Therefore, it cannot be used in any dependencies. GNUmakefile has
+# hooks to force a reconfigure at distribution time to get the value
+# correct, without penalizing normal development with extra reconfigures.
+#
+# .version - present in a checked-out repository and in a distribution
+# tarball. Usable in dependencies, particularly for files that don't
+# want to depend on config.h but do want to track version changes.
+# Delete this file prior to any autoconf run where you want to rebuild
+# files to pick up a version string change; and leave it stale to
+# minimize rebuild time after unrelated changes to configure sources.
+#
+# It is probably wise to add these two files to .gitignore, so that you
+# don't accidentally commit either generated file.
+#
+# Use the following line in your configure.ac, so that $(VERSION) will
+# automatically be up-to-date each time configure is run (and note that
+# since configure.ac no longer includes a version string, Makefile rules
+# should not depend on configure.ac for version updates).
+#
+# AC_INIT([GNU project],
+# m4_esyscmd([build-aux/git-version-gen .tarball-version]),
+# [bug-project at example])
+#
+# Then use the following lines in your Makefile.am, so that .version
+# will be present for dependencies, and so that .tarball-version will
+# exist in distribution tarballs.
+#
+# BUILT_SOURCES = $(top_srcdir)/.version
+# $(top_srcdir)/.version:
+# echo $(VERSION) > $@-t && mv $@-t $@
+# dist-hook:
+# echo $(VERSION) > $(distdir)/.tarball-version
+
+case $# in
+ 1|2) ;;
+ *) echo 1>&2 "Usage: $0 \$srcdir/.tarball-version" \
+ '[TAG-NORMALIZATION-SED-SCRIPT]'
+ exit 1;;
+esac
+
+tarball_version_file=$1
+tag_sed_script="${2:-s/x/x/}"
+nl='
+'
+
+# Avoid meddling by environment variable of the same name.
+v=
+
+# First see if there is a tarball-only version file.
+# then try "git describe", then default.
+if test -f $tarball_version_file
+then
+ v=`cat $tarball_version_file` || exit 1
+ case $v in
+ *$nl*) v= ;; # reject multi-line output
+ [0-9]*) ;;
+ *) v= ;;
+ esac
+ test -z "$v" \
+ && echo "$0: WARNING: $tarball_version_file seems to be damaged" 1>&2
+fi
+
+if test -n "$v"
+then
+ : # use $v
+# Otherwise, if there is at least one git commit involving the working
+# directory, and "git describe" output looks sensible, use that to
+# derive a version string.
+elif test "`git log -1 --pretty=format:x . 2>&1`" = x \
+ && v=`git describe --abbrev=4 --match='v*' HEAD 2>/dev/null \
+ || git describe --abbrev=4 HEAD 2>/dev/null` \
+ && v=`printf '%s\n' "$v" | sed "$tag_sed_script"` \
+ && case $v in
+ v[0-9]*) ;;
+ *) (exit 1) ;;
+ esac
+then
+ # Is this a new git that lists number of commits since the last
+ # tag or the previous older version that did not?
+ # Newer: v6.10-77-g0f8faeb
+ # Older: v6.10-g0f8faeb
+ case $v in
+ *-*-*) : git describe is okay three part flavor ;;
+ *-*)
+ : git describe is older two part flavor
+ # Recreate the number of commits and rewrite such that the
+ # result is the same as if we were using the newer version
+ # of git describe.
+ vtag=`echo "$v" | sed 's/-.*//'`
+ numcommits=`git rev-list "$vtag"..HEAD | wc -l`
+ v=`echo "$v" | sed "s/\(.*\)-\(.*\)/\1-$numcommits-\2/"`;
+ ;;
+ esac
+
+ # Change the first '-' to a '.', so version-comparing tools work properly.
+ # Remove the "g" in git describe's output string, to save a byte.
+ v=`echo "$v" | sed 's/-/./;s/\(.*\)-g/\1-/'`;
+else
+ v=UNKNOWN
+fi
+
+v=`echo "$v" |sed 's/^v//'`
+
+# Don't declare a version "dirty" merely because a time stamp has changed.
+git update-index --refresh > /dev/null 2>&1
+
+dirty=`sh -c 'git diff-index --name-only HEAD' 2>/dev/null` || dirty=
+case "$dirty" in
+ '') ;;
+ *) # Append the suffix only if there isn't one already.
+ case $v in
+ *-dirty) ;;
+ *) v="$v-dirty" ;;
+ esac ;;
+esac
+
+# Omit the trailing newline, so that m4_esyscmd can use the result directly.
+echo "$v" | tr -d "$nl"
+
+# Local variables:
+# eval: (add-hook 'write-file-hooks 'time-stamp)
+# time-stamp-start: "scriptversion="
+# time-stamp-format: "%:y-%02m-%02d.%02H"
+# time-stamp-time-zone: "UTC"
+# time-stamp-end: "; # UTC"
+# End:
diff --git a/make/gitlog-to-changelog b/make/gitlog-to-changelog
new file mode 100755
index 0000000..7660af5
--- /dev/null
+++ b/make/gitlog-to-changelog
@@ -0,0 +1,191 @@
+eval '(exit $?0)' && eval 'exec perl -wS "$0" ${1+"$@"}'
+ & eval 'exec perl -wS "$0" $argv:q'
+ if 0;
+# Convert git log output to ChangeLog format.
+
+my $VERSION = '2009-10-30 13:46'; # UTC
+# The definition above must lie within the first 8 lines in order
+# for the Emacs time-stamp write hook (at end) to update it.
+# If you change this file with Emacs, please let the write hook
+# do its job. Otherwise, update this string manually.
+
+# Copyright (C) 2008-2010 Free Software Foundation, Inc.
+
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+# Written by Jim Meyering
+
+use strict;
+use warnings;
+use Getopt::Long;
+use POSIX qw(strftime);
+
+(my $ME = $0) =~ s|.*/||;
+
+# use File::Coda; # http://meyering.net/code/Coda/
+END {
+ defined fileno STDOUT or return;
+ close STDOUT and return;
+ warn "$ME: failed to close standard output: $!\n";
+ $? ||= 1;
+}
+
+sub usage ($)
+{
+ my ($exit_code) = @_;
+ my $STREAM = ($exit_code == 0 ? *STDOUT : *STDERR);
+ if ($exit_code != 0)
+ {
+ print $STREAM "Try `$ME --help' for more information.\n";
+ }
+ else
+ {
+ print $STREAM <<EOF;
+Usage: $ME [OPTIONS] [ARGS]
+
+Convert git log output to ChangeLog format. If present, any ARGS
+are passed to "git log". To avoid ARGS being parsed as options to
+$ME, they may be preceded by '--'.
+
+OPTIONS:
+
+ --since=DATE convert only the logs since DATE;
+ the default is to convert all log entries.
+ --format=FMT set format string for commit subject and body;
+ see 'man git-log' for the list of format metacharacters;
+ the default is '%s%n%b%n'
+
+ --help display this help and exit
+ --version output version information and exit
+
+EXAMPLE:
+
+ $ME --since=2008-01-01 > ChangeLog
+ $ME -- -n 5 foo > last-5-commits-to-branch-foo
+
+EOF
+ }
+ exit $exit_code;
+}
+
+# If the string $S is a well-behaved file name, simply return it.
+# If it contains white space, quotes, etc., quote it, and return the new string.
+sub shell_quote($)
+{
+ my ($s) = @_;
+ if ($s =~ m![^\w+/.,-]!)
+ {
+ # Convert each single quote to '\''
+ $s =~ s/\'/\'\\\'\'/g;
+ # Then single quote the string.
+ $s = "'$s'";
+ }
+ return $s;
+}
+
+sub quoted_cmd(@)
+{
+ return join (' ', map {shell_quote $_} @_);
+}
+
+{
+ my $since_date = '1970-01-01 UTC';
+ my $format_string = '%s%n%b%n';
+ GetOptions
+ (
+ help => sub { usage 0 },
+ version => sub { print "$ME version $VERSION\n"; exit },
+ 'since=s' => \$since_date,
+ 'format=s' => \$format_string,
+ ) or usage 1;
+
+ my @cmd = (qw (git log --log-size), "--since=$since_date",
+ '--pretty=format:%ct %an <%ae>%n%n'.$format_string, @ARGV);
+ open PIPE, '-|', @cmd
+ or die ("$ME: failed to run `". quoted_cmd (@cmd) ."': $!\n"
+ . "(Is your Git too old? Version 1.5.1 or later is required.)\n");
+
+ my $prev_date_line = '';
+ while (1)
+ {
+ defined (my $in = <PIPE>)
+ or last;
+ $in =~ /^log size (\d+)$/
+ or die "$ME:$.: Invalid line (expected log size):\n$in";
+ my $log_nbytes = $1;
+
+ my $log;
+ my $n_read = read PIPE, $log, $log_nbytes;
+ $n_read == $log_nbytes
+ or die "$ME:$.: unexpected EOF\n";
+
+ my @line = split "\n", $log;
+ my $author_line = shift @line;
+ defined $author_line
+ or die "$ME:$.: unexpected EOF\n";
+ $author_line =~ /^(\d+) (.*>)$/
+ or die "$ME:$.: Invalid line "
+ . "(expected date/author/email):\n$author_line\n";
+
+ my $date_line = sprintf "%s $2\n", strftime ("%F", localtime ($1));
+ # If this line would be the same as the previous date/name/email
+ # line, then arrange not to print it.
+ if ($date_line ne $prev_date_line)
+ {
+ $prev_date_line eq ''
+ or print "\n";
+ print $date_line;
+ }
+ $prev_date_line = $date_line;
+
+ # Omit "Signed-off-by..." lines.
+ @line = grep !/^Signed-off-by: .*>$/, @line;
+
+ # If there were any lines
+ if (@line == 0)
+ {
+ warn "$ME: warning: empty commit message:\n $date_line\n";
+ }
+ else
+ {
+ # Remove leading and trailing blank lines.
+ while ($line[0] =~ /^\s*$/) { shift @line; }
+ while ($line[$#line] =~ /^\s*$/) { pop @line; }
+
+ # Prefix each non-empty line with a TAB.
+ @line = map { length $_ ? "\t$_" : '' } @line;
+
+ print "\n", join ("\n", @line), "\n";
+ }
+
+ defined ($in = <PIPE>)
+ or last;
+ $in ne "\n"
+ and die "$ME:$.: unexpected line:\n$in";
+ }
+
+ close PIPE
+ or die "$ME: error closing pipe from " . quoted_cmd (@cmd) . "\n";
+ # FIXME-someday: include $PROCESS_STATUS in the diagnostic
+}
+
+# Local Variables:
+# mode: perl
+# indent-tabs-mode: nil
+# eval: (add-hook 'write-file-hooks 'time-stamp)
+# time-stamp-start: "my $VERSION = '"
+# time-stamp-format: "%:y-%02m-%02d %02H:%02M"
+# time-stamp-time-zone: "UTC"
+# time-stamp-end: "'; # UTC"
+# End:
diff --git a/make/release.mk b/make/release.mk
new file mode 100644
index 0000000..3a34ace
--- /dev/null
+++ b/make/release.mk
@@ -0,0 +1,73 @@
+# to build official release tarballs, handle tagging and publish.
+
+# signing key
+gpgsignkey=0x6CE95CA7
+
+project=fence-agents
+
+all: checks setup tag tarballs sha256 sign
+
+checks:
+ifeq (,$(version))
+ @echo ERROR: need to define version=
+ @exit 1
+endif
+ @if [ ! -d .git ]; then \
+ echo This script needs to be executed from top level cluster git tree; \
+ exit 1; \
+ fi
+
+setup: checks
+ ./autogen.sh
+ ./configure
+ make maintainer-clean
+
+tag: setup ./tag-$(version)
+
+tag-$(version):
+ifeq (,$(release))
+ @echo Building test release $(version), no tagging
+else
+ git tag -a -m "v$(version) release" v$(version) HEAD
+ @touch $@
+endif
+
+tarballs: tag
+ ./autogen.sh
+ ./configure
+ make distcheck
+
+sha256: tarballs $(project)-$(version).sha256
+
+$(project)-$(version).sha256:
+ifeq (,$(release))
+ @echo Building test release $(version), no sha256
+else
+ sha256sum $(project)-$(version)*tar* | sort -k2 > $@
+endif
+
+sign: sha256 $(project)-$(version).sha256.asc
+
+$(project)-$(version).sha256.asc: $(project)-$(version).sha256
+ifeq (,$(release))
+ @echo Building test release $(version), no sign
+else
+ gpg --default-key $(gpgsignkey) \
+ --detach-sign \
+ --armor \
+ $<
+endif
+
+publish:
+ifeq (,$(release))
+ @echo Building test release $(version), no publishing!
+else
+ git push --tags origin
+ scp $(project)-$(version).* \
+ fedorahosted.org:$(project)
+ @echo Hey you!.. yeah you looking somewhere else!
+ @echo remember to update the wiki and send the email to cluster-devel and linux-cluster
+endif
+
+clean:
+ rm -rf $(project)* tag-*
diff --git a/scripts/fenceparse b/scripts/fenceparse
new file mode 100644
index 0000000..b6ed431
--- /dev/null
+++ b/scripts/fenceparse
@@ -0,0 +1,42 @@
+#!/bin/bash
+
+set -e
+
+export LC_ALL=C
+
+definefile="$1"
+define="$2"
+release="$3"
+srcdir="$4"
+infile="$5"
+
+definedata="$(cat $definefile | grep "^\#define $define" | sed -e 's/.*'$define' //')"
+
+realinfile="$(ls $srcdir/$infile.*{py,pl,sh} 2>/dev/null || true)"
+
+[ -z "$realinfile" ] && exit 1
+
+interpreter="$(cat $realinfile | head -n 1 | awk -F "/" '{print $NF}')"
+interpreter="$(echo $interpreter)"
+
+case "$interpreter" in
+ perl)
+ start="\$"
+ end=";"
+ ;;
+ *)
+ start=""
+ end=""
+ ;;
+esac
+
+awk "{print}(\$1 ~ /#BEGIN_VERSION_GENERATION/){exit 0}" $realinfile
+echo ${start}RELEASE_VERSION=\"${release}\"${end}
+echo ${start}BUILD_DATE=\"\(built $(date)\)\"${end}
+if awk -v p=0 "(\$1 ~ /#BEGIN_VERSION_GENERATION/){p = 1} (\$1 ~ /#END_VERSION_GENERATION/){p = 0} {if(p==1)print}" $realinfile | \
+ grep -q REDHAT_COPYRIGHT; then
+ echo ${start}REDHAT_COPYRIGHT=${definedata}${end}
+fi
+awk -v p=0 "(\$1 ~ /#END_VERSION_GENERATION/){p = 1} {if(p==1)print}" $realinfile
+
+exit 0
diff --git a/tests/actions.d/list.cfg b/tests/actions.d/list.cfg
new file mode 100644
index 0000000..b7ed552
--- /dev/null
+++ b/tests/actions.d/list.cfg
@@ -0,0 +1,2 @@
+name = "List plugs and check port 6"
+actions = [ { "command" : "list", "return_code" : "^0$" } ]
diff --git a/tests/actions.d/power-on-off.cfg b/tests/actions.d/power-on-off.cfg
new file mode 100644
index 0000000..d9df57a
--- /dev/null
+++ b/tests/actions.d/power-on-off.cfg
@@ -0,0 +1,2 @@
+name = "Power ON & OFF"
+actions = [ { "command" : "on", "return_code" : "^0$" }, { "command" : "status", "return_code" : "^0$" }, { "command" : "off", "return_code" : "^0$" }, { "command" : "status", "return_code" : "^2$" } ]
diff --git a/tests/actions.d/sleep.cfg b/tests/actions.d/sleep.cfg
new file mode 100644
index 0000000..c0fad72
--- /dev/null
+++ b/tests/actions.d/sleep.cfg
@@ -0,0 +1,2 @@
+name = "Pure Sleep"
+actions = [ { "command" : "sleep(1)", "return_code" : "^0$" }, { "command" : "sleep(3)", "return_code" : "^0$" }, { "command" : "sleep(5)", "return_code" : "^0$" } ]
diff --git a/tests/actions.d/status.cfg b/tests/actions.d/status.cfg
new file mode 100644
index 0000000..760f94b
--- /dev/null
+++ b/tests/actions.d/status.cfg
@@ -0,0 +1,2 @@
+name = "Simple Status"
+actions = [ { "command" : "status", "return_code" : "^[02]$" }, { "command" : "sleep(1)", "return_code" : "^0$" } ]
diff --git a/tests/devices.d/dummy-with_action.cfg b/tests/devices.d/dummy-with_action.cfg
new file mode 100644
index 0000000..5550c36
--- /dev/null
+++ b/tests/devices.d/dummy-with_action.cfg
@@ -0,0 +1,9 @@
+name = "Dummy fence device configuration"
+agent = "/bin/true"
+[options]
+ login = "foo", "--username", "-l"
+ passwd = "bar", "--password", "-p"
+ ipaddr = "fence.example.com", "--ip", "-a"
+ port = "1", "--plug"
+ action = "status", "--action", "-o"
+
diff --git a/tests/devices.d/dummy.cfg b/tests/devices.d/dummy.cfg
new file mode 100644
index 0000000..d912475
--- /dev/null
+++ b/tests/devices.d/dummy.cfg
@@ -0,0 +1,3 @@
+name = "Dummy fence device configuration"
+agent = "/home/marx/GIT/fence-agents/fence/agents/dummy/fence_dummy"
+[options]
diff --git a/tests/devices.d/invalid-missing_option.cfg b/tests/devices.d/invalid-missing_option.cfg
new file mode 100644
index 0000000..0805fdc
--- /dev/null
+++ b/tests/devices.d/invalid-missing_option.cfg
@@ -0,0 +1,4 @@
+name = "Invalid device definition: Both short and long options are missing"
+agent = "/bin/true"
+[options]
+ login = "foo"
diff --git a/tests/devices.d/true-with_action.cfg b/tests/devices.d/true-with_action.cfg
new file mode 100644
index 0000000..d95c9fe
--- /dev/null
+++ b/tests/devices.d/true-with_action.cfg
@@ -0,0 +1,8 @@
+name = "Dummy fence device configuration"
+agent = "/bin/true"
+[options]
+ login = [ "foo", "--username", "-l" ]
+ passwd = [ "bar", "--password", "-p" ]
+ ipaddr = [ "fence.example.com", "--ip", "-a" ]
+ port = [ "1", "--plug" ]
+ action = [ "status", "--action", "-o" ]
diff --git a/tests/devices.d/true.cfg b/tests/devices.d/true.cfg
new file mode 100644
index 0000000..4ba0aa5
--- /dev/null
+++ b/tests/devices.d/true.cfg
@@ -0,0 +1,8 @@
+name = "Dummy fence device configuration"
+agent = "/bin/true"
+[options]
+ login = [ "foo", "--username", "-l" ]
+ passwd = [ "bar", "--password", "-p" ]
+ ipaddr = [ "fence.example.com", "--ip", "-a" ]
+ port = [ "1", "--plug" ]
+
diff --git a/tests/fence_testing.py b/tests/fence_testing.py
new file mode 100755
index 0000000..166eaf8
--- /dev/null
+++ b/tests/fence_testing.py
@@ -0,0 +1,126 @@
+""" Library for fence agents testing via predefined scenarios """
+from configobj import ConfigObj
+import re, sys, os
+
+EC_CONFIG_FAIL = 1
+
+def _prepare_command(agent_file, method):
+ """ Parse configuration of fence device and prepare (command + STDIN values) to execute.
+
+ Fence device configuration is used to generate a command which can be executed.
+ Because fence agents supports several options how to enter data, we can select
+ from three different methods ("stdin", "getopt" - short options, "longopt").
+ When method "stdin" is used then this function will generate also text which should
+ be entered on STDIN instead of command itself.
+
+ Example of agent definition:
+ name = "Dummy fence device configuration"
+ agent = "/bin/true"
+ [options]
+ login = [ "foo", "--username", "-l" ]
+ passwd = [ "bar", "--password", "-p" ]
+ ipaddr = [ "fence.example.com", "--ip", "-a" ]
+ port = [ "1", "--plug" ]
+ """
+ assert (method in ["stdin", "getopt", "longopt"]), "Invalid method entered"
+
+ config = ConfigObj(agent_file, unrepr = True)
+
+ assert (config.has_key("agent")), "Fence agent has to be defined"
+ final_command = config["agent"]
+ stdin_values = None
+
+ for opt in config["options"].keys():
+ assert isinstance(config["options"][opt], list), "Option %s have to have at least value and longopt"% (opt)
+ assert len(config["options"][opt]) >= 2, "Option %s have to have at least value and longopt"% (opt)
+ value = config["options"][opt][0]
+ if opt == "action":
+ ## ignore action as it is not part of fence device definition
+ continue
+
+ if method == "stdin":
+ option = opt
+ if stdin_values == None:
+ stdin_values = ""
+ stdin_values += option + "=" + value + "\n"
+ elif method == "longopt":
+ option = config["options"][opt][1]
+ final_command += " " + option + " " + value
+ elif method == "getopt":
+ if len(config["options"][opt]) == (2 + 1):
+ option = config["options"][opt][2]
+ else:
+ option = config["options"][opt][1]
+ final_command += " " + option + " " + value
+
+ return (final_command, stdin_values)
+
+def test_action(agent, action_file, method, verbose = False):
+ """ Run defined sequence of actions on a given fence agent.
+
+ This function will run one set of test on a fence agent. Test itself consists of
+ sequence of action and expected return codes. User can select from actions supported
+ by fence agent (on, off, reboot, list, status, monitor) and sleep(X) command where X
+ is in seconds and determine the length of pause between commands. Each action has to
+ have defined regular expression which define acceptable return codes from fence agent
+ or sleep.
+
+ Example of action configuration file:
+ name = "Simple Status"
+ actions = [ { "command" : "status", "return_code" : "^[02]$" }, { "command" : "sleep(1)", "return_code" : "^0$" } ]
+ """
+ re_sleep_command = re.compile('sleep\(([0-9]+)\)', re.IGNORECASE)
+ config = ConfigObj(action_file, unrepr = True)
+
+ (command, stdin_options) = _prepare_command(agent, method)
+
+ for action in config["actions"]:
+ assert action.has_key("command"), "Action %s need to have defined 'command'"% (action_file)
+ assert action.has_key("return_code"), "Command %s (in %s) need to have 'return_code' defined"% (action_file, action["command"])
+
+ sleep_wait = None
+ current_command = None
+ current_stdin_options = None
+
+ if not (action["command"] in [ "status", "reboot", "on", "off", "list", "monitor" ]):
+ is_sleep = re.search(re_sleep_command, action["command"])
+ if is_sleep != None:
+ sleep_wait = is_sleep.group(1)
+ else:
+ sys.stderr.write("ERROR: %s contains unsupported action \"%s\"\n"% (action_file, action["command"]))
+ sys.exit(1)
+
+ if sleep_wait != None:
+ current_command = "/bin/sleep " + sleep_wait
+ current_stdin_options = None
+ else:
+ current_command = command
+ current_stdin_options = stdin_options
+
+ if method == "stdin":
+ if current_stdin_options == None:
+ current_stdin_options = ""
+ current_stdin_options += "action=%s"% (action["command"])
+ elif method == "longopt":
+ current_command += " --action=%s"% (action["command"])
+ elif method == "getopt":
+ current_command += " -o %s"% (action["command"])
+
+ # @note: Broken pipe can occur here and I'm not sure why - non-deterministic
+ if method == "stdin" and sleep_wait == None:
+ current_command = "/bin/echo -e \"" + current_stdin_options + "\" | " + current_command
+
+ if verbose == False:
+ result = os.system(current_command + " &> /dev/null")
+ else:
+ print current_command
+ result = os.system(current_command)
+ exitcode = (result >> 8) & 0xFF
+
+ is_valid_result_code = re.search(action["return_code"], str(exitcode), re.IGNORECASE)
+
+ if is_valid_result_code == None:
+ print "TEST FAILED: %s failed on %s when using (%s)\n"% (agent, action_file, method)
+ print "TEST INFO: %s returns %s\n"% (action["command"], str(exitcode))
+ return
+ print "TEST PASSED: %s worked on %s (%s)\n"% (agent, action_file, method)
diff --git a/tests/fence_testing_test.py b/tests/fence_testing_test.py
new file mode 100755
index 0000000..368ff70
--- /dev/null
+++ b/tests/fence_testing_test.py
@@ -0,0 +1,70 @@
+#!/usr/bin/python
+
+import unittest
+import fence_testing
+
+class TestPrepareCommand(unittest.TestCase):
+ DEVICE_MISSING_OPTION = "devices.d/invalid-missing_option.cfg"
+ DEVICE_CORRECT = "devices.d/true.cfg"
+ DEVICE_CORRECT_WITH_ACTION = "devices.d/true-with_action.cfg"
+
+ def test_missing_device(self):
+ self.assertRaises(fence_testing._prepare_command, None, "getopt")
+
+ def test_missing_option(self):
+ self.assertRaises(AssertionError, fence_testing._prepare_command, self.DEVICE_MISSING_OPTION, "stdin")
+
+ def test_valid_methods(self):
+ fence_testing._prepare_command(self.DEVICE_CORRECT, "getopt")
+ fence_testing._prepare_command(self.DEVICE_CORRECT, "longopt")
+ fence_testing._prepare_command(self.DEVICE_CORRECT, "stdin")
+
+ def test_invalid_method(self):
+ self.assertRaises(AssertionError, fence_testing._prepare_command, self.DEVICE_CORRECT, "invalid")
+
+ def test_is_action_ignored(self):
+ (command1, _) = fence_testing._prepare_command(self.DEVICE_CORRECT, "getopt")
+ (command2, _) = fence_testing._prepare_command(self.DEVICE_CORRECT_WITH_ACTION, "getopt")
+ self.assertEquals(command1, command2)
+
+ def test_is_stdin_empty(self):
+ (_, stdin) = fence_testing._prepare_command(self.DEVICE_CORRECT, "getopt")
+ self.assertEquals(None, stdin)
+ (_, stdin) = fence_testing._prepare_command(self.DEVICE_CORRECT, "longopt")
+ self.assertEquals(None, stdin)
+
+ def test_prepared_command_getopt(self):
+ ## Test also fallback to longopt if short is not present
+ (command, _) = fence_testing._prepare_command(self.DEVICE_CORRECT, "getopt")
+ self.assertEquals("/bin/true -l foo -p bar -a fence.example.com --plug 1", command)
+
+ def test_prepared_command_longopt(self):
+ (command, _) = fence_testing._prepare_command(self.DEVICE_CORRECT, "longopt")
+ self.assertEquals("/bin/true --username foo --password bar --ip fence.example.com --plug 1", command)
+
+ def test_prepared_command_stdin(self):
+ (command, stdin) = fence_testing._prepare_command(self.DEVICE_CORRECT, "stdin")
+ self.assertEquals("/bin/true", command)
+ self.assertEquals("login=foo\npasswd=bar\nipaddr=fence.example.com\nport=1\n", stdin)
+
+class TestTestAction(unittest.TestCase):
+ def test_valid_actions(self):
+ pass
+
+ def test_invalid_actions(self):
+ pass
+
+ def test_valid_return_code(self):
+ pass
+
+ def test_invalid_return_code(self):
+ pass
+
+ def test_valid_re_contains(self):
+ pass
+
+ def test_invalid_re_contains(self):
+ pass
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/test-apc2.py b/tests/test-apc2.py
new file mode 100755
index 0000000..bb5aefd
--- /dev/null
+++ b/tests/test-apc2.py
@@ -0,0 +1,17 @@
+#!/usr/bin/python
+
+from fence_testing import test_action
+
+def main():
+ DEVICE = "devices.d/apc-v2.cfg"
+
+ ACT_STATUS = "actions.d/status.cfg"
+ ACT_ONOFF = "actions.d/power-on-off.cfg"
+ ACT_LIST = "actions.d/list.cfg"
+
+ test_action(DEVICE, ACT_STATUS, "getopt")
+ test_action(DEVICE, ACT_ONOFF, "stdin")
+ test_action(DEVICE, ACT_LIST, "getopt")
+
+if __name__ == "__main__":
+ main()
\ No newline at end of file
diff --git a/tests/test-apc5.py b/tests/test-apc5.py
new file mode 100755
index 0000000..6cea3b1
--- /dev/null
+++ b/tests/test-apc5.py
@@ -0,0 +1,17 @@
+#!/usr/bin/python
+
+from fence_testing import test_action
+
+def main():
+ DEVICE = "devices.d/apc-v5.cfg"
+
+ ACT_STATUS = "actions.d/status.cfg"
+ ACT_ONOFF = "actions.d/power-on-off.cfg"
+ ACT_LIST = "actions.d/list.cfg"
+
+ test_action(DEVICE, ACT_STATUS, "getopt", verbose=1)
+# test_action(DEVICE, ACT_ONOFF, "stdin")
+ test_action(DEVICE, ACT_LIST, "getopt")
+
+if __name__ == "__main__":
+ main()
\ No newline at end of file
diff --git a/tests/test-drac4.py b/tests/test-drac4.py
new file mode 100755
index 0000000..75c24c5
--- /dev/null
+++ b/tests/test-drac4.py
@@ -0,0 +1,15 @@
+#!/usr/bin/python
+
+from fence_testing import test_action
+
+def main():
+ DRAC4 = "devices.d/dell-drac-4I.cfg"
+
+ ACT_STATUS = "actions.d/status.cfg"
+ ACT_ONOFF = "actions.d/power-on-off.cfg"
+
+ test_action(DRAC4, ACT_STATUS, "getopt")
+ test_action(DRAC4, ACT_ONOFF, "stdin")
+
+if __name__ == "__main__":
+ main()
\ No newline at end of file
diff --git a/tests/test-multi-apc2.py b/tests/test-multi-apc2.py
new file mode 100755
index 0000000..7ab9754
--- /dev/null
+++ b/tests/test-multi-apc2.py
@@ -0,0 +1,17 @@
+#!/usr/bin/python
+
+from fence_testing import test_action
+
+def main():
+ DEVICE = "devices.d/multi-apc-v2.cfg"
+
+ ACT_STATUS = "actions.d/status.cfg"
+ ACT_ONOFF = "actions.d/power-on-off.cfg"
+ ACT_LIST = "actions.d/list.cfg"
+
+ test_action(DEVICE, ACT_STATUS, "getopt")
+ test_action(DEVICE, ACT_ONOFF, "stdin")
+ test_action(DEVICE, ACT_LIST, "getopt")
+
+if __name__ == "__main__":
+ main()
\ No newline at end of file
diff --git a/tests/test.py b/tests/test.py
new file mode 100755
index 0000000..8e82ed9
--- /dev/null
+++ b/tests/test.py
@@ -0,0 +1,21 @@
+#!/usr/bin/python
+
+from fence_testing import test_action
+
+def main():
+ ## @todo: utility1 - run single 'agent' 'action' 'method'
+ ## @todo: utility2 - run complex tests (using utility1?) -> file with test suites
+
+ AGENTDEF = "devices.d/true.cfg"
+ DUMMYDEF = "devices.d/dummy.cfg"
+
+ ACT_STATUS = "actions.d/status.cfg"
+ ACT_ONOFF = "actions.d/power-on-off.cfg"
+
+# test_action(AGENTDEF, ACTIONDEF, "stdin")
+# test_action(AGENTDEF, ACTIONDEF, "getopt")
+ test_action(DUMMYDEF, ACT_STATUS, "getopt")
+ test_action(DUMMYDEF, ACT_ONOFF, "getopt")
+
+if __name__ == "__main__":
+ main()
\ No newline at end of file
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-ha/fence-agents.git
More information about the Debian-HA-Commits
mailing list