RemoteDesktop

Below are the test cases that should be run when gnome-remote-desktop is updated to new major releases in the development version of Ubuntu. These should also be run for any gnome-remote-desktop Stable Release Update.

If the fdk-aac MIR is approved, the new Audio Forwarding test case should be run for any new major releases of fdk-aac or Stable Release Update of fdk-aac.

Basic RDP Test Case

  1. Install all updates. Log out and log back in.
  2. Open the Settings app to the Sharing page. Turn on Sharing and turn on Remote Desktop Sharing.
  3. From a second computer, open Remmina.

The Remote Desktop page on the first computer provides the username and password to use. It also shows the computer name. If you want to use your IP address instead, you can find it with ip a or in the Settings app > Wifi > gear button. If you are connected via Ethernet, use the Network page instead of the Wifi page.

  1. Change the protocol to RDP in the address bar. Fill in the first computer's name or IP address and press Enter. On many network's you need to add a .local suffix to the computer's name for it to work.
  2. On the next screen, fill in your username and password. On the first computer you can click the Show Text button to see the password. (A password is automatically assigned but it can be changed.)
  3. Ensure that the connection works.

Basic Remote Login Test Case (For Ubuntu 24.04 LTS and later only)

  1. Install all updates. Log out and log back in.
  2. Open the Settings app to the System page. Click Remote Desktop. Click Remote Login.
  3. Unlock the page.
  4. Turn on Remote Login.
  5. Create a username and password. This is not a real user but only authentication for remote clients to be able to access the login screen.
  6. Log out.
  7. From a second computer, open Remmina.
  8. Change the protocol to RDP in the address bar. Fill in the first computer's name or IP address and press Enter. On many network's you need to add a .local suffix to the computer's name for it to work.
  9. On the next screen, fill in the username and password from the Remote Login screen.
  10. You should now see the login screen.
  11. Log in to one of the accounts. Login should complete successfully and you should be able to use the Ubuntu Desktop. On the first computer, the login screen should still be showing.

Note that Remote Login requires working Wayland.

Basic VNC Test Case (For Ubuntu 22.04 LTS only)

  1. Do the Basic RDP Test Case but this time also enable the Legacy VNC option on the Remote Desktop Sharing page.
  2. In Remmina, change the protocol to VNC, fill in the first computer's name or IP address and press Enter.
  3. Ensure that the connection works.

Note: The VNC feature was removed from Ubuntu 22.10 so this test case is only for Ubuntu 22.04 LTS.

New Audio Forwarding Feature

A new audio forwarding feature was added to gnome-remote-desktop 43. This feature has not been enabled in Ubuntu yet so this test case will not work yet. The Main Inclusion bug is https://launchpad.net/bugs/1977614

Prerequisites

  1. From the gnome-remote-desktop 43 packaging, remove -Dfdk_aac=false from debian/rules
  2. In debian/control and debian/control.in, uncomment libfdk-aac-dev from the list of Build-Depends
  3. Build the package.
  4. Install your updated gnome-remote-desktop package

Audio Forwarding Test Case

  1. Install all updates. Log out and log back in.
  2. Open the Settings app to the Sharing page. Turn on Sharing and turn on Remote Desktop Sharing.
  3. From a second computer running Windows 10 or Windows 11, open the Remote Desktop Connection app.
  4. Enter your first computer's name or IP Address in the Computer field and click Connect
  5. It may take several moments for the next screen to load.
  6. On the "Enter your credentials screen", click "More Choices". Then click "Use a different account"
  7. Enter the username and password
  8. You may be prompted to accept the security certificate with a warning that the identify of the remote computer cannot be verified. Click Yes to proceed.
  9. You should be able to view the remote desktop now.
  10. Open an audio file. Play the file. You should hear the audio on both computers.
  11. If you don't hear audio on the Windows computer, you can also check the settings. Disconnect. From the Remote Desktop Connection dialog, click "Show Options". Switch to the "Local Resources" tab, then click Remote audio settings. Verify that "Play on this computer" is selected.
  12. If you mute the first computer, the remote audio on the second computer will also be muted. If you lower the volume on the first computer, the remote audio on the second computer will also be lowered.
  13. Currently, this feature isn't supported in Remmina. More investigation is needed. One suggestion was that it might require freerdp to be built against ffmpeg. But ffmpeg is in universe. Alternatively, it may be possible to get this feature working with the Remmina snap. Meanwhile, this test case uses Windows as the client connection.

What Could Go Wrong

RDP Sharing is a new feature for Ubuntu 22.04 LTS as part of GNOME 42. (Previously only VNC Sharing was offered.)

RDP Sharing can be used for providing remote support so it's important that this feature works well because it may be difficult for the remote admin to fix issues in person.

gnome-remote-desktop is part of GNOME Core and falls under the GNOME Stable Release Update microrelease exception.

CategoryDesktopTestPlans

DesktopTeam/TestPlans/RemoteDesktop (last edited 2024-04-15 12:17:38 by jbicha)