summaryrefslogtreecommitdiff
path: root/metadata/news/2022-12-01-systemd-usrmerge/2022-12-01-systemd-usrmerge.en.txt
blob: 87ec4afba6da9f17ec66d96b370ac2b67ea086d0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
Title: /usr merge for systemd users
Author: Mike Gilbert <floppym@gentoo.org>
Posted: 2022-12-01
Revision: 2
News-Item-Format: 2.0
Display-If-Installed: sys-apps/systemd

In the latter half of 2023, systemd will drop support for
split-usr/unmerged-usr systems [1]. All Gentoo systems running systemd
will need to be migrated to merged-usr.

Migrating to merged-usr will move all data from /bin, /sbin, and /lib
into the /usr/bin and /usr/lib directories. The directories in / are
replaced with symlinks.

To facilitate this, a new set of sub-profiles has been created, and a
script is available to perform the actual migration.

To migrate a system to merged-usr, follow this procedure:

1. Ensure your system backups are up to date.

2. Install sys-apps/merge-usr.

3. Run the merge-usr script. The --dryrun option may be used to
   check for error conditions before running the script for real.

4. Switch to a merged-usr profile.
     eg. eselect profile set default/linux/amd64/17.1/systemd/merged-usr

5. Run emerge with the --newuse or --changed-use option to rebuild
   any packages that have a "split-usr" USE flag.
     eg. emerge -uDN @world

For new installs, new "mergedusr" stage3 tarballs are being produced for
commonly used profiles.

[1] https://lists.freedesktop.org/archives/systemd-devel/2022-September/048352.html