agorum core auf einen anderen Server umziehen

Identisches Zielsystem und Quellsystem

Das Zielsystem und Quellsystem von agorum core müssen identisch sein.

Es müssen die gleichen Module aktiviert / installiert sein.
Das Passwort des Super-Administrators roi muss identisch sein.
Die gleiche Suchmaschine muss verwendet werden (Solr, Lucene).
Die gleiche Datenbank muss verwendet werden.

Importieren Sie die Datenbank durch einen Datenbank-Dump und eine Wiederherstellung auf dem Zielsystem. Wenn es sich dabei um Nicht-UTF-8 Daten handelt und Sie diese in eine UTF8-Installation überführen wollen, müssen Sie einige Punkte beachten.

Die Datenbank ist je nach Set-up nur ein Teil von mehreren Schritten, die Sie beim Umzug beachten müssen.

Für das korrekte Vorgehen ist unter anderem relevant, ob Sie eines der folgenden Module verwenden:

agorum core storage
agorum core adminsync

Schnittstellen deaktivieren

Schnittstellen, etwa einen E-Mail-Adapter, müssen Sie deaktivieren.
Verwenden Sie ein Testsystem und Produktivsystem gleichzeitig, müssen Sie bei einem davon den E-Mail-Adapter deaktivieren, da sonst beide Systeme E-Mails abholen. Dies ist durch ein XML-Skript möglich, oder Sie deaktivieren den E-Mail-Adapter vorübergehend vor Erstellung des Dumps.

Den Umzug bei gleichem Betriebssystem durchführen

Hinweis: Alle Verzeichnisse müssen auf dem Zielsystem identisch zu den Verzeichnissen des Quellsystems sein.

Installieren Sie agorum core auf dem Zielsystem.
Beenden Sie agorum core auf dem Zielserver.
Überführen Sie die Datenbank des Quellservers durch einen Dump und eine Wiederherstellung in die Zieldatenbank.
Übertragen Sie die für die jeweilige Suchmaschine relevanten Daten.
Übertragen Sie die Daten des Moduls agorum core adminsync aus folgendem Pfad vom Quellsystem auf das Zielsystem, sofern Sie das Modul verwenden:
```
<InstallDir>/jboss/server/default/deploy/roi.ear/config
```
Übertragen Sie die Daten des Moduls agorum core storage, sofern Sie das Modul verwenden.

Hinweise:
• Kopieren Sie die auf die Platte ausgelagerten Daten des Moduls in dasselbe Zielverzeichnis, indem er auch auf dem Quellserver erreichbar war, da es sonst zu schwerwiegenden Systemfehlern kommen kann.
• Entnehmen Sie die verwendeten Pfade des Moduls der Storage-Konfigurationsoberfläche. Öffnen Sie dazu in agorum core das Modul Storage.
• Befolgen Sie die Anweisungen unter Umzug bei Betriebssystemwechsel durchführen, sofern sich die Pfade durch die gegebenen Umstände ändern.

Pfad der storage-Auslagerung

Die suchmaschinenrelevante Daten übertragen

Solr

Löschen Sie diese Pfade auf dem Zielserver:
```
<InstallDir>/solr
<InstallDir>/zookeeper
```
Ersetzen Sie diese kompletten Verzeichnisse mit den Daten aus dem Quellserver:
```
<InstallDir>/solr
<InstallDir>/zookeeper
```

Lucene

Bei Installationen mit Lucene liegt der Index typischerweise in der Datenbank. Das System überträgt diesen durch den Datenbank-Dump. Oftmals ist dieser zusätzlich aus Performancegründen in das Dateisystem ausgelagert.

Überprüfen Sie daher, ob der Index ausgelagert ist:

Öffnen Sie links in der Seitenleiste Administration und dann MetaDB.

Öffnen Sie den Pfad:

 MAIN_MODULE_MANAGEMENT/textindexservice/control/syncdata/indexer

Prüfen Sie, ob das Property-Entry DoExportIndexToFS auf true steht.

Hinweise:
• Sie finden das entsprechende Verzeichnis im Property-Entry ExportIndexDirectory.
• Parallel zu diesem Ordner existiert ein weiterer Ordner mit dem gleichen Namen und dem Postfix _indexing.
• Übertragen Sie stets beide Verzeichnisse vom Quellsystem auf das Zielsystem.

Den Umzug bei Betriebssystemwechsel durchführen

Installieren Sie agorum core auf dem Zielsystem.
Beenden Sie agorum core auf dem Zielserver.
Überführen Sie die Datenbank des Quellservers durch einen Dump und eine Wiederherstellung in die Zieldatenbank.
Übertragen Sie die für die jeweilige Suchmaschine relevanten Daten.
Übertragen Sie die Daten des Moduls agorum core adminsync aus folgendem Pfad vom Quellsystem auf das Zielsystem, sofern Sie das Modul verwenden:
```
<InstallDir>/jboss/server/default/deploy/roi.ear/config
```
Übertragen Sie die Daten des Moduls agorum core storage und bereiten Sie die Anpassung für den Start vor, sofern Sie das Modul verwenden.

Hinweise:

• Übertragen Sie die Storage-Daten auf dem neuen Zielserver in das gewünschte Verzeichnis.
• In der MetaDB von agorum core stehen durch die Übertragung des Datenbank-Dumps noch die alten Pfade.
• Passen Sie den Pfad des Storages wie nachfolgend beschrieben an.

Den Storage-Pfad mit XML beim Start anpassen

Exportieren Sie auf dem Quellsystem den folgenden MetaDB-Pfad mit dem desk4web-Tool MetaDb Export als XML:
```
MAIN_MODULE_MANAGEMENT/backend/configurations/name-der-storage-konfiguration/parameters
```
Passen Sie die Pfade im XML an.
Legen Sie das XML auf dem Zielsystem in dieses Verzeichnis ab:
```
InstallDir-agorum/jboss/server/default/deploy/roi.ear/autoupdate/parseXMLs
```
Ergebnis:

• Das System führt das XML beim Start aus.
• Die Konfigurationsänderungen sind direkt beim Start aktiv.

Erklärung zur Anpassung
Ändert sich ein Pfad oder ändern sich mehrere Pfade eines Storages, stellt dies ein Problem dar. Möchten Sie die Pfade in einem produktiven System ändern, passen Sie diese in einem laufenden Betrieb an. Der alte Storage ist zu diesem Zeitpunkt noch vorhanden. Das System erstellt einen neuen und trägt diesen ein.

Bei einem Serverwechsel liegt allerdings eine neue Hardware vor. In diesem Fall stellen Sie sicher, dass sich die Pfade zu 100 % ähneln. Dann können Sie agorum core umziehen. Pfade und Daten sind immer noch dieselben.

Ändern sich allerdings die Pfade, etwa bei einem Betriebssystemwechsel, müssen Sie weitere Dinge beachten. Spielen Sie agorum core, so wie es ist, auf das andere Betriebssystem, wird es Probleme haben, die Pfade des Storage zu finden und deswegen abstürzen, da Sie die Pfade des alten Systems übertragen haben.

Erstellen Sie daher die beschriebene XML-Datei im Ordner autoupdate. Startet agorum core auf dem neuen System, ersetzt agorum core zuerst alle Dateien im Ordner autoupdate. In diesem Fall überschreibt das System die Einträge im desk4web mit den neuen Pfaden im neuen Betriebssystem. Erst dann startet agorum core, die Einträge im desk4web sind an das neue Betriebssystem angepasst. agorum core und auch der agorum core storage laufen erfolgreich weiter.

Solr-relevante Daten übertragen

Hinweis: Neu angelegte Solr- und zookeeper-Verzeichnisse auf dem Zielserver bleiben bestehen.

Übernehmen Sie folgende Unterverzeichnisse vom Quellserver und ersetzen Sie diese auf dem Zielserver:
```
<InstallDir>/solr/nodes
<InstallDir>/zookeeper/data
```

Den AdminSync-Schlüssel neu setzen

Hinweis: Die folgenden Schritte sind nur relevant, falls Sie das Modul agorum core adminsync verwenden.

Bei einem Umzug setzen Sie den für die Verschlüsselung eingesetzten Schlüssel im Modul agorum core adminsync neu. Wenn Sie diese Schritte nicht durchführen, scheitert die Synchronisierung mit dem Fehler Content is not allowed in prolog, da die synchronisierten Daten nicht entschlüsselt werden können.

Öffnen Sie links in der Seitenleiste Weitere Apps und dann desk4web.
Wählen Sie links im Menü AdminSync.
Wählen Sie rechts im Menü Vorgang > Konfigurator.

Menü Vorgang > Konfigurator wählen
Klicken Sie im Abschnitt Schlüssel auf Speichern.

Den E-Mail-Adapter per XML deaktivieren

<?xml version = "1.0" encoding="ISO-8859-1"?>
<ObjectList>
  <AMailMountpoint>
    <Update>/agorum/roi/Files/...../path to mail-mountpoint</Update>
    <!-- Disable automatic fetching -->
    <AMAILUPDATEINTERVAL>0</AMAILUPDATEINTERVAL>
  </AMailMountpoint>
</ObjectList>

Legen Sie das XML unter diesem Pfad ab:
```
InstallDir-agorum/jboss/server/default/deploy/roi.ear/autoupdate/parseXMLs
```
Ergebnis: Das System führt das XML beim Start aus, das XML ist direkt aktiv.

Die IP-Adressänderung prüfen

Prüfen Sie, ob sich Ihre IP-Adresse ändert. Falls ja, ändern Sie diese IP-Adresse überall dort, wo diese verwendet wurde, etwa in der Datei hosts.

Die Datenbank kontrollieren

In folgendem XML-Skript stehen Verbindungsdaten, die durch Datenbank- oder Server-Umzug eventuell nicht mehr stimmen. Wenn Sie eine andere Datenbank als MariaDB oder MySQL verwenden, kann der Dateiname abweichen.

<InstallDir>/agorumcore/jboss/server/default/deploy/mysql-ds.xml

Prüfen Sie, ob die folgenden blau markierten Daten korrekt sind und sich nicht geändert haben:

<?xml version="1.0" encoding="UTF-8"?>

<datasources>
 <local-tx-datasource>
   <jndi-name>DefaultDS</jndi-name>
    <connection-url><![CDATA[jdbc:mariadb://localhost:3306/roi?useUnicode=true&characterEncoding=UTF-8&useSSL=false]]>  </connection-url>
    <driver-class>org.mariadb.jdbc.Driver</driver-class>
    <user-name>root</user-name>
    <password><![CDATA[...]]></password>
    <check-valid-connection-sql>select 1</check-valid-connection-sql>
    <min-pool-size>5</min-pool-size>
    <max-pool-size>500</max-pool-size>
   </local-tx-datasource>
</datasources>

Server-Daten
localhost oder roihost oder IP-Adresse

Port
3306 (Standard-Port von MySQL und MariaDB. Falls belegt, können Sie manuell einen anderen wählen)

Username
root

Korrigieren Sie die Daten, falls sie sich geändert haben.
Starten Sie agorum core neu.