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 |