Updates specified active
charging option(s) for the matching sessions.
Privilege
Security Administrator,
Administrator, Operator, Inspector
Mode
Exec
The following prompt
is displayed in the Exec mode:
[local]host_name#
Syntax
update active-charging { override-control rulebase-config | switch-to-fw-and-nat-policy fw_nat_policy_name | switch-to-rulebase rulebase_name | switch-to-tpo-policy tpo_policy_name } { all | callid call_id | fw-and-nat-policy fw_nat_policy_name | imsi imsi | ip-address ip_address | msid msid | rulebase rulebase_name | tpo-policy tpo_policy_name | username user_name } [ -noconfirm ] [ | { grep grep_options | more } ]
override-control rulebase-config
This keyword initiates
batch processing of all active calls to apply Override Control (OC)
or Inheritance after any rulebase changes, charging action changes
and/or addition/deletion of ruledefs for all subscribers
having OC or Inheritance feature enabled. Since this is the batch processing
of all active calls, the command execution will be in the background
even after the CLI command returns to the CLI prompt.
Important |
Override Control is a license-controlled
feature. A valid feature license must be installed prior to configuring
this feature. For more information on the licensing requirements,
contact your Cisco account representative. For more information
on the command to enable this feature, refer to ACS Rulebase
Configuration Mode Commands chapter in the Command Line Interface Reference.
|
Important |
In this release, both Inheritance and
the Override Control features are supported. Note that these two
features should not be enabled simultaneously. If by mistake, these
two features are enabled, only Override Control is applied.
|
In 17 and later releases,
this CLI command is used to apply the overridden or inherited values
after any ruledef, charging action and rulebase changes performed
through the CLI commands in the respective configuration modes.
This CLI command is necessary because the configuration changes
are reflected immediately on any new PDN session that gets established. However,
for the existing PDN sessions established before the configuration
change, explicit execution of this CLI command is necessary. This
will get all the PDN sessions in system in sync with respect to
the required configuration changes.
Important |
It
is recommended that this CLI command is executed after all rulebase/charging
action/ruledef changes are complete. So, this will help
in one-time execution of the CLI to get all PDN sessions in sync.
|
Typically, this command
is used whenever any rulebase, charging action or ruledef modification
happens. Once this CLI command is executed, each subscriber will
read the configuration and incorporate the rulebase or ruledef changes
for Override Control. Until this CLI execution is complete, Inheritance
or Override Control values will not be applied to the changes done
in configuration for all existing calls. Charging and policy parameters
configured at P-GW will apply during this period. Please follow
recommended upgrade procedures to avoid this. For the upgrade procedure,
contact your Cisco account representative.
In release 17,
the batch processing will complete in 15 to 20 minutes depending
on the call load in the system. In 18 and later
releases, batch processing will complete in 1 to 3 minutes depending
on the call load in the system.
If the override-control rulebase-config command has
been issued multiple times, batch processing will be restarted and
the latest rulebase/charging action/ruledef changes
will be applied to all the active calls.
Important |
In
release 17, there was no restriction on the usage of the CLI command "update
active-charging override-control rulebase-config " on
a standby chassis. In release 18 and later, this CLI command is
not allowed to be executed on the standby chassis.
|
switch-to-fw-and-nat-policy fw_nat_policy_name
Specifies an existing
Firewall-and-NAT policy to switch to as an alphanumeric string of
1 through 63 characters.
switch-to-rulebase rulebase_name
Specifies an existing
rulebase to switch to as an alphanumeric string of 1 through 63 characters.
switch-to-tpo-policy tpo_policy_name
Important |
The Traffic Performance
Optimization (TPO) in-line service is not supported in this release.
|
all
Updates rulebase/policy
for all subscribers.
callid call_id
Updates rulebase/policy
for the Call Identification number specified as an eight-digit hexadecimal
number.
fw-and-nat-policy fw_nat_policy_name
Updates the rulebase/policy
for sessions matching an existing Firewall-and-NAT policy specified
as an alphanumeric string of 1 through 63 characters.
imsi imsi
Updates rulebase/policy
for International Mobile Subscriber Identification (IMSI) specified here.
imsi must
be 3 digits of MCC (Mobile Country Code), 2 or 3 digits of MNC (Mobile
Network Code), and the rest with MSIN (Mobile Subscriber Identification Number).
The total should not exceed 15 digits. For example, 123-45-678910234
can be entered as 12345678910234.
ip-address iP_address
Updates rulebase/policy
for the IP address specified in IPv4 dotted-decimal or IPv6 colon-separated-hexadecimal
notation.
msid msid
Updates rulebase/policy
for an MSID specified as a string of 1 through 24 characters.
rulebase rulebase_name
Updates rulebase/policy
for sessions matching an existing rulebase specified as an alphanumeric
string of 1 through 63 characters.
tpo-policy tpo_policy_name
Important |
The Traffic Performance
Optimization (TPO) in-line service is not supported in this release.
|
username user_name
Updates rulebase/policy
for user specified as a an alphanumeric of characters and/or wildcard
characters ('$' and '*') of 1 through 127 characters.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
| { grep grep_options | more }
Pipes (sends) the output
of this command to the specified command. You must specify a command
to which the output of this command will be sent.
For details on the
usage of grep and more , refer
to the Regulating a Command's Output section of the Command
Line Interface Overview chapter in the Command Line Interface Reference.
Usage Guidelines
Use this command to
change specified active charging option(s) for the matching sessions.
Example
The following command
changes the rulebase for sessions using the rulebase named standard to
use the rulebase named super :update active-charging switch-to-rulebase super rulebase standard
Feedback