Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 11 additions & 11 deletions content/install-guides/dcperf.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ additional_search_terms:
- Neoverse

test_images:
- ubuntu:22.04
- ubuntu:latest
test_maintenance: false

layout: installtoolsall
Expand All @@ -23,12 +23,12 @@ weight: 1

DCPerf is an open-source benchmarking and microbenchmarking suite originally developed by Meta. It faithfully replicates the characteristics of general-purpose data center workloads, with particular attention to microarchitectural fidelity. DCPerf stands out for accurate simulation of behaviors such as cache misses and branch mispredictions, which are details that many other benchmarking tools overlook.

You can use DCPerf to generate performance data to inform procurement decisions, and for regression testing to detect changes in the environment, such as kernel and compiler changes.
You can use DCPerf to generate performance data to inform procurement decisions, and for regression testing to detect changes in the environment, such as kernel and compiler changes.

DCPerf runs on Arm-based servers. The examples below have been tested on an AWS `c7g.metal` instance running Ubuntu 22.04 LTS.
DCPerf runs on Arm-based servers. The examples below have been tested on an AWS `c7g.metal` instance running Ubuntu 22.04 LTS.

{{% notice Note %}}
When running on a server provided by a cloud service, you have limited access to some parameters, such as UEFI settings, which can affect performance.
When running on a server provided by a cloud service, you have limited access to some parameters, such as UEFI settings, which can affect performance.
{{% /notice %}}

## Install prerequisites
Expand All @@ -40,15 +40,15 @@ sudo apt update
sudo apt install -y python-is-python3 python3-pip python3-venv git
```

It is recommended that you install Python packages in a Python virtual environment.
It is recommended that you install Python packages in a Python virtual environment.

Set up your virtual environment:

```bash
python3 -m venv venv
source venv/bin/activate
```
If requested, restart the recommended services.
If requested, restart the recommended services.

Install the required packages:

Expand All @@ -65,9 +65,9 @@ cd DCPerf

## Running the MediaWiki benchmark

DCPerf offers many benchmarks. See the official documentation for the benchmark of your choice.
DCPerf offers many benchmarks. See the official documentation for the benchmark of your choice.

One example is the MediaWiki benchmark, designed to faithfully reproduce the workload of the Facebook social networking site.
One example is the MediaWiki benchmark, designed to faithfully reproduce the workload of the Facebook social networking site.

Install HipHop Virtual Machine (HHVM), a virtual machine used to execute the web application code:

Expand Down Expand Up @@ -95,14 +95,14 @@ Compiler: 1704922878_080332982
Repo schema: 4239d11395efb06bee3ab2923797fedfee64738e
```

Confirm security-enhanced Linux (SELinux) is disabled with the following commands:
Confirm security-enhanced Linux (SELinux) is disabled with the following commands:

```bash
sudo apt install selinux-utils
getenforce
```

You should see the following response:
You should see the following response:

```output
Disabled
Expand Down Expand Up @@ -181,7 +181,7 @@ The metrics file contains several key performance indicators from the benchmark

These metrics help you evaluate the performance and reliability of the system under test. Higher values for successful requests and RPS, and lower response times, generally indicate better performance. The score provides a single value for easy comparison across runs or systems.

## Next steps
## Next steps

These are some activities you might like to try next:

Expand Down
3 changes: 1 addition & 2 deletions content/learning-paths/cross-platform/intrinsics/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,8 +23,7 @@ author: Jason Andrews
test_images:
- amd64/ubuntu:latest
- arm64v8/ubuntu:latest
test_link: https://github.com/armflorentlebeau/arm-learning-paths/actions/runs/4312122327
test_maintenance: true
test_maintenance: false

### Tags
skilllevels: Advanced
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,7 @@ author: Pareena Verma

test_images:
- armswdev/arm-tools:bare-metal-compilers
test_link: null
test_maintenance: true
test_maintenance: false

### Tags
skilllevels: Introductory
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ author: Pareena Verma
test_images:
- amd64/ubuntu:latest
test_link: null
test_maintenance: true
test_maintenance: false

### Tags
skilllevels: Introductory
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ To emulate the ML extensions for Vulkan:
```
![Add user-defined Vulkan layers path in Vulkan Configurator#center](./images/load_layers.png "Figure 1: Add Vulkan layer path.")

5. Ensure the Graph layer is listed *above* the Tensor layer, and that you've set up the configuration scope as shown in the image.
5. Switch back to the **Vulkan Loader Management** tab. Ensure the Graph layer is listed *above* the Tensor layer, and that you've set up the configuration scope as shown in the image.

![Layer configuration showing Graph above Tensor#center](./images/verify_layers.png "Figure 2: Verify layer ordering and scope.")

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ Next, enable the emulation layers using the Vulkan Configurator to simulate the

Under the **Vulkan Layers Location** tab, add the path to your `MLEmulationLayerForVulkan` folder.

In the **Apply a Vulkan Loader Configuration** list, right-click and choose **Create a new Configuration**. You can give the new configuration any name, for example `tensor_and_data_graph`.
Switch back to the **Vulkan Loader Management** tab. In the **Apply a Vulkan Loader Configuration** list, right-click and choose **Create a new Configuration**. You can give the new configuration any name, for example `tensor_and_data_graph`.

![Screenshot of the Vulkan Configurator showing the Vulkan Layers Location tab, where the emulation layer path (MLEmulationLayerForVulkan) is added to enable VK_ARM_data_graph and VK_ARM_tensors alt-text#center](./images/load_layers.png "Add emulation layers in Vulkan Configurator")

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
22 changes: 12 additions & 10 deletions tools/check_open_category.py
Original file line number Diff line number Diff line change
Expand Up @@ -329,17 +329,19 @@ def check_entries(lp_index_path: Path, model: str = "gpt-4o-2024-08-06") -> int:
# ----------------------------

def main():
if len(sys.argv) != 2:
print("Usage: python tools/check_tools_software_languages.py /path/to/content/<section>/<category>/<lp>/_index.md")
sys.exit(2)

lp_index_path = Path(sys.argv[1]).resolve()
if not lp_index_path.exists():
print(f"[ERROR] File not found: {lp_index_path}")
sys.exit(2)

# Single sequential flow so you can follow the variables:
problems = check_entries(lp_index_path, model="gpt-4o-2024-08-06")
files = sys.argv[1:]
problems = 0

for f in files:
if "content/" in f and f.endswith("_index.md"):
lp_index_path = Path(f).resolve()
if not lp_index_path.exists():
print(f"[ERROR] File not found: {lp_index_path}")
sys.exit(2)
print("Checking file:", f)
# Single sequential flow so you can follow the variables:
problems = problems + check_entries(lp_index_path, model="gpt-4o-2024-08-06")

# Exit codes: 0 ok, 1 issues found
sys.exit(1 if problems > 0 else 0)
Expand Down
1 change: 1 addition & 0 deletions tools/requirements.txt
Original file line number Diff line number Diff line change
Expand Up @@ -5,3 +5,4 @@ pyspellchecker
better-profanity
setuptools
alive-progress
openai
2 changes: 2 additions & 0 deletions tools/verify_index_fields.py
Original file line number Diff line number Diff line change
Expand Up @@ -117,5 +117,7 @@ def validate_file(path, allowlist):
if validate_file(f, allowlist):
any_errors = True



if any_errors:
sys.exit(1)