Usage#

archiver_test#

Archiver Test checks the data from two archivers to see the difference when querying for the same data.

Example test the PV DTL-010:EMR-TT-047:Temp for the last 20 seconds.

archiver_test test -p DTL-010:EMR-TT-047:Temp -o archiver-linac-01.tn.esss.lu.se -n skybrewer.cslab.esss.lu.se -s 20 -t "sky archiver vs linac 01"

Importing from a configuration file:

archiver_test load config.json

Outputting to a configuration file and to a json storage:

archiver_test test --output-folder output

A copy of the downloaded data will be stored in output/store/archiver_host_name/pv_name/time_period.test_state.test_run_time.pickle and a copy of the config as output/test_name-test_run_time.test_state.pickle.

Loading existing data from another test run:

archiver_test test --old_data output/store/archiver-linac-01.tn.esss.lu.se/DTL-010:EMR-GT-003:Pos/data.pickle

Output is presented as a list of a tables for each PV for each archiver. Including:

  • Archival parameters

  • Average mean

  • Number of test events

  • PASS or FAIL if the returned events are exactly the same.

  • Possible reason why results could be different.

And a summary table with all with a calculated average mean difference.

archiver_test [OPTIONS] COMMAND [ARGS]...

load#

Loads a file CONFIG of test sets in json.

Argument CONFIG is a json file specifying a list of tests to run.

archiver_test load [OPTIONS] CONFIG

Options

--debug#

Turn on debug logging

Default:

False

--output-folder <output_folder>#

Output folder for data from test.

Arguments

CONFIG#

Required argument

test#

Runs a single test given input options

archiver_test test [OPTIONS]

Options

-p, --pv <pv>#

PV names to check.

-o, --archiver_old <archiver_old>#

Hostname of old archiver.

-n, --archiver_new <archiver_new>#

Hostname of new archiver

-s, --seconds <seconds>#

Length of time period to check in seconds.

-t, --test_name <test_name>#

Name of test.

--old_data <old_data>#
--debug#

Turn on debug logging

Default:

False

--output-folder <output_folder>#

Output folder for data from test.