Gentoo Archives: gentoo-dev

From: Georgy Yakovlev <gyakovlev@g.o>
To: gentoo-dev@l.g.o
Cc: pr@g.o, Georgy Yakovlev <gyakovlev@g.o>
Subject: [gentoo-dev] [PATCH] 2021-07-17-new-ppc64-profiles: add new item
Date: Sat, 17 Jul 2021 20:38:15
Message-Id: 20210717203739.478544-1-gyakovlev@gentoo.org
1 a lot of text taken from 17.1 profile news item:
2 2019-06-05-amd64-17-1-profiles-are-now-stable.en.txt
3
4 Bug: https://bugs.gentoo.org/640184
5 Bug: https://bugs.gentoo.org/715680
6 ---
7 .../2021-07-17-new-ppc64-profiles.en.txt | 78 +++++++++++++++++++
8 1 file changed, 78 insertions(+)
9 create mode 100644 2021-07-17-new-ppc64-profiles/2021-07-17-new-ppc64-profiles.en.txt
10
11 diff --git a/2021-07-17-new-ppc64-profiles/2021-07-17-new-ppc64-profiles.en.txt b/2021-07-17-new-ppc64-profiles/2021-07-17-new-ppc64-profiles.en.txt
12 new file mode 100644
13 index 0000000..6344963
14 --- /dev/null
15 +++ b/2021-07-17-new-ppc64-profiles/2021-07-17-new-ppc64-profiles.en.txt
16 @@ -0,0 +1,78 @@
17 +Title: new ppc64 profiles
18 +Author: Georgy Yakovlev <gyakovlev@g.o>
19 +Posted: 2021-07-17
20 +Revision: 1
21 +News-Item-Format: 2.0
22 +Display-If-Profile: default/linux/powerpc/ppc64/17.0/64bit-userland
23 +Display-If-Profile: default/linux/powerpc/ppc64/17.0/64bit-userland/desktop
24 +Display-If-Profile: default/linux/powerpc/ppc64/17.0/64bit-userland/desktop/gnome
25 +Display-If-Profile: default/linux/powerpc/ppc64/17.0/64bit-userland/desktop/gnome/systemd
26 +Display-If-Profile: default/linux/powerpc/ppc64/17.0/64bit-userland/developer
27 +
28 +A new set of ppc64 profiles has been added to the Gentoo
29 +repository in Jan 2020. These profiles switch to a more standard
30 +'no SYMLINK_LIB' multilib layout, and require explicit migration as
31 +described below. They are considered stable at the moment, and we would
32 +like to request all users to upgrade their systems. The old profiles
33 +will be deprecated in the near future.
34 +
35 +In the new profiles, the lib->lib64 compatibility symlink is removed.
36 +64-bit libraries need to be installed directly to lib64. /lib
37 +and /usr/lib become real directories, that are used for cross-arch
38 +and native non-library packages (gcc, clang).
39 +
40 +The migration is performed using app-portage/unsymlink-lib tool.
41 +The following steps can be used to upgrade your system:
42 +
43 +1. Sync and upgrade your system to the newest package versions
44 + to reduce the risk of issues.
45 +
46 +2. Install the tool:
47 +
48 + # emerge -1v app-portage/unsymlink-lib
49 +
50 +3. Run 'unsymlink-lib --analyze' and check the output for obvious
51 + mistakes. If you need to perform any changes to the system, remember
52 + to run 'unsymlink-lib --analyze' again afterwards.
53 +
54 +[past this point do not call emerge or modify /usr manually]
55 +
56 +4. This is a very good time to make a backup.
57 +
58 +5. Run 'unsymlink-lib --migrate'. You can add '--pretend' first to see
59 + what is going to happen.
60 +
61 +6. Reboot your system. Check if important programs work.
62 + In particular, verify that e.g. 'emerge --info' works (but do not
63 + install anything). If you hit any serious problems, you can use
64 + 'unsymlink-lib --rollback' to revert the changes and return to
65 + step 4.
66 +
67 +7. Run 'unsymlink-lib --finish'. You can add '--pretend' first to see
68 + what is going to happen but note that you're going to see a very long
69 + list of files to remove.
70 +
71 +8. Switch the profile, e.g.:
72 +
73 + # eselect profile set default/linux/ppc64/17.0
74 +
75 +[at this point you can start using emerge again]
76 +
77 +9. Rebuild the toolchain:
78 +
79 + # emerge -1v sys-devel/gcc:10
80 + [ repeat for other slots you will be using ]
81 + # emerge -1v sys-devel/binutils
82 + # emerge -1v sys-libs/glibc
83 +
84 +For known issues, please see bugs #506276 [2] and #640184[3] .
85 +If you have any problems with the new profiles or the migration procedure,
86 +please report a bug and make it block the tracker.
87 +
88 +For more information on the layout, please see the wiki article
89 +on AMD64 multilib layouts [4], it applies to PPC64 as well.
90 +
91 +[1] https://gentoo.org/support/news-items/2017-11-30-new-17-profiles.html
92 +[2] https://bugs.gentoo.org/506276
93 +[3] https://bugs.gentoo.org/640184
94 +[4] https://wiki.gentoo.org/wiki/Project:AMD64/Multilib_layout
95 --
96 2.32.0