Upgrading from older versions - Revision history

Zcrayfish: /* Upgrading Alpine v2.x to v3.x */ Attempt to improve text flow in warning box.

2024-01-06T06:48:29Z

Upgrading Alpine v2.x to v3.x: Attempt to improve text flow in warning box.

← Older revision		Revision as of 06:48, 6 January 2024
Line 5:		Line 5:

	{{Warning\|Alpine Linux 3.x switched to a different libc implementation compared to previous versions. Because the new Musl libc is not ABI compatible with uClibc, there are additional steps required for an upgrade.<br>		{{Warning\|Alpine Linux 3.x switched to a different libc implementation compared to previous versions. Because the new Musl libc is not ABI compatible with uClibc, there are additional steps required for an upgrade.<br>
	These versions are ANCIENT and sourcing compatible APKs will be difficult.}}		::These versions are ANCIENT and sourcing compatible APKs will be difficult.}}

	==== Installing statically linked tools ====		==== Installing statically linked tools ====
Line 32:		Line 32:

	{{Cmd\|apk.static upgrade --no-self-upgrade --available}}		{{Cmd\|apk.static upgrade --no-self-upgrade --available}}




	=== Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later ===		=== Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later ===

Zcrayfish: Added blurb about upcoming 3.20.0 release. Collapse Alpine 1.x information by default.

2024-01-06T06:33:57Z

Added blurb about upcoming 3.20.0 release. Collapse Alpine 1.x information by default.

← Older revision		Revision as of 06:33, 6 January 2024
Line 1:		Line 1:
			=== Upgrading Alpine ≤v3.19 to v3.20.0===
			When upgrading existing installations using grub, make sure to update the installed bootloader before rebooting, otherwise your machine might not boot.
			For more information on this issue, please check the [[Release Notes for Alpine 3.20.0#grub 2.12\|release notes]]
	=== Upgrading Alpine v2.x to v3.x ===		=== Upgrading Alpine v2.x to v3.x ===

Line 36:		Line 37:

	=== Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later ===		=== Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later ===
			<div class="toccolours mw-collapsible mw-collapsed">
			<div class="mw-collapsible-content">
	Since the '''apk''' tool has been significantly changed you need to download and install manually the latest version of {{Pkg\|apk-tools-static}}. We also install {{Pkg\|busybox-static}} just in case something goes wrong.		Since the '''apk''' tool has been significantly changed you need to download and install manually the latest version of {{Pkg\|apk-tools-static}}. We also install {{Pkg\|busybox-static}} just in case something goes wrong.

Zcrayfish: Expanded warning.

2023-08-25T03:49:21Z

Expanded warning.

← Older revision		Revision as of 03:49, 25 August 2023
Line 3:		Line 3:
	=== Upgrading Alpine v2.x to v3.x ===		=== Upgrading Alpine v2.x to v3.x ===

	{{Warning\|Alpine Linux 3.x switched to a different libc implementation compared to previous versions. Because the new Musl libc is not ABI compatible with uClibc, there are additional steps required for an upgrade.}}		{{Warning\|Alpine Linux 3.x switched to a different libc implementation compared to previous versions. Because the new Musl libc is not ABI compatible with uClibc, there are additional steps required for an upgrade.<br>
			These versions are ANCIENT and sourcing compatible APKs will be difficult.}}

	==== Installing statically linked tools ====		==== Installing statically linked tools ====

Zcrayfish: /* Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later */ Good luck.

2023-08-25T03:48:35Z

Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later: Good luck.

← Older revision		Revision as of 03:48, 25 August 2023
Line 42:		Line 42:
	Download {{Pkg\|busybox-static}} and install it:		Download {{Pkg\|busybox-static}} and install it:
	{{Cmd\|wget https://nl.alpinelinux.org/alpine/v3.0/main/x86/busybox-static-1.22.1-r9.apk		{{Cmd\|wget https://nl.alpinelinux.org/alpine/v3.0/main/x86/busybox-static-1.22.1-r9.apk
	apk add busybox-static-1.18.4-r3.apk}}		apk add busybox-static-1.22.1-r9.apk}}

	Download {{Pkg\|apk-tools-static}} and install it:		Download {{Pkg\|apk-tools-static}} and install it:
	{{Cmd\|wget https://nl.alpinelinux.org/alpine/v3.0/main/x86/apk-tools-static-2.4.4-r0.apk		{{Cmd\|wget https://nl.alpinelinux.org/alpine/v3.0/main/x86/apk-tools-static-2.4.4-r0.apk
	apk add apk-tools-static-2.1.0-r1.apk}}		apk add apk-tools-static-2.4.4-r0.apk}}

	Change repositories:		Change repositories:

Zcrayfish: /* Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later */ Give users of these ancient versions some hope....

2023-08-25T03:47:56Z

Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later: Give users of these ancient versions some hope....

← Older revision		Revision as of 03:47, 25 August 2023
Line 41:		Line 41:

	Download {{Pkg\|busybox-static}} and install it:		Download {{Pkg\|busybox-static}} and install it:
	{{Cmd\|wget https://nl.alpinelinux.org/alpine/v2.2/main/x86/busybox-static-1.18.4-r3.apk		{{Cmd\|wget https://nl.alpinelinux.org/alpine/v3.0/main/x86/busybox-static-1.22.1-r9.apk
	apk add busybox-static-1.18.4-r3.apk}}		apk add busybox-static-1.18.4-r3.apk}}

	Download {{Pkg\|apk-tools-static}} and install it:		Download {{Pkg\|apk-tools-static}} and install it:
	{{Cmd\|wget https://nl.alpinelinux.org/alpine/v2.2/main/x86/apk-tools-static-2.1.0-r1.apk		{{Cmd\|wget https://nl.alpinelinux.org/alpine/v3.0/main/x86/apk-tools-static-2.4.4-r0.apk
	apk add apk-tools-static-2.1.0-r1.apk}}		apk add apk-tools-static-2.1.0-r1.apk}}

Sertonix: use https links

2023-08-25T03:09:50Z

use https links

← Older revision		Revision as of 03:09, 25 August 2023
Line 41:		Line 41:

	Download {{Pkg\|busybox-static}} and install it:		Download {{Pkg\|busybox-static}} and install it:
	{{Cmd\|wget ~~http~~://nl.alpinelinux.org/alpine/v2.2/main/x86/busybox-static-1.18.4-r3.apk		{{Cmd\|wget https://nl.alpinelinux.org/alpine/v2.2/main/x86/busybox-static-1.18.4-r3.apk
	apk add busybox-static-1.18.4-r3.apk}}		apk add busybox-static-1.18.4-r3.apk}}

	Download {{Pkg\|apk-tools-static}} and install it:		Download {{Pkg\|apk-tools-static}} and install it:
	{{Cmd\|wget ~~http~~://nl.alpinelinux.org/alpine/v2.2/main/x86/apk-tools-static-2.1.0-r1.apk		{{Cmd\|wget https://nl.alpinelinux.org/alpine/v2.2/main/x86/apk-tools-static-2.1.0-r1.apk
	apk add apk-tools-static-2.1.0-r1.apk}}		apk add apk-tools-static-2.1.0-r1.apk}}

	Change repositories:		Change repositories:
	{{Cat\|/etc/apk/repositories\|...		{{Cat\|/etc/apk/repositories\|...
	~~http~~://nl.alpinelinux.org/alpine/v2.2/main		https://nl.alpinelinux.org/alpine/v2.2/main
	# or any other mirror		# or any other mirror
	}}		}}

Sb1: moving in 2.x to 3.x instructions

2021-07-05T10:54:25Z

moving in 2.x to 3.x instructions

← Older revision		Revision as of 10:54, 5 July 2021
Line 1:		Line 1:
	== Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later ==

			=== Upgrading Alpine v2.x to v3.x ===

			{{Warning\|Alpine Linux 3.x switched to a different libc implementation compared to previous versions. Because the new Musl libc is not ABI compatible with uClibc, there are additional steps required for an upgrade.}}

			==== Installing statically linked tools ====

			Statically linked version of apk-tools is needed, because the old musl version would stop working after a libc change (possibly in the middle of upgrade). Static version of busybox can be handy in case of the recovery from a failure.

			{{Cmd\|apk add busybox-static apk-tools-static}}

			==== Changing repositories to v3.x ====

			To begin, you need to update your {{Path\|/etc/apk/repositories}} file. Here are some shortcuts for doing so:
			:* Launch {{Cmd\|setup-apkrepos}} Enter {{Key\|e}} to edit {{Path\|/etc/apk/repositories}}. Change the version number by hand.
			:* Or, edit the file in place. This is how you'd change <var>v2.7</var> to <var>v3.0</var>: {{Cmd\|sed -i -e 's/<var>v2\.7</var>/<var>v3.0</var>/g' /etc/apk/repositories}}

			==== Upgrading system ====

			Use statically linked version of apk to update content of repository:

			{{Cmd\|apk.static update}}

			Simulating upgrade is recommended in order to detect issues beforehand:

			{{Cmd\|apk.static upgrade --no-self-upgrade --available --simulate}}

			With no problems encountered or after resolving them, start proper upgrade:

			{{Cmd\|apk.static upgrade --no-self-upgrade --available}}




			=== Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later ===
	Since the '''apk''' tool has been significantly changed you need to download and install manually the latest version of {{Pkg\|apk-tools-static}}. We also install {{Pkg\|busybox-static}} just in case something goes wrong.		Since the '''apk''' tool has been significantly changed you need to download and install manually the latest version of {{Pkg\|apk-tools-static}}. We also install {{Pkg\|busybox-static}} just in case something goes wrong.

Dubiousjim: /* Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later */ remove --update-cache

2012-10-29T23:22:48Z

Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later: remove --update-cache

← Older revision		Revision as of 23:22, 29 October 2012
Line 7:		Line 7:
	Download {{Pkg\|busybox-static}} and install it:		Download {{Pkg\|busybox-static}} and install it:
	{{Cmd\|wget http://nl.alpinelinux.org/alpine/v2.2/main/x86/busybox-static-1.18.4-r3.apk		{{Cmd\|wget http://nl.alpinelinux.org/alpine/v2.2/main/x86/busybox-static-1.18.4-r3.apk
	apk add busybox-static-1.18.4-r3.apk ~~--update-cache~~}}		apk add busybox-static-1.18.4-r3.apk}}

	Download {{Pkg\|apk-tools-static}} and install it:		Download {{Pkg\|apk-tools-static}} and install it:
	{{Cmd\|wget http://nl.alpinelinux.org/alpine/v2.2/main/x86/apk-tools-static-2.1.0-r1.apk		{{Cmd\|wget http://nl.alpinelinux.org/alpine/v2.2/main/x86/apk-tools-static-2.1.0-r1.apk
	apk add apk-tools-static-2.1.0-r1.apk ~~--update-cache~~}}		apk add apk-tools-static-2.1.0-r1.apk}}

	Change repositories:		Change repositories:

Dubiousjim: /* Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later */ remove -U from apk.static commands

2012-10-29T18:57:52Z

Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later: remove -U from apk.static commands

← Older revision		Revision as of 18:57, 29 October 2012
Line 19:		Line 19:
	}}		}}

	Proceed with update and upgrade. The <code>--available</code> switch is used to force all packages to be upgraded, even if they have the same version number, due to changes in uClibc:		Proceed with update and upgrade:
	~~{{Cmd\|apk.static update --update-cache~~		{{Cmd\|apk.static update
	~~apk~~.~~static upgrade --update-cache --available}}~~		apk.static upgrade --available}}
			The <code>--available</code> switch is used to force all packages to be upgraded, even if they have the same version number, due to changes in uClibc.

	Reboot the system to load new kernel		Reboot the system to load new kernel

Dubiousjim: Prune to only pre-2.2 instructions

2012-10-29T16:46:20Z

Prune to only pre-2.2 instructions

← Older revision		Revision as of 16:46, 29 October 2012
Line 1:		Line 1:
	~~{{Note\|You will need to restart any services that have been upgraded to begin using the upgraded versions. If the kernel is upgraded, you will need to reboot to begin using the upgraded version.}}~~

	~~== Upgrading from 2.1 to Alpine Linux 2.2 and later ==~~
	~~Since '''apk''' tool has been significantly changed first make sure you have upgraded ''apk-tools'' package to latest version available in 2.1 repositories:~~

	~~{{Cmd\|apk update --update-cache~~
	~~apk add --upgrade apk-tools}}~~

	~~Change repositories:~~
	~~{{Cat\|/etc/apk/repositories\|...~~
	~~http://nl.alpinelinux.org/alpine/v2.2/main~~
	~~# or any other mirror~~
	}}

	~~Proceed with update and upgrade. The <code>--available</code> switch is used to force all packages to be upgraded, even if they have the same version number, due to changes in uClibc:~~
	~~{{Cmd\|apk update --update-cache~~
	~~apk upgrade --available --update-cache}}~~

	~~Reboot the system to load new kernel~~
	~~{{Cmd\|sync~~
	~~reboot}}~~


	== Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later ==		== Upgrading from 2.0 or 1.10.x to Alpine Linux 2.2 and later ==
	Since '''apk''' tool has been significantly changed you need to download and install manually the latest version of ''apk-tools-static~~'' package~~.~~<BR>~~		Since the '''apk''' tool has been significantly changed you need to download and install manually the latest version of {{Pkg\|apk-tools-static}}. We also install {{Pkg\|busybox-static}} just in case something goes wrong.
	~~And we~~ install ''busybox-static'' just in case something goes wrong.

	If current version is 1.10.x remove GNU Wget before attempting an upgrade:		If current version is 1.10.x remove GNU Wget before attempting an upgrade:
	{{Cmd\|apk del wget}}		{{Cmd\|apk del wget}}

			Download {{Pkg\|busybox-static}} and install it:
	Download busybox-static ~~package~~ and install it:
	{{Cmd\|wget http://nl.alpinelinux.org/alpine/v2.2/main/x86/busybox-static-1.18.4-r3.apk		{{Cmd\|wget http://nl.alpinelinux.org/alpine/v2.2/main/x86/busybox-static-1.18.4-r3.apk
	apk add busybox-static-1.18.4-r3.apk --update-cache}}		apk add busybox-static-1.18.4-r3.apk --update-cache}}

	Download apk-tools-static ~~package~~ and install it:		Download {{Pkg\|apk-tools-static}} and install it:
	{{Cmd\|wget http://nl.alpinelinux.org/alpine/v2.2/main/x86/apk-tools-static-2.1.0-r1.apk		{{Cmd\|wget http://nl.alpinelinux.org/alpine/v2.2/main/x86/apk-tools-static-2.1.0-r1.apk
	apk add apk-tools-static-2.1.0-r1.apk --update-cache}}		apk add apk-tools-static-2.1.0-r1.apk --update-cache}}
Line 46:		Line 21:
	Proceed with update and upgrade. The <code>--available</code> switch is used to force all packages to be upgraded, even if they have the same version number, due to changes in uClibc:		Proceed with update and upgrade. The <code>--available</code> switch is used to force all packages to be upgraded, even if they have the same version number, due to changes in uClibc:
	{{Cmd\|apk.static update --update-cache		{{Cmd\|apk.static update --update-cache
	apk.static upgrade --~~available~~ --~~update~~-~~cache~~}}		apk.static upgrade --update-cache --available}}

	Reboot the system to load new kernel		Reboot the system to load new kernel
	{{Cmd\|sync		{{Cmd\|sync
	reboot}}		reboot}}


	[[Category:Installation]]		[[Category:Installation]]
	[[Category:Package Manager]]		[[Category:Package Manager]]