XRA-31 Command-line Interface

The same functionality available in the XRA-31 web interface can be accessed from the command-line. The items in the XRA-31 Control Panel map one-to-one on the following commands:

Commands

xra31-configure

Configure the XRA-31 channels. The three commands can be combined, and will be executed in the order store, load, wait-lock.

usage: xra31-configure [-h] [-f] [-q] [-v] [--version] [--store channels.json]
                       [--load channels.json] [--wait-lock] [-t TIMEOUT]
                       XRA-31

positional arguments

xra-31

XRA-31 hostname or IP address

optional arguments

-h, --help

show this help message and exit

-f, --force

force full access mode if it’s in use

-q, --quiet

don’t print progress messages

-v, --verbose

print debugging messages

--version

print client version and server release

commands

--store <channels.json>

store the current XRA-31 channel configuration to JSON

--load <channels.json>

load a JSON channel configuration to the XRA-31

--wait-lock

wait for all channels to be locked

command options

-t <timeout>, --timeout <timeout>

maximum time to wait for lock and channel detection (seconds)

xra31-capture

Configure the XRA-31 capture. The commands can be combined, and will be executed in the order store, load, start, stop, wait (end or file-end). Command-line output options override configurations in the loaded file.

usage: xra31-capture [-h] [-f] [-q] [-v] [--version] [--store capture.json]
                     [--load capture.json] [--start] [--stop] [--wait-end]
                     [--wait-file-end] [--filename directory/capture.pcap]
                     [-D DURATION] [-S SIZE] [-n NUMBER_OF_FILES]
                     [-d FILE_DURATION] [-s FILE_SIZE] [-t TIMEOUT]
                     XRA-31

positional arguments

xra-31

XRA-31 hostname or IP address

optional arguments

-h, --help

show this help message and exit

-f, --force

force full access mode if it’s in use

-q, --quiet

don’t print progress messages

-v, --verbose

print debugging messages

--version

print client version and server release

commands

--store <capture.json>

store the current XRA-31 capture configuration to JSON (channels, filtering, output)

--load <capture.json>

load a JSON capture configuration to the XRA-31

--start

start capturing

--stop

stop capturing

--wait-end

wait for the capture to end

--wait-file-end

wait for the next file rollover in a rolling file capture

output

--filename <directory/capture.pcap>

capture filename on the XRA-31

-D <duration>, --duration <duration>

duration limit of the capture (seconds). 0 for unlimited

-S <size>, --size <size>

size limit of the capture (MB). 0 for unlimited

rolling file

-n <number_of_files>, --number-of-files <number_of_files>

number of files in the rolling file capture (1 for single file capture)

-d <file_duration>, --file-duration <file_duration>

per-file duration limit (seconds). 0 for unlimited

-s <file_size>, --file-size <file_size>

per-file size limit (MB). 0 for unlimited

command options

-t <timeout>, --timeout <timeout>

maximum time to wait for the end of the capture or the rollover of a file (seconds)

xra31-analyse

Access XRA-31 capture files. The commands can be combined, and files won’t be deleted unless downloading succeeds.

usage: xra31-analyse [-h] [-f directory/remote.pcap] [-q] [-v] [--version]
                     [--download] [--delete] [-o local.pcap] [-r] [-a] [-c]
                     XRA-31

positional arguments

xra-31

XRA-31 hostname or IP address

optional arguments

-h, --help

show this help message and exit

-f <directory/remote.pcap>, --filename <directory/remote.pcap>

capture filename on the XRA-31. If missing, the latest capture is downloaded

-q, --quiet

don’t print progress messages

-v, --verbose

print debugging messages

--version

print client version and server release

commands

--download

store captures locally

--delete

remove captures from the XRA-31

command options

-o <local.pcap>, --output <local.pcap>

local download location

-r, --rolling

treat filename as a full rolling file capture

-a, --append

append capture to an existing file; requires download

-c, --compress

compress the downloaded capture file (gzip)