Chapter 41 Maintenance Tools

Here are maintenance tool commands that you can use in configure mode.

Table 153 Maintenance Tools Commands in Configuration Mode

COMMAND

DESCRIPTION

[no] packet-capture activate

Performs a packet capture that captures network traffic

 

going through the set NXC’s interface(s). Studying these

 

packet captures may help you identify network problems.

 

The no command stops the running packet capture on the

 

NXC.

 

Note: Use the packet-capture configure

 

command to configure the packet-

 

capture settings before using this

 

command.

 

 

packet-capture configure

Enters the sub-command mode.

duration <0..300>

Sets a time limit in seconds for the capture. The NXC

 

stops the capture and generates the capture file when

 

either this period of time has passed or the file reaches the

 

size specified using the files-sizecommand below. 0

 

means there is no time limit.

file-suffix <profile_name>

Specifies text to add to the end of the file name (before the

 

dot and filename extension) to help you identify the packet

 

capture files. Modifying the file suffix also avoids making

 

new capture files that overwrite existing files of the same

 

name.

 

The file name format is “interface name-file suffix.cap”, for

 

example “vlan2-packet-capture.cap”.

 

 

files-size <1..1000000000>

Specify a maximum size limit in kilobytes for the total

 

combined size of all the capture files on the NXC,

 

including any existing capture files and any new capture

 

files you generate.

 

The NXC stops the capture and generates the capture file

 

when either the file reaches this size or the time period

 

specified ( using the duration command above) expires.

 

Note: If you have existing capture files you may

 

need to set this size larger or delete

 

existing capture files.

 

 

host-ip{ip-address profile_name

Sets a host IP address or a host IP address object for

any>

which to capture packets. any means to capture packets

 

for all hosts.

host-port <0..65535>

If you set the IP Type to any, tcp, or udp using the ip-

 

type command below, you can specify the port number of

 

traffic to capture.

iface {add del} {interface_name

Adds or deletes an interface or a virtual interface for which

virtual_interface_name}

to capture packets to the capture interfaces list.

ip-version {any ip ip6}

Sets the version of the Internet Protocol (IP) by which

 

traffic is routed across the networks and Internet. any

 

means to capture packets for traffic sent by either IP

 

version.

 

 

proto-type {icmp igmp igrp pim

Sets the protocol of traffic for which to capture packets.

ah esp vrrp udp tcp any}

any means to capture packets for all types of traffic.

262

 

NXC CLI Reference Guide