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/vnc.md
+30-27Lines changed: 30 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ additional_search_terms:
9
9
- linux
10
10
11
11
### Estimated completion time in minutes (please use integer multiple of 5)
12
-
minutes_to_complete: 30
12
+
minutes_to_complete: 15
13
13
14
14
author: Jason Andrews
15
15
@@ -29,67 +29,69 @@ multitool_install_part: false # Set to true if a sub-page of a multi-page arti
29
29
layout: installtoolsall # DO NOT MODIFY. Always true for tool install articles
30
30
---
31
31
32
-
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.
32
+
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.
33
33
34
-
This section provides info about how to setup VNC on a remote Arm Linux machine.
34
+
This guide provides information about how to set up VNC on a remote Arm Linux machine.
35
35
36
-
Feel free to seek out additional VNC tutorials or add more information to this page.
37
-
38
-
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**.
36
+
This installation only works on newer versions of Ubuntu and Debian. It was successfully tested on Ubuntu 22.04 and Ubuntu 24.04.
39
37
40
38
## What is VNC?
41
39
42
-
VNC is a clientserver application. A VNC server runs on a remote machine. A VNC client runs on the local machine and connects to the remote server.
40
+
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.
43
41
44
42
### How do I install the VNC server and xfce4 desktop?
45
43
46
-
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/).
44
+
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/).
47
45
48
-
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.
46
+
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.
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.
62
+
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.
65
63
66
64
```console
67
65
vncpasswd
68
66
```
69
67
70
-
Remember the password for later when the client is connected.
68
+
Remember this password for later when you connect the client.
71
69
72
70
### How do I configure the desktop startup for VNC?
73
71
74
-
Create a file at `$HOME/.vnc/xstartup` with the contents:
72
+
Create a file at `$HOME/.vnc/xstartup` with the following contents:
75
73
76
74
```console
77
75
#!/bin/sh
78
76
unset SESSION_MANAGER
79
77
unset DBUS_SESSION_BUS_ADDRESS
80
78
exec startxfce4
81
79
```
82
-
Make sure the `xstartup` file has executable permission.
80
+
Make sure the `xstartup` file has executable permissions:
81
+
83
82
```console
84
83
chmod +x $HOME/.vnc/xstartup
85
84
```
86
85
87
86
### How do I set up a systemd service to manage VNC?
88
87
89
-
To create a systemd service to start the VNC server create the file `/etc/systemd/system/vncserver@.service`
88
+
To create a systemd service to start the VNC server, create the file `/etc/systemd/system/vncserver@.service`.
90
89
91
-
Use sudo or root as it is located in a read-only area.
92
-
```console
90
+
Use `sudo` or root privileges because this file is in a system directory.
91
+
92
+
If your username is not `ubuntu` change the `User` value to match your username after you create the new file.
93
+
94
+
```ini
93
95
[Unit]
94
96
Description=Remote desktop service (VNC)
95
97
After=syslog.target network.target
@@ -105,9 +107,9 @@ Use sudo or root as it is located in a read-only area.
105
107
106
108
[Install]
107
109
WantedBy=multi-user.target
110
+
```
108
111
109
-
```
110
-
The commands below are for any Linux distribution using `systemd`.
112
+
The following commands are for any Linux distribution that uses `systemd`.
### How do I use port forwarding via SSH to connect to VNC?
131
133
132
-
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.
134
+
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.
133
135
134
-
SSH to your remote Linux machine. Refer to[SSH](/install-guides/ssh/) for additional details.
136
+
SSH to your remote Linux machine. See[SSH](/install-guides/ssh/) for additional details.
135
137
136
-
Substitute your private key file and public IP address of the remote machine.
138
+
Substitute your private key file and the public IP address of the remote machine in the following command:
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.
144
+
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.
145
+
146
+
Open the VNC client and enter the following for the VNC server:
143
147
144
-
Open the VNC client and enter the following for the VNC server.
145
148
```console
146
149
localhost:5901
147
150
```
148
-
You will be prompted for the password created earlier with `vncpasswd`.
151
+
You will be prompted for the password you created earlier with `vncpasswd`.
149
152
150
-
A remote Linux Desktop should appear on your local computer. Make sure to close the VNC client first and then exit the SSH connection.
153
+
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.
Copy file name to clipboardExpand all lines: content/learning-paths/automotive/zenacssdebug/config.md
+13-5Lines changed: 13 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -46,19 +46,27 @@ Debug configurations are stored in a configuration database. Create a local data
46
46
- Open the same wizard (**File > New > Other**), then choose **Configuration Database > Model Configuration**.
47
47
- Click **Next**, select the **Configuration Database** you created, then click **Next**.
48
48
- For **Model Interface**, choose **Iris**, then click **Next**.
49
-
- Choose **Browse for model running on local host**. The debugger detects and interrogates the FVP.
49
+
- Choose **Browse for model running on local host**. Select your FVP and click **Finish**. The debugger detects and interrogates the FVP.
50
50
- If connecting remotely, choose **Connect to model running on either local or remote host** and provide the host and port.
51
51
52
+
{{% notice Tip %}}
53
+
The name of the FVP may be displayed as `RD_ASD` or other.
54
+
55
+
If unsure, use the port number to identify the correct FVP.
56
+
{{% /notice %}}
57
+
52
58
Arm Development Studio generates a `model.mdf` file that enumerates all CPUs in the FVP.
53
59
54
-
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.
60
+
Optionally, update **Manufacturer Name** (for example, `Arm`) and **Platform Name** (for example, `Zena_CSS_FVP`).
61
+
62
+
**Save** and **Import** the model into the configuration database.
55
63
56
64
{{% notice Tip %}}
57
-
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.
65
+
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.
66
+
67
+
For remote connections, confirm the host is reachable and the port is open.
58
68
{{% /notice %}}
59
69
60
70
A `model.mdf` file will be created that identifies all CPUs within the FVP.
61
71
62
-
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.
63
-
64
72
The debugger is now aware of the FVP and you are ready to debug.
@@ -41,12 +42,20 @@ Symbol loading is Exception Level–aware. If execution changes Exception Level,
41
42
42
43
## Debug the Linux kernel with OS awareness (symmetric multiprocessing)
43
44
44
-
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:
45
+
{{% notice Note %}}
46
+
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.
47
+
48
+
It will be supported in a future Development Studio version.
49
+
{{% /notice %}}
50
+
51
+
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.
52
+
53
+
Load the kernel symbols and set source mapping if your kernel sources are located outside the default paths:
set substitute-path "/usr/src/kernel/" "/arm-auto-solutions/build/tmp_baremetal/work-shared/fvp-rd-aspen/kernel-source/"
50
59
```
51
60
52
61
Run the FVP until the OS prompt appears.
@@ -73,7 +82,7 @@ You might see a warning like:
73
82
```text
74
83
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.
75
84
```
76
-
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.
85
+
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.
77
86
{{% /notice %}}
78
87
79
88
You have successfully learnt how to use Arm Development Studio to explore and debug the Arm Zena CSS Reference Software Stack.
0 commit comments