CISCO-PSD-CLIENT-MIB

All MIBs › CISCO-PSD-CLIENT-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2005-08-24

Category: Cisco Devices

Description: Manages Packet Stream Dispatcher client configuration and statistics on Cisco high-performance routing platforms.

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-PSD-CLIENT-MIB?

CISCO-PSD-CLIENT-MIB manages the client-side functionality of Cisco's Persistent Storage Device (PSD) feature, used on GGSN (Gateway GPRS Support Node) and Content Services Gateway (CSG) platforms to buffer Call Detail Records locally when they cannot be delivered to a Charging Gateway. It exposes both configuration objects, such as a data-store table with auto-retrieve settings and row status, and performance/fault counters covering read/write requests, retransmissions, and disk-full events. This MIB is heavily used for monitoring software/storage health of the PSD client: counters like cPsdClientDSWriteReq, cPsdClientDSReadReq, cPsdClientDSRdWrRetrans, and especially cPsdClientDSDiskFullTrans directly reveal whether the local persistent store is keeping up with CDR traffic or is filling up and at risk of losing billing records, and cPsdClientNotifEnable/traps under ciscoPsdClientMIBNotifs alert when the associated PSD server goes up, down, or full. It is a Cisco mobile-core-specific extension built on Cisco's general GGSN/CSG SNMP framework rather than a generic IETF standard. It is typically deployed in mobile operator core networks on GGSN or CSG nodes where CDR delivery reliability to billing systems is business-critical, and operators typically begin with a CISCO-PSD-CLIENT-MIB download to compile the module into their billing-assurance monitoring system.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-PSD-CLIENT-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 GGSN (Gateway GPRS Support Node)
Cisco Content Services Gateway (CSG)

Monitoring Examples

An administrator would poll cPsdClientDSTable/cPsdClientDSEntry for a given data-store (cPsdClientDSName) to check cPsdClientDSAutoRetrieve and cPsdClientDSMaxRetrieve settings, and would watch cPsdClientDSDiskFullTrans for a rising count indicating the local persistent store has filled up. A spike in cPsdClientDSRdWrRetrans alongside disk-full events would reveal that CDRs are failing to be written and retransmitted repeatedly, risking data loss, while cPsdClientDSServerTable state shows whether the associated PSD server is currently reachable. Enabling cPsdClientNotifEnable ensures traps fire proactively rather than requiring constant polling.

What Can Be Monitored

CDR write/read request counts
read/write retransmission count
disk-full transition events
data-store auto-retrieve configuration
PSD server up/down/full status

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From INET-ADDRESS-MIB

InetAddress
InetAddressType

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

RowStatus
TruthValue

How to Use in IPNetwork Monitor

Example using cPsdClientDSWriteReq OID:

Select a Cisco GGSN / Content Services Gateway (CSG) 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 cPsdClientDSWriteReq into the Find box to locate it in the OID tree, then select it and click OK. The number of Data Record Transfer request (for write) messages sent to the PSD server. 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 a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoPsdClientMIB	1.3.6.1.4.1.9.9.495			This MIB module manages the client side functionality of the Persistent Storage Device(PSD). This MIB instrumentation is for configuring data-store(PSD client) feature on GGSN and monitoring the state of the PSD server(up/down/full). The Cisco Persistent Storage Device(PSD) is an extension to existing storage on the Cisco Content Services Gateway(CSG). The GGSN currently allows sending of the CDRs to an active CG, while allowing up to two standby CG's to be configured. When all the configured CG's become unavailable, the CDRs get stored at the GGSN and start using up GGSN resources such as memory. As the amount of memory is limited on GGSN and failure of GGSN shall lead to losing these stored CDRs. Using PSD as temporary storage, shall avoid losses due to these problems. When all the configured CG's are unavailable, GGSN needs to backup the live closed CDR's to a PSD. When any of the CG's shall become available, GGSN shall retrieve the stored CDR's automatically from the PSD and forwards them to the active CG. PSD supports the charging protocol(GTP'), version 0 with a few private extensions, which is used to facilitate the required functionality via UDP. Acronyms and terms: CDR Call Detail Record CID Charging Identification CG Charging Gateway CGF Charging Gateway Functionality DS Data-Store ETSI European Telecommunications Standards Institute Ga Name of the interface between SGSN/GGSN and CG Gi Name of the interface between GGSN and PDN Gn Name of the interface between GGSN and SGSN G-CDR Gateway GPRS Support Node-Call Detail Record GGSN Gateway GPRS Support Node GPRS General Packet Radio Service GSM Global System for Mobile communication GTP GPRS Tunneling Protocol GTP' GTP enhanced for charging IE Information Element MS Mobile Station PDN Packet Data Network PDP Packet Data Protocol SGSN Serving GPRS support Node TOS Type of Service. PSD Persistence Storage Device.
ciscoPsdClientMIBNotifs	1.3.6.1.4.1.9.9.495.0
NTF cPsdClientDownNotif	1.3.6.1.4.1.9.9.495.0.1			A notification of this type is generated when the PSD server goes DOWN. If the PSD client was in write/retrieving state, then that operation shall be be stopped.
NTF cPsdClientUpNotif	1.3.6.1.4.1.9.9.495.0.2			A notification of this type is generated when the PSD server comes UP. A GTP' path will be created fulfilling all the specific requirements of the PSD interface.
NTF cPsdClientDiskFullNotif	1.3.6.1.4.1.9.9.495.0.3			A notification of this type is generated when the PSD server's disk become full. If the disk of writable PSD server becomes full, the client shall not be able to write any CDR into the server. It shall then behave as a retrieve only PSD server.
ciscoPsdClientMIBObjects	1.3.6.1.4.1.9.9.495.1
ciscoPsdClientStatistics	1.3.6.1.4.1.9.9.495.1.1
C32 cPsdClientDSWriteReqEx	1.3.6.1.4.1.9.9.495.1.1.1	Counter32	read-only	The number of Data Record Transfer request (for write) messages sent to the PSD server. This counter is incremented when the FIFO write request is sent to the PSD server from the client.
C32 cPsdClientDSReadReq	1.3.6.1.4.1.9.9.495.1.1.2	Counter32	read-only	The number of Data Record Transfer request (for read) messages sent to PSD server. This counter is incremented when the FIFO read request message is sent to PSD server.
C32 cPsdClientDSRdWrRetrans	1.3.6.1.4.1.9.9.495.1.1.3	Counter32	read-only	The number of Data Record Transfer Request (retransmission) messages sent to the PSD server. The PSD does not differentiate between a retransmission and original request. So, this counter together with the above two counters cPsdClientDSReadReq/ cPsdClientDSWriteReq can be used to tally the number of messages received by the PSD client. This counter is incremented when the FIFO read/write retransmission messages are sent to PSD server.
C32 cPsdClientDSDiskFullTrans	1.3.6.1.4.1.9.9.495.1.1.4	Counter32	read-only	The number of state transitions made by the PSD from state 'disk available' to 'disk full'. This counter is incremented when client receives the disk full indication from PSD server.
ciscoPsdClientNotifMgmt	1.3.6.1.4.1.9.9.495.1.2
T/F cPsdClientNotifEnable	1.3.6.1.4.1.9.9.495.1.2.1	TruthValue	read-write	This object specifies whether the agent should generate the notifications defined in this MIB module. If the value of this object is 'true' it enables the device to generate the notifications. If the value of this object is 'false' it disables the device from generating the notifications.
ciscoPsdClientConfigurations	1.3.6.1.4.1.9.9.495.1.3
cPsdClientDSTable	1.3.6.1.4.1.9.9.495.1.3.1		not-accessible	A table consisting of entries for data-store(DS) and auto-retrieval configurations. In order to minimize the performance/memory impact on the PSD client, as well as not to overwhelm the CG with both live CDRs and retrieved CDRs, the maximum retrieval rate from PSD server to GGSN is limited and can be configured by the user.
cPsdClientDSEntry	1.3.6.1.4.1.9.9.495.1.3.1.1		not-accessible	Each entry contains the configuration for auto-retrieval and also maximum retrieval value if auto-retrieval is enabled.
STR cPsdClientDSName	1.3.6.1.4.1.9.9.495.1.3.1.1.1	SnmpAdminString	not-accessible	This object contains the name of the configured data-store
T/F cPsdClientDSAutoRetrieve	1.3.6.1.4.1.9.9.495.1.3.1.1.2	TruthValue	read-create	This object is used to enable/disable the CDR auto-retrieval functionality. If value of this object is set to 'true', auto-retrieval is enabled. If value of this object is set to 'false', auto-retrieval is disabled.
I32 cPsdClientDSMaxRetrieve	1.3.6.1.4.1.9.9.495.1.3.1.1.3	Integer32	read-create	This object used to specify the maximum retrieval value, when auto retrieve is enabled, i.e when the value of the corresponding instance of cPsdClientDSAutoRetrieve is set to 'true'.
ROW cPsdClientDSRowStatus	1.3.6.1.4.1.9.9.495.1.3.1.1.4	RowStatus	read-create	The status of this conceptual row. This object is used to create a row or delete a existing row in a table.
cPsdClientDSServerTable	1.3.6.1.4.1.9.9.495.1.3.2		not-accessible	The table contains the list of the PSD servers used to write/retrieve the CDRs.
cPsdClientDSServerEntry	1.3.6.1.4.1.9.9.495.1.3.2.1		not-accessible	This entry contains a description of the PSD server.
IPt cPsdClientDSServerAddressType	1.3.6.1.4.1.9.9.495.1.3.2.1.1	InetAddressType	not-accessible	This object indicates the type of Internet address of the PSD server.
IP cPsdClientDSServerAddress	1.3.6.1.4.1.9.9.495.1.3.2.1.2	InetAddress	not-accessible	The object specifies the Internet address of the PSD server. The type of address of an instance of this object is determined by the value of the corresponding instance of cPsdClientDSServerAddressType.
T/F cPsdClientDSRetrieveOnly	1.3.6.1.4.1.9.9.495.1.3.2.1.3	TruthValue	read-create	The object represents that, the PSD server can be configured either as write/retrievable or as retrievable only. If the value of this object is set to 'true', the PSD server (the value of the corresponding instance of cPsdClientDSServerAddress) shall not be used for writing the CDRs. If the value of this object is set to 'false', the PSD server (the value of the corresponding instance of cPsdClientDSServerAddress) shall be used for writing the CDRs as well as retrieving the CDRs.
ROW cPsdClientDSServerRowStatus	1.3.6.1.4.1.9.9.495.1.3.2.1.4	RowStatus	read-create	The status of this conceptual row. This object will create a row or delete a existing row in a table.
ciscoPsdClientNotifInfo	1.3.6.1.4.1.9.9.495.1.4
IPt cPsdClientNotifDSServerAddrType	1.3.6.1.4.1.9.9.495.1.4.1	InetAddressType	accessible-for-notify	This object indicates the type of Internet address of the Data-Store server.
IP cPsdClientNotifDSServerAddress	1.3.6.1.4.1.9.9.495.1.4.2	InetAddress	accessible-for-notify	This object specifies the Internet address of the Data-Store server . The type of address of an instance of this object is determined by the value of cPsdClientNotifDSServerAddrType.
ciscoPsdClientMIBConform	1.3.6.1.4.1.9.9.495.2
cPsdClientMIBCompliances	1.3.6.1.4.1.9.9.495.2.1
cPsdClientMIBCompliance	1.3.6.1.4.1.9.9.495.2.1.1			The compliance statement for entities which implement the CISCO PSD CLIENT MIB.
cPsdClientMIBGroups	1.3.6.1.4.1.9.9.495.2.2
cPsdClientMIBStatisticsGroup	1.3.6.1.4.1.9.9.495.2.2.1			A collection of objects providing Data Store related statistics.
cPsdClientMIBConfigurationsGroup	1.3.6.1.4.1.9.9.495.2.2.2			A collection of objects providing Data Store related configurations.
cPsdClientMIBNotifGroup	1.3.6.1.4.1.9.9.495.2.2.3			A collection of Notifications.
cPsdClientMIBNotifInfoGroup	1.3.6.1.4.1.9.9.495.2.2.4			A collection of notification info objects on PSD.
cPsdClientMIBNotifMgmtGroup	1.3.6.1.4.1.9.9.495.2.2.5			A collection of objects related with notification management on PSD.

RFC description

Persistent Storage Device (PSD) client management for GGSN CDR backup and recovery.

Start monitoring Cisco GGSN / Content Services Gateway (CSG) 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-PSD-CLIENT-MIB