Using the Command-line Interface

Even when no scripting is needed, the XRA-31 Command-line Interface has its merits. The three commands are shown here in typical day-to-day scenarios.

Storing and loading configurations

Channel configuration

While tools are at hand to ease the configuration of channels within the web interface, it can be a repetitive task when switching between setups. To ease this process, the xra31-configure command can be used to quickly store and load XRA-31 channel configurations.

Having configured an XRA-31 once for a given setup, be it from the web interface or a Python script, issuing the command

$ xra31-configure xra31_hostname --store configuration.json

will create a JSON file containing downstream channel parameters, the reference channel of choice and upstream UCIDs.

Whenever needed,

$ xra31-configure xra31_hostname --load configuration.json

will load this configuration back to the XRA-31.

Capture configuration

In the same way, the xra31-capture command can be used to store and load XRA-31 capture configurations, including

  • the channel selection,

  • the filtering options (packet types, OFDM streams and OFDM profiles), and

  • the output settings (stop criteria, rolling file options and paths).

$ xra31-capture xra31_hostname --store capture.json
$ xra31-capture xra31_hostname --load capture.json

Starting and stopping a capture

Starting an unlimited rolling file capture, keeping only the last 3 files with 60 seconds each, can be achieved as follows

$ xra31-capture xra31_hostname --path test_1/capture.pcap --size 0 --duration 0 --number-of-files 3 --file-size 0 --file-duration 60 --start

This capture can then be stopped from the web interface, Python, or with the command

$ xra31-capture xra31_hostname --stop

Downloading capture files

Finally, the capture files can be downloaded using the xra31-analyse command.

In the most common case, the latest capture file will be needed, and is available through the following command, optionally renaming it:

$ xra31-analyse xra31_hostname --download --output renamed.pcap

For most captures, gzip-compression can reduce file sizes significantly, and is available through the option --compress.

Specific files can be downloaded as well, using for example

$ xra31-analyse xra31_hostname --download --path test_1/capture_03.pcap --compress

Rolling file captures can be downloaded in one go, and will be concatenated to a single capture file. The following will download test_1/capture_*.pcap to capture.pcap.gz, and deletes the files from the XRA-31:

$ xra31-analyse xra31_hostname --download test_1/capture.pcap --rolling --compress --delete