> APN Remap Table Configuration Mode
> APN Remap Table configuration mode provides the commands to configure parameters for multiple features related to APN handling, such as: Default APN, APN Remap, and Wildcard APN. APN remap table is a key element of the Operator Policy feature and a table is not usable (valid) until it has been associated with an operator policy (see Operator Policy Configuration Mode Commands chapter.)
> The SGSN supports a maximum of 1000 APN remap tables and each APN remap table supports a maximum of 100 APN remap entries. Multiple tables can be defined and stored but an operator policy and/or IMEI profile each only support association with a single (one) table per policy/profile configuration. The APN remap table associated with an IMEI profile will be used in IMEI override scenarios.
> When this mode is accessed, the command prompt should be similar to:
> [local]asr5000(apn-remap-table<table_id>)#
> apn-remap
> Create an entry in the APN remap table. This command is specific to the SGSN.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> apn-remap { network-identifier apn_net_id { new-ni new_apn_net_id | operator-identifier apn_op_id new-ni new_apn_net_id { new-oi new_apn_op_id | value-for-oi-mcc mcc | value-for-oi-mnc mnc } | value-for-ni-wc new_apn_net_id } | operator-identifier apn_op_id { new-oi new_apn_op_id | value-for-oi-mcc mcc | value-for-oi-mnc mnc } }
> no apn-remap { network-identifier apn_net_id | operator-identifier apn_op_id }
> no
> Delete the specified APN remap entry from the APN remap table.
> network-identifier apn_net_id
> Identify the ‘old’ APN network identifier that is being mapped for replacement.
> apn_net_id : Enter a string of 1 to 62 alphanumeric characters, including dots (.) and dashes (-) . Additionally, one wildcard character ( * ) can be included anywhere within the string.
> new-ni new_apn_net_id
> Use this keyword when no wildcard character is included in the ‘old’ APN network identifier.
> This keyword identifies the new (target) network identifier.
> new_apn_net_id : Enter a string of 1 to 62 alphanumeric characters, including dots (.) and dashes (-) .
> value-for-ni-wc new_apn_net_id
> Use this keyword when a wildcard character is included in the ‘old’ APN network identifier.
> This keyword identifies the information to replace the wildcard in the new APN network identifier.
> new_apn_net_id : Enter a string of alphanumeric characters, including dots (.) and dashes (-) . This string replaces the wildcard (*) specified in the apn_net_id. The two strings together must not exceed 62 alphanumeric characters.
> operator-identifier apn_op_id
> Identify the ‘old’ APN operator identifier that is being mapped for replacement.
> apn_op_id : Enter a string of 1 to 18 alphanumeric characters including dots (.). The entry must be in the following format, where # represents a digit: MNC###.MCC###.GPRS.
> Optionally, either one or two wildcard characters (*) can be entered. Wildcard characters can be used in place of one # or three # -- for example MNC1*.MCC*.GPRS.
> new-oi new_apn_op_id
> Use this keyword when no wildcard character is included in the ‘old’ APN operator identifier.
> This keyword identifies the new (target) operator identifier.
> new_apn_op_id : Enter a string of 1 to 18 alphanumeric characters including dots (.). The entry must be in the following format, where # represents a digit: MNC###.MCC###.GPRS.
> value-for-oi-mcc mcc
> Use this keyword when a wildcard character is included in the MCC portion of the ‘old’ APN operator identifier, for example MNC###.MCC*.GPRS.
> This keyword identifies the information to replace the wildcard in the new APN operator identifier.
> mcc : Enter 1 to 3 digits.
> value-for-oi-mnc mcc
> Use this keyword when a wildcard character is included in the MNC portion of the ‘old’ APN operator identifier, for example MNC*.MCC###.GPRS.
> This keyword identifies the information to replace the wildcard in the new APN operator identifier.
> mnc : Enter 1 to 3 digits.
> Usage
> Important: Entries in the APN remap table are only valid if the table is associated with an operator policy. The same table can then be associated with an IMEI profile as IMEI-specific remap entries are not supported.
> Use this command to define table entries in the APN remap table. Each entry can remap an ‘old’ APN network identifier (NI) or ‘old’ APN operator identifier (OI) to a new NI or OI. Mapping can be done one-to-one with a specific APN NI/OI mapped to a specific new APN NI/OI. Mapping can also be done with wildcards in the ‘old’ APN entry mapped to wildcard replacements to dynamically create ‘new’ identifiers.
> Example
> A one-to-one APN NI remap entry is illustrated by:
> apn-remap network-identifier 123abc.com new-ni 333CBC.com
> Create an entry with a wildcard so that part of an incoming APN NI will be replaced - for example, incoming “xyzabcpqr.com” becomes “xyzinternet2pqr.com”.
> apn-remap network-identifier xyz*pqr.com value-for-ni-wc internet2
> Replace any incoming APN NI with a new APN NI.
> apn-remap network-identifier * value-for-ni-wc newnet.com
> A one-to-one APN OI remap entry is illustrated by:
> apn-remap operator-identifier MNC423.MCC222.GPRS new-oi MNC123.MCC456.GPRS
> Replace any incoming APN OI with a new APN OI MNC123.MCC456.GPRS:
> apn-remap operator-identifier MNC*.MCC*.GPRS value-for-oi-mnc 123 value-for-oi-mcc 456
> apn-selection-default
> This command enables/disables and configures the Default APN feature for use when the normal APN selection process fails.
> Product
> MME, SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> apn-selection-default { first-in-subscription | 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
> 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 PDN type is used as the default APN 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, then it is expected that the wildcard APN be configured. If not, the activation will be rejected.
> network-identifier apn_net_id
> The network identifier will be used as the default APN name.
> apn_net_id: Enter a string of 1 to 62 alphanumeric characters, including 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: Enter a string of 1 to 62 alphanumeric characters, including dots (.) and dashes (-).
> fallback-to-first-in-subscription
> Uses the APN from the first subscription record when 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 selected APN.
> 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 : Enter a string of 1 to 62 alphanumeric characters, including dots (.) and dashes (-).
> Usage
> Important: The Default APN feature will only work if it is configured in an APN remap table entry and the table is associated to an IMEI profile.
> The default APN feature will be used in error situations when the SGSN cannot select a valid APN via the normal APN selection process. Within an operator policy, a default APN can be configured for the SGSN to:

> • | override a requested APN when the 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,

> • | 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 SGSN can provide the default APN as an alternate behavior to ensure that PDP context activation is successful.
> Example
> Enable default APN feature for APN HomeNet1:
> apn-selection-default network-identifier HomeNet1
> Enable use of a default APN if the DNS query fails:
> apn-selection-default network-identifier HomeNet1 require-dns-fail-wildcard
> blank-apn
> Enable the Blank APN feature and define the APN that will be used when no APN is requested. This command is specific to SGSN.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> blank-apn network-identifier apn_net_id
> no blank-apn
> no
> Removes the APN NI from the APN Remap Table configuration and disables the Default APN feature.
> network-identifier apn_net_id
> Identify the APN network identifier that will be used when no APN is requested.
> apn_net_id : Enter a string of 1 to 62 alphanumeric characters, including dots (.) and dashes (-) .
> Usage
> Use this command to enable the Blank APN feature.
> Example
> Create an entry that supplies the starnet.com as the APN network identifier whenever a request does not include an APN:
> blank-apn network-identifier starnet.com
> cc
> The cc command defines the charging characteristics to be applied for CDR generation. This command is specific to the SGSN.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> cc { behavior-bit no-records bit_value | local-value behavior bit_value profile index_bit | prefer { hlr-value | local-value } }
> no cc behavior-bit no-records
> remove cc { behavior-bit no-records | local-value | prefer }
> no
> Disables the configuration for the charging characteristics behavior bit in the APN remap table.
> remove
> Removes the configured charging characteristics from this operator policy.
> behavior-bit no-records bit_value
> Default: Disabled
> Specify that which behavior bit in charging characteristic is used to no accounting records will be generated. no-records to indicate which behavior bit in charging characteristics, means that no accounting records should be generated.
> If we use a charging characteristics with the no-records bit set, then we won’t generate any accounting records, regardless of what may be configured elsewhere. Use “no” to indicate that there is no such bit.
> bit_value must be an integer value from 1 through 12.
> local-value behavior bit_value profile index_bit
> Default: bit_value = 0x0
> index_bit = 8
> This keyword sets the SGSN operator policy to configure the value of the behavior bits and profile index for the charging characteristics when the HLR does not provide value for this.
> If the HLR provides the charging characteristics with behavior bits and profile index and operator want to ignore it, then specify prefer local-value keyword with this command.
> bit_value must be a hexadecimal value between 0x0 and 0xFFF.
> index_bit must be an integer value from 1 through 15.
> Some of the index values are predefined according to 3GPP standard:

> • | 1 for hot billing

> • | 2 for flat billing

> • | 4 for prepaid billing

> • | 8 for normal billing

> prefer
> Default: hlr-value
> Specifies preference for using charging characteristics settings received from HLR or set by SGSN locally.

> • | hlr-value: Sets the operator policy to use charging characteristics settings received from HLR. This is the default preference.

> • | local-value: Sets the operator policy to use charging characteristics settings from SGSN only. If no charging characteristics received from HLR then local value will be applicable.

> Usage
> Use this command to set the behavior for charging characteristics either from an HLR or locally from the SGSN.
> These charging characteristics parameters are also configurable in the APN profile configuration mode too. For generation of M-CDRs, the parameters configured in this mode will prevail but for generation of S-CDRs the parameters configured in the APN profile configuration mode will prevail.
> The first four bits of charging characteristics (use keyword profile) is for the charging trigger profile index and is used to select different charging trigger profiles.
> The 12 behavior bits (with keyword local-value behavior) can to enable or disable the CDR generation.
> Example
> The following command creates a configuration that instructs the SGSN not to use records for charging characteristics and to set the behavior bit to 2:
> cc behavior-bit no-records 2
> description
> Define a string that describes the particular APN remap table.
> Product
> MME, SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> description description
> no description
> no
> Removes the description configuration from this APN Remap Table configuration.
> description
> Enter an alphanumeric string of 1 to 100 alphanumeric characters. The string may include spaces, punctuation, and case-sensitive letters if the string is enclosed in double quotes ( “ ).
> Usage
> Define information that identifies this particularly APN remap table.
> Example
> description “APN_remap1 replaces all MNC1## Ids.”
> 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.
> wildcard-apn
> Enable/disable the Wildcard APN feature and define the APN to be used in case a wildcard APN is included in the subscriber record.
> Product
> MME, SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> wildcard-apn pdp-type { ipv4 | ipv6 | ppp } network-identifier apn_net_id
> no wildcard-apn pdp-type pdp-type
> no
> Removes the wildcard-apn definition from the configuration.
> pdp-type { ipv4 | ipv6 | ppp }
> Specified the PDP type.

> • | ipv4 - for an ipv4 context

> • | ipv6 - for an ipv6 context

> • | ppp - for a PPP context

> network-identifier apn_net_id
> Must be one of the APN network identifiers specified with the apn command in the Operator Policy configuration mode.
> apn_net_id must be a string of 1 to 62 alpha and/or numeric characters, including dots (.) and dashes (-), to define the network identifier.
> Usage
> This command is used to define a wildcard APN with the type of PDP context and the APN’s network ID. This wildcard APN would be used when an APN is not identified.
> Important: Wildcard APN feature configuration is only valid if the APN remap table is associated with at least one operator policy. The same table can then be associated with an IMEI profile as IMEI-specific Wildcard APN is not supported.
> Example
> Use this command to create an APN wildcard:
> wildcard-apn pdp-type ipv4 network-identifier homer1

Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883