From 7f0de467fca017fe7ac3a178b5f48b86eca0f214 Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Fri, 1 Mar 2024 22:11:14 +1000 Subject: [PATCH] doc/install: add manual RADOSGW install procedure Add a manual RADOSGW installation procedure to doc/install/manual-deployment.rst. This procedure was developed by Janne Johansson and reported to the ceph-users mailing list on 29 Jan 2024 here: https://lists.ceph.io/hyperkitty/list/ceph-users@ceph.io/message/LB3YRIKAPOHXYCW7MKLVUJPYWYRQVARU/ Co-authored-by: Janne Johansson Co-authored-by: Anthony D'Atri Signed-off-by: Zac Dover (cherry picked from commit 565bc9503838906995fa48f59debcd2843775b18) --- doc/install/manual-deployment.rst | 46 +++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) diff --git a/doc/install/manual-deployment.rst b/doc/install/manual-deployment.rst index 6716ecb5beb50..0eb759de701ce 100644 --- a/doc/install/manual-deployment.rst +++ b/doc/install/manual-deployment.rst @@ -461,6 +461,52 @@ In the below instructions, ``{id}`` is an arbitrary name, such as the hostname o #. Now you are ready to `create a Ceph file system`_. +Manually Installing RADOSGW +=========================== + +For a more involved discussion of the procedure presented here, see `this +thread on the ceph-users mailing list +`_. + +#. Install ``radosgw`` packages on the nodes that will be the RGW nodes. + +#. From a monitor or from a node with admin privileges, run a command of the + following form: + + .. prompt:: bash # + + ceph auth get-or-create client.short-hostname-of-rgw mon 'allow rw' osd 'allow rwx' + +#. On one of the RGW nodes, do the following: + + a. Create a ``ceph-user``-owned directory. For example: + + .. prompt:: bash # + + install -d -o ceph -g ceph /var/lib/ceph/radosgw/ceph-$(hostname -s) + + b. Enter the directory just created and create a ``keyring`` file: + + .. prompt:: bash # + + touch /var/lib/ceph/radosgw/ceph-$(hostname -s)/keyring + + Use a command similar to this one to put the key from the earlier ``ceph + auth get-or-create`` step in the ``keyring`` file. Use your preferred + editor: + + .. prompt:: bash # + + $EDITOR /var/lib/ceph/radosgw/ceph-$(hostname -s)/keyring + + c. Repeat these steps on every RGW node. + +#. Start the RADOSGW service by running the following command: + + .. prompt:: bash # + + systemctl start ceph-radosgw@$(hostname -s).service + Summary ======= -- 2.39.5