diff options
Diffstat (limited to 'profiles/default/linux/amd64/17.0/desktop/deprecated')
| -rw-r--r-- | profiles/default/linux/amd64/17.0/desktop/deprecated | 45 |
1 files changed, 33 insertions, 12 deletions
diff --git a/profiles/default/linux/amd64/17.0/desktop/deprecated b/profiles/default/linux/amd64/17.0/desktop/deprecated index b726cb19ea7a..90bb574cd748 100644 --- a/profiles/default/linux/amd64/17.0/desktop/deprecated +++ b/profiles/default/linux/amd64/17.0/desktop/deprecated @@ -1,53 +1,73 @@ default/linux/amd64/17.1/desktop The amd64 17.1 profiles switch to a more standard 'no SYMLINK_LIB' -multilib layout, and require an explicit migration. -The migration is performed using the app-portage/unsymlink-lib tool. +multilib layout, and require an explicit migration. The migration is +performed using the app-portage/unsymlink-lib tool. + +Read the Gentoo news item [2] for more information! + The following steps can be used to upgrade your system: 1. Sync and upgrade your system to the newest package versions to reduce the risk of issues. -2. Install the tool: +2. If you are still running a 13.0 profile, select gcc 6.4.0 or later + as the system compiler, source /etc/profile and reinstall libtool: + + # gcc-config -l + [1] x86_64-pc-linux-gnu-5.5.0 * + [2] x86_64-pc-linux-gnu-8.3.0 + # gcc-config 2 + # . /etc/profile + # emerge -1v libtool + +3. Install the tool: # emerge -1v app-portage/unsymlink-lib -3. Run 'unsymlink-lib --analyze' and check the output for obvious +4. Run 'unsymlink-lib --analyze' and check the output for obvious mistakes. If you need to perform any changes to the system, remember to run 'unsymlink-lib --analyze' again afterwards. [past this point do not call emerge or modify /usr manually] -4. This is a very good time to make a backup. +5. This is a very good time to make a backup. -5. Run 'unsymlink-lib --migrate'. You can add '--pretend' first to see +6. Run 'unsymlink-lib --migrate'. You can add '--pretend' first to see what is going to happen. -6. Reboot your system. Check if important programs work. +7. Reboot your system. Check if important programs work. In particular, verify that e.g. 'emerge --info' works (but do not install anything). If you hit any serious problems, you can use 'unsymlink-lib --rollback' to revert the changes and return to step 3. -7. Run 'unsymlink-lib --finish'. You can add '--pretend' first to see +8. Run 'unsymlink-lib --finish'. You can add '--pretend' first to see what is going to happen but note that you're going to see a very long list of files to remove. -8. Switch the profile, e.g.: +9. Switch the profile, e.g.: # eselect profile set default/linux/amd64/17.1/desktop [at this point you can start using emerge again. emerge will then not display this message anymore, but the remaining steps are still required!] -9. Rebuild gcc: +10. Rebuild the toolchain: # emerge -1v sys-devel/gcc:9.3.0 [ repeat for other slots you will be using ] + [ if you are upgrading from 13.0 profile, also: ] + # emerge -1v sys-devel/binutils + # emerge -1v sys-libs/glibc -10. If you are using a multilib profile, rebuild all 32-bit packages. +11. If you are using a multilib profile, rebuild all 32-bit packages. This can be done using: # emerge -1v --deep /lib32 /usr/lib32 /usr/lib/llvm/*/lib32 -11. Once the last 32-bit package is rebuilt, your package manager + Alternatively, if you are switching from one of the 13.0 profiles + you can rebuild all packages as detailed in the 17.0 news item: + # emerge -ev @world + +12. Once the last 32-bit package is rebuilt, your package manager should remove the orphaned /lib32 and /usr/lib32 symlinks. If that does not happen, remove them manually: # rm /lib32 /usr/lib32 @@ -57,3 +77,4 @@ with the new profiles or the migration procedure, please report a bug and make it block the tracker. [1] bug #506276 +[2] https://www.gentoo.org/support/news-items/2019-06-05-amd64-17-1-profiles-are-now-stable.html |