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

NAM CLI Commands: alarm event - ip http secure port

Table Of Contents

NAM CLI Commands:
alarm event - ip http secure port

alarm event

alarm mib

application group

audit-trail enable

autostart

cdp enable

cdp hold-time

cdp interval

clear access log

clear system-alerts

clock set

config clear

config network

config upload

coredump

custom-filter capture

custom-filter decode

debug log disable

debug log enable

debug log level

debug log reset

diffserv aggregate

diffserv profile

email

entity alias

entity assetid

exit

exsession

ftp

help

ip address

ip broadcast

ip gateway

ip host

ip hosts add

ip hosts delete

ip http port

ip http secure generate

ip http secure install certificate

ip http secure port


NAM CLI Commands:
alarm event - ip http secure port


This chapter contains an alphabetical listing of the commands unique to the Catalyst 6500 series and Cisco 7600 series Network Analysis Module (NAM), Cisco 2200 Series NAM appliances, and Cisco Branch rotuer series NME-NAM and NM-NAM modules.

For information about Cisco IOS commands that are used to configure the switch, refer to the current Cisco IOS documentation including:

Catalyst 6500 Series Switch Cisco IOS Software Configuration Guide

Catalyst 6500 Series Switch Cisco IOS Software Command Reference

For information about Catalyst operating system commands that are used to configure the switch, refer to the current Catalyst operating system documentation including:

Catalyst 6500 Series Switch Configuration Guide

Catalyst 6500 Series Switch Command Reference

Unless otherwise noted, the following commands are valid for all network analysis modules.

This chapter describes the following commands:

alarm event

alarm mib

application group

audit-trail enable

autostart

cdp enable

cdp hold-time

cdp interval

clear access log

clear system-alerts

clock set

config clear

config network

config upload

coredump

custom-filter capture

custom-filter decode

debug log disable

debug log enable

debug log level

debug log reset

diffserv aggregate

diffserv profile

email

entity alias

entity assetid

exit

exsession

ftp

help

ip address

ip broadcast

ip gateway

ip host

ip hosts add

ip hosts delete

ip http port

ip http secure generate

ip http secure install certificate

ip http secure port

alarm event

To enter the alarm event configuration subcommand mode, and then configure alarm NAM events, use the alarm event command. To remove an alarm event, use the no form of this command.

alarm event

no alarm event 1-65535

Syntax Description

1-65535

Specifies the event control index.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

When you enter the alarm event submode, the following commands are available:

cancel—Discards changes and exits from the subcommand mode.

community community_string—(Optional) Sets the community string.

description description-string—Sets the alarm description.

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

index index(Optional) Sets the alarm index. Range is from 1 to 65535.

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


type [both | log | none | trap](Optional) Sets the event to both log and trap, log, none, or trap.

Examples

This example shows how to configure an alarm event:

root@hostname.cisco.com# alarm event
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@hsotname.cisco.com(sub-alarm-event)# ?
?                         - display help
cancel                    - discard changes and exit from subcommand mode
community                 - set community string
description               - set description
exit                      - exit from subcommand mode
help                      - display help
index                     - set index
owner                     - set owner string
type                      - set type
root@hostname.cisco.com(sub-alarm-event)# community public
root@hostname.cisco.com(sub-alarm-event)# description test-event
root@hostname.cisco.com(sub-alarm-event)# index 100
root@hostname.cisco.com(sub-alarm-event)# owner monitor
root@hostname.cisco.com(sub-alarm-event)# type both
root@hostname.cisco.com(sub-alarm-event)# exit
Successfully created the event.
root@hostname.cisco.com# show alarm event
Index:      100
Description:test-event
Type:       Log and trap
Community:  public
Owner:      monitor
root@hostname.cisco.com#

Related Commands

alarm mib
show alarm event
show alarm mib
show alarm voice

alarm mib

To enter the alarm MIB configuration subcommand mode, and then configure NAM MIB alarms, use the alarm mib command. To remove an alarm MIB entry, use the no form of this command.

alarm mib

no alarm mib 1-65535

Syntax Description

1-65535

Specifies the event control index.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

When you enter the alarm MIB submode, 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.

falling-event 1-65535Sets the falling event index. Range is from 1 to 65535.

falling-threshold number (Optional) Sets the number of packets for the falling event threshold. Default is 0 packets.

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

interval seconds(Optional) Sets the polling interval in seconds. Default is 60 seconds.

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


rising-event 1-65535Sets the rising event index. Range is from 1 to 65535.

rising-threshold number(Optional) Sets the number of packets for the rising event threshold. Default is 0 packets.

sample-type absolute | deltaSets the sample type to absolute or delta.

startup-alarm both | falling | risingSets the startup alarm to both rising and falling, falling, or rising.

variable OIDSets the object identifier (OID) variable.

Examples

This example shows how to set a MIB alarm:

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-alarm-mib)# ?
?                         - display help
cancel                    - discard changes and exit from subcommand mode
exit                      - exit from subcommand mode
falling-event             - set falling event index (*)
falling-threshold         - set number of pkts for falling threshold
help                      - display help
index                     - set alarm index
interval                  - set polling interval
owner                     - set owner string
rising-event              - set rising event index (*)
rising-threshold          - set number of pkts for rising threshold
sample-type               - set sample type (*)
startup-alarm             - set startup alarm (*)
variable                  - set variable (*)
 
(*) - denotes a mandatory field for this configuration.
root@hostname.cisco.com(sub-alarm-mib)# falling-event 100
root@hostname.cisco.com(sub-alarm-mib)# rising-event 100
root@hostname.cisco.com(sub-alarm-mib)# sample-type delta
root@hostname.cisco.com(sub-alarm-mib)# startup-alarm both
root@hostname.cisco.com(sub-alarm-mib)# variable nlHostInPkts.29673.0.1.4.10.77.201.68
root@hostname.cisco.com(sub-alarm-mib)# exit
Successfully created the NAM MIB alarm.
root@hostname.cisco.com# show alarm mib
Index:               19967
Polling interval:    60 secs
Variable:            nlHostInPkts.29673.0.1.4.10.77.201.68
Sample type:         Delta
Startup:             Rising & falling
Rising threshold:    0 Pkts
Falling threshold:   0 Pkts
Rising event index:  100
Falling event index: 100
Owner:               monitor

root@hostname.cisco.com#

Related Commands

alarm mib
show alarm event
show alarm mib
show alarm voice

application group

To enter the application group submode and define an application group, use the application group command.

application group

no application group group-name

Syntax Description

group-name

Application group name.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

When you enter the application group submode, the following commands are available:

add protocol-specifierAdds a protocol to the group. You only can add one protocol to a group at a time (for example, HTTPS). This command allows you to group statistics for more than one specified protocol into one counter.

To add two or more protocols to an application group, repeat the add command for each protocol. The protocols are added only when you exit application group subcommand mode.

cancel—Discards changes and exits from the subcommand mode; see the cdp enable section.

delete protocol-specifierRemoves a protocol from the group. You only can remove one protocol from a group at a time.

To remove two or more existing protocols from an existing application group, repeat the delete command for each protocol. The protocol is removed only when you exit the application group subcommand mode.

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

help—Displays help and keeps you in the application group subcommand mode; see the "help" command section.

name string—Sets the the application group name.

You must provide protocol specifiers in the add or delete parameters, or both the add and delete parameters.

Examples

This example shows how to create an application group named appBrpSample with two protocols in the group:

root@NAM# application group
Entering into subcommand mode for this command.
Type 'exit' to come out of this mode.
Type 'cancel' to discard changes and to come out of this mode.
root@NAM(sub-application-group)# ?
?                         - display help
add                       - add a protocol to the group (*)
cancel                    - discard changes and exit from subcommand mode
delete                    - remove a protocol from the group (*)
exit                      - exit from subcommand mode
help                      - display help
name                      - set application group name (*)

(*) - denotes a mandatory field for this configuration.
root@NAM(sub-application-group)# add 16.1.0.0.1.0.0.8.0.0.0.0.6.0.0.3.68.4.0.1.0.0
root@NAM(sub-application-group)# add 16.1.0.0.1.0.0.8.0.0.0.0.17.0.0.4.60.4.0.1.0.0
root@NAM(sub-application-group)# name appGrpSample
root@NAM(sub-application-group)# exit
Sucessfully create application group appGrpSample.
root@NAM#
root@NAM#
root@NAM# show application group appGrpSample
Application Group: appGrpSample
    Number of Protocols: 2
      - w-ether2.ip.tcp.tcp-836
        16.1.0.0.1.0.0.8.0.0.0.0.6.0.0.3.68.4.0.1.0.0
      - w-ether2.ip.udp.udp-1084
        16.1.0.0.1.0.0.8.0.0.0.0.17.0.0.4.60.4.0.1.0.0

root@NAM#

Related Commands

show application group

audit-trail enable

To enable and audit trail of GUI and CLI accesses, use the audit-trail enable command. To disable audit trail of GUI and CLI accesses, use the no form of this command:

audit-trail enable

no audit-trail enable

Defaults

Audit trail of the CLI and GUI accesses is enabled.

Command Modes

Command mode

Examples

This example shows how to enable an audit trail for GUI and CLI accesses:

root@hostname.cisco.com# audit-trail enable

Related Commands

show audit-trail

autostart

To enable or disable autostart collections, use the autostart command.

autostart collection {enable | disable}

Syntax Description

collection

Specifies a collection. Valid collections are etherstats, addressmap, priostats, vlanstats, and art.

enable

Enables autostart.

disable

Disables autostart.


Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to enable autostart collections on the NAM:

root@hostname.cisco.com# autostart ?
addressmap                - enable/disable autostart address map
art                       - enable/disable autostart art
etherstats                - enable/disable autostart ether stats
priostats                 - enable/disable autostart prio stats
vlanstats                 - enable/disable autostart vlan stats
root@hostname.cisco.com# autostart etherstats enable 
root@hostname.cisco.com# show autostart 
etherstats enable
addressmap disable
priostats disable
vlanstats disable
art disable
root@hostname.cisco.com# 

Related Commands

show autostart

cdp enable

To enable the Cisco Discovery Protocol (CDP) on the NM-NAM, use the cdp enable command. To disable CDP on the NM-NAM, use the no form of this command.

cdp enable

no cdp enable


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

Examples

This example shows how to enable CDP:

root@localhost.cisco.com# cdp enable
root@localhost.cisco.com#

Related Commands

cdp hold-time
cdp interval
show cdp settings

cdp hold-time

To set the Cisco Discovery Protocol (CDP) messages hold time, use the cdp hold-time command. To return the CDP messages hold time to the default value, use the no form of this command.

cdp hold-time time

no cdp hold-time


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


Syntax Description

time

Specifies the CDP hold time. Range is from 10 to 255 seconds.


Defaults

180 seconds.

Command Modes

Command mode

Examples

This example shows how to set the CDP messages hold time:

root@localhost.cisco.com# cdp hold-time 30
root@localhost.cisco.com#

Related Commands

cdp enable
cdp interval
show cdp settings

cdp interval

To set the Cisco Discovery Protocol (CDP) messages interval on the NM-NAM, use the cdp interval command. To return the CDP messages interval on the NM-NAM to the default value, use the no form of this command.

cdp interval time

no cdp interval


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


Syntax Description

time

Specifies the CDP messages interval. Range is from 5 to 254 seconds.


Defaults

60 seconds

Command Modes

Command mode

Examples

This example shows how to set the CDP messages interval:

root@localhost.cisco.com# cdp interval 200
root@localhost.cisco.com#

Related Commands

cdp enable
cdp hold-time
show cdp settings

clear access log

To clear the access log, use the clear access log command.

clear access-log

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 clear the access log:

root@localhost# clear access-log

Related Commands

clock set
config clear

clear system-alerts

To clear the system alerts, use the clear system-alerts command.

clear system-alerts

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 clear the system alerts:

root@localhost# clear system-alerts

Related Commands

clear access log
config clear

clock set

To set the date and time of a Cisco NAM 2200 series appliance, use the clock set command.

clock set <hh:mm:ss:> <mm/dd/yyyy>


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


Syntax Description

hh:mm:ss:

hh=hour, mm=minutes, ss=seconds

mm/dd/yyyy

mm = month, dd=day, yyyy=year


Defaults

This command has no default settings.

Command Modes

Command mode

Examples

The following example shows how to set the clock the NAM appliance.

root@nam.cisco.com# clock set 06:10:00 08/04/2008

config clear

To reset the NAM and return it to the factory-default state, use the config clear command.

config clear [all | ip]

Syntax Description

all

(Optional) Resets the NAM to the factory-default state including the NAM IP parameters configuration. The NAM reboots automatically for the changes to take effect.

ip

(Optional) Resets the NAM IP parameters to the manufacturing-default state. The NAM reboots automatically, and you must session into the NAM from the switch supervisor engine to configure the NAM IP parameters so that the module can come online.


Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to clear the configuration:

root@localhost# config clear
This operation will reset the NAM configuration with the exception
of NAM IP parameters.

This operation will also reboot the NAM to allow the changes to
take effect.

Do you wish to continue? (y/n) [n]:y
Successfully updated the SCCP configuration.
Successfully updated the H.323 configuration.
NAM syslog settings updated successfully.
NAM web interface preferences updated successfully.

Successfully modified the configuration.
NAM will be rebooted now, for the changes to take effect ...

config network

To import a NAM configuration into the NAM from a specified location, use the config network command.

config network url

Syntax Description

url

Specifies the NAM configuration location.


Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to download a configuration file to a NAM named kluu-test.config, which is located at the FTP server namlab-pc1 in the user home directory named /home/kluu directory.

root@NAM #
root@NAM # config network ftp://kluu@namlab-pc1//home/kluu/kluu-test.config
Downloading ftp://kluu@namlab-pc1//home/kluu/kluu-test.config, please wait ...

Password for kluu@namlab-pc1:
ftp://kluu@namlab-pc1//home/kluu/kluu-test.config (9K)
/tmp/lrcfile.txt.1007     [########################]       9K | 4916.90K/s
9748 bytes transferred in 0.00 sec (4274.44k/sec)

Download completed.

Configuring the NAM. This may take few minutes, please wait ...

NAM configuration completed.
To view the results, use the command 'show log config'.
root@NAM #

config upload

To upload the running NAM configuration to a specified location, use the config upload command.

config upload url [filename]

Syntax Description

url

Specifies the configuration location.

filename

(Optional) Specifies the filename for the configuration.


Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to upload the NAM running configuration to the FTP server named namlab-pc1 with a filename of example.config:

root@NAM# config upload ftp://kluu@namlab-pc1.cisco.com example.config
Building configuration, please wait... Done.

Uploading the configuration to 'example.config'
on 'ftp://kluu@namlab-pc1.cisco.com', This may take few minutes ...

Password:

Successfully uploaded the NAM configuration.
root@NAM#

coredump

To retrieve the core dump file, use the coredump command.

coredump ftp://user:passwd@host/full-path/

Syntax Description

ftp://user:passwd@host/full-path/

Sets the path to the core dump file.


Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to retrieve a core dump:

root@localhost# coredump ftp://user:passwd@host/full-path/

custom-filter capture

To enter the custom filter capture subcommand mode, and then configure custom filter capture settings, use the custom-filter capture command. To remove custom filter capture, use the no capture-filter filtername command.

custom-filter capture

no capture-filter filtername

Syntax Description

filtername

Specifies the filter to remove.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

When you enter the custom filter capture submode, the following commands are available:

base OID(Optional) Sets the base object identifier (OID) variable.

cancel—Discards changes and exits from the subcommand mode.

data hex-string(Optional) Sets the data.

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

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

description string(Optional) Sets the filter description.

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

filter-name stringSets the filter name.

offset 0-65535(Optional) Sets the offset. Range is 0 to 65535.

protocol OID Sets the protocol object identifier (OID) variable.

status 0-65535 (Optional)Sets the status. Range is 0 to 65535.

status-mask 0-65535(Optional) Sets the status mask. Range is 0 to 65535.

status-not-mask 0-65535(Optional) Sets the status-not mask. Range is 0 to 65535.

Examples

This example shows how to configure custom filter settings:

root@localhost# custom-filter capture
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-custom-filter-capture)# 

Related Commands

custom-filter capture
custom-filter decode
show custom-filter capture
show custom-filter decode

custom-filter decode

To enter the custom-filter decode subcommand mode, and then configure custom filter decode settings, use the custom-filter decode command. To remove custom filter decode, use the no decode-filter filtername command.

custom-filter decode

no decode-filter filtername

Syntax Description

filtername

Specifies the filter to remove.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

When you enter the custom-filter decode submode, the following commands are available:

address-type ip | mac(Optional) Sets the address type to IP or MAC.

base OID(Optional) Sets the base object identifier (OID) variable.

cancel—Discards changes and exits from the subcommand mode.

data hex-string(Optional) Sets the data.

description string(Optional) Sets the filter description.

direction both | single(Optional) Applies the filter to both directions or a single direction.

dst-address address(Optional) Sets the traffic destination address.

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

filter-expression expression-string(Optional) Sets the filter expression.

filter-name stringSets the filter name.

offset 0-1518(Optional) Sets the offset. Range is 0 to 1518.

protocol string Sets the protocol.

src-address address (Optional)Sets the data stream source address.

Examples

This example shows how to custom filter decode settings:

root@localhost<sub># custom-filter decode
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-custom-filter-decode)# filter-name 12345

Related Commands

custom-filter capture
custom-filter decode
show custom-filter capture
show custom-filter decode

debug log disable

To disable debug logging, use the debug log disable command.

debug log disable

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default behavior or settings.

Command Modes

Command mode

Examples

The following example disables all debug logging:

root@nam.cisco.com# debug log disable

debug log enable

To enable debug logging, use the debug log enable command.

debug log enable

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default behavior or settings.

Command Modes

Command mode

Examples

The following example disables all debug logging:

root@nam.cisco.com# debug log enable

debug log level

To set the debug log level for each module running in NAM system, use the debug log-level command

show debug log level <log-feature> <log-level>

Syntax Description

log-feature

Possible feature names include the following:
ART, CAPTURE, CDP, COLL_SHARED, DSMON_HOST, DSMON_MATRIX, DSMON_PDIST, DSMON_STATS, ENTITY, ETHERSTATS, FM, FR, MAIN, MISC, RMON, RPC, DSRC, PARSER, PPROC, RTP, METRIC_ENGINE, OTHER, PORT_TABLE, MPLS_STATS, POLLD, RMON1_HOST, RMON1_MATRIX, RMON2_ADDRMAP, RMON2_HOST, RMON2_MATRIX, RMON2_PDIST, SMON_PRIO, SMON_VLAN, SNMP, SRSNMP, SWPOLLD, TREND_DAEMON, TREND_RPC, TREND_SNMP, URL_COLLECTION, WAAS,

log-level

A value between 0 and 7 which represents the following log levels:

0—Critical
1—Error
2—Warning
3—Notice
4—Info
5—Debug
6—Debug2
7—Debug3


Defaults

This command has no default behavior or settings.

Command Modes

Command mode

Examples

The following example shows how to set the automated response time (ART) feature to display all log messages up to log level 2. This command will log all messages generated by the ART module that have log levels set to Critical, Error and Warning.

root@nam.cisco.com# debug log level ART 2

debug log reset

To reset debug logging level back to default settings, use the debug log reset command.

debug log reset

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Command mode

Examples

The following example resets all debug log levels back to default values:

root@nam.cisco.com# debug log reset

diffserv aggregate

To enter the differentiated services aggregate configuration subcommand mode, and then configure differentiated services aggregation, use the diffserv aggregate command. To remove differentiated services aggregation, use the no form of this command.

diffserv aggregate

no diffserv aggregate 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 aggregation 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 is random.

description description—Specifies the aggregate description.

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

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 differentiated services aggregation:

root@localhost# diffserv aggregate
Entering into sub-command mode for this command.
Type 'cancel' to discard changes and to come out of this mode.
root@localhost(sub-diffserv-aggregate)# descr test1
root@localhost(sub-diffserv-aggregate)# exit
Successfully created a diffserv aggregate.
root@localhost# show diffserv aggregate
Control index:                25013
Description:                  test1
Owner:                        monitor
Status:                       1
root@localhost# no diffserv aggregate 25013
Successfully removed the diffserv aggregate. 

Related Commands

diffserv profile
show diffserv aggregate

diffserv profile

To enter the differentiated services profile configuration subcommand mode, and then configure differentiated services profile, use the diffserv profile command. To remove differentiated services aggregation, use the no form of this command.

diffserv profile

no diffserv profile profile-index

Syntax Description

profile-index

Specifies a differentiated services aggregate control index. Range is from 1 to 65535.

Note Use the diffserv aggregate command to first create the differentiated services control index, and then use the show diffserv aggregate command to obtain a differentiated services aggregate control index.


Defaults

The profile index is random.

Command Modes

Command mode

Usage Guidelines

When you enter the differentiated services profile submode, the following commands are available:

cancel—Discards changes and exits from the subcommand mode.

descripton DSCP-value | description—(Optional) Specifies the aggregate description.

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

profile-index profile-index— Specifies the entry control index for an existing differentiated services aggregate. Range is from 1 to 65535. Default is random.


Note To create a new differentiated services profile entry, you must obtain a new differentiated services aggregate control index by using the diffserv aggregate command to create a new differentiated services aggregate entry before using the diffserv profile command.


Examples

This example shows how to configure a differentiated services profile:

root@localhost# show diffserv aggregate
Control index:                25013
Description:                  test1
Owner:                        monitor
Status:                       1
root@localhost.cisco.com# diffserv profile
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-diffserv-profile)# profile-index 25013
root@localhost.cisco.com(sub-diffserv-profile)# descr 0 dscpA
root@localhost.cisco.com(sub-diffserv-profile)# descr 1 dscpB
root@localhost.cisco.com(sub-diffserv-profile)# exit
Successfully updated the differentiated service profile. 
root@localhost.cisco.com# show diffserv profile 25013
Aggregate Profile Index:25013
DSCP Value     Description
0            dscpA
1            dscpB
root@localhost.cisco.com# no diffserv profile 25013
Successfully removed the diffserv profile. 

Related Commands

show diffserv aggregate
show diffserv profile

email

To set up an email server that sends both alarm and report data through email, enable or disable alarm messages sent through email, and enter the subcommand mode, use the email command. To remove the email server, use the no email server command. To stop sending out both scheduled report data and alarm messages through email, use the no email alarm command.

email

no email server

no email alarm

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

(Note: the recipients are alarm messages recipients. Report data recipients are not supported on CLI because there is not any CLI command for setting up a scheduled report.)

When you enter the email 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 email-server—Specifies the email server name.

alarm enable Enables sending alarm messages through email.

alarm disable—Disables sending alarm messages through email.

alarm recipients space-seperated-list-of-email-addresses

Examples

This example shows how to set up the NAM to send scheduled reports through email to abc@example.com and xyz@example.com:

root@localhost# email
proot@localhost(sub-email)# server example-email.domain.com
root@localhost(sub-email)# alarm enable
root@localhost(sub-email)# alarm recipients admin@domain.com another_admin@domain.com 
root@localhost(sub-email)# exit
Successfully set email configuration settings.

Related Commands

show email

entity alias

To configure an entity alias for the entity MIB, use the entity alias command.

entity alias string

Syntax Description

string

Specifies the entity string used to configure the entPHysicalAlias.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

The entity MIB makes the entPhysicalTable and entLastChangeTime available through SNMP.

The clear configuration command deletes the entity alias and asset ID by setting them to an empty string.

Examples

This example shows how to log out of the NAM:

root@localhost# entity alias 123456

Related Commands

show entity

entity assetid

To configure an entity MIB asset ID, use the entity assetid command.

entity assetid string

Syntax Description

string

Specifies the entity string used to configure the entPHysicalAssetID.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

The entity MIB makes the entPhysicalTable and entLastChangeTime available through SNMP.

The clear configuration command deletes the entity alias and asset ID by setting them to an empty string.

Examples

This example shows how to log out of the NAM:

root@localhost# entity assetid 1234566

Related Commands

show entity

exit

To log out of the system or to leave a subcommand mode, use the exit command.

exit

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

To leave a subcommand mode, use the exit command. The exit command saves any changes before leaving the submode.

Examples

This example shows how to log out of the NAM:

root@localhost# exit

exsession

To enable or disable outside logins, use the exsession command.

exsession on [ssh]

exsession off

Syntax Description

on

Enables outside logins.

off

Disables outside logins.

ssh

(Optional) Sets the outside logins to SSH.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

A strong crypto patch is required if you use the ssh option.

Examples

This example shows how to allow outside logins to the NAM:

root@localhost# exsession on

ftp

To set the FTP server and directory for storing scheduled reports, use the ftp command. To disable FTP scheduled reports, use the no form of this command.

ftp

no ftp

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

directory WORD—Specifies the FTP location on the FTP server.

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

password WORD—Specifies the user password on the FTP server.

user WORD—Specifies the user name on the FTP server.

server WORD—Specifies the FTP server name or IP address.

Examples

This example shows how to set the FTP server for storing scheduled reports:

root@localhost<sub-email># ftp
Entering into subcommand mode for this command.
Type 'exit' to come out of this mode.
Type 'cancel' to discard changes and to come out of this mode.
root@namlab-kom7.cisco.com(sub-ftp)# ?

Related Commands

show ftp

help

To display help, use the help command or ?. You must press the Enter key after entering the ?.

help | ?

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Modes

Command mode or subcommand mode

Examples

This example shows how to display help:

root@localhost# help
?                         - display help
alarm                     - configure NAM MIB/voice alarms
autostart                 - enable/disable autostart collections
clear                     - clear access log / system alerts
config                    - configure NAM
coredump                  - retrieve the coredump file
custom-filter             - configure capture/decode custom filters
diffserv                  - differentiated service related configurations
exit                      - log out of system
exsession                 - enable/disable outside logins
help                      - display help
ip                        - set ip parameters
logout                    - log out of system
mfgtest                   - Manufacturing only tests
monitor                   - enable collections
no                        - delete various configurations
nslookup                  - query nameservers
password                  - set new password
patch                     - download and install new patch
ping                      - ping a network device
preferences               - configure web interface preferences for all users
reboot                    - reboot the system
rmon                      - configure RMON collections
rmwebusers                - remove all web users from local web user database
show                      - show system parameters
shutdown                  - shut down the system
snmp                      - set snmp parameters
syslog                    - configure NAM syslog
time                      - configure NAM timezone/time sync settings
traceroute                - traceroute to a network device
trap-dest                 - create/edit NAM trap destination
upgrade                   - download and install new maintenance image
voice                     - enable/disable voice collections
web-user                  - create/edit local web user

ip address

To set the system IP address, use the ip address command.

ip address ip-address subnet-mask

Syntax Description

ip-address

Sets the system IP address.

subnet-mask

Sets the subnet mask.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

After setting the IP address, the gateway address may be set to 0.0.0.0. When this situation occurs, use the ip gateway command to set the gateway address.

The broadcast address is automatically set with an address that is created using the new IP address and network mask. To select a different broadcast address, use the ip broadcast command

Examples

This example shows how to set the system IP address:

root@localhost# ip address 172.20.104.74 255.255.255.192
IP address and netmask configured successfully.
NOTE: Default gateway address has been reset to 0.0.0.0
Please use 'ip gateway' command to configure it.
root@localhost# ip gateway 172.20.104.66
root@localhost# show ip
IP address:             172.20.104.74
Subnet mask:            255.255.255.192
IP Broadcast:           172.20.255.255
DNS Name:               namlab-kom8.cisco.com
Default Gateway:        172.20.104.66
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@localhost#

Related Commands

ip broadcast
ip gateway
ip host
show ip

ip broadcast

To set the system broadcast address, use the ip broadcast command.

ip broadcast broadcast-address

Syntax Description

broadcast-address

Sets the system broadcast address.


Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to set the system broadcast address:

root@localhost# ip broadcast 172.20.104.127
root@localhost# 

Related Commands

ip address
ip gateway
ip host
ip interface
show ip

ip gateway

To set the system default gateway address, use the ip gateway command.

ip gateway default-gateway

Syntax Description

default-gateway

Sets the default gateway address.


Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to set the IP gateway address:

root@localhost# ip gateway 123.34.56.0

Related Commands

ip address
ip broadcast
ip host
ip interface
show ip

ip host

To set the system host name, use the ip host command.

ip host name

Syntax Description

name

Sets the IP host name.


Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to set the IP host name:

root@localhost# ip host orion

Related Commands

ip address
ip gateway
ip interface
show ip

ip hosts add

To add or replace host entries, use the ip hosts add command.

ip hosts add ip-address host-name [alias1] [alias2]

ip hosts add ftp://user:passwd@host/full-path/filename

Syntax Description

ip-address

Sets the host IP address.

host-name

Sets the host name which can be an FTP URL with a filename.

alias1 alias2

(Optional) Sets the host alias.

ftp://user:passwd@host/full-path/filename

Sets the path to the host parameters file location.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

Use the ip hosts add ftp://user:passwd@host/full-path/filename command to import host entries to the NAM. A maximum of 1,000 entries can exist on the NAM.

Examples

This example shows how to add a specific IP host:

root@localhost# ip hosts add 30.50.68.10 orion

Related Commands

ip hosts delete
show hosts

ip hosts delete

To delete host entries, use the ip hosts delete command.

ip hosts delete ip-address

ip hosts delete ftp://user:passwd@host/full-path/filename

Syntax Description

ip-address

Sets the host IP address.

ftp://user:passwd@host/full-path/filename

Sets the path to the host parameters file location.


Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

Use the ip hosts delete ftp://user:passwd@host/full-path/filename command to remove host entries from the NAM.

Examples

This example shows how to delete a specific host:

root@localhost# ip hosts delete 172.20.98.129 

Related Commands

ip hosts add
show hosts

ip http port

To set the HTTP port, use the ip http port command.

ip http port 1-65535

Syntax Description

1-65535

Specifies a port number in the range of 1 through 65535.


Not all ports are available to be assigned. Most browsers block ports that are used for other applications. Table 2-1 lists the commonly blocked ports.

Table 2-1 Commonly-Blocked Ports

Port
Application
 
Port
Application
 
Port
Application

1

tcpmux

 

95

supdup

 

513

 

7

echo

101

hostriame

514

shell

9

discard

102

iso-tsap

515

printer

11

systat

103

gppitnp

526

tempo

13

daytime

104

acr-nema

530

courier

15

netstat

109

POP2

531

chat

17

qotd

110

POP3

532

netnews

19

chargen

111

sunrpc

540

uucp

20

ftp data

113

auth

556

remotefs

21

ftp control

115

sftp

563

NNTP+SSL

22

ssh

117

uucp-path

587

submission

23

telnet

119

NNTP

601

syslog

25

smtp

123

NTP

636

LDAP+SSL

37

time

135

loc-srv / epmap

993

IMAP+SSL

42

name

139

netbios

995

POP3+SSL

43

nicname

143

IMAP2

2049

nfs

53

domain

179

LDAP

4045

lockd

77

priv-rjs

389

LDAP

6000

X11

79

finger

465

SMTP+SSL

   

87

ttylink

512

print / exec

   

Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to specify an HTTP port for the NAM:

root@localhost# ip http port 233

Related Commands

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

ip http secure generate

To generate a certificate request, use the ip http secure generate command.

ip http secure generate {certificate-request | self-signed-certificate}

Syntax Description

certificate-request

Generates a certificate request.

self-signed-certificate

Generates a self-signed certificate.


Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to set up a secure server:

root@localhost# ip http secure generate certificate-request

Related Commands

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

ip http secure install certificate

To install a certificate, use the ip http secure install certificate command.

ip http secure install certificate

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to set up a secure server:

root@localhost# ip http secure install certificate

Related Commands

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

ip http secure port

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

ip http secure port port

Syntax Description

port

Sets the HTTP secure port.


Not all ports are available to be assigned. Most browsers block ports that are used for other applications. Table 2-1 in the descripton of command ip http port lists the Commonly-Blocked Ports.

Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to set up a secure server:

root@localhost# ip http secure port 30

Related Commands

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