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

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

•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

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 WORD—NFS server dns hostname or ip address.

•dir WORD—An absolute directory with read write permission at the nfs server.

•name WORD—Name 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 WORD—Name of the iSCSI remote storage entry.

•server WORD—SCSI server dns hostname or ip address.

•target WORD—iSCSI target name provided by the iSCSI server admin.

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

•format one-linux—Format 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