]>
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 | |
22 | 4.x-based "longterm maintenance" kernel series: | |
23 | ||
9f95a23c | 24 | - 4.19.z |
11fdf7f2 | 25 | - 4.14.z |
7c673cae | 26 | |
7c673cae FG |
27 | For CephFS, see `CephFS best practices`_ for kernel version guidance. |
28 | ||
224ce89b WB |
29 | Older kernel client versions may not support your `CRUSH tunables`_ profile |
30 | or other newer features of the Ceph cluster, requiring the storage cluster | |
31 | to be configured with those features disabled. | |
7c673cae | 32 | |
7c673cae FG |
33 | |
34 | Platforms | |
35 | ========= | |
36 | ||
37 | The charts below show how Ceph's requirements map onto various Linux | |
38 | platforms. Generally speaking, there is very little dependence on | |
39 | specific distributions aside from the kernel and system initialization | |
40 | package (i.e., sysvinit, upstart, systemd). | |
41 | ||
9f95a23c | 42 | Nautilus (14.2.z) |
224ce89b WB |
43 | ----------------- |
44 | ||
45 | +----------+----------+--------------------+--------------+---------+------------+ | |
46 | | Distro | Release | Code Name | Kernel | Notes | Testing | | |
47 | +==========+==========+====================+==============+=========+============+ | |
48 | | CentOS | 7 | N/A | linux-3.10.0 | 3 | B, I, C | | |
49 | +----------+----------+--------------------+--------------+---------+------------+ | |
50 | | Debian | 8.0 | Jessie | linux-3.16.0 | 1, 2 | B, I | | |
51 | +----------+----------+--------------------+--------------+---------+------------+ | |
52 | | Debian | 9.0 | Stretch | linux-4.9 | 1, 2 | B, I | | |
53 | +----------+----------+--------------------+--------------+---------+------------+ | |
224ce89b WB |
54 | | RHEL | 7 | Maipo | linux-3.10.0 | | B, I | |
55 | +----------+----------+--------------------+--------------+---------+------------+ | |
56 | | Ubuntu | 14.04 | Trusty Tahr | linux-3.13.0 | | B, I, C | | |
57 | +----------+----------+--------------------+--------------+---------+------------+ | |
58 | | Ubuntu | 16.04 | Xenial Xerus | linux-4.4.0 | 3 | B, I, C | | |
59 | +----------+----------+--------------------+--------------+---------+------------+ | |
9f95a23c TL |
60 | | Ubuntu | 18.04 | Bionic Beaver | linux-4.15 | 3 | B, I, C | |
61 | +----------+----------+--------------------+--------------+---------+------------+ | |
62 | | openSUSE | 15.1 | Leap | linux-4.12 | | | | |
63 | +----------+----------+--------------------+--------------+---------+------------+ | |
64 | | openSUSE | | Tumbleweed | linux-5.1.7 | | | | |
65 | +----------+----------+--------------------+--------------+---------+------------+ | |
224ce89b | 66 | |
9f95a23c TL |
67 | Luminous (12.2.z) |
68 | ----------------- | |
7c673cae FG |
69 | |
70 | +----------+----------+--------------------+--------------+---------+------------+ | |
9f95a23c | 71 | | Distro | Release | Code Name | Kernel | Notes | Testing | |
7c673cae | 72 | +==========+==========+====================+==============+=========+============+ |
224ce89b | 73 | | CentOS | 7 | N/A | linux-3.10.0 | 3 | B, I, C | |
7c673cae FG |
74 | +----------+----------+--------------------+--------------+---------+------------+ |
75 | | Debian | 8.0 | Jessie | linux-3.16.0 | 1, 2 | B, I | | |
76 | +----------+----------+--------------------+--------------+---------+------------+ | |
9f95a23c TL |
77 | | Debian | 9.0 | Stretch | linux-4.9 | 1, 2 | B, I | |
78 | +----------+----------+--------------------+--------------+---------+------------+ | |
7c673cae FG |
79 | | Fedora | 22 | N/A | linux-3.14.0 | | B, I | |
80 | +----------+----------+--------------------+--------------+---------+------------+ | |
81 | | RHEL | 7 | Maipo | linux-3.10.0 | | B, I | | |
82 | +----------+----------+--------------------+--------------+---------+------------+ | |
83 | | Ubuntu | 14.04 | Trusty Tahr | linux-3.13.0 | | B, I, C | | |
84 | +----------+----------+--------------------+--------------+---------+------------+ | |
9f95a23c | 85 | | Ubuntu | 16.04 | Xenial Xerus | linux-4.4.0 | 3 | B, I, C | |
7c673cae FG |
86 | +----------+----------+--------------------+--------------+---------+------------+ |
87 | ||
88 | Notes | |
89 | ----- | |
90 | ||
91 | - **1**: The default kernel has an older version of ``btrfs`` that we do not | |
224ce89b | 92 | recommend for ``ceph-osd`` storage nodes. We recommend using ``XFS``. |
7c673cae FG |
93 | |
94 | - **2**: The default kernel has an old Ceph client that we do not recommend | |
95 | for kernel client (kernel RBD or the Ceph file system). Upgrade to a | |
96 | recommended kernel. | |
97 | ||
224ce89b WB |
98 | - **3**: The default kernel regularly fails in QA when the ``btrfs`` |
99 | file system is used. We do not recommend using ``btrfs`` for | |
100 | backing Ceph OSDs. | |
101 | ||
7c673cae FG |
102 | |
103 | Testing | |
104 | ------- | |
105 | ||
106 | - **B**: We build release packages for this platform. For some of these | |
107 | platforms, we may also continuously build all ceph branches and exercise | |
108 | basic unit tests. | |
109 | ||
110 | - **I**: We do basic installation and functionality tests of releases on this | |
111 | platform. | |
112 | ||
113 | - **C**: We run a comprehensive functional, regression, and stress test suite | |
114 | on this platform on a continuous basis. This includes development branches, | |
115 | pre-release, and released code. | |
116 | ||
117 | .. _CRUSH Tunables: ../../rados/operations/crush-map#tunables | |
118 | ||
119 | .. _CephFS best practices: ../../cephfs/best-practices |