Skip to content

Commit 9e49dd5

Browse files
ggray-cbRayOffiah
andcommitted
Avx2 deprecation pt2 (#3800)
* Initial draft of AVX2 deprecation notice. Also cleaned up the Clock Source section a bit. * Added example to show whether processor has avx2. * Minor tweaks * Typo fix spotted by Ray Co-authored-by: Ray Offiah <[email protected]> * Verb agreement fix from Ray Co-authored-by: Ray Offiah <[email protected]> --------- Co-authored-by: Ray Offiah <[email protected]>
1 parent 5f71cab commit 9e49dd5

File tree

1 file changed

+48
-15
lines changed

1 file changed

+48
-15
lines changed

modules/install/pages/pre-install.adoc

Lines changed: 48 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,49 @@
44
[abstract]
55
{description}
66

7-
[tabs]
7+
## CPU Requirements
8+
9+
Couchbase Server can run on x86 and ARM processors (including Apple Silicon processors).
10+
This section explains the minimum requirements for of these platforms.
11+
12+
### x86 Processors
13+
14+
15+
[#avx2-requirements]
16+
.deprecation notice
17+
[IMPORTANT]
18+
====
19+
The use of older x86 processors that do not implement the https://en.wikipedia.org/wiki/Advanced_Vector_Extensions#AVX2[Advanced Vector Extensions 2 (AVX2)] instruction set are deprecated in Couchbase Server 7.6.x.
20+
Future versions will require processors that have AVX2 support.
21+
This requirements is only for x86 processors--ARM processors have a separate set of vector instructions.
22+
23+
The earliest processors that support AVX2 instructions include:
24+
25+
* Intel 4th generation (Haswell) Core processors released in 2013.
26+
* Intel 11th generation (Tiger Lake) Celeron and Pentium processors released in 2020.
27+
* AMD Excavator processors released in 2015.
28+
29+
Processors from these or later generations will be required to run Couchbase Server in the future.
30+
31+
On Linux, you can tell if your processor has the AVX2 instructions by executing the following command:
32+
33+
[source,bash]
34+
----
35+
grep -q -i 'avx2' /proc/cpuinfo && \
36+
echo "Processor has AVX2" || echo "AVX2 not found"
37+
----
38+
39+
If the command returns the text `Processor has AVX2`, your processor is supported in future Couchbase Server releases.
40+
If the command returns `AVX2 not found`, your processor does not have AVX2 instructions and will not be supported in future Couchbase Server versions.
841
====
9-
x86 Processors::
10-
+
11-
--
42+
43+
44+
Couchbase Server has the following requirements when running on x86 processors.
45+
46+
1247
[cols="80,180,180"]
1348
|===
14-
| | Minimum Specifications* | Recommended Specifications**
49+
| | Minimum Specifications<<#note1,*>> | Recommended Specifications<<#note2,**>>
1550

1651
| *CPU*
1752
| 2 GHz dual core x86_64 CPU supporting SSE4.2
@@ -39,14 +74,15 @@ a|
3974

4075
Network file systems such as CIFS and NFS are not supported.
4176
|===
42-
--
4377

44-
ARM Processors::
45-
+
46-
--
78+
### ARM Processors
79+
80+
Couchbase Server has the following requirements when running on ARM-based platforms.
81+
82+
4783
[cols="80,180,180"]
4884
|===
49-
| | Minimum Specifications* | Recommended Specifications**
85+
| | Minimum Specifications<<#note1,*>> | Recommended Specifications<<#note2,**>>
5086

5187
| *CPU*
5288
| 2 Ghz dual core 64bit ARM v8 CPU
@@ -66,12 +102,9 @@ a|
66102

67103
Network file systems such as CIFS and NFS are not supported.
68104
|===
69-
--
70-
====
71-
72-
73105

74-
*_You can reduce the CPU and RAM resources below the Minimum Specifications for development and testing purposes.
106+
[#note1]
107+
^*^You can reduce the CPU and RAM resources below the Minimum Specifications for development and testing purposes.
75108
Resources can be as low as 1 GB of free RAM beyond operating system requirements, and a single CPU core.
76109
However, you must adhere to the Minimum Specifications for production._
77110

0 commit comments

Comments
 (0)