systemslab context new

Description	Create a new SystemsLab context.
Usage	systemslab context new [OPTIONS]

Description

The systemslab context new command creates a new empty SystemsLab context.

The new context is created in the open state. It can be modified by attaching and detaching experiments from it. You can also attach newly submitted experiments by passing the context id via the --context flag to systemslab submit.

Once the experiment has completed, you will need to mark the context as complete so that SystemsLab can generate the appropriate reports.

TIP

Creating a new context does not re-run any of the experiments within. If you want to recreate an existing context with a few experiments replaced that can be done like so:

ctx=$(systemslab context new --name 'my new context' --inherit <context-id>)

systemslab context replace $ctx <my bad experiment id> <my new experiment id>

# or, alternatively
systemslab detach $ctx <my bad experiment id>
systemslab submit my-experiment.jsonnet --context $ctx

Options

Option	Default	Description
--name		The name of the new context.
--inherit		An existing context ID to base the new context off of. This will copy the experiments and (optionally) the name from the provided context into the new one.

Common Options

Option	Default	Description
--systemslab-url		The URL at which to access the systemslab server.
--color	auto	Controls when color is used in the output. Possible values are auto, always, and never.
--output-format	long	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

Variable	Description
SYSTEMSLAB_URL	Specify the URL used to contact the SystemsLab server. Equivalent to --systemslab-url.