end
Exits the current configuration mode and returns to the Exec mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
end
Usage Guidelines
Use this command to return to the Exec mode.
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
Overload control enables a GTP-C entity becoming or being overloaded to gracefully reduce its incoming signalling load by instructing its GTP-C peers to reduce sending traffic according to its available signalling capacity to successfully process the traffic. A GTP-C entity is in overload when it operates over its signalling capacity, which results in diminished performance (including impacts to handling of incoming and outgoing traffic).
This chapter describes the GTPC Overload Profile Configuration Mode Commands
Exec > Global Configuration > GTPC Overload Control Profile Configuration
configure > gtpc-overload-control-profile profile_name
Entering the above command sequence results in the following prompt:
[local]host_name(config-gtpc-overload-control-profile)#
Important |
Available commands or keywords/variables vary based on platform type, product version, and installed license(s). |
Exits the current configuration mode and returns to the Exec mode.
All
Security Administrator, Administrator
end
Use this command to return to the Exec mode.
Exits the current mode and returns to the parent configuration mode.
All
Security Administrator, Administrator
exit
Use this command to return to the parent configuration mode.
This command allows the user to configure the inclusion of CPU utilization of Session Manager, Demux Manager, IMSI Manager and MME Manager under GTP-C overload control profile for overload factor calculation.
P-GW
MME
S-GW
Administrator, Security Administrator
Exec > Global Configuration > GTPC Overload Control Profile Configuration
configure > gtpc-overload-control-profile profile_name
Entering the above command sequence results in the following prompt:
[local]host_name(config-gtpc-overload-control-profile)#
cpu-utilization { sessmgr-card | demuxmgr-card | imsimgr | mmemgr }
no cpu-utilization
default cpu-utilization
Disables the configuration of CPU utilization of Sessmgr/Demuxmgr/IMSImgr/MMEmgr under GTP-C overload control profile for overload factor calculation.
The default behavior for the above CLI is to include the average CPU utilization of Sessmgr cards and Demuxmgr card in the overload factor calculation.
This command configures the inclusion of average CPU-utilization SessMgr Cards/DemuxMgr Card/MMEMgr/IMSIMgr for load factor calculation.
This keyword configures the inclusion of average cpu-utilization of SessMgr cards for overload factor calculation.
This keyword configures the inclusion of average cpu-utilization of Demux Manager card for overload factor calculation.
This keyword configures the inclusion of cpu-utilization of IMSIMgr(s) proclet for overload factor calculation.
This keyword configures the inclusion of cpu-utilization of MMEMgr(s) proclet for overload factor calculation.
cpu-utilization sessmgr-card demuxmgr-card imsimgr mmemgr
Configure parameters to determine the inclusion frequency of the Overload Control Information IE.
Important |
GTP-C Overload Control Profile is a license-controlled feature. For more information, contact your Cisco account or support representative. |
P-GW
SAEGW
S-GW
Administrator, Security Administrator
Exec > Global Configuration > GTPC Overload Control Profile Configuration
configure > gtpc-overload-control-profile profile_name
Entering the above command sequence results in the following prompt:
[local]host_name(config-gtpc-overload-control-profile)#
inclusion-frequency { advertisement-interval interval_in_seconds | change-factor change_factor }
default inclusion-frequency { advertisement-interval | change-factor }
Specifies that parameters to determine the inclusion frequency of the Overload Control Information IE for a GTP-C Overload Control Profile configuration will be configured. The Overload Control Information IE is a 3GPP-specific IE that is sent to peers when a configured threshold is reached. This parameter specifies how often the operator wants to send overload information to the peers.
Configures the advertisement-interval for overload control in seconds. Specifies how often overload control information should be sent to the peers. If configured to 0, the node will send overload control information in each and every outgoing message to the peers.
interval_in_seconds must be an integer from 0 to 3600.
Default: 300
P-GW only. Configures the change factor for overload control. If the overload control factor changes by a configured factor, whether by an increase or decrease, the overload control information should be sent to the peers. This information is only sent to the peers when the overload factor changes by the factor configured.
change_factor must be an integer from 1 to 20.
Default: 5%
Use this command to configure parameters to decide inclusion frequency of Overload Control Information IE. How often the sender includes the overload control information is implementation specific. The network element ensures that new/updated overload control information is propagated to the target receivers within an acceptable delay so that the purpose of the information, effective load balancing, is achieved.
If no parameters are specified, the system will use the default settings.
The Overload Control Profile must be associated with a P-GW, S-GW, or SAEGW service using one of the following commands:
inclusion-frequency change-factor 10
Configures the priority percentage to be given to the two specific message groups for the GTP-C Overload Control Profile feature.
Important |
GTP-C Overload Control Profile is a license-controlled feature. Fore more information, contact your Cisco account or support representative. |
ePDG
P-GW
SAEGW
S-GW
Administrator, Security Administrator
Exec > Global Configuration > GTPC Overload Control Profile Configuration
configure > gtpc-overload-control-profile profile_name
Entering the above command sequence results in the following prompt:
[local]host_name(config-gtpc-overload-control-profile)#
message-prioritization group1 percentage group2 percentage
[ no | default ] message-prioritization
Disables message-prioritization for this node.
Returns the message-prioritization settings to there default value. The defaults are 50% for each message group.
Configures the priority percentage to be given to the two message groups.
In the overload control it is possible to apply message throttling (when peer indicated it is overloaded) based on message priority. To apply message prioritization using the loss algorithm the node must know how many messages each node (PGW or ePDG) is expected to generate. This keyword allows the operator to define the expected number of messages in, as a percentage in each message group. group1 messages are:
The entry must be an integer from 0 to 100.
The default setting is 50%.
In the overload control it is possible to apply message throttling (when peer indicated it is overloaded) based on message priority. To apply message prioritization using the loss algorithm the node must know how many messages each node (PGW or ePDG) is expected to generate. This keyword allows the operator to define the expected number of messages in, as a percentage in each message group. group2 messages are:
The entry must be an integer from 0 to 100.
The default setting is 50%.
Use this command to configure priority the message prioritization percentage to be given to the two specific message groups.
The Overload Control Profile must be associated with a P-GW, S-GW, or SAEGW service using one of the following commands:
message prioritization group1 40 group2 60
Enables/disables the handling of GTP-C overload control information for the node.
Important |
GTP-C Overload Control Profile is a license-controlled feature. For more information, contact your Cisco account or support representative. |
P-GW
SAEGW
S-GW
Administrator, Security Administrator
Exec > Global Configuration > GTPC Overload Control Profile Configuration
configure > gtpc-overload-control-profile profile_name
Entering the above command sequence results in the following prompt:
[local]host_name(config-gtpc-overload-control-profile)#
[ no ] overload-control-handling { home | visited }
Disables overload control information handling for this node.
Enables the handling of overload control information.
Specifies that the handling of overload control information will be enabled for the home PLMN.
Specifies that the handling of overload control information will be enabled for the visited PLMN.
Use this command to enable/disable the handling of overload control information for this node.
The Load Control Profile must be associated with a P-GW, S-GW, or SAEGW service using one of the following commands:
overload-control-handling home
Enables/disables the publishing of overload control information towards the home or visited PLMN.
Important |
GTP-C Overload Control Profile is a license-controlled feature. For more information, contact your Cisco account or support representative. |
P-GW
SAEGW
S-GW
Administrator, Security Administrator
Exec > Global Configuration > GTPC Overload Control Profile Configuration
configure > gtpc-overload-control-profile profile_name
Entering the above command sequence results in the following prompt:
[local]host_name(config-gtpc-overload-control-profile)#
[ no ] overload-control-publishing { home | visited }
default overload-control-publishing
Disables overload control information publishing towards the home or visited PLMN.
Returns overload control publishing to the default setting.
Enables the publishing of overload control information.
Enables the publishing of overload control information towards the home PLMN.
Enables the publishing of overload control information towards the visited PLMN.
Use this command to enable/disable the publishing of overload control information towards the home or visited PLMN.
The Load Control Profile must be associated with a P-GW, S-GW, or SAEGW service using one of the following commands:
overload-control-publishing visited
Configures self protection behavior for up to three APN names or eight EARP values for the GTP-C Overload Control Profile feature.
Important |
GTP-C Overload Control Profile is a license-controlled feature. For more information, contact your Cisco account or support representative. |
P-GW
SAEGW
S-GW
Administrator, Security Administrator
Exec > Global Configuration > GTPC Overload Control Profile Configuration
configure > gtpc-overload-control-profile profile_name
Entering the above command sequence results in the following prompt:
[local]host_name(config-gtpc-overload-control-profile)#
[ no ] self-protection-behavior { apn apn_name * exclude | earp { 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 * } exclude } }
Disables self-protection-behavior for this node.
Enables self protection behavior for this node
Specify up to three APN names to be allowed under self-protection behavior.
Configures up to eight EARP priority level values so that incoming request messages for the configured EARP priority values are not rejected even if the system is under self-protection mode.
Specifies that configured emergency pdn connections and/or EARP priority values are not rejected.
Use this command to configure GTP-C overload control self-protection behavior. This functionality enables the operator to configure up to three APN names and up to eight EARP priority level values for self-protection mode so that incoming request messages for emergency packet data node (PDN) connections and/or configured EARP priority values are not rejected even if the system is under self-protection mode.
The Load Control Profile must be associated with a P-GW, S-GW, or SAEGW service using one of the following commands:
self-protection-behavior apn APN1
Configures GTP-C Overload Control Profile tolerance limits.
Important |
GTP-C Overload Control Profile is a license-controlled feature. For more information, contact your Cisco account or support representative. |
P-GW
SAEGW
S-GW
Administrator, Security Administrator
Exec > Global Configuration > GTPC Overload Control Profile Configuration
configure > gtpc-overload-control-profile profile_name
Entering the above command sequence results in the following prompt:
[local]host_name(config-gtpc-overload-control-profile)#
tolerance { initial-reduction-metric percentage | threshold report-reduction-metric percentage self-protection-limit percentage }
default tolerance [ initial-reduction-metric | threshold ]
Specifies that GTP-C overload profile configuration tolerance parameters will be configured.
Configures initial overload reduction metric value to be advertised upon reaching minimum overload tolerance limit. When reaching the configured minimum threshold, this parameter specifies how much the node wants the peers to reduce incoming traffic.
percentage must be an integer from 1 to 100.
Default: 10%
Configures the minimum overload tolerance threshold for advertising overload reduction metric to the peer. When the minimum threshold is reached, the node will report this information to peers. When the maximum limit is reached, the node will go into self-protection mode.
Important |
The threshold report-reduction-metric should always be lower than the self-protection-limit . |
percentage must be an integer from 1 to 100.
Default: 80%
Configures the maximum overload tolerance threshold after which node will move to self protection mode. When the maximum limit is reached, the node will start rejecting all incoming messages, except for delete messages. The node will not initiate any new messages to the peers. This is to mitigate the overload condition.
percentage must be an integer from 1 to 100.
Default: 95%
Use this command to configure GTP-C Overload Control Profile tolerance limits.
Default parameters are used if any parameters are not configured.
The Overload Control Profile must be associated with a P-GW, S-GW or SAEGW service using one of the following commands:
tolerance initial-reduction-metric 20
Configures throttling behavior based on peer's overload reduction-metric by excluding some or all emergency events and/or EARP messages for the GTP-C Overload Control Profile feature.
Important |
GTP-C Overload Control Profile is a license-controlled feature. For more information, contact your Cisco account or support representative. |
P-GW
SAEGW
S-GW
Administrator, Security Administrator
Exec > Global Configuration > GTPC Overload Control Profile Configuration
configure > gtpc-overload-control-profile profile_name
Entering the above command sequence results in the following prompt:
[local]host_name(config-gtpc-overload-control-profile)#
throttling-behavior { earp [ 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9| 10 | 11 | 12 | 13 | 14 | 15 * ] exclude } | emergency-events exclude }
no throttling-behavior { earp [ 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9| 10 | 11 | 12 | 13 | 14 | 15 * ] exclude } | emergency-events exclude }
Configures throttling behavior based on peer's overload reduction-metric.
Excludes the specified messages with configured earp from throttling due to peer's overload-reduction metric. If a bearer with configured EARP is created or updated, it will be excluded from throttling. A maximum of eight EARP values can be configured.
* : More than one of the previous keywords can be entered within a single command.
P-GW Only. Excludes all emergency events from throttling due to the peer's overload reduction-metric. While reducing messages towards the peer based on the overload information received from the peer, the P-GW will exclude events sent for emergency sessions.
Use this command to configure throttling behavior based on peer's overload reduction-metric by excluding some or all emergency events and/or messages with configured EARP. Message throttling applies only to initial messages. Triggered request or response messages should not be throttled since that would result in the retransmission of the corresponding request message by the sender.
If throttling behavior is configured, the profile can be associated with an S-GW or P-GW service. If a P-GW specific keyword is configured, and the profile is associated with an S-GW service, the S-GW will ignore the P-GW specific configuration. Only the parameters specific to S-GW or P-GW will be utilized.
The Overload Control Profile must be associated with a P-GW, S-GW, or SAEGW service using one of the following commands:
throttling-behavior emergency-events exclude
Configures the time, in seconds, that specifies how long the overload control information is valid.
Important |
GTP-C Overload Control Profile is a license-controlled feature. For more information, contact your Cisco account or support representative. |
P-GW
SAEGW
S-GW
Security Administrator, Administrator
Exec > Global Configuration > GTPC Overload Control Profile Configuration
configure > gtpc-overload-control-profile profile_name
Entering the above command sequence results in the following prompt:
[local]host_name(config-gtpc-overload-control-profile)#
validity-period seconds
default validity-period
Specifies the length of time during which the overload condition specified by the OCI IE is to be considered as valid, unless overridden by subsequent new overload control information.
seconds must be an integer from from 1 to 3600.
Default: 600
Use this command to configure how long the overload control profile information is valid.
If no validity-period is configured, the system will use the default setting.
The Overload Control profile must be associated with a P-GW, S-GW, or SAEGW service using one of the following commands:
validity-period 700
Configures weightage for various GTP-C Overload Control Profile parameters.
Important |
GTP-C Overload Control Profile is a license-controlled feature. For more information, contact your Cisco account or support representative. |
P-GW
SAEGW
S-GW
Administrator, Security Administrator
Exec > Global Configuration > GTPC Overload Control Profile Configuration
configure > gtpc-overload-control-profile profile_name
Entering the above command sequence results in the following prompt:
[local]host_name(config-gtpc-overload-control-profile)#
weightage system-cpu-utilization percentage system-memory-utilization percentage license-session-utilization percentage
default weightage
Specifies that system memory, CPU, and license session utilization parameters are to be configured.
Important |
All parameters must be specified. The total weightage for all parameters should be 100%. The total of all three parameters cannot exceed 100%. |
Specify the desired system CPU utilization weightage as a percentage of 100.
percentage must be an integer from 0 to 100.
Default: 40%
Specify the system memory utilization weightage as a percentage of 100.
percentage must be an integer from 0 to 100.
Default: 30%
Specify the license session utilization weightage as a percentage of 100.
percentage must be an integer from 0 to 100.
Default: 30%
Returns all settings to their default value.
Use this command to specify weightage for various GTP-C Overload Control Profile parameters. These parameters constitute the basic settings for this GTP-C Overload Control Profile. Communication of these parameters indicate to peers when this network element is becoming or being overloaded. When this occurs, the NE will be able to instruct its peers to gracefully reduce its incoming signalling load by instructing the peers to reduce sending traffic according to its available signalling capacity to successfully process the traffic. A GTP-C entity is in overload when it operates over its signalling capacity, which results in diminished performance (including impacts to handling of incoming and outgoing traffic).
Use the inclusion-frequency command in GTP-C Overload Profile Configuration mode to to determine the inclusion frequency of the Overload-Load control information IE that is sent to the peers to keep them up to date on the overload condition on this network element.
If no parameters are specified, the system will use the default settings.
The Overload Control profile must be associated with a P-GW, S-GW, or SAEGW service using one of the following commands:
weightage system-cpu-utilization 30 system-memory-utilization 30 license-session-utilization 40