== 24.04 == The followings are the test plans for testing gnome-initial-setup. === First Boot Initialization === This test case is intended for OEM or pre-bootstrapped image such as Raspberry Pi image, where the account setup is after the installation. ==== Prepare and launch ==== '''Do not use a production system to run this test!''' To test this behavior, we need a system that has no user account created, that means all users needs to be deleted for the test. To delete current user, first we have to set up password for root: {{{ sudo passwd }}} Then log out current user, switch to text terminal by Ctrl-Alt-F3, login as root, then: {{{ deluser --remove-home [username] systemctl reboot }}} If `deluser` failed, ensure the user is not logged in, wait and try again. ==== Page 1: Welcome (locale selection) ==== * A page with Ubuntu logo on top, a rotating ''Welcome'' and its translations below the logo, a search bar for the locales, and list of common languages on the bottom should be shown, and an option of vertical ellipsis (⋮) on the bottom, which can be expanded to more available languages. * Click on the locale to switch between languages, and the language for the ''Next'' button should change. Try it for a couple more times to see whether it would crash. * Remember what you selected and click ''Next''. ==== Page 2: Typing ==== * Offers a list of available keyboard layouts and a search bar for the keyboard layouts. An option of vertical ellipsis (⋮) is on the bottom, which can be expanded to more available keyboard layouts. * Select a different keyboard layout, remember what you selected. * Click ''Preview'' next to it will show a window of the selected keyboard layout. * Click ''Next''. ==== Page 3: EULA ==== EULA page (as a requirement for OEM systems) needs extra files installed in the system. This page will be skipped if PDF files under the paths denoted below are not available. * If there is a locale-bound EULA file available at `/usr/share/desktop-provision/eula/EULA_[locale].pdf`, a localized EULA page should be displayed. * If the above is not available, but there is a file `/usr/share/desktop-provision/eula/EULA.pdf`, there will be a EULA page displayed. * If no, this page would be skipped entirely. * The top-right button should be ''Accept''. If the EULA is shown, click the button to continue. ==== Page 4: Network (Wi-Fi) ==== If the system does not have any Wi-Fi interface, this page will be skipped. * A list of Wi-Fi access points are listed. If the one you can connect is available, select one and enter passphrase, and see whether it can be connected. * Click ''Next'', or ''Skip'' if not connecting to an access point. ==== Page 5: Time Zone ==== * A map and a search bar for the cities are available. * Note that, if no city is selected, ''Next'' button should be greyed out. * Type a city name into the search bar, select one and hit Enter, the correlated city (might not be the same you selected, but has the same timezone) should be pinned, with city name and timezone information annotated. * Click ''Next''. ==== Page 6: About You (account creation) ==== * Text fields to input ''Full name'', ''Username'', and ''Computer'' are available, and a button to change user icon. * Click the edit button besides user avatar, a grid of stock photos should be shown. Click the image to change the photo. * Type a name into ''Full Name'', the username and computer name should be changed to a lowercase of the Full Name, unless it does not begin with a letter. * Change Username so it begins with a number, there should be an error ''The username must start with a lower case letter from a-z.'' * Change Username so it includes special characters (like +), there should be an error ''The username should only consist of lower case letters from a-z, digits, and the following characters: - _'' * Change Computer (name) so it begins with a number, it should be allowed. * Change Computer (name) so it includes special characters (like +), there should be an error ''The hostname should only consist of lower case letters from a-z, digits and a hyphen: -'' There is a known issue that the computer name cannot be the existing name this system was set to, which will give out an error denoting the name is used on the network. This issue can be ignored. Please change the name to continue. * If any of the settings do not pass, the ''Next'' button should be greyed out. * Set the above settings to a passing combination, and click ''Next''. ==== Page 7: Password ==== * Two password input with a security indicator should be shown. * Type the password on the first field. * Click the eye on the right side of the input, it should show the password you typed. * The security indicator should show the strength of the password you typed. * Type a different password on the second field. A message should appear ''The passwords do not match'', and the ''Next'' button should be greyed out. * Type the same password on the second field, and click ''Next'' to continue. ==== Page 8: Setup Complete ==== * Click ''Start Using Ubuntu'', which should lead user to the desktop, and immediately lead to Desktop Welcome window. ==== Check the settings ==== * Open ''Settings'' (gnome-control-center), and check the followings: * Go to ''System'' -> ''Region & Language'', under ''Your Account'', the selected language and formats are correct. * Go to ''System'' -> ''Date & Time'', check the timezone is correct. * Go to ''System'' -> ''Users'', the selected user icon and the name and the selected language are correct. * Go to ''Keyboard'', check ''Input Sources'', the selected keyboard layout is used. * Go to ''Wi-Fi'', the access point is connected (if available and selected). * Logout and login with the password you set, you should be able to login with the password. === Desktop Welcome === This is displayed on the first user entering desktop environment, in order to setup Ubuntu Pro, asking user about telemetry, and introduce user to the Store. ==== Prepare and launch ==== {{{ sudo ua detach --assume-yes XDG_CURRENT_DESKTOP=ubuntu /usr/libexec/gnome-initial-setup --existing-user }}} ==== Page 1, welcome ==== * A welcome page stating the Ubuntu version and showing its mascot. * Clicking show changelog opens a browser with the release notes of corresponding distribution. * Click ''next''. ==== Page 2, offers Pro ==== * Offers Ubuntu Pro, by default ''skip for now'' is selected. * Disconnect from the Internet, the first radio button must become gray and insensitive; A warning message tells you that an Internet connection is required for that option. Connect to the Internet. * Click ''next'' and, on the next page, that is not an Ubuntu Pro page, click ''previous''. You are now back to the Ubuntu Pro page. * Click the ''enable Ubuntu Pro'' radio button and ''next''. ==== Page 3, attach to Pro ==== Make sure /usr/lib/policykit-1-gnome/polkit-gnome-authentication-agent-1 is running. * Choose ''add token manually'' and type a character in the box, observe that ''next'' lights up. Click it. An authentication box shows up asking for password, you give it and the program says invalid token. * Choose ''attach machine via Ubuntu One account'', ''next'' becomes insensitive. Do as instructed and observe that eventually "valid token" appears and ''next'' lights up. Click ''next'' and maybe the authentication box shows up (depends on whether the timeout from the previous authentication has elapsed), in which case you give your password and it starts attaching. While the operation is not complete a spinner spins. Once complete, the program jumps to the next page ==== Page 4, Pro service list ==== * Your contract information is shown, with your subscription, your enabled services and available services, which match the information from {{{ua status}}}. * ''Previous'' takes you back to page 3, whose elements are insensitive with the exception of the header bar buttons, which also work as expected (i.e. takes you to pages 2 and 4). Go back to page 4 and click ''next''. ==== Page 5, telemetry ==== * Explains that submitting your data helps improve Ubuntu. * Click ''show the first report''. A transient window appears with the contents of the to-be-sent report. Close it. * Click ''legal notice''. https://ubuntu.com/legal/systems-information-notice (or equivalent) opens in your browser. Use {{{rm -rf $HOME/ubuntu-report}}} lest nothing is done in the next step because you already performed it in the past. * Whatever the option you choose, the page should advance immediately upon ''next''. ==== Page 6, software ==== * Tells you about App Center, where more applications can be installed. A picture with App Center's and other programs' logos is in the center of the page. If snap-store is not installed, do it: {{{snap install snap-store}}}. * Click ''open App Center'', App Center opens. ---- CategoryDesktopTestPlans