Context Configuration Mode Commands E-H

This section includes the commands edr-module active-charging-service through hss-peer-service.


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

IMPORTANT:

The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).

eap-profile

Creates a new, or specifies an existing, Extensible Authentication Protocol (EAP) profile and enters the EAP Configuration Mode.

Product:

ASN-GW

ePDG

PDIF


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
[ no ] eap-profile name
name

Specifies the name of a new or existing EAP profile as an alphanumeric string of 1 through 256 characters.


Usage:

Use this command to create a new or enter an existing EAP profile.

Entering this command results in the following prompt:

[context_name]hostname(config-ctx-eap-profile)#

EAP Configuration Mode commands are defined in the EAP Configuration Mode Commands chapter.


Example:
The following command configures an EAP profile called eap1 and enters the EAP Configuration Mode:
eap-profile eap1
edr-module active-charging-service

Enables the creation, configuration, or deletion of the Event Data Record (EDR) module for this context. In releases prior to 15.0, the SGSN re-used the existing ‘EDR” module for generating event logs which is primarily used for charging records. But from release 15.0 onwards, the session-event module is used by SGSN for event logging. For more information see the session-event-module command.

Product:

ACS

GGSN

HA

LNS

PDSN

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
[ no ] edr-module
active-charging-service [ charging | reporting ]
no

Removes the EDR module configuration for the current context.

charging

Enables the EDR module for charging EDRs that are stored in the /records/edr directory.

reporting

Enables the EDR module for reporting EDRs that are stored in the /records/redr directory.


Usage:

Use this command to create the EDR module for the context, and configure the EDR module for active charging service records. You must be in a non-local context when specifying this command, and you must use the same context when specifying the UDR module command.

If this CLI command is configured without the charging or reporting keywords, by default the EDR module is enabled for charging EDRs.

On entering the command with the chargingkeyword or without any keywords, the CLI prompt changes to:

[context_name]hostname(config-edr)#

On entering the command with the reportingkeyword, the CLI prompt changes to:

[context_name]hostname(config-redr)#


Example:
The following command creates the EDR module for the context for charging EDRs, and enters the EDR Module Configuration Mode:
edr-module active-charging-service
egtp-service

Creates an eGTP service or specifies an existing eGTP service and enters the eGTP Service Configuration Mode for the current context. On an S4-SGSN, creating and configuring the eGTP service is required for the S4-SGSN to communicate with the S-GW via the S4 interface.

Product:

MME

P-GW

SAEGW

SGSN

S-GW

IMPORTANT:

Currently the SGSN is not supported on the ASR 5500 platform.


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
[ no ] egtp-service service_name [ -noconfirm ]
egtp-service service_name

Specifies the name of the eGTP service as an alphanumeric string of 1 through 63 characters. If service_name does not refer to an existing service, the new service is created if resources allow.

IMPORTANT:

Service names must be unique across all contexts within a chassis.

-noconfirm

Executes the command without any additional prompt and confirmation from the user.

no egtp-service service_name

Removes the specified eGTP service from the context.


Usage:

Enter the eGTP Service Configuration Mode for an existing service or for a newly defined service. This command is also used to remove an existing service.

A maximum of 256 services (regardless of type) can be configured per system.

CAUTION:

Large numbers of services greatly increase the complexity of management and may impact overall system performance (for example, resulting from such things as system handoffs). Therefore, it is recommended that a large number of services only be configured if your application absolutely requires it. Please contact your local service representative for more information.

Entering this command results in the following prompt:

[context_name]hostname(config-egtp-service)#

eGTP Service Configuration Mode commands are defined in the eGTP Service Configuration Mode Commands chapter.

Use this command when configuring the following GTP SAE components: MME, P-GW, and S-GW. Also use this command when configuring an S4-SGSN. Once the eGTP service has been created on the S4-SGSN, the eGTP service must be configured using the gtpc, validation-mode and interface-type commands in eGTP Service Configuration Mode. Once the service is created and configured, it then must be associated with the 2G and/or 3G services configured on the S4-SGSN using theassociate command in Call Control Profile Configuration Mode.


Example:
The following command enters the existing eGTP Service Configuration Mode (or creates it if it does not already exist) for the service named egtp-service1:
egtp-service egtp-service1
The following command will remove egtp-service1 from the system:
no egtp-service egtp-service1
end

Exits the current configuration mode and returns to the Exec mode.

Product:

All


Privilege:

Security Administrator, Administrator


Syntax
end

Usage:

Use this command to return to the Exec mode.

epdg-service

Creates Evolved Packet Data GateWay service and enters EPDG service configuration mode.

Product:

ACS

ePDG

GGSN

HA

LNS

PDSN

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
[ no ] epdg-service name [ -noconfirm ]
no

Indicates the evolved packet data gateway service specified is to be removed.

name

Specifies the name of the ePDG service to configure as an alphanumeric string of 1 through 63 characters. If name does not refer to an existing service, the new service is created if resources allow.

IMPORTANT:

Service names must be unique across all contexts within a chassis.

-noconfirm

Executes the command without any additional prompt and confirmation from the user.


Usage:

Enter the ePDG Service Configuration Mode for an existing service or for a newly defined service. This command is also used to remove an existing service.


Example:
The following command will enter the ePDG Service Configuration Mode creating the service sampleService, if necessary.
epdg-service sampleService
The following command will remove sampleService as being a defined ePDG service.
no epdg-service sampleService
event-notif-endpoint

Enables creation, configuration or deletion of an Event Notification collection server endpoint.

Product:

IPCF


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
[ no ] event-notif-endpoint en_node_name
no

Removes the specified Event Notification collection server endpoint.

en_node_name

Specifies name of the Event Notification collection server endpoint as an alphanumeric string of 1 through 31 characters.

If the named endpoint does not exist, it is created, and the CLI mode changes to the Event Notification Interface Endpoint Configuration Mode wherein the endpoint can be configured.

If the named endpoint already exists, the CLI mode changes to the Event Notification Interface Endpoint Configuration Mode wherein the endpoint can be reconfigured.


Usage:

Use this command to create/configure/delete an Event Notification collection server endpoint.

Only 1 Event Notification interface across a chassis can be configured on a system.

Entering this command results in the following prompt:

[context_name]hostname(config-ntfyintf-endpoint)#

The commands configured in this mode are defined in the Event Notification Interface Endpoint Configuration Mode Commands chapter of Command Line Interface Reference.

CAUTION:

This is a critical configuration. The PCC Event notification can not be collected on a server without this configuration. Any change to this configuration would lead to the loss of event notifications from PCC service on IPCF node.


Example:
The following command creates an Event Notification Interface Endpoint named event_intfc_3:
event-notif-endpoint
event_intfc_3 
exit

Exits the current mode and returns to the parent configuration mode.

Product:

All


Privilege:

Security Administrator, Administrator


Syntax
exit

Usage:

Use this command to return to the parent configuration mode.

external-inline-server

This is a restricted command.

fa-service

Creates or deletes a foreign agent (FA) service or specifies an existing FA service for which to enter the FA Service Configuration Mode for the current context.

Product:

ASN-GW

PDSN

FA


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
[ no ] fa-service name [ -noconfirm ]
no

Indicates the foreign agent service specified is to be removed.

name

Specifies the name of the FA service to configure as an alphanumeric string of 1 through 63 characters. If name does not refer to an existing service, the new service is created if resources allow.

IMPORTANT:

Service names must be unique across all contexts within a chassis.

-noconfirm

Executes the command without any additional prompt and confirmation from the user.


Usage:

Enter the FA Service Configuration Mode for an existing service or for a newly defined service. This command is also used to remove an existing service.

A maximum of 256 services (regardless of type) can be configured per system.

CAUTION:

Large numbers of services greatly increase the complexity of management and may impact overall system performance (i.e. resulting from such things as system handoffs). Therefore, it is recommended that a large number of services only be configured if your application absolutely requires it. Please contact your local service representative for more information.


Example:
The following command will enter the FA Service Configuration Mode creating the service sampleService, if necessary.
fa-service sampleService
The following command will remove sampleService as being a defined FA service.
no fa-service sampleService
firewall max-associations

This command is obsolete.

fng-service

Creates a new, or specifies an existing FNG service and enters the FNG Service Configuration Mode. A maximum of 16 FNG services can be created. This limit applies per ASR 5000 chassis and per context.

Product:

FNG


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
fng-service name [ -noconfirm ]no fng-service name
fng-service name

Specifies the name of a new or existing FNG service as an alphanumeric string of 1 through 63 characters that must be unique across all FNG services within the same context and across all contexts.

IMPORTANT:

Service names must be unique across all contexts within a chassis.

no fng-service name

Deletes the specified FNG service.


Usage:

Use this command in Context Configuration Mode to create a new FNG service or modify an existing one. Executing this command enters the FNG Service Configuration Mode.


Example:
The following command configures an FNG service named fng1 and enters the FNG Service Configuration Mode:
fng-service fmg1
ggsn-service

Creates or deletes a Gateway GPRS Support Node (GGSN) service and enters the GGSN Service Configuration Mode within the current context to configure it.

Product:

GGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
ggsn-service svc_name [ -noconfirm ]no ggsn-service svc_name
no

Deletes a preciously configured GGSN service.

svc_name

Specifies the name of the GGSN service to create/configure as an alphanumeric string of 1 through 63 characters that is case sensitive.

IMPORTANT:

Service names must be unique across all contexts within a chassis.

-noconfirm

Executes the command without any additional prompt and confirmation from the user.


Usage:

Services are configured within a context and enable certain functionality. This command creates and allows the configuration of services enabling the system to function as a GGSN in a GPRS or UMTS network. This command is also used to remove previously configured GGSN services.

A maximum of 256 services (regardless of type) can be configured per system.

CAUTION:

Large numbers of services greatly increase the complexity of management and may impact overall system performance (i.e. resulting from such things as system handoffs). Therefore, it is recommended that a large number of services only be configured if your application absolutely requires it. Please contact your local service representative for more information.


Example:
The following command creates a GGSN service named ggsn1:
ggsn-service ggsn1
gprs-service

Creates a GPRS service instance and enters the GPRS Service Configuration Mode. This mode configures all of the parameters specific to the operation of an SGSN in a GPRS network.

IMPORTANT:

For details about the commands and parameters for this mode, check the GPRS Service Configuration Mode chapter.

Product:

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gprs-service srvc_name [ -noconfirm ]no gprs-service srvc_name
no

Removes the configuration for the specified IGPRS service from the configuration for the current context.

srvc_name

Specifies the name of the GPRS service as a unique alphanumeric string of 1 through 63 characters.

IMPORTANT:

Service names must be unique across all contexts within a chassis.

-noconfirm

Executes the command without any additional prompt and confirmation from the user.


Usage:

Use this command to create or remove a GPRS service. Entering this command will move the system to the GPRS Service Configuration Mode and change the prompt to:

[context_name]hostname(config-gprs-service)#

Example:
The following command creates an GPRS service named gprs1:
gprs-service gprs1
The following command removes the GPRS service named gprs1:
no gprs-service gprs1
gs-service

Creates a Gs service instance and enters the Gs Service Configuration Mode. This mode configures the parameters specific to the Gs interface between the SGSN and the MSC/VLR.

Product:

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gs-service svc_name [ -noconfirm ]no gs-service svc_name
no

Remove the configured Gs service from the current context.

svc_name

Specifies the Gs service as a unique alphanumeric string of 1 through 63 characters.

IMPORTANT:

Service names must be unique across all contexts within a chassis.

-noconfirm

Executes the command without any additional prompt and confirmation from the user.


Usage:

Use this command to create, edit, or remove a Gs service.

A maximum of 32 Gs service can be configured in one context/system. This limit is subject to maximum of 256 services (regardless of type) can be configured per system.

IMPORTANT:

For details about the commands and parameters for this mode, refer Gs Service Configuration Mode chapter.


Example:
The following command creates an Gs service named gs1:
gs-service gs1
The following command removes the Gs service named gs1:
no gs-service gs1

gtpc overload-protection egress

Configures the over-load protection of GGSN/PGW by throttling outgoing GTPv1 and GTPv2 control messages over Gn/Gp(GTPv1) or S5/S8 (GTPv2) interface using rate-limiting-function (RLF) template for services configured in a context.

Product:

GGSN

P-GW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpc overload-protection
egress [ rlf-template rlf_template_name | throttling-override-policy throttling_override_policy_name[no] gtpc
overload-protection egress
no

Disables the GTP Outgoing Control Message Throttling for GGSN/PGW services in this context.

rlf-template rlf_template_name

It associates the preconfigured Rate-Limiting-Function (RLF) template rlf_template_name in Global Configuration mode for throttling the GTP outgoing control messages for the GGSN/PGW services in this context. This is a mandatory parameter to enable throttling.

throttling-override-policythrottling_override_policy_name

INSERT TEXT HERE.


Usage:

Use this command to enable the GTP Outgoing Control Message Throttling for GGSN/PGW services configured in the same context. The RLF template associated with this command controls the throttling parameters.


Example:
The following command enables the outgoing GTP control messages in a context using rlf-template gtpc_1:
gtpc overload-protection
egress rlf-template gtpc_1

gtpc overload-protection ingress

Configures the over-load protection of GGSN/PGW by throttling incoming GTPv1 and GTPv2 control messages over Gn/Gp(GTPv1) or S5/S8 (GTPv2) interface with other parameters for services configured in a context.

Product:

GGSN

P-GW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpc overload-protection
ingress {msg-rate msg_rate} [delay-tolerance dur] [queue-size size][no] gtpc
overload-protection ingress
no

Disables the GTP incoming control message throttling for GGSN/PGW services in this context.

msg-rate msg_rate

Defines the number of GTP incoming messages that can be processed per second.

msg_rate is an integer between 100 through 12000.

delay-tolerance dur

Defines the maximum number of seconds a incoming GTP message can be queued before it is processed. After exceeding this, the message is dropped.

dur is an integer between 1 through 10.

queue-size size

Defines the maximum size of the queue to be maintained for incoming GTPC messages. If the queue exceeds the defined size size, any new incoming messages will be dropped.

size is an integer between 100 through 10000.


Usage:

Use this command to enable the GTP incoming control message throttling for GGSN/PGW services configured in the same context.


Example:
The following command enables the incoming GTP control messages in a context using message rate 1000 per second with message queue size 10000and delay of 1 second:
gtpc overload-protection
ingress msg-rate 1000 delay-tolerance 1 queue-size 10000
gtpp algorithm

Configures GTPP routing algorithms for the current context. This command is deprecated but available for backward compatibility.

Product:

GGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp algorithm { first-server | round-robin | first-n count }
first-server

Specifies that accounting data is sent to the first available charging gateway function (CGF) based upon the relative priority of each configured CGF. Default: Enabled

round-robin

Specifies that accounting data is transmitted in a circular queue fashion such that data is sent to the highest priority CGF first, then to the next available CGF of the highest priority, and so on. Ultimately, the queue returns to the CGF with the highest configured priority. Default: Disabled

first-n count

Specifies that the AGW must send accounting data to count (more than one) CGFs based on their priority. Response from any one of the count CGFs would suffice to proceed with the call. The full set of accounting data is sent to each of the count CGFs.

count is the number of CGFs to which accounting data will be sent, and must be an integer from 2 through 65535. Default: 1 (Disabled)


Usage:

Use this command to control how G-CDR/P-CDR accounting data is routed among the configured CGFs.


Example:
The following command configures the system to use the round-robin algorithm when transmitting G-CDR/P-CDR accounting data:
gtpp algorithm round-robin
gtpp attribute

Allows the specification of the optional attributes to be present in the Call Detail Records (CDRs) that the GPRS/PDN/UMTS access gateway generates. It also defines that how the information is presented in CDRs by encoding the attribute field values.

Product:

GGSN

SGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
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 | duration-ms | dynamic-flag | dynamic-flag-extension | furnish-charging-information | imei | imsi-unauthenticated-flag | local-record-sequence-number | losdv | ms-timezone | msisdn | node-id | node-id-suffix STRING | pdn-connection-id | pdp-address | pdp-type | pgw-plmn-id | plmn-id | rat | recordextension | record-extensions rat | served-mnai | served-pdp-pdn-address-extension | served-pdp-pdn-address-prefix-length | sgsn-change |  sms { destination-number | recording-entity | service-centre } | start-time | stop-time | 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 | duration-ms | dynamic-flag | dynamic-flag-extension | furnish-charging-information | imei | imsi-unauthenticated-flag | local-record-sequence-number | losdv | ms-timezone | msisdn | node-id | pdn-connection-id | pdp-address | pdp-type | pgw-plmn-id | plmn-id | rat | recordextension | record-extensions rat | served-mnai | served-pdp-pdn-address-extension | served-pdp-pdn-address-prefix-length | sgsn-change |  sms { destination-number | recording-entity | service-centre } | start-time | stop-time | 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 | duration-ms | dynamic-flag | dynamic-flag-extension | furnish-charging-information | imei | imsi-unauthenticated-flag | local-record-sequence-number | losdv | ms-timezone | msisdn | node-id | pdn-connection-id | pdp-address | pdp-type | pgw-plmn-id | plmn-id | rat | recordextension | record-extensions rat | served-mnai | served-pdp-pdn-address-extension | served-pdp-pdn-address-prefix-length | sgsn-change |served-mnai |  sms { destination-number | recording-entity | service-centre }| start-time | stop-time | uli  | user-csg-information }
default

Sets the default GTPP attributes in the generated CDRs. It also sets the default presentation of attribute values in generated CDRs.

no

Removes the configured GTPP attributes from the 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

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.
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.

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 this keyword is enabled and the gtpp centralized-lrsn-creation option is enabled with the gtpp single-source centralized-lrsn command, then the Node ID format changes as follows: <1-byte-AAAproxy-restart-counter> <3-byte AAAproxy instance number> <node-id-suffix>. If gtpp centralized-lrsn-creation is not enabled, the node-id format for CDRs generated by Sessmgr is as follows: <1-byte Sessmgr restart-value> <3-byte Sessmgr instance number> <node-id-suffix>. If gtpp centralized-lrsn-creation is not enabled, the 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-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.

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.

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.

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.

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.

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:

Use this command to configure the type of optional information fields to include in generated CDRs (M-CDRs, S-CDRs, S-SMO-CDR, S-SMT-CDR from SGSN and G-CDRs, eG-CDRs from GGSN) by the AGW (SGSN/GGSN/P-GW/SAEGW). 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).

IMPORTANT:

This command can be repeated multiple times with different keywords to configure multiple GTPP attributes.


Example:
The following command configures the system to present the time provided in the Duration field of the CDR is reported in milliseconds:
gtpp attribute duration-ms
gtpp charging-agent

Configures the IP address and port of the system interface within the current context used to communicate with the Charging Gateway Function (CGF).

Product:

GGSN

SGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp charging-agent
address ip_address [ port port ]no gtpp charging-agent
no

Removes a previously configured charging agent address.

address ip_address

Specifies the IP address of the interface configured within the current context that is used to transmit CDR records (G-CDR/eG-CDR/M-CDR/S-CDR) to the CGF. ip_address must be entered using IPV4 dotted-decimal notation.

port port

Specifies the Charging Agent UDP port. as an integer from 1 through 65535.

If port is not defined, IP will take the default port number 49999.

IMPORTANT:

Configuring gtpp charging-agent on port 3386 may interfere with a ggsn-service configured with the same ip address.


Usage:

This command establishes a Ga interface for the system. For GTPP accounting, one or more Ga interfaces must be specified for communication with the CGF. These interfaces must exist in the same context in which GTPP functionality is configured (refer to the gtpp commands in this chapter).

This command instructs the system as to what interface to use. The IP address supplied is also the address by which the GSN is known to the CGF. Therefore, the IP address used for the Ga interface could be identical to one bound to a GSN service (a Gn interface).

If no GSN service is configured in the same context as the Ga interface, the address configured by this command is used to receive unsolicited GTPP packets.


Example:
The following command configures the system to use the interface with an IP address of 192.168.13.10 as the accounting interface with port 20000 to the CGF:
gtpp charging-agent
address 192.168.13.10 port 20000
gtpp data-request sequence-numbers

Configures the range of sequence numbers to be used in the GTPP data record transfer record (DRT). Use this command to set the start value for the sequence number.

Product:

GGSN

SGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp data-request sequence-numbers
start { 0 | 1 }default gtpp data-request
sequence-numbers start
default

Default is 0 (zero).

{ 0 | 1 }

Specifies the value of the start sequence number for the GTPP Data Record Transfer Request. Default: 0

  • 0: Designates the start sequence number as 0.
  • 1: Designates the start sequence number as 1.

Usage:

When the GGSN/P-GW (SAEGW)/SGSN is configured to send GTPP echo request packets, the SGSN always uses 0 as the sequence number in those packets. Re-using 0 as a sequence number in the DRT packets is allowed by the 3GPP standards; however, this CLI command ensures the possibility of inter-operating with CGFs that can not properly handle the re-use of sequence number0 in the echo request packets.


Example:
The following command sets the sequence to start at 1.
gtpp data-request sequence-numbers
start 1
gtpp dead-server suppress-cdrs

Enables or disables CDR archiving when a dead server is detected.

IMPORTANT:

This command is customer specific. For more information please contact your local Cisco service representative.

Product:

GGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
[ default | no ] gtpp
dead-server suppress-cdrs
default

Configures the default setting.

Default: Disabled

no

Re-enables CDR archiving.


Usage:

Use this command to enable/disable CDR archiving when a dead server is detected.With this CLI, once a server is detected as down, requests are purged.Also the requests generated for the period when the server is down are purged.

gtpp deadtime

Configures the amount of time to wait before attempting to communicate with a Charging Gateway Function (CGF) that was previously marked as unreachable.

Product:

GGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp deadtime timedefault gtpp deadtime
default

Configures this command with the default setting.

Default: 120 seconds

time

Specifies the amount of time (in seconds) that must elapse before the system attempts to communicate with a CGF that was previously unreachable. time is an integer from 1 through 65535.


Usage:

If the system is unable to communicate with a configured CGF, after a pre-configured number of failures the system marks the CGF as being down.

This command specifies the amount of time that the system waits prior to attempting to communicate with the downed CGF.

Refer to the gtpp detect-dead-server and gtpp max-retries commands for additional information on the process the system uses to mark a CGF as down.


Example:
The following command configures the system to wait 60 seconds before attempting to re-communicate with a CGF that was marked as down:
gtpp deadtime 60
gtpp detect-dead-server

Configures the number of consecutive communication failures that could occur before the system marks a Charging Gateway Function (CGF) as down.

Product:

GGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp detect-dead-server
consecutive-failures max_numberdefault gtpp detect-dead-server
consecutive-failures
default

Configures this command with the default setting.

Default: 0

consecutive-failures max_number

Specifies the number of failures that could occur before marking a CGF as down. max_number is an integer from 0 through 1000.


Usage:

This command works in conjunction with the gtpp max-retries parameter to set a limit to the number of communication failures that can occur with a configured CGF.

The gtpp max-retries parameter limits the number of attempts to communicate with a CGF. Once that limit is reached, the system treats it as a single failure. The gtpp detect-dead-server parameter limits the number of consecutive failures that can occur before the system marks the CGF as down and communicate with the CGF of next highest priority.

If all of the configured CGFs are down, the system ignores the detect-dead-server configuration and attempt to communicate with highest priority CGF again.

If the system receives a GTPP Node Alive Request, Echo Request, or Echo Response message from a CGF that was previously marked as down, the system immediately treats it as being active.

Refer to the gtpp max-retries command for additional information.


Example:
The following command configures the system to allow 8 consecutive communication failures with a CGF before it marks it as down:
gtpp detect-dead-server
consecutive-failures 8
gtpp dictionary

Designates a dictionary used by GTPP for a specific context.

Product:

GGSN

SGSN

PDG/TTG

P-GW

SAEGW

S-GW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp dictionary { custom1 | custom10 | custom11 | custom12 | custom13 | custom14 | custom15 | custom16 | custom17 | custom18 | custom19 | custom2 | custom20 | custom21 | custom22 | custom23 | custom24 | custom25 | custom26 | custom27 | custom28 | custom29 | custom3 | custom30 | custom31 | custom32 | custom33 | custom34 | custom35 | custom36 | custom37 | custom38 | custom39 | custom4 | custom40 | custom41 | custom42 | custom43 | custom44 | custom45 | custom46 | custom47 | custom48 | custom49 | custom5 | custom50 | custom51 | custom52 | custom53 | custom54 | custom55 | custom56 | custom57 | custom58 | custom59 | custom6 |  custom60 | custom7 | custom8 | custom9 | standard }default gtpp dictionary
default

Configures the default dictionary.

custom1

This is a custom-defined dictionary that conforms to TS 32.015 v 3.6.0 for R99. It supports the encoding of IP addresses in text format for G-CDRs.

custom2

Custom-defined dictionary.

custom3

This is a custom-defined dictionary that conforms to TS 32.015 v 3.6.0 for R99 except that it supports the encoding of IP addresses in binary format for G-CDRs.

custom4

This is a custom-defined dictionary that conforms to TS 32.015 v 3.6.0 for R99 except that:

  • IP addresses are encoded in binary format.
  • The Data Record Format Version information element contains 0x1307 instead of 0x1308.
  • QoS Requested is not present in the LoTV containers.
  • QoS negotiated is added only for the first container and the container after a QoS change.
custom5

Custom-defined dictionary.

custom6

This is a custom-defined dictionary for eG-CDR encoding.

custom7 ... custom30

These custom-defined dictionary have default behavior or “standard” dictionary.

custom31

This is a custom-defined dictionary for S-CDR encoding that is based on 3GPP TS 32.298 v6.4.1 with a special field appended for the PLMN-ID.

custom33
This ia a custom-defined dictionary for S-CDR encoding that is based on the 3GPP TS 32.298v6.4.1 with the following exceptions:
  • Proprietary PLMN-ID field is present.
  • It is a SEQUENCE and not a SET.
  • Diagnostics and SGSN-Change fields are not supported.
  • Indefinite length encoding is used.
  • Booleans are encoded as 0x01(3GPP it is 0xff).
  • IMEISV shall be sent if available else IMEI should be sent.
  • Record Sequence Number is Mandatory.
  • APN OI and NI part is length encoded.
  • Cause for Record closure should be “RAT Change” instead of “intra-SGSNinter-system”.
standard

Default: Enabled

This dictionary conforms to TS 32.215 v 4.6.0 for R4 (and also R5 - extended QoS format).


Usage:

Use this command to designate specific dictionary used by GTPP for specific context.

IMPORTANT:

Note that the following warning message will be displayed whenever an existing GTPP dictionary is being changed or a new GTPP dictionary is configured irrespective of whether or not the calls are active on the system.

Warning: It is not recommended to change the dictionary when the system has active calls.

Are you sure? [Yes|No]: n

IMPORTANT:

This change will require user's input on the CLI console for GTPP dictionary configuration / change.


Example:
The following command configures the system to use custom3 dictionary to encode IP address in Binary format in G-CDRs:
gtpp dictionary custom3
gtpp duplicate-hold-time

Configures the number of minutes to hold on to CDRs that are possibly duplicates while waiting for the primary Charging Gateway Function (CGF) to come back up.

Product:

GGSN

SGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp duplicate-hold-time minutesdefault gtpp duplicate-hold-time
default

Configures this command with the default setting.

Default: 60 minutes

minutes

Specifies the number of minutes to hold on to CDRs that may be duplicates whenever the primary CGF is down, minutes must be an integer from 1 through 10080.


Usage:

Use this command to configure how long to hold on to CDRs that are possibly duplicates while waiting for the primary CGF to come back up. If the GGSN/P-GW (SAEGW) determines that the primary CGF is down, CDRs that were sent to the primary CGF but not acknowledged are sent by the GSN to the secondary CGF as “possibly duplicates”. When the primary CGF comes back up, the GSN uses GTPP to determine whether the possibly duplicate CDRs were received by the primary CGF. Then the secondary CGF is told whether to release or cancel those CDRs. This command configures how long the system should wait for the primary CGF to come back up. As soon as the configured time expires, the secondary CGF is told to release all of the possibly duplicate CDRs.


Example:
Use the following command to set the amount of time to hold on to CDRs to 2 hours (120 minutes);
gtpp duplicate-hold-time 120
gtpp echo-interval

Configures the frequency at which the system sends GTPP echo packets to configured CGFs.

Product:

GGSN

SGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp echo-interval time{ default | no } gtpp
echo-interval
default

Configures the default setting for this command,

Default: 60 seconds

no

Disables the use of the echo protocol except for the scenarios described in the Usage section for this command.

time

Specifies the time interval (in seconds) for sending GTPP echo packets as an integer from 60 through 2147483647. Default: 60


Usage:

The GTPP echo protocol is used by the system to ensure that it can communicate with configured CGFs. The system initiates this protocol for each of the following scenarios:

  • Upon system boot
  • Upon the configuration of a new CGF server on the system using the gtpp server command as described in this chapter
  • Upon the execution of the gtpp test accounting command as described in the Exec Mode Commands chapter of this reference
  • Upon the execution of the gtpp sequence-numbers private-extensions command as described in this chapter

The echo-interval command is used in conjunction with the gtpp max-retries and gtpp timeout commands as described in this chapter.

In addition to receiving an echo response for this echo protocol, if we receive a GTPP Node Alive Request message or a GTPP Echo Request message from a presumed dead CGF server, we will immediately assume the server is active again.

The alive/dead status of the CGFs is used by the AAA Managers to affect the sending of CDRs to the CGFs. If all CGFs are dead, the AAA Managers will still send CDRs, (refer to the gtpp deadtime command), albeit at a slower rate than if a CGF were alive. Also, AAA Managers independently determine if CGFs are alive/dead.


Example:
The following command configures an echo interval of 120 seconds:
gtpp echo-interval 120
gtpp egcdr

Configures the eG-CDR and P-CDR (P-GW CDR) parameters and triggers.

Product:

GGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp egcdr { closure-reason admin-disconnect [ management-intervention | normal-release ] | final-record [ [ include-content-ids { all | only-with-traffic } ] [ closing-cause { same-in-all-partials | unique } ] ] | losdv-max-containers max_losdv_containers | lotdv-max-containers max_lotdv_containers | rulebase-max-length rulebase_name_max_length | service-data-flow
threshold { interval interval | volume { downlink bytes [ uplink bytes ] | total bytes | uplink bytes [ downlink bytes ] } } | service-idle-timeout { 0 | service_idle_timeout } }default gtpp egcdr { closure-reason admin-disconnect | final-record include-content-ids
only-with-traffic closing-cause same-in-all-partials | losdv-max-containers | lotdv-max-containers | service-idle-timeout
0 }no gtpp egcdr { rulebase-max-length | service-data-flow threshold { interval | volume { downlink [ uplink ] | total | uplink [ downlink ] } } }
closure-reason admin-disconnect [ management-intervention | normal-release ]

Controls the configuration of “causeForRecordClosing” in PGW-CDR when a call is cleared from the chassis.

Releases prior to 14.1, when a call is cleared from the chassis the field “causeForRecordClosing” in a PGW-CDR shows “Normal Release”. In 15.0 and later releases, the behavior has changed to comply with the 3GPP specifications. That is, the default “causeForRecordClosing” in PGW-CDR will be “Management Intervention”.

IMPORTANT:

This behavioral change is limited to PGW-CDR Release 8 dictionaries only.

closing-reason: Configures the record closing reason for PGW-CDR.

  • management-intervention: Specifies to send Management-Intervention as causeForRecordClosing in PGW-CDRs. By default, Management-Intervention will be sent as the record closure reason for PGW-CDRs.
  • normal-release: Specifies to send Normal Release as causeForRecordClosing in PGW-CDRs.
final-record [ [ include-content-ids { all | only-with-traffic } ] [ closing-cause { same-in-all-partials | unique } ] ]

Enables configuration of the final eG-CDR/P-CDR.

Default: Restores the GTPP eG-CDR/P-CDR final record to the default setting to include content IDs with some data to report are included. Also, sets the closing cause to the default of using the same closing cause for multiple final eG-CDR/P-CDRs.

  • include-content-ids: Controls which content IDs are being included in the final eG-CDR/P-CDR.
    • all: Specifies that all content IDs be included in the final eG-CDR/P-CDR.
    • only-with-traffic: Specifies that only content-IDs with traffic be included in the final eG-CDR/P-CDRs.
  • closing-cause: Configures closing cause for the final eG-CDR/P-CDR.
    • same-in-all-partials: Specifies that the same closing cause is to be included for multiple final eG-CDR/P-CDRs
    • unique: Specifies that the closing cause for final eG-CDR/P-CDRs is to be unique.
losdv-max-containers max_losdv_containers

The maximum number of List of Service Data Volume (LoSDV) containers in one eG-CDR/P-CDR.

max_losdv_containers must be an integer from 1 through 255.

Default: 10

lotdv-max-containers max_lotdv_containers

The maximum number of List of Traffic Data Volume (LoTDV) containers in one eG-CDR/P-CDR.

max_lotdv_containers must be an integer from 1 through 8.

Default: 8

rulebase-max-length rulebase_name_max_length

Specifies the maximum character length of charging rulebase name in LOSDVs of eG- CDR/P-CDR.

rulebase_name_max_length must be an integer from 0 through 63. Zero (0) means the rulebase name is added as-is.

Default: None. That is, full (un-truncated) charging rulebase name will go in LOSDVs of eG-CDR/P-CDR.

service-data-flow threshold { interval interval | volume { downlink bytes [ uplink bytes ] | total bytes | uplink bytes [ downlink bytes ] } }

Configures the thresholds for closing a service data flow container within an eG-CDR/P-CDR.

  • interval interval: Specifies the time interval, in seconds, to close the eG-CDR/P-CDR if the minimum time duration thresholds for service data flow containers satisfied in flow-based charging.
    interval must be an integer from 60 through 40000000.
    Default: Disabled
  • volume { downlink bytes [ uplink bytes ] | total bytes | uplink bytes [ downlink bytes ] }: Specifies the volume octet counts for the generation of the interim G-CDR/P-CDRs to service data flow container in FBC.
    • downlink bytes: specifies the limit for the number of downlink octets after which the eG-CDR/P-CDR is closed.
    • total bytes: Specifies the limit for the total number of octets (uplink+downlink) after which the eG-CDR/P-CDR is closed.
    • uplink bytes: specifies the limit for the number of uplink octets after which the eG-CDR/P-CDR is closed.
    • bytes must be an integer from 10000 through 400000000.

A service data flow container has statistics for an individual content ID. When the threshold is reached, the service data flow container is closed.

service-idle-timeout { 0 | service_idle_timeout }

Specifies a time period where if no data is reported for a service flow, the service container is closed and added to eG-CDR/P-CDR (as part of LOSDV container list) with service condition change as ServiceIdleOut.

service_idle_timeout must be an integer from 10 through 86400.

0: Specifies no service-idle-timeout trigger.

Default: 0


Usage:

Use this command to configure individual triggers for eG-CDR/P-CDR generation.

Use the service-data-flow threshold option to configure the thresholds for closing a service data flow container within an eG-CDR (eG-CDRs for GGSN and P-CDRs for PGW) during flow-based charging (FBC). A service data flow container has statistics regarding an individual content ID.

Thresholds can be specified for time interval and for data volume, by entering the command twice (once with interval and once with volume). When either configured threshold is reached, the service data flow container will be closed. The volume trigger can be specified for uplink or downlink or the combined total (uplink + downlink) byte thresholds.

When the PDP context is terminated, all service data flow containers will be closed regardless of whether the thresholds have been reached.

An eG-CDR/P-CDR will have at most ten service data flow containers. Multiple eG-CDR/P-CDRs will be created when there are more than ten.


Example:
Use the following command to set the maximum number of LoSDV containers to 7:
gtpp egcdr losdv-max-containers 7
The following command sets an eG-CDR threshold interval of 6000 seconds:
gtpp egcdr service-data-flow
threshold interval 6000
gtpp error-response

Configures the response when the system receives an error response after transmitting a DRT (data record transfer) request.

Product:

GGSN

SGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp error-response { discard-cdr | retry-request }default gtpp error-response
default

Configures this command with the default setting.

Default: retry-request

discard-cdr

Instructs the system to purge the request upon receipt of an error response and not to retry.

retry-request

Instructs the system to retry sending a DRT after receiving an error response. This is the default behavior.


Usage:

This command configures the system’s response to receiving an error message after sending a DRT request.


Example:
gtpp error-response
discard-cdr
gtpp group

Configures GTPP server group in a context for the Charging Gateway Function (CGF) accounting server(s) that the system is to communicate with.

Product:

GGSN

SGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
[ no ] gtpp
group group_name [ -noconfirm ]
group_name

Specifies the name of GTPP server group that is used for charging and/or accounting in a specific context. group_name must be an alphanumeric string of 1 through 63 character.

A maximum of eight GTPP server groups (excluding system created default GTPP server group “default”) can be configured with this command in a context.

no

Removes the previously configured GTPP group within a context.

When a GTPP group is removed accounting information is not generated for all calls using that group and all calls associated with that group are dropped. A warning message displays indicating the number of calls that will be dropped.

-noconfirm

Executes the command without any additional prompt and confirmation from the user.


Usage:

This feature provides the charging gateway function (CGF) accounting server configurable for a group of servers. Instead of having a single list of CGF accounting servers per context, this feature configures multiple GTPP accounting server groups in a context and each server group is consist of list of CGF accounting servers.

In case no GTPP server group is configured in a context, a server group named “default” is available and all the CGF servers configured in a specific context for CGF accounting functionality will be part of this “default” server group.


Example:
The following command configures a GTPP server group named star1 for CGF accounting functionality. This server group is available for all subscribers within that context.
gtpp group star1
gtpp max-cdrs

Configures the maximum number of charging data records (CDRs) included per packet.

Product:

GGSN

P-GW

SAEGW

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp max-cdrs max_cdrs [ wait-time wait_time ]default gtpp max-cdrs
default

Configures this command with the default setting.

Default: One CDR per packet; disables wait-time

max_cdrs

Specifies the maximum number of CDRs to be inserted in a single packet as an integer from 1 through 255. Default: 1

wait-time wait_time

Specifies the number of seconds the system waits for CDRs to be inserted into the packet before sending it. wait_time must be an integer from 1 through 300. Default: Disabled

IMPORTANT:

If the wait-time expires, the packet is sent as this keyword over-rides max_cdrs.


Usage:

CDRs are placed into a GTPP packet as the CDRs close. The system stops placing CDRs into a packet when either the maximum max_cdrs is met, or the wait-time expires, or the value for the gtpp max-pdu-size command is met.


Example:
The following command configures the system to place a maximum of 10 CDRs in a single GTPP packet before transmitting the packet:
gtpp max-cdrs 10
gtpp max-pdu-size

Configures the maximum payload size of a single GTPP packet that could be sent by the system.

Product:

GGSN

P-GW

SAEGW

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp max-pdu-size pdu_sizedefault gtpp max-pdu-size
default

Configures this command with the default setting.

Default:65400 bytes

pdu_size

Specifies the maximum payload size (in octets) of the GTPP packet as an integer from 1024 to65400. The payload includes the CDR and the GTPP header.

CAUTION:

This command is effective only when GTPP single-source is configured, otherwise this command has no effect.


Usage:

The GTPP packet contains headers (layer 2, IP, UDP, and GTPP) followed by the CDR. Each CDR contains one or more volume containers. If a packet containing one CDR exceeds the configured maximum payload size, the system creates and send the packet containing the one CDR regardless.

The larger the packet data unit (PDU) size allowed, the more volume containers that can be fit into the CDR.

The system performs standard IP fragmentation for packets that exceed the system’s maximum transmission unit (MTU).

IMPORTANT:

The maximum size of an IPv4 PDU (including the IPv4 and subsequent headers) is 65,535. However, a slightly smaller limit is imposed by this command because the system’s max-pdu-size doesn't include the IPv4 and UDP headers, and because the system may need to encapsulate GTPP packets in a different/larger IP packet (for sending to a backup device).


Example:
The following command configures a maximum PDU size of 2048 octets:
gtpp max-pdu-size 2048
gtpp max-retries

Configures the maximum number of times the system attempts to communicate with an unresponsive Charging Gateway Function (CGF).

Product:

GGSN

P-GW

SAEGW

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp max-retries max_attemptsdefault gtpp max-retries
default

Configures this command with the default setting.

Default: 4

max_attempts

Specifies the number of times the system attempts to communicate with a CGF that is not responding. max_attempts is an integer from 1 through 15.


Usage:

This command works in conjunction with the gtpp detect-dead-server and gtpp timeout parameters to set a limit to the number of communication failures that can occur with a configured CGF.

When the value specified by this parameter is met, a failure is logged. The gtpp detect-dead-server parameter specifies the number of consecutive failures that could occur before the server is marked as down.

In addition, the gtpp timeout command controls the amount of time between re-tries.

If the value for the max-retries is met, the system begins storing CDRs in Random Access Memory (RAM). The system allocates memory as a buffer, enough to store one million CDRs for a fully loaded chassis (a maximum of one outstanding CDR per PDP context). Archived CDRs are re-transmitted to the CGF until they are acknowledged or the system’s memory buffer is exceeded.

Refer to the gtpp detect-dead-server and gtpp timeout commands for additional information.


Example:
The following command configures the maximum number of re-tries to be 8:
gtpp max-retries 8
gtpp node-id

Configures the GTPP Node ID for all CDRs.

Product:

GGSN

P-GW

SAEGW

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp node-id node_idno gtpp node-id
no

Removes the previous gtpp node ID configuration.

node_id

Specifies the node ID for all CDRs as an alphameric string of 1 through 16 characters.


Usage:

Use this command to configure the GTPP Node ID for all CDRs.


Example:
The following command configures the GTPP Node ID as test123:
gtpp node-id test123
gtpp redirection-allowed

Configures the system to allow or disallow the redirection of CDRs when the primary Charging Gateway Function (CGF) is unavailable.

Product:

GGSN

P-GW

SAEGW

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp redirection-allowed{ default | no } gtpp
redirection-allowed
default

Configures this command with the default setting. Default: Enabled

no

Deletes the command from the configuration.


Usage:

This command allows operators to better handle erratic network links, without having to remove the configuration of the backup server(s) via the no gtpp server command.

This functionality is enabled by default.

If the no gtpp redirection-allowed command is executed, the system only sends CDRs to the primary CGF. If that CGF goes down, we will buffer the CDRs in memory until the CGF comes back or until the system runs out of buffer memory. In addition, if the primary CGF announces its intent to go down (with a GTPP Redirection Request message), the system responds to that request with an error response.

gtpp redirection-disallowed

This command has been obsoleted and is replaced by the gtpp redirection-allowed command.

gtpp server

Configures the Charging Gateway Function (CGF) accounting server(s) with which the system will communicate.

Product:

GGSN

P-GW

SAEGW

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp server ip_address [ max max_messages ] [ priority priority ] [ port port ] [ node-alive { enable | disable } ] [ -noconfirm ]no gtpp server ip_address
no

Deletes a previously configured CGF.

ip_address

Specifies the IP address of the CGF in IPv4 dotted-decimal or IPV6 colon-separated-hexadecimal notation.

max max_messages

Default: 256

Specifies the maximum number of outstanding or unacknowledged GTPP packets (from any one AAA Manager task) allowed for this CGF before the system begins buffering the packets.

max_messages can be configured as an integer from 1 through 256.

priority priority

Default:1000

Specifies the relative priority of this CGF. When multiple CGFs are configured, the priority is used to determine which CGF server to send accounting data to.

priority can be configured as an integer from 1 through 1000. When configuring two or more servers with the same priority you will be asked to confirm that you want to do this. If you use the -noconfirm option, you are not asked for confirmation and multiple servers could be assigned the same priority.

port port

Default: 3386

Specifies the port the CGF is using. port can be configured as an integer from 1 through 65535. Default value for port is 3286.

IMPORTANT:

The port keyword option has been modified from udp-port to make it a generic command. The udp-port keyword can still be used, however, it will be in concealed mode and will not be shown in auto-complete or help for the command.

node-alive { enable | disable }

Default: Disable.

This optional keyword allows operator to enable/disable GSN to send Node Alive Request to GTPP Server (i.e. CGF). This configuration can be done per GTPP Server basis.

-noconfirm

Executes the command without any additional prompt and confirmation from the user.


Usage:

Use this command to configure the CGF(s) that the system sends CDR accounting data to.

Multiple CGFs can be configured using multiple instances of this command. Up to 12 CGF scan be configured per system context. Each configured CGF can be assigned a priority. The priority is used to determine which server to use for any given subscriber based on the routing algorithm that has been implemented. A CGF with a priority of “1” has the highest priority.

IMPORTANT:

The configuration of multiple CGFs with the same IP address but different port numbers is not supported.

Each CGF can also be configured with the maximum allowable number of unacknowledged GTPP packets. Since multiple AAA Manager tasks could be communicating with the same CGF, the maximum is based on any one AAA Manager instance. If the maximum is reached, the system buffers the packets Random Access Memory (RAM). The system allocates memory as a buffer, enough to store one million CDRs for a fully loaded chassis (a maximum of one outstanding CDR per PDP context).


Example:
The following command configures a CGF with an IP address of 192.168.2.2 and a priority of 5.
gtpp server 192.168.2.2
priority 5
The following command deletes a previously configured CGF with an IP address of 100.10.35.7:
no gtpp server 100.10.35.7 
gtpp source-port-validation

Toggles port checking for node alive/echo/redirection requests from the CGF.

Product:

GGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
[ default | no ] gtpp
source-port-validation
default

Configures this command with the default setting.

Default: Enabled

no

Disables CGF port checking.Only the IP address will be used to verify CGF requests.


Usage:

This command is for enabling or disabling port checking on node alive/echo/redirection requests from the CGF. If the CGF sends messages on a non-standard port, it may be necessary to disable port checking in order to receive CGF requests. On the default setting, both IP and port are checked.


Example:
The following command disables port checking for CGF requests:
no gtpp source-port-validation
gtpp storage-server

Configures information for the GTPP back-up storage server.

Product:

GGSN

P-GW

SAEGW

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
[ no ] gtpp
storage-server ip-address port port-num
no

Removes a previously configured back-up storage server.

ip-address

Specifies the IP address of the back-up storage server expressed in IPv4 dotted-decimal notation.

port port-num

Specifies the UDP port number over which the GSN communicates with the back-up storage server. Default: 3386


Usage:

This command configures the information for the server to which GTPP packets are to be backed up to if all the CGFs are unreachable.

One backup storage server can be configured per system context.

IMPORTANT:

This command only takes affect if gtpp single-source in the Global Configuration Mode is also configured. Additionally, this command is customer specific. Please contact your local sales representative for additional information.


Example:
The following command configures a back-up server with an IP address of 192.168.1.2:
gtpp storage-server 192.168.1.2
gtpp storage-server local file

Configures the parameters for GTPP files stored locally on the GTPP storage server. This command is available for the ASR 5000 platform only.

Product:

GGSN

P-GW

SAEGW

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp storage-server
local file { compression { gzip | none } | format { custom1 | custom2 | custom3 | custom4 | custom5 | custom6 | custom7 | custom8 } | name { format string [ max-file-seq-num seq_number ] | prefix prefix } | purge-processed-files [ file-name-pattern file_pattern | purge-interval purge_dur ] | push { encrypted-url url | url url } [ encrypted-secondary-url url | secondary-url url ] [ via-local-context ] | rotation { cdr-count count | time-interval time [ force-file-rotation ] | volume
mb size } | start-file-seq-num seq_num [ recover-file-seq-num ]  }default gtpp storage-server
local file { compression | format | name { format | prefix } | purge-processed-files | rotation { cdr-count | time-interval | volume } | start-file-seq-num }no gtpp storage-server
local file { purge-processed-files | push | rotation { cdr-count | time-interval } }
default

Configures default setting for the specified parameter.

no

Removes a previously configured parameters for local storage of CDR files on HDD on SMC card.

compression { gzip | none }

Configures the type of compression to be used on the files stored locally.

  • gzip: Enables Gzip file compression.
  • none: Disables Gzip file compression -this is the default value.

Default: Disabled

format { custom-n }

Configures the file format to be used to format files to be stored locally.

custom1: File format custom1—this is the default value.

custom2: File format custom2.

custom3: File format custom3.

custom4: File format custom4.

custom5: File format custom5.

custom6: File format custom6 with a block size of 8K for CDR files.

custom7: File format custom7 is a customer specific CDR file format.

custom8: File format custom8 is a customer specific CDR file format. It uses node-id-suffix_date_time_fixed-length-seq-num format for file naming.

Default: custom1

name { format | prefix prefix }

Allows the format of the CDR filenames to be configured independently from the file format so that the name format contains the file name with conversion specifications.

prefix — Enter an alphanumeric string of 1 through 127 characters. The string must begin with the % (percent sign).
  • %y: = year as a decimal number without century (range 00 to 99).
  • %Y: year as a decimal number with century.
  • %m: month as a decimal number (range 01 to 12).
  • %d: day of the month as a decimal number (range 01 to 31).
  • %H: hour as a decimal number 24-hour format (range 00 to 23).
  • %h: hour as a decimal number 12-hour format (range 01 to 12).
  • %M: minute as a decimal number (range 00 to 59).
  • %S: second as a decimal number (range 00 to 60). (The range is up to 60 to allow occasional leap seconds.)
  • %Q: File sequence number. Field width may be specified between the % and the Q. If the natural size of the field is smaller than this width, then the result string is padded (on the left) to the specified width with 0s
  • %N: No of CDRs in the file. Field width may be specified between the % and the N. If the natural size of the field is smaller than this width, then the result string is padded (on the left) to the specified width with 0s
  • max-file-seq-no: This can be configured optionally. It indicates the maximum value of sequence number in file name (starts from 1). Once the configured max-file-seq-no limit is reached, the sequence number will restart from 1. If no max-file-seq-no is specified then file sequence number ranges from 1 – 4294967295.

By default the above keyword is not configured (default gtpp storage-server local filename format). In which case the CDR filenames are generated based on the file format as before (maintains backward compatibility).

purge-processed-files [ file-name-pattern file_pattern | purge-interval purge_dur ]

Enables the GSN to periodically (every 4 minutes) delete locally processed (*.p) CDR files from the HDD on the SMC card. Default: Disabled

This keyword also deletes the processed push files (tx.*,under $CDR_PATH/TX/tx.*) a well when purging is enabled instead of "*.p:*.P".

IMPORTANT:

This option is available only when GTPP server storage mode is configured for local storage of CDRs with the gtpp storage-server mode local command.

Optional keyword file-name-pattern file_pattern provides an option for user to control the pattern of files. file_pattern must be mentioned in “*.p:*.P:tx.*” format in a string of size 1 through 127, which is also the default format. Wildcards * and: (synonymous to |) are allowed.

Optional keyword purge-interval purge_dur provides an option for user to control the purge interval duration (in minutes). purge_dur must be an integer from 1 through 259200. Default value 60.

push { encrypted-url encrypted_url | url url } [ encrypted-secondary-url encrypted_url | secondary-url url ] [ via-local-context ]

Enables push method to transfer local CDR files to remote system.

encrypted-url: Defines use of an encrypted url.

encrypted_url must be an alphanumeric string of 1 through 8192 characters in SFTP format.

url: Location where the CDR files are to be transferred.

url must be an alphanumeric string of 1 through 1024 characters in the format:

scheme://user:password@host

encrypted-secondary-url: Defines use of an encrypted secondary url.

encrypted_url must be an alphanumeric string of 1 through 8192 characters in SFTP format.

secondary-url: Secondary location where the CDR files are to be transferred, in case primary is unreachable.

url must be an alphanumeric string of 1 through 1024 characters in the format:

scheme://user:password@host

IMPORTANT:

When a file transfer to primary fails four times, the transfer of files will automatically be failed over to the secondary server. The transfer will switch back to the original primary after 30 minutes, or if there are four transfer failures to the secondary server.

via-local-context: Pushes the CDR files via SPIO in the local context.

Default: Pushes via the group's context.

IMPORTANT:

If the push is done through gtpp context, then the push rate is lesser compared to via local context as the HDD is attached to the local context.

rotation { cdr-countcount | time-interval time | volume mb size }

Specifies rotation related configuration for GTPP files stored locally.

cdr-count count: Configures the CDR count for the file rotation as an integer from 1000 through 65000. Default value 10000.

time-interval time: Configures the time interval (in seconds) for file rotation as an integer from 30 through 86400. Default value 3600 (1 hour).

volume mb size: Configure the file volume (in MB) for file rotation. Enter an integer from 2 to 40. This trigger cannot be disabled. Default value is 4MB.

start-file-seq-num seq_num [ recover-file-seq-num ]

Specifies the start sequence number. The sequence number goes on incrementing until ULONG_MAX (or max-seq-num configured in file name format) and then it would rollover. If recover-file-seq-num is configured, every time the system is rebooted (or aaaproxy recovery/ planned/ unplanned packet service card migration), the file sequence number continues from the last sequence number and during rollover it starts from first-sequence number.

seq_num: Configures the sequence number. Enter an integer from 1 through 4294967295.

recover-file-seq-num: Configures the recovery of file sequence number. This is an optional field and if configured, every time the machine rebooted, the file sequence number continues from the last sequence number.


Usage:

This command configures the parameters for storage of GTPP packets as files on the local server—meaningthe hard disk.


Example:
The following command configures rotation for every 1.5 hours (5400 seconds) for locally stored files.
gtpp storage-server
local file rotation time-interval 5400 start-file-seq-num 20 recover-file-seq-num
gtpp storage-server max-retries

Configures the maximum number of times the system attempts to communicate with an unresponsive GTPP back-up storage server.

Product:

GGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp storage-server
max-retries max_attemptsdefault gtpp storage-server
max-retries
default

Configures this command with the default setting.

Default: 2

max_attempts

Specifies the number of times the system attempts to communicate with a GTPP back-up storage server that is not responding. max_attempts enter an integer from 1 through 15.


Usage:

This command works in conjunction with the gtpp storage-server timeout parameters to set a limit to the number of communication failures that can occur with a configured GTPP back-up storage server.

The gtpp storage-server timeout command controls the amount of time between re-tries.


Example:
The following command configures the maximum number of re-tries to be 8:
gtpp storage-server
max-retries 8
gtpp storage-server mode

Configures storage mode, local or remote, for CDRs. Local storage mode is available with ASR 5000 platforms only.

Product:

GGSN

P-GW

SAEGW

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp storage-server
mode { local | remote | streaming }default gtpp storage-server mode
default

Configures this command with the default setting.

Default: remote

local

Default: Disabled

Specifies the use of the hard disk on the SMC for storing CDRs

remote

Specifies the use of an external server for storing CDRs. This is the default value.

streaming

Default: Disabled

Allows the operator to configure “streaming” mode of operation for GTPP group. When this keyword is supplied the CDRs will be stored in following fashion:

  • When GTPP link is active with CGF, CDRs are sent to a CGF via GTPP and local hard disk is NOT used as long as every record is acknowledged in time.
  • If the GTPP connection is considered to be down, all streaming CDRs will be saved temporarily on the local hard disk and once the connection is restored, unacknowledged records will be retrieved from the hard disk and sent to the CGF.

Usage:

This command configures whether the CDRs should be stored on the hard disk of the SMC or remotely, on an external server.


Example:
The following command configures use of a hard disk for storing CDRs:
gtpp storage-server
mode local
gtpp storage-server timeout

Configures the amount of time that must pass with no response before the system re-attempts to communicate with the GTPP back-up storage server.

Product:

GGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp storage-server
timeout durationdefault gtpp storage-server timeout
default

Configures this command with the default setting.

Default: 30 seconds

duration

Specifies the maximum amount of time (in seconds) the system waits for a response from the GTPP back-up storage server before assuming the packet is lost. duration is an integer from 30 through 120.


Usage:

This command works in conjunction with the gtpp storage-server max-retries command to establish a limit on the number of times that communication with a GTPP back-up storage server is attempted before a failure is logged. This parameter specifies the time between retries.


Example:

The following command configures a retry timeout of 60 seconds:

gtpp storage-server
timeout 60
gtpp suppress-cdrs zero-volume

This command suppresses the CDRs with zero byte data count. The CDRs can be classified as Final-cdrs, Internal-trigger-cdrs, and External-trigger-cdrs. This command allows the selection of CDRs to be suppressed and it is disabled by default.

IMPORTANT:

This command is license dependent. For more information, contact your Cisco account representative.

Product:

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp suppress-cdrs
zero-volume { external-trigger-cdr | final-cdr | internal-trigger-cdr } default gtpp suppress-cdrs
zero-volumeno gtpp suppress-cdrs
zero-volume
default

Configures this command with the default setting.

no

Disables suppression of the CDRs with zero byte data count.


Usage:

This command suppresses the CDRs with zero byte data count. This command provides an option to select the CDRs to be suppressed.


Example:
To suppress only final zero volume CDRs use:
gtpp suppress-cdrs
zero-volume final-cdr
To suppress final zero Volume CDRs and interim zero volume CDRs due to internal triggers use:
gtpp suppress-cdrs
zero-volume final-cdr internal-trigger-cdr
To suppress final zero volume CDRs and interim zero volume CDRs due to internal and external triggers use:
gtpp suppress-cdrs
zero-volume final-cdr internal-trigger-cdr external-trigger-cdr
To suppress interim zero volume CDRs due to internal and external triggers use:
gtpp suppress-cdrs
zero-volume internal-trigger-cdr external-trigger-cdr
To suppress interim zero volume CDRs due to external triggers use:
gtpp suppress-cdrs
zero-volume external-trigger-cdr
gtpp suppress-cdrs zero-volume-and-duration

Suppresses the CDRs created by sessions having zero duration and/or zero volume. By default this mode is disabled.

Product:

GGSN

P-GW

SAEGW

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp suppress-cdrs zero-volume-and-duration { gcdrs [ egcdrs ] | egcdrs [ gcdrs ] }default gtpp suppress-cdrs
zero-volume-and-duration
default

Configures this command with the default setting.

Default: Disabled.

gcdrs [ egcdrs ]

Suppresses G-CDRs before eG-CDRs.

egcdrs [ gcdrs ]

Suppresses eG-CDRs before G-CDRs.


Usage:

Use this command to suppress the CDRs (G-CDRs and eG-CDRs) which were created when zero-duration sessions and zero-volume sessions are encountered due to any reason.By default this command is disabled and system will not suppress any CDR.


Example:
The following command configures the system to suppress the eG-CDRs created for a zero duration session or zero volume session:
gtpp suppress-cdrs
zero-volume-and-duration egcdrs gcdrs
gtpp timeout

Configures the amount of time that must pass with no response before the system re-attempts to communicate with the Charging Gateway Function (CGF).

Product:

GGSN

SGSN

P-GW

SAEGW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp timeout timedefault gtpp timeout
default

Configures this command with the default setting. Default: 20 seconds

time

Specifies the maximum amount of time (in seconds) the system waits for a response from the CGF before assuming the packet is lost. time is an integer from 1 through 60.


Usage:

This command works in conjunction with the gtpp max-retries command to establish a limit on the number of times that communication with a CGF is attempted before a failure is logged.

This parameter specifies the time between retries.


Example:
The following command configures a retry timeout of 30 seconds:
gtpp timeout 30
gtpp trigger

This command is left in place for backward compatibility. To disable and enable GTPP triggers you should use the gtpp trigger command in GTPP Server Group Configuration Mode.

gtpp transport-layer

Selects the transport layer protocol for the Ga interface for communication between the access gateways (GSNs) and GTPP servers.

Product:

GGSN

P-GW

SAEGW

SGSN


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpp transport-layer { tcp | udp }default gtpp transport-layer
default

Configures this command with the default setting.

Default: udp

tcp

Default: Disabled

Enables the system to implement TCP as transport layer protocol for communication with GTPP server.

udp

Default: Enabled

Enables the system to implement UDP as transport layer protocol for communication with GTPP server.


Usage:

Use this command to select the TCP or UDP as the transport layer protocol for Ga interface communication between GTPP servers and AGWs (GSNs).


Example:
The following command enables TCP as the transport layer protocol for the GSN’s Ga interface.
gtpp transport-layer tcp
gtpu-service

Creates a GTP-U service or specifies an existing GTP-U service and enters the GTP-U Service Configuration Mode for the current context.

Product:

GGSN

P-GW

SAEGW

S-GW


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
gtpu-service service_name [ -noconfirm ]no gtpu-service service_name
gtpu-service service_name

Specifies the name of the GTP-U service. If service_name does not refer to an existing service, a new service is created if resources allow. service_name is an alphanumeric string of 1 through 63 characters.

IMPORTANT:

Service names must be unique across all contexts within a chassis.

-noconfirm

Executes the command without any additional prompt and confirmation from the user.

no gtpu-service service_name

Removes the specified GTP-U service from the context.


Usage:

Enter the GTP-U Service Configuration Mode for an existing service or for a newly defined service. This command is also used to remove an existing service.

A maximum of 256 services (regardless of type) can be configured per system.

CAUTION:

Large numbers of services greatly increase the complexity of management and may impact overall system performance (for example, resulting from such things as system handoffs). Therefore, it is recommended that a large number of services only be configured if your application absolutely requires it. Please contact your local service representative for more information.

Entering this command results in the following prompt:

[context_name]hostname(config-gtpu-service)#

GTP-U Service Configuration Mode commands are defined in the GTP-U Service Configuration Mode Commands chapter.


Example:
The following command enters the existing GTP-U Service Configuration Mode (or creates it if it does not already exist) for the service named gtpu-service1:
gtpu-service gtpu-service1
The following command will remove gtpu-service1 from the system:
no gtpu-service gtpu-service1
ha-service

Creates/deletes a home agent service or specifies an existing HA service for which to enter the Home Agent Service Configuration Mode for the current context.

Product:

HA


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
ha-service name [ -noconfirm ]no ha-service name
no

Indicates the home agent service specified is to be removed.

name

Specifies the name of the HA service to configure. If name does not refer to an existing service, the new service is created if resources allow. name is an alphanumeric string of 1 through 63 characters.

IMPORTANT:

Service names must be unique across all contexts within a chassis.

-noconfirm

Executes the command without any additional prompt and confirmation from the user.


Usage:

Enter the HA Service Configuration Mode for an existing service or for a newly defined service. This command is also used to remove an existing service.

A maximum of 256 services (regardless of type) can be configured per system.

CAUTION:

Large numbers of services greatly increase the complexity of management and may impact overall system performance (i.e. resulting from such things as system handoffs). Therefore, it is recommended that a large number of services only be configured if your application absolutely requires it. Please contact your local service representative for more information.


Example:
The following command will enter, or create and enter, the HA service sampleService:
ha-service sampleService
The following command will remove sampleService as being a defined HA service:
no ha-service sampleService
hnbgw-service

Creates or removes an Home Node B Gateway (HNB-GW) service or configures an existing HNB-GW service and enters the HNB-GW Service Configuration Mode for Femto UMTS access networks configuration in the current context.

Product:

HNB-GW


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
hnbgw-service hnbgw_svc_name [ -noconfirm ]no hnbgw-service hnbgw_svc_name
no

Removes the specified HNB-GW service from the context.

hnbgw_svc_name

Specifies the name of the HNB-GW service. If service_name does not refer to an existing service, the new service is created if resources allow. hnbgw_svc_name is an alphanumeric string of 1 through 63 characters.

IMPORTANT:

Service names must be unique across all contexts within a chassis.

-noconfirm

Executes the command without any additional prompt and confirmation from the user.


Usage:

Use this command to enter the HNB-GW Service Configuration Mode for an existing service or for a newly defined service. This command is also used to remove an existing service.

A maximum of one HNB-GW service which is further limited to a maximum of 256 services (regardless of type) can be configured per system.

CAUTION:

Large numbers of services greatly increase the complexity of management and may impact overall system performance (for example, resulting from such things as system handoffs). Therefore, it is recommended that a large number of services only be configured if your application absolutely requires it. Please contact your local service representative for more information.

Entering this command results in the following prompt:

[context_name]hostname(config-hnbgw-service)#

The commands available in this mode are defined in the HNB-GW Service Configuration Mode Commands chapter of Command Line Interface Reference.

CAUTION:

This is a critical configuration. The HNB-GW service can not be configured without this configuration. Any change to this configuration would lead to restarting the HNB-GW service and removing or disabling this configuration will stop the HNB-GW service.


Example:
The following command enters the existing HNB-GW Service Configuration Mode (or creates it if it does not already exist) for the service named hnb-service1:
hnbgw-service hnb-service1
The following command will remove hnb-service1 from the system:
no hnbgw-service hnb-service1
hsgw-service

Creates an HSGW service or specifies an existing HSGW service and enters the HSGW Service Configuration Mode for the current context.

Product:

HSGW


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
hsgw-service service_name [ -noconfirm ]no hsgw-service service_name
no

Removes the specified HSGW service from the context.

service_name

Specifies the name of the HSGW service. If service_name does not refer to an existing service, the new service is created if resources allow. service_name is an alphanumeric string of 1 through 63 characters.

IMPORTANT:

Service names must be unique across all contexts within a chassis.

-noconfirm

Executes the command without any additional prompt and confirmation from the user.


Usage:

Enter the HSGW Service Configuration Mode for an existing service or for a newly defined service. This command is also used to remove an existing service.

A maximum of 256 services (regardless of type) can be configured per system.

CAUTION:

Large numbers of services greatly increase the complexity of management and may impact overall system performance (for example, resulting from such things as system handoffs). Therefore, it is recommended that a large number of services only be configured if your application absolutely requires it. Please contact your local service representative for more information.

Entering this command results in the following prompt:

[context_name]hostname(config-hsgw-service)#

HSGW Service Configuration Mode commands are defined in the HSGW Service Configuration Mode Commands chapter.

Use this command when configuring the following eHRPD components: HSGW.


Example:
The following command enters the existing HSGW Service Configuration Mode (or creates it if it does not already exist) for the service named hsgw-service1:
hsgw-service hsgw-service1
The following command will remove hsgw-service1 from the system:
no hsgw-service hsgw-service1
hss-peer-service

Creates a Home Subscriber Service (HSS) peer service or configures an existing HSS peer service and enters the HSS Peer Service Configuration Mode.

Product:

MME

SGSN


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration

configure > context context_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-ctx)#

Syntax
hss-peer-service service_name [ -noconfirm ]no hss-peer-service service_name
no

Removes the specified HSS peer service from the context.

service_name

Specifies the name of the HSS peer service. If service_name does not refer to an existing service, a new service is created if resources allow. service_name is an alphanumeric string of 1 through 63 characters.

IMPORTANT:

Service names must be unique across all contexts within a chassis.

-noconfirm

Executes the command without any additional prompt and confirmation from the user.


Usage:

Enter the HSS Peer Service Configuration Mode for an existing service or for a newly defined service. This command is also used to remove an existing service.

A maximum of 256 services (regardless of type) can be configured per system.

CAUTION:

Large numbers of services greatly increase the complexity of management and may impact overall system performance (for example, resulting from such things as system handoffs). Therefore, it is recommended that a large number of services only be configured if your application absolutely requires it. Please contact your local service representative for more information.

Entering this command results in the following prompt:

[context_name]hostname(config-hss-peer-service)#

HSS Peer Service Configuration Mode commands are defined in the HSS Peer Service Configuration Mode Commands chapter.


Example:
The following command enters the existing HSS Peer Service Configuration Mode (or creates it if it does not already exist) for the service named hss-peer1:
hss-peer-service hss-peer1
The following command will remove hss-peer1 from the system:
no hss-peer-service
hss-peer1