Nächste Überarbeitung | Vorhergehende ÜberarbeitungLetzte ÜberarbeitungBeide Seiten der Revision |
de:idp4:upgrade [2020/03/10 12:50] – angelegt Silke Meyer | de:idp4:upgrade [2020/04/06 13:25] – [Schritt 1: Update auf IdP 3.4.6] 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 ===== |
| |
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. | {{ :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. |