containers
/
automation-tests
mirror of https://github.com/containers/automation-tests.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #3356 from giuseppe/system-migrate-add-doc 

docs: add note to system migrate
This commit is contained in:
OpenShift Merge Robot 2019-06-20 12:30:23 +02:00 committed by GitHub
parent b4f9bc868e 300025359e
commit 00f266393e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 14 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/podman-system-migrate.1.md
View File

@ -11,11 +11,24 @@ podman\-system\-migrate - Migrate container to the latest version of podman
**podman system migrate** takes care of migrating existing containers to the latest version of podman if any change is necessary.
"Rootless Podman uses a pause process to keep the unprivileged
namespaces alive. This prevents any change to the `/etc/subuid` and
`/etc/subgid` files from being propagated to the rootless containers
while the pause process is running.
For these changes to be propagated, it is necessary to first stop all
running containers associated with the user and to also stop the pause
process and delete its pid file. Instead of doing it manually, `podman
system migrate` can be used to stop both the running containers and the
pause process. The `/etc/subuid` and `/etc/subgid` files can then be
edited or changed with usermod to recreate the user namespace with the
newly configured mappings.
## SYNOPSIS
**podman system migrate**
## SEE ALSO
`podman(1)`, `libpod.conf(5)`
`podman(1)`, `libpod.conf(5)`, `usermod(8)`
## HISTORY
April 2019, Originally compiled by Giuseppe Scrivano (gscrivan at redhat dot com)