CISCO-FCPING-MIB

File: CISCO-FCPING-MIB.mib (22457 bytes)

Imported modules

SNMPv2-SMI SNMPv2-CONF SNMPv2-TC
CISCO-SMI CISCO-ST-TC

Imported symbols

MODULE-IDENTITY OBJECT-TYPE NOTIFICATION-TYPE
Gauge32 Unsigned32 Integer32
MODULE-COMPLIANCE OBJECT-GROUP NOTIFICATION-GROUP
RowStatus TruthValue TEXTUAL-CONVENTION
ciscoMgmt VsanIndex FcAddress
FcAddressType

Defined Types

FcStartOper  
TEXTUAL-CONVENTION    
  current INTEGER enable(1), disable(2)

FcPingEntry  
SEQUENCE    
  fcPingIndex Integer32
  fcPingVsanIndex VsanIndex
  fcPingAddressType FcAddressType
  fcPingAddress FcAddress
  fcPingPacketCount Unsigned32
  fcPingPayloadSize Unsigned32
  fcPingPacketTimeout Unsigned32
  fcPingDelay Unsigned32
  fcPingAgeInterval Unsigned32
  fcPingUsrPriority INTEGER
  fcPingAdminStatus FcStartOper
  fcPingOperStatus INTEGER
  fcPingTrapOnCompletion TruthValue
  fcPingRowStatus RowStatus

FcPingStatsEntry  
SEQUENCE    
  fcPingTxPackets Gauge32
  fcPingRxPackets Gauge32
  fcPingMinRtt Integer32
  fcPingAvgRtt Integer32
  fcPingMaxRtt Integer32
  fcPingNumTimeouts Gauge32

Defined Values

ciscoFcPingMIB 1.3.6.1.4.1.9.9.295
The MIB module for the management of the Fibre Channel Ping functionality.
MODULE-IDENTITY    

ciscoFcPingMIBObjects 1.3.6.1.4.1.9.9.295.1
OBJECT IDENTIFIER    

fcPingMIBConformance 1.3.6.1.4.1.9.9.295.2
OBJECT IDENTIFIER    

fcPingConfiguration 1.3.6.1.4.1.9.9.295.1.1
OBJECT IDENTIFIER    

fcPingStats 1.3.6.1.4.1.9.9.295.1.2
OBJECT IDENTIFIER    

fcPingNotification 1.3.6.1.4.1.9.9.295.1.3
OBJECT IDENTIFIER    

fcPingNotifications 1.3.6.1.4.1.9.9.295.1.3.0
OBJECT IDENTIFIER    

fcPingTable 1.3.6.1.4.1.9.9.295.1.1.1
A table of ping request entries. This table contains a set of ping requests which need to be executed at the agent.
OBJECT-TYPE    
  SEQUENCE OF  
    FcPingEntry

fcPingEntry 1.3.6.1.4.1.9.9.295.1.1.1.1
A ping request entry. A management station wishing to create an entry should generate a pseudo-random number to be used as an index into this table and create an instance of the fcPingRowStatus object. After that, the management station should set the corresponding instance of fcPingAddress object with the address of the destination that should be pinged and fcPingVsanIndex with the desired VSAN number. Once the appropriate instance of all the configuration objects have been created, either by an explicit SNMP set request or by default, the row status should be set to active to initiate the ping sequence. Note that this entire procedure may be initiated via a single set request which specifies a row status of createAndGo as well as specifies valid values for the non-defaulted configuration objects. Once the ping sequence has been initiated it can be stopped by setting the corresponding instance of fcPingRowStatus to 'destroy'. The results of the ping operation are made available in the fcPingStats table. For a ping entry uniquely identified by fcPingIndex, an entry will be created in the fcPingStats table automatically by the agent. Once the ping sequence completes, the management station should retrieve the statistics of interest from the fcPingStats table and delete the entry from the fcPingTable. The corresponding entry in the fcPingStats table shall be deleted automatically by the agent. In order to prevent old entries from clogging the table, entries will be aged out, but an entry will never be deleted within fcPingAgeInterval milliseconds of completing. If the management station wishes to repeat the ping sequence to a particular destination, then it will need to set the corresponding instance of fcPingAdminStatus to 'enable' again.
OBJECT-TYPE    
  FcPingEntry  

fcPingIndex 1.3.6.1.4.1.9.9.295.1.1.1.1.1
The index of a ping entry. This object uniquely identifies a ping request entry on a VSAN.
OBJECT-TYPE    
  Integer32 1..2147483647  

fcPingVsanIndex 1.3.6.1.4.1.9.9.295.1.1.1.1.2
This object identifies the VSAN to which this ping request belongs. This object cannot be modified if the corresponding instance of fcPingOperStatus object has a value of 'inProgress'.
OBJECT-TYPE    
  VsanIndex  

fcPingAddressType 1.3.6.1.4.1.9.9.295.1.1.1.1.3
The format of the corresponding instance of fcPingAddress object.
OBJECT-TYPE    
  FcAddressType  

fcPingAddress 1.3.6.1.4.1.9.9.295.1.1.1.1.4
The address of the device to be pinged. If the value of the corresponding instance of fcPingAddressType object is 'wwn', then this object will contain an 8 octet long WWN. If the value of the corresponding instance of fcPingAddressType object is 'fcid', then this object will contain a 3 octet long FCID. This object MUST be set to a valid value before or concurrently with setting the corresponding instance of fcPingRowStatus to 'active'.
OBJECT-TYPE    
  FcAddress  

fcPingPacketCount 1.3.6.1.4.1.9.9.295.1.1.1.1.5
The number of ping packets to be sent to the target in this sequence. This object cannot be modified if the corresponding instance of fcPingOperStatus object has a value of 'inProgress'.
OBJECT-TYPE    
  Unsigned32 1..2147483647  

fcPingPayloadSize 1.3.6.1.4.1.9.9.295.1.1.1.1.6
This object specifies the size of the ping packet payload to be sent to the target in this sequence. This object cannot be modified if the corresponding instance of fcPingOperStatus object has a value of 'inProgress'.
OBJECT-TYPE    
  Unsigned32 0..1884  

fcPingPacketTimeout 1.3.6.1.4.1.9.9.295.1.1.1.1.7
The amount of time to wait for a response to a transmitted packet before declaring the packet 'dropped'. This object cannot be modified if the corresponding instance of fcPingOperStatus object has a value of 'inProgress'.
OBJECT-TYPE    
  Unsigned32 1..10  

fcPingDelay 1.3.6.1.4.1.9.9.295.1.1.1.1.8
The minimum amount of time to wait before sending the next packet in a sequence, after receiving a response or declaring a timeout for a previously transmitted packet. This object cannot be modified if the corresponding instance of fcPingOperStatus object has a value of 'inProgress'.
OBJECT-TYPE    
  Unsigned32 0..3600000  

fcPingAgeInterval 1.3.6.1.4.1.9.9.295.1.1.1.1.9
The amount of time to wait after the ping sequence completes before the ping entry is aged out. This object cannot be modified if the corresponding instance of fcPingOperStatus object has a value of 'inProgress'.
OBJECT-TYPE    
  Unsigned32 500000..900000  

fcPingUsrPriority 1.3.6.1.4.1.9.9.295.1.1.1.1.10
This object determines the queuing priority and drop probability this sequence of ping packets experience in the switches through which they pass through. If the value of this object is set to 'high', then the corresponding sequence of packets will experience high queueing priority and low drop probability in the switches through which they pass through. If the value of this object is set to 'low', then the corresponding sequence of packets will experience low queueing priority and higher drop probability in the switches through which they pass through. This object cannot be modified if the corresponding instance of fcPingOperStatus object has a value of 'inProgress'.
OBJECT-TYPE    
  INTEGER high(1), low(2)  

fcPingAdminStatus 1.3.6.1.4.1.9.9.295.1.1.1.1.11
This object specifies the desired state that a fcPingEntry should be in: enable(1) - Attempt to activate the ping as defined by this entry. disable(2) - Deactivate the ping as defined by this entry. The actual operational state of this test is indicated by the corresponding instance of fcPingOperStatus. When the ping sequence corresponding to this entry is executing, this object cannot be modified. If this object is read at such a time, a value of 'enable' will be returned. When the ping sequence completes, the value of this object will be made 'disable' automatically by the agent.
OBJECT-TYPE    
  FcStartOper  

fcPingOperStatus 1.3.6.1.4.1.9.9.295.1.1.1.1.12
This object indicates the operational status of this fcPingEntry. inProgress(1) - Indicates that the ping sequence as defined by this instance of fcPingEntry is currently running. complete(2) - Indicates that the ping sequence as defined by this instance of fcPingEntry is currently complete. disabled(3) - Indicates that the ping sequence as defined by this instance of fcPingEntry is currently disabled. failure(4) - Indicates that the ping sequence as defined by this instance of fcPingEntry has currently failed due to resource limitations. Initially the value of this object will be 'inProgress' when the ping sequence is being executed. Once the ping sequence is completed, the value of this object will transition to 'complete'. If the value of the corresponding instance of fcPingAdminStatus is 'disable', then this object will have a value of 'disabled'.
OBJECT-TYPE    
  INTEGER inProgress(1), complete(2), disabled(3), failure(4)  

fcPingTrapOnCompletion 1.3.6.1.4.1.9.9.295.1.1.1.1.13
This specifies if fcPingCompletionNotify notification should be generated or not when the corresponding ping sequence completes. If this object is set to 'true', then the notification is generated. If this object is set to 'false', then the notification is not generated. This object cannot be modified if the corresponding instance of fcPingOperStatus object has a value of 'inProgress'.
OBJECT-TYPE    
  TruthValue  

fcPingRowStatus 1.3.6.1.4.1.9.9.295.1.1.1.1.14
The status of this conceptual row. When a ping sequence is being executed, if this object is set to 'destroy', then the corresponding ping sequence will be stopped.
OBJECT-TYPE    
  RowStatus  

fcPingStatsTable 1.3.6.1.4.1.9.9.295.1.2.1
A table of ping statistics. The statistics corresponding to the entries in the fcPingTable. When an entry is deleted in the fcPingTable, the corresponding entry in this table is deleted automatically by the agent.
OBJECT-TYPE    
  SEQUENCE OF  
    FcPingStatsEntry

fcPingStatsEntry 1.3.6.1.4.1.9.9.295.1.2.1.1
A ping statistics entry. An entry shall be created automatically in this table whenever a ping request is activated in the fcPingTable by setting the fcPingRowStatus to 'active'. This entry shall have the same indices as the entry that got activated in the fcPingTable. An entry in this table shall be deleted by the agent automatically either when the corresponding entry in the fcPingTable is deleted by the management station or is aged out by the agent. This table shall be empty if there is no 'active' entry in the fcPingTable.
OBJECT-TYPE    
  FcPingStatsEntry  

fcPingTxPackets 1.3.6.1.4.1.9.9.295.1.2.1.1.1
The number of ping packets sent to the target in this sequence.
OBJECT-TYPE    
  Gauge32  

fcPingRxPackets 1.3.6.1.4.1.9.9.295.1.2.1.1.2
The number of ping packets received from the target in this sequence.
OBJECT-TYPE    
  Gauge32  

fcPingMinRtt 1.3.6.1.4.1.9.9.295.1.2.1.1.3
The minimum round trip time of all the packets that have been sent in this sequence.
OBJECT-TYPE    
  Integer32 0..10000000  

fcPingAvgRtt 1.3.6.1.4.1.9.9.295.1.2.1.1.4
The average round trip time of all the packets that have been sent in this sequence.
OBJECT-TYPE    
  Integer32 0..10000000  

fcPingMaxRtt 1.3.6.1.4.1.9.9.295.1.2.1.1.5
The maximum round trip time of all the packets that have been sent in this sequence.
OBJECT-TYPE    
  Integer32 0..10000000  

fcPingNumTimeouts 1.3.6.1.4.1.9.9.295.1.2.1.1.6
The number of timeouts encountered in this sequence.
OBJECT-TYPE    
  Gauge32  

fcPingCompletionNotify 1.3.6.1.4.1.9.9.295.1.3.0.1
This notification is generated whenever a sequence of pings is complete and the corresponding instance of fcPingTrapOnCompletion object has been set to 'true'.
NOTIFICATION-TYPE    

fcPingMIBCompliances 1.3.6.1.4.1.9.9.295.2.1
OBJECT IDENTIFIER    

fcPingMIBGroups 1.3.6.1.4.1.9.9.295.2.2
OBJECT IDENTIFIER    

fcPingMIBCompliance 1.3.6.1.4.1.9.9.295.2.1.1
Only three values 'createAndGo', 'destroy' and 'active' out of the six enumerated values need to be supported.
MODULE-COMPLIANCE    
  fcPingRowStatus INTEGER active(1), createAndGo(4), destroy(6)

fcPingConfigGroup 1.3.6.1.4.1.9.9.295.2.2.1
A collection of objects for configuring Fibre Channel Ping.
OBJECT-GROUP    

fcPingStatsGroup 1.3.6.1.4.1.9.9.295.2.2.2
A collection of objects for displaying Fibre Channel Ping statistics.
OBJECT-GROUP    

fcPingNotifyGroup 1.3.6.1.4.1.9.9.295.2.2.3
A collection of notification(s) for monitoring Fibre Channel Ping completion.
NOTIFICATION-GROUP