From 88dd90e15ebb882f28fdc65ef07592504b8b33fc Mon Sep 17 00:00:00 2001 From: John Wilkins Date: Tue, 18 Sep 2012 11:23:22 -0700 Subject: [PATCH] :doc: Removed old rec section. Signed-off-by: John Wilkins --- doc/rec/crypto.rst | 7 ------ doc/rec/data-placement.rst | 7 ------ doc/rec/filesystem.rst | 45 -------------------------------------- doc/rec/hardware.rst | 7 ------ doc/rec/index.rst | 16 -------------- 5 files changed, 82 deletions(-) delete mode 100644 doc/rec/crypto.rst delete mode 100644 doc/rec/data-placement.rst delete mode 100644 doc/rec/filesystem.rst delete mode 100644 doc/rec/hardware.rst delete mode 100644 doc/rec/index.rst diff --git a/doc/rec/crypto.rst b/doc/rec/crypto.rst deleted file mode 100644 index 6fe7d858d530f..0000000000000 --- a/doc/rec/crypto.rst +++ /dev/null @@ -1,7 +0,0 @@ -======================== - Disabling cryptography -======================== - -Authentication is optional but very much recommended. - -.. todo:: write me diff --git a/doc/rec/data-placement.rst b/doc/rec/data-placement.rst deleted file mode 100644 index cae7f47e3158c..0000000000000 --- a/doc/rec/data-placement.rst +++ /dev/null @@ -1,7 +0,0 @@ -================ - Data placement -================ - -.. todo:: brief intro to CRUSH, pointers to more - -.. todo:: Considerations and tradeoffs of different placement policies diff --git a/doc/rec/filesystem.rst b/doc/rec/filesystem.rst deleted file mode 100644 index efe2038720d90..0000000000000 --- a/doc/rec/filesystem.rst +++ /dev/null @@ -1,45 +0,0 @@ -============ - Filesystem -============ -For details on file systems when configuring a cluster See -`Hard Disk and File System Recommendations`_ . - -.. tip:: We recommend configuring Ceph to use the ``XFS`` file system in - the near term, and ``btrfs`` in the long term once it is stable - enough for production. - -Before ``ext3``, ``ReiserFS`` was the only journaling file system available for -Linux. However, ``ext3`` doesn't provide Extended Attribute (XATTR) support. -While ``ext4`` provides XATTR support, it only allows XATTRs up to 4kb. The -4kb limit is not enough for RADOS GW ACLs, snapshots, and other features. As of -version 0.45, Ceph provides a ``leveldb`` feature for ``ext4`` file systems -that stores XATTRs in excess of 4kb in a ``leveldb`` database. - -The ``XFS`` and ``btrfs`` file systems provide numerous advantages in highly -scaled data storage environments when `compared`_ to ``ext3`` and ``ext4``. -Both ``XFS`` and ``btrfs`` are `journaling file systems`_, which means that -they are more robust when recovering from crashes, power outages, etc. These -filesystems journal all of the changes they will make before performing writes. - -``XFS`` was developed for Silicon Graphics, and is a mature and stable -filesystem. By contrast, ``btrfs`` is a relatively new file system that aims -to address the long-standing wishes of system administrators working with -large scale data storage environments. ``btrfs`` has some unique features -and advantages compared to other Linux filesystems. - -``btrfs`` is a `copy-on-write`_ filesystem. It supports file creation -timestamps and checksums that verify metadata integrity, so it can detect -bad copies of data and fix them with the good copies. The copy-on-write -capability means that ``btrfs`` can support snapshots that are writable. -``btrfs`` supports transparent compression and other features. - -``btrfs`` also incorporates multi-device management into the file system, -which enables you to support heterogeneous disk storage infrastructure, -data allocation policies. The community also aims to provide ``fsck``, -deduplication, and data encryption support in the future. This compelling -list of features makes ``btrfs`` the ideal choice for Ceph clusters. - -.. _copy-on-write: http://en.wikipedia.org/wiki/Copy-on-write -.. _Hard Disk and File System Recommendations: ../../config-cluster/file-system-recommendations -.. _compared: http://en.wikipedia.org/wiki/Comparison_of_file_systems -.. _journaling file systems: http://en.wikipedia.org/wiki/Journaling_file_system diff --git a/doc/rec/hardware.rst b/doc/rec/hardware.rst deleted file mode 100644 index 4fe241357ed70..0000000000000 --- a/doc/rec/hardware.rst +++ /dev/null @@ -1,7 +0,0 @@ -========== - Hardware -========== - -See `Hardware Recommendations`_ for details. - -.. _Hardware Recommendations: ../../install/hardware-recommendations diff --git a/doc/rec/index.rst b/doc/rec/index.rst deleted file mode 100644 index c908c2e37099b..0000000000000 --- a/doc/rec/index.rst +++ /dev/null @@ -1,16 +0,0 @@ -================= - 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 - data-placement - crypto -- 2.39.5