Skip to content

Commit fe45e49

Browse files
authored
Merge pull request #285017 from bryan-strassner/bstrassner/SIunits
Clarify references to GB to indicate GiB where applicable
2 parents 370fd3a + 723628c commit fe45e49

8 files changed

+14
-14
lines changed

articles/operator-nexus/concepts-compute.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -41,11 +41,11 @@ Azure Operator Nexus reserves a small set of CPUs for the host operating system
4141

4242
### Huge page support
4343

44-
Huge page usage in workloads refers to the utilization of large memory pages, typically 2 MB or 1 GB in size, instead of the standard 4-KB pages. This approach helps reduce memory overhead and improves the overall system performance. It reduces the translation look-aside buffer (TLB) miss rate and improves memory access efficiency.
44+
Huge page usage in workloads refers to the utilization of large memory pages, typically 2 MiB or 1 GiB in size, instead of the standard 4 KiB pages. This approach helps reduce memory overhead and improves the overall system performance. It reduces the translation look-aside buffer (TLB) miss rate and improves memory access efficiency.
4545

46-
Workloads that involve large data sets or intensive memory operations, such as network packet processing, can benefit from huge page usage because it enhances memory performance and reduces memory-related bottlenecks. As a result, users see improved throughput and reduced latency.
46+
Workloads that involve large data sets or intensive memory operations such as network packet processing, can benefit from huge page usage because it enhances memory performance and reduces memory-related bottlenecks. As a result, users see improved throughput and reduced latency.
4747

48-
All virtual machines created on Azure Operator Nexus can make use of either 2-MB or 1-GB huge pages, depending on the type of virtual machine.
48+
All virtual machines created on Azure Operator Nexus are backed by 1GiB(1G) hugepages for the requested memory. The kernel running inside the VM can manage these available memory anyway it likes, including the allocation of memory to support hugepages (2M or 1G).
4949

5050
### Dual-stack support
5151

articles/operator-nexus/howto-kubernetes-cluster-huge-pages.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ When configuring huge-pages for a Nexus Kubernetes cluster, you need to provide
3333
## Limitations
3434
Nexus Kubernetes cluster enforces the following constraints to ensure proper configuration:
3535
* The total size of huge-pages (HugepageSize multiplied by HugepageCount) must not exceed 80% of the VM's memory.
36-
* At least 2 GB of memory must be left for the host kernel after allocating huge-pages.
36+
* At least 2 GiB of memory must be left for the host kernel after allocating huge-pages.
3737
* If the huge-page size is ```2M```, the huge-page count must be a power of 2 (for example, 1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048, 4096, 8192, etc.).
3838
* Huge-page configurations must be done during agent pool creation, it can't be added or modified after.
3939

articles/operator-nexus/includes/virtual-machine/virtual-machine-arm-template.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@
6262
"type": "int",
6363
"defaultValue": 4,
6464
"metadata": {
65-
"description": "The memory size of the virtual machine in GB (max 224 GB)"
65+
"description": "The memory size of the virtual machine in GiB (max 224 GiB)"
6666
}
6767
},
6868
"networkAttachments": {

articles/operator-nexus/includes/virtual-machine/virtual-machine-bicep-template.bicep

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ param cloudServicesNetworkId string
2828
@description('Number of CPU cores for the virtual machine. Choose a value between 2 and 46.')
2929
param cpuCores int = 2
3030

31-
@description('The memory size of the virtual machine in GB (max 224 GB)')
31+
@description('The memory size of the virtual machine in GiB (max 224 GiB)')
3232
param memorySizeGB int = 4
3333

3434
@description('The list of network attachments to the virtual machine.')

articles/operator-nexus/quickstarts-virtual-machine-deployment-cli.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,8 +38,8 @@ Before you run the commands, you need to set several variables to define the con
3838
| ADMIN_USERNAME | The username for the virtual machine administrator. |
3939
| SSH_PUBLIC_KEY | The SSH public key that is used for secure communication with the virtual machine. |
4040
| CPU_CORES | The number of CPU cores for the virtual machine (even number, max 46 vCPUs) |
41-
| MEMORY_SIZE | The amount of memory (in GB, max 224 GB) for the virtual machine. |
42-
| VM_DISK_SIZE | The size (in GB) of the virtual machine disk. |
41+
| MEMORY_SIZE | The amount of memory (in GiB, max 224 GiB) for the virtual machine. |
42+
| VM_DISK_SIZE | The size (in GiB) of the virtual machine disk. |
4343
| VM_IMAGE | The URL of the virtual machine image. |
4444
| ACR_URL | The URL of the Azure Container Registry. |
4545
| ACR_USERNAME | The username for the Azure Container Registry. |

articles/operator-nexus/quickstarts-virtual-machine-deployment-ps.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,8 +38,8 @@ Before you run the commands, you need to set several variables to define the con
3838
| ADMIN_USERNAME | The username for the virtual machine administrator. |
3939
| SSH_PUBLIC_KEY | The SSH public key that is used for secure communication with the virtual machine. |
4040
| CPU_CORES | The number of CPU cores for the virtual machine (even number, max 46 vCPUs) |
41-
| MEMORY_SIZE | The amount of memory (in GB, max 224 GB) for the virtual machine. |
42-
| VM_DISK_SIZE | The size (in GB) of the virtual machine disk. |
41+
| MEMORY_SIZE | The amount of memory (in GiB, max 224 GiB) for the virtual machine. |
42+
| VM_DISK_SIZE | The size (in GiB) of the virtual machine disk. |
4343
| VM_IMAGE | The URL of the virtual machine image. |
4444
| ACR_URL | The URL of the Azure Container Registry. |
4545
| ACR_USERNAME | The username for the Azure Container Registry. |

articles/operator-nexus/reference-near-edge-compute.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -39,9 +39,9 @@ Azure Operator Nexus supports a range of geometries and configurations. This tab
3939
| Number of virtual CPUs (vCPUs) for tenant usage | 96 vCPUs, with hyperthreading enabled per compute server. |
4040
| Number of vCPUs available for workloads | 2 to 48 vCPUs, with an even number of vCPUs only. No cross-NUMA (nonuniform memory access) virtual machines (VMs). |
4141
| CPU pinning | Default. |
42-
| RAM for running tenant workloads | 448 GB (224 GB per NUMA). |
43-
| Huge pages for tenant workloads | All VMs are backed by 1-GB huge pages. |
44-
| Disk (ephemeral) per compute | Up to 3.5 TB per compute host. |
42+
| RAM for running tenant workloads | 448 GiB (224 GiB per NUMA). |
43+
| Huge pages for tenant workloads | All VMs are backed by 1GiB (1G) huge pages. |
44+
| Disk (ephemeral) per compute | Up to 3.5 TB (3.18 TiB) per compute host. |
4545
| Data plane traffic path for workloads | Single-root I/O virtualization (SR-IOV). |
4646
| Number of SR-IOV virtual functions (VFs) | Maximum of 32 virtual NICs (vNICs), with 30 VFs available for tenant workloads per NUMA. |
4747
| SR-IOV NIC support | Enabled on all 100G NIC ports on VMs, with VFs assigned out of Mellanox-supported VF link aggregation (VF LAG). The allocated VFs are from the same physical NIC and within the same NUMA boundary. NIC ports that provide VF LAG are connected to two different top-of-rack (ToR) switches for redundancy. <br><br>Support includes trunked VF receive-side scaling (RSS) with hardware queuing. Support also includes multiple queues on VMs. |

articles/operator-nexus/troubleshoot-hardware-validation-failure.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ Expanding `result_detail` for a given category shows detailed results.
4747

4848
### System info category
4949

50-
* Memory/RAM Related Failure (memory_capacity_GB)
50+
* Memory/RAM Related Failure (memory_capacity_GB) (measured in GiB)
5151
* Memory specs are defined in the SKU. Memory below threshold value indicates missing or failed Dual In-Line Memory Module (DIMM). A failed DIMM would also be reflected in the `health_info` category. The following example shows a failed memory check.
5252

5353
```json

0 commit comments

Comments
 (0)