CLI: Debug

You can use the debug command to generate diagnostic dumps and captures. Generated files will be available for download on the Web UI. Then you can use the file command to delete, upload, or e-mail it.

Generating diagnostics files

debug generate {capture {interface|filter|timeout} | dump}

To delete a tcpdump file:

file tcpdump delete <file-name>

To generate a packet capture diagnostic file:

debug generate capture {interface|filter|timeout}

  • interface <interface-name> - Select an interface to run the TCPTransmission Control Protocol dump on. E.g. br1, eth1, or ALL. Note that when you select ALL for the Interface, only those interfaces which are link up are included.
  • timeout <duration> - Specify the duration (in seconds) that the capture should run.
  • filter - Specify a filter to apply to the capture. More information on tcpdump filters is available at www.tcpdump.org

To generate a sysdump diagnostic file:

debug generate dump

Manipulating diagnostics files

file debug-dump {delete|email|upload}
file tcpdump {delete|upload}

To delete a diagnostic dump file:

file debug-dump delete <file-name>

To e-mail a diagnostic dump file:

file debug-dump email <file-name>

To upload a diagnostic dump file:

file debug-dump upload <file-name> <upload-url>

To delete a tcpdump file:

file tcpdump delete <file-name>

To upload a tcpdump file:

file tcpdump upload <file-name> <upload-url>

EXAMPLE

Capture 5 seconds of traffic on Bridge br10, then upload to a server via scp

> debug generate capture interface br10 timeout 5
Starting capture... (Press ctrl-c to end capture)

Stopping capture... Generated capture file: capture-exinda-hq-20110405-055920.tar.gz

> file tcpdump upload capture-exinda-hq-20110405-055920.tar.gz \

scp://admin@foo.com/tcpdumps