QA:Testcase Power Management pm hibernate

Description

This test case tests hibernation via the pm-hibernate command.

This test case requires swap partition to be setup on host disk. Physical swap partition should work as well as swap on LVM/LUKS.

This test case will write and destroy data previously stored on your host swap. If running from live media this is quite hackish approach and something may go wrong. Making backups of your data before running this test case is highly recommended. If you want to be safe and don't like livesystem to write to your host disk, feel free to skip this test case.

Setup

1. Check that you have pm-utils installed:

   # rpm -q pm-utils

2. Check that the hibernate is supported on your platform:

   $ cat /sys/power/state

   If there is disk in the output, it signals that the hibernate is supported.

3. Check your swap:

   $ swapon -s

   You may see something like:

   Filename	      Type            Size    Used    Priority
   /dev/dm-2             partition       3997692 1856    -1

   If you are running from the live medium note the filename of the swap partition with the highest priority (/dev/dm-2 in this case). It will be your resume partition. You will need this filename later when resuming. It is not needed if running installed system.

4. Check your physical RAM size and swap size by:

   $ free

Your swap size should be your RAM size or more, otherwise the hibernation may fail. Even if your swap size is less than your RAM size the hibernation may work correctly (due to compression), but in case of failure please signal this in your report.

Troubleshooting

For cases you booted from the live medium and there is no active swap partition, but you have swap on the host disk LVM/LUKS (i.e. it wasn't detected) you may try to follow the steps bellow (you can combine them in cases you have e.g. LVM on LUKS, etc.). In case nothing helps feel free to skip this test case.

LVM

1. Scan for logical volumes:

   # vgscan --mknodes 
   # vgchange -a y
   # lvscan

2. Find your swap (e.g. /dev/vg0/swap) and activate it:

   # swapon /dev/vg0/swap

You may also boot with the following dracut parameters (hit Tab in the live media boot menu) that should do the same (e.g. swap on vg0/swap):

rd.lvm.vg=vg0 rd.lvm.lv=vg0/swap

LUKS

1. Unlock encrypted partition (e.g. /dev/sda2):

   # cryptsetup luksOpen /dev/sda2 crypt1

   Or if you know the UUID (it can be obtained by cryptsetup luksUUID /dev/sda2) you may use:

   # cryptsetup luksOpen UUID=luks-fa649b04-5ede-496f-9168-331161a2b833 crypt1

2. Activate swap:

   # swapon /dev/mapper/swap1

You may also boot with the following dracut parameters (hit Tab in the live media boot menu) that should do the same (only UUID is supported):

rd.luks.uuid=luks-fa649b04-5ede-496f-9168-331161a2b833 

How to test

1. Run the following command:

   # pm-hibernate

2. Wait for hibernation process to complete (it typically takes cca. 2-60 seconds).
3. Resume by hitting the power button.

   If you hibernated from the installed system it should work out of the box but if you hibernated from the live medium you may need to follow the following steps during the boot:

   1. Select boot from the live media.
   2. When the boot manager displays make sure the default option is selected (e.g. "Default" or "Start PM Test", the exact value depends on the medium/boot manager you are using) and edit the kernel boot parameters (mostly by hitting Tab).
   3. Append to the kernel boot parameters resume=/dev/dm-2 (replace /dev/dm-2 by your swap partition, it is the filename you previously noted during the setup) In case your resume partition is still not recognized you may try to add dracut boot parameters from troubleshooting.
   4. Boot (mostly by hitting Enter).

Expected Results

1. System correctly hibernates.
2. System correctly resumes.