Upgrade Instructions/1.4-release

   Important

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. Thank you!

Set Release and Sync

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

   /etc/ego.conf

[global]

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. If you have enabled the workstation or desktop profile, then Intel integrated graphics as well as Radeon graphics will be automatically enabled. To enable NVIDIA graphics, either proprietary or Open Source, you'll want to add either the gfxcard-nvidia or gfxcard-nouveau mix-in to your profile. See make.conf/VIDEO_CARDS for more information on these changes.

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 safely 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:

root # emerge -auDN @world --jobs=3

Upgrade Perl

Perl has been updated to 5.28, and it is good to update this next:

root # emerge dev-lang/perl --jobs=3
root # perl-cleaner --all

Finishing Steps

The default Python interpreter in 1.4 is now 3.7, and you will want to set it to be the default python3 interpreter, remove python 3.6, and then perform a preserved-rebuild to rebuild any python modules to no longer include 3.6 support now that it is no longer installed:

root # eselect python set --python3 python3.7
root # emerge -C =dev-lang/python-3.6*
root # emerge @preserved-rebuild

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

Enjoy!