Wiki-Quellcode von Nextcloud Upgrade

Version 12.1 von Tom Altenbrunn am 2024/11/08 16:29

version	line-number	content
3.1	1	{{toc/}}
	2
	3	----
	4
3.2	5	Die Ubuntu-Basis der Nextcloud unter LD2.0 benötigt eine aktuellere Version als die derzeit genutzte Version 16.0.4 (Xenial Xerus), damit neuere Nextcloud-und PHP-Versionen installiert werden können. Im Nachfolgenden wird zunächst die Basis des nextcloud-g1 Containers auf Version 22.04.5 (Jammy) angehoben und anschließend die Komponenten Nextcloud, sowie PHP aktualisiert.
1.2	6
	7
2.3	8	= Server aktualisieren =
2.2	9
2.3	10	Zunächst den Server mit den aktuellsten Updates versorgen und die aktuelle Puppet-Version 1.6.X installieren.
2.2	11
2.4	12	{{code language="bash"}}
	13	root@ldhost:~ # ssh puppeteer
	14	root@puppeteer:~ # ldupdate
	15	{{/code}}
2.2	16
3.2	17	Im Anschluss wie gewohnt mehrere pruns im ldhost durchlaufen lassen und ein ldupdate im logosrv durchführen. Danach noch 2 x gprun im ldhost, damit die Updates über alle Container-Instanzen hinweg installiert werden.
2.3	18
2.7	19	{{code language="bash"}}
	20	root@ldhost:~ # prun;prun
	21	root@ldhost:~ # ssh logosrv
2.3	22
2.7	23	root@logosrv:~ # ldupdate
2.6	24
2.7	25	root@ldhost:~ # gprun;gprun
	26	{{/code}}
	27
	28	= Nextcloud-Containeranpassungen =
	29
2.11	30	== Nextcloud-Instanz zerstören ==
2.7	31
3.2	32	Nun wird die alte nextcloud-g1 Instanz unter der alten Ubuntu-Basis zerstört, damit diese später mit der neuen Ubuntu-Version wieder aufgebaut werden kann.
2.11	33
2.12	34	(% class="box infomessage" %)
	35	(((
5.1	36	Die Nextcloud-Benutzerdaten bleiben erhalten, da diese im ldhost im Verzeichnis lxc.data des Containers vorliegen bzw. als externe SMB-Shares eingebunden sind.
2.12	37	)))
	38
	39	{{code language="bash"}}
	40	root@puppeteer:~ # puppet-master-remove-client nextcloud-g1
	41	{{/code}}
	42
2.8	43	== Ubuntu-Version des LXC anheben ==
	44
3.2	45	Im puppeteer wird in der Konfigurations-Datei des ldhost für den nextcloud-g1-Container die Ubuntu-Release-Version auf Jammy gesetzt.
2.8	46
2.9	47	{{code language="bash"}}
3.4	48	root@puppeteer:~ # cd /etc/logodidact/hiera/custom.d/
3.5	49	root@puppeteer:/etc/logodidact/hiera/custom.d # vi ldhost.yaml
2.9	50	{{/code}}
	51
	52	{{code language="bash"}}
	53	profile::lxc::host:
	54	guests:
	55	nextcloud-g1:
	56	ensure: running
	57	release: jammy
	58	{{/code}}
	59
2.20	60	== Upgrade Anpassungen ==
	61
3.2	62	Während der Dauer des Upgrades ist es vonnöten die korrekte PHP-Version statisch per Nextcloud-Konfiguration mitzugeben.
1.1	63
2.15	64	{{code language="bash"}}
3.4	65	root@puppeteer:~ # cd /etc/logodidact/hiera/custom.d/
3.5	66	root@puppeteer:/etc/logodidact/hiera/custom.d # vi nextcloud-g1.yaml
2.15	67	{{/code}}
2.13	68
2.15	69	{{code language="bash"}}
	70	php::globals::php_version: '8.1'
	71	php::package_prefix: 'php8.1-'
	72	ld_base::fixes::php::historic_php_versions:
	73	- '8.3'
	74	{{/code}}
2.13	75
2.16	76	Alle Änderungen an den Konfigurationen ins GIT commiten.
2.13	77
3.4	78	{{code language="bash"}}
3.5	79	root@puppeteer:/etc/logodidact/hiera/custom.d # git add .
	80	root@puppeteer:/etc/logodidact/hiera/custom.d # git commit -am "KÜRZEL: Temporäre Anpassungen für Nextcloud Upgrade vorgenommen."
3.4	81	{{/code}}
2.15	82
3.4	83
2.17	84	== Re-Installation Nextcloud ==
2.15	85
3.3	86	Zunächst den jeweiligen LXC-Containerdienst im ldhost deaktivieren. Dadurch wird der LXC vollständig heruntergefahren.
2.16	87
2.17	88	{{code language="bash"}}
	89	root@ldhost:~ # systemctl stop lxc@nextcloud-g1.service
7.2	90	root@ldhost:~ # lxc-stop -n nextcloud-g1
	91
2.17	92	{{/code}}
2.16	93
9.2	94	Zur Überprüfung kann mittels lxc-ls -f der ausgeschaltete Zustand des Containers bestätigt werden.
	95
	96
2.17	97	Danach den ausgeschalteten und nicht mehr benötigten Nextcloud-Container vom Host-System löschen.
2.13	98
2.18	99	{{code language="bash"}}
	100	root@ldhost:~ # lxc-destroy -n nextcloud-g1 -f
	101	{{/code}}
1.1	102
2.18	103	Ein darauf folgender prun baut den Container neu auf unter Berücksichtigung der in den vorangegangen Schritten getätigten Vorgaben.
1.2	104
2.18	105	{{code language="bash"}}
	106	root@ldhost:~ # prun
	107	{{/code}}
1.1	108
3.3	109	(% class="box warningmessage" %)
	110	(((
	111	Gegebenenfalls sind je nach Geschwindigkeit des Servers noch weitere pruns notwendig.
	112	)))
	113
11.2	114	Verbinden Sie sich nun mit dem Container und starten diesen neu.
11.1	115
	116	{{code language="bash"}}
	117	root@ldhost:~ # lxc-attach -n nextcloud-g1
	118	root@nextcloud-g1:~ # reboot
	119	{{/code}}
	120
	121
2.19	122	Nachdem der Container vollständig aufgebaut ist, die Nextcloud-Version nach und nach auf die nächsthöheren Versionen 27 und 28 aktualisieren. Ein Upgrade der Anwendung über mehrere Versionen hinweg ist nicht möglich.
2.20	123
1.1	124
2.20	125	{{code language="bash"}}
	126	root@nextcloud-g1:~ # apt install --reinstall ld-nextcloud=27.1.9
	127
	128	root@nextcloud-g1:~ # prun
	129
	130	root@nextcloud-g1:~ # apt install --reinstall ld-nextcloud=28.0.5
	131
	132	root@nextcloud-g1:~ # prun
	133
	134	root@nextcloud-g1:~ # apt upgrade -y
	135
	136	root@nextcloud-g1:~ # prun
	137	{{/code}}
	138
	139	Damit ist der eigentliche Aktualisierungsvorgang abgeschlossen.
	140
3.3	141
2.20	142	== Upgrade Anpassungen entfernen ==
	143
2.21	144	Abschließend die gesetzten Upgrade-Anpassungen wieder entfernen und die Änderungen ins GIT commiten.
2.20	145
	146	{{code language="bash"}}
3.4	147	root@puppeteer:~ # cd /etc/logodidact/hiera/custom.d/
	148	root@puppeteer:/etc/logodidact/hiera/custom.d # vi nextcloud-g1.yaml
2.20	149	{{/code}}
	150
3.4	151	{{code language="bash"}}
	152	root@puppeteer:/etc/logodidact/hiera/custom.d # git add .
	153	root@puppeteer:/etc/logodidact/hiera/custom.d # git commit -am "KÜRZEL: Temporäre Anpassungen für Nextcloud Upgrade zurückgesetzt."
	154	{{/code}}
2.20	155
	156	== Abschluss ==
	157
2.21	158	Im Nextcloud-Container die Änderungen durch prun übernehmen. Dadurch wird ggf. auch eine neuere PHP-Version installiert.
2.20	159
2.21	160	{{code language="bash"}}
	161	root@nextcloud-g1:~ # prun;prun
	162	{{/code}}
8.2	163
	164	[[https:~~/~~/github.com/nextcloud/server/wiki/Releases-and-PHP-versions>>https://github.com/nextcloud/server/wiki/Releases-and-PHP-versions]]