MIBs Depot

CISCO-CSG-MIB

Registered at
1.3.6.1.4.1.9.9.331
Last updated
2003-02-20 00:00
Organization
Cisco Systems, Inc.
Revisions
2003-02-20 00:00
Namespace
cisco
Source file
CISCO-CSG-MIB
Digest
sha256:e9ac9783463ed9e2bbbdcf2149649285a5430b613d3ce2438a1dafd228a94a14

Description

This MIB supports the Cisco Content Services Gateway (CSG) product. It includes five traps and four tables that enable querying CSG resource statistics.

Contact

Cisco Systems Customer Service Postal: 170 W. Tasman Drive San Jose, CA 95134 USA tel: +1 800 553-NETS E-Mail: cs-csg@cisco.com

Imports

FromSymbols
CISCO-SMIciscoMgmt
INET-ADDRESS-MIBInetAddress, InetAddressType, InetPortNumber
SNMPv2-CONFMODULE-COMPLIANCE, NOTIFICATION-GROUP, OBJECT-GROUP
SNMPv2-SMICounter32, Counter64, Gauge32, MODULE-IDENTITY, NOTIFICATION-TYPE, OBJECT-IDENTITY, OBJECT-TYPE, Unsigned32, iso
SNMPv2-TCDisplayString, RowStatus, TEXTUAL-CONVENTION, TimeInterval, TruthValue

Imported by

Nothing in this corpus imports this module.

Load order

Every file a consumer needs in order to load this module, dependencies first.

CISCO-CSG-MIB
CISCO-SMI
INET-ADDRESS-MIB
SNMPv2-CONF
SNMPv2-SMI
SNMPv2-TC

Textual conventions

NameOIDSyntaxAccessStatus
CsgEntityName
TEXTUAL-CONVENTION
Name of a CSG entity. The CSG entities are 'user-group' and 'accounting'. The CsgEntityName is supported as octet string containing administrative information in human-readable form. The use of control codes should be avoided. The use of newline should be avoided. The use of leading or trailing white space should be avoided.
current
CsgServerPriority
TEXTUAL-CONVENTION
This convention applies to CSG billing mediation agents and quota managers. When multiple servers of the same type are defined, the priority defines the order of activation of the servers. The lowest priority value designates the highest priority.
current
CsgSlotNumber
TEXTUAL-CONVENTION
The card (slot) number of the CSG line card within the host switch. CSG line cards cannot occupy slot 0.
current
CsgUserTableUpperBound
TEXTUAL-CONVENTION
Upper bound on the number of entries in the user table.
current

Objects

NameOIDSyntaxAccessStatus
ciscoCsgMIBNotifs
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.331.0
ciscoCsgMIBObjects
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.331.1
csgScalars
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.331.1.1
csgAgentLostRecordTimer
OBJECT-TYPE
The time interval for monitoring the lost-record event (ciscoCsgAgentLostRecordEvent) of a billing mediation agent (BMA). A notification is issued when the CSG detects a lost BMA record. An interval timer is started with this value. When the timer expires the lost record count (csgAgentLostRecords) is checked. If the lost record count has increased since the previous the detection, the timer is restarted to monitor another period. If the lost record count has not increased since the previous detection, a final notification is sent to indicate that the condition has cleared.
1.3.6.1.4.1.9.9.331.1.1.1TimeIntervalread-writecurrent
csgQuotaMgrLostRecordTimer
OBJECT-TYPE
The time interval for monitoring the lost-record event (ciscoCsgQuotaMgrLostRecordEvent) of a quota manager. A notification is issued when the CSG detects a lost quota manager record. An interval timer is started with this value. When the timer expires the lost record count (csgQuotaMgrLostRecords) is checked. If the lost record count has increased since the previous the detection, the timer is restarted to monitor another period. If the lost record count has not increased since the previous detection, a final notification is sent to indicate that the condition has cleared.
1.3.6.1.4.1.9.9.331.1.1.2TimeIntervalread-writecurrent
csgUserStats
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.331.1.2
csgUserTable
OBJECT-TYPE
Table of User statistics. Columnar objects can be modified when the row is 'active'. Rows can be created and destroyed. Entries are added to this table via csgUserRowStatus in accordance with the RowStatus convention.
1.3.6.1.4.1.9.9.331.1.2.1not-accessiblecurrent
csgUserTableEntry
OBJECT-TYPE
Entry that defines parameters for the User Table.
1.3.6.1.4.1.9.9.331.1.2.1.1not-accessiblecurrent
csgUserCardId
OBJECT-TYPE
The slot number in the host switch in which the CSG card is inserted. This object is part of the index in all tables.
1.3.6.1.4.1.9.9.331.1.2.1.1.1CsgSlotNumbernot-accessiblecurrent
csgUserGroupName
OBJECT-TYPE
Name of associated user-group. This object is part of the index of this table and the csgUserDbTable.
1.3.6.1.4.1.9.9.331.1.2.1.1.2CsgEntityNamenot-accessiblecurrent
csgUserMaxEntries
OBJECT-TYPE
Maximum User Table entries.
1.3.6.1.4.1.9.9.331.1.2.1.1.3CsgUserTableUpperBoundread-createcurrent
csgUserCurrEntries
OBJECT-TYPE
Current number of user table entries.
1.3.6.1.4.1.9.9.331.1.2.1.1.4Gauge32read-onlycurrent
csgUserHighWater
OBJECT-TYPE
Highest number of entries inserted into User Table. The only write operation allowed is to reset the value to 0.
1.3.6.1.4.1.9.9.331.1.2.1.1.5CsgUserTableUpperBoundread-createcurrent
csgUserLRUSteals
OBJECT-TYPE
Number of User Table entries acquired from LRU list. When the User Table becomes full and a new user is detected, the least recently used User Table entry is allocated to the new user.
1.3.6.1.4.1.9.9.331.1.2.1.1.6Counter32read-onlycurrent
csgUserRowStatus
OBJECT-TYPE
This object is used by the manager to create or delete the row entry in the csgUserTable following the RowStatus textual convention. If this row is deleted, then accounting records subsequently generated by the associated CSG line card (identified by csgUserCardId) will not contain user information.
1.3.6.1.4.1.9.9.331.1.2.1.1.7RowStatusread-createcurrent
csgUserDataBaseStats
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.331.1.3
csgUserDbTable
OBJECT-TYPE
Table of user databases. Rows can be created and destroyed. Entries are added to this table via csgUserDbRowStatus in accordance with the RowStatus convention.
1.3.6.1.4.1.9.9.331.1.3.1not-accessiblecurrent
csgUserDbTableEntry
OBJECT-TYPE
Entry that defines parameters for a User Database. The User Database is a server that returns a userid given an IP address received in request.
1.3.6.1.4.1.9.9.331.1.3.1.1not-accessiblecurrent
csgUserDbIpAddrType
OBJECT-TYPE
Type of IP address of the user database.
1.3.6.1.4.1.9.9.331.1.3.1.1.1InetAddressTypenot-accessiblecurrent
csgUserDbIpAddr
OBJECT-TYPE
The IP address of the user database.
1.3.6.1.4.1.9.9.331.1.3.1.1.2InetAddressnot-accessiblecurrent
csgUserDbPort
OBJECT-TYPE
The listening UDP port of the user database.
1.3.6.1.4.1.9.9.331.1.3.1.1.3InetPortNumbernot-accessiblecurrent
csgUserDbState
OBJECT-TYPE
State of the user database. 'reset' - State before the database is determined to be active. 'active' - The database is available and processing requests. 'failed' - The database has failed and is not processing requests.
1.3.6.1.4.1.9.9.331.1.3.1.1.4INTEGER {reset(1), active(2), failed(3)}read-onlycurrent
csgUserDbRequests
OBJECT-TYPE
Number of user database requests.
1.3.6.1.4.1.9.9.331.1.3.1.1.5Counter64read-onlycurrent
csgUserDbUidsReturned
OBJECT-TYPE
Number of user identifiers returned.
1.3.6.1.4.1.9.9.331.1.3.1.1.6Counter64read-onlycurrent
csgUserDbReqResent
OBJECT-TYPE
Number of database requests resent.
1.3.6.1.4.1.9.9.331.1.3.1.1.7Counter32read-onlycurrent
csgUserDbReqTimeouts
OBJECT-TYPE
Number of user database requests that have timed out.
1.3.6.1.4.1.9.9.331.1.3.1.1.8Counter32read-onlycurrent
csgUserDbReqErrors
OBJECT-TYPE
Number of errors returned on user database requests.
1.3.6.1.4.1.9.9.331.1.3.1.1.9Counter32read-onlycurrent
csgUserDbRowStatus
OBJECT-TYPE
This object is used by the manager to create or delete the row entry in the csgUserDbTable following the RowStatus textual convention. This row can be deleted regardless of the value of csgUserDbState. Deletion of this row means that the associated database (identified by csgUserDbIpAddr and csgUserDbPort) is no longer available to the associated CSG card. If all csgUserDbTable rows have been deleted for a given CSG card, then other mechanisms, such as intercepting RADIUS flows, may be used to associate a user name with an IP address. If this is not possible, then the user name will be absent from generated accounting records.
1.3.6.1.4.1.9.9.331.1.3.1.1.10RowStatusread-createcurrent
csgAgentStats
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.331.1.4
csgAgentTable
OBJECT-TYPE
A table of billing mediation agents (BMAs). Columnar objects can be modified when the row is 'active'. Rows can be created and destroyed. Entries are added to this table via csgAgentRowStatus in accordance with the RowStatus convention. At least one BMA is required per CSG line card. Multiple BMAs can be configured for the purposes of load sharing and redundancy in the event of failure.
1.3.6.1.4.1.9.9.331.1.4.1not-accessiblecurrent
csgAgentTableEntry
OBJECT-TYPE
Entry that defines parameters for a mediation agent.
1.3.6.1.4.1.9.9.331.1.4.1.1not-accessiblecurrent
csgAgentIpAddrType
OBJECT-TYPE
Type of IP address of a BMA.
1.3.6.1.4.1.9.9.331.1.4.1.1.1InetAddressTypenot-accessiblecurrent
csgAgentIpAddr
OBJECT-TYPE
The IP address of a BMA.
1.3.6.1.4.1.9.9.331.1.4.1.1.2InetAddressnot-accessiblecurrent
csgAgentPort
OBJECT-TYPE
The UDP port of a BMA.
1.3.6.1.4.1.9.9.331.1.4.1.1.3InetPortNumbernot-accessiblecurrent
csgAgentAcctName
OBJECT-TYPE
Name of associated accounting service.
1.3.6.1.4.1.9.9.331.1.4.1.1.4CsgEntityNameread-createcurrent
csgAgentPriority
OBJECT-TYPE
The activation priority of a BMA. BMAs are activated in highest priority order. If multiple BMAs are active for load sharing, the highest priority BMAs available are activated. If an active BMA fails, the next highest priority BMA (in 'standby' state) is activated.
1.3.6.1.4.1.9.9.331.1.4.1.1.5CsgServerPriorityread-createcurrent
csgAgentState
OBJECT-TYPE
States of a billing mediation agent. 'standby' - The server is prepared to become active. 'failed' - The server has failed to respond to requests. 'active' - The server has been activated to receive requests. 'echowait' - CSG has sent an echo request to this billing mediation agent and is waiting for a response. 'nawait' - CSG has sent a node-alive request to this billing mediation agent and is waiting for a response. 'suspended' - The server has receive a stop request from the operator.
1.3.6.1.4.1.9.9.331.1.4.1.1.6INTEGER {standby(1), failed(2), active(3), echowait(4), nawait(5), suspended(6)}read-onlycurrent
csgAgentLostRecords
OBJECT-TYPE
Total number of lost records since system initialization or the last time the counter wrapped.
1.3.6.1.4.1.9.9.331.1.4.1.1.7Counter32read-onlycurrent
csgAgentTotalSent
OBJECT-TYPE
Total number of records sent to the billing mediation agent.
1.3.6.1.4.1.9.9.331.1.4.1.1.8Counter64read-onlycurrent
csgAgentFailAck
OBJECT-TYPE
Number of acknowledgments received from the billing mediation agent for which there are no outstanding requests.
1.3.6.1.4.1.9.9.331.1.4.1.1.9Counter32read-onlycurrent
csgAgentOutstanding
OBJECT-TYPE
Current number of messages waiting to be ACKed.
1.3.6.1.4.1.9.9.331.1.4.1.1.10Gauge32read-onlycurrent
csgAgentHighWater
OBJECT-TYPE
Highest number of messages waiting for ACKs. The only write operation allowed is to reset the value to 0.
1.3.6.1.4.1.9.9.331.1.4.1.1.11Unsigned32 (0..2147483647)read-createcurrent
csgAgentBadRecord
OBJECT-TYPE
The number of bad records received. These are records in which the CSG detected an error in attempting to decode the contents.
1.3.6.1.4.1.9.9.331.1.4.1.1.12Counter32read-onlycurrent
csgAgentRetransmit
OBJECT-TYPE
The number of messages retransmitted to the billing mediation agent.
1.3.6.1.4.1.9.9.331.1.4.1.1.13Counter32read-onlycurrent
csgAgentRowStatus
OBJECT-TYPE
This object is used by the manager to create or delete the row entry in the csgAgentTable following the RowStatus textual convention. Deletion of a row makes a BMA (identified by csgAgentIpAddr and csgAgentPort) unavailable to the associated CSG card. At least one BMA must be available to a CSG card. Therefore, deletion of the last BMA is not allowed. This row can be deleted regardless of the value of csgAgentState. Requests queued for the deleted BMA are requeued to another BMA.
1.3.6.1.4.1.9.9.331.1.4.1.1.14RowStatusread-createcurrent
csgQuotaMgrStats
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.331.1.5
csgQuotaMgrTable
OBJECT-TYPE
Table of CSG quota managers. Columnar objects can be modified when the row is 'active'. Rows can be created and destroyed. Entries are added to this table via csgAgentRowStatus in accordance with the RowStatus convention.
1.3.6.1.4.1.9.9.331.1.5.1not-accessiblecurrent
csgQuotaMgrTableEntry
OBJECT-TYPE
Entry that defines parameters for a quota manager.
1.3.6.1.4.1.9.9.331.1.5.1.1not-accessiblecurrent
csgQuotaMgrIpAddrType
OBJECT-TYPE
Type IP address of a quota manager.
1.3.6.1.4.1.9.9.331.1.5.1.1.1InetAddressTypenot-accessiblecurrent
csgQuotaMgrIpAddr
OBJECT-TYPE
The IP address of a quota manager.
1.3.6.1.4.1.9.9.331.1.5.1.1.2InetAddressnot-accessiblecurrent
csgQuotaMgrPort
OBJECT-TYPE
The UDP port of a quota manager.
1.3.6.1.4.1.9.9.331.1.5.1.1.3InetPortNumbernot-accessiblecurrent
csgQuotaMgrUserGroupName
OBJECT-TYPE
Name of associated user-group.
1.3.6.1.4.1.9.9.331.1.5.1.1.4CsgEntityNameread-onlycurrent
csgQuotaMgrPriority
OBJECT-TYPE
The priority of a quota manager.
1.3.6.1.4.1.9.9.331.1.5.1.1.5CsgServerPriorityread-createcurrent
csgQuotaMgrState
OBJECT-TYPE
States of a quota manager: 'standby' - The QuotaMgr is prepared to become active. 'failed' - The QuotaMgr has failed to respond to requests. 'active' - The QuotaMgr has been activated to receive requests. 'echowait' - CSG has sent an echo request to this QuotaMgr and is waiting for a response. 'nawait' - CSG has sent a node-alive request to this QuotaMgr and is waiting for a response. 'suspended' - The QuotaMgr has receive a stop request from the operator.
1.3.6.1.4.1.9.9.331.1.5.1.1.6INTEGER {standby(1), failed(2), active(3), echowait(4), nawait(5), suspended(6)}read-onlycurrent
csgQuotaMgrLostRecords
OBJECT-TYPE
Total number of lost records since system initialization or the last time the counter wrapped.
1.3.6.1.4.1.9.9.331.1.5.1.1.7Counter32read-onlycurrent
csgQuotaMgrTotalSent
OBJECT-TYPE
Total number of records sent to the quota manager.
1.3.6.1.4.1.9.9.331.1.5.1.1.8Counter64read-onlycurrent
csgQuotaMgrFailAck
OBJECT-TYPE
Number of acknowledgments received from the quota manager for which there are no requests.
1.3.6.1.4.1.9.9.331.1.5.1.1.9Counter32read-onlycurrent
csgQuotaMgrOutstanding
OBJECT-TYPE
Current number of messages waiting to be ACKed.
1.3.6.1.4.1.9.9.331.1.5.1.1.10Gauge32read-onlycurrent
csgQuotaMgrHighWater
OBJECT-TYPE
Highest number of messages waiting for ACKs. The only write operation allowed is to reset the value to 0.
1.3.6.1.4.1.9.9.331.1.5.1.1.11Unsigned32 (0..2147483647)read-createcurrent
csgQuotaMgrBadRecord
OBJECT-TYPE
The number of bad records received. These are records in which the CSG detected an error in attempting to decode the contents.
1.3.6.1.4.1.9.9.331.1.5.1.1.12Counter32read-onlycurrent
csgQuotaMgrRetransmit
OBJECT-TYPE
The number of messages retransmitted to the billing mediation agent.
1.3.6.1.4.1.9.9.331.1.5.1.1.13Counter32read-onlycurrent
csgQuotaMgrRowStatus
OBJECT-TYPE
This object is used by the manager to create or delete the row entry in the csgQuotaMgrTable following the RowStatus textual convention. Deletion of a row makes a QuotaMgr (identified by csgQuotaMgrIpAddr and csgQuotaMgrPort) unavailable to the associated CSG card. For the prepaid billing function, at least one QuotaMgr must be available to a CSG card. Therefore, deletion of the last QuotaMgr causes all accounting processing to switch to post-paid billing. This row can be deleted regardless of the value of csgQuotaMgrState. Requests queued for the deleted QuotaMgr are requeued to another QuotaMgr if one is available. If no QuotaMgr is available, processing reverts to post-paid billing.
1.3.6.1.4.1.9.9.331.1.5.1.1.14RowStatusread-createcurrent
csgNotifsEnable
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.331.1.6
csgAgentNotifsEnabled
OBJECT-TYPE
The CSG Agent notification truth value. 'true' Indicates that all defined notifications for CSG agents are enabled. 'false' Indicates that CSG Agent notification generation is disabled.
1.3.6.1.4.1.9.9.331.1.6.1TruthValueread-writecurrent
csgQuotaNotifsEnabled
OBJECT-TYPE
The CSG notification truth value. 'true' Indicates that all defined notifications for quota servers are enabled. 'false' Indicates that CSG quota server notifications generation are disabled.
1.3.6.1.4.1.9.9.331.1.6.2TruthValueread-writecurrent
csgDatabaseNotifsEnabled
OBJECT-TYPE
The CSG notification truth value. 'true' Indicates that all defined notifications for the CSG database are enabled. 'false' Indicates that CSG database notification generation is disabled.
1.3.6.1.4.1.9.9.331.1.6.3TruthValueread-writecurrent
ciscoCsgMIBConform
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.331.2
ciscoCsgMIBCompliances
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.331.2.1
ciscoCsgMIBGroups
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.331.2.2

Notifications

NameOIDStatus
ciscoCsgAgentStateChange
NOTIFICATION-TYPE
This notification is issued when csgAgentNotifsEnabled is set to 'true', and the billing mediation agent changes state. There is one exception: No notification is issued for state changes involving 'echowait' because this would cause an excessive number of notifications.
1.3.6.1.4.1.9.9.331.0.1current
ciscoCsgQuotaMgrStateChange
NOTIFICATION-TYPE
This notification is issued when csgQuotaNotifsEnabled is set to 'true', and the quota manager changes state. There is one exception: No notification is issued for state changes involving 'echowait' because this would cause an excessive number of notifications.
1.3.6.1.4.1.9.9.331.0.2current
ciscoCsgUserDbStateChange
NOTIFICATION-TYPE
This notification is issued when csgDatabaseNotifsEnabled is set to 'true', and the user database changes state.
1.3.6.1.4.1.9.9.331.0.3current
ciscoCsgAgentLostRecordEvent
NOTIFICATION-TYPE
This notification is issued when csgAgentNotifsEnabled is set to 'true', and the CSG must discard accounting records that should be sent to the billing mediation agent. Initially, csgAgentLostRecords is set to 0. When a record is discarded, csgAgentLostRecords is incremented, a period timer is started, and this notification is issued. The NMS and the agent save this value. The agent continues to increment csgAgentLostRecords each time a record is lost. When the period timer expires, the agent compares the current value of csgAgentLostRecords with the previous (saved) value. If the values are equal this notification is issued again, signalling to the NMS that the condition has been cleared. Otherwise, the timer is restarted to monitor the next period. When a record is lost and no period timer is active, this notification is issued and the above procedure is repeated.
1.3.6.1.4.1.9.9.331.0.4current
ciscoCsgQuotaMgrLostRecordEvent
NOTIFICATION-TYPE
This notification is issued when csgQuotaNotifsEnabled is set to 'true', and the CSG must discard request records to be sent to the quota manager. The processing is the same as described in the description for ciscoCsgAgentLostRecordEvent.
1.3.6.1.4.1.9.9.331.0.5current

Conformance

NameOIDStatus
ciscoCsgMIBCompliance
MODULE-COMPLIANCE
The compliance statement for entities which implement the Cisco CSG line card MIB.
1.3.6.1.4.1.9.9.331.2.1.1current
ciscoUserGroup
OBJECT-GROUP
CSG User Table Statistic objects.
1.3.6.1.4.1.9.9.331.2.2.1current
ciscoUserDbGroup
OBJECT-GROUP
CSG Statistic objects.
1.3.6.1.4.1.9.9.331.2.2.2current
ciscoAgentGroup
OBJECT-GROUP
CSG Statistic objects.
1.3.6.1.4.1.9.9.331.2.2.3current
ciscoQuotaMgrGroup
OBJECT-GROUP
CSG Statistic objects.
1.3.6.1.4.1.9.9.331.2.2.4current
ciscoCsgNotifEnableGroup
OBJECT-GROUP
CSG notifications enable/disable flags.
1.3.6.1.4.1.9.9.331.2.2.5current
ciscoCsgNotifGroup
NOTIFICATION-GROUP
A collection of objects providing CSG notifications.
1.3.6.1.4.1.9.9.331.2.2.6current