CISCO-CFS-MIB

        This MIB applies to one or more of a set of devices
which have connectivity through some kind of 'fabric'.
Many features which run in such an environment require
the exchange of information between the peer devices
which participate in providing the feature. An example
of the type of information exchanged is configuration
information. It would be advantageous to have the ability
to have configuration for a feature done on one device
and propagated to all other devices in the fabric.
Cisco Fabric Service (CFS) is a general mechanism for
data distribution within the fabric that could be used
by most features.
        
A feature supported in a device may or may not be CFS 
capable. In case a feature is CFS capable, the control
of the CFS operations are instrumented through this MIB.
        
A CFS capable feature can be enabled for data
distribution within the fabric by the user via SNMP.
When a CFS capable feature is enabled for data
distribution, CFS operations can then be performed for
that particular feature.
        
As part of the CFS configuration the first mandatory step
is to explicitly enable the feature for data distribution.
This enabling of distribution for a feature needs to be 
done for those devices in the fabric where the distribution
is intended. Following this mandatory step, feature specific
configurations can be instrumented in the respective MIBs.
        
Once a feature is enabled for data distribution, first
subsequent feature specific configuration SET operation
results in a snapshot of current 'Running Configuration'
of the feature, on the local device. This snapshot is used
for subsequent modifications by feature specific SET 
operations. Such modified configuration is referred to as
'Pending Configuration'. There can only be one 'Pending
Configuration' in the fabric. Additionally, such 'Pending
Configuration' can be maintained within the context of
additional scope, specific to the respective features.
The user who initiates the creation of the 'Pending
Configuration' is its owner. When a 'Pending Configuration'
for a feature exists in one of the devices of the fabric,
an attempt to create a 'Pending Configuration' for the same
feature and on a different device by way of feature specific
SET operation results in an error. This means feature 
specific SET operations intended for distribution can only
be performed on the device that has the 'Pending 
Configuration' with it. This ensures data consistency for
distribution.
        
Once the configuration of a feature is ready to be
distributed to all devices connected to the fabric, a
'commit' action performed on the local device overwrites
the local 'Running Configuration' and then distributes the
new  local 'Running Configuration' to all other devices in
the fabric. The successful 'commit' action also results into
destroying of the 'Pending Configuration' and makes the
feature available for new distribution. Any attempt to
perform 'commit' without any modification results in to an
error. The 'commit' action can only be performed by the
owner of the 'Pending Configuration'.
        
The 'Pending Configuration' can optionally be destroyed
without any distribution. This can be done by using either
'abort' or 'clear' action. The 'abort' action needs to
performed only on that device where the 'Pending
Configuration' exists and can only be performed by the owner
of the 'Pending Configuration'. The 'clear' action can be
initiated through any of the devices in the fabric. The
successful 'abort' or 'clear' operation makes the feature
available for new distribution.
        
The CFS, in addition to providing the basic distribution 
infrastructure to the CFS capable features in a stable
fabric, also provides infrastructure to handle data 
distribution when two stable fabrics merge.
        
This MIB module is to facilitate the global level control
(enabling/disabling) and actions (commit/abort/clear) over
the CFS capable features in the system.
        
Glossary of the terms used in this MIB:
--------------------------------------
        
VSAN                     - Virtual Storage Area Network, 
                           similar to a VLAN.
                                   
CFS feature Scope        - The scope of distribution.
                           The scope provides the context 
                           within which the CFS actions 
                           are performed on a CFS capable 
                           feature.
                                   
CFS Fabric Merge         - The merging of two stable fabrics.
                           The CFS provides infrastructure
                           to handle data distribution for 
                           CFS distribution enabled features
                           when the two stable fabrics merge.
        
CFS control and actions : 
        
CFS Distribution Enable  - This is to enable data distribution
                           for CFS capable feature.
                                   
CFS Distribution Disable - This is to disable data 
                           distribution for CFS capable 
                           feature.
                                   
CFS Commit               - This is to commit the 'Pending 
                           Configuration' on the local device.
                           This action triggers the 
                           distribution of the 'Pending 
                           Configuration' to all the devices
                           in the fabric.
                                   
CFS Abort                - This is to Destroy the 'Pending 
                           Configuration' on the local device
                           without any distribution. Once 
                           local 'Pending Configuration' is
                           destroyed, creation of 'Pending
                           Configuration' in the local or any
                           other device connected to the 
                           fabric is allowed. 
                                   
CFS Clear                - This is to Destroy the 'Pending 
                           Configuration' that exists in any
                           of the device in the fabric. Once
                           'Pending Configuration' that exists
                           with one of the devices in the
                           fabric is destroyed, creation of
                           'Pending Configuration' in the 
                           local or any other device connected
                           to the fabric is allowed.
    
Source file
CISCO-CFS-MIB
Last revised
Identity
ciscoCFSMIB
Base OID
1.3.6.1.4.1.9.9.433
Imported Objects
CISCO-SMI ciscoMgmt
INET-ADDRESS-MIB InetAddress InetAddressType
SNMP-FRAMEWORK-MIB SnmpAdminString
SNMPv2-CONF MODULE-COMPLIANCE (no object page) NOTIFICATION-GROUP (no object page) OBJECT-GROUP (no object page)
SNMPv2-SMI MODULE-IDENTITY (no object page) NOTIFICATION-TYPE (no object page) OBJECT-TYPE (no object page)
SNMPv2-TC TEXTUAL-CONVENTION (no object page) TimeStamp
Net-SNMP examples using the cisco MIB directory Show commands

These commands use the standard Observium installation path and load the selected MIB variant before the RFC and Net-SNMP directories.

Translate the module identity
/usr/bin/snmptranslate -Pud -Ir -On -m 'CISCO-CFS-MIB' -M '/opt/observium/mibs/cisco:/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'CISCO-CFS-MIB::ciscoCFSMIB'
Walk the MIB subtree
/usr/bin/snmpbulkwalk -v2c -c '<community>' -Pud -Ir -OQUs -m 'CISCO-CFS-MIB' -M '/opt/observium/mibs/cisco:/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'udp:<hostname>:161' 'CISCO-CFS-MIB::ciscoCFSMIB'
How SNMP, Net-SNMP, MIB paths, and variants work
Objects (75)
.1.3.6.1.4.1.9.9.433
.1.3.6.1.4.1.9.9.433.0
.1.3.6.1.4.1.9.9.433.1
.1.3.6.1.4.1.9.9.433.1.1
.1.3.6.1.4.1.9.9.433.1.1.1
.1.3.6.1.4.1.9.9.433.1.1.1.1
OctetString
.1.3.6.1.4.1.9.9.433.1.1.1.1.1
cfsFeatureOpShowCfgOption deprecated r/w
Enumeration
.1.3.6.1.4.1.9.9.433.1.1.1.1.10
.1.3.6.1.4.1.9.9.433.1.1.1.1.11
Bits
.1.3.6.1.4.1.9.9.433.1.1.1.1.12
.1.3.6.1.4.1.9.9.433.1.1.1.1.2
.1.3.6.1.4.1.9.9.433.1.1.1.1.3
OctetString
.1.3.6.1.4.1.9.9.433.1.1.1.1.4
.1.3.6.1.4.1.9.9.433.1.1.1.1.5
.1.3.6.1.4.1.9.9.433.1.1.1.1.6
OctetString
.1.3.6.1.4.1.9.9.433.1.1.1.1.7
.1.3.6.1.4.1.9.9.433.1.1.1.1.8
.1.3.6.1.4.1.9.9.433.1.1.1.1.9
.1.3.6.1.4.1.9.9.433.1.1.2
.1.3.6.1.4.1.9.9.433.1.1.2.1
.1.3.6.1.4.1.9.9.433.1.1.2.1.1
OctetString
.1.3.6.1.4.1.9.9.433.1.1.2.1.2
.1.3.6.1.4.1.9.9.433.1.1.2.1.3
.1.3.6.1.4.1.9.9.433.1.1.2.1.4
Bits
.1.3.6.1.4.1.9.9.433.1.1.2.1.5
.1.3.6.1.4.1.9.9.433.1.1.2.1.6
.1.3.6.1.4.1.9.9.433.1.1.3
.1.3.6.1.4.1.9.9.433.1.1.3.1
.1.3.6.1.4.1.9.9.433.1.1.3.1.1
OctetString
.1.3.6.1.4.1.9.9.433.1.1.3.1.2
Enumeration
.1.3.6.1.4.1.9.9.433.1.1.3.1.3
.1.3.6.1.4.1.9.9.433.1.1.4
.1.3.6.1.4.1.9.9.433.1.1.4.1
.1.3.6.1.4.1.9.9.433.1.1.4.1.1
OctetString
.1.3.6.1.4.1.9.9.433.1.1.4.1.2
Enumeration
.1.3.6.1.4.1.9.9.433.1.1.4.1.3
Enumeration
.1.3.6.1.4.1.9.9.433.1.1.4.1.4
.1.3.6.1.4.1.9.9.433.1.1.5
.1.3.6.1.4.1.9.9.433.1.1.5.1
.1.3.6.1.4.1.9.9.433.1.1.5.1.1
OctetString
.1.3.6.1.4.1.9.9.433.1.1.5.1.2
.1.3.6.1.4.1.9.9.433.1.1.6
.1.3.6.1.4.1.9.9.433.1.1.6.1
.1.3.6.1.4.1.9.9.433.1.1.6.1.1
OctetString
.1.3.6.1.4.1.9.9.433.1.1.6.1.2
.1.3.6.1.4.1.9.9.433.1.1.6.1.3
OctetString
.1.3.6.1.4.1.9.9.433.1.1.6.1.4
.1.3.6.1.4.1.9.9.433.1.1.7
.1.3.6.1.4.1.9.9.433.1.1.7.1
.1.3.6.1.4.1.9.9.433.1.1.7.1.1
OctetString
.1.3.6.1.4.1.9.9.433.1.1.7.1.2
.1.3.6.1.4.1.9.9.433.1.1.7.1.3
.1.3.6.1.4.1.9.9.433.1.1.7.1.4
.1.3.6.1.4.1.9.9.433.1.1.7.1.5
Enumeration
.1.3.6.1.4.1.9.9.433.1.1.7.1.6
.1.3.6.1.4.1.9.9.433.1.1.7.1.7
.1.3.6.1.4.1.9.9.433.1.2
OctetString
.1.3.6.1.4.1.9.9.433.1.2.1
.1.3.6.1.4.1.9.9.433.1.2.2
OctetString
.1.3.6.1.4.1.9.9.433.1.2.3
.1.3.6.1.4.1.9.9.433.1.2.4
.1.3.6.1.4.1.9.9.433.1.3
Enumeration
.1.3.6.1.4.1.9.9.433.1.3.1
Enumeration
.1.3.6.1.4.1.9.9.433.1.3.2
.1.3.6.1.4.1.9.9.433.1.3.3
.1.3.6.1.4.1.9.9.433.1.4
Enumeration
.1.3.6.1.4.1.9.9.433.1.4.1
.1.3.6.1.4.1.9.9.433.1.4.2
.1.3.6.1.4.1.9.9.433.1.4.2.1
.1.3.6.1.4.1.9.9.433.1.4.2.1.1
.1.3.6.1.4.1.9.9.433.1.4.2.1.2
Enumeration
.1.3.6.1.4.1.9.9.433.1.4.2.1.3
.1.3.6.1.4.1.9.9.433.2
.1.3.6.1.4.1.9.9.433.2.1
.1.3.6.1.4.1.9.9.433.2.2
Dependencies (6) 6 direct Show tree and compile order Hide dependency details

Each imported module is resolved in the importing module's source directory first, then through the normal default-variant rules.

Dependency tree
Dependency-first compile order
  1. SNMPv2-SMIrfc
  2. CISCO-SMIcisco
  3. SNMPv2-TCrfc
  4. INET-ADDRESS-MIBrfc
  5. SNMPv2-CONFrfc
  6. SNMP-FRAMEWORK-MIBrfc
  7. CISCO-CFS-MIBciscoselected
Type Definitions (5)
Enumeration
noop(1)
enable(2)
disable(3)
commit(4)
abort(5)
clear(6)
Enumeration
none(1)
success(2)
failed(3)
inProgress(4)
partialSuccess(5)
Enumeration
unknown(1)
enabled(2)
disabled(3)
Enumeration
none(1)
vsanID(2)
OctetString range: 0..255
Conformance Groups (13)
A collection of objects for configurations of the CFS capable
features.
.1.3.6.1.4.1.9.9.433.2.2.1
A collection of objects for the 'Pending Configuration'
owner details of the CFS capable features.
.1.3.6.1.4.1.9.9.433.2.2.2
A collection of objects required for CFS notifications.
.1.3.6.1.4.1.9.9.433.2.2.3
A collection of notifications for the CFS actions on the
CFS capable features.
.1.3.6.1.4.1.9.9.433.2.2.4
A collection of notifications for CFS fabric merge
failures.
.1.3.6.1.4.1.9.9.433.2.2.5
A collection of objects for discovering list of devices in
the fabric.
.1.3.6.1.4.1.9.9.433.2.2.6
A collection of objects for CFS action results.
.1.3.6.1.4.1.9.9.433.2.2.7
A collection of notifications for CFS peer discovery.
.1.3.6.1.4.1.9.9.433.2.2.8
A collection of objects for configurations of the CFS capable
features.
.1.3.6.1.4.1.9.9.433.2.2.9
A collection of objects for controlling the distribution
capabilities of CFS.
.1.3.6.1.4.1.9.9.433.2.2.10
A collection of objects for controlling the per Internet
address type distribution capabilities of CFS.
.1.3.6.1.4.1.9.9.433.2.2.11
A collection of objects for configurations of the CFS capable
features.
.1.3.6.1.4.1.9.9.433.2.2.12
A collection of objects for CFS action results.
.1.3.6.1.4.1.9.9.433.2.2.13
Compliance Statements (4)

OID .1.3.6.1.4.1.9.9.433.2.1.1
The compliance statement for entities which implement the
CISCO-CFS-MIB.
Required groups
mandatory cfsFeatureOpGroup
mandatory cfsPendingConfOwnerGroup
mandatory cfsFeatureActionNotifGroup
optional cfsFeatureNotifObjectsGroup This group is conditionally mandatory and must be
implemented by the agent of the managed entity only
if the CFS implementation on the managed entity
supports notifications as defined in the
'cfsMergeFailNotifGroup'.
optional cfsMergeFailNotifGroup This group is conditionally mandatory and must be
implemented by the agent of the managed entity only
if the CFS implementation on the managed entity
supports fabric merge.

OID .1.3.6.1.4.1.9.9.433.2.1.2
The compliance statement for entities which implement the
CISCO-CFS-MIB.
Required groups
mandatory cfsFeatureOpGroupRev1
mandatory cfsPendingConfOwnerGroup
mandatory cfsFeatureActionNotifGroup
mandatory cfsMembersGroup
mandatory cfsPeerDiscoveryNotifGroup
mandatory cfsFeatureOpExtGroup
optional cfsFeatureNotifObjectsGroup This group is conditionally mandatory and must be
implemented by the agent of the managed entity only
if the CFS implementation on the managed entity
supports notifications as defined in the
'cfsMergeFailNotifGroup'.
optional cfsMergeFailNotifGroup This group is conditionally mandatory and must be
implemented by the agent of the managed entity only
if the CFS implementation on the managed entity
supports fabric merge.
optional cfsDistCtrlGroup This group is conditionally mandatory and must be
implemented by the agent of the managed entity only
if the CFS implementation on the managed entity
supports CFS distribution control.

OID .1.3.6.1.4.1.9.9.433.2.1.3
The compliance statement for entities which implement the
CISCO-CFS-MIB.
Required groups
mandatory cfsFeatureOpGroupRev2
mandatory cfsPendingConfOwnerGroup
mandatory cfsFeatureActionNotifGroup
mandatory cfsMembersGroup
mandatory cfsPeerDiscoveryNotifGroup
mandatory cfsFeatureOpExtGroup
optional cfsFeatureNotifObjectsGroup This group is conditionally mandatory and must be
implemented by the agent of the managed entity only
if the CFS implementation on the managed entity
supports notifications as defined in the
'cfsMergeFailNotifGroup'.
optional cfsMergeFailNotifGroup This group is conditionally mandatory and must be
implemented by the agent of the managed entity only
if the CFS implementation on the managed entity
supports fabric merge.
optional cfsDistCtrlGroup This group is conditionally mandatory and must be
implemented by the agent of the managed entity only
if the CFS implementation on the managed entity
supports CFS distribution control.
optional cfsDistCtrlInetGroup This group is conditionally mandatory and must be
implemented by the agent of the managed entity only
if the CFS implementation on the managed entity
supports per Internet address type CFS distribution
control.

OID .1.3.6.1.4.1.9.9.433.2.1.4
The compliance statement for entities which implement the
CISCO-CFS-MIB.
Required groups
mandatory cfsFeatureOpGroupRev2
mandatory cfsPendingConfOwnerGroup
mandatory cfsFeatureActionNotifGroup
mandatory cfsMembersGroup
mandatory cfsPeerDiscoveryNotifGroup
mandatory cfsFeatureOpExtGroupRev1
optional cfsFeatureNotifObjectsGroup This group is conditionally mandatory and must be
implemented by the agent of the managed entity only
if the CFS implementation on the managed entity
supports notifications as defined in the
'cfsMergeFailNotifGroup'.
optional cfsMergeFailNotifGroup This group is conditionally mandatory and must be
implemented by the agent of the managed entity only
if the CFS implementation on the managed entity
supports fabric merge.
optional cfsDistCtrlGroup This group is conditionally mandatory and must be
implemented by the agent of the managed entity only
if the CFS implementation on the managed entity
supports CFS distribution control.
optional cfsDistCtrlInetGroup This group is conditionally mandatory and must be
implemented by the agent of the managed entity only
if the CFS implementation on the managed entity
supports per Internet address type CFS distribution
control.
Notifications / Traps (3)
NameOIDDescription
.1.3.6.1.4.1.9.9.433.0.1
Notification to covey the information of the action
performed on a CFS capable feature.

This notification gets generated when :

- a CFS operation action is triggered on CFS capable
feature

- the result of last action performed on the CFS
capable feature changes.

The 'cfsFeatureOpLastActionResult' indicates the new
value of the last action result performed on the feature.
.1.3.6.1.4.1.9.9.433.0.2
Notification to convey the information of the 'Merge
Failure' occurred in the fabric. This notification gets
generated when the merge of the two fabrics fail for a
CFS capable feature.
.1.3.6.1.4.1.9.9.433.0.3
Notification to indicate that the CFS has completed
discovering the CFS capable devices in the fabric.

If the value of cfsPeersDiscoveryResult is 'successful',
then the cfsPeersTable is appropriately populated.