Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
Nächste ÜberarbeitungBeide Seiten der Revision
de:shibidp:upgrade [2020/11/18 12:23] Silke Meyerde:shibidp:upgrade [2021/02/09 08:58] Silke Meyer
Zeile 1: Zeile 1:
 ====== 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.63.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="Vortrag"> <callout color="#ff9900" title="Vortrag">
Zeile 15: Zeile 15:
 <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.=====+===== Upgrade von 3.4.6 3.4.=====
  
-Die IdP-Versionen 3.4.6 und 3.4.7 sind beide upgradefähig.+Die IdP-Versionen 3.4.63.4.7 und 3.4.8 sind upgradefähig.
  
 Die groben Schritte: Die groben Schritte:
Zeile 41: Zeile 41:
  
 <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.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.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>
  
Zeile 48: Zeile 48:
 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.====+==== Schritt 1: Update auf IdP 3.4.====
  
-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.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.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.auf 4.0.x ====+==== Schritt 2: Upgrade von 3.4.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 =====
Zeile 122: Zeile 122:
  
 === 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" />
  • Zuletzt geändert: vor 10 Monaten