Explore Cisco
How to Buy

Have an account?

  •   Personalized content
  •   Your products and support

Need an account?

Create an account

Command Line Interface Reference, Modes G - H, StarOS Release 21

Bias-Free Language

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.

Book Contents
Find Matches in This Book
Available Languages
Download Options

Book Title

Command Line Interface Reference, Modes G - H, StarOS Release 21

Chapter Title

GTPC Load Control Profile Configuration Mode Commands

Results

Updated:
October 27, 2016

Chapter: GTPC Load Control Profile Configuration Mode Commands

GTPC Load Control Profile Configuration Mode Commands

Load control enables a GTP-C entity (for example, an S-GW/P-GW) to send its load information to a GTP-C peer (e.g. an MME/SGSN, ePDG, TWAN) to adaptively balance the session load across entities supporting the same function (for example, an S-GW cluster) according to their effective load. The load information reflects the operating status of the resources of the GTP-C entity.

Mode

This chapter describes the GTPC Load Control Profile Configuration Mode commands.

Exec > Global Configuration > GTPC Load Control Profile Configuration

configure > gtpc-load-control-profile profile_name

Entering the above command results in the following prompt:

[local]host_name(config-gtpc-load-control-profile)#
Important:

Available commands or keywords/variables vary based on platform type, product version, and installed license(s).

end

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

Product

All

Privilege

Security Administrator, Administrator

Syntax

Syntax Description

end

Usage Guidelines

Use this command to return to the Exec mode.

exit

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

Product

All

Privilege

Security Administrator, Administrator

Syntax

Syntax Description

exit

Usage Guidelines

Use this command to return to the parent configuration mode.

inclusion-frequency

Configures parameters to determine the inclusion frequency of the Load Control Information IE for a GTP-C Load Control Profile configuration.

Product

Important:

GTP-C Load Control Profile is a license-controlled feature. For more information, contact your Cisco account or support representative.

P-GW

SAEGW

S-GW

Privilege

Administrator, Security Administrator

Mode

Exec > Global Configuration > GTPC Load Control Profile Configuration

configure > gtpc-load-control-profile profile_name

Entering the above command results in the following prompt:

[local]host_name(config-gtpc-load-control-profile)#

Syntax

Syntax Description

inclusion-frequency { advertisement-interval interval_in_seconds | change-factor change_factor  }
default inclusion-frequency  { advertisement-interval | change-factor }

inclusion-frequency

Specifies that parameters to determine the inclusion frequency of the Load Control Information IE for a GTP-C Load Control Profile configuration will be configured. The Load 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 this information to the peers.

advertisement-interval interval_in_seconds

Configures the advertisement-interval for Load Control in seconds. Specifies how often load control information should be sent to the peers. If configured to 0, the node will send load control information in each and every outgoing message to the peers.

interval_in_seconds must be an integer from 0 to 3600.

Default: 300

change-factor change_factor

Configures the change factor for Load Control. If the load control factor changes by the configured factor, whether it is an increase or decrease, the load control information should be sent to the peers. This information is only sent to the peers when the load factor changes by the factor configured.

change_factor must be an integer from 1 to 20.

Default: 5%

default

Returns configured parameters to their default value.

Usage Guidelines

Use this command to specify parameters to determine the inclusion frequency of the Load control information IE for a GTP-C Load Control Profile configuration. This IE reflects the current operating status of the network element based on the configured weightage parameters. The network element ensures that new/updated load control information is propagated to the target receivers within an acceptable delay, so that the purpose of the information (i.e., effective load balancing) is achieved.

The weightage command in GTP-C Load Control Profile Configuration Mode should also be configured along with the inclusion-frequency setting.

If this setting is not configured, the node will use the default setting.

The Load Control profile must be associated with a P-GW, S-GW, or SAEGW service using one of the following commands:

  • P-GW: associate command in P-GW Service Configuration Mode
  • S-GW: associate command in S-GW Service Configuration Mode
  • SAEGW: associate commands in both P-GW and S-GW Service Configuration modes

Examples

This example configures the inclusion-frequency advertisement-interval to 120 seconds.
inclusion-frequency  advertisement-interval 120

load-control-handling

Enables or disables the handling of GTP-C load control information provided to the MME and S-GW.

Product

Important:

GTP-C Load Control Profile is a licensed-controlled feature. For more information, contact your Cisco account or support representative.

P-GW

S-GW

SAEGW

Privilege

Administrator, Security Administrator

Mode

Exec > Global Configuration > GTPC Load Control Profile Configuration

configure > gtpc-load-control-profile profile_name

Entering the above command results in the following prompt:

[local]host_name(config-gtpc-load-control-profile)#

Syntax

Syntax Description

[ no ] load-control-handling { home | visited }
[ default ] load-control-handling

no

Disables load-control-handling for the specified option (home or visited).

default

Returns the load-control-handling feature to its default behavior (enabled).

load-control-handling

Enables load control handling for the specified option.

home

Enables load control handling information for the home PLMN.

visited

Enables/disables load control handling information for the visited PLMN.

Examples

Use this command to enable/disable the handling of load control information handling for the home or visited PLMN.

If no parameters are specified, the system will use the default settings.

The Load Control Profile must be associated with a P-GW, S-GW, or SAEGW service using one of the following commands:

  • P-GW: associate command in P-GW Service Configuration Mode
  • S-GW: associate command in S-GW Service Configuration Mode
  • SAEGW: associate commands in both P-GW and S-GW Service Configuration modes

Examples

This command enables load control handling for the home PLMN.
load-control-handling home

load-control-publishing

Enables/disables the publishing of GTP-C load control information.

Product

Important:

GTP-C Load Control Profile is a license-controlled feature. For more information, contact your Cisco account or support representative.

P-GW

S-GW

SAEGW

Privilege

Adminstrator, Security Administrator

Mode

Exec > Global Configuration > GTPC Load Control Profile Configuration

configure > gtpc-load-control-profile profile_name

Entering the above command results in the following prompt:

[local]host_name(config-gtpc-load-control-profile)#

Syntax

Syntax Description

[ no ] load-control-publishing { home | visited }
default load-control-publishing

no

Disables load control publishing for the specified option.

default

Returns load control publishing to its default behavior (enabled).

load-control-publishing

Enables the publishing of load control information towards the home or visited PLMN.

home

Enables load control publishing information for the home PLMN.

visited

Enables load control publishing information for the visited PLMN.

Usage Guidelines

Use this command to enable/disable load control information publishing for 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:

  • P-GW: associate command in P-GW Service Configuration Mode
  • S-GW: associate command in S-GW Service Configuration Mode
  • SAEGW: associate commands in both P-GW and S-GW Service Configuration modes

Examples

This command enables the publishing of load control information towards the visited peers.
load-control-publishing visited

threshold

Configures the minimum threshold value above which PGW-provided GTP-C load control information should be utilized for calculating the PGW effective weight during initial node selection.

Product

Important:

GTP-C Load Control Profile is a license-controlled feature. For more information, contact your Cisco account or support representative.

P-GW

S-GW

SAEGW

Privilege

Administrator, Security Administrator

Mode

Exec > Global Configuration > GTPC Load Control Profile Configuration

configure > gtpc-load-control-profile profile_name

Entering the above command results in the following prompt:

[local]host_name(config-gtpc-load-control-profile)#

Syntax

Syntax Description

threshold percentage
[ no ] threshold

threshold

Enables the configuration of the minimum threshold value above which PGW-provided load control information should be utilized for calculating the P-GW effective weight during initial node selection.

percentage

Enter the threshold setting as a percentage of 100%. The entry must be an integer from 1 to 100. The default setting is 50%.

no

Disables the configured threshold setting.

Usage Guidelines

Use this command to configure the minimum threshold value above which PGW-provided load control information should be utilized for calculating the P-GW effective weight during initial node selection.

The Load Control Profile must be associated with a P-GW, S-GW, or SAEGW service using one of the following commands:

  • P-GW: associate command in P-GW Service Configuration Mode
  • S-GW: associate command in S-GW Service Configuration Mode
  • SAEGW: associate commands in both P-GW and S-GW Service Configuration modes

Examples

This command sets the threshold to 60%.
threshold 60

weightage

Configures weightage for various GTP-C load control profile parameters.

Product

Important:

GTP-C Load Control Profile is a license-controlled feature. For more information, contact your Cisco account or support representative.

P-GW

SAEGW

S-GW

Privilege

Administrator, Security Administrator

Mode

Exec > Global Configuration > GTPC Load Control Profile Configuration

configure > gtpc-load-control-profile profile_name

Entering the above command results in the following prompt:

[local]host_name(config-gtpc-load-control-profile)#

Syntax

Syntax Description

weightage  system-cpu-utilization  percentage  system-memory-utilization  percentage  license-session-utilization  percentage
default weightage

weightage

Specifies that system memory, system CPU, and license session utilization parameters will be configured.

Important:

All parameters must be specified. The total of all three parameter settings should total, but not exceed, 100%.

system-cpu-utilization percentage

Specifies system CPU utilization weightage as a percentage of 100.

percentage must be an integer from 0 to 100.

Default: 40%

system-memory-utilization percentage

Specifies system memory utilization weightage as a percentage of 100.

percentage must be an integer from 0 to 100.

Default: 30%

license-session-utilization percentage

Specifies the license session utilization as a percentage of 100.

percentage must be an integer from 0 to 100.

Default: 30%

default weightage

Returns all parameters to their default settings.

Usage Guidelines

Use this command to set weightage percentages for system CPU, memory, and license session utilization as part of a GTP-C Load Control Profile configuration. These settings constitute the basic Load Control Profile for this network element. These parameters allow the P-GW/S-GW/SAEGW to send its load information to a peer GTP control plane node which the receiving GTP control plane peer node uses to augment existing GW selection procedure for the P-GW and S-GW. Load Information reflects the operating status of the resources of the originating GTP control plane node.

If no parameters are specified, the system will use the default settings.

Operators should also configure the inclusion-frequency command in GTP-C Load Control Profile Configuration mode to specify parameters to determine the inclusion frequency of the Load Control Information IE sent to peers for the GTP-C Load Control Profile configuration.

The Load Control Profile must be associated with a P-GW, S-GW, or SAEGW service using one of the following commands:

  • P-GW: associate command in P-GW Service Configuration Mode
  • S-GW: associate command in S-GW Service Configuration Mode
  • SAEGW: associate commands in both P-GW and S-GW Service Configuration modes

Examples

The following example configures system-cpu-utilization at 30%, system-memory utilization at 40%, and license-utilization at 30%.
weightage  system-cpu-utilization  30  system-memory-utilization  40  license-session-utilization  30

Was this Document Helpful?

FeedbackFeedback

Contact Cisco