]> git.proxmox.com Git - pve-docs.git/blobdiff - pve-storage-rbd.adoc
totp: fix copy/paste mistake
[pve-docs.git] / pve-storage-rbd.adoc
index 4002fd3fb5c07b2c91f5022e9c7ad7f8f6f127fa..5fe558a766b79d340743766f8da02d4d6377bb1d 100644 (file)
@@ -70,6 +70,9 @@ TIP: You can use the `rbd` utility to do low-level management tasks.
 Authentication
 ~~~~~~~~~~~~~~
 
+NOTE: If Ceph is installed locally on the {pve} cluster, the following is done
+automatically when adding the storage.
+
 If you use `cephx` authentication, which is enabled by default, you need to
 provide the keyring from the external Ceph cluster.
 
@@ -99,13 +102,29 @@ The keyring will be stored at
 # /etc/pve/priv/ceph/<STORAGE_ID>.keyring
 ----
 
-If Ceph is installed locally on the {pve} cluster, this is done automatically
-when adding the storage.
-
 TIP: Creating a keyring with only the needed capabilities is recommend when
 connecting to an external cluster. For further information on Ceph user
 management, see the Ceph docs.footnoteref:[cephusermgmt,{cephdocs-url}/rados/operations/user-management/[Ceph User Management]]
 
+Ceph client configuration (optional)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Connecting to an external Ceph storage doesn't always allow setting
+client-specific options in the config DB on the external cluster. You can add a
+`ceph.conf` beside the Ceph keyring to change the Ceph client configuration for
+the storage.
+
+The ceph.conf needs to have the same name as the storage.
+
+----
+# /etc/pve/priv/ceph/<STORAGE_ID>.conf
+----
+
+See the RBD configuration reference footnote:[RBD configuration reference
+{cephdocs-url}/rbd/rbd-config-ref/] for possible settings.
+
+NOTE: Do not change these settings lightly. {PVE} is merging the
+<STORAGE_ID>.conf with the storage configuration.
 
 
 Storage Features