]>
Commit | Line | Data |
---|---|---|
7c673cae FG |
1 | ==================== |
2 | OS Recommendations | |
3 | ==================== | |
4 | ||
5 | Ceph Dependencies | |
6 | ================= | |
7 | ||
8 | As a general rule, we recommend deploying Ceph on newer releases of Linux. | |
9 | We also recommend deploying on releases with long-term support. | |
10 | ||
11 | Linux Kernel | |
12 | ------------ | |
13 | ||
14 | - **Ceph Kernel Client** | |
15 | ||
224ce89b WB |
16 | If you are using the kernel client to map RBD block devices or mount |
17 | CephFS, the general advice is to use a "stable" or "longterm | |
18 | maintenance" kernel series provided by either http://kernel.org or | |
19 | your Linux distribution on any client hosts. | |
7c673cae FG |
20 | |
21 | For RBD, if you choose to *track* long-term kernels, we currently recommend | |
f67539c2 | 22 | 4.x-based "longterm maintenance" kernel series or later: |
7c673cae | 23 | |
9f95a23c | 24 | - 4.19.z |
11fdf7f2 | 25 | - 4.14.z |
f67539c2 | 26 | - 5.x |
7c673cae | 27 | |
f67539c2 TL |
28 | For CephFS, see the section about `Mounting CephFS using Kernel Driver`_ |
29 | for kernel version guidance. | |
7c673cae | 30 | |
224ce89b WB |
31 | Older kernel client versions may not support your `CRUSH tunables`_ profile |
32 | or other newer features of the Ceph cluster, requiring the storage cluster | |
33 | to be configured with those features disabled. | |
7c673cae | 34 | |
7c673cae FG |
35 | |
36 | Platforms | |
37 | ========= | |
38 | ||
39 | The charts below show how Ceph's requirements map onto various Linux | |
40 | platforms. Generally speaking, there is very little dependence on | |
41 | specific distributions aside from the kernel and system initialization | |
20effc67 | 42 | package (i.e., sysvinit, systemd). |
7c673cae | 43 | |
f67539c2 TL |
44 | Octopus (15.2.z) |
45 | ----------------- | |
46 | ||
47 | +----------+----------+--------------------+--------------+---------+------------+ | |
48 | | Distro | Release | Code Name | Kernel | Notes | Testing | | |
49 | +==========+==========+====================+==============+=========+============+ | |
50 | | CentOS | 8 | N/A | linux-4.18 | | B, I, C | | |
51 | +----------+----------+--------------------+--------------+---------+------------+ | |
52 | | CentOS | 7 | N/A | linux-3.10.0 | 4, 5 | B, I | | |
53 | +----------+----------+--------------------+--------------+---------+------------+ | |
54 | | Debian | 10 | Buster | linux-4.19 | | B | | |
55 | +----------+----------+--------------------+--------------+---------+------------+ | |
56 | | RHEL | 8 | Ootpa | linux-4.18 | | B, I, C | | |
57 | +----------+----------+--------------------+--------------+---------+------------+ | |
58 | | RHEL | 7 | Maipo | linux-3.10.0 | | B, I | | |
59 | +----------+----------+--------------------+--------------+---------+------------+ | |
60 | | Ubuntu | 18.04 | Bionic Beaver | linux-4.15 | 4 | B, I, C | | |
61 | +----------+----------+--------------------+--------------+---------+------------+ | |
62 | | openSUSE | 15.2 | Leap | linux-5.3 | 6 | | | |
63 | +----------+----------+--------------------+--------------+---------+------------+ | |
64 | | openSUSE | | Tumbleweed | | | | | |
65 | +----------+----------+--------------------+--------------+---------+------------+ | |
66 | ||
67 | ||
9f95a23c | 68 | Nautilus (14.2.z) |
224ce89b WB |
69 | ----------------- |
70 | ||
71 | +----------+----------+--------------------+--------------+---------+------------+ | |
72 | | Distro | Release | Code Name | Kernel | Notes | Testing | | |
73 | +==========+==========+====================+==============+=========+============+ | |
74 | | CentOS | 7 | N/A | linux-3.10.0 | 3 | B, I, C | | |
75 | +----------+----------+--------------------+--------------+---------+------------+ | |
76 | | Debian | 8.0 | Jessie | linux-3.16.0 | 1, 2 | B, I | | |
77 | +----------+----------+--------------------+--------------+---------+------------+ | |
78 | | Debian | 9.0 | Stretch | linux-4.9 | 1, 2 | B, I | | |
79 | +----------+----------+--------------------+--------------+---------+------------+ | |
224ce89b WB |
80 | | RHEL | 7 | Maipo | linux-3.10.0 | | B, I | |
81 | +----------+----------+--------------------+--------------+---------+------------+ | |
82 | | Ubuntu | 14.04 | Trusty Tahr | linux-3.13.0 | | B, I, C | | |
83 | +----------+----------+--------------------+--------------+---------+------------+ | |
84 | | Ubuntu | 16.04 | Xenial Xerus | linux-4.4.0 | 3 | B, I, C | | |
85 | +----------+----------+--------------------+--------------+---------+------------+ | |
9f95a23c TL |
86 | | Ubuntu | 18.04 | Bionic Beaver | linux-4.15 | 3 | B, I, C | |
87 | +----------+----------+--------------------+--------------+---------+------------+ | |
f67539c2 | 88 | | openSUSE | 15.1 | Leap | linux-4.12 | 6 | | |
9f95a23c | 89 | +----------+----------+--------------------+--------------+---------+------------+ |
224ce89b | 90 | |
9f95a23c TL |
91 | Luminous (12.2.z) |
92 | ----------------- | |
7c673cae FG |
93 | |
94 | +----------+----------+--------------------+--------------+---------+------------+ | |
9f95a23c | 95 | | Distro | Release | Code Name | Kernel | Notes | Testing | |
7c673cae | 96 | +==========+==========+====================+==============+=========+============+ |
224ce89b | 97 | | CentOS | 7 | N/A | linux-3.10.0 | 3 | B, I, C | |
7c673cae FG |
98 | +----------+----------+--------------------+--------------+---------+------------+ |
99 | | Debian | 8.0 | Jessie | linux-3.16.0 | 1, 2 | B, I | | |
100 | +----------+----------+--------------------+--------------+---------+------------+ | |
9f95a23c TL |
101 | | Debian | 9.0 | Stretch | linux-4.9 | 1, 2 | B, I | |
102 | +----------+----------+--------------------+--------------+---------+------------+ | |
7c673cae FG |
103 | | Fedora | 22 | N/A | linux-3.14.0 | | B, I | |
104 | +----------+----------+--------------------+--------------+---------+------------+ | |
105 | | RHEL | 7 | Maipo | linux-3.10.0 | | B, I | | |
106 | +----------+----------+--------------------+--------------+---------+------------+ | |
107 | | Ubuntu | 14.04 | Trusty Tahr | linux-3.13.0 | | B, I, C | | |
108 | +----------+----------+--------------------+--------------+---------+------------+ | |
9f95a23c | 109 | | Ubuntu | 16.04 | Xenial Xerus | linux-4.4.0 | 3 | B, I, C | |
7c673cae FG |
110 | +----------+----------+--------------------+--------------+---------+------------+ |
111 | ||
112 | Notes | |
113 | ----- | |
114 | ||
f67539c2 TL |
115 | - **1**: The default kernel has an older version of ``Btrfs`` that we do not |
116 | recommend for ``ceph-osd`` storage nodes. We recommend using ``BlueStore`` | |
117 | starting with Luminous, and ``XFS`` for previous releases with ``Filestore``. | |
7c673cae FG |
118 | |
119 | - **2**: The default kernel has an old Ceph client that we do not recommend | |
120 | for kernel client (kernel RBD or the Ceph file system). Upgrade to a | |
121 | recommended kernel. | |
122 | ||
f67539c2 TL |
123 | - **3**: The default kernel regularly fails in QA when the ``Btrfs`` |
124 | file system is used. We recommend using ``BlueStore`` starting from | |
125 | Luminous, and ``XFS`` for previous releases with ``Filestore``. | |
126 | ||
127 | - **4**: ``btrfs`` is no longer tested on this release. We recommend | |
128 | using ``bluestore``. | |
129 | ||
130 | - **5**: Some additional features related to dashboard are not available. | |
224ce89b | 131 | |
f67539c2 | 132 | - **6**: Packages are built regularly, but not distributed by upstream Ceph. |
7c673cae FG |
133 | |
134 | Testing | |
135 | ------- | |
136 | ||
137 | - **B**: We build release packages for this platform. For some of these | |
f67539c2 | 138 | platforms, we may also continuously build all Ceph branches and perform |
7c673cae FG |
139 | basic unit tests. |
140 | ||
141 | - **I**: We do basic installation and functionality tests of releases on this | |
142 | platform. | |
143 | ||
144 | - **C**: We run a comprehensive functional, regression, and stress test suite | |
145 | on this platform on a continuous basis. This includes development branches, | |
146 | pre-release, and released code. | |
147 | ||
148 | .. _CRUSH Tunables: ../../rados/operations/crush-map#tunables | |
149 | ||
f67539c2 | 150 | .. _Mounting CephFS using Kernel Driver: ../../cephfs/mount-using-kernel-driver#which-kernel-version |