snmp_mib_archive/CISCO-VIRTUAL-NW-IF-MIB.my
Heston Snodgrass 89bf4b016e initial commit
2016-12-15 15:03:18 -07:00

321 lines
14 KiB
Plaintext

-- *********************************************************************
-- CISCO-VIRTUAL-NW-IF-MIB.my: Virtual Network Interface Mib
--
-- September 2002, Srini Kode
--
-- Copyright (c) 2002 by cisco Systems, Inc.
-- All rights reserved.
--
-- *********************************************************************
CISCO-VIRTUAL-NW-IF-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE,
NOTIFICATION-TYPE,
Unsigned32 FROM SNMPv2-SMI
MODULE-COMPLIANCE, OBJECT-GROUP,
NOTIFICATION-GROUP FROM SNMPv2-CONF
RowStatus FROM SNMPv2-TC
SnmpAdminString FROM SNMP-FRAMEWORK-MIB
InterfaceIndex,ifName FROM IF-MIB
ciscoMgmt FROM CISCO-SMI
entPhysicalIndex FROM ENTITY-MIB
FcAddressId FROM CISCO-ST-TC;
ciscoVirtualNwIfMIB MODULE-IDENTITY
LAST-UPDATED "200210020000Z"
ORGANIZATION "Cisco Systems Inc."
CONTACT-INFO
" Cisco Systems
Customer Service
Postal: 170 W Tasman Drive
San Jose, CA 95134
USA
Tel: +1 800 553 -NETS
E-mail: cs-san@cisco.com"
DESCRIPTION
"The MIB module for management of virtual network
interfaces to VSAN and VLAN."
REVISION "200210020000Z"
DESCRIPTION
"Initial version of this MIB module."
::= { ciscoMgmt 290 }
ciscoVirtualNwIfObjects OBJECT IDENTIFIER
::= { ciscoVirtualNwIfMIB 1 }
virtualNwIfMIBConformance OBJECT IDENTIFIER
::= { ciscoVirtualNwIfMIB 2 }
virtualNwIfConfig OBJECT IDENTIFIER
::= { ciscoVirtualNwIfObjects 1 }
virtualNwIfStatistics OBJECT IDENTIFIER
::= { ciscoVirtualNwIfObjects 2 }
virtualNwIfNotification OBJECT IDENTIFIER
::= { ciscoVirtualNwIfObjects 3 }
virtualNwIfNotifications OBJECT IDENTIFIER
::= { virtualNwIfNotification 0 }
-- Virtual Network Interface Table
virtualNwIfTable OBJECT-TYPE
SYNTAX SEQUENCE OF VirtualNwIfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains one entry for each local virtual
interface to a VSAN or VLAN, at most one such interface
per processor on a Supervisor or Line card managed by
the agent. Each such processor will have an entry in
the entPhysicalTable ( from ENTITY-MIB ) and will have a
unique PhysicalIndex. For e.g. if Line card has
2 processors on it then each processor will have a
entry in the entPhysicaltable and each will have
unique PhysicalIndex. It is possible that there can be
multiple VSAN's or VLAN's per processor, but the
network manager can create only one virtual interface
for a VSAN and only one for a VLAN per physical entity
i.e. per processor on the card.
Note:Processor is represented as a physical entity in
the entPhysicalTable.
Each such interface has a unique ifIndex assigned by
the agent. When requested to create an entry in this
table, the agent also creates a corresponding entry in
the ifTable of IF-MIB and also an entry in the
cieIfInterfaceTable of CISCO-IF-EXTENSION-MIB. Next,
the agent fills in the values of virtualNwIfIndex, after
which the creation of the entry in this table completes.
The ciiIPIfAddressTable of CISCO-IP-IF-MIB can be used
to configure the IP addresses. The ifTable and this
table can be used to monitor the interface.
Entries in this table are created by network managers.
But the entries can be deleted either by the network
managers or will be deleted by the agent if the
corresponding VSAN or VLAN is deleted.
An entry will be allowed to be created only if the
corresponding VSAN or VLAN has been created.
The ifType for an created interface of type 'vsan(1)'
will be 'fibreChannel(56)' and of type 'vlan(2)' would
be 'ethernetCsmacd(6)'. "
::= { virtualNwIfConfig 1 }
virtualNwIfEntry OBJECT-TYPE
SYNTAX VirtualNwIfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Each entry provides information on a local virtual
interface for a VSAN or VLAN."
INDEX { entPhysicalIndex, virtualNwIfType, virtualNwIfId }
::= { virtualNwIfTable 1 }
VirtualNwIfEntry ::= SEQUENCE {
virtualNwIfType INTEGER,
virtualNwIfId Unsigned32,
virtualNwIfIndex InterfaceIndex,
virtualNwIfFcId FcAddressId,
virtualNwIfOperStatusCause INTEGER,
virtualNwIfOperStatusCauseDescr SnmpAdminString,
virtualNwIfRowStatus RowStatus
}
virtualNwIfType OBJECT-TYPE
SYNTAX INTEGER { vsan(1), vlan(2) }
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"If the virtualNwIfType is vsan(1) and if the
corresponding virtual interface is enabled
( ifAdminStatus='up' ), then the operational state of
virtual interface will become active
( ifOperStatus='up' ) only if the VSAN state is active
and a FCID is obtained through a successful FLOGI.
Even if the desired state of the virtual interface is
enabled ( ifAdminStatus='up' ), but if the VSAN state is
non-active or FCID has not been obtained, then the
virtual interface is disabled(ifOperStatus='down').
Only when the VSAN state becomes active and an FCID is
obtained will the virtual interface be enabled
( ifOperStatus='up' ). An interface can be disabled while
its VSAN exists by setting ifAdminStatus='down'. When
an VSAN is deleted, the corresponding interface
( if created ) is also deleted.
If the virtualNwIfType is vlan(2) and if the
corresponding virtual interface is enabled
( ifAdminStatus='up' ) , then the virtual interface will
become active ( ifOperStatus='up' ) only if the VLAN
state is active. Even if the desired state of the
virtual interface is enabled(ifAdminStatus='up'), but if
the VLAN state is non-active, then the virtual interface
is disabled ( ifOperStatus='down' ) . Only when the VLAN
state becomes active will the virtual interface be
enabled ( ifOperStatus='up' ). An interface can be
disabled while its VLAN exists by setting
ifAdminStatus='down'. When an VLAN is deleted, the
corresponding interface ( if created ) is also deleted. "
::= { virtualNwIfEntry 1 }
virtualNwIfId OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The id of VSAN or VLAN, according to the value of
virtualNwIfType. "
::= { virtualNwIfEntry 2 }
virtualNwIfIndex OBJECT-TYPE
SYNTAX InterfaceIndex
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The ifIndex of this interface. This value is
dynamically assigned by the agent. It is valid
whenever the value of the corresponding
virtualNwIfRowStatus is 'active'.
The ifType of interface of type vsan(1) will be
'fibreChannel(56)' and of type 'vlan(2)' would be
'ethernetCsmacd(6)'. "
::= { virtualNwIfEntry 3 }
virtualNwIfFcId OBJECT-TYPE
SYNTAX FcAddressId
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The Fibre Channel Identifier(FC-ID) of this interface.
This object is relevant to interfaces with
'virtualNwIfType' of vsan(1) only. "
::= { virtualNwIfEntry 4 }
virtualNwIfOperStatusCause OBJECT-TYPE
SYNTAX INTEGER {
none(1),
adminDown(2),
vsanNotOperational(3),
noFcid(4),
kernelConfFailure(5)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The cause of current operational state of the interface.
'none(1)' - no failure.
'adminDown(2)' - 'ifAdminStatus' is down(2).
'vsanNotOperational(3) - VSAN not operational.
'noFcid(4)' - failed to get an FCID.
'kernelConfFailure(5)' - failed to configure the
network device.
The current operational state of the interface is shown
by the 'ifOperStatus' defined in rfc2863. This object
will show 'none(1)' for all the 'ifOperStatus' values
except for 'down(2)'. It will show one of the values
defined above if 'ifOperStatus' is 'down(2)'. "
::= { virtualNwIfEntry 5 }
virtualNwIfOperStatusCauseDescr OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The description for the cause of current operational
state of the interface, shown by the object
'virtualNwIfOperStatusCause'. "
::= { virtualNwIfEntry 6 }
virtualNwIfRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this conceptual row. "
::= { virtualNwIfEntry 7 }
-- Notifications
virtualNwIfCreateEntryNotify NOTIFICATION-TYPE
OBJECTS { virtualNwIfIndex, ifName }
STATUS current
DESCRIPTION
"This notification is generated by the agent
whenever an virtual interface is created in the,
'virtualNwIfTable'. Note that this notification
is generated only when a new entry is added to the
table and not for any modifications to an existing
entry. "
::= { virtualNwIfNotifications 1 }
virtualNwIfDeleteEntryNotify NOTIFICATION-TYPE
OBJECTS { virtualNwIfIndex }
STATUS current
DESCRIPTION
"This notification is generated by the agent
whenever an virtual interface is deleted from the
'virtualNwIfTable'. "
::= { virtualNwIfNotifications 2 }
-- Conformance
virtualNwIfMIBCompliances
OBJECT IDENTIFIER ::= { virtualNwIfMIBConformance 1 }
virtualNwIfMIBGroups
OBJECT IDENTIFIER ::= { virtualNwIfMIBConformance 2 }
virtualNwIfMIBCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for entities which
implement the CISCO-VIRTUAL-NW-IF-MIB mib. "
MODULE MANDATORY-GROUPS { virtualNwIfGroup,
virtualNwIfNotificationGroup }
OBJECT virtualNwIfRowStatus
SYNTAX INTEGER {
active(1),
createAndGo(4),
destroy(6)}
DESCRIPTION
"Only three values 'createAndGo', 'destroy' and
'active' out of the six enumerated values need to
be supported. "
-- OBJECT virtualNwIfId
-- SYNTAX Unsigned32
-- DESCRIPTION
-- "If the virtualNwIfType is vsan(1), then this
-- object will have range as specified by VsanIndex
-- textual convention. "
::= { virtualNwIfMIBCompliances 1 }
-- Units of Conformance
virtualNwIfGroup OBJECT-GROUP
OBJECTS { virtualNwIfIndex, virtualNwIfFcId,
virtualNwIfOperStatusCause,
virtualNwIfOperStatusCauseDescr,
virtualNwIfRowStatus }
STATUS current
DESCRIPTION
"A collection of objects related to virtual interface
parameters. "
::= { virtualNwIfMIBGroups 1 }
virtualNwIfNotificationGroup NOTIFICATION-GROUP
NOTIFICATIONS { virtualNwIfCreateEntryNotify,
virtualNwIfDeleteEntryNotify }
STATUS current
DESCRIPTION
"A collection of notifications for monitoring virtual
interfaces. "
::= { virtualNwIfMIBGroups 2 }
END