Skip to content

systemslab import experiment

Description Import a previously exported SystemsLab experiment.
Usagesystemslab import experiment [OPTIONS] <SOURCE>

Description

The systemslab import experiment command imports an experiment tar file that was generated by a previous systemslab export experiment command. This allows you to move experiments between different SystemsLab servers.

TIP

systemslab import experiment does not handle compressed tar files on its own. You can import compressed tar files by passing them to stdin like so

bash
gzip -d experiment.tar.gz -c | systemslab import experiment -

Options

OptionDefaultDescription
<SOURCE> Tar file or folder containing the experiment to import. This can be - to read the tar file from stdin.
-j, --parallel1 Number of requests allowed to be made in parallel. Passing 0 will make this use the number of CPUs on the current machine.
--postprocessfalse Postprocess the experiment after import is complete. Will only work for experiments which have executed successfully.
--postprocessing-configNoneProvide a custom postprocessing configuration. If not provided, either the config submitted during experiment creation or the default configuration is used. The config file is a TOML file and can override individual parameters in the original config.

Common Options

OptionDefaultDescription
--systemslab-url The URL at which to access the systemslab server.
--colorauto Controls when color is used in the output. Possible values are auto, always, and never.
--output-formatlong Output format to use when outputting messages. long will result output designed to be human-readable while short is short output meant to be used within scripts.

Environment Variables

VariableDescription
SYSTEMSLAB_URLSpecify the URL used to contact the SystemsLab server. Equivalent to --systemslab-url.