Table Of Contents

syslog voice

terminal

time

traceroute

trap-dest

upgrade

web-publication

web-user

22

syslog voice

To configure system logging for voice threshold events from the syslog subcommand mode, use the syslog voice command.

syslog voice local enable | disable remote enable | disable

Syntax Description

local enable | disable	Enables or disables local voice alarms.
remote enable | disable	Enables or disables remote voice alarms.

Defaults

This command has no default settings.

Command Modes

Syslog subcommand mode

Examples

This example shows how to configure the NAM to capture voice alarms:

root@hostname.cisco.com<sub-syslog># syslog voice local enable

root@hostname.cisco.com# show options

ART mib:         Enabled

Voice monitoring:Enabled

root@hostname.cisco.com#

Related Commands

alarm mib
alarm voice
show alarm event
show autostart
show patches
show syslog-settings
syslog remote-server

terminal

To set the number of lines on a screen for this session, use the terminal command.

terminal editor [enable | disable]

terminal length length

terminal mode { 0 | 1}

Syntax Description

editor [enable | disable]	(Optional) Enables or disables the NAM CLI command editing.
length length	Sets the number of lines per screen for a session.
mode { 0 | 1}	Sets the terminal mode.

Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to set the number of lines on a session's screen:

root@localhost# terminal length 24

Terminal length for this session set to 24.

Related Commands

config clear

time

To enter the time configuration subcommand mode, and then configure NAM system time settings, use the time command.

time

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

When you enter the time configuration 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 section.

•sync ntp | switch—(Optional) Synchronizes the NAM system time with the Network Time Protocol (NTP) or with the switch.

•zone—region-name [zone-name]—Synchronizes the time zone with the NAM for use with NTP.

•sync router—Synchronizes the NAM time with the router.

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 configure system time settings on the NAM to synchronizes the time with the switch:

root@hostname.cisco.com# time

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

?                         - display help

cancel                    - discard changes and exit from subcommand mode

exit                      - exit from subcommand mode

help                      - display help

sync                      - synchronize NAM system time with switch or ntp

root@hostname.cisco.com(sub-time)# sync switch

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

Successfully updated NAM system time settings.

NOTE:You have configured the NAM synchronize time to the switch.

For this change to take effect, set the time from the switch or

reset the NAM.

root@hostname.cisco.com# show time

NAM synchronize time to:          Switch

Timezone configured on the switch:PST

Switch time offset to UTC:        0

Current system time:              Thu Mar 20 09:23:14 GMT 2003

This example shows how to configure system time settings on the NAM to synchronize the time with the NTP:

root@hostname.cisco.com# time

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-time)# sync ntp ntp01.cisco.com ntp02.cisco.com

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

Successfully updated NAM system time settings.

root@hostname.cisco.com# show time

NAM synchronize time to:          NTP

NTP server1:                      ntp01.cisco.com

NTP server2:                      ntp02.cisco.com

Current system time:              Thu Mar 20 09:23:36 GMT 2003

root@hostname.cisco.com# 

Related Commands

show time

traceroute

To trace the route to a network device, use the traceroute command.

traceroute [-I | n | v] [-f first_ttl] [-m max_ttl] [-p port] [-s src_addr] [-t tos] [-w waittime] destination host name | IP address [packetlen]

Syntax Description

-I	(Optional) Specifies that ICMP ECHO is used instead of UDP datagrams.
-n	(Optional) Prints hop addresses numerically.
-v	(Optional) Sets the output to verbose.
-f first_ttl	(Optional) Sets the initial time-to-live used in the first outgoing packet.
-m max_ttl	(Optional) Sets the maximum time-to-live (max number of hops) used.
-p port	(Optional) Sets the base UDP port number used in probes.
-s src_addr	(Optional) Forces the source address to be an address other than the IP address of the interface the packet is sent on.
-t tos	(Optional) Sets the type-of-service in packets to the following value.
-w waittime	(Optional) Sets the time (in seconds) to wait for a response to a probe.
destination	Sets the packet destination.
host	Sets the host.
name	Sets the hostname.
IP address	Sets the IP address
packetlen	(Optional) Set the length of the packet.

Defaults

This command has no default settings.

Command Modes

Command mode

Examples

This example shows how to trace a route to a network device named aragon:

root@localhost.cisco.com# traceroute -I -n -v -f first_ttl -p 5 -w 10 aragon 123.34.54.12 

root@localhost.cisco.com# 

trap-dest

To enter the trap destination subcommand mode and create or edit trap destinations on the NAM, use the trap-dest command. To remove a trap destination entry, use the no form of this command.

trap-dest

no trap-dest [control-index]

Syntax Description

control-index

(Optional) Specifies the collection control index. Range is from 1 to 65535.

Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

When you enter the trap destination subcommand mode, the following commands are available:

•address—Sets the trap destination IP address.

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

•community community_string—Sets the community string.

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

•index index—(Optional) Sets the trap index. Range is from 1 to 65535. Default is random.

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

---

•port—(Optional) Sets the UDP port. Default is 162.

Examples

This example shows how to configure traps on the NAM:

root@hostname.cisco.com# trap-dest

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-trap-dest)# ?

?                         - display help

address                   - set IP address (*)

cancel                    - discard changes and exit from subcommand mode

community                 - set community string (*)

exit                      - exit from subcommand mode

help                      - display help

index                     - set trap index

owner                     - set owner string

port                      - set UDP port

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

root@hostname.cisco.com(sub-trap-dest)# address 10.0.0.1

root@hostname.cisco.com(sub-trap-dest)# community public

root@hostname.cisco.com(sub-trap-dest)# exit

Trap created successfully.

root@hostname.cisco.com# show trap-dest

Trap index:48981

Community: public

Address:   10.0.0.1

UDP port:  162 (00a2)

Owner:     monitor

root@hostname.cisco.com#

Related Commands

alarm event
alarm mib
alarm voice
show alarm event
show autostart
show trap-dest

upgrade

To download and install a new maintenance image on the NAM, use the upgrade command.

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

Syntax Description

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

Path to the location of the upgrade maintenance image.

Defaults

This command has no default settings.

Command Modes

Command mode.

Examples

This example shows how to download and install a new maintenance image:

Root@localhost# upgrade ftp://alamo:ljljsdf@milton/dir65/abracadabr/dir65/upgrade_now

Root@localhost# 

Related Commands

show patches
show version

web-publication

To enable and set up a list of hosts that can view the NAM GUI monitoring displays without logging into the NAM, use the web-publication command. To remove web publishing from your configuration, use the no form of this command.

web-publication user-name

no web-publication

Syntax Description

user-name

Sets the username.

Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

When you enter the web user subcommand mode, the following commands are available:

•? or help—Displays help; see the "help" command section.

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

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

•alarm enable | disable—(Optional) Enables or disables web publishing of alarm displays.

•allow-hosts WORD—Sets the hosts which are allowed to view web published monitoring displays.

•code WORD—Sets the code which allows hosts to view web published monitoring displays.

•report enable | disable—(Optional) Enables or disables web publishing report displays.

•rmon enable | disable—(Optional) Enables or disables web publishing RMON monitoring displays.

•voice enable | disable—(Optional) Enables or disables web publishing voice monitoring displays.

Examples

This example shows how to configure a host to receive web published reports from the NAM:

root@hostname.cisco.com# web-publication

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-web-publication)# ?

root@hostname.cisco.com#

Related Commands

show web-publication

web-user

To enter the web user configuration subcommand mode, and then configure local web users on the NAM, use the web-user command. To remove a web user from your configuration, use the no form of this command.

web-user

no web-user user-name

Syntax Description

user-name

Sets the username.

Defaults

This command has no default settings.

Command Modes

Command mode

Usage Guidelines

When you enter the web user subcommand mode, the following commands are available:

•account-mgmt enable | disable—(Optional) Enables or disables the account management privilege.

•alarm-config enable | disable—(Optional) Enables or disables the alarm configuration privilege.

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

•capture enable | disable—(Optional) Enables or disables the packet capture and decode privilege.

•collection-config enable | disable—(Optional) Enables or disables the collection configuration privilege.

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

•system-config enable | disable—(Optional) Enables or disables the system configuration privilege.

•user-name user-name—Sets the user name.

Examples

This example shows how to configure a NAM web user:

root@hostname.cisco.com# web-user

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-web-user)# ?

?                         - display help

account-mgmt              - enable/disable account management privilege

alarm-config              - enable/disable alarm configuration privilege

cancel                    - discard changes and exit from subcommand mode

capture                   - enable/disable packet capture/decode privilege

collection-config         - enable/disable collection configuration privilege

exit                      - exit from subcommand mode

help                      - display help

system-config             - enable/disable system configuration privilege

user-name                 - set username (*)

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

root@hostname.cisco.com(sub-web-user)# user-name foo

root@hostname.cisco.com(sub-web-user)# account-mgmt enable

root@hostname.cisco.com(sub-web-user)# exit

No password specified.

Do you want specify password now (y/n) [n] y

Enter password:

Confirm password:

User 'foo' created successfully.

root@hostname.cisco.com# show web-users foo

User name:         foo

Account management:Enabled

System config:     Disabled

Capture:           Disabled

Alarm config:      Disabled

Collection config: Disabled

Collection view:   Enabled

root@hostname.cisco.com#

Related Commands

show web-users