report: edits in aws methodology section
[csit.git] / docs / report / introduction / methodology_aws / aws_instances.rst
1 AWS Performance Testbeds
2 ------------------------
3
4 CSIT implements two virtual machine topology types running in AWS EC2:
5
6 - **2-Node Topology**: Consists of one EC2 instance as a System Under
7   Test (SUT) and one EC2 instance acting as a Traffic Generator
8   (TG), with both instances connected into a ring topology. Used for
9   executing tests that require frame encapsulations supported by TG.
10
11 - **3-Node Topology**: Consists of two EC2 instances acting as a Systems
12   Under Test (SUTs) and one EC2 instance acting as a Traffic Generator
13   (TG), with all instances connected into a ring topology. Used for
14   executing tests that require frame encapsulations not supported by TG
15   e.g. certain overlay tunnel encapsulations and IPsec.
16
17 AWS EC2 Instances
18 -----------------
19
20 CSIT is using AWS EC2 C5n instances as System Under Test and TG virtual
21 machines. C5n instances got selected to take advantage of high network
22 throughput and packet rate performance. C5n instances offer up to 100
23 Gbps network bandwidth and increased memory over comparable C5
24 instances. For more information, see
25 `Instance types <https://aws.amazon.com/ec2/instance-types/>`_.
26
27 C5n features:
28
29 - 3.0 GHz Intel Xeon Platinum (Skylake) processors with Intel AVX-512
30   instructions.
31 - Sustained all core Turbo frequency of up to 3.4GHz, and single core
32   turbo frequency of up to 3.5 GHz.
33 - Requires HVM AMIs (Amazon Machine Images) that include drivers for ENA
34   and NVMe. See :ref:`csit_ami` for more information.
35 - Network bandwidth to up to 100 Gbps.
36 - Powered by the AWS Nitro System, a combination of dedicated hardware
37   and lightweight hypervisor.
38
39 +-------------+------+--------------+------------------------+-----------------------------+----------------------+
40 | Model       | vCPU | Memory (GiB) | Instance Storage (GiB) | Network Bandwidth (Gbps)*** | EBS Bandwidth (Mbps) |
41 +=============+======+==============+========================+=============================+======================+
42 |c5n.large    |    2 |         5.25 |        EBS-Only        |                    Up to 25 |          Up to 4,750 |
43 +-------------+------+--------------+------------------------+-----------------------------+----------------------+
44 |c5n.xlarge   |    4 |        10.5  |        EBS-Only        |                    Up to 25 |          Up to 4,750 |
45 +-------------+------+--------------+------------------------+-----------------------------+----------------------+
46 |c5n.2xlarge  |    8 |        21    |        EBS-Only        |                    Up to 25 |          Up to 4,750 |
47 +-------------+------+--------------+------------------------+-----------------------------+----------------------+
48 |c5n.4xlarge  |   16 |        42    |        EBS-Only        |                    Up to 25 |                4,750 |
49 +-------------+------+--------------+------------------------+-----------------------------+----------------------+
50 |c5n.9xlarge  |   36 |        96    |        EBS-Only        |                          50 |                9,500 |
51 +-------------+------+--------------+------------------------+-----------------------------+----------------------+
52 |c5n.18xlarge |   72 |       192    |        EBS-Only        |                         100 |               19,000 |
53 +-------------+------+--------------+------------------------+-----------------------------+----------------------+
54 |c5n.metal    |   72 |       192    |        EBS-Only        |                         100 |               19,000 |
55 +-------------+------+--------------+------------------------+-----------------------------+----------------------+
56
57 CSIT is configured by default to use `c5n.4xlarge` in `eu-central-1` AWS
58 region due to allocation stability issues with `c5n.9xlarge` in
59 `eu-central-1` region.
60
61
62 AWS EC2 Networking
63 ------------------
64
65 CSIT EC2 instances are equipped with AWS Elastic Network Adapter
66 (ENA) supporting AWS enhanced networking. Enhanced networking uses
67 single root I/O virtualization (SR-IOV) to provide high-performance
68 networking capabilities. For more information, see
69 `Elastic Network Adapter <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/enhanced-networking-ena.html>`_.
70
71 For more information about the current advertised AWS ENA performance
72 limits, see
73 `Computed optimized instances <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/compute-optimized-instances.html>`_.
74
75 CSIT DUTs make use of AWS ENA DPDK driver supplied by AWS and specified
76 in
77 `amzn drivers dpdk <https://github.com/amzn/amzn-drivers/tree/master/userspace/dpdk>`_.