Enables the specification
of some of the optional fields in the CDRs that the GSN (GGSN or
SGSN) generates and/or how the information is to be presented.
Many keywords are also applicable to S-GW and P-GW CDRs.
Product
GGSN
P-GW
SAEGW
SaMOG
SGSN
S-GW
Privilege
Security Administrator,
Administrator
Mode
Exec > Global Configuration
> Context Configuration > GTPP Server Group Configuration
configure > context context_name > gtpp group group_name
Entering the above
command sequence results in the following prompt:
[context_name]host_name(config-gtpp-group)#
Syntax
Syntax Description
gtpp attribute { apn-ambr [ include-for-all-bearers | include-for-default-bearer | include-for-non-gbr-bearers ] | apn-ni | apn-selection-mode | charging-characteristic-selection-mode | camel-info | cell-plmn-id | diagnostics [ abnormal-release-cause ] | direct-tunnel | duration-ms | dynamic-flag | dynamic-flag-extension | furnish-charging-information | imei | imsi-unauthenticated-flag | lapi | local-record-sequence-number | losdv | ms-timezone | msisdn | node-id | node-id-suffix STRING | pdn-connection-id | pdp-address | pdp-type | pgw-ipv6-addr | pgw-plmn-id | plmn-id | qos max-length | rat | recordextension | record-extensions rat | record-type { sgsnpdprecord | sgwrecord } | served-mnai | served-pdp-pdn-address-extension | served-pdp-pdn-address-prefix-length | sgsn-change | sms { destination-number | recording-entity | service-centre } | sgw-ipv6-addr | sna-ipv6-addr | sponsor-id | start-time | stop-time | twanuli | uli | user-csg-information } +
default gtpp attribute { apn-ambr [ include-for-all-bearers | include-for-default-bearer | include-for-non-gbr-bearers ] | apn-ni | apn-selection-mode | charging-characteristic-selection-mode | cell-plmn-id | diagnostics | direct-tunnel | duration-ms | dynamic-flag | dynamic-flag-extension | furnish-charging-information | imei | imsi-unauthenticated-flag | lapi | local-record-sequence-number | losdv | ms-timezone | msisdn | node-id | pdn-connection-id | pdp-address | pdp-type | pgw-ipv6-addr | pgw-plmn-id | plmn-id | qos | rat | recordextension | record-extensions rat | served-mnai | served-pdp-pdn-address-extension | served-pdp-pdn-address-prefix-length | sgsn-change | sgw-ipv6-addr | sms { destination-number | recording-entity | service-centre } | sna-ipv6-addr | sponsor-id | start-time | stop-time | twanuli | uli | user-csg-information }
no gtpp attribute { apn-ambr [ include-for-all-bearers | include-for-default-bearer | include-for-non-gbr-bearers ] | apn-ni | apn-selection-mode | charging-characteristic-selection-mode | cell-plmn-id | diagnostics | direct-tunnel | duration-ms | dynamic-flag | dynamic-flag-extension | furnish-charging-information | imei | imsi-unauthenticated-flag | lapi | local-record-sequence-number | losdv | ms-timezone | msisdn | node-id | pdn-connection-id | pdp-address | pdp-type | pgw-ipv6-addr | pgw-plmn-id | plmn-id | qos | rat | recordextension | record-extensions rat | record-type | served-mnai | served-pdp-pdn-address-extension | served-pdp-pdn-address-prefix-length | sgsn-change | sgw-ipv6-addr | served-mnai | sms { destination-number | recording-entity | service-centre }| sna-ipv6-addr | sponsor-id | start-time | stop-time | twanuli | uli | user-csg-information }
default
Resets the default
attribute values for this GTPP group configuration.
no
Disables the specified
optional field so that the information will not be present in generated CDRs.
apn-ambr [ include-for-all-bearers | include-for-default-bearer | include-for-non-gbr-bearers ]
Default: Disabled
This keyword controls
the inclusion of the optional field "apn-ambr" in
the PGW-CDRs in the custom24 GTPP dictionary.
Important: This keyword option
will be available only if a valid license is installed. For more information,
contact your Cisco account representative.
The APN Aggregate Maximum
Bit Rate (AMBR) is a subscription parameter stored per APN. It limits
the aggregate bit rate that can be expected to be provided across
all non-GBR bearers and across all PDN connections of the same APN.
Each of these non-GBR bearers potentially utilize the entire APN
AMBR, e.g. when the other non-GBR bearers do not carry any traffic.
The APN AMBR is present as part of QoS information.
In 15.0 and later releases,
this CLI command should be configured along with the following additional
options to support APN-AMBR reporting in SGW-CDRs in all GTPP dictionaries.
- include-for-all-bearers:
Includes the APN-AMBR information in SGW-CDRs for all bearers (GBR
and NON-GBR)
- include-for-default-bearer:
Includes APN-AMBR information in SGW-CDRs only for default bearer.
- include-for-non-gbr-bearers:
Includes APN-AMBR information for non-gbr-bearers.
This feature is required
to enable post-processing of CDRs to verify MVNO subscribers actual
QoS against invoicing systems.
Important: This CLI command and
the associated options are not available for products other than
S-GW and P-GW. The option "non-gbr-bearers-only" is
available in S-GW and P-GW but the other options are available in
S-GW only.
In
the P-GW implementation, if the CLI command "gtpp attribute apn-ambr" is
configured, it will be treated as "gtpp attribute apn-ambr
non-gbr-bearers-only". In case of S-GW/P-GW
combo if any of the options is configured, it will be considered
that the attribute is available.
apn-ni
Default: Enabled
This keyword controls
the inclusion of the optional field "APN" in the
x-CDRs.
apn-selection-mode
Default: Enabled
This keyword controls
the inclusion of the optional field "APN Selection Mode" in
the x-CDRs.
camel-info
SGSN only
Enter this keyword
to include CAMEL-specific fields in SGSN CDRs. Default: Disabled
cell-plmn-id
SGSN only
Enter this keyword
to enable the system to include the Cell PLMN ID field in the M-CDR. Default:
Disabled
charging-characteristic-selection-mode
Default: Enabled
This keyword controls
the inclusion of the optional field "Charging Characteristic
Selection Mode" in the x-CDRs.
diagnostics [ abnormal-release-cause ]
Default: Disabled
Enables the system
to include the Diagnostic field in the CDR that is created when
PDP contexts are released. The field will include one of the following
values:26 - For GGSN:
if the GGSN sends "delete PDP context request" for any
other reason (e.g., the operator types "clear subscribers" on
the GGSN). For SGSN: The SGSN
includes this cause code in the S-CDR to indicate that a secondary
PDP context activation request or a PDP context modification request
has been rejected due to insufficient resources.
36 - For GGSN:
this cause code is sent in the G-CDR to indicate the PDP context
has been deactivated in the GGSN due to the SGSN having sent a "delete
PDP context request" to the GGSN. For SGSN, this cause
code is used to indicate a regular MS or network-initiated PDP context
deactivation.
37 - when the network
initiates a QoS modification, the SGSN sends in the S-CDR to indicate
that the MS initiation deactivate request message has been rejected
with QoS not accepted as the cause.
38 - if the GGSN
sends "delete PDP context request" due to GTP-C/GTP-U echo
timeout with SGSN. If the SGSN sends this cause code, it indicates
PDP context has been deactivated due to path failure, specifically
GTP-C/GTP-U echo timeout.
39 - SGSN only
- this code indicates the network (GGSN) has requested a PDP context
reactivation after a GGSN restart.
40 - if the GGSN
sends "delete PDP context request" due to receiving
a RADIUS Disconnect-Request message.
abnormal-release-cause:
This keyword controls the inclusion of abnormal bearer termination
information in diagnostics field of SGW-CDR. Note that the CLI command "gtpp attribute diagnostics" will disable abnormal-release-cause and
enable the diagnostics field.
The no gtpp attribute diagnostics command
will disable both abnormal-release-cause and diagnostics field.
Important: The Abnormal Bearer
Termination feature is currently applicable only to custom34 and custom35
GTPP dictionaries. That is, the bearer termination cause is populated
in SGW-CDR for custom34 and custom35 dictionaries, and PGW-CDRs
for custom35 GTPP dictionary when the cause for record closing is "Abnormal
Release".
direct-tunnel
Default: Disabled
Includes the Direct
Tunnel field in PGW-CDR/eG-CDRs.
This keyword is applicable
for GGSN, P-GW and S-GW only.
duration-ms
Specifies that the
information contained in the mandatory Duration field be reported
in milliseconds instead of seconds (as the standards require). Default:
Disabled
dynamic-flag
Default: Enabled
This keyword controls
the inclusion of the optional field "Dynamic Flag" in
the x-CDRs.
dynamic-flag-extension
Default: Enabled
This keyword controls
the inclusion of the optional field "Dynamic Address Flag Extension" in
the x-CDRs.
This field is seen
in the CDR when the IPv4 address is dynamically assigned for a dual
PDP context. This extension field is required in the 3GPP Release
10 compliant CDRs so that the Dual Stack Bearer support is available.
furnish-charging-information
Default: Disabled
This keyword controls
the inclusion of the optional field "pSFurnishChargingInformation" in
the eG-CDRs and PGW-CDRs.
Important: The Furnish Charging
Information (FCI) feature is applicable to all GTPP dictionaries compliant
to 3GPP Rel.7 and 3GPP Rel.8 except custom43 dictionary. This keyword
option will be available only if a valid license is installed. For
more information, contact your Cisco account representative.
PGW-CDR and eG-CDR will
contain FCI only if it is enabled at command level, i.e. using the gtpp attribute furnish-charging-information command
in GTPP Server Group Configuration mode.
Whenever FCI changes,
a new Free-Format-Data (FFD) value is either appended to existing FFD
or overwritten on the existing FDD depending on Append-Free-Format-Data
(AFFD) flag. CDR is not generated upon FCI change.
FCI is supported in main
CDR as well as in LOSDV. Whenever a trigger (volume, time, RAT,
etc.) happens current available FFD at command level is added to
the main body of the CDR. The same FFD at command level is added
to the main body of the next CDRs until it is not appended or overwritten
by next Credit-Control-Answer message at command level.
In the case of custom43
dictionary, the FCI implementation will be as follows:
- Whenever FCI changes
PGW-CDR will generate CDR i.e close old bucket and will have old
FCI details in the generated CDR.
- Translation for the PS-Free-Format-Data
in CDR will be conversion of hexadecimal values in ASCII format
(for numbers 0 to 9) to decimal values as integers.
- PS-Append-Free-Format-Data
always OVERWRITE.
imei
Default: Disabled
For SGSN: includes
the IMEI value in the S-CDR.
For GGSN: includes
the IMEISV value in the G-CDR.
imsi-unauthenticated-flag
Default: Enabled
This keyword controls
the inclusion of the optional field "IMSI Unauthenticated
Flag" in the x-CDRs.
When the served IMSI
is not authenticated, this field "IMSI Unauthenticated
Flag" if configured, will be present in the P-GW CDR record
for custom35 dictionary. This field is added per 3GPP TS 32.298
v10.7.
lapi
Default: Disabled
Includes the Low Access
Priority Indicator (LAPI) field in the CDRs. This field is required to
support MTC feature.
When UE indicates
low priority connection, then the "lowPriorityIndicator" attribute
will be included in the CDR.
local-record-sequence-number
Default: Disabled
This keyword provides
both the local record sequence number and the Node ID. In the x-CDRs,
this field indicates the number of CDRs generated by the node and
is unique within the session manager.
The Node ID field is
included in the x-CDR for any of several reasons, such as when PDP contexts
are released or if partial-CDR is generated based on configuration.
The field will consist of a AAA Manager identifier automatically
appended to the name of the SGSN or GGSN service.
The name of the SGSN
or GGSN service may be truncated, because the maximum length of the
Node ID field is 20 bytes. Since each AAA Manager generates CDRs
independently, this allows the Local Record Sequence Number and
Node ID fields to uniquely identify a CDR.
Important: If the gtpp
single-source centralized-lrsn is configured, the 'Node-ID' field
consists of only the specified NodeID-suffix. If NodeID-suffix is
not configured, GTPP group name is used. For default GTPP groups,
GTPP context-name is used. If the gtpp single-source centralized-lrsn is
not configured, then node-id format for CDRs generated by Sessmgr
is as follows: <1-byte Sessmgr restartvalue><3-byte Sessmgr instance
number> <node-id-suffix>. If the gtpp single-source
centralized-lrsn is not configured, then node-id format
for CDRs generated by ACSmgr is as follows: <1-byte ACSmgr restart-value>
<3-byte ACSmgr instance number> <Active charging service-name>.
losdv
Default: Enabled
This keyword controls
the inclusion of the optional field "List of Service Data" in
the x-CDRs.
ms-timezone
Default: Enabled
This keyword controls
the inclusion of the optional field "MS-Timezone" in
the x-CDRs.
msisdn
Default: Enabled
This keyword controls
the inclusion of the optional field "MSISDN" in
the x-CDRs.
node-id
Default: Enabled
This keyword controls
the inclusion of the optional field "Node ID" in
the x-CDRs.
node-id-suffix STRING
Default: Disabled
Specifies the configured
Node-ID-Suffix to use in the NodeID field of GTPP CDRs as an alphanumeric
string of 1 through 16 characters. Each Session Manager task generates
a unique NodeID string per GTPP context.
Important: The NodeID field is
a printable string of the ndddSTRING format: n: The first
digit is the Sessmgr restart counter having a value between 0 and
7. ddd:
The number of sessmgr instances. Uses the specified NodeID-suffix
in all CDRs. The "Node-ID" field consists of sessMgr
Recovery counter (1 digit) n + AAA
Manager identifier (3 digits) ddd + the configured
Node-Id-suffix (1 to 16 characters) STRING. If
the centralized LRSN feature is enabled, the "Node-ID" field
will consist of only the specified NodeID-suffix (NodeID-prefix
is not included). If this option is not configured, then GTPP group
name will be used instead (For default GTPP groups, context-name
will be used).
Important: If this node-id-suffix is
not configured, the GGSN uses the GTPP context name as the Node-id-suffix
(truncated to 16 characters) and the SGSN uses the GTPP group named
as the node-id-suffix.
pdn-connection-id
Default: Enabled
This keyword controls
the inclusion of the optional field "PDN Connection ID" in
the x-CDRs.
pdp-address
Default: Enabled
This keyword controls
the inclusion of the optional field "PDP Address" in
the x-CDRs.
pdp-type
Default: Enabled
This keyword controls
the inclusion of the optional field "PDP Type" in
the x-CDRs.
pgw-ipv6-addr
Default: Disabled
Specifying this option
allows to configure the P-GW IPv6 address.
Important: This attribute can
be controllably configured in custom24 and custom35 SGW-CDR dictionaries.
pgw-plmn-id
Default: Enabled
This keyword controls
the inclusion of the optional field "PGW PLMN-ID" in
the x-CDRs.
plmn-id [ unknown-use ]
Default: Enabled
For SGSN, reports the
SGSN PLMN Identifier value (the RAI) in the S-CDR provided if the dictionary
supports it.
For GGSN, reports the
SGSN PLMN Identifier value (the RAI) in the G-CDR if it was originally
provided by the SGSN in the GTP create PDP context request. It is
omitted if the SGSN does not supply one.
Normally when SGSN
PLMN-id information is not available, the attribute sgsnPLMNIdentifier
is not included in the CDR. This keyword enables the inclusion of
the sgsnPLMNIdentifier with a specific value when the SGSN PLMN-id
is not available.
unknown-use hex_num:
is aa hexadecimal number from 0x0 through 0xFFFFFF that identifies
a foreign SGSN that has not provided a PLMN-id. For GGSN only.
qos max-length
Default: Disabled
Specifying
this option will change the parameters related to QoS sent in S-CDR
and SaMOG CDR. The max-length option
is used to modify the length of QoS sent in CDR. The qos_value must
be an integer from 4 through 24.
This feature is introduced
to support Rel.7+ QoS formats.
rat
Default: Enabled
For
SGSN: includes the RAT (identifies the radio access technology type)
value in the S-CDR.
For GGSN: includes
the RAT (identifies the radio access technology type) value in the
G-CDR.
recordextension
Default: Disabled
This keyword controls
the inclusion of the optional field "RecordExtension" in
the x-CDRs.
record-extensions
rat
Default: Disabled
Enables network operators
and/or manufacturers to add their own recommended extensions to
the CDRs according to the standard record definitions from 3GPP
TS 32.298 Release 7 or higher.
record-type { sgsnpdprecord | sgwrecord }
Important: This keyword is available
only when the SaMOG Mixed Mode license (supporting both 3G and 4G)
is configured.
Default: sgwrecord
Specifies the SaMOG
CDR type to use.
For an SaMOG 3G license,
this keyword will not be available. However, sgsnpdprecord type
will be used as the default record type.
served-mnai
Default: Disabled
This keyword controls
the inclusion of the optional field "Served MNAI" in
the x-CDRs.
served-pdp-pdn-address-extension
Default: Disabled
In support of IPv4v6
dual-stack PDP address types, this keyword causes the service to include
IPv4v6 address information in the CDR. The IPv4 address goes in
the Served PDP PDN Address Extension field and the IPv6 address
goes in the Served PDP Address or Served PDP PDN Address field.
Important: This attribute will not
be displayed if the GTPP dictionary is set to custom34.
 Note |
For SGSN, on enabling served-pdp-pdn-address-extension all
custom S-CDR dictionaries will support the CDR field "Served PDP/ PDN
Address extension" except for the following dictionaries:
- custom17
- custom18
- custom23
- custom42
- custom41
|
served-pdp-pdn-address-prefix-length
Default: Enabled
In support of IPv6
prefix delegation, this keyword causes the service to include this
field "Served PDP PDN Address" in the x-CDRs.
If this field is configured,
the servedPDPPDNAddress field will support reporting the IPv6 prefix
length as outlined in 3GPP 32.298. The prefix length will only be
reported if:
- it is configured
- it is not the default
length of 64
- it is an IPv6 or IPv4v6
call
sgsn-change
Default: Enabled
This keyword is specific
to SGSN and is license restricted.
This keyword controls
the inclusion of the S-CDR attribute "SGSN Change" in
the S-CDRs. It is enabled by default and the attribute "SGSN
Change" is included in the S-CDRs by default.
 Note |
For SGSN specific custom33
dictionary, it is recommended to disable this keyword before an
upgrade to prevent billing issues.
|
sgw-ipv6-addr
Default: Disabled
Specifying
this option allows to configure the S-GW IPv6 address.
Important: This attribute can
be controllably configured in custom24 and custom35 SGW-CDR dictionaries.
sms { destination-number | recording-entity | service-centre }
This keyword is specific
to the SGSN.
Entering this keyword
causes the inclusion of an SMS-related field in the SMS-MO-CDR or SMS-MT-CDR.
destination-number:
Includes the "destinationNumber" field in the
SMS-MO-CDR or SMS-MT-CDR.
recording-entity:
Includes the "recordingEntity" field in the SMS-MO-CDR
or SMS-MT-CDR.
service-centre:
Includes the "serviceCentre" field in the SMS-MO-CDR
or SMS-MT-CDR.
sna-ipv6-addr
Default: Disabled
Specifying
this option allows to configure the Serving Node IPv6 Address (SNAv6).
Important: This attribute can
be controllably configured in custom24 and custom35 SGW-CDR dictionaries.
sponsor-id
Default: Disabled
Includes the Sponsor
ID and Application-Service-Provider-Identity fields in PGW-CDR.
Note that the "Sponsor
ID" and "Application-Service-Provider-Identity" attributes
will be included in PGW-CDR if the PCEF supports Sponsored Data
Connectivity feature or the required reporting level is sponsored
connectivity level as described in 3GPP TS 29.212.
This feature is implemented
to be in compliance with Release 11 3GPP specification for CDRs.
So, this behavior is applicable to all GTPP dictionaries that are
Release 11 compliant, i.e. custom35.
start-time
Default: Enabled
This keyword controls
the inclusion of the optional field "Start-Time" in
the x-CDRs.
stop-time
Default: Enabled
This keyword controls
the inclusion of the optional field "Stop-Time" in
the x-CDRs.
twanuli
Default: Disabled
This keyword controls
the inclusion of the optional field "TWAN User Location Information" in
the CDRs.
uli
Default: Enabled
This keyword controls
the inclusion of the optional field "User Location Information" in
the x-CDRs.
user-csg-information
Default: Disabled
This keyword controls
the inclusion of the optional field "User CSG Information" in
the x-CDRs.
Important: Currently, UCI values
are only supported for SGW-CDRs.
This attribute will not
be displayed if the GTPP dictionary is set to custom11, custom34,
or custom35.
+
Indicates that this
command can be entered multiple times to configure multiple attributes.
Usage Guidelines
This command dictates
some of the optional information fields that should be reported
in CDRs generated by the GGSN. In addition, it controls how the
information for some of the mandatory fields are reported.
Fields described as
optional by the standards but not listed above will always be present
in the CDRs, except for Record Extensions (which will never be present).
Examples
The
following command disables the inclusion of the field "SGSN
Change" in the S-CDR:no gtpp attribute sgsn-change
Examples
The following command
dictates that the time provided in the Duration field of the CDR
is reported in milliseconds:gtpp attribute duration-ms