-- ===================================================================== -- Copyright (c) 2009-2023 FS.COM Inc. All Rights Reserved. -- -- Description: -- This MIB module is for the management of the Fibre Channel -- Ping functionality. -- Reference: -- Version: V1.0 -- History: -- V1.0 Initial version created by liuyanchao 2013-03-15 -- ===================================================================== FS-FC-PING-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, Unsigned32, Integer32 FROM SNMPv2-SMI RowStatus, TruthValue FROM SNMPv2-TC FsFcVsanIndex, FsFcAddressType, FsFcAddress, FsFcStartOper FROM FS-FC-TC-MIB fsSan FROM FS-VSAN-MIB; fsFcPing MODULE-IDENTITY LAST-UPDATED "201303150000Z" ORGANIZATION "Fiberstore Co.,Limited" CONTACT-INFO "" DESCRIPTION "This MIB module is for the management of the Fibre Channel Ping functionality." REVISION "201303150000Z" DESCRIPTION "Initial version of this MIB module." ::= { fsSan 5 } fsFcPingObjects OBJECT IDENTIFIER ::= { fsFcPing 1 } fsFcPingConfigurations OBJECT IDENTIFIER ::= { fsFcPingObjects 1 } fsFcPingStatistics OBJECT IDENTIFIER ::= { fsFcPingObjects 2 } fsFcPingNotifications OBJECT IDENTIFIER ::= { fsFcPingObjects 3 } fsFcPingNotifyPrefix OBJECT IDENTIFIER ::= { fsFcPingNotifications 0 } -- FC Ping table fsFcPingTable OBJECT-TYPE SYNTAX SEQUENCE OF FsFcPingEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table of FC ping entries containing a group of FC ping requests that need to be executed at the agent." ::= { fsFcPingConfigurations 1 } fsFcPingEntry OBJECT-TYPE SYNTAX FsFcPingEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A FC ping request entry that need to be executed at the agent." INDEX { fsFcPingIndex } ::= { fsFcPingTable 1 } FsFcPingEntry ::= SEQUENCE { fsFcPingIndex Unsigned32, fsFcPingVsan FsFcVsanIndex, fsFcPingAddressType FsFcAddressType, fsFcPingAddress FsFcAddress, fsFcPingPacketCount Unsigned32, fsFcPingPayloadSize Unsigned32, fsFcPingTimeout Unsigned32, fsFcPingDelay Unsigned32, fsFcPingAgeInterval Unsigned32, fsFcPingAdminStatus FsFcStartOper, fsFcPingOperStatus INTEGER, fsFcPingTrapOnCompletion TruthValue, fsFcPingRowStatus RowStatus } fsFcPingIndex OBJECT-TYPE SYNTAX Unsigned32 (1..65535) MAX-ACCESS accessible-for-notify STATUS current DESCRIPTION "The index of the current FC ping entry. This object identifies a FC ping request entry uniquely in a specified VSAN (Virtual Storage Area Network)." ::= { fsFcPingEntry 1 } fsFcPingVsan OBJECT-TYPE SYNTAX FsFcVsanIndex MAX-ACCESS read-create STATUS current DESCRIPTION "The VSAN on which the FC ping request will be performed. If the corresponding instance value of fsFcPingOperStatus is 'inProgress', the object cannot be modified." ::= { fsFcPingEntry 2 } fsFcPingAddressType OBJECT-TYPE SYNTAX FsFcAddressType MAX-ACCESS read-create STATUS current DESCRIPTION "The type of the corresponding instance of fsFcPingAddress object." DEFVAL { fcid } ::= { fsFcPingEntry 3 } fsFcPingAddress OBJECT-TYPE SYNTAX FsFcAddress MAX-ACCESS read-create STATUS current DESCRIPTION "The address to which the route will be pinged. This object will contain an 8 octet long WWN(World Wide Name), if the value of the associated instance of fsFcPingAddressType object is 'wwn'. This object will contain a 3 octet long Fibre Channel Address ID, if the value of the associated instance of fsFcPingAddressType object is 'fcid'." ::= { fsFcPingEntry 4 } fsFcPingPacketCount OBJECT-TYPE SYNTAX Unsigned32 (1..2147483647) MAX-ACCESS read-create STATUS current DESCRIPTION "The number of FC ping packets to be sent to the target in this sequence." DEFVAL { 5 } ::= { fsFcPingEntry 5 } fsFcPingPayloadSize OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "This object specifies the size of the FC ping packet payload to be sent to the target in this sequence." ::= { fsFcPingEntry 6 } fsFcPingTimeout OBJECT-TYPE SYNTAX Unsigned32 (1..10) UNITS "seconds" MAX-ACCESS read-create STATUS current DESCRIPTION "The value of timeout for this FC ping request." DEFVAL { 5 } ::= { fsFcPingEntry 7 } fsFcPingDelay OBJECT-TYPE SYNTAX Unsigned32 UNITS "seconds" MAX-ACCESS read-only STATUS current DESCRIPTION "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." ::= { fsFcPingEntry 8 } fsFcPingAgeInterval OBJECT-TYPE SYNTAX Unsigned32 (500..900) UNITS "seconds" MAX-ACCESS read-create STATUS current DESCRIPTION "The interval time after a FC ping test completes before the entry is aged out." DEFVAL { 500 } ::= { fsFcPingEntry 9 } fsFcPingAdminStatus OBJECT-TYPE SYNTAX FsFcStartOper MAX-ACCESS read-create STATUS current DESCRIPTION "The administrative status of each fsFcPingEntry. The object has two values: enable - Activate the entry. disable - Deactivate the entry. When the FC ping 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 test finishes, the value of this object will be set to 'disable'." DEFVAL { disable } ::= { fsFcPingEntry 10 } fsFcPingOperStatus OBJECT-TYPE SYNTAX INTEGER { inProgress(1), -- FC ping in progress complete(2), -- FC ping complete disabled(3), -- FC ping disabled failed(4) -- FC ping failed } MAX-ACCESS read-only STATUS current DESCRIPTION "This object indicates the operational status of this fsFcPingEntry. The value specifications are listed as follows: inProgress - FC ping is in progress. complete - FC ping is complete. disabled - FC ping is disabled. failed - FC ping has failed due to resource limitations." ::= { fsFcPingEntry 11 } fsFcPingTrapOnCompletion OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "This object indicates that if fsFcPingCompletionNotify notification should be generated or not when the corresponding ping sequence completes." DEFVAL { false } ::= { fsFcPingEntry 12 } fsFcPingRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this conceptual row." ::= { fsFcPingEntry 13 } -- FC Ping Statistics Table fsFcPingStatTable OBJECT-TYPE SYNTAX SEQUENCE OF FsFcPingStatEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table of FC ping statistics. This table notes the FC ping statistics of a FC ping test associated with an entry in the fsFcPingTable." ::= { fsFcPingStatistics 1 } fsFcPingStatEntry OBJECT-TYPE SYNTAX FsFcPingStatEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A FC ping statistics entry. An entry will be created automatically in this table when the fsFcPingRowStatus of a ping request in the fsFcPingTable is set to 'active'. The entry in this table will have the same indices as the entry that in the fsFcPingTable. An entry in this table will be deleted when the corresponding entry in the fsFcPingTable is deleted." INDEX { fsFcPingIndex } ::= { fsFcPingStatTable 1 } FsFcPingStatEntry ::= SEQUENCE { fsFcPingReqPackets Unsigned32, fsFcPingResPackets Unsigned32, fsFcPingMinTime Integer32, fsFcPingAverageTime Integer32, fsFcPingMaxTime Integer32, fsFcPingTimeoutNum Unsigned32 } fsFcPingReqPackets OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of FC ping packets request in this sequence." ::= { fsFcPingStatEntry 1 } fsFcPingResPackets OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of FC ping packets response in this sequence." ::= { fsFcPingStatEntry 2 } fsFcPingMinTime OBJECT-TYPE SYNTAX Integer32 UNITS "microseconds" MAX-ACCESS read-only STATUS current DESCRIPTION "The minimum round trip time of all the packets that have been sent in this sequence." ::= { fsFcPingStatEntry 3 } fsFcPingAverageTime OBJECT-TYPE SYNTAX Integer32 UNITS "microseconds" MAX-ACCESS read-only STATUS current DESCRIPTION "The average round trip time of all the packets that have been sent in this sequence." ::= { fsFcPingStatEntry 4 } fsFcPingMaxTime OBJECT-TYPE SYNTAX Integer32 UNITS "microseconds" MAX-ACCESS read-only STATUS current DESCRIPTION "The maximum round trip time of all the packets that have been sent in this sequence." ::= { fsFcPingStatEntry 5 } fsFcPingTimeoutNum OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of timeouts encountered in this sequence." ::= { fsFcPingStatEntry 6 } -- Notifications fsFcPingCompletionNotify NOTIFICATION-TYPE OBJECTS { fsFcPingIndex, fsFcPingVsan, fsFcPingAddressType, fsFcPingAddress, fsFcPingReqPackets, fsFcPingResPackets} STATUS current DESCRIPTION "When a FC ping test is finished and the instance of fsFcPingTrapOnCompletion associated with the test is set to 'true', this notification occurred." ::= { fsFcPingNotifyPrefix 1 } END