From Mageia wiki
Jump to: navigation, search
(Before doing the upgrade)
(How to do an upgrade)
Line 27: Line 27:
 
===Via mgaapplet===
 
===Via mgaapplet===
  
:* Now that https://releases.mageia.org/api has been updated,
+
:* When https://releases.mageia.org/api has been set to allow testing upgrades, in a fully
in a fully up-to-date Mageia 6 system, as a regular user open
+
up-to-date current Mageia system, as a regular user open
 
a terminal, and run the following commands ...
 
a terminal, and run the following commands ...
  

Revision as of 22:30, 18 January 2021


Drakconf multiflag.png
Other languages
Deutsch ; English ; français ;

What is an upgrade?

Upgrading should not be confused with updating. Updates are updated packages which are installed in the existing release from the existing update media, for example updating Firefox 10.0.4 in 'Core Release' to Firefox 10.0.5 from 'Core Updates'.


An upgrade 'updates' the entire release to a whole new release. It is the process of moving from Mageia 6 to Mageia 7 etc.


This procedure explains how to perform the upgrade and how to check if it's successful. Commands are shown in Italic text. Wherever you see a command beginning with # it should be used as root and if it begins with $ it should be used as a normal user. You will notice these two symbols in your terminal.


Please open a separate bug for each problem encountered.

Before doing the upgrade

  • check that you have a well configured desktop (email, bookmarks, wallpaper…)
  • close all open applications, including any running in the background in the notification area
  • back up all your important data
  • use a test computer if possible or a virtual machine
  • back up your /home/$USER so it can be restored if needed
  • ensure any screen lockers have been disabled

How to do an upgrade

Via mgaapplet

up-to-date current Mageia system, as a regular user open a terminal, and run the following commands ...

  • $ killall mgaapplet
  • $ mgaapplet --testing

Via a Mageia DVD

  • download the Classic install DVD .iso from your favourite mirror
  • check the downloaded ISO with md5sum path/to/my-iso.iso
  • burn it on a DVD or DVD-RW at low speed, or to USB using Isodumper
  • make a list of your hardware setup # lspcidrake -v > /home/$USER/lspcidrake.before
  • now you can close the terminal and reboot your computer
  • check in your BIOS that your computer will boot from the DVD or USB
  • launch the installation and choose 'Upgrade'


At the end of the process, please do an update to have the latest packages and bug fixes both with the installer during the last steps of the upgrade and after the reboot.

In a root terminal # urpmi --auto-update

Via a Mageia mirror

  • choose a mirror near you from http://mirrors.mageia.org/ and remember the URL
  • open a TTY, log in as root (eg. CTRL + ALT + F2, then log in as root)
    and follow the steps below:
    1. stop the Desktop Manager service with service dm stop
    2. make a list of your hardware setup # lspcidrake -v > /home/$USER/lspcidrake.before
    3. remove all your existing media urpmi.removemedia -a
    4. add the media for the new release from the mirror you chose as:

      urpmi.addmedia --distrib $PROTOCOL://path/to/Mageia/$ARCH

      eg.

      urpmi.addmedia --distrib http://ftp.belnet.be/mirror/mageia/distrib/7/x86_64

    5. perform the upgrade and keep a debug log in case errors occur:
      urpmi --debug --bug /root/log --replacefiles --auto-update --auto


Warning Icon.png The upgrade has to be done on a TTY and not under X, don't attempt to do it in a normal terminal
Warning Icon.png Using a local mirror will prevent you having hdlists changing X times during the upgrade
Warning Icon.png Don't forget to plug in the AC adapter if you are working on a laptop

What to check

Once the upgrade process is finished, you can check a few things:


before rebooting
  • the upgrade finished without any issues in the terminal
  • # cat /etc/mageia-release displays the proper Mageia release
  • # cat /etc/product.id displays the proper information
  • # less /root/log/ search for the keyword error and report any error messages as a bug.


while rebooting
  • the bootsplash has been updated
  • the gfxboot theme has been updated
  • the gfxboot entries have been updated
  • the desktop manager has been updated


after reboot
  • log into your favourite desktop and open a terminal
  • check that you still have your
  • mail client well configured and installed
  • web browser installed and well configured with all your bookmarks
  • favourite wallpaper
  • ensure # uname -r displays the new Mageia kernel
  • check that # urpme --auto-orphans won't remove any important/needed packages
  • check that important packages are still on your system and up to date:
  • $ rpm -qa | grep kernel.*latest (must display the version of the package installed)
  • $ rpm -qa | grep msec (must display the version of the package installed)
  • # lspcidrake -v > /home/$USER/lspcidrake.after
  • compare both lspcidrake files and check that there is no regression in hardware modules
  • check that all peripherals are still working as well as they did before the upgrade
  • if you have dkms modules, check with # dkms status that they are built and still available
  • if you were using dmraid, check that you still have it with # lsmod | grep dmraid
  • check that you still have a network connection
  • by browsing the Internet
  • # ping -c 10 -I [ethX/wlanX] free.fr
  • check network interfaces with # ifconfig
  • check that you still have sound with $ aplay /usr/share/sounds/*.wav
  • check your X configuration with $ xrandr and launch $ reflect
  • open Mageia Control Center and check that everything is working
  • check with # lsusb that when you plug in a USB stick it is detected
  • in case of any hardware problems refer to QA_process_for_testing_installations#Checking hardware
Testing sysvinit-legacy
  • Install the package sysvinit-legacy (removes systemd)
  • Rebuild the initramfs with
  • # mkinitrd -f /boot/initrd-$(uname -r) $(uname -r)
  • Reboot and ensure services such as ntpd are running

Well done, you did it!


Now, if this was an upgrade from Mandriva 2010 to Mageia 1, check for any Mandriva packages still waiting to be imported into Mageia and report them on Bugzilla

$ rpm -qa | grep mdv

Return to the QA portal