DocumentazioneAEM GuidesDocumentazione di AEM Guides

Aggiornare Adobe Experience Manager Guides id224MBE0M0XA

Last update: Wed Nov 06 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Esperto
  • Amministratore
NOTE
Segui le istruzioni di aggiornamento specifiche per la versione con licenza del tuo prodotto.

È possibile aggiornare la versione corrente di Experience Manager Guides alla versione 4.6.0 Service Pack 1:

  • Se utilizzi la versione 4.6.0, puoi effettuare direttamente l’aggiornamento a 4.6.0 Service Pack 1.
  • Se utilizzi le versioni 4.4, 4.3.1 o 4.3.0 , devi effettuare l’aggiornamento alla versione 4.6.0 prima di passare alla versione 4.6.0 Service Pack 1.
  • Se utilizzi le versioni 4.2, 4.2.1 (Hotfix 4.2.1.3), 4.1 o 4.1.x, devi effettuare l’aggiornamento alla versione 4.4 prima di eseguire l’aggiornamento alla versione 4.6.0.
  • Se utilizzi la versione 4.0, devi effettuare l’aggiornamento alla versione 4.2 prima di passare alla versione 4.3.x.
  • Se utilizzi la versione 3.8.5, devi effettuare l’aggiornamento alla versione 4.0 prima di passare alla versione 4.2.
  • Se utilizzi una versione precedente alla 3.8.5, consulta la sezione Aggiornamento di Experience Manager Guides nella guida all'installazione specifica per il prodotto disponibile nell'archivio di Adobe Experience Manager Guides help PDF.
NOTE
Prima di aggiornare la versione di Experience Manager Guides è necessario installare il service pack per AEM.

Per ulteriori informazioni, consulta le procedure seguenti:

IMPORTANT
Prima di iniziare l'aggiornamento, eseguire un backup completo del sistema per evitare la perdita di dati.

Aggiornamento dalla versione 3.8.5 alla versione 4.0 id2256DK003E1

Se utilizzi Experience Manager Guides versione 3.8.5, puoi effettuare l’aggiornamento alla versione 4.0 di Experience Manager Guides. Con la funzione di aggiornamento, non è necessario disinstallare la versione precedente di Experience Manager Guides.

Prima di eseguire il processo è necessario completare alcune attività. Le seguenti sottosezioni ti guideranno attraverso i prerequisiti, la generazione di rapporti e il processo di migrazione. Inoltre, dopo aver installato Experience Manager Guides versione 4.0 è possibile personalizzare varie configurazioni, in base alle impostazioni del cliente.

NOTE
Questo processo di aggiornamento è applicabile solo dalla versione 3.8.5 alla versione 4.0. Per eseguire l'aggiornamento dalla versione 3.4 o successiva alla versione 3.8.5, fare riferimento alla sezione Aggiornamento di Experience Manager Guides nella guida all'installazione specifica del prodotto disponibile nell'archivio di Adobe Experience Manager Guides help PDF.

​ ​Prerequisiti​ ​

Prima di avviare il processo di aggiornamento di Experience Manager Guides, verificare di disporre di:

  1. Importazione dei commenti di revisione negli argomenti aperti per la revisione.
  2. Chiuse tutte le recensioni attive.
  3. Ha chiuso tutte le attività di traduzione.
  4. Disinstalla eventuali aggiornamenti rapidi di Experience Manager Guides installati nella parte superiore della versione precedente (principale o patch) di Experience Manager Guides.

Prima di installare la versione 4.0

Prima di installare la versione 4.0, effettuare le seguenti operazioni:

  1. A questo punto, assicurati che Experience Manager Guides sia nella versione 3.8.5.
  2. Scarica il pacchetto dello script di aggiornamento. Per eseguire questa operazione, cercare "Pacchetto di aggiornamento della soluzione XML Documentation 4.0" nel portale di distribuzione software Adobe che scaricherà un file zip.
  3. Carica questo pacchetto in AEM tramite Gestione pacchetti e installa il pacchetto.
  4. Una volta installato il pacchetto di aggiornamento, esegui i seguenti script specificati nello stesso ordine e segui le istruzioni fornite:

Verifica API compatibilità aggiornamento

Questa API è progettata per valutare lo stato corrente del sistema e segnalare se l’aggiornamento è possibile o meno. Per eseguire questo script, attiva il seguente endpoint specificato:

Punto finale
/bin/dxml/upgrade/3xto4x/report
Tipo di richiesta
GET È possibile utilizzare un browser Web in cui è stato effettuato l'accesso all'istanza AEM come amministratore.
Risposta prevista
- Nel caso in cui tutti i nodi richiesti possano essere spostati, riceverai un controllo superato.
- Se nella posizione di destinazione è presente un nodo, viene visualizzato un errore rilevante. Pulisci l’archivio (elimina nodo /var/dxml) e reinstalla il pacchetto di aggiornamento, quindi attiva di nuovo questo endpoint.
Nota: non si tratta di un errore comune in quanto il percorso di destinazione non è stato utilizzato in precedenza da Experience Manager Guides 3.x.
- Se questo script non riesce, non procedere e segnalalo al team di successo del cliente.

API di migrazione dati di sistema

Questa API è progettata per migrare i dati di sistema come indicato nella sezione Mappatura migrazione.

  1. Non eseguire questo script se l’API Verifica compatibilità aggiornamento non riesce (non procedere).
  2. Una volta che l’API di verifica compatibilità dell’aggiornamento restituisce il risultato positivo, puoi eseguire lo script di aggiornamento.
Punto finale
/bin/dxml/upgrade/3xto4x
Tipo di richiesta
POST Questo script è una richiesta POST, quindi deve essere eseguito tramite agenti come Postman.
Risposta prevista
- Una volta completata la migrazione, è possibile installare la soluzione XML Documentation versione 4.0.
- In caso di errori, ripristina l’ultimo punto di controllo e condividi i registri degli errori con l’output API al team di successo del cliente.

Mappatura migrazione: l'API precedente esegue la migrazione di tutti i dati nel percorso di origine nel percorso di destinazione.

Sorgente
Destinazione
/content/fmdita
/var/dxml
/content/dxml
/var/dxml
/etc/fmdita
/libs/fmdita

Installa versione 4.0 id23598G006XA

  1. Installa la versione 4.0 solo se i passaggi di aggiornamento hanno avuto esito positivo.

  2. Scarica il pacchetto di versione 4.0 da Portale di distribuzione software di Adobe:

    • Se utilizzi una versione UUID del software, cerca "4.0 UUID Release for XML Documentation solution for AEM 6.5".
    • Se si utilizza una versione del software non UUID, cercare "4.0 Non-UUID Release for XML Documentation solution for AEM 6.5".
      Carica il pacchetto nell'istanza del server AEM esistente utilizzando Gestione pacchetti di CRX e installalo.
    note note
    NOTE
    Attendere l'avvio di tutti i componenti di sistema.

  3. Cancella la cache del browser dopo l’installazione del pacchetto.

  4. Se un dispatcher è configurato nell’istanza di creazione dell’AEM, effettua le seguenti operazioni:

    • Assicurati che nelle regole del dispatcher vengano gestiti i seguenti elementi:
    • Il pattern URL /home/users/*/preferences è inserito nella whitelist.
    • Il modello URL /libs/cq/security/userinfo.json non è memorizzato nella cache.

  5. Cancella cache del dispatcher (per cancellare qualsiasi clientlibs memorizzato nella cache).

Aggiornamento alla versione 4.2 id22A3F500SXA

L’aggiornamento alla versione 4.2 dipende dalla versione corrente di Experience Manager Guides.

Se utilizzi le versioni 4.0, 4.1 o 4.1.x, puoi eseguire direttamente l’aggiornamento alla versione 4.2.

​ ​Prerequisiti​ ​

Prima di avviare il processo di aggiornamento di Experience Manager Guides 4.2, assicurati di disporre di:

  1. Aggiornato a Experience Manager Guides versione 4.0, 4.1 o 4.1.x.
  2. Ha chiuso tutte le attività di traduzione.
  3. Il livello di registro è stato modificato in INFO per la classe com.adobe.fmdita.translationservices.TranslationMapUpgradeScript e questi registri sono stati aggiunti in un nuovo file di registro, ad esempio logs/translation_upgrade.log.
NOTE
Chiudere tutte le recensioni attive. Se le attività di revisione non vengono chiuse durante l’aggiornamento alla versione 4.2, le precedenti attività di revisione in corso continuano a coinvolgere gli utenti nelle pagine di revisione precedenti e le attività di revisione create dopo l’aggiornamento visualizzano gli ultimi aggiornamenti della funzionalità.

Installare la versione 4.2 id2245IK0E0EV

  1. Scarica il pacchetto di versione 4.2 da Adobe Software Distribution Portal.

  2. Installa la versione 4.2 del pacchetto.

  3. Dopo aver completato l’installazione del pacchetto, attendi i seguenti messaggi(s) nei registri:

    Completed the post deployment setup script

    Il messaggio sopra riportato indica che tutti i passaggi dell'installazione sono stati completati.

    Se riscontri uno dei seguenti prefissi ERROR, segnalali al team di successo del cliente:

    • Errore nello script di installazione post-distribuzione
    • Eccezione durante il porting del MAP di traduzione
    • Impossibile trasferire la mappa di traduzione dalla versione 1 alla versione 2 per la proprietà

  4. Aggiornamento del plug-in del connettore ossigeno rilasciato con la versione 4.2 (se necessario).

  5. Cancella la cache del browser dopo l’installazione del pacchetto.

  6. Continua ad aggiornare le personalizzazioni come descritto nella sezione successiva.

Dopo aver installato la versione 4.2 id2326F02004K

IMPORTANT
Il modello Hi-tech non viene visualizzato sul server aggiornato. Per includere il modello hi-tech sul tuo server puoi copiarlo: Source: /libs/fmdita/pdf/Hi-Tech Destinazione: /content/dam/dita-templates/pdf

Dopo aver installato Experience Manager Guides, è possibile unire le varie configurazioni applicabili dalla versione appena installata alla configurazione.

NOTE
Il modello dam-update-asset può essere personalizzato. Pertanto, se sono state apportate personalizzazioni, è necessario sincronizzare le personalizzazioni e Experience Manager Guides nella copia di lavoro del modello.

  1. Flusso di lavoro Aggiorna risorsa DAM (Modifiche post-elaborazione):

  2. Apri URL:

    code language-http 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. Seleziona Flusso di lavoro Aggiorna risorsa DAM.

  4. Fai clic su Modifica.

  5. Se il componente DXML Post Process Initiator è presente, verificare che le personalizzazioni siano sincronizzate.

  6. Se il componente DXML Post Process Initiator è assente, eseguire la procedura seguente per inserirlo:

  7. Fare clic su Inserisci componente (Responsabile della post-elaborazione di Experience Manager Guides come fase finale del processo).

  8. Configura il passaggio del processo con i dettagli seguenti:

    Scheda comune

    Titolo: iniziatore post-elaborazione DXML

    Descrizione: passaggio iniziatore post-elaborazione DXML che attiverà un processo sling per la post-elaborazione DXML della risorsa modificata/creata

    Scheda Elabora

    • Seleziona DXML Post Process Initiator dal menu a discesa Process

    • Seleziona Avanzamento gestore

    • Seleziona Fine

  9. Fai clic su Sincronizza in alto a destra dopo aver completato le modifiche. Riceverai una notifica di esito positivo.

    note note
    NOTE
    Aggiorna e verifica che le modifiche personalizzate e il passaggio di post-elaborazione Experience Manager Guides siano presenti nel modello di flusso di lavoro finale.

  10. Una volta convalidato il flusso di lavoro Aggiorna risorsa DAM, controlla le configurazioni del modulo di avvio corrispondenti. Per farlo, vai all’interfaccia del flusso di lavoro AEM e apri i moduli di avvio.

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    Trova e apporta le modifiche (se necessario) ai seguenti due moduli di avvio (che dovrebbe essere attivo) corrispondenti al flusso di lavoro Aggiorna risorsa DAM:

  11. Modulo di avvio per "Nodo creato" per Flusso di lavoro Aggiorna risorsa DAM- per la condizione "jcr:content/jcr:mimeType!=video", il valore 'Globbing' deve essere:

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • 'excludeList' deve avere "event-user-data:changedByWorkflowProcess".
    • Modulo di avvio per "Node Modified" per Flusso di lavoro Aggiorna risorsa DAM - per la condizione "jcr:content/jcr:mimeType!=video",
    • il valore 'Globbing' deve essere:
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • 'excludeList' deve avere "event-user-data:changedByWorkflowProcess".

  12. Al termine dell’aggiornamento, accertati che le personalizzazioni/sovrapposizioni siano convalidate e aggiornate in modo che corrispondano al nuovo codice dell’applicazione. Di seguito sono riportati alcuni esempi:

    • Tutti i componenti sovrapposti da/libs/fmditaor/libssdevono essere confrontati con il nuovo codice del prodotto e gli aggiornamenti devono essere eseguiti in file sovrapposti in/apps.
    • Tutte le categorie clientlib utilizzate dal prodotto, devono essere riviste per eventuali modifiche. Eventuali configurazioni sostituite (esempi di seguito) devono essere confrontate con quelle più recenti in modo da ottenere le funzioni più recenti:
    • elementmapping.xml
    • ui_config.json(potrebbe essere stato impostato in profili cartella)
    • ha modificato com.adobe.fmdita.config.ConfigManager
    • Verifica se uno dei codici personalizzati utilizzava percorsi precedenti (come indicato nella sezione Mappatura migrazione) - deve essere aggiornato ai nuovi percorsi in modo che anche le personalizzazioni funzionino come previsto.

  13. Leggi le informazioni sulle nuove configurazioni introdotte nella versione corrente (controlla Note sulla versione) e scopri se sono interessate eventuali funzionalità, quindi adotta le misure appropriate. Un esempio potrebbe essere quello di utilizzare "Gestione migliorata dei file e delle versioni" introdotta nella versione 4.0, per la quale è necessario abilitare una configurazione.

Passaggi per indicizzare il contenuto esistente per utilizzare la nuova funzione Trova e sostituisci:

Effettua le seguenti operazioni per indicizzare il contenuto esistente e utilizzare il nuovo testo Trova e sostituisci a livello di mappa:

  • Esegui una richiesta POST al server (con autenticazione corretta) - http://<server:port\>/bin/guides/map-find/indexing. (Facoltativo: È possibile passare percorsi specifici delle mappe per indicizzarle; per impostazione predefinita, tutte le mappe saranno indicizzate || Esempio: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • L’API restituirà un jobId. Per verificare lo stato del processo, puoi inviare una richiesta di GET con ID processo allo stesso endpoint:

http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}(Ad esempio: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42)

  • Una volta completato il processo, la richiesta di GET di cui sopra risponderà con successo e menzionerà se eventuali mappe non sono riuscite. Le mappe indicizzate correttamente possono essere confermate dai registri del server.

Se il processo di aggiornamento non riesce e il registro degli errori mostra il seguente errore:

"La query ha letto o attraversato più di 100000 nodi. Per evitare di influenzare altre attività, l’elaborazione è stata interrotta."

Ciò potrebbe verificarsi perché l’indice non è configurato correttamente per la query utilizzata nell’aggiornamento. È possibile provare la seguente soluzione alternativa:

  1. Nell'indice oak damAssetLucene aggiungere la proprietà booleana indexNodeName come true nel nodo.
    /oak:index/damAssetLucene/indexRules/dam:Asset

  2. Aggiungi un nuovo nodo con il nome estratto sotto il nodo.

    /oak:index/damAssetLucene/indexRules/dam:Asset/properties
    e imposta le seguenti proprietà nel nodo:

    code language-none 
    name - rep:excerpt
propertyIndex - {Boolean}true
notNullCheckEnabled - {Boolean}true

    La struttura di damAssetLucene deve essere simile a:

    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>

    (insieme ad altri nodi e proprietà esistenti)

  3. Reindicizzare l'indice damAssetLucene (impostando il flag di reindicizzazione come true in
    e attendi che sia di nuovo false (questo indica che la reindicizzazione è completa). Tieni presente che potrebbero essere necessarie alcune ore a seconda delle dimensioni dell’indice.

  4. Esegui nuovamente lo script di indicizzazione eseguendo i passaggi precedenti.

Aggiornamento alla versione 4.2.1 upgrade-version-4-2-1

TIP
Si consiglia di installare Hotfix 4.2.1.3 oltre alla versione 4.2.1.

L’aggiornamento alla versione 4.2.1 dipende dalla versione corrente di Experience Manager Guides. Se utilizzi le versioni 4.1 o 4.1.x o 4.2, puoi eseguire direttamente l’aggiornamento alla versione 4.2.1.

NOTE
La post-elaborazione e l’indicizzazione potrebbero richiedere alcune ore. Si consiglia di avviare il processo di aggiornamento durante le ore non di punta.

​ ​Prerequisiti​ ​

Prima di avviare il processo di aggiornamento di Experience Manager Guides 4.2.1, assicurati di disporre di:

  1. Aggiornamento a Experience Manager Guides versione 4.1, 4.1.x o 4.2.
  2. Ha chiuso tutte le attività di traduzione.
  3. Il livello di registro è stato modificato in INFO per la classe com.adobe.fmdita.translationservices.TranslationMapUpgradeScript e questi registri sono stati aggiunti in un nuovo file di registro, ad esempio logs/translation_upgrade.log.
NOTE
Chiudere tutte le recensioni attive. Se le attività di revisione non vengono chiuse durante l’aggiornamento alla versione 4.2, le precedenti attività di revisione in corso continuano a coinvolgere gli utenti nelle pagine di revisione precedenti e le attività di revisione create dopo l’aggiornamento visualizzano gli ultimi aggiornamenti della funzionalità.

Installare la versione 4.2.1

  1. Scarica il pacchetto di versione 4.2.1 da Adobe Software Distribution Portal.

  2. Installa la versione 4.2.1 del pacchetto.

  3. Puoi scegliere di premere il trigger per avviare il processo di aggiornamento della mappa di traduzione. Per ulteriori dettagli, vedere Abilitare il trigger dello script tramite un servlet.

  4. Dopo aver completato l’installazione del pacchetto, attendi i seguenti messaggi(s) nei registri:

    Completed the post deployment setup script

    Il messaggio sopra riportato indica che tutti i passaggi dell'installazione sono stati completati.

    Se riscontri uno dei seguenti prefissi ERROR, segnalali al team di successo del cliente:

    • Errore nello script di installazione post-distribuzione
    • Eccezione durante il porting del MAP di traduzione
    • Impossibile trasferire la mappa di traduzione dalla versione 1 alla versione 2 per la proprietà

  5. Aggiornamento del plug-in del connettore ossigeno rilasciato con la versione 4.2 (se necessario).

  6. Cancella la cache del browser dopo l’installazione del pacchetto.

  7. Continua ad aggiornare le personalizzazioni come descritto nella sezione successiva.

Abilitare l’attivazione dello script tramite un servlet enable-trigger-serverlet

POST:

http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade

Risposta:

{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}

Nella risposta JSON precedente, la chiave lockNodePath contiene il percorso del nodo creato nell'archivio che punta al processo inviato. Verrà eliminato automaticamente una volta completato il processo; fino ad allora, puoi fare riferimento a questo nodo per lo stato corrente del processo.

Registro di esempio:
Di seguito è riportato un esempio di registri che verranno visualizzati nel file di registro dopo l'attivazione dello script.

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

Cercare com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2 e com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2 prima di procedere ai passaggi successivi.

Dopo aver installato la versione 4.2.1

IMPORTANT
Il modello Hi-tech non viene visualizzato sul server aggiornato. Per includere il modello hi-tech sul tuo server puoi copiarlo: Source: /libs/fmdita/pdf/Hi-Tech Destinazione: /content/dam/dita-templates/pdf

Dopo aver installato Experience Manager Guides, è possibile unire le varie configurazioni applicabili dalla versione appena installata alla configurazione.

NOTE
Il modello dam-update-asset può essere personalizzato. Pertanto, se sono state apportate personalizzazioni, è necessario sincronizzare le personalizzazioni e Experience Manager Guides nella copia di lavoro del modello.

  1. Flusso di lavoro Aggiorna risorsa DAM (Modifiche post-elaborazione):

  2. Apri URL:

    code language-http 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. Seleziona Flusso di lavoro Aggiorna risorsa DAM.

  4. Fai clic su Modifica.

  5. Se il componente DXML Post Process Initiator è presente, verificare che le personalizzazioni siano sincronizzate.

  6. Se il componente DXML Post Process Initiator è assente, eseguire la procedura seguente per inserirlo:

  7. Fare clic su Inserisci componente (Responsabile della post-elaborazione di Experience Manager Guides come fase finale del processo).

  8. Configura il passaggio del processo con i dettagli seguenti:

    Scheda comune

    Titolo: iniziatore post-elaborazione DXML

    Descrizione: passaggio iniziatore post-elaborazione DXML che attiverà un processo sling per la post-elaborazione DXML della risorsa modificata/creata

    Scheda Elabora

    • Seleziona DXML Post Process Initiator dal menu a discesa Process

    • Seleziona Avanzamento gestore

    • Seleziona Fine

  9. Fai clic su Sincronizza in alto a destra dopo aver completato le modifiche. Riceverai una notifica di esito positivo.

    note note
    NOTE
    Aggiorna e verifica che le modifiche personalizzate e il passaggio di post-elaborazione Experience Manager Guides siano presenti nel modello di flusso di lavoro finale.

  10. Una volta convalidato il flusso di lavoro Aggiorna risorsa DAM, controlla le configurazioni del modulo di avvio corrispondenti. Per farlo, vai all’interfaccia del flusso di lavoro AEM e apri i moduli di avvio.

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    Trova e apporta le modifiche (se necessario) ai seguenti due moduli di avvio (che dovrebbe essere attivo) corrispondenti al flusso di lavoro Aggiorna risorsa DAM:

  11. Modulo di avvio per "Nodo creato" per Flusso di lavoro Aggiorna risorsa DAM- per la condizione "jcr:content/jcr:mimeType!=video", il valore 'Globbing' deve essere:

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • 'excludeList' deve avere "event-user-data:changedByWorkflowProcess".
    • Modulo di avvio per "Node Modified" per Flusso di lavoro Aggiorna risorsa DAM - per la condizione "jcr:content/jcr:mimeType!=video", il valore 'Globbing' deve essere:
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList deve avere "event-user-data:changedByWorkflowProcess".

  12. Al termine dell’aggiornamento, accertati che le personalizzazioni/sovrapposizioni siano convalidate e aggiornate in modo che corrispondano al nuovo codice dell’applicazione. Di seguito sono riportati alcuni esempi:

    • Tutti i componenti sovrapposti da/libs/fmditaor/libssdevono essere confrontati con il nuovo codice del prodotto e gli aggiornamenti devono essere eseguiti in file sovrapposti in/apps.
    • Tutte le categorie clientlib utilizzate dal prodotto, devono essere riviste per eventuali modifiche. Eventuali configurazioni sostituite (esempi di seguito) devono essere confrontate con quelle più recenti in modo da ottenere le funzioni più recenti:
    • elementmapping.xml
    • ui_config.json(potrebbe essere stato impostato in profili cartella)
    • ha modificato com.adobe.fmdita.config.ConfigManager
    • Verifica se uno dei codici personalizzati utilizzava percorsi precedenti (come indicato nella sezione Mappatura migrazione) - deve essere aggiornato ai nuovi percorsi in modo che anche le personalizzazioni funzionino come previsto.

  13. Leggi le informazioni sulle nuove configurazioni introdotte nella versione corrente (controlla Note sulla versione) e scopri se sono interessate eventuali funzionalità, quindi adotta le misure appropriate. Un esempio potrebbe essere quello di utilizzare "Gestione migliorata dei file e delle versioni" introdotta nella versione 4.0, per la quale è necessario abilitare una configurazione.

Passaggi per indicizzare il contenuto esistente per utilizzare la nuova funzione Trova e sostituisci:

Effettua le seguenti operazioni per indicizzare il contenuto esistente e utilizzare il nuovo testo Trova e sostituisci a livello di mappa:

  • Verificare che l'indicizzazione damAssetLucene sia stata completata. Può richiedere alcune ore, a seconda della quantità di dati presenti sul server. Puoi confermare che la reindicizzazione è stata completata verificando che il campo di reindicizzazione sia impostato su false in
    http://<server:port>/oak:index/damAssetLucene. Inoltre, se hai aggiunto delle personalizzazioni in damAssetLucene, potrebbe essere necessario applicarle nuovamente.

  • Esegui una richiesta POST al server (con autenticazione corretta) - http://<server:port\>/bin/guides/map-find/indexing. (Facoltativo: Puoi passare percorsi specifici delle mappe per indicizzarle; per impostazione predefinita, tutte le mappe saranno indicizzate || Esempio: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • È inoltre possibile passare una cartella principale per indicizzare le mappe DITA di una cartella specifica (e delle relative sottocartelle). Ad esempio, http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test. Si noti che se vengono passati sia il parametro paths che il parametro root, viene considerato solo il parametro paths.

  • L’API restituirà un jobId. Per verificare lo stato del processo, è possibile inviare una richiesta di GET con ID processo allo stesso endpoint: http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}\ (ad esempio: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42)

  • Una volta completato il processo, la richiesta di GET di cui sopra risponderà con successo e menzionerà se eventuali mappe non sono riuscite. Le mappe indicizzate correttamente possono essere confermate dai registri del server.

Aggiornamento alla versione 4.3.0 upgrade-version-4-3

L’aggiornamento alla versione 4.3.0 dipende dalla versione corrente di Experience Manager Guides. Se utilizzi la versione 4.2 o 4.2.x, puoi eseguire direttamente l’aggiornamento alla versione 4.3.0.

NOTE
La post-elaborazione e l’indicizzazione potrebbero richiedere alcune ore. Si consiglia di avviare il processo di aggiornamento durante le ore non di punta.

​ ​Prerequisiti​ ​

Prima di avviare il processo di aggiornamento di Experience Manager Guides 4.3.0, assicurati di disporre di:

  1. Aggiornato a Experience Manager Guides versione 4.2 o 4.2.x e completato il rispettivo passaggio di installazione.
  2. Ha chiuso tutte le attività di traduzione.

Installare la versione 4.3.0

  1. Scarica il pacchetto di versione 4.3.0 da portale di distribuzione software Adobe.
  2. Installa la versione 4.3.0 del pacchetto.
  3. Cancella la cache del browser dopo l’installazione del pacchetto.
  4. Aggiornare il file ui_config.json dalla scheda Configurazione editor XML nel Profilo cartella.

Dopo aver installato la versione 4.3.0

Dopo aver installato Experience Manager Guides, è possibile unire le varie configurazioni applicabili dalla versione appena installata alla configurazione.

Passaggi per pubblicare ed elaborare il contenuto esistente per utilizzare il rapporto sui collegamenti interrotti

Effettua le seguenti operazioni per la post-elaborazione del contenuto esistente e l’utilizzo del nuovo rapporto sui collegamenti interrotti:

  1. (Facoltativo) Se nel sistema sono presenti più di 100.000 file dita, aggiornare queryLimitReads in org.apache.jackrabbit.oak.query.QueryEngineSettingsService a un valore maggiore (qualsiasi valore maggiore del numero di risorse presenti, ad esempio 200.000) e quindi ridistribuire.

    table 0-row-3 1-row-3
    PID Chiave proprietà Valore proprietà
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Valore: 200000
    Valore predefinito: 100000

  2. Esegui le seguenti API per eseguire la post-elaborazione su tutti i file:

    table 0-row-2 1-row-2 2-row-2
    Punto finale /bin/guides/reports/upgrade
    Tipo di richiesta POST Questo script è una richiesta POST, quindi deve essere eseguito tramite agenti come Postman.
    Risposta prevista L’API restituirà un jobId. Per verificare lo stato del processo, puoi inviare una richiesta di GET con ID processo allo stesso punto finale.
    URL di esempio: http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    Punto finale /bin/guides/reports/upgrade
    Tipo di richiesta GET
    Parametro jobId: passa il jobId ricevuto dalla richiesta post precedente.
    Risposta prevista - Una volta completato il processo, la richiesta di GET risponde con successo.
    - In caso di errori, condividi i registri degli errori con il tuo team Customer Success insieme all'output API.
    URL di esempio: http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678

  3. Ripristinare il valore predefinito o esistente precedente di queryLimitReads se è stato modificato nel passaggio 1.

Aggiornamento alla versione 4.3.1 upgrade-version-4-3-1

L’aggiornamento alla versione 4.3.1 dipende dalla versione corrente di Experience Manager Guides. Se utilizzi le versioni 4.3.0, 4.2 o 4.2.1, puoi eseguire direttamente l’aggiornamento alla versione 4.3.1.

NOTE
La post-elaborazione e l’indicizzazione potrebbero richiedere alcune ore. Si consiglia di avviare il processo di aggiornamento durante le ore non di punta.

​ ​Prerequisiti​ ​

Prima di avviare il processo di aggiornamento di Experience Manager Guides 4.3.1, assicurati di disporre di:

  1. Aggiornato a Experience Manager Guides versione 4.3.0, 4.2 o 4.2.1 e completato il rispettivo passaggio di installazione.
  2. (Facoltativo) Ha chiuso tutte le attività di traduzione.
  3. Il livello di registro è stato modificato in INFO per la classe com.adobe.fmdita.translationservices.TranslationMapUpgradeScript e questi registri sono stati aggiunti in un nuovo file di registro, ad esempio logs/translation_upgrade.log.

Installare la versione 4.3.1

  1. Scarica il pacchetto di versione 4.3.1 da Portale di distribuzione software di Adobe.

  2. Installa la versione 4.3.1 del pacchetto.

  3. Puoi scegliere di premere il trigger per avviare il processo di aggiornamento della mappa di traduzione. Per ulteriori dettagli, vedere Abilitare il trigger dello script tramite un servlet.

  4. Dopo aver completato l’installazione del pacchetto, attendi i seguenti messaggi(s) nei registri:

    Completed the post deployment setup script

    Il messaggio sopra riportato indica che tutti i passaggi dell'installazione sono stati completati.

    Se riscontri uno dei seguenti prefissi ERROR, segnalali al team di successo del cliente:

    • Errore nello script di installazione post-distribuzione
    • Eccezione durante il porting del MAP di traduzione
    • Impossibile trasferire la mappa di traduzione dalla versione 1 alla versione 2 per la proprietà

  5. Aggiornamento del plug-in del connettore ossigeno rilasciato con la versione 4.2 (se necessario).

  6. Cancella la cache del browser dopo l’installazione del pacchetto.

  7. Continua ad aggiornare le personalizzazioni come descritto nella sezione successiva.

Abilitare l’attivazione dello script tramite un servlet enable-trigger-serverlet-4-3-1

POST:

http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade

Risposta:

{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}

Nella risposta JSON precedente, la chiave lockNodePath contiene il percorso del nodo creato nell'archivio che punta al processo inviato. Verrà eliminato automaticamente una volta completato il processo; fino ad allora, puoi fare riferimento a questo nodo per lo stato corrente del processo.

Registro di esempio:
Di seguito è riportato un esempio di registri che verranno visualizzati nel file di registro dopo l'attivazione dello script.

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

Cercare com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2 e com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2 prima di procedere ai passaggi successivi.

Dopo aver installato la versione 4.3.1

Dopo aver installato Experience Manager Guides, è possibile unire le varie configurazioni applicabili dalla versione appena installata alla configurazione.

NOTE
Il modello dam-update-asset può essere personalizzato. Pertanto, se sono state apportate personalizzazioni, è necessario sincronizzare le personalizzazioni e Experience Manager Guides nella copia di lavoro del modello.

  1. Flusso di lavoro Aggiorna risorsa DAM (Modifiche post-elaborazione):

  2. Apri URL:

    code language-none 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. Seleziona Flusso di lavoro Aggiorna risorsa DAM.

  4. Fai clic su Modifica.

  5. Se il componente DXML Post Process Initiator è presente, verificare che le personalizzazioni siano sincronizzate.

  6. Se il componente DXML Post Process Initiator è assente, eseguire la procedura seguente per inserirlo:

  7. Fare clic su Inserisci componente (Responsabile della post-elaborazione di Experience Manager Guides come fase finale del processo).

  8. Configura il passaggio del processo con i dettagli seguenti:

    Scheda comune

    Titolo: iniziatore post-elaborazione DXML

    Descrizione: passaggio iniziatore post-elaborazione DXML che attiverà un processo sling per la post-elaborazione DXML della risorsa modificata/creata

    Scheda Elabora

    • Seleziona DXML Post Process Initiator dal menu a discesa Process

    • Seleziona Avanzamento gestore

    • Seleziona Fine

  9. Fai clic su Sincronizza in alto a destra dopo aver completato le modifiche. Riceverai una notifica di esito positivo.

    note note
    NOTE
    Aggiorna e verifica che le modifiche personalizzate e il passaggio di post-elaborazione Experience Manager Guides siano presenti nel modello di flusso di lavoro finale.

  10. Una volta convalidato il flusso di lavoro Aggiorna risorsa DAM, controlla le configurazioni del modulo di avvio corrispondenti. Per farlo, vai all’interfaccia del flusso di lavoro AEM e apri i moduli di avvio.

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    Trova e apporta le modifiche (se necessario) ai seguenti due moduli di avvio (che dovrebbe essere attivo) corrispondenti al flusso di lavoro Aggiorna risorsa DAM:

  11. Modulo di avvio per "Nodo creato" per Flusso di lavoro Aggiorna risorsa DAM- per la condizione "jcr:content/jcr:mimeType!=video", il valore 'Globbing' deve essere:

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • 'excludeList' deve avere "event-user-data:changedByWorkflowProcess".
    • Modulo di avvio per "Node Modified" per Flusso di lavoro Aggiorna risorsa DAM - per la condizione "jcr:content/jcr:mimeType!=video", il valore 'Globbing' deve essere:
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList deve avere "event-user-data:changedByWorkflowProcess".

  12. Al termine dell’aggiornamento, accertati che le personalizzazioni/sovrapposizioni siano convalidate e aggiornate in modo che corrispondano al nuovo codice dell’applicazione. Di seguito sono riportati alcuni esempi:

    • Tutti i componenti sovrapposti da/libs/fmditaor/libssdevono essere confrontati con il nuovo codice del prodotto e gli aggiornamenti devono essere eseguiti in file sovrapposti in/apps.
    • Tutte le categorie clientlib utilizzate dal prodotto, devono essere riviste per eventuali modifiche. Eventuali configurazioni sostituite (esempi di seguito) devono essere confrontate con quelle più recenti in modo da ottenere le funzioni più recenti:
    • elementmapping.xml
    • ui_config.json(potrebbe essere stato impostato in profili cartella)
    • ha modificato com.adobe.fmdita.config.ConfigManager

Passaggi per indicizzare il contenuto esistente

NOTE
Non è necessario eseguire questi passaggi se si esegue l’aggiornamento da 4.3.0 o 4.2.1.

Effettua le seguenti operazioni per indicizzare il contenuto esistente e utilizzare il nuovo testo Trova e sostituisci a livello di mappa:

  • Esegui una richiesta POST al server (con autenticazione corretta) - http://<server:port\>/bin/guides/map-find/indexing. (Facoltativo: Puoi passare percorsi specifici delle mappe per indicizzarle; per impostazione predefinita, tutte le mappe saranno indicizzate || Esempio: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • L’API restituirà un jobId. Per verificare lo stato del processo, è possibile inviare una richiesta di GET con ID processo allo stesso endpoint: http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}\ (ad esempio: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42)

  • Una volta completato il processo, la richiesta di GET di cui sopra risponderà con successo e menzionerà se eventuali mappe non sono riuscite. Le mappe indicizzate correttamente possono essere confermate dai registri del server.

Passaggi per pubblicare ed elaborare il contenuto esistente per utilizzare il rapporto sui collegamenti interrotti

NOTE
Non è necessario eseguire questi passaggi se si esegue l’aggiornamento da 4.3.0

Effettua le seguenti operazioni per la post-elaborazione del contenuto esistente e l’utilizzo del nuovo rapporto sui collegamenti interrotti:

  1. (Facoltativo) Se nel sistema sono presenti più di 100.000 file dita, aggiornare queryLimitReads in org.apache.jackrabbit.oak.query.QueryEngineSettingsService a un valore maggiore (qualsiasi valore maggiore del numero di risorse presenti, ad esempio 200.000) e quindi ridistribuire.

    table 0-row-3 1-row-3
    PID Chiave proprietà Valore proprietà
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Valore: 200000
    Valore predefinito: 100000

  2. Esegui le seguenti API per eseguire la post-elaborazione su tutti i file:

    table 0-row-2 1-row-2 2-row-2
    Punto finale /bin/guides/reports/upgrade
    Tipo di richiesta POST Questo script è una richiesta POST, quindi deve essere eseguito tramite agenti come Postman.
    Risposta prevista L’API restituirà un jobId. Per verificare lo stato del processo, puoi inviare una richiesta di GET con ID processo allo stesso punto finale.
    URL di esempio: http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    Punto finale /bin/guides/reports/upgrade
    Tipo di richiesta GET
    Parametro jobId: passa il jobId ricevuto dalla richiesta post precedente.
    Risposta prevista - Una volta completato il processo, la richiesta di GET risponde con successo.
    - In caso di errori, condividi i registri degli errori con il tuo team Customer Success insieme all'output API.
    URL di esempio: http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678

  3. Ripristinare il valore predefinito o esistente precedente di queryLimitReads se è stato modificato nel passaggio 1.

Aggiornamento alla versione 4.3.1.5 upgrade-version-4-3-1-5

L’aggiornamento alla versione 4.3.1.5 dipende dalla versione corrente di Experience Manager Guides. Se utilizzi la versione 4.3.1 di puoi effettuare direttamente l’aggiornamento alla versione 4.3.1.5 di.

Installare la versione 4.3.1.5

  1. Scarica il pacchetto di versione 4.3.1.5 da portale di distribuzione software Adobe.

  2. Installa il pacchetto versione 4.3.1.5.

  3. Attendere il completamento del processo di installazione.

  4. Continua ad aggiornare le personalizzazioni come descritto nella sezione successiva.

Dopo aver installato la versione 4.3.1.5

NOTE
Se desideri utilizzare il bundle org.apache.velocity, esegui i seguenti passaggi prima di caricare il bundle:
  1. Passa a <server>:<port>/system/console/bundles.
  2. Cerca org.apache.velocity.
  3. Disinstalla il bundle cercato.
  4. Installa il bundle Velocity richiesto.

  1. Al termine dell’aggiornamento, accertati che le personalizzazioni/sovrapposizioni siano convalidate e aggiornate in modo che corrispondano al nuovo codice dell’applicazione. Di seguito sono riportati alcuni esempi:

    • Tutti i componenti sovrapposti da /libs/fmdita o /libs devono essere confrontati con il nuovo codice prodotto e gli aggiornamenti devono essere eseguiti in file sovrapposti in /apps.
    • Tutte le categorie clientlib utilizzate dal prodotto, devono essere riviste per eventuali modifiche. Eventuali configurazioni sostituite (esempi di seguito) devono essere confrontate con quelle più recenti in modo da ottenere le funzioni più recenti:
    • elementmapping.xml
    • ui\_config.json\ (potrebbe essere stato impostato nei profili cartella)
    • ha modificato com.adobe.fmdita.config.ConfigManager

Aggiornamento alla versione 4.4.0 upgrade-version-4-4-0

L’aggiornamento alla versione 4.4.0 dipende dalla versione corrente di Experience Manager Guides. Se utilizzi le versioni 4.3.1, 4.3.0, 4.2 o 4.2.1 (Hotfix 4.2.1.3), puoi eseguire direttamente l’aggiornamento alla versione 4.4.0

NOTE
La post-elaborazione e l’indicizzazione potrebbero richiedere alcune ore. Si consiglia di avviare il processo di aggiornamento durante le ore non di punta.

​ ​Prerequisiti​ ​

Prima di avviare il processo di aggiornamento di Experience Manager Guides 4.4.0, assicurati di disporre di:

  1. Aggiornato a Experience Manager Guides versione 4.3.1, 4.3.0 o 4.2.1 (Hotfix 4.2.1.3), ha completato il rispettivo passaggio di installazione.
  2. (Facoltativo) Ha chiuso tutte le attività di traduzione.
  3. Il livello di registro è stato modificato in INFO per la classe com.adobe.fmdita.translationservices.TranslationMapUpgradeScript e questi registri sono stati aggiunti in un nuovo file di registro, ad esempio logs/translation_upgrade.log.

Installare la versione 4.4.0

  1. Scarica il pacchetto di versione 4.4.0 da portale di distribuzione software Adobe.

  2. Installa la versione 4.4.0 del pacchetto.

  3. Puoi scegliere di premere il trigger per avviare il processo di aggiornamento della mappa di traduzione. Per ulteriori dettagli, vedere Abilitare il trigger dello script tramite un servlet.

  4. Dopo aver completato l’installazione del pacchetto, attendi i seguenti messaggi(s) nei registri:

    Completed the post deployment setup script

    Il messaggio sopra riportato indica che tutti i passaggi dell'installazione sono stati completati.

    Se riscontri uno dei seguenti prefissi ERROR, segnalali al team di successo del cliente:

    • Errore nello script di installazione post-distribuzione
    • Eccezione durante il porting del MAP di traduzione
    • Impossibile trasferire la mappa di traduzione dalla versione 1 alla versione 2 per la proprietà

  5. Aggiornamento del plug-in del connettore ossigeno rilasciato con la versione 4.4.0 (se necessario).

  6. Cancella la cache del browser dopo l’installazione del pacchetto.

  7. Continua ad aggiornare le personalizzazioni come descritto nella sezione successiva.

Dopo aver installato la versione 4.4.0

Dopo aver installato Experience Manager Guides, è possibile unire le varie configurazioni applicabili dalla versione appena installata alla configurazione.

NOTE
Il modello dam-update-asset può essere personalizzato. Pertanto, se sono state apportate personalizzazioni, è necessario sincronizzare le personalizzazioni e Experience Manager Guides nella copia di lavoro del modello.

  1. Flusso di lavoro Aggiorna risorsa DAM (Modifiche post-elaborazione):

  2. Apri URL:

    code language-none 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. Seleziona Flusso di lavoro Aggiorna risorsa DAM.

  4. Fai clic su Modifica.

  5. Se il componente DXML Post Process Initiator è presente, verificare che le personalizzazioni siano sincronizzate.

  6. Se il componente DXML Post Process Initiator è assente, eseguire la procedura seguente per inserirlo:

  7. Fare clic su Inserisci componente (Responsabile della post-elaborazione di Experience Manager Guides come fase finale del processo).

  8. Configura il passaggio del processo con i dettagli seguenti:

    Scheda comune

    Titolo: iniziatore post-elaborazione DXML

    Descrizione: passaggio iniziatore post-elaborazione DXML che attiverà un processo sling per la post-elaborazione DXML della risorsa modificata/creata

    Scheda Elabora

    • Seleziona DXML Post Process Initiator dal menu a discesa Process

    • Seleziona Avanzamento gestore

    • Seleziona Fine

  9. Fai clic su Sincronizza in alto a destra dopo aver completato le modifiche. Riceverai una notifica di esito positivo.

    note note
    NOTE
    Aggiorna e verifica che le modifiche personalizzate e il passaggio di post-elaborazione Experience Manager Guides siano presenti nel modello di flusso di lavoro finale.

  10. Una volta convalidato il flusso di lavoro Aggiorna risorsa DAM, controlla le configurazioni del modulo di avvio corrispondenti. Per farlo, vai all’interfaccia del flusso di lavoro AEM e apri i moduli di avvio.

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    Trova e apporta le modifiche (se necessario) ai seguenti due moduli di avvio (che dovrebbe essere attivo) corrispondenti al flusso di lavoro Aggiorna risorsa DAM:

  11. Modulo di avvio per "Nodo creato" per Flusso di lavoro Aggiorna risorsa DAM- per la condizione "jcr:content/jcr:mimeType!=video", il valore 'Globbing' deve essere:

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • 'excludeList' deve avere "event-user-data:changedByWorkflowProcess".
    • Modulo di avvio per "Node Modified" per Flusso di lavoro Aggiorna risorsa DAM - per la condizione "jcr:content/jcr:mimeType!=video", il valore 'Globbing' deve essere:
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList deve avere "event-user-data:changedByWorkflowProcess".

  12. Al termine dell’aggiornamento, accertati che le personalizzazioni/sovrapposizioni siano convalidate e aggiornate in modo che corrispondano al nuovo codice dell’applicazione. Di seguito sono riportati alcuni esempi:

    • Tutti i componenti sovrapposti da/libs/fmditaor/libssdevono essere confrontati con il nuovo codice del prodotto e gli aggiornamenti devono essere eseguiti in file sovrapposti in/apps.
    • Tutte le categorie clientlib utilizzate dal prodotto, devono essere riviste per eventuali modifiche. Eventuali configurazioni sostituite (esempi di seguito) devono essere confrontate con quelle più recenti in modo da ottenere le funzioni più recenti:
    • elementmapping.xml
    • ui_config.json(potrebbe essere stato impostato in profili cartella)
    • ha modificato com.adobe.fmdita.config.ConfigManager

  13. Se hai aggiunto delle personalizzazioni in damAssetLucene, potresti dover applicarle nuovamente. Dopo aver apportato tali modifiche, imposta la reindicizzazione su true. In questo modo tutti i nodi esistenti verranno reindicizzati con le personalizzazioni. Al termine, il flag di reindicizzazione verrà impostato di nuovo su false. Questa operazione può richiedere alcune ore a seconda del numero di risorse nel sistema.

Passaggi per indicizzare il contenuto esistente

NOTE
Non è necessario eseguire questi passaggi se si esegue l’aggiornamento da 4.3.0 o 4.3.1.

Effettua le seguenti operazioni per indicizzare il contenuto esistente e utilizzare il nuovo testo Trova e sostituisci a livello di mappa:

  • Esegui una richiesta POST al server (con autenticazione corretta) - http://<server:port\>/bin/guides/map-find/indexing. (Facoltativo: Puoi passare percorsi specifici delle mappe per indicizzarle; per impostazione predefinita, tutte le mappe saranno indicizzate || Esempio: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • L’API restituirà un jobId. Per verificare lo stato del processo, è possibile inviare una richiesta di GET con ID processo allo stesso endpoint: http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}\ (ad esempio: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42)

  • Una volta completato il processo, la richiesta di GET di cui sopra risponderà con successo e menzionerà se eventuali mappe non sono riuscite. Le mappe indicizzate correttamente possono essere confermate dai registri del server.

Passaggi per pubblicare ed elaborare il contenuto esistente per utilizzare il rapporto sui collegamenti interrotti

NOTE
Non è necessario eseguire questi passaggi se si esegue l’aggiornamento da 4.3.0 o 4.3.1.

Effettua le seguenti operazioni per la post-elaborazione del contenuto esistente e l’utilizzo del nuovo rapporto sui collegamenti interrotti:

  1. (Facoltativo) Se nel sistema sono presenti più di 100.000 file dita, aggiornare queryLimitReads in org.apache.jackrabbit.oak.query.QueryEngineSettingsService a un valore maggiore (qualsiasi valore maggiore del numero di risorse presenti, ad esempio 200.000) e quindi ridistribuire.

    table 0-row-3 1-row-3
    PID Chiave proprietà Valore proprietà
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Valore: 200000
    Valore predefinito: 100000

  2. Esegui le seguenti API per eseguire la post-elaborazione su tutti i file:

    table 0-row-2 1-row-2 2-row-2
    Punto finale /bin/guides/reports/upgrade
    Tipo di richiesta POST Questo script è una richiesta POST, quindi deve essere eseguito tramite agenti come Postman.
    Risposta prevista L’API restituirà un jobId. Per verificare lo stato del processo, puoi inviare una richiesta di GET con ID processo allo stesso punto finale.
    URL di esempio: http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    Punto finale /bin/guides/reports/upgrade
    Tipo di richiesta GET
    Parametro jobId: passa il jobId ricevuto dalla richiesta post precedente.
    Risposta prevista - Una volta completato il processo, la richiesta di GET risponde con successo.
    - In caso di errori, condividi i registri degli errori con il tuo team Customer Success insieme all'output API.
    URL di esempio: http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678

  3. Ripristinare il valore predefinito o esistente precedente di queryLimitReads se è stato modificato nel passaggio 1.

Abilitare l’attivazione dello script tramite un servlet enable-trigger-serverlet-4-4-0

NOTE
Non è necessario eseguire questi passaggi se si esegue l’aggiornamento da 4.3.0 o 4.3.1.

POST:

http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade

Risposta:

{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}

Nella risposta JSON precedente, la chiave lockNodePath contiene il percorso del nodo creato nell'archivio che punta al processo inviato. Verrà eliminato automaticamente una volta completato il processo; fino ad allora, puoi fare riferimento a questo nodo per lo stato corrente del processo.

Cercare com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2 e com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2 prima di procedere ai passaggi successivi.

NOTE
Verifica se il nodo è ancora presente e lo stato del processo.

GET: http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json

Passaggi per gestire il conflitto 'fmdita rewriter'

Experience Manager Guides dispone di un modulo sling rewriter personalizzato per la gestione dei collegamenti generati in caso di mappe incrociate (collegamenti tra gli argomenti di due mappe diverse).

Se nel codebase è presente un altro rewriter sling personalizzato, utilizza un valore 'order' maggiore di 50, in quanto il rewriter sling di Experience Manager Guides utilizza 'order' 50. Per evitare questo problema, è necessario un valore > 50. Per ulteriori dettagli, visualizza Pipeline di riscrittura output.

Durante l'aggiornamento, poiché il valore 'order' viene modificato da 1000 a 50, è necessario unire l'eventuale rewriter personalizzato esistente con 'fmdita-rewriter'.

Argomento padre: ​ Scarica e installa

Aggiornamento alla versione 4.6.0 upgrade-version-4-6-0

TIP
Si consiglia di installare 4.6.0 Service Pack 1 sopra alla versione 4.6.0. Il processo di aggiornamento per la versione 4.6.0 Service Pack 1 segue gli stessi passaggi della versione 4.6.0.

L’aggiornamento alla versione 4.6.0 dipende dalla versione corrente di Experience Manager Guides. Se utilizzi le versioni 4.4.0, 4.3.1, 4.3.0, 4.2 o 4.2.1 (Hotfix 4.2.1.3), puoi eseguire direttamente l’aggiornamento alla versione 4.6.0.

NOTE
La post-elaborazione e l’indicizzazione potrebbero richiedere alcune ore. Si consiglia di avviare il processo di aggiornamento durante le ore non di punta.

​ ​Prerequisiti​ ​

Prima di avviare il processo di aggiornamento di Experience Manager Guides 4.6.0, assicurati di disporre di:

  1. Aggiornato a Experience Manager Guides versione 4.3.1, 4.3.0 o 4.2.1 (Hotfix 4.2.1.3), ha completato il rispettivo passaggio di installazione.
  2. (Facoltativo) Ha chiuso tutte le attività di traduzione.
  3. Il livello di registro è stato modificato in INFO per la classe com.adobe.fmdita.translationservices.TranslationMapUpgradeScript e questi registri sono stati aggiunti in un nuovo file di registro, ad esempio logs/translation_upgrade.log.

Installare la versione 4.6.0

  1. Scarica il pacchetto di versione 4.6.0 da portale di distribuzione software Adobe.

  2. Installa la versione 4.6.0 del pacchetto.

  3. Puoi scegliere di premere il trigger per avviare il processo di aggiornamento della mappa di traduzione. Per ulteriori dettagli, vedere Abilitare il trigger dello script tramite un servlet.

  4. Dopo aver completato l’installazione del pacchetto, attendi i seguenti messaggi(s) nei registri:

    Completed the post deployment setup script

    Il messaggio sopra riportato indica che tutti i passaggi dell'installazione sono stati completati.

    Se riscontri uno dei seguenti prefissi ERROR, segnalali al team di successo del cliente:

    • Errore nello script di installazione post-distribuzione
    • Eccezione durante il porting del MAP di traduzione
    • Impossibile trasferire la mappa di traduzione dalla versione 1 alla versione 2 per la proprietà

  5. Aggiornamento del plug-in del connettore ossigeno rilasciato con la versione 4.6.0 (if needed).

  6. Cancella la cache del browser dopo l’installazione del pacchetto.

Dopo aver installato la versione 4.6.0

Dopo aver installato Experience Manager Guides, è possibile unire le varie configurazioni applicabili dalla versione appena installata alla configurazione.

NOTE
Il modello dam-update-asset può essere personalizzato. Pertanto, se sono state apportate personalizzazioni, è necessario sincronizzare le personalizzazioni e Experience Manager Guides nella copia di lavoro del modello.

  1. Flusso di lavoro Aggiorna risorsa DAM (Modifiche post-elaborazione):

  2. Apri URL:

    code language-none 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. Seleziona Flusso di lavoro Aggiorna risorsa DAM.

  4. Fai clic su Modifica.

  5. Se il componente DXML Post Process Initiator è presente, verificare che le personalizzazioni siano sincronizzate.

  6. Se il componente DXML Post Process Initiator è assente, eseguire la procedura seguente per inserirlo:

  7. Fare clic su Inserisci componente (Responsabile della post-elaborazione di Experience Manager Guides come fase finale del processo).

  8. Configura il passaggio del processo con i dettagli seguenti:

    Scheda comune

    Titolo: iniziatore post-elaborazione DXML

    Descrizione: passaggio iniziatore post-elaborazione DXML che attiverà un processo sling per la post-elaborazione DXML della risorsa modificata/creata

    Scheda Elabora

    • Selezionare DXML Post Process Initiator dal menu a discesa Process

    • Seleziona Avanzamento gestore

    • Seleziona Fine

  9. Fai clic su Sincronizza in alto a destra dopo aver completato le modifiche. Riceverai una notifica di esito positivo.

    note note
    NOTE
    Aggiorna e verifica che le modifiche personalizzate e il passaggio di post-elaborazione Experience Manager Guides siano presenti nel modello di flusso di lavoro finale.

  10. Una volta convalidato il flusso di lavoro Aggiorna risorsa DAM, controlla le configurazioni del modulo di avvio corrispondenti. Per farlo, vai all’interfaccia del flusso di lavoro AEM e apri i moduli di avvio.

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    Trova e apporta le modifiche (se necessario) ai seguenti due moduli di avvio (che dovrebbe essere attivo) corrispondenti al flusso di lavoro Aggiorna risorsa DAM:

  11. Modulo di avvio per "Nodo creato" per Flusso di lavoro Aggiorna risorsa DAM- per la condizione "jcr:content/jcr:mimeType!=video", il valore 'Globbing' deve essere:

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • 'excludeList' deve avere "event-user-data:changedByWorkflowProcess".
    • Modulo di avvio per "Node Modified" per Flusso di lavoro Aggiorna risorsa DAM - per la condizione "jcr:content/jcr:mimeType!=video", il valore 'Globbing' deve essere:
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList deve avere "event-user-data:changedByWorkflowProcess".

  12. Al termine dell’aggiornamento, accertati che le personalizzazioni/sovrapposizioni siano convalidate e aggiornate in modo che corrispondano al nuovo codice dell’applicazione. Di seguito sono riportati alcuni esempi:

    • Tutti i componenti sovrapposti da/libs/fmditaor/libssdevono essere confrontati con il nuovo codice del prodotto e gli aggiornamenti devono essere eseguiti in file sovrapposti in/apps.
    • Tutte le categorie clientlib utilizzate dal prodotto, devono essere riviste per eventuali modifiche. Eventuali configurazioni sostituite (esempi di seguito) devono essere confrontate con quelle più recenti in modo da ottenere le funzioni più recenti:
    • elementmapping.xml
    • ui_config.json(potrebbe essere stato impostato in profili cartella)
    • ha modificato com.adobe.fmdita.config.ConfigManager

  13. Se hai aggiunto delle personalizzazioni in damAssetLucene, potresti dover applicarle nuovamente. Dopo aver apportato tali modifiche, imposta la reindicizzazione su true. In questo modo tutti i nodi esistenti verranno reindicizzati con le personalizzazioni. Al termine, il flag di reindicizzazione verrà impostato di nuovo su false. Questa operazione può richiedere alcune ore a seconda del numero di risorse nel sistema.

Passaggi per reindicizzare gli indici Experience Manager Guides

  1. Apri crx/de e passa al percorso indice: /oak:index/guidesAssetProperties

  2. Impostare la proprietà di reindicizzazione come true (false per impostazione predefinita) e fare clic su Salva tutto.

  3. Una volta completata la reindicizzazione, la proprietà di reindicizzazione viene nuovamente impostata su false e il conteggio di reindicizzazione viene incrementato di 1.

    note note
    NOTE
    Questa operazione può richiedere alcuni minuti, a seconda della quantità di dati presenti.

    4. Seguire la stessa procedura per gli altri indici aggiunti o modificati: `guidesBulkActivation`, `guidesPeerLinkIndex` e `guidesKonnectTemplateIndex`.

Passaggi per indicizzare il contenuto esistente

Per indicizzare il contenuto esistente, effettua le seguenti operazioni:

  • Esegui una richiesta POST al server (con autenticazione corretta) - http://<server:port\>/bin/guides/map-find/indexing. (Facoltativo: Puoi trasmettere percorsi specifici delle mappe per indicizzarle; per impostazione predefinita, tutte le mappe saranno indicizzate || Esempio: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • L’API restituirà un jobId. Per verificare lo stato del processo, è possibile inviare una richiesta di GET con ID processo allo stesso endpoint - http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}\ (ad esempio: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678)

  • Una volta completato il processo, la richiesta di GET di cui sopra risponderà con successo e menzionerà se eventuali mappe non sono riuscite. Le mappe indicizzate correttamente possono essere confermate dai registri del server.

NOTE
Se si utilizza lo schema personalizzato, è necessario definire il percorso dei file DTD e XSD catalog.xml personalizzati nell'archivio AEM nell'opzione Integrate Catalog.

Passaggi per gestire il conflitto 'fmdita rewriter'

Experience Manager Guides dispone di un modulo sling rewriter personalizzato per la gestione dei collegamenti generati in caso di mappe incrociate (collegamenti tra gli argomenti di due mappe diverse).

Se nel codebase è presente un altro rewriter sling personalizzato, utilizza un valore 'order' maggiore di 50, in quanto il rewriter sling di Experience Manager Guides utilizza 'order' 50. Per evitare questo problema, è necessario un valore > 50. Per ulteriori dettagli, visualizza Pipeline di riscrittura output.

Durante l'aggiornamento, poiché il valore 'order' viene modificato da 1000 a 50, è necessario unire l'eventuale rewriter personalizzato esistente con 'fmdita-rewriter'.

Argomento padre: Scarica e installa

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178