Changes

Jump to: navigation, search

Upgrade Instructions/1.3-release

442 bytes added, 9 months ago
Marked this version for translation
{{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!}}
=== Prior to 1.3 ===<!--T:8-->
<!--T:9-->
Prior to upgrading to 1.3, you will need to perform an {{c|ego sync}} under 1.2. If you encounter errors with {{c|ego sync}} not completing successfully on {{c|xorg-kit}} or {{c|gnome-kit}}, perform the following steps to correct your tree. First, add the following to {{f|/etc/ego.conf}}:
<!--T:10-->
{{file|name=/etc/ego.conf|body=
[global]
<!--T:11-->
kits_depth = 20
}}
<!--T:12-->
Then, run the following commands:
<!--T:13-->
{{console|body=
# ##i##rm -rf /var/git/meta-repo
}}
<!--T:14-->
Now, make sure you have {{c|ego 2.7.2}} or later installed, as this will be required to start the upgrade process.
=== Set Release and Sync ===<!--T:15-->
<!--T:16-->
In {{f|/etc/ego.conf}}, set the release to 1.3:
<!--T:17-->
{{file|name=/etc/ego.conf|body=
[global]
<!--T:18-->
release = 1.3
}}
<!--T:19-->
Then, run {{c|ego sync}}:
<!--T:2-->
{{console|body=
# ##i##ego sync
}}
<!--T:2-->
=== Optionally Retarget Pure64 ===<!--T:20-->
<!--T:21-->
If you are running a {{c|pure64}} build of Funtoo Linux, you will need to run the following command to update your {{f|/etc/portage/make.profile/parent}} file to no longer reference the {{c|pure64}} arch profile, as it has been deprecated.
Run the following command:
<!--T:22-->
{{console|body=
# ##i##epro arch x86-64bit
##y##WARNING: Previous value: x86-64bit -- typically, user should not change this.
=== Enabled Profiles: ===<!--T:23-->
<!--T:24-->arch: ##c##x86-64bit
build: ##c##current
subarch: ##c##intel64-westmere
mix-ins: ##c##mediaformat-gfx-extra
<!--T:25-->
>>> Set arch to x86-64bit.
Updating profiles at /etc/portage/make.profile/parent...
}}
<!--T:3-->
{{Note|You may also need to update {{c|subarch}} using a similar set of arguments to {{c|epro}}, e.g. from {{c|intel64-westmere-pure64}} to {{c|intel64-westmere}}.}}
<!--T:3-->
=== Optionally Remove Xorg-Server ===<!--T:26-->
<!--T:27-->
1.3-release contains a completely reworked xorg-server, and as such, it is best to ''remove'' your old xorg-server prior to updating:
# ##i##emerge --oneshot x11-base/xorg-proto
}}
=== Relax Deps and Rebuild === <!--T:4-->=== Relax Deps and Rebuild ===
<!--T:28-->
Before upgrading, it is a good idea to perform the following commands to relax any existing 32-bit ABI deps so that installed packages don't block necessary updates. Be sure to back up {{f|/var/db/pkg}}, as included in the instructions below, and specify the {{c|find}} commands below exactly -- best to copy and paste:
<!--T:29-->
{{console|body=
# ##i##cd /var/db
}}
<!--T:30-->
Any critical installed packages should no longer depend on ebuilds providing 32-bit ABIs.
<!--T:31-->
Now, proceed to install the new gcc, remove the old one, and then upgrade glibc:
<!--T:32-->
{{console|body=
# ##i##emerge -u1 gcc
}}
=== Perl Rebuild ===<!--T:33-->
With 1.3-release {{c|dev-lang/perl}} updated from 5.24 to 5.26 version. It is necessary to rebuild perl modules installed with such major version update, which can be done with:
{{console|body=
}}
<!--T:34-->
{{Note|Some systems may require {{c|perl-cleaner --reallyall}}}}
<!--T:35-->
Now, you are ready to proceed with a full system and world update:
<!--T:36-->
{{console|body=
# ##i##emerge -auDN @system --ignore-world
}}
<!--T:37-->
Now, it should be possible to rebuild any necessary packages to get rid of preserved libraries, paying particular attention to any old versions of glibc:
<!--T:38-->
{{console|body=
# ##i##emerge -av @preserved-rebuild
}}
<!--T:5-->
{{Important|It appears that {{c|dev-lang/go}} will keep rebuilding against a preserved 32-bit glibc, so to fully remove multilib on a system that has {{c|dev-lang/go}} installed, you will need to perform the following steps: {{c|emerge -C dev-lang/go; emerge dev-lang/go}}.}}
<!--T:5-->
<!--T:6-->
Now, after update and rebuild you will want to either run {{c|etc-update}} or {{c|dispatch-conf}} to perform changes to the configuration files that may happen with ebuild updates:
{{console|body=
# ##i##etc-update
}}
<!--T:6-->
=== Optionally Update Kernel ===<!--T:39-->
<!--T:40-->
If you were not using {{c|debian-sources-lts}} before, you may want to upgrade to this kernel. Do this as follows:
<!--T:41-->
{{console|body=
# ##i##emerge -av debian-sources-lts
}}
<!--T:42-->
Depending on your {{f|/etc/boot.conf}} settings, you may need to tweak the file in order to have {{c|debian-sources-lts}} selected by default.
# ##i##emerge -av @module-rebuild --exclude debian-sources-lts
}}
=== Reboot === <!--T:7-->=== Reboot ===
<!--T:43-->
At this point, we recommend rebooting the system to ensure you are running in the new environment:
<!--T:44-->
{{console|body=
# ##i##reboot
Bureaucrats, Administrators, wiki-admins, wiki-staff
6,258
edits

Navigation menu