mirror of
https://github.com/hsnodgrass/snmp_mib_archive.git
synced 2025-04-17 16:03:04 +00:00
321 lines
14 KiB
Plaintext
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
|