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.

Platform:

ASR 5000

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.

Platform:

ASR 5000

Product:

All


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).

Platform:

ASR 5000

Product:

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.

Platform:

ASR 5000

Product:

All


Privilege:

Security Administrator, Administrator, Operator


Syntax
alarm cutoff

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.


Example:
alarm cutoff
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.

Platform:

ASR 5000

Product:

SGSN


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.

Platform:

ASR 5000

Product:

All


Privilege:

Security Administrator, Administrator, Operator


Syntax
autoconfirmno 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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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).

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

PDSN, GGSN, ASN-GW, P-GW


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.

Platform:

ASR 5000

Product:

ACS


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.

protocol_name must be one of the following:
  • dns
  • file-transfer
  • ftp
  • http
  • icmp
  • icmpv6
  • imap
  • ip
  • ipv6
  • mms
  • p2p [ application ]: Peer-to-peer analyzer. The supported applications are:
    • actsync
    • aimini
    • applejuice
    • ares
    • armagettron
    • battlefld
    • bittorrent
    • blackberry
    • citrix
    • clubpenguin
    • crossfire
    • ddlink
    • directconnect
    • dofus
    • edonkey
    • facebook
    • facetime

      IMPORTANT:

      The facetime protocol is available only in releases 9.0 and 11.0. This protocol is not available in release 10.0.

    • fasttrack
    • feidian
    • fiesta
    • filetopia
    • florensia
    • freenet
    • fring
    • funshion
    • gadu_gadu
    • gamekit

      IMPORTANT:

      The gamekit protocol is available only in releases 9.0 and 11.0. This protocol is not available in release 10.0.

    • gmail
    • gnutella
    • gtalk
    • guildwars
    • halflife2
    • hamachivpn
    • iax
    • icecast
    • imesh
    • iptv
    • irc
    • isakmp
    • iskoot
    • itunes
    • jabber
    • kontiki
    • manolito
    • maplestory
    • meebo
    • mgcp
    • msn
    • mute
    • myspace
    • nimbuzz
    • octoshape
    • off
    • oovoo
    • openft
    • orb
    • oscar
    • paltalk
    • pando
    • pandora
    • popo
    • pplive
    • ppstream
    • ps3
    • qq
    • qqgame
    • qqlive
    • quake
    • rdp
    • rfactor
    • rmstream
    • scydo
    • secondlife
    • shoutcast
    • skinny
    • skype
    • slingbox
    • sopcast
    • soulseek
    • splashfighter
    • ssdp
    • stealthnet
    • steam
    • stun
    • teamspeak
    • teamviewer
    • thunder
    • tor
    • truphone
    • tvants
    • tvuplayer
    • twitter
    • uusee
    • veohtv
    • viber
    • vpnx
    • vtun
    • warcft3
    • whatsapp
    • wii
    • winmx
    • winny
    • wmstream
    • wofkungfu
    • wofwarcraft
    • xbox
    • xdcc
    • yahoo
    • yourfreetunnel
    • zattoo
  • pop3
  • pptp
  • rtcp
  • rtp
  • rtsp
  • sdp
  • secure-http
  • sip
  • smtp
  • tcp
  • tftp
  • udp
  • wsp
  • wtp
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.

Platform:

ASR 5000

Product:

ACS


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.

Platform:

ASR 5000

Product:

CF


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.

Platform:

ASR 5000

Product:

ACS


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.

Platform:

ASR 5000

Product:

ACS


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.

Platform:

ASR 5000

Product:

ACS


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.

Platform:

ASR 5000

Product:

FW


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.

Platform:

ASR 5000

Product:

FW


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.

Platform:

ASR 5000

Product:

FW, NAT


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.

Platform:

ASR 5000

Product:

ACS


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.

Platform:

ASR 5000

Product:

NAT


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.

Platform:

ASR 5000

Product:

ACS


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).

Platform:

ASR 5000

Product:

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.

Platform:

ASR 5000

Product:

ACS


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.

Platform:

ASR 5000

Product:

ACS


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.

Platform:

ASR 5000

Product:

TPO


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.

Platform:

ASR 5000

Product:

TPO


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.

Platform:

ASR 5000

Product:

CF


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.

Platform:

ASR 5000

Product:

MVG


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.

Platform:

ASR 5000

Product:

All


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

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

HNB-GW


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

ANS-GW


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.

Platform:

ASR 5000

Product:

ANS-GW


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.

Platform:

ASR 5000

Product:

GGSN, P-GW


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.

Platform:

ASR 5000

Product:

PDSN


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.

Platform:

ASR 5000

Product:

SGSN


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.

Platform:

ASR 5000

Product:

SGSN


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.

Platform:

ASR 5000

Product:

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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

MVG


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.

Platform:

ASR 5000

Product:

All


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).

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


Privilege:

Security Administrator, Administrator


Syntax
clear cli history

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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

CF


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

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.

Platform:

ASR 5000

Product:

HNB-GW


Privilege:

Operator


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).

Platform:

ASR 5000

Product:

SCM


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.

Platform:

ASR 5000

Product:

SCM


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.

Platform:

ASR 5000

Product:

SCM


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.

Platform:

ASR 5000

Product:

SCM


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.

Platform:

ASR 5000

Product:

GGSN, ASN-GW, P-GW


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.

Platform:

ASR 5000

Product:

GGSN, ASN-GW, P-GW


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

SCM


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.

Platform:

ASR 5000

Product:

SCM


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).

Platform:

ASR 5000

Product:

HSGW, PDSN, S-GW


Privilege:

Inspector


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.

Platform:

ASR 5000

Product:

MME, P-GW, S-GW


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

FNG


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.

Platform:

ASR 5000

Product:

GGSN


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.

Platform:

ASR 5000

Product:

SGSN


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).

Platform:

ASR 5000

Product:

SGSN


Privilege:

Inspector


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.

Platform:

ASR 5000

Product:

SGSN


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.

Platform:

ASR 5000

Product:

GGSN


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).

Platform:

ASR 5000

Product:

GGSN


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.

Platform:

ASR 5000

Product:

GGSN, SGSN


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).

Platform:

ASR 5000

Product:

GGSN


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.

Platform:

ASR 5000

Product:

P-GW, S-GW, MME


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

HSGW, P-GW, S-GW


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

HNB-GW


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

HNB-GW


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

HSGW


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

MME


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

GGSN

SCM


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.

Platform:

ASR 5000

Product:

PDIF


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.

Platform:

ASR 5000

Product:

PDSN, GGSN ASN-GW


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

HA


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.

Platform:

ASR 5000

Product:

All


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
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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

IPSG


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.

Platform:

ASR 5000

Product:

PDIF


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.

Platform:

ASR 5000

Product:

PDSN, HA GGSN


Privilege:

Administrator, Security Administrator


Syntax
clear ipv6 ospf process 

Usage:

Force a restart of OSPFv3 process using the available configuration.


Example:
clear ipv6 ospf process 
clear l2tp

Clears all or specific Layer 2 Tunnelling Protocol (L2TP) statistics or clears and disconnects all or specified sessions or tunnels.

Platform:

ASR 5000

Product:

PDSN, GGSN, LNS


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.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Inspector


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.

Platform:

ASR 5000

Product:

P-GW


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

P-GW


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

HSGW, S-GW


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

GGSN, SGSN


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

PDSN, GGSN,ASN-GW


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.

Platform:

ASR 5000

Product:

PDSN, HA


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).

Platform:

ASR 5000

Product:

PDSN, HA


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).

Platform:

ASR 5000

Product:

PDSN, HA


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.

Platform:

ASR 5000

Product:

MME


Privilege:

Inspector


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.

Platform:

ASR 5000

Product:

MME


Privilege:

Inspector


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.

Platform:

ASR 5000

Product:

MME


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.

Platform:

ASR 5000

Product:

PDSN, SGSN


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

PDG/TTG


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.

Platform:

ASR 5000

Product:

P-GW


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

PDSN, GGSN


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.

Platform:

ASR 5000

Product:

PDSN, GGSN


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.

Platform:

ASR 5000

Product:

ASN-GW


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

HNB-GW


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

GGSN


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

PDSN, GGSN, ASN-GW, P-GW


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].

Platform:

ASR 5000

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.

Platform:

ASR 5000

Product:

PDSN


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.

Platform:

ASR 5000

Product:

PDSN


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Inspector


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.


Example:
clear session subsystem
clear sgsn-fast-path statistics

Clears information related to SGSN fast-path.

Platform:

ASR 5000

Product:

SGSN


Privilege:

Inspector


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).

Platform:

ASR 5000

Product:

SGSN


Privilege:

Inspector


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).

Platform:

ASR 5000

Product:

MME


Privilege:

Operator


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.

Platform:

ASR 5000

Product:

SGSN


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.

Platform:

ASR 5000

Product:

SGSN


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.

Platform:

ASR 5000

Product:

S-GW


Privilege:

Operator


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).

Platform:

ASR 5000

Product:

SGSN


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.

Platform:

ASR 5000

Product:

SGSN


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

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.

Platform:

ASR 5000

Product:

SGSN


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.

Platform:

ASR 5000

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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

SGSN


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.

Platform:

ASR 5000

Product:

SGSN


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


Privilege:

Security Administrator, Administrator, Operator, Inspector


Syntax
context name
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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

All


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.

Platform:

ASR 5000

Product:

PDSN, GGSN


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