Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung |
de:idp4:upgrade [2020/04/06 13:24] – Silke Meyer | de:idp4:upgrade [2020/04/14 14:50] (aktuell) – gelöscht Silke Meyer |
---|
~~NOTOC~~ | |
====== Upgrade ====== | |
{{INLINETOC 2}} | |
| |
<WRAP tip> | |
Diese Seite ist Work in Progress! | |
</WRAP> | |
| |
===== Upgrade von IdP 3.x auf 4.x ===== | |
| |
{{ :de:idp4:sign-bunny.png?150 |}} | |
| |
Laut der [[https://wiki.shibboleth.net/confluence/display/IDP4/Upgrading|Shibboleth-Dokumentation]] //muss// der IdP 4.0 direkt auf einen funktionsfähigen IdP Version 3.4.6 installiert werden! Man erhält //kein// fehlerfrei funktionierendes System, wenn man die Version 4.x separat installiert und die Konfiguration der Version in die Installation hineinkopiert. | |
| |
==== Schritt 1: Update auf IdP 3.4.6 ==== | |
| |
In den letzten 3.4.x-Releases wurden bereits alle Syntax- und Konfigurationsparameter-Änderungen als veraltet bemängelt, die in Version 4.0 nicht mehr möglich sind. Mit einer entsprechend mitgepflegten, laufenden IdP 3.4.6-Installation ist das Upgrade auf 4.0 möglich. | |
| |
Daher bringen Sie Ihren IdP bitte zunächst auf die Version 3.4.6: [[de:shibidp3upgrade|Hinweise zum Upgrade innerhalb der IdP v3 Produktlinie]] Auf der Seite finden Sie auch einen de:shibidp3upgrade#ueberblick_ueber_die_konfigurationsaenderungen_ab_idp_v340_-_vorbereitung_auf_idp_v4x| Überblick über die Konfigurationsänderungen]], die im IdP v3.4.6 laufen müssen. Beobachten Sie das ''idp-process.log'' und bereinigen Sie alle Deprecation Warnings. | |
| |
==== Schritt 2: Upgrade von 3.4.6 auf 4.0 ==== | |
| |
Die groben Schritte: | |
* Datensicherung von idp.home und Datenbank | |
* [[https://wiki.shibboleth.net/confluence/display/IDP4/ReleaseNotes|Release Notes]] studieren | |
* den Installer (''.bin/install.sh'') aufrufen und den IdP - wie bei den vorherigen Updates ins gewohnte Verzeichnis installieren | |
* die Datei ''./war/idp.war'' neu bauen mit ''./bin/build.sh'' | |
| |
Was geschieht mit den Änderungen am eigenen IdP? | |
* Dateien im Ordner ''idp.home/system'' werden (schon immer) bei Upgrades überschrieben. Dies war nie der Ort für eigene Anpassungen - sollten Sie doch Anpassungen vorgenommen haben, übertragen Sie sie bitte an die entsprechenden Stellen in den anderen Ordnern. | |
* Dateien in folgenden Ordnern werden bei Upgrades nicht überschrieben: ''./conf'', ''./views'', ''./messages'' und ''./edit-webapp''. Hier sollten Sie also Ihre Konfigurationen, Views oder Templates untergebracht haben. | |