CISCO-NS-MIB

All MIBs › CISCO-NS-MIB

Organization: Cisco Systems Inc.

Last Updated: 2004-08-30

Category: Cisco Devices, Fibre Channel and Storage

Description: Manages the Fibre Channel Name Server database and zone membership on Cisco MDS series SAN switches.

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-NS-MIB?

CISCO-NS-MIB is a Cisco-specific MIB implemented on Cisco MDS series Fibre Channel storage-area-network (SAN) switches, providing management access to the Fibre Channel Name Server (NS) as defined by the FC-GS3 standard. It exposes fabric-wide data about which devices are registered in the name server, including port identifiers, port/node World Wide Names, class-of-service capabilities, and node IP addresses for each attached FC end device. Rather than hardware health, CISCO-NS-MIB SNMP monitoring focuses on software/fabric-service status: tracking name-server database size (row counts), detecting when the table last changed, and watching proxy port registrations that indicate name-server communication across an inter-switch link. It builds directly on the FC-GS3 Name Server specification and the broader Cisco Fibre Channel MIB family, so it is typically deployed alongside other Cisco FC/zoning MIBs rather than standalone. It is used in Fibre Channel SAN environments to verify that hosts and storage devices are correctly registering and discoverable through the fabric's name service.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-NS-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 9718 Multilayer Director — current high-end Fibre Channel SAN director chassis, actively supported with Supervisor-4 modules under NX-OS 9.x

Monitoring Examples

An administrator would poll fcNameServerTable/fcNameServerEntry, keyed by fcNameServerPortIdentifier, to see each registered device's fcNameServerPortName, fcNameServerNodeName, and fcNameServerClassOfSvc, confirming a host bus adapter or storage array is properly logged into the fabric. Watching fcNameServerTableLastChange and fcNameServerNumRows over time reveals unexpected churn (devices dropping in and out) or a device that fails to register after a link flap. The fcNameServerProxyPortTable/fcNameServerProxyPortName objects show which switch ports are acting as name-server proxies between interconnected VSANs or fabrics, useful for diagnosing multi-switch name-server propagation problems.

What Can Be Monitored

Fibre Channel name server device registrations
port/node World Wide Names
name server table change/row count
name server proxy port status
class of service per device

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From CISCO-ST-TC

FcAddressId
FcClassOfServices
FcNameId
FcNameIdOrZero

From CISCO-VSAN-MIB

notifyVsanIndex	OBJECT-TYPE
vsanIndex	OBJECT-TYPE

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Integer32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE

From SNMPv2-TC

TEXTUAL-CONVENTION
TimeStamp
TruthValue

How to Use in IPNetwork Monitor

Example using fcNameServerNumRows OID:

Select a Cisco MDS 9718 Multilayer Director as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type fcNameServerNumRows into the Find box to locate it in the OID tree, then select it and click OK. It reports the number of Fibre Channel Nx_Ports currently registered with this switch's name server, fabric-wide. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is an Integer32-type OID, Value bounds is the most useful condition here — trigger an alert if the count drops well below its normal baseline, which would indicate hosts or storage ports have unexpectedly logged out of the fabric. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoNameServerMIBObjects	1.3.6.1.4.1.9.9.293.1
ciscoNsMIB	1.3.6.1.4.1.9.9.293			The MIB module for the management of the Cisco Name Server which realizes the FC-GS3 requirements for Name Server (NS).
FCC fcNameServerClassOfSvc	1.3.6.1.4.1.9.9.293.1.1.4.1.4	FcClassOfServices	read-only	The class of service indicator. This object is a array of bits that contain a bit map of the classes of service supported by the associated port. If a bit in this object is 1, it indicates that the class of service is supported by the associated port. When a bit is set to 0, it indicates that no class of service is supported by this Nx_port.
fcNameServerConfiguration	1.3.6.1.4.1.9.9.293.1.1
NTF fcNameServerDatabaseFull	1.3.6.1.4.1.9.9.293.1.4.0.2			This notification is generated by the Name Server when the Name Server cannot allocate space for a new entry.
fcNameServerDBGroup	1.3.6.1.4.1.9.9.293.2.2.1			A collection of objects for displaying and configuring Name Server objects.
fcNameServerDBGroup1	1.3.6.1.4.1.9.9.293.2.2.5			A collection of objects for displaying and configuring Name Server objects.
fcNameServerDBGroup2	1.3.6.1.4.1.9.9.293.2.2.7			A collection of objects for displaying and configuring Name Server objects.
fcNameServerDBGroup3	1.3.6.1.4.1.9.9.293.2.2.8			A collection of objects for displaying and configuring Name Server objects.
fcNameServerEntry	1.3.6.1.4.1.9.9.293.1.1.4.1		not-accessible	An entry (conceptual row) in the fcNameServerTable. This contains information about an Nx_Port represented by fcNameServerPortIdentifier for a particular VSAN identified by vsanIndex.
NTF fcNameServerEntryAdd	1.3.6.1.4.1.9.9.293.1.4.0.3			This notification is generated by the Name Server when a new entry gets added to the Name Server database.
NTF fcNameServerEntryDelete	1.3.6.1.4.1.9.9.293.1.4.0.4			This notification is generated by the Name Server when an existing entry is deleted from the Name Server database.
FCN fcNameServerFabricPortName	1.3.6.1.4.1.9.9.293.1.1.4.1.10	FcNameId	read-only	The Fabric Port Name (WWN) of the Fx_port to which this Nx_port is attached. If this object is not set, then it will contain the null value '0000000000000000'h.
OCT fcNameServerFC4Features	1.3.6.1.4.1.9.9.293.1.1.4.1.14	OCTET STRING	read-write	The FC-4 Features associated with this port and the FC-4 Type. Refer to FC-GS3 specification for the format of this object. This object is an array of 4-bit values, one for each TYPE code value. The 5 most significant bits of the TYPE field will be used to identify the word for the FC-4 Features object. - Word 0 contains information related to TYPE code '00' thru' '07'; - Word 1 contains information related to TYPE code '08' thru' 0F'; - and so forth to Word 31 that contains information related to TYPE code 'F8' thru' 'FF'. The 3 least significant bits of the TYPE field will be used to identify the position within the word for the 4-bit FC-4 Features value.
OCT fcNameServerFC4Type	1.3.6.1.4.1.9.9.293.1.1.4.1.7	OCTET STRING	read-write	The FC-4 protocol types supported by this Nx_port. This is an array of 256-bits. Each bit in the array corresponds to a Type value as defined by the fibre channel standards and contained in the Type field of the frame header.
ADR fcNameServerHardAddress	1.3.6.1.4.1.9.9.293.1.1.4.1.11	FcAddressId	read-only	The format of this object is identical to the format of Hard Address defined in the Discover Address (ADISC) Extended Link Service (FC-PH-2). Hard Address is the 24-bit NL_Port identifier which consists of - the 8-bit Domain Id in the most significant byte - the 8-bit Area Id in the next most significant byte - the 8-bit AL-PA(Arbitrated Loop Physical Address) which an NL_port attempts acquire during FC-AL initialization in the least significant byte. If the port is not an NL_Port, or if it is an NL_Port but does not have a hard address, then all bits are reported as 0s.
C32 fcNameServerInDeRegReqs	1.3.6.1.4.1.9.9.293.1.2.2.1.4	Counter32	read-only	The total number of De-registration Requests received by the local switch on this VSAN.
fcNameServerInformation	1.3.6.1.4.1.9.9.293.1.3
C32 fcNameServerInGetReqs	1.3.6.1.4.1.9.9.293.1.2.2.1.1	Counter32	read-only	The total number of Get Requests received by the local switch on this VSAN.
C32 fcNameServerInRegReqs	1.3.6.1.4.1.9.9.293.1.2.2.1.3	Counter32	read-only	The total number of Registration Requests received by the local switch on this VSAN.
C32 fcNameServerInRscns	1.3.6.1.4.1.9.9.293.1.2.2.1.5	Counter32	read-only	The total number of RSCN commands received by the local switch on this VSAN.
fcNameServerMIBCompliance	1.3.6.1.4.1.9.9.293.2.1.1			The compliance statement for entities which implement the name server.
fcNameServerMIBCompliance1	1.3.6.1.4.1.9.9.293.2.1.2			The compliance statement for entities which implement the name server.
fcNameServerMIBCompliance2	1.3.6.1.4.1.9.9.293.2.1.3			The compliance statement for entities which implement the name server.
fcNameServerMIBCompliance3	1.3.6.1.4.1.9.9.293.2.1.4			The compliance statement for entities which implement the name server.
fcNameServerMIBCompliances	1.3.6.1.4.1.9.9.293.2.1
fcNameServerMIBConformance	1.3.6.1.4.1.9.9.293.2
fcNameServerMIBGroups	1.3.6.1.4.1.9.9.293.2.2
OCT fcNameServerNodeIpAddress	1.3.6.1.4.1.9.9.293.1.1.4.1.5	OCTET STRING	read-write	The IP address of the node of this Nx_port, as indicated by the Nx_Port in a GS3 message that it transmitted. The GS3 format specifies a 32-bit IPv4 address or a 128-bit IPv6 address. For the former, the leftmost 96 bits (12 bytes) are set to x'00 00 00 00 00 00 00 00 00 00 FF FF' and the rightmost 32 bits are supposed to contain the IPv4 address.
FCN fcNameServerNodeName	1.3.6.1.4.1.9.9.293.1.1.4.1.3	FcNameId	read-only	The fibre channel Node_Name (WWN) of this Nx_port. If this object is not set, then it will contain the null value '0000000000000000'h.
fcNameServerNotification	1.3.6.1.4.1.9.9.293.1.4
fcNameServerNotifications	1.3.6.1.4.1.9.9.293.1.4.0
fcNameServerNotifyControlGroup	1.3.6.1.4.1.9.9.293.2.2.3			A collection of notification control and notification information objects for monitoring Name Server registrations/de-registrations.
fcNameServerNotifyGroup	1.3.6.1.4.1.9.9.293.2.2.4			A collection of notifications for monitoring Name Server registrations/de-registrations.
fcNameServerNotifyGroupRev1	1.3.6.1.4.1.9.9.293.2.2.6			A collection of notifications for monitoring Name Server registrations/de-registrations.
I32 fcNameServerNumRowsEx	1.3.6.1.4.1.9.9.293.1.1.3	Integer32	read-only	The number of Nx_Ports currently registered with this device fabric wide.
C32 fcNameServerOutGetReqs	1.3.6.1.4.1.9.9.293.1.2.2.1.2	Counter32	read-only	The total number of Get Requests sent by the local switch on this VSAN.
C32 fcNameServerOutRscns	1.3.6.1.4.1.9.9.293.1.2.2.1.6	Counter32	read-only	The total number of RSCN commands sent by the local switch on this VSAN.
FCN fcNameServerPermanentPortName	1.3.6.1.4.1.9.9.293.1.1.4.1.16	FcNameId	read-only	The Permanent Port Name of this Nx_port. If multiple Port_Name(s) are associated with this Nx_port via FDISC (Discover F_Port Service Parameters), the Permanent Port Name is the original Port_Name associated with this Nx_port at login. If this object is not set, then it will contain the null value '0000000000000000'h.
BIT fcNameServerPortFunction	1.3.6.1.4.1.9.9.293.1.1.4.1.15	Bits	read-only	The function of this port. trapPort(0) indicates that this port is functioning as a Trap Port. vep(1) indicates that this port is functioning as a Virtual Enclosure Port (VEP). volOwner(2) indicates that this port is functioning as a Volume Owner. ipfcPort(3) indicates that this port is functioning as a IP-FC port. intPort(4) indicates that this port is functioning as an internal port.
ADR fcNameServerPortIdentifier	1.3.6.1.4.1.9.9.293.1.1.4.1.1	FcAddressId	not-accessible	The Fibre Channel Identifier (FC-ID) of this Nx_Port.
OCT fcNameServerPortIpAddress	1.3.6.1.4.1.9.9.293.1.1.4.1.9	OCTET STRING	read-write	This object contains the IP address of the associated port in either 32-bit IPv4 format or 128-bit IPv6 format. When this object contains a IPv4 address, the leftmost 96 bits (12 bytes) should contain x'00 00 00 00 00 00 00 00 00 00 FF FF'. The IPv4 address should be present in the rightmost 32 bits. Note that the value of this object is the IP address value that is received in the GS3 message Register IP address (Port) RIPP_ID. It is not validated against any IP address format.
FCN fcNameServerPortName	1.3.6.1.4.1.9.9.293.1.1.4.1.2	FcNameId	read-only	The fibre channel Port_Name (WWN) of this Nx_port. If this object is not set, then it will contain the null value '0000000000000000'h.
INT fcNameServerPortType	1.3.6.1.4.1.9.9.293.1.1.4.1.8	INTEGER	read-only	The port type of this port.
OCT fcNameServerProcAssoc	1.3.6.1.4.1.9.9.293.1.1.4.1.6	OCTET STRING	read-only	The Fibre Channel initial process associator (IPA).
fcNameServerProxyPortEntry	1.3.6.1.4.1.9.9.293.1.1.1.1		not-accessible	An entry (conceptual row) in this table.
FCN fcNameServerProxyPortName	1.3.6.1.4.1.9.9.293.1.1.1.1.1	FcNameIdOrZero	read-write	Name of the proxy port which can register/deregister for other ports on this VSAN. Users can enable third party registrations by setting this object. In order to disable third party registrations, this object should be set to ''H.
fcNameServerProxyPortTable	1.3.6.1.4.1.9.9.293.1.1.1		not-accessible	This table contains a list of proxy ports on all configured VSANs on the local switch. Only one proxy port is allowed on a VSAN.
FCG fcNameServerRejectReasonCode	1.3.6.1.4.1.9.9.293.1.3.1	FcGs3RejectReasonCode	read-only	The registration reject reason code. This object contains the reason code corresponding to the most recent Name Server Registration request failure.
NTF fcNameServerRejectRegNotify	1.3.6.1.4.1.9.9.293.1.4.0.1			This notification is generated by the Name Server whenever it rejects a registration request. The Name Server should update the 'fcNameServerRejectReasonCode' and 'fcNameServerRejReasonCodeExp' objects with the corresponding reason code and reason code explanation before sending the notification. These two objects are also included along with the notification to provide the reason for the reject.
C32 fcNameServerRejects	1.3.6.1.4.1.9.9.293.1.2.2.1.7	Counter32	read-only	The total number of requests rejected by the local switch on this VSAN.
FCN fcNameServerRejReasonCodeExp	1.3.6.1.4.1.9.9.293.1.3.2	FcNameServerRejReasonExpl	read-only	The registration reject reason code explanation. This object contains the reason code explanation if the above object has a reason code corresponding to 'Unable to perform command request'. This object like the one above, corresponds to the most recent Name Server Registration request rejection.
T/F fcNameServerRejReqNotifyEnable	1.3.6.1.4.1.9.9.293.1.1.5	TruthValue	read-write	This object specifies if the Name Server should generate 'fcNameServerRejectRegNotify' notifications. If value of this object is 'true', then the notification is generated when a request is rejected. If it is 'false', the notification is not generated.
fcNameServerStats	1.3.6.1.4.1.9.9.293.1.2
fcNameServerStatsEntry	1.3.6.1.4.1.9.9.293.1.2.2.1		not-accessible	An entry (conceptual row) in this table.
fcNameServerStatsGroup	1.3.6.1.4.1.9.9.293.2.2.2			A collection of objects for displaying Name Server statistics.
fcNameServerStatsTable	1.3.6.1.4.1.9.9.293.1.2.2		not-accessible	This table contains statistic counters which are maintained by the Name Server. These counters are maintained per VSAN.
STR fcNameServerSymbolicNodeName	1.3.6.1.4.1.9.9.293.1.1.4.1.13	SnmpAdminString	read-write	The user-defined name of the node of this port. If this object has not been set, then the value of this object is the zero length string.
STR fcNameServerSymbolicPortName	1.3.6.1.4.1.9.9.293.1.1.4.1.12	SnmpAdminString	read-write	The user-defined name of this port. If this object has not been set, then the value of this object is the zero length string.
fcNameServerTable	1.3.6.1.4.1.9.9.293.1.1.4		not-accessible	This table contains entries for all Nx_Ports registered with Fx_Ports on all the VSANs configured on the local switch.
TIM fcNameServerTableLastChange	1.3.6.1.4.1.9.9.293.1.1.2	TimeStamp	read-only	The value of sysUpTime at the time of the last update to the fcNameServerTable. This includes creation of an entry, deletion of an entry and modification of an existing entry. If no updates have taken place since the last re-initialization of the local network management subsystem, then this object contains a zero value.
C32 fcNameServerTotalRejects	1.3.6.1.4.1.9.9.293.1.2.1	Counter32	read-only	The total number of requests rejected by the local switch across all VSANs.

RFC description

Cisco vendor-private MIB for management of Nexus Switch (NS) platform-specific features and hardware.

Start monitoring Cisco MDS Fibre Channel SAN switches (Name Server) 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.

Download CISCO-NS-MIB