Include:Upgrading to Edge: Difference between revisions

From Alpine Linux
(Undo revision 31418 by John3-16 - Undid my revision, as the merge request pipeline that updated the text in the usr_merge_nag.sh script (https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/91806/diffs) was skipped: https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/91806/pipelines?commit_id=0db52277bea433ba4241117d4860cc7ca14e532f)
Tag: Undo
(moved content to Edge as this is not specific to upgrading to Edge)
 
(4 intermediate revisions by 2 users not shown)
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 the best-possible support. See
* https://alpinelinux.org/posts/2025-10-01-usr-merge.html for more details
</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.
:As indicated above, 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
doas merge-usr
# The script would no longer be required and may now be deleted from the system
doas apk del merge-usr
# Remember to sync and reboot, as per usual after a system upgrade
doas sync
doas reboot
</pre>

Latest revision as of 04:07, 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
Retrieved from "https://wiki.alpinelinux.org/w/index.php?title=Include:Upgrading_to_Edge&oldid=31544"