diff --git a/doc/index.rst b/doc/index.rst index d3ad0c669ec..588c47b8580 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -89,6 +89,7 @@ Table of Contents tutorial architecture ops/index + rec/index api/index Internals man/index diff --git a/doc/ops/index.rst b/doc/ops/index.rst index 3bc4dbaabe1..2fd9e7ed73c 100644 --- a/doc/ops/index.rst +++ b/doc/ops/index.rst @@ -9,9 +9,6 @@ config radosgw rbd - hardware - filesystem monitor data-placement autobuilt - misc diff --git a/doc/ops/misc.rst b/doc/ops/misc.rst deleted file mode 100644 index 084debc80e7..00000000000 --- a/doc/ops/misc.rst +++ /dev/null @@ -1,14 +0,0 @@ -=============== - Miscellaneous -=============== - -.. todo:: This section should not exist. Try to reorganize, when - document is otherwise more ready. - - -Disabling encryption -==================== - -Authentication is optional but very much recommended. - -.. todo:: write me diff --git a/doc/rec/crypto.rst b/doc/rec/crypto.rst new file mode 100644 index 00000000000..6fe7d858d53 --- /dev/null +++ b/doc/rec/crypto.rst @@ -0,0 +1,7 @@ +======================== + Disabling cryptography +======================== + +Authentication is optional but very much recommended. + +.. todo:: write me diff --git a/doc/ops/filesystem.rst b/doc/rec/filesystem.rst similarity index 100% rename from doc/ops/filesystem.rst rename to doc/rec/filesystem.rst diff --git a/doc/ops/hardware.rst b/doc/rec/hardware.rst similarity index 78% rename from doc/ops/hardware.rst rename to doc/rec/hardware.rst index a3c5872d019..7cc5506fbd1 100644 --- a/doc/ops/hardware.rst +++ b/doc/rec/hardware.rst @@ -2,9 +2,6 @@ Hardware recommendations ========================== -Hardware requirements and tradeoffs -=================================== - Discussing the hardware requirements for each daemon, the tradeoffs of doing one cosd per machine versus one per disk, and hardware-related configuration options like journaling locations. diff --git a/doc/rec/index.rst b/doc/rec/index.rst new file mode 100644 index 00000000000..0b1e6154ef7 --- /dev/null +++ b/doc/rec/index.rst @@ -0,0 +1,15 @@ +================= + Recommendations +================= + +There are several ways to set up a storage system. Often, the nature +of the load means different tradeoffs make sense for different +installations. This section aims to walk through some common +scenarios, and inform you on how to decide what is best for your +cluster. + +.. toctree:: + + hardware + filesystem + crypto