flux restore [OPTIONS] INFILE


The flux restore command reads a KVS snapshot from a portable archive format, usually written by flux-dump(1).

The archive source may be specified as a file path or - for standard input. The format of the archive may be any of the formats supported by libarchive(3) and is determined on the fly based on the archive content.

The snapshot may be restored to a KVS key if --key=NAME is used and the KVS service is running, or as a checkpoint in the content backing store if --checkpoint is used, without the KVS running. One of those two options is required.


-h, --help

Summarize available options.

-v, --verbose

List keys on stderr as they are restored instead of a periodic count of restored keys.

-q, --quiet

Don't show a periodic count of restored keys on stderr.


After restoring the archived content, write the final root blobref to the KVS checkpoint area in the content backing store. The checkpoint is used as the initial KVS root when the KVS module is loaded. Unload the KVS module before restoring with this option.


After restoring the archived content, write the final root blobref to a KVS key, so the key becomes the restored root directory.


Bypass the broker content cache and interact directly with the backing store. Performance will vary depending on the content of the archive.


Skip restoring keys that exceed SIZE bytes (default: no limit). SIZE may be specified as a floating point number with an optional multiplicative suffix k or K=1024, M=1024*1024, or G=1024*1024*1024 (up to INT_MAX).


Flux: http://flux-framework.org

Flux RFC: https://flux-framework.readthedocs.io/projects/flux-rfc


10/Content Storage Service

11/Key Value Store Tree Object Format v1


flux-dump(1), flux-kvs(1)