1-- *******************************************************************
2-- CISCO-GSLB-HEALTH-MON-MIB.my:  Global Server Load Balancing
3-- Keepalive Status and Statistics
4--
5-- Dec 2006, Pawan N
6--
7-- Copyright (c) 2006-2007 by Cisco Systems Inc.
8-- All rights reserved.
9-- ******************************************************************
10
11CISCO-GSLB-HEALTH-MON-MIB DEFINITIONS ::= BEGIN
12
13IMPORTS
14    MODULE-IDENTITY,
15    OBJECT-TYPE,
16    NOTIFICATION-TYPE,
17    Counter32,
18    Unsigned32
19        FROM SNMPv2-SMI
20    MODULE-COMPLIANCE,
21    NOTIFICATION-GROUP,
22    OBJECT-GROUP
23        FROM SNMPv2-CONF
24    RowStatus,
25    StorageType,
26    TruthValue
27        FROM SNMPv2-TC
28    sysName
29        FROM SNMPv2-MIB
30    SnmpAdminString
31        FROM SNMP-FRAMEWORK-MIB
32    InetAddressType,
33    InetAddress,
34    InetPortNumber
35        FROM INET-ADDRESS-MIB
36    CiscoGslbKeepaliveTargetType,
37    CiscoGslbKeepaliveMethod,
38    CiscoGslbKeepaliveRate,
39    CiscoGslbTerminationMethod,
40    CiscoGslbKeepaliveStatus,
41    CiscoGslbKalapType
42        FROM CISCO-GSLB-TC-MIB
43    cgdAnswerId
44        FROM CISCO-GSLB-DNS-MIB
45    ciscoMgmt
46        FROM CISCO-SMI;
47
48
49ciscoGslbHealthMonMIB MODULE-IDENTITY
50    LAST-UPDATED    "200704090000Z"
51    ORGANIZATION    "Cisco Systems, Inc."
52    CONTACT-INFO
53            "Cisco Systems
54            Customer Service
55
56            Postal: 170 W Tasman Drive
57            San Jose, CA  95134
58            USA
59
60            Tel: +1 800 553-NETS
61
62            E-mail: cs-slb@cisco.com"
63    DESCRIPTION
64        "The MIB defines objects related to global keepalive
65        properties in GSLB devices.  It contains the tables
66        for keep alive configuration and statistics.  It also
67        defines related notifications.
68
69        Acronyms and their description:
70
71        Keepalive    : Keepalive is a method by which the GSLB
72                       device periodically checks to see if a
73                       resource associated with an answer is
74                       still active.  The action of checking is
75                       known as a keepalive probe.
76
77        Shared
78        -keepalive   : The GSLB device supports the use of shared
79                       keepalives to minimize traffic between the
80                       GSLB device and the SLBs(Server Load
81                       Balancing) that it is monitoring.
82                       A shared keepalive identifies a common IP
83                       address or resource that provides status
84                       for multiple answers.  Shared keepalives
85                       periodically provide state information
86                       (online, offline) of the resources
87                       to the GSLB device.
88
89        VIP          : Virtual IP Addresses are used by SLBs to
90                       represent content hosted on one or more
91                       servers under their control.  The use of
92                       VIPs is to route content to the proper
93                       requesting host without exposing the
94                       device's internal IP address.
95
96        CAPP         : Content Application Peering Protocol(CAPP) is
97                       a protocol used for intercommunication between
98                       content switching devices.
99
100        Answer       : Refers to resources to which the GSLB device
101                       resolves DNS requests that it receives.
102
103                       There are three possible types of answers:
104
105                       Virtual IP (VIP) : Addresses associated with
106                                          a SLB, a web server, a
107                                          cache, etc.
108
109                       Name Server (NS) : Configured DNS name server
110                                          on the network that can
111                                          answer queries that the GSLB
112                                          device can not resolve.
113
114                       Content Routing  : A device which uses a
115                       Agent (CRA)        resolution process called
116                                          DNS race to send identical
117                                          and simultaneous responses
118                                          back to client D-proxy
119                                          for proximity determination.
120                       HTTPHEAD         : The HTTP HEAD keepalive type
121                                          sends a TCP format HTTP HEAD
122                                          request to a web server at
123                                          an address you specify,
124                                          returning the online status
125                                          of the device (in the form
126                                          of a 200 response) as well
127                                          as information on the web
128                                          page status and content
129                                          size."
130    REVISION        "200704090000Z"
131    DESCRIPTION
132        "-Added the following objects to ciscoGslbGeneralConfigGroup:
133        cghMonDroppedKalNotifs
134        cghMonKalTrapRateLimit
135
136        -Added a new group ciscoGslbGeneralConfigRateLimitGroup."
137    REVISION        "200612040000Z"
138    DESCRIPTION
139        "Initial version of this MIB module."
140    ::= { ciscoMgmt 600 }
141
142
143ciscoGslbHealthMonMIBNotifs  OBJECT IDENTIFIER
144    ::= { ciscoGslbHealthMonMIB 0 }
145
146ciscoGslbHealthMonMIBObjects  OBJECT IDENTIFIER
147    ::= { ciscoGslbHealthMonMIB 1 }
148
149ciscoGslbHealthMonMIBConform  OBJECT IDENTIFIER
150    ::= { ciscoGslbHealthMonMIB 2 }
151
152-- Objects for Notification Control
153
154cghMonNotifControl  OBJECT IDENTIFIER
155    ::= { ciscoGslbHealthMonMIBObjects 1 }
156
157-- Objects for Notification
158
159cghMonNotifObjects  OBJECT IDENTIFIER
160    ::= { ciscoGslbHealthMonMIBObjects 2 }
161
162-- Objects for General configuration, status and statistics
163
164cghMonKalGeneralConfig  OBJECT IDENTIFIER
165    ::= { ciscoGslbHealthMonMIBObjects 3 }
166
167-- Objects for per keepalive configuration, status and statistics
168
169cghMonKal  OBJECT IDENTIFIER
170    ::= { ciscoGslbHealthMonMIBObjects 4 }
171
172
173-- General Configuration Objects
174
175cghMonNsQueryDomainName OBJECT-TYPE
176    SYNTAX          SnmpAdminString
177    MAX-ACCESS      read-write
178    STATUS          current
179    DESCRIPTION
180        "This object specifies the default doman name for a
181        keepalive identified by cghMonKalMethod value of 'ns'."
182    DEFVAL          { "." }
183    ::= { cghMonKalGeneralConfig 1 }
184
185cghMonCappHash OBJECT-TYPE
186    SYNTAX          SnmpAdminString
187    MAX-ACCESS      read-write
188    STATUS          current
189    DESCRIPTION
190        "This object specifies the default alphanumeric value used
191        to encrypt CAPP data.  A keepalive with cghMonKalMethod as
192        'kalap' uses CAPP for inter-communication between GSLB
193        devices."
194    DEFVAL          { "hash-not-set" }
195    ::= { cghMonKalGeneralConfig 2 }
196
197cghMonHttpHeadPath OBJECT-TYPE
198    SYNTAX          SnmpAdminString
199    MAX-ACCESS      read-write
200    STATUS          current
201    DESCRIPTION
202        "This object specifies the default path relative to the
203        server website, for a keepalive with cghMonKalMethod as
204        'httphead'."
205    DEFVAL          { "/" }
206    ::= { cghMonKalGeneralConfig 3 }
207
208cghMonHttpHeadConnTermMethod OBJECT-TYPE
209    SYNTAX          CiscoGslbTerminationMethod
210    MAX-ACCESS      read-write
211    STATUS          current
212    DESCRIPTION
213        "This object specifies the default connection termination
214        method for a keepalive with cghMonKalMethod as 'httphead'."
215    DEFVAL          { reset }
216    ::= { cghMonKalGeneralConfig 4 }
217
218cghMonTcpConnTermMethod OBJECT-TYPE
219    SYNTAX          CiscoGslbTerminationMethod
220    MAX-ACCESS      read-write
221    STATUS          current
222    DESCRIPTION
223        "This object specifies the default connection termination
224        method for a keepalive with cghMonKalMethod as 'tcp'."
225    DEFVAL          { reset }
226    ::= { cghMonKalGeneralConfig 5 }
227
228cghMonCraDecay OBJECT-TYPE
229    SYNTAX          Unsigned32 (1..65535 )
230    MAX-ACCESS      read-write
231    STATUS          current
232    DESCRIPTION
233        "This object is used for a keepalive with cghMonKalMethod
234        as 'cra', to specify how heavily GSLB should weigh recent
235        DNS Round Trip Time (RTT) probe results relative to earlier
236        RTT metrics, with 1 indicating that recent results should
237        not be weighed any more than previous RTT results."
238    DEFVAL          { 2 }
239    ::= { cghMonKalGeneralConfig 6 }
240
241cghMonTotalConfiguredProbes OBJECT-TYPE
242    SYNTAX          Unsigned32
243    MAX-ACCESS      read-only
244    STATUS          current
245    DESCRIPTION
246        "This object specifies the total number of keepalive probes
247        configured on the GSLB device by the administrator.  This
248        value corresponds to the number of entries in the
249        cghMonKalConfigTable."
250    ::= { cghMonKalGeneralConfig 7 }
251
252cghMonDroppedKalNotifs OBJECT-TYPE
253    SYNTAX          Unsigned32
254    UNITS           "traps"
255    MAX-ACCESS      read-only
256    STATUS          current
257    DESCRIPTION
258        "The value of this object is the total number of
259        ciscoGslbKalEventStatus notifications dropped
260        since the network management portion of the system
261        was last re-initialized. These notifications are dropped
262        when the limit configured in cghMonKalTrapRateLimit
263        is reached."
264    ::= { cghMonKalGeneralConfig 8 }
265
266cghMonKalTrapRateLimit OBJECT-TYPE
267    SYNTAX          Unsigned32 (1..65535)
268    UNITS           "traps per minute"
269    MAX-ACCESS      read-only
270    STATUS          current
271    DESCRIPTION
272        "This object specifies the maximum rate at which the
273        ciscoGslbKalEventStatus notifications can be sent."
274    DEFVAL          { 25 }
275    ::= { cghMonKalGeneralConfig 9 }
276
277cghMonKalParameterTable OBJECT-TYPE
278    SYNTAX          SEQUENCE OF CghMonKalParameterEntry
279    MAX-ACCESS      not-accessible
280    STATUS          current
281    DESCRIPTION
282        "This table is used to configure the default parameters
283        associated with each keepalive method, identified by
284        cghMonKalParameterMethod."
285    ::= { cghMonKalGeneralConfig 10 }
286
287cghMonKalParameterEntry OBJECT-TYPE
288    SYNTAX          CghMonKalParameterEntry
289    MAX-ACCESS      not-accessible
290    STATUS          current
291    DESCRIPTION
292        "An entry in cghMonKalParameterTable.  Each entry contains
293        default values for a keepalive probe method, identified by
294        cghMonKalParameterMethod.
295        Entries can be added/modified/deleted by administrator
296        action.  If the value of cghMonKalParameterStorageType
297        is 'permanent' then the corresponding entry cannot be
298        deleted."
299    INDEX           { cghMonKalParameterMethod }
300    ::= { cghMonKalParameterTable 1 }
301
302CghMonKalParameterEntry ::= SEQUENCE {
303        cghMonKalParameterMethod               CiscoGslbKeepaliveMethod,
304        cghMonKalParameterRate                 CiscoGslbKeepaliveRate,
305        cghMonKalParameterMinimumFrequency     Unsigned32,
306        cghMonKalParameterResponseTimeout      Unsigned32,
307        cghMonKalParameterFastRetries          Unsigned32,
308        cghMonKalParameterFastSuccessfulProbes Unsigned32,
309        cghMonKalParameterDestPort             InetPortNumber,
310        cghMonKalParameterStorageType          StorageType,
311        cghMonKalParameterRowStatus            RowStatus
312}
313
314cghMonKalParameterMethod OBJECT-TYPE
315    SYNTAX          CiscoGslbKeepaliveMethod
316    MAX-ACCESS      not-accessible
317    STATUS          current
318    DESCRIPTION
319        "This object specifies the method used for the keepalive."
320    ::= { cghMonKalParameterEntry 1 }
321
322cghMonKalParameterRate OBJECT-TYPE
323    SYNTAX          CiscoGslbKeepaliveRate
324    MAX-ACCESS      read-create
325    STATUS          current
326    DESCRIPTION
327        "This object specifies the global rate setting for a
328        keepalive method, identified by cghMonKalParameterMethod.
329        It is not valid when cghMonKalParameterMethod
330        is 'ns' or 'cra'."
331    ::= { cghMonKalParameterEntry 2 }
332
333cghMonKalParameterMinimumFrequency OBJECT-TYPE
334    SYNTAX          Unsigned32 (1..65535 )
335    UNITS           "seconds"
336    MAX-ACCESS      read-create
337    STATUS          current
338    DESCRIPTION
339        "This object specifies the minimum interval with which the
340        GSLB device attempts to schedule keepalives.
341
342        It is valid when cghMonKalParameterMethod is 'cra' or 'ns'.
343        And also, it is valid when cghMonKalParameterMethod is
344        'tcp', 'icmp', 'httphead' or 'kalap', provided
345        cghMonKalParameterRate is 'standard'."
346    ::= { cghMonKalParameterEntry 3 }
347
348cghMonKalParameterResponseTimeout OBJECT-TYPE
349    SYNTAX          Unsigned32 (1..65535 )
350    UNITS           "seconds"
351    MAX-ACCESS      read-create
352    STATUS          current
353    DESCRIPTION
354        "This object specifies the length of time allowed
355        before retransmission of data to a device that is
356        not responding to a request.
357
358        This object is valid when cghMonKalParameterMethod
359        is 'tcp' or 'httphead', provided
360        cghMonKalParameterRate is 'standard'."
361    ::= { cghMonKalParameterEntry 4 }
362
363cghMonKalParameterFastRetries OBJECT-TYPE
364    SYNTAX          Unsigned32 (1..65535 )
365    UNITS           "retries"
366    MAX-ACCESS      read-create
367    STATUS          current
368    DESCRIPTION
369        "This object specifies the number of times that the GSLB
370        device retransmits a packet before declaring an answer
371        offline.
372
373        This object is valid when cghMonKalParameterRate
374        is 'fast'."
375    ::= { cghMonKalParameterEntry 5 }
376
377cghMonKalParameterFastSuccessfulProbes OBJECT-TYPE
378    SYNTAX          Unsigned32 (1..65535 )
379    UNITS           "probes"
380    MAX-ACCESS      read-create
381    STATUS          current
382    DESCRIPTION
383        "This object specifies the number of consecutive successful
384        keepalive attempts (probes) that must be recognized by the
385        GSLB device before bringing an answer back online (and
386        reintroducing it into the GSLB network).
387
388        This object is valid when cghMonKalParameterRate is 'fast'."
389    ::= { cghMonKalParameterEntry 6 }
390
391cghMonKalParameterDestPort OBJECT-TYPE
392    SYNTAX          InetPortNumber (1..65535 )
393    MAX-ACCESS      read-create
394    STATUS          current
395    DESCRIPTION
396        "This object specifies the port on the remote device,
397        identified by cgdAnswerAddress, to which the
398        keepalive is sent.
399
400        This object is valid when cghMonKalParameterMethod is
401        'tcp' or 'httphead'."
402    REFERENCE       "cgdAnswerAddress from CISCO-GSLB-DNS-MIB."
403    ::= { cghMonKalParameterEntry 7 }
404
405cghMonKalParameterStorageType OBJECT-TYPE
406    SYNTAX          StorageType
407    MAX-ACCESS      read-create
408    STATUS          current
409    DESCRIPTION
410        "This object specifies the storage type for this conceptual
411        row.  If the value of this object in the row is 'permanent',
412        then that corresponding row cannot be deleted, it can only
413        be modified."
414    DEFVAL          { nonVolatile }
415    ::= { cghMonKalParameterEntry 8 }
416
417cghMonKalParameterRowStatus OBJECT-TYPE
418    SYNTAX          RowStatus
419    MAX-ACCESS      read-create
420    STATUS          current
421    DESCRIPTION
422        "This object is used to create/delete an entry in the
423        cghMonKalParameterTable."
424    ::= { cghMonKalParameterEntry 9 }
425
426
427
428cghMonKalConfigTable OBJECT-TYPE
429    SYNTAX          SEQUENCE OF CghMonKalConfigEntry
430    MAX-ACCESS      not-accessible
431    STATUS          current
432    DESCRIPTION
433        "This table is used for configuring keepalives.
434        It consists a list of configuration entries for
435        each keepalive configured."
436    ::= { cghMonKal 1 }
437
438cghMonKalConfigEntry OBJECT-TYPE
439    SYNTAX          CghMonKalConfigEntry
440    MAX-ACCESS      not-accessible
441    STATUS          current
442    DESCRIPTION
443        "An entry containing configuration entities for a keepalive
444        instance.  Entries can be added/deleted/modified by
445        administrator action.
446
447        The following objects are mandatory for a row creation:
448            cghMonKalMethod
449            cghMonKalTargetType."
450    INDEX           { cghMonKalId }
451    ::= { cghMonKalConfigTable 1 }
452
453CghMonKalConfigEntry ::= SEQUENCE {
454        cghMonKalId                   Unsigned32,
455        cghMonKalTargetType           CiscoGslbKeepaliveTargetType,
456        cghMonKalMethod               CiscoGslbKeepaliveMethod,
457        cghMonKalAnswerId             Unsigned32,
458        cghMonKalPrimaryTargetType    InetAddressType,
459        cghMonKalPrimaryTarget        InetAddress,
460        cghMonKalEnable               TruthValue,
461        cghMonKalDelay                Unsigned32,
462        cghMonKalKalapType            CiscoGslbKalapType,
463        cghMonKalTagName              SnmpAdminString,
464        cghMonKalDestPort             InetPortNumber,
465        cghMonKalCappSecure           TruthValue,
466        cghMonKalCappHash             SnmpAdminString,
467        cghMonKalQueryDomainName      SnmpAdminString,
468        cghMonKalPath                 SnmpAdminString,
469        cghMonKalHostTag              SnmpAdminString,
470        cghMonKalSecondaryTargetType  InetAddressType,
471        cghMonKalSecondaryTarget      InetAddress,
472        cghMonKalFastRetries          Unsigned32,
473        cghMonKalFastSuccessfulProbes Unsigned32,
474        cghMonKalStorageType          StorageType,
475        cghMonKalRowStatus            RowStatus
476}
477
478cghMonKalId OBJECT-TYPE
479    SYNTAX          Unsigned32 (1..65535 )
480    MAX-ACCESS      not-accessible
481    STATUS          current
482    DESCRIPTION
483        "This object uniquely identifies a keepalive."
484    ::= { cghMonKalConfigEntry 1 }
485
486cghMonKalTargetType OBJECT-TYPE
487    SYNTAX          CiscoGslbKeepaliveTargetType
488    MAX-ACCESS      read-create
489    STATUS          current
490    DESCRIPTION
491        "This object specifies the answer type to which this
492        keepalive is associated."
493    ::= { cghMonKalConfigEntry 2 }
494
495cghMonKalMethod OBJECT-TYPE
496    SYNTAX          CiscoGslbKeepaliveMethod
497    MAX-ACCESS      read-create
498    STATUS          current
499    DESCRIPTION
500        "This object specifies the keepalive method."
501    ::= { cghMonKalConfigEntry 3 }
502
503cghMonKalAnswerId OBJECT-TYPE
504    SYNTAX          Unsigned32
505    MAX-ACCESS      read-create
506    STATUS          current
507    DESCRIPTION
508        "This object is used to associate an answer with this
509        keepalive instance.  Its value must be same as the
510        value configured in cgdAnswerTable.
511
512        This object is mandatory for a row creation, the only
513        expection being when cghMonKalTargetType has a value
514        'shared'."
515    REFERENCE       "cgdAnswerTable from CISCO-GSLB-DNS-MIB."
516    ::= { cghMonKalConfigEntry 4 }
517
518cghMonKalPrimaryTargetType OBJECT-TYPE
519    SYNTAX          InetAddressType
520    MAX-ACCESS      read-create
521    STATUS          current
522    DESCRIPTION
523        "This object specifies the primary target device IP address
524        type used by this keepalive."
525    DEFVAL          { ipv4 }
526    ::= { cghMonKalConfigEntry 5 }
527
528cghMonKalPrimaryTarget OBJECT-TYPE
529    SYNTAX          InetAddress
530    MAX-ACCESS      read-create
531    STATUS          current
532    DESCRIPTION
533        "This object specifies the primary target device IP
534        address used by this keepalive.  The type of IP address
535        is identified by cghMonKalPrimaryTargetType.
536
537        This object is mandatory provided cghMonKalTargetType
538        is 'shared'."
539    DEFVAL          { "" }
540    ::= { cghMonKalConfigEntry 6 }
541
542cghMonKalEnable OBJECT-TYPE
543    SYNTAX          TruthValue
544    MAX-ACCESS      read-create
545    STATUS          current
546    DESCRIPTION
547        "This object is used to activate/deactivate a keepalive by
548        setting the state to either 'true'/'false' respectively."
549    DEFVAL          { false }
550    ::= { cghMonKalConfigEntry 7 }
551
552cghMonKalDelay OBJECT-TYPE
553    SYNTAX          Unsigned32
554    UNITS           "milliseconds"
555    MAX-ACCESS      read-create
556    STATUS          current
557    DESCRIPTION
558        "This object specifies one-way delay time in milliseconds.
559        This value is used by the GSLB device to calculate a
560        static round-trip time (RTT), with the one-way delay
561        constituting one-half of the round-trip time.
562        This object is valid when cghMonKalMethod is 'cra' provided
563        cghMonKalEnable is 'false'."
564    DEFVAL          { 0 }
565    ::= { cghMonKalConfigEntry 8 }
566
567cghMonKalKalapType OBJECT-TYPE
568    SYNTAX          CiscoGslbKalapType
569    MAX-ACCESS      read-create
570    STATUS          current
571    DESCRIPTION
572        "This object specifies the type of kalap for a keepalive.
573        This object is valid when cghMonKalTargetType is 'kalap'."
574    DEFVAL          { kalapByVip }
575    ::= { cghMonKalConfigEntry 9 }
576
577cghMonKalTagName OBJECT-TYPE
578    SYNTAX          SnmpAdminString
579    MAX-ACCESS      read-create
580    STATUS          current
581    DESCRIPTION
582        "This object specifies the tag for identifying a specific
583        target, identified by cgdAnswerAddress object, on
584        content switching device.  This object is valid when
585        cghMonKalMethod is 'kalap' provided cghMonKalKalapType is
586        'kalapByTag'."
587    REFERENCE       "cgdAnswerAddress from CISCO-GSLB-DNS-MIB."
588    DEFVAL          { "" }
589    ::= { cghMonKalConfigEntry 10 }
590
591cghMonKalDestPort OBJECT-TYPE
592    SYNTAX          InetPortNumber (1..65535 )
593    MAX-ACCESS      read-create
594    STATUS          current
595    DESCRIPTION
596        "This object specifies the port on the remote device that
597        is to receive the TCP/HTTPHEAD keepalive probe from the
598        GSLB device.
599        The default value for this object is got from
600        cghMonKalParameterDestPort in the default properties
601        table (cghMonKalParameterTable)."
602    ::= { cghMonKalConfigEntry 11 }
603
604cghMonKalCappSecure OBJECT-TYPE
605    SYNTAX          TruthValue
606    MAX-ACCESS      read-create
607    STATUS          current
608    DESCRIPTION
609        "This object specifies whether or not the keepalive uses
610        CAPP encryption.
611        This object is valid when cghMonKalMethod is 'kalap'."
612    DEFVAL          { false }
613    ::= { cghMonKalConfigEntry 12 }
614
615cghMonKalCappHash OBJECT-TYPE
616    SYNTAX          SnmpAdminString
617    MAX-ACCESS      read-create
618    STATUS          current
619    DESCRIPTION
620        "This object specifies the alphanumeric value used to
621        encrypt interbox communications, which uses CAPP.  The
622        same value needs to be the configured on the remote GSLB
623        device, identified by cgdAnswerAddress .
624        This object is valid when cghMonKalMethod is 'kalap'
625        provided cghMonKalCappSecure is 'true'.
626        The default for this object is the value of
627        cghMonCappHash."
628    REFERENCE       "cgdAnswerAddress from CISCO-GSLB-DNS-MIB."
629    ::= { cghMonKalConfigEntry 13 }
630
631cghMonKalQueryDomainName OBJECT-TYPE
632    SYNTAX          SnmpAdminString
633    MAX-ACCESS      read-create
634    STATUS          current
635    DESCRIPTION
636        "This object specifies the name of the domain name server
637        to which an ns keepalive is sent.
638        The default for this object is the value of
639        cghMonNsQueryDomainName."
640    ::= { cghMonKalConfigEntry 14 }
641
642cghMonKalPath OBJECT-TYPE
643    SYNTAX          SnmpAdminString
644    MAX-ACCESS      read-create
645    STATUS          current
646    DESCRIPTION
647        "This object specifies the server website queried in
648        HTTPHEAD keepalive.  The default for this object is the
649        value of cghMonHttpHeadPath."
650    ::= { cghMonKalConfigEntry 15 }
651
652cghMonKalHostTag OBJECT-TYPE
653    SYNTAX          SnmpAdminString
654    MAX-ACCESS      read-create
655    STATUS          current
656    DESCRIPTION
657        "This object specifies an optional domain name that is sent
658        to the VIP as part of the HTTPHEAD query.  This tag allows
659        an SLB to resolve the keepalive request to a particular
660        website even when multiple sites are represented by the
661        same VIP.
662        This is object is valid when cghMonKalMethod is 'httphead'."
663    DEFVAL          { "" }
664    ::= { cghMonKalConfigEntry 16 }
665
666cghMonKalSecondaryTargetType OBJECT-TYPE
667    SYNTAX          InetAddressType
668    MAX-ACCESS      read-create
669    STATUS          current
670    DESCRIPTION
671        "This object specifies the secondary target device IP
672        address type used by this keepalive.
673        This object is valid when cghMonKalMethod is 'kalap'."
674    DEFVAL          { ipv4 }
675    ::= { cghMonKalConfigEntry 17 }
676
677cghMonKalSecondaryTarget OBJECT-TYPE
678    SYNTAX          InetAddress
679    MAX-ACCESS      read-create
680    STATUS          current
681    DESCRIPTION
682        "This object specifies the secondary target device IP
683        address used by this keepalive.  The type of IP address is
684        identified by cghMonKalSecondaryTargetType object.
685        Secondary target is used when the primary target is
686        not available.
687        This object is valid when cghMonKalMethod is 'kalap'."
688    DEFVAL          { "" }
689    ::= { cghMonKalConfigEntry 18 }
690
691cghMonKalFastRetries OBJECT-TYPE
692    SYNTAX          Unsigned32
693    UNITS           "retries"
694    MAX-ACCESS      read-create
695    STATUS          current
696    DESCRIPTION
697        "This object specifies the number of times the GSLB device
698        retransmits a keepalive probe before declaring the target,
699        identified by cgdAnswerAddress, offline.
700        The value of this object is by default got from the
701        default properties table (cghMonKalParameterTable), from
702        the row identified by cghMonKalMethod."
703    REFERENCE       "cgdAnswerAddress from CISCO-GSLB-DNS-MIB."
704    ::= { cghMonKalConfigEntry 19 }
705
706cghMonKalFastSuccessfulProbes OBJECT-TYPE
707    SYNTAX          Unsigned32
708    UNITS           "probes"
709    MAX-ACCESS      read-create
710    STATUS          current
711    DESCRIPTION
712        "This object specifies the number of consecutive successful
713        keepalive attempts that must be recognized by the GSLB
714        device before bringing an answer back online.
715        The value of this object is by default got from the
716        default properties table (cghMonKalParameterTable), from
717        the row identified by cghMonKalMethod."
718    ::= { cghMonKalConfigEntry 20 }
719
720cghMonKalStorageType OBJECT-TYPE
721    SYNTAX          StorageType
722    MAX-ACCESS      read-create
723    STATUS          current
724    DESCRIPTION
725        "This object specifies the storage type for this
726        conceptual row."
727    DEFVAL          { nonVolatile }
728    ::= { cghMonKalConfigEntry 21 }
729
730cghMonKalRowStatus OBJECT-TYPE
731    SYNTAX          RowStatus
732    MAX-ACCESS      read-create
733    STATUS          current
734    DESCRIPTION
735        "This object is used to create/delete an entry in the
736        cghMonKalConfigTable."
737    ::= { cghMonKalConfigEntry 22 }
738
739
740
741cghMonKalSharedAnswerTable OBJECT-TYPE
742    SYNTAX          SEQUENCE OF CghMonKalSharedAnswerEntry
743    MAX-ACCESS      not-accessible
744    STATUS          current
745    DESCRIPTION
746        "This table is used for associating a shared keepalive with
747        an answer."
748    ::= { cghMonKal 2 }
749
750cghMonKalSharedAnswerEntry OBJECT-TYPE
751    SYNTAX          CghMonKalSharedAnswerEntry
752    MAX-ACCESS      not-accessible
753    STATUS          current
754    DESCRIPTION
755        "An entry containing the per shared keepalive to answer
756        association.  Entries can be added/deleted by
757        administrator action.  Entries are added when a shared
758        keepalive is required to be associated with an answer."
759    INDEX           {
760                        cgdAnswerId,
761                        cghMonKalId
762                    }
763    ::= { cghMonKalSharedAnswerTable 1 }
764
765CghMonKalSharedAnswerEntry ::= SEQUENCE {
766        cghMonKalShAnsStoragetype StorageType,
767        cghMonKalShAnsRowStatus   RowStatus
768}
769
770cghMonKalShAnsStoragetype OBJECT-TYPE
771    SYNTAX          StorageType
772    MAX-ACCESS      read-create
773    STATUS          current
774    DESCRIPTION
775        "This object specifies the storage type for this
776        conceptual row."
777    DEFVAL          { nonVolatile }
778    ::= { cghMonKalSharedAnswerEntry 1 }
779
780cghMonKalShAnsRowStatus OBJECT-TYPE
781    SYNTAX          RowStatus
782    MAX-ACCESS      read-create
783    STATUS          current
784    DESCRIPTION
785        "This object is used to create/delete an entry in the
786        cghMonKalSharedAnswerTable."
787    ::= { cghMonKalSharedAnswerEntry 2 }
788
789
790-- Keepalive Statistics Table
791
792cghMonKalStatsTable OBJECT-TYPE
793    SYNTAX          SEQUENCE OF CghMonKalStatsEntry
794    MAX-ACCESS      not-accessible
795    STATUS          current
796    DESCRIPTION
797        "This table provides the statistics of each keepalive
798        configured on the device."
799    ::= { cghMonKal 3 }
800
801cghMonKalStatsEntry OBJECT-TYPE
802    SYNTAX          CghMonKalStatsEntry
803    MAX-ACCESS      not-accessible
804    STATUS          current
805    DESCRIPTION
806        "An entry containing statistics for a keepalive instance.
807        Entries are added/deleted when the corresponding entries
808        in the cghMonKalConfigTable are added/deleted."
809    AUGMENTS           { cghMonKalConfigEntry  }
810
811    ::= { cghMonKalStatsTable 1 }
812
813CghMonKalStatsEntry ::= SEQUENCE {
814        cghMonKalStatus            CiscoGslbKeepaliveStatus,
815        cghMonKalSentProbes        Counter32,
816        cghMonKalReceivedProbes    Counter32,
817        cghMonKalPositiveProbes    Counter32,
818        cghMonKalNegativeProbes    Counter32,
819        cghMonKalStatusTransitions Counter32,
820        cghMonKalDynamicLoad       Unsigned32,
821        cghMonKalVIPFailovers      Counter32
822}
823
824cghMonKalStatus OBJECT-TYPE
825    SYNTAX          CiscoGslbKeepaliveStatus
826    MAX-ACCESS      read-only
827    STATUS          current
828    DESCRIPTION
829        "This object provides the status of the keepalive."
830    ::= { cghMonKalStatsEntry 1 }
831
832cghMonKalSentProbes OBJECT-TYPE
833    SYNTAX          Counter32
834    UNITS           "probes"
835    MAX-ACCESS      read-only
836    STATUS          current
837    DESCRIPTION
838        "This object specifies the total number of keepalive probes
839        sent to the remote device, identified by
840        cgdAnswerAddress.  This value of this object is sum
841        of cghMonKalPositiveProbes & cghMonKalNegativeProbes"
842    REFERENCE       "cgdAnswerAddress from CISCO-GSLB-DNS-MIB."
843    ::= { cghMonKalStatsEntry 2 }
844
845cghMonKalReceivedProbes OBJECT-TYPE
846    SYNTAX          Counter32
847    UNITS           "probes"
848    MAX-ACCESS      read-only
849    STATUS          current
850    DESCRIPTION
851        "This object specifies the total number of keepalive probes
852        received from the remote device, identified by
853        cgdAnswerAddress object."
854    REFERENCE       "cgdAnswerAddress from CISCO-GSLB-DNS-MIB."
855    ::= { cghMonKalStatsEntry 3 }
856
857cghMonKalPositiveProbes OBJECT-TYPE
858    SYNTAX          Counter32
859    UNITS           "probes"
860    MAX-ACCESS      read-only
861    STATUS          current
862    DESCRIPTION
863        "This object specifies the total number of keepalive probes
864        sent to the remote device, identified by
865        cgdAnswerAddress object, that resulted in a positive
866        response."
867    REFERENCE       "cgdAnswerAddress from CISCO-GSLB-DNS-MIB."
868    ::= { cghMonKalStatsEntry 4 }
869
870cghMonKalNegativeProbes OBJECT-TYPE
871    SYNTAX          Counter32
872    UNITS           "probes"
873    MAX-ACCESS      read-only
874    STATUS          current
875    DESCRIPTION
876        "This object specifies the total number of keepalive probes
877        sent to the remote device, identified by
878        cgdAnswerAddress object, that resulted in a negative
879        response."
880    REFERENCE       "cgdAnswerAddress from CISCO-GSLB-DNS-MIB."
881    ::= { cghMonKalStatsEntry 5 }
882
883cghMonKalStatusTransitions OBJECT-TYPE
884    SYNTAX          Counter32
885    MAX-ACCESS      read-only
886    STATUS          current
887    DESCRIPTION
888        "This object specifies the total number of status
889        transitions of cghMonKalStatus, from 'offline' to
890        'online' and vice versa."
891    ::= { cghMonKalStatsEntry 6 }
892
893cghMonKalDynamicLoad OBJECT-TYPE
894    SYNTAX          Unsigned32
895    MAX-ACCESS      read-only
896    STATUS          current
897    DESCRIPTION
898        "This object speifies the dynamic load value on the remote
899        device, identified by cgdAnswerAddress object,
900        associated with this keepalive."
901    REFERENCE       "cgdAnswerAddress from CISCO-GSLB-DNS-MIB."
902    ::= { cghMonKalStatsEntry 7 }
903
904cghMonKalVIPFailovers OBJECT-TYPE
905    SYNTAX          Counter32
906    MAX-ACCESS      read-only
907    STATUS          current
908    DESCRIPTION
909        "This object specifies the number of times the VIP switched
910        from primary to secondary target and vice versa.
911        The primary and secondary targets are identified by
912        cghMonKalSecondaryTarget and cghMonKalPrimaryTarget
913        objects respectively."
914    ::= { cghMonKalStatsEntry 8 }
915
916
917
918-- Notification Control Group
919
920cghMonKalNotifEnable OBJECT-TYPE
921    SYNTAX          TruthValue
922    MAX-ACCESS      read-write
923    STATUS          current
924    DESCRIPTION
925        "This object defines the administrative state of sending
926        notifications to signal the transition of the status of
927        keepalives."
928    DEFVAL          { false }
929    ::= { cghMonNotifControl 1 }
930
931-- Objects for Notification
932
933cghMonKalPrevStatus OBJECT-TYPE
934    SYNTAX          CiscoGslbKeepaliveStatus
935    MAX-ACCESS      accessible-for-notify
936    STATUS          current
937    DESCRIPTION
938        "This object is used for sending the value of
939        cghMonKalStatus before transitioning to new state."
940    ::= { cghMonNotifObjects 1 }
941
942-- Notifications
943
944ciscoGslbKalEventStatus NOTIFICATION-TYPE
945    OBJECTS         {
946                        sysName,
947                        cghMonKalPrimaryTargetType,
948                        cghMonKalPrimaryTarget,
949                        cghMonKalMethod,
950                        cghMonKalPrevStatus,
951                        cghMonKalStatus,
952                        cghMonDroppedKalNotifs
953                    }
954    STATUS          current
955    DESCRIPTION
956        "This notification is sent when ever the value of
957        cghMonKalStatus changes."
958   ::= { ciscoGslbHealthMonMIBNotifs 1 }
959-- Conformance
960
961ciscoGslbHealthMonMIBCompliances  OBJECT IDENTIFIER
962    ::= { ciscoGslbHealthMonMIBConform 1 }
963
964ciscoGslbHealthMonMIBGroups  OBJECT IDENTIFIER
965    ::= { ciscoGslbHealthMonMIBConform 2 }
966
967
968-- Compliance
969
970ciscoGslbHealthMonMIBCompliance MODULE-COMPLIANCE
971    STATUS          deprecated
972    DESCRIPTION
973        "Compliance statement for entities which implement
974        the Cisco GSLB HEALTH MON MIB"
975    MODULE          -- this module
976    MANDATORY-GROUPS {
977                        ciscoGslbGeneralConfigGroup,
978                        ciscoGslbKalParameterGroup,
979                        ciscoGslbKalConfigGroup,
980                        ciscoGslbKalStatsGroup,
981                        ciscoGslbKalNotifControlGroup,
982                        ciscoGslbKalNotifObjectsGroup,
983                        ciscoGslbKalNotificationGroup,
984                        ciscoGslbGeneralConfigRateLimitGroup
985                    }
986    ::= { ciscoGslbHealthMonMIBCompliances 1 }
987
988-- Units of Conformance
989
990ciscoGslbGeneralConfigGroup OBJECT-GROUP
991    OBJECTS         {
992                        cghMonNsQueryDomainName,
993                        cghMonCappHash,
994                        cghMonHttpHeadPath,
995                        cghMonHttpHeadConnTermMethod,
996                        cghMonCraDecay,
997                        cghMonTcpConnTermMethod,
998                        cghMonTotalConfiguredProbes,
999                        cghMonDroppedKalNotifs,
1000                        cghMonKalTrapRateLimit
1001                    }
1002    STATUS          current
1003    DESCRIPTION
1004        "A collection of objects providing general GSLB keepalive
1005        configuration."
1006    ::= { ciscoGslbHealthMonMIBGroups 1 }
1007
1008ciscoGslbKalParameterGroup OBJECT-GROUP
1009    OBJECTS         {
1010                        cghMonKalParameterRate,
1011                        cghMonKalParameterMinimumFrequency,
1012                        cghMonKalParameterResponseTimeout,
1013                        cghMonKalParameterFastRetries,
1014                        cghMonKalParameterFastSuccessfulProbes,
1015                        cghMonKalParameterDestPort,
1016                        cghMonKalParameterStorageType,
1017                        cghMonKalParameterRowStatus
1018                    }
1019    STATUS          current
1020    DESCRIPTION
1021        "A collection of objects providing general GSLB keepalive
1022        parameter configuration."
1023    ::= { ciscoGslbHealthMonMIBGroups 2 }
1024
1025ciscoGslbKalConfigGroup OBJECT-GROUP
1026    OBJECTS         {
1027                        cghMonKalTargetType,
1028                        cghMonKalMethod,
1029                        cghMonKalAnswerId,
1030                        cghMonKalPrimaryTargetType,
1031                        cghMonKalPrimaryTarget,
1032                        cghMonKalEnable,
1033                        cghMonKalDelay,
1034                        cghMonKalKalapType,
1035                        cghMonKalTagName,
1036                        cghMonKalDestPort,
1037                        cghMonKalCappSecure,
1038                        cghMonKalCappHash,
1039                        cghMonKalQueryDomainName,
1040                        cghMonKalPath,
1041                        cghMonKalHostTag,
1042                        cghMonKalSecondaryTargetType,
1043                        cghMonKalSecondaryTarget,
1044                        cghMonKalFastRetries,
1045                        cghMonKalFastSuccessfulProbes,
1046                        cghMonKalStorageType,
1047                        cghMonKalRowStatus,
1048                        cghMonKalShAnsStoragetype,
1049                        cghMonKalShAnsRowStatus
1050                    }
1051    STATUS          current
1052    DESCRIPTION
1053        "A collection of objects providing per keepalive
1054        configuration."
1055    ::= { ciscoGslbHealthMonMIBGroups 3 }
1056
1057ciscoGslbKalStatsGroup OBJECT-GROUP
1058    OBJECTS         {
1059                        cghMonKalStatus,
1060                        cghMonKalSentProbes,
1061                        cghMonKalReceivedProbes,
1062                        cghMonKalPositiveProbes,
1063                        cghMonKalNegativeProbes,
1064                        cghMonKalStatusTransitions,
1065                        cghMonKalDynamicLoad,
1066                        cghMonKalVIPFailovers
1067                    }
1068    STATUS          current
1069    DESCRIPTION
1070        "A collection of objects providing per keepalive
1071        status and statistics."
1072    ::= { ciscoGslbHealthMonMIBGroups 4 }
1073
1074ciscoGslbKalNotifControlGroup OBJECT-GROUP
1075    OBJECTS         { cghMonKalNotifEnable }
1076    STATUS          current
1077    DESCRIPTION
1078        "This group of objects controls the sending of
1079        notifications defined in this MIB module."
1080    ::= { ciscoGslbHealthMonMIBGroups 5 }
1081
1082ciscoGslbKalNotifObjectsGroup OBJECT-GROUP
1083    OBJECTS         { cghMonKalPrevStatus }
1084    STATUS          current
1085    DESCRIPTION
1086        "This group of objects is used to convey information for
1087        notifications defined in this MIB module."
1088    ::= { ciscoGslbHealthMonMIBGroups 6 }
1089
1090ciscoGslbKalNotificationGroup NOTIFICATION-GROUP
1091   NOTIFICATIONS    { ciscoGslbKalEventStatus }
1092    STATUS          current
1093    DESCRIPTION
1094        "A collection of objects providing GSLB events."
1095    ::= { ciscoGslbHealthMonMIBGroups 7 }
1096
1097ciscoGslbGeneralConfigRateLimitGroup OBJECT-GROUP
1098    OBJECTS         {
1099                        cghMonDroppedKalNotifs,
1100                        cghMonKalTrapRateLimit
1101                    }
1102    STATUS          current
1103    DESCRIPTION
1104        "A collection of objects providing information on
1105        notifications dropped and rate limit for notifications."
1106    ::= { ciscoGslbHealthMonMIBGroups 8 }
1107
1108END
1109