Exec Mode Commands
(A-C)
This section
includes the commands aaa
test through crypto-group.
The Exec Mode is the
initial entry point into the command line interface system. Exec
mode commands are useful in troubleshooting and basic system monitoring.
IMPORTANT:
The commands or keywords/variables
that are available are dependent on platform type, product version,
and installed license(s).
aaa test
Tests Authentication,
Authorization and Accounting (AAA) functionality between this system
and a remote server.
Product:
PDSN, HA
, GGSN, SGSN, ASN-GW
Privilege:
Security Administrator,
Administrator, Operator
Syntax
aaa test { accounting
username user_name | authenticate user_name password | session user_name
password }
accounting username user_name
Tests RADIUS
or GTPP accounting
functionality for the specified user.
user_name must
be the name of a user configured on the RADIUS or CFG server.
IMPORTANT:
GTPP is used only
in conjunction with the GGSN or SGSN product.
authenticate user_name password
Tests RADIUS authentication
functionality for the specified user.
user_name is
the name of a user configured on the RADIUS server. password is
the user’s password.
session user_name password
Tests both RADIUS
authentication and RADIUS
or
GTPP accounting functionality for the specified user.
user_name is
the name of a user configured on the RADIUS server. password is
the user’s password.
IMPORTANT:
GTPP is used only
in conjunction with the GGSN or SGSN product.
Usage:
This command is used
to test RADIUS-based authentication and RADIUS
or GTPP accounting.
This command may be useful for diagnosing problems with subscribers
and access to the system and/or billing data.
Example:
The following command
verifies accounting for a user named
user1:
aaa test accounting
username user1
The following command
tests authentication for a user named
user1 with
the password
abc123:
aaa test authentication
user1 abc123
The following command
tests both accounting and authentication for the user named
user1 with
the password
abc123:
aaa test session user1 abc123
abort
Stops software patch
or upgrade process.
Privilege:
Security Administrator,
Administrator
Syntax
abort { patch | upgrade } [ -noconfirm ]
patch
Stops a running software
patch process.
upgrade
Stops a running software
upgrade process.
IMPORTANT:
The abort upgrade command
can only be used during Stage 1 (busy-out) of an on-line software
upgrade.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
Usage:
Use this command to
stop a running StarOS patch or upgrade process. For additional information
on software patches and upgrades, refer to the System Administration Guide.
Example:
The following command
stops an in-progress StarOS upgrade:
abort upgrade
active-charging
service
Creates an active
charging service (ACS).
Privilege:
Security Administrator,
Administrator, Operator
Syntax
active-charging service ecs_service_name [ -noconfirm ]
ecs_service_name
Specifies name of
the active charging service.
ecs_service_name must
be an alphanumeric string of 1 through 15 characters.
If the named service
does not exist, it is created and the CLI mode changes to the ACS Configuration
Mode wherein the service can be configured.
If the named service
already exists, the CLI mode changes to the ACS Configuration mode wherein
the specified active charging service can be configured.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
Usage:
Use this command to
create an active charging service in the system. This command can be
used directly in Exec Mode after issuing the require active-charging command
in the Global Configuration Mode.
This command allows
an operator (rather than security administrators and administrators) to
configure the ACS functionality only.
On entering this command,
the CLI prompt changes to:
[context_name]hostname(config-acs)#
IMPORTANT:
Operators need special
CLI privilege for ACS functionality to be able to use this CLI command.
Example:
The following command
creates an active charging service named
test:
active-charging service test
alarm
Disables the internal
audible alarm on the system management card.
Privilege:
Security Administrator,
Administrator, Operator
Usage:
Alarm cutoff disables
the audible alarm. The alarm may be enabled following this command
if an event within the system results in the audible alarm being enabled.
aps
Allows the operator
to perform SONET Automatic Protection Switching (APS) administrative
operations.
IMPORTANT:
Use of this command
is limited to the OLC2 and the CLC2 line cards.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
aps { clear slot#/port# | exercise slot#/port# | lockout slot#/port# | switch { force | manual } slot#/port# }
clear slot#/port#
Clears the last switch
command on the specified channelized port.
slot#/port# is
the CLC2/OLC2 slot number (valid range is 17 - 48) and
appropriate port number (CLC2 valid range is 1 - 4; OLC2 valid value
is 1).
exercise slot#/port#
Tests the APS protocol
on line connected to port.
slot#/port# is
the CLC2/OLC2 slot number (valid range is 17 - 48) and
appropriate port number (CLC2 valid range is 1 - 4; OLC2 valid value
is 1)
lockout slot#/port#
Prevents the working
port from switching to the protection port.
slot#/port# is
the CLC2/OLC2 slot number (valid range is 17 - 48) and
appropriate port number (CLC2 valid range is 1 - 4; OLC2 valid value
is 1)
switch { force | manual } slot#/port#
Switch to either the
working port or the protection port:
- force: Forces
a switch of ports, even if there is an active alarm state.
- manual: Implements
a switch of ports if there are no active alarms.
slot#/port# is
the CLC2/OLC2 slot number (valid range is 17 - 48) and
appropriate port number (CLC2 valid range is 1 - 4; OLC2 valid value
is 1)
Usage:
This command allows
an operator to perform administrative/maintenance APS tasks
such as testing the APS protocol, switching the working port to
the protection port, and locking out the switching function.
Example:
The following command
starts an APS protocol test on port 2 of card 27:
aps exercise 27/2
autoconfirm
Enables or disables
confirmation for certain commands. This command affects the current
CLI session only.
IMPORTANT:
Use the autoconfirm command
in the Global Configuration Mode to change the behavior for all
future CLI sessions.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
autoconfirm
no autoconfirm
Usage:
When autoconfirm is
enabled, certain commands ask you to answer yes or no to confirm
that you want to execute the command. When autoconfirm is
disabled, the confirmation questions never appear. Disabling autoconfirm is
active for the current session only.
By default autoconfirm is
enabled.
Example:
The following command
enables command confirmation:
autoconfirm
The following command
disables command confirmation for the duration of the current CLI session:
no autoconfirm
bulkstats force
Manages the collection
and delivery of system statistics (bulkstats) to the configured
server.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
bulkstats force { gather | transfer }
gather
Immediately collects
the system statistics.
transfer
Immediately sends
the currently collected statistics to the configured server.
Usage:
When the current system
statistics are desired immediately as opposed to the normal scheduled
collection and delivery intervals issue this command.
Troubleshooting the
system may require the review of statistics at times when the scheduled
delivery is not timely.
Example:
The following causes
the chassis to immediately collect system statistics. This would
be in anticipation of a transfer command.
bulkstats force gather
The following command
causes the chassis to immediately send all collected statistics
to the configured server.
bulkstats force transfer
call-home send
Manages how Cisco
Smart Call Home messages are sent to alert groups.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
call-home send alert-group { configuration profile profile name | inventory profile profile name }
configuration profile profile name
Sends configuration
messages to the previously defined profile, expressed as an alphanumeric
string of 1 through 31 characters.
inventory profile profile name
Sends inventory messages
to the previously defined profile, expressed as an alphanumeric string
of 1 through 31 characters.
Usage:
Use this command to
send specified alert-group call-home message from the CLI to all profiles
subscribed to the specified alert group, or to a specified profile
which does not need to be subscribed to the specified alert-group.
For additional information, refer to the Call-Home Configuration
Mode Commands and Call-Home
Profile Configuration Mode Commands chapters.
Example:
The following command
sets the system to send configuration related call-home messages
to the profile named
Profile1.
call-home send alert-group
configuration profile Profile1
call-home test
Sends a test Smart
Call Home event message to a specified profile.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
call-home test message { test_message_content | profile profile name }
call-home test message
message test_message_content
Defines the message
to send to the defined profile as an alphanumeric string of 1 through 128
characters.
profile profile_name
Specifies the previously
defined profile to which the message will be sent, expressed as
an alphanumeric string of 1 through 31 characters.
Usage:
Use this command to
send test call-home messages from the CLI to a specified profile.
If a message is not specified, the system sends out a default message.
Example:
The following command
sets the system to send a test call-home message
Test_Message_1 to
the profile named
Profile1.
call-home test message
Test_Message_1 profile Profile1
card busy-out
Moves processes from
the source packet processing card to the destination packet processing
card, or disables the packet processing card from accepting any
new calls. When busy-out is enabled, the packet processing card
stops receiving new calls but continues to process calls until they
are completed. The command prompt is returned once the command is initiated.
The busy-out procedure is completed in background.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
card busy-out { migrate
from src_slot to dst_slot } [ -noconfirm ]
no card busy-out
no
Disables busy-out.
The packet processing card is re-enabled to accept new calls.
migrate from src_slot to dst_slot
Moves processes from
the specified source packet processing card to the specified destination
packet processing card. The command prompt is returned once the
command is initiated. The card migration is completed in background.
src_slot indicates
the source slot number of the card from which processes will be
migrated. dst_slot indicates
the destination slot number of the card to which processes will
be migrated.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
Usage:
Migrating a packet
processing card changes the active/standby status of a
packet processing card. This results in the active sessions/processes
being moved to the newly active card. This is useful when there
is a maintenance activity on the active card which requires removing
the card from service.
The destination slot
specified must contain a packet processing card which is in the standby
state for the command to complete successfully.
CAUTION:
Be cautious when executing
this command. Depending on the number of active sessions being migrated,
some subscribers may experience service interruptions.
Using busy-out to
refuse new calls on a packet processing card allows you to take
a card out of service without any interruptions to the end user.
An individual system can be taken completely out of service gracefully
by enabling busy-out on all packet processing cards and waiting
for current calls to complete. The show card info command
shows if busy-out is enabled.
IMPORTANT:
When a packet processing
card fails, is migrated, or is restarted for any reason, busy-out
is reset to disabled, the default behavior.
IMPORTANT:
This command is not
supported on all platforms.
Example:
The following command
migrates the active processes from the packet processing card in slot
12 to the
card in slot
14.
This command executes after you provide confirmation of the request.
card migrate from
12 to 14
The following command
migrates the active processes from the packet processing card in slot
1 to the
card in slot
8.
This command executes after you provide confirmation of the request.
card migrate from
1 to 8
The following command
sets the packet processing card in slot 1 to stop accepting new
calls:
card busy-out 1
card halt
Halts all StarOS processes
on a card. A card reboot command
must be issued to bring the card back into service after it is halted.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
card halt slot_num [ -force ] [ -noconfirm ]
slot_num
Indicates the slot
number of the card of interest.
-force
Over-rides any warnings
to force the card to be halted.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
Usage:
Halt a card to stop
the card for maintenance or emergency situations.
CAUTION:
Caution should be
taken in using this command. Halting a card which has no redundant
card available may cause a service interruption and loss of active
sessions.
CAUTION:
The -force and -noconfirm options
should only be used concurrently by experienced users as this will
cause an immediate halt regardless of warnings and no confirmation
from the user.
IMPORTANT:
This command is not
supported on all platforms.
Example:
The following command
temporarily stops the card in slot 1.
card halt 1
The following commands
force the card to halt and indicate no confirmation is to take place, respectively.
card halt 1 -force
-noconfirm
card halt 1 -noconfirm
card migrate
Migrates StarOS processes
from an active packet processing card to a standby packet processing
card.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
card migrate from
src_slot to dst_slot [ -noconfirm ]
src_slot
Indicates the slot
number of the packet processing card from which processes will be migrated. The packet processing
card in this slot must be in Active mode.
dst_slot
Indicates the slot
number of the packet processing card to which processes will be migrated.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
Usage:
This command allows
an operator to move processes from an active to a standby packet processing
card.
Example:
The following will
cause processes currently running on the card in slot 8 to migrate
to the standby card in slot 9. The migration will not occur if any
warnings are generated.
card migrate from
8 to 9
card reboot
Resets of the target
card. For ASR 5000, rebooting a packet processing or line card will
result in the card downloading the image from the active system
management card. For ASR 5500, rebooting a card will result in the
card downloading the image from the active MIO card.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
card reboot target_slot [ -force ] [ -noconfirm ]
target_slot
Initiates a reboot
of the card in the specified the slot number.
-force
Indicates that the
reboot is to take place ignoring any state or usage warnings that
might be generated.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
Usage:
A reboot is used to
reset the card and receive a new download. This may be useful when
a card is not responding or when it is necessary to cause the card
to reload its image and restart.
IMPORTANT:
Caution should be
taken in using this command. Rebooting a card which has no redundant card
available may cause a service interruption and loss of active sessions.
CAUTION:
The -force and -noconfirm options
should only be used concurrently by experienced users as this will
cause an immediate reboot regardless of warnings and no confirmation
from the user.
IMPORTANT:
This command is not
supported on all platforms.
Example:
The following will
cause the card in slot 8 to reboot without any confirmation from
the user. The card will not reboot if there are any warnings generated.
card reboot 8 -noconfirm
The following command
will cause the card in slot 8 to reboot regardless of any warnings. The
user must provide confirmation prior to this command executing.
card reboot 8 -force
The following command
will cause the card in slot 8 to reboot regardless of any warnings with
no additional user confirmation.
card reboot 8 -force
-noconfirm
card restart
Performs a soft-reset
of the target card causing all application processes to restart.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
card restart target_slot [ -force ] [ -noconfirm ]
target_slot
Initiates a restart
of the card in the specified slot number.
-force
Indicates the restart
is to take place ignoring any state or usage warnings that might
be generated.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
Usage:
Restarting a card
may be useful when a card is not performing as expected (performance drop,
increased response delays, etc.). A restart may be preferred to
a reboot as the card becomes available in less time than a reboot.
When this command
is issued for an active card, the user is prompted for confirmation unless
the -force and/or -noconfirm keywords
are used. Because the reboot of standby or redundant cards is non-service
impacting, the reboot proceeds immediately after the command execution without
user confirmation.
IMPORTANT:
Caution should be
taken in using this command. Restarting a card which has no redundant card
available may cause a service interruption and loss of active sessions.
IMPORTANT:
This command is not
supported on all platforms.
CAUTION:
The -force and -noconfirm options
should only be used concurrently by experienced users as this will
cause an immediate restart regardless of warnings and no confirmation
from the user.
Example:
The following will
cause the card in slot 8 to restart without any confirmation from
the user. The card will not reboot if there are any warnings generated.
card restart 8 -noconfirm
The following command
will cause the card in slot 8 to restart regardless of any warnings. The
user must provide confirmation prior to this command executing.
card restart 8 -force
The following command
will cause the card in slot 8 to restart regardless of any warnings with
no additional user confirmation.
card restart 8 -force
-noconfirm
card switch
Manages card pairs
and their active/standby status.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
card switch { from target_slot | to target_slot } [ -noconfirm ]
from target_slot
Specifies the slot
number of a currently active card that is to be switched. The slot
number must be valid and contain a card in active mode.
to target_slot
Specifies the slot
number of a standby card which is to become the active card. The
slot number must be valid and contain a card in standby.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
Usage:
Card switch-overs
change the active/standby status of a card. This is useful
when there is a maintenance activity on the active card which requires
removing the card from service.
CAUTION:
Caution should be
taken in using this command. Depending on the amount of bandwidth/traffic
being switched, some subscribers may experience service interruptions.
IMPORTANT:
This command is not
supported on all platforms.
Example:
The following command
switches the active/standby status of the line cards in
slots 17 and 18. This command only executes after you provide confirmation
of the request.
card switch from 17
to 18
The following command
switches the active/standby status of the cards in slots
1 and 2. This command executes immediately with no additional user
confirmation.
card switch from 1
to 2 -noconfirm
card upgrade
Upgrades the programmable
memory on a card.
Privilege:
Security Administrator,
Administrator
Syntax
card upgrade slot_number[ -noconfirm ]
slot_number
The slot number of
the card to be upgraded, for ASR 5000: from 1 through 16,
and for ASR 5500: from 1 through 10.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
CAUTION:
Use this command only
if instructed by or working with Technical Assistance Center personnel.
Usage:
You can only initiate
an upgrade if:
- there is no migration
occurring,
- the card is active
or standby,
- there is no online
upgrade in progress.
IMPORTANT:
The following operations
are not allowed while
a card is upgrading: change edc requirement (config), change card [no] shutdown
(config), change card active (config), change card redundancy (config),
card halt (exec), card reboot (exec), start an online upgrade.
IMPORTANT:
Level unlock operations
are ignored while a card is upgrading.
IMPORTANT:
This command is not
supported on all platforms.
Example:
The following command
initiates a packet processing card upgrade on slot number 10:
card upgrade 10
cdr-push
Initiates a manual
push of CDR files to a configured URL
or Local - External
Storage System (L-ESS).
Privilege:
Security Administrator,
Administrator, Operator, Inspector
Syntax
cdr-push { all | local-filename file_name }
all
Pushes all CDR files
to the configured URL.
local-filename file_name
Pushes only the specified
file to the configured URL.
file_name must
be the absolute path of the local file to push, and must be an alphanumeric
string of 1 through 1023 characters.
Usage:
Use this command to
manually push CDR files to the a configured URL
or L-ESS.
For information on
configuring the L-ESS, see the cdr command
in the EDR Module Configuration
Mode Commands and the UDR Module
Configuration Mode Commands chapters.
ASR 5000:
Run this command only from the local context. If you are in any other
context, you will see this failure message: “Failure: Manual
PUSH of CDRs supported only in the local context”
Example:
The following command
pushes all CDR files to the URL:
cdr-push all
clear aaa
Clears all Authentication,
Authorization, and Accounting (AAA) statistics for the current context.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear aaa local counters
Usage:
Clearing the AAA statistics
may be useful when monitoring the statistics manually. Clearing
resets the counters to zero.
The keyword local is
not intended to imply the local context defined for all systems.
Rather, it indicates the statistics within the current context are
to be cleared.
Example:
The following command
zeroes out all the AAA statistics in the current context.
clear aaa local counters
clear active-charging
analyzer statistics
Clears protocol analyzer
statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
analyzer statistics [ name protocol_name ] [ | { grep grep_options | more } ]
name protocol_name
Clears statistics
for the specified protocol analyzer.
If this keyword is
not specified all statistics are cleared.
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.
Usage:
Use this command to
clear ACS analyzer statistics.
Example:
The following command
clears active charging service analyzer information for TCP analyzer:
clear active-charging
analyzer statistics name tcp
clear active-charging
charging-action statistics
Clears ACS charging
action statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
charging-action statistics [ name charging_acion_name ] [ | { grep grep_options | more } ]
name charging_acion_name
Clears statistics
for the specified charging action.
charging_acion_name must
be the name of a charging action, and must be an alphanumeric string
of 1 through 63 characters.
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.
Usage:
Use this command to
clear active charging action statistics.
Example:
The following command
clears active charging action statistics information for charging action
named
pre-paid:
clear active-charging
charging-action statistics name pre-paid
clear active-charging
content-filtering server-group statistics
Clears statistics
for all/a specific CF server group.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
content-filtering server-group statistics [ name cf_server_group_name ] [ | { grep grep_options | more } ]
name cf_server_group_name
Clears statistics
for the specified CF server group.
cf_server_group_name must
be the name of a CF server group, and must be an alphanumeric string
of 1 through 15 characters.
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.
Usage:
Use this command to
clear content filtering statistics for CF server groups.
Example:
The following command
clears category-based content filtering statistics information for Rulebase
named
cf_rule1:
clear active-charging
content-filtering category statistics rulebase name cf_rule1
clear active-charging
credit-control statistics
Clears credit control
statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
credit-control statistics [ group cc_group_name | server { ip-address ip_address | name cc_group_name } ]
clear active-charging
credit-control statistics
Clears statistics
for all credit control groups.
group cc_group_name
Clears statistics
for the specified credit control group.
cc_group_name must
be an alphanumeric string of 1 through 63 characters.
server { ip-address ip_address | name cc_group_name}
Clears statistics
for the credit control server specified as:
- ip-address:
an IP address for the credit control group entered in IPv4 dotted-decimal
or IPv6 colon-separated-hexadecimal notation
- cc_group_name:
name of the credit control group server entered as an alphanumeric
string of 1 through 127 characters.
Usage:
Use this command to
clear credit control statistics.
Example:
The following command
clears statistics information for credit control:
clear active-charging
credit-control statistics
clear active-charging
edr-format statistics
Clears ACS statistics
for all or a specific Event Data Record (EDR) format.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
edr-format statistics [ name edr_format_name ]
name edr_format_name
Clears statistics
for the specified EDR format.
edr_format_name must
be the name of an EDR format, and must be an alphanumeric string
of 1 through 63 characters.
IMPORTANT:
If an EDR format name
is not specified, statistics for all EDR formats are cleared.
Usage:
Use this command to
clear the accumulated statistics for the specified EDR format.
Example:
The following command
clears the statistics for all EDR formats:
clear active-charging
edr-format statistics
clear active-charging
edr-udr-file statistics
Clears Event Data
Record (EDR) and Usage Data Record (UDR) file related statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
edr-udr-file statistics
Usage:
Use this command to
clear EDR and UDR file statistics.
Example:
The following command
clears statistical information for EDR and UDR files:
clear active-charging
edr-udr-file statistics
clear active-charging
firewall statistics
Clears Stateful Firewall
statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
firewall statistics [ callid call_id | domain-name domain_name | nat-realm nat_realm_name | protocol { icmp | icmpv6 | ip | ipv6 | other | tcp | udp } | username user_name ] [ acsmgr instance instance_id ] [ | { grep grep_options | more } ]
acsmgr instance instance_id
Specifies an ACS Manager
instance ID as an integer from 1 through 65535.
callid call_id
Specifies a call identification
number as an eight-byte hexadecimal number.
domain-name domain_name
Specifies the domain
name.
domain_name must
be an alphanumeric string of 1 through 127 characters.
nat-realm nat_realm_name
Specifies the NAT
realm.
nat_realm_name must
be an alphanumeric string of 1 through 31 characters.
protocol { icmp | ip | other | tcp | udp }
Specifies a protocol
for the statistics.
- icmp: ICMPv4
-
icmpv6
- ip: IPv4
-
ipv6
- other: Protocols
other than TCP, UDP, and ICMPv4/ICMPv6
- tcp
- udp
username user_name
Specifies the user
name.
user_name must
be an alphanumeric string of 1 through 127 characters.
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.
Usage:
Use this command to
clear Stateful Firewall statistics.
Example:
The following command
clears all Stateful Firewall statistics:
clear active-charging
firewall statistics
clear active-charging
firewall track-list
Clears the list of
servers being tracked for involvement in any Denial-of-Service (DOS)
attacks.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
firewall track-list attacking-servers
Usage:
Use this command to
clear the list of servers being tracked for involvement in any DOS attacks.
Example:
The following command
clears the list of servers being tracked for involvement in any
DOS attacks:
clear active-charging
firewall track-list attacking-servers
clear active-charging
fw-and-nat policy statistics
Clears statistics
for all or a specific Firewall-and-NAT policy.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
fw-and-nat policy statistics { all | name policy_name } [ | { grep grep_options | more } ]
all
Clears information
for all Firewall-and-NAT policies.
name policy_name
Clears information
for the specified Firewall-and-NAT policy.
policy_name must
be the name of a Firewall-and-NAT policy, and must be an alphanumeric
string of 1 through 63 characters.
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.
Usage:
Use this command to
clear statistics for all or a specific firewall-and-NAT policy.
Example:
The following command
clears statistics for the firewall-and-NAT policy named
test123:
clear active-charging
fw-and-nat policy statistics name test123
clear active-charging
group-of-ruledefs statistics
Clears ACS group of
ruledefs statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
group-of-ruledefs statistics [ name group_of_ruledefs ] [ | { grep grep_options | more } ]
name group_of_ruledefs
Clears statistics
for the specified group of ruledefs.
group_of_ruledefs must
be the name of a group of ruledefs, and must be an alphanumeric
string of 1 through 63 characters.
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.
Usage:
Use this command to
clear statistical information related to all or specified Active Charging
Service group of ruledefs.
Example:
The following command
clears statistical information related to the group of ruledefs
named
ruledef_group12:
clear active-charging
group-of-ruledefs statistics name ruledef_group12
clear active-charging
nat statistics
Clears NAT realm statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
nat statistics [ nat-realm nat_realm_name ] [ | { grep grep_options | more } ]
clear active-charging
nat statistics
This command when
issued in the local context clears statistics for all NAT realms
in all contexts. When issued within a specific context, this command
clears statistics for all NAT realms in that context.
nat-realm nat_realm_name
This command when
issued in the local context clears statistics for the specified
NAT realm in all contexts. When issued in a specific context, this
command clears statistics for the specified NAT realm in that context.
nat_realm_name:
Specifies name of the NAT realm as an alphanumeric string of 1 through
31 characters.
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.
Usage:
Use this command to
clear NAT realm statistics.
Example:
The following command
when issued in the local context, clears NAT realm statistics for NAT
realms named
test135 in
all contexts:
clear active-charging
nat statistics nat-realm test135
clear active-charging
rulebase statistics
Clears ACS rulebase
statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
rulebase statistics [ name rulebase_name ] [ | { grep grep_options | more } ]
rulebase_name
Clears statistics
for the specified ACS rulebase.
rulebase_name must
be the name of a rulebase, and must be an alphanumeric string of
1 through 15 characters.
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.
Usage:
Use this command to
clear ACS rulebase statistics.
Example:
The following command
clears statistics for the ACS rulebase named
postpaid:
clear active-charging
rulebase statistics name postpaid
clear active-charging
ruledef statistics
Clears statistics
for rule definitions configured in the Active Charging Service (ACS).
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
ruledef statistics [ charging | firewall | name ruledef_name ] [ | { grep grep_options | more } ]
charging
Clears statistics
for all charging ruledefs.
firewall
Clears statistics
for all Stateful Firewall ruledefs.
name ruledef_name
Clears statistics
for the specified ruledef.
ruledef_name must
be the name of a ruledef, and must be an alphanumeric string of
1 through 63 characters.
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.
Usage:
Use this command to
clear ACS ruledef statistics.
Example:
The following command
clears all ruledef statistics:
clear active-charging
ruledef statistics
clear active-charging
subsystem
Clears all ACS subsystem
information.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging subsystem
Usage:
Use this command to
clear all ACS subsystem information.
Example:
The following command
clears all ACS subsystem information:
clear active-charging subsystem
clear active-charging
tcp-proxy statistics
Clears ACS TCP Proxy
statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
tcp-proxy statistics [ all | ip-layer | rulebase rulebase_name | socket-migration | tcp-layer ]
all
Clears all TCP Proxy
statistics.
ip-layer
Clears TCP Proxy statistics
for IP layer.
rulebase rulebase_name
Clears TCP Proxy statistics
for the specified rulebase.
rulebase_name must
be the name of a rulebase, and must be an alphanumeric string of
1 through 63 characters.
socket-migration
Clears TCP Proxy Socket
Migration related statistics.
tcp-layer
Clears TCP Proxy statistics
for TCP layer.
Usage:
Use this command to
clear TCP Proxy statistics.
Example:
The following command
clears TCP Proxy statistics for the rulebase named
test14:
clear active-charging
tcp-proxy statistics rulebase test14
clear active-charging
tpo policy statistics
Clears Traffic Performance
Optimization (TPO) policy statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
tpo policy statistics [ name tpo_policy_name ]
name tpo_policy_name
Clears statistics for
the specified TPO policy.
tpo_policy_name must
be the name of a TPO policy, and must be an alphanumeric string
of 1 through 63 characters.
Usage:
Use this command to
clear TPO policy statistics.
- clear active-charging
tpo policy statistics command clears statistics for all
TPO policies configured in the active charging service.
- clear active-charging
tpo policy statistics name tpo_policy_name command
clears statistics for the specified TPO policy.
Example:
The following command
clears statistics for the TPO policy named
policy12:
clear active-charging
tpo policy statistics name policy12
clear active-charging
tpo profile statistics
Clears Traffic Performance
Optimization (TPO) profile statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
tpo profile statistics [ name tpo_profile_name ]
name tpo_profile_name
Clears statistics for
the specified TPO profile
tpo_profile_name must
be the name of a TPO profile, and must be an alphanumeric string
of 1 through 63 characters.
Usage:
Use this command to
clear TPO profile statistics.
- clear active-charging
tpo profile statistics command clears statistics for all
TPO profiles configured in the active charging service.
- clear active-charging
tpo profile statistics name tpo_profile_name command
clears statistics for the specified TPO profile.
Example:
The following command
clears statistics for the TPO profile named
profile12:
clear active-charging
tpo profile statistics name profile12
clear active-charging
url-blacklisting statistics
Clears URL Blacklisting
feature related statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
url-blacklisting statistics [ rulebase name rulebase_name ] [ | { grep grep_options | more } ]
rulebase name rulebase_name
Clears URL Blacklisting
information for the specified rulebase.
rulebase_name must
be the name of a rulebase, and must be an alphanumeric string of
1 through 63 characters.
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.
Usage:
Use this command to
clear URL Blacklisting feature related statistics, optionally for
a specific rulebase.
Example:
The following command
clears URL Blacklisting feature related statistics for
rulebase12:
clear active-charging
url-blacklisting statistics rulebase name rulebase12
clear active-charging
video detailed-statistics
Resets the detailed
statistics for TCP video flows.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear active-charging
video detailed-statistics
Usage:
Use this command to
reset the detailed statistics for TCP video flows.
Example:
The following command
resets the detailed statistics for TCP video flows:
clear active-charging
video detailed-statistics
clear administrator
Ends the session of
an administrative user specified by either user name or session
ID.
Privilege:
Security Administrator,
Administrator
Syntax
clear administrator { name user_name | session
id id_num }
name user_name
Identifies the user
name of the administrative user.
session id id_num
Identifies the ID
number of the administrative user session as displayed in the output
of the show
administrators session id command.
Usage:
This command is used
to terminate command line interface sessions for other administrative
users.
Example:
The following command
ends the session of the administrative user identified as
user1:
clear administrator
name user1
The following command
ends the session of the administrative user with the session ID
of
3:
clear administrator
session id 3
clear alarm
Clears outstanding
alarm conditions
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear alarm { all | chassis | id num | port slot/port | slot slot }
all
Clear all outstanding
alarms
chassis
Clears chassis-wide
and fan tray alarms
id num
Clears a specific
alarm by its internal alarm ID. num is the internal
alarm identification number.
port slot/port
Clears alarms for
the specified port. slot/port is
the card slot and port on the card for which to clear alarms.
slot slot
Clears alarms for
the specified slot. slot is
the card slot for which to clear alarms.
Usage:
Use this command to
clear outstanding alarm conditions.
Example:
To clear all outstanding
alarms, use the following command:
clear alarm all
To clear all alarms
for slot
7,
enter the following command:
clear alarm slot 7
clear alcap
Clears the Access Link
Control Application Part (ALCAP) session statistics of an ALCAP
service associated with a Home-NodeB Gateway (HNB-GW) service instance configured
and running on a system.
Syntax
clear alcap statistics [ alcap-service alcap_svc_name [ aal2-node aal2_node_name [ aal2-path aal2_path_id ] ] ]
alcap-service alcap_svc_name
Specifies the name
of the ALCAP service for which statistics are to be cleared.
aal2-node aal2-node
Specifies the name
of the ATM Adaptation Layer 2 (AAL2) node for which ALCAP service statistics
will be cleared.
aal2-path aal2_path_id
Specifies the identity
number of the AAL2 path on a specific ATM Adaptation Layer 2 (AAL2)
node for which ALCAP service statistics will be cleared.
Usage:
This command is used
to clear the sessions statistics and counters for ALCAP service.
Example:
The following command
clears the service session statistics of ALCAP service named as
alcap_hnb_svc1:
clear alcap statistics
alcap-service alcap_hnb_svc1
clear asngw-service
Clears the service
session statistics for an Access Service Network Gateway (ASN-GW)
service specified by either service name or trusted peer address.
Privilege:
Security Administrator,
Administrator
Syntax
clear asngw-service
statistics [ name svc_name | peer-address ip_address ]
name svc_name
Identifies the name
of the ASN-GW service for which statistics will be cleared. svc_name must
be an alphanumeric string of 1 through 63 characters.
peer-address ip_address
Identifies the IP
address of the ASN-GW peer for which service statistics will be
cleared. ip_address must
be entered in IPv4 dotted-decimal notation.
Usage:
This command is used
to terminate command line interface sessions for ASN GW services.
Example:
The following command
clears the service session statistics of the ASN-GW service named
aasn_svc1:
clear asngw-service
statistics name asn_svc1
clear asnpc-service
Clears the service
session statistics of an ASN paging controller service specified by
either ASN PC service name or trusted paging controller peer address.
Privilege:
Security Administrator,
Administrator
Syntax
clear asnpc-service
statistics [ name svc_name | peer-address ip_address ]
name svc_name
Identifies the name
of the ASN PC service for which session statistics will be cleared. svc_name must
be an alphanumeric string of 1 through 63 characters.
peer-address ip_address
Identifies the IP
address of the ASN PC peer for which all service statistics will
be cleared. ip_address must
be entered in IPv4 dotted-decimal notation.
Usage:
This command is used
to terminate command line interface sessions for ASN PC services.
Example:
The following command
clears the service session statistics of ASN PC service named as
asnpc_svc1:
clear asnpc-service
statistics name asnpc_svc1
clear apn statistics
Deletes all previously
gathered statistics for either a specific Access Point Name (APN)
or all APNs configured with the given context.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear apn statistics [ name apn_name | smgr-instance instance ] [ | { grep grep_options | more } ]
name apn_name
Specifies the name
of a specific APN configured in the context for which to clear statistics. apn_name is
the name of the APN expressed as an alphanumeric string of 1 through
63 characters that is case sensitive.
smgr-instance instance
Specifies a particular
Sessmgr instance in the context for which to clear APN statistics. instance must
be an integer from 1 to 4294967295.
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.
Usage:
Statistics for a single
APN can be cleared using the name keyword.
Statistics for all APNs in the context can be deleted by entering
the command with no keywords.
If this command is
executed from within the local context with no keywords, statistics
will be cleared for every APN configured on the system regardless
of context. In addition, if the name keyword
is used when executing from within the local context, statistics
for all APNs configured with the specified name will be cleared
regardless of context.
Example:
The following command
clears statistics for an APN called
isp1:
clear apn statistics
name isp1
clear bcmcs statistics
Clears Broadcast Multicast
Service (BCMCS) statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear bcmcs statistics [ pdsn-service service_name ]
pdsn-service service_name
Specifies a specific
PDSN service for which to clear BCMCS-specific statistics. This
value must be an alphanumeric string of 1 through 63 characters.
Usage:
Use this command to
clear accumulated BCMCS statistics. You may specify an individual PDSN
or peer to selectively clear statistics.
Example:
clear bcmcs statistics
clear bcmcs statistics
pdsn-service service_name
clear blacklisted-gtpu-bind-address
Clears the GTP-U loopback
address blacklisted by a specific radio network controller (RNC)
as defined for a specific IuPS Service configuration.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear blacklisted-gtpu-bind-address ip_address rnc-id rnc_id mcc mcc_num mnc mnc_num iups-service name
ip_address
Specifies the IP loopback
address that has been blacklisted in IPv4 dotted-decimal notation. This
loopback address was originally defined with the associate-gtpu-bind-addfress command
in the Radio-Network-Controller Configuration mode of the IuPS Service.
Usage:
This command enables
this loopback address to be used for future RAB-assignment requests.
Example:
clear blacklisted-gtpu-bind-address 1.1.1.1 rnc-id 2 mcc 123 mnc 321 iups-service iups1
clear bssap+ statistics
Clears the BSSAP+ protocol
(base station subsystem GPRS protocol) statistics collected for
the Gs interface between the SGSN and the MSC/VLR.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear bssap+ statistics [ gs-service gs_svc_name ] [ vlr { isdn-number ISDN_Num| name vlr_name } ] [ | { grep grep_options | more } ]
gs-service gs_svc_name
Specifies the name
of a preconfigured Gs service handling BSSAP+ information
as an alphanumeric string of 1 through 63 characters that is case
sensitive.
vlr { isdn-number ISDN_Num| name vlr_name
Specifies a VLR (by
ISDN number or name) handling BSSAP+ information.
isdn-number ISDN_num is
the configured E.164-type ISDN number for the VLR. Enter a numerical
string of 1 to 15 digits.
name vlr_name is
the configured name of the VLR entered as an alphanumeric string
of 1 through 63 characters.
Usage:
Use this command to
delete or clear collected BSSAP+ protocol statistics for
the entire SGSN or for a specified Gs interface. Using the keywords
of this command, the interface can be identified by defining a specific
VLR connected to the SGSN or by identifying the Gs service to which
the interface has been configured.
Example:
The following command
clears the BSSAP+ statistics collected for the Gs interface configured
for the Gs service named
gssvc1.
clear bssap+ statistics
gs-service gssvc1
clear bssgp statistics
Clears collected BSSGP
protocol (base station subsystem GPRS protocol) statistics for traffic
between the base station subsystem (BSS) and the SGSN.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear bssgp statistics [ gprs-service gprs_svc_name | nse nse_id [ bvc bvc_id ] [ | { grep grep_options | more } ]
gprs-service gprs_svc_name
Specifies the name
of a preconfigured GPRS service for which the BSSGP statistics have been
collected as an alphanumeric string of 1 through 63 characters that
is case sensitive.
nse nse_ID
Clears the BSSGP statistics
collected for the network service entity (NSE) specified as an integer
from 0 through 65535.
bvc bvc_ID
Enter this keyword
to clear the BSSGP statistics collected for the identified BSSGP
virtual connection (BVC) specified as n integer from 0 through 65000.
| { 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.
Usage:
Use this command to
clear the BBSGP statistics for a particular GPRS service or NSEI.
Example:
The following command
deletes the collected BSSGP statistics for the GPRS service named
gprs1.
clear bssgp statistics
gprs-service gprs1
clear bulkstats
Clears counters and
accumulated bulk statistics related information.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear bulkstats { counters | data }
counters
Clears the counters
maintained by the system’s “bulkstats” facility.
data
Clears any accumulated
data that has not been transferred. This includes any “completed” files
that have not been successfully transferred.
Usage:
Once bulk statistics
collection is enabled, the system stores the information until the specified
transfer criteria is met or until a manual transfer is initiated.
The system maintains counters for the “bulkstats” software
facility. (Refer to the data keyword
for the show
bulkstats command for information on viewing the counters.)
This command can be
used to delete bulk statistics information that has been collected
but not transferred and/or to clear the counters that have
been maintained.
Example:
The following command
clears bulk statistics-related counters:
clear bulkstats counters
clear cae-group statistics
server
This command resets
the discardable statistics, which are the Hit Count, Timeout Consecutive
(Cumulative), and Last Failure statistics, for all CAEs or for a
specific CAE. The CAE (Content Adaptation Engine) is an optional
component of the Mobile Videoscape.
Privilege:
Security Administrator,
Administrator
Syntax
clear cae-group statistics
server { all | name cae_name }
all
Resets the discardable
statistics for all CAEs.
namecae_name
Specifies the name of
a CAE.
Usage:
Use this command to
reset the discardable statistics for all CAEs or for a specific
CAE. This command must be issued in the same context in which the
associated CAE group is defined.
Example:
The following command
clears the discardable statistics for the CAE named
server_1:
clear cae-group statistics
server name server_1
clear call-home statistics
Clears Cisco Call Home
feature statistics.
Privilege:
Security Administrator,
Administrator
Syntax
clear call-home statistics
Usage:
Use this command to
reset the statistics for all Call Home events.
Example:
The following command
clears the discardable statistics for the Call Home feature:
clear call-home statistics
clear cdr statistics
Clears statistics related
to charging data records (CDRMOD).
Privilege:
Security Administrator,
Administrator
Syntax
clear cdr statistics
Usage:
Use this command to
reset the statistics for charging data records.
Example:
The following command
clears the discardable statistics related to CDRs:
clear cdr statistics
clear cli history
Clears the tracking
history of command line interface (CLI) command usage.
Privilege:
Security Administrator,
Administrator
Usage:
Use this command to
clear the tracking history of CLI command usage.
Example:
The following command
clears the CLI history:
clear cli history
clear config
Replaces the active
configuration source file with an empty configuration where possible.
Privilege:
Security Administrator,
Administrator
Syntax
clear config [ -noconfirm ]
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
Usage:
This command clears
the current configuration when a complete overwrite is desired or
if it is necessary to start from an empty configuration.
IMPORTANT:
Clearing the configuration
will cause the active configuration source file to be empty and
of no use in configuring the system to an active state providing
service.
IMPORTANT:
This command should
only be performed on configurations that have been previously backed
up for easy restoration.
Example:
The following command
clears the active configuration after the user provides confirmation of
the request.
clear config
The following command
clears the active configuration source file immediately with no
user confirmation.
clear config -noconfirm
clear congestion-control
statistics
Clears the congestion
control statistics for all instances of the specified manager type.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear congestion-control
statistics { a11mgr | asngwmgr | asnpcmgr | gtpcmgr | hamgr | hnbmgr | imsimgr | ipsecmgr | imsimgr | l2tpmgr }
a11mgr
Clears the statistics
for all A11 Manager instances.
asngwmgr
Clears the statistics
for all ASN GW Manager instances
asnpcmgr
Clears the statistics
for all ASN PC-LR Manager instances
gtpcmgr
Clears the statistics
for all GTPC Manager instances.
hamgr
Clears the statistics
for all HA Manager instances.
hnbmgr
Clears the statistics
for all HNB Manager instances.
imsimgr
Clears the statistics
for all IMSI Manager instances.
ipsecmgr
Clears the statistics
for all IPSEC Manager instances.
l2tpmgr
Clears the statistics
for all L2TP Manager instances.
Usage:
Use this command to
statistics for all instances of the specified manager.
IMPORTANT:
When this command
is issued in any context other than the local context, only instances
of the specified manager for the current context have the statistics
cleared. When the current context is the local context, all instances
of the specified manager type in all contexts have the statistics cleared.
Example:
Clear the statistics
for all instances of the A11 manger, by entering the following command:
clear congestion-control
statistics a11mgr
clear content-filtering
category statistics
Clears the Category-based
Content Filtering application statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear content-filtering
category statistics [ facility srdbmgr instance instance_value ]
facility srdbmgr instance instance_value
Clears logged events
for the specified SRDB Manager instance.
instance_value must
be an integer from 1 through 8.
In release 9.0 and later, instance_value must
be an integer from 1 through 10000.
Usage:
Use this command to
clear all Category-based Content Filtering application statistics,
or statistics for a specific SRDB Manager instance.
Example:
The following command
clears all Category-based Content Filtering application statistics:
clear content-filtering
category statistics
clear crash
Removes a specific
crash file or all crash files.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear crash [ list | number crash_num ]
list | number crash_num
list: removes
all crash files.
number crash_num:
removes only the crash file specified as an integer from 1 through
30.
Usage:
Clear crashes for
general maintenance activities in cleaning out old, unused, or files
which are of no importance.
Example:
The following will
remove all crash files.
clear crash list
The following command
will remove only crash file
27.
clear crash numer 27
clear credit-control
statistics
Clears credit control
statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear credit-control
statistics cc-service cc_service_name
cc-service cc_service_name
Specifies an existing
Credit Control service name as an alphanumeric string of 1 through
63 characters.
Usage:
Use this command to
clear active credit control statistics.
Example:
The following command
clears the configured credit control statistics for a service named
service1:
clear credit-control
statistics cc-service service1
clear crypto
Clears crypto associations
or crypto statistics.
Product:
ePDG, PDSN, HA
, GGSN, PDG/TTG, PDIF, SCM
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear crypto { isakmp [ tag map_name | peer peer_ip ] | security-association { counters
tag map_name [ tx | rx ] | tag map_name | peer peer_ip } | statistics { ikev2 | ipsec-3gpp-cscf | srtp } [service-ip-address ip-address | service-name name ] }
isakmp [ tag map_name | peer peer_ip ]
When no keywords are
specified, this command clears all of the ISAKMP security associations
for the current context.
tag map_name:
Clears the ISAKMP SAs for the specified crypto map. map_name is
the name of an existing crypto map.
peer peer_ip:
Deletes the ISAKMP SAs for the specified peer.
peer_ip must
be entered in IPv4 dotted-decimal
or
IPv6 colon-separated-hexadecimal notation.
security-association { counters
map map_name [ tx | rx ] | tag map_name | peer peer_ip }
counters tag map_name [ tx | rx ]:
Resets the counters for the specified crypto map. map_name is
the name of an existing crypto map. tx specifies
that only the transmit SA counters are reset. rx specifies
that only the receive SA counters are reset. If neither tx or rx are specified,
both transmit and receive SA counters are reset.
tag map_name:
Tears down a Security Association (SA) for the specified crypto
map. map_name is the
name of an existing crypto map.
peer peer_ip:
Clears the SAs for all tunnels who have the peer at the specified
IP address.
peer_ip must
be entered in Pv4 dotted-decimal
or
IPv6 colon-separated-hexadecimal notation.
CAUTION:
Modification(s) to
an existing crypto map and/or ISAKMP policy configuration
will not take effect until the related security association has
been cleared.
statistics { ikev2 | ipsec-3gpp-cscf | srtp } [ service-ip-address ip-address | service-name name ]
ikev2: Clears
global IKEv2 statistics for the current context.
ipsec-3gpp-cscf:
Clears global CSCF IPSec statistics for the current context.
srtp: Clears
global CSCF SRTP (Secure Real-time Transport Protocol) statistics
for the current context.
service-ip-address ip-address:
Clears statistics for the specified service-ip address. service-name name: Clears
statistics for the specified service name.
Usage:
Clear SAs and apply
changes to the crypto map or clear the crypto statistics for this context.
Example:
The following clears
all IKEv2 crypto statistics for the current context:
clear crypto statistics ikev2
clear cs-network
statistics
Clears the HNB-Circuit
Switched (CS) network service associated for an HNB-GW service instance.
Syntax
clear cs-network statistics [ name cs_svc_name | ranap-only | rtp-only | sccp-only ]
name cs_svc_name
Clears the session
statistics for an HNB-CS Network service name configured and running on
this system. cs_svc_name must
be an alphanumeric string of 1 through 63 characters.
ranap-only
Clears the session
statistics limited to Radio Access Network Application Protocol (RANAP)
traffic only for the specified HNB-CS Network service.
rtp-only
Clears the session
statistics limited to Real Time Protocol (RTP) traffic only for
the specified HNB-CS Network service.
sccp-only
Clears the session
statistics limited to Signaling Connection Control Part (SCCP) traffic
only for the specified HNB-CS Network service.
Usage:
Use this command to
clear the session statistics for overall session or in selected
part of user session for HNB-CS Network services configured and
running on a system.
Example:
The following command
clears the session statistics for RANAP part of session for the HNB-CS
Network service
hnb_CS_1:
clear cs-network statistics
name hnb_CS_1 ranap-only
clear cscf service
Resets statistics
counters for a specific Call/Session Control Function (CSCF) service,
all CSCF services, or for all services within a specified context
(VPN).
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear cscf service { diameter { location-info | policy-control } statistics [ service-name service_name | vpn-name name ] | li-packet-cable
statistics [service-name service_name] | performance-counters
name service_name | statistics
name service_name { all | calls | ip-security | message | package-name { message-summary | presence | reg | winfo } | registrations | sigcomp | tcp { msrp | sip } | vpn-name name { all | calls | ip-security | message | package-name { message-summary | presence | reg | winfo } | registrations | sigcomp | tcp { msrp | sip } } }
diameter { location-info | policy-control } statistics [ service-name service_name | vpn-name name ]
Clears Diameter (DPECA)
statistics on the CSCF Rx interface with the configuration information.
service-name service_name: Specifies
the name of an existing CSCF service for which the statistics will
be reset as an alphanumeric string of 1 through 63 characters.
vpn-name name: Specifies
the name of an existing context in which all statistics for all
services will be reset as an alphanumeric string of 1 through 79
characters.
li-packet-cable statistics [ service-name service_name ]
Refer to the Lawful Intercept Configuration
Guide for a description of this command.
performance-counters
name service_name
Clears all CSCF performance
counters for an existing CSCF service specified as an alphanumeric
string of 1 through 63 characters.
statistics name service_name { all | calls | ip-security | message | package-name { message-summary | presence | reg | winfo } | registrations | sigcomp | tcp
tcp { msrp | sip } | vpn-name name { all | calls | ip-security | message | package-name { message-summary | presence | reg | winfo } | registrations | sigcomp | tcp
tcp { msrp | sip } } }
Clears service statistics
for an existing CSCF service specified as an alphanumeric string
of 1 through 63 characters.
all: Clears
all CSCF service statistics.
calls: Clears
statistics related to CSCF calls.
ip-security:
Clears statistics related to CSCF IPSec.
message:
Clears statistics for the SIP method MESSAGE.
package-name:
Clears statistics for the associated event package.
- message-summary:
Clears statistics for the “message-summary” event
package.
- presence:
Clears statistics for the “presence” event package.
- reg: Clears
statistics for the “reg” event package.
- winfo: Clears
statistics for the “watcher-info” event package.
registrations:
Clears statistics related to CSCF registrations, re-registrations,
and de-registrations.
sigcomp:
Clears statistics related to CSCF sigcomp.
tcp: Displays
session statistics related to CSCF TCP.
- msrp: Clears
statistics related to CSCF MSRP TCP.
- sip: Clears
statistics related to CSCF SIP TCP.
vpn-name name: Clears
statistics for a specific CSCF service configured in a specific
context on this system. name must
be an existing context expressed as an alphanumeric string of 1
through 79 characters.
IMPORTANT:
This keyword must
be followed by another statistics-related keyword.
Usage:
Use this command to
reset statistics counters for CSCF services. This command will reset the
counters in the output of the show cscf service statistics command.
IMPORTANT:
This command will not clear current
registered users and current CSCF sessions.
Example:
The following command
resets all statistics for a service named
cscf1:
clear cscf service
statistics name cscf1 all
clear cscf sessions
Clears statistics
for Call/Session Control Function (CSCF) sessions on this system.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear cscf sessions { counters { calls | subscription } service service_name | service service_name { all | aor aor | session-id id }
counters { calls | subscription } service service_name
Clears counters for
all CSCF sessions matching the filter criteria.
calls: Counters
associated with calls in CSCF service.
subscription:
Counters associated with subscriptions in CSCF service.
service service_name: Counters
on specific CSCF service. service_name must
be an existing CSCF service expressed as an alphanumeric string
of 1 through 63 alphanumeric characters.
service service_name { all | aor aor | session-id id }
Clears session information
for all CSCF sessions matching the filter criteria.
service service_name: Session
statistics on specific CSCF service.
service_name must
be an existing CSCF service expressed as an alphanumeric string
of 1 through 63 alphanumeric characters.
- all: Specifies
that session statistics are to be cleared for all sessions on this
service.
- aor aor: Specifies
that session statistics are to be cleared for sessions at this specific
AoR. aor must
be an existing AoR expressed as an alphanumeric string of 1 through
79 characters.
- session-id id: Specifies that
session statistics are to be cleared for sessions with this ID. id must
be an existing session ID expressed as an alphanumeric string of
1 through 63 characters.
Usage:
Use this command to
clear session information for CSCF sessions.
Example:
The following command
resets all session statistics for a service named
cscf1:
clear cscf sessions
service cscf1 all
clear cscf sip
Resets SIP statistics
counters for a specific CSCF service, all CSCF services, or for
all services within a specified context (VPN) or interface.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear cscf sip statistics [ name service_name [ interface
{ domain name domain_name | ip address ip_address } |
vpn-name name ]
name service_name
Specifies the name
of an existing CSCF service for which the SIP statistics will be
reset as an alphanumeric string of 1 through 63 characters.
interface { domain
name domain_name | ip address ip_address }
SIP statistics will
be reset in this interface.
domain name domain_name:
Specifies an existing domain associated with the CSCF service as
an alphanumeric string of 1 through 64 characters.
ip address ip_address:
Specifies the destination or source ip address associated with the
CSCF service.
vpn-name name
Specifies the name
of an existing context in which all SIP statistics for all services
will be reset as an alphanumeric string of 1 through 79 characters.
Usage:
Use this command to
reset SIP counters found in the output of the show cscf sip command.
Example:
The following command
resets the SIP statistics for a service named
cscf1:
clear cscf sip statistics
name cscf1
clear cscf subscription
Clears all subscriptions
for a named service or for individual subscribers within the service.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear cscf subscription
service service_name { all | from-aor subscriber_aor to-aor resource_aor }
service service_name
Specifies the name
of an existing CSCF service for which the subscription(s) will be
cleared as an alphanumeric string of 1 through 63 characters.
all | from-aor subscriber_aor to-aor resource_aor
all: Removes
all CSCF subscriptions for the specified service.
from-aor subscriber_aor: Removes
all CSCF subscriptions for a specified subscriber in a specified
service.
subscribed-to resource_aor:
Removes all CSCF subscriptions for a specified subscriber in a specified
service with a specified subscribed-to resource AoR.
Usage:
Use this command to
clear subscriptions to enforce policies. This command initiates
a SUBSCRIBE request with Expires as 0 in the corresponding subscription dialog.
Example:
The following command
clear all subscriptions for a CSCF service named
cscf1:
clear cscf subscription
service cscf1 all
clear dhcp statistics
Deletes all previously
gathered statistics for either a specific or all DHCP IPv4 servers
configured within the given context.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear dhcp statistics [ dhcp-service svc_name | server ip_address ]
dhcp-service svc_name
Specifies the name
of a specific DHCP service for which to clear statistics as an alphanumeric
string of 1 through 63 characters that is case sensitive.
server ip_address
Specifies the IP address
of a DHCP server in IPv4 dotted-decimal notation as configured in the
context for which to clear statistics.
Usage:
Statistics for a single
server can be cleared using the server keyword.
Statistics for all DHCP servers in the context can be deleted by
entering the command with no keywords.
This command can be
executed from any context configured on the system.
If this command is
executed from within the local context with no keywords, statistics
will be cleared for every DHCP server configured on the system regardless
of context. In addition, if the server keyword is used when executing
from within the local context, statistics for all DHCP servers configured
with the specified name will be cleared regardless of context.
Example:
The following command
clears statistics for all configured DHCP servers within the context:
clear dhcp statistics
clear dhcpv6 statistics
Deletes all previously
gathered statistics for either a specific or all DHCP IPv6 (DHCPv6)
servers configured within the given context.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear dhcpv6 statistics [ server ipv6_address | service svc_name ]
server ipv6_address
Specifies the IP address
of a DHCP server in IPv6 colon-separated-hexadecimal notation as configured
in the context for which to clear statistics.
service svc_name
Specifies the name
of a specific DHCPv6 service for which to clear statistics as an alphanumeric
string of 1 through 63 characters that is case sensitive.
Usage:
Statistics for a single
server can be cleared using the server keyword.
Statistics for all DHCPv6 servers in the context can be deleted
by entering the command with no keywords.
This command can be
executed from any context configured on the system.
If this command is
executed from within the local context with no keywords, statistics
will be cleared for every DHCPv6 server configured on the system
regardless of context. In addition, if the server keyword is used
when executing from within the local context, statistics for all DHCPv6
servers configured with the specified name will be cleared regardless
of context.
Example:
The following command
clears statistics for all configured DHCPv6 servers within the context:
clear dhcpv6 statistics
clear diameter
aaa-statistics
Clears Diameter AAA
statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear diameter aaa-statistics [ all | [ group aaa_group ] server diameter_server ] [ | { grep grep_options | more } ]
all
Clears all Diameter
server statistics.
group aaa_group
Clears Diameter server
statistics for the specified AAA group.
aaa_group must
be the name of a AAA server group, and must be an alphanumeric string
of 1 through 64 characters.
server diameter_server
Clears Diameter server
statistics for the specified Diameter server.
diameter_server must
be an alphanumeric string of 1 through 64 characters.
| { 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.
Usage:
Use this command to
clear Diameter AAA statistics.
Example:
The following command
clears Diameter server statistics for the specified AAA group:
clear diameter aaa-statistics
group aaagroup3
clear diameter
statistics
Clears Diameter statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear diameter statistics [ [ proxy ] endpoint endpoint_name [ peer-host host_id [ peer-realm realm_id ] ] ] [ | { grep grep_options | more } ]
endpoint endpoint_name
Clears statistics
for the specified endpoint.
endpoint_name must
be the name of a diameter endpoint, and must be an alphanumeric
string of 1 through 63 characters.
proxy
Clears proxy related
statistics.
peer-host host_id
Clears statistics
for the specified Diameter peer host ID.
host_id must
be an alphanumeric string of 1 through 255 characters.
peer-realm realm_id
Clears statistics
for the specified Diameter peer realm.
realm_id must
be an alphanumeric string of 1 through 127 characters.
| { 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.
Usage:
Use this command to
clear Diameter statistics.
Example:
The following command
clears all Diameter statistics for the specified endpoint:
clear diameter statistics
endpoint endpt345
clear diameter-service
Clears information
pertaining to configured Diameter services.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear diameter-service { eap { all | session-id session_id } | lte-s6b { all | session-id session_id } | lte-sta { all | session-id session_id } | mbms { bearer-contexts { all | bmsc-bearer-service
name service_name } | ue-context { all | bmsc-bearer-service
name service_name } } | statistics
name service_name [ vpn-name vpn context_name ] }
eap { all | session-id session_id }
Clears subscribers
from the EAP interface.
all: Clears
all subscribers.
session-id session_id: Clears
a call for the session ID specified as an alphanumeric string of
1 through 63 characters.
lte-s6b { all | session-id session_id }
Clears subscribers
from the S6b interface.
all: Clears
all subscribers.
session-id session_id: Clears
a call for the session ID specified as an alphanumeric string of
1 through 63 characters.
lte-sta { all | session-id session_id }
Clears subscribers
from STa interface.
all: Clears
all subscribers.
session-id session_id: Clears
a call for the session ID specified as an alphanumeric string of
1 through 63 characters.
mbms { bearer-contexts { all | bmsc-bearer-service
name service_name } | ue-context { all | bmsc-bearer-service
name service_name } }
Clears information
from the SGSN-APP interface.
bearer-contexts { all | bmsc-bearer-service
name service_name }: Clears
information from the bearer-context gmb-interface.
all: Clears
all subscribers.
bmsc-bearer-service name service_name }: Specifies
the name of a bmsc-bearer-service as an alphanumeric string of 1
through 63 characters.
ue-context { all | bmsc-bearer-service
name service_name }: Clear
information UE context for gmb-interface.
all: Clears
all subscribers.
bmsc-bearer-service name service_name }: Specifies
the name of a bmsc-bearer-service as an alphanumeric string of 1
through 63 characters.
service_name
service_name must
be a name of a Diameter service expressed as an alphanumeric string
of 1 through 63 characters.
statistics name service_name [ vpn-name vpn context_name ]
Clears the Diameter
service associated with the specified statistics.
name service_name:
Specifies the name of a Diameter service as an alphanumeric string
of 1 through 63 characters.
vpn-name vpn context_name: Clears
statistics for the vpn-context name specified as an alphanumeric
string of 1 through 63 characters.
Usage:
Use this command to
clear information pertaining to configured Diameter services.
Example:
The following command
clears Diameter service information for all subscribers associated with
EAP interface:
clear diameter-service
eap all
clear dns-client
Clears DNS cache and/or
statistics for a specified DNS client.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear dns-client name { cache [ query-name name | query-type
{ A | AAAA | NAPTR | SRV } ] | statistics }
dns-client name
Specifies the name
of an existing DNS client whose cache and/or statistics
are being cleared as an alphanumeric string of 1 through 255 characters.
cache [ query-name name | query-type { A | AAAA | NAPTR | SRV } ]
Specifies that the
cache for the defined DNS client is to be cleared.
query-name name: Filters
DNS results based on the domain name. The name is an alphanumeric
string of 1 through 255 characters. that is the domain name used
to perform the DNS query. This name is different from the actual
domain name which is resolved. For example, to resolve the SIP server
for service.com,
the query name is _sip._udp.service.com and
the query type is SRV.
query-type:
- A: Filters
DNS results based on domain IP address records (A records).
- AAAA: Filters
DNS results based on AAAA records (AAAA resource records).
- NAPTR: Filters
DNS results based on Name Authority Pointer records.
- SRV: Filters
DNS results based on service host records (SRV records).
statistics
Specifies that statistics
for the defined DNS client are to be cleared.
Usage:
Use this command to
clear DNS cache and/or statistics for a specified DNS client.
Example:
The following command
clears statistics for a DNS client named
domain1.com:
clear dns-client domain1.com statistics
clear dns-proxy
statistics
Clears all DNS proxy
statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear dns-proxy statistics
Usage:
Use this command to
clear all DNS proxy statistics.
Example:
The following command
clears DNS proxy statistics:
clear dns-proxy statistics
clear dynamic-policy
statistics
Clears policy control
and charging (PCC) statistics from the interface communicating with
the Policy and Charging Rules Function (PCRF) via Gx(x).
Product:
HSGW, PDSN,
S-GW
Syntax
clear dynamic-policy
statistics { hsgw-service name | pdsn-service name | sgw-service name }
hsgw-service name
Clears policy control
and charging statistics from the Gxa interface communicating with
the PCRF. name must
be an existing HSGW service name and be from 1 to 63 alphanumeric
characters.
pdsn-service name
Clears policy control
and charging statistics from the Gx interface communicating with
the PCRF. name must
be an existing PDSN service name and be from 1 to 63 alphanumeric
characters.
sgw-service name
Clears policy control
and charging statistics from the Gxc interface communicating with
the PCRF. name must
be an existing S-GW service name and be from 1 to 63 alphanumeric
characters.
Usage:
Use this command to
clear PCC statistics for the specified service and its Gx interface communicating
with the PCRF.
Example:
The following command
clears HSGW statistics for an HSGW service named
hsgw4:
clear dynamic-policy
statistics hsgw-service hsgw4
The following command
clears PCC statistics for a PDSN service named
cdma4:
clear dynamic-policy
statistics pdsn-service cdma4
The following command
clears S-GW statistics for an S-GW service named
sgw4:
clear dynamic-policy
statistics sgw-service sgw4
clear egtpc
Clears enhanced GPRS
Tunneling Protocol control plane (eGTP-C) statistics and counters
found in show command
outputs and bulk statistics associated with all eGTP-C-related services
or those defined by the parameters in this command.
Syntax
clear egtpc statistics [ egtp-service name | interface-type { interface-mme | interface-pgw-ingress | interface-sgsn | interface-sgw-egress | interface-sgw-ingress } | mme-address ip_address | pgw-address ip_address | sgsn-address ip_address | sgw-address ip_address ]
egtp-service name
Clears all statistics
and counters associated with an existing eGTP service name specified
as an alphanumeric string of 1 through 63 characters.
interface-type { interface-mme | interface-pgw-ingress | interface-sgw-egress | interface-sgw-ingress }
interface-mme:
Clears statistics and counters derived from all MME interface types
associated with this system.
interface-pgw-ingress:
Clears statistics and counters derived from all P-GW ingress interface
types associated with this system.
interface-sgw-egress:
Clears statistics and counters derived from all S-GW egress interface
types associated with this system.
interface-sgsn:
Clears statistics and counters derived from all SGSN S4 interface
types associated with this system.
interface-sgw-ingress:
Clears statistics and counters derived from all S-GW ingress interface
types associated with this system.
mme-address ip_address
Clears all statistics
and counters derived from an existing MME IP address specified in
IPv4 dotted-decimal or IPv6 colon-separated-hexadecimal notation.
pgw-address ip_address
Clears all statistics
and counters derived from an existing P-GW IP address specified
in IPv4 dotted-decimal or IPv6 colon-separated-hexadecimal notation.
sgw-address ip_address
Clears all statistics
and counters derived from an existing S-GW IP address specified
in IPv4 dotted-decimal or IPv6 colon-separated-hexadecimal notation.
sgsn-address ip_address
Clears all statistics
and counters derived from an existing SGSN S4 IP address specified
in IPv4 dotted-decimal or IPv6 colon-separated-hexadecimal notation.
Usage:
Use this command to
clear running statistics and counters found in show command and bulk
statistics outputs for all eGTP-C-related services or for specific
interfaces, services, or IP addresses as specified by parameters
in this command.
Example:
The following command
clears eGTP-C statistics and counter associated with all P-GW ingress
interfaces configured on this system:
clear egtpc statistics
interface-type interface-pgw-ingress
The following command
clears eGTP-C statistics and counter associated with all MME interfaces
configured on this system:
clear egtpc statistics
interface-type interface-mme
clear firewall
This command is obsolete.
clear fng-service
statistics
Deletes all previously
gathered statistics for a specific Femto Network Gateway (FNG) service
or all FNG services configured within a context.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear fng-service
statistics {name service_name}
name service_name
Specifies the name of
a specific FNG service configured in the context for which to clear statistics
as an alphanumeric string of 1 through 63 characters that is case sensitive.
Usage:
Statistics for a single
FNG service can be cleared using the name keyword.
Statistics for all FNG services in the context can be deleted by
entering the command with no keywords.
If this command is executed
from within the local context with no keywords, statistics will be
cleared for every FNG service configured on the system regardless
of context. In addition, if the name keyword
is used when executing from within the local context, statistics
for all FNG services configured with the specified name will be
cleared regardless of context.
Example:
The following command
clears statistics for an FNG service named fng1:
clear fng-service statistics
name fng1
clear gmb statistics
Deletes the collected
statistics for the Gmb reference point. Gmb handles broadcast multicast
service center (BM-SC) related signaling, which includes the user
specific and bearer service messages for Multimedia Broadcast/Multicast
Service (MBMS) service.
Privilege:
Security Administrator,
Administrator, Operator, Inspector
Syntax
clear gmb statistics [ apn name | bmsc-profile profile_name
apn name
Deletes only the Gmb
information for the specified Access Point Name (APN) specified
as an alphanumeric string of 1 through 62 characters.
bmsc-profile profile_name
Deletes only the Gmb
information for the specified BM-SC profile specified as an alphanumeric
string of 1 through 79 characters.
Usage:
Use this command to
delete usage statistics for the Gmb reference point.
Example:
The following command
deletes all Gmb statistics:
clear gmb statistics
clear gmm-sm statistics
Deletes the collected
statistics for the GPRS Mobility Management and Session Management
(GMM/SM) configurations for various SGSN services.
Privilege:
Security Administrator,
Administrator, Operator, Inspector
Syntax
clear gmm-sm statistics [ gmm-only| sm-only ] [ gprs-service srvc_name | iups-service srvc_name | sgsn-service srvc_name ]
Keywords are presented
below. First are the primary keywords in the order one is selected,
as displayed in the syntax. Secondary or filtering keywords are
presented alphabetically after the primary keywords.
gmm-only
Deletes only GPRS mobility
management (GMM) information for the specified keyword parameters.
sm-only
Deletes only session
management (SM) information for the specified keyword parameters.
gprs-service srvc_name
Deletes the statistics
for a 2.5G GPRS service specified as an alphanumeric string of 1 through
63 characters that uniquely identifies a preconfigured GPRS service.
The delete request can be narrowed by adding either the nsei or routing-area keywords.
iups-service srvc_name
Deletes the statistics
for a IuPS service specified as an alphanumeric string of 1 through
63 characters that uniquely identifies a preconfigured IuPS service.
The delete request can be narrowed by adding either the rnc or routing-area keywords.
sgsn-service srvc_name
Deletes the statistics
for a 3G SGSN service specified as an alphanumeric string of 1 through 63
characters that uniquely identifies the SGSN service. The delete
request can be narrowed by adding either the rnc or routing-area keywords.
lac lac_id
Specifies the location
area code (LAC) as part of the identification of the RNC or RA. lac_id must
be an integer from 1 through 65535.
mcc mcc_id
Specifies the mobile
country code (MCC) as part of the identification of the RNC or RA. mcc_id must
be an integer from 100 through 999.
mnc mnc_id
Specifies the mobile
network code (MNC) as part of the identification of the RNC or RA. mnc_id must
be a 2- or 3-digit integer from 00 through 999.
nseinse_id
Deletes the GMM/SM
session statistics for the identified network service entity (NSEI). nse_id must
be an integer from 0 through 65535 that uniquely identifies a configured
NSEI.
rncrnc_id
Fine-tunes the deletion
of GMM/SM session statistics just for the specified radio
network controller (RNC). rnc_id must
be an integer from 0 through 4095.
rac rac_id
Specifies the routing
area code (RAC) as part of the identification of the RNC or RA. rac_id must
be an integer from 1 through 255.
routing-area mcc mcc_id mnc mnc_id lac lac_id rac rac_id
Enter the routing-area keyword
to fine-tune the clearing of the GMM/SM statistics for
a specified routing area (RA) identified by the MCC, MNC, LAC and RAC.
Usage:
Use this command to
delete usage statistics for the GMM/SM session configurations
for SGSN services, including BSC attaches, activations, and throughput.
Example:
The following command
deletes GMM/SM statistics for a specific routing area defined
for the SGSN’s GPRS service:
clear gmm-sm statistics
gprs-service gprs1 routing-area mcc 123 mcc 131 lac 24 rac 11
The following command
displays all possible information for GMM/SM statistics:
show gmm-sm statistics verbose
IMPORTANT:
Output descriptions
for show commands
are available in the Statistics
and Counters Reference.
clear gprsns statistics
Deletes collected statistics
for the 2.5G SGSN’s General Packet Radio Service (GPRS)
Network Service (NS) layer (link level).
Syntax
clear gprsns statistics { msg-stats
nse nse_id | sns-msg-stats }[ | { grep grep_options | more } ]
msg-stats
Deletes collected transmit
(tx) and receive (rx) message statistics for the NS layer.
consolidated nse nse_id
nse_id:
Enter an integer from 0 to 65535.
nse nse_id
Deletes statistics
for an NSE specified as an integer from 0 to 65535.
sns-msg-stats
Deletes subnetwork
service (SNS) sublayer message statistics.
| { grep grep_options | more }
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.
Usage:
This command is used
to display Frame Relay statistics configured for the NSE/NSVC with
the commands documented in the Network Service Entity
- Peer NSEI Configuration Mode chapter.
Collected statistics
are cleared (deleted) with the clear gprsns statistics described
in the Exec Mode Commands
(A-C) chapter.
Example:
The following command
displays the collected message statistics for NSEI
1422:
show gprsns statistics
msg-stats nse 1422
IMPORTANT:
Output descriptions
for show commands
are available in the Statistics
and Counters Reference.
clear gprsssf statistics
Deletes all Customized
Applications for Mobile networks Enhanced Logic (CAMEL) service
gprsSSF statistics collected since the last reset or clear command.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear gprsssf statistics [ camel-service srvc_name | gprs [ 2g-sgsn-app | 3g-sgsn-app ] | gsmscf-address { address | all } | sms ] [ | { grep | more } ]
camel-service srvc_name
Clears only CAMEL service
statistics for the configured CAMEL service specified as an alphanumeric
string of 1 through 63 characters.
gprs [ 2g-sgsn-app | 3g-sgsn-app ]
Clears only CAMEL service
statistics for either a 2.5G or 3G SGSN.
gsmscf-address { address | all }
Filters the command
to only clear CAMEL service statistics for specified GSM service control
function (gsmSCF) addresses. address is
a standard ISDN E.164 address of 1 to 15 digits.
sms
Filters the command
to only clear CAMEL service statistics for SMS protocol information.
| { grep grep_options | more }
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.
Usage:
This command instructs
the SGSN to delete collected CAMEL service statistics for either specified
CAMEL services, or for SMS or GPRS applications in all contexts.
Example:
The following command
will delete gprsSSF statistics collected for the CAMEL service residing
at SCP identified by the gsmSCF address:
clear gprsssf statistics
gsmscf-address 412211411151
clear gtpc statistics
Deletes all previously
gathered GTPC (GTPv0, GTPv1-C, GTPv1-U) statistics within the given
context based on the specified criteria.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear gtpc statistics [ [ custom1 | gtpcmgr-instance gtpcmgr_instance_number | smgr-instance sessmgr_instance_number ] [ apn apn_name | ggsn-service ggsn_service_name | sgsn-address sgsn_ipv4_address ] ]
custom1
Clears the statistics
of GTP-C messages for preservation mode and free of charge service.
This keyword is a
customer-specific function used for Preservation-Mode and Free-of-Charge
Service that is enabled under customer-specific license. For more
information on this support, contact your Cisco account representative.
gtpcmgr-instance gtpcmgr_instance_number
Clears GTP-C statistics
for a GTPC Manager instance specified as an integer from 1 through 4294967295.
smgr-instance sessmgr_instance_number
Clears GTP-C statistics
for a Session Manager instance specified as an integer from 1 through
4294967295.
apn apn_name
Clears GTP-C statistics
for an existing APN specified as an alphanumeric string of 1 through 63
characters that is case sensitive.
ggsn-service ggsn_service_name
Clears GTP-C statistics
for an existing GGSN service specified as an alphanumeric string
of 1 through 63 characters that is case sensitive.
sgsn-address sgsn_ipv4_address
Clears GTP-C statistics
for an existing SGSN specified by IP address in IPv4 dotted-decimal notation.
Usage:
GTPC statistics can
be cleared for a single APN, GGSN service, or SGSN. All GTPC statistics
in the context can be deleted by entering the command with no keywords.
This command can be
executed from any context configured on the system.
If this command is
executed from within the local context with no keywords, all GTPC statistics
will be cleared regardless of context.
GTPP statistics are
not affected by this command.
Example:
The following command
clears all GTPC statistics context:
clear gtpc statistics
clear gtpp statistics
Deletes all previously
gathered GTPP statistics within the given context based for either
single or all charging gateway functions (CGFs).
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear gtpp statistics [ cgf-address ip-address ]
cgf-address cgf_address
Deletes statistics
for a CGF identified by its IP address entered in IPv4 dotted-decimal
or IPv6 colon-separated-hexadecimal notation.
Usage:
Statistics for a single
CGF can be cleared using the cgf-address keyword.
Statistics for all CGFs in the context can be deleted by entering
the command with no keywords.
This command can be
executed from any context configured on the system.
If this command is
executed from within the local context with no keywords, statistics
will be cleared for every CGF configured on the system regardless
of context. In addition, if the cgf-address keyword is used when
executing from within the local context, statistics for all CGFs configured
with the specified name will be cleared regardless of context.
Example:
The following command
deletes all GTPP statistics for a CGF with an IP address of 192.168.1.42:
clear gtpp statistics
cgf-address 192.168.1.42
clear gtpp storage-server
local file statistics
Clears AAA proxy GTPP
group level statistics for CDRs stored on the local hard disk.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear gtpp storage-server
local file statistics [ group name name ]
Usage:
If executed from the
local context, this command clears statistics for all GTPP groups configured
on the system. If executed from the context within which the storage
servers (hard disk) is configured, statistics are deleted for only
that context.
clear gtpp storage-server
statistics
Clears statistics
for configured GTPP storage servers (GSS).
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear gtpp storage-server statistics
Usage:
If executed from the
local context, this command clears statistics for all GTPP storage servers
configured on the system. If executed from the context within which
the servers are configured, statistics are deleted for only those servers.
clear gtpu statistics
Clears enhanced GPRS
Tunneling Protocol user plane statistics and counters found in show command outputs
and bulk statistics associated with all GTP-U-related services or
those defined by the parameters in this command.
Syntax
clear gtpu statistics [ gtpu-service gtpu_service_name | peer-address ipv4/ipv6_address ]
gtpu-service gtpu_service_name
Clears GTP-U statistics
for an existing GTP-U service specified as an alphanumeric string
of 1 through 63 characters.
peer-address ipv4/ipv6_address
Clears GTP-U statistics
for an existing peer IP address entered in IPv4 dotted-decimal or IPv6
colon-separated-hexadecimal notation.
Usage:
Use this command to
clear running statistics and counters found in show command and bulk
statistics outputs for all GTP-U-related services or for specific
services or IP addresses as specified by parameters in this command.
Example:
The following command
clears GTP-U statistics and counter associated with a GTP-U service
name
gtpu-12 configured
on this system:
clear gtpu statistics
gtpu-service gtpu-12
clear hd-storage-policy
Clears statistic information
for HD storage policies configured on the system.
Product:
HSGW, P-GW, S-GW
Syntax
clear hd-storage-policy
statistics { all | name name }
statistics { all | name name }
all: Clears
ACR statistical information for all HD storage policies configured
on the system.
name name: Clears
ACR statistical information for an existing HD storage policy specified
as an alphanumeric string of 0 through 63 characters.
Usage:
Use this command to
clear statistics for HD storage policies configured on the system.
Example:
The following command
clears statistics for an HD storage policy named
pgwsgw:
clear hd-storage-policy
statistics name pgwsgw
clear hnbgw sessions
Clears the active/dormant
session information about registered Nabs) on Home-NodeB Gateway
(HNB-GW) service instances configured and running on this system
based on different filter criteria.
Syntax
clear hnbgw sessions { all | cell-id cell_id | hnb-address hnb_ip_address | hnb-local-id hnb_id | hnbgw-service hnbgw_svc_name | hnbid hnb_glbl_id | mcc mcc mnc mnc [ -noconfirm ] [ lac lac | rac rac ] }
all
Clears the summarized
or full information for all registered HNB sessions on an HNB-GW service
instance running on system. Clearing the statistics can be filtered
based on given filtering.
cell-id cell_id
Clears HNB session
statistics for a registered cell ID on an HNB-GW service instance. cell_id is
the identification number of the Femto cell where the user/subscriber
is geographically located expressed as an integer from 0 through 268435455.
hnb-address hnb_ip_address
Clears the session
statistics for HNB session(s) based on a registered HNB IP address entered
in IPv4 dotted-decimal notation.
hnb-local-id hnb_id
Clears the session
statistics of HNB session(s) for a registered local id of HNB specified
as as an integer from 1 through 255.
hnbgw-service hnbgw_svc_name
Clears the session
statistics for registered HNB session(s) on an existing HNB-GW service name
specified as an alphanumeric string of 1 through 63 characters.
hnbid hnb_glbl_id
Clears the statistics
for HNB session(s) based on the registered HNB global id specified
as an integer from 1 through 255
mcc mcc
Clears statistics for
HNB session(s) based on the registered Mobile Country Code (MCC) identification
number of the UE. mcc must
be an integer from 101 through 999.
mnc mnc
Clears the statistics
for HNB session(s) based on the registered Mobile Network Code (MNC)
identification number of the UE. mnc must
be a 2- or 3-digit integer from 00 through 999
lac lac
Clears the statistics
for HNB session(s) based on the registered Location Area Code (LAC) identification
number of the UE. lac must
be an integer from 1 through 65535.
rac rac
Clears the statistics
for HNB session(s) based on the registered Radio Access Code (RAC) identification
number of the UE. rac must
be an integer from 1 through 255.
rnc rnc
Clears the statistics
for HNB session(s) based on the registered Radio Network Code (RAC) identification
number of the HNB. rnc must
be an integer from 1 through 65535.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
IMPORTANT:
The Operator privilege
does not have access to this keyword.
Usage:
Use this command to
clear the session statistics of all or specific registered HNB session(s) or
in selected part of user session for HNB-GW services configured
and running on this system.
Example:
The following command
clears the session statistics for all registered HNBs on the HNB-GW
service named
hnbgw1:
clear hnbgw sessions
hnbgw-service hnbgw1
clear hnbgw statistics
Clears the HNB-GW service
and HNB related statistics from an HNB-GW node.
Syntax
clear hnbgw statistics { hnbgw-service hnbgw_svc_name [ gtpu-only | hnbap-only | ranap-only | rtp-only | rua
-only | sccp-only | sctp-only ] | hnbid hnb_identifier [ gtpu-only | hnbap-only | ranap-only | rtp-only | rua
-only ] }
hnbgw-service hnbgw_svc_name
Clears the session
statistics for an existing \HNB-GW service name specified
as an alphanumeric string of 1 through 63 characters.
hnbid hnb_identifier
Clears the session
statistics for an existing Home-NodeB identifier specified as an alphanumeric
string of 1 through 255 characters.
gtpu-only
Clears the statistics
for GTP-U traffic only for the selected HNB/HNB-GW service.
hnbap-only
Clears the statistics
for Home NodeB Application Part (HNBAP) traffic only for the selected HNB/HNB-GW
service.
ranap-only
Clears the session
statistics for Radio Access Network Application Protocol (RANAP) traffic
only for the selected HNB/HNB-GW service.
rtp-only
Clears the session
statistics for Real Time Protocol (RTP) traffic only for the selected
HNB/HNB-GW service.
rua-only
Clears the session
statistics for RANAP User Adaptation (RUA) traffic only for the
selected HNB/HNB-GW service.
sccp-only
Clears the session
statistics for Signaling Connection Control Part (SCCP) traffic
only for the selected HNB-GW service.
sctp-only
Filters the session
statistics to display only Stream Control Transmission Protocol
(SCTP) traffic for the selected HNB-GW service.
Usage:
Use this command to
clear the session statistics for an overall session or in a selected
part of a user session for HNB-GW services and/or HNBs
configured and running on this system.
Example:
The following command
clear the session statistics for the HNBAP portion of session details for
the HNB-GW service named
hnbgw1:
clear hnbgw statistics
hnbgw-service hnbgw1 hnbap-only
The following command
clears the session statistics for the RANAP portion of session details
for the HNB identified as
102:
clear hnbgw statistics
hnbid 102 ranap-only
clear hsgw-service
Clears HRPD Serving
Gateway (HSGW) statistics and counters found in show command
outputs and bulk statistics associated with all HSGW services or
a specific service defined by the parameter in this command.
Syntax
clear hsgw-service
statistics [ name service_name ] [ | { grep grep_options | more } ]
name name
Clears statistics
and counters for a an existing HSGW service name specified as an alphanumeric
string of 1 through 63 characters.
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.
Usage:
Use this command to
clear statistics for HSGW services configured on the system.
Example:
The following command
clears statistics for an HSGW service named
hsgw3:
clear hsgw-service
statistics name hsgw3
clear hss-peer-service
Clears statistic information
for Home Subscriber Service (HSS) peer services configured on the
system.
Syntax
clear hss-peer-service
statistics [ service name ]
statistics [ service name ]
statistics:
Clears HSS peer service statistical information for all HSS peer
services configured on the system.
service name: Clears
HSS peer service statistic information for an existing HSS peer
service specified as an alphanumeric string of 1 through 64 characters.
Usage:
Use this command to
clear statistics for HSS peer services configured on the system.
Example:
The following command
clears statistics for an HSS peer service named
hss4:
clear hss-peer-servicey
statistics service name hss4
clear ims-authorization
Clears statistics
for all or for a specified IP Multimedia System (IMS) Authorization
Service.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear ims-authorization { policy-control statistics [ ims-auth-service service_name ] | service
statistics [ name service_name ] } [ | { grep grep_options | more } ]
ims-auth-service service_name
Clears statistics
for the specified IMSA service.
service_name must
be an alphanumeric string of 1 through 64 characters.
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.
Usage:
Use this command to
clear IMSA Service statistics.
Example:
The following command
clears IMSA policy-control statistics for an IMSA service named
test_service:
clear ims-authorization
policy-control statistics ims-auth-service test_service
clear ims-sh-service
statistics
Clears all IP Multimedia
System (IMS) Sh interface (Diameter) statistics for a specific or
all services using the Sh interface.
Privilege:
Security Administrator,
Administrator
Syntax
clear ims-sh-service
statistics [ service service_name ]
service service_name
Clears statistics
for the specified existing IMS service.
service_name must
be an alphanumeric string of 1 through 64 characters.
Usage:
Use this command to
clear interface Sh interface statistics for a specified or all IMS services.
Example:
The following command
clears all Sh interface statistics:
clear ims-sh-service statistics
clear ip access-group
statistics
Clears all interface
access control list (ACL) statistics and the context level ACL statistics
that have been configured in the current context. Be aware that
updating an access list also causes all ip access-groups utilizing
the list to be cleared.
Privilege:
Security Administrator,
Administrator
Syntax
clear ip access-group statistics
Usage:
Use this command to
clear all interface ACL statistics and the context level ACL statistics that
have been configured in the current context.
Example:
The following command
clears the ACL statistics:
clear ip access-group statistics
clear ip arp
Clears the address
resolution protocol (ARP) cache for a given IP address.
Privilege:
Security Administrator,
Administrator
Syntax
clear ip arp ip_address
ip_address
Specifies the IP address
for which to clear the ARP cache in IPv4 dotted-decimal
or IPv6 colon-separated-hexadecimal notation.
Usage:
Clear the ARP cache
when network changes have occurred for the case where the cached data
may cause undue overhead in routing packets.
Example:
The following command
clears the ARP cache for the IP address
10.2.3.4:
clear ip arp 10.2.3.4
clear ip bgp peer
Resets Border Gateway
Protocol (BGP) connections for all peers or for specified peers
in the current context.
Privilege:
Security Administrator,
Administrator
Syntax
clear ip bgp peer { ip_address | all | as as_num } [ in | out | soft | vpnv4 ]
ip_address
Specifies the IP address
of the neighbor for which BGP connections should be reset in IPv4 dotted-decimal
notation.
all
Resets BGP connections
for all peers.
as as_num
Resets BGP connections
for all peers in the specified autonomous system (AS). as_num must
be an integer from 1 through 65535.
in
Softly reconfigures
inbound updates.
out
Softly reconfigures
outbound updates.
soft
Softly reconfigures
inbound and outbound updates.
vpnv4
Clears BGP sessions
within the vpnv4 address family.
Usage:
Use this command to
BGP information for the current context.
Example:
The following command
resets BGP connections for all neighbors:
clear ip bgp peer all
clear ip localhosts
Removes the host specified
from the current context’s local host list for IP address
mappings.
Privilege:
Security Administrator,
Administrator
Syntax
clear ip localhosts [ host_name ]
host_name
Specifies the name
of the host to be removed as an alphanumeric string of 1 through
127 characters. When omitted, all local host name mappings will
be removed.
Usage:
Clears a host name
when it is no longer valid for the current context to access. The
host name specified will be unrecognized by the current context
once the command is performed.
Example:
clear ip localhosts 10.2.3.4
clear ip localhosts remoteABC
clear ip ospf process
Clears Open Shortest
Path FIrst (OSPF) database information for the current context and
re-establishes neighbor adjacency.
Privilege:
Security Administrator,
Administrator
Syntax
clear ip ospf process
Usage:
Use this command to
clear the OSPF database information for the current context and
re-establishes neighbor adjacency.
Example:
The following command
clears the OSPF database information for the current context and re-establishes
neighbor adjacency:
clear ip ospf process
clear ipsg statistics
Clears IP Services
Gateway (IPSG) statistics for a specified or all IPSG services.
Privilege:
Administrator, Security
Administrator
Syntax
clear ipsg statistics [ service service_name ]
service service_name
Specifies the name
of an IPSG service for which statistics will be cleared.
service_name must
be an alphanumeric string of 1 through 64 characters.
Usage:
Clears IPSG service
statistics for a specified or all IPSG services.
Example:
The following command
clears statistics for all IPSG services:
clear ipsg statistics
clear ipv6 neighbors
Clears an IPv6 address
from the neighbor cache.
Privilege:
Administrator, Security
Administrator
Syntax
clear ipv6 neighbors ip_address
ip_address
Specifies the IP address
in IPv6 colon-separated-hexadecimal notation.
Usage:
Clears a specific
address from the neighbor cache.
Example:
Use the following
example to clear
3ffe:ffff:101::230:6eff:fe04:d9aa/48:
clear ipv6 neighbors 3ffe:ffff:101::230:6eff:fe04:d9aa/48
clear ipv6 ospf
process
Restarts Open Shortest
Path First Version 3 (OSPFv3) with available configuration.
Privilege:
Administrator, Security
Administrator
Syntax
clear ipv6 ospf process
Usage:
Force a restart of
OSPFv3 process using the available configuration.
clear l2tp
Clears all or specific
Layer 2 Tunnelling Protocol (L2TP) statistics or clears and disconnects
all or specified sessions or tunnels.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear l2tp { statistics [ lac-service service_name | lns-service service_name | peer-address ip_address ] | tunnels { all [ clear-sa ] |
callid call_id | lac-service service_name [ clear-sa ] | lns-service service_name | peer-address ip_address [ clear-sa ] } }
statistics [ lac-service service_name | lns-service service_name | peer-address ip_address ]
With no optional keywords
specified, this command clears all L2TP statistics for the current context.
lac-service service_name: Clears
all L2TP statistics for the specified LAC service in the current
context.
lns-service service_name: Clears
all L2TP statistics for the specified LNS service in the current
context.
peer-address ip_address: Clears
all L2TP statistics for the destination (peer LNS) at the specified
IP address. The IP address is entered using IPv4 dotted-decimal
notation.
tunnels { all [ clear-sa ] | callid call_id | lac-service service_name [ clear-sa ] | peer-address ip_address [ clear-sa ] }
all: Clears
all tunnels in the current context.
lac-service service_name:
Clears all tunnels in the current context that belong to the specified
LAC service and closes the tunnels.
lns-service service_name:
Clears all tunnels in the current context that belong to the specified
LNS service and closes the tunnels.
peer-address ip_address:
Clears all tunnels in the current context whose destination (peer
LNS) is the system at the specified IP address. The IP address is specified
using IPv4 dotted-decimal notation.
callid call_id:
Uses the unique identifier that specifies a particular tunnel in
the system to clear that tunnel and disconnect it. The output of
the command show
l2tp tunnels contains a field labeled Callid Hint which lists
the call id information to use with this command. This is an 8-byte
hexadecimal number.
clear-sa:
If any security associations have been established they are cleared.
Usage:
Clear L2TP all or
specific L2TP statistics or clear sessions in a tunnel and disconnect
the tunnel.
Example:
To clear all L2TP
statistics for the current context, use the following command:
clear l2tp statistics
To clear all L2TP
statistics for the LAC service named
lac1, use the
following command:
clear l2tp statistics
lac-service lac1
Use the following
command to clear L2TP statistics for the LNS peer at the IP address
10.10.10.100:
clear l2tp statistics
peer-address 10.10.10.100
The following command
clears and closes all tunnels in the current context:
clear l2tp tunnels all
The following command
clears and closes all tunnels for the LAC service named
lac2:
clear l2tp tunnels
lac-service lac2
The following command
clears and closes all tunnels the peer at the IP address
10.10.10.110:
clear l2tp tunnels
peer-address 10.10.10.110
clear lawful-intercept
Refer to the Lawful Intercept Configuration
Guide for a description of this command.
clear llc statistics
Deletes collected traffic
statistics for the GPRS logical link-control (LLC) layer.
Syntax
clear llc statistics [ gprs-service srvc_name ] [ | { grep
grep_options | more } ]
gprs-service srvc_name
Clears
the collected statistics for an existing GPRS service specified
as an alphanumeric string of 1 through 63 characters.
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 more information
on the usage of grep and more, refer
to the Regulating a
Command’s Output section of the Command Line Interface
Reference.
Usage:
This command deletes
statistics collected for the traffic that has gone through the LLC layer
for either all GPRS services or for a specified GPRS service.
Example:
The following command
deletes all LLC statistics for GPRS service
gprs1:
clear llc statistics
gprs-service gprs1
clear lma-service
statistics
Clears Local Mobility
Anchor (LMA) statistics and counters found in show command outputs
and bulk statistics associated with all LMA services or a specific
service defined by the parameter in this command.
Syntax
clear lma-service
statistics [ name service_name ]
name service_name
Clears statistics
and counters for an existing LMA service name specified as an alphanumeric
string of 1 through 63 characters.
Usage:
Use this command to
clear statistics and counters in show command outputs and bulk statistics
for all LMA services or for a specific LMA service.
Example:
The following command
clears statistics and counters for an LMA service named
lma3:
clear lma-service
statistics name lma3
clear local-policy
Clears local Quality
of Service (QoS) policy service statistics and counters found in show command outputs
and bulk statistics associated with all local QoS policy services
or a specific service defined by the parameter in this command.
Syntax
clear local-policy
statistics [ service service_name ]
service service_name
Clears statistics
and counters for an existing local policy service name specified
as an alphanumeric string of 1 through 64 characters.
Usage:
Use this command to
clear statistics and counters in show command
outputs and bulk statistics for all local QoS policy services or
a specific service.
Example:
The following command
clears statistics and counters for a local QoS policy service named
lp3:
clear local-policy
statistics service lp3
clear local-user
Clears information
pertaining to local-user administrative accounts.
Privilege:
Security Administrator
Syntax
clear local-user { database [ -noconfirm ] | statistics |
username name lockout }
clear local-user database
Clears the local-user
database by deleting all information for all local-user accounts.
CAUTION:
Use this command only
in the event of security concerns or to address concerns of the
local-user account database integrity.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
clear local-user statistics
Clears statistics
pertaining to local-user accounts.
clear local-user userame name lockout
Removes lockouts associated
with the local-user account expressed as an alphanumeric string
of 3 through 16 characters that is case sensitive.
Usage:
This command can be
used to remove local-user account lockouts, reset local-user-related statistics
to 0, or to delete the local-user database.
Example:
The following command
removes the lockout placed on a local-user account named
SecureAdmin:
clear local-user username
SecureAdmin lockout
clear mag-service
statistics
Clears Mobile Access
Gateway (MAG) statistics and counters found in show command
outputs and bulk statistics associated with all MAG services or
a specific service defined by the parameter in this command.
Syntax
clear mag-service
statistics [ name service_name ]
name service_name
Clears statistics
and counters for an existing MAG service name specified as an alphanumeric
string of 1 through 63 characters.
Usage:
Use this command to
clears statistics and counters in show command outputs and bulk statistics
for all MAG services or for a specific MAG service.
Example:
The following command
clears statistics and counters for a MAG service named
mag1
clear mag-service
statistics name mag1
clear map statistics
Clears Mobile Application
Part (MAP) statistics (SS7) for a specified service or all services.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear map statistics [ name service_name ]
name service_name
Clears statistics
and counters for an existing MAP service name specified as an alphanumeric
string of 1 through 63 characters.
Usage:
Delete MAP statistics
for a single or all GGSN/SGSN services.
Example:
The following command
deletes all MAP statistics.
clear map statistics
clear maximum-temperatures
Clears information
pertaining to component maximum temperatures.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear maximum-temperatures
Usage:
Reset the timestamp
to the current time and clear previous maximum temperatures for
all temperature monitored components. This may be useful when preparing
to study system performance, monitor usage, or trouble shoot the
administrative interfaces.
Example:
The following command
resets the maximum temperature statistics for all monitored chassis components.
clear maximum-temperatures
clear mipfa statistics
Clears the statistics
for the mobile IP foreign agent (MIPFA). The statistics for a specific
foreign agent service may be cleared by an explicit command.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear mipfa statistics [ fa-service name | peer-address ip_address ]
fa-service name | peer-address ip_address
fa-service name: Clears
the statistics for an existing FA service specified as an alphanumeric
string of 1 through 63 characters. “Total sessions” counters
for all peers associated with the service are also reset.
peer-address ip_address: Clears
the statistics for the peer IP address specified in IPv4 dotted-decimal
notation. “Total sessions” counter for the specified
peer is also reset.
Usage:
Clear all statistics
for the MIP foreign agent or for a specific service. This may be
useful in monitoring performance and troubleshooting as the statistics
may be cleared at a well known time and then collected and transferred
for review.
Example:
The following clears
all statistics for the mobile IP foreign agent.
clear mipfa statistics
The following commands
clear the statistics for the example service only.
clear mipfa statistics
fa-service sampleService
clear mipfa statistics
peer-address 10.2.3.4
clear mipha statistics
Clears the statistics
for the mobile IP home agent (MIPHA). The statistics for a home
agent service may be cleared by explicit command.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear mipha statistics [ ha-service name | peer-address ip_address ]
ha-service name | peer-address ip_address
ha-service name: Clears
the statistics for an existing HA service name specified as an alphanumeric
string of 1 through 63 characters. “Total sessions” counters
for all peers associated with the service are also reset.
peer-address ip_address: Clears
the statistics for an IP address specified using IPv4 dotted-decimal
notation. “Total sessions” counter for the specified
peer is also reset.
Usage:
Clear all statistics
for the MIP home agent or for a specific service. This may be useful
in monitoring performance and troubleshooting as the statistics
may be cleared at a well known time and then collected and transferred
for review.
Example:
The following clears
all statistics for the mobile IP foreign agent.
clear mipha statistics
The following command
clears the statistics for the example service only.
clear mipha statistics
ha-service sampleService
clear mipha statistics
peer-address 10.2.3.4
clear mipmn statistics
Clears the statistics
for mobile IP mobile node (MIPMN).
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear mipmn statistics
Usage:
Clear all statistics
for MIP mobile node. This may be useful in monitoring performance and
troubleshooting as the statistics may be cleared at a well known
time and then collected and transferred for review.
Example:
The following clears
all statistics for MIP mobile node:
clear mipmn statistics
clear mipv6ha statistics
Clears the statistics
for mobile IP IPv6 home agent (MIPv6HA).
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear mipv6ha statistics
Usage:
Clear all statistics
for a MIP IPv6 home agent. This may be useful in monitoring performance
and troubleshooting as the statistics may be cleared at a well known
time and then collected and transferred for review.
Example:
The following clears
all statistics for MIPv6 home agent:
clear mipv6ha statistics
clear mme-service
db record
Clears the MME database
records all instances of session manager running for an MME service
filtered with IMSI or GUTI as criteria.
Syntax
clear mme-service db
record { all | guti plmn plmn_id group-id mme_grp_id code mme_code m-tmsi mtmsi_value | imsi imsi_identifier | instance instance_id }
all
Clears all detached
database records.
guti plmn plmn_id group-id mme_grp_id code mme_code m-tmsi mtmsi_value
This set of keywords
specifies the filter criteria as a Globally Unique Temporary Identifier (GUTI)
to clear the database records for MME service.
The GUTI is constructed
from the GUMMEI and the M-TMSI where GUMMEI is constructed from
PLMN (MMC and MNC) plmn_id and
MME Identifier is constructed from an MME Group ID (MMEGI) mme_grp_id and
an MME Code (MMEC) mme_code.
Within the MME, the
mobile is identified by the M-TMSI mtmsi_value
imsi imsi_identifier
Specifies the filter
criteria as International Mobile Subscriber Identity (IMSI) to clear
the database records of a session instance. imsi_identifier is
a 15-character IMSI field that identifies the subscriber’s
home country and carrier.
instance instance_id
Clears all detached
database records in an existing session manager instance specified
as an integer from 1 through 4294967295.
Usage:
Use this command to
clear/remove database records for all or a particular instance
of session manager for MME services on this system.
Example:
The following command
clears the summary database records of a session instance for subscriber
having IMSI as
123455432112345 in
the MME service:
clear mme-service
db record imsi 123455432112345
clear mme-service
db statistics
Clears the MME database
statistics for MME sessions for all or specific session instances
on this system.
Syntax
clear mme-service
db statistics [ instance smgr_instance ]
instance smgr_instance
Specifies that MME
database statistics for a specific instance of session manager running
for MME service are to be remove. The instance ID expressed is an
integer from 0 through 4294967295. If an instance is not specified,
database statistics of all instances will be removed.
Usage:
Use this command to
clear/remove database statistics for all or a particular
instance of session manager for MME services on this system.
Example:
The following command
removes/clears the database statistics of all instances
of the MME service on a system:
clear mme-service
db statistics
clear mme-service
statistics
Clears the service
statistics of an MME service specified by various criteria.
Privilege:
Security Administrator,
Administrator
Syntax
clear mme-service statistics [ emm-only | esm-only | mme-service mme_svc_name [ emm-only | esm-only | handover | offload | s1ap | sctp ] | offload | peer-id peer_identifier [ emm-only | esm-only | handover | offload | s1ap | sctp ] | s1ap | sctp ] ]
emm-only
Clears all EPS mobility
management (EMM) related statistics for a specific MME service name,
a specific peer MME identifier, or all EMM statistic instances.
esm-only
Clears all EPS session
management (ESM) related statistics for a specific MME service name,
a specific peer MME identifier, or all ESM statistic instances.
mme-service mme_svc_name
Filters by MME service
name to clear all service statistics.
peer-id peer_identifier
Filters by the identifier
of an MME peer to clear all service statistics.
s1ap
Filters by the MME
service name of a peer MME identifier to clear all S1-AP statistics.
sctp
Filters by the MME
service name of a peer MME identifier to clear all SCTP statistics.
Usage:
This command is used
to clear the statistical information of an MME service based on various
filter criteria.
Example:
The following command
clears the service session statistics of all MME service on a system:
clear mme-service statistics
clear multicast-sessions
Disconnects broadcast-multicast
sessions based on specified criteria.
Privilege:
Security Administrator
Operator
Syntax
clear
multicast-sessions [ -noconfirm ] [ keywords ] [ verbose ]
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
all
Disconnects all multicast
sessions.
callid call_id
Clears the call specified
by call_id.
The call ID is as an 8-byte hexadecimal number.
card-num slot_num
Specifies the slot
number of the packet processing card by which the multicast session
is processed as a number from 1 through 7 or 10 through 16 (for
the ASR 5000) or from 1 through 3 or 6 through 10 (for
the ASR 5500).
flowid id
Clears calls for a
specific Broadcast/Multicast Service (BCMCS) flow id, specified
as a hexadecimal numbe.r
flowid-type [ flow | program ]
Clears multicast sessions
according to the type of flow.
flow: Clears
all multicast sessions for the flow ID type “flow”.
program:
Clears all multicast sessions for the flow ID type “program”.
mcast-address ipv4_address
Clears multicast sessions
for a specific multicast address. Must be followed by the IP address
of an interface in IPv4 dotted-decimal notation.
pcf ipv4_address
Clears multicast sessions
connected via the packet control function defined by an IP address in
IPv4 dotted-decimal notation.
pdsn_service name
Clears multicast sessions
connected to an existing packet data service name.
sgsn-service svc_name
Displays information
for multicast sessions connected to an existing SGSN service name.
verbose
Displays as much information
as possible. If this option is not specified, the output is the standard
level which is the concise mode.
Usage:
Clear multicast sessions
to aid in troubleshooting the system when no additional subscribers
may connect or when a specific service or remote address may be
having connection problems. This command may also be useful when
preparing for maintenance activities such that connects may be cleared
to perform any necessary procedures.
The keywords are filters
that modify or filter the criteria for deciding which sessions to clear
and are described below. Multiple keywords can be entered on a command
line.
When multiple keywords
are specified, the multicast sessions deleted must meet the specifications
of all of the keywords.
Example:
The following command
clears the broadcast-multicast sessions having multicast address
10.2.3.4:
clear multicast-sessions
mcast-address 10.2.3.4
The following command
clears the broadcast-multicast session(s) having call id
00004e22:
clear multicast-sessions
callid 00004e22
clear orbem statistics
Clears the interface
statistics for the object request broker element manager (ORBEM)
interface.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear orbem statistics
Usage:
Clear the statistics
to reset them to zero for the ORBEM interface. This may be useful when
preparing to study system performance, monitor usage, or troubleshoot
the administrative interfaces.
Example:
The following command
resets the statistics for the ORB element manager.
clear orbem statistics
clear pdg-service
statistics
Deletes all previously
gathered statistics for a specific Packet Data Gateway (PDG) service
or all PDG services configured within a context.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear pdg-service statistics [ name service_name ]
name service_name
Clears the statistics
for the PDG service name configured in the context, expressed as
an alphanumeric string of 1 through 63 characters that is case sensitive.
Usage:
Usage Statistics for
a single PDG service can be cleared using the name keyword. Statistics
for all PDG services in the context can be deleted by entering the
command with no keywords.
If this command is executed
from within the local context with no keywords, statistics will be
cleared for every PDG service configured on the system regardless
of context. In addition, if the name keyword is used when executing
from within the local context, statistics for all PDG services configured
with the specified name will be cleared regardless of context.
Example:
Example(s) The following
command clears statistics for a PDG service named
pdg1:
clear pdg-service
statistics pdg1
clear pgw-service
Clears PDN Gateway
(P-GW) statistics and counters found in show command
outputs and bulk statistics associated with all P-GW services or
a specific service defined by the parameter in this command.
Syntax
clear pgw-service
statistics [ name service_name ] [ | { grep grep_options | more } ]
name service_name
Clears statistics
and counters for an existing P-GW service name, expressed as an alphanumeric
string of 1 through 63 characters.
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.
Usage:
Use this command to
clear statistics and counters in show command outputs and bulk statistics
for all P-GW services or for a specific P-GW service.
Example:
The following command
clears statistics and counters for an P-GW service named
pgw5:
clear pgw-service
statistics name pgw5
clear port
Clears port related
statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear port { datalink
counters { all | slot/port } |
npu counters { all | slot/port [ untagged | vlan tag_id ] }
clear port datalink
counters
Clears data link port
statistics.
clear port npu counters
Clears statistics
for the network processing unit(s).
all
Clears counters for
all datalink or NPU ports.
slot/port
Clears the statistics
for the specified slot and port number.
untagged
Clears NPU statistics
for all ports that do not have a VLAN tag.
vlan tag_id
Clears NPU statistics
for the port that has a previously configured VLAN tag ID.
Usage:
Manually clear the
statistics for a specified port. This is useful when preparing to
trouble shoot or monitor the system.
Example:
The following command
clears the data link related statistics for port 1 in slot 17.
clear port datalink
counters 17/1
The following command
clears the network processing unit related statistics for port 1
in slot 17.
clear port npu counters
17/1
The following command
clears the network processing unit related statistics for port 10
in slot 5.
clear port npu counters
5/10
clear ppp statistics
Clears point-to-point
protocol (PPP) related statistics. All PPP statistics may be cleared
or just those for a specific packet data service may be cleared.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear ppp statistics [ ggsn-service ggsn_name | lns-service lns_name | pcf-address [ pcf_ip_addr | all ] | pdsn-service pdsn_name ]
ggsn-service ggsn_name
Clears statistics
only for the time the session is connected to the named GGSN service.
lns-service lns_name
Clears statistics
only for the time the session is connected to the named LNS service.
pcf-address [ pcf_ip_addr | all ]
Clears statistics
only for the time the session is connected to the specified PCF
(Packet Control Function) or for all PCFs. pcf_ip_addr must
be entered using IPv4 dotted-decimal notation.
pdsn-service pdsn_name
Clears statistics
only for the named PDSN service.
Usage:
Allows you to manually
reset PPP statistics when it is desired to have counts begin again from
a specific point in time.
Example:
The following clears
the statistics for all PPP counters and services.
clear ppp statistics
The following clears
only the point-to-point protocol statistics for the service named
sampleService.
clear ppp statistics
pdsn-service sampleService
clear prepaid 3gpp2
statistics
Clears all of the
statistics counters for 3GPP2 Pre-paid accounting. Statistics may be
cleared for all services or for an individual service.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear prepaid 3gpp2
statistics { all | { ggsn-service | ha-service | lns-service | pdsn-service |
pdsnclosedrp-service } { all | name service_name } }
all
Clears prepaid statistics
for all services.
ggsn-service
Clears statistics
for GGSN service(s).
ha-service
Clears statistics
for HA service(s).
lns-service
Clears statistics
for LNS service(s).
pdsn-service
Clears statistics
for PDSN service(s).
{ all | name service_name }
all: Clears
statistics for all services of the specified type.
name service_name:
Clears statistics for the named service of the specified service
type.
Usage:
Use this command to
clear Pre-paid statistics for a particular named service or for
all services.
Example:
To clear statistics
for a PDSN service name
PDSN1,
enter the following command:
clear prepaid 3gpp2
statistics pdsn-service name PDSN1
clear prepaid wimax
Clears all of the
statistical counters for WiMAX prepaid accounting. Statistics may
be cleared for all services or for an individual service.
Syntax
clear prepaid wimax
statistics { all | asngw-service { all | name service_name } | ha-service { all | name service_name } }
all
Clears prepaid statistics
for all services.
asngw-service
Clears prepaid statistics
for ASN-GW service(s).
ha-service
Clears prepaid accounting
statistics for HA service(s).
{ all | name service_name }
all: Clears
statistics for all services of the specified type.
name service_name:
Clears statistics for the named service of the specified service
type.
Usage:
Use this command to
clear prepaid WiMAX accounting statistics for named service or for all
services.
Example:
The following command
clears prepaid WiMAX accounting statistics for an ASN-GW service
name
asn1:
clear prepaid wimax
statistics asngw-service name asn1
clear ps-network
statistics
Clears the HNB-Packet
Switched (PS) network service associated with an HNB-GW service
instance.
Syntax
clear ps-network statistics [ name cs_svc_name | gtpu-only | ranap-only | rtp-only | sccp-only ]
name ps_svc_name
Clears the session
statistics based on an existing HNB-PS network service name, expressed as
an alphanumeric string of from 1 through 63 characters.
gtpu-only
Clears the session
statistics for GTP-U traffic only for the specified HNB-PS Network service.
ranap-only
Clears the session
statistics for Radio Access Network Application Protocol (RANAP) traffic
only for the specified HNB-PS Network service.
sccp-only
Clears the session
statistics for Signaling Connection Control Part (SCCP) traffic
only for the specified HNB-PS Network service.
Usage:
Use this command to
clear the session statistics for overall session or in selected
part of user session for HNB-CS Network services configured and
running on a system.
Example:
The following command
clears the session statistics for RANAP part of session for the HNB-PS
Network service
hnb_PS_1:
clear ps-network statistics
name hnb_PS_1 ranap-only
clear qos npu stats
Clears information
pertaining to NPU QoS priority queue bandwidth allocation and sharing.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear qos npu stats
inter-subscriber traffic slot slot_num
inter-subscriber traffic
slot slot_num
Clears inter-subscriber
traffic statistics for the ASR 5000 application or line
card or the ASR 5500 DPC or MIO card installed in the specified
slot.
slot_num indicates
the number of the chassis slot in which the card is installed and
can be configured to an integer value from 1 through 48 (for the
ASR 5000 or 1 through 10 (for the ASR 5500).
Usage:
Allows you to manually
reset statistics pertaining to NPU QoS priority queue bandwidth allocation.
Example:
The following command
clears statistics for a card installed in chassis slot
3:
clear qos npu stats
inter-subscriber traffic slot 3
clear radius accounting
archive
Clears archived RADIUS
accounting messages associated with an AAA group, or all the archived
RADIUS accounting messages in the context in which the command is executed
depending on the option chosen. The scope of the command is limited
to the context in which it is executed (including the local context).
IMPORTANT:
This command is only
available in StarOS 8.3 and later. For more information, please
contact your local service representative.
Privilege:
Security Administrator,
Administrator
Syntax
clear radius accounting
archive { all | radius group group_name } [ -noconfirm ]
all
Clears all archived
RADIUS accounting messages in the context.
radius group group_name
Clears all archived
RADIUS accounting messages for the specified RADIUS group.
group_name must
be the name of a RADIUS server group, and must be an alphanumeric
string of 0 through 64 characters.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
Usage:
Use this command to
clear the archived RADIUS accounting messages associated with an AAA
group, or all the archived RADIUS accounting messages in the context
in which the command is executed.
Example:
Use the following
command to clear all archived RADIUS accounting messages for the group
named
test12.
clear radius accounting
archive radius group test12
clear radius counters
Clears statistics
for RADIUS servers or a server group. The statistics for all RADIUS
servers or a server group may be cleared.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear radius counters { all | radius
group group_name | server ip_address [ port number ] }
all | radius
group group_name | server ip_address [ port number ]
all: Clears
statistics for all servers.
radius group group_name: Clears
all configured authentication/accounting servers in the
specified RADIUS group. group_name must
be the name of server group configured in a specific context for
authentication/accounting, expressed as an alphanumeric
string of 1 through 63 characters.
server ip_address [ port number ]:
Clears statistics only for the server specified using IPv4 dotted-decimal
or IPv6 colon-separated-hexadecimal notation. Optionally, you can
specify the port which is to have its RADIUS statistics cleared
as an integer from 0 through 65535.
Usage:
Clear the statistics
to reset them to zero prior to logging or monitoring the system
for troubleshooting, performance measurements, etc.
Example:
The following command
clears the statistics for all RADIUS servers.
clear radius counters all
The following command
resets the statistics only for the server
10.2.3.4.
clear radius counters
server 10.2.3.4
The following command
resets the statistics only for the server group named
star1.
clear radius counters
radius group star1
clear rohc statistics
Clears statistics
and counters collected since the last reload or clear command
was issued for RObust Header Compression (ROHC) [RFC 3095].
Product:
PDSN, ASN-GW, HSGW
Privilege:
Administrator, Config-administrator,
Operator, Inspector
Syntax
clear rohc statistics [ pdsn-service pdsnsvc_name | asngw-service asngwsvc_name
pdsn-service pdsnsvc_name
Clears ROHC statistics
and counters for the specified PDSN service.
Clears ROHC statistics
and counters for the specified ASN-GW service.
Usage:
Use this command to
clear ROHC statistics for all services or for a specific PDSN
or ASNGW service.
Example:
The following command
clears ROHC statistics and counters for the PDSN service named
pdsn1:
clear rohc statistics
pdsn-service pdsn1
clear rp service-option
Clears the radio-packet
(R-P) interface service option statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear rp service-option
statistics [ number option_num | pdsn-service pdsn_name ]
number option_num | pdsn-service pdsn_name
Default: clears the
statistics for all service options and all packet data services.
number option_num:
Specifies the R-P service option number for which the statistics
are to be cleared as an integer from 0 through 1000.
pdsn-service pdsn_name: Specifies
the PDSN service name for which statistics will be cleared.
Usage:
Clear the R-P service
option statistics prior to monitoring the system for bench marking
or for detecting areas of further research.
Example:
The following resets
the service option statistics for service option
23 and packet
data service
sampleService,
respectively.
clear rp service-option
statistics number 23
clear rp service-option
statistics pdsn-service sampleService
clear rp statistics
Clears the radio-packet
(R-P) interface statistics. The statistics for a specific packet
data server or peer node may be cleared if specified.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear rp statistics [ pdsn-service name | peer-address
[ peer_address | all ] ]
pdsn-service name | peer-address [ peer_address | all ]
Default: clears all
R-P associated statistics.
pdsn-service name: Specifies the
packet data service name that is to have its statistics reset.
peer-address [ ip_address | all ]: Specifies
that statistics for the specified peer, or all peers, are to be
cleared. The ip_address must
be specified using IPv4 dotted-decimal notation.
Usage:
Clear the statistics
to prepare for monitoring the system.
Example:
The following command
resets all the associated statistics for the R-P interfaces.
clear rp statistics
The following command
clears the statistics for the packet data service
sampleService.
clear rp statistics
pdsn-service sampleService
The following command
resets the statistics associated with peer node with IP address
10.2.3.4.
clear rp statistics
peer-address 10.2.3.4
clear rsvp statistics
Clears theResource
Reservation Protocol (RSVP) statistics.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear rsvp statistics
Usage:
Clear RSVP statistics.
Example:
The following command
resets all RSVP statistics.
clear rsvp statistics
The following command
resets the statistics associated with peer node with IP address
clear sccp statistics
Clears SS7 Signaling
Connection Control Part (SCCP) statistics collected for services
that use the SCCP protocol.
Syntax
clear sccp statistics [ iups-service iups_srvc_name | map-service map_srvc_name | sccp-network ntwk_index [ dpc dpc [ ssn ssn ] | global-title-translation { address-map
instance add_map_inst | association
instance assoc_inst } [ sessmgr
instance sessmgr_inst ] ] [ | { grep grep_options | more } ]
iups-service iups_srvc_name
Deletes collected SCCP
protocol statistics for an existing Iu-PS service in the current context
specified as an alphanumeric string of 1 through 63 characters.
map-service map_srvc_name
Deletes collected SCCP
protocol statistics for an existing MAP service specified as an alphanumeric
string of 1 through 63 characters.
sccp-network ntwk_index
Deletes collected SCCP
protocol statistics for the SSCP network configuration with the
a network index specified as an integer from 1 through 12.
The following filters
can be added to limit the clearing of SCCP network statistics:
- dpc dpc: Specifies
a differentiated pointcode address to limit the deletion of collected
SCCP network statistics to those for the identified destination.
- ssn ssn: Specifies
a subsystem number as an integer from 1 to 255 to limit the deletion
of collected SCCP network statistics.
- global-title-translation
address-map instance add_map_inst:
Specifies an identified GTT address-map as an integer from 1 to
4096 to limit the deletion of collected SCCP network statistics.
- global-title-translation
association instance assoc_inst:
Specifies an identified GTT association as an integer from 1 to
16 to limit the deletion of collected SCCP network statistics.
- sessmgr instance sessmgr_inst:
Specifies an identified session manager instance as an integer from
1 to 384 to limit the deletion of collected SCCP network statistics.
Usage:
Use this command to
delete all collected SCCP statistics or to delete SCCP statistics
for a specified service, SCCP network, or session manager.
Example:
The following command
deletes all collected SCCP statistics:
clear sccp statistics
The following command
clears all collected SCCP statistics for the IuPS service named
iups-serv1:
clear sccp statistics
iups-service iups-serv1
clear session disconnect-reasons
Clears the session
disconnect reason statistics for all sessions on the system.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear session disconnect-reasons
Usage:
Sets the counters
for session disconnect reasons to zero (0) in preparation for a
monitoring or troubleshooting session.
Example:
clear session disconnect-reasons
clear session setuptime
Clears the session
setup time statistics for Packet Control Functions (PCFs)
or SGSNs. If
no keyword is specified the summary statistics displayed by the
show session setuptime command
are cleared.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear session setuptime [ pcf [ pcf_addr | all ] | sgsn-address [ sgsn_addr | all ]
pcf [ pcf_addr | all ]
pcf_addr:
Clears the setup time counters for the PCF at the IP address specified
in IPv4 dotted-decimal notation.
all: Clears
the setup time counters for all PCFs.
sgsn-address [ sgsn_addr | all ]
sgsn_addr:
Clears the setup time counters for the SGSN at the IP address specified
in IPv4 dotted-decimal notation.
all: Clears
the setup time counters for all SGSNs.
Usage:
Sets the counters
for session disconnect reasons to zero (0) in preparation for a
monitoring or troubleshooting session.
Example:
To clear the statistics
for the PCF at IP address
192.168.100.10,
enter the following command:
clear session setuptime
pcf 192.168.100.10
clear session subsystem
Clears all session
subsystem statistics for the current context.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear session subsystem
Usage:
Clear the statistics
in preparation for a troubleshooting or monitoring session so that
the counters are at a well known values.
clear sgsn-fast-path
statistics
Clears information
related to SGSN fast-path.
Syntax
show sgsn-fast-path
statistics [ all | smgr-instance smgr_inst ] [ | { grep grep_options | more } ]
all
Deletes collected fast-path
statistics for all session managers.
smgr-instance smgr_inst
Clears collected fast-path
statistics for a session manager instance specified as an integer from
1 to 65535.
| 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.
Please refer to the Regulating the Command
Output section in this reference for details on the usage of grep and more.
Usage:
Use this command to
clear all statistics for SGSN fast-path configurations.
Example:
The following command
deletes all collected fast-path statistics for all SGSN session managers:
clear sgsn-fast-path
statistics
clear sgsn-map-app
Deletes collected statistics
for the SGSN Mobile Application Part (MAP).
Syntax
clear sgsn-map-app statistics [ | { grep grep_options | more } ]
clear sgsn-map-app
statistics
Clears all collected
statistics for the SGSN MAP application.
| 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.
Please refer to the Regulating the Command
Output section in this reference for details on the usage of grep and more.
Usage:
Use this command to
deleted collected statistics for the SGSN MAP application.
Example:
The following command
clears all collected SGSN MAP statistics:
clear sgsn-map-app
statistics
clear sgs-service
Clears SGs interface
statistics associated with a Visitor Location Register (VLR).
Syntax
clear sgs-service { statistics [ name name ] | vlr-status [ service-name name ] [ vlr-name name ] }
statistics [ name name ]
Clears statistics
for all SGs services or a specific SGs service.
name name: Clears
the statistics for an existing SGs service specified as an alphanumeric
string of 1 through 63 characters.
vlr-status [ service-name name ] [ vlr-name name ] }
Clears statistics
for all VLRs, a VLR related to a SGs service, or a specific VLR.
service-name name: Clears
the SGs statistics for an existing VLR specified as an alphanumeric
string of 1 through 63 characters.
Usage:
Use this command to
clear statistics for all SGs services, Visitor Location Registers (VLRS),
or a specific SGs service or VLR name.
Example:
The following command
clears statistics for an SGs service named
sgs2:
clear sgs-service
statistics name sgs2
clear sgtpc statistics
Clears all SGSN GTP-C
(SGTPC) statistics for the current context.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear sgtpc statistics [ gsn-address ipv4_address | sgtp-service sgtp_srvc_name ]
gsn-address ipv4_address
Clears GTPC packet statistics
for the interface specified as an IP address in IPv4 dotted-decimal
notation.
sgtp-service sgtp_srvc_name
Clears GTPC packet statistics
for an existing SGTP service specified as an alphanumeric string
of 1 through 63 characters.
Usage:
Use this command to
clear the statistics in preparation for a troubleshooting or monitoring session.
IMPORTANT:
Statistics are vital
for troubleshooting. We recommend that you check with your Cisco support
personnel prior to clearing these statistics.
Example:
clear sgtpc statistics
sgtp-service SGSN1sgtp12
clear sgtpu statistics
Clears all SGSN GTP-U
(SGTPU) statistics for the current context.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear sgtpu statistics [ ggsn-address ipv4_address | gprs-service gprs_srvc_name nsei nse_id | iups-bind-address ipv4_address | iups-service iups_srvc_name | rnc-address ipv4_address | sgtp-service sgtp_srvc_name ]
ggsn-address ipv4_address
Clears GTPU packet statistics
for a specific GGSN specified as an IP address in IPv4 dotted-decimal
notation.
gprs-service gprs_srvc_name nsei nse_id
gprs-service gprs_srvc_name:
Clears GTPU packet statistics for the interface for a specific GPRS
service specified as an alphanumeric string of 1 through 63 characters.
nsei nse_id:
Specifies a network service entity (NSEI) as an integer from 0 through
65535.
iups-bind-address ipv4_address
Clears GTPU packet statistics
for the bind address of an IuPS interface specified as an IP address
in IPv4 dotted-decimal notation.
iups-service iups_srvc_name
Clears GTPU packet statistics
for an active IuPS service interface specified as an alphanumeric
string of 1 through 63 characters.
rnc-address ipv4_address
Clears GTPU packet statistics
for an RNC specified as an IP address in IPv4 dotted-decimal notation.
sgtp-service sgtp_srvc_name
Clears GTPU packet statistics
for an active SGTP service interface specified as an alphanumeric
string of 1 through 63 characters.
Usage:
Use this command to
clear the statistics in preparation for a troubleshooting or monitoring session.
IMPORTANT:
Statistics are vital
for troubleshooting. We recommend that you check with your Cisco support
personnel prior to clearing these statistics.
Example:
Use this command to
clear collected SGTPU statistics for a specific NSEI of a configured GPRS
service:
clear sgtpu statistics
gprs-service SGSN1Gprs1 nsei 2445
clear sgw-service
statistics
Clears Serving Gateway
(S-GW) statistics and counters found in show command outputs
and bulk statistics associated with all S-GW services or a specific
service defined by the parameter in this command.
Syntax
clear sgw-service
statistics { all | name service_name }
all
Clears statistics
and counters for all S-GW services configured on the system.
name service_name
Clears statistics
and counters for an existing S-GW service name specified as an alphanumeric
string of 1 through 63 characters.
Usage:
Use this command to
clears statistics and counters in show command outputs and bulk statistics
for all S-GW services or for a specific S-GW service.
Example:
The following command
clears statistics and counters for an S-GW service named
sgw3:
clear sgw-service
statistics name sgw3
clear sms statistics
Deletes collected traffic
statistics for the Short Message Service (SMS).
Privilege:
Administrator, Security
Administrator, Operator
Syntax
clear sms statistics [ name map_srvc ] [ | { grep grep_options | more } ]
name map_srvc
Specifies a MAP Service
as an alphanumeric string of 1 through 63 characters.
| { 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 the grep and more commands,
refer to the Regulating
a Command’s Output section of the Command Line Interface
Overview chapter in the Command
Line Interface Reference.
Usage:
Use this command to
delete collected traffic statistics for SMS. It is possible to clear
the statistics of a specific MAP service associated with the SMS
by including the name filter.
Example:
Use the following command
to clear SMS statistics for MAP service
MAP-LONDON1:
clear sms statistics
name MAP-LONDOND1
clear sndcp statistics
Deletes all collected
statistics for the packet traffic going through the Subnetwork Dependent
Convergence Protocol (SNDCP) layer.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear sndcp statistics [ gprs-service srvc_name ] [ | { grep grep_options | more } ]
gprs-service srvc_name
Specifies a GPRS service
as an alphanumeric string of 1 through 63 characters.
| { 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 the grep and more commands,
refer to the Regulating
a Command’s Output section of the Command Line Interface
Overview chapter in the Command
Line Interface Reference.
Usage:
Use this command to
delete all collected SNDCP traffic statistics. Include the gprs-service keyword
to filter the clearing action to only deleted statistics for one
GPRS service.
Example:
Use the following command
to clear all collected SNDCP layer traffic statistics:
clear sndcp statistics
Use the following command
to delete SNDCP layer traffic statistics for the
test1 GPRS
service:
clear sndcp statistics
gprs-service test1
clear snmp trap
Clears all SNMP event
trap notifications from the buffer.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear snmp trap { history | statistics }
history
Clears all SNMP historical
trap information from the system buffer.
statistics
Clears all SNMP event
trap information from the system buffer.
Usage:
Use this command to
empty the buffer of all SNMP trap notifications.
Example:
The following command
clears the all historical SNMP traps from the system buffer:
clear snmp trap history
clear srp
Clears system Service
Redundancy Protocol (SRP) statistics.
Product:
All products that
support Interchassis Session Recovery (ICSR)
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear srp { call-loss statistics | checkpoint statistics | statistics }
call-loss statistics
Clears SRP call loss
history.
checkpoint statistics
Clears SRP checkpoint
interface statistics.
statistics
Clears SRP statistics.
Usage:
Clears the SRP statistics
to prepare the system for SRP monitoring.
Example:
The following command
resets all the associated statistics for SRP checkpoints.
clear srp checkpoint statistics
The following command
resets all the associated statistics for SRP.
clear srp statistics
clear ss7-routing-domain
Deletes specified
statistics for an SS7 routing domain.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear ss7-routing-domain domain_index { asp | mtp2 | mtp3 | qsaa1 | sscf }
domain_index
Specifies the index
number of the SS7 routing domain as an integer from 1 through 12.
asp
Clears statistics and
status information for the SS7 Application Service Part (ASP) in
the specified SS7 routing domain.
m3ua
Clears
statistics and status information for the SS7 MTP3 User Adaptation
Layer (M3UA) in the specified SS7 routing domain.
mtp2
Clears statistics and
status information for the SS7 Message Transfer Part-2 (MTP2) in
the specified SS7 routing domain.
mtp3
Clears statistics and
status information for the SS7 Message Transfer Part-3 (MTP3) in
the specified SS7 routing domain.
qsaal
Clears statistics and
status information for the Service Specific Connection-Oriented Protocol
(SSCOP) sub-layer of the Quasi Signaling Application Adaptation
Layer (QSAAL) in the specified SS7 routing domain.
sscf
Clears statistics and
status information for the Service Specific Coordination Function (SSCF [q.2140])
in the specified SS7 routing domain.
Usage:
Deletes statistics
for the specified SS7 routing domain.
Example:
The following command
clears SS7 ASP routing statistics for domain index
4:
clear ss7-routing-domain
4 asp
clear ssl statistics
Deletes all previously
gathered Secure Sockets Layer (SSL) statistics for a specific P-CSCF
service or all P-CSCF services, either system-wide or within a context.
Product:
SCM (P-CSCF, A-BG)
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear ssl statistics [ service-name name ]
service-name name
Specifies the name
of a P-CSCF service for which to clear SSL statistics as an alphanumeric string
of 1 through 63 characters that is case sensitive.
Usage:
SSL statistics for
a single P-CSCF service can be cleared using the service-name keyword.
SSL statistics for all P-CSCF services can be deleted by entering
the command with no keywords.
If this command is
executed from within the local context with no keywords, SSL statistics will
be cleared for every P-CSCF service configured on the system regardless
of context. In addition, if the service-name keyword
is used when executing from within the local context, SSL statistics
for all P-CSCF services configured with the specified name will
be cleared regardless of context.
Example:
The following command
clears SSL statistics for the P-CSCF service
pcscf_service_1:
clear ssl statistics
service-name pcscf_service_1
clear subscribers
Disconnects subscribers
based on specified criteria.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear subscribers [ keywords ] [ verbose ] [ -noconfirm ]
The keywords are filters
that modify or filter the criteria for deciding which subscriber sessions
to clear and are described below. Multiple keywords can be entered
on a command line.
When multiple keywords
are specified, the subscriber sessions deleted must meet the specifications
of all of the keywords.
For example; if you
enter the following command:
clear subscribers
ip-pool pool1 card-num 1
Only subscriber sessions
that were assigned an IP address from the IP pool named pool1 and
are also being processed by the processing card in slot 1 are cleared.
All other subscriber sessions that do not meet these criteria remain
and are not cleared.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
IMPORTANT:
The Operator privilege
does not have access to this keyword.
active
Only disconnects subscribers
who currently have active sessions.
active-charging-service ecs_service_name
Clears information
for subscribers using the Active charging Service.
ecs_service_name must
be the name of the Active Charging Service, expressed as an alphanumeric
string of 1 through 15 characters.
all
Disconnects all subscribers.
IMPORTANT:
The Operator privilege
does not have access to this keyword.
apn name
Clears all PDP contexts
accessing a specific access point name (APN).
apn_name is
the name of the APN expressed as an alphanumeric string of 1 through
63 characters that is case sensitive.
asn-peer-address ip_address
Clears information
for subscribers on an ASN-GW trusted peer.
ip_address is
the address of the ASN-GW peer server entered using IPv4 dotted-decimal
notation.
asngw-service service_name
Clears counters for
subscribers accessing the ASN-GW service.
service_name must
be an existing service expressed as an alphanumeric string of 1
through 63 characters.
asnpc-service service_name
Clears counters for
subscribers accessing the ASN PC service.
service_name must
be an existing service expressed as an alphanumeric string of 1
through 63 characters.
bandwidth-policy bandwidth_policy_name
Clears information
for subscribers using the specified bandwidth policy.
bandwidth_policy_name must
be the name for an existing bandwidth policy, expressed as an alphanumeric
string of 1 through 63 characters.
callid id
Clears the call specified
by call_id.
The call ID must be specified as a 4-byte hexadecimal number.
card-num card_num
The slot number of
the processing card by which the subscriber session is processed. card_num is
a slot number from 1 through 7 or 10 through 16 (for the ASR 5000)
or from 1 through 4 or 7 through 10 (for the ASR 5500).
cbb-policy cbb_policy_name
Clears information
for subscribers using the specified CBB policy.
cbb_policy_name must
be the name for an existing CBB policy expressed as an alphanumeric
string of 1 through 63 characters.
ccoa-only
This option clears
the subscribers that registered a MIP co-located COA directly with
the HA.
This option is only
valid when MIPHA session license is enabled.
configured-idle-timeout [ < | > | greater-than | less-than ] value
Disconnects subscribers
whose idle timeout matches the specified criteria. A value of 0 (zero)
indicates that the subscribers idle timeout is disabled.
<: Filters
output so that only information less than the specified value is
cleared.
>: Filters
output so that only information greater than the specified value
is cleared.
greater-than:
Filters output so that only information greater than the specified
value is cleared.
less-than:
Filters output so that only information less than the specified
value is cleared.
value: If
no other filtering options are specified only output matching value is
cleared. If value is not
specified all data is cleared. value must
be an integer from 0 through 4294967295.
connected-time [ < | > | greater-than | less-than ] value
Disconnects subscribers
who have been connected for the specified length of time.
<: Filters
output so that only information less than the specified value is
cleared.
>: Filters
output so that only information greater than the specified value
is cleared.
greater-than:
Filters output so that only information greater than the specified
value is cleared.
less-than:
Filters output so that only information less than the specified
value is cleared.
value: If
no other filtering options are specified only output matching value is
cleared. If value is not
specified all data is cleared. value must
be an integer from 0 through 4294967295.
cscf-service service_name
Clears all subscribers
from the specified CSCF service.
service_name must
be an existing service expressed as an alphanumeric string of 1
through 63 characters.
css-delivery-sequence name
IMPORTANT:
This is a restricted
keyword. In
StarOS 9.0 and later, this keyword is obsoleted.
css-service name
IMPORTANT:
This is a restricted
keyword. In
StarOS 9.0 and later, this keyword is obsoleted.
dhcp-server address
Clears all PDP contexts
that currently possess an IP address assigned from a specific DHCP server. dhcp_address is
the IP address of the DHCP server expressed in IPv4 dotted-decimal
notation.
dormant
Only disconnects subscriber
sessions that are dormant (not transmitting or receiving data).
enodeb-address ip_address
Clears subscribers
based on the eNodeB to which they are attached. ip_address must
be a valid IP address of an existing eNodeB entered using IPv4 dotted-decimal
or IPv6 colon-separated-hexadecimal notation.
fa ip_address
Disconnects all subscribers
connected to the foreign agent specified by the IP address in IPv4
dotted-decimal notation.
fa-service fa_name
Disconnects all subscribers
connected to an existing foreign agent name.
firewall { not-required | required }
Clears all subscriber
information for the specified subscribers:
not-required:
Subscribers for whom firewall processing is not-required.
required:
Subscribers for whom firewall processing is required.
firewall-policy fw_policy_name
This keyword is obsolete.
fw-and-nat policy fw&nat_policy_name
Clears information
for subscribers using the specified Firewall-and-NAT policy.
fw&nat_policy_name must
be the name of an existing Firewall-and-NAT policy expressed as
an alphanumeric string of 1 through 63 characters.
fng-service service_name
Clears subscriber sessions
connected to the FNG service. service_name must
be an existing service expressed as an alphanumeric string of 1
through 63 characters.
ggsn-service name
Clears all PDP contexts
accessing an existing GGSN service specified as an alphanumeric string
of 1 through 63 characters that is case sensitive.
gprs-service name
Clears all PDP contexts
associated with the 2G SGSN. This keyword can be used with filtering
keywords that are part of the clear subscriber command
set.
Using this keyword
can trigger a network-initiated service request (paging) procedure.
name identifies
a specific GPRS service configuration expressed as an alphanumeric
string of 1 through 63 characters.
gsm-traffic-class { background | conversational | interactive { priority } | streaming }
Subscribers whose
traffic matches the specified 3GPP traffic class.
- background:
3GPP QoS background class.
- conversational:
3GPP QoS conversational class.
- interactive:
3GPP QoS interactive class. Must be followed by a traffic priority.
priority can be configured to any integer value from 1 to 3.
- streaming:
3GPP QoS streaming class.
gtp-version
Displays the specific
GTP version number. Must be followed by one of the supported GTP versions
(0 or 1).
The following filter
keywords are valid with this command:
active-charging-service,
apn, asngw-service, asnpc-service,
asn-peer-address, bearer-establishment, callid, card-num, coaa-only,
configured-idle-timeout, connected-time, cscf-service,
dhcp-server, fa,
fa-service,
firewall, ggsn-service, gprs-service,
gsm-traffic-class, gtp-version, ha, ha-ipsec-service, ha-service,
idle-time, ims-auth-service, imsi, ip-address, ip-alloc-method,
ip-pool, ipv6-address, ipv6-prefix, l3-tunnel-local-addr, lac, lac-service,
lns, lns-service, long-duration-time-left, mip-udp-tunnel-only, mipv6ha-service,
msid, msisdn, network-requested, network-type, pcf,
pdg-service, pdif-service, pdsn-service,
plmn-type, rulebase,
rx-data, session-time-left
,
sgsn-address,
sgsn-service, tx-data,
username, grep, more
ha address
Disconnects all subscribers
connected to the home agent specified by ha_address must
be specified using IPv4 dotted-decimal notation.
ha-ipsec-only
Disconnects all MIP
HA sessions with IPSec tunnels.
ha-service name
Disconnects all subscribers
connected to the home agent specified by ha_name must
have been previously defined.
hsgw-service name
Disconnects subscribers
using this HRPD Serving Gateway (HSGW) service configured on this
system. name must
be an existing HSGW service expressed as an alphanumeric string
of 1 through 63 characters.
idle-time [ < | > | greater-than | less-than ] value
Disconnects subscribers
whose idle time matches the specified length of time.
<: Filters
output so that only information less than the specified value is
cleared.
>: Filters
output so that only information greater than the specified value
is cleared.
greater-than:
Filters output so that only information greater than the specified
value is cleared.
less-than:
Filters output so that only information less than the specified
value is cleared.
value: If
no other filtering options are specified only output matching value is
cleared. If value is not
specified all data is cleared. value must
be an integer from 0 through 4294967295.
ims-auth-service imsa_service_name
Disconnects subscribers
using this IMS Authorization Service configured on this system.
imsa_service_name must
be an existing IMS Authorization Service expressed as an alphanumeric
string of 1 through 63 characters.
imsi id
Disconnects the subscriber
with the specified id. The IMSI (International Mobile Subscriber Identity)
ID is a 50-bit field which identifies the subscriber’s
home country and carrier. Wildcard characters $ and * are
allowed. The * wildcard matches multiple characters and
the $ wildcard matches a single character. If you do not
want the wildcard characters interpreted as a wildcard enclose them
in single quotes ( ‘ ). For example; ‘$’.
ip-alloc-method { aaa-assigned | dhcp [ relay-agent | proxy-client ] | dynamic-pool | l2tp-lns-assigned | mip-ha-assigned | ms-provided-static | not-ms-provided-static | static
pool }
Displays the specific
IP Allocation Method. Must be followed by one of the IP Allocation Methods:
- aaa-assigned:
Selects subscribers whose IP Addresses were assigned by AAA.
- dhcp: Selects
subscribers whose IP Addresses were assigned by DHCP.
- relay-agent:
Selects subscribers whose IP Addresses were assigned by the DHCP
Relay Agent
- proxy-client:
Selects subscribers whose IP Addresses were assigned by the DHCP
Proxy Client
- dynamic-pool:
Selects subscribers whose IP Addresses were assigned from a dynamic
IP address pool.
- l2tp-lns-assigned:
Selects subscribers whose IP Addresses were assigned by the Layer
2 Tunnelling Protocol Network Server.
- mip-ha-assigned:
Selects subscribers whose IP Addresses were assigned by the Mobile
IP Home Agent.
- ms-provided-static:
Selects subscribers whose IP Addresses were provided by the Mobile
Station.
- not-ms-provided-static:
Selects subscribers whose IP Addresses were not provided by the
Mobile Station.
- static-pool:
Selects subscribers whose IP Addresses were assigned from a static
IP address pool.
ip-address address
Disconnects all subscribers
connected to the specified ip_address.
The address must be specified using IPv4 dotted-decimal notation.
ip-pool name
Disconnects all subscribers
assigned addresses from the IP address pool pool_name. pool_name must
be the name of an existing IP pool or IP pool group.
ipv4
Clears all subscribers
with IPv4 Firewall enabled/disabled.
ipv6
Clears all subscribers
with IPv6 Firewall enabled/disabled.
ipv6-address address
Clears all subscribers
connected to the specified IPv6 address.
ipv6-prefix prefix
Clears subscribers
from a specific IPv6 address prefix.
lac address
Disconnects all calls
to the peer LAC (L2TP access concentrator) specified by address must
be specified using IPv4 dotted-decimal notation.
lac-service name
Disconnects all calls
for this LAC service. name is
an alphanumeric string of 1 through 63 characters.
lma-service name
Disconnects subscribers
using this LMA service configured on this system. name must
be an existing LMA service expressed as an alphanumeric string of
1 through 63 characters.
lns address
Disconnects calls
to the peer LNS (L2TP network server) specified by address must
be specified using IPv4 dotted-decimal notation.
lns-service name
Disconnects calls
associated with the LNS service named name. name is
an alphanumeric string of 1 through 63 characters.
long-duration-time-left [ < | > | greater-than | less-than ] value
Disconnects subscriber
sessions whose time left for the maximum duration of their session matches
the length of time specified.
<: Filters
output so that only information less than the specified value is
cleared.
>: Filters
output so that only information greater than the specified value
is cleared.
greater-than:
Filters output so that only information greater than the specified
value is cleared.
less-than:
Filters output so that only information less than the specified
value is cleared.
value: If
no other filtering options are specified only output matching value is
cleared. If value is not
specified all data is cleared. value must
be an integer from 0 through 4294967295.
mag-service name
Disconnects subscribers
using this Mobile Access Gateway (MAG) service configured on this
system. name must
be an existing MAG service and be from 1 to 63 alphanumeric characters.
mip-udp-tunnel-only
This option clears
the subscribers that negotiated MIP-UDP tunneling with the HA.
This option is only
valid when MIP NAT Traversal license is enabled.
mme-address ipv4_addr
Disconnects subscribers
using this peer Mobility Management Entity (MME). ipv4_addr must
be an existing peer MME IP address entered using IPv4 dotted-decimal
notation.
mme-only
Disconnects all MME
subscriber sessions on the system.
mme-service name
Disconnects subscribers
using this MME service configured on this system. name must
be an existing MME service expressed as an alphanumeric string1
through 63 characters.
msid id
Disconnects the mobile
user identified by ms_id. ms_id must
be from 7 to 16 digits specified as an IMSI, MIN, or RMI. Wildcard
characters $ and * are allowed. The * wildcard
matches multiple characters and the $ wildcard matches
a single character. If you do not want the wildcard characters interpreted as
a wildcard enclose them in single quotes ( ‘ ). For example; ‘$’.
In case of enforce imsi-min equivalence is
enabled on the chassis and MIN or IMSI numbers supplied, this filter
will clear subscribers with a corresponding MSID (MIN or IMSI) whose
lower 10 digits matches to lower 10 digits of the supplied MSID.
clear subscribers
msid 111110123456789 or
clear subscribers
msid 0123456789
will clear any subscriber
with a MSID that match the lower 10 digits of MSID supplied, i.e. 0123456789.
msisdn msisdn
Clears information
for the mobile user identified by Mobile Subscriber ISDN Number (MSISDN). msisdn must
be from 7 to 16 digits specified as an IMSI, MIN, or RMI.
nat { not-required | required [ nat-ip nat_ip_address | nat-realm nat_realm_name ] }
Clears all subscriber
information for the specified subscribers:
not-required:
Subscribers for whom NAT processing is not required.
required:
Subscribers for whom NAT processing is required.
IMPORTANT:
The nat-ip keyword
is only available in StarOS 8.3 and later.
nat-ip nat_ip_address: Subscribers
for whom NAT processing is enabled and are using the specified NAT
IP address. nat_ip_address specifies
the NAT IP address using IPv4 dotted-decimal notation.
nat-realm nat_realm_name: Subscribers
for whom NAT processing is enabled and are using the specified NAT
realm. nat_realm_name specifies
the NAT realm name expressed as an alphanumeric string of 1 through
63 characters.
network-requested
Disconnect subscriber
sessions that were initiated by the GGSN network requested create PDP
context procedure.
network-type { gre | ipv4 | ipv6 | ipip | l2tp | mobile-ip | proxy-mobile-ip }
Disconnects subscriber
sessions based on the network type. The following network types can
be selected:
- gre: Generic
Routing Encapsulation (GRE) per RFC 2784
- ipv4: Internet
Protocol version 4 (IPv4)
- ipv6: Internet
Protocol version 6 (IPv6)
- ipip: IP-in-IP
encapsulation per RFC 2003
- l2tp: Layer
2 Tunneling Protocol encryption per RFC 2661
- mobile-ip:
Mobile IP
- proxy-mobile-ip:
Proxy Mobile IP
pcf [ < | > | less-than | greater-than ] ipv4_address [ [ < | > | less-than | greater-than ] ipv4_address ]
Displays information
for subscribers connected via the packet control function with a specific
or range of IP address
ipv4_ddress.
The address must be specified using IPv4 dotted-decimal notation.
- <: Filters
output so that only information less than the specified IPv4 address
value is displayed.
- >: Filters
output so that only information greater than the specified IPv4
address value is displayed.
- less-than:
Filters output so that only information less than the specified
IPv4 address value is displayed.
- greater-than:Filters
output so that only information greater than the specified IPv4
address value is displayed.
Note: It is possible
to define a limited range of IP addresses by using the less-than
and greater-than options to define minimum and maximum values.
pdsn-service name
Disconnect all subscribers
connected to the packet data service pdsn_name.
The packet data service must have been previously configured.
pdg-service service_name
Disconnects subscriber
sessions that are using the PDG service.
service_name must be an existing
service expressed as an alphanumeric string of 1 through 63 characters.
pdif-service service_name
Clears counters for
subscribers accessing the Packet Data Interworking Function (PDIF) service.
service_name must
be an existing service expressed as an alphanumeric string of 1
through 63 characters.
pgw-only { all | imsi id ebi id | pgw-service name | sgw-address ip_addr }
all: Disconnects
all subscribers for all P-GW services on this system.
imsi id: Disconnects
subscribers based on their International Mobile Subscriber Identification
(IMSI). id must
be the 3-digit MCC (Mobile Country Code), follow by the 2 or 3 digits
of the MNC (Mobile Network Code) and the MSIN (Mobile Subscriber
Identification Number).
id should
not exceed 15 digits.
Example: 123-45-678910234
must be entered as 12345678910234
ebi id: The
EBI (EPS Bearer Identity)
id must
be a valid EBI and be an integer value from 5 to 15.
pgw-service name: Disconnects
all subscribers using this P-GW service.
name must
be an existing P-GW service expressed as an alphanumeric string
of 1 through 63 characters.
sgw-address ip_addr: Disconnects
all subscribers using this S-GW IP address.
ip_addr must
be an existing IP address entered using IPv4 dotted-decimal notation
or IPv6 colon-separated-hexadecimal notation.
plmn-type { home | roaming | visiting }
For GGSN, disconnects
subscribers whose subscriber type matches the specified type.
qci number
Disconnects subscribers
based on their QCI identity. number must
be an integer from 0 to 9.
rulebase rulebase_name
Clears information
for subscribers using the specified rulebase.
rulebase_name must
be name of an existing rulebase expressed as an alphanumeric string
of 1 through 63 characters.
rx-data [ < | > | greater-than | less-than ] value
Disconnects subscribers
who have received the specified number of bytes of data.
<: Filters
output so that only information less than the specified value is
cleared.
>: Filters
output so that only information greater than the specified value
is cleared.
greater-than:
Filters output so that only information greater than the specified
value is cleared.
less-than:
Filters output so that only information less than the specified
value is cleared.
value: If
no other filtering options are specified only output matching value is
cleared. If value is not
specified all data is cleared. value must
be an integer from 0 through 18446744073709551615.
s5-proto { gtp | pmip }
Disconnects subscribers
based on their S5 interface protocol type.
gtp: Indicates
that the GTP protocol is used on the S5 interface for the subscribers
being disconnected.
pmip: Indicates
that the PMIP protocol is used on the S5 interface for the subscribers
being disconnected.
session-time-left [ < | > | greater-than | less-than ] value
The amount of time
left for the subscriber session.
<: Filters
output so that only information less than the specified value is
cleared.
>: Filters
output so that only information greater than the specified value
is cleared.
greater-than:
Filters output so that only information greater than the specified
value is cleared.
less-than:
Filters output so that only information less than the specified
value is cleared.
value: If
no other filtering options are specified only output matching value is
cleared. If value is not
specified all data is cleared. value must
be an integer from 0 through 4294967295.
sgsn-address address
Clears all PDP contexts
currently being facilitated by a specific SGSN.
address is
the IP address of the SGSN entered using IPv4 dotted-decimal notation.
sgsn-service name
Clears all PDP contexts
associated with SGSN. This keyword can be used with filtering keywords
that are part of the clear
subscriber command set.
Using this keyword
can trigger a network-initiated service request (paging) procedure.
name identifies
a specific SGSN-service configuration expressed as an alphanumeric
string of 1 through 63 characters.
sgw-only
Disconnects all S-GW
subscriber sessions on the system.
sgw-service name
Disconnects subscribers
using this Serving Gateway (S-GW) service configured on this system. name must
be an existing S-GW service expressed as an alphanumeric string
of 1 through 63 characters.
tpo { not-required | required }
Clears all subscriber
information for the specified subscribers:
not-required:
Subscribers for whom TPO processing is not required.
required:
Subscribers for whom TPO processing is required.
tx-data [ < | > | greater-than | less-than ] value
Disconnects subscribers
who have transmitted the specified number of bytes of data.
<: Filters
output so that only information less than the specified value is
cleared.
>: Filters
output so that only information greater than the specified value
is cleared.
greater-than:
Filters output so that only information greater than the specified
value is cleared.
less-than:
Filters output so that only information less than the specified
value is cleared.
value: If
no other filtering options are specified only output matching value is
cleared. If value is not
specified all data is cleared. value must be an integer from 0 through 18446744073709551615.
username name
Disconnect the subscriber
with the specified username
name is
the username of the subscriber to be cleared. name must
be a sequence of characters and/or wildcard characters
('$' and '*') from 1 to 127 characters. The * wildcard
matches multiple characters and the $ wildcard matches
a single character. If you do not want the wildcard characters interpreted
as wildcard enclose them in single quotes ( ‘). For example; ‘$’.
verbose
Indicates the output
should provide as much information as possible. If this option is
not specified then the output is the standard level which is the
concise mode.
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.
Usage:
Clear subscribers
sessions to aid in troubleshooting the system when no additional subscribers
may connect or when a specific service or remote address may be
having connection problems. This command may also be used to clear
connections when preparing for maintenance activities.
Related commands to
clear subscription data -
for
SGSN use only
- For a 2G SGSN, the admin-disconnect-behavior
clear-subscription command in the GPRS Service Configuration
mode enables the SGSN to clear subscription data after the administrative
disconnect - clear subscribers
all has been issued.
- For a 3G SGSN, the admin-disconnect-behavior
clear-subscription command in the SGSN Service Configuration
mode enables the SGSN to clear subscription data after the administrative
disconnect - clear subscribers
all has been issued.
Example:
The following examples
illustrate the basic command usage as well as the redirection of
the command output. Not all options are exemplified as all options
follow the same basic constructs.
The following are
basic subscriber clearing examples.
clear subscribers username ser1
clear subscribers ha sampleService
clear subscribers ip-pool
pool2 verbose
The following command
disconnects users connected to the foreign agent with IP address
10.2.3.4.
clear subscribers
fa 10.2.3.4
clear super-charger
Deletes the subscriber’s
backed-up subscription data.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear super-charger { imsi | all }
imsi
Specifies a subscriber’s
international mobile subscriber identity (IMSI) number. This 15-digit
number includes the MCC (mobile country code), the MNC (mobile network
code) and the MSIN (mobile station identification number),
all
Instructs the SGSN
to delete subscription data for all super charger subscribers.
Usage:
Use this command to
clear (delete) the subscription data records for one or all subscribers within
a super charger subscription configuration.
Example:
The following command
deletes the backed up records for the subscriber identified by the IMSI
90121882144672.
clear super-charger
imsi 90121882144672
clear tcap statistics
Deletes the collected
statistics for traffic that has passed through theSS7 TCAP (Transaction
Capabilities Application Part) layer.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
clear tcap statistics [ camel-service [ all | name camel_srvc ] | map-service [ all | name map_srvc ] ] [ | { grep grep_options | more } ]
camel-service [ all | name camel_srvc ]
Deletes TCAP statistics
for either all CAMEL (Customized Applications for Mobile Network
Enhanced Logic, GSM 09.78) services or only for the named CAMEL
service.
map-service [ all | name mapl_srvc ]
Deletes TCAP statistics
for either all MAP services or only for the named MAP service.
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.
Usage:
Use this command to
clear (delete) the collected TCAP statistics for MAP or CAMEL services.
Example:
The following command
deletes the collected statistics for a MAP service named
MAP-Tewk.
clear tcap statistics
map-service name MAP-Tewk
cli
Specifies command
line interface (CLI) session behavior.
Privilege:
Security Administrator,
Administrator, Operator, inspector
Syntax
[ no ] cli { history | stop-on-first-error }
no
Disables the specified
keyword functionality.
history
Enables command line
history for the current command line session. Default: Enabled
stop-on-first-error
When enabled and a
configuration file is loaded, the system stops loading the configuration file
on the first syntax error. Default: Disabled
Usage:
This command controls
CLI settings pertaining to the maintenance of a per-session command
history and syntax error monitoring during configuration file loading.
By default, the system
maintains a list of commands executed during each CLI session. This
list is referred to as a history.
In addition, the system
can be configured to stop loading a configuration if a syntax error
is detected. By default, the system identifies the error but continues
to process the configuration file.
Example:
The following command
disables the keeping of a CLI history for the current session:
no cli history
clock set
Sets the system time.
Privilege:
Security Administrator,
Administrator
Syntax
clock set date_time
date_time
Specifies the date
and time to set the system clock in the format YYYY:MM:DD:HH:mm
or YYYY:MM:DD:HH:mm:ss. Where:
- YYYY = 4-digit
year
- MM = 2-digit
month in the range 01 through 12
- DD = 2-digit
day in the range 01 through 31
- HH = 2-digit
hour in the range 00 through 23
- mm = 2-digit
minute in the range 00 through 59
- ss = 2-digit
second in the range 00 through 59
Usage:
Set the clock to adjust
the system clock for such things as timing drift, day-light savings adjustment,
etc. New settings are immediately applied to all CPUs in the system.
IMPORTANT:
This command should
only be used if there is no NTP server enabled for any context.
If NTP is running on the system, this command returns a failure.
Example:
The following commands
set the system clock where one sets the exact second as well.
clock set 2011:08:05:02:30
clock set 2011:08:05:02:31:30
configure
Sets the mode to the
global configure mode. May also be used to set the mode to the configure
mode and pre-load the configuration referred to by the options.
Privilege:
Security Administrator,
Administrator
Syntax
configure [ url [ verbose ] ]
url
Specifies the location
of a configuration file to pre-load. url may
refer to a local or a remote file. url must
be entered using the following format:
For the ASR 5000:
- [ file: ]{ /flash | /pcmcia1 | /hd } [ /directory ]/file_name
- tftp://{ host[ :port# ] } [ /directory ]/file_name
- [ http: | ftp: | sftp: ]//[ username [ :password ] @ ] { host } [ :port# ] [ /directory ]/file_name
IMPORTANT:
Use of the SMC hard
drive is not supported in this release.
IMPORTANT:
Do not use the following
characters when entering a string for the field names below: “/” (forward
slash), “:” (colon) or “@” (at
sign).
directory is
the directory name.
filename is
the actual file of interest.
username is
the user to be authenticated.
password is
the password to use for authentication.
host is
the IP address or host name of the server.
port# is
the logical port number that the communication protocol is to use.
verbose
Displays the line
number and actual line content from the configuration as it is processed.
Usage:
If no URL is specified,
executing this command causes the CLI to enter the Global Configuration
Mode.
If a URL is specified,
executing this command loads the specified configuration file.
Example:
The following simply
changes the mode to the command line interface global configuration mode.
configure
The following command
loads a configuration file from the node sampleNode given
the path specified and a local file, respectively.
configure ftp://sampleNode/pub/glob.cfg
For the ASR 5000:
configure /pcmcia1/pub/glob.cfg verbose
context
Sets the current context
to the context specified.
Privilege:
Security Administrator,
Administrator, Operator, Inspector
name
Specifies the context
of interest as an alphanumeric string of 1 through 79 characters.
Must be a previously defined context.
Usage:
Change the current
context when it is desired to configure and/or manage a
specific context.
Example:
The following sets
the current context to the
sampleContext context.
context sampleContext
copy
Copies files from
one location to another. Allows files to be copied to/from locally,
as well as from one remote location to another.
Privilege:
Security Administrator,
Administrator
Syntax
copy from_url to_url [ passive ] [ -noconfirm ]
from_url
Specifies the source
of the copy. url may
refer to a local or a remote file. url must
be entered using the following format:
For the ASR 5000:
- [ file: ]{ /flash | /pcmcia1 | /hd }[ /directory ]/file_name
- tftp://{ host[ :port# ] }[ /directory ]/file_name
- [ http: | ftp: | sftp: ]//[ username [ :password ]@ ] { host }[ :port# ][ /directory ]/file_name
IMPORTANT:
Use of the SMC hard
drive is not supported in this release.
IMPORTANT:
Do not use the following
characters when entering a string for the field names below: “/” (forward
slash), “:” (colon) or “@” (at
sign).
directory is
the directory name.
filename is
the actual file of interest.
username is
the user to be authenticated.
password is
the password to use for authentication.
host is
the IP address or host name of the server.
port# is
the logical port number that the communication protocol is to use.
to_url
Specifies the destination
of the copy. url may
refer to a local or a remote file. url must
be entered using the following format:
For the ASR 5000:
- [ file: ]{ /flash | /pcmcia1 | /hd }[ /directory ] /file_name
- tftp://{ host[ :port# ] } [ /directory ] /file_name
- [ ftp: | sftp: ] / / [ username [ :password ] @ ] { host } [ :port# ] [ /directory ] /file_name
IMPORTANT:
Use of the SMC hard
drive is not supported in this release.
directory is
the directory name.
filename is
the actual file of interest.
username is
the user to be authenticated.
password is
the password to use for authentication.
host is
the IP address or host name of the server.
port# is
the logical port number that the communication protocol is to use.
passive
Indicates the file
copy is to use the passive mode.
-noconfirm
Executes the command
without any additional prompt and confirmation from the user.
IMPORTANT:
Use of the -noconfirm option
allows the over writing of an existing file if the destination file
already exists.
Usage:
Copy configuration
files, log files, etc.,to provide backups of data through the network.
Example:
For thew ASR 5000,
the following copies files from the local
/flash/pub directory
to remote node
remoteABC’s
/pcmcia2/pub directory
with and without confirmation respectively.
copy http://remoteABC/pub/june.cfg /flash/pub/june.cfg
copy tftp://remoteABC/pub/june.cfg /pcmcia2/pub/june.cfg
-noconfirm
The following copies
files from remote node
remoteABC to remote
node
remote123.
copy ftp://remoteABC/pub/may.cfg
ftp://remote123/pub/may.cfg
crash copy
Copies individual
crash files (one-at-a-time) and optionally the core dump file from
the stored crash records on the chassis to a user-specified location.
Privilege:
Security Administrator,
Administrator
Syntax
crash copy number number url to_url [ core ]
number number
Specifies the identification
number of the crash record as an integer representing a valid record
number from 1 through 120. To determine the numeric identity of
a specific crash file, use the show crash list command
in Exec mode.
url to_url
Specifies the destination
of the copy. url may
refer to a local or a remote file and must be entered using the
following format:
For the ASR 5000:
- [ file: ] { /flash | /pcmcia1 | /hd } [ /directory ] /
- tftp://{ host[ :port# ] } [ /directory ] /
- [ ftp: | sftp: ]//[ username [ :password ] @ ] { host } [ :port# ] [ /directory ] /
IMPORTANT:
Use of the SMC hard
drive is not supported in this release.
directory: the
name of the target directory.
username: the
username to be authenticated to provide access to targeted server.
password: the
username’s password to be authenticated.
host: the
IP address or host name of the targeted server.
port#: the
number of the target server’s logical port used for the
selected communication protocol.
IMPORTANT:
Do not specify a
target filename as this will prevent the file from writing to the target
server. The system generates and provides a timestamp-based filename
that appears at the destination when the copy command
completes.
core
Copies the core dump
to the targeted storage server. The core cannot be copied alone;
it must be part of a crash
copy action included when copying a crash file.
Usage:
Copy crash files of
core dump to another location for backup or analysis.
Example:
The following uses
FTP to copy stored record number
5 and the core
dump from the crash record list to a targeted remote node directory
called
crasharchive through
port
22 of
the targeted server
remoteABC with
access through user
homeboy whose
password is
secret.7.word.
crash copy number
5 url ftp://homeboy:secret.7.word@ remoteABC:22/crasharchive/ core
crypto-group
Allows the manual
switchover of redundant IPSec tunnels belonging to a specific crypto
group.
Privilege:
Security Administrator,
Administrator, Operator
Syntax
crypto-group name group_name activate { primary | secondary }
name group_name
Specifies the name
of an existing crypto group with which the tunnels to be switched
are associated.
activate { primary | secondary }
Allows you to specify
which tunnel to activate:
- primary:
Switches traffic to the primary tunnel in the group.
- secondary:
Switches traffic to the secondary tunnel in the group.
Usage:
This command is used
in conjunction with the Redundant IPSec Tunnel Fail-over feature.
Use this command to
manually switch traffic to a specific tunnel in a crypto group if
the automatic switchover options have been disabled. Refer to the switchover command
in the Crypto Group configuration mode for more information.
Example:
The following command
manually switches user traffic to the secondary tunnel in the crypto group
called
group1:
crypto-group group1
activate secondary