Enables and
configures or disables the Default APN feature for use when the normal APN
selection process fails.
Privilege
Security
Administrator, Administrator
Mode
Exec > Global
Configuration > APN Remap Table Configuration
configure > apn-remap-table
table_name
Entering the above
command sequence results in the following prompt:
[local]host_name(apn-remap-table_name)#
Syntax
Syntax Description
apn-selection-default { first-in-subscription [ orig-apn ] | lowest-context-id [ orig-apn ] | network-identifier apn_net_id [ fallback-apn network-identifier apn_net_id | fallback-to-first-in-subscription | prefer-single-subscription | reject-blank-apn | require-dns-fail-wildcard [ orig-apn ] | require-subscription-apn ] + }
no apn-selection-default { first-in-subscription | lowest-context-id | network-identifier apn_net_id }
no
Delete the
configuration statement and disable the default APN feature.
first-in-subscription
[ orig-apn
]
Specifies that the
first APN in the subscription record matching the requested PDN type is used as
the default APN. This applies when normal APN selection fails and if the UE APN
is absent and the defined default APN is not a match.
For the SGSN,
"first-in-subscription" means the first record from the list of records sent
from the HLR (in the same order) with PDP type matching the requested PDP type.
With this configuration, if the first record is a wildcard APN it is expected
that the wildcard APN be configured. If not, the activation will be rejected.
For MME, if the
default APN in the subscription data matches the requested pdn-type, then the
default APN is used. Otherwise, the first record from the list of records
(apn-list) sent from the HSS with PDP type matching the UE-requested PDP type
is selected. The apn-list is sorted according to apn-name.
orig-apn:
Enables MME to send the original APN (UE requested APN) in the ATTACH_ACCEPT or
ACTIVATE_DEFAULT_BEARER_REQUEST message to the UE. This is an optional keyword.
If this keyword is not configured, then re-mapped APN is sent
back to UE.
lowest-context-id
[ orig-apn
]
Specifies that the
subscription APN with the lowest context-ID in the subscription record matching
the PDN type is used as the default APN when normal APN selection fails.
With this
configuration, if the record with the lowest context-ID is a wildcard APN, then
it is expected that the wildcard APN has already been configured. If not, the
activation will be rejected.
If both
apn-selection-default
lowest-context-id and
apn-selection-default
first-in-subscription options are configured, whichever command
was executed (configured) first will be the behavior used.
Starting with
Release 14.0, MME also supports use of this keyword.
orig-apn:
Enables MME to send the original APN (UE requested APN) in the ATTACH_ACCEPT or
ACTIVATE_DEFAULT_BEARER_REQUEST message to the UE. This is an optional keyword.
If this keyword is not configured, then remapped APN is sent
back to UE.
network-identifier apn_net_id
Specifies the network identifier will be used as the default APN name. apn_net_id is a string of 1 through 62 characters, including digits, letters, dots (.) and dashes (-).
In 21.4 and later releases, this keyword is enhanced to support S4-SGSN.
Any of the following
optional keywords can be used with
network-identifier as qualifications.
fallback-apn network-identifier apn_net_id
SGSN only.
Specifies a dummy
APN to be used when the default APN is not present in the subscription so that
the activation does not fail. With this keyword configured, the context is
activated with a dummy APN and the GGSN displays a static page for this APN,
instructing the subscriber to subscribe for appropriate services.
apn_net_id is a string of 1 to 62 characters,
including letters, digits, dots (.) and dashes (-).
fallback-to-first-in-subscription
SGSN only.
Uses the APN from
the first subscription record when the configured default APN is not available.
prefer-single-subscription
SGSN only.
Uses the APN from
the subscription record if it is the only record available and normal APN
selection fails.
reject-blank-apn
SGSN only.
Disables use of the
default APN if a blank APN is received.
require-dns-fail-wildcard
[ orig-apn
]
MME only.
Enables the default
APN to be used if the DNS query fails with the requested APN.
orig-apn:
Enables MME to send the original APN (UE requested APN) in the ATTACH_ACCEPT or
ACTIVATE_DEFAULT_BEARER_REQUEST message to the UE. This is an optional keyword.
If this keyword is not configured, then remapped APN is sent
back to UE.
In 18.2 and later releases: The require-dns-fail-wildcard keyword is also supported by the MME.
In releases prior to 21.4: The require-dns-fail-wildcard keyword is not supported for S4-SGSN.
In 21.4 and later releases: The require-dns-fail-wildcard keyword is supported for S4-SGSN.
require-subscription-apn
network-identifier
apn_net_id
SGSN only.
If defined, this APN
name must also be included in the subscription data for the default APN feature
to function.
apn_net_id is a string of 1 to 62 characters,
including letters, digits, dots (.) and dashes (-).
Usage Guidelines
The default APN
feature will be used in error situations when the MME or the SGSN cannot select
a valid APN via the normal APN selection process. Within an operator policy, an
APN remap table with a default APN can be configured for the MME/SGSN to:
-
override a
requested APN when the HSS/HLR does not have the requested APN in the
subscription profile.
-
provide a viable
APN if APN selection fails because there was no "requested APN" and wildcard
subscription was not an option.
The default APN
feature can also be used in the event of a DNS query failure with the selected
APN, if:
-
the
wildcard-apn
command is configured, (requirement only for SGSN)
-
a wildcard
subscription is present,
-
the
require-dns-fail-wildcard keyword is included with
the
apn-selection-default command then the configured
default APN will be used when the DNS query is retried.
In all of the
instances outlined above, the MME/SGSN can provide the default APN as an
alternate behavior to ensure that PDP context activation is successful.
Important: For SGSN ONLY - Beginning
with Release 16, customers already using an APN remap table that is associated
with an IMEI profile
will have to
change the existing configuration
to enable the default APN remapping associated with an operator
policy rather than the one associated with an IMEI profile. For example, if an
existing configuration forced all matching IMEI in a defined IMEI range to use
xxx.net APN, the configuration needs to be changed to an APN remap table
configuration similar to what is shown below:
Old APN remap table
associated with an IMEI profile:
apn-selection-default network-identifier xxx.net
For a configuration to
accomplish the same remapping function, change the APN remap table
associated with an
IMEI profile to the following:
apn-remap network-identifier * new-ni xxx.net
Important: For SGSN ONLY - With
Release 16, an APN remap table associated with an IMEI profile overrides a
remap table associated with an operator policy. This means activation will be
rejected if a local default APN configured, in an APN remap table associated
with
an IMEI
profile, cannot be used. This will occur even if a valid local default APN
is available in an APN remap table associated with
an operator
policy.
For SGSN ONLY - Beginning
with Release 16, the following
sample
configuration will enable the operator to bypass APN remapping for a specific
IMEI range:
config
operator-policy name OpPol1
associate call-control-profile OpPol1CCprof1
associate apn-remap-table RemapOpPol1
imei-range first start_imei last ending_imei [ sv IMEI_sv ] imei-profile name IMEIprof1
exit
imei-profile name IMEIprof1
associate apn-remap-table remapIMEIprof1
exit
apn-remap-table remapIMEIprof1
exit
apn-remap-table RemapOpPol1
apn-selection-default network-identifier NewAPN.net
end
Example
The following
command enables the default APN feature for APN
HomeNet1
in an APN remap table associated with an operator policy:
apn-selection-default network-identifier HomeNet1
For SGSN only - Beginning
with Release 16, if the APN remap table is associated with an IMEI profile, for
a configuration to accomplish the same remapping function as noted in the
sample above, then use syntax similar to the following:
apn-remap network-identifier * new-ni xxx.net
The following
command, in an APN remap table associated with an operator policy,
enables use of a default APN selected on the basis of lowest context-ID if the
APN is not contained within the subscription:
apn-selection-default lowest-context-id
The following
command enables use of a default APN if the DNS query fails:
apn-selection-default network-identifier HomeNet1 require-dns-fail-wildcard