]> git.proxmox.com Git - ceph.git/blame - ceph/doc/rados/configuration/filesystem-recommendations.rst
update sources to v12.1.1
[ceph.git] / ceph / doc / rados / configuration / filesystem-recommendations.rst
CommitLineData
7c673cae
FG
1===========================================
2 Hard Disk and File System Recommendations
3===========================================
4
5.. index:: hard drive preparation
6
7Hard Drive Prep
8===============
9
10Ceph aims for data safety, which means that when the :term:`Ceph Client`
11receives notice that data was written to a storage drive, that data was actually
12written to the storage drive. For old kernels (<2.6.33), disable the write cache
13if the journal is on a raw drive. Newer kernels should work fine.
14
15Use ``hdparm`` to disable write caching on the hard disk::
16
17 sudo hdparm -W 0 /dev/hda 0
18
19In production environments, we recommend running a :term:`Ceph OSD Daemon` with
20separate drives for the operating system and the data. If you run data and an
21operating system on a single disk, we recommend creating a separate partition
22for your data.
23
24.. index:: filesystems
25
26Filesystems
27===========
28
29Ceph OSD Daemons rely heavily upon the stability and performance of the
30underlying filesystem.
31
32Recommended
33-----------
34
35We currently recommend ``XFS`` for production deployments.
36
7c673cae
FG
37Not recommended
38---------------
39
224ce89b
WB
40We recommand *against* using ``btrfs`` due to the lack of a stable
41version to test against and frequent bugs in the ENOSPC handling.
42
7c673cae
FG
43We recommend *against* using ``ext4`` due to limitations in the size
44of xattrs it can store, and the problems this causes with the way Ceph
45handles long RADOS object names. Although these issues will generally
46not surface with Ceph clusters using only short object names (e.g., an
47RBD workload that does not include long RBD image names), other users
48like RGW make extensive use of long object names and can break.
49
50Starting with the Jewel release, the ``ceph-osd`` daemon will refuse
51to start if the configured max object name cannot be safely stored on
52``ext4``. If the cluster is only being used with short object names
53(e.g., RBD only), you can continue using ``ext4`` by setting the
54following configuration option::
55
56 osd max object name len = 256
57 osd max object namespace len = 64
58
59.. note:: This may result in difficult-to-diagnose errors if you try
60 to use RGW or other librados clients that do not properly
61 handle or politely surface any resulting ENAMETOOLONG
62 errors.