A-L Commands

Table Of Contents

Network Analysis Module Commands

alarm

alarm event

alarm mib

alarm voice

autostart

cancel

clear

config

coredump

custom-filter

custom-filter capture

custom-filter decode

diffserv

diffserv aggregate

diffserv profile

exit

exsession

help

ip

ip address

ip broadcast

ip gateway

ip host

ip hosts

ip hosts add

ip hosts delete

ip http

ip http port

ip http secure

ip http server

ip http tacacs+

ip interface

ip nameserver

logout

Network Analysis Module Commands

---

This chapter contains an alphabetical listing of the commands unique to the Catalyst 6500 series and Cisco 7600 series Network Analysis Module (NAM) and the NM-NAM network module.

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 Catalyst Command Reference

For information about the NM-NAM network module, refer to this URL:

http://lbj.cisco.com/targets/ucdit/cc/td/doc/product/software/ios123/123newft/123limit/123x/123xd/nm_nam.htm

alarm

To configure NAM alarms, use the alarm command. To remove event and MIB alarms, use the no form of this command.

alarm event | mib | voice

no alarm event | mib

Syntax Description

event	Enters the event subcommand mode and configures events.
mib	Enters the MIB subcommand mode and configures the NAM MIB alarm.
voice	Enters the voice subcommand mode and configures the NAM voice alarm.

Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to configure NAM alarms:

root@localhost# alarm event

root@localhost<sub-alarm-event># 

Related Commands

alarm event
alarm mib
alarm voice
show alarm
show alarm event
show alarm mib
show alarm voice

alarm event

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

alarm event

no alarm event 1-65535

Syntax Description

1-65535

Specifies the event.

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; see the "cancel" command section.

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

•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
alarm mib
no
show alarm
show alarm event
show alarm mib
show autostart

alarm mib

To enter the alarm MIB configuration subcommand mode, and then configure NAM MIB alarms, use the alarm mib command.

alarm mib

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 alarm MIB submode, the following commands are available:

•cancel—Discards changes and exits from the subcommand mode; see the "cancel" command section.

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

•falling-event 1-65535—Sets 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-65535—Sets 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 | delta—Sets the sample type to absolute or delta.

•startup-alarm both | falling | rising—Sets the startup alarm to both rising and falling, falling, or rising.

•variable OID—Sets 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
alarm event
no
show alarm
show alarm event
show alarm mib
show autostart

alarm voice

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

alarm voice

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 alarm voice submode, the following commands are available:

•cancel—Discards changes and exits from the subcommand mode; see the "cancel" command section.

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

•jitter-alarm enable | disable—(Optional) Enables or disables the jitter alarm.

•jitter-threshold int—(Optional) Sets the jitter threshold in milliseconds. Default for SCCP is 30 milliseconds, H.323 is 150 milliseconds, and MGCP is 30 milliseconds.

•pkt-loss-alarm enable | disable—(Optional) Enables or disables the packet loss alarm.

•pkt-loss-threshold int—(Optional) Sets the packet loss threshold in percentage(%). Default is 5 percent for all three protocols, SCCP, H.323, and MGCP.

•protocol H.323 | SCCP | MGCP—Sets the voice protocol to H323, SCCP, or MGCP.

The MGCP protocol option is specific to the Network Analysis Module (NAM) software release running on network modules in the Cisco 2600, 3600, 3700 routers.

Examples

This example shows how to set a voice alarm:

root@localhost# alarm voice 

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-voice)# ?

?                         - display help

cancel                    - discard changes and exit from subcommand mode

exit                      - exit from subcommand mode

help                      - display help

jitter-alarm              - enable/disable jitter alarm

jitter-threshold          - set jitter threshold

pkt-loss-alarm            - enable/disable packet loss alarm

pkt-loss-threshold        - set packet loss threshold

protocol                  - set protocol (*)

(*) - denotes a mandatory field for this configuration.

root@hostname.cisco.com(sub-alarm-voice)# protocol SCCP

root@hostname.cisco.com(sub-alarm-voice)# jitter-alarm enable

root@hostname.cisco.com(sub-alarm-voice)# jitter-threshold 50

root@hostname.cisco.com(sub-alarm-voice)# exit

Successfully updated the SCCP configuration.

root@hostname.cisco.com# show alarm voice

SCCP:

        Jitter alarm:         Disabled

        Packet lost alarm:    Disabled

        Jitter threshold:     30 msecs

        Packet lost threshold:5%

H.323:

        Jitter alarm:         Disabled

        Packet lost alarm:    Disabled

        Jitter threshold:     150 msecs

        Packet lost threshold:5%

MGCP:

        Jitter alarm:         Enabled

        Packet lost alarm:    Enabled

        Jitter threshold:     31 msecs

        Packet lost threshold:6%

Related Commands

alarm
show alarm
show alarm voice
show autostart

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

cancel

To discard changes and exit a command or subcommand mode, use the cancel command.

cancel

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Modes

Subcommand mode

Examples

This example shows how to leave a subcommand mode and return to the main menu:

root@namlab-kom7.cisco.com(sub-alarm-mib)# cancel

root@namlab-kom7.cisco.com#

Related Commands

clear
exit

clear

To clear the access log or system alerts, use the clear command.

clear [access-log | system-alerts]

Syntax Description

access-log	(Optional) Clears the web access log.
system-alerts	(Optional) Clears the system log of messages logged by various NAM processes.

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

cancel
exit

config

To configure the NAM, use the config command.

config [clear [all | ip]] [network URL] [upload URL | URL [remote-filename]

Syntax Description

clear	(Optional) Resets the NAM back to the factory default state but does not reset the NAM IP parameters. The NAM is rebooted automatically for the changes to take effect.
all	(Optional) Resets the NAM back to the factory default state and resets the NAM IP parameters. The NAM is rebooted automatically for the changes to take effect.
ip	(Optional) Resets only the NAM IP parameters to the factory default state on both the application and maintenance partitions. The NAM is rebooted automatically for the changes to take effect.
network URL	(Optional) Imports configurations into the NAM from a specified location. The imported and running configurations are merged.
upload URL | URL remote-filename	(Optional) Automates the publishing of a configuration file. You can use this command to save a configuration file without manual edits. This capability allows you to edit or remove a configuration script run by another user.

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

This example shows how to clear the IP configuration:

root@localhost.cisco.com# config clear ip

This operation will reset 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

Resetting IP parameters

HTTP port is already set to port 80.

Successfully modified the configuration.

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

This example shows how to upload a configuration to the NAM:

root@localhost.cisco.com# config upload ftp://user@host

Building configuration, please wait... Done.

Uploading the configuration to 'localhost-c6svc-nam-3.1-0.32.confg'

on 'ftp://user@host', This may take few minutes ...

Password:

Successfully uploaded the NAM configuration.

This example shows how to upload a configuration to the NAM from the network:

root@localhost.cisco.com# config network ftp://sekarbc@namlab-pc6:/home/sekarb

c/localhost-c6svc-nam-3.1-0.32.confg

Downloading ftp://sekarbc@namlab-pc6:/home/sekarbc/localhost-c6svc-nam-3.1-0.32.confg, 
please wait ...

Password for sekarbc@namlab-pc6:

ftp://sekarbc@namlab-pc6:/home/sekarbc/localhost-c6svc-nam-3.1-0.32.confg (1K)

/tmp/lrcfile.txt.1397     [########################]       1K |   35.46K/s

1402 bytes transferred in 0.04 sec (35.34k/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'.

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

To configure custom filter settings, use the custom-filter command.

custom-filter {capture | decode}

Syntax Description

capture	Configures custom capture filter.
decode	Configures custom decode filter.

Defaults

This command has no default settings.

Command Modes

Command mode

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@namlab-kom7.cisco.com(sub)# 

Related Commands

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

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 form of this 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 exist from the subcommand mode; see the "cancel" command section.

•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 string—Sets 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@namlab-kom7.cisco.com(sub-custom-filter-capture)# 

Related Commands

custom-filter
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 form of this 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; see the "cancel" command section.

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

•description string—(Optional) Sets the filter description.

•direction both | single—(Optional) Applies the filter to both 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 string—Sets 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@namlab-kom7.cisco.com(sub-custom-filter-decode)# filter-name 12345

Related Commands

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

diffserv

To configure differentiated services, use the diffserv command.

diffserv {aggregate | profile}

Syntax Description

aggregate	Configures differentiated services aggregation.
profile	Configures differentiated services profile.

Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to configure differentiated services:

root@localhost# diffserv aggregate

root@localhost<sub-diffserv-aggregate># 

Related Commands

show diffserv aggregate

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; see the "cancel" command section.

•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

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; see the "cancel" command section.

•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 collection profile index. Range is from 1 to 65535. Default is random.

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

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 | off} | [ssh]

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

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

To set IP parameters, use the ip command.

ip [address | broadcast | domain | gateway | host | hosts | http | nameserver]

Syntax Description

address	(Optional) Sets the system IP address and subnet mask.
broadcast	(Optional) Sets the system broadcast address.
domain	(Optional) Sets the system domain.
gateway	(Optional) Sets the system default gateway address.
host	(Optional) Sets the system host name.
hosts	(Optional) Adds, deletes, or replaces hosts' entries.
http	(Optional) Sets the HTTP parameters.
nameserver	(Optional) Sets the system name server entries.

Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to set IP parameters:

root@localhost# ip address 30.24.10.10 2355.255.255.0

Related Commands

ip address
ip broadcast
ip gateway
ip host
ip hosts
ip http
show ip

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.

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
ip hosts
ip http
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 hosts
ip http
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 hosts
ip http
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 hosts
ip http
ip interface
show ip

ip hosts

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

ip hosts [add | delete]

Syntax Description

add	Adds hosts.'
delete	Deletes hosts.'

Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to add IP hosts':

root@namlab-kom8.cisco.com# ip hosts add 172.20.98.129 namlab-gw Lab-Gateway

root@namlab-kom8.cisco.com# show hosts

# $Id: hosts,v 1.5 2003/08/07 00:50:03 pwildi Exp $

#

127.0.0.1               localhost localhost.localdomain

172.20.104.74 namlab-kom8.cisco.com namlab-kom8

172.20.98.129   namlab-gw       Lab-Gateway

root@namlab-kom8.cisco.com#

root@namlab-kom8.cisco.com# ip hosts delete 172.20.98.129 

root@namlab-kom8.cisco.com# show hosts

# $Id: hosts,v 1.5 2003/08/07 00:50:03 pwildi Exp $

#

127.0.0.1               localhost localhost.localdomain

172.20.104.74 namlab-kom8.cisco.com namlab-kom8

root@namlab-kom8.cisco.com#

Related Commands

ip address
ip gateway
ip host
ip http
ip interface
show ip

ip hosts add

To add or replace hosts' 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.
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 1000 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 address
ip gateway
ip host
ip hosts delete
ip http
ip interface
show ip

ip hosts delete

To delete hosts' 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 hosts' 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 address
ip gateway
ip host
ip hosts add
ip http
ip interface
show ip

ip http

To set the system HTTP parameters, use the ip http command.

ip http [port | secure | server | tacacs+]

Syntax Description

port	(Optional) Sets the HTTP port.
secure	(Optional) Sets the IP HTTP secure server.
server	(Optional) Enables or disables the HTTP server.
tacacs+	(Optional) Enables or disables TACACS+.

Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to specify a TACACS+ server for the NAM:

root@localhost# ip http tacacs+ enable geronimo

Related Commands

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

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.

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
ip http secure
ip http server
ip http tacacs+
show ip

ip http secure

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

ip http secure [generate [certificate-request | self-signed-certificate]] [install certificate] [port 1-65535] [server enable | disable]

Syntax Description

generate certificate-request | self-signed-certificate	Generates a certificate request or a self-signed certificate.
install certificate	Installs a certificate.
port 1-65535	Sets the HTTP secure port.
server enable | disable	Enables or disables the HTTP server.

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

root@localhost# ip http secure port 30

root@localhost# ip http secure server enable

Related Commands

ip http
ip http port
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
ip http port
ip http secure
ip http tacacs+
show ip

ip http tacacs+

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

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

Syntax Description

disable	(Optional) Disables the TACACS+ server.
enable	(Optional) Enables the TACACS+ server.
primary-srv	(Optional) 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. For 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+:

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

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
ip http port
ip http secure
ip http server
show ip

ip interface

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

ip interface [external | internal]

Syntax Description

external	Selects the RJ-45 Fast Ethernet connector on the 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 NAM.

Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

This command is specific to the NAM software release running on network modules in the Cisco 2600, 3600, and 3700 routers.

Examples

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

root@localhost# ip interface external

Related Commands

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