When C/R fails

This page is the collection of typical situations when checkpoint or restore fails.

PID mismatch on restoreEdit

If you see one of these lines in the failed restore logs

Pid $number do not match expected $another_number
Thread pid mismatch $number1/$number2

this means that while restoring a process tree, CRIU has failed to recreate a process (or a thread) with the PID (TID) value the proceess (thread) used to have on dump. Most likely, this is because the desired PID/TID is used by other task or thread. There are several possible solutions to this.

Restore "by hand"Edit

One way is to restore the images into a separate pid namespace. This can be done by using the unshare -p -m --fork --mount-proc command and then doing the restore. In this case, you might also want to unshare the mount namespace and re-mount the /proc, so that the restored tasks can use it. This method effectively means restoring tasks in a container.

Note, however, that the most correct way is to run the tasks you plan to checkpoint in the pid namespace (with /proc tune-up if required) from the very beginning.

Kill the obstacleEdit

Another solution to PID mismatch, which is not correct, but still efficient, is to kill the offending taskĀ :)

With CRIU helpEdit

There's a helper script called criu-ns that does restore in pseudo-container and also can dump again the restored tree. For more details see the "CR in namespace" article.

Mount namespace with external dependencesEdit

The dump-time error in logs

$nr:$path doesn't have a proper root mount

indicates that the container (or just mount namespace) being dumped has some external dependences. CRIU knows how to work with it, you just need to tell CRIU about external bind mounts you have.

External unix socket connectionEdit

If an application has an open unix connection to the external world, the dump will fail with

"Cannot dump half of a stream unix connection

In this case the socket should be explained as "OK to break" and reconnected back on restore. How to do it is described in here