Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung Nächste ÜberarbeitungBeide Seiten der Revision |
de:idp4:upgrade [2020/03/10 13:14] – Silke Meyer | de:idp4:upgrade [2020/04/06 13:24] – Silke Meyer |
---|
====== Upgrade ====== | ====== Upgrade ====== |
{{INLINETOC 2}} | {{INLINETOC 2}} |
| |
| <WRAP tip> |
| Diese Seite ist Work in Progress! |
| </WRAP> |
| |
===== Upgrade von IdP 3.x auf 4.x ===== | ===== 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. | 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. |
{{:de:idp4:sign-bunny.png?150 |}} | |
| |
==== Schritt 1: Update auf IdP 3.4.6 ==== | ==== 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 migepflegten, laufenden IdP 3.4.6-Installation ist das Upgrade auf 4.0 möglich. | 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: [[https://doku.tid.dfn.de/de:shibidp3upgrade|Hinweise zum Upgrade innerhalb der IdP v3 Produktlinie und Überblick über die Konfigurationsänderungen ab IdP v3.4.0]] | 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 ==== | ==== Schritt 2: Upgrade von 3.4.6 auf 4.0 ==== |
| |
| Die groben Schritte: |
* Datensicherung von idp.home und Datenbank | * Datensicherung von idp.home und Datenbank |
* [[https://wiki.shibboleth.net/confluence/display/IDP4/ReleaseNotes|Release Notes]] studieren | * [[https://wiki.shibboleth.net/confluence/display/IDP4/ReleaseNotes|Release Notes]] studieren |
* die Datei ''./war/idp.war'' neu bauen mit ''./bin/build.sh'' | * 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. |