diff --git a/userdocs/contents/images.rst b/userdocs/contents/images.rst index 53cc6dc1..8422ef26 100644 --- a/userdocs/contents/images.rst +++ b/userdocs/contents/images.rst @@ -173,21 +173,6 @@ directly. $ apptainer build --sandbox ./rockylinux-8/ docker://ghcr.io/warewulf/warewulf-rockylinux:8 $ sudo wwctl image import ./rockylinux-8/ rockylinux-8 -.. note:: - - If a source directory includes persistent sockets, these sockets may cause the import operation to fail. - - .. code-block:: console - - Copying sources... - ERROR : could not import image: lchown ./rockylinux-8/run/user/0/gnupg/d.kg8ijih5tq41ixoeag4p1qup/S.gpg-agent: no such file or directory - - To resolve this, remove the sockets from the source directory. - - .. code-block:: bash - - find ./rockylinux-8/ -type s -delete - HTTP proxies ------------ diff --git a/userdocs/contents/known-issues.rst b/userdocs/contents/known-issues.rst index b15687ab..0ead49cd 100644 --- a/userdocs/contents/known-issues.rst +++ b/userdocs/contents/known-issues.rst @@ -35,3 +35,22 @@ To mark a Warewulf image as writeable, use `chmod u+w`. # chmod u+w $(wwctl image show rockylinux-9.5) This behavior is changed in v4.6 to use an explicit ``readonly`` file stored outside of ``rootfs/``. + +Image sockets cause build failures +================================== + +If an image source directory includes persistent sockets, these sockets may cause the import operation to fail. + +.. code-block:: console + + Copying sources... + ERROR : could not import image: lchown ./rockylinux-8/run/user/0/gnupg/d.kg8ijih5tq41ixoeag4p1qup/S.gpg-agent: no such file or directory + +To resolve this, remove the sockets from the source directory. + +.. code-block:: bash + + find ./rockylinux-8/ -type s -delete + +This issue was fixed in an upstream library and `should be resolved in Warewulf +v4.6.0. `_