Admin.migrationshinweise

In diesem Kapitel erhalten Sie wichtige Hinweise für die Migration von einer imperia-Version zum nächst höheren (Major-)Release.

Im Gegensatz zum Installationshandbuch, wo Sie Anleitungen zur allgemeinen Vorbereitung und Durchführung einer Migration bzw. zur Erst-Installation erhalten, finden Sie hier konkrete Hinweise zu den einzelnen Versionen auf diese Sie migrieren bzw. upgraden möchten.

Generell unterstützen wir im Support die aktuelle Version der letzten 2 Major-Releases. Bsp.: "End-of-Lifetime" für imperia 10 ist demnach erst bei Erscheinen von imperia 12.

Zusammenfassung

Update	Update-Hinweise, die ab dieser Version gültig sind.
Update von i10.2.3 auf i10.2.4	Mit imperia 10.2.4 verfügt das Skript `perl site_rebuild_db.pl -m -t -b` nun über weitere Parameter (`-m` für "Minimaler Neuaufbau"). Lesen Sie dazu auch im Admin-Handbuch site_rebuild_db.pl.
Volltextsuche ignoriert Base64 enkodierte, interne Daten. Optional deaktivierbar mit der Index.conf-Variable: `keepbase64content`
Update von i10.2.1 auf i10.2.2	Mit der Version 10.2.2 gab es Änderungen in der Datenbank. Nach dem Update müssen Sie diese mit `site_doctree_admin.pl -U` neu aufbauen. Dies erfolgt in Ihrem System unter `./imperia.de/site/bin/site_doctree_admin.pl -U`.
Update von i10.2.0 auf i10.2.1	Aktualisieren Sie – falls möglich – Ihre SQLite auf eine Version >3.8.3. Sie verbessern damit u.a. die Suchergebnisse im Dokumenten-Browser.
Update von i10.1 auf i10.2	Mit einem Update auf i10.2 ist eine Hermes.conf Pflicht. Wichtig: Das Skript wird beim Update/bei einer Erstinstallation NICHT automatisch ausgeführt. Um sicherzustellen, dass diese auch generiert wird, führen Sie folgende Schritte durch: 1. Führen Sie das Skript `site/bin/site_hermes_plugins_list.pl` aus: Windows: `C:\Strawberry\perl\bin\perl.exe C:/imp/projects/926/webs/dev/site_hermes_plugins_list.pl -g -q -i Monitor\\|Analyzer` UNIX: `perl /imp/projects/926/webs/dev/site/bin/site_hermes_plugins_list.pl -g -q -i Monitor\\|Analyzer` Bitte beachten Der Backslash muss vorangestellt werden, damit die Shell das Symbol `\|` nicht als Pipe interpretiert. Dieses Skript erzeugt nicht mehrere parallele Hermes-Worker, sondern nur eine Instanz mit ALLEN Plug-ins. 2. Kopieren Sie den Output der Liste manuell in die site/config/hermes.conf.sample: `perl site/bin/site_hermes_plugins_list.pl > site/config/hermes.conf.sample` 3. Ändern Sie `hermes.conf.sample` zu `hermes.conf` ab. Bitte beachten Folgende Hinweise sind für die Weiterarbeit mit den Plug-ins relevant: Das Aufteilen der Hermes-Worker ist nicht ganz trivial - zumindest nicht in allen Fällen! Lesen Sie daher auch die generelle Dokumentation unter: site/config/hermes.conf.sample Die Anwendung des Hermes-Dienstes wird im Admin-Handbuch ausführlichst beschrieben.
Update von 10.0.0 auf 10.0.3	Bei Updates von imperia 10.0.0-10.0.3 müssen Sie unter Umständen die Datenbank neu aufbauen (mit `site_doctree_admin.pl -U`), falls es bei Ihnen Probleme mit der Reihenfolge der Master- und Copyseiten im Dokumenten-Browser gibt oder es zu Berechtigungsproblemen kommt.
___

Version 10.2.3¶

In 10.2.2 und 10.2.3 gab es Änderungen in der Datenbank. Nach dem Update müssen Sie diese mit site_doctree_admin.pl -U neu aufbauen.
Dies erfolgt in Ihrem System unter ./imperia.de/site/bin/site_doctree_admin.pl -U.
Volltextsuche ignoriert Base64 enkodierte, interne Daten. Optional deaktivierbar mit der Index.conf-Variable: keepbase64content

Version 10.2.2¶

In 10.2.2 und 10.2.3 gab es Änderungen in der Datenbank. Nach dem Update müssen Sie diese mit site_doctree_admin.pl -U neu aufbauen. Dies erfolgt in Ihrem System unter ./imperia.de/site/bin/site_doctree_admin.pl -U.

Version 10.2.1¶

Aktualisieren Sie – falls möglich – Ihre SQLite auf eine Version >3.8.3. Sie verbessern damit u.a. die Suchergebnisse im Dokumenten-Browser.

Version 10.2¶

Mit einem Update auf i10.2 ist eine Hermes.conf Pflicht.

Um sicherzustellen, dass diese auch generiert wird, führen Sie folgende Schritte durch:

Version 10.1.3¶

Keine besonderen Hinweise vorhanden.

Version 10.1.2¶

Keine besonderen Hinweise vorhanden.

Version 10.1.1¶

Keine besonderen Hinweise vorhanden.

Version 10.1.0¶

Migration von 10.0.x auf 10.1¶

Die Migration von 10.0.4 auf imperia 10.1 unterscheidet sich nicht von einem Update. Sie stoppen die Hermesdienste, führen das Perlskript install.pl auf Ihre imperia-Instanzen aus und starten anschließend den Webserver neu.

Migration von 9.2.x auf 10.1¶

Wie bei jedem neuen Major-Release, erfordert ein Upgrade auf imperia 10.1 eine Migration des Datenkbankschemas. Andere Daten müssen nicht migriert werden, sofern Sie von der neuesten Version von imperia 9 kommen.
Ein direktes Upgrade von Imperia 8.6 kann evtl. funktionieren, wird aber von Imperia nicht supportet.

Schema-Upgrade Datenbank¶

Wie schon bei früheren Versionen, wird das Datenbankschema auf imperia 10.1 mit dem Skriptaufruf site/bin/site_doctree_admin.pl --upgrade --auto aktualisiert. Die Option --auto ist neu in imperia 10.1 und bewirkt, dass das Skript - soweit notwendig - alle Tabellen automatisch neu aufbaut. Dies ist in erster Linie für Installationen mit Datenhaltung im Dateisystem und der Embedded-Datenbank SQLite3 interessant.

Wichtig

*imperia 10.1* verwendet in den Tabellendefinitionen Fremdschlüssel. Falls Sie kein Client-Server-RDBMS sondern die Embedded-Datenbank SQLite3 verwenden, sollten Sie bei manueller Manipulation der Datenbank unbedingt daran denken, dass Sie am Anfang Ihrer Session Fremdschlüssel in SQLite3 mit dem Statement `pragma foreign_keys on` aktivieren, um eine Korrumpierung Ihrer Daten zu vermeiden.

Upgrade User-Management¶

Das User-Management erfordert keine Migration. Sie sollten allerdings bedenken, dass die Primärquelle für alle User- und Gruppendaten nun die Datenkbank für die Dokumentenhaltung ist. Infolgedessen, werden alle Anmeldeversuche vor einem Upgrade des Datenbankschemas scheitern.

Lokales User-Management:
Sie können jederzeit einen Neuaufbau der User- und Gruppendaten in der Datenbank mit dem Skriptaufruf site/bin/site_rebuild_db --todo --batch --um-only erzwingen.

Wichtig

Aus Sicherheitserwägungen werden fehlgeschlagene Logins aufgrund eines inkompatiblen Datenbankschemas nicht über die Oberfläche gemeldet, sondern sind nur aus dem Error-Log des Web-Servers ersichtlich.
LDAP:
Das Format der Konfigurationsdatei site/bin/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.
Nach dem Datenbank-Upgrade, sowie nach jeder Änderung der Gruppenstruktur in Ihrem LDAP, sollten Sie die LDAP-Daten mit dem Kommando site/bin/site_replicate_um.pl --backend=LDAP in imperia replizieren. Die Replizierung findet ebenfalls regelmäßig um 01:00 Uhr nachts statt. Sie können diese Zeit auch mit der neuen Systemvariable UM_REPLICATION_EXEC_TIME (Format HH:MM oder “no”, um die automatische Replizierung abzuschalten) Ihren Bedürfnissen entsprechend setzen.

Wichtig

Mit der zusätzlichen Option --debug erzeugen Sie mehr informative Ausgaben des Replizierungsskripts.

Durch Setzen der Umgebungsvariablen LDAP_DEBUG auf einen wahren Wert, aktivieren Sie in allen Bereichen von imperia informative Debugausgaben.

Perl-Code anpassen¶

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.1” in der Datei site/docs/UM-i10.txt für erschöpfende Informationen. Der an das neue API angepasste Perl-Code wird in aller Regel kürzer, besser lesbar und stabiler sein.

Version 10.0.4¶

Keine besonderen Hinweise vorhanden.

Version 10.0.3¶

Bei Migrationen von imperia 10.0.0 – 10.0.3 müssen Sie unter Umständen die Datenbank neu aufbauen (mit site_doctree_admin.pl -U), falls es bei Ihnen Probleme mit der Reihenfolge der Master- und Copyseiten im Dokumenten-Browser gibt oder es zu Berechtigungsproblemen kommt.

Version 10.0.2.1¶

Keine besonderen Hinweise vorhanden.

Version 10.0.2¶

Keine besonderen Hinweise vorhanden.

Version 10.0.1¶

Keine besonderen Hinweise vorhanden.

Version 10¶

Upgraden Sie auf die aktuellste Version von imperia 9.2 bevor Sie auf imperia 10 migrieren.
Die LDAP-Anbinding in imperia 10 wurde vollständig überarbeitet. Starten Sie im Falle von Problemen bitte das Skript site_replicate_um.pl --backend=LDAP
Erweiterte Zugriffskontrolle: Insbesondere für Zielsysteme lässt sich die Zugriffskontrolle wie in Apache 2.4 über Rulesets einstellen. Kopieren Sie hierzu die Datei /site/config/access.conf.sample und passen Sie sie an die eigenen Bedürfnisse an.
Schema-Upgrade Datenbank: Wie schon bei früheren Versionen, wird das Datenbankschema auf imperia 10 mit dem Skriptaufruf site/bin/site_doctree_admin.pl --upgrade --auto aktualisiert. Die Option --auto ist neu in imperia 10 und bewirkt, dass das Skript - soweit notwendig - alle Tabellen automatisch neu aufbaut. Dies ist in erster Linie für Installationen mit Datenhaltung im Dateisystem und der Embedded-Datenbank SQLite3 interessant.

Wichtig

imperia 10 verwendet in den Tabellendefinitionen Fremdschlüssel. Falls Sie kein Client-Server-RDBMS sondern die Embedded-Datenbank SQLite3 verwenden, sollten Sie bei manueller Manipulation der Datenbank unbedingt daran denken, dass Sie am Anfang Ihrer Session Fremdschlüssel in SQLite3 mit dem Statement pragma foreign_keys on aktivieren, um eine Korrumpierung Ihrer Daten zu vermeiden.
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.1” in der Datei site/docs/UM-i10.txt für erschöpfende Informationen. Der an das neue API angepasste Perl-Code wird in aller Regel kürzer, besser lesbar und stabiler sein.
In imperia 9 personalisierte Dashboards werden in Version 10 nicht übernommen. Grund dafür ist eine Anpassung der Dashboards, um die Konfigurationsmöglichkeiten der Widgets erweitern zu können.
Lesen Sie auch Upgrade User-Management.
Wenn imperia 10 über ein existentes imperia 9 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 nicht mehr gibt.
Somit können unter anderem Projektskripte weiter funktionieren. In einem "frischen" imperia 10-System stehen diese Variablen nicht mehr zur Verfügung.
Bitte beachten Sie, dass der Kompatibilitätslayer nur mit eingeschränkter Funktionalität ausgestattet ist, um den Umstieg zu erleichtern.

Version 9.2.12¶

Im MAM werden nun auch Vorschaubilder von SVG-Dateien generiert. Dazu muss allerdings die folgende System.conf-Variable gesetzt werden: MAM_THUMBNAIL_SVG_TO_MIME = 'png'
Im Falle von Icons eigens erstellter Menüpunkte, müssen diese neu ausgewählt werden, d.h. die Ersetzungen müssen manuell vorgenommen werden.

Version 9.2¶

Mit imperia 9.2 wurde der Zugriff auf das Benutzermanagement beschleunigt. Nach dem Update führen Sie bitte das Skript site_doctree_admin.pl -U aus.
Lesen Sie dazu auch die Release 9.2-Dokumentation.
Mit der Einführung des HTML5-Grids werden die Konfigurationsdialog der Workflow-Schritte in regulärem HTML definiert. Eigene Konfigurationsdialoge müssen deshalb mit Hilfe des Skripts site/bin/site_migrate_fxml_to_html.pl migriert werden. Jedes Plug-in muss einzeln migriert werden!
Zusätzlich benötigen Sie die Perl-Module XML::LibXML und XML::LibXSLT, damit die Migration funktioniert. Diese Module sollten Sie vor der Migration Ihrer Konfigurationsdialoge installieren.
Lesen Sie dazu auch das Kapitel Workflows.

Version 9¶

Wenn imperia 9 über ein existentes imperia 8 System installiert wird, wird ein sog. "Kompatibilitätslayer" mit installiert.
Dieser Kompatibilitätslayer interpretiert noch einige der System-Conf-Variablen, die es in imperia 9 nicht mehr gibt.
Somit können unter anderem Projektskripte weiter funktionieren. In einem "frischen" imperia 10-System stehen diese Variablen nicht mehr zur Verfügung.
Bitte beachten Sie, dass der Kompatibilitätslayer nur mit eingeschränkter Funktionalität ausgestattet ist, um den Umstieg zu erleichtern.

in allen Perl-Erweiterungen empfehlen wir ein Codegerüst, das ungefähr so aussieht:

use strict;

use Imperia;

use vars qw ($new $metainfo);

An die wichtigsten Objekte kommen Sie mit folgenden Statements:

my $system_conf = $imperia->common->
{system_conf}

;
my $doctree_plugin = $imperia->common->
{doc_tree}

;
my $user_info = $imperia->common->
{user}

;

Der Aufruf der Variablen erfolgt dann entsprechend:

my $liveServer = $system_conf->
{'ABS-DOC-ROOT'}

;
my $doc_root = $system_conf->
{'DOCUMENT-ROOT'}

;

Restlicher Code ...

$new = "Ergebnis";

Weitere Methoden für Perl Erweiterungen finden Sie unter perldoc site/modules/core/Imperia.pm.