Table Of Contents
NAM CLI Commands:
monitor matrix - preferences
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 auto-learned udp max-port
monitor protocol encapsulation
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 h.323
monitor voice mgcp
monitor voice sccp
monitor voice sip
mpls data-source label
mpls data-source vc
mpls data-source vrf
netflow data-source
netflow device
nslookup
password
patch
ping
preferences
NAM CLI Commands:
monitor matrix - preferences
This chapter describes the following NAM CLI Commands:
•
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 filter
•
monitor rtp-stream max-entry
•
monitor rtp-stream pkt-loss-alarm
•
monitor urlcollection
•
monitor urlfilter
•
monitor vlanstats
•
monitor vlanstats on-switch
•
monitor voice h.323
•
monitor voice mgcp
•
monitor voice sccp
•
monitor voice sip
•
mpls data-source label
•
mpls data-source vc
•
mpls data-source vrf
•
netflow data-source
•
netflow device
•
nslookup
•
password
•
patch
•
ping
•
preferences
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
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
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
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
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 NM-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
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
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
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
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
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
When you enter the monitor protocol directory entries subcommand mode, the following commands are available:
•
addressmap enable | disable | not-applicable— Enables 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-applicable— Enables 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-4294967295—Specifies 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
Protocol specifier:12.1.0.0.1.0.0.8.0.0.0.0.17.3.0.1.0
Conversation stats:Disabled
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
Conversation stats:Enabled
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
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
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
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
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
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
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 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 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
Examples
This example shows how to
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.
|
Defaults
This command has no default settings.
Command Modes
Command mode
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 number RTP streams for monitoring, use the monitor rtp-stream max-entry command. To set the max number of RTP streams for monitoring to manufracturing 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.
|
Defaults
This command has no default settings.
Command Modes
Command mode
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
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 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
Syntax Description
This command has no keywords or arguments.
Defaults
This command has no default settings.
Command Modes
Command mode
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-name—Specifies 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 | disable—Enables 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 | disable—Enables 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 NM-NAM.
Examples
This example shows how to configure URL collections:
root@localhost# monitor urlcollections
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
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
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-index—Specifies 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-regexp—Specifies 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
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 valid for NM-NAM devices, NME-NAM devices, or the Cisco 2200 Series NAM appliances.
Syntax Description
This command has no arguments or keywords.
Defaults
The control index is random.
Command Modes
Command mode
Usage Guidelines
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
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
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 the NAM-1 and NAM-2 only.
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 h.323
To enter the H.323 voice collection configuration subcommand mode, and then configure H.323 voice collections, use the monitor voice h.323 command. To disable the H.323 voice collections, use disable in the monitor voice h.323 subcommand mode.
monitor voice h.323
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Modes
Command mode
Usage Guidelines
When you enter the monitor voice H.323 statistics collection subcommand mode, the following commands are available:
•
cancel—Discards changes and exits from the subcommand mode.
•
disable—Disables H.323 voice collections.
•
enable—Enables H.323 voice collections.
•
exit—Saves changes and exits from the subcommand mode; see the exit command.
•
max-calls—Specifies the number of call table rows. Range is from 10 to 1000. Default is 200.
•
max-phones—Specifies the number of phone table rows. Range is from 10 to 1000. Default is 200.
•
top-jitter-rows—Specifies the number of top jitter rows. Range is from 1 to 20. Default is 5.
•
top-loss-rows—Specifies the number of top loss rows. Range is from 1 to 20. Default is 5.
Examples
This example shows how to configure H.323 voice collections:
root@localhost.cisco.com# monitor voice h.323
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-voice-h.323)# disable
root@localhost.cisco.com(sub-monitor-voice-h.323)# exit
Successfully disabled the h.323 voice collection with changes.
root@localhost.cisco.com# show monitor voice h.323
H.323 voice monitoring: Disabled
Number of phone table rows: 200
Number of call table rows: 1000
Number of top packet jitter rows: 5
Number of top packet loss rows: 5
Related Commands
monitor voice h.323
show monitor vlanstats
monitor voice mgcp
To enter the Media Gateway Control Protocol (MGCP) collection configuration subcommand mode, and then configure MGCP collections, use the monitor voice mgcp command. To disable MGCP collections, use disable in the monitor voice mgcp subcommand mode.
monitor voice mgcp
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Modes
Command mode
Usage Guidelines
When you enter the monitor voice MGCP statistics collection subcommand mode, the following commands are available:
•
cancel—Discards changes and exits from the subcommand mode.
•
disable—Disables MGCP collections.
•
enable—Enables MGCP collections.
•
exit—Saves changes and exits from the subcommand mode; see the exit command.
•
max-calls—Specifies the number of call table rows. Range is from 10 to 1000. Default is 200.
•
max-phones—Specifies the number of phone table rows. Range is from 10 to 1000. Default is 200.
•
top-jitter-rows—Specifies the number of top jitter rows. Range is from 1 to 20. Default is 5.
•
top-loss-rows—Specifies the number of top loss rows. Range is from 1 to 20. Default is 5.
Examples
This example shows how to configure MGCP collections:
root@localhost.cisco.com# monitor voice mgcp
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-voice-mgcp)# disable
root@localhost.cisco.com(sub-monitor-voice-mgcp)# exit
Successfully disabled the MGCP collection with changes.
Root@localhost# show monitor voice mgcp
MGCP voice monitoring: Disabled
Number of phone table rows: 150
Number of call table rows: 150
Number of top packet jitter rows: 7
Number of top packet loss rows: 7
Related Commands
monitor voice h.323
show monitor vlanstats
monitor voice sccp
To enter the Skinny Client Control Protocol (SCCP) voice statistics collection configuration subcommand mode, and then configure SCCP voice collection, use the monitor voice sccp command. To disable SCCP voice collection, use disable in the monitor voice sccp subcommand mode.
monitor voice sccp
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Modes
Command mode
Usage Guidelines
When you enter the monitor voice SCCP statistics collection subcommand mode, the following commands are available:
•
cancel—Discards changes and exits from the subcommand mode.
•
disable—Disables SCCP voice collections.
•
enable—Enables SCCP voice collections.
•
exit—Saves changes and exits from the subcommand mode; see the exit command.
•
max-calls—Specifies the number of call table rows. Range is from 10 to 1000. Default is 300.
•
max-phones—Specifies the number of phone table rows. Range is from 10 to 1000. Default is 300.
•
top-jitter-rows—Specifies the number of top jitter rows. Range is from 1 to 20. Default is 5.
•
top-loss-rows—Specifies the number of top loss rows. Range is from 1 to 20. Default is 5.
Examples
This example shows how to configure voice SCCP statistics collections:
root@localhost.cisco.com# monitor voice sccp
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-voice-sccp)# top-loss-rows 500
ERROR:You have specified a number of loss rows which is not valid.
The number of loss rows must be between 1 and 20.
root@localhost.cisco.com(sub-monitor-voice-sccp)# top-loss-rows 20
root@localhost.cisco.com(sub-monitor-voice-sccp)# top-jitter-rows 20
root@localhost.cisco.com(sub-monitor-voice-sccp)# exit
Successfully enabled the sccp voice collection with changes.
root@localhost.cisco.com# show monitor voice sccp
SCCP voice monitoring: Enabled
Number of phone table rows: 300
Number of call table rows: 100
Number of top packet jitter rows: 20
Number of top packet loss rows: 20
Related Commands
monitor voice h.323
show monitor vlanstats
monitor voice sip
To enter the Session Initiation Protocol (SIP) voice statistics collection configuration subcommand mode, and then configure SIP voice collection, use the monitor sip command. To disable SIP voice collection, use disable in the monitor sip subcommand mode.
monitor voice sip
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Modes
Command mode
Usage Guidelines
When you enter the monitor voice SIP statistics collection subcommand mode, the following commands are available:
•
? or help—Displays help; see the help command.
•
cancel—Discards changes and exits from the subcommand mode.
•
disable—Disables SIP voice collections.
•
exit—Saves changes and exits from the subcommand mode; see the exit command.
•
enable—Enables SIP voice collections.
•
max-calls—Specifies the maximum number of rows in the call table. Range is from 10 to 1000. Default is 200.
•
max-phones—Specifies the maximum number of rows in the phone table. Range is from 10 to 1000. Default is 200.
•
top-jitter-rows—Specifies the maximum number of rows in the top jitter table. Range is from 1 to 20. Default is 5.
•
top-loss-rows—Specifies the maximum number of rows in the top percent packet loss table. Range is from 1 to 20. Default is 5.
Examples
This example shows how to configure SIP collections:
root@namlab-kom6.cisco.com# monitor voice sip
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@namlab-kom6.cisco.com(sub-monitor-voice-sip)# enable
root@namlab-kom6.cisco.com(sub-monitor-voice-sip)# max-calls 250
root@namlab-kom6.cisco.com(sub-monitor-voice-sip)# max-phones 500
root@namlab-kom6.cisco.com(sub-monitor-voice-sip)# top-jitter-rows 20
root@namlab-kom6.cisco.com(sub-monitor-voice-sip)# top-loss-rows 20
root@namlab-kom6.cisco.com(sub-monitor-voice-sip)# exit
Successfully enabled the sip voice collection with changes.
root@namlab-kom6.cisco.com# show monitor voice sip
SIP voice monitoring: Enabled
Number of phone table rows: 500
Number of call table rows: 250
Number of top packet jitter rows: 20
Number of top packet loss rows: 20
root@namlab-kom6.cisco.com#
Related Commands
show monitor voice
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
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
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
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
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
Examples
This example shows how to parse set up an MPLS data source on the NAM collect RMON statistics:
root@localhost# mpls data-source vc 12345
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
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
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
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
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.
•
name—Specifies 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# 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
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
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
Examples
This example shows how to configure name server queries:
root@localhost.cisco.com# nslookup www.yahoo.com
Non-authoritative answer:
www.yahoo.com canonical name = www.yahoo.akadns.net.
Name: www.yahoo.akadns.net
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
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
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
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
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
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
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
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 | bytes—Specifies 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 | disable—Displays 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-comma—Sets 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
Refresh interval: 60 secs
Hostname resolution: Disabled
Number notation: Commas-dot
root@localhost.cisco.com#
Related Commands
show preferences