diff options
| author | OpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com> | 2019-06-20 12:30:23 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2019-06-20 12:30:23 +0200 |
| commit | 00f266393ef6397cea2b1a7d53a257cb79020bf0 (patch) | |
| tree | 69fbce35cebe6f6b75e83e383273341ca0242167 | |
| parent | b4f9bc868e2f5b3ffc5b7487be9d7b717dd6ae5b (diff) | |
| parent | 300025359eb5ed6d2128d4675fa9b72a3841761c (diff) | |
| download | podman-00f266393ef6397cea2b1a7d53a257cb79020bf0.tar.gz podman-00f266393ef6397cea2b1a7d53a257cb79020bf0.tar.bz2 podman-00f266393ef6397cea2b1a7d53a257cb79020bf0.zip | |
Merge pull request #3356 from giuseppe/system-migrate-add-doc
docs: add note to system migrate
| -rw-r--r-- | docs/podman-system-migrate.1.md | 15 |
1 files changed, 14 insertions, 1 deletions
diff --git a/docs/podman-system-migrate.1.md b/docs/podman-system-migrate.1.md index 48f3bca8f..1efa779ce 100644 --- a/docs/podman-system-migrate.1.md +++ b/docs/podman-system-migrate.1.md @@ -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) |