From 77114365771c83deeb0a578ade173f2cac6501f1 Mon Sep 17 00:00:00 2001 From: Anna Stuchlik Date: Fri, 5 Aug 2022 16:55:40 +0200 Subject: [PATCH 1/5] doc: extend the list of supported CPUs --- docs/getting-started/system-requirements.rst | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/docs/getting-started/system-requirements.rst b/docs/getting-started/system-requirements.rst index c59833fcd8..422c2b2c9f 100644 --- a/docs/getting-started/system-requirements.rst +++ b/docs/getting-started/system-requirements.rst @@ -28,14 +28,17 @@ Scylla tries to maximize the resource usage of all system components. The shard- CPU ^^^ -Scylla requires modern Intel CPUs that support the SSE4.2 instruction set and will not boot without it. +ScyllaDB requires modern Intel CPUs that support the SSE4.2 instruction set and will not boot without it. -The following CPUs are supported by Scylla: +ScyllaDB supports the following CPUs: -* Intel core: Westmere or later (2010) -* Intel atom: Goldmont or later (2016) -* AMD low power: Jaguar or later (2013) -* AMD standard: Bulldozer or later (2011) +* Intel core: Westmere and later (2010) +* Intel atom: Goldmont and later (2016) +* AMD low power: Jaguar and later (2013) +* AMD standard: Bulldozer and later (2011) +* Apple M1 and M2 +* Ampere Altra +* AWS Graviton, Graviton2, Graviton3 In terms of the number of cores, any number will work since Scylla scales up with the number of cores. From ceaf0c41bd0f125c7bd48598fbc3c6ab64ec3338 Mon Sep 17 00:00:00 2001 From: Anna Stuchlik Date: Fri, 5 Aug 2022 17:18:44 +0200 Subject: [PATCH 2/5] doc: add support for AWS i4g instances --- docs/getting-started/system-requirements.rst | 72 ++++++++++++++++++++ 1 file changed, 72 insertions(+) diff --git a/docs/getting-started/system-requirements.rst b/docs/getting-started/system-requirements.rst index 422c2b2c9f..14ce079a10 100644 --- a/docs/getting-started/system-requirements.rst +++ b/docs/getting-started/system-requirements.rst @@ -219,6 +219,78 @@ See `ScyllaDB on the New AWS EC2 I4i Instances: Twice the Throughput & Lower Lat learn more about using ScyllaDB with i4i instances. +i4g instances +^^^^^^^^^^^^^^ + +.. list-table:: Im4gn + :widths: 30 20 20 30 + :header-rows: 1 + + * - Model + - vCPU + - Mem (GB) + - Storage (NVMe SSD) + * - Im4gn.large + - 2 + - 8 + - 1 x 937 + * - Im4gn.xlarge + - 4 + - 16 + - 1 x 1875 + * - Im4gn.2xlarge + - 8 + - 32 + - 1 x 3750 + * - Im4gn.4xlarge + - 16 + - 64 + - 1 x 7500 + * - Im4gn.8xlarge + - 32 + - 128 + - 2 x 7500 + * - Im4gn.16xlarge + - 64 + - 256 + - 4 x 7500 + + +.. list-table:: Is4gn + :widths: 30 20 20 30 + :header-rows: 1 + + * - Model + - vCPU + - Mem (GB) + - Storage (NVMe SSD) + * - Is4gen.medium + - 1 + - 6 + - 1 x 937 + * - Is4gen.large + - 2 + - 12 + - 1 x 1875 + * - Is4gen.xlarge + - 4 + - 24 + - 1 x 3750 + * - Is4gen.2xlarge + - 8 + - 48 + - 1 x 7500 + * - Is4gen.4xlarge + - 16 + - 96 + - 2 x 7500 + * - Is4gen.8xlarge + - 32 + - 192 + - 4 x 7500 + +See `Amazon EC2 Im4gn and Is4gen instances `_ for specification details. + Google Compute Engine (GCE) ----------------------------------- From 2c69a8f458f9f5dd1770d8863ef2c73d618f16b6 Mon Sep 17 00:00:00 2001 From: Anna Stuchlik Date: Mon, 8 Aug 2022 14:17:59 +0200 Subject: [PATCH 3/5] doc: replace the tables with a generic description of support for Im4gn and Is4gen instances --- docs/getting-started/system-requirements.rst | 74 +------------------- 1 file changed, 3 insertions(+), 71 deletions(-) diff --git a/docs/getting-started/system-requirements.rst b/docs/getting-started/system-requirements.rst index 14ce079a10..6df4276082 100644 --- a/docs/getting-started/system-requirements.rst +++ b/docs/getting-started/system-requirements.rst @@ -219,77 +219,9 @@ See `ScyllaDB on the New AWS EC2 I4i Instances: Twice the Throughput & Lower Lat learn more about using ScyllaDB with i4i instances. -i4g instances -^^^^^^^^^^^^^^ - -.. list-table:: Im4gn - :widths: 30 20 20 30 - :header-rows: 1 - - * - Model - - vCPU - - Mem (GB) - - Storage (NVMe SSD) - * - Im4gn.large - - 2 - - 8 - - 1 x 937 - * - Im4gn.xlarge - - 4 - - 16 - - 1 x 1875 - * - Im4gn.2xlarge - - 8 - - 32 - - 1 x 3750 - * - Im4gn.4xlarge - - 16 - - 64 - - 1 x 7500 - * - Im4gn.8xlarge - - 32 - - 128 - - 2 x 7500 - * - Im4gn.16xlarge - - 64 - - 256 - - 4 x 7500 - - -.. list-table:: Is4gn - :widths: 30 20 20 30 - :header-rows: 1 - - * - Model - - vCPU - - Mem (GB) - - Storage (NVMe SSD) - * - Is4gen.medium - - 1 - - 6 - - 1 x 937 - * - Is4gen.large - - 2 - - 12 - - 1 x 1875 - * - Is4gen.xlarge - - 4 - - 24 - - 1 x 3750 - * - Is4gen.2xlarge - - 8 - - 48 - - 1 x 7500 - * - Is4gen.4xlarge - - 16 - - 96 - - 2 x 7500 - * - Is4gen.8xlarge - - 32 - - 192 - - 4 x 7500 - -See `Amazon EC2 Im4gn and Is4gen instances `_ for specification details. +Im4gn and Is4gen instances +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +ScyllaDB supports Arm-based Im4gn and Is4gen instances. See `Amazon EC2 Im4gn and Is4gen instances `_ for specification details. Google Compute Engine (GCE) ----------------------------------- From 260f85643df1032bff6c6759f9fdbaeb9e250ce5 Mon Sep 17 00:00:00 2001 From: Anna Stuchlik Date: Mon, 8 Aug 2022 14:35:54 +0200 Subject: [PATCH 4/5] doc: specify the recommended AWS instance types --- docs/getting-started/system-requirements.rst | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/docs/getting-started/system-requirements.rst b/docs/getting-started/system-requirements.rst index 6df4276082..00ea80d69a 100644 --- a/docs/getting-started/system-requirements.rst +++ b/docs/getting-started/system-requirements.rst @@ -109,20 +109,25 @@ Cloud Instance Recommendations Amazon Web Services (AWS) -------------------------------- +* The recommended instance types are :ref:`i3 `, :ref:`i3en `, and :ref:`i4i `. +* We recommend using enhanced networking that exposes the physical network cards to the VM. + .. note:: Some of the ScyllaDB configuration features rely on querying instance metadata. Disabling access to instance metadata will impact using Ec2 Snitches and tuning performance. See `AWS - Configure the instance metadata options `_ for more information. +.. _system-requirements-i3-instances: -We highly recommend EC2 **I3** instances—High I/O. This family includes the High Storage Instances that provide very fast SSD-backed instance storage optimized for very high random I/O performance and provide high IOPS at a low cost. We recommend using enhanced networking that exposes the physical network cards to the VM. +i3 instances +^^^^^^^^^^^^ +This family includes the High Storage Instances that provide very fast SSD-backed instance storage optimized for very high random I/O performance and provide high IOPS at a low cost. We recommend using enhanced networking that exposes the physical network cards to the VM. i3 instances are designed for I/O intensive workloads and equipped with super-efficient NVMe SSD storage. It can deliver up to 3.3 Million IOPS. An i3 instance is great for low latency and high throughput, compared to the i2 instances, the i3 instance provides storage that it's less expensive and denser along with the ability to deliver substantially more IOPS and more network bandwidth per CPU core. -i3 instances -^^^^^^^^^^^^ + =========================== =========== ============ ===================== Model vCPU Mem (GB) Storage (NVMe SSD) =========================== =========== ============ ===================== @@ -145,6 +150,8 @@ Source: `Amazon EC2 I3 Instances More on using Scylla with `i3.metal vs i3.16xlarge `_ +.. _system-requirements-i3en-instances: + i3en instances ^^^^^^^^^^^^^^ i3en instances have up to 4x the networking bandwidth of i3 instances, enabling up to 100 Gbps of sustained network bandwidth. @@ -180,12 +187,12 @@ All i3en instances have the following specs: See `Amazon EC2 I3en Instances `_ for details. +.. _system-requirements-i4i-instances: + i4i instances ^^^^^^^^^^^^^^ i4i support is available for ScyllaDB Open Source 5.0 and later and ScyllaDB Enterprise 2021.1.10 and later. - - =========================== =========== ============ ===================== Model vCPU Mem (GB) Storage (NVMe SSD) =========================== =========== ============ ===================== @@ -206,7 +213,7 @@ i4i.32xlarge 128 1,024 8 x 3,750 GB i4i.metal 128 1,024 8 x 3,750 GB =========================== =========== ============ ===================== -All i41 instances have the following specs: +All i4i instances have the following specs: * 3.5 GHz all-core turbo Intel® Xeon® Scalable (Ice Lake) processors * 40 Gbps bandwidth to EBS in the largest size and up to 10 Gbps in the four smallest sizes (twice that of i3 instances. Up to 75 Gbps networking bandwidth (three times more than I3 instances). From 8375304d9b4e8dd2d4ca784e111d469d6d478a9e Mon Sep 17 00:00:00 2001 From: Anna Stuchlik <37244380+annastuchlik@users.noreply.github.com> Date: Wed, 9 Nov 2022 14:37:34 +0100 Subject: [PATCH 5/5] Update docs/getting-started/system-requirements.rst Co-authored-by: Yaniv Kaul --- docs/getting-started/system-requirements.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/system-requirements.rst b/docs/getting-started/system-requirements.rst index 00ea80d69a..1c52988dff 100644 --- a/docs/getting-started/system-requirements.rst +++ b/docs/getting-started/system-requirements.rst @@ -28,7 +28,7 @@ Scylla tries to maximize the resource usage of all system components. The shard- CPU ^^^ -ScyllaDB requires modern Intel CPUs that support the SSE4.2 instruction set and will not boot without it. +ScyllaDB requires modern Intel/AMD CPUs that support the SSE4.2 instruction set and will not boot without it. ScyllaDB supports the following CPUs: