Upgrade Instructions/1.3-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.2 to 1.3. 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

In /etc/ego.conf, set the release to 1.3:

   /etc/ego.conf

[global]

release = 1.3

Then, run ego sync:

root # ego sync

Optionally Remove Xorg-Server

1.3-release contains a completely reworked xorg-server, and as such, it is best to remove your old xorg-server prior to updating:

root # emerge -C xorg-server

Optionally Retarget Pure64

If you are running a pure64 build of Funtoo Linux, you will need to run the following command to update your /etc/portage/make.profile/parent file to no longer reference the pure64 arch profile, as it has been deprecated. Run the following command:

root # epro arch x86-64bit
root ##y##WARNING: Previous value: x86-64bit -- typically, user should not change this.

=== Enabled Profiles: ===

        arch: x86-64bit
       build: current
     subarch: intel64-westmere
      flavor: core
     mix-ins: mediaformat-gfx-common
     mix-ins: mediaformat-gfx-extra

>>> Set arch to x86-64bit.
Updating profiles at /etc/portage/make.profile/parent...

Update World

Now, proceed to perform a system upgrade followed by a world upgrade:

root # emerge -auDN @system
root # emerge -auDN @world

   Warning

Upgrading to 1.3 will remove any 32-bit compatibility on your system, as we have deprecated multilib support! Please be aware of this before starting the upgrade process.

Optionally Update Kernel

If you were not using debian-sources-lts before, you may want to upgrade to this kernel. Do this as follows:

root # emerge -av debian-sources-lts
root # ego boot update

Depending on your /etc/boot.conf settings, you may need to tweak the file in order to have debian-sources-lts selected by default.

   Important

Remember to rebuild any necessary kernel modules!

This can be achieved with:

root # emerge -av @module-rebuild

Reboot

At this point, we recommend rebooting the system to ensure you are running in the new environment:

root # reboot