| Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung Nächste ÜberarbeitungBeide Seiten der Revision |
| de:shibidp:upgrade [2020/11/17 11:17] – Silke Meyer | de:shibidp:upgrade [2021/02/09 08:58] – Silke Meyer |
|---|
| ====== Upgrade auf Shibboleth IdP 4.x ====== | ====== Upgrade auf Shibboleth IdP 4.x ====== |
| |
| Laut der [[https://wiki.shibboleth.net/confluence/display/IDP4/Upgrading|Shibboleth-Dokumentation]] **//soll//** der IdP 4.0 direkt auf einen funktionsfähigen IdP Version 3.4.6 oder 3.4.7 installiert werden! Man erhält //kein// fehlerfrei funktionierendes System, wenn man die Version 4.x separat installiert und die Konfiguration der alten Version einfach in die neue Installation hineinkopiert. Es ist natürlich möglich, die geprüften Inhalte in eine Neuinstallation zu übertragen. | Laut der [[https://wiki.shibboleth.net/confluence/display/IDP4/Upgrading|Shibboleth-Dokumentation]] **//soll//** der IdP 4.0 direkt auf einen funktionsfähigen IdP Version 3.4.6, 3.4.7 oder 3.4.8 installiert werden! Man erhält //kein// fehlerfrei funktionierendes System, wenn man die Version 4.x separat installiert und die Konfiguration der alten Version einfach in die neue Installation hineinkopiert. Es ist natürlich möglich, die geprüften Inhalte in eine Neuinstallation zu übertragen. |
| |
| <callout color="#ff9900" title="Vortragsfolien"> | <callout color="#ff9900" title="Vortrag"> |
| Hier finden Sie die Folien zum {{ :de:idp4:idp4-upgrade.pdf |Vortrag "Upgrade auf Shibboleth IdP 4.0.1"}} vom 17.11.2020. | Hier können Sie unseren **Vortrag "Upgrade auf Shibboleth IdP 4.x"** vom 17.11.2020 anschauen oder sich die {{ :de:idp4:idp4-upgrade.pdf |Folien }} herunterladen. Die Themen: |
| | * Allgemeine Neuerung im IdP 4 |
| | * Neuerungen, die nur auf neu installierten 4er IdPs aktiv sind |
| | * Vorstellung der neuen Attribute SAML Subject ID und SAML Pairwise ID |
| | * Vorgehensweise beim Upgrade (siehe auch unten auf dieser Seite) |
| | * Ausblick auf Shibboleth 4.1 |
| | {{:de:idp4:idp-upgrade.mp4 |}} |
| </callout> | </callout> |
| |
| <callout color="#ff9900" title="Vorgehen in Abhängigkeit Ihrer IdP-Version"> | <callout color="#ff9900" title="Vorgehen in Abhängigkeit Ihrer IdP-Version"> |
| Wir empfehlen, je nach dem, welche 3er-Version Sie betreiben, unterschiedliche Wege zu gehen, die unten dokumentiert sind: | Wir empfehlen, je nach dem, welche 3er-Version Sie betreiben, unterschiedliche Wege zu gehen, die unten dokumentiert sind: |
| * [[de:shibidp:upgrade#upgrade_von_346_oder_347|Upgrade von 3.4.6 / 3.4.7]] | * [[de:shibidp:upgrade#upgrade_von_346_oder_347|Upgrade von 3.4.6 / 3.4.7 / 3.4.8]] |
| * [[de:shibidp:upgrade#upgrade_von_341_-_345| Upgrade von 3.4.1 - 3.4.5]] | * [[de:shibidp:upgrade#upgrade_von_341_-_345| Upgrade von 3.4.1 - 3.4.5]] |
| * [[de:shibidp:upgrade#neuinstallation_bei_idp_33x_oder_aelter | Neuinstallation bei 3.3.x oder älter]] | * [[de:shibidp:upgrade#neuinstallation_bei_idp_33x_oder_aelter | Neuinstallation bei 3.3.x oder älter]] |
| </callout> | </callout> |
| |
| ===== Upgrade von 3.4.6 oder 3.4.7 ===== | ===== Upgrade von 3.4.6 - 3.4.8 ===== |
| |
| Die IdP-Versionen 3.4.6 und 3.4.7 sind beide upgradefähig. | Die IdP-Versionen 3.4.6, 3.4.7 und 3.4.8 sind upgradefähig. |
| |
| Die groben Schritte: | Die groben Schritte: |
| |
| <callout color="#ff9900" title="Attribute Resolver erst später umbauen"> | <callout color="#ff9900" title="Attribute Resolver erst später umbauen"> |
| Da die IdP-Version 4.1 voraussichtlich etliche Konfigurationsänderungen mit sich bringen wird ([[https://wiki.shibboleth.net/confluence/display/DEV/2020/09/08/September+Update|[1]]], [[https://wiki.shibboleth.net/confluence/display/DEV/2020/10/12/October+Update|[2]]]), empfehlen wir, nach einem Upgrade von 3.4.6 bzw. 3.4.7 auf 4.0.1 die alte ''conf/attribute-resolver.xml'' beizubehalten. Den Umbau der Syntax und das Einbeziehen der neuen Attribute Registry sollten Sie dann später vornehmen. | Da die IdP-Version 4.1 voraussichtlich etliche Konfigurationsänderungen mit sich bringen wird ([[https://wiki.shibboleth.net/confluence/display/DEV/2020/09/08/September+Update|[1]]], [[https://wiki.shibboleth.net/confluence/display/DEV/2020/10/12/October+Update|[2]]]), empfehlen wir, nach einem Upgrade von 3.4.6-3.4.8 auf 4.0.1 die alte ''conf/attribute-resolver.xml'' beizubehalten. Den Umbau der Syntax und das Einbeziehen der neuen Attribute Registry sollten Sie dann später vornehmen. |
| </callout> | </callout> |
| |
| 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. Je nach dem, welche genaue IdP-Version Sie betreiben, sollten Sie **abwägen, welchen Weg Sie gehen möchten**. Ab Version 3.4.2 war die Datei ''conf/attribute-resolver.xml'' anzupassen. Dies war der aufwändigste Schritt. Wenn Sie ihn schon hinter sich haben, ist es sicher weniger Aufwand, dem Upgradepfad zu folgen. | 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. Je nach dem, welche genaue IdP-Version Sie betreiben, sollten Sie **abwägen, welchen Weg Sie gehen möchten**. Ab Version 3.4.2 war die Datei ''conf/attribute-resolver.xml'' anzupassen. Dies war der aufwändigste Schritt. Wenn Sie ihn schon hinter sich haben, ist es sicher weniger Aufwand, dem Upgradepfad zu folgen. |
| |
| ==== Schritt 1: Update auf IdP 3.4.7 ==== | ==== Schritt 1: Update auf IdP 3.4.8 ==== |
| |
| Daher bringen Sie Ihren IdP bitte zunächst auf die Version 3.4.7: [[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.7 laufen müssen. Beobachten Sie das ''idp-process.log'' (oder nur die Warnungen und Fehler im ''idp-warn.log'') und bereinigen Sie alle Deprecation Warnings. | Daher bringen Sie Ihren IdP bitte zunächst auf die Version 3.4.8: [[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.8 laufen müssen. Beobachten Sie das ''idp-process.log'' (oder nur die Warnungen und Fehler im ''idp-warn.log'') und bereinigen Sie alle Deprecation Warnings. |
| |
| ==== Schritt 2: Upgrade von 3.4.7 auf 4.0.x ==== | ==== Schritt 2: Upgrade von 3.4.8 auf 4.0.x ==== |
| |
| Ab hier gehen Sie vor, wie im Abschnitt [[de:shibidp:upgrade#upgrade_von_346_oder_347|Upgrade von 3.4.6 oder 3.4.7]] beschrieben. | Ab hier gehen Sie vor, wie im Abschnitt [[de:shibidp:upgrade#upgrade_von_346_oder_347|Upgrade von 3.4.6 - 3.4.8]] beschrieben. |
| |
| ===== Neuinstallation bei IdP 3.3.x oder älter ===== | ===== Neuinstallation bei IdP 3.3.x oder älter ===== |
| |
| === attribute-filter.xml === | === attribute-filter.xml === |
| * Das XML-Element ''ignoreCase'' wird ersetzt durch ''caseSensitive''. Um die gleiche Aussage zu erhalten, geben Sie statt ''ignoreCase='true' '' jetzt ''caseSensitive='false' '' ein. Ein Beispiel: <file xml conf/attribute-resolver.xml> | * Das XML-Element ''ignoreCase'' wird ersetzt durch ''caseSensitive''. Um die gleiche Aussage zu erhalten, geben Sie statt ''ignoreCase='true' '' jetzt ''caseSensitive='false' '' ein. Ein Beispiel aus den Filter Policies (dasselbe kann auch im Attribute Resolver vorkommen): <file xml conf/attribute-filter.xml> |
| <AttributeFilterPolicy id="LibraryTermsToAnyone"> | <AttributeFilterPolicy id="LibraryTermsToAnyone"> |
| <PolicyRequirementRule xsi:type="ANY" /> | <PolicyRequirementRule xsi:type="ANY" /> |