]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc/man: remove docs about support for unix domain sockets 53302/head
authorZac Dover <zac.dover@proton.me>
Wed, 6 Sep 2023 06:33:43 +0000 (16:33 +1000)
committerZac Dover <zac.dover@proton.me>
Wed, 6 Sep 2023 06:33:43 +0000 (16:33 +1000)
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 <zac.dover@proton.me>
doc/man/8/radosgw.rst

index 0d997ace83dcfb95980bd7bfa6415caed14014c5..6dee83e946585bc6db4ce9531d7634f570770492 100644 (file)
@@ -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,27 +76,21 @@ 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
@@ -149,16 +139,6 @@ tcp and through unix domain socket:
 
                </VirtualHost>
 
-#. 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:
 
                </VirtualHost>
 
-   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