Include:Upgrading to Edge: Difference between revisions

From Alpine Linux
m (Updated nag message)
(added warning and links and removed nag message contents as usr-merge page has necessary info)
Line 1: Line 1:
An upgrade of Alpine Linux from a stable version to the rolling development version ''edge'' basically requires the same steps as [[Upgrading_Alpine#Upgrading_to_latest_release|Upgrading to latest release]].  
An upgrade of Alpine Linux from a stable version to the rolling development version ''edge'' basically requires the same steps as [[Upgrading_Alpine#Upgrading_to_latest_release|Upgrading to latest release]].  


There are only two differences:-
When editing the {{Path|/etc/apk/repositories}} file, all referenced repository versions (such as {{ic|v{{#expr:{{AlpineLatest}}}}}} or {{ic|latest-stable}}) therein need to be pointing to <code>'''edge'''</code> as follows. {{cat|/etc/apk/repositories|#/media/cdrom/apks
 
* When editing the {{Path|/etc/apk/repositories}} file, all referenced repository versions (such as {{ic|v{{#expr:{{AlpineLatest}}}}}} or {{ic|latest-stable}}) therein need to be pointing to <code>'''edge'''</code> as follows. {{cat|/etc/apk/repositories|#/media/cdrom/apks
http://dl-cdn.alpinelinux.org/alpine/edge/main
http://dl-cdn.alpinelinux.org/alpine/edge/main
http://dl-cdn.alpinelinux.org/alpine/edge/community
http://dl-cdn.alpinelinux.org/alpine/edge/community
@testing http://dl-cdn.alpinelinux.org/alpine/edge/testing}}
@testing http://dl-cdn.alpinelinux.org/alpine/edge/testing}}
* When the upgrade completes, ''edge'' currently issues an encouragement to run a ''"/usr merge"'' script that would update the base filesystem hierarchy:
<pre>
usr_merge_nag.sh:
* WARNING: The current system is not /usr-merged.
* You are encouraged to migrate manually to ensure system reliability.
*
* See https://alpinelinux.org/posts/2025-10-01-usr-merge.html for more
* details.
*
* You can disable this message by masking the usr-merge-nag package:
*  apk add '!usr-merge-nag'
</pre>
:Applying this change should not affect general users.  For background  information on this process, consult the [https://alpinelinux.org/posts/2025-10-01-usr-merge.html news release], including its listing of the types of installations that may be affected.
:This update is not currently a requirement but will be implemented in the future. 
:To attempt its implementation with a dry run first that should foresee errors in execution:
<pre>
# As per a standard system upgrade to Edge or to a new release
doas apk upgrade -aU   
# Install the script
doas apk add merge-usr
# Simulate the outcome of the merge: do a "dry run".  This would report any errors onscreen
doas merge-usr --dryrun
# If any error is reported, it would be appreciated if you could kindly open an issue at https://gitlab.alpinelinux.org/alpine/aports/–/issues/new


# WARNING: The next step would be to run the script, but it is only to be run as long as the steps above were performed without any errors
When the upgrade completes, ''edge'' currently issues a messege encouraging users to migrate manually to install {{pkg|merge-usr}} package, that would update the base filesystem hierarchy. Consult [https://alpinelinux.org/posts/2025-10-01-usr-merge.html news release on usr-merge] for background information including the rationale.
doas merge-usr


# The script would no longer be required and may now be deleted from the system
This update is currently not a requirement, but will be implemented in the future as part of standard system upgrade to a [[Upgrading_Alpine#Upgrading_to_latest_release|new release]] as mentioned in {{Issue|17624}}.
doas apk del merge-usr


# Remember to sync and reboot, as per usual after a system upgrade
{{Warning|If any error is reported on running {{ic|$ doas merge-usr --dryrun}}, do not proceed with next steps, as this would break your system. Instead, it would be appreciated if you could kindly submit a '''[https://gitlab.alpinelinux.org/alpine/aports/issues bug report]''' and provide all requested information when doing so.}}
doas sync
doas reboot
</pre>

Revision as of 03:51, 28 November 2025

An upgrade of Alpine Linux from a stable version to the rolling development version edge basically requires the same steps as Upgrading to latest release.

When editing the /etc/apk/repositories file, all referenced repository versions (such as v3.23 or latest-stable) therein need to be pointing to edge as follows.

Contents of /etc/apk/repositories

#/media/cdrom/apks http://dl-cdn.alpinelinux.org/alpine/edge/main http://dl-cdn.alpinelinux.org/alpine/edge/community @testing http://dl-cdn.alpinelinux.org/alpine/edge/testing

When the upgrade completes, edge currently issues a messege encouraging users to migrate manually to install merge-usr package, that would update the base filesystem hierarchy. Consult news release on usr-merge for background information including the rationale.

This update is currently not a requirement, but will be implemented in the future as part of standard system upgrade to a new release as mentioned in #17624.

Warning: If any error is reported on running $ doas merge-usr --dryrun, do not proceed with next steps, as this would break your system. Instead, it would be appreciated if you could kindly submit a bug report and provide all requested information when doing so.


Retrieved from "https://wiki.alpinelinux.org/w/index.php?title=Include:Upgrading_to_Edge&oldid=31540"