Updates

Author: madeline-underwood

content/learning-paths/servers-and-cloud-computing/mongodb-on-azure/_index.md

@@ -3,12 +3,12 @@ title: Run MongoDB on Arm-based Microsoft Azure Cobalt 100 instances
 
 minutes_to_complete: 30   
 
-who_is_this_for: Software developers who want to migrate MongoDB workloads to Arm-based platforms, with a focus on Microsoft Azure Cobalt 100 Arm64 instances.
+who_is_this_for: This is an introductory topic for software developers who want to migrate MongoDB workloads to Arm-based platforms, with a focus on Microsoft Azure Cobalt 100 Arm64 instances.
 
 learning_objectives: 
-    - Provision an Arm64-based Cobalt 100 virtual machine in Azure using Ubuntu Pro 24.04 LTS.
-    - Deploy MongoDB on the Cobalt 100 instance.
-    - Run baseline tests and performance benchmarks on MongoDB in the Arm64 environment.
+    - Provision an Arm64-based Cobalt 100 virtual machine in Azure using Ubuntu Pro 24.04 LTS
+    - Deploy MongoDB on the Cobalt 100 instance
+    - Run baseline tests and performance benchmarks on MongoDB in the Arm64 environment
 
 prerequisites:
     - A [Microsoft Azure](https://azure.microsoft.com/) account with access to Cobalt 100 (Dpsv6) instances

content/learning-paths/servers-and-cloud-computing/mongodb-on-azure/background.md

@@ -10,8 +10,10 @@ layout: "learningpathall"
 
 Azure’s Cobalt 100 is Microsoft’s first-generation, in-house Arm-based processor. Built on the Arm Neoverse N2 architecture, this 64-bit CPU improves performance and energy efficiency for a wide range of cloud-native, scale-out Linux workloads. These include web and application servers, data analytics, open-source databases, caching systems, and more. Running at 3.4 GHz, the Cobalt 100 processor allocates a dedicated physical core for each vCPU to ensure consistent, predictable performance.
 
-To learn more, see the [Azure Cobalt 100 announcement blog](https://techcommunity.microsoft.com/blog/azurecompute/announcing-the-preview-of-new-azure-vms-based-on-the-azure-cobalt-100-processor/4146353).
+To find out more, see the [Azure Cobalt 100 announcement blog](https://techcommunity.microsoft.com/blog/azurecompute/announcing-the-preview-of-new-azure-vms-based-on-the-azure-cobalt-100-processor/4146353).
 
 ## MongoDB
 
-MongoDB is an open-source NoSQL database known for high performance, scalability, and flexibility. It stores data in JSON-like BSON documents, making it ideal for applications that need dynamic, schema-less data structures. Developers commonly use MongoDB for web, mobile, IoT, and real-time analytics workloads. Learn more on the [MongoDB website](https://www.mongodb.com/) and in the [official documentation](https://www.mongodb.com/docs/).
+MongoDB is an open-source NoSQL database known for high performance, scalability, and flexibility. It stores data in JSON-like BSON documents, making it ideal for applications that need dynamic, schema-less data structures. Developers commonly use MongoDB for web, mobile, IoT, and real-time analytics workloads. 
+
+To find out more, see the [MongoDB website](https://www.mongodb.com/) and the [official documentation](https://www.mongodb.com/docs/).

content/learning-paths/servers-and-cloud-computing/mongodb-on-azure/create-instance.md

@@ -1,5 +1,5 @@
 ---
-title: Create an Arm based cloud virtual machine using Microsoft Cobalt 100 CPU 
+title: Create an Arm-based cloud virtual machine using Microsoft Cobalt 100 CPU 
 weight: 3
 
 ### FIXED, DO NOT MODIFY
@@ -8,39 +8,43 @@ layout: learningpathall
 
 ## Introduction
 
-There are several ways to create an Arm-based Cobalt 100 virtual machine : the Microsoft Azure console, the Azure CLI tool, or using your choice of IaC (Infrastructure as Code). In this section, you will use the Azure console to create a virtual machine with Arm-based Azure Cobalt 100 Processor. 
+There are several ways to create an Arm-based Cobalt 100 virtual machine: the Microsoft Azure console, the Azure CLI, or your preferred infrastructure as code (IaC) tool. In this section, you will use the Azure console to create a virtual machine with the Arm-based Azure Cobalt 100 processor.
 
-This learning path focuses on the general-purpose virtual machine of the D series. Please read the guide on [Dpsv6 size series](https://learn.microsoft.com/en-us/azure/virtual-machines/sizes/general-purpose/dpsv6-series) offered by Microsoft Azure.  
+This Learning Path focuses on the general-purpose virtual machines in the **Dpsv6** series. For further information, see the [Microsoft Azure Dpsv6 sizes series guide](https://learn.microsoft.com/en-us/azure/virtual-machines/sizes/general-purpose/dpsv6-series).  
 
-While the steps to create this instance are included here for your convenience, you can also refer to the [Deploy a Cobalt 100 Virtual Machine on Azure Learning Path](/learning-paths/servers-and-cloud-computing/cobalt/)
+While the steps to create this instance are included here for convenience, you can also refer to the [Deploy a Cobalt 100 virtual machine on Azure Learning Path](/learning-paths/servers-and-cloud-computing/cobalt/).
 
-#### Create an Arm-based Azure Virtual Machine 
+## Create an Arm-based Azure virtual machine 
 
-Creating a virtual machine based on Azure Cobalt 100 is no different from creating any other virtual machine in Azure. To create an Azure virtual machine, launch the Azure portal and navigate to "Virtual Machines".
-1. Select "Create", and click on "Virtual Machine" from the drop-down list.
-2. Inside the "Basic" tab, fill in the Instance details such as "Virtual machine name" and "Region".
-3. Choose the image for your virtual machine (for example, Ubuntu Pro 24.04 LTS) and select “Arm64” as the VM architecture.
-4. In the “Size” field, click on “See all sizes” and select the D-Series v6 family of virtual machines. Select “D4ps_v6” from the list.
+Creating a virtual machine on Azure Cobalt 100 is similar to creating any other virtual machine in Azure. To create an Azure virtual machine, open the Azure portal and navigate to **Virtual machines**.
 
-![Azure portal VM creation — Azure Cobalt 100 Arm64 virtual machine (D4ps_v6) alt-text#center](images/instance.png "Figure 1: Select the D-Series v6 family of virtual machines")
+Then follow these steps:
 
-5. Select "SSH public key" as an Authentication type. Azure will automatically generate an SSH key pair for you and allow you to store it for future use. It is a fast, simple, and secure way to connect to your virtual machine.
-6. Fill in the Administrator username for your VM.
-7. Select "Generate new key pair", and select "RSA SSH Format" as the SSH Key Type. RSA could offer better security with keys longer than 3072 bits. Give a Key pair name to your SSH key.
-8. In the "Inbound port rules", select HTTP (80) and SSH (22) as the inbound ports.
+- Select **Create**, then select **Virtual machine** from the drop-down list.
+- In the **Basics** tab, enter the instance details such as **Virtual machine name** and **Region**.
+- Choose the image for your virtual machine (for example, **Ubuntu Pro 24.04 LTS**) and select **Arm64** as the **VM architecture**.
+- In the **Size** field, select **See all sizes** and choose the **D-series v6** family of virtual machines. Select **D4ps_v6** from the list.
 
-![Azure portal VM creation — Azure Cobalt 100 Arm64 virtual machine (D4ps_v6) alt-text#center](images/instance1.png "Figure 2: Allow inbound port rules")
+![Azure portal VM creation: Azure Cobalt 100 Arm64 virtual machine (D4ps_v6) alt-text#center](images/instance.png "Select the D-series v6 family of virtual machines")
 
-9. Click on the "Review + Create" tab and review the configuration for your virtual machine. It should look like the following:
+Now select **SSH public key** as the **Authentication type**. Azure can generate an **SSH key pair** for you and store it for future use. This is a fast, simple, and secure way to connect to your virtual machine.
+Enter the **Administrator username** for your VM
+Select **Generate new key pair**, and select **RSA SSH format** as the **SSH key type**. RSA could offer better security with keys longer than 3072 bits. Give a Key pair name to your SSH key.
 
-![Azure portal VM creation — Azure Cobalt 100 Arm64 virtual machine (D4ps_v6) alt-text#center](images/ubuntu-pro.png "Figure 3: Review and Create an Azure Cobalt 100 Arm64 VM")
+In **Inbound port rules**, select **HTTP (80)** and **SSH (22)** as the inbound ports.
 
-10. Finally, when you are confident about your selection, click on the "Create" button, and click on the "Download Private key and Create Resources" button.
+![Azure portal VM creation: allow inbound port rules alt-text#center](images/instance1.png "Allow inbound port rules")
 
-![Azure portal VM creation — Azure Cobalt 100 Arm64 virtual machine (D4ps_v6) alt-text#center](images/instance4.png "Figure 4: Download Private key and Create Resources")
+Select the **Review and create** tab and confirm your configuration. It should look similar to the following:
 
-11. Your virtual machine should be ready and running within no time. You can SSH into the virtual machine using the private key, along with the Public IP details.
+![Azure portal VM creation: review and create an Azure Cobalt 100 Arm64 VM alt-text#center](images/ubuntu-pro.png "Review and create an Azure Cobalt 100 Arm64 VM")
 
-![Azure portal VM creation — Azure Cobalt 100 Arm64 virtual machine (D4ps_v6) alt-text#center](images/final-vm.png "Figure 5: VM deployment confirmation in Azure portal")
+When you are satisfied with your selections, select **Create**, then select **Download private key and create resources**.
 
-While the virtual machine ready, proceed to the next section to deploy MongoDB on your running instance.
+![Azure portal VM creation: download private key and create resources alt-text#center](images/instance4.png "Download private key and create resources")
+
+After deployment, your virtual machine will be running. Use the private key and the **Public IP** to connect over **SSH**
+
+![Azure portal VM creation: VM deployment confirmation in Azure portal alt-text#center](images/final-vm.png "VM deployment confirmation in Azure portal")
+
+With the virtual machine ready, proceed to the next section to deploy MongoDB on your running instance.

content/learning-paths/servers-and-cloud-computing/mongodb-on-azure/deploy.md

@@ -6,20 +6,19 @@ weight: 4
 layout: learningpathall
 ---
 
+## Install MongoDB and mongosh on the Ubuntu Pro 24.04 LTS Arm instance
 
-## Install MongoDB and Mongosh on the Ubuntu Pro 24.04 LTS Arm instance
+Install MongoDB and `mongosh on Ubuntu Pro 24.04 LTS (Arm64) by downloading the binaries, setting up environment paths, configuring data and log directories, and starting the server for local access and verification.
 
-Install MongoDB and mongosh on Ubuntu Pro 24.04 LTS Arm64 by downloading the binaries, setting up environment paths, configuring data and log directories, and starting the server for local access and verification.
+## Install system dependencies
 
-1. Install System Dependencies
-
-Install required system packages to support MongoDB:
+Install the required system packages to support MongoDB:
 ```console
 sudo apt update
 sudo apt install -y curl wget tar fio openssl libcurl4 net-tools
 ```
 
-2. Download and Extract MongoDB
+## Download and extract MongoDB
 
 Fetch and unpack the MongoDB binaries for Arm64:
 ```console
@@ -28,61 +27,62 @@ tar -xvzf mongodb-linux-aarch64-ubuntu2404-8.0.12.tgz
 sudo mv mongodb-linux-aarch64-ubuntu2404-8.0.12 /usr/local/mongodb
 ```
 
-3. Add MongoDB to System PATH
+## Add MongoDB to the system PATH
 
 Enable running MongoDB from any terminal session:
 ```console
 echo 'export PATH=/usr/local/mongodb/bin:$PATH' | sudo tee /etc/profile.d/mongodb.sh
 source /etc/profile.d/mongodb.sh
 ```
 
-4. Create data and log directories to use with MongoDB:
+## Create data and log directories
 
-Set up the database data directory:
+Set up the database data and log directories:
 ```console
 sudo mkdir -p /var/lib/mongo
 sudo mkdir -p /var/log/mongodb
 sudo chown -R $USER:$USER /var/lib/mongo /var/log/mongodb
 ```
 
-5. Start MongoDB Server 
+## Start the MongoDB server
 
-You can start MongoDB manually as shown:
+Start `mongod` manually for local testing:
 ```console
 mongod --dbpath /var/lib/mongo --logpath /var/log/mongodb/mongod.log --fork
 ```
 
-The output from this command should look like:
+Expected output:
 ```output
 about to fork child process, waiting until server is ready for connections.
 forked process: 3356
 child process started successfully, parent exiting
 ```
 
-6. Install mongosh
+6. **Install mongosh**
 
-**mongosh** is the MongoDB Shell used to interact with your MongoDB server. It provides a modern, user-friendly CLI for running queries and database operations.
+**mongosh** is the MongoDB shell used to interact with your MongoDB server. It provides a modern, user-friendly CLI for running queries and database operations.
 
-Download and install MongoDB’s command-line shell for Arm:
+Download and install the MongoDB shell for Arm:
 ```console
 wget https://downloads.mongodb.com/compass/mongosh-2.3.8-linux-arm64.tgz
 tar -xvzf mongosh-2.3.8-linux-arm64.tgz
 sudo mv mongosh-2.3.8-linux-arm64 /usr/local/mongosh
 ```
-Add mongosh to  System `PATH`
+
+Add `mongosh` to the system PATH:
 ```console
 echo 'export PATH=/usr/local/mongosh/bin:$PATH' | sudo tee /etc/profile.d/mongosh.sh
 source /etc/profile.d/mongosh.sh
 ```
 
-### Verify MongoDB and mongosh Installation
+### Verify MongoDB and mongosh installation
 
-Check if MongoDB and mongosh are properly installed on your machine:
+Check if MongoDB and `mongosh` are properly installed on your machine:
 ```console
 mongod --version
 mongosh --version
 ```
-You should see output similar to: 
+You should see output similar to:
 ```output
 db version v8.0.12
 Build Info: {
@@ -102,11 +102,11 @@ Build Info: {
 
 ### Connect to MongoDB via mongosh
 
-You can now start interacting with MongoDB through its shell interface:
+Start interacting with MongoDB through the shell:
 ```console
 mongosh mongodb://127.0.0.1:27017
 ```
-You should see output on your terminal similar to: 
+You should see output similar to:
 ```output
 Current Mongosh Log ID: 68b573411523231d81a00aa0
 Connecting to:          mongodb://127.0.0.1:27017/?directConnection=true&serverSelectionTimeoutMS=2000&appName=mongosh+2.3.8
@@ -130,4 +130,4 @@ For mongosh info see: https://www.mongodb.com/docs/mongodb-shell/
 test>
 ```
 
-With this you have verified that the MongoDB installation is complete. You can now proceed with the baseline testing of MongoDB on your Azure Cobalt 100 based VM.
+With this, you have verified that the MongoDB installation is complete. You can now proceed with baseline testing of MongoDB on your Azure Cobalt 100 VM.