Table Of Contents

NAM CLI Commands:
ip http secure port - monitor nbar

ip http secure server

ip http server

ip http tacacs+

ip interface

ip nameserver

logout

managed-device address

managed-device community

metric export host

metric export non-waas traffic

monitor addrmap

monitor art

monitor art response-times

monitor diffserv host

monitor diffserv matrix

monitor diffserv pdist

monitor diffserv stats

monitor etherstats

monitor etherstats on-switch

monitor history

monitor hlhost

monitor hlmatrix

monitor host

monitor ifstats

monitor interface

NAM CLI Commands:
ip http secure port - monitor nbar

---

This chapter provides information about the following commands:

•ip http secure server

•ip http server

•ip http tacacs+

•ip interface

•ip nameserver

•logout

•managed-device address

•managed-device community

•metric export host

•metric export non-waas traffic

•monitor addrmap

•monitor art

•monitor art response-times

•monitor diffserv host

•monitor diffserv matrix

•monitor diffserv pdist

•monitor diffserv stats

•monitor etherstats

•monitor etherstats on-switch

•monitor history

•monitor hlhost

•monitor hlmatrix

•monitor host

•monitor ifstats

•monitor interface

ip http secure server

To set up a secure server, use the ip http secure server command.

ip http secure server {enable | disable}

Syntax Description

server enable | disable

Enables or disables the HTTP server.

Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

A strong crypto patch is required before applying this command.

Examples

This example shows how to set up a secure server:

root@localhost# ip http secure server enable

Related Commands

ip http port
ip http secure generate
ip http secure install certificate
ip http server
ip http tacacs+
show ip

ip http server

To enable an HTTP server, use the ip http server command.

ip http server {enable | disable}

Syntax Description

enable	Enables the HTTP server.
disable	Disables the HTTP server.

Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how enable an HTTP server:

root@localhost# ip http server enable

Related Commands

ip http port
ip http secure generate
ip http tacacs+
show ip

ip http tacacs+

To enable a TACACS+ server, use the ip http tacacs+ command.

ip http tacacs+ enable primary-srv [backup-srv] [en-secret-key encrypted-secret-key]

ip http tacacs+ disable

Syntax Description

disable	Disables the TACACS+ server.
enable	Enables the TACACS+ server.
primary-srv	Specifies the primary TACAC+ server.
backup-srv	(Optional) Specifies the backup TACACS+ server.
en-secret-key	(Optional) Argument name to enable the secret key.
encrypted-secret-key	(Optional) Argument value.

Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

The en-secret-key keyword is used only during the importing of NAM configurations. This key cannot be used unless you can specify a DES-encrypted string as the argument to this keyword, as in this example:

root@localhost# ip http tacacs+ enable 10.0.0.1 10.0.0.2 en-secret-key "dEAF="

Examples

These examples show how to enable and disable TACACS+.

To enable TACACS+, enter this command:

root@hostname.cisco.com# ip http tacacs+ enable 10.0.0.1 10.0.0.2

Secret key:

Repeat secret key:

Successfully enabled Tacacs+

root@hostname.cisco.com# show ip

IP address:             172.20.98.177

Subnet mask:            255.255.255.192

IP Broadcast:           172.20.255.255

DNS Name:               hostname.cisco.com

Default Gateway:        172.20.98.129

Nameserver(s):          171.69.2.133

HTTP server:            Enabled

HTTP secure server:     Disabled

HTTP port:              80

HTTP secure port:       443

TACACS+ configured:     Yes

TACACS+ primary server: 10.0.0.1

TACACS+ backup server : 10.0.0.2

Telnet:                 Enabled

SSH:                    Disabled

root@hostname.cisco.com#

To disable TACACS+, enter this command:

root@hostname.cisco.com# ip http tacacs+ disable

TACACS+ disabled successfully.

root@hostname.cisco.com# show ip

IP address:             172.20.98.177

Subnet mask:            255.255.255.192

IP Broadcast:           172.20.255.255

DNS Name:               hostname.cisco.com

Default Gateway:        172.20.98.129

Nameserver(s):          171.69.2.133

HTTP server:            Enabled

HTTP secure server:     Disabled

HTTP port:              80

HTTP secure port:       443

TACACS+ configured:     No

Telnet:                 Enabled

SSH:                    Disabled

root@hostname.cisco.com#

Related Commands

ip http port
ip http secure generate
ip http server
show ip

ip interface

To select the external port or the internal ports for the NM-NAM, use the ip interface command.

ip interface external | internal

---

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

---

Syntax Description

external	Selects the RJ-45 Fast Ethernet connector on the NM-NAM.
internal	Selects the internal LAN segment to the router through the PCI interface for IP communication (for example Telnet, SNMP, HTTP, and so forth) to the NM-NAM.

Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is supported only on the NM-NAM.

Examples

This example shows how to specify an interface port for the NM-NAM:

root@localhost# ip interface external

Related Commands

ip address
show ip

ip nameserver

To set or disable system name server entries, use the ip nameserver command.

ip nameserver ip-addr ip-addr ip-addr

or

ip nameserver disable

Syntax Description

ip-addr	Sets the name server address.
disable	Disables the name server entries.

Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to set a system name server:

root@localhost# ip nameserver 171.69.2.133

Related Commands

ip address
show ip

logout

To log out of the system, use the logout command.

logout

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 log out of the NAM:

root@localhost# logout

managed-device address

To configure the managed device address, use the managed-device address command.

managed-device address  <ip-address>

---

Note This command is only valid for Cisco NAM 2200 series appliances.

---

Syntax Description

ip-address

Specifies the IP address of the managed device.

Defaults

No default behavior or values.

Command Modes

Command mode

Examples

The following example sets the managed device IP address, then shows the managed device:

root@nam.cisco.com# managed-device address 10.0.0.1

root@nam.cisco.com# show managed-device 

root@nam.cisco.com# 10.0.0.1

managed-device community

To configure the managed device SNMP community, use the managed-device community command.

managed-device community <rw-community>

---

Note This command is only valid for Cisco NAM 2200 series appliances.

---

Syntax Description

rw-community

Specifies the SNMP community for read/write operations.

Defaults

None.

Command Modes

Command mode

Examples

The following example sets the managed device community:

root@nam.cisco.com# managed-device community private

root@nam.cisco.com# 

metric export host

To configure the metric export host, use the metric export host command. To disable metric export, use the no form of this command.

metric export host ip-address [port]

no metric export

Syntax Description

ip-address	Specifies the IPv4 address of the external reporting console.
port	Port the external reporting console is listening on for incoming packets (optional).

Defaults

The default port is 9995.

Command Modes

Command mode

Usage Guidelines

•Use this command to export ART metrics to an external reporting console.

Examples

The following example specifies the reporting console's IP address as the source to collect ART metrics, then removes this configuration.

root@nam.cisco.com# metric export 10.0.0.1 9995

root@nam.cisco.com# no metric export

metric export non-waas traffic

To send SPAN traffic (non-WAAS traffic) to an external reporting console, use the metric export non-waas traffic command. To disable metric export, use the no form of this command.

metric export non-waas traffic

no metric export non-waas traffic

Syntax Description

This command has no arguments or keywords.

Defaults

Export is disabled.

Command Modes

Command mode

Usage Guidelines

•Use this command to export non-waas (SPAN traffic) metrics to an external reporting console.

Examples

The following example shows how to sent non WAAS traffic to an external reporting console, then removes this configuration:

root@nam.cisco.com# metric export non-waas traffic

root@nam.cisco.com# no metric export non-waas traffic

monitor addrmap

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

monitor addrmap

no monitor addrmap 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 address map collection submode, 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 if random.

•data-source data-source—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 address map collections:

root@localhost.cisco.com# monitor addrmap

     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-addrmap)# data-source vlan1

root@localhost.cisco.com(sub-monitor-addrmap)# exit

     Successfully created an addrmap collection.

root@localhost.cisco.com# show monitor addrmap

    Control index:                65465

    Data source:                  vlan1

    Owner is                      monitor

root@localhost.cisco.com# no monitor addrmap 65465

    Successfully removed the addrmap collection.

Related Commands

show monitor addrmap

monitor art

To enter the ART MIB collection subcommand mode and then monitor ART MIB collections, use the monitor art command. To remove ART MIB collection monitoring, use the no form of this command.

monitor art

no monitor art 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 ART MIB 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.

•max-entries int—(Optional) Specifies the maximum collection entries. Range is from 1 to 65535. Default is 500.

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

---

•rsp-time1int—(Optional) Specifies the collection response time of 1 millisecond. Range is from 0 to 2147483647 (milliseconds). Default is 5 milliseconds.

•rsp-time2 int—(Optional) Specifies the collection response time of 1 millisecond. Range is from 0 to 2147483647 (milliseconds). Default is 15 milliseconds.

•rsp-time3int—(Optional) Specifies the collection response time of 1 millisecond. Range is from 0 to 2147483647 (milliseconds). Default is 50 milliseconds.

•rsp-time4 int—(Optional) Specifies the collection response time of 1 millisecond. Range is from 0 to 2147483647 (milliseconds). Default is 100 milliseconds.

•rsp-time5 int—(Optional) Specifies the collection response time of 1 millisecond. Range is from 0 to 2147483647 (milliseconds). Default is 200 milliseconds.

•rsp-time6 int—(Optional) Specifies the collection response time of 1 millisecond. Range is from 0 to 2147483647 (milliseconds). Default is 500 milliseconds.

•rsp-timeout int—(Optional) Specifies the collection response time timeout in milliseconds. Range is from 0 to 2147483647 (milliseconds). Default is 3000 milliseconds.

•time-remaining seconds—(Optional) Specifies the time remaining in seconds. Range is from 1 to 86400 (seconds). Default is 1800 milliseconds.

Examples

This example shows how to monitor ART MIB collections:

root@localhost.cisco.com# monitor art

     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-art)# data-source vlan1 

root@localhost.cisco.com(sub-monitor-art)# exit 

     Successfully created an art collection.

root@localhost.cisco.com# show monitor art

     Control index:                33060

     Data source:                  vlan1

     Owner is                      monitor

     Status:                       1

     Time remaining:               1707

     Response time 1:              5

     Response time 2:              15

     Response time 3:              50

     Response time 4:              100

     Response time 5:              200

     Response time 6:              500

     Response timeout:             3000

     Maximum entries:              500

     Status:                       1              

root@localhost.cisco.com# no monitor art 33060

     Successfully removed the art collection.

Related Commands

show monitor art

monitor art response-times

To enter the ART MIB collection subcommand mode, and then set response times for the ART MIB collections, use the monitor art response-times command. To remove ART MIB resonse time collection monitoring, use the no form of this command.

monitor art response-times

no monitor art response-times

Defaults

The control index is random.

Command Modes

Command mode

Usage Guidelines

When you enter the ART MIB collection subcommand mode, the following commands are available:

•cancel—Discards changes and exits from the subcommand mode.

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

•help—

•rsp-time1int—(Optional) Specifies the collection response time of 1 millisecond. Range is from 0 to 2147483647 (milliseconds). Default is 5 milliseconds.

•rsp-time2 int—(Optional) Specifies the collection response time of 1 millisecond. Range is from 0 to 2147483647 (milliseconds). Default is 15 milliseconds.

•rsp-time3int—(Optional) Specifies the collection response time of 1 millisecond. Range is from 0 to 2147483647 (milliseconds). Default is 50 milliseconds.

•rsp-time4 int—(Optional) Specifies the collection response time of 1 millisecond. Range is from 0 to 2147483647 (milliseconds). Default is 100 milliseconds.

•rsp-time5 int—(Optional) Specifies the collection response time of 1 millisecond. Range is from 0 to 2147483647 (milliseconds). Default is 200 milliseconds.

•rsp-time6 int—(Optional) Specifies the collection response time of 1 millisecond. Range is from 0 to 2147483647 (milliseconds). Default is 500 milliseconds.

•rsp-timeout int—(Optional) Specifies the collection response time timeout in milliseconds. Range is from 0 to 2147483647 (milliseconds). Default is 3000 milliseconds.

Examples

This example shows how to monitor ART MIB collections:

root@localhost.cisco.com# monitor art response-times

     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-art)# resp-time1 

root@localhost.cisco.com(sub-monitor-art)# exit 

     Successfully created an art collection.

root@localhost.cisco.com# show monitor art

     Control index:                33060

     Data source:                  vlan1

     Owner is                      monitor

     Status:                       1

     Time remaining:               1707

     Response time 1:              5

     Response time 2:              15

     Response time 3:              50

     Response time 4:              100

     Response time 5:              200

     Response time 6:              500

     Response timeout:             3000

     Maximum entries:              500

     Status:                       1              

root@localhost.cisco.com# no monitor art 33060

     Successfully removed the art collection.

Related Commands

show monitor art

monitor diffserv host

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

monitor diffserv host

no monitor diffserv host control-index

Syntax Description

control-index

Specifies the control index. The control index range is from 1 to 65535. Note If the control-index value is not specified for the monitor diffserv host, monitor diffserv matrix, monitor diffserv pdist, and monitor diffserv stats commands, the command defaults to the index of the first aggregate created using the diffserv aggregate command.

Defaults

The control index is random.

Command Modes

Command mode

Usage Guidelines

When you enter the differentiated services host 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.

•ipv4-prefix-len ipv4-prefix-length—(Optional) Sets the IP version 4 prefix length. Default is 32.

•ipv6-prefix-len ipv6-prefix-length—(Optional) Sets the IP version 6 prefix length. Default is 128.

•max-entries number—(Optional) Specifies the maximum differentiated services maximum entries. Range is from 1 to 65535. Default is -1.

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

---

•profile-index profile-index—(Optional) Specifies the differentiated services profile index. Range is from 1 to 65535. Default is the first profile index that exists.

Examples

This example shows how to configure the differentiated services host collections:

root@localhost.cisco.com# monitor diffserv host

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-diffserv-host)# data-source vlan1 

root@localhost.cisco.com(sub-monitor-diffserv-host)# exit 

Successfully created a diffserv host collection.

root@localhost.cisco.com#

root@localhost.cisco.com# show monitor diffserv host

Control index:                24864

Data source:                  vlan1

Owner is                      monitor

Status:                       1

Max entries:                  Max possible

Profile index:                23723

IPv4 prefix length:           32

IPv6 prefix length:           128

root@localhost.cisco.com# no monitor diffserv host 24864

Successfully removed the diffserv host collection.

Related Commands

monitor diffserv host
show monitor diffserv host

monitor diffserv matrix

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

monitor diffserv matrix

no monitor diffserv 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 differentiated services 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. Default is random.

•data-source string—Specifies the collection data source.

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

•max-entries number—(Optional) Specifies the maximum differentiated services maximum entries. Range is from 1 to 65535. Default is -1.

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

---

•profile-index profile-index—(Optional) Specifies the collection profile index. Range is from 1 to 65535. Default is the first profile index that exists.

Examples

This example shows how to configure the differentiated services matrix collections:

root@localhost.cisco.com# monitor diffserv 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-diffserv-matrix)# data-source vlan1 

root@localhost.cisco.com(sub-monitor-diffserv-matrix)# max-entries 50 

root@localhost.cisco.com(sub-monitor-diffserv-matrix)# owner test 

root@localhost.cisco.com(sub-monitor-diffserv-matrix)# exit 

Successfully created a diffserv matrix collection.

root@localhost.cisco.com# show monitor diffserv matrix

Control index:                1269

Data source:                  vlan1

Owner:                        test

Status:                       1

Max entries:                  50

Profile index:                23723

root@localhost.cisco.com# no monitor diffserv matrix 1269

Successfully removed the diffserv matrix collection.

Related Commands

monitor diffserv matrix
show monitor diffserv host

monitor diffserv pdist

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

monitor diffserv pdist

no monitor diffserv 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 differentiated services 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.

•max-entries number—(Optional) Specifies the maximum differentiated services maximum entries. Range is from 1 to 65535. Default is 1.

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

---

•profile-index profile-index—(Optional) Specifies the profile index. Range is from 1 to 65535. Default is the first profile index that exists.

Examples

This example shows how to configure the differentiated services protocol distribution collections:

root@localhost.cisco.com# monitor diffserv 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-diffserv-pdist)# profile-index 31645 

root@localhost.cisco.com(sub-monitor-diffserv-pdist)# data-source allspan 

root@localhost.cisco.com(sub-monitor-diffserv-pdist)# owner monitor 

root@localhost.cisco.com(sub-monitor-diffserv-pdist)# exit 

Successfully created a diffserv pdist collection.

root@localhost.cisco.com# show monitor diffserv pdist

Control index:                61188

Data source:                  allspan

Owner:                        monitor

Status:                       1

Max entries:                  Max possible

Profile index:                31645

root@localhost.cisco.com# no monitor diffserv pdist 61188

Successfully removed the diffserv pdist collection. 

Related Commands

show monitor diffserv pdist

monitor diffserv stats

To enter the differentiated services statistics collection configuration subcommand mode, and then configure the differentiated services statistics collections, use the monitor diffserv stats command. To remove the differentiated services statistics collections, use the no form of this command.

monitor diffserv stats

no monitor diffserv stats 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

Monitor differentiated services command mode

Usage Guidelines

When you enter the differentiated services 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.

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

---

•profile-index profile-index—(Optional) Specifies the profile index. Range is from 1 to 65535. Default is the first profile index that exists.

Examples

This example shows how to configure the differentiated services statistics collections:

root@localhost.cisco.com# monitor diffserv stats

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-diffserv-stats)# data-source vlan1 

root@localhost.cisco.com(sub-monitor-diffserv-stats)# exit 

Successfully created a diffserv stats collection.

root@localhost.cisco.com# show monitor diffserv stats

Control index:                42204

Data source:                  vlan1

Owner:                        monitor

Status:                       1

Profile index:                23723

root@localhost.cisco.com# no monitor diffserv stats 42204

Successfully removed the diffserv stats collection.

Related Commands

show monitor diffserv host

monitor etherstats

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

monitor etherstats

no monitor etherstats control-index

---

Note This command is not valid for the Cisco 2200 Series NAM appliances.

---

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 Ethernet 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 Ethernet statistics collections:

root@localhost.cisco.com# monitor etherstats

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-etherstats)# control-index 15 

root@localhost.cisco.com(sub-monitor-etherstats)# data-source vlan1 

root@localhost.cisco.com(sub-monitor-etherstats)# exit 

Successfully created a etherstats collection.

root@localhost.cisco.com# show monitor etherstats 15

Control index:                15

Data source:                  vlan1

Owner:                        monitor

Status:                       1

root@localhost.cisco.com# no monitor etherstats 15

Successfully removed the etherstats collection.

Related Commands

monitor etherstats on-switch
show monitor etherstats

monitor etherstats on-switch

To enable the supervisor engine mini-RMON statistics polling on the NAM, use the monitor etherstats on-switch command. To disable the supervisor engine mini-RMON statistics polling on the NAM, use the no form of this command.

monitor etherstats on-switch

no monitor etherstats on-switch

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 the NAM-1 and NAM-2. This command is not supported on the NM-NAM.

Examples

This example shows how to enable the supervisor engine mini-RMON statistics polling on the NAM:

root@localhost.cisco.com# monitor etherstats on-switch

Related Commands

show monitor etherstats on-switch

monitor history

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

monitor history

no monitor history 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 history collection subcommand mode, the following commands are available:

•cancel—Discards changes and exits from the subcommand mode.

•buckets number—(Optional) Specifies the bucket size. Range is from 1 to 65535. Default is 50.

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

•interval seconds—(Optional) Interval range is from 1 to 3600 (seconds). Default is 1800.

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

Examples

This example shows how to configure a history collection:

root@localhost.cisco.com# monitor history

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-history)# control-index 5 

root@localhost.cisco.com(sub-monitor-history)# interval 5 

root@localhost.cisco.com(sub-monitor-history)# owner test 

root@localhost.cisco.com(sub-monitor-history)# buckets 100 

root@localhost.cisco.com(sub-monitor-history)# data-source allspan 

root@localhost.cisco.com(sub-monitor-history)# exit 

Successfully created a history collection.

root@localhost.cisco.com# show monitor history 5

Control index:                5

Data source:                  allspan

Owner:                        test

Status:                       1

Buckets:                      100

Interval:                     5

root@localhost.cisco.com# no monitor history 5

Successfully removed the history collection.

Related Commands

show monitor history

monitor hlhost

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

monitor hlhost

no monitor hlhost 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 host layer host collection subcommand mode, the following commands are available:

•cancel—Discards changes and exits from the subcommand mode.

•al-max max-entries—(Optional) Specifies the maximum entries for the application layer. Range is from-1 to 2147483647. Default is -1.

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

•nl-max seconds—(Optional) Specifies the maximum entries for the network layer. Range is from -1 - 2147483647. Default is -1.

•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 a host layer host collection:

root@localhost.cisco.com# monitor hlhost

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-hlhost)# al-max 200 

root@localhost.cisco.com(sub-monitor-hlhost)# nl-max 200 

root@localhost.cisco.com(sub-monitor-hlhost)# control-index 59 

root@localhost.cisco.com(sub-monitor-hlhost)# owner test 

root@localhost.cisco.com(sub-monitor-hlhost)# data-source allspan 

root@localhost.cisco.com(sub-monitor-hlhost)# exit 

Successfully created a hlhost collection.

root@localhost.cisco.com# show monitor hlhost

Control index:                59

Data source:                  allspan

Owner:                        test

Status:                       1

Network layer max entries:    200

Application layer max entries:200

root@localhost.cisco.com# no monitor hlhost 59

Successfully removed the hlhost collection.

Related Commands

show monitor hlhost

monitor hlmatrix

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

monitor hlmatrix

no monitor hlmatrix 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 host layer matrix collection subcommand mode, the following commands are available:

•cancel—Discards changes and exits from the subcommand mode.

•al-max max-entries—(Optional) Specifies the maximum entries for the application layer. Range is from-1 to 2147483647. Default is -1.

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

•nl-max seconds—(Optional) Specifies the maximum entries for the network layer. Range is from -1 - 2147483647. Default is -1.

•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 host layer matrix collections:

root@localhost.cisco.com# monitor hlmatrix

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-hlmatrix)# control-index 15 

root@localhost.cisco.com(sub-monitor-hlmatrix)# data-source vlan1 

root@localhost.cisco.com(sub-monitor-hlmatrix)# al-max 15 

root@localhost.cisco.com(sub-monitor-hlmatrix)# nl-max 15 

root@localhost.cisco.com(sub-monitor-hlmatrix)# exit 

Successfully created a hlmatrix collection.

root@localhost.cisco.com# show monitor hlmatrix 15

Control index:                15

Data source:                  vlan1

Owner:                        monitor

Status:                       1

Network layer max entries:    15

Application layer max entries:15

root@localhost.cisco.com# no monitor hlmatrix 15

Successfully removed the hlmatrix collection.

Related Commands

show monitor hlmatrix

monitor host

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

monitor host

no monitor host 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 host 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 host collections:

root@localhost.cisco.com# monitor host

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-host)# data-source allspan 

root@localhost.cisco.com(sub-monitor-host)# exit 

Successfully created a host collection.

root@localhost.cisco.com# show monitor host

Control index:                16850

Data source:                  allspan

Owner:                        monitor

Status:                       1

root@localhost.cisco.com# no monitor host 16850

Successfully removed the host collection.

Related Commands

show monitor hlmatrix

monitor ifstats

To enable router interface statistics collection on the NM-NAM, use the monitor ifstats command. To disable router interface statistics collection, use the no form of this command.

monitor ifstats

no monitor ifstats

---

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

---

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 only on the NM-NAM.

Examples

This example shows how to enable router interface statistics collection:

root@localhost.cisco.com# monitor ifstats

Successfully enable ifstats collection.

root@localhost.cisco.com# no monitor ifstats

Successfully disable ifstats collection.

Related Commands

show monitor ifstats

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 2200 Series NAM 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 NM-NAM only.

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#