Adobe Experience Manager Guides aktualisieren id224MBE0M0XA
Sie können Ihre aktuelle Version von Experience Manager Guides auf Version 5.1.0 aktualisieren:
- Wenn Sie Version 4.6.3, 4.6.4, 5.0.0, 5.0.0 Service Pack 1 oder 5.0.0 Service Pack 2 verwenden, können Sie direkt auf Version 5.1.0 aktualisieren.
- Wenn Sie Version 4.6.0, 4.6.1 verwenden, müssen Sie auf Version 4.6.3 oder 4.6.4 oder 5.0.0 aktualisieren, bevor Sie auf Version 5.1.0 aktualisieren.
- Wenn Sie Version 4.3.x, 4.2, 4.2.1 (Hotfix 4.2.1.3), 4.1 oder 4.1.x verwenden, müssen Sie vor dem Upgrade auf Version 5.0.0 ein Upgrade auf Version 4.4 durchführen.
- Wenn Sie Version 4.0 verwenden, müssen Sie auf Version 4.2 aktualisieren, bevor Sie auf Version 4.3.x aktualisieren.
- Wenn Sie Version 3.8.5 verwenden, müssen Sie auf Version 4.0 aktualisieren, bevor Sie auf Version 4.2 aktualisieren.
- Wenn Sie eine Version vor 3.8.5 verwenden, lesen Sie den Abschnitt zum Upgrade von Experience Manager Guides im produktspezifischen Installationshandbuch, das auf der Adobe Experience Manager Guides-Hilfe für PDF Archive verfügbar ist.
Weitere Informationen finden Sie in den folgenden Verfahren:
- Upgrade von 3.8.5 auf Version 4.0
- Aktualisierung auf Version 4.2
- Aktualisierung auf Version 4.2.1
- Aktualisierung auf Version 4.3.0
- Aktualisierung auf Version 4.3.1
- Aktualisieren auf Version 4.3.1.5
- Aktualisierung auf Version 4.4.0
- Aktualisieren auf Version 4.6.0
- Aktualisieren auf Version 5.0.0
- Aktualisierung auf Version 5.1.0
Upgrade von Version 3.8.5 auf Version 4.0
Wenn Sie Experience Manager Guides Version 3.8.5 verwenden, können Sie auf Version 4.0 von Experience Manager Guides aktualisieren. Mit der Upgrade-Funktion müssen Sie die vorherige Version von Experience Manager Guides nicht deinstallieren.
Vor Ausführung des Prozesses gibt es bestimmte Aufgaben, die Sie abschließen müssen. Die folgenden Unterabschnitte führen Sie durch die Voraussetzungen, die Berichterstellung und den Migrationsprozess. Nach der Installation von Experience Manager Guides Version 4.0 können Sie außerdem verschiedene Konfigurationen entsprechend den Kundeneinstellungen anpassen.
Voraussetzungen
Bevor Sie mit dem Experience Manager Guides-Upgrade-Prozess beginnen, stellen Sie sicher, dass die folgenden Punkte erfüllt sind:
- Die Überprüfungskommentare in Themen importiert, die zur Überprüfung geöffnet sind.
- Alle aktiven Rezensionen wurden geschlossen.
- Alle Übersetzungsaufgaben geschlossen.
- Deinstallieren Sie alle Experience Manager Guides-Hotfixes, die oben auf der vorherigen Version (Haupt- oder Patch-Version) von Experience Manager Guides installiert sind.
Vor der Installation von Version 4.0
Führen Sie vor der Installation von Version 4.0 die folgenden Schritte aus:
- Stellen Sie sicher, dass Experience Manager Guides derzeit Version 3.8.5 verwendet.
- Laden Sie das Paket mit dem Upgrade-Skript herunter. Suchen Sie dazu im Adobe Software Distribution-Portal nach "XML Documentation-Lösungs-4.0-UpgradePaket“, wodurch eine ZIP-Datei heruntergeladen wird.
- Laden Sie dieses Paket über Package Manager in AEM hoch und installieren Sie es.
- Sobald das Upgrade-Paket installiert ist, führen Sie die folgenden Skripte in der gleichen Reihenfolge aus und befolgen Sie die angegebenen Anweisungen:
Upgrade-Kompatibilitäts-API überprüfen
Diese API dient dazu, den aktuellen Systemstatus zu bewerten und Berichte zu erstellen, ob das Upgrade möglich ist oder nicht. Um dieses Skript auszuführen, geben Sie den folgenden Trigger für den Endpunkt ein:
- Wenn am Zielspeicherort ein Knoten vorhanden ist, wird ein relevanter Fehler angezeigt. Bereinigen Sie das Repository (löschen Sie den Knoten /var/dxml) und installieren Sie das Aktualisierungspaket erneut. Führen Sie dann erneut einen Trigger mit diesem Endpunkt durch.
Hinweis: Dies ist kein häufiger Fehler, da der Zielspeicherort von 3.x Experience Manager Guides nicht zuvor verwendet wird.
- Wenn dieses Skript nicht erfolgreich ist, fahren Sie nicht fort und melden Sie es Ihrem Customer Success-Team.
Systemdatenmigrations-API
Diese API dient zur Migration der Systemdaten, wie im Abschnitt Migrationszuordnung beschrieben.
- Führen Sie dieses Skript nicht aus, wenn die API zur Überprüfung der Upgrade-Kompatibilität fehlschlägt (fahren Sie nicht fort).
- Sobald die API zur Überprüfung der Aktualisierungskompatibilität erfolgreich war, können Sie das Aktualisierungsskript ausführen.
- Wenn Fehler auftreten, stellen Sie den letzten Checkpoint wieder her und geben Sie die Fehlerprotokolle zusammen mit der API-Ausgabe an Ihr Customer Success-Team weiter.
Migrationszuordnung: Die obige API migriert alle Daten unter dem Quellspeicherort zum Zielspeicherort.
Installieren von Version 4.0 id23598G006XA
-
Installieren Sie Version 4.0 nur, wenn die Upgrade-Schritte erfolgreich waren.
-
Laden Sie das Versionspaket 4.0 vom Adobe Software Distribution-Portal herunter:
- Wenn Sie die UUID-Version der -Software verwenden, suchen Sie nach „4.0 UUID Release for XML Documentation Solution for AEM 6.5“.
- Wenn Sie eine Nicht-UUID-Version von Software verwenden, suchen Sie nach „4.0 Non-UUID Release for XML Documentation Solution for AEM 6.5“.
Laden Sie das Paket mit CRX Package Manager in die bestehende(n) AEM-Server-Instanz(en) hoch und installieren Sie es.
note note NOTE Warten Sie, bis alle Systemkomponenten gestartet wurden. -
Löschen Sie den Browser-Cache nach der Installation des Pakets.
-
Wenn ein Dispatcher in der AEM-Autoreninstanz konfiguriert ist, führen Sie die folgenden Schritte aus:
- Stellen Sie sicher, dass in Dispatcher-Regeln Folgendes verarbeitet wird:
- Das URL-Muster /home/users/*/preferences wird auf die Whitelist gesetzt.
- Das URL-Muster /libs/cq/security/userinfo.json wird nicht zwischengespeichert.
-
Dispatcher-Cache löschen (um alle zwischengespeicherten
clientlibs
zu löschen).
Aktualisierung auf Version 4.2
Die Aktualisierung auf Version 4.2 hängt von der aktuellen Version von Experience Manager Guides ab.
Wenn Sie Version 4.0, 4.1 oder 4.1.x verwenden, können Sie direkt auf Version 4.2 aktualisieren.
Voraussetzungen
Bevor Sie mit dem Upgrade auf Experience Manager Guides 4.2 beginnen, stellen Sie Folgendes sicher:
- Auf Experience Manager Guides Version 4.0, 4.1 oder 4.1.x aktualisiert.
- Alle Übersetzungsaufgaben geschlossen.
- Protokollebene für Klasse in ""
com.adobe.fmdita.translationservices.TranslationMapUpgradeScript
und diese Protokolle in einer neuen Protokolldatei anhängen, z. B.logs/translation_upgrade.log.
Installieren von Version 4.2 id2245IK0E0EV
-
Laden Sie das Versionspaket 4.2 vom Adobe Software Distribution Portal herunter.
-
Installieren Sie das Paket Version 4.2 .
-
Warten Sie nach Abschluss der Paketinstallation in den Protokollen auf die folgende(n) Meldung(en):
Completed the post deployment setup script
Die obige Meldung weist darauf hin, dass alle Installationsschritte abgeschlossen sind.
Falls Sie auf eines der folgenden FEHLER-Präfixe stoßen, melden Sie dies Ihrem Customer Success-Team:
- Fehler im Setup-Skript nach der Bereitstellung
- Ausnahme bei der Portierung des Übersetzungs-MAP
- Die Übersetzungszuordnung kann für die Eigenschaft nicht von v1 auf v2 portiert werden
-
Upgrade des Oxygen Connector-Plug-ins, das mit Version 4.2 veröffentlicht wurde (falls erforderlich).
-
Löschen Sie den Browser-Cache nach der Installation des Pakets.
-
Fahren Sie mit dem Upgrade der Anpassungen fort, wie im nächsten Abschnitt beschrieben.
Nach der Installation von Version 4.2 id2326F02004K
Nach der Installation von Experience Manager Guides können Sie die verschiedenen Konfigurationen, die für die neu installierte Version gelten, mit Ihrem Setup zusammenführen.
-
Workflow „DAM-Update-Asset“ (Änderungen nach der Verarbeitung):
-
URL öffnen:
code language-http http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
-
Wählen Sie Workflow DAM-Update-Asset.
-
Klicken Sie auf Bearbeiten.
-
Wenn die DXML Post Process Initiator-Komponente vorhanden ist, stellen Sie sicher, dass die Anpassungen synchronisiert werden.
-
Wenn die DXML Post Process Initiator-Komponente fehlt, führen Sie die folgenden Schritte aus, um sie einzufügen:
-
Klicken Sie Komponente einfügen (Verantwortlich für die Nachbearbeitung von Experience Manager Guides als letzter Schritt im Prozess).
-
Konfigurieren Sie den Prozessschritt mit den folgenden Details:
Registerkarte „Allgemein“
title: DXML-Nachbearbeitungs-Initiator
Beschreibung: Schritt „DXML-Nachbearbeitungs-Initiator“, der einen Sling-Auftrag für die DXML-Nachbearbeitung des geänderten/erstellten Assets Trigger
Registerkarte „Prozess“
-
Wählen Sie DXML Post Process Initiator aus der Dropdown Prozess aus
-
Wählen Sie Handler-Fortschritt aus
-
Wählen Sie Fertig
-
-
Klicken Sie rechts oben den Änderungen auf „Synchronisieren“. Sie erhalten eine Erfolgsbenachrichtigung.
note note NOTE Aktualisieren Sie und überprüfen Sie, ob benutzerdefinierte Änderungen und der Experience Manager Guides-Nachbearbeitungsschritt im endgültigen Workflow-Modell vorhanden sind. -
Nachdem Workflow DAM-Update-Asset validiert wurde, überprüfen Sie die entsprechenden Starter-Konfigurationen. Gehen Sie dazu zur Workflow-Benutzeroberfläche von AEM und öffnen Sie Starter.
code language-http http://localhost:4502/libs/cq/workflow/content/console.html
Suchen Sie die beiden folgenden Starter (die aktiv sein sollten) und nehmen Sie entsprechende Änderungen vor (falls erforderlich), die dem Workflow DAM-Update-Asset entsprechen:
-
Starter für "Knoten erstellt" für Workflow DAM-Update-Asset- für
"jcr:content/jcr:mimeType!=video"
sollte der Wert „Globbing“ sein:code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
- „excludeList“ muss
"event-user-data:changedByWorkflowProcess"
haben. - Starter für "Node Modified" für DAM Update Asset Workflow - für Bedingung "
jcr:content/jcr:mimeType!=video
", - Der Wert für „Globbing“ sollte sein:
code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
- „excludeList“ muss
"event-user-data:changedByWorkflowProcess"
haben.
- „excludeList“ muss
-
Nachdem das Upgrade abgeschlossen ist, stellen Sie sicher, dass alle Anpassungen/Überlagerungen validiert und aktualisiert werden, damit sie dem neuen Anwendungs-Code entsprechen. Im Folgenden finden Sie einige Beispiele:
- Alle Komponenten, die von /libs/fmdidator/libs überlagert sind, sollten mit dem neuen Produkt-Code verglichen werden und Aktualisierungen sollten in überlagerten Dateien unter /apps vorgenommen werden.
- Alle Client-Bibliothekskategorien, die vom Produkt verwendet werden, sollten auf Änderungen überprüft werden. Alle überschriebenen Konfigurationen (Beispiele unten) sollten mit den neuesten verglichen werden, um die neuesten Funktionen zu erhalten:
- elementmapping.xml
- ui_config.json(wurde möglicherweise in Ordnerprofilen festgelegt)
- geänderte
com.adobe.fmdita.config.ConfigManager
- Überprüfen Sie, ob einer der benutzerdefinierten Codes alte Pfade verwendet hat (wie im Abschnitt Migrationszuordnung) - sollte auf die neuen Pfade aktualisiert werden, damit die Anpassungen ebenfalls erwartungsgemäß funktionieren.
-
Lesen Sie alle neuen Konfigurationen, die in der aktuellen Version bereitgestellt werden (überprüfen Sie Versionshinweise), und überprüfen Sie, ob Funktionen betroffen sind. Ein Beispiel könnte die Verwendung von „Verbessertes Datei- und Versionsmanagement“ sein, die in Version 4.0 eingeführt wurde und für die Sie eine Konfiguration aktivieren müssen.
Schritte zum Indizieren des vorhandenen Inhalts für die Verwendung des neuen Such- und Ersetzungsmodus:
Führen Sie die folgenden Schritte aus, um den vorhandenen Inhalt zu indizieren und den neuen Text „Suchen und Ersetzen“ auf Zuordnungsebene zu verwenden:
-
Führen Sie eine POST-Anfrage an den Server (mit korrekter Authentifizierung) -
http://<server:port\>/bin/guides/map-find/indexing
aus. (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=<map\_path\_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\}
(Beispiel: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42
)
- Sobald der Vorgang abgeschlossen ist, wird die obige GET-Anfrage erfolgreich beantwortet und es wird angegeben, ob Zuordnungen fehlgeschlagen sind. Die erfolgreich indizierten Zuordnungen können aus den Serverprotokollen bestätigt werden.
Wenn der Upgrade-Auftrag fehlschlägt und das Fehlerprotokoll den folgenden Fehler anzeigt:
„Die Abfrage mehr als 100000 Knoten gelesen oder durchlaufen. Um andere Aufgaben nicht zu beeinträchtigen, wurde die Verarbeitung angehalten.“
Dies kann vorkommen, da der Index für die beim Upgrade verwendete Abfrage nicht ordnungsgemäß eingerichtet ist. Sie können die folgende Problemumgehung ausprobieren:
-
Fügen Sie im damAssetLucene-Oak-Index die boolesche Eigenschaft
indexNodeName
wie im Knotentrue
hinzu./oak:index/damAssetLucene/indexRules/dam:Asset
-
Fügen Sie einen neuen Knoten mit dem Namen „excerpt“ unter dem Knoten hinzu.
/oak:index/damAssetLucene/indexRules/dam:Asset/properties
und legen Sie die folgenden Eigenschaften im Knoten fest:code language-none name - rep:excerpt propertyIndex - {Boolean}true notNullCheckEnabled - {Boolean}true
Die Struktur von
damAssetLucene
sollte in etwa so aussehen:code language-none <damAssetLucene compatVersion="{Long}2" async="async, nrt" jcr:primaryType="oak:QueryIndexDefinition" evaluatePathRestrictions="{Boolean}true" type="lucene"> <indexRules jcr:primaryType="nt:unstructured"> <dam:Asset indexNodeName="{Boolean}true" jcr:primaryType="nt:unstructured"> <properties jcr:primaryType="nt:unstructured"> <excerpt name="rep:excerpt" propertyIndex="{Boolean}true" jcr:primaryType="nt:unstructured" notNullCheckEnabled="{Boolean}true"/> </properties> </dam:Asset> </indexRules> </damAssetLucene>
(zusammen mit anderen vorhandenen Knoten und Eigenschaften)
-
Indizieren Sie den
damAssetLucene
neu (indem Sie das Flag für die Neuindizierung auftrue
unter festlegen).
und warten Sie, bis sie erneutfalse
wird (dies bedeutet, dass die Neuindizierung abgeschlossen ist). Beachten Sie, dass es je nach Größe des Index einige Stunden dauern kann. -
Führen Sie das Indizierungsskript erneut aus, indem Sie die vorherigen Schritte ausführen.
Aktualisierung auf Version 4.2.1
Die Aktualisierung auf Version 4.2.1 hängt von der aktuellen Version von Experience Manager Guides ab. Wenn Sie Version 4.1, 4.1.x oder 4.2 verwenden, können Sie direkt auf Version 4.2.1 aktualisieren.
Voraussetzungen
Stellen Sie vor dem Start des Upgrades auf Experience Manager Guides 4.2.1 Folgendes sicher:
- Auf Experience Manager Guides Version 4.1, 4.1.x oder 4.2 aktualisiert.
- Alle Übersetzungsaufgaben geschlossen.
- Protokollebene für Klasse in ""
com.adobe.fmdita.translationservices.TranslationMapUpgradeScript
und diese Protokolle in einer neuen Protokolldatei anhängen, z. B.logs/translation_upgrade.log.
Installieren von Version 4.2.1
-
Laden Sie das Versionspaket 4.2.1 vom Adobe Software Distribution Portal herunter.
-
Installieren Sie das Paket Version 4.2.1 .
-
Sie können den Trigger drücken, um den Upgrade-Auftrag für die Übersetzungskarte zu starten. Weitere Informationen finden Sie unter Aktivieren des Skript-Triggers über ein Servlet.
-
Warten Sie nach Abschluss der Paketinstallation in den Protokollen auf die folgende(n) Meldung(en):
Completed the post deployment setup script
Die obige Meldung weist darauf hin, dass alle Installationsschritte abgeschlossen sind.
Falls Sie auf eines der folgenden FEHLER-Präfixe stoßen, melden Sie dies Ihrem Customer Success-Team:
- Fehler im Setup-Skript nach der Bereitstellung
- Ausnahme bei der Portierung des Übersetzungs-MAP
- Die Übersetzungszuordnung kann für die Eigenschaft nicht von v1 auf v2 portiert werden
-
Upgrade des Oxygen Connector-Plug-ins, das mit Version 4.2 veröffentlicht wurde (falls erforderlich).
-
Löschen Sie den Browser-Cache nach der Installation des Pakets.
-
Fahren Sie mit dem Upgrade der Anpassungen fort, wie im nächsten Abschnitt beschrieben.
Aktivieren des Skript-Triggers über ein Servlet (für 4.2.1)
BEITRAG:
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 obigen Antwort-JSON enthält der lockNodePath
den Pfad zum Knoten , der im Repository erstellt wurde und auf den gesendeten Auftrag verweist. Sie wird automatisch gelöscht, sobald der Auftrag abgeschlossen ist. Bis dahin können Sie in diesem Knoten den aktuellen Status des Auftrags abrufen.
Beispielprotokoll:
Im Folgenden finden Sie ein Beispiel für Protokolle, die in der Protokolldatei angezeigt werden, nachdem Sie das Skript Trigger haben.
04.05.2023 14:17:12.876 *INFO* [[0:0:0:0:0:0:0:1] [1683190032736] POST /bin/guides/script/start HTTP/1.1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Acquiring lock for job : translation-map-upgrade
04.05.2023 14:17:12.897 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Starting the thread to upgrade translation map from V1 to V2
04.05.2023 14:17:12.899 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Initiating lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.901 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Starting porting of translation map from V1 to V2
04.05.2023 14:17:12.904 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Memory increase is of : 764 kB
04.05.2023 14:17:12.906 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2
04.05.2023 14:17:12.907 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Releasing lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.909 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2
Suchen Sie nach com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2
und com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2
, bevor Sie mit den nächsten Schritten fortfahren.
Nach der Installation von Version 4.2.1
Nach der Installation von Experience Manager Guides können Sie die verschiedenen Konfigurationen, die für die neu installierte Version gelten, mit Ihrem Setup zusammenführen.
-
Workflow „DAM-Update-Asset“ (Änderungen nach der Verarbeitung):
-
URL öffnen:
code language-http http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
-
Wählen Sie Workflow DAM-Update-Asset.
-
Klicken Sie auf Bearbeiten.
-
Wenn die DXML Post Process Initiator-Komponente vorhanden ist, stellen Sie sicher, dass die Anpassungen synchronisiert werden.
-
Wenn die DXML Post Process Initiator-Komponente fehlt, führen Sie die folgenden Schritte aus, um sie einzufügen:
-
Klicken Sie Komponente einfügen (Verantwortlich für die Nachbearbeitung von Experience Manager Guides als letzter Schritt im Prozess).
-
Konfigurieren Sie den Prozessschritt mit den folgenden Details:
Registerkarte „Allgemein“
title: DXML-Nachbearbeitungs-Initiator
Beschreibung: Schritt „DXML-Nachbearbeitungs-Initiator“, der einen Sling-Auftrag für die DXML-Nachbearbeitung des geänderten/erstellten Assets Trigger
Registerkarte „Prozess“
-
Wählen Sie DXML Post Process Initiator aus der Dropdown Prozess aus
-
Wählen Sie Handler-Fortschritt aus
-
Wählen Sie Fertig
-
-
Klicken Sie rechts oben den Änderungen auf „Synchronisieren“. Sie erhalten eine Erfolgsbenachrichtigung.
note note NOTE Aktualisieren Sie und überprüfen Sie, ob benutzerdefinierte Änderungen und der Experience Manager Guides-Nachbearbeitungsschritt im endgültigen Workflow-Modell vorhanden sind. -
Nachdem Workflow DAM-Update-Asset validiert wurde, überprüfen Sie die entsprechenden Starter-Konfigurationen. Gehen Sie dazu zur Workflow-Benutzeroberfläche von AEM und öffnen Sie Starter.
code language-http http://localhost:4502/libs/cq/workflow/content/console.html
Suchen Sie die beiden folgenden Starter (die aktiv sein sollten) und nehmen Sie entsprechende Änderungen vor (falls erforderlich), die dem Workflow DAM-Update-Asset entsprechen:
-
Starter für "Knoten erstellt" für Workflow DAM-Update-Asset- für
"jcr:content/jcr:mimeType!=video"
sollte der Wert „Globbing“ sein:code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
- „excludeList“ muss
"event-user-data:changedByWorkflowProcess"
haben. - Starter für "Node Modified" für DAM Update Asset Workflow - Für Bedingung "
jcr:content/jcr:mimeType!=video
" sollte der Wert „Globbing“ sein:
code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
excludeList
sollte"event-user-data:changedByWorkflowProcess"
haben.
- „excludeList“ muss
-
Nachdem das Upgrade abgeschlossen ist, stellen Sie sicher, dass alle Anpassungen/Überlagerungen validiert und aktualisiert werden, damit sie dem neuen Anwendungs-Code entsprechen. Im Folgenden finden Sie einige Beispiele:
- Alle Komponenten, die von /libs/fmdidator/libs überlagert sind, sollten mit dem neuen Produkt-Code verglichen werden und Aktualisierungen sollten in überlagerten Dateien unter /apps vorgenommen werden.
- Alle Client-Bibliothekskategorien, die vom Produkt verwendet werden, sollten auf Änderungen überprüft werden. Alle überschriebenen Konfigurationen (Beispiele unten) sollten mit den neuesten verglichen werden, um die neuesten Funktionen zu erhalten:
- elementmapping.xml
- ui_config.json(wurde möglicherweise in Ordnerprofilen festgelegt)
- geänderte
com.adobe.fmdita.config.ConfigManager
- Überprüfen Sie, ob einer der benutzerdefinierten Codes alte Pfade verwendet hat (wie im Abschnitt Migrationszuordnung) - sollte auf die neuen Pfade aktualisiert werden, damit die Anpassungen ebenfalls erwartungsgemäß funktionieren.
-
Lesen Sie alle neuen Konfigurationen, die in der aktuellen Version bereitgestellt werden (überprüfen Sie Versionshinweise), und überprüfen Sie, ob Funktionen betroffen sind. Ein Beispiel könnte die Verwendung von „Verbessertes Datei- und Versionsmanagement“ sein, die in Version 4.0 eingeführt wurde und für die Sie eine Konfiguration aktivieren müssen.
Schritte zum Indizieren des vorhandenen Inhalts für die Verwendung des neuen Such- und Ersetzungsmodus:
Führen Sie die folgenden Schritte aus, um den vorhandenen Inhalt zu indizieren und den neuen Text „Suchen und Ersetzen“ auf Zuordnungsebene zu verwenden:
-
Stellen Sie sicher, dass die
damAssetLucene
Indizierung abgeschlossen wurde. Je nach der auf dem Server vorhandenen Datenmenge kann dies bis zu ein paar Stunden dauern. Sie können bestätigen, dass die Neuindizierung abgeschlossen ist, indem Sie überprüfen, ob das Neuindizierungsfeld in auf „false“ gesetzt isthttp://<server:port>/oak:index/damAssetLucene
. Wenn Sie außerdem Anpassungen indamAssetLucene
hinzugefügt haben, müssen Sie diese möglicherweise erneut anwenden. -
Führen Sie eine POST-Anfrage an den Server (mit korrekter Authentifizierung) -
http://<server:port\>/bin/guides/map-find/indexing
aus. (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=<map\_path\_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. Zur Überprüfung des Auftragsstatus 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/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42
) -
Sobald der Vorgang abgeschlossen ist, wird die obige GET-Anfrage erfolgreich beantwortet und es wird angegeben, ob Zuordnungen fehlgeschlagen sind. Die erfolgreich indizierten Zuordnungen können aus den Serverprotokollen bestätigt werden.
Aktualisierung auf Version 4.3.0
Die Aktualisierung auf Version 4.3.0 hängt von der aktuellen Version von Experience Manager Guides ab. Wenn Sie Version 4.2 oder 4.2.x verwenden, können Sie direkt auf Version 4.3.0 aktualisieren.
Voraussetzungen
Stellen Sie vor dem Start des Upgrades auf Experience Manager Guides 4.3.0 Folgendes sicher:
- auf Experience Manager Guides Version 4.2 oder 4.2.x aktualisiert und der entsprechende Installationsschritt abgeschlossen.
- Alle Übersetzungsaufgaben geschlossen.
Installieren von Version 4.3.0
- Laden Sie das Versionspaket 4.3.0 vom Adobe Software Distribution Portal herunter.
- Installieren Sie das Paket Version 4.3.0.
- Löschen Sie den Browser-Cache nach der Installation des Pakets.
- Aktualisieren Sie die Datei
ui_config.json
auf der Registerkarte XML-Editor im Ordnerprofil.
Nach der Installation von Version 4.3.0
Nach der Installation von Experience Manager Guides können Sie die verschiedenen Konfigurationen, die für die neu installierte Version gelten, mit Ihrem Setup zusammenführen.
Schritte zur Nachbearbeitung des vorhandenen Inhalts, um den Bericht über fehlerhafte Links zu verwenden
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
queryLimitReads
unterorg.apache.jackrabbit.oak.query.QueryEngineSettingsService
auf 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.table 0-row-3 1-row-3 PID Eigenschaftsschlüssel Eigenschaftswert org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Wert: 200000
Standardwert: 100000 -
Führen Sie die folgenden APIs aus, um die Nachbearbeitung für alle Dateien auszuführen:
table 0-row-2 1-row-2 2-row-2 Endpunkt /bin/guides/reports/upgrade Abfragetyp POST Dieses Skript ist eine POST-Anfrage und sollte daher über Agenten wie Postman ausgeführt werden. Erwartete Antwort 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.
Beispiel-URL:http://<server:port>/bin/guides/reports/upgrade
table 0-row-2 1-row-2 2-row-2 3-row-2 Endpunkt /bin/guides/reports/upgrade Abfragetyp GET Parameter jobId: Übergeben Sie die jobId, die von der vorherigen POST-Anfrage erhalten wurde. Erwartete Antwort - Nachdem der Vorgang abgeschlossen ist, wird die GET-Anfrage erfolgreich beantwortet.
- Wenn Fehler auftreten, teilen Sie die Fehlerprotokolle zusammen mit der API-Ausgabe mit Ihrem Customer Success-Team.
Beispiel-URL:http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
-
Kehren Sie zum Standardwert oder vorherigen vorhandenen Wert von
queryLimitReads
zurück, wenn Sie ihn in Schritt 1 geändert haben.
Aktualisierung auf Version 4.3.1
Die Aktualisierung auf Version 4.3.1 hängt von der aktuellen Version von Experience Manager Guides ab. Wenn Sie Version 4.3.0, 4.2 oder 4.2.1 verwenden, können Sie direkt auf Version 4.3.1 aktualisieren.
Voraussetzungen
Stellen Sie vor dem Start des Upgrades auf Experience Manager Guides 4.3.1 Folgendes sicher:
- auf Experience Manager Guides Version 4.3.0, 4.2 oder 4.2.1 aktualisiert und der entsprechende Installationsschritt abgeschlossen.
- (Optional) Alle Übersetzungsaufgaben wurden geschlossen.
- Protokollebene für Klasse in ""
com.adobe.fmdita.translationservices.TranslationMapUpgradeScript
und diese Protokolle in einer neuen Protokolldatei anhängen, z. B.logs/translation_upgrade.log
.
Installieren von Version 4.3.1
-
Laden Sie das Versionspaket 4.3.1 vom Adobe Software Distribution Portal herunter.
-
Installieren Sie das Paket Version 4.3.1 .
-
Sie können den Trigger drücken, um den Upgrade-Auftrag für die Übersetzungskarte zu starten. Weitere Informationen finden Sie unter Aktivieren des Skript-Triggers über ein Servlet.
-
Warten Sie nach Abschluss der Paketinstallation in den Protokollen auf die folgende(n) Meldung(en):
Completed the post deployment setup script
Die obige Meldung weist darauf hin, dass alle Installationsschritte abgeschlossen sind.
Falls Sie auf eines der folgenden FEHLER-Präfixe stoßen, melden Sie dies Ihrem Customer Success-Team:
- Fehler im Setup-Skript nach der Bereitstellung
- Ausnahme bei der Portierung des Übersetzungs-MAP
- Die Übersetzungszuordnung kann für die Eigenschaft nicht von v1 auf v2 portiert werden
-
Upgrade des Oxygen Connector-Plug-ins, das mit Version 4.2 veröffentlicht wurde (falls erforderlich).
-
Löschen Sie den Browser-Cache nach der Installation des Pakets.
-
Fahren Sie mit dem Upgrade der Anpassungen fort, wie im nächsten Abschnitt beschrieben.
Aktivieren des Skript-Triggers über ein Servlet (für 4.3.1)
BEITRAG:
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 obigen Antwort-JSON enthält der lockNodePath
den Pfad zum Knoten , der im Repository erstellt wurde und auf den gesendeten Auftrag verweist. Sie wird automatisch gelöscht, sobald der Auftrag abgeschlossen ist. Bis dahin können Sie in diesem Knoten den aktuellen Status des Auftrags abrufen.
Beispielprotokoll:
Im Folgenden finden Sie ein Beispiel für Protokolle, die in der Protokolldatei angezeigt werden, nachdem Sie das Skript Trigger haben.
04.05.2023 14:17:12.876 *INFO* [[0:0:0:0:0:0:0:1] [1683190032736] POST /bin/guides/script/start HTTP/1.1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Acquiring lock for job : translation-map-upgrade
04.05.2023 14:17:12.897 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Starting the thread to upgrade translation map from V1 to V2
04.05.2023 14:17:12.899 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Initiating lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.901 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Starting porting of translation map from V1 to V2
04.05.2023 14:17:12.904 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Memory increase is of : 764 kB
04.05.2023 14:17:12.906 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2
04.05.2023 14:17:12.907 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Releasing lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.909 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2
Suchen Sie nach com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2
und com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2
, bevor Sie mit den nächsten Schritten fortfahren.
Nach der Installation von Version 4.3.1
Nach der Installation von Experience Manager Guides können Sie die verschiedenen Konfigurationen, die für die neu installierte Version gelten, mit Ihrem Setup zusammenführen.
-
Workflow „DAM-Update-Asset“ (Änderungen nach der Verarbeitung):
-
URL öffnen:
code language-none http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
-
Wählen Sie Workflow DAM-Update-Asset.
-
Klicken Sie auf Bearbeiten.
-
Wenn die DXML Post Process Initiator-Komponente vorhanden ist, stellen Sie sicher, dass die Anpassungen synchronisiert werden.
-
Wenn die DXML Post Process Initiator-Komponente fehlt, führen Sie die folgenden Schritte aus, um sie einzufügen:
-
Klicken Sie Komponente einfügen (Verantwortlich für die Nachbearbeitung von Experience Manager Guides als letzter Schritt im Prozess).
-
Konfigurieren Sie den Prozessschritt mit den folgenden Details:
Registerkarte „Allgemein“
title: DXML-Nachbearbeitungs-Initiator
Beschreibung: Schritt „DXML-Nachbearbeitungs-Initiator“, der einen Sling-Auftrag für die DXML-Nachbearbeitung des geänderten/erstellten Assets Trigger
Registerkarte „Prozess“
-
Wählen Sie DXML Post Process Initiator aus der Dropdown Prozess aus
-
Wählen Sie Handler-Fortschritt aus
-
Wählen Sie Fertig
-
-
Klicken Sie rechts oben den Änderungen auf „Synchronisieren“. Sie erhalten eine Erfolgsbenachrichtigung.
note note NOTE Aktualisieren Sie und überprüfen Sie, ob benutzerdefinierte Änderungen und der Experience Manager Guides-Nachbearbeitungsschritt im endgültigen Workflow-Modell vorhanden sind. -
Nachdem Workflow DAM-Update-Asset validiert wurde, überprüfen Sie die entsprechenden Starter-Konfigurationen. Gehen Sie dazu zur Workflow-Benutzeroberfläche von AEM und öffnen Sie Starter.
code language-http http://localhost:4502/libs/cq/workflow/content/console.html
Suchen Sie die beiden folgenden Starter (die aktiv sein sollten) und nehmen Sie entsprechende Änderungen vor (falls erforderlich), die dem Workflow DAM-Update-Asset entsprechen:
-
Starter für "Knoten erstellt" für Workflow DAM-Update-Asset- für
"jcr:content/jcr:mimeType!=video"
sollte der Wert „Globbing“ sein:code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
- „excludeList“ muss
"event-user-data:changedByWorkflowProcess"
haben. - Starter für "Node Modified" für DAM Update Asset Workflow - Für Bedingung "
jcr:content/jcr:mimeType!=video
" sollte der Wert „Globbing“ sein:
code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
excludeList
sollte"event-user-data:changedByWorkflowProcess"
haben.
- „excludeList“ muss
-
Nachdem das Upgrade abgeschlossen ist, stellen Sie sicher, dass alle Anpassungen/Überlagerungen validiert und aktualisiert werden, damit sie dem neuen Anwendungs-Code entsprechen. Im Folgenden finden Sie einige Beispiele:
- Alle Komponenten, die von /libs/fmdidator/libs überlagert sind, sollten mit dem neuen Produkt-Code verglichen werden und Aktualisierungen sollten in überlagerten Dateien unter /apps vorgenommen werden.
- Alle Client-Bibliothekskategorien, die vom Produkt verwendet werden, sollten auf Änderungen überprüft werden. Alle überschriebenen Konfigurationen (Beispiele unten) sollten mit den neuesten verglichen werden, um die neuesten Funktionen zu erhalten:
- elementmapping.xml
- ui_config.json(wurde möglicherweise in Ordnerprofilen festgelegt)
- geänderte
com.adobe.fmdita.config.ConfigManager
Schritte zum Indizieren des vorhandenen Inhalts
Führen Sie die folgenden Schritte aus, um den vorhandenen Inhalt zu indizieren und den neuen Text „Suchen und Ersetzen“ auf Zuordnungsebene zu verwenden:
-
Führen Sie eine POST-Anfrage an den Server (mit korrekter Authentifizierung) -
http://<server:port\>/bin/guides/map-find/indexing
aus. (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=<map\_path\_in\_repository\>
) -
Die API gibt eine jobId zurück. Zur Überprüfung des Auftragsstatus 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/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42
) -
Sobald der Vorgang abgeschlossen ist, wird die obige GET-Anfrage erfolgreich beantwortet und es wird angegeben, ob Zuordnungen fehlgeschlagen sind. Die erfolgreich indizierten Zuordnungen können aus den Serverprotokollen bestätigt werden.
Schritte zur Nachbearbeitung des vorhandenen Inhalts, um den Bericht über fehlerhafte Links zu verwenden
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
queryLimitReads
unterorg.apache.jackrabbit.oak.query.QueryEngineSettingsService
auf 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.table 0-row-3 1-row-3 PID Eigenschaftsschlüssel Eigenschaftswert org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Wert: 200000
Standardwert: 100000 -
Führen Sie die folgenden APIs aus, um die Nachbearbeitung für alle Dateien auszuführen:
table 0-row-2 1-row-2 2-row-2 Endpunkt /bin/guides/reports/upgrade Abfragetyp POST Dieses Skript ist eine POST-Anfrage und sollte daher über Agenten wie Postman ausgeführt werden. Erwartete Antwort 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.
Beispiel-URL:http://<server:port>/bin/guides/reports/upgrade
table 0-row-2 1-row-2 2-row-2 3-row-2 Endpunkt /bin/guides/reports/upgrade Abfragetyp GET Parameter jobId: Übergeben Sie die jobId, die von der vorherigen POST-Anfrage erhalten wurde. Erwartete Antwort - Nachdem der Vorgang abgeschlossen ist, wird die GET-Anfrage erfolgreich beantwortet.
- Wenn Fehler auftreten, teilen Sie die Fehlerprotokolle zusammen mit der API-Ausgabe mit Ihrem Customer Success-Team.
Beispiel-URL:http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
-
Kehren Sie zum Standardwert oder vorherigen vorhandenen Wert von
queryLimitReads
zurück, wenn Sie ihn in Schritt 1 geändert haben.
Aktualisieren auf Version 4.3.1.5
Das Upgrade auf Version 4.3.1.5 hängt von der aktuellen Version von Experience Manager Guides ab. Wenn Sie Version 4.3.1 verwenden, können Sie direkt auf Version 4.3.1.5 aktualisieren.
Installieren von Version 4.3.1.5
-
Laden Sie 4.3.1.5 Versionspaket vom Adobe Software Distribution Portal herunter.
-
Installieren Sie Version 4.3.1.5 Pakets.
-
Warten Sie, bis der Installationsprozess erfolgreich abgeschlossen wurde.
-
Fahren Sie mit dem Upgrade der Anpassungen fort, wie im nächsten Abschnitt beschrieben.
Nach der Installation von Version 4.3.1.5
- Rufen Sie
<server>:<port>/system/console/bundles
auf. - Suchen Sie nach org.apache.velocity.
- Deinstallieren Sie das gesuchte Bundle.
- Installieren Sie das erforderliche Velocity-Bundle.
-
Nachdem das Upgrade abgeschlossen ist, stellen Sie sicher, dass alle Anpassungen/Überlagerungen validiert und aktualisiert werden, damit sie dem neuen Anwendungs-Code entsprechen. Im Folgenden finden Sie einige Beispiele:
- Alle Komponenten, die von
/libs/fmdita
oder/libs
überlagert sind, sollten mit dem neuen Produkt-Code verglichen werden und Aktualisierungen sollten in überlagerten Dateien unter/apps
erfolgen. - Alle Client-Bibliothekskategorien, die vom Produkt verwendet werden, sollten auf Änderungen überprüft werden. Alle überschriebenen Konfigurationen (Beispiele unten) sollten mit den neuesten verglichen werden, um die neuesten Funktionen zu erhalten:
elementmapping.xml
ui\_config.json\
(kann in Ordnerprofilen festgelegt worden sein)- geänderte
com.adobe.fmdita.config.ConfigManager
- Alle Komponenten, die von
Aktualisierung auf Version 4.4.0
Die Aktualisierung auf Version 4.4.0 hängt von der aktuellen Version von Experience Manager Guides ab. Wenn Sie Version 4.3.1, 4.3.0, 4.2 oder 4.2.1 (Hotfix 4.2.1.3) verwenden, können Sie direkt auf Version 4.4.0 aktualisieren
Voraussetzungen
Stellen Sie vor dem Start des Upgrades auf Experience Manager Guides 4.4.0 Folgendes sicher:
- auf Experience Manager Guides Version 4.3.1, 4.3.0 oder 4.2.1 (Hotfix 4.2.1.3) aktualisiert und der entsprechende Installationsschritt abgeschlossen.
- (Optional) Alle Übersetzungsaufgaben wurden geschlossen.
- Protokollebene für Klasse in ""
com.adobe.fmdita.translationservices.TranslationMapUpgradeScript
und diese Protokolle in einer neuen Protokolldatei anhängen, z. B.logs/translation_upgrade.log
.
Installieren von Version 4.4.0
-
Laden Sie das Versionspaket 4.4.0 vom Adobe Software Distribution Portal herunter.
-
Installieren Sie das Paket Version 4.4.0.
-
Sie können den Trigger drücken, um den Upgrade-Auftrag für die Übersetzungskarte zu starten. Weitere Informationen finden Sie unter Aktivieren des Skript-Triggers über ein Servlet.
-
Warten Sie nach Abschluss der Paketinstallation in den Protokollen auf die folgende(n) Meldung(en):
Completed the post deployment setup script
Die obige Meldung weist darauf hin, dass alle Installationsschritte abgeschlossen sind.
Falls Sie auf eines der folgenden FEHLER-Präfixe stoßen, melden Sie dies Ihrem Customer Success-Team:
- Fehler im Setup-Skript nach der Bereitstellung
- Ausnahme bei der Portierung des Übersetzungs-MAP
- Die Übersetzungszuordnung kann für die Eigenschaft nicht von v1 auf v2 portiert werden
-
Upgrade des Oxygen Connector-Plug-ins, das mit Version 4.4.0 veröffentlicht wurde (falls erforderlich).
-
Löschen Sie den Browser-Cache nach der Installation des Pakets.
-
Fahren Sie mit dem Upgrade der Anpassungen fort, wie im nächsten Abschnitt beschrieben.
Nach der Installation von Version 4.4.0
Nach der Installation von Experience Manager Guides können Sie die verschiedenen Konfigurationen, die für die neu installierte Version gelten, mit Ihrem Setup zusammenführen.
-
Workflow „DAM-Update-Asset“ (Änderungen nach der Verarbeitung):
-
URL öffnen:
code language-none http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
-
Wählen Sie Workflow DAM-Update-Asset.
-
Klicken Sie auf Bearbeiten.
-
Wenn die DXML Post Process Initiator-Komponente vorhanden ist, stellen Sie sicher, dass die Anpassungen synchronisiert werden.
-
Wenn die DXML Post Process Initiator-Komponente fehlt, führen Sie die folgenden Schritte aus, um sie einzufügen:
-
Klicken Sie Komponente einfügen (Verantwortlich für die Nachbearbeitung von Experience Manager Guides als letzter Schritt im Prozess).
-
Konfigurieren Sie den Prozessschritt mit den folgenden Details:
Registerkarte „Allgemein“
title: DXML-Nachbearbeitungs-Initiator
Beschreibung: Schritt „DXML-Nachbearbeitungs-Initiator“, der einen Sling-Auftrag für die DXML-Nachbearbeitung des geänderten/erstellten Assets Trigger
Registerkarte „Prozess“
-
Wählen Sie DXML Post Process Initiator aus der Dropdown Prozess aus
-
Wählen Sie Handler-Fortschritt aus
-
Wählen Sie Fertig
-
-
Klicken Sie rechts oben den Änderungen auf „Synchronisieren“. Sie erhalten eine Erfolgsbenachrichtigung.
note note NOTE Aktualisieren Sie und überprüfen Sie, ob benutzerdefinierte Änderungen und der Experience Manager Guides-Nachbearbeitungsschritt im endgültigen Workflow-Modell vorhanden sind. -
Nachdem Workflow DAM-Update-Asset validiert wurde, überprüfen Sie die entsprechenden Starter-Konfigurationen. Gehen Sie dazu zur Workflow-Benutzeroberfläche von AEM und öffnen Sie Starter.
code language-http http://localhost:4502/libs/cq/workflow/content/console.html
Suchen Sie die beiden folgenden Starter (die aktiv sein sollten) und nehmen Sie entsprechende Änderungen vor (falls erforderlich), die dem Workflow DAM-Update-Asset entsprechen:
-
Starter für "Knoten erstellt" für Workflow DAM-Update-Asset- für
"jcr:content/jcr:mimeType!=video"
sollte der Wert „Globbing“ sein:code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
- „excludeList“ muss
"event-user-data:changedByWorkflowProcess"
haben. - Starter für "Node Modified" für DAM Update Asset Workflow - Für Bedingung "
jcr:content/jcr:mimeType!=video
" sollte der Wert „Globbing“ sein:
code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
excludeList
sollte"event-user-data:changedByWorkflowProcess"
haben.
- „excludeList“ muss
-
Nachdem das Upgrade abgeschlossen ist, stellen Sie sicher, dass alle Anpassungen/Überlagerungen validiert und aktualisiert werden, damit sie dem neuen Anwendungs-Code entsprechen. Im Folgenden finden Sie einige Beispiele:
- Alle Komponenten, die von /libs/fmdidator/libs überlagert sind, sollten mit dem neuen Produkt-Code verglichen werden und Aktualisierungen sollten in überlagerten Dateien unter /apps vorgenommen werden.
- Alle Client-Bibliothekskategorien, die vom Produkt verwendet werden, sollten auf Änderungen überprüft werden. Alle überschriebenen Konfigurationen (Beispiele unten) sollten mit den neuesten verglichen werden, um die neuesten Funktionen zu erhalten:
- elementmapping.xml
- ui_config.json(wurde möglicherweise in Ordnerprofilen festgelegt)
- geänderte
com.adobe.fmdita.config.ConfigManager
-
Wenn Sie Anpassungen in damAssetLucene hinzugefügt haben, müssen Sie diese möglicherweise erneut anwenden. Nachdem Sie diese Änderungen vorgenommen haben, setzen Sie die Neuindizierung auf „true“. Dadurch werden alle vorhandenen Knoten mit den Anpassungen neu indiziert. Nach Abschluss wird das Neuindizierungs-Flag erneut auf „false“ gesetzt. Dies kann je nach Anzahl der Assets im System einige Stunden dauern.
Schritte zum Indizieren des vorhandenen Inhalts
Führen Sie die folgenden Schritte aus, um den vorhandenen Inhalt zu indizieren und den neuen Text „Suchen und Ersetzen“ auf Zuordnungsebene zu verwenden:
-
Führen Sie eine POST-Anfrage an den Server (mit korrekter Authentifizierung) -
http://<server:port\>/bin/guides/map-find/indexing
aus. (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=<map\_path\_in\_repository\>
) -
Die API gibt eine jobId zurück. Zur Überprüfung des Auftragsstatus 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/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42
) -
Sobald der Vorgang abgeschlossen ist, wird die obige GET-Anfrage erfolgreich beantwortet und es wird angegeben, ob Zuordnungen fehlgeschlagen sind. Die erfolgreich indizierten Zuordnungen können aus den Serverprotokollen bestätigt werden.
Schritte zur Nachbearbeitung des vorhandenen Inhalts, um den Bericht über fehlerhafte Links zu verwenden
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
queryLimitReads
unterorg.apache.jackrabbit.oak.query.QueryEngineSettingsService
auf 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.table 0-row-3 1-row-3 PID Eigenschaftsschlüssel Eigenschaftswert org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Wert: 200000
Standardwert: 100000 -
Führen Sie die folgenden APIs aus, um die Nachbearbeitung für alle Dateien auszuführen:
table 0-row-2 1-row-2 2-row-2 Endpunkt /bin/guides/reports/upgrade Abfragetyp POST Dieses Skript ist eine POST-Anfrage und sollte daher über Agenten wie Postman ausgeführt werden. Erwartete Antwort 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.
Beispiel-URL:http://<server:port>/bin/guides/reports/upgrade
table 0-row-2 1-row-2 2-row-2 3-row-2 Endpunkt /bin/guides/reports/upgrade Abfragetyp GET Parameter jobId: Übergeben Sie die jobId, die von der vorherigen POST-Anfrage erhalten wurde. Erwartete Antwort - Nachdem der Vorgang abgeschlossen ist, wird die GET-Anfrage erfolgreich beantwortet.
- Wenn Fehler auftreten, teilen Sie die Fehlerprotokolle zusammen mit der API-Ausgabe mit Ihrem Customer Success-Team.
Beispiel-URL:http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
-
Kehren Sie zum Standardwert oder vorherigen vorhandenen Wert von
queryLimitReads
zurück, wenn Sie ihn in Schritt 1 geändert haben.
Aktivieren des Skript-Triggers über ein Servlet
BEITRAG:
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 obigen Antwort-JSON enthält der lockNodePath
den Pfad zum Knoten , der im Repository erstellt wurde und auf den gesendeten Auftrag verweist. Sie wird automatisch gelöscht, sobald der Auftrag abgeschlossen ist. Bis dahin können Sie in diesem Knoten den aktuellen Status des Auftrags abrufen.
Suchen Sie nach com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2
und com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2
, bevor Sie mit den nächsten Schritten fortfahren.
GET: http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
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.
Übergeordnetes Thema: Herunterladen und installieren
Aktualisieren auf Version 4.6.0
Die Aktualisierung auf Version 4.6.0 hängt von der aktuellen Version von Experience Manager Guides ab. Wenn Sie Version 4.4.0, 4.3.1, 4.3.0, 4.2 oder 4.2.1 (Hotfix 4.2.1.3) verwenden, können Sie direkt auf Version 4.6.0 aktualisieren.
Voraussetzungen
Stellen Sie vor dem Start des Upgrades auf Experience Manager Guides 4.6.0 Folgendes sicher:
- auf Experience Manager Guides Version 4.3.1, 4.3.0 oder 4.2.1 (Hotfix 4.2.1.3) aktualisiert und der entsprechende Installationsschritt abgeschlossen.
- (Optional) Alle Übersetzungsaufgaben wurden geschlossen.
- Protokollebene für Klasse in ""
com.adobe.fmdita.translationservices.TranslationMapUpgradeScript
und diese Protokolle in einer neuen Protokolldatei anhängen, z. B.logs/translation_upgrade.log
.
Installieren von Version 4.6.0
-
Laden Sie das Versionspaket 4.6.0 vom Adobe Software Distribution Portal herunter.
-
Installieren Sie das Paket Version 4.6.0.
-
Sie können den Trigger drücken, um den Upgrade-Auftrag für die Übersetzungskarte zu starten. Weitere Informationen finden Sie unter Aktivieren des Skript-Triggers über ein Servlet.
-
Warten Sie nach Abschluss der Paketinstallation in den Protokollen auf die folgende(n) Meldung(en):
Completed the post deployment setup script
Die obige Meldung weist darauf hin, dass alle Installationsschritte abgeschlossen sind.
Falls Sie auf eines der folgenden FEHLER-Präfixe stoßen, melden Sie dies Ihrem Customer Success-Team:
- Fehler im Setup-Skript nach der Bereitstellung
- Ausnahme bei der Portierung des Übersetzungs-MAP
- Die Übersetzungszuordnung kann für die Eigenschaft nicht von v1 auf v2 portiert werden
-
Upgrade des Oxygen Connector-Plug-ins, das mit Version 4.6.0 veröffentlicht wurde (falls erforderlich).
-
Löschen Sie den Browser-Cache nach der Installation des Pakets.
Nach der Installation von Version 4.6.0
Nach der Installation von Experience Manager Guides können Sie die verschiedenen Konfigurationen, die für die neu installierte Version gelten, mit Ihrem Setup zusammenführen.
-
Workflow „DAM-Update-Asset“ (Änderungen nach der Verarbeitung):
-
URL öffnen:
code language-none http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
-
Wählen Sie Workflow DAM-Update-Asset.
-
Klicken Sie auf Bearbeiten.
-
Wenn die DXML Post Process Initiator-Komponente vorhanden ist, stellen Sie sicher, dass die Anpassungen synchronisiert werden.
-
Wenn die DXML Post Process Initiator-Komponente fehlt, führen Sie die folgenden Schritte aus, um sie einzufügen:
-
Klicken Sie Komponente einfügen (Verantwortlich für die Nachbearbeitung von Experience Manager Guides als letzter Schritt im Prozess).
-
Konfigurieren Sie den Prozessschritt mit den folgenden Details:
Registerkarte „Allgemein“
title: DXML-Nachbearbeitungs-Initiator
Beschreibung: Schritt „DXML-Nachbearbeitungs-Initiator“, der einen Sling-Auftrag für die DXML-Nachbearbeitung des geänderten/erstellten Assets Trigger
Registerkarte „Prozess“
-
Wählen Sie DXML Post Process Initiator aus der Prozess Dropdown aus
-
Wählen Sie Handler-Fortschritt aus
-
Wählen Sie Fertig
-
-
Klicken Sie rechts oben den Änderungen auf „Synchronisieren“. Sie erhalten eine Erfolgsbenachrichtigung.
note note NOTE Aktualisieren Sie und überprüfen Sie, ob benutzerdefinierte Änderungen und der Experience Manager Guides-Nachbearbeitungsschritt im endgültigen Workflow-Modell vorhanden sind. -
Nachdem Workflow DAM-Update-Asset validiert wurde, überprüfen Sie die entsprechenden Starter-Konfigurationen. Gehen Sie dazu zur Workflow-Benutzeroberfläche von AEM und öffnen Sie Starter.
code language-http http://localhost:4502/libs/cq/workflow/content/console.html
Suchen Sie die beiden folgenden Starter (die aktiv sein sollten) und nehmen Sie entsprechende Änderungen vor (falls erforderlich), die dem Workflow DAM-Update-Asset entsprechen:
-
Starter für "Knoten erstellt" für Workflow DAM-Update-Asset- für
"jcr:content/jcr:mimeType!=video"
sollte der Wert „Globbing“ sein:code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
- „excludeList“ muss
"event-user-data:changedByWorkflowProcess"
haben. - Starter für "Node Modified" für DAM Update Asset Workflow - Für Bedingung "
jcr:content/jcr:mimeType!=video
" sollte der Wert „Globbing“ sein:
code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
excludeList
sollte"event-user-data:changedByWorkflowProcess"
haben.
- „excludeList“ muss
-
Nachdem das Upgrade abgeschlossen ist, stellen Sie sicher, dass alle Anpassungen/Überlagerungen validiert und aktualisiert werden, damit sie dem neuen Anwendungs-Code entsprechen. Im Folgenden finden Sie einige Beispiele:
- Alle Komponenten, die von /libs/fmdidator/libs überlagert sind, sollten mit dem neuen Produkt-Code verglichen werden und Aktualisierungen sollten in überlagerten Dateien unter /apps vorgenommen werden.
- Alle Client-Bibliothekskategorien, die vom Produkt verwendet werden, sollten auf Änderungen überprüft werden. Alle überschriebenen Konfigurationen (Beispiele unten) sollten mit den neuesten verglichen werden, um die neuesten Funktionen zu erhalten:
- elementmapping.xml
- ui_config.json(wurde möglicherweise in Ordnerprofilen festgelegt)
- geänderte
com.adobe.fmdita.config.ConfigManager
-
Wenn Sie Anpassungen in damAssetLucene hinzugefügt haben, müssen Sie diese möglicherweise erneut anwenden. Nachdem Sie diese Änderungen vorgenommen haben, setzen Sie die Neuindizierung auf „true“. Dadurch werden alle vorhandenen Knoten mit den Anpassungen neu indiziert. Nach Abschluss wird das Neuindizierungs-Flag erneut auf „false“ gesetzt. Dies kann je nach Anzahl der Assets im System einige Stunden dauern.
Neuindizierung der Experience Manager Guides-Indizes
-
Öffnen Sie
crx/de
und navigieren Sie zum Indexpfad:/oak:index/guidesAssetProperties
-
Legen Sie die Eigenschaft für die Neuindizierung auf
true
fest (standardmäßigfalse
) und klicken Sie auf Alle speichern. -
Sobald die Neuindizierung abgeschlossen ist, wird die Eigenschaft für die Neuindizierung erneut auf
false
festgelegt und die Neuindizierungsanzahl um 1 erhöht.note note NOTE Dies kann je nach Menge der vorhandenen Daten einige Minuten dauern. 4. Führen Sie dieselben Schritte für andere hinzugefügte oder geänderte Indizes aus: `guidesBulkActivation`, `guidesPeerLinkIndex` und `guidesKonnectTemplateIndex`.
Schritte zum Indizieren des vorhandenen Inhalts
Führen Sie die folgenden Schritte aus, um den vorhandenen Inhalt zu indizieren:
-
Führen Sie eine POST-Anfrage an den Server (mit korrekter Authentifizierung) -
http://<server:port\>/bin/guides/map-find/indexing
aus. (Optional) Sie können bestimmte Pfade der Karten übergeben, um sie zu indizieren. Standardmäßig werden alle Karten indiziert || Beispiel :https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_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\}
(zum Beispiel:http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
) -
Sobald der Vorgang abgeschlossen ist, wird die obige GET-Anfrage erfolgreich beantwortet und es wird angegeben, ob Zuordnungen fehlgeschlagen sind. Die erfolgreich indizierten Zuordnungen können aus den Serverprotokollen 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.
Aktualisieren auf Version 5.0.0
Voraussetzungen
Stellen Sie vor dem Start des Upgrades auf Experience Manager Guides 5.0.0 Folgendes sicher:
- auf Experience Manager Guides Version 4.6.3, 4.6.1, 4.6.0 oder 4.4 aktualisiert und der entsprechende Installationsschritt abgeschlossen.
- (Optional) Alle Übersetzungsaufgaben wurden geschlossen.
- Protokollebene für Klasse in ""
com.adobe.fmdita.translationservices.TranslationMapUpgradeScript
und diese Protokolle in einer neuen Protokolldatei anhängen, z. B.logs/translation_upgrade.log
.
Installieren von Version 5.0.0
-
Laden Sie das Versionspaket 5.0.0 vom Adobe Software Distribution Portal herunter.
-
Installieren Sie das Paket Version 5.0.0.
-
Sie können den Trigger drücken, um den Upgrade-Auftrag für die Übersetzungskarte zu starten. Weitere Informationen finden Sie unter Aktivieren des Skript-Triggers über ein Servlet.
-
Warten Sie nach Abschluss der Paketinstallation in den Protokollen auf die folgende(n) Meldung(en):
Completed the post deployment setup script
Die obige Meldung weist darauf hin, dass alle Installationsschritte abgeschlossen sind.
Falls Sie auf eines der folgenden FEHLER-Präfixe stoßen, melden Sie dies Ihrem Customer Success-Team:
- Fehler im Setup-Skript nach der Bereitstellung
- Ausnahme bei der Portierung des Übersetzungs-MAP
- Die Übersetzungszuordnung kann für die Eigenschaft nicht von v1 auf v2 portiert werden
-
Upgrade des Oxygen Connector-Plug-ins, das mit Version 5.0.0 veröffentlicht wurde (falls erforderlich).
-
Löschen Sie den Browser-Cache nach der Installation des Pakets.
Nach der Installation von Version 5.0.0
Nach der Installation von Experience Manager Guides können Sie die verschiedenen Konfigurationen, die für die neu installierte Version gelten, mit Ihrem Setup zusammenführen.
-
Workflow „DAM-Update-Asset“ (Änderungen nach der Verarbeitung):
-
URL öffnen:
code language-none http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
-
Wählen Sie Workflow DAM-Update-Asset.
-
Klicken Sie auf Bearbeiten.
-
Wenn die DXML Post Process Initiator-Komponente vorhanden ist, stellen Sie sicher, dass die Anpassungen synchronisiert werden.
-
Wenn die DXML Post Process Initiator-Komponente fehlt, führen Sie die folgenden Schritte aus, um sie einzufügen:
-
Klicken Sie Komponente einfügen (Verantwortlich für die Nachbearbeitung von Experience Manager Guides als letzter Schritt im Prozess).
-
Konfigurieren Sie den Prozessschritt mit den folgenden Details:
Registerkarte „Allgemein“
title: DXML-Nachbearbeitungs-Initiator
Beschreibung: Schritt „DXML-Nachbearbeitungs-Initiator“, der einen Sling-Auftrag für die DXML-Nachbearbeitung des geänderten/erstellten Assets Trigger
Registerkarte „Prozess“
-
Wählen Sie DXML Post Process Initiator aus der Prozess Dropdown aus
-
Wählen Sie Handler-Fortschritt aus
-
Wählen Sie Fertig
-
-
Klicken Sie rechts oben den Änderungen auf „Synchronisieren“. Sie erhalten eine Erfolgsbenachrichtigung.
note note NOTE Aktualisieren Sie und überprüfen Sie, ob benutzerdefinierte Änderungen und der Experience Manager Guides-Nachbearbeitungsschritt im endgültigen Workflow-Modell vorhanden sind. -
Nachdem Workflow DAM-Update-Asset validiert wurde, überprüfen Sie die entsprechenden Starter-Konfigurationen. Gehen Sie dazu zur Workflow-Benutzeroberfläche von AEM und öffnen Sie Starter.
code language-http http://localhost:4502/libs/cq/workflow/content/console.html
Suchen Sie die beiden folgenden Starter (die aktiv sein sollten) und nehmen Sie entsprechende Änderungen vor (falls erforderlich), die dem Workflow DAM-Update-Asset entsprechen:
-
Starter für "Knoten erstellt" für Workflow DAM-Update-Asset- für
"jcr:content/jcr:mimeType!=video"
sollte der Wert „Globbing“ sein:code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
- „excludeList“ muss
"event-user-data:changedByWorkflowProcess"
haben. - Starter für "Node Modified" für DAM Update Asset Workflow - Für Bedingung "
jcr:content/jcr:mimeType!=video
" sollte der Wert „Globbing“ sein:
code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
excludeList
sollte"event-user-data:changedByWorkflowProcess"
haben.
- „excludeList“ muss
-
Nachdem das Upgrade abgeschlossen ist, stellen Sie sicher, dass alle Anpassungen/Überlagerungen validiert und aktualisiert werden, damit sie dem neuen Anwendungs-Code entsprechen. Im Folgenden finden Sie einige Beispiele:
- Alle Komponenten, die von /libs/fmdidator/libs überlagert sind, sollten mit dem neuen Produkt-Code verglichen werden und Aktualisierungen sollten in überlagerten Dateien unter /apps vorgenommen werden.
- Alle Client-Bibliothekskategorien, die vom Produkt verwendet werden, sollten auf Änderungen überprüft werden. Alle überschriebenen Konfigurationen (Beispiele unten) sollten mit den neuesten verglichen werden, um die neuesten Funktionen zu erhalten:
- elementmapping.xml
- ui_config.json(wurde möglicherweise in Ordnerprofilen festgelegt)
- geänderte
com.adobe.fmdita.config.ConfigManager
-
Wenn Sie Anpassungen in damAssetLucene hinzugefügt haben, müssen Sie diese möglicherweise erneut anwenden. Nachdem Sie diese Änderungen vorgenommen haben, setzen Sie die Neuindizierung auf „true“. Dadurch werden alle vorhandenen Knoten mit den Anpassungen neu indiziert. Nach Abschluss wird das Neuindizierungs-Flag erneut auf „false“ gesetzt. Dies kann je nach Anzahl der Assets im System einige Stunden dauern.
Neuindizierung der Experience Manager Guides-Indizes
-
Öffnen Sie
crx/de
und navigieren Sie zum Indexpfad:/oak:index/guidesAssetProperties
-
Legen Sie die Eigenschaft für die Neuindizierung auf
true
fest (standardmäßigfalse
) und klicken Sie auf Alle speichern. -
Sobald die Neuindizierung abgeschlossen ist, wird die Eigenschaft für die Neuindizierung erneut auf
false
festgelegt und die Neuindizierungsanzahl um 1 erhöht.note note NOTE Dies kann je nach Menge der vorhandenen Daten einige Minuten dauern. 4. Führen Sie dieselben Schritte für andere hinzugefügte oder geänderte Indizes aus: `guidesBulkActivation`, `guidesPeerLinkIndex` und `guidesKonnectTemplateIndex`.
Schritte zum Indizieren des vorhandenen Inhalts
Führen Sie die folgenden Schritte aus, um den vorhandenen Inhalt zu indizieren:
-
Führen Sie eine POST-Anfrage an den Server (mit korrekter Authentifizierung) -
http://<server:port\>/bin/guides/map-find/indexing
aus. (Optional) Sie können bestimmte Pfade der Karten übergeben, um sie zu indizieren. Standardmäßig werden alle Karten indiziert || Beispiel :https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_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\}
(zum Beispiel:http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
) -
Sobald der Vorgang abgeschlossen ist, wird die obige GET-Anfrage erfolgreich beantwortet und es wird angegeben, ob Zuordnungen fehlgeschlagen sind. Die erfolgreich indizierten Zuordnungen können aus den Serverprotokollen 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 Neuindizierung von damAssetLucene
Die Indexdefinition wird für damAssetLucene mit Handbüchern aktualisiert. Informationen Neuindizierung von damAssetLucene nachAktualisierung auf Version 5.0.0 finden Sie in diesem Artikel .
Aktualisierung auf Version 5.1.0
Voraussetzungen
Stellen Sie vor dem Start des Upgrades auf Experience Manager Guides 5.1.0 Folgendes sicher:
- auf Experience Manager Guides Version 4.6.3, 4.6.4, 5.0.0 oder 5.0.0 Service Pack 1 aktualisiert und der entsprechende Installationsschritt abgeschlossen.
- (Optional) Alle Übersetzungsaufgaben wurden geschlossen.
- Protokollebene für Klasse in ""
com.adobe.fmdita.translationservices.TranslationMapUpgradeScript
und diese Protokolle in einer neuen Protokolldatei anhängen, z. B.logs/translation_upgrade.log
.
Installieren von Version 5.1.0
-
Laden Sie das Versionspaket 5.1.0 vom Adobe Software Distribution Portal herunter.
-
Installieren Sie das Paket Version 5.1.0.
-
Sie können den Trigger drücken, um den Upgrade-Auftrag für die Übersetzungskarte zu starten. Weitere Informationen finden Sie unter Aktivieren des Skript-Triggers über ein Servlet.
-
Warten Sie nach Abschluss der Paketinstallation in den Protokollen auf die folgende(n) Meldung(en):
Completed the post deployment setup script
Die obige Meldung weist darauf hin, dass alle Installationsschritte abgeschlossen sind.
Falls Sie auf eines der folgenden FEHLER-Präfixe stoßen, melden Sie dies Ihrem Customer Success-Team:
- Fehler im Setup-Skript nach der Bereitstellung
- Ausnahme bei der Portierung des Übersetzungs-MAP
- Die Übersetzungszuordnung kann für die Eigenschaft nicht von v1 auf v2 portiert werden
-
Upgrade des Oxygen Connector-Plug-ins, das mit Version 5.1.0 veröffentlicht wurde (falls erforderlich).
-
Löschen Sie den Browser-Cache nach der Installation des Pakets.
Nach der Installation von Version 5.1.0
Nach der Installation von Experience Manager Guides können Sie die verschiedenen Konfigurationen, die für die neu installierte Version gelten, mit Ihrem Setup zusammenführen.
-
Workflow „DAM-Update-Asset“ (Änderungen nach der Verarbeitung):
-
URL öffnen:
code language-none http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
-
Wählen Sie Workflow DAM-Update-Asset.
-
Wählen Sie Bearbeiten aus.
-
Wenn die DXML Post Process Initiator-Komponente vorhanden ist, stellen Sie sicher, dass die Anpassungen synchronisiert werden.
-
Wenn die DXML Post Process Initiator-Komponente fehlt, führen Sie die folgenden Schritte aus, um sie einzufügen:
-
Wählen Sie Komponente einfügen (Verantwortlich für die Experience Manager Guides-Nachbearbeitung als letzten Schritt im Prozess) aus.
-
Konfigurieren Sie den Prozessschritt mit den folgenden Details:
Registerkarte „Allgemein“
title: DXML-Nachbearbeitungs-Initiator
Beschreibung: Schritt „DXML-Nachbearbeitungs-Initiator“, der einen Sling-Auftrag für die DXML-Nachbearbeitung des geänderten/erstellten Assets Trigger
Registerkarte „Prozess“
-
Wählen Sie DXML Post Process Initiator aus der Prozess Dropdown aus
-
Wählen Sie Handler-Fortschritt aus
-
Wählen Sie Fertig
-
-
Wählen oben rechts Synchronisieren“ aus, nachdem Sie die Änderungen abgeschlossen haben. Sie erhalten eine Erfolgsbenachrichtigung.
note note NOTE Aktualisieren Sie und überprüfen Sie, ob benutzerdefinierte Änderungen und der Experience Manager Guides-Nachbearbeitungsschritt im endgültigen Workflow-Modell vorhanden sind. -
Nachdem Workflow DAM-Update-Asset validiert wurde, überprüfen Sie die entsprechenden Starter-Konfigurationen. Gehen Sie dazu zur Workflow-Benutzeroberfläche von AEM und öffnen Sie Starter.
code language-http http://localhost:4502/libs/cq/workflow/content/console.html
Suchen Sie die beiden folgenden Starter (die aktiv sein sollten) und nehmen Sie entsprechende Änderungen vor (falls erforderlich), die dem Workflow DAM-Update-Asset entsprechen:
-
Starter für "Knoten erstellt" für Workflow DAM-Update-Asset- für
"jcr:content/jcr:mimeType!=video"
sollte der Wert „Globbing“ sein:code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
- „excludeList“ muss
"event-user-data:changedByWorkflowProcess"
haben. - Starter für "Node Modified" für DAM Update Asset Workflow - Für Bedingung "
jcr:content/jcr:mimeType!=video
" sollte der Wert „Globbing“ sein:
code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
excludeList
sollte"event-user-data:changedByWorkflowProcess"
haben.
- „excludeList“ muss
-
Nachdem das Upgrade abgeschlossen ist, stellen Sie sicher, dass alle Anpassungen/Überlagerungen validiert und aktualisiert werden, damit sie dem neuen Anwendungs-Code entsprechen. Im Folgenden finden Sie einige Beispiele:
- Alle Komponenten, die von /libs/fmdidator/libs überlagert sind, sollten mit dem neuen Produkt-Code verglichen werden und Aktualisierungen sollten in überlagerten Dateien unter /apps vorgenommen werden.
- Alle Client-Bibliothekskategorien, die vom Produkt verwendet werden, sollten auf Änderungen überprüft werden. Alle überschriebenen Konfigurationen (Beispiele unten) sollten mit den neuesten verglichen werden, um die neuesten Funktionen zu erhalten:
- elementmapping.xml
- ui_config.json(wurde möglicherweise in Ordnerprofilen festgelegt)
- geänderte
com.adobe.fmdita.config.ConfigManager
-
Wenn Sie Anpassungen in damAssetLucene hinzugefügt haben, müssen Sie diese möglicherweise erneut anwenden. Nachdem Sie diese Änderungen vorgenommen haben, setzen Sie die Neuindizierung auf „true“. Dadurch werden alle vorhandenen Knoten mit den Anpassungen neu indiziert. Nach Abschluss wird das Neuindizierungs-Flag erneut auf „false“ gesetzt. Dies kann je nach Anzahl der Assets im System einige Stunden dauern.
Neuindizierung der Experience Manager Guides-Indizes
-
Öffnen Sie
crx/de
und navigieren Sie zum Indexpfad:/oak:index/guidesAssetProperties
-
Legen Sie die Eigenschaft für die Neuindizierung auf
true
fest (standardmäßigfalse
) und klicken Sie auf Alle speichern. -
Sobald die Neuindizierung abgeschlossen ist, wird die Eigenschaft für die Neuindizierung erneut auf
false
festgelegt und die Neuindizierungsanzahl um 1 erhöht.note note NOTE Dies kann je nach Menge der vorhandenen Daten einige Minuten dauern. 4. Führen Sie dieselben Schritte für andere hinzugefügte oder geänderte Indizes aus: `guidesBulkActivation`, `guidesPeerLinkIndex` und `guidesKonnectTemplateIndex`.
Schritte zum Indizieren des vorhandenen Inhalts
Führen Sie die folgenden Schritte aus, um den vorhandenen Inhalt zu indizieren:
-
Führen Sie eine POST-Anfrage an den Server (mit korrekter Authentifizierung) -
http://<server:port\>/bin/guides/map-find/indexing
aus. (Optional) Sie können bestimmte Pfade der Karten übergeben, um sie zu indizieren. Standardmäßig werden alle Karten indiziert || Beispiel :https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_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\}
(zum Beispiel:http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
) -
Sobald der Vorgang abgeschlossen ist, wird die obige GET-Anfrage erfolgreich beantwortet und es wird angegeben, ob Zuordnungen fehlgeschlagen sind. Die erfolgreich indizierten Zuordnungen können aus den Serverprotokollen 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 Neuindizierung von damAssetLucene
Die Indexdefinition wird für damAssetLucene mit Handbüchern aktualisiert. Informationen Neuindizierung von damAssetLucene nachAktualisierung auf Version 5.1.0 finden Sie in diesem Artikel .
Übergeordnetes Thema: Herunterladen und installieren