show gprs access-point
To display information about access points on the GGSN, use the show gprs access-point privileged EXEC command.
show gprs access-point {access-point-index [address-allocation] | all}
Syntax Description
access-point-index |
Integer (from 1 to 65535) that identifies a GPRS access point. Information about that access point is shown. |
access-point-index address-allocation |
TID and dynamically allocated mobile station (MS) addresses (by either a DHCP or RADIUS server) for PDP contexts on the specified access point are shown. |
all |
Information about all access points on the GGSN is shown. |
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.1(1)GA |
This command was introduced. |
12.1(5)T |
This command was integrated in Cisco IOS Release 12.1(5)T. |
12.2(4)MX |
This command was incorporated in Cisco IOS Release 12.2(4)MX. •The following output fields were added to the display: –accounting –aggregate –apn_accounting_server_group –apn_authentication_server_group –apn-type –apn_username –apn_password –Block Roamer Mode –GPRS vaccess interface –VPN –wait_accounting •The following output fields were removed from the display: –apn_charging_gw –apn_backup_charging_gw –apn_radius_server •Several output field results were changed from binary 0 and 1 to Yes and No. •The following output fields were added to the all version of this command: –Access-type –ppp-regeneration (max-session, setup-time) –VRF Name |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD and the Block Roamer Mode output field was changed to Block Foreign-MS Mode output field. |
12.2(8)YW |
This command was incorporated in Cisco IOS Release 12.2(8)YW. •The following output fields were added to the display: –input ACL –output ACL –backup –RADIUS attribute suppress MSISDN –RADIUS attribute suppress IMSI –RADIUS attribute suppress SGSN Address –RADIUS attribute suppress QoS •The format of the apn_username: , apn_password: display fields was changed to apn_username: apn_password:. |
Usage Guidelines
Use the access-point-index argument to specify a particular access point number for which you want to obtain information.
Use the address-allocation keyword, to obtain information about dynamically allocated MS addresses and lease terms by access point.
Use the all keyword to obtain information about all access points in an abbreviated format.
Examples
Example 1
The following is sample output of the show gprs access-point command for access-point 1:
router# show gprs access-point 1
apn_index 1 apn_name = gprs.corporate.com
input ACL: None, output ACL: None
dynamic_address_pool: dhcp-proxy-client
apn_dhcp_server: 10.99.100.5 backup: 10.99.100.4
apn_dhcp_gateway_addr: 10.27.1.1
apn_authentication_server_group: foo
apn_accounting_server_group: foo1
apn_username: apn_password:
deactivate_pdp_context_on violation: Yes
network_activation_allowed: Yes
Block Foreign-MS Mode: Disable
VPN: Disable (VRF Name : None)
GPRS vaccess interface: Virtual-Access2
RADIUS attribute suppress MSISDN: Disabled
RADIUS attribute suppress IMSI: Disabled
RADIUS attribute suppress SGSN Address: Disabled
RADIUS attribute suppress QoS
number of ip_address_allocated 0
Verify mobile source addr: enable
Verify mobile destination addr: enable
Mobile-to-mobile: destination 1.1.1.1
Total number of PDP in this APN :0
Table 5 describes the fields show in the display.
Table 5 show gprs access-point Field Descriptions
|
|
accounting |
Current status of accounting services at the APN: •Enable—Accounting services are enabled at the APN. This is the default for non-transparent access APNs. •Disable—Accounting services are disabled at the APN. This is the default for transparent access APNs. You can configure an APN for accounting services using the aaa-accounting access-point configuration command. |
aggregate |
Route aggregation configuration information on the GGSN. The output display includes the "In APN" field for configuration information for the access point, and the "In global" field for global configuration on the GGSN. The output field may contain the following information: •IP network address and mask for which PDP requests on the access point will be collectively routed over the virtual template interface on the GGSN. IP address and mask information appears if an aggregate range has been configured on the GGSN. •auto—Indicates that the GGSN uses the allocated IP mask from the DHCP or RADIUS server to perform route aggregation on the APN. This keyword appears when the APN has been configured with the aggregate auto access-point configuration command. This value only applies to the APN. •Disable—Indicates that route aggregation is not configured at either the APN or global level. |
apn_accounting_server_group |
Name of the AAA server group providing accounting services. |
apn_authentication_server_group |
Name of the AAA server group providing authentication services. |
apn_dhcp_gateway_addr |
IP address of the DHCP gateway, if configured. |
apn_dhcp_server |
IP address of the DHCP server, if configured. |
apn_index |
Number assigned to this access point. |
apn_mode |
Current setting for the access-mode command: •Transparent—Users are allowed access without authorization or authentication. •Non-transparent—Users must be authenticated by the GGSN acting as a proxy for the authentication. |
apn_name |
Access point name. |
apn-type |
Current setting for the access-type command: •Real—APN type that corresponds to a physical interface to an external network on the GGSN. •Virtual—APN type that is not associated with any specific physical target network. |
apn_username |
Username specified in the anonymous user command. If the anonymous user command is not configured, this field will be blank. |
apn_password |
Password specified in the anonymous user command. If the anonymous user command is not configured, this field will be blank. |
backup |
IP address of the backup DHCP server, if configured. |
Block Foreign-MS Mode |
Current setting for the block-foreign-ms command: •Enable—Blocking for foreign MSs is configured. •Disable—Blocking for foreign MSs is not configured. |
deactivate_pdp_context_on violation |
Current setting for the access-violation command: •No—User packets are discarded. •Yes—Mobile sessions are terminated when there is an access violation. |
dynamic_address_pool |
Current setting for the ip-address-pool command. |
GPRS vaccess interface |
Name of the virtual access interface associated with the VPN. If no VPN is configured at the access point, the name of the virtual access interface for the GGSN virtual template is shown, which is always Virtual-Access1. |
idle_timer |
Amount of time the GGSN will wait before purging idle mobile sessions for the access point configured using the session idle-time command. |
input ACL |
IP access list for inbound packets (Gi to Gn interfaces). |
Mobile-to-Mobile |
Current setting for the redirect intermobile ip command. |
network_activation_allowed |
Indicates whether network-initiated PDP context support is configured using the network-request-activation command: •No—Network-initiated PDP context support is disabled. •Yes—Network-initiated PDP context support is enabled. |
number of ip_address_allocated |
Number of IP addresses allocated to MS users. |
output ACL |
IP access list for outbound packets (Gn to Gi interfaces). |
RADIUS attribute suppress IMSI |
Current setting for the radius attribute suppress imsi command: •Enabled—GGSN suppresses the 3GPP-IMSI number in its authentication and accounting requests to a RADIUS server. •Disabled—GGSN does not suppress the 3GPP-IMSI number in its authentication and accounting requests to a RADIUS server. |
RADIUS attribute suppress MSISDN |
Current setting for the msisdn suppression command: •Enabled—GGSN overrides or suppresses the MSISDN number in its RADIUS authentication. •Disabled—GGSN does not override or suppress the MSISDN number in its RADIUS authentication. |
RADIUS attribute suppress SGSN Address |
Current setting for the radius attribute suppress sgsn-address command: •Enabled—GGSN suppresses the 3GPP VSA 3GPP-SGSN-Address subattribute in its RADIUS authentication and accounting requests. •Disabled—GGSN does not suppress the 3GPP VSA 3GPP-SGSN-Address subattribute in its RADIUS authentication and accounting requests. |
RADIUS attribute suppress QoS |
Current setting for the radius attribute suppress qos command: •Enabled—GGSN suppresses the 3GPP VSA 3GPP-QoS-Profile subattribute in its RADIUS authentication and accounting requests. •Disabled—GGSN does not suppress the 3GPP VSA 3GPP-QoS-Profile subattribute in its RADIUS authentication and accounting requests. |
subscribe_required |
Current setting for the subscription-required command: •No—No subscription is required. •Yes—Subscription is required for access point users. The GGSN looks for the "subscription verified" selection mode in the PDP context request to establish the session. |
Total number of PDP in this APN |
Number of active PDP contexts for this access point. |
Verify mobile source addr |
Current setting for the security verify source command: •Enabled—GGSN verifies the source IP address of upstream TPDUs against addresses previously assigned to MSs. •Disabled—GGSN does not verify the source IP address of upstream TPDUs against addresses previously assigned to MSs. |
Verify mobile destination addr |
Current setting for the security verify destination command: •Enabled—GGSN verifies the destination address of upstream TPDUs against the global list of PLMN addresses specified using the gprs plmn ip address command. •Disabled—GGSN does not verify the destination address of upstream TPDUs against the global list of PLMN addresses specified using the gprs plmn ip address command. |
VPN |
Indicates whether a Virtual Private Network (VPN) is enabled or disabled at the access point. |
VRF name |
Name assigned to the VPN Routing and Forwarding instance. A value of None appears when VRF is not enabled at the access point. |
wait_accounting |
Current status of RADIUS accounting response message waiting at the APN: •Enable—GGSN waits for an accounting response message from the RADIUS server before sending an activate PDP context request to the SGSN. •Disable—GGSN sends an activate PDP context request to the SGSN after sending an accounting request to the RADIUS server. The GGSN does not wait for a RADIUS accounting response. You can configure RADIUS accounting response message waiting using the gprs gtp response-message wait-accounting global configuration command, or the response-message wait-accounting access-point configuration command. |
Example 2
The following is sample output of the show gprs access-point address-allocation command:
router# show gprs access-point 8 address-allocation
1111111100000099 10.88.105.227
1111111100000191 10.88.105.7
1111111100000192 10.88.105.70
1111111100000297 10.88.106.162
1111111100000298 10.88.106.169
1111111100000299 10.88.106.161
1111111100000391 10.88.106.150
1111111100000392 10.88.106.25
1111111100000442 10.88.106.196
1111111100000443 10.88.106.197
1111111100000886 10.88.108.153
1111111100000887 10.88.108.158
2222222200000000 10.88.111.255
Table 6 describes the fields show in the display.
Table 6 show gprs access-point address-allocation Field Descriptions
|
|
TID |
Tunnel ID for the PDP context request on the APN. |
PDP_ADDRESS |
IP address assigned to the PDP context request on the APN. |
Example 3
The following is sample output of the show gprs access-point all command:
router# show gprs access-point all
There are 3 Access-Points configured
Index Mode Access-type AccessPointName VRF Name
-----------------------------------------------------------------------
1 transparent Real corporate_1.com corporate_1.com
ppp-regeneration (max-session: 10000, setup-time: 60)
-----------------------------------------------------------------------
2 non-transparent Real corporate_2.com
-----------------------------------------------------------------------
3 transparent Virtual corporate_3.com
-----------------------------------------------------------------------
Table 7 describes the fields show in the display.
Table 7 show gprs access-point all Field Descriptions
|
|
Index |
Integer assigned to the access point in the GGSN configuration. The index number is used to reference an APN in GGSN commands. |
Mode |
Authorization configured on the access point. The possible values are: •transparent—Users who access the PDN through the access point associated with the current virtual template are allowed access without authorization or authentication. •non-transparent—Users who access the PDN through the current virtual template must be authenticated by the GGSN acting as a proxy for the authentication. |
Access-type |
Type of access point. The possible values are: •Real—APN type that corresponds to an external physical network on the GGSN. This is the default value. •Virtual—APN type that is not associated with any specific physical target network on the GGSN. Virtual APNs are used to simply HLR provisioning in the PLMN. |
AccessPointName |
Access point network ID, which is commonly an Internet domain name. |
ppp-regeneration (max-session, setup-time) |
PPP regeneration session parameters configured at the access point: •max-session—Maximum number of PPP regenerated sessions allowed at the access point. •setup-time—Maximum amount of time (between 1 and 65535 seconds) within which a PPP regenerated session must be established. |
VRF Name |
Name of the VPN routing and forwarding instance associated with the APN. |
Related Commands
|
|
access-point |
Specifies an access point number and enters access-point configuration mode. |
show gprs access-point statistics
To display data volume and PDP activation and deactivation statistics for access points on the GGSN, use the show gprs access-point statistics privileged EXEC command.
show gprs access-point statistics {access-point-index | all}
Syntax Description
access-point-index |
Index number of an access point. Statistics for that access point are shown. |
all |
Statistics for all access points on the GGSN are shown. |
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.2(4)MX |
This command was introduced. |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD. |
12.2(8)YW |
This command was incorporated in Cisco IOS Release 12.2(8)YW. |
Usage Guidelines
Use the show gprs access-point statistics command to display data volume and PDP activation and deactivation statistics for access points on the GGSN.
Use the access-point-index argument to specify a particular access point number for which you want to obtain information.
Use the all keyword to obtain information about all access points in an abbreviated format.
Examples
The following example displays PDP context activation and deactivation statistics for all access points on the GGSN:
router# show gprs access-point statistics all
There are 3 Access-Points activated
Index Mode Access-type AccessPointName VRF Name
-----------------------------------------------------------------------
1 transparent Real coporate_1.com corporate_1.com
ppp-regeneration (max-session: 10000, setup-time: 60)
PDP activation initiated by MS: 3
Successful PDP activation initiated by MS: 3
Dynamic PDP activation initiated by MS: 3
Successful dynamic activation initiated by MS: 0
PDP deactivation initiated by MS: 0
Successful PDP deactivation initiated by MS: 0
Network initiated PDP activation: 0
Successful network initiated PDP activation: 0
PDP deactivation initiated by GGSN: 1
Successful PDP deactivation initiated by GGSN: 1
upstream data volume in octets: 0
downstream data volume in octets: 0
Src addr violation: 6 paks, 9136 bytes
Redirected mobile-to-mobile traffic: 35 paks, 3480 bytes
-------------------------------------------------------------
4 transparent gprs.pdn.com
PDP activation initiated by MS: 1
Successful PDP activation initiated by MS: 1
Dynamic PDP activation initiated by MS: 0
Successful dynamic activation initiated by MS: 0
PDP deactivation initiated by MS: 0
Successful PDP deactivation initiated by MS: 0
Network initiated PDP activation: 0
Successful network initiated PDP activation: 0
PDP deactivation initiated by GGSN: 6
Successful PDP deactivation initiated by GGSN: 6
upstream data volume in octets: 0
downstream data volume in octets: 0
Src addr violation: 6 paks, 9136 bytes
Dest addr violation: 6 paks, 9136 bytes
Redirected mobile-to-mobile traffic: 35 paks, 3480 bytes
-------------------------------------------------------------
5 transparent gpru.pdn.com
PDP activation initiated by MS: 1
Successful PDP activation initiated by MS: 1
Dynamic PDP activation initiated by MS: 0
Successful dynamic activation initiated by MS: 0
PDP deactivation initiated by MS: 0
Successful PDP deactivation initiated by MS: 0
Network initiated PDP activation: 0
Successful network initiated PDP activation: 0
PDP deactivation initiated by GGSN: 0
Successful PDP deactivation initiated by GGSN: 6
upstream data volume in octets: 0
downstream data volume in octets: 0
Src addr violation: 6 paks, 9136 bytes
Dest addr violation: 6 paks, 9136 bytes
Redirected mobile-to-mobile traffic: 35 paks, 3480 bytes
Table 8 describes the fields shown in the display:
Table 8 show gprs access-point statistics Field Descriptions
|
|
active PDP |
Number of PDP contexts that are currently established on the GGSN. |
downstream data volume in octets |
Number of bytes of data received by the GGSN from the PDN, or network. |
Dest addr violation |
Number of packets (and bytes) dropped by the GGSN because of a source address violation. This field displays only when the security verify destination command is configured. Note This field does not apply to APNs using VRF. In addition, verification of destination addresses does not apply to GTP-PPP regeneration or GTP-PPP with L2TP. |
Dynamic PDP activation initiated by MS |
Number of Create PDP Context Request messages received by the GGSN from an MS without a PDP address. (Duplicate requests are not counted.) |
Network initiated PDP activation |
Number of Create PDP Context Request messages received by the GGSN from network initiation. |
PDP activation initiated by MS |
Number of Create PDP Context Request messages received by the GGSN from an SGSN. (Duplicate requests are not counted.) |
PDP deactivation initiated by GGSN |
Number of Delete PDP Context Request messages sent by the GGSN to an SGSN. |
PDP deactivation initiated by MS |
Number of Delete PDP Context Request messages received by the GGSN from an SGSN. (Duplicate messages are not counted.) |
ppp-regeneration (max-session, setup-time) |
PPP regeneration session parameters configured at the access point: •max-session—Maximum number of PPP regenerated sessions allowed at the access point. •setup-time—Maximum amount of time (between 1 and 65535 seconds) within which a PPP regenerated session must be established. |
Redirected mobile-to-mobile traffic |
Number of packets (and bytes) dropped at the APN from which they exit because mobile-to-mobile traffic has been redirected. This field displays only when the redirect intermobile ip command is configured. |
Src addr violation |
Number of packets (and bytes) dropped because of source address violation. This field displays only when the security verify source command is configured. |
Successful dynamic activation initiated by MS |
Number of Create PDP Context Response messages sent by the GGSN with a cause value of "GTP_RES_REQACCEPTED", indicating that the PDP address has been dynamically assigned. |
Successful network initiated PDP activation |
Number of PDP contexts activated on the GGSN that were initiated by the network. |
Successful PDP activation initiated by MS |
Number of Create PDP Context Response messages sent by the GGSN with a cause value of "GTP_RES_REQACCEPTED." |
Successful PDP deactivation initiated by GGSN |
Number of Delete PDP Context Response messages received by the GGSN from an SGSN. |
Successful PDP deactivation initiated by MS |
Number of Delete PDP Context Response messages sent by the GGSN to an SGSN with a cause value of "GTP_RES_REQACCEPTED". |
upstream data volume in octets |
Number of bytes of data received by the GGSN from the SGSN. |
Related Commands
|
|
clear gprs access-point statistics |
Clears statistics counters for a specific access point or for all access points on the GGSN. |
show gprs access-point |
Displays information about access points on the GGSN. |
show gprs charging parameters
To display information about the current GPRS charging configuration, use the show gprs charging parameters privileged EXEC command.
show gprs charging parameters
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.1(1)GA |
This command was introduced. |
12.1(5)T |
This command was integrated in Cisco IOS Release 12.1(5)T. |
12.2(4)MX |
This command was incorporated in Cisco IOS Release 12.2(4)MX. The following output fields were added to the display: •Charging CDR Option Local Record Sequence Number •Charging CDR Option No Partial CDR Generation •Charging CDR Option Node ID •Charging CDR Option Packet Count •Charging Change Condition Limit •Charging Send Buffer Size •Charging GTP' Port Number •Charging MCC Code •Charging MNC Code •Charging Roamers CDR Only •Charging HPLMN Matching Criteria •Charging SGSN Limit The following output fields were removed from the display: •Charging MCC Code •Charging MNC Code •Charging HPLMN Matching Criteria |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD. |
12.2(8)YW |
This command was incorporated in the Cisco IOS Release 12.2(8)YW. •The Charging Path Protocol field was changed from binary 0 and 1 to udp and tcp. •The Charging qos-info output field was changed to Charging release. •The following output fields were added to the display: –Charging Time Limit –Charging qos-info –Charging Transfer Format. –GTP' use short header |
Usage Guidelines
Use the show gprs charging parameters command to display the currently active charging parameters for the GGSN.
Examples
The following is sample output of the show gprs charging parameters command:
router# show gprs charging parameters
GPRS Charging Protocol Parameters
=================================
* Default Charging Gateway Address: <9.9.9.9>
* Default Backup Charging Gateway Address:UNDEFINED.
* Current Active Charging Gateway Address:<9.9.9.9>
* Current Backup Charging Gateway Address:UNDEFINED.
* Charging Server Switch-Over Timer: <15> seconds.
* Charging Path Protocol: tcp
* GTP' use short header: DISABLED
* Charging Message Options:
- Packet Transfer Command IE: ENABLED.
- Number Responded: DISABLED.
* Charging MAP DATA TOS: <3>
* Charging Transfer Interval: <105> seconds.
* Charging Transfer Threshold: <400> bytes.
* Charging CDR Aggregation Limit: <255> CDRs per msg.
* Charging Packet Queue Size: <128> messages.
* Charging Gateway Path Request Timer: <1> Minutes.
* Charging Change Condition Limit: <5>
* Charging SGSN Limit: DISABLED.
* Charging Time Limit: <3000>
* Charging Send Buffer Size: <1460>
* Charging Port Number: <3386>
* Charging Roamers CDR Only: DISABLED.
- Local Record Sequence Number: DISABLED.
- APN Selection Mode: DISABLED.
- No Partial CDR Generation: DISABLED.
- Packet Count: DISABLED.
- Served MSISDN: DISABLED.
- Private Echo: DISABLED.
* Charging Tariff Time Changes:
- Tariff Time Change (#0): 04:04:01
- Tariff Time Change (#1): 17:00:00
- Tariff Time Change (#2): 21:25:00
Table 9 describes the fields shown in the display.
Table 9 show gprs charging parameters Field Descriptions
|
|
Charging CDR Aggregation Limit |
Maximum number of CDRs that the GGSN aggregates in a charging data transfer message to the charging gateway. You can configure this limit using the gprs charging cdr-aggregation-limit command. |
Charging CDR Option: Local Record Sequence Number |
Status indicating if the GGSN uses the local record sequence field in G-CDRs. The possible values are enabled or disabled. You can enable the GGSN to use the local record sequence field in G-CDRs using the gprs charging cdr-option local-record-sequence-number command. |
Charging CDR Option: APN Selection Mode |
Status indicating if the GGSN provides the reason code for APN selection in G-CDRs. The possible values are enabled or disabled. You can enable the GGSN to provide the APN selection mode in G-CDRs using the gprs charging cdr-option apn-selection-mode command. |
Charging CDR Option: No Partial CDR Generation |
Status indicating if the GGSN can create partial CDRs. The possible values are enabled or disabled. You can disable partial CDR generation by the GGSN using the gprs charging cdr-option no-partial-cdr-generation command. |
Charging CDR Option: Node ID |
Status indicating if the GGSN specifies the name of the node that generated the CDR in the node ID field of the G-CDR. The possible values are enabled or disabled. You can enable the GGSN to use the node ID field in G-CDRs using the gprs charging cdr-option node-id command. |
Charging CDR Option: Packet Count |
Status indicating if the GGSN provides uplink and downlink packet counts in the optional record extension field of a G-CDR. The possible values are ON or OFF. You can enable the GGSN to provide packet counts using the gprs charging cdr-option packet-count command. |
Charging CDR Option: Served MSISDN |
Status indicating if the GGSN provides the mobile station integrated services digital network number from the create PDP context request in a G-CDR. The possible values are enabled or disabled. You can enable the GGSN to provide the MSISDN number using the gprs charging cdr-option served-msisdn command. |
Charging CDR Option: Private Echo |
Status indicating if the GGSN uses private echo signaling for flow control. The possible values are enabled or disabled. You can enable private echo signaling using the gprs charging flow-control private-echo command. |
Charging Change Condition Limit |
Maximum number of charging containers in each G-CDR. You can configure the change condition limit using the gprs charging container change-limit command. |
Charging Gateway Path Request Timer |
Number of minutes that the GGSN waits before trying to establish the TCP path to the charging gateway when TCP is the specified path protocol. You can configure the path request timer using the gprs charging cg-path-requests command. |
Charging MAP DATA TOS |
Type of service (ToS) priority currently configured for GPRS charging packets. Value (between 0 and 5) is set in the precedence bits of the IP header of charging packets. You can configure the ToS mapping using the gprs charging map data tos command. |
Charging Message Options: Transfer Request |
Whether the GGSN includes the Packet Transfer Command IE in the Data Record Transfer Response messages. The possible values are ENABLED (the GGSN includes the Packet Transfer Command IE) or DISABLED (the GGSN does not include the IE). |
Charging Messages Options: Transfer Response |
Whether the GGSN is using the Number of Requests Responded field instead or the Length field in the Requests Responded IE of Data Record Transfer Response messages. The possible values are ENABLED (the GGSN uses the Number of Requests Responded field) or DISABLED (the GGSN uses the Length field). |
Charging Packet Queue Size |
Maximum number of unacknowledged charging data transfer requests that the GGSN maintains in its queue. You can configure the maximum queue size using the gprs charging packet-queue-size command. |
Charging Path Protocol |
Protocol in use between the GGSN and the charging gateway. The possible values are udp or tcp. You can configure the charging path protocol using the gprs charging path-protocol command. |
Charging Port Number |
Destination port of the charging gateway. You can configure the destination port using the gprs charging port command. |
Charging release |
Whether UMTS (R99) and GSM (R97/R98) QoS profile formats are presented in G-CDRs. The possible values are 99 (GSM and UMTS QoS profile formats are presented) or 98 (only GSM QoS profile formats are presented). You can configure the type of QoS profile format to be included using the gprs charging release command. |
Charging Roamers CDR Only |
Status of the charging for roamers feature on the GGSN. The possible values are enabled or disabled. You can configure the GGSN to support creation of CDRs for roaming subscribers using the gprs charging roamers command. |
Charging Send Buffer Size |
Size (in bytes) of the buffer that contains the GTP' PDU and signaling messages on the GGSN. You can configure the buffer size using the gprs charging send-buffer command. |
Charging Server Switch-Over Timer |
Amount of time (in seconds) that the GGSN waits before sending charging data to the backup charging gateway, after the active charging gateway fails. You can configure this period of time using the gprs charging server-switch-timer command. |
Charging SGSN Limit |
Maximum number of SGSN changes that can occur before the GGSN closes a G-CDR for a particular PDP context. |
Charging Tariff Time Changes |
Time of day when GPRS charging tariffs change. You can configure this time using the gprs charging tariff-time command. |
Charging Transfer Interval |
Amount of time (in seconds) that the GGSN waits before checking and sending any closed CDRs to the charging gateway. You can configure this period of time using the gprs charging transfer interval command. |
Charging Transfer Threshold |
Maximum size (in bytes) that the GGSN maintains in a charging container before closing it and updating the CDR. You can configure the container volume using the gprs charging container volume-threshold command. |
Current Active Charging Gateway Address |
IP address of the charging gateway to which the GGSN is currently sending charging data. You can configure the primary charging gateway using the gprs default charging-gateway command. |
Current Backup Charging Gateway Address |
IP address of the backup charging gateway to which the GGSN will send charging data if the current active charging gateway becomes unavailable. You can configure the backup charging gateway using the gprs default charging-gateway command. |
Default Backup Charging Gateway Address |
IP address of the default secondary, or backup, charging gateway. You can configure the default backup charging gateway using the gprs default charging-gateway command. |
Default Charging Gateway Address |
IP address of the default primary charging gateway. You can configure the default primary charging gateway using the gprs default charging-gateway command. |
GTP' use short header |
Whether the GGSN is using the GTP short header (6-byte header). The possible values are ENABLED (the GGSN is using the GTP short header) or DISABLED (the GGSN is using the GTP long header). You can configure the GGSN to use the GTP short header using the gprs charging header short command. |
Related Commands
|
|
show gprs charging statistics |
Displays cumulative charging statistics for the GGSN. |
show gprs charging statistics
To display cumulative charging statistics for the GGSN, use the show gprs charging statistics privileged EXEC command.
show gprs charging statistics
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.1(1)GA |
This command was introduced. |
12.1(5)T |
This command was integrated in Cisco IOS Release 12.1(5)T. |
12.2(4)MX |
This command was incorporated in Cisco IOS Release 12.2(4)MX, and the statistics were changed to be cumulative since the last restart of the GGSN and the keyword options were removed. |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD. |
12.2(8)YW |
This command was incorporated in Cisco IOS Release 12.2(8)YW. |
Usage Guidelines
Use the show gprs charging statistics command to display cumulative charging statistics since the last restart of the GGSN.
Examples
The following is sample output of the show gprs charging statistics command:
router# show gprs charging statistics all
GPRS Charging Protocol Statistics
=================================
* Total Number of CDRs for Charging: <200>
* Total Number of Containers for Charging: <104>
* Total Number of CDR_Output_Msgs sent: <22>
-- Charging Gateway Statistics --
* Charging Gateway Down Count: <1>
* Last Charging Gateway Down Time = 2001/11/29 15:23:0
Table 10 describes the fields shown in the display.
Table 10 show gprs charging statistics Field Descriptions
|
|
Total Number of CDRs for Charging |
Cumulative number of open and closed G-CDRs on the GGSN since the last startup of the GGSN. |
Total Number of Containers for Charging |
Cumulative number of all open and closed charging containers for all G-CDRs on the GGSN since the last startup of the GGSN. |
Total Number of CDR_Output_Msgs sent |
Cumulative number of G-CDR output messages that the GGSN sent to the charging gateway and received acknowledgment for since the last startup of the GGSN. |
Charging Gateway Down Count |
Number of times that the charging gateway has transitioned its state (from up or unknown, to down) since the last startup of the GGSN. |
Last Charging Gateway Down Time |
Recorded system time when the charging gateway was last in a down state. This statistics only appears if a charging gateway has been down. |
.
Related Commands
|
|
show gprs charging parameters |
Displays information about the current GPRS charging configuration. |
show gprs charging status |
Displays current charging statistics for the GGSN. |
show gprs charging status
To display current charging statistics for the GGSN, use the show gprs charging status privileged EXEC command.
show gprs charging status {tid tunnel_id | access-point access-point-index | all}
Syntax Description
tid tunnel_id |
Specifies a tunnel ID for which you want to display charging statistics. |
access-point access-point-index |
Specifies the index of the access point for which you want to display charging statistics. |
all |
Requests display of all charging statistics. |
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.2(4)MX |
This command was introduced. |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD and the Number of partial CDRs output field was changed to the Number of closed CDRs buffered. |
12.2(8)YW |
This command was incorporated in Cisco IOS Release 12.2(8)YW. |
Usage Guidelines
Use the show gprs charging status command to display current charging statistics for the GGSN since the last G-CDR was sent.
Examples
Example 1
The following is sample output of the show gprs charging status tid command:
router# show gprs charging status tid 1231231111111100
GPRS Charging Protocol Status for TID
=========================================
* Number of closed CDRs buffered: <0>
* Number of Containers: <0>
Table 11 describes the fields shown in the display.
Table 11 show gprs charging status tid Field Descriptions
|
|
Number of CDRs |
Number of currently open and closed G-CDRs on the GGSN for the specified TID, since the last G-CDR was successfully sent to the charging gateway. |
Number of closed CDRs buffered |
Number of currently closed G-CDRs that the GGSN has not yet sent to the charging gateway for the specified TID. |
Number of Containers |
Number of all currently open and closed charging containers for the specified TID, since the last G-CDR was successfully sent to the charging gateway. |
Example 2
The following is sample output of the show gprs charging status access-point command:
router# show gprs charging status access-point 1
GPRS Charging Protocol Status for APN
=========================================
* Number of closed CDRs buffered: <0>
* Number of Containers: <0>
Table 12 describes the fields shown in the display.
Table 12 show gprs charging status access-point Field Descriptions
|
|
Number of CDRs |
Number of currently open and closed G-CDRs on the GGSN for the specified access point, since the last G-CDR was successfully sent to the charging gateway. |
Number of closed CDRs buffered |
Number of currently closed G-CDRs that the GGSN has not yet sent to the charging gateway for the specified access point. |
Number of Containers |
Number of all currently open and closed charging containers for the specified access point, since the last G-CDR was successfully sent to the charging gateway. |
Example 3
The following is sample output of the show gprs charging status all command:
router# show gprs charging status all
GPRS Charging Protocol Status
=================================
* Number of closed CDRs buffered: <0>
* Number of Containers buffered: <0>
* Number of pending unack. CDR_Output_Msgs: <1>
Table 13 describes the fields shown in the display.
Table 13 show gprs charging status Field Descriptions
|
|
Number of APNs |
Number of access points for which charging data has currently been collected. This statistic appears in the all version of this command only. |
Number of CDRs |
Number of currently open and closed G-CDRs on the GGSN since the last G-CDR was successfully sent to the charging gateway. For the tid and access-point versions of this command, this is the number of currently open and closed G-CDRs for the specified TID or access point. |
Number of closed CDRs buffered |
Number of currently closed G-CDRs that the GGSN has not yet sent to the charging gateway. For the tid and access-point versions of this command, this is the number of currently closed G-CDRs for the specified TID or access-point that have not yet been sent to the charging gateway. |
Number of Containers buffered |
Number of all currently open and closed charging containers since the last G-CDR was successfully sent to the charging gateway. |
Number of pending unack. CDR_Output_Msgs |
Number of G-CDR output messages sent by the GGSN that are not acknowledged by the charging gateway. |
Related Commands
|
|
show gprs charging parameters |
Displays information about the current GPRS charging configuration. |
show gprs charging statistics |
Displays cumulative charging statistics for the GGSN. |
show gprs gtp ms
To display the currently active MSs on the GGSN, use the show gprs gtp ms privileged EXEC command.
show gprs gtp ms {imsi imsi| access-point access-point-index | all}
Syntax Description
imsi imsi |
Displays MSs by International Mobile Subscriber Identity (IMSI). The IMSI can be up to 15 numeric digits. You can obtain the IMSI from the output for the show gprs gtp ms all command or the show gprs gtp pdp-context tid command. |
access-point access-point-index |
Displays MSs by access point. |
all |
Displays all MSs. |
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.2(8)YW |
This command was introduced. |
Usage Guidelines
Use the show gprs gtp ms command to display information about the mobile stations that are currently active on the GGSN. You can display the MS information according to access-point or IMSI. You can also display information for all MSs.
Examples
The following example displays information for all MSs:
router# show gprs gtp ms all
112233445565437 10.3.0.1 gprsa.apn.com
223456788765437 10.2.0.1 gprsb.apn.com
The following example displays information for all MSs on access-point 1:
router# show gprs gtp ms access-point 1
112233445565437 10.3.0.1 gprsa.apn.com
The following example displays information for all MSs on IMSI 110406080002045:
router# show gprs gtp ms imsi 110406080002045
110406080002045 10.10.10.2 gprsc.apn.com
Table 14 describes the fields shown in the display.
Table 14 show gprs gtp ms Field Descriptions
|
|
IMSI |
International mobile subscriber identity for the MSs. |
MS ADDRESS |
The IP address for the MSs. |
APN |
Access point name. |
number of pdp |
Number of PDP contexts on the MSs. |
reference count |
Internal data structure field. It is used only for internal troubleshooting purposes. |
Related Commands
|
|
show gprs gtp pdp-context |
Displays a list of the currently active PDP contexts (mobile sessions). |
show gprs gtp status |
Displays information about the current status of the GTP on the GGSN (such as activated PDP contexts, throughput, and QoS statistics). |
show gprs gtp parameters
To display information about the current GPRS Tunneling Protocol (GTP) configuration on the GGSN, use the show gprs gtp parameters privileged EXEC command.
show gprs gtp parameters
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.1(1)GA |
This command was introduced. |
12.1(5)T |
This command was integrated in Cisco IOS Release 12.1(5)T. |
12.2(4)MX |
This command was incorporated in Cisco IOS Release 12.2(4)MX. The following output fields were added to the display: •Charging MCC Code •Charging MNC Code •Charging HPLMN Matching Criteria •GTP dynamic echo-timer minimum •GTP dynamic echo-timer smooth factor The following output field was removed: •GTP max hold time for old sgsn PDUs T3_tunnel |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD and the following output field was removed from the display: •GPRS HPLMN Matching Criteria |
12.2(8)YW |
This command was incorporated in Cisco IOS Release 12.2(8)YW. |
Usage Guidelines
Use the show gprs gtp parameters command to display the current GTP parameters configured on the GGSN.
Examples
The following is sample output of the show gprs gtp parameters command:
router# show gprs gtp parameters
GTP path echo interval = 60
GTP signal max wait time T3_response = 1
GTP max retry N3_request = 5
GTP dynamic echo-timer minimum = 5
GTP dynamic echo-timer smooth factor = 2
GTP buffer size for receiving N3_buffer = 8192
GTP max pdp context = 45000
Table 15 describes the fields shown in the display.
.
Table 15 show gprs gtp parameters Field Descriptions
|
|
GPRS MCC Code |
Mobile country code (MCC) that the GGSN uses in conjunction with the mobile network node to determine whether a create PDP context request is from a roamer. You can configure the MCC using the gprs mcc mnc command. |
GPRS MNC Code |
Mobile network node (MNC) that the GGSN uses in conjunction with the mobile country code to determine whether a create PDP context request is from a roamer. You can configure the MNC using the gprs mcc mnc command. |
GTP buffer size for receiving N3_buffer |
Current size of the receive buffer (in bytes) that the GGSN uses to receive GTP signaling messages and packets sent through the tunneling protocol. You can configure the N3 buffer using the gprs gtp n3-buffer-size command. |
GTP dynamic echo-timer minimum |
Current minimum time period (in seconds) used by the dynamic echo timer. You can configure the minimum value using the gprs gtp echo-timer dynamic minimum command. |
GTP dynamic echo-timer smooth factor |
Current multiplier used by the GGSN to calculate the T-dynamic for the dynamic echo timer. You can configure the smooth factor using the gprs gtp echo-timer dynamic smooth-factor command. |
GTP max pdp context |
Current maximum number of PDP contexts (mobile sessions) that can be activated on the GGSN. You can configure the maximum number of PDP context requests using the gprs maximum-pdp-context-allowed command. |
GTP max retry N3_request |
Maximum number of times that the GGSN attempts to send a signaling request to an SGSN. You can configure the maximum number of signaling requests made by the GGSN using the gprs gtp n3-requests command. |
GTP path echo interval |
Interval, in seconds, that the GGSN waits before sending an echo-request message to the SGSN. You can configure the path echo interval using the gprs gtp path-echo-interval command. |
GTP signal max wait time T3_response |
Interval, in seconds, that the GGSN waits before responding to a signaling request message. You can configure the maximum interval using the gprs gtp t3-response command. |
Related Commands
|
|
show gprs gtp statistics |
Displays the current GTP statistics for the GGSN (such as IE, GTP signaling, and GTP PDU statistics). |
show gprs gtp status |
Displays information about the current status of the GTP on the GGSN (such as activated PDP contexts, throughput, and QoS statistics). |
show gprs gtp path
To display information about one or more GTP paths between the GGSN and other GPRS devices, use the show gprs gtp path privileged EXEC command.
show gprs gtp path {remote-address ip-address [remote-port-num] | version gtp-version | all}
Syntax Description
remote-address ip-address [remote_port_num] |
Displays GTP path information for a specified remote IP address. Optionally, displays GTP path information for a specified remote IP address and port number. |
version gtp-version |
Displays the GTP paths by the GTP version (0 or 1). |
all |
Displays information for all GTP paths. |
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.1(1)GA |
This command was introduced. |
12.1(5)T |
This command was integrated in Cisco IOS Release 12.1(5)T. |
12.2(4)MX |
This command was incorporated in Cisco IOS Release 12.2(4)MX, and the following output field was added to the display: •Dynamic echo timer |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD. |
12.2(8)YW |
This command was incorporated in Cisco IOS Release 12.2(8)YW. •The version keyword option and the option to display GTP path information for a remote IP address and remote port number were added. •The GTP version output field was added to the display. |
Usage Guidelines
Use the show gprs gtp path command to display information about one or more GTP paths from the GGSN.
Examples
Example 1
The following example shows the output for the GTP path to the remote device with an IP address of 10.49.85.100:
router# show gprs gtp path 10.49.85.100
Local address Remote address GTP version Dynamic echo timer
10.10.10.1(2123) 10.49.85.100(2123) 1 5
10.10.10.1(2152) 10.49.85.100(2152) 1 5
Example 2
The following example shows the output for the GTP path to the remote device with an IP address of 10.49.85.100 and remote port number 2123:
router# show gprs gtp path 10.49.85.100 2123
Local address Remote address GTP version Dynamic echo timer
10.10.10.1(2123) 10.49.85.100(2123) 1 5
Example 3
The following example shows the output for all paths on the GGSN that are using GTP version 1:
router# show gprs gtp path version 1
Local address Remote address GTP version Dynamic echo timer
10.10.10.1(3386) 10.49.85.100(3386) 1 5
10.10.10.1(3386) 10.7.7.7(3386) 1 2
Example 4
The following example shows the output for all GTP paths on the GGSN:
router# show gprs gtp path all
Local address Remote address GTP version Dynamic echo timer
10.10.10.1(3386) 10.49.85.100(3386) 1 Disabled
10.10.10.1(3386) 10.1.1.1(3386) 0 2
10.10.10.1(3386) 10.7.7.7(3386) 1 5
Table 16 describes the fields shown in the display.
Table 16 show gprs gtp path Field Descriptions
|
|
Total number of path |
Total number of GTP paths currently established. |
Dynamic echo timer |
Current setting (in seconds) for the dynamic echo timer. "Disabled" appears when the dynamic echo timer is not in use. |
Local address |
IP address and port number for the local end of the GTP path. |
Remote address |
IP address and port number for the remote end of the GTP path, such as the address of the SGSN. |
GTP version |
Version of the GTP protocol (version 0 or 1) supported by the path. |
show gprs gtp pdp-context
To display a list of the currently active PDP contexts (mobile sessions), use the show gprs gtp pdp-context privileged EXEC command.
show gprs gtp pdp-context {tid tunnel_id | ms-address ip_address [apn-index access-point-index] | imsi imsi [nsapi nsapi [tft]] | path ip-address [remote-port-num] | access-point access-point-index | pdp-type {ip | ppp} | qos-umts-class {background | conversational | interactive | streaming} | qos {precedence {low | normal | high} | qos-delay {class1 | class2 | class3 | classbesteffort} | version gtp-version} | all}
Syntax Description
tid tunnel_id |
Displays PDP contexts by tunnel ID. This value corresponds to the IMSI plus NSAPI and can be up to 16 numeric digits. |
ms-address ip_address |
Displays PDP contexts for the specified mobile station IP address (in dotted-decimal format). |
apn-index access-point-index |
(Optional) Displays PDP contexts for the specified mobile station IP address at a particular access point. This option is required to display mobile stations that are accessing a private VPN. |
imsi imsi |
Displays PDP contexts by International Mobile Subscriber Identity (IMSI). The IMSI value can be up to 15 numeric digits. |
nsapi nsapi [tft] |
(Optional) Displays a particular PDP context by Network Service Access Point Identifier (NSAPI) for the specified IMSI. Optionally, displays the traffic flow template (TFT) filters associated with the NSAPI. |
path ip-address [remote_port_num] |
Displays PDP contexts by path. Optionally, displays PDP contexts by remote IP address and port number. |
access-point access-point-index |
Displays PDP contexts by access point. Possible values are 1 to 65535. |
pdp-type {ip | ppp} |
Displays PDP contexts that are transmitted using either IP or PPP. |
qos-umts-class |
Displays PDPs by UMTS QoS traffic class. You can specify the following traffic classes: background, conversational, interactive, and streaming. This option is available when UMTS QoS is enabled. |
qos-precedence |
Displays PDP contexts for a specified GPRS QoS precedence type. You can specify the following precedence types: low, normal, and high. This option is available when GPRS QoS canonical QoS is enabled. |
qos-delay |
Displays PDP contexts for a specified GPRS quality of service delay class type. You can specify the following delay class types: class1, class2, class3, and classbesteffort. This option is available when GPRS QoS delayed-based QoS is enabled. |
version gtp-version |
Displays PDP contexts by GTP version. The possible values are 0 or 1. |
all |
Displays all PDP contexts. |
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.1(1)GA |
This command was introduced. |
12.1(5)T |
This command was integrated into Cisco IOS Release 12.1(5)T. |
12.2(1) |
The MS International PSTN/ISDN Number (MSISDN) field was added to the output display. |
12.2(4)MX |
This command was incorporated in Cisco IOS Release 12.2(4)MX. •The pdp-type ppp and qos-delay options were added to the command. •The following fields were added to the output display of the tid version of this command: –cef_down_byte –cef_down_pkt –cef_drop –cef_up_byte –cef_up_pkt –gtp pdp idle time •The Network Init Information section was added to the output display of the tid version of this command with the following new fields: –Buf.Bytes –MNRG Flag –NIP State –PDU Discard Flag –SGSN Addr •The following fields were removed from the output display of the tid version of this command: –fast_up_pkt –fast_up_byte –fast_down_pkt –fast_down_byte –fast_drop •The "dynamic?" and "Dynamic" fields were removed from the output display of the all and tid versions of this command, and were replaced by the Source field. |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD and the following fields were added to the output display of the tid version of this command: •primary dns •secondary dns •primary nbns •secondary nbns |
12.2(8)YW |
This command was incorporated in the 12.2(8)YW. •The the option of displaying PDP contexts by remote IP address and port number was added. •The delay Qos class(req.) output field was added to the display of the tid version of this command when the mapping of GPRS QoS categories to delay QoS classes is enabled. •The ms-address, imsi, qos-umts-class and version options were added to the command. •The ggsn_addr_signal field was changed to the sgsn_addr_data in the output display of the tid version of this command. •The following fields were added to the output display of the tid version of this command: –control teid local –control teid remote –data teid local –data teid remote –primary pdp –nsapi |
Usage Guidelines
Use the show gprs gtp pdp-context command to display the currently active PDP contexts on the GGSN. You can display PDP contexts by tunnel ID, by IMSI, by access point, by PDP type, and by GPRS QoS precedence, UMTS QoS traffic class, or you can display all PDP contexts.
Several versions of the show gprs gtp pdp-context command display similar output. The examples provided show these two different types of output.
Interpreting the Effective Bandwidth
Example 2 provides sample output from the show gprs gtp pdp-context tid command, which includes the field called effective bandwidth (in bps). The effective bandwidth is determined according to the GPRS QoS canonical QoS class (premium, normal, or best effort) for the PDP context; it does not represent the actual bandwidth in use by the PDP context. The potential number of supported PDP contexts for that class of QoS can then be calculated according to the total amount of bandwidth (GSN resource) available to the GGSN.
For more information about GPRS QoS canonical QoS and resources on the GGSN, see the "Configuring QoS on the GGSN" chapter in the Cisco IOS Mobile Wireless Configuration Guide.
Examples
Example 1
The following is sample output of the show gprs gtp pdp-context all command:
router# show gprs gtp pdp-context all
TID MS Addr Source SGSN Addr APN
1234567890123456 10.11.1.1 Radius 10.4.4.11 www.pdn1.com
2345678901234567 Pending DHCP 10.4.4.11 www.pdn2.com
3456789012345678 10.21.1.1 IPCP 10.1.4.11 www.pdn3.com
4567890123456789 10.31.1.1 IPCP 10.1.4.11 www.pdn4.com
5678901234567890 10.41.1.1 Static 10.4.4.11 www.pdn5.com
Note The same output fields shown in Example 1 also appear when you use the access-point, path, pdp-type, qos-delay, or qos-precedence keyword options of the show gprs gtp pdp-context command.
Table 17 describes the fields shown in the display.
Table 17 show gprs gtp pdp-context all Field Descriptions
|
|
APN |
Access point name where the PDP context is active. |
MS Addr |
IP address of the mobile station. |
SGSN Addr |
IP address of the SGSN that is processing the packets. |
Source |
Source of IP addressing for the MS. The possible values are: •DHCP—Dynamic address allocation using DHCP. •IPCP—Dynamic address allocation for PPP PDP types, or for IP PDP types with PPP regeneration, using PPP IP Control Protocol. •Pending—Waiting for dynamic address allocation. Dynamic address source is unknown. •Radius—Dynamic address allocation using RADIUS. •Static—IP address is not dynamically assigned. |
TID |
Tunnel ID for the PDP context. |
Example 2
The following is sample output from the show gprs gtp pdp-context tid command for a PDP context
created by GTP version 1 and GPRS QoS canonical QoS is configured:
router#show gprs gtp pdp-context tid 1111111111111111
TID MS Addr Source SGSN Addr APN
1111111111111111 10.1.1.1 Radius 10.8.8.1 dns.com
current time :Mar 18 2002 11:24:36
user_name (IMSI):1111111111111111 MS address:10.1.1.1
MS International PSTN/ISDN Number (MSISDN):ABC
sgsn_addr_signal:10.8.8.1 sgsn_addr_data:10.8.0.1
control teid local: 0x63493E0C
control teid remove: 0x00000121
data teid local: 0x63483E10
data teid remote: 0x00000121
signal_sequence: 0 seq_tpdu_up: 0
upstream_signal_flow: 1 upstream_data_flow: 2
downstream_signal_flow:14 downstream_data_flow:12
pdp_create_time: Mar 18 2002 09:58:39
last_access_time: Mar 18 2002 09:58:39
mnrgflag: 0 tos mask map:00
gprs qos_req:091101 canonical Qos class(req.):01
gprs qos_neg:25131F canonical Qos class(neg.):01
rcv_pkt_count: 0 rcv_byte_count: 0
send_pkt_count: 0 send_byte_count: 0
cef_up_pkt: 0 cef_up_byte: 0
cef_down_pkt: 0 cef_down_byte: 0
Src addr violation: 2 paks, 1024 bytes
Dest addr violation: 2 paks, 1024 bytes
Redirected mobile-to-mobile traffic: 2 paks, 1024 bytes
** Network Init Information **
MNRG Flag: 0 PDU Discard Flag: 0
SGSN Addr: 172.16.44.1 NIP State: NIP_STATE_WAIT_PDP_ACTIVATION
Table 18 describes the fields shown in the display.
Note The Network Init Information section of the output appears only while network-initiated PDP contexts are being processed by the GGSN.
Note The same output fields shown in Example 2 also appear when you use the imsi keyword option of the show gprs gtp pdp-context command.
Table 18 show gprs gtp pdp-context tid Field Descriptions
|
|
APN |
Access point name where the PDP context is active. |
canonical Qos class (neg.) |
Negotiated canonical quality of service class for the PDP context, with the following values: •01—Best effort •02—Normal •03—Premium This field displays when GPRS QoS canonical QoS is enabled on the GGSN. |
canonical Qos class (req.) |
Requested GPRS canonical QoS class by the PDP context, with the following values: •01—Best effort •02—Normal •03—Premium This field displays when GPRS QoS canonical QoS is enabled on the GGSN. |
cef_down_byte |
Total number of G-PDU bytes CEF switched on the downlink, from the GGSN to the SGSN. |
cef_down_pkt |
Total number of G-PDU packets CEF switched on the downlink, from the GGSN to the SGSN. |
cef_drop |
Total number of G-PDU packets dropped during CEF switching. |
cef_up_byte |
Total number of G-PDU bytes CEF switched on the uplink, from the SGSN to the GGSN. |
cef_up_pkt |
Total number of G-PDU packets CEF switched on the uplink, from the SGSN to the GGSN. |
charging_id |
Unique 4-octet value generated by the GGSN for the PDP context. The value 0 is reserved. |
control teid local |
Uplink tunnel endpoint identifier (TEID) chosen by the GGSN for control plane messages. This field displays for PDP contexts created with GTP version 1. |
control teid remote |
Downlink TEID chosen by the SGSN for control plane messages. This field displays for PDP contexts created with GTP version 1. |
current time |
Date and time of the show command output. |
data teid local |
Uplink TEID chosen by the GGSN for G-PDUs. This field displays for PDP contexts created with GTP version 1. |
data teid remote |
Downlink TEID chosen by the SGSN for PDUs. This field displays for PDP contexts created with GTP version 1. |
Dest addr violation |
Number of packets (and bytes) dropped by the GGSN because of a source address violation. This field displays only when the security verify destination command is configured. Note This field does not apply to APNs using VRF. In addition, verification of destination addresses does not apply to GTP-PPP regeneration or GTP-PPP with L2TP.
|
downstream_data_flow |
Flow label of downlink G-PDUs. |
downstream_signal_flow |
Flow label of downlink signaling messages. |
effective bandwidth |
Estimated number of bits per second allocated by the GGSN for this PDP context. The effective bandwidth is determined according to the QoS class (premium, normal, or best effort) for the PDP context. The potential number of supported PDP contexts for that class of QoS can be calculated according to the total amount of bandwidth (GSN resource) available to the GGSN. This field displays when canonical QoS is enabled on the GGSN. Note The effective bandwidth does not represent actual bandwidth usage.
|
gprs qos_neg |
Negotiated quality of service for the PDP context. The field is in the format vwxyzz, which represents the following QoS classes (as defined in the GSM specifications for quality of service profiles): •v—Delay class •w—Reliability class •x—Peak throughput class •y—Precedence class •zz—Mean throughput class Note To determine the GPRS QoS attributes shown in this output, you must convert the value to binary and interpret the values to find the corresponding class attributes. Some of the bits represent "don't care" bits and are not interpreted as part of the final value. For more information about how to interpret this value, see the "Interpreting the Requested and Negotiated GPRS QoS" section of the "Configuring QoS" chapter in the Cisco IOS Mobile Wireless Configuration Guide.
|
gprs qos_req |
Requested quality of service by the PDP context. The field is in the format vwxyzz, which represents the following QoS classes (as defined in the GSM specifications for GPRS QoS profiles): •v—Delay class •w—Reliability class •x—Peak throughput class •y—Precedence class •zz—Mean throughput class Note See the Note in the description of the gprs qos_neg output field above.
|
gtp pdp idle time |
Current setting for the gprs idle-pdp-context purge-timer command, unless the session idle-time command is configured. Indicates the amount of idle time (in hours) allowed before PDP contexts are deleted. |
last_access_time |
Time when the PDP context for this TID was last accessed. The date format is MMM DD YYYY. The time format is hours:minutes:seconds. When a signaling packet or data packet for a PDP context arrives on the GGSN, the last_access_time is reset to the current date and time. If the last_access_time exceeds the purge timer for idle PDP contexts, then the PDP context is purged by the GGSN. |
mnrgflag |
Mobile not reachable flag, with the following values: •0—flag is off. •1—flag is on, indicating that the MS is not reachable |
MS_ADDR and MS Address |
IP address of the mobile station. |
MS International PSTN/ISDN Number (MSISDN) |
Integrated Services Digital Network (ISDN) number of the mobile station. |
nsapi |
Network Service Access Point Identifier (NSAPI). This field displays for PDP contexts created with GTP version 1. |
ntwk_init_pdp |
Network initiated PDP context indicator, with the following values: •0—Not a network initiated PDP context. This indicates a mobile initiated PDP context. •1—Network initiated PDP context |
pdp_create_time |
Time when the PDP context for this TID was created. The date format is MMM DD YYYY. The time format is hours:minutes:seconds. |
pdp reference count |
Number of subsystems on the GGSN that are aware of the PDP context. For example, if both the charging and GTP subsystems are aware of the PDP context, then the pdp reference counter shows a value of 2. |
primary dns |
IP address of the primary DNS server. |
primary nbns |
IP address of the primary NetBIOS Name Service (NBNS). |
primary pdp |
Whether the PDP is primary or secondary. Possible values are Y (PDP is primary) or N (PDP is secondary). This field displays for PDP contexts created with GTP version 1. |
RAupdate_flow |
Flow Label Data II information element in GTP header. This IE contains the flow label for data transmission between old and new SGSNs for a particular PDP context. This IE is requested by the new SGSN. |
rcv_byte_count |
Total number of G-PDU bytes received. For the GGSN, this is the total byte count on the uplink. |
rcv_pkt_count |
Total packet count of received G-PDUs. For the GGSN, this is the total byte count on the uplink. |
Redirected mobile-to-mobile traffic |
Number of packets (and bytes) dropped at the APN from which they exit because mobile-to-mobile traffic has been redirected. This field displays only when the redirect intermobile ip command is configured. |
secondary dns |
IP address of the secondary DNS server. |
secondary nbns |
IP address of the secondary NBNS. |
send_byte_count |
Total number of G-PDU bytes sent by the GSN (GGSN or SGSN D-node). |
send_pkt_count |
Total number of G-PDU packets sent by the GSN (GGSN or SGSN D-node). |
seq_tpdu_down |
Last sequence number used in the downlink T-PDU. This number wraps to 0 after 65535. |
seq_tpdu_up |
Last sequence number used in the uplink T-PDU. This number wraps to 0 after 65535. |
sgsn_addr_signal |
IP address of the SGSN that is processing the packets. |
sgsn_addr_data |
IP address of the SGSN that is processing tunnel packet data units (TPDUs). |
signal_sequence |
Last sequence number used in the GTP signaling message. |
Source |
Source of IP addressing for the MS. The possible values are: •DHCP—Dynamic address allocation using DHCP. •IPCP—Dynamic address allocation for PPP PDP types, or for IP PDP types with PPP regeneration, using PPP IP Control Protocol. •Pending—Waiting for dynamic address allocation. Dynamic address source is unknown. •Radius—Dynamic address allocation using RADIUS. •Static—IP address is not dynamically assigned. |
Src addr violation |
Number of packets (and bytes) dropped because of source address violation. This field displays only when the security verify source command is configured. |
TID |
Tunnel ID for the PDP context. |
tos mask map |
ToS value in IP header of this PDP context. |
umts qos_req |
Requested UMTS quality of service by the PDP context. This field displays when UMTS QoS is enabled on the GGSN. |
umts qos_neg |
Negotiated UMTS quality of service for the PDP context. This field displays when UMTS QoS is enabled on the GGSN. |
upstream_data_flow |
Flow label of uplink G-PDUs. |
upstream_signal_flow |
Flow label of uplink signaling messages. |
user_name (IMSI) |
International mobile subscriber identity for the PDP context. |
Table 19 describes the fields shown in the Network Init Information section of the output.
Note The Network Init Information section of the output appears only when network-initiated PDP contexts are unsuccessful.
Table 19 show gprs gtp pdp-context tid Network Init Information Field Descriptions
|
|
Buf.Bytes |
Number of bytes currently buffered for this network-initiated PDP context. |
last_access_time |
Time when the PDP context for this TID was last accessed. The date format is MMM DD YYYY. The time format is hours:minutes:seconds. When a signaling packet or data packet for a PDP context arrives on the GGSN, the last_access_time is reset to the current date and time. If the last_access_time exceeds the purge timer for idle PDP contexts, then the PDP context is purged by the GGSN. |
MNRG Flag |
Mobile not reachable flag, with the following values: •0—flag is off. •1—flag is on, indicating that the MS is not reachable |
NIP State |
State information for the network initiated PDP process on the GGSN. |
PDU Discard Flag |
Discarded PDU indicator for a network initiated PDP context, with the following values: •0—PDUs are not discarded. This indicates that PDUs for a network initiated PDP context are being sent to the SGSN. •1—PDUs are being discarded by the GGSN. PDUs are discarded by the GGSN when a network initiated PDP context procedure is unsuccessful. This occurs when the SGSN sends a rejection of the PDP context request to the GGSN with a Cause value of either "MS Refuses" or "MS is not GPRS Responding."
When the flag is set to 1, the GGSN ignores PDUs destined for that MS for the specified PDU discard period. The default period is 300 seconds (5 minutes). You can configure the PDU discard time using the gprs ntwk-init-pdp pdu-discard-period command. |
SGSN Addr |
IP address of the SGSN that is associated with the network-initiated procedure for this PDP context (used for paging). |
Related Commands
|
|
show gprs access-point |
Displays information about access points on the GGSN. |
show gprs gtp status |
Displays information about the current status of the GTP on the GGSN (such as activated PDP contexts, throughput, and QoS statistics). |
show gprs gtp statistics
To display the current GPRS Tunneling Protocol (GTP) statistics for the GGSN (such as IE, GTP signaling, and GTP PDU statistics), use the show gprs gtp statistics privileged EXEC command.
show gprs gtp statistics
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.1(1)GA |
This command was introduced. |
12.1(2)GB |
The following fields were added to the output display: •total created_pdp •total deleted_pdp |
12.1(5)T |
This command was integrated in Cisco IOS Release 12.1(5)T. |
12.2(4)MX |
This command was incorporated in Cisco IOS Release 12.2(4)MX, and the following new output fields were added: •ntwk_init_pdp_act_rej •ppp_regen_pending •ppp_regen_pending_peak •ppp_regen_total_drop •ppp_regen_no_resource •total created_ppp_pdp •total ntwkInit created pdp |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD. |
12.2(8)YW |
This command was incorporated in the Cisco IOS Release 12.2(8)YW and the following new output fields were added: •tft_semantic_error •tft_syntactic_error •packet_filter_semantic_error •packet_filter_syntactic_error •total deleted_ppp_pdp |
Usage Guidelines
Use the show gprs gtp statistics command to display the GTP statistics for the GGSN. The counter values displayed by this command represent totals accumulated since the last time the statistical counters were cleared using the clear gprs gtp statistics command.
Examples
The following is sample output of the show gprs gtp statistics command:
router# show gprs gtp statistics
version_not_support 0 msg_too_short 0
unknown_msg 0 unexpected_sig_msg 0
unexpected_data_msg 0 mandatory_ie_missing 0
mandatory_ie_incorrect 0 optional_ie_invalid 0
ie_unknown 0 ie_out_of_order 0
ie_unexpected 0 ie_duplicated 0
optional_ie_incorrect 0 pdp_activation_rejected 10981
tft_semantic_error 0 tft_syntactic_error 0
pkt_ftr_semantic_error 0 pkt_ftr_syntactic_error 0
non_existent 0 path_failure 0
total_dropped 0 signalling_msg_dropped 0
data_msg_dropped 0 no_resource 0
get_pak_buffer_failure 0 rcv_signalling_msg 15401
snd_signalling_msg 19243 rcv_pdu_msg 0
snd_pdu_msg 0 rcv_pdu_bytes 0
snd_pdu_bytes 0 total created_pdp 3761
total deleted_pdp 3661 total created_ppp_pdp 0
total deleted_ppp_pdp 0 ppp_regen_pending 0
ppp_regen_pending_peak 0 ppp_regen_total_drop 0
ppp_regen_no_resource 0 ntwk_init_pdp_act_rej 0
total ntwkInit created pdp 0
Table 20 describes the fields shown in the display:
Table 20 show gprs gtp statistics Field Descriptions
|
|
data_msg_dropped |
Number of GTP PDUs dropped. |
get_pak_buffer_failure |
Number of times the GGSN has failed to obtain a GTP packet. |
ie_duplicated |
Number of GTP messages received with a duplicated information element. |
ie_out_of_order |
Number of GTP messages received with an information element (IE) out of order. |
ie_unexpected |
Number of GTP messages received with an information element that not expected in the GTP message, but is defined in GTP. GTP messages with unexpected IEs are processed as if the IE was not present. |
ie_unknown |
Number of GTP messages received with an information element of an unknown type. |
mandatory_ie_incorrect |
Number of GTP messages received with an incorrect mandatory information element—for example, with an information element that has an incorrect length. |
mandatory_ie_missing |
Number of GTP messages received with a missing mandatory information element. |
msg_too_short |
Number of GTP messages received that are too short to hold the GTP header for the supported GTP version. |
no_resource |
Number of times a resource was not available for transmitting GTP messages. For example, the router may be out of memory. |
non-existent |
Number of |
ntwk_init_pdp_act_rej |
Number of rejected PDP context requests that were initiated by the network (PDN). |
optional_ie_incorrect |
Number of GTP messages received with an optional IE that is incorrect, which prevents the GGSN from processing the GTP message correctly. |
optional_ie_invalid |
Number of GTP messages received with an information element that contains a value that is not within the defined range for that IE. GTP messages with invalid optional IEs are processed as if the IE was not present. |
packet_filter_semantic_error |
Number of GTP messages received with an IE element with packet filter semantic errors. A semantic error is when the defined format of the information element (IE) is valid but the content of the IE is inconsistent or invalid. |
packet_filter_syntactic_error |
Number of GTP messages received with an IE element with packet filter syntactic errors. A syntactic error is when the coding of the IE is invalid. |
path_failure |
Number of path failures on the GPRS Support Node (GSN). |
pdp_activation_rejected |
Number of times a request to activate a PDP context was rejected. |
ppp_regen_no_resource |
Total number of rejected responses to create PDP context and delete PDP context requests due to unavailable resource on the GGSN for PPP regeneration. |
ppp_regen_pending |
Number of pending PPP regeneration sessions. |
ppp_regen_pending_peak |
Maximum number of pending PPP regeneration sessions since the statistic was cleared. |
ppp_regen_total_drop |
Total number of create PDP context and delete PDP context requests that were dropped due to the threshold limit being reached for maximum number of PPP regeneration sessions allowed on the GGSN. |
rcv_pdu_bytes |
Number of bytes received in protocol data units (PDUs). |
rcv_pdu_msg |
Number of PDU messages received. |
rcv_signaling_msg |
Number of GTP signaling messages received. |
signalling_msg_dropped |
Number of GTP signaling messages dropped. |
snd_pdu_bytes |
Number of PDU bytes sent. |
snd_pdu_msg |
Number of PDU messages sent. |
snd_signalling_msg |
Number of GTP signaling messages sent. |
tft_semantic_error |
Number of GTP messages received with an IE element with traffic flow template (TFT) semantic errors. A semantic error is when the defined format of the information element (IE) is valid but the content of the IE is inconsistent or invalid. |
tft_syntactic_error |
Number of GTP messages received with an IE element with TFT syntactic errors. A syntactic error is when the coding of the IE is invalid. |
total created_pdp |
Total number of PDP contexts created since system startup (supports Special Mobile Group (SMG)-28 standards level and later) |
total created_ppp_pdp |
Total number of PDP contexts created for PPP PDP PDU types. |
total deleted_pdp |
Total number of PDP contexts deleted since system startup (supports SMG-28 standards level and later) |
total deleted_ppp_pdp |
Total number of PDP contexts created for PPP PDP PDU types deleted since system startup. |
total_dropped |
Number of GTP messages dropped. |
total ntwkInit created pdp |
Number of PDP context requests activated by the GGSN that were initiated by the network (PDN). |
unexpected_data_msg |
Number of GTP PDUs received for nonexistent PDP contexts. |
unexpected_sig_msg |
Number of unexpected GTP signaling messages received—for example, a message received on the wrong end of the tunnel or a response message received for a request that was not sent by the GGSN. |
unknown_msg |
Number of unknown GTP messages received. |
version_not_support |
Number of GTP messages received from devices running an unsupported version of the GTP. |
Related Commands
|
|
show gprs gtp parameters |
Displays the current GTP parameters configured on the GGSN. |
show gprs gtp path |
Displays information about one or more GTP paths between the GGSN and other GPRS devices. |
show gprs gtp pdp-context |
Displays a list of the currently active PDP contexts (mobile sessions). |
show gprs gtp status |
Displays information about the current status of GTP on the GGSN. |
show gprs charging statistics |
Displays current statistics for the transfer of charging packets between the GGSN and charging gateways. |
show gprs gtp status
To display information about the current status of the GPRS Tunneling Protocol (GTP) on the GGSN (such as activated PDP contexts, throughput, and QoS statistics), use the show gprs gtp status privileged EXEC command.
show gprs gtp status
Syntax DescriptionDescription
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.1(1)GA |
This command was introduced. |
12.1(5)T |
This command was integrated in Cisco IOS Release 12.1(5)T. |
12.2(4)MX |
This command was incorporated in Cisco IOS Release 12.2(4)MX, and the following output fields were added: •activated_ppp_pdp •activated_ppp_regen_pdp •ntwk_init_pdp •qos_delay1_pdp •qos_delay2_pdp •qos_delay3_pdp •qos_delaybesteffort_pdp |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD. |
12.2(8)YW |
This command was incorporated in the Cisco IOS Release 12.2(8)YW and the following output fields were added: •activated gtpv0 pdp •activated gtpv1 pdp •activated ms |
Usage Guidelines
Use the show gprs gtp status command to display information about the status of GTP running on the GGSN. The output fields displayed by the show gprs gtp status command vary by the type of QoS method that is enabled on the GGSN.
The values displayed by the show gprs gtp status command show the current counts since the GGSN was started. Unlike the values displayed by the show gprs gtp statistics command, these values cannot be cleared.
Examples
Example 1
The following example shows output from the show gprs gtp status command for an activated network-initiated PDP context using the canonical QoS method:
Router# show gprs gtp status
gsn_used_bandwidth 7399 total gsn_resource 4294967295
activated_pdp 1 ntwk_init_pdp 1
mean_throughput_premium 1110.000
mean_throughput_normal 0.000 mean_throughput_besteffort 0.000
qos_high_pdp 1 qos_normal_pdp 0
qos_low_pdp 0 qos premium mean-throughput-deviation 0.100
Example 2
The following example shows output from the show gprs gtp status command for activated 2 PPP PDP contexts using the canonical QoS method. Both of the PDP contexts are using the premium QoS class, indicated by the qos_high_pdp output field:
Router# show gprs gtp status
gsn_used_bandwidth 14798 total gsn_resource 1048576
activated_pdp 2 ntwk_init_pdp 0
mean_throughput_premium 2220.000
mean_throughput_normal 0.000 mean_throughput_besteffort 0.000
qos_high_pdp 2 qos_normal_pdp 0
qos_low_pdp 0 qos premium mean-throughput-deviation 0.100
Note All output fields except those related to PDP context creation appear only when canonical QoS is enabled on the GGSN.
Example 3
The following example shows output from the show gprs gtp status command for 3 activated PPP regenerated PDP contexts not using either the canonical or delay QoS method:
Router# show gprs gtp status
activated_pdp 3 ntwk_init_pdp 0
activated_ppp_pdp 0 activated_ppp_regen_pdp 3
Example 4
The following example shows output from the show gprs gtp status command for 4 activated PDP contexts using the delay QoS method. The PDP contexts are using the delay class 1, delay class 2, and delay best effort class:
Router# show gprs gtp status
activated_pdp 4 ntwk_init_pdp 0
activated_ppp_pdp 0 activated_ppp_regen_pdp 0
qos_delay1_pdp 1 qos_delay2_pdp 1
qos_delay3_pdp 0 qos_delaybesteffort_pdp 2
Example 5
The following example shows output from the show gprs gtp status command with 2 active PDP contexts using GTP version 1, and 5 active mobile stations:
router# show gprs gtp status
activated_pdp 2 ntwk_init_pdp 0
Table 21 describes the fields shown in the display.
Table 21 show gprs gtp status Field Descriptions
|
|
activated gtpv0 pdp |
Number of PDP contexts created with GTP version 0. |
activated gtpv1 pdp |
Number of PDP contexts created with GTP version 1. |
activated ms |
Number of active mobile stations (MS). |
activated_pdp |
Number of PDP contexts currently activated. This number includes PDP contexts initiated by both the MS and the network (PDN). |
activated_ppp_pdp |
Number of point-to-point protocol PDP contexts currently activated. |
activated_ppp_regen_pdp |
Number of point-to-point protocol PDP contexts created on the GGSN. |
gsn_used_bandwidth |
Currently used bandwidth, in bits per second. Represents the cumulative bandwidth for all active PDP context requests currently using canonical QoS. This field only appears when canonical QoS is enabled. |
mean_throughput_besteffort |
Total mean throughput for best effort QoS users, in bits per second. Represents the cumulative throughput for all active PDP context requests classified in the best effort canonical QoS class. This field only appears when canonical QoS is enabled. |
mean_throughput_normal |
Total mean throughput for normal QoS users, in bits per second. Represents the cumulative throughput for all active PDP context requests classified in the normal canonical QoS class. This field only appears when canonical QoS is enabled. |
mean_throughput_premium |
Total mean throughput for premium QoS users, in bits per second. Represents the cumulative throughput for all active PDP context requests classified in the premium canonical QoS class. This field only appears when canonical QoS is enabled. |
ntwk_init_pdp |
Current number of active PDP contexts that are initiated by the network to an MS. |
qos_delay1_pdp |
Current number of active PDP contexts that are classified in the class 1 delay QoS class. This field only appears when delay QoS is enabled. |
qos_delay2_pdp |
Current number of active PDP contexts that are classified in the class 2 delay QoS class. This field only appears when delay QoS is enabled. |
qos_delay3_pdp |
Current number of active PDP contexts that are classifed in the class 3 delay QoS class. This field only appears when delay QoS is enabled. |
qos_delaybesteffort_pdp |
Current number of active PDP contexts that are classified in the best effort delay QoS class. This field only appears when delay QoS is enabled. |
qos_high_pdp |
Current number of active PDP contexts that are classified in the premium canonical QoS class. This field only appears when canonical QoS is enabled. |
qos_low_pdp |
Current number of PDP contexts that are classified in the best effort canonical QoS class. This field only appears when canonical QoS is enabled. |
qos_normal_pdp |
Current number of PDP contexts that are classified in the normal canonical QoS class. This field only appears when canonical QoS is enabled. |
qos premium mean-throughput-deviation |
Current mean throughput deviation for QoS. This field only appears when canonical QoS is enabled. |
total gsn_resource |
Currently available GSN resources. This field only appears when canonical QoS is enabled. |
Related Commands
|
|
encapsulation gtp |
Sets the encapsulation type for all connections established using the virtual template to GTP. This is mandatory for all GTP interfaces. |
show gprs gtp statistics |
Displays the current GTP statistics for the GGSN. |
show gprs gtp-director pending-request
Note This feature is not supported in GGSN Release 4.0.
To display a list of the create PDP context requests sent by GDM to a real GGSN that are pending expiration of the retry timer, use the show gprs gtp-director pending-request privileged EXEC command.
show gprs gtp-director pending-request {tid hex-data | all}
Syntax Description
tid hex-data |
Displays the create PDP context currently requested by GDM for the specified tunnel ID. Enter the TID in hexadecimal format. |
all |
Displays a list of all create PDP contexts currently requested by GDM. |
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.2(4)MX |
This command was introduced. |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD. |
12.2(8)YW |
This command was incorporated in Cisco IOS Release 12.2(8)YW |
Usage Guidelines
Use the show gprs gtp-director pending-request command to display a list of the create PDP context requests currently sent by GDM to a real GGSN that are pending expiration of the retry timer.
Note The show gprs gtp-director pending-request command shows only those PDP contexts that have been requested by GDM for a real GGSN—it does not represent the number of PDP contexts that are currently active with that GGSN.
The create PDP context requests that have been sent will continue to appear in the GDM output display until the GTP director retry timeout period has expired. You can configure the GTP director retry timeout period using the gprs gtp-director retry-timeout command.
Examples
Example 1
The following is sample output of the show gprs gtp-director pending-request tid command. The output shows that GDM has sent a create PDP context request for TID 1234120000000000 to the real GGSN with IP address 10.41.41.1 for a real APN called corporateb.com.
GDM received the original create PDP context request from the SGSN with IP address 10.23.23.1, for an APN called corporate. The corporate APN is a virtual APN that is configured at the HLR and at the DNS server used by the SGSN. The DNS server used by the SGSN should return the IP address of the GDM router for the virtual APN name.
Notice that corporateb.com appears under the output field called Domain-Name, which represents the domain portion of the username. The username (with format login@domain) is specified in the protocol configuration option (PCO) of the original create PDP context request from the SGSN. The domain name becomes the APN that GDM specifies in its create PDP context request sent to the real GGSN. In this case, GDM has sent a create PDP context request for TID 1234120000000000 to GGSN 10.41.41.1 for the corporateb.com APN:
router# show gprs gtp-director pending-request tid 1234120000000000
TID GGSN-ADDR SGSN-ADDR APN-NAME DOMAIN-NAME
1234120000000000 10.41.41.1 10.23.23.1 corporate corporateb.com
Example 2
The following is sample output of the show gprs gtp-director pending-request all command:
router# show gprs gtp-director pending-request all
TID GGSN-ADDR SGSN-ADDR APN-NAME DOMAIN-NAME
1234000000000000 10.41.41.1 10.23.23.1 corporate corporatea.com
1234120000000000 10.41.41.1 10.23.23.1 corporate corporateb.com
8808000000000000 10.41.41.1 10.23.23.1 corporate corporatec.com
Example 3
The following is sample output of the show gprs gtp-director pending-request tid command, where no domain name has been provided in the PCO IE. In this case, GDM specifies corporatea.com as the APN in the create PDP context request to the GGSN at 10.41.41.1:
router# show gprs gtp-director pending-request tid 1111220000333000
TID GGSN-ADDR SGSN-ADDR APN-NAME DOMAIN-NAME
1111220000333000 10.41.41.1 10.23.23.1 corporatea.com —
Table 22 describes the fields shown in the displays:
Table 22 show gprs gtp-director pending-request Field Descriptions
|
|
TID |
Tunnel identifier of the PDP context request. |
GGSN-ADDR |
IP address of the real GGSN to which GDM has sent the create PDP context request. |
SGSN-ADDR |
IP address of the SGSN from which the original create PDP context request was received by GDM. |
APN-NAME |
APN name specified in the original create PDP context request from the SGSN. Note In the case where a domain name is provided in the PCO information element (IE) of the create PDP context request, this APN represents a virtual APN name, which means that this APN does not correspond to a real destination network. GDM determines the real destination network by the domain requested in the PCO IE. |
DOMAIN-NAME |
Domain name specified in the username portion of the PCO. This domain is the APN of the real destination network that is requested by GDM in the create PDP context request to the real GGSN. Note If the Domain-Name field contains a dash, it indicates that the domain name is not provided in the PCO IE. In this case, GDM uses the value of the APN as the real destination network. |
.
Related Commands
|
|
gprs gtp-director retry-timeout |
Specifies the amount of time during which the GTP director forwards retries from an SGSN to the selected GGSN to establish a PDP context. |
show gprs gtp-director statistics
To display the current statistics for create requests received by GDM, use the show gprs gtp-director statistics privileged EXEC command.
show gprs gtp-director statistics
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.2(4)MX |
This command was introduced. |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD. |
12.2(8)YW |
This command was incorporated in Cisco IOS Release 12.2(8)YW |
Usage Guidelines
Use the show gprs gtp-director statistics command to display the current statistics for create requests received by GDM.
Most of the counter values displayed by this command represent totals accumulated since the last time the statistical counters were cleared using the clear gprs gtp-director statistics command. However, the counter for the number of unique PDP contexts pending retry timeout increments and decrements as the GTP director idle time-out period is reached for a forwarded PDP context.
Examples
The following is sample output of the show gprs gtp-director statistics command:
router# show gprs gtp-director statistics
Number of unique pdp-contexts forwarded: 23
Total number of create requests forwarded: 50
Total number of create requests rejected: 0
Number of unique pdp-contexts pending retry-timeout: 2
Total number of unsupported messages received: 0
Total number of requests dropped: 0
Table 23 describes the fields shown in the display.
Table 23 show gprs gtp-director statistics Field Descriptions
|
|
Number of unique pdp-contexts forwarded |
Number of create PDP context requests with unique TIDs that GDM has forwarded to a real GGSN. This number does not include retries by the SGSN. |
Total number of create requests forwarded |
Total number of create PDP context requests, including retries from the SGSN, that GDM has forwarded to a real GGSN. |
Total number of create requests rejected |
Total number of create PDP context requests sent by the SGSN that GDM has rejected. For example, if an invalid domain name is requested, the create PDP context request is rejected. |
Number of unique pdp-contexts pending retry-timeout |
Number of create PDP context requests with unique TIDs, that have been forwarded by GDM to a real GGSN, whose retry timeout period has not expired. When the retry timeout period is reached, this counter is decremented. You can display the create PDP context requests that are pending retry timeout using the show gprs gtp-director pending-request command. |
Total number of unsupported messages received |
Total number of messages received that GDM cannot process (for example, delete PDP context requests or echo messages). Under normal conditions, this counter should not increment. If the counter is incrementing, a problem in the network is indicated. The only signaling message that GDM receives and processes is a create PDP context request. |
Total number of requests dropped |
Total number of create PDP context requests that were unable to be forwarded by GDM. Dropped requests indicate a routing problem between the GTP stack and the IP stack. However, this counter does not indicate problems at the IP level. |
Related Commands
|
|
clear gprs gtp-director statistics |
Clears the current GDM forwarded and rejected request counters. |
gprs gtp-director retry-timeout |
Specifies the amount of time during which the GTP director forwards retries from an SGSN to the selected GGSN to establish a PDP context. |
show gprs gtp-director pending-request |
Displays a list of the create PDP context requests sent by GDM to a real GGSN that are pending retry timeout. |
show gprs ms-address exclude-range
To display the IP address range(s) configured on the GGSN for the GPRS network, use the show gprs ms-address exclude-range privileged EXEC command.
show gprs ms-address exclude-range
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.2(4)MX |
This command was introduced. |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD. |
12.2(8)YW |
This command was incorporated in Cisco IOS Release 12.2(8)YW |
Usage Guidelines
Use the show gprs ms-address exclude-range command to display the IP address range(s) configured on the GGSN for the GPRS network.
IP addresses are 32-bit values.
Examples
The following is sample output of the show gprs ms-address exclude-range command:
router# show gprs ms-address exclude-range
Table 24 describes the fields shown in the display.
Table 24 show gprs ms-address exclude-range Field Descriptions
|
|
Start IP |
IP address at the beginning of the range. |
End IP |
IP address at the end of the range. |
Related Commands
|
|
gprs ms-address exclude-range |
Specifies the IP address range(s) used by the GPRS network and thereby excluded from the mobile station (MS) IP address range. |
show gprs plmn ip address
To display the IP address range(s) configured for a PLMN, use the show gprs plmn ip address privileged EXEC command.
show gprs plmn ip address
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.2(8)YW |
This command was introduced. |
Usage Guidelines
Use the show gprs plmn ip address command to display the IP address range(s) configured for a PLMN.
IP addresses are 32-bit values.
Examples
The following is sample output of the show gprs plmn ip address command:
router# show gprs plmn ip address
PLMN Start IP End IP Range Type
Table 24 describes the fields shown in the display.
Table 25 show gprs plmn ip address Field Descriptions
|
|
PLMN Start IP |
IP address at the beginning of the range. |
End IP |
IP address at the end of the range. |
Range Type |
|
Related Commands
|
|
gprs plmn ip address |
Specifies the PLMN IP address range(s) used by the GGSN. |
show gprs qos status
To display the number of PDP contexts currently active on the GGSN for a particular QoS class, use the show gprs qos status privileged EXEC command.
show gprs qos status
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.2(8)YW |
This command was introduced. |
Usage Guidelines
Use the show gprs qos status command to display the number of PDP contexts currently active on the GGSN for a particular QoS class.
Examples
Example 1
The following example shows output from the show gprs qos status command for UMTS QoS:
router# show gprs qos status
conversational_pdp 100 streaming_pdp 150
interactive_pdp 1345 background_pdp 2000
Table 26 describes the fields shown in the display.
Table 26 show gprs qos status Field Descriptions
|
|
type |
Type of QoS. Possible QoS types are: •Canonical—Configured using the gprs qos map canonical-qos command. •Delay—Configured using the gprs qos map delay command. •UMTS—Configured using the gprs qos map umts command. •None—No QoS is configured on the GGSN. |
conversational_pdp |
Current number of PDP contexts that have a conversational UMTS QoS traffic class. |
streaming_pdp |
Current number of PDP contexts that have a streaming UMTS QoS traffic class. |
interactive_pdp |
Current number of PDP contexts that have a interactive UMTS QoS traffic class. |
background_pdp |
Current number of PDP contexts that have a background UMTS QoS traffic class. |
Example 2
The following example displays output from the show gprs qos status command for canonical QoS:
router# show gprs qos status
gsn_used_bandwidth:1110.000 total gsn_resource:1048576
mean_throughput_premium:0.000
mean_throughput_normal:1110.000 mean_throughput_besteffort 0.000
qos_high_pdp:0 qos_normal_pdp:1
qos_low_pdp :0 qos_premium mean-throughput-deviation 0.100
Table 27 describes the fields shown in the display.
Table 27 show gprs qos status Field Descriptions
|
|
type |
Type of QoS. Possible QoS types are: •Canonical—Configured using the gprs qos map canonical-qos command. •Delay—Configured using the gprs qos map delay command. •UMTS—Configured using the gprs qos map umts command. •None—No QoS is configured on the GGSN. |
gsn_used_bandwidth |
Currently used bandwidth, in bits per second. |
total gsn_resource |
Currently available GSN resources. |
mean_throughput_premium: |
Total mean throughput for premium QoS users, in bytes. |
mean_throughput_normal |
Total mean throughput for normal QoS users, in bytes. |
mean_throughput_besteffort |
Total mean throughput for best effort QoS users, in bytes. |
qos_high_pdp |
Current number of PDP contexts that have a high QoS. |
qos_normal_pdp |
Current number of PDP contexts that have a normal QoS. |
qos_low_pdp |
Current number of PDP contexts that have a low QoS. |
qos_premium mean-throughput-deviation |
Current mean throughput deviation for QoS. |
Example 3
The following example displays output from the show gprs qos status command for delay QoS:
router# show gprs qos status
qos_delay1_pdp:0 qos_delay2_pdp: 0
qos_delay3_pdp:0 qos_delaybesteffort_pdp 0
Table 28 describes the fields shown in the display.
Table 28 show gprs qos status Field Descriptions
|
|
type |
Type of QoS. Possible QoS types are: •Canonical—Configured using the gprs qos map canonical-qos command. •Delay—Configured using the gprs qos map delay command. •UMTS—Configured using the gprs qos map umts command. •None—No QoS is configured on the GGSN. |
qos_delay1_pdp |
Current number of PDP contexts that have a delay1 QoS class. |
qos_delay2_pdp |
Current number of PDP contexts that have a delay2 QoS class. |
qos_delay3_pdp |
Current number of PDP contexts that have a delay3 QoS class. |
qos_delaybesteffort_pdp |
Current number of PDP contexts that have a delaybesteffort_pdp QoS class. |
Example 4
The following example shows output from the show gprs qos status command when no QoS has been configured on the GGSN:
router# show gprs qos status
Related Commands
|
|
gprs qos map canonical-qos |
Enables mapping of GPRS QoS categories to a canonical QoS method that includes best-effort, normal, and premium QoS classes. |
gprs qos map delay |
Enables Delay QoS on the GGSN. |
gprs qos map umts |
Enables UMTS QoS on the GGSN. |
show gprs umts-qos map traffic-class
To display UMTS QoS mapping information, use the show gprs umts-qos map traffic-class privileged EXEC command.
show gprs umts-qos map traffic-class {all | signalling | conversational | streaming | interactive | background}
Syntax Description
all |
Displays information for all UMTS QoS traffic classes. |
signalling |
Displays information for the UMTS QoS traffic class signalling. |
conversational |
Displays information for the UMTS QoS traffic class conversational. |
streaming |
Displays information for the UMTS QoS traffic class streaming. |
interactive |
Displays information for the UMTS QoS traffic class interactive. |
background |
Displays information for the UMTS QoS traffic class background. |
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
|
|
12.2(8)YW |
This command was introduced. |
Usage Guidelines
Use the show gprs umts-qos map traffic-class command to display information about UMTS QoS mapping.
Examples
The following example shows output from the show gprs umts-qos map traffic-class command for all UMTS QoS traffic classes:
router# show gprs umts-qos map traffic-class all
Traffic Class Diffserv PHB Group Diffserv Code Point
signaling Signaling Class 40
conversational EF Class 46
streaming AF2 Class 18,20,22
interactive AF3 Class 26,28,30
Table 29 describes the fields shown in the display.
Table 29 show gprs umts-qos map traffic-class Field Descriptions
|
|
Traffic Class |
Type of UMTS QoS traffic class as specified in the gprs umts-qos map traffic-class command. The UMTS QoS traffic classes are: •signaling •conversational •streaming •interactive •background |
Diffserv PHB Group |
Type of DiffServ PHB group as specified in the gprs umts-qos map diffserv-phb command. Possible DiffServ PHB groups are: •signalling-class •ef-class •af1-class •af2-class •af3-class •af4-class •best-effort |
Diffserv Code Point |
Number of DSCPs as specified in the gprs umts-qos map diffserv-phb command. |
Related Commands
|
|
gprs umts-qos map traffic-class |
Specifies a QoS mapping from the UMTS traffic classes to a differentiated services (DiffServ) per-hop behavior (PHB) group |
gprs umts-qos map diffserv-phb |
Assigns a differentiated services code point (DSCP) to a DiffServ PHB group. |
subscription-required
To specify that the GGSN checks the value of the selection mode in a PDP context request to determine if a subscription is required to access a PDN through a particular access point, use the subscription-required access-point configuration command. To specify that no subscription is required, use the no form of this command.
subscription-required
no subscription-required
Syntax Description
This command has no arguments or keywords.
Defaults
No subscription is required
Command Modes
Access-point configuration.
Command History
|
|
12.1(1)GA |
This command was introduced. |
12.1(5)T |
This command was integrated in Cisco IOS Release 12.1(5)T. |
12.2(4)MX |
This command was incorporated in Cisco IOS Release 12.2(4)MX. |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD. |
12.2(8)YW |
This command was incorporated in Cisco IOS Release 12.2(8)YW |
Usage Guidelines
Use the subscription-required command to specify that the GGSN checks the value of the selection mode in a PDP context request to determine if a subscription is required for user access to PDNs through the current access point. When you configure the subscription-required command at the APN, the GGSN looks for the "subscription verified" selection mode in the PDP context request to establish the session. If the GGSN finds that the selection mode is designated as subscription not verified in the PDP context request, then the GGSN rejects the PDP context request.
The subscription must be set up by the service provider, and subscription information must be passed with the mobile user's PDP context requests.
Examples
The following example specifies that the GGSN checks for subscription verification in the selection mode before establishing a session at the access-point:
access-point-name gprs.somewhere.com
dhcp-gateway-address 10.88.0.1
vrf
To configure VPN routing and forwarding at a GGSN access point and associate the access point with a particular VRF instance, use the vrf access-point configuration command.
vrf vrf-name
Syntax Description
vrf-name |
Name of the corresponding VRF instance with which the access point is associated. |
Defaults
No default behavior or values.
Command Modes
Access-point configuration
Command History
|
|
12.2(4)MX |
This command was introduced. |
12.2(8)YD |
This command was incorporated in Cisco IOS Release 12.2(8)YD. |
12.2(8)YW |
This command was incorporated in Cisco IOS Release 12.2(8)YW |
Usage Guidelines
Use the vrf command to configure VPN routing and forwarding (VRF) at a GGSN access point and associate the access point with a particular VRF instance. The vrf-name should match the name configured in an ip vrf global configuration command, and also the ip vrf forwarding command at the Gi interface.
To support VRF, you must also enable Cisco Express Forwarding (CEF) switching on the router using the ip cef global configuration command.
If you are also configuring DHCP services at the APN, then you must also configure the dhcp-server ip-address vrf command.
Note Memory constraints might occur if you define a large number of access points to support VPN Routing and Forwarding (VRF).
Examples
The following example shows a VRF configuration for vpn3 (without tunneling) using the ip vrf global configuration command. Because the ip vrf command establishes both VRF and CEF routing tables, notice that ip cef also is configured at the global configuration level to enable CEF switching at all of the interfaces.
The following other configuration elements must also associate the same VRF named vpn3:
•FastEthernet0/0 is configured as the Gi interface using the ip vrf forwarding interface configuration command.
•Access-point 2 implements VRF using the vrf command access-point configuration command.
The DHCP server at access-point 2 also is configured to support VRF. Notice that access-point 1 uses the same DHCP server, but is not supporting the VRF address space. The IP addresses for access-point 1 will apply to the global routing table:
aaa group server radius foo
aaa authentication ppp foo group foo
aaa authorization network default group radius
aaa accounting exec default start-stop group foo
ip address 10.30.30.30 255.255.255.255
ip address 10.27.27.27 255.255.255.255
interface FastEthernet0/0
ip address 10.50.0.1 255.255.0.0
interface FastEthernet1/0
ip address 10.70.0.1 255.255.0.0
ip address 10.8.0.1 255.255.255.0
interface Virtual-Template1
gprs access-point-list gprs
ip route 10.10.0.1 255.255.255.255 Virtual-Template1
ip route vrf vpn3 10.100.0.5 255.255.255.0 fa0/0 10.50.0.2
ip route 10.200.0.5 255.255.255.0 fa1/0 10.70.0.2
gprs access-point-list gprs
access-point-name gprs.pdn.com
ip-address-pool dhcp-proxy-client
dhcp-gateway-address 10.30.30.30
network-request-activation
access-point-name gprs.pdn2.com
access-mode non-transparent
ip-address-pool dhcp-proxy-client
dhcp-server 10.100.0.5 10.100.0.6 vrf
dhcp-gateway-address 10.27.27.27
aaa-group authentication foo
gprs default ip-address-pool dhcp-proxy-client
gprs gtp ip udp ignore checksum
radius-server host 10.2.3.4 auth-port 1645 acct-port 1646 non-standard
radius-server host 10.6.7.8 auth-port 1645 acct-port 1646 non-standard
radius-server key ggsntel
Related Commands
|
|
dhcp-server |
Specifies a primary (and backup) DHCP server to allocate IP addresses to MS users entering a particular PDN access point. |
ip cef |
Enables CEF on the RP card. |
ip vrf |
Configures a VRF routing table. |
ip vrf forwarding |
Associates a VRF with an interface or subinterface. |
rd |
Creates routing and forwarding tables for a VRF and and specifies the default route distinguisher for a VPN. |