Skip to content

Update linaro-uenv.md #104

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
May 3, 2025
Merged

Update linaro-uenv.md #104

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
03fc5e4
Update linaro-uenv.md
jgphpc May 3, 2025
21fa24f
spell
May 3, 2025
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
47 changes: 20 additions & 27 deletions docs/software/devtools/linaro-uenv.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,10 +21,10 @@
```console
$ uenv image find linaro-forge
uenv arch system id size(MB) date
linaro-forge/24.1.1:v1 gh200 daint e0e79f5c3e6a8ee0 365 2025-02-12
linaro-forge/24.1.2:v1 gh200 daint b9c8487cf183a16a 365 2025-04-15

$ uenv image pull linaro-forge/24.1.1:v1
pulling e0e79f5c3e6a8ee0 100.00% --- 365/365 (0.00 MB/s)
$ uenv image pull linaro-forge/24.1.2:v1
pulling b9c8487cf183a16a 100.00% --- 365/365 (0.00 MB/s)
```

This uenv is configured to be mounted in the `/user-tools` path so that they can be used alongside application and development uenv mounted at `/user-environment`.
Expand All @@ -33,33 +33,26 @@
In the following example, the `prgenv-gnu` and `linaro-forge` uenv will be mounted at `/user-environment` and `/user-tools` respectively:

```console
$ uenv start prgenv-gnu/24.11,linaro-forge/24.1.1 \
--view=prgenv-gnu:default,forge
$ uenv start prgenv-gnu/24.11:v2,linaro-forge/24.1.2:v1 \
--view=prgenv-gnu:default # (1)!
$ source /user-tools/activate

$ uenv status # (1)!
$ uenv status # (2)!

$ ddt --version # (2)!
$ ddt --version # (3)!
Linaro DDT Part of Linaro Forge.
Copyright (c) 2023-2024 Linaro Limited. All rights reserved.
Version: 24.1.1
Copyright (c) 2023-2025 Linaro Limited. All rights reserved.
Version: 24.1.2
```

1. Test that everything has been mounted correctly by looking at `uenv status`.
1. Loading the `activate` script instead of loading a view for the linaro-forge uenv allows to keep using the compilers from the prgenv-gnu uenv.
2. Test that everything has been mounted correctly by looking at `uenv status`.
There will be warnings if there are problems.
2. Check that the [DDT debugger][ref-devtools-ddt] is in the path.
3. Check that the [DDT debugger][ref-devtools-ddt] is in the path.

!!! note
The `linaro-forge` uenv is always mounted at the `/user-tools` mount point, and a script `/user-tools/activate` is provided to load both ddt and map into your environment, without needing to use a view.

```console
$ uenv start linaro-forge/14.1.1
$ source /user-tools/activate
$ ddt --version
Linaro DDT Part of Linaro Forge.
Copyright (c) 2023-2024 Linaro Limited. All rights reserved.
Version: 24.1.1
```

### Install and configure the Linaro client on your local machine

We recommend installing the [Linaro desktop client] on your local workstation or laptop.
Expand All @@ -73,7 +66,7 @@
Mismatches between the client and the uenv version will lead to the following error when trying to establish a remote connection:

```
The local version of Linaro DDT (24.0.6) is not compatible with the remote version (24.1.1).
The local version of Linaro DDT (24.0.6) is not compatible with the remote version (24.1.2).
```

The client can be configured to connect with the debug jobs running on [Alps][ref-alps], offering a better user experience compared to running with X11 forwarding.
Expand All @@ -88,7 +81,7 @@
The path will change if you have installed a different version, or if it has been installed in a non-standard installation location.

```bash
$HOME/linaro/forge/24.1.1/bin/ddt
$HOME/linaro/forge/24.1.2/bin/ddt
```

=== "macOS"
Expand All @@ -99,7 +92,7 @@
Please use the appropriate path and version for your installation.

```bash
open /Applications/Linaro\ Forge\ Client\ 24.1.1.app/
open /Applications/Linaro\ Forge\ Client\ 24.1.2.app/
```

Next, configure a connection to the target system.
Expand All @@ -117,7 +110,7 @@
| ----------- | --------------------------------------- |
| Connection | `daint` |
| Host Name | `cscsusername@ela.cscs.ch cscsusername@daint.cscs.ch` |
| Remote Installation Directory | `uenv run linaro-forge/24.1.1:/user-tools -- /user-tools/env/forge/` |
| Remote Installation Directory | `uenv run linaro-forge/24.1.2:/user-tools -- /user-tools/env/forge/` |
| Private Key | `~/.ssh/cscs-key` |

=== "Santis"
Expand All @@ -132,7 +125,7 @@
| ----------- | --------------------------------------- |
| Connection | `santis` |
| Host Name | `cscsusername@ela.cscs.ch cscsusername@santis.cscs.ch` |
| Remote Installation Directory | `uenv run linaro-forge/24.1.1:/user-tools -- /user-tools/env/forge/` |
| Remote Installation Directory | `uenv run linaro-forge/24.1.2:/user-tools -- /user-tools/env/forge/` |
| Private Key | `~/.ssh/cscs-key` |

=== "Clariden"
Expand All @@ -147,7 +140,7 @@
| ----------- | --------------------------------------- |
| Connection | `clariden` |
| Host Name | `cscsusername@ela.cscs.ch cscsusername@clariden.cscs.ch` |
| Remote Installation Directory | `uenv run linaro-forge/24.1.1:/user-tools -- /user-tools/env/forge/` |
| Remote Installation Directory | `uenv run linaro-forge/24.1.2:/user-tools -- /user-tools/env/forge/` |
| Private Key | `~/.ssh/cscs-key` |

=== "Eiger"
Expand All @@ -162,7 +155,7 @@
| ----------- | --------------------------------------- |
| Connection | `eiger` |
| Host Name | `cscsusername@ela.cscs.ch cscsusername@eiger.cscs.ch` |
| Remote Installation Directory | `uenv run linaro-forge/24.1.1:/user-tools -- /user-tools/env/forge/` |
| Remote Installation Directory | `uenv run linaro-forge/24.1.2:/user-tools -- /user-tools/env/forge/` |
| Private Key | `~/.ssh/cscs-key` |

!!! tip
Expand Down
Loading