Observium_CE/mibs/enterasys/ENTERASYS-VIRTUAL-SWITCH-BONDING-MIB

638 lines
21 KiB
Plaintext

ENTERASYS-VIRTUAL-SWITCH-BONDING-MIB DEFINITIONS ::= BEGIN
-- enterasys-virtual-switch-bonding-mib.txt
--
-- Part Number:
--
--
-- This module provides authoritative definitions for Enterasys
-- Networks' Virtual Switch Bonding MIB.
--
-- This module will be extended, as needed.
-- Enterasys Networks reserves the right to make changes in this
-- specification and other information contained in this document
-- without prior notice. The reader should consult Enterasys Networks
-- to determine whether any such changes have been made.
--
-- In no event shall Enterasys Networks be liable for any incidental,
-- indirect, special, or consequential damages whatsoever (including
-- but not limited to lost profits) arising out of or related to this
-- document or the information contained in it, even if Enterasys
-- Networks has been advised of, known, or should have known, the
-- possibility of such damages.
--
-- Enterasys Networks grants vendors, end-users, and other interested
-- parties a non-exclusive license to use this Specification in
-- connection with the management of Enterasys Networks products.
-- Copyright March 2012 Enterasys Networks, Inc.
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, Unsigned32
FROM SNMPv2-SMI
TEXTUAL-CONVENTION, TruthValue, TimeStamp, MacAddress
FROM SNMPv2-TC
MODULE-COMPLIANCE, OBJECT-GROUP
FROM SNMPv2-CONF
SnmpAdminString
FROM SNMP-FRAMEWORK-MIB
ifIndex
FROM IF-MIB
etsysModules
FROM ENTERASYS-MIB-NAMES;
etsysVirtualSwitchBondingMIB MODULE-IDENTITY
LAST-UPDATED "201203131914Z" -- Tue Mar 13 19:14 UTC 2012
ORGANIZATION "Enterasys Networks, Inc"
CONTACT-INFO
"Postal: Enterasys Networks
50 Minuteman Rd.
Andover, MA 01810-1008
USA
Phone: +1 978 684 1000
E-mail: support@enterasys.com
WWW: http://www.enterasys.com"
DESCRIPTION
"This MIB module defines a portion of the SNMP MIB under
Enterasys Networks' enterprise OID pertaining to Virtual
Switch Bonding (VSB).
VSB is meant to accomplish two similar
goals: to allow the aggregation of two or more
chassis-type products into a single, virtual network
device; and similarly to support building a stack of
two or more stand-alone-type products. The key operational
benefit behind this (and similar) technologies is the
ability to provide transparent Layer 2 physical redundancy
(redundancy of both links and network devices) all the way
to the edge of the network."
REVISION "201203131914Z" -- Tue Mar 13 19:14 UTC 2012
DESCRIPTION
"Added the etsysVsbSystemLinkFailureResponse and
etsysVsbChassisLfrOperPriority objects."
REVISION "201202071553Z" -- Tue Feb 7 15:53 UTC 2012
DESCRIPTION
"Correct DEFVAL clause for etsysVsbPortAdminStatus."
REVISION "201112132031Z" -- Tue Dec 13 20:31 UTC 2011
DESCRIPTION
"The initial version of this MIB module."
::= { etsysModules 83 }
-- -------------------------------------------------------------
-- MIB Objects
-- -------------------------------------------------------------
etsysVsbObjects
OBJECT IDENTIFIER ::= { etsysVirtualSwitchBondingMIB 1 }
etsysVsbSystem
OBJECT IDENTIFIER ::= { etsysVsbObjects 1 }
etsysVsbChassis
OBJECT IDENTIFIER ::= { etsysVsbObjects 2 }
etsysVsbPort
OBJECT IDENTIFIER ::= { etsysVsbObjects 3 }
-- -------------------------------------------------------------
-- Textual Conventions
-- ---------------------------------------------------------
VsbId ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"An octet string value that uniquely identifies a
virtual switch. A string of zero length means no ID is
configured for this device."
SYNTAX OCTET STRING (SIZE (0|8))
VsbChassisStatus ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"This textual convention describes chassis
bonding status.
up(1) indicates chassis is present and bonded
to all virtual switch members.
down(2) indicates chassis is not present.
incomplete(3) indicates chassis is present but not
bonded to all virtual switch members.
inactive(4) indicates chassis is present but not
active in the bond."
SYNTAX INTEGER {
up(1),
down(2),
incomplete(3),
inactive(4)
}
VsbSlotList ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"Each octet within this value specifies a set of eight
slots, with the first octet specifying slots 1 through 8,
the second octet specifying slots 9 through 16, etc.
Within each octet, the most significant bit represents
the lowest numbered slot, and the least significant bit
represents the highest numbered slot. Thus, each slot
of the virtual switch is represented by a single bit
within the value of this object. If that bit has a value
of '1' then that slot is included in the set of slots;
the slot is not included if its bit has a value of '0'."
SYNTAX OCTET STRING
-- ---------------------------------------------------------- --
-- VSB System Group
-- ---------------------------------------------------------- --
etsysVsbSystemEnable OBJECT-TYPE
SYNTAX INTEGER {
enabled(1),
disabled(2)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The administrative enable/disable state for VSB.
Enabling this object turns on VSB in a system."
DEFVAL { disabled }
::= { etsysVsbSystem 1 }
etsysVsbSystemMaxChassis OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum number of physical chassis supported
in the virtual switch."
::= { etsysVsbSystem 2 }
etsysVsbSystemMaxSlotNumber OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum slot number supported in the virtual switch."
::= { etsysVsbSystem 3 }
etsysVsbAdministrativeMacAddress OBJECT-TYPE
SYNTAX MacAddress
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The administratively configured mac address of the
virtual switch."
::= { etsysVsbSystem 4 }
etsysVsbOperationalMacAddress OBJECT-TYPE
SYNTAX MacAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The operationally assigned mac address of the
virtual switch. If no mac address is administratively
configured, the VSB system will be responsible for selecting
and assigning the virtual switch mac address."
::= { etsysVsbSystem 5 }
etsysVsbSystemLinkFailureResponse OBJECT-TYPE
SYNTAX INTEGER {
enabled(1),
disabled(2)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The administrative state of the Link Failure Response
for the VSB. Enabling this object turns on the default
Link Failure Response algorithms."
DEFVAL { disabled }
::= { etsysVsbSystem 6 }
-- ---------------------------------------------------------- --
-- VSB Chassis Table
-- ---------------------------------------------------------- --
etsysVsbChassisTable OBJECT-TYPE
SYNTAX SEQUENCE OF EtsysVsbChassisEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains the configuration information for
the physical chassis of a virtual switch.
Adding a chassis to a virtual switch is initiated by
assigning a virtual switch system ID to an entry.
The entry index is also the chassis ID in the virtual switch.
A virtual switch ID can only be administratively assigned
to one entry in the table because a chassis cannot
simultaneously be a member of multiple virtual switches,
or have multiple chassis IDs in the same virtual switch.
A value of 'inconsistentValue' will be returned if attempts
are made to assign the same virtual switch ID to more than
one entry.
Chassis ID is also used to indicate relative position
in the virtual switch, where chassis 1 is assigned slot 1
through n, chassis 2 is assigned slots n+1 through n+m,
where n and m are the max number of slots for chassis 1 and
2 respectively."
::= { etsysVsbChassis 1 }
etsysVsbChassisEntry OBJECT-TYPE
SYNTAX EtsysVsbChassisEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The configuration for a physical chassis in the
virtual switch."
INDEX { etsysVsbChassisIndex }
::= { etsysVsbChassisTable 1 }
EtsysVsbChassisEntry ::=
SEQUENCE {
etsysVsbChassisIndex Unsigned32,
etsysVsbChassisSystemId VsbId,
etsysVsbChassisSerialNum SnmpAdminString,
etsysVsbChassisFirstSlotNumber Unsigned32,
etsysVsbChassisLocalSlotList VsbSlotList,
etsysVsbChassisSystemSlotList VsbSlotList,
etsysVsbChassisStatus VsbChassisStatus,
etsysVsbChassisLastBondTime TimeStamp,
etsysVsbChassisSharedSecret SnmpAdminString,
etsysVsbChassisSecretEntered TruthValue,
etsysVsbChassisLfrOperPriority Unsigned32
}
etsysVsbChassisIndex OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The identifier of this chassis in the virtual switch.
This value is in the range between 1..etsysVsbSystemMaxChassis."
::= { etsysVsbChassisEntry 1 }
etsysVsbChassisSystemId OBJECT-TYPE
SYNTAX VsbId
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The virtual switch ID for this switch."
::= { etsysVsbChassisEntry 2 }
etsysVsbChassisSerialNum OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE(0..32))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The serial number string for the physical chassis or standalone
device in a bonded setup."
::= { etsysVsbChassisEntry 3 }
etsysVsbChassisFirstSlotNumber OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The administratively assigned first slot position in the
virtual switch. Manually initializing chassis position
will override automatic positioning by the VSB system.
In the event another chassis already occupies the position,
this chassis will not be added to the bond. This value is in the
range of 0|1..etsysVsbSystemMaxSlotNumber."
DEFVAL { 0 }
::= { etsysVsbChassisEntry 4 }
etsysVsbChassisLocalSlotList OBJECT-TYPE
SYNTAX VsbSlotList
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The set of slots local to this chassis that are present."
::= { etsysVsbChassisEntry 5 }
etsysVsbChassisSystemSlotList OBJECT-TYPE
SYNTAX VsbSlotList
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The set of local and bonded slots that are present."
::= { etsysVsbChassisEntry 6 }
etsysVsbChassisStatus OBJECT-TYPE
SYNTAX VsbChassisStatus
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The bonding status of this chassis."
::= { etsysVsbChassisEntry 7 }
etsysVsbChassisLastBondTime OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Last sysUpTime at which this chassis was connected
to all other members of the virtual switch."
::= { etsysVsbChassisEntry 8 }
etsysVsbChassisSharedSecret OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..32))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The secret shared between the chassis in a virtual switch used
to authenticate the bonding protocol data being transmitted
between chassis.
On a read operation this object MUST return a zero length
string.
Writing this object with a zero length string clears the
secret."
::= { etsysVsbChassisEntry 9 }
etsysVsbChassisSecretEntered OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"true(1) - Indicates that etsysVsbChassisSharedSecret was
last set with some value other than the empty string.
false(2) - Indicates that etsysVsbChassisSharedSecret has
never been set, or was last set to the empty string."
::= { etsysVsbChassisEntry 10 }
etsysVsbChassisLfrOperPriority OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Operational priority assigned to the associated chassis
identifier. When responding to a VSB link failure, the
currently operational chassis with the highest priority
is allowed to remain operational. This value is in the
range between 1..255."
::= { etsysVsbChassisEntry 11 }
-- ---------------------------------------------------------- --
-- VSB Port Table
-- ---------------------------------------------------------- --
etsysVsbPortTable OBJECT-TYPE
SYNTAX SEQUENCE OF EtsysVsbPortEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of configuration and status objects for each
port that supports Bonding Port mode."
::= { etsysVsbPort 1 }
etsysVsbPortEntry OBJECT-TYPE
SYNTAX EtsysVsbPortEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry containing per port bonding properties."
INDEX { ifIndex }
::= { etsysVsbPortTable 1 }
EtsysVsbPortEntry ::=
SEQUENCE {
etsysVsbPortAdminStatus INTEGER,
etsysVsbPortOperStatus INTEGER
}
etsysVsbPortAdminStatus OBJECT-TYPE
SYNTAX INTEGER {
up(1),
down(2)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The desired state of the bonding port for this ifIndex."
DEFVAL { down }
::= { etsysVsbPortEntry 1 }
etsysVsbPortOperStatus OBJECT-TYPE
SYNTAX INTEGER {
up(1),
down(2),
highLatency(3),
probeLoop(4),
probeTimeout(5),
portInstability(6)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The operational status of the bonding port for this ifIndex.
If the state is NOT up, then it is down for the stated reason,
if known. If etsysVsbPortAdminStatus is down(2), then
etsysVsbPortOperStatus should be down(2). If etsysVsbPortAdminStatus
is changed to up(1) the etsysVsbPortOperStatus should change to
up(1) if the interface is ready to transmit and receive bonding
traffic. It should remain in the down(2) state if and only if
there is a fault that prevents it from going to the up(1) state."
::= { etsysVsbPortEntry 2 }
-- -------------------------------------------------------------
-- Conformance Information
-- -------------------------------------------------------------
etsysVsbConformance
OBJECT IDENTIFIER ::= { etsysVirtualSwitchBondingMIB 2 }
etsysVsbGroups
OBJECT IDENTIFIER ::= { etsysVsbConformance 1 }
etsysVsbCompliances
OBJECT IDENTIFIER ::= { etsysVsbConformance 2 }
-- -------------------------------------------------------------
-- Units of conformance
-- -------------------------------------------------------------
etsysVsbSystemGroup OBJECT-GROUP
OBJECTS {
etsysVsbSystemEnable,
etsysVsbSystemMaxChassis,
etsysVsbSystemMaxSlotNumber,
etsysVsbAdministrativeMacAddress,
etsysVsbOperationalMacAddress
}
STATUS deprecated
DESCRIPTION
"This section is for system configuration of
the VSB system."
::= { etsysVsbGroups 1 }
etsysVsbChassisGroup OBJECT-GROUP
OBJECTS {
etsysVsbChassisSystemId,
etsysVsbChassisSerialNum,
etsysVsbChassisFirstSlotNumber,
etsysVsbChassisLocalSlotList,
etsysVsbChassisSystemSlotList,
etsysVsbChassisStatus,
etsysVsbChassisLastBondTime,
etsysVsbChassisSharedSecret,
etsysVsbChassisSecretEntered
}
STATUS deprecated
DESCRIPTION
"This section is for chassis based configuration of
the VSB system."
::= { etsysVsbGroups 2 }
etsysVsbPortGroup OBJECT-GROUP
OBJECTS {
etsysVsbPortAdminStatus,
etsysVsbPortOperStatus
}
STATUS current
DESCRIPTION
"This section is for port configuration of the
VSB system."
::= { etsysVsbGroups 3 }
etsysVsbSystemGroup2 OBJECT-GROUP
OBJECTS {
etsysVsbSystemEnable,
etsysVsbSystemMaxChassis,
etsysVsbSystemMaxSlotNumber,
etsysVsbAdministrativeMacAddress,
etsysVsbOperationalMacAddress,
etsysVsbSystemLinkFailureResponse
}
STATUS current
DESCRIPTION
"This section is for system configuration of
the VSB system."
::= { etsysVsbGroups 4 }
etsysVsbChassisGroup2 OBJECT-GROUP
OBJECTS {
etsysVsbChassisSystemId,
etsysVsbChassisSerialNum,
etsysVsbChassisFirstSlotNumber,
etsysVsbChassisLocalSlotList,
etsysVsbChassisSystemSlotList,
etsysVsbChassisStatus,
etsysVsbChassisLastBondTime,
etsysVsbChassisSharedSecret,
etsysVsbChassisSecretEntered,
etsysVsbChassisLfrOperPriority
}
STATUS current
DESCRIPTION
"This section is for chassis based configuration of
the VSB system."
::= { etsysVsbGroups 5 }
-- -------------------------------------------------------------
-- Compliance statements
-- -------------------------------------------------------------
etsysVsbCompliance MODULE-COMPLIANCE
STATUS deprecated
DESCRIPTION
"The compliance statement for devices that support VSB."
MODULE -- this module
MANDATORY-GROUPS { etsysVsbSystemGroup,
etsysVsbChassisGroup,
etsysVsbPortGroup }
OBJECT etsysVsbSystemEnable
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required for devices where VSB must
always be enabled."
OBJECT etsysVsbAdministrativeMacAddress
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT etsysVsbChassisSharedSecret
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required"
OBJECT etsysVsbChassisFirstSlotNumber
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT etsysVsbPortAdminStatus
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required for devices with dedicated
VSB ports."
::= { etsysVsbCompliances 1 }
etsysVsbCompliance2 MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for devices that support VSB."
MODULE -- this module
MANDATORY-GROUPS { etsysVsbSystemGroup2,
etsysVsbChassisGroup2,
etsysVsbPortGroup }
OBJECT etsysVsbSystemEnable
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required for devices where VSB must
always be enabled."
OBJECT etsysVsbAdministrativeMacAddress
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT etsysVsbSystemLinkFailureResponse
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT etsysVsbChassisSharedSecret
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required"
OBJECT etsysVsbChassisLfrOperPriority
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required"
OBJECT etsysVsbChassisFirstSlotNumber
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT etsysVsbPortAdminStatus
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required for devices with dedicated
VSB ports."
::= { etsysVsbCompliances 2 }
END