From bc9ac8f8667e9db438e7f87a9b4d43eabbecdf4e Mon Sep 17 00:00:00 2001 From: Michał Górny Date: Tue, 26 Dec 2017 12:32:04 +0100 Subject: Add the news item for 17.1 amd64 profiles --- ...7-12-26-experimental-amd64-17-1-profiles.en.txt | 102 +++++++++++++++++++++ 1 file changed, 102 insertions(+) create mode 100644 2017-12-26-experimental-amd64-17-1-profiles/2017-12-26-experimental-amd64-17-1-profiles.en.txt (limited to '2017-12-26-experimental-amd64-17-1-profiles') diff --git a/2017-12-26-experimental-amd64-17-1-profiles/2017-12-26-experimental-amd64-17-1-profiles.en.txt b/2017-12-26-experimental-amd64-17-1-profiles/2017-12-26-experimental-amd64-17-1-profiles.en.txt new file mode 100644 index 0000000..4ce77a9 --- /dev/null +++ b/2017-12-26-experimental-amd64-17-1-profiles/2017-12-26-experimental-amd64-17-1-profiles.en.txt @@ -0,0 +1,102 @@ +Title: Experimental amd64 17.1 profiles up for testing +Author: Michał Górny +Posted: 2017-12-xx +Revision: 1 +News-Item-Format: 2.0 +Display-If-Profile: default/linux/amd64/13.0 +Display-If-Profile: default/linux/amd64/13.0/selinux +Display-If-Profile: default/linux/amd64/13.0/desktop +Display-If-Profile: default/linux/amd64/13.0/desktop/gnome +Display-If-Profile: default/linux/amd64/13.0/desktop/gnome/systemd +Display-If-Profile: default/linux/amd64/13.0/desktop/plasma +Display-If-Profile: default/linux/amd64/13.0/desktop/plasma/systemd +Display-If-Profile: default/linux/amd64/13.0/developer +Display-If-Profile: default/linux/amd64/13.0/no-multilib +Display-If-Profile: default/linux/amd64/13.0/systemd +Display-If-Profile: default/linux/amd64/17.0 +Display-If-Profile: default/linux/amd64/17.0/selinux +Display-If-Profile: default/linux/amd64/17.0/hardened +Display-If-Profile: default/linux/amd64/17.0/hardened/selinux +Display-If-Profile: default/linux/amd64/17.0/desktop +Display-If-Profile: default/linux/amd64/17.0/desktop/gnome +Display-If-Profile: default/linux/amd64/17.0/desktop/gnome/systemd +Display-If-Profile: default/linux/amd64/17.0/desktop/plasma +Display-If-Profile: default/linux/amd64/17.0/desktop/plasma/systemd +Display-If-Profile: default/linux/amd64/17.0/developer +Display-If-Profile: default/linux/amd64/17.0/no-multilib +Display-If-Profile: default/linux/amd64/17.0/no-multilib/hardened +Display-If-Profile: default/linux/amd64/17.0/no-multilib/hardened/selinux +Display-If-Profile: default/linux/amd64/17.0/systemd + +A new set of 17.1 amd64 profiles has been added to the Gentoo +repository. Those profiles switch to a more standard 'no SYMLINK_LIB' +multilib layout, and require explicit migration as described below. They +are considered experimental at the moment, and have a fair risk +of breaking your system. We would therefore like to ask our users to +test them on their non-production ~amd64 systems. + +In those profiles, the lib->lib64 compatibility symlink is removed. +The 'lib' directory becomes a separate directory, that is used +for cross-arch and native non-library packages (gcc, clang) and 32-bit +libraries on the multilib profile (for better compatibility with +prebuilt x86 packages). + +Migration from both 13.0 and 17.0 profiles is supported. In case +of the former, please read the news item for 17.0 upgrade first +and enable gcc 6.4.0 or newer first as explained there. + +The migration is performed using app-portage/unsymlink-lib tool. +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, e.g. via 'emerge -1v app-portage/unsymlink-lib' + +3. 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. Run 'unsymlink-lib --migrate'. You can add '--pretend' first to see + what is going to happen. + +6. Reboot your system and see if it still boots. Check if important + programs work. In particular, check if 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 + 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.: + + eselect profile set --force default/linux/amd64/17.1/desktop + +[at this point you can start using emerge again] + +9. Rebuild sys-devel/gcc. If you are switching from 13.0 profiles, + rebuild sys-devel/binutils and sys-libs/glibc afterwards. + +10. If you are using a multilib profile, rebuild all 32-bit packages. + This can be done using: + + emerge -1v /lib32 /usr/lib32 + + 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. + +11. 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. + +For known issues, please see bug #506276 [1]. If you have any problems +with the new profiles or the migration procedure, please report a bug +and make it block the tracker. + +[1]:https://bugs.gentoo.org/506276 -- cgit v1.2.3-65-gdbad