Skip to content

Upgrade von i9 auf i11

In dieser Anleitung lernen Sie, wie Sie von einer beliebigen Version von imperia 9 auf imperia 11 upgraden.

Schritt 1: neue Lizenzdaten vom Hersteller erhalten#

Holen Sie sich Ihren Lizenzschlüssel für imperia 11 bei unserem Support-Desk. In diesem Prozess legen wir für Sie auch einen Account auf unserer Docker-Registry an: Hier Support-Ticket anlegen.

Schritt 2: Redaktionssystem auf imperia 9.2 updaten#

Ein direktes Update von imperia 9.0.x oder 9.1.x auf imperia 11 ist grundsätzlich möglich. Wir empfehlen jedoch einen Zwischenschritt einzulegen und zunächst einmal auf imperia 9.2.15 zu aktualisieren. Gehen Sie dazu die Schritte der Update-Anleitung durch.

Schritt 3: Redaktionssystem auf imperia 11 upgraden#

Nun installieren Sie imperia 11 und gehen dafür erneut die Update-Anleitung durch. Beachten Sie jedoch die folgende Ausnahme:

Wenn Sie nach dem Update das Datenbankschema updaten, übergeben Sie den Paramet --auto, um die Datenbank zu erweitern und obsolete Tabellen zu entfernen. Der vollständige Skriptaufruf ist dann der Folgende:

perl /var/www/imperia/dev/site/bin/site_doctree_admin.pl -U --auto

Schritt 4: Datenbank neu aufbauen#

Für das Update muss einmalig die Datenbank neu aufgebaut werden. Führen Sie also das site_rebuild_db-Skript aus:

perl /var/www/imperia/dev/site/bin/site_rebuild_db.pl -t -b

Schritt 5: Regkey-Datei einspielen#

Kopieren Sie die regkey.bin Datei, die Sie von der pirobase imperia gmbh erhalten haben, in das Verzeichnis site/config.

Schritt 6: Lizenzdaten eingeben#

Geben Sie Ihren imperia 11 Lizenzschlüssel ein. (Sie erhalten den Lizenzschlüssel beim Support-Desk der pirobase imperia gmbh)

imperia 11 einrichten#

Upgrade-Instruktionen für imperia 10#

Bitte beachten Sie auch die Upgradeinstruktionen für das Upgrade von imperia 10 auf imperia 11.

LDAP-Anbindung#

Die LDAP-Anbindung in imperia 10 wurde vollständig überarbeitet.

Nach dem Datenbank-Upgrade, sowie nach jeder Änderung der Gruppenstruktur in Ihrem LDAP oder im Falle von Problemen, sollten Sie die LDAP-Daten in das imperia Benutzermanagement replizieren. Dazu führen Sie das folgende Skript aus:

perl site/bin/site_replicate_um.pl --backend=LDAP

Hinweis

Mit der zusätzlichen Option --debug erzeugen Sie eine ausführlichere Ausgabe des Replizierungsskripts.

Durch Setzen der Umgebungsvariablen LDAP_DEBUG auf einen wahren Wert aktivieren Sie in allen Bereichen von imperia informative Debug-Ausgaben.

Das Format der Konfigurationsdatei site/config/LDAP.conf hat sich geringfügig geändert. Der Installer passt die Datei automatisch an das neue Format an. Die Systemvariablen UMLIGHT_PLUGIN und DATABASE_STORAGE_PLUGIN werden nicht mehr benötigt. imperia wird die neue Systemvariable UM_PROVIDERS automatisch auf “LDAP” setzen, wenn in Ihrer Installation LDAP-Authentifizierung aktiviert ist.

Rollen-Rechte-Management#

Die umfangreichste API-Änderung in imperia 10 ist das API des User- und Gruppen-Managements.

Allerdings werden die alten Klassendateien Roles.pm, Users.pm und Groups.pm vom Installer absichtlich nicht angetastet und funktionieren für die wichtigsten lesenden Zugriffe auf die User- und Gruppendaten weiter.

Nichtsdestotrotz sollten Sie existierenden Perl-Code an das neue API anpassen. Konsultieren Sie hierfür den „Hitchhiker's Guide To The New User Management in imperia 10” in der Datei site/docs/UM-i10.txt für ausführlichere Informationen. Der an das neue API angepasste Perl-Code wird in aller Regel kürzer, besser lesbar und stabiler sein.

Selbstgeschriebene Plugins/Perl-CodeIncludes/Controller müssen ggf. angepasst werden.

Kompatibilitätslayer#

Hinweis

Bitte beachten Sie, dass der Kompatibilitätslayer nur mit eingeschränkter Funktionalität ausgestattet ist, um den Umstieg zu erleichtern.

  • Wenn imperia 11 über ein existentes imperia 9-System bzw. i9 über ein existentes i8-System installiert wird, wird ein sog. "Kompatibilitätslayer" mit installiert.
  • Dieser Kompatibilitätslayer interpretiert noch einige der System-Conf-Variablen, die es in imperia 10 bzw. 9 nicht mehr gibt.
  • Somit können unter anderem Projektskripte weiter funktionieren.

Dashboards#

In imperia 9 personalisierte Dashboards werden nicht übernommen. Grund dafür ist eine Anpassung der Dashboards, um die Konfigurationsmöglichkeiten der Widgets erweitern zu können.

Neue IWE-Version#

CK-Editor wurde auf die Verion 4 aktualisiert. Die alte 3er Version wird weiter mitgeliefert und kann verwendet werden.