Upgrade Instructions/1.4-release

From Funtoo
Jump to: navigation, search

The goal of these instructions is to provide Funtoo Linux users with a reliable, consistent set of instructions for upgrading Funtoo Linux from 1.3 to 1.4. Please assist in ensuring that these instructions are complete, make changes to the page that are needed to make these instructions 100% reliable, and if the instructions seem to not work properly, please consider opening a bug at https://bugs.funtoo.org or asking for assistance at https://forums.funtoo.org or #funtoo on freenode. Do not make major changes to this document without first opening a bug related to the issue so your changes can be reviewed. Thank you!

Set Release and Sync

Use your favorite editor in /etc/ego.conf, set the release to 1.4:


release = 1.4

Then, run ego sync:

root # ego sync

Set gfxcard mix-ins and VIDEO_CARDS

In Funtoo Linux 1.4, the VIDEO_CARDS make.conf setting has been updated and mix-ins have been created to allow you to easily choose common configurations. It is strongly recommended that you select your video hardware using Funtoo mix-ins, not VIDEO_CARDS directly, by choosing a mix-in from the following list:

Funtoo Graphics Mix-Ins

This mix-in enables all DRI-based Intel integrated graphics, including support for Vulkan and video acceleration where available. Do an emerge libva-intel-driver afterwards to ensure you have full video acceleration support.
This mix-in enables support for modern Radeon cards, including Vulkan and video acceleration where available.
Use this mix-in to enable support for older R100 and R200-series Radeon cards.
Use this to enable support for proprietary NVIDIA drivers. You will also need to emerge nvidia-kernel-modules, blacklist nouveau and add yourself to the video group. See this documentation for more details.
Use this mix-in to enable support for Open Source nouveau drivers.

Another important change for NVIDIA proprietary graphics users -- a new package nvidia-kernel-modules is now used to install the NVIDIA kernel modules. nvidia-drivers will only install the userland components. To emerge both, emerge nvidia-kernel-modules which will in turn pull in nvidia-drivers. This is set up this way because it is possible to set up an NVIDIA-accelerated container (see LXD/GPU Acceleration) that needs nvidia-drivers but not kernel modules.

Here is an example of how to add a mix-in to your profile:

root # epro mix-ins +gfxcard-nvidia

=== Enabled Profiles: === 

        arch: x86-64bit
       build: current
     subarch: intel64-westmere
      flavor: desktop
     mix-ins: mediaformat-gfx-common
     mix-ins: gfxcard-nvidia

>>> Set mix-in gfxcard-nvidia.
Updating profiles at /etc/portage/make.profile/parent...

Upgrade Toolchain

Funtoo 1.4, gcc has been updated to 9.1.1 series by default, so lets take advantage of that, and also update binutils and glibc. Note that multiple versions of gcc, 9.1.1 and 7.4.1, may get pulled in in while upgrading gcc. Only 9.1.1 is needed in Funtoo 1.4, so once 9.1.1 is installed, you may cancel the emerge of older versions of gcc to save time.

root # emerge -u1 gcc
root # emerge -u1 binutils
root # binutils-config -l
root # binutils-config 3 (or whatever number corresponds to version 2.32)
root # emerge -u1 glibc

World Update

At this point, you should be all set to perform a world update. We will exclude perl from upgrading now as we will do that near the end of the install.

root # emerge -auDN @world --jobs=3 --exclude dev-lang/perl

Perl Upgrade

We've saved the perl upgrade for now, so we would have a complete but old perl installation for the world upgrade. Now that things are upgraded, we can take care of perl, and rebuild all perl modules and perl-dependent things against the new perl:

root # emerge -u1 dev-lang/perl 
root # perl-cleaner --all

Finishing Steps

Remove python-3.6 as it will no longer be used:

root # emerge -C =dev-lang/python-3.6*
root # eselect python cleanup

If you are using debian-sources-lts, it has now been updated to 4.19.37_p6. Edit /etc/boot.conf as necessary and run ego boot update to ensure the new kernel is booted upon next system startup.

root # ego boot update

etc-update and Reboot

Before rebooting, it is a good idea to run etc-update to apply updates to any configuration files that require updating:

root # etc-update

Now, you should be able to reboot into Funtoo Linux 1.4:

root # reboot