From: Zac Dover Date: Wed, 6 Sep 2023 06:33:43 +0000 (+1000) Subject: doc/man: remove docs about support for unix domain sockets X-Git-Tag: v18.2.1~318^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F53312%2Fhead;p=ceph.git doc/man: remove docs about support for unix domain sockets doc/man: support for unix domain sockets is not implemented, hence we removed documentation about it. (Note: the changes in this commit were the work of Rok Jaklič in https://github.com/ceph/ceph/pull/48537. This pull request has been raised because that pull request was for some mysterious reason causing merge conflicts that were never resolved.) Co-authored-by: Rok Jaklič rjaklic@gmail.com Signed-off-by: Zac Dover (cherry picked from commit fa40b7ef560fc60a107dad1604650e0bcf27e77e) --- diff --git a/doc/man/8/radosgw.rst b/doc/man/8/radosgw.rst index a3cb00b82f67..d31f3de8e6e8 100644 --- a/doc/man/8/radosgw.rst +++ b/doc/man/8/radosgw.rst @@ -53,10 +53,6 @@ Options Run in foreground, log to usual location -.. option:: --rgw-socket-path=path - - Specify a unix domain socket path. - .. option:: --rgw-region=region The region where radosgw runs @@ -80,30 +76,24 @@ and ``mod_proxy_fcgi`` have to be present in the server. Unlike ``mod_fastcgi``, or process management may be available in the FastCGI application framework in use. -``Apache`` can be configured in a way that enables ``mod_proxy_fcgi`` to be used -with localhost tcp or through unix domain socket. ``mod_proxy_fcgi`` that doesn't -support unix domain socket such as the ones in Apache 2.2 and earlier versions of -Apache 2.4, needs to be configured for use with localhost tcp. Later versions of -Apache like Apache 2.4.9 or later support unix domain socket and as such they -allow for the configuration with unix domain socket instead of localhost tcp. +``Apache`` must be configured in a way that enables ``mod_proxy_fcgi`` to be +used with localhost tcp. The following steps show the configuration in Ceph's configuration file i.e, ``/etc/ceph/ceph.conf`` and the gateway configuration file i.e, ``/etc/httpd/conf.d/rgw.conf`` (RPM-based distros) or ``/etc/apache2/conf-available/rgw.conf`` (Debian-based distros) with localhost -tcp and through unix domain socket: +tcp: #. For distros with Apache 2.2 and early versions of Apache 2.4 that use - localhost TCP and do not support Unix Domain Socket, append the following - contents to ``/etc/ceph/ceph.conf``:: + localhost TCP, append the following contents to ``/etc/ceph/ceph.conf``:: [client.radosgw.gateway] host = {hostname} keyring = /etc/ceph/ceph.client.radosgw.keyring - rgw socket path = "" - log file = /var/log/ceph/client.radosgw.gateway.log - rgw frontends = fastcgi socket_port=9000 socket_host=0.0.0.0 - rgw print continue = false + log_file = /var/log/ceph/client.radosgw.gateway.log + rgw_frontends = fastcgi socket_port=9000 socket_host=0.0.0.0 + rgw_print_continue = false #. Add the following content in the gateway configuration file: @@ -149,16 +139,6 @@ tcp and through unix domain socket: -#. For distros with Apache 2.4.9 or later that support Unix Domain Socket, - append the following configuration to ``/etc/ceph/ceph.conf``:: - - [client.radosgw.gateway] - host = {hostname} - keyring = /etc/ceph/ceph.client.radosgw.keyring - rgw socket path = /var/run/ceph/ceph.radosgw.gateway.fastcgi.sock - log file = /var/log/ceph/client.radosgw.gateway.log - rgw print continue = false - #. Add the following content in the gateway configuration file: For CentOS/RHEL add in ``/etc/httpd/conf.d/rgw.conf``:: @@ -182,10 +162,6 @@ tcp and through unix domain socket: - Please note, ``Apache 2.4.7`` does not have Unix Domain Socket support in - it and as such it has to be configured with localhost tcp. The Unix Domain - Socket support is available in ``Apache 2.4.9`` and later versions. - #. Generate a key for radosgw to use for authentication with the cluster. :: ceph-authtool -C -n client.radosgw.gateway --gen-key /etc/ceph/keyring.radosgw.gateway