Cedana
Cedana Daemon
Cedana
Cedana Daemon
  • Cedana Daemon
  • Get started
    • Installation
    • Authentication
    • Configuration
    • Health checks
    • Plugins
    • Feature matrix
  • Guides
    • Managed process/container
    • Checkpoint/restore basics
    • Checkpoint/restore with GPUs
    • Checkpoint/restore runc
    • Checkpoint/restore containerd
    • Checkpoint/restore streamer
    • Checkpoint/restore kata
      • how-to-create-custom-busybox-image
      • how-to-install-criu-in-guest
      • how-to-install-on-aws
      • how-to-make-kernel-criu-compatible
      • how-to-make-rootfs-criu-compatible
      • Checkpoint/Restore kata containers
  • Developer guides
    • Architecture
    • Profiling
    • Testing
    • Writing plugins
  • References
    • CLI
      • cedana
      • cedana attach
      • cedana checkpoint
      • cedana checkpoints
      • cedana completion
      • cedana completion bash
      • cedana completion fish
      • cedana completion powershell
      • cedana completion zsh
      • cedana daemon
      • cedana daemon check
      • cedana daemon start
      • cedana delete
      • cedana dump
      • cedana dump containerd
      • cedana dump job
      • cedana dump process
      • cedana dump runc
      • cedana exec
      • cedana features
      • cedana inspect
      • cedana job
      • cedana job attach
      • cedana job checkpoint
      • cedana job checkpoint inspect
      • cedana job checkpoint list
      • cedana job checkpoints
      • cedana job delete
      • cedana job inspect
      • cedana job kill
      • cedana job list
      • cedana jobs
      • cedana k8s-helper
      • cedana k8s-helper destroy
      • cedana kill
      • cedana manage
      • cedana manage containerd
      • cedana manage process
      • cedana manage runc
      • cedana plugin
      • cedana plugin features
      • cedana plugin install
      • cedana plugin list
      • cedana plugin remove
      • cedana plugins
      • cedana ps
      • cedana query
      • cedana query k8s
      • cedana query runc
      • cedana restore
      • cedana restore job
      • cedana restore process
      • cedana restore runc
      • cedana run
      • cedana run containerd
      • cedana run process
      • cedana run runc
    • API
    • GitHub
Powered by GitBook
On this page
  • Prerequisites
  • Checkpoint
  • Restore
  • Compression
  • Remoting
  • Enable by default

Was this helpful?

Edit on GitHub
  1. Guides

Checkpoint/restore streamer

PreviousCheckpoint/restore containerdNextCheckpoint/restore kata

Last updated 2 months ago

Was this helpful?

The Cedana daemon supports checkpoint/restore via low-overhead streaming. It's powered by the , which is a fork of CRIU's .

Real benefit of streaming is realized when checkpointing and restoring to/from a remote location. See Remoting.

Prerequisites

  1. Create an account with Cedana, to get access to the streamer plugin. See .

  2. Set the Cedana URL & authentication token in the .

  3. Install the streamer plugin with sudo cedana plugin install streamer.

  4. Ensure the daemon is running, see .

  5. Do a health check to ensure the plugin is ready, see .

Checkpoint

The cedana dump subcommand supports a --stream <n> flag, where n is the number of parallel streams to use. For example:

cedana dump process <pid> --stream 4

This will directly stream the checkpoint to a directory, using 4 parallel streams. You will notice that the checkpoint directory contains 4 separate image files:

-rw-r--r-- 1 root root 145K Feb 19 15:13 img-0
-rw-r--r-- 1 root root  17K Feb 19 15:13 img-1
-rw-r--r-- 1 root root 209K Feb 19 15:13 img-2
-rw-r--r-- 1 root root 188K Feb 19 15:13 img-3

Restore

Similarly, the cedana restore subcommand supports a --stream <n> flag, where n is the number of parallel streams to use. For example:

cedana restore process --stream 4 --path <path-to-dump>

Note that, here you must pass in 4 as the number of parallel streams, as the checkpoint directory contains 4 separate image files, since the checkpoint was taken with 4 parallel streams.

Compression

Remoting

Enable by default

All compression algorithms supported for basic checkpoint/restore are supported. See for more information.

The daemon simply reads/writes from the filesystem. This is also the case for streaming, with the additional requirement that the underlying filesystem must be .

To checkpoint/restore to/from a remote directory, you can use a FUSE-based filesystem mount backed by your network storage. For Amazon's S3, check out .

To enable streaming by default, set the Checkpoint.Stream field in the to the desired number of parallel streams. Zero means no streaming.

For all available CLI options, see . Directly interacting with daemon is also possible through gRPC, see .

streamer plugin
image streamer
authentication
configuration
installation
health checks
POSIX-compliant
s3fs-fuse
configuration
CLI reference
API reference
compression