Network Analysis Module Command Reference Guide, 3.6
T-W Commands
Downloads: This chapterpdf (PDF - 120.0KB) The complete bookPDF (PDF - 2.52MB) | Feedback

22

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