Network Analysis Module Command Reference Guide, 3.6
P-R Commands
Downloads: This chapterpdf (PDF - 155.0KB) The complete bookPDF (PDF - 2.52MB) | Feedback

22

Table Of Contents

netflow device

nslookup

password

patch

ping

preferences

protocol esp-null-heuristic

reboot

remote-storage nfs

remote-storage iscsi

rmon buffer

rmon channel

rmon filter


22

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

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

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

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

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

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

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

protocol esp-null-heuristic

Use the protocol esp-null-heuristic command to enable and disable the NAM to parse ESP-NULL protocol heuristically.

To enable the NAM to parse ESP-NULL protocol heuristically, use the following command:

protocol esp-null-heuristic enable

To disable the NAM to parse ESP-NULL protocol heuristically, use the following command:

no protocol esp-null-heuristic enable

Syntax Description

This command enables and disables heuristic parsing of ESP-NULL packets.

Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to enable parsing heuristically:

root@localhost# protocol esp-null-heuristic enable 

root@localhost# 

This example shows how to disable parsing heuristically:

root@localhost# no protocol esp-null-heuristic enable 

root@localhost# 

Related Commands

show protocol-feature

reboot

To shut down and then restart the NAM, use the reboot command.

reboot

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 reboot the NAM:

root@localhost# reboot
Reboot the NAM? (Y/N) [N]:
root@localhost# 

remote-storage nfs

To set an NFS remote storage for capturing data and enter the configuration command mode, use the remote-storage nfs command. To remove a NFS remote storage for captured data, use the no remote-storage name command.

remote-storage nfs

no remote-storage name

Syntax Description

name

Specifies the name for the NFS remote storage being removed.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

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

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

cancel—Discards changes and exits from the subcommand mode.

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

server WORDNFS server dns hostname or ip address.

dir WORDAn absolute directory with read write permission at the nfs server.

name WORDName of the nfs remote storage entry.

Examples

This example shows how to configure NFS remote storage for capturing data:

root@hostname.cisco.com# remote-storage nfs
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@hostname.cisco.com(sub-remote-storage_nfs)# ?

root@hostname.cisco.com#

Related Commands

remote-storage iscsi
show remote-storage

remote-storage iscsi

To set an iSCSI remote storage for capture data and enter the configuration command mode, use the remote-storage iscsi command. To remove an iSCSI remote storage entry for capture data, use the no remote-storage name command.

remote-storage iscsi

no remote-storage name

Syntax Description

name

Specifies the name for the NFS remote storage being removed.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

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

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

cancel—Discards changes and exits from the subcommand mode.

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

name WORDName of the iSCSI remote storage entry.

server WORDSCSI server dns hostname or ip address.

target WORDiSCSI target name provided by the iSCSI server admin.

format none partition-numberUntouch the remote iSCSI target partition table and make the NAM use "partition-number" for storing its capture data.

format one-linuxFormat the remote iSCSI target with one linux ext2 partition before using it to store NAM capture data.

Examples

This example shows how to configure a remote storage for caputuring iSCSI data:

root@hostname.cisco.com# remote-storage iscsi
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@hostname.cisco.com(sub-remote-storage_iscsi)# ?

root@hostname.cisco.com#

Related Commands

remote-storage nfs
show remote-storage

rmon buffer

To enter the RMON buffer configuration subcommand mode, and then configure RMON buffers, use the rmon buffer command. To remove RMON buffer configurations, use the no form of this command.

rmon buffer

no rmon buffer 1-65535

Syntax Description

1-65535

RMON buffer OID.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

When you enter the RMON buffer configuration subcommand mode, the following commands are available:

cancel—Discards changes and exits from the subcommand mode.

capture-slice bytes—(Optional) Sets the capture slice size. Default is 500 bytes.

channel-index 1-65535—Sets the channel index. Range is from 1 to 65535.

download-offset offset-number—(Optional) Sets the download offset. Default is 0.

download-slice bytes—(Optional) Sets the download slice size. Default is 500 bytes.

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

full-action lock | wrap(Optional) Sets full action type to lock or wrap. Default is lock when full (lock).

Index(Optional) Sets the index.

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


size bytes—(Optional) Sets the buffer size.

Examples

This example shows how to configure RMON buffers:

root@localhost.cisco.com# rmon buffer
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-rmon-buffer)# channel-index 10
root@localhost.cisco.com(sub-rmon-buffer)# full-action lock
root@localhost.cisco.com(sub-rmon-buffer)# capture-slice 500
root@localhost.cisco.com(sub-rmon-buffer)# download-slice 500
root@localhost.cisco.com(sub-rmon-buffer)# download-offset 0
root@localhost.cisco.com(sub-rmon-buffer)# size 5120000
root@localhost.cisco.com(sub-rmon-buffer)# owner monitor
root@localhost.cisco.com(sub-rmon-buffer)# exit
Successfully created the RMON buffer control entry.
root@localhost.cisco.com# 

root@localhost.cisco.com# show rmon buffer 
Index:               50485
Channel index:       10
Full action:         Lock when full
Capture slice size:  500 bytes
Download slice size: 500 bytes
Download offset:     0
Max octets requested:5120000 bytes
Owner:               monitor

root@localhost.cisco.com# 

Related Commands

show rmon buffer

rmon channel

To enter the RMON channel subcommand mode, and then configure RMON channel collections, use the rmon channel command. To remove RMON channel configurations use the no form of this command.

rmon channel

no rmon channel 1-65535

Syntax Description

1-65535

RMON channel OID.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

When you enter the RMON channel configuration subcommand mode, the following commands are available:

accept-type failed | matched(Optional) Sets the accept type to either failed or matched. Default is matched.

cancel—Discards changes and exits from the subcommand mode.

data-control off | on(Optional) Turns the capture channel off or on. Default is on.

data-source data-source-string—Sets the channel data source.

description string—(Optional) Sets the channel description.

event-status always | ready(Optional) Sets the event status to either always or ready.

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

index 1-65535—(Optional) Sets the channel index. Range is from 1 to 65535.

off-event 0-65535—(Optional) Sets the off event index. Default is 0.

on-event 0-65535—(Optional) Sets the on event index. Default is 0.

owner string—(Optional) Sets the owner string. 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 RMON channels:

root@localhost.cisco.com# rmon channel
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-rmon-channel)# ?
?                         - display help
accept-type               - set accept type
cancel                    - discard changes and exit from subcommand mode
data-control              - set capture channel mode
data-source               - set data source (*)
description               - set description
event-status              - set event status
exit                      - exit from subcommand mode
help                      - display help
index                     - set index
match-event               - set match-event index
off-event                 - set off-event index
on-event                  - set on-event index
owner                     - set owner string

(*) - denotes a mandatory field for this configuration.
root@localhost.cisco.com(sub-rmon-channel)# data-source vlan1
root@localhost.cisco.com(sub-rmon-channel)# accept-type matched
root@localhost.cisco.com(sub-rmon-channel)# data-control on
root@localhost.cisco.com(sub-rmon-channel)# description test
root@localhost.cisco.com(sub-rmon-channel)# event-status ready
root@localhost.cisco.com(sub-rmon-channel)# on-event 10
root@localhost.cisco.com(sub-rmon-channel)# off-event 10
root@localhost.cisco.com(sub-rmon-channel)# match-event 10
root@localhost.cisco.com(sub-rmon-channel)# owner monitor
root@localhost.cisco.com(sub-rmon-channel)# exit
Successfully created the RMON channel.
root@localhost.cisco.com# show rmon channels
Index:               24614
Data source:         vlan1 (5)
Accept type:         Matched (Inclusive)
Data control:        ON
Turn-On event index: 10
Turn-Off event index:10
Event index:         10
Event status:        Ready
Description:         test
Owner:               monitor

root@localhost.cisco.com#

Related Commands

show rmon channels

rmon filter

To enter the RMON filter subcommand mode, and then configure RMON filters, use the rmon filter command. To remove RMON filter configurations use the no form of this command.

rmon filter

no rmon filter 1-65535

Syntax Description

1-65535

RMON filter OID.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

When you enter the RMON filter configuration subcommand mode, the following commands are available:

cancel—Discards changes and exits from the subcommand mode.

channel-index 1-65535—Sets the channel index. Range is from 1 to 65535.

data hex-string—(Optional) Sets data.

data-mask hex-string—(Optional) Sets the data mask.

data-not-mask hex-string—(Optional) Sets the data-not-mask.

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

index 1-65535—(Optional) Sets the filter index. Range is from 1 to 65535.

offset number—(Optional) Sets the offset. Default is 0.

owner string—(Optional) Sets the owner string. 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."


pd-data-index number—(Optional) Sets the protocol directory data local index. Default is 0.

pd-index number—(Optional) Sets the protocol directory local index. Default is 0.

status number—(Optional) Sets the packet status. Default is 0.

status-mask number—(Optional) Sets the packet status mask. Default is 0.

status-not-mask number—(Optional) Sets the packet status not mask. Default is 0.

Examples

This example shows how to configure RMON filters:

root@localhost.cisco.com# rmon filter
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-rmon-filter)# ?
?                         - display help
cancel                    - discard changes and exit from subcommand mode
channel-index             - set channel index (*)
data-mask                 - set data mask
data-not-mask             - set data not mask
data                      - set data (*)
exit                      - exit from subcommand mode
help                      - display help
index                     - set filter index
offset                    - set offset
owner                     - set owner string
pd-data-index             - set protocol directory data local index
pd-index                  - set protocol directory local index
status-mask               - set packet status mask
status-not-mask           - set packet status not mask
status                    - set packet status

(*) - denotes a mandatory field for this configuration.
root@localhost.cisco.com(sub-rmon-filter)# channel-index 10
root@localhost.cisco.com(sub-rmon-filter)# data "ab bc cd 2f"
root@localhost.cisco.com(sub-rmon-filter)# offset 0
root@localhost.cisco.com(sub-rmon-filter)# owner monitor
root@localhost.cisco.com(sub-rmon-filter)# exit
Successfully created the RMON filter.
root@localhost.cisco.com# show rmon filters
Index:          11089
Channel index:  10
Data offset:    0
Data:           ab bc cd 2f
Data mask:
Data not mask:
Status:         0
Status mask:    0
Status not mask:0
PD index:       0
PD data index:  0
Owner:          monitor

root@localhost.cisco.com# 

Related Commands

show rmon buffer