From Fedora Project Wiki

(Updated guidance for using systemd)
(adjust associated_release_criterion template invocation)
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Template:Associated_release_criterion|Beta|installation-interfaces}}
{{QA/Test_Case
{{QA/Test_Case
|description=
|description=This is to verify that [[Anaconda]] installation works over a serial console and the installed system uses it as well. Because computers with serial ports are very scarce today, this test case will describe testing in a [[Virtualization|virtualized environment]], where we can easily emulate that. However, if you have a bare-metal hardware that support serial connections, you can use it instead.
This test is intended to ensure that the console= parameter is honored and the post-installed systems is configured properly for a non tty0 console. While the examples mention the use of ''console=ttyS0'', it it acceptable to use any device other than the default ''tty0''.
|setup=
{{Admon/note|Serial Cable?| This test case may require using a DB-9 serial cable to connect to the system under test.   Additionally, you may be required to update the BIOS to enable the serial port.}}
# Install a virtualization software that supports serial console emulation. The following instructions are related to {{package|virt-manager}}.
{{Admon/tip|Go Virtual|Since the focus of this test is not to validate the physical DB-9 serial cable connection, or to ensure the cables are seated properly, it is entirely acceptable (and ''encouraged'') to use [[Virtualization]]. For example, creating any KVM/QEMU virtual guest with the correct ''console{{=}}ttyS0 serial'' will setup a serial console for use with this test.}}
# Prepare any non-live installation media (anything except {{filename|Live.iso}}).
# Prepare a virtual machine in virt-manager and attach the installation media, but don't start it yet.
|actions=
|actions=
# Using a DB-9 serial cable, connect to your test system on the first port (typically S0) and start a serial port monitoring application (ttywatch, cermit, or minicom)
# Start the virtual machine and add <code>console=ttyS0</code> boot options to the default boot menu item. Don't boot it yet.
# Boot installation program passing the console=ttyS0 command line parameter
# On your host system switch to a terminal and connect to the serial console of your virtual machine: <pre># virsh console <machine_name></pre>
# Complete installation and boot into installed system
# Switch back to the virtual machine and boot the installer.
# Proceed with installation.
# After the installation is complete and the system is restarted, make sure you are still connected to the serial console in the terminal and boot the new system.
|results=
|results=
<ol>
# The boot messages are printed to the serial console.
<li> The installation displays properly and responds to user input over the serial line </li>
# The installer is started in a text mode on the serial console.
<li> Confirm that a login console is presented over the serial device. When using {{package|systemd}} (Fedora 15 and newer), you may confirm that the serial device is configured for login by examining the output of {{command|systemctl status serial-getty@ttyS0.service}}.  For example:
# The installer is displayed properly and responds to user input properly.
<pre>
# The installed system displays [[GRUB]] boot menu to the serial console.
  Loaded: loaded (/lib/systemd/system/serial-getty@.service)
# The installed system prints boot messages to the serial console.
  Active: active (running) since Tue, 01 Mar 2011 12:46:54 -0500; 4min 29s ago
# The installed system present a working login prompt to the serial console.
Main PID: 736 (login)
#* If this doesn't work, please attach output from {{command|systemctl status serial-getty@ttyS0.service}} command and {{filename|/etc/securetty}} file into the bug report.
  CGroup: name=systemd:/system/serial-getty@.service/ttyS0
</pre>
When using {{package|upstart}} (from Fedora 9 to Fedora 14), you may confirm that the serial device is configured for login by examining the output of {{command|initctl status serial DEV{{=}}ttyS0}}.  For example:
<pre>serial (ttyS0) start/running, process 1210</pre>
</li>
<li> The file {{filename|/etc/securetty}} contains a line matching the requested console and the user is able to login to the system using the serial login prompt
</ol>
}}
}}
[[Category:User Interface]]
[[Category:User Interface]]

Latest revision as of 20:31, 30 July 2013

Note.png
Associated release criterion
This test case is associated with the Fedora_41_Beta_Release_Criteria#installation-interfaces release criterion. If you are doing release validation testing, a failure of this test case may be a breach of that release criterion. If so, please file a bug and nominate it as blocking the appropriate milestone, using the blocker bug nomination page.


Description

This is to verify that Anaconda installation works over a serial console and the installed system uses it as well. Because computers with serial ports are very scarce today, this test case will describe testing in a virtualized environment, where we can easily emulate that. However, if you have a bare-metal hardware that support serial connections, you can use it instead.

Setup

  1. Install a virtualization software that supports serial console emulation. The following instructions are related to Package-x-generic-16.pngvirt-manager.
  2. Prepare any non-live installation media (anything except Live.iso).
  3. Prepare a virtual machine in virt-manager and attach the installation media, but don't start it yet.

How to test

  1. Start the virtual machine and add console=ttyS0 boot options to the default boot menu item. Don't boot it yet.
  2. On your host system switch to a terminal and connect to the serial console of your virtual machine: 
    # virsh console <machine_name>
  3. Switch back to the virtual machine and boot the installer.
  4. Proceed with installation.
  5. After the installation is complete and the system is restarted, make sure you are still connected to the serial console in the terminal and boot the new system.

Expected Results

  1. The boot messages are printed to the serial console.
  2. The installer is started in a text mode on the serial console.
  3. The installer is displayed properly and responds to user input properly.
  4. The installed system displays GRUB boot menu to the serial console.
  5. The installed system prints boot messages to the serial console.
  6. The installed system present a working login prompt to the serial console.
    • If this doesn't work, please attach output from systemctl status serial-getty@ttyS0.service command and /etc/securetty file into the bug report.
Retrieved from "https://fedoraproject.org/w/index.php?title=QA:Testcase_Anaconda_User_Interface_serial_console&oldid=347343"