Aktualisierungsanweisungen für die Version 2024.10.0
Dieser Artikel behandelt die Upgrade-Anweisungen und die Kompatibilitätsmatrix für die Version 2024.10.0 von Adobe Experience Manager Guides as a Cloud Service.
Weitere Informationen zu den neuen Funktionen und Verbesserungen finden Sie unter Neue Funktionen in Version 2024.10.0.
Eine Liste der in dieser Version behobenen Probleme finden Sie im Artikel Behobene Probleme in Version 2024.10.0.
Kompatibilitätsmatrix
In diesem Abschnitt wird die Kompatibilitätsmatrix für die Softwareanwendungen aufgelistet, die von der Version 2024.10.0 von Experience Manager Guides as a Cloud Service unterstützt werden.
FrameMaker und FrameMaker Publishing Server
Sauerstoffanschluss
Version der Wissensdatenbankvorlage
Upgrade auf Version 2024.10.0
Experience Manager Guides wird nach dem Upgrade der aktuellen (neuesten) Version von Experience Manager as a Cloud Service automatisch aktualisiert.
- ui_config.json (kann in Ordnerprofilen festgelegt worden sein)
Führen Sie die folgenden Schritte für Experience Manager Guides as a Cloud Service durch, wenn Sie es nicht schon früher für Ihre bestehende Version getan haben:
Schritte zum Aktivieren des Triggers eines Skripts über ein Servlet
(Nur bei Versionen vor der Version Juni 2023 von Experience Manager Guides as a Cloud Service)
Nach Abschluss der Installation 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 lockNodePath den Pfad zum Knoten , der im Repository erstellt wurde und auf den gesendeten Auftrag verweist. Er wird automatisch gelöscht, sobald der Auftrag abgeschlossen ist, und Sie können in diesem Knoten den Status des Auftrags abrufen.
Warten Sie, bis dieser Vorgang abgeschlossen ist, bevor Sie mit den nächsten Schritten fortfahren.
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
Schritte zur Nachbearbeitung des vorhandenen Inhalts, um den Bericht über fehlerhafte Links zu verwenden
(Nur bei Versionen vor der Version Juni 2023 von Experience Manager Guides as a Cloud Service)
Führen Sie die folgenden Schritte aus, um den vorhandenen Inhalt nachzuverarbeiten und den neuen Bericht „Beschädigter Link“ zu verwenden:
-
(Optional) Wenn mehr als 100.000 DITA-Dateien im System vorhanden sind, aktualisieren Sie die
queryLimitReadsundqueryLimitInMemoryunterorg.apache.jackrabbit.oak.query.QueryEngineSettingsServiceauf einen größeren Wert (einen beliebigen 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 Details (Eigenschaft) zum Konfigurieren der
queryLimitReads- undqueryLimitInMemoryan:table 0-row-3 1-row-3 2-row-3 PID Eigenschaftsschlüssel Eigenschaftswert org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Wert: 200000 Standardwert: 100000 org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitInMemory Wert: 200000 Standardwert: 100000
-
-
Ausführen einer POST-Anfrage an den Server (mit korrekter 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) -
Sobald der Auftrag abgeschlossen ist, antwortet die vorherige GET-Anfrage mit Erfolg. Wenn der Vorgang aus irgendeinem Grund fehlschlägt, kann der Fehler in den Serverprotokollen angezeigt werden.
-
Kehren Sie zum Standardwert oder vorherigen vorhandenen Wert von
queryLimitReadszurück, wenn Sie ihn in Schritt 1 geändert haben.
Schritte zum Indizieren des vorhandenen Inhalts, um die neue Themenliste „Suchen und Ersetzen“ auf der Registerkarte „Berichte“ zu verwenden:
(Nur bei Versionen vor der Version Juni 2023 von Experience Manager Guides as a Cloud Service)
Führen Sie die folgenden Schritte aus, um den vorhandenen Inhalt zu indizieren und den neuen Text „Suchen und Ersetzen“ auf Zuordnungsebene und in der Themenliste auf der Registerkarte „Berichte“ zu verwenden:
-
Ausführen einer POST-Anfrage an den Server (mit korrekter Authentifizierung) -
http://<server:port>/bin/guides/map-find/indexing. (Optional: Sie können bestimmte Pfade der Zuordnungen übergeben, um sie zu indizieren. Standardmäßig werden alle Zuordnungen indiziert.|| Beispiel :https://<Server:port>/bin/guides/map-find/indexing?paths=<path of the MAP in repository>) -
Sie können auch einen Stammordner übergeben, um die DITA-Zuordnungen eines bestimmten Ordners (und seiner Unterordner) zu indizieren. Beispiel:
http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test. Beachten Sie, dass nur der Pfadparameter berücksichtigt wird, wenn sowohl der Pfadparameter als auch der Stammparameter übergeben werden. -
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:port>/bin/guides/map-find/indexing?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 mit Erfolg und gibt an, ob Zuordnungen fehlschlagen. Die erfolgreich indizierten Zuordnungen können über Serverprotokolle bestätigt werden.
Schritte zum Umgang mit dem 'fmdita rewriter'
Experience Manager Guides verfügt über Modul „Benutzerdefiniertes Sling Rewriter, in dem die Links verarbeitet werden, die bei Kreuzzuordnungen (Verknüpfungen zwischen den Themen zweier verschiedener Zuordnungen) generiert werden.
Wenn Sie einen anderen benutzerdefinierten Sling Rewriter in Ihrer Codebasis haben, 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 Output-Umschreibungs-Pipelines.
Da während dieses Upgrades der 'order' von 1000 auf 50 geändert wird, müssen Sie den vorhandenen benutzerdefinierten Rewriter (sofern vorhanden) mit fmdita-rewriter zusammenführen.
Schritte zur Durchführung der B-Tree-Migration für Inhaltsfragmente
Wenn für Inhaltsfragmente keine Verweise angezeigt werden, können Sie festlegen, dass der Trigger aufgerufen wird, um den Migrationsvorgang zu starten:
POST:
http://localhost:4503/bin/guides/script/start?jobType=cf-reference-store-btree-migration
Antwort:
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/cf-reference-store-btree-migration/1683190032886",
"status": "SCHEDULED"
}
In der vorherigen Antwort, JSON, enthält der lockNodePath den Pfad zu dem im Repository erstellten Knoten, der auf den gesendeten Auftrag verweist. Sie wird automatisch gelöscht, sobald der Vorgang abgeschlossen ist. Sie können auf diesem Knoten nach dem Status des Auftrags suchen.
Warten Sie, bis dieser Vorgang abgeschlossen ist, bevor Sie mit den nächsten Schritten fortfahren.
GET:
http://<aem_domain>/var/dxml/executor-locks/cf-reference-store-btree-migration/1683190032886.json