You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/install-guides/ams.md
+29-48Lines changed: 29 additions & 48 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,96 +37,77 @@ test_maintenance: true
37
37
test_images:
38
38
- ubuntu:latest
39
39
---
40
-
[Arm Performance Studio](https://developer.arm.com/Tools%20and%20Software/Arm%20Performance%20Studio) is a performance analysis tool suite for Android and Linux application developers.
40
+
[Arm Performance Studio](https://developer.arm.com/Tools%20and%20Software/Arm%20Performance%20Studio) is a performance analysis tool suite for Android and Linux application developers
41
41
42
-
It helps analyze how your game or app performs on production devices, so you can identify issues that affect performance, cause overheating, or drain battery life.
43
-
44
-
The following table lists the tools and describes their functions:
42
+
It comprises of a suite of easy-to-use tools that show you how well your game or app performs on production devices, so that you can identify problems that might cause slow performance, overheat the device, or drain the battery.
45
43
46
44
| Component | Functionality |
47
45
|----------|-------------|
48
-
|[Streamline](https://developer.arm.com/Tools%20and%20Software/Streamline%20Performance%20Analyzer)| Captures a performance profile with hardware counter activity from the device. |
49
-
|[Performance Advisor](https://developer.arm.com/Tools%20and%20Software/Performance%20Advisor)| Generates an easy-to-read performance summary from an annotated Streamline capture, and provides actionable optimization suggestions. |
50
-
|[Frame Advisor](https://developer.arm.com/Tools%20and%20Software/Frame%20Advisor)| Captures API calls and rendering details from a specific frame and provides detailed geometry metrics to help identify rendering bottlenecks. |
51
-
|[Mali Offline Compiler](https://developer.arm.com/Tools%20and%20Software/Mali%20Offline%20Compiler)| Analyzes how efficiently your shader programs perform on a range of Mali GPUs. |
52
-
|[RenderDoc for Arm GPUs](https://developer.arm.com/Tools%20and%20Software/RenderDoc%20for%20Arm%20GPUs)| Debugs Vulkan graphics applications with support for Arm GPU extensions and Android features. |
46
+
|[Streamline](https://developer.arm.com/Tools%20and%20Software/Streamline%20Performance%20Analyzer) with [Performance Advisor](https://developer.arm.com/Tools%20and%20Software/Performance%20Advisor)| Capture a performance profile that shows all the performance counter activity from the device. Generate an easy-to-read performance summary from an annotated Streamline capture, and get actionable advice about where you should optimize. |
47
+
|[Frame Advisor](https://developer.arm.com/Tools%20and%20Software/Frame%20Advisor)| Capture the API calls and rendering from a problem frame and get comprehensive geometry metrics to discover what might be slowing down your application. |
48
+
|[Mali Offline Compiler](https://developer.arm.com/Tools%20and%20Software/Mali%20Offline%20Compiler)| Analyze how efficiently your shader programs perform on a range of Mali GPUs. |
49
+
|[RenderDoc for Arm GPUs](https://developer.arm.com/Tools%20and%20Software/RenderDoc%20for%20Arm%20GPUs)| The industry-standard tool for debugging Vulkan graphics applications, including early support for Arm GPU extensions and Android features. |
53
50
54
51
55
-
All features of Arm Performance Studio are available free of charge without a license.
52
+
All features of Arm Performance Studio are available free of charge without any additional license.
56
53
57
-
## How do I install Arm Performance Studio?
54
+
## Download Arm Performance Studio
58
55
59
56
Arm Performance Studio is supported on Windows, Linux, and macOS hosts. Download the appropriate installer from [Arm Performance Studio Downloads](https://developer.arm.com/Tools%20and%20Software/Arm%20Performance%20Studio#Downloads).
60
57
61
58
Full details about the supported OS and Android versions are given in the Arm Performance Studio [Release Notes](https://developer.arm.com/documentation/107649).
62
59
63
-
### How do I install Arm Performance Studio on Windows?
64
-
65
-
Run the downloaded `Arm_Performance_Studio_<version>_windows_x86-64.exe` installer, and follow the on-screen instructions.
66
-
67
-
To open Streamline, Frame Advisor, or RenderDoc for Arm GPUs, go to the Windows **Start** menu and search for the name of the tool you want to open.
68
-
69
-
Performance Advisor is a feature of the Streamline command-line application. To generate a performance report, you must first run the provided Python script to enable Streamline to collect frame data from the device. [Get started with Performance Advisor tutorial](https://developer.arm.com/documentation/102478/latest) describes this process in detail. After you have captured a profile with Streamline, run `Streamline-cli` on the Streamline capture file. This command is added to your `PATH` environment variable during installation, so it can be used from anywhere.
60
+
## How do I install Arm Performance Studio on Windows
70
61
71
-
```console
72
-
Streamline-cli.exe -pa <options> my_capture.apc
73
-
```
74
-
75
-
To run Mali Offline Compiler, open a command terminal, navigate to your work directory, and run the `malioc` command on a shader program. The malioc command is added to your `PATH` environment variable during installation, so it can be used from anywhere.
62
+
Arm Performance Studio is provided as an installer executable. Double-click the `.exe` file and follow the instructions in the setup wizard.
76
63
77
-
```console
78
-
malioc.exe <options> my_shader.frag
79
-
```
64
+
Open the Performance Studio Hub from the **Windows Start** menu, or by double-clicking the shortcut in the installation directory. You can read a description of the tools and launch them from the Hub.
80
65
81
-
### How do I install Arm Performance Studio on macOS?
66
+
### How do I install Arm Performance Studio on macOS
82
67
83
68
Arm Performance Studio is provided as a `.dmg` package. To mount it, double-click the `.dmg` package and follow the instructions. The Arm Performance Studio directory tree is copied to the Applications directory on your local file system for easy access.
84
69
85
-
You can remove write permission from the installation directory to prevent other users from writing to it. This is done with the `chmod` command. For example:
70
+
Arm recommends that you set the permissions for the installation directory to prevent other users from writing to it. This is typically achieved with the `chmod` command. For example,
86
71
87
72
```
88
73
chmod go-w <dest_dir>
89
74
```
90
75
91
-
Open Streamline, Frame Advisor or RenderDoc for Arm GPUs directly from the Arm Performance Studio directory in your Applications directory. For example, to open Streamline, go to the `<installation_directory>/streamline` directory and open the `Streamline.app` file.
76
+
To get started, navigate to the Arm Performance Studio installation directory in your `Applications` directory. Open the `Performance Studio.app` file to launch the **Arm Performance Studio Hub**. You can read a description of the tools and launch them from the Hub.
92
77
93
-
To run Performance Advisor, go to the `<installation_directory>/streamline` directory, and double-click the `Streamline-cli-launcher` file. Your computer will ask you to allow Streamline to control the Terminal application. Allow this. The Performance Advisor launcher opens the Terminal application and updates your `PATH` environment variable so you can run Performance Advisor from any directory.
78
+
### Install Arm Performance Studio on Linux
94
79
95
-
Performance Advisor is a feature of the Streamline command-line application. To generate a performance report, you must first run the provided Python script to enable Streamline to collect frame data from the device. This process is described in detail in the [Get started with Performance Advisor tutorial](https://developer.arm.com/documentation/102478/latest). After you have captured a profile with Streamline, run the `Streamline-cli` command on the Streamline capture file to generate a performance report:
80
+
Arm Performance Studio is provided as a gzipped tar archive. Extract this tar archive to your preferred location, using a recent version (1.13 or later) of GNU tar:
96
81
97
82
```
98
-
Streamline-cli -pa <options> my_capture.apc
83
+
tar xvzf Arm_Performance_Studio_2025.1_linux.tgz
99
84
```
100
85
101
-
To run Mali Offline Compiler, go to the `<installation_directory>/mali_offline_compiler` directory, and double-click the `mali_offline_compiler_launcher` file. The Mali Offline Compiler launcher opens the Terminal application and updates your `PATH` environment variable so you can run the `malioc` command from any directory. To generate a shader analysis report, run the `malioc` command on a shader program:
86
+
Arm recommends that you set the permissions for the installation directory to prevent other users from writing to it. This is typically achieved with the `chmod` command. For example:
102
87
103
88
```
104
-
malioc <options> my_shader.frag
89
+
chmod go-w <dest_dir>
105
90
```
106
91
107
-
On some versions of macOS, you might see a message that Mali Offline Compiler is not recognized as an application from an identified developer. To enable Mali Offline Compiler, cancel this message, then open **System Preferences > Security & Privacy** and select **Allow Anyway** for the `malioc` application.
108
-
109
-
### How do I install Arm Performance Studio on Linux?
110
-
111
-
Arm Performance Studio is provided as a gzipped tar archive. Extract this tar archive to your preferred location, using version 1.13 or later of GNU tar:
92
+
{{% notice Tip %}}
93
+
You might find it useful to edit your `PATH` environment variable to add the paths to the `Streamline-cli` and `malioc` executables so that you can run them from any directory. Add the following commands to the .bashrc file in your home directory, so that they are set whenever you initialize a shell session:
112
94
113
95
```
114
-
tar xvzf Arm_Performance_Studio_<version>_linux.tgz
You can remove write permission from the installation directory to prevent other users from writing to it. This is done with the `chmod` command. For example:
100
+
{{% /notice %}}
118
101
119
-
```
120
-
chmod go-w <dest_dir>
121
-
```
102
+
Inside the installation directory is a shortcut called **Performance Studio**. Double-click on the shortcut to launch the Performance Studio Hub. You can read a description of the tools and launch them from the Hub.
122
103
123
-
You might find it useful to edit your `PATH` environment variable to add the paths to the `Streamline-cli` and `malioc` executables so that you can run them from any directory. Add the following commands to the .bashrc file in your home directory, so that they are set whenever you initialize a shell session:
104
+
Alternatively, to open Streamline, Frame Advisor or RenderDoc for Arm GPUs directly, go to the installation directory, open the folder for the tool you want to open and run the application file. For example:
## How do I get started with Arm Performance Studio?
131
112
132
-
Refer to[Get started with Arm Performance Studio](/learning-paths/mobile-graphics-and-gaming/ams/) for an overview of how to run each tool in Arm Performance Studio.
113
+
See the[Get started with Arm Performance Studio](/learning-paths/mobile-graphics-and-gaming/ams/) learning path for an overview of how to run each tool in Arm Performance Studio.
title: Install Ubuntu on ChromeOS Crostini as an LXC Container
3
+
4
+
draft: true
5
+
cascade:
6
+
draft: true
7
+
8
+
minutes_to_complete: 60
9
+
10
+
who_is_this_for: This Learning Path is for software developers who want to install Ubuntu and other Linux distributions on their Arm-based Chromebook with ChromeOS file sharing and GUI support.
11
+
12
+
learning_objectives:
13
+
- Create an Ubuntu 24.04 container on ChromeOS Crostini using the Termina shell and LXC.
14
+
- Set up ChromeOS integration for file sharing and GUI applications.
15
+
- Manage LXC containers on ChromeOS.
16
+
17
+
prerequisites:
18
+
- A ChromeOS device with the Linux development environment enabled. The Lenovo Chromebook Plus 14 is recommended.
The [Lenovo Chromebook Plus 14](https://www.bestbuy.com/site/lenovo-chromebook-plus-14-oled-2k-touchscreen-laptop-mediatek-kompanio-ultra-16gb-memory-256gb-ufs-seashell/6630493.p?skuId=6630493&intl=nosplash) is is powered by the MediaTek Kompanio Ultra processor, featuring an Arm-based MediaTek Kompanio Ultra processor, offers software developers a powerful and energy-efficient platform for Linux development. Its compatibility with containerized environments and support for ChromeOS Linux (Crostini) make it an excellent choice for coding, testing, and running modern development workflows on the go.
8
+
9
+
This Learning Path will walk you through setting up an Ubuntu 24.04 container on your Arm-based Chromebook using ChromeOS's built-in Linux development environment. You'll learn how to create and manage containers, install essential development tools, and integrate your Ubuntu environment with ChromeOS features like file sharing and GUI application support. By the end, you'll have a flexible and powerful Arm Linux development environment.
10
+
11
+
## Access the ChromeOS terminal
12
+
13
+
The first step to creating an Ubuntu container on ChromeOS is to open the ChromeOS shell.
14
+
15
+
Open the Chrome browser and press **Ctrl + Alt + T** to open crosh, the ChromeOS shell, crosh.
The name of the Debian container is penguin. When you enable the Linux subsystem on ChromeOS the Debian container named penguin is created, but you can create additional containers with different Linux distributions and different names.
46
+
47
+
## Create a Ubuntu 24.04 container
48
+
49
+
This command creates and starts a new Ubuntu 24.04 container named `u1`.
50
+
51
+
```bash
52
+
lxc launch ubuntu:24.04 u1
53
+
```
54
+
55
+
The output is:
56
+
57
+
```output
58
+
Creating u1
59
+
Starting u1
60
+
```
61
+
62
+
Check the status of the new container and confirm the status is RUNNING.
Once inside the Ubuntu container, you need to perform some initial setup tasks.
89
+
90
+
Update the package lists and upgrade installed packages to the latest versions.
91
+
92
+
```bash
93
+
apt update && apt upgrade -y
94
+
```
95
+
96
+
Install essential packages for development and system management. You can select your favorite software packages, these are examples.
97
+
98
+
```bash
99
+
apt install -y net-tools gcc
100
+
```
101
+
102
+
Creating a non-root user is a crucial security best practice and ensures that applications don't have unnecessary administrative privileges. The username `ubuntu` is already available in the container. You are free to use `ubuntu` as your non-root user or create a new user.
103
+
104
+
{{% notice Note %}}
105
+
The following commands use `user1` as a new username. You can replace it with your actual desired username in all subsequent steps.
106
+
{{% /notice %}}
107
+
108
+
Create a new user account. Skip if you want to use the `ubuntu` user.
109
+
110
+
```bash
111
+
adduser user1
112
+
```
113
+
114
+
Add the new user to the sudo group to grant administrative privileges. Skip if you want to use the `ubuntu` user.
115
+
116
+
```bash
117
+
usermod -aG sudo user1
118
+
```
119
+
120
+
Switch to your new user account to continue the setup.
121
+
122
+
```bash
123
+
su - user1
124
+
```
125
+
126
+
If you didn't creat a new user switch to `ubuntu` as the non-root user.
127
+
128
+
```bash
129
+
su - ubuntu
130
+
```
131
+
132
+
Continue to learn how to integrate the new Ubuntu container with ChromeOS features like file sharing.
0 commit comments