NAME

       podman-system-renumber  -  Migrate  lock  numbers  to handle a change in maximum number of
       locks

SYNOPSIS

       podman system renumber

DESCRIPTION

       podman system renumber renumbers locks used by containers and pods.

       Each Podman container and pod is allocated a lock at creation time, up to a maximum number
       controlled by the num_locks parameter in containers.conf.

       When  all  available  locks  are  exhausted, no further containers and pods can be created
       until some existing containers and pods are removed. This can be avoided by increasing the
       number  of  locks  available via modifying containers.conf and subsequently running podman
       system renumber to prepare the new locks (and reallocate  lock  numbers  to  fit  the  new
       struct).

       podman  system  renumber  must be called after any changes to num_locks - failure to do so
       results in errors starting Podman as the number of  locks  available  conflicts  with  the
       configured number of locks.

       podman  system  renumber  can  also be used to migrate 1.0 and earlier versions of Podman,
       which used a different locking scheme, to the  new  locking  model.  It  is  not  strictly
       required  to  do  this,  but  it  is  highly  recommended  to do so as deadlocks can occur
       otherwise.

       If possible, avoid calling podman system renumber while there are other  Podman  processes
       running.

SEE ALSO

       podman(1), podman-system(1), containers.conf(5)

HISTORY

       February 2019, Originally compiled by Matt Heon (mheon at redhat dot com)

                                                                        podman-system-renumber(1)