docs: deprecate the rados storage-backend

bareos · Nov 23, 2020 · d118446 · d118446
1 parent 1644ab3
commit d118446
Show file tree

Hide file tree

Showing 3 changed files with 10 additions and 2 deletions.
diff --git a/docs/manuals/source/TasksAndConcepts/Plugins.rst b/docs/manuals/source/TasksAndConcepts/Plugins.rst
@@ -426,6 +426,9 @@ Opposite to the :ref:`Rados Backend <SdBackendRados>` that is used to store data
 Rados Plugin
 ~~~~~~~~~~~~
 
+.. comment::
+   .. deprecated:: 20.0.0
+
 :index:`\ <single: Plugin; ceph; rados>`\  :index:`\ <single: Ceph; Rados Plugin>`\
 
 Opposite to the :ref:`Rados Backend <SdBackendRados>` that is used to store data on a CEPH Object Store, this plugin is intended to backup a CEPH Object Store via the Rados interface to other media. The package **bareos-filedaemon-ceph-plugin** (:sinceVersion:`15.2.0: CEPH Rados Plugin`) contains an example configuration file, that must be adapted to your environment.

diff --git a/docs/manuals/source/TasksAndConcepts/StorageBackends.rst b/docs/manuals/source/TasksAndConcepts/StorageBackends.rst
@@ -19,7 +19,8 @@ A Bareos Storage Daemon can use various storage backends:
    is used to access a GlusterFS storage.
 
 **Rados** (Ceph Object Store)
-   is used to access a Ceph object store.
+   is used to access a Ceph object store (deprecated since Bareos 20.0.0)
+
 
 .. _SdBackendDroplet:
 
@@ -174,7 +175,7 @@ More arguments and the SSL parameters can be found in the documentation of the d
 CEPH Object Gateway S3
 ^^^^^^^^^^^^^^^^^^^^^^
 
-Please note, that there is also the :ref:`SdBackendRados` backend, which can backup to CEPH directly. However, currently (17.2.7) the **Droplet** (S3) is known to outperform the **Rados** backend.
+Please note, that there is also the :ref:`SdBackendRados` backend, which is deprecated since Bareos 20.0.0. Please use the **Droplet** (S3) backend, instead.
 
 While parameters have been explained in the :ref:`section-DropletAwsS3` section, this gives an example about how to backup to a CEPH Object Gateway S3.
 
@@ -351,6 +352,8 @@ Adapt server and volume name to your environment.
 Rados Storage Backend
 ---------------------
 
+.. deprecated:: 20.0.0
+
 **Rados** (Ceph Object Store)
 
 Here you configure the Ceph object store, which is accessed by the SD using the Rados library. Prerequistes are a working Ceph object store and the package **bareos-storage-ceph**. See http://ceph.com for more information regarding Ceph installation and configuration. Assuming that you have an object store with name :file:`poolname` and your Ceph access is configured in :file:`/etc/ceph/ceph.conf`, you can use following snippet to configure it as

diff --git a/.../manuals/source/manually_added_config_directive_descriptions/sd-device-DeviceType.rst.inc b/.../manuals/source/manually_added_config_directive_descriptions/sd-device-DeviceType.rst.inc
@@ -19,6 +19,8 @@ The Device Type specification allows you to explicitly define the kind of device
 
    :sinceVersion:`14.2.2: Ceph (Rados)`
 
+   .. deprecated:: 20.0.0
+
 **Droplet**
    is used to access an object store supported by **libdroplet**, most notably S3. For details, refer to :ref:`SdBackendDroplet`.