View source for Upgrade Instructions/1.3-release/zh-cn

<languages/>
{{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.}}
{{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 ===

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

{{file|name=/etc/ego.conf|body=
[global]

kits_depth = 20
}}

然后，运行以下命令：

{{console|body=
# ##i##rm -rf /var/git/meta-repo
# ##i##ego sync
}}

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 ===

In {{f|/etc/ego.conf}}, set the release to 1.3:

{{file|name=/etc/ego.conf|body=
[global]

release = 1.3
}}

然后，运行 {{c|ego sync}}：

{{console|body=
# ##i##ego sync
}}

=== Optionally Retarget Pure64 ===

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:

{{console|body=
# ##i##epro arch x86-64bit
##y##WARNING: Previous value: x86-64bit -- typically, user should not change this.

=== Enabled Profiles: ===

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

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

{{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}}.}}

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

{{console|body=
# ##i##emerge -C xorg-server
# ##i##emerge -aC $(qlist -IC x11-proto)
# ##i##emerge --oneshot x11-base/xorg-proto
}}
=== Relax Deps and Rebuild ===

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:

{{console|body=
# ##i##cd /var/db
# ##i##cp -a pkg /var/tmp/pkg.bak
# ##i##cd pkg
# ##i##find -iname RDEPEND -exec sed -i -e 's/\[abi_x86_32(-),abi_x86_64(-)]//g' {} \;
# ##i##find -iname RDEPEND -exec sed -i -e 's/,abi_x86_32(-),abi_x86_64(-)]/]/g' {} \;
}}

Any critical installed packages should no longer depend on ebuilds providing 32-bit ABIs.

Now, proceed to install the new gcc, remove the old one, and then upgrade glibc:

{{console|body=
# ##i##emerge -u1 gcc
# ##i##emerge -C =sys-devel/gcc-7.3.1*
# ##i##emerge -u1 glibc
}}

=== Perl Rebuild ===
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=
# ##i##emerge -v1 --nodeps dev-lang/perl
# ##i##perl-cleaner --all
}}

{{Note|Some systems may require {{c|perl-cleaner --reallyall}}}}

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

{{console|body=
# ##i##emerge -auDN @system --ignore-world
# ##i##emerge -auDN @world
}}

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:

{{console|body=
# ##i##emerge -av @preserved-rebuild
}}

{{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}}.}}

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
}}

=== Optionally Update Kernel ===

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

{{console|body=
# ##i##emerge -av debian-sources-lts
# ##i##ego boot update
}}

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.

{{Important|Remember to rebuild any necessary kernel modules!}}
This can be achieved with:
{{console|body=
# ##i##emerge -av @module-rebuild --exclude debian-sources-lts
}}
=== Reboot ===

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

{{console|body=
# ##i##reboot
}}


[[Category:Official Documentation]]
[[Category:Upgrade Instructions]]