All MIBs › CISCO-PREFERRED-PATH-MIB
Organization: Cisco Systems Inc.
Last Updated: 2006-10-26
Category: Cisco Devices, IP and Core Protocols, Routing Protocols
Description: Manages preferred path routing policies directing traffic over specific WAN links on Cisco routers.
Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.
What Is CISCO-PREFERRED-PATH-MIB?
CISCO-PREFERRED-PATH-MIB is a Cisco-proprietary MIB for managing "preferred path" routing policy on Cisco storage/SAN switching platforms (e.g., MDS series), letting administrators direct traffic over selected paths rather than the shortest path chosen by protocols like FSPF. It exposes route-map style configuration tables that bind preferred-path rules to a VSAN and route index, along with global activation controls and row-status-driven provisioning, plus notifications for path-related events. Its monitoring value is configuration/software-status focused: confirming which preferred-path route-map entries are active, whether strict interface preference is enforced, and whether the global preferred-path feature is enabled. It depends on Fibre Channel routing concepts (FSPF, VSANs) and the general Cisco MIB row-status/storage-type conventions (RFC 2579-style TEXTUAL-CONVENTIONs). It is deployed in Cisco MDS Fibre Channel SAN environments where administrators need deterministic path control distinct from default FSPF routing. Engineers can download the CISCO-PREFERRED-PATH-MIB file directly to load it into their MIB browser.
IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-PREFERRED-PATH-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.
Supported Devices
- Cisco MDS Fibre Channel SAN switches
Monitoring Examples
An administrator would poll cPrefPathRouteMapTable/cPrefPathRouteMapEntry, keyed by cPrefPathRouteMapVsanIndex and cPrefPathRouteMapRouteIndex, checking cPrefPathRouteMapRouteActive and cPrefPathRouteMapActive to confirm which preferred-path rule is currently in effect for a given VSAN. If cPrefPathRouteMapIntfPrefStrict is set but traffic is still taking an unexpected path, the admin would check cPrefPathRouteMapGlobalTable's cPrefPathRouteMapGlobalActive to verify the feature is globally enabled. The ciscoPrefPathMIBNotifs group would alert when a route-map entry's status changes unexpectedly.
What Can Be Monitored
- preferred-path route-map activation state per VSAN
- strict interface preference setting
- global preferred-path feature enablement
- route index configuration
This MIB depends on
Related MIBs
Imported Objects
From CISCO-SMI
| ciscoMgmt | OBJECT-IDENTITY |
From CISCO-ST-TC
| FcAddressId | |
| VsanIndex |
From CISCO-VSAN-MIB
| notifyVsanIndex | OBJECT-TYPE |
From IF-MIB
| InterfaceIndex | |
| InterfaceIndexOrZero |
From SNMPv2-CONF
| MODULE-COMPLIANCE | |
| NOTIFICATION-GROUP | |
| OBJECT-GROUP |
From SNMPv2-SMI
| MODULE-IDENTITY | |
| NOTIFICATION-TYPE | |
| OBJECT-TYPE | |
| Unsigned32 |
From SNMPv2-TC
| RowStatus | |
| StorageType | |
| TEXTUAL-CONVENTION | |
| TruthValue |
OIDs
| OID symbolic | OID numeric | Type | Access | Description |
|---|---|---|---|---|
| ciscoPrefPathMIB | 1.3.6.1.4.1.9.9.592 | The MIB module for the management of preferred path. This MIB enables managers to configure and monitor Preferred Path parameters. Preferred path provides a method of routing traffic over the selected paths, not necessarily the preferred shortest path as chosen by routing protocols such as FSPF. This kind of control allows users to choose shortest paths based on characteristics, such as frames received on a selected interface or frames with selected source FC-ID. This feature allows users to ensure paths seperation between switches for different traffic between a host and a target. Glossary: FC-ID - Fibre Channel Identifier. VSAN - Virtual Storage Area Network. fcroute - Fibre Channel route to host or target. FSPF - Fibre Shortest Path First. IVR - Inter-VSAN Routing. | ||
| ciscoPrefPathMIBNotifs | 1.3.6.1.4.1.9.9.592.0 | |||
| NTF ciscoPrefPathHWFailureNotify | 1.3.6.1.4.1.9.9.592.0.1 | This notification is generated whenever the local device encounters some hardware failures during programming of local preferred path configuration. | ||
| ciscoPrefPathMIBObjects | 1.3.6.1.4.1.9.9.592.1 | |||
| ciscoPrefPathConfiguration | 1.3.6.1.4.1.9.9.592.1.1 | |||
| cPrefPathRouteMapTable | 1.3.6.1.4.1.9.9.592.1.1.1 | not-accessible | This table allows users to configure and monitor the preferred path fcroute-map parameters on all the VSANs configured on the local switch. A fcroute-map can be created per VSAN. For each fcroute-map users can create multiple routes which are identified by a route ID. Within each route there can be multiple flows which are configured using the cPrefPathRouteMapMatchTable table and the corresponding outgoing interface for a route can be configured using the cPrefPathRouteMapSetTable table. This table is the top-level table which is used to configure the fcroute-map indexed by VSAN ID and a route within a fcroute-map indexed by the route ID of the route. Entries in this table are created and deleted using the cPrefPathRouteMapRowStatus object. To create a row in this table, a manager must set the cPrefPathRouteMapRowStatus object to 'createAndGo' or 'createAndWait'. This will create a route within a fcroute-map. There is no need to configure instances of other corresponding columns - cPrefPathRouteMapIntfPrefStrict, cPrefPathRouteMapRouteActive, cPrefPathRouteMapActive in order to make the newly created row to active. To delete a row in this table, a manager must set the cPrefPathRouteMapRowStatus object to 'destroy'. This will delete a route within a fcroute-map. | |
| cPrefPathRouteMapEntry | 1.3.6.1.4.1.9.9.592.1.1.1.1 | not-accessible | A conceptual row in the cPrefPathRouteMapTable. There is an entry in this table for each route within a fcroute-map. | |
| VSA cPrefPathRouteMapVsanIndex | 1.3.6.1.4.1.9.9.592.1.1.1.1.1 | VsanIndex | not-accessible | The VSAN ID of this fcroute-map. |
| U32 cPrefPathRouteMapRouteIndex | 1.3.6.1.4.1.9.9.592.1.1.1.1.2 | Unsigned32 | not-accessible | An arbitrary integer value which identifies a route in this fcroute-map. |
| T/F cPrefPathRouteMapIntfPrefStrict | 1.3.6.1.4.1.9.9.592.1.1.1.1.3 | TruthValue | read-create | This object allows to change the way the preferred path selection logic would select the preferred path. Setting this object to 'true' will make the preferred path to select the outgoing interface strictly based on the preference set using the cPrefPathRMapSetIntfPref. When this object is set to 'false', then the preferred path selection logic will perform selection only when the current outgoing interface goes down. |
| T/F cPrefPathRouteMapRouteActive | 1.3.6.1.4.1.9.9.592.1.1.1.1.4 | TruthValue | read-create | This object allows to activate/de-activate the route within a fcroute-map. If value of this object is set to 'true', then route will be activated. If set to 'false', then the route will be de-activated. After the route is activated, any incremental updates or changes made to the match or set criteria would require this object to be set to 'true' again (re-activation). |
| T/F cPrefPathRouteMapActive | 1.3.6.1.4.1.9.9.592.1.1.1.1.5 | TruthValue | read-create | This object allows to activate/de-activate all the routes within a fcroute-map. If value of this object is set to 'true', then all the routes within this fcroute-map will be activated. If set to 'false', then all routes within this fcroute-map will be de-activated. After the fcroute-map is activated, any incremental updates or changes made to the match or set criteria would require this object to be set to 'true' again (re-activation). |
| STO cPrefPathRouteMapStorageType | 1.3.6.1.4.1.9.9.592.1.1.1.1.6 | StorageType | read-create | The storage type for this conceptual row. Conceptual rows having the value 'permanent' need not allow write-access to any columnar objects in the row. |
| ROW cPrefPathRouteMapRowStatus | 1.3.6.1.4.1.9.9.592.1.1.1.1.7 | RowStatus | read-create | The status of this conceptual row. There is no need to configure instances of other corresponding columnar objects in order to make the newly created row to active. Instances of all other corresponding columns can be modified for an active row. |
| cPrefPathRouteMapGlobalTable | 1.3.6.1.4.1.9.9.592.1.1.2 | not-accessible | This table allows users to configure and monitor the preferred path fcroute-map global parameters. Entries in this table are automatically created when the first route in a fcroute-map is created using the cPrefPathRouteMapTable table. An entry is deleted automatically from this table if either: - The last route in a fcroute-map is removed using the cPrefPathRouteMapTable table. or - The corresponding VSAN is deleted using the vsanTable table (Defined in CISCO-VSAN-MIB). | |
| cPrefPathRouteMapGlobalEntry | 1.3.6.1.4.1.9.9.592.1.1.2.1 | not-accessible | A row in the cPrefPathRouteMapGlobalTable table. There is an entry in this table for each fcroute-map created. | |
| INT cPrefPathRouteMapGlobalActive | 1.3.6.1.4.1.9.9.592.1.1.2.1.1 | INTEGER | read-write | This object allows to activate/de-activate all the routes within a fcroute-map. This object is read-write for the values of 'all' and 'none', but cannot be set to 'partial'. If this object is set to 'all', then all the routes within this fcroute-map will be activated. If this object is set to 'none', then all routes within this fcroute-map will be de-activated. The value of 'partial' indicates that not all of the routes within this fcroute-map are active. This happens when some of the routes within this fcroute-map is de-activated by using cPrefPathRouteMapRouteActive object. After the fcroute-map is activated, any incremental updates or changes made to the match or set criteria would require this object to be set to 'all' again (re-activation). |
| cPrefPathRouteMapMatchTable | 1.3.6.1.4.1.9.9.592.1.1.3 | not-accessible | This table allows to configure and monitor the match criteria for a route within a fcroute-map created using the cPrefPathRouteMapTable table. Each match criteria allows user to classify a traffic flow based on the the incoming frame's source FC-ID and destination FC-ID match. Each entry in this table is indexed by the - cPrefPathRouteMapVsanIndex - cPrefPathRouteMapRouteIndex - cPrefPathRMapMatchSrcAddr - cPrefPathRMapMatchSrcAddrMask - cPrefPathRMapMatchSrcIntf - cPrefPathRMapMatchDstAddr - cPrefPathRMapMatchDstAddrMask Note that any changes or updates made to the match criteria would require the corresponding route or the corresponding fcroute-map to be activated again. Entries in this table are created and deleted using the cPrefPathRMapMatchRowStatus object. To create a row in this table, a manager must set the cPrefPathRMapMatchRowStatus object to 'createAndGo' or 'createAndWait'. This will create a match criteria for a route within a fcroute-map. To delete a row in this table, a manager must set the cPrefPathRMapMatchRowStatus object to 'destroy'. This table is dependent on cPrefPathRouteMapTable table. The association between this table and cPrefPathRouteMapTable table is through the common indices - cPrefPathRouteMapRouteIndex and cPrefPathRouteMapVsanIndex. All the entries in this table with the indices - cPrefPathRouteMapVsanIndex and cPrefPathRouteMapRouteIndex is in fact the match criteria or the flows associated with the route within a fcroute-map for a VSAN, which are created and activated using the cPrefPathRouteMapTable table. When the row corresponding to indices - cPrefPathRouteMapVsanIndex and cPrefPathRouteMapRouteIndex in the cPrefPathRouteMapTable is destroyed then all the rows in this table with those indices will be destroyed. | |
| cPrefPathRouteMapMatchEntry | 1.3.6.1.4.1.9.9.592.1.1.3.1 | not-accessible | An entry (conceptual row) in this table. There is an entry in this table for each match criteria of a route within a fcroute-map. | |
| ADR cPrefPathRMapMatchSrcAddr | 1.3.6.1.4.1.9.9.592.1.1.3.1.1 | FcAddressId | not-accessible | The FC-ID which need to be matched with source address in a frame for the flow classification. |
| CIS cPrefPathRMapMatchSrcAddrMask | 1.3.6.1.4.1.9.9.592.1.1.3.1.2 | CiscoPrefPathFcAddrMask | not-accessible | This object represents the mask associated with the source address represented by cPrefPathRMapMatchSrcAddr. The value of this object is meaningful only if the corresponding instance of cPrefPathRMapMatchSrcAddr contains a valid FC-ID. |
| NUM cPrefPathRMapMatchSrcIntf | 1.3.6.1.4.1.9.9.592.1.1.3.1.3 | InterfaceIndexOrZero | not-accessible | This object represents an interface on the local device on which a frame should arrive for flow classification. The value of 0 indicates that source interface match is not selected. |
| ADR cPrefPathRMapMatchDstAddr | 1.3.6.1.4.1.9.9.592.1.1.3.1.4 | FcAddressId | not-accessible | The FC-ID which need to be matched with destination address in a frame for flow classification. |
| CIS cPrefPathRMapMatchDstAddrMask | 1.3.6.1.4.1.9.9.592.1.1.3.1.5 | CiscoPrefPathFcAddrMask | not-accessible | This object represents the mask associated with the destination address represented by cPrefPathRMapMatchDstAddr. The value of this object is meaningful only if the corresponding instance of cPrefPathRMapMatchDstAddr contains a valid FC-ID. |
| ROW cPrefPathRMapMatchRowStatus | 1.3.6.1.4.1.9.9.592.1.1.3.1.6 | RowStatus | read-create | The status of this conceptual row. There is no need to configure instances of other corresponding columnar objects in order to make the newly created row to active. Instances of all other corresponding columns can be modified for an active row. |
| cPrefPathRouteMapSetTable | 1.3.6.1.4.1.9.9.592.1.1.4 | not-accessible | This table allows to configure and monitor the set criteria for a route within a fcroute-map created using the cPrefPathRouteMapTable table. Each set criteria allows user to setup an action on the classified or matched traffic flow created using the cPrefPathRouteMapMatchTable table. Each set criteria allows user to setup an outgoing interface, and associate it with a preference level. Preference level indicates the priority of the interface during the selection in case multiple outgoing interfaces are configured. Match criteria configured using the cPrefPathRouteMapMatchTable table for a route within a fcroute-map and the set criteria (this table) configured for the same route within a fcroute-map go together as (match, set) pair. Which means that those matched traffic flows will be forwarded or routed via the interface selected based on the preference level in the set criteria (this table). Each entry in this table is indexed by the - cPrefPathRouteMapVsanIndex - cPrefPathRouteMapRouteIndex - cPrefPathRMapSetIntfPref Note any changes or updates made to the set criteria would require the corresponding route or the corresponding fcroute-map to be activated again. Entries in this table are created and deleted using the cPrefPathRMapSetRowStatus object. To create a row in this table, a manager must set the cPrefPathRMapSetRowStatus object to 'createAndGo' or 'createAndWait'. This will create a set criteria for a route within a fcroute-map. It is required to configure instances of cPrefPathRMapSetIntf column before or concurrently in order to make the newly created row to active. To delete a row in this table, a manager must set the cPrefPathRMapSetRowStatus object to 'destroy'. This table is dependent on cPrefPathRouteMapTable table. The association between this table and the cPrefPathRouteMapTable table is through the common indices - cPrefPathRouteMapVsanIndex and cPrefPathRouteMapVsanIndex. All the entries in this table with the indices - cPrefPathRouteMapVsanIndex and cPrefPathRouteMapRouteIndex is in fact the set criteria associated with the route within a fcroute-map, which are created and activated in the cPrefPathRouteMapTable Table. When the row corresponding to indices - cPrefPathRouteMapVsanIndex and cPrefPathRouteMapRouteIndex in the cPrefPathRouteMapTable is destroyed then all the rows in this table with those indices will be destroyed. | |
| cPrefPathRouteMapSetEntry | 1.3.6.1.4.1.9.9.592.1.1.4.1 | not-accessible | An entry (conceptual row) in this table. There is an entry in this table for each set criteria of a route within a fcroute-map. | |
| CIS cPrefPathRMapSetIntfPref | 1.3.6.1.4.1.9.9.592.1.1.4.1.1 | CiscoPrefPathPreferenceLevel | not-accessible | Preference level, which indicates the metric or cost, associated with the cPrefPathRMapSetIntf outgoing interface. The lower the number the higher the preference. |
| NUM cPrefPathRMapSetIntf | 1.3.6.1.4.1.9.9.592.1.1.4.1.2 | InterfaceIndex | read-create | This object represents an interface on the local device on which the matched or classified frame will be forwarded. |
| CIS cPrefPathRMapSetIvrNextHopVsanId | 1.3.6.1.4.1.9.9.592.1.1.4.1.3 | CiscoPrefPathIvrNextHopVsanId | read-create | This object represents the IVR next hop VSAN ID. |
| ROW cPrefPathRMapSetRowStatus | 1.3.6.1.4.1.9.9.592.1.1.4.1.4 | RowStatus | read-create | The status of this conceptual row. It is required to configure instances of cPrefPathRMapSetIntf column before or concurrently in order to make the newly created row to active. Instances of all other corresponding columns can be modified for an active row. |
| T/F cPrefPathHwFailureNotifEnable | 1.3.6.1.4.1.9.9.592.1.1.5 | TruthValue | read-write | This variable indicates whether the system produces the ciscoPrefPathHWFailureNotify. A 'false' value for this object will prevent ciscoPrefPathHWFailureNotify notification being generated by the device. |
| ciscoPrefPathInformation | 1.3.6.1.4.1.9.9.592.1.2 | |||
| cPrefPathRouteMapInfoTable | 1.3.6.1.4.1.9.9.592.1.2.1 | not-accessible | This table contains information of the 'preferred path' that is currently active and selected for a route within a fcroute-map. The 'preferred path' is the selected preference level, and its associated interface which will be the outgoing interface for traffic that are classified using the match criteria in that particular indexed fcroute-map route. Each entry in this table is indexed by - cPrefPathRouteMapVsanIndex - cPrefPathRouteMapRouteIndex For each route in a fcroute-map, preferred path selects a preference level (the lower the number the higher the preference) per VSAN based on link status of interface associated with the preference level. This table contains the information of the selected preference level. | |
| cPrefPathRouteMapInfoEntry | 1.3.6.1.4.1.9.9.592.1.2.1.1 | not-accessible | An entry which contains information about the preferred path of a route within a fcroute-map. | |
| CIS cPrefPathRMapSelectedPref | 1.3.6.1.4.1.9.9.592.1.2.1.1.1 | CiscoPrefPathPreferenceLevel | read-only | The selected preference level. |
| NUM cPrefPathRMapSelectedIntf | 1.3.6.1.4.1.9.9.592.1.2.1.1.2 | InterfaceIndex | read-only | This object represents an interface on the local device which is selected to forward the classified or matched flow. |
| CIS cPrefPathRMapSelIvrNextHopVsanId | 1.3.6.1.4.1.9.9.592.1.2.1.1.3 | CiscoPrefPathIvrNextHopVsanId | read-only | This object represents the IVR next hop VSAN ID. |
| cPrefPathRouteMapMatchInfoTable | 1.3.6.1.4.1.9.9.592.1.2.2 | not-accessible | This table allows to monitor the status of the the match criteria of the route within a fcroute-map that are activated using the cPrefPathRouteMapGlobalActive or cPrefPathRouteMapRouteActive objects. Each match criteria entry in this table is indexed by - cPrefPathRouteMapVsanIndex - cPrefPathRouteMapRouteIndex - cPrefPathRMapMatchSrcAddr - cPrefPathRMapMatchSrcAddrMask - cPrefPathRMapMatchSrcIntf - cPrefPathRMapMatchDstAddr - cPrefPathRMapMatchDstAddrMask | |
| cPrefPathRouteMapMatchInfoEntry | 1.3.6.1.4.1.9.9.592.1.2.2.1 | not-accessible | An entry which contains information about the match criteria of an 'active' route within a fcroute-map. | |
| CIS cPrefPathRMapMatchStatus | 1.3.6.1.4.1.9.9.592.1.2.2.1.1 | CiscoPrefPathStatus | read-only | The status of the indexed match entry. |
| cPrefPathRouteMapSetInfoTable | 1.3.6.1.4.1.9.9.592.1.2.3 | not-accessible | This table allows to monitor the status of the the set criteria of the route within a fcroute-map that are activated using the cPrefPathRouteMapGlobalActive or cPrefPathRouteMapRouteActive objects. Each entry in this table is indexed by - cPrefPathRouteMapVsanIndex - cPrefPathRouteMapRouteIndex - cPrefPathRMapSetIntfPref. | |
| cPrefPathRouteMapSetInfoEntry | 1.3.6.1.4.1.9.9.592.1.2.3.1 | not-accessible | An entry which contains information about the set criteria of an 'active' route within a fcroute-map. | |
| NUM cPrefPathRouteMapSetInfoIntf | 1.3.6.1.4.1.9.9.592.1.2.3.1.1 | InterfaceIndex | read-only | This object represents an interface on the local device on which the matched or classified frame will be forwarded. |
| CIS cPrefPathRouteMapSetInfoIvrNextHopVId | 1.3.6.1.4.1.9.9.592.1.2.3.1.2 | CiscoPrefPathIvrNextHopVsanId | read-only | This object represents the IVR next hop VSAN ID. |
| CIS cPrefPathRouteMapSetStatus | 1.3.6.1.4.1.9.9.592.1.2.3.1.3 | CiscoPrefPathStatus | read-only | The status of the indexed set entry. |
| ciscoPrefPathMIBConform | 1.3.6.1.4.1.9.9.592.2 | |||
| ciscoPrefPathMIBCompliances | 1.3.6.1.4.1.9.9.592.2.1 | |||
| ciscoPrefPathMIBCompliance | 1.3.6.1.4.1.9.9.592.2.1.1 | The compliance statement for entities which implement the CISCO-PREFERRED-PATH-MIB. | ||
| ciscoPrefPathMIBComplianceRev1 | 1.3.6.1.4.1.9.9.592.2.1.2 | The compliance statement for entities which implement the CISCO-PREFERRED-PATH-MIB. | ||
| ciscoPrefPathMIBGroups | 1.3.6.1.4.1.9.9.592.2.2 | |||
| ciscoPrefPathConfigGroup | 1.3.6.1.4.1.9.9.592.2.2.1 | A collection of objects for configuring and displaying Preferred Path parameters. | ||
| ciscoPrefPathInfoGroup | 1.3.6.1.4.1.9.9.592.2.2.2 | A collection of objects for providing information for preferred path notifications. | ||
| ciscoPrefPathNotifyGroup | 1.3.6.1.4.1.9.9.592.2.2.3 | A collection of notifications for monitoring failure in configuring Preferred Path parameters on the local device. | ||
| ciscoPrefPathNotifyConfigGroup | 1.3.6.1.4.1.9.9.592.2.2.4 | A collection of objects for displaying and configuring preferred path notifications. | ||
| ciscoPrefPathConfigGroupRev1 | 1.3.6.1.4.1.9.9.592.2.2.5 | A collection of objects for configuring and displaying Preferred Path parameters. |
RFC description
Cisco MIB module enabling management of Preferred Path parameters for Fibre Channel networks, allowing granular control over traffic routing between switches independent of standard shortest-path routing protocols.
Start monitoring Cisco MDS Fibre Channel SAN switches (preferred path) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.