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 | lowest-context-id | 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 | 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
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 the MME, "first-in-subscription" means
the first record from the list of records (apn-list) sent
from the HSS with PDP type matching the UE-requested PDP
type. The apn-list is sorted according to apn-name.
lowest-context-id
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.
network-identifier apn_net_id
Specifies the network
identifier will be used as the default APN name as a string of 1
to 62 characters, including digits, letters, dots (.) and
dashes (-).
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
Uses the APN from
the first subscription record when the configured default APN is
not available.
prefer-single-subscription
Uses the APN from
the subscription record if it is the only record available and normal
APN selection fails.
reject-blank-apn
Disables use of the
default APN if a blank APN is received.
require-dns-fail-wildcard
Enables the default
APN to be used if the DNS query fails with the requested APN.
Starting
with Release 18.2, this keyword is also supported
by the MME.
require-subscription-apn network-identifier apn_net_id
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
Examples
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