Network Analysis Module Command Reference Guide, 4.0
NAM CLI Commands: ip http secure port - monitor nbar
Downloads: This chapterpdf (PDF - 571.0KB) The complete bookPDF (PDF - 3.66MB) | Feedback

NAM CLI Commands: ip http secure port - monitor nbar

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#