Upgrade-Anweisungen für Version 2024.2.0
In diesem Artikel werden die Upgrade-Anweisungen und die Kompatibilitätsmatrix für die Version 2024.2.0 von Adobe Experience Manager Guides as a Cloud Service beschrieben.
Weitere Informationen zu den neuen Funktionen und Verbesserungen finden Sie unter Neue Funktionen in Version 2024.2.0.
Sehen Sie sich für die Liste der in dieser Version behobenen Probleme Behobene Probleme in Version 2024.2.0 an.
Kompatibilitätsmatrix
In diesem Abschnitt wird die Kompatibilitätsmatrix für die von Version 2024.2.0 von Experience Manager Guides as a Cloud Service unterstützten Softwareanwendungen aufgeführt.
FrameMaker und FrameMaker Publishing Server
Sauerstoffanschluss
Knowledgebase-Vorlagenversion
Aktualisierung auf Version 2024.2.0
Experience Manager Guides wird beim Upgrade der aktuellen (aktuellen) Version von Experience Manager as a Cloud Service automatisch aktualisiert.
Führen Sie die folgenden Schritte für Experience Manager Guides as a Cloud Service aus, wenn Sie noch keine frühere Version für Ihre bestehende Version erstellt haben:
Schritte zum Aktivieren des Triggers eines Skripts über ein Servlet
(Nur wenn Sie eine Version vor der Experience Manager Guides as a Cloud Service-Version vom Juni 2023 haben)
Nachdem Sie die Installation abgeschlossen haben, können Sie den Trigger drücken, um den Übersetzungsauftrag zu starten:
POST:
http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade
Antwort:
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}
In der vorherigen Antwort-JSON enthält der Schlüssel lockNodePath
den Pfad zum Knoten, der im Repository erstellt wurde und auf den gesendeten Auftrag verweist. Sobald der Auftrag abgeschlossen ist, wird er automatisch gelöscht. In diesem Knoten können Sie den Status des Auftrags nachlesen.
Warten Sie, bis dieser Auftrag abgeschlossen ist, bevor Sie mit den nächsten Schritten fortfahren.
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
Schritte zum Nachbearbeiten des vorhandenen Inhalts zur Verwendung des Berichts über einen fehlerhaften Link
(Nur wenn Sie eine Version vor der Experience Manager Guides as a Cloud Service-Version vom Juni 2023 haben)
Führen Sie die folgenden Schritte für die Nachbearbeitung des vorhandenen Inhalts und die Verwendung des neuen Berichts über fehlerhafte Links aus:
-
(Optional) Wenn mehr als 100.000 DITA-Dateien im System vorhanden sind, aktualisieren Sie die
queryLimitReads
undqueryLimitInMemory
unterorg.apache.jackrabbit.oak.query.QueryEngineSettingsService
auf einen größeren Wert (ein beliebiger Wert, der größer ist als die Anzahl der vorhandenen Assets, z. B. 200.000), und stellen Sie dann erneut bereit.-
Verwenden Sie die Anweisungen im Abschnitt Konfigurationsüberschreibungen unter Installieren und Konfigurieren von Adobe Experience Manager Guides as a Cloud Service , um die Konfigurationsdatei zu erstellen.
-
Geben Sie in der Konfigurationsdatei die folgenden (Eigenschaft-)Details an, um die Optionen
queryLimitReads
undqueryLimitInMemory
zu konfigurieren:table 0-row-3 1-row-3 2-row-3 PID Eigenschaftenschlüssel Eigenschaftswert org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Wert: 200000 Standardwert: 100000 org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitInMemory Wert: 200000 Standardwert: 100000
-
-
Führen Sie eine POST-Anfrage an den Server aus (mit der richtigen Authentifizierung) -
http://<server>//bin/guides/reports/upgrade
. -
Die API gibt eine jobId zurück. Um den Status des Auftrags zu überprüfen, können Sie eine GET-Anfrage mit Auftrags-ID an denselben Endpunkt senden -
http://<server>/bin/guides/reports/upgrade?jobId= {jobId}
(Beispiel:http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
) -
Nach Abschluss des Auftrags antwortet die vorherige GET-Anfrage erfolgreich. Wenn der Auftrag aus irgendeinem Grund fehlschlägt, kann in den Serverprotokollen ein Fehler angezeigt werden.
-
Kehren Sie zurück zum standardmäßigen oder vorherigen vorhandenen Wert von
queryLimitReads
zurück, wenn Sie ihn in Schritt 1 geändert haben.
Schritte zum Indexieren des vorhandenen Inhalts zur Verwendung der neuen Suchen- und Ersetzen- und Themenliste auf der Registerkarte Berichte :
(Nur wenn Sie eine Version vor der Experience Manager Guides as a Cloud Service-Version vom Juni 2023 haben)
Führen Sie die folgenden Schritte aus, um den vorhandenen Inhalt zu indizieren und den neuen Text auf Zuordnungs- und Themenliste auf der Registerkarte Berichte zu finden und zu ersetzen:
-
Führen Sie eine POST-Anfrage an den Server aus (mit der richtigen Authentifizierung) -
http://<server:port>/bin/guides/map-find/indexing
. (Optional: Sie können bestimmte Pfade der Maps übergeben, um sie zu indizieren. Standardmäßig werden alle Maps indiziert| Beispiel:https://<Server:port>/bin/guides/map-find/indexing?paths=<path of the MAP in repository>
) -
Die API gibt eine jobId zurück. Um den Auftragsstatus zu überprüfen, können Sie eine GET-Anfrage mit Auftrags-ID an denselben Endpunkt senden -
http://<server:port>/bin/guides/map-find/indexing?jobId={jobId}
(z. B.http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
) -
Nach Abschluss des Auftrags antwortet die vorherige GET-Anfrage erfolgreich. Wenn der Auftrag aus irgendeinem Grund fehlschlägt, kann in den Serverprotokollen ein Fehler angezeigt werden.
-
Kehren Sie zum standardmäßigen oder vorherigen vorhandenen Wert von queryLimitReads zurück, wenn Sie ihn in Schritt 1 geändert haben.
Schritte zur Handhabung des 'fmdita rewriter'
-Konflikts
Experience Manager Guides verfügt über ein benutzerdefinierter Sling-Rewriter -Modul für die Verarbeitung der im Fall von Querverweisen generierten Links (Links zwischen den Themen zweier verschiedener Maps).
Wenn Sie in Ihrer Codebasis über einen anderen benutzerdefinierten Sling-Rewriter verfügen, verwenden Sie einen 'order'
-Wert größer als 50, da der Experience Manager Guides Sling-Rewriter 'order'
50 verwendet. Um dies zu überschreiben, benötigen Sie einen Wert > 50. Weitere Informationen finden Sie unter Pipelines zum Neuschreiben der Ausgabe.
Da während dieses Upgrades der Wert 'order'
von 1000 auf 50 geändert wird, müssen Sie die vorhandene benutzerdefinierte Rewriter, falls vorhanden, mit 'fmdita-rewriter'
zusammenführen.