Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
176 commits
Select commit Hold shift + click to select a range
1028b36
Deploy Ruby on Rails on Google Cloud C4A (Arm-based Axion VMs)
odidev Oct 6, 2025
7e5bab4
Deploy TypeScript on Google Cloud C4A (Arm-based Axion VMs)
odidev Oct 8, 2025
13c576a
Add nginx on AKS multi-architecture learning path - initial cluster s…
geremyCohen Oct 9, 2025
46e52ed
Add Intel nginx deployment with nginx_util.sh testing script
geremyCohen Oct 9, 2025
20f24bb
Complete multiarch nginx on AKS tutorial - AMD, ARM, and multiarch de…
geremyCohen Oct 9, 2025
e8d5cbf
Improve nginx_util.sh output formatting with console bold text for be…
geremyCohen Oct 9, 2025
162fb00
Add login functionality and btop installation to nginx_util.sh script
geremyCohen Oct 10, 2025
5dce967
Restructure tutorial chapters and fix nginx access logs for proper mo…
geremyCohen Oct 10, 2025
0a800ec
Add a learning path for profiling the Linux kernel with Arm Streamline
yahyaA-arm Oct 12, 2025
90da748
Fix nginx_util.sh script to correctly identify serving pods
geremyCohen Oct 14, 2025
95e8476
Deploy Apache Flink on Google Cloud C4A (Arm-based Axion VMs)
odidev Oct 16, 2025
1d3ada3
Enhance build instructions for arm_executor_runner
NostalgiaJohn Oct 17, 2025
06f98d6
Add git configuration and setup verification steps
NostalgiaJohn Oct 17, 2025
049292d
Deploying Quantized LLMs on DGX Spark using llama.cpp
odincodeshen Oct 22, 2025
111e629
Remove cmake --fresh in the clear build
odincodeshen Oct 22, 2025
4b8197c
Update chapter weights for multiarch nginx tutorial
geremyCohen Oct 23, 2025
0809c02
Update AKS cluster tutorial to enhance clarity and accuracy for Arm n…
geremyCohen Oct 23, 2025
b46981f
Refactor introduction section for clarity in the Learning Path descri…
geremyCohen Oct 23, 2025
b6e1931
Enhance AKS cluster tutorial with improved clarity and additional not…
geremyCohen Oct 23, 2025
4955525
Replace embedded script with curl download from GitHub repo
geremyCohen Oct 24, 2025
8b253aa
Update nginx utility script instructions for clarity and include curl…
geremyCohen Oct 24, 2025
4423636
Replace embedded YAML with curl downloads from nginxOnAKS repo
geremyCohen Oct 24, 2025
a76deb4
Update deployment instructions for Intel nginx setup and add jq as a …
geremyCohen Oct 24, 2025
40c5b23
Replace embedded ARM YAML with curl/kubectl commands
geremyCohen Oct 24, 2025
f154ec7
Extract multiarch service YAML to repo, use curl + kubectl pattern
geremyCohen Oct 24, 2025
8210d9d
Add example outputs to chapter 0 (cluster creation)
geremyCohen Oct 24, 2025
c54e02e
Remove AMD reference and update put command to btop in chapter 1.5
geremyCohen Oct 24, 2025
014114b
Update chapter 1: Add ConfigMap, fix nodeSelector/container name, upd…
geremyCohen Oct 24, 2025
5027344
Add note explaining amd64 architecture naming convention
geremyCohen Oct 24, 2025
ba20ce7
Update chapter 3: Add ConfigMap, fix nodeSelector, update outputs, ad…
geremyCohen Oct 24, 2025
eea0422
Remove duplicate 'Verify the deployment' heading in chapter 3
geremyCohen Oct 24, 2025
80e4395
Update chapter 4: Remove AMD references, update outputs to show 2 nod…
geremyCohen Oct 24, 2025
48fddcd
Update performance monitoring section: change title, remove AMD refer…
geremyCohen Oct 24, 2025
fa2d2b8
Replace 'nginx_util.sh get' with 'nginx_util.sh curl' throughout tuto…
geremyCohen Oct 24, 2025
14e27d1
Merge branch 'ArmDeveloperEcosystem:main' into ignite-demo
geremyCohen Oct 27, 2025
1b2eeb5
Zephyr Workbench VS Code learning path
odincodeshen Oct 27, 2025
5c8c94d
Add AC6 contributor
odincodeshen Oct 27, 2025
4536710
Update performance monitoring section: change title, remove AMD refer…
geremyCohen Oct 27, 2025
2f90972
Update performance monitoring section: change title, remove AMD refer…
geremyCohen Oct 27, 2025
11f5741
Renamed files
geremyCohen Oct 27, 2025
f57cf9d
Update _index.md
odincodeshen Oct 27, 2025
3cb0e6b
Merge pull request #2455 from odincodeshen/feature/gb10_llamacpp
jasonrandrews Oct 28, 2025
38dab50
Start review of llama.cpp on DGX Spark
jasonrandrews Oct 28, 2025
e1d0920
Merge pull request #2485 from jasonrandrews/review
jasonrandrews Oct 28, 2025
aa036bf
x86 to arm64 on gke
ranimandepudi Oct 28, 2025
3398c76
flattened LP. added new option to hide from nav pane
DougAnsonAustinTX Oct 29, 2025
390d38f
added some description detail to the example LP for the new metadata …
DougAnsonAustinTX Oct 29, 2025
3b00091
added detail on new metadata tag to formatting section too
DougAnsonAustinTX Oct 29, 2025
943e303
removed from the metadata content page
DougAnsonAustinTX Oct 29, 2025
f232560
Add .gitignore to exclude default ignored files
geremyCohen Oct 29, 2025
5fddbd9
Update roadmap-update.yml
chrismoroney Oct 29, 2025
6acf3c0
Enhance AKS cluster deployment guide with multi-architecture benefits…
geremyCohen Oct 29, 2025
407a61d
Update VNC install guide
jasonrandrews Oct 29, 2025
3444c31
Merge pull request #2488 from jasonrandrews/review
jasonrandrews Oct 29, 2025
7f0bb9f
pulled new metadata tag from example LP for now
DougAnsonAustinTX Oct 29, 2025
63d6733
Merge pull request #2487 from ArmDeveloperEcosystem/cmoroney-update-p…
jasonrandrews Oct 29, 2025
3ec77f9
Merge pull request #2486 from DougAnsonAustinTX/ei_lp_structure_update
jasonrandrews Oct 29, 2025
137a06f
review llama.cpp on GB10
jasonrandrews Oct 29, 2025
de650a2
Merge pull request #2489 from jasonrandrews/review
jasonrandrews Oct 29, 2025
3da5f0b
Update install-circleci-cli.md
pareenaverma Oct 30, 2025
7d209e2
Update Android LlamaDemo LP
annietllnd Oct 30, 2025
a98ac74
Update _index.md
pareenaverma Oct 31, 2025
eb16b34
Merge pull request #2409 from yahyaA-arm/main
pareenaverma Oct 31, 2025
4eb2d94
Update top-down performance Learning Path
jasonrandrews Nov 1, 2025
89f9abb
Merge pull request #2495 from jasonrandrews/review
jasonrandrews Nov 1, 2025
a4016f0
Merge branch 'main' into ignite-demo
geremyCohen Nov 2, 2025
7d21b17
Update install_circleci_runner.md
pareenaverma Nov 3, 2025
ae388f6
Update circleci-arm64-cloud-demo.md
pareenaverma Nov 3, 2025
a106838
Update _index.md
pareenaverma Nov 3, 2025
d4fa262
Update background.md
pareenaverma Nov 3, 2025
2916ff2
Update install-circleci-cli.md
pareenaverma Nov 3, 2025
b8358c3
Update create_resource_class.md
pareenaverma Nov 3, 2025
332aa83
Update install_circleci_runner.md
pareenaverma Nov 3, 2025
6859b26
Update install_circleci_runner.md
pareenaverma Nov 3, 2025
5ff4b3c
Update circleci-arm64-cloud-demo.md
pareenaverma Nov 3, 2025
8885acf
Merge branch 'ArmDeveloperEcosystem:main' into content_review
pareenaverma Nov 3, 2025
eefa097
Merge pull request #2496 from pareenaverma/content_review
pareenaverma Nov 3, 2025
a12193d
Merge pull request #2493 from annietllnd/updates
pareenaverma Nov 3, 2025
91836d7
Update _index.md
pareenaverma Nov 3, 2025
bdd3bb8
Merge pull request #2403 from odidev/typescr_LP
pareenaverma Nov 3, 2025
2692108
Update _index.md
pareenaverma Nov 3, 2025
c769d9a
Update background.md
pareenaverma Nov 3, 2025
b7f792f
lp(gke-multi-arch-axion): add gke-build-push page; update _index, clo…
ranimandepudi Nov 3, 2025
6766208
Update installation.md
pareenaverma Nov 3, 2025
d7e7f88
Update baseline.md
pareenaverma Nov 3, 2025
e9049de
Update benchmarking.md
pareenaverma Nov 3, 2025
634c654
Update benchmarking.md
pareenaverma Nov 3, 2025
6f97b86
Merge pull request #2497 from pareenaverma/content_review
pareenaverma Nov 3, 2025
df53d61
Update _index.md
pareenaverma Nov 3, 2025
e4b7f5a
Merge pull request #2400 from odidev/ruby_LP
pareenaverma Nov 3, 2025
fc62632
Refine introductory content and resources for DGX Spark learning path
madeline-underwood Nov 3, 2025
8f357fe
Update resource title format in DGX Spark learning path
madeline-underwood Nov 3, 2025
b737c5c
Update tutorials: add shared nginx-configmap, remove ARM vs Intel con…
geremyCohen Nov 4, 2025
55b346b
Merge branch 'ignite-demo' of github.com:geremyCohen/arm-learning-pat…
geremyCohen Nov 4, 2025
f919619
Fix 5 documentation issues for shared ConfigMap architecture
geremyCohen Nov 4, 2025
8ad75ec
Merge branch 'ignite-demo' of github.com:geremyCohen/arm-learning-pat…
geremyCohen Nov 4, 2025
01095fd
Merge branch 'ArmDeveloperEcosystem:main' into dgx
madeline-underwood Nov 4, 2025
65c96e2
Refactor introduction sections and enhance clarity in DGX Spark learn…
madeline-underwood Nov 4, 2025
688a48e
Merge branch 'dgx' of https://github.com/madeline-underwood/arm-learn…
madeline-underwood Nov 4, 2025
cfbbac2
Refactor DGX Spark learning path documentation: update titles, enhanc…
madeline-underwood Nov 4, 2025
b1e1453
Refactor DGX Spark learning path documentation: update section titles…
madeline-underwood Nov 4, 2025
d70fb81
Fix confusing reference to Intel deployment in test utility section
geremyCohen Nov 4, 2025
0bc72bc
Merge branch 'ArmDeveloperEcosystem:main' into ignite-demo
geremyCohen Nov 4, 2025
a7fefa3
Merge branch 'ignite-demo' of github.com:geremyCohen/arm-learning-pat…
geremyCohen Nov 4, 2025
03b2b7d
removing .idea and .gitignore
geremyCohen Nov 4, 2025
06aef29
Update VNC install guide
jasonrandrews Nov 4, 2025
e806cc6
Merge pull request #2499 from jasonrandrews/review
jasonrandrews Nov 4, 2025
dfdfc04
Update baseline.md
pareenaverma Nov 4, 2025
5d03a12
Update baseline.md
pareenaverma Nov 4, 2025
500ffd8
Refactor DGX Spark learning path documentation: enhance clarity, impr…
madeline-underwood Nov 4, 2025
ab3869d
Merge branch 'ArmDeveloperEcosystem:main' into dgx
madeline-underwood Nov 4, 2025
684f1cd
Update content/learning-paths/laptops-and-desktops/dgx_spark_llamacpp…
madeline-underwood Nov 4, 2025
82c7de2
Update baseline.md
pareenaverma Nov 4, 2025
e253cdc
Refactor documentation for clarity and consistency: update phrasing, …
madeline-underwood Nov 4, 2025
c4908ba
Update baseline.md
pareenaverma Nov 4, 2025
09250bf
Update Zena Debug for latest 2.1 sw stack
RonanSynnottArm Nov 5, 2025
c4a5879
Merge pull request #2500 from RonanSynnottArm/zenadebug21
jasonrandrews Nov 5, 2025
f64b304
Merge branch 'main' into feature/zephyr_vsworkbench
jasonrandrews Nov 5, 2025
dab9d74
Merge pull request #2483 from odincodeshen/feature/zephyr_vsworkbench
jasonrandrews Nov 5, 2025
f4299ca
start tech review on Zephyr Learning Path
jasonrandrews Nov 5, 2025
e8d2054
Merge pull request #2501 from jasonrandrews/review2
jasonrandrews Nov 5, 2025
138c8e0
Merge branch 'ArmDeveloperEcosystem:main' into dgx
madeline-underwood Nov 5, 2025
68dca01
Fixed typo in DGX Spark LLaMA.cpp GPU guide
madeline-underwood Nov 5, 2025
2f6382d
Fixed typo# Please enter the commit message for your changes. Lines s…
madeline-underwood Nov 5, 2025
c8a2a36
Update prerequisites in DGX Spark LLaMA.cpp guide to include addition…
madeline-underwood Nov 5, 2025
c0f4e1a
Final tweaks
madeline-underwood Nov 5, 2025
7bb8ff9
Merge branch 'ArmDeveloperEcosystem:main' into content_review
pareenaverma Nov 5, 2025
b909a4e
Update _index.md
pareenaverma Nov 5, 2025
52b975d
Update installation.md
pareenaverma Nov 5, 2025
7a9a38c
Update installation.md
pareenaverma Nov 5, 2025
612c897
Update baseline.md
pareenaverma Nov 5, 2025
a4cd4d2
Update benchmarking.md
pareenaverma Nov 5, 2025
b5b0052
Update benchmarking.md
pareenaverma Nov 5, 2025
9e45199
Update benchmarking.md
pareenaverma Nov 5, 2025
c992f65
Merge pull request #2503 from pareenaverma/content_review
pareenaverma Nov 5, 2025
7461550
Update Windows VM Learning Path
jasonrandrews Nov 5, 2025
2039c12
Merge pull request #2504 from jasonrandrews/review
jasonrandrews Nov 5, 2025
b9d2a72
Update LPs to ExecuTorch 1.0
annietllnd Nov 5, 2025
7d082cf
Merge pull request #2498 from geremyCohen/ignite-demo
jasonrandrews Nov 5, 2025
cdf000d
Start tech review of AKS running nginx Learning Path
jasonrandrews Nov 5, 2025
3d0c227
Merge pull request #2506 from jasonrandrews/review
jasonrandrews Nov 5, 2025
d474a5b
Merge pull request #2502 from madeline-underwood/dgx
jasonrandrews Nov 5, 2025
da93022
Review DGX Spark Learning Path
jasonrandrews Nov 5, 2025
a9ca570
Merge pull request #2508 from jasonrandrews/review
jasonrandrews Nov 5, 2025
0f7fe7a
Update Ruby on Rails learning path: refine content, add accomplishmen…
madeline-underwood Nov 6, 2025
ed21755
Update PostgreSQL authentication method instructions in baseline.md
madeline-underwood Nov 6, 2025
3125c8d
Update Ruby on Rails learning path content
madeline-underwood Nov 6, 2025
c386534
Initial review of Zephyr Workbench Learning Path
jasonrandrews Nov 6, 2025
f9a48e1
Merge pull request #2512 from jasonrandrews/review
jasonrandrews Nov 6, 2025
ef8fa8a
Initial review of Zephyr Workbench Learning Path
jasonrandrews Nov 6, 2025
eb4de78
Merge pull request #2513 from jasonrandrews/review
jasonrandrews Nov 6, 2025
9eb1148
Merge branch 'ArmDeveloperEcosystem:main' into ruby
madeline-underwood Nov 6, 2025
57fcffe
Refine Ruby on Rails documentation: update titles for clarity, enhanc…
madeline-underwood Nov 6, 2025
b32fca7
Merge branch 'ruby' of https://github.com/madeline-underwood/arm-lear…
madeline-underwood Nov 6, 2025
eb2bc77
first review of nginx on AKS Learning Path
jasonrandrews Nov 6, 2025
859ab93
Refactor titles and section headings for consistency in Ruby on Rails…
madeline-underwood Nov 6, 2025
e8bad70
Merge pull request #2516 from jasonrandrews/review
jasonrandrews Nov 7, 2025
cb77ef5
Merge pull request #2505 from annietllnd/updates
jasonrandrews Nov 7, 2025
d417bed
author name fix
ranimandepudi Nov 7, 2025
5296a42
Merge branch 'main' into add-multi-arch-learning-path
jasonrandrews Nov 7, 2025
8eb8f72
fix: updated the block with correct theme
ranimandepudi Nov 7, 2025
2a896e1
Merge pull request #2434 from NostalgiaJohn/update-to-Introduction-to…
jasonrandrews Nov 7, 2025
95cad50
Merge pull request #2518 from ranimandepudi/add-multi-arch-learning-path
jasonrandrews Nov 7, 2025
051ff52
Fix processing-workflow.md for scheduling and runtime
stevesuzuki-arm Nov 7, 2025
50b372d
Merge pull request #2519 from stevesuzuki-arm/fix_processing-workflow
pareenaverma Nov 7, 2025
7416aa5
Update _index.md
pareenaverma Nov 7, 2025
c6f2240
Merge pull request #2427 from odidev/flink_LP
pareenaverma Nov 7, 2025
8da2f47
review online boutique app on GKE
jasonrandrews Nov 7, 2025
fd9a792
review online boutique app on GKE
jasonrandrews Nov 7, 2025
2cb875c
review online boutique app on GKE
jasonrandrews Nov 7, 2025
656b587
Merge pull request #2521 from jasonrandrews/review
jasonrandrews Nov 7, 2025
0e489e1
Merge pull request #2514 from madeline-underwood/ruby
jasonrandrews Nov 7, 2025
2d02e31
Update 3-env-setup-fvp.md
annietllnd Nov 8, 2025
de56802
Merge pull request #2522 from annietllnd/review
jasonrandrews Nov 8, 2025
ea6b458
spelling and tag updates
jasonrandrews Nov 8, 2025
4edd700
Merge pull request #2524 from jasonrandrews/review
jasonrandrews Nov 8, 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
18 changes: 14 additions & 4 deletions .github/workflows/roadmap-update.yml
Original file line number Diff line number Diff line change
Expand Up @@ -171,13 +171,23 @@ jobs:
console.log('Start Date field not found');
}
} else if (labelName === 'publish') {
const endDateFieldId = await getFieldId(projectId, 'Publish Date');
if (endDateFieldId) {
await updateDateField(projectId, itemId, endDateFieldId, today);
// Publish Date
const publishDateFieldId = await getFieldId(projectId, 'Publish Date');
if (publishDateFieldId) {
await updateDateField(projectId, itemId, publishDateFieldId, today);
console.log('Updated Publish Date to', today);
} else {
console.log('Publish Date field not found');
}

// Last Reviewed Date (same as Publish Date)
const lastReviewedFieldId = await getFieldId(projectId, 'Last Reviewed Date');
if (lastReviewedFieldId) {
await updateDateField(projectId, itemId, lastReviewedFieldId, today);
console.log('Updated Last Reviewed Date to', today);
} else {
console.log('Last Reviewed Date field not found');
}
} else {
console.log('No action taken for label:', labelName);
}
Expand All @@ -187,4 +197,4 @@ jobs:
}
}

main();
main();
102 changes: 101 additions & 1 deletion .wordlist.txt
Original file line number Diff line number Diff line change
Expand Up @@ -5055,4 +5055,104 @@ Zynq
ZYNQ
zypper
ZZa
ZZZZZ
ZZZZZ
Abouelseoud
ActiveRecord
Axion's
Ayoub
BeagleBone
Bourjilat
Buildroot's
Bundler
CGO
ConfigMap
CubeProgrammer
DEBLOAT
DGX
DTC
Disaggregated
EP
Espressif
FPARMv
FRDM
FirewallD
Flink's
IDQ
Kustomize
LinkServer
MCXN
MIS
MVC
NVLink
OpenOCD
PRED
PackageCloud
Puncover
PyOCD
RemoteChannelThroughputBenchmark
Retbleed
SEGGER
SVD
Skaffold
Skylake
Spectre
Superchip
TARGETPLATFORM
TFLOPs
TMA
TMAM
UNHALTED
VPCs
Vmlinux
WordCount
YJIT
Yahya
backend's
btop
carkservice
cartservice
checkpointing
cours
dgx
dtlb
emailservice
firewalld
fopenmp
fs
htop
ident
insmod
itlb
ko
kube
loadgen
loadgenerator
microbenchmarks
microcoded
microoperation
mknod
mpki
mtune
mvn
mychardrv
nRF
narrowings
navpane
nginx's
nvcc
nvtop
oRT
petaFLOP
plaintext
rbenv
recommendationservice
remoteRebalance
residually
rubyonrails
sdcard
smi
spiko
transpile
tsc
typescriptlang
vmlinux
5 changes: 4 additions & 1 deletion assets/contributors.csv
Original file line number Diff line number Diff line change
Expand Up @@ -104,4 +104,7 @@ Alejandro Martinez Vicente,Arm,,,,
Mohamad Najem,Arm,,,,
Ruifeng Wang,Arm,,,,
Zenon Zhilong Xiu,Arm,,zenon-zhilong-xiu-491bb398,,
Zbynek Roubalik,Kedify,,,,
Zbynek Roubalik,Kedify,,,,
Rani Chowdary Mandepudi, Arm,,,,
Ayoub Bourjilat,Ac6,Bourjilat,ayoub-bourjilat-a55b58165/,,https://www.ac6.fr/en/
Yahya Abouelseoud,Arm,,,,
Binary file modified content/install-guides/_images/xfce4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
57 changes: 30 additions & 27 deletions content/install-guides/vnc.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ additional_search_terms:
- linux

### Estimated completion time in minutes (please use integer multiple of 5)
minutes_to_complete: 30
minutes_to_complete: 15

author: Jason Andrews

Expand All @@ -29,67 +29,69 @@ multitool_install_part: false # Set to true if a sub-page of a multi-page arti
layout: installtoolsall # DO NOT MODIFY. Always true for tool install articles
---

Virtual Network Computing (VNC) is one of the common tools used to connect to a remote Linux desktop. During development it may be useful to quickly create a remote desktop on an Arm server.
Virtual Network Computing (VNC) is one of the common tools used to connect to a remote Linux desktop. During development, it can be useful to quickly create a remote desktop on an Arm server.

This section provides info about how to setup VNC on a remote Arm Linux machine.
This guide provides information about how to set up VNC on a remote Arm Linux machine.

Feel free to seek out additional VNC tutorials or add more information to this page.

This installation only works on newer versions of Ubuntu and Debian. It was successfully tested on **Ubuntu 22.04** and is known to fail on **Ubuntu 20.04**.
This installation only works on newer versions of Ubuntu and Debian. It was successfully tested on Ubuntu 22.04 and Ubuntu 24.04.

## What is VNC?

VNC is a client server application. A VNC server runs on a remote machine. A VNC client runs on the local machine and connects to the remote server.
VNC is a client-server application. A VNC server runs on a remote machine. A VNC client runs on the local machine and connects to the remote server.

### How do I install the VNC server and xfce4 desktop?

To use VNC, a VNC server needs to be installed. There are multiple VNC servers which can be used. This recipe uses [TigerVNC](https://tigervnc.org/).
To use VNC, you need to install a VNC server. There are multiple VNC servers you can use. This guide uses [TigerVNC](https://tigervnc.org/).

Desktop software is also needed. There are many options for this, but using [xfce4](https://www.xfce.org/) makes for a minimal install with good performance.
You also need desktop software. There are many options for this, but using [xfce4](https://www.xfce.org/) provides a minimal install with good performance.

Install the desktop software.
Install the desktop software:

```bash
sudo apt-get install xfce4 xfce4-goodies xorg dbus-x11 x11-xserver-utils xfce4-terminal -y
```

Install the VNC server.
Install the VNC server:

```bash
sudo apt-get install tigervnc-standalone-server tigervnc-common -y
```

### How do I set a VNC password?

Run the password command to set a password for VNC. This is not the password for the user account, just for the VNC client to connect to the VNC server.
Run the `vncpasswd` command to set a password for VNC. This is not the password for your user account, but for the VNC client to connect to the VNC server.

```console
vncpasswd
```

Remember the password for later when the client is connected.
Remember this password for later when you connect the client.

### How do I configure the desktop startup for VNC?

Create a file at `$HOME/.vnc/xstartup` with the contents:
Create a file at `$HOME/.vnc/xstartup` with the following contents:

```console
#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
exec startxfce4
```
Make sure the `xstartup` file has executable permission.
Make sure the `xstartup` file has executable permissions:

```console
chmod +x $HOME/.vnc/xstartup
```

### How do I set up a systemd service to manage VNC?

To create a systemd service to start the VNC server create the file `/etc/systemd/system/vncserver@.service`
To create a systemd service to start the VNC server, create the file `/etc/systemd/system/vncserver@.service`.

Use sudo or root as it is located in a read-only area.
```console
Use `sudo` or root privileges because this file is in a system directory.

If your username is not `ubuntu` change the `User` value to match your username after you create the new file.

```ini
[Unit]
Description=Remote desktop service (VNC)
After=syslog.target network.target
Expand All @@ -105,9 +107,9 @@ Use sudo or root as it is located in a read-only area.

[Install]
WantedBy=multi-user.target
```

```
The commands below are for any Linux distribution using `systemd`.
The following commands are for any Linux distribution that uses `systemd`.

To start the VNC service:

Expand All @@ -129,24 +131,25 @@ sudo systemctl restart vncserver@1.service

### How do I use port forwarding via SSH to connect to VNC?

The default port for the first instance of VNC is `5901`. SSH port forwarding is the best solution for accessing the Linux desktop on a cloud machine. This way no additional ports need to be opened in the security group.
The default port for the first instance of VNC is `5901`. SSH port forwarding is the recommended solution for accessing the Linux desktop on a cloud machine. This way, no additional ports need to be opened in the security group.

SSH to your remote Linux machine. Refer to [SSH](/install-guides/ssh/) for additional details.
SSH to your remote Linux machine. See [SSH](/install-guides/ssh/) for additional details.

Substitute your private key file and public IP address of the remote machine.
Substitute your private key file and the public IP address of the remote machine in the following command:

```console
ssh -i <private_key> -L 5901:localhost:5901 ubuntu@<public_ip_address>
```

Once connected via SSH, use a VNC client to connect. [Download](https://sourceforge.net/projects/tigervnc/files/stable/1.12.0/) an install a TigerVNC client for your computer.
Once connected via SSH, use a VNC client to connect. [Download](https://sourceforge.net/projects/tigervnc/files/stable/1.12.0/) and install a TigerVNC client for your computer.

Open the VNC client and enter the following for the VNC server:

Open the VNC client and enter the following for the VNC server.
```console
localhost:5901
```
You will be prompted for the password created earlier with `vncpasswd`.
You will be prompted for the password you created earlier with `vncpasswd`.

A remote Linux Desktop should appear on your local computer. Make sure to close the VNC client first and then exit the SSH connection.
A remote Linux desktop should appear on your local computer. When you are finished, close the VNC client first and then exit the SSH connection.

![Linux desktop #center](/install-guides/_images/xfce4.png)
2 changes: 1 addition & 1 deletion content/learning-paths/automotive/zenacssdebug/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ learning_objectives:

prerequisites:
- Ubuntu 22.04 host machine
- Arm Development Studio 2024.1 or later with a valid license - for support see the [Install Guide for ADS](/install-guides/armds)
- Arm Development Studio 2024.1 or later with a valid license - for support see the [Install Guide for Arm DS](/install-guides/armds)
- Basic understanding of the Arm Zena CSS software stack, Armv8-A/Armv9-A cores, and Linux

author: Ronan Synnott
Expand Down
18 changes: 13 additions & 5 deletions content/learning-paths/automotive/zenacssdebug/config.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,19 +46,27 @@ Debug configurations are stored in a configuration database. Create a local data
- Open the same wizard (**File > New > Other**), then choose **Configuration Database > Model Configuration**.
- Click **Next**, select the **Configuration Database** you created, then click **Next**.
- For **Model Interface**, choose **Iris**, then click **Next**.
- Choose **Browse for model running on local host**. The debugger detects and interrogates the FVP.
- Choose **Browse for model running on local host**. Select your FVP and click **Finish**. The debugger detects and interrogates the FVP.
- If connecting remotely, choose **Connect to model running on either local or remote host** and provide the host and port.

{{% notice Tip %}}
The name of the FVP may be displayed as `RD_ASD` or other.

If unsure, use the port number to identify the correct FVP.
{{% /notice %}}

Arm Development Studio generates a `model.mdf` file that enumerates all CPUs in the FVP.

Optionally, update **Manufacturer Name** (for example, `Arm`) and **Platform Name** (for example, `Zena_CSS_FVP`). Then **Save** and **Import** the model into the configuration database.
Optionally, update **Manufacturer Name** (for example, `Arm`) and **Platform Name** (for example, `Zena_CSS_FVP`).

**Save** and **Import** the model into the configuration database.

{{% notice Tip %}}
If the FVP is not detected, verify the Iris server is running on the expected port (`7100` by default) and that your firewall allows local connections. For remote connections, confirm the host is reachable and the port is open.
If the FVP is not detected, verify the Iris server is running on the expected port (`7100` by default) and that your firewall allows local connections.

For remote connections, confirm the host is reachable and the port is open.
{{% /notice %}}

A `model.mdf` file will be created that identifies all CPUs within the FVP.

You can change the **Manufacturer Name** and **Platform Name** to something more meaningful (such as `Arm` and `Zena_CSS_FVP`), then **Save**, and **Import** into the configuration database.

The debugger is now aware of the FVP and you are ready to debug.
19 changes: 14 additions & 5 deletions content/learning-paths/automotive/zenacssdebug/primarycompute.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,9 @@ For example the processors start in `EL3` and move to `EL2N` when the Linux kern

``` text
stop
add-symbol-file /arm-auto-solutions/build/tmp_baremetal/work/fvp_rd_aspen-poky-linux/trusted-firmware-a/2.11.0+git/image/firmware/bl2.elf EL3:0x0
add-symbol-file "/arm-auto-solutions/build/tmp_baremetal/work/fvp_rd_aspen-poky-linux/trusted-firmware-a/2.13.0+git/image/firmware/bl2.elf" EL3:0x0
tbreak bl2_entrypoint

```

{{% notice Note %}}
Expand All @@ -41,12 +42,20 @@ Symbol loading is Exception Level–aware. If execution changes Exception Level,

## Debug the Linux kernel with OS awareness (symmetric multiprocessing)

Switch to the `Primary_Linux.launch` connection you created earlier to enable Arm Development Studio OS awareness for the Linux kernel. Load the kernel symbols and set source mapping if your kernel sources are located outside the default paths:
{{% notice Note %}}
OS awareness for Linux Kernel 6.12 (as used with Reference Software Stack 2.1) is not currently supported as of Arm Development Studio 2025.0.

It will be supported in a future Development Studio version.
{{% /notice %}}

Disconnect `Primary_init.launch` and use the `Primary_Linux.launch` connection you created earlier to enable Arm Development Studio OS awareness for the Linux kernel.

Load the kernel symbols and set source mapping if your kernel sources are located outside the default paths:

```text
stop
add-symbol-file /arm-auto-solutions/build/tmp_baremetal/work/fvp_rd_aspen-poky-linux/linux-yocto/6.6.54+git/linux-fvp_rd_aspen-standard-build/vmlinux EL2N:0x0
set substitute-path /usr/src/kernel/ /arm-auto-solutions/build/tmp_baremetal/work-shared/fvp-rd-aspen/kernel-source/
add-symbol-file "/arm-auto-solutions/build/tmp_baremetal/work/fvp_rd_aspen-poky-linux/linux-yocto-rt/6.12.30+git/linux-fvp_rd_aspen-preempt-rt-build/vmlinux" EL2N:0x0
set substitute-path "/usr/src/kernel/" "/arm-auto-solutions/build/tmp_baremetal/work-shared/fvp-rd-aspen/kernel-source/"
```

Run the FVP until the OS prompt appears.
Expand All @@ -73,7 +82,7 @@ You might see a warning like:
```text
WARNING(ROS60): Could not enable OS support as the OS does not appear to be initialized. This might be caused by a mismatch between the loaded symbols and the code on the target or because the OS is not up and running. Enabling OS support will be re-attempted when the target next stops.
```
This occurs if the OS has not completed boot when you connect; it is safe to ignore and will clear after the next target stop.
This occurs if the OS has not completed boot when you connect; it is safe to ignore and will clear when stopping target after the OS has booted.
{{% /notice %}}

You have successfully learnt how to use Arm Development Studio to explore and debug the Arm Zena CSS Reference Software Stack.
Loading
Loading