QA:Testcase Anaconda User Interface serial console

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(add 'serial' option, it's needed for anaconda)
(change instructions to use virtualization, which is much more accessible)
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{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=X serial'' parameters are 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 serial</code> boot options to the default boot menu item. Don't boot it yet.
# Boot installation program passing the ''console=ttyS0 serial'' command line parameters
+
# 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]]

Revision as of 12:54, 8 November 2012

Contents

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 serial 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.