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 and guide users through any potential complications. Since this is a wiki, make changes to the page that are needed to make these instructions 100% reliable. 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.x series by default, so lets take advantage of that.

root # emerge -u1 gcc
root # emerge -u1 binutils
root # emerge -u1 glibc

Now, you are ready to proceed with a full world update:

root # emerge -auDN @world

Finishing Steps

The default Python interpreter in 1.4 is now 3.7, we need to select it:

root # eselect python set python3.7

Perl has been upgraded from 5.26.0 to 5.28.0. Most modules should have been upgraded and cleaned, but lets make sure by running perl-cleaner.

root # perl-cleaner --all

If your kernel was upgraded you may want to run boot update.

root # ego boot update

THATS IT PLEASE ENJOY :)