Network Analysis Module Command Reference Guide, 4.2
NAM CLI Commands: monitor matrix - preferences
Downloads: This chapterpdf (PDF - 637.0KB) The complete bookPDF (PDF - 4.3MB) | Feedback

NAM CLI Commands: monitor matrix - preferences

Table Of Contents

NAM CLI Commands:
monitor matrix - preferences

monitor interface

monitor matrix

monitor nbar

monitor pdist

monitor priostats

monitor protocol

monitor protocol auto-learned

monitor protocol auto-learned max-entry

monitor protocol auto-learned tcp exclude

monitor protocol auto-learned tcp max-port

monitor protocol auto-learned udp exclude

monitor protocol auto-learned udp max-port

monitor protocol encapsulation

monitor rtp-stream

monitor rtp-stream analysis-interval

monitor rtp-stream enable

monitor rtp-stream filter

monitor rtp-stream max-entry

monitor rtp-stream pkt-loss-alarm

monitor rtp-stream threshold

monitor urlcollection

monitor urlfilter

monitor vlanstats

monitor vlanstats on-switch

monitor voice

monitor voice enable

monitor voice mos quality-range

mpls data-source label

mpls data-source vc

mpls data-source vrf

netflow data-source

netflow device

nslookup

password

patch

pid-sn

ping

preferences


NAM CLI Commands:
monitor matrix - preferences


This chapter describes the following NAM CLI Commands:

monitor interface

monitor matrix

monitor nbar

monitor pdist

monitor priostats

monitor protocol

monitor protocol auto-learned

monitor protocol auto-learned max-entry

monitor protocol auto-learned tcp exclude

monitor protocol auto-learned tcp max-port

monitor protocol auto-learned udp exclude

monitor protocol auto-learned udp max-port

monitor protocol encapsulation

monitor rtp-stream enable

monitor rtp-stream filter

monitor rtp-stream max-entry

monitor rtp-stream pkt-loss-alarm

monitor urlcollection

monitor urlfilter

monitor vlanstats

monitor vlanstats on-switch

monitor voice

monitor voice enable

mpls data-source label

mpls data-source vc

mpls data-source vrf

netflow data-source

netflow device

nslookup

password

patch

pid-sn

ping

preferences

monitor interface

To obtain more network traffic analysis GUI detail about the traffic entering or leaving the access router interface, use the monitor wan-interface command. To disable the interface statistics detail, use the no form of this command.

monitor interface if-index

no monitor interface if-index


Note This command is not valid for NAM-1 or NAM-2 devices or the Cisco NAM 2200 Series appliances.


Syntax Description

if-index

Specifies the SNMP interface index of the router interface.


Defaults

This command has not default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported only on the NME-NAM.

Examples

This example shows how to increase the detail in the interface traffic display:

root@namlab-jet5.cisco.com# monitor interface 24
Successfully enabled wan monitoring on interface ifIndex(24).
root@namlab-jet5.cisco.com#

monitor matrix

To enter the matrix collection configuration subcommand mode, and then configure matrix collections, use the monitor matrix command. To remove the host collections, use the no form of this command.

monitor matrix

no monitor matrix control-index


Note This command is not supported on the NAM Virtual Blade.


Syntax Description

control-index

Specifies the collection control index. Range is from 1 to 65535.


Defaults

The control index is random.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1, NAM-2, NME-NAM-80S, and NME-NAM-120S devices and Cisco NAM 2200 Series appliances.

Usage Guidelines

When you enter the monitor matrix collection subcommand mode, the following commands are available:

cancel—Discards changes and exits from the subcommand mode.

control-index control-index(Optional) Specifies the collection control index. Range is from 1 to 65535.

data-source string—Specifies the collection data source.

exit—Saves changes and exits from the subcommand mode; see the exit command.

owner owner-string(Optional) Specifies the collection owner. Default is monitor.


Note The collections that are configured in the CLI will not be visible in the GUI. For collections that use a GUI screen, you can make them visible in the GUI by using the owner string "LocalMgr."


Examples

This example shows how to configure monitor matrix collections:

root@localhost.cisco.com# monitor matrix
Entering into sub-command mode for this command.
Type 'exit' to come out of this mode.
Type 'cancel' to discard changes and to come out of this mode.
root@localhost.cisco.com(sub-monitor-matrix)# data-source allspan 
root@localhost.cisco.com(sub-monitor-matrix)# owner test 
root@localhost.cisco.com(sub-monitor-matrix)# control-index 5 
root@localhost.cisco.com(sub-monitor-matrix)# exit 
Successfully created a matrix collection.
root@localhost.cisco.com# show monitor matrix 5
Control index:                5
Data source:                  allspan
Owner:                        test
Status:                       1

root@localhost.cisco.com# no monitor matrix 5
Successfully removed the matrix collection.

Related Commands

show monitor matrix

monitor nbar

To enable supervisor NBAR statistics polling, use the monitor nbar command. To disable polling, use the no form of this command.

monitor nbar

no monitor nbar

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no defaults.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

The NBAR-PD-MIB must be present to enable the collection of statistical information.

The device using the command determines where statistics are polled from as follows:

The NME-NAM statistics are polled from the router.

The NAM-1 or NAM-2 statistics are polled from the supervisor engine.

Examples

This example shows how to enable NBAR statistics polling:

root@localhost.cisco.com# monitor nbar
Successful enable nbar collection.
root@localhost.cisco.com# no monitor nbar
Successfully disable nbar collection.

This example shows how to display NBAR statistics polling:

root@localhost.cisco.com# show monitor nbar
nbar collection enabled

Related Commands

show monitor nbar

monitor pdist

To enter the protocol distribution collection configuration subcommand mode, and then configure protocol distribution collections, use the monitor pdist command. To remove the protocol distribution collections, use the no form of this command.

monitor pdist

no monitor pdist control-index

Syntax Description

control-index

Specifies the collection control index. Range is from 1 to 65535.


Defaults

The control index is random.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

When you enter the monitor protocol distribution collection subcommand mode, the following commands are available:

cancel—Discards changes and exits from the subcommand mode.

control-index control-index(Optional) Specifies the collection control index. Range is from 1 to 65535. Default is random.

data-source string—Specifies the collection data source.

exit—Saves changes and exits from the subcommand mode; see the exit command.

owner owner-string(Optional) Specifies the collection owner. Default is monitor.


Note The collections that are configured in the CLI will not be visible in the GUI. For collections that use a GUI screen, you can make them visible in the GUI by using the owner string "LocalMgr."


Examples

This example shows how to configure monitor protocol distribution collections:

root@localhost.cisco.com# monitor pdist
Entering into sub-command mode for this command.
Type 'exit' to come out of this mode.
Type 'cancel' to discard changes and to come out of this mode.
root@localhost.cisco.com(sub-monitor-pdist)# data-source vlan1 
root@localhost.cisco.com(sub-monitor-pdist)# exit 
Successfully created a pdist collection.
root@localhost.cisco.com# show monitor pdist
Control index:                44272
Data source:                  vlan1
Owner:                        monitor
Status:                       1

root@localhost.cisco.com# no monitor pdist 44272
Successfully removed the pdist collection.

Related Commands

show monitor pdist

monitor priostats

To enter the priority statistics collection configuration subcommand mode, and then configure priority statistics collections, use the monitor priostats command. To remove the priority statistics collections, use the no form of this command.

monitor priostats

no monitor priostats control-index


Note This command is not supported on the NAM Virtual Blade.


Syntax Description

control-index

Specifies the collection control index. Range is from 1 to 65535.


Defaults

The control index is random.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1, NAM-2, NME-NAM-80S, and NME-NAM-120S devices and Cisco NAM 2200 Series appliances.

When you enter the monitor priority statistics collection subcommand mode, the following commands are available:

cancel—Discards changes and exits from the subcommand mode.

control-index control-index(Optional) Specifies the collection control index. Range is from 1 to 65535. Default is random.

data-source string—Specifies the collection data source.

exit—Saves changes and exits from the subcommand mode; see the exit command.

owner owner-string(Optional) Specifies the collection owner. Default is monitor.

Examples

This example shows how to configure priority statistics collections:

root@localhost.cisco.com# monitor priostats
Entering into sub-command mode for this command.
Type 'exit' to come out of this mode.
Type 'cancel' to discard changes and to come out of this mode.
root@localhost.cisco.com(sub-monitor-priostats)# data-source vlan1002 
root@localhost.cisco.com(sub-monitor-priostats)# exit 
Successfully created a prio stats collection.

Related Commands

show monitor priostats

monitor protocol

To enter the protocol directory entries configuration subcommand mode, and then configure protocol directory entries, use the monitor protocol command. To remove the protocol directory entries, use the no form of this command.

monitor protocol

no monitor protocol prot-specifier

Syntax Description

prot-specifier

Specifies the protocol entry's SNMP object identifier.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

When you enter the monitor protocol directory entries subcommand mode, the following commands are available:

addressmap enable | disable | not-applicableEnables or disables address map statistics or sets the address map as not applicable for this protocol.

cancel—Discards changes and exits from the subcommand mode.

conversations enable | disable | not-applicableEnables or disables conversations statistics or sets the conversations as not applicable for this protocol.

exit—Saves changes and exits from the subcommand mode; see the exit command.

host enable | disable | not-applicable Enables or disables host statistics or sets the host as not applicable for this protocol.

name string—Enters the full name of the protocol. The name string can contain multiple words.

owner owner-string(Optional) Specifies the collection owner. Default is monitor.


Note The collections that are configured in the CLI will not be visible in the GUI. For collections that use a GUI screen, you can make them visible in the GUI by using the owner string "LocalMgr."


prot-specifier protocol-specifier-string | ip 1-255 | tcp 1-65535 | udp 1-65535 | ncp 1-255 | sunrpc 1-4294967295Specifies the collection protocol by protocol.

range 1-255—Specifies the number of consecutive TCP or UDP ports included in the protocol.

Examples

This example shows how to configure protocol directory entries:

root@localhost.cisco.com# monitor protocol
Entering into sub-command mode for this command.
Type 'exit' to come out of this mode.
Type 'cancel' to discard changes and to come out of this mode.
root@localhost.cisco.com(sub-monitor-protocol)# prot-specifier 
12.1.0.0.1.0.0.8.0.0.0.0.17.3.0 .1.0 
root@localhost.cisco.com(sub-monitor-protocol)# host disable 
root@localhost.cisco.com(sub-monitor-protocol)# conversations disable 
root@localhost.cisco.com(sub-monitor-protocol)# exit 
Successfully updated the protocol directory entry.
root@localhost.cisco.com# show monitor protocol 12.1.0.0.1.0.0.8.0.0.0.0.17.3 .0.1.0 
w-ether2.ip.udp
  Protocol specifier:12.1.0.0.1.0.0.8.0.0.0.0.17.3.0.1.0
  Address map stats: N/A
  Host stats:        Disabled
  Conversation stats:Disabled
  ART stats:         N/A

root@localhost.cisco.com# no monitor protocol 12.1.0.0.1.0.0.8.0.0.0.0.17.3.0 .1.0
Successfully removed the protocol directory entry.
root@localhost.cisco.com# monitor protocol
Entering into sub-command mode for this command.
Type 'exit' to come out of this mode.
Type 'cancel' to discard changes and to come out of this mode.
root@localhost.cisco.com(sub-monitor-protocol)# prot-specifier 
12.1.0.0.1.0.0.8.0.0.0.0.17.3.0 .1.0 
root@localhost.cisco.com(sub-monitor-protocol)# host enable 
root@localhost.cisco.com(sub-monitor-protocol)# addressmap not-applicable 
root@localhost.cisco.com(sub-monitor-protocol)# conversations enable 
root@localhost.cisco.com(sub-monitor-protocol)# art disable 
root@localhost.cisco.com(sub-monitor-protocol)# exit 
Successfully created a protocol directory entry.
root@localhost.cisco.com# show monitor protocol

  Protocol specifier:12.1.0.0.1.0.0.8.0.0.0.0.17.3.0.1.0
  Address map stats: N/A
  Host stats:        Enabled
  Conversation stats:Enabled
  ART stats:         Disabled

Related Commands

show monitor protocol

monitor protocol auto-learned

To enable the automatically learned protocols, use the monitor protocol auto-learned command. To disable automatically learned protocols, use the no form of this command.

monitor protocol auto-learned

no monitor protocol auto-learned

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

Examples

This example shows how to set protocol automatic learning:

root@localhost.cisco.com# monitor protocol auto-learned

Related Commands

show monitor protocol auto-learned settings

monitor protocol auto-learned max-entry

To set the maximum number of automatically learned protocol entries, use the monitor protocol auto-learned max-entry command. To reset the maximum number of automatically learned protocol entries to the default value, use the no form of this command.

monitor protocol auto-learned max-entry entries

no monitor protocol auto-learned max-entry

Syntax Description

entries

Sets the number of automatic learned protocol entries.


Defaults

100 entries.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

Examples

This example shows how to set protocol automatic learning:

root@localhost.cisco.com# monitor protocol auto-learned max-entry 20 

Related Commands

show monitor protocol auto-learned settings

monitor protocol auto-learned tcp exclude

To set the automatically learned protocol feature's TCP port exclusion, use the monitor protocol auto-learned tcp exclude command. To remove the automatically learned protocol feature's TCP port exclusion, use the no form of this command.

monitor protocol auto-learned tcp exclude begin-port | end-port

no monitor protocol auto-learned tcp exclude

Syntax Description

begin-port

Specifies the beginning port for the port exclusion.

end-port

Specifies the ending port for the port exclusion.


Defaults

No TCP port is excluded.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

Examples

This example shows how to set protocol automatic learning:

root@localhost.cisco.com# monitor protocol auto-learned tcp exclude 20 50 

Related Commands

show monitor protocol auto-learned settings

monitor protocol auto-learned tcp max-port

To set the maximum number of TCP port values that the automatically learned protocol feature can learn up to, use the monitor protocol auto-learned tcp max-port command. To reset the maximum TCP port value for automatically learned protocols to the default value, use the no form of this command.

monitor protocol auto-learned tcp max-port max-port

no monitor protocol auto-learned max-port

Syntax Description

max-port

Sets the maximum number of ports that the automatically learned protocol feature can learn up to. Ports above this setting are not learned. Range is from 1 to 65535.


Defaults

The maximum number of learned ports is 65535.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

If you apply the monitor protocol auto-learned tcp max-port 100 command to the NAM, the NAM does not learn protocols that have TCP port values of 101 or more.

Examples

This example shows how to set protocol automatic learning:

root@localhost.cisco.com# monitor protocol auto-learned tcp 

root@localhost.cisco.com# monitor protocol auto-learned

Related Commands

show monitor protocol auto-learned settings

monitor protocol auto-learned udp exclude

To set the automatically learned protocol feature's UDP port exclusion, use the monitor protocol auto-learned udp exclude command. To remove the automatically learned protocol feature's UDP port exclusion, use the no form of this command.

monitor protocol auto-learned udp exclude begin-port | end-port

no monitor protocol auto-learned udp exclude

Syntax Description

begin-port

Specifies the beginning port for the port exclusion.

end-port

Specifies the ending port for the port exclusion.


Defaults

No UDP port is excluded.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

Examples

This example shows how to set protocol automatic learning:

root@localhost.cisco.com# monitor protocol auto-learned udp exclude 20 50 

Related Commands

show monitor protocol auto-learned settings

monitor protocol auto-learned udp max-port

To set the maximum number of UDP port values that the automatically learned protocol feature can learn up to, use the monitor protocol auto-learned udp max-port command. To reset the maximum UDP port values for automatically learned protocols to the default value, use the no form of this command.

monitor protocol auto-learned udp max-port max-port

no monitor protocol auto-learned max-port

Syntax Description

max-port

Sets the maximum number of ports that the automatically learned protocol feature can learn up to. Ports above this setting are not learned. Range is from 1 to 65535.


Defaults

The maximum number of learned ports is 65535.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

If you apply the monitor protocol auto-learned udp max-port 100 command to the NAM, the NAM does not learn protocols that have UDP port values of 101 or more.

Examples

This example shows how to set protocol automatic learning:

root@localhost.cisco.com# monitor protocol auto-learned udp 

Related Commands

show monitor protocol auto-learned settings

monitor protocol encapsulation

To be supplied.

monitor protocol encapsulation

no monitor protocol encapsulation

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

Examples

This example shows how to


Related Commands


monitor rtp-stream

To enable RTP stream monitoring, use the monitor rtp-stream enable command. To disable RTP stream monitoring, use the no form of this command.

monitor rtp-stream <source> <source-mask> <destination> <destination-mask>

no monitor rtp-stream enable <source> <source-mask> <destination> <destination-mask>


Note This command is not supported on the NAM Virtual Blade.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1, NAM-2, NME-NAM-80S, and NME-NAM-120S devices and Cisco NAM 2200 Series appliances.

Examples

This example shows how to enable RTP stream monitoring.

root@localhost# monitor rtp-stream 192.10.10.10 255.255.255.254 172.20.20.20 
255.255.255.254

Related Commands

monitor rtp-stream analysis-interval

To set the RTP stream monitoring interval, use the monitor rtp-stream analysis-interval command.

monitor rtp-stream analysis-interval 60

Syntax Description

nn

Specifies the RTP stream analysis interval in seconds. Default value is 60. .



Note This command is not supported on the NAM Virtual Blade.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1, NAM-2, NME-NAM-80S, and NME-NAM-120S devices and Cisco NAM 2200 Series appliances.

Examples

This example shows how to set the RTP stream anaysis interval to 60.

root@localhost# monitor rtp-stream analysis-interval 60

Related Commands

monitor rtp-stream enable

To enable RTP stream monitoring, use the monitor rtp-stream enable command. To disable RTP stream monitoring, use the no form of this command.

monitor rtp-stream enable

no monitor rtp-stream enable


Note This command is not supported on the NAM Virtual Blade.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1, NAM-2, NME-NAM-80S, and NME-NAM-120S devices and Cisco NAM 2200 Series appliances.

Examples

This example shows how to enable RTP stream monitoring.

root@localhost# monitor rtp-stream enable

This example shows how to disable RTP stream monitoring.

root@localhost# no monitor rtp-stream enable

Related Commands

monitor rtp-stream filter

To set a RTP stream filtering entry, use the monitor rtp-stream filter command. To remove a RTP stream filtering entry, use the no form of the is command.

monitor rtp-stream filter source-address source-mask dest-address dest-mask

Syntax Description

source-address

Specifies the source address of the RTP stream being filtered.

source-mask

Specifies the subnet mask of the source address of the RTP stream being filtered.

dest-address

Specifies the destination address of the RTP stream being filtered.

dest-mask

Specifies the subnet mask of the RTP stream being filtered.



Note This command is not supported on the NAM Virtual Blade.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1, NAM-2, NME-NAM-80S, and NME-NAM-120S devices and Cisco NAM 2200 Series appliances.

Examples

This example shows how to enable RTP stream filtering:

root@localhost# monitor rtp-stream filter 1.2.3.0 255.255.255.0 4.5.0.0 255.255.0.0

Related Commands

monitor protocol encapsulation
monitor rtp-stream max-entry
monitor rtp-stream pkt-loss-alarm

monitor rtp-stream max-entry

To set the maximum number of streams for RTP stream monitoring, use the monitor rtp-stream max-entry command. To set the maximum number of RTP streams for monitoring to manufacturing default value (30), use the no form of this command.

monitor rtp-stream max-entry [max-entries]

no monitor rtp-stream max-entry

Syntax Description

max-entires

Specifies the maximum number of streams you can monitor. Range is from 1 to 100.



Note This command is not supported on the NAM Virtual Blade.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1, NAM-2, NME-NAM-80S, and NME-NAM-120S devices and Cisco NAM 2200 Series appliances.

Examples

This example shows how to enable RTP stream monitoring:

root@localhost.cisco.com# monitor rtp-stream max-entry 50

Related Commands

monitor protocol encapsulation
monitor rtp-stream filter
monitor rtp-stream pkt-loss-alarm

monitor rtp-stream pkt-loss-alarm

To enable alarm for RTP stream packet loss, use the monitor rtp-stream pkt-loss-alarm command. To disable alarm on RTP stream packet loss, use the no form of this command.

monitor rtp-stream pkt-loss-alarm enable threshold

no monitor rtp-stream pkt-loss-alarm

Syntax Description

enable

Enables packet lost monitoring.

threshold

Specifies one of two thresholds in the command. The first threshold is the number of consecutive RTP losses. The second threshold is the packet loss rate in 106 units.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

Examples

This example shows how to enable an alarm for RTP stream monitoring of lost packets:

root@localhost.cisco.com# monitor rtp-stream pkt-loss-alarm 23 44

Related Commands

monitor protocol encapsulation
monitor rtp-stream max-entry

monitor rtp-stream threshold

To set the alarm threshold for the different RTP stream monitoring types, use the monitor rtp-stream threshold command. To disable the alarm threshold RTP stream monitoring, use the no form of this command.

monitor rtp-stream threshold <key_word>

no monitor rtp-stream threshold <key_word>

Syntax Description

Key Word

Action

actual-pkt-loss

Specifies the actual packet loss percentile threshold and enables the actual packet loss threshold alarm.

adjusted-pkt-loss

Specifies the adjusted packet loss percentile threshold and enables the adjusted packet loss threshold alarm.

jitter

Specifies the jitter alarm threshold and enables the jitter threshold alarm in milliseconds.

mos

Specifies the MOS score threshold and enables the MOS score alarm.

soc

Specifies the seconds of concealment threshold and enables the soc alarm.

ssc

Specifies the severe seconds of concealment threshold and enables the ssc alarm.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

Examples

This example shows how to set an alarm threshold of 6% for RTP stream monitoring of lost packets.

root@localhost.cisco.com# monitor rtp-stream adjusted-pkt-loss 6

Related Commands

monitor urlcollection

To enter the URL collection submode and configure URL collections, use the monitor urlcollection command. To disable the URL collection, use the no form of this command.

monitor urlcollection

no monitor urlcollection


Note This command is not supported on the NAM Virtual Blade.


Syntax Description

This command has no keywords or arguments.

Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1, NAM-2, NME-NAM-80S, and NME-NAM-120S devices and Cisco NAM 2200 Series appliances.

Usage Guidelines

When you enter the URL collections submode, the following commands are available:

? or help—Displays help; see the help command.

cancel—Discards changes and exits from the subcommand mode; see the cdp enable command section.

data-source nam-data-source-nameSpecifies the NAM data source name.

exit—Saves changes and exits from the subcommand mode; see the exit command.

ignore(Optional) Sets the host, path, and the URL matching argument.

ignore host—Specifies that you ignore or do not ignore the URL's host part when collecting URL collection data.

ignore path—Specifies that you ignore or do not ignore the URL's parth part when collecting URL collection data.

ignore url-arg—Specifies that you ignore or do not ignore the URL's arguments when collecting URL collection data.

ignore enable | disableEnables or disables this command.

match-only string(Optional) Specifies collecting only the URL data that matches the string in the URL.

max-entry 100 | 50 | 1000(Optional) Specifies the maximum of URL collection entries.

recycle enable | disableEnables or disables aging of the URL collection data entries.

There is only one URL collection in the NAM. The collection owner is always LocalMgr. The index is always one.

This command is supported by the NAM-1, NAM-2, and NME-NAM.

Examples

This example shows how to configure URL collections:

root@localhost# monitor urlcollections
root@localhost# 

Related Commands

clear access log
show monitor urlcollection

monitor urlfilter

To enter the URL filter collection configuration subcommand mode, and then configure URL filters, use the monitor urlfilter command. To remove the URL filters from the configuration, use the no form of this command.

monitor urlfilter

no monitor urlfilter control-index


Note This command is not supported on the NAM Virtual Blade.


Syntax Description

control-index

Specifies the collection control index. Range is from 1 to 65535.


Defaults

The control index is random.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1, NAM-2, NME-NAM-80S, and NME-NAM-120S devices and Cisco NAM 2200 Series appliances.

When you enter the monitor URL filter subcommand mode, the following commands are available:

?—Displays help.

cancel—Discards changes and exits from the subcommand mode.

control-index control-indexSpecifies the URL entry's control index. Range is from 1 to 65535. Default is random.

description string(Optional) Specifies the URL filter's description string.

exit—Saves changes and exits from the subcommand mode; see the exit command.

help—Displays help.

host-regexp—Specifies the regular expression for the URL's host.

path-regexpSpecifies the regular expression of the URL's pathr.

protocol-encap—(Optional) Specifies the protocol encapsulation of the HTTP packet.

The clear configuration command removes the URL filters from the configuration. There is no SNMP support for configuring the URL filters.

Examples

This example shows how to configure URL filters:

root@nam# monitor urlfilter
Entering into subcommand mode for this command.
Type 'exit' to come out of this mode.
Type 'cancel' to discard changes and to come out of this mode.
root@nam(sub-monitor-url-filter)# control-index 2
root@nam(sub-monitor-url-filter)# description urlfilter example
root@nam(sub-monitor-url-filter)# host-regexp www.example.com
root@nam(sub-monitor-url-filter)# protocol-encap ipv4
root@nam(sub-monitor-url-filter)# exit
Sucessfully created urlfilter entry.
root@nam# show monitor urlfilter
Description: urlfilter example
    Control index:             2
    Protocol encapsulation:    IPv4
    URL's host string:         www.example.com
    URL's path string:         (not-set)

To remove this URL filter entry, use the no form of the command:

root@nam# no monitor urlfilter 2
Successfully delete urlfilter entry.

Related Commands

clear access log
show monitor urlfilter

monitor vlanstats

To enter the VLAN statistics collection configuration subcommand mode, and then configure VLAN statistics collections, use the monitor vlanstats command. To remove the VLAN statistics collections, use the no form of this command.

monitor vlanstats

no monitor vlanstats control-index


Note This command is not supported on the NAM Virtual Blade.


Syntax Description

This command has no arguments or keywords.

Defaults

The control index is random.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1, NAM-2, NME-NAM-80S, and NME-NAM-120S devices and Cisco NAM 2200 Series appliances.

When you enter the monitor VLAN statistics collection subcommand mode, the following commands are available:

cancel—Discards changes and exits from the subcommand mode.

control-index control-index(Optional) Specifies the collection control index. Range is from 1 to 65535. Default is random.

data-source string—Specifies the collection data source.

exit—Saves changes and exits from the subcommand mode; see the exit command.

owner owner-string(Optional) Specifies the collection owner. Default is monitor.


Note The collections that are configured in the CLI will not be visible in the GUI. For collections that use a GUI screen, you can make them visible in the GUI by using the owner string "LocalMgr."


Examples

This example shows how to configure VLAN statistics collections:

root@localhost.cisco.com# monitor vlanstats
Entering into sub-command mode for this command.
Type 'exit' to come out of this mode.
Type 'cancel' to discard changes and to come out of this mode.
root@localhost.cisco.com(sub-monitor-vlanstats)#
root@localhost.cisco.com(sub-monitor-vlanstats)# data-source vlan1002 
root@localhost.cisco.com(sub-monitor-vlanstats)# exit 
Successfully created a vlan stats collection.
root@localhost.cisco.com# show monitor vlanstats
Control index:                35955
Data source:                  vlan1002
Owner is                      monitor
Status:                       1

root@localhost.cisco.com# no monitor vlanstats 35955
Successfully removed the vlan stats collection.

Related Commands

show monitor urlcollection

monitor vlanstats on-switch

To configure supervisor engine VLAN statistics collections, use the monitor vlanstats on-switch command. To disable the VLAN statistics collections, use the no form of this command.

monitor vlanstats on-swtich

no monitor vlanstats on-switch


Note This command is not supported on the NAM Virtual Blade.


Syntax Description

This command has no arguments or keywords.

Defaults

This command has not default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1, NAM-2, NME-NAM-80S, and NME-NAM-120S devices and Cisco NAM 2200 Series appliances.

Examples

This example shows how to configure supervisor engine VLAN statistics collections:

root@localhost.cisco.com# monitor vlanstats on-switch
Successfully enable supervisor vlanstats on-switch.

This example shows how to display supervisor engine VLAN statistics collections:

root@localhost.cisco.com# show monitor vlanstats on-switch
Supervisor vlanstats collection is enabled.

This example shows how to disable supervisor engine VLAN statistics collections:

root@localhost.cisco.com# no monitor vlanstats on-switch
Successfully disable supervisor vlanstats on-switch.

Related Commands

show monitor vlanstats on-switch

monitor voice

To enter subcommand mode and set up voice monitoring table sizes, use the monitor voice command.

monitor voice enable

no monitor voice


Note This command is not supported on the NAM Virtual Blade.


Syntax Description

This command has no arguments or keywords.

Defaults

This command has not default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1, NAM-2, NME-NAM-80S, and NME-NAM-120S devices and Cisco NAM 2200 Series appliances.

Examples

This example shows how to enable voice monitoring:

root@localhost.cisco.com# monitor voice enable
Voice monitoring enabled.

Related Commands

show monitor vlanstats on-switch

monitor voice enable

To enable voice monitoring, use the monitor voice enable command. To disable voice monitoring, use the no form of this command.

monitor voice enable

no monitor voice


Note This command is not supported on the NAM Virtual Blade.


Syntax Description

This command has no arguments or keywords.

Defaults

This command has not default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1, NAM-2, NME-NAM-80S, and NME-NAM-120S devices and Cisco NAM 2200 Series appliances.

Examples

This example shows how to enable voice monitoring:

root@localhost.cisco.com# monitor voice enable
Voice monitoring enabled.

Related Commands

show monitor vlanstats on-switch

monitor voice mos quality-range

To configure supervisor engine VLAN statistics collections, use the monitor vlanstats on-switch command. To disable the VLAN statistics collections, use the no form of this command.

monitor vlanstats on-swtich

no monitor vlanstats on-switch


Note This command is not supported on the NAM Virtual Blade.


Syntax Description

This command has no arguments or keywords.

Defaults

This command has not default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1, NAM-2, NME-NAM-80S, and NME-NAM-120S devices and Cisco NAM 2200 Series appliances.

Examples

This example shows how to configure supervisor engine VLAN statistics collections:

root@localhost.cisco.com# monitor vlanstats on-switch
Successfully enable supervisor vlanstats on-switch.

This example shows how to display supervisor engine VLAN statistics collections:

root@localhost.cisco.com# show monitor vlanstats on-switch
Supervisor vlanstats collection is enabled.

This example shows how to disable supervisor engine VLAN statistics collections:

root@localhost.cisco.com# no monitor vlanstats on-switch
Successfully disable supervisor vlanstats on-switch.

Related Commands

show monitor vlanstats on-switch

mpls data-source label

To create a NAM MPLS data source specifically interested in a local MPLS label, use this command. (optionally provide a user-meaningful data source name. , use the mpls data-source label command. To remove the MPLS data source, use the no form of this command.

mpls data-source label data-source-value

no mpls data-source label data-source-value


Note This command is not supported on NME-NAM-80S and NME-NAM-120S devices and the NAM Virtual Blade on NAM-1 and NAM-2 devices or the Cisco NAM 2200 Series appliances.


Syntax Description

data-source-value

Specifies a user-meaningful data source value. Range is from 16 to 1048575.


Defaults

LABEL:label in the data source name.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1 and NAM-2 devices and the Cisco NAM 2200 Series appliances.

Examples

This example shows how to parse set up an MPLS data source on the NAM collect RMON statistics:

root@localhost# mpls data-source label XXXYYY12345
root@localhost#

Related Commands

mpls data-source vc
mpls data-source vrf
show nam data-source

mpls data-source vc

To create a NAM MPLS data source based on an MPLS virtual circuit ID, use the mpls data-source vc command. To remove the MPLS data source, use the no form of this command.

mpls data-source vc vc-id

no mpls data-source vc-id


Note This command is not supported on NME-NAM-80S and NME-NAM-120S devices and the NAM Virtual Blade on NAM-1 and NAM-2 devices or the Cisco NAM 2200 Series appliances.


Syntax Description

vc

Specifies an MPLS data source based on a virtual circuit ID.

vc-id

Specifies the virtual circuit ID. Range is from 1 to 65535.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1 and NAM-2 devices and the Cisco NAM 2200 Series appliances.

Examples

This example shows how to parse and set up an MPLS data source on the NAM collect RMON statistics:

root@localhost# mpls data-source vc 12345
root@localhost#

Related Commands

mpls data-source vrf
mpls data-source label
show nam data-source

mpls data-source vrf

To create a NAM MPLS data source based on and MPLS VRF name string, use the mpls data-source vrf command. To remove the MPLS data source, use the no form of this command.

mpls data-source vrf vrf-name-string

no mpls data-source vrf-name-string


Note This command is not supported on NME-NAM-80S and NME-NAM-120S devices and the NAM Virtual Blade on NAM-1 and NAM-2 devices or the Cisco NAM 2200 Series appliances.


Syntax Description

vrf

Specifies an MPLS data source based on a virtual rf ID.

vrf-name-string

Specifies the virtual rf ID.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported only on NAM-1 and NAM-2 devices and the Cisco NAM 2200 Series appliances.

Examples

This example shows how to parse set up an MPLS data source on the NAM collect RMON statistics:

root@localhost# mpls data-source vrf netflow
root@localhost#

Related Commands

mpls data-source vc
mpls data-source label
show nam data-source

netflow data-source

To enter the NetFlow data source configuration subcommand mode, and then create or edit a custom data source, use the netflow data-source command. To remove a NetFlow custom data source, use the no form of this command.

netflow data-source

no netflow data-source data-source-name

Syntax Description

data-source-name

Specifies the custom NetFlow data source name.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

When you enter the NetFlow data source configuration subcommand mode, the following commands are available:

both (* * * ...)—Specifies a list of ifIndices separated by a space for both input and output data flow directions.

cancel—Discards changes and exits from the subcommand mode; see the cdp enable section.

device (* * * ...)Specifies the NetFlow device's ipV4 address.

exit—Saves changes and exits from the subcommand mode; see the exit command.

index (* * * ...)Specifies the ifIndex of the NetFlow data source. Use 0 when creating a new ifIndex.

input direction (* * * ...)—Specifies a list of ifIndices separated by a space for the input data flow direction.

nameSpecifies the NetFlow data source name.

output direction (* * * ...)—Specifies a list of ifIndices separated by a space for the output data flow direction.

To create a new NetFlow custom data source, you must not provide an index value in the subcommand mode. If an index value is provided, it is an edit of an existing NetFlow custom data source.

The NetFlow custom data source name is prepended with nde-. For example, nde-exampleNetFlow.

You must give NetFlow device information.

All the if-indices values are provided by the NetFlow device. You do not need to provide all three directions (input, output, and both) but there must be at least one of the three.

Examples

This example shows how to configure a remote NetFlow device:

root@localhost# netflow device 10.0.0.2
Successfully created a NetFlow device.
root@localhost# 
root@localhost# netflow data-source 
Entering into subcommand mode for this command.
Type `exit' to come out of this mode.
Type `cancel' to discard changes and to come out of this mode.

root@localhost(sub-netflow-data-source)# device 10.0.0.2
root@localhost(sub-netflow-data-source)# name exampleNetFlow
root@localhost(sub-netflow-data-source)# input 1 2 
root@localhost(sub-netflow-data-source)# output 3 4 5 
root@locaroot(sub-netflow-data-source)# both 22 29
root@locaroot(sub-netflow-data-source)# exit

Related Commands

show nam data-source

netflow device

To configure remote NetFlow devices and create a default data source for the NetFlow device, use the netflow device command. To remove a remote NetFlow device, use the no form of this command.

netflow device device-address [community-string]

no netflow device address

Syntax Description

device-address

Specifies the remote NetFlow device address.

community-string

(Optional) Specifies the remote NetFlow device community string.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

Examples

This example shows how to configure a remote NetFlow device:

root@localhost# netflow device 10.0.0.1 public
Successfully created a netflow device.
root@localhost# show nam data-source
allspan
nde-10.0.0.1

root@localhost# no netflow device 10.0.0.1
Successfully removed the netflow device.

nslookup

To configure name server queries, use the nslookup command.

nslookup hostname [server]

Syntax Description

hostname

Specifies the name server query host.

server

(Optional) Specifies the name server to query.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

Examples

This example shows how to configure name server queries:

root@localhost.cisco.com# nslookup www.yahoo.com
Server:        127.0.0.1
Address:       127.0.0.1#53

Non-authoritative answer:
www.yahoo.com   canonical name = www.yahoo.akadns.net.
Name:  www.yahoo.akadns.net
Address:66.218.71.80

password

To set a new password, use the password command.

password username

Syntax Description

username

Sets the user login name whose password will be changed.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

There are only two valid users, root and guest.

Examples

This example shows how to set a password:

root@localhost.cisco.com# password root
Changing password for user root
New UNIX password:
Retype new UNIX password:
passwd:all authentication tokens updated successfully
root@localhost.cisco.com# 

patch

To download and install a software patch, use the patch command.

patch ftp://user:passwd@host/full-path/filename

Syntax Description

ftp://user:passwd@host/full-path/filename

Sets the path to download the patch.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

Examples

This example shows how to download and install a patch:

root@localhost.cisco.com# patch 
ftp://hostname/fullpath/c6nam-3.6-strong-cryptoK9-patch-1-0.bin
 
Proceeding with installation. Please do not interrupt.
If installation is interrupted, please try again.
 
Downloading c6nam-3.6-strong-cryptoK9-patch-1-0.bin. Please wait...
ftp://hostname/fullpath/c6nam-3.6-strong-cryptoK9-patch-1-0.bin (1K)
-                         [########################]       1K | 1886.33K/s
1891 bytes transferred in 0.00 sec (1569.00k/sec)
 
Verifying c6nam-3.6-strong-cryptoK9-patch-1-0.bin. Please wait...
Patch c6nam-3.6-strong-cryptoK9-patch-1-0.bin verified.
 
Applying /usr/local/nam/patch/workdir/c6nam-3.6-strong-cryptoK9-patch-1-0.bin. Please 
wait...
########################################### [100%]
########################################### [100%]
 
Patch applied successfully.
root@localhost.cisco.com#

Related Commands

show patches
show version

pid-sn

To enter the Product ID and Serial number of a WAE device for node locking with a NAM Virtual Blade product license, use the pid-sn command.

pid-sn PIDnnnn SNnnnn

Syntax Description

PIDnnnn

Specifies the Product ID of the WAE device.

SNnnnn

Specifies the serial number of the WAE device.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is valid only on NAM Virtual Blade platforms.

Examples

This example shows how to ener the Product ID and serial number of a WAE device:

root@localhost# pid-sn WAE-674-K9 KXQCDHDR
root@localhost# 

ping

To check connectivity to a network device, use the ping command.

ping [-n | -v] [-c count] [-i wait] [-p pattern] [-s packetsize] hostname | IP address

Syntax Description

-n

(Optional) Displays the network addresses as numbers.

-v

(Optional) Specifies verbose output.

-c count

(Optional) Stops the ping after sending the count of ECHO_REQUEST packets.

-i wait

(Optional) Specifies the time interval in seconds between sending each packet.

-p pattern

(Optional) Specifies the pad bytes to fill out packets sent in the ping. You may specify up to 16 pad bytes to fill out packets being sent.

-s packetsize

(Optional) Sets the 8 bytes of ICMP header data.

hostname

Sets the hostname of the network device to ping.

IP address

Specifies the IP address of the network device to ping.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

Examples

This example shows how to check the connectivity of a network device with ping:

root@localhost# ping -n -v ralph 100.20.19.23
root@localhost# 

preferences

To enter the preferences subcommand mode, and then configure how your screen displays information, use the preferences command.

preferences

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported on all NAM platforms.

When you enter the preferences subcommand mode, the following commands are available:

cancel—Discards changes and exits from the subcommand mode.

csv-export all | current-screen Sets the comma-separated values export monitor data options.

data-displayed bits | bytesSpecifies how the data is displayed in bits or bytes.

entries-per-screen 1-100—(Optional) Sets the number of rows to display in tabular screens. Default is 15.

exit—Saves changes and exits from the subcommand mode; see the exit command.

format-large-number enable | disableDisplays the GUI counters in large numbers: K(kilo), M(mega), or G(giga).

graph-bars 1-15— (Optional) Sets the number of bars on a displayed graph. Default is 10.

help—Displays help; see the help command.

number-notation commas-dot | dots-comma | spaces-commaSets the number notation to commas or dot and so forth. For example: 1,000 or 1.000 or 300, 10.

refresh-interval 15-3600(Optional) Sets the screen refresh interval in seconds. Default is 60.

resolve-hostname enable | disable(Optional) Enables or disables hostname resolution. Default is enable.

Examples

This example shows how to configure preferences for your screen display:

root@localhost.cisco.com# preferences
Entering into subcommand mode for this command.
Type 'exit' to come out of this mode.
Type 'cancel' to discard changes and to come out of this mode.
root@localhost.cisco.com(sub-preferences)# entries-per-screen 15
root@localhost.cisco.com(sub-preferences)# refresh-interval 60
root@localhost.cisco.com(sub-preferences)# graph-bars 10
root@localhost.cisco.com(sub-preferences)# hostname-resolution disable
root@localhost.cisco.com(sub-preferences)# data-displayed bytes
root@localhost.cisco.com(sub-preferences)# format-large-number enable
root@localhost.cisco.com(sub-preferences)# number-notation comma-dot
root@localhost.cisco.com(sub-preferences)# exit
NAM web interface preferences updated successfully.data

This example shows how to display the configured preferences:

root@localhost.cisco.com# show preferences
Entries per screen:   15
Refresh interval:     60 secs
Number of graph bars: 10
Hostname resolution:  Disabled
Data displayed in:    Bytes
Format large number:  No
Number notation:      Commas-dot
root@localhost.cisco.com# 

Related Commands

show preferences