P-GW Service Configuration Mode Commands

The P-GW (PDN Gateway) Service Configuration Mode is used to create and manage the relationship between specified services used for either GTP or PMIP network traffic.


Mode:

Exec > Global Configuration > Context Configuration > P-GW Service Configuration

configure > context context_name > pgw-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-pgw-service)#

IMPORTANT:

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

associate

Associates the P-GW service with specific pre-configured services and/or policies configured in the same context.

Product:

P-GW

SAEGW


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration > P-GW Service Configuration

configure > context context_name > pgw-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-pgw-service)#

Syntax
associate { egtp-service name [ lma-service name ] | ggsn-service name | lma-service name [ egtp-service name ] | peer-map map_name ] | qci-qos-mapping name }no associate { egtp-service | lma-service | peer-map | qci-qos-mapping }
no

Removes the selected association from this service.

egtp-service name [ lma-service name ] | lma-service name [ egtp-service name ]

egtp-service name [ lma-service name ]: Specifies that the P-GW service is to be associated with an existing eGTP service within this context.

name must be an alphanumeric string of 1 through 63 characters and be an existing eGTP service.

Configure an associated LMA service name to support handoffs between PMIPv6 and GTP. name must be an alphanumeric string of 1 through 63 characters and be an existing LMA service.

lma-service name [ egtp-service name ]: Specifies that the P-GW service is to be associated with an existing LMA service within this context.

name must be an alphanumeric string of 1 through 63 characters and be an existing LMA service.

Configure an associated eGTP service name to support handoffs between PMIPv6 and GTP. name must be an alphanumeric string of 1 through 63 characters and be an existing eGTP service.

ggsn-service name

Specifies that the P-GW service is to be associated with an existing GGSN service within this context.

name must be an alphanumeric string of 1 through 63 characters and be an existing GGSN service.

peer-map map_name

Specifies that the P-GW service is to be associated with an existing peer map within this context.

map_name must be an alphanumeric string of 1 through 63 characters and be an existing peer map.

Refer to the LTE Policy Configuration Mode Commands chapter for more information on peer map creation.

qci-qos-mapping name

Specifies that the P-GW service is to be associated with an existing QCI-QoS mapping configuration within this context.

name must be an alphanumeric string of 1 through 63 characters and be an existing QCI-QoS mapping configuration.

QCI-Qos mapping is typically configured in a AAA context. Refer to the QCI-QoS Mapping Configuration Mode Commands chapter for more information.

IMPORTANT:

If a GGSN service is associated with a P-GW service, then the GGSN service will use the QCI-QoS mapping tables specified in the qci-qos-mapping command and assigned to its associated P-GW service.


Usage:

Use this command to associate the P-GW service with other pre-configured services and/or policies configured in the same context.


Example:
The following command associates this service with an eGTP service called egtp1:
associate egtp-service egtp1
authorize-with-hss

This command enables or disables subscriber session authorization via a Home Subscriber Server (HSS) over an S6b Diameter interface. This feature is required to support the interworking of GGSN with P-GW and HA.

Product:

P-GW

SAEGW


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration > P-GW Service Configuration

configure > context context_name > pgw-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-pgw-service)#

Syntax
authorize-with-hss [ egtp | lma [ s6b-aaa-group aaa-group-name | report-ipv6-addr ] | report-ipv6-addr ]
[ default | no ] authorize-with-hss
[ default | no ]

Disables the default authorization of subscriber over S6b interface. Resets the command to the default setting of “authorize locally” from an internal APN authorization configuration.

egtp

Enables S6b authorization for eGTP only.

lma

Enables S6b authorization for LMA only.

report-ipv6-addr

Enables the IPv6 address reporting through Authorization-Authentication-Request (AAR) towards the S6b interface.


Usage:

Use this command to enable/disable the authorization support for subscriber over S6b interface, which is used between P-GW and the 3GPP AAA to exchange the information related to charging, GGSN discovery, etc.

dns-client

Specifies the DNS client context to use for sending DNS queries.

Product:

P-GW

SAEGW


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration > P-GW Service Configuration

configure > context context_name > pgw-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-pgw-service)#

Syntax
dns-client context name[ default | no ] dns-client context
default

Returns the command to the default setting of targeting the DNS client in the context where the P-GW service resides.

no

Disables DNS queries.

context name

Specifies the name of the context where the DNS client is used for the resolution of PCSCF-FQDN received from S6b interface.

name must be an existing context expressed as an alphanumeric string of 1 through 79 characters.


Usage:

Use this command to specify the context where the DNS client resides to perform P-CSCF-FQDN resolution from the S6b interface.


Example:
The following command identifies the egress1 context as the context where the DNS client resides:
dns-client context egress1 
egtp

Configures handling of eGTP related procedures.

Product:

P-GW

SAEGW


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration > P-GW Service Configuration

configure > context context_name > pgw-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-pgw-service)#

Syntax
egtp { cause-code
temp-fail timeout sec retry retries | modify-bearer-cmd-negotiate-qos | overcharge-protection | sgw-restoration
session-hold timeout seconds }default egtp { cause-code
temp-fail | modify-bearer-cmd-negotiate-qos | overcharge-protection | sgw-restoration
session-hold }no egtp { cause-code
temp-fail | modify-bearer-cmd-negotiate-qos | overcharge-protection | sgw-restoration session-hold }
default

Resets the command to the default setting.

no

Disables the configuration statement.

cause-code temp-fail timeout sec retry retries

Enables EGTP Cause Code Handling for when the P-GW receives a temporary failure response from peer (cause code 110). All transactions that were moved to pending queue because of temporary cause failure would be reattempted after temporary failure timer expires.

After timer expiry, the P-GW informs PCRF about the transient failure. PCRF sends new RAR and CBR/MBR/UBR would succeed.

timeout sec: Specifies the time to wait (in seconds) before reattempting the Create Bearer Request (CBR)/Modify Bearer Request (MBR)/Update Bearer Request (UBR).

sec must be an integer from 1 to 100.

retry retries: Specifies the maximum number of retries. The P-GW discards CBR/MBR/UBR after the maximum number of retries are exceeded.

retries must be an integer from 1 to 4.

modify-bearer-cmd-negotiate-qos

This configuration only impacts the PGW QoS negotiation behavior when PCRF is unreachable or event trigger is not registered while handling Modify Bearer Command. By default, this configuration is disabled. When enabled, P-GW will always enforce old QoS values authorized by the PCRF. When disabled, the P-GW will always accept new QoS values (APN-AMBR/Def-EPS-Bearer-QoS) received in Modify Bearer Command.

overcharge-protection

Configures overcharging protection by temporarily not charging during loss of radio coverage. By default, this configuration is disabled.

sgw-restoration session-hold timeout seconds

Enables S-GW restoration functionality and configure session hold timeout on a P-GW service. By default, S-GW restoration is disabled.

seconds must be an integer from 1 to 3600.

Default: 0 (disabled).

On S-GW failure indication, P-GW shall check if S-GW restoration feature is enabled or not. If enabled, P-GW shall maintain all the affected sessions for session-hold timeout. After session-hold timeout, P-GW shall clear all the sessions which are not recovered yet.


Usage:

Use this command to configure the behavior of the P-GW/SAEGW for eGTP procedures.


Example:
The following command sets the temporary failure timer to 30 seconds and 2 retries:
egtp cause-code temp-fail
timeout 30 retry 2
The following command configures the P-GW to accept new QoS values from the modify bearer command while the PCRF is not reachable:
egtp modify-bearer-cmd-negotiate-qos
The following command enables S-GW restoration functionality and configures session hold timeout on a P-GW service:
sgw-restoration
session-hold timeout seconds
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.

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.

fqdn

Configures a Fully Qualified Domain Name for this P-GW service used in messages between the P-GW and a 3GPP AAA server over the S6b interface.

Product:

P-GW

SAEGW


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration > P-GW Service Configuration

configure > context context_name > pgw-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-pgw-service)#

Syntax
fqdn host domain_name realm realm_name[ default | no ] fqdn
default

Returns the command to the default setting of “null”.

no

Removes the configured FQDN from this service configuration.

host domain_name

Specifies the domain name of the P-GW service.

domain_name must be an alphanumeric string of 1 through 255 characters.

realm realm_name

Specifies the realm name of the P-GW service.

realm_name must be an alphanumeric string of 1 through 255 characters.


Usage:

Use this command to identify the P-GW service using an FQDN required when sending messages over the S6b interface to a 3GPP AAA server.

IMPORTANT:

In order to properly interact with other nodes in the network, the FQDN should be less than or equal to 96 alphanumeric characters.

Topology Matching (eHRPD only)

You may specify which P-GW you wish an HSGW interface to connect with by enabling topology matching within the FQDNs for both the HSGW service and P-GW service. Topology matching selects geographically closer nodes and reduces backhaul traffic for a specified interface.

The following optional keywords enable or disable topology matching when added to the beginning of an FQDN:
  • topon.interface_name.
    Beginning an FQDN with topon initiates topology matching with available HSGWs in the network. Once this feature is enabled, the rest of the FQDN is processed from right to left until a matching regional designator is found on a corresponding HSGW FQDN.
  • topoff.interface_name.
    By default, topology matching is disabled. If you enable topology matching for any interfaces within a node, however, all interfaces not using this feature should be designated with topoff.

Example:
The following command configures the FQDN for this P-GW service as 123abc.all.com with a realm name of all.com:
fqdn host 123abc.all.com
realm all.com
The following command configures this P-GW service with an FQDN that enables topology matching:
fqdn host topon.interface_name.pgw01.bos.ma.node.epc .mnc<value>.mcc<value>.3gppnetwork.org
realm node.epc.mnc.mcc.3gppnetwork.org

IMPORTANT:

The associated HSGW service must have a corresponding FQDN similar to the following:

topon.interface_name.hsgw01.bos.ma.node.epc.mncvalue.mccvalue.3gppnetwork.org
gx-li

Refer to the Lawful Intercept Configuration Guide for a description of this command.

newcall

Configures the P-GW to accept or reject requests for a static IP address if the address is already in use by another session.

Product:

P-GW

SAEGW


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration > P-GW Service Configuration

configure > context context_name > pgw-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-pgw-service)#

Syntax
newcall duplicate-subscriber-requested-address { accept | reject } no newcall duplicate-subscriber-requested-address
no

Returns the command to the default setting of “reject”.

duplicate-subscriber-requested-address { accept | reject }

Default: reject

accept: Specifies that the old session with the requested address will be ended to accept the new session with the same address.

reject: Specifies that the new session requesting the same address will be rejected.


Usage:

Use this command to configure the behavior of the P-GW service when receiving requests for static IP address already in use by other sessions.

IMPORTANT:

This command is only applicable to sessions using services supporting duplicate address abort. These services include HA, GGSN, and P-GW.


Example:
The following command allows for the acceptance of requests for static IP addresses already in use by other sessions:
newcall duplicate-subscriber-requested-address accept
plmn

Configures Public Land Mobile Network identifiers used to determine if a mobile station is visiting, roaming, or belongs to this network.

Product:

P-GW

SAEGW


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration > P-GW Service Configuration

configure > context context_name > pgw-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-pgw-service)#

Syntax
plmn id mcc number mnc number [ primary ]
id mcc number mnc number

mcc number: Specifies the mobile country code (MCC) portion of the PLMN identifier.

number is the PLMN MCC identifier and must be an integer from 100 through 999.

mnc number: Specifies the mobile network code (MNC) portion of the PLMN identifier.

number is the PLMN MNC identifier and can be configured to a 2- or 3-digit integer from 00 through 999.

primary

When multiple PLMN IDs are configured, the primary keyword can be used to designate one of the PLMN IDs to be used for the AAA attribute.


Usage:

The PLMN identifier is used to aid the P-GW service in the determination of whether or not a mobile station is visiting, roaming, or home. Multiple P-GW services can be configured with the same PLMN identifier. Up to five PLMN IDs can be configured for each P-GW Service.


Example:
The following command configures the PLMN identifier with an MCC of 462 and MNC of 02:
plmn id mcc 462 mnc 02
session-delete-delay

Configures a delay in terminating a session.

Product:

P-GW

SAEGW


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration > P-GW Service Configuration

configure > context context_name > pgw-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-pgw-service)#

Syntax
session-delete-delay
timeout [ msec ][ default | no ] session-delete-delay timeout
default

Resets the command to the default setting of 10000 milliseconds.

no

Disables the feature.

timeout msec

Default: 10000

Specifies the time to retain the session (in milliseconds) before terminating it.

msec must be an integer from 1000 to 60000.


Usage:

Use this command to set a delay to provide session continuity in break-before-make scenarios.


Example:
The following command sets the session delete delay to the default setting of 10,000 milliseconds:
session-delete-delay timeout
setup-timeout

Configures the maximum amount of time the P-GW service takes for creating a session.

Product:

P-GW


Privilege:

Security Administrator, Administrator


Mode:

Exec > Global Configuration > Context Configuration > P-GW Service Configuration

configure > context context_name > pgw-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-pgw-service)#

Syntax
setup-timeout setup_time
default setup-timeout
default

Configures the default guard timer value for session creation.

setup-time

Default: 60

Specifies the maximum amount of time taken by P-GW for service creation.

setup_time is measured in seconds and can be configured to an integer from 1 through 120.


Usage:

Use this command to limit the amount of time allowed for creating a session. If a “Create Session Request” is received and the setup-timeout is configured, the timer starts with the configured value. If the setup timeout is not configured, the timer starts with the default value of 60 seconds.


Example:
The following command allows a maximum of 120 seconds for creating a session:
setup-timeout 120