Ytterligare konfiguration för uppgradering av AEM Guides som Cloud Service
ui_config.json). Efter varje uppgradering granskar och ändrar du inställningarna efter behov för att säkerställa kompatibilitet med de senaste ändringarna.Beroende på vilken version du uppgraderar från kan ytterligare konfigurationssteg behövas för att kunna integrera ändringar som introducerats i nyare Cloud Service-versioner.
Vissa konfigurationer gäller endast vissa versioner. Se till att du hänvisar till konfigurationsavsnitten nedan och använder de konfigurationer som krävs för din konfiguration.
Steg för att använda sökfilter på DITAVAL-filer för alla förinställningar för utdata
Uppdatera ui_config.json för att se till att filterfunktionen fungerar korrekt. Ändra egenskaperna som listas under browseFilters > Icke-DITA-filer > Ditaval-filer enligt nedan:
{
"title": "Ditaval Files",
"property": "LOWER_NAME",
"operation": "like",
"value": ".ditaval"
}
Steg för B-trädmigrering för innehållsfragment
Om referenser inte visas för innehållsfragment kan du välja att köra migreringsjobbet:
POST:
http://localhost:4503/bin/guides/script/start?jobType=cf-reference-store-btree-migration
Svar:
{
"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"
}
I det tidigare svaret, JSON, innehåller nyckeln lockNodePath sökvägen till noden som skapades i databasen, vilket pekar på jobbet som skickades. Den tas automatiskt bort när jobbet är klart. Du kan referera till den här noden för jobbstatus.
Vänta tills jobbet är klart innan du fortsätter till nästa steg.
GET:
http://<aem_domain>/var/dxml/executor-locks/cf-reference-store-btree-migration/1683190032886.json
Steg som ska hantera 'fmdita rewriter'-konflikten
Experience Manager Guides har en anpassad omskrivarmodul för hantering av länkar som genereras vid korsmappningar (länkar mellan ämnen på två olika kartor).
Om du har en annan anpassad återskrivningsskrivare i kodbasen använder du ett 'order'-värde som är större än 50, eftersom Experience Manager Guides återskrivningsprogram använder 'order' 50. Om du vill åsidosätta detta måste du ange ett värde > 50. Mer information finns i Skriva om utdata.
Under den här uppgraderingen måste du, eftersom värdet 'order' ändras från 1 000 till 50, sammanfoga den befintliga anpassade omskrivaren, om sådan finns, med fmdita-rewriter.
Konfigurationer som gäller för versioner före juni 2023
Följande konfigurationer krävs bara om du använder en version av Experience Manager Guides as a Cloud Service som släppts före juni 2023. Expandera de relevanta avsnitten nedan för att tillämpa de nödvändiga inställningarna och säkerställa kompatibilitet med nödvändiga uppdateringar.
Utför följande steg för att indexera det befintliga innehållet och använd den nya sök- och ersätt-texten på mappnivå och ämneslista på fliken Rapporter:
-
Kör en POST-begäran till servern (med korrekt autentisering) -
http://<server:port>/bin/guides/map-find/indexing. (Valfritt: Du kan skicka specifika sökvägar för mappningarna för att indexera dem. Som standard indexeras alla mappningar|| Exempel:https://<Server:port>/bin/guides/map-find/indexing?paths=<path of the MAP in repository>) -
Du kan också skicka en rotmapp för att indexera DITA-mappningarna för en viss mapp (och dess undermappar). Exempel:
http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test. Observera, att om både sökvägsparametern och rotparametern skickas, beaktas bara sökvägsparametern. -
API:t returnerar ett jobId. Om du vill kontrollera jobbets status kan du skicka en GET-begäran med jobb-ID till samma slutpunkt -
http://<server:port>/bin/guides/map-find/indexing?jobId={jobId}(Exempel:http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678) -
När jobbet är klart svarar den tidigare GET-förfrågan med framgång och anger om några kartor misslyckades. De korrekt indexerade mappningarna kan bekräftas från serverloggar.
Utför följande steg för att efterbearbeta befintligt innehåll och använda den nya brutna länkrapporten:
-
(Valfritt) Om det finns fler än 100 000 DITA-filer i systemet uppdaterar du
queryLimitReadsochqueryLimitInMemoryunderorg.apache.jackrabbit.oak.query.QueryEngineSettingsServicetill ett större värde (vilket värde som helst som är större än antalet resurser, till exempel 200 000) och distribuerar sedan om.-
Använd instruktionerna i avsnittet Konfigurationsåsidosättningar i Installera och konfigurera Adobe Experience Manager Guides as a Cloud Service för att skapa konfigurationsfilen.
-
Ange följande (egenskap) information i konfigurationsfilen för att konfigurera alternativet
queryLimitReadsochqueryLimitInMemory:table 0-row-3 1-row-3 2-row-3 PID Egenskapsnyckel Egenskapsvärde org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Värde: 200000 Standardvärde: 100000 org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitInMemory Värde: 200000 Standardvärde: 100000
-
-
Kör en POST-begäran till servern (med korrekt autentisering) -
http://<server>//bin/guides/reports/upgrade. -
API:t returnerar ett jobId. Om du vill kontrollera jobbets status kan du skicka en GET-begäran med jobb-ID till samma slutpunkt -
http://<server>/bin/guides/reports/upgrade?jobId= {jobId}
(Till exempel:http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678) -
När jobbet är klart svarar den tidigare GET-förfrågan med framgång. Om jobbet misslyckas av någon anledning kan felet visas i serverloggarna.
-
Återgå till standardvärdet eller det tidigare befintliga värdet
queryLimitReadsom du har ändrat det i steg 1.
När du har slutfört installationen kan du välja att starta översättningsjobbet:
POST:
| code language-none |
|---|
|
Svar:
| code language-none |
|---|
|
I föregående svar-JSON innehåller nyckeln lockNodePath sökvägen till noden som skapades i databasen som pekar på jobbet som skickades. Den tas automatiskt bort när jobbet är klart, så du kan referera till den här noden för jobbstatus.
Vänta tills jobbet är klart innan du fortsätter till nästa steg.
| note note |
|---|
| NOTE |
| Du bör kontrollera om noden fortfarande finns och jobbens status. |
| code language-none |
|---|
|