From 8b98a949f730f5f306ce1aa2a315cd5497ea3c64 Mon Sep 17 00:00:00 2001 From: Mike McLean Date: Tue, 6 May 2025 16:55:16 -0400 Subject: [PATCH] update volume docs --- docs/source/volumes.rst | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/docs/source/volumes.rst b/docs/source/volumes.rst index 096f29a8..be5ae177 100644 --- a/docs/source/volumes.rst +++ b/docs/source/volumes.rst @@ -73,9 +73,17 @@ for builds on other volumes. Adding a new volume ------------------- -The new volume directory should initially contain a packages/ -subdirectory, and the permissions should be the same as the default -packages directory. +The new volume directory should initially contain: + +* a ``packages`` subdirectory +* a ``toplink`` symlink to the primary volume (i.e. /mnt/koji) + +The permissions for the ``packages`` directory should be the same as the\ +default packages directory. + +The ``toplink`` symlink should normally be an absolute symlink. +If you do not create it, then Koji will do so for you when you run the +add-volume command. Assuming you do use a mount for a vol/NAME directory, you will want to ensure that the same mounts are created on all systems that interface with