Merge pull request #2832 from geremyCohen/main

changed instance types to m6g from c8g, added uname steps, minor doc tweaks

Author: jasonrandrews

content/learning-paths/servers-and-cloud-computing/fastpath/_index.md

@@ -41,7 +41,7 @@ further_reading:
         type: documentation
     - resource:
         title: Kernel install guide
-        link: /install-guides/kernel-build/
+        link: /learning-paths/servers-and-cloud-computing/kernel-build/
         type: guide
     - resource:
         title: AWS Compute Service Provider learning path

content/learning-paths/servers-and-cloud-computing/fastpath/analyze_benchmark_results.md

@@ -17,7 +17,7 @@ To see the swprofiles (kernels) tested and stored in the results directory, run:
 
 ```commandline
 source ~/venv/bin/activate
-fastpath result list results-fastpath_test_010826-1837 --object swprofile
+~/fastpath/fastpath/fastpath result list results-fastpath_test_010826-1837 --object swprofile
 ```
 
 If you followed the tutorial exactly, you should see output similar to:
@@ -61,7 +61,7 @@ If you followed the tutorial exactly, you should see output similar to:
 To see the relative results for each kernel, run the following commands:
 
 ```commandline
-  fastpath result show results-fastpath_test_010826-1837 --swprofile fp_6.19.0-rc1-ubuntu --relative
+  ~/fastpath/fastpath/fastpath result show results-fastpath_test_010826-1837 --swprofile fp_6.19.0-rc1-ubuntu --relative
 ```
 Relative in this case means that the statistics displayed are relative to the mean. In addition to the min/mean/max, you are also given the confidence interval bounds, the coefficient of variation and the number of samples, similar to:
 
@@ -76,7 +76,7 @@ Relative in this case means that the statistics displayed are relative to the me
 You can run it again for the other kernel:
 
 ```commandline
-fastpath result show results-fastpath_test_010826-1837 --swprofile fp_6.18.1-ubuntu --relative
+~/fastpath/fastpath/fastpath result show results-fastpath_test_010826-1837 --swprofile fp_6.18.1-ubuntu --relative
 ```
 with output similar to:
 
@@ -95,7 +95,7 @@ To compare the relative results between both kernels, run:
 
 
 ```commandline
-fastpath result show results-fastpath_test_010826-1837 --swprofile fp_6.19.0-rc1-ubuntu --swprofile fp_6.18.1-ubuntu --relative
+~/fastpath/fastpath/fastpath result show results-fastpath_test_010826-1837 --swprofile fp_6.19.0-rc1-ubuntu --swprofile fp_6.18.1-ubuntu --relative
 ```
 with output similar to:
 

content/learning-paths/servers-and-cloud-computing/fastpath/build_setup.md

@@ -8,7 +8,7 @@ layout: "learningpathall"
 
 ## Provision the build host
 
-CPU-optimized instances compile kernels quickly, so in our example, an AWS Graviton4 `c8g.24xlarge` instance is used. It will be referred to as the *build* machine throughout the rest of the guide.
+CPU-optimized instances compile kernels quickly, so in our example, an AWS Graviton `m6g.12xlarge` instance is used. It will be referred to as the *build* machine throughout the rest of the guide.
 
 {{% notice Note %}}
 The following steps involve launching an EC2 instance.  You can perform all EC2 instance creation steps via the AWS Management Console instead or AWS CLI.  For step-by-step instructions to bring up an EC2 instance via the console, consult the [Compute Service Provider learning path](/learning-paths/servers-and-cloud-computing/csp/) for detailed instructions.  A tutorial from AWS is also available via [Get started with Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html).
@@ -20,7 +20,7 @@ Create build host with the following specifications:
 2. **Operating system** — *Ubuntu*
 3. **AMI** — *Ubuntu 24.04 LTS (Arm)*
 4. **Architecture** — *64-bit Arm*
-5. **Instance type** — `c8g.24xlarge`
+5. **Instance type** — `m6g.12xlarge`
 6. **Key pair** — *Select or create a key for SSH*
 7. **Security group** — *allow SSH inbound from your IP and cluster peers*
 8. **Storage** — *200 GB gp3*
@@ -35,7 +35,7 @@ There are many different ways to create this instance, and a few different metho
 # Replace the placeholders with values from your account/environment
 aws ec2 run-instances \
   --image-id resolve:ssm:/aws/service/canonical/ubuntu/server/24.04/stable/current/arm64/hvm/ebs-gp3/ami-id \
-  --instance-type c8g.24xlarge \
+  --instance-type m6g.12xlarge \
   --key-name <KEY_PAIR_NAME> \
   --subnet-id <SUBNET_ID> \
   --security-group-ids <SECURITY_GROUP_ID> \
@@ -60,7 +60,7 @@ cat <<'EOF' > build-host.yaml
 
 AWSTemplateFormatVersion: '2010-09-09'
 Description: >-
-  Fastpath Learning Path - Build host for kernel compilation (Ubuntu 24.04 LTS on Graviton4 c8g.24xlarge).
+  Fastpath Learning Path - Build host for kernel compilation (Ubuntu 24.04 LTS on Graviton m6g.12xlarge).
 
 Parameters:
   LatestUbuntuAmiId:
@@ -69,13 +69,11 @@ Parameters:
     Description: SSM parameter for the latest Ubuntu 24.04 LTS (Arm) AMI.
   InstanceType:
     Type: String
-    Default: c8g.24xlarge
+    Default: m6g.12xlarge
     AllowedValues:
-      - c8g.24xlarge
-      - c8g.16xlarge
-      - c8g.12xlarge
-      - c8g.8xlarge
-      - c8g.4xlarge
+      - m6g.12xlarge
+      - m6g.8xlarge
+      - m6g.4xlarge
     Description: Instance size for the build host.
   KeyPairName:
     Type: AWS::EC2::KeyPair::KeyName
@@ -168,7 +166,7 @@ When the instance reports a `running` state, note the public and private IP addr
 
 The Kernel Build repository contains build scripts and configuration files needed to easily compile kernels. To clone the repository:
 
-1. SSH into the `c8g.24xlarge` host using the configured key pair.
+1. SSH into the `m6g.12xlarge` host using the configured key pair.
 
     ```output
     ssh -i ~/.ssh/gcohen1.pem ubuntu@34.216.87.65
@@ -187,7 +185,7 @@ The Kernel Build repository contains build scripts and configuration files neede
     ubuntu@ip-172-31-110-110:~$
     ```
 
-2. Open the [Install and Clone section](https://localhost:1313/install-guides/kernel-build/#install-and-clone) of the install guide from your workstation.
+2. Open the [Install and Clone section](/learning-paths/servers-and-cloud-computing/kernel-build/how-to-1/#install-required-dependencies) of the install guide from your workstation.
 
 3. Run each command from that section on the build machine.  It should be similar to the following (always refer to the above link for the latest command line):
 
@@ -238,7 +236,11 @@ Once you are familiar with the process and you wish to explore and test further,
 
 ## Compile and build Fastpath-enabled kernels 6.18.1 and 6.19-rc1
 
-To run the script with *fastpath* options:
+{{% notice Note %}}
+Warning messages are expected at compile-time.  Warnings can be safely ignored, however fatal errors should be investigated.
+{{% /notice %}}
+
+To compile kernels with *fastpath* options:
 
 1. On the build machine, ```cd``` into the `arm_kernel_install_guide` folder you just cloned. 
 
@@ -250,7 +252,7 @@ cd ~/arm_kernel_install_guide
 ubuntu@ip-172-31-110-110:~/arm_kernel_install_guide$
 ```
 
-2. Open the [Custom tags with *fastpath* enabled](http://localhost:1313/install-guides/kernel-build/#2-custom-tags-with-fastpath-enabled) section from the install guide, and follow the instructions to run the build script. It should be similar to the following (always refer to the above link for the latest command line):
+2. Open the [Custom tags with *fastpath* enabled](/learning-paths/servers-and-cloud-computing/kernel-build/how-to-3/#build-custom-tags-with-fastpath-enabled) section from the install guide, and follow the instructions to run the build script. It should be similar to the following (always refer to the above link for the latest command line):
 
 ```output
 $ ./scripts/kernel_build_and_install.sh --tags v6.18.1,v6.19-rc1 --fastpath true
@@ -273,7 +275,7 @@ I: build output in /home/ubuntu/kernels/6.19.0-rc1-ubuntu
 [2026-01-08 18:32:06] [v6.19-rc1-2] Build artifacts are located in /home/ubuntu/kernels/6.19.0-rc1-ubuntu+
 ```
 
-The script will now build two kernel images.  This process may take some time -- on a `c8g.24xlarge` instance, expect approximately 30 minutes for both kernel builds to complete.
+The script will now build two kernel images.  This process may take some time -- on a `m6g.12xlarge` instance, expect approximately 30 minutes for both kernel builds to complete.
 
 4. Monitor the console output for the `BUILD COMPLETE` message. 
 

content/learning-paths/servers-and-cloud-computing/fastpath/fastpath_setup.md

@@ -15,13 +15,13 @@ The *fastpath* host will manage testing against the system under test (SUT) and
 The following steps involve launching an EC2 instance.  You can perform all EC2 instance creation steps via the AWS Management Console instead or AWS CLI.  For step-by-step instructions to bring up an EC2 instance via the console, consult the [Compute Service Provider learning path](/learning-paths/servers-and-cloud-computing/csp/) for detailed instructions.  A tutorial from AWS is also available via [Get started with Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html).
 {{% /notice %}}
 
-Create build host with the following specifications:
+Create Fastpath host with the following specifications:
 
 1. **Name** — *fastpath-host*
 2. **Operating system** — *Ubuntu*
 3. **AMI** — *Ubuntu 24.04 LTS (Arm)*
 4. **Architecture** — *64-bit Arm*
-5. **Instance type** — `c8g.24xlarge`
+5. **Instance type** — `m6g.4xlarge`
 6. **Key pair** — *Select or create a key for SSH*
 7. **Security group** — *allow SSH inbound from your IP and cluster peers*
 8. **Storage** — *200 GB gp3*
@@ -34,7 +34,7 @@ Create build host with the following specifications:
 # Replace the placeholders with values from your account/environment
 aws ec2 run-instances \
   --image-id resolve:ssm:/aws/service/canonical/ubuntu/server/24.04/stable/current/arm64/hvm/ebs-gp3/ami-id \
-  --instance-type c8g.4xlarge \
+  --instance-type m6g.4xlarge \
   --key-name <KEY_PAIR_NAME> \
   --subnet-id <SUBNET_ID> \
   --security-group-ids <SECURITY_GROUP_ID> \
@@ -67,11 +67,10 @@ Parameters:
     Description: SSM parameter for the latest Ubuntu 24.04 LTS (Arm) AMI.
   InstanceType:
     Type: String
-    Default: c8g.4xlarge
+    Default: m6g.4xlarge
     AllowedValues:
-      - c8g.4xlarge
-      - c8g.8xlarge
-      - c8g.12xlarge
+      - m6g.4xlarge
+      - m6g.8xlarge
     Description: Instance size for the Fastpath host.
   KeyPairName:
     Type: AWS::EC2::KeyPair::KeyName
@@ -165,9 +164,9 @@ When the instance reports a `running` state, note the public and private IP addr
 
 Repeat the dependency installation process so the *fastpath* host has the same toolchain and helper scripts as the build machine.
 
-1. SSH into the `c8g.4xlarge` *fastpath* host using the configured key pair.
+1. SSH into the `m6g.4xlarge` *fastpath* host using the configured key pair.
 
-2. Open the [Install and Clone section](https://localhost:1313/install-guides/kernel-build/#install-and-clone) of the install guide from your workstation.
+2. Open the [Install and Clone section](/learning-paths/servers-and-cloud-computing/kernel-build/how-to-1/#install-required-dependencies) of the install guide from your workstation.
 
 3. Run each command from that section on the *fastpath* machine.  It should be similar to the following (always refer to the above link for the latest command line):
 
@@ -230,7 +229,7 @@ After copying the artifacts from the build machine, stop (or terminate it) to av
 
 
 {{% notice Note %}}
-If you do decide to keep the machine around as a kernel copy host, you can modify it to a smaller instance type such as `c8g.4xlarge` to save on costs when its running.  The larger 24xlarge instance is only needed during kernel compilation.
+If you do decide to keep the machine around as a kernel copy host, you can modify it to a smaller instance type such as `m6g.4xlarge` to save on costs when its running.  The larger 12xlarge instance is only needed during kernel compilation.
 {{% /notice %}}
 
 ## Configure the Fastpath host

content/learning-paths/servers-and-cloud-computing/fastpath/generate_and_execute_plan.md

@@ -22,7 +22,7 @@ cd ~/arm_kernel_install_guide
 ./scripts/generate_plan.sh
 ```
 
-When complete, the script creates the plan, and provides a list of frequently performed tasks relative to the plan:
+When complete, the script creates the plan with an auto-generated name and provides a list of frequently performed tasks relative to the plan:
 
 ```output
 Enter SUT private IP: 172.31.100.19
@@ -33,17 +33,17 @@ Plan written to:
   /home/ubuntu/arm_kernel_install_guide/plans/fastpath_test_010826-1837.yaml
 
 Run Fastpath with:
-  fastpath plan exec --output results/ /home/ubuntu/arm_kernel_install_guide/plans/fastpath_test_010826-1837.yaml
+  ~/fastpath/fastpath/fastpath plan exec --output results/ /home/ubuntu/arm_kernel_install_guide/plans/fastpath_test_010826-1837.yaml
 
 After Fastpath run completes, gather results with:
-  fastpath result list results/ --object swprofile
+  ~/fastpath/fastpath/fastpath result list results/ --object swprofile
 
 Relative results per kernel:
-  fastpath result show results/ --swprofile fp_6.19.0-rc1-ubuntu --relative
-  fastpath result show results/ --swprofile fp_6.18.1-ubuntu --relative
+  ~/fastpath/fastpath/fastpath result show results/ --swprofile fp_6.19.0-rc1-ubuntu --relative
+  ~/fastpath/fastpath/fastpath result show results/ --swprofile fp_6.18.1-ubuntu --relative
 
 Comparison between kernels:
-  fastpath result show results/ --swprofile fp_6.19.0-rc1-ubuntu --swprofile fp_6.18.1-ubuntu --relative
+  ~/fastpath/fastpath/fastpath result show results/ --swprofile fp_6.19.0-rc1-ubuntu --swprofile fp_6.18.1-ubuntu --relative
 ```
 
 

content/learning-paths/servers-and-cloud-computing/fastpath/next-steps.md

@@ -16,7 +16,7 @@ You now have a working *fastpath* benchmarking environment consisting of:
 Continue exploring by revisiting the source documentation:
 
 - [*fastpath* documentation](https://fastpath.docs.arm.com/en/latest/index.html) for advanced deployment models, additional benchmarks, and troubleshooting tips.
-- [Kernel Install Guide](/install-guides/kernel-build/) for deeper dives into kernel customization, *fastpath* tagging, and artifact management.
+- [Kernel Install Guide](/learning-paths/servers-and-cloud-computing/kernel-build/) for deeper dives into kernel customization, *fastpath* tagging, and artifact management.
 - [Tuxmake documentation](https://docs.tuxmake.org/en/latest/) to learn how to tailor build matrices, cross-compilation targets, and caching strategies that complement the *fastpath* workflow.
 
 Extend this learning path by experimenting with new kernel patches, expanding the benchmark suite, or automating the instance lifecycle with Terraform.

content/learning-paths/servers-and-cloud-computing/fastpath/sut_setup.md

@@ -11,19 +11,19 @@ Now that kernels are built and the *fastpath* host is ready, it's time to set up
 
 The System Under Test (SUT) is the target machine where *fastpath* installs your kernels, runs benchmarks on each kernel (one at a time) and when complete, compares and displays the results via *fastpath*.
 
-Just like choosing the kernels to test, the instance type of the SUT depends on your use case. For this *fastpath* LP, we recommend a Graviton4 `c8g.12xlarge` instance with Ubuntu 24.04 LTS. This instance type provides a good balance of CPU and memory for a test benchmark.
+Just like choosing the kernels to test, the instance type of the SUT depends on your use case. For this *fastpath* LP, we recommend a Graviton `m6g.12xlarge` instance with Ubuntu 24.04 LTS. This instance type provides a good balance of CPU and memory for a test benchmark.
 
 {{% notice Note %}}
 The following steps involve launching an EC2 instance.  You can perform all EC2 instance creation steps via the AWS Management Console instead or AWS CLI.  For step-by-step instructions to bring up an EC2 instance via the console, consult the [Compute Service Provider learning path](/learning-paths/servers-and-cloud-computing/csp/) for detailed instructions.  A tutorial from AWS is also available via [Get started with Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html).
 {{% /notice %}}
 
-Create build host with the following specifications:
+Create the SUT host with the following specifications:
 
 1. **Name** — *fastpath-sut*
 2. **Operating system** — *Ubuntu*
 3. **AMI** — *Ubuntu 24.04 LTS (Arm)*
 4. **Architecture** — *64-bit Arm*
-5. **Instance type** — `c8g.12xlarge`
+5. **Instance type** — `m6g.12xlarge`
 6. **Key pair** — *Select or create a key for SSH*
 7. **Security group** — *allow SSH inbound from your IP and cluster peers*
 8. **Storage** — *200 GB gp3*
@@ -40,7 +40,7 @@ Choose whichever provisioning method is most convenient—the tabs below provide
 # Replace the placeholders with values from your account/environment
 aws ec2 run-instances \
   --image-id resolve:ssm:/aws/service/canonical/ubuntu/server/24.04/stable/current/arm64/hvm/ebs-gp3/ami-id \
-  --instance-type c8g.12xlarge \
+  --instance-type m6g.12xlarge \
   --key-name <KEY_PAIR_NAME> \
   --subnet-id <SUBNET_ID> \
   --security-group-ids <SECURITY_GROUP_ID> \
@@ -73,11 +73,11 @@ Parameters:
     Description: SSM parameter for the latest Ubuntu 24.04 LTS (Arm) AMI.
   InstanceType:
     Type: String
-    Default: c8g.12xlarge
+    Default: m6g.12xlarge
     AllowedValues:
-      - c8g.8xlarge
-      - c8g.12xlarge
-      - c8g.16xlarge
+      - m6g.8xlarge
+      - m6g.12xlarge
+      - m6g.16xlarge
     Description: Instance size for the SUT.
   KeyPairName:
     Type: AWS::EC2::KeyPair::KeyName
@@ -230,7 +230,7 @@ HW:
   architecture: aarch64
   cpu_count: 48
   ...
-  product_name: c8g.12xlarge
+  product_name: m6g.12xlarge
 SW:
   kernel_name: 6.14.0-1018-aws
   userspace_name: Ubuntu 24.04.3 LTS