Actualizar Adobe Experience Manager Guides id224MBE0M0XA

NOTE
Siga las instrucciones de actualización específicas de la versión con licencia del producto.

Puede actualizar su versión actual de Experience Manager Guides a la versión 4.6.0:

  • Si utiliza las versiones 4.4, 4.3.1 o 4.3.0 , puede actualizar directamente a la versión 4.6.0.
  • Si utiliza las versiones 4.2, 4.2.1 (revisión 4.2.1.3), 4.1 o 4.1.x, debe actualizar a la versión 4.4 antes de actualizar a la versión 4.6.0.
  • Si utiliza la versión 4.0, debe actualizar a la versión 4.2 antes de actualizar a la versión 4.3.x.
  • Si utiliza la versión 3.8.5, debe actualizar a la versión 4.0 antes de actualizar a la versión 4.2.
  • Si tiene una versión anterior a la 3.8.5, consulte la sección Actualizar Experience Manager Guides en la guía de instalación específica del producto disponible en Archivo del PDF de ayuda de Adobe Experience Manager Guides.
NOTE
AEM Debe instalar el paquete de servicio de antes de actualizar la versión de Experience Manager Guides.

Para obtener más información, consulte los siguientes procedimientos:

IMPORTANT
Antes de comenzar la actualización, realice una copia de seguridad completa del sistema para evitar la pérdida de datos.

Actualice de la versión 3.8.5 a la versión 4.0 id2256DK003E1

Si utiliza la versión 3.8.5 de Experience Manager Guides, puede actualizar a la versión 4.0 de Experience Manager Guides. Con la función de actualización, no es necesario desinstalar la versión anterior de Experience Manager Guides.

Antes de ejecutar el proceso, hay ciertas tareas que debe completar. Las siguientes subsecciones le guiarán por los requisitos previos, la generación de informes y el proceso de migración. Además, después de instalar la versión 4.0 de Experience Manager Guides, puede personalizar varias configuraciones en función de la configuración del cliente.

NOTE
Este proceso de actualización solo es aplicable de la versión 3.8.5 a la versión 4.0. Para el proceso de actualización de la versión 3.4 o superior a la 3.8.5, consulte la sección Actualizar Experience Manager Guides en la guía de instalación específica del producto disponible en Archivo del PDF de ayuda de Adobe Experience Manager Guides.

​Requisitos previos​

Antes de iniciar el proceso de actualización de Experience Manager Guides, asegúrese de lo siguiente:

  1. Se han importado los comentarios de revisión en los temas abiertos para su revisión.
  2. Se cerraron todas las revisiones activas.
  3. Se cerraron todas las tareas de traducción.
  4. Desinstale cualquier revisión de Experience Manager Guides instalada sobre la versión anterior (versión principal o de parche) de Experience Manager Guides.

Antes de instalar la versión 4.0

Antes de instalar la versión 4.0, realice los siguientes pasos:

  1. Asegúrese de que en este momento Experience Manager Guides esté en la versión 3.8.5.
  2. Descargue el paquete del script de actualización. Para ello, busque "Paquete de actualización de la solución XML Documentation 4.0" en Portal de distribución de software de Adobe que descargará un archivo zip.
  3. AEM Cargue este paquete en mediante el Administrador de paquetes e instálelo.
  4. Una vez instalado el paquete de actualización, ejecute los siguientes scripts en el mismo orden y siga las instrucciones dadas:

Comprobar API de compatibilidad de actualización

Esta API está diseñada para evaluar el estado actual del sistema e informar si la actualización es posible o no. Para ejecutar este script, almacene en déclencheur el siguiente extremo dado:

Punto final
/bin/dxml/upgrade/3xto4x/report
Tipo de solicitud
GET AEM: puede usar un explorador web en el que haya iniciado sesión en la instancia de administrador de la instancia de la cuenta de usuario de la cuenta de usuario de la cuenta de usuario de la cuenta de usuario de la cuenta de usuario de la cuenta de usuario.
Respuesta esperada
- Si se pueden mover todos los nodos requeridos, se le aprobará una comprobación.
- Si un nodo está presente en la ubicación de destino, se producirá un error relevante. Limpie el repositorio (elimine el nodo /var/xml), vuelva a instalar el paquete de actualización y, a continuación, almacene en déclencheur este extremo de nuevo.
Nota: Este no es un error común porque 3.x Experience Manager Guides no usa anteriormente la ubicación de destino.
- Si este script no se ejecuta correctamente, no continúe y genere un informe para el equipo de éxito del cliente.

API de migración de datos del sistema

Esta API está diseñada para migrar los datos del sistema como se menciona en la sección Asignación de migración.

  1. No ejecute este script si la API Comprobar compatibilidad de actualización falla (no continuar).
  2. Una vez que la API de comprobación de compatibilidad de actualización devuelva un resultado correcto, puede ejecutar el script de actualización.
Punto final
/bin/dxml/upgrade/3xto4x
Tipo de solicitud
POST: este script es una solicitud de POST, por lo que debe ejecutarse a través de agentes como Postman.
Respuesta esperada
- Una vez completada la migración, puede instalar la solución de XML Documentation versión 4.0.
- En caso de errores, restaure al último punto de comprobación y comparta los registros de errores junto con la salida de la API con el equipo de éxito del cliente.

Asignación de migración: la API anterior migra todos los datos de la ubicación de origen a la ubicación de destino.

Origen
Público destinatario
/content/fmdita
/var/dxml
/content/dxml
/var/dxml
/etc/fmdita
/libs/fmdita

Instalar versión 4.0 id23598G006XA

  1. Instale la versión 4.0 solo si los pasos de actualización se realizaron correctamente.

  2. Descargar el paquete de la versión 4.0 desde Portal de distribución de software de Adobe:

    • Si está utilizando la versión de software de UUID, busque "Versión 4.0 de UUID para la solución de XML Documentation AEM para la versión 6.5 de".
    • Si está utilizando una versión de software que no sea UUID, busque "Versión 4.0 que no sea UUID para la solución XML Documentation AEM para la versión 6.5 de".
      AEM Cargue el paquete en la instancia de servidor de la existente mediante el Administrador de paquetes de CRX e instálelo.
    note note
    NOTE
    Espere a que se inicien todos los componentes del sistema.
  3. Borre la caché del explorador después de instalar el paquete.

  4. AEM Si Dispatcher está configurado en una instancia de autor de la aplicación, realice los siguientes pasos:

    • Asegúrese de que se gestionan las siguientes opciones en las reglas de Dispatcher:
    • El patrón de URL /home/users/*/preferences está en la lista blanca.
    • El patrón de URL /libs/cq/security/userinfo.json no se almacena en caché.
  5. Borrar caché de Dispatcher (para borrar cualquier clientlibs almacenado en caché).

Actualización a la versión 4.2 id22A3F500SXA

La actualización a la versión 4.2 depende de la versión actual de Experience Manager Guides.

Si utiliza las versiones 4.0, 4.1 o 4.1.x, puede actualizar directamente a la versión 4.2.

​Requisitos previos​

Antes de iniciar el proceso de actualización de Experience Manager Guides 4.2, asegúrese de lo siguiente:

  1. Se ha actualizado a la versión de Experience Manager Guides 4.0, 4.1 o 4.1.x.
  2. Se cerraron todas las tareas de traducción.
  3. Se ha cambiado el nivel de registro a INFO para la clase com.adobe.fmdita.translationservices.TranslationMapUpgradeScript y se han anexado estos registros a un nuevo archivo de registro, por ejemplo, logs/translation_upgrade.log.
NOTE
Debe cerrar todas las revisiones activas. Si las tareas de revisión no se cierran al actualizar a la versión 4.2, las tareas de revisión en curso más antiguas siguen llevando a los usuarios a las páginas de revisión más antiguas y las tareas de revisión creadas después de la actualización mostrarán las actualizaciones más recientes en la funcionalidad.

Instalar versión 4.2 id2245IK0E0EV

  1. Descargue el paquete de la versión 4.2 del Portal de distribución de software de Adobe.

  2. Instale el paquete de la versión 4.2.

  3. Después de completar la instalación del paquete, espere a que aparezca el siguiente mensaje en los registros:

    Completed the post deployment setup script

    El mensaje anterior indica que se han completado todos los pasos de la instalación.

    Si encuentra cualquiera de los siguientes prefijos ERROR, informe de ellos a su equipo de éxito del cliente:

    • Error en el script de configuración posterior a la implementación
    • Excepción al transferir el mapa de traducción
    • No se puede portar el mapa de traducción de v1 a v2 para la propiedad
  4. Actualice el complemento Conector de oxígeno lanzado con la versión 4.2 (si es necesario).

  5. Borre la caché del explorador después de instalar el paquete.

  6. Continúe actualizando las personalizaciones como se detalla en la siguiente sección.

Después de instalar la versión 4.2 id2326F02004K

IMPORTANT
La plantilla de alta tecnología no se muestra en el servidor actualizado. Para incluir la plantilla de alta tecnología en el servidor, puede copiarla: Source: /libs/fmdita/pdf/Hi-Tech Destino: /content/dam/dita-templates/pdf

Después de instalar Experience Manager Guides, puede combinar las distintas configuraciones aplicables desde la versión recién instalada con la configuración.

NOTE
El modelo dam-update-asset se puede personalizar. Por lo tanto, si se ha realizado alguna personalización, es necesario sincronizar las personalizaciones y Experience Manager Guides en la copia de trabajo del modelo.
  1. Flujo de trabajo del recurso de actualización DAM (Cambios posteriores al procesamiento):

  2. Abrir URL:

    code language-http
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
    
  3. Seleccione flujo de trabajo del recurso de actualización DAM.

  4. Haz clic en Editar.

  5. Si el componente Iniciador de procesamiento posterior DXML está presente, asegúrese de que las personalizaciones estén sincronizadas.

  6. Si el componente Iniciador de procesamiento posterior DXML no está presente, realice los siguientes pasos para insertarlo:

  7. Haga clic en Insertar componente (Responsable del posprocesamiento de Experience Manager Guides como paso final del proceso).

  8. Configure el paso del proceso con los siguientes detalles:

    Ficha común

    Título: Iniciador de procesamiento posterior DXML

    Descripción: paso del iniciador posterior del proceso DXML que almacenará en déclencheur un trabajo sling para el posprocesamiento DXML del recurso modificado/creado

    Ficha de proceso

    • Seleccione Iniciador de procesamiento posterior DXML de la lista desplegable Proceso

    • Seleccionar avance de controlador

    • Seleccionar Listo

  9. Haga clic en Sincronizar en la parte superior derecha después de completar los cambios. Recibirá una notificación de éxito.

    note note
    NOTE
    Actualice y compruebe que los cambios personalizados y el paso posterior al procesamiento de Experience Manager Guides estén presentes en el modelo final de flujo de trabajo.
  10. Una vez validado flujo de trabajo del recurso de actualización DAM, compruebe las configuraciones del iniciador correspondientes. AEM Para ello, vaya a la interfaz de flujo de trabajo de la y abra los iniciadores.

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

    Busque y realice cambios (si es necesario) en los dos iniciadores siguientes (que deberían estar activos) correspondientes a flujo de trabajo de recursos de actualización de DAM:

  11. Lanzador para "Nodo creado" para flujo de trabajo del recurso de actualización DAM- para la condición "jcr:content/jcr:mimeType!=video", el valor 'Globbing' debe ser:

    code language-json
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    
    • 'excludeList' debe tener "event-user-data:changedByWorkflowProcess".
    • Lanzador para "Nodo modificado" para flujo de trabajo de recursos de actualización DAM - para la condición "jcr:content/jcr:mimeType!=video",
    • el valor "Globbing" debe ser:
    code language-json
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    
    • 'excludeList' debe tener "event-user-data:changedByWorkflowProcess".
  12. Una vez completada la actualización, asegúrese de que cualquiera de las personalizaciones/superposiciones se valide y actualice para que coincida con el nuevo código de la aplicación. A continuación se ofrecen algunos ejemplos:

    • Cualquier componente superpuesto de /libs/fmidator/libs debe compararse con el nuevo código de producto y las actualizaciones deben realizarse en archivos superpuestos en /apps.
    • Cualquier categoría clientlib utilizada desde el producto debe revisarse para ver si hay cambios. Cualquier configuración anulada (ejemplos abajo) debe compararse con las más recientes para obtener las últimas funciones:
    • elementmapping.xml
    • ui_config.json(puede haberse configurado en perfiles de carpeta)
    • se modificó com.adobe.fmdita.config.ConfigManager
    • Compruebe si alguno de los códigos personalizados estaba usando rutas antiguas (como se menciona en la sección Asignación de migración) - debe actualizarse a las nuevas rutas para que las personalizaciones también funcionen según lo esperado.
  13. Obtenga información sobre las nuevas configuraciones que se introdujeron en la versión actual (compruebe Notas de la versión) y vea si alguna funcionalidad se ve afectada y, a continuación, tome las medidas adecuadas. Un ejemplo podría ser utilizar el "Control de archivos y versiones mejorado" introducido en la versión 4.0, para el cual necesita habilitar una configuración.

Pasos para indexar el contenido existente y utilizar la nueva función de buscar y reemplazar:

Realice los siguientes pasos para indexar el contenido existente y utilice el nuevo texto de búsqueda y reemplazo a nivel de mapa:

  • Ejecute una solicitud de POST al servidor (con la autenticación correcta) - http://<server:port\>/bin/guides/map-find/indexing. (Opcional: puede pasar rutas específicas de las asignaciones para indexarlas; de forma predeterminada, todas las asignaciones se indexarán || Por ejemplo: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • La API devolverá un jobId. Para comprobar el estado del trabajo, puede enviar una solicitud de GET con el ID del trabajo al mismo punto final:

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

  • Una vez completado el trabajo, la solicitud de GET anterior responderá correctamente y mencionará si alguna asignación ha fallado. Los mapas indexados correctamente se pueden confirmar desde los registros del servidor.

Si el trabajo de actualización falla y el registro de errores muestra el siguiente error:

"La consulta leyó o atravesó más de 100000 nodos. Para evitar que afectara a otras tareas, el procesamiento se detuvo".

Esto podría suceder porque el índice no está configurado correctamente para la consulta utilizada en la actualización. Puede probar la siguiente solución:

  1. En el índice damAssetLucene oak, agregue la propiedad booleana indexNodeName como true en el nodo.
    /oak:index/damAssetLucene/indexRules/dam:Asset

  2. Agregue un nuevo nodo con el extracto de nombre bajo el nodo.

    /oak:index/damAssetLucene/indexRules/dam:Asset/properties
    y establezca las siguientes propiedades en el nodo:

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

    La estructura de damAssetLucene debería tener un aspecto similar al siguiente:

    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>
    

    (junto con otros nodos y propiedades existentes)

  3. Reindexe el índice damAssetLucene (estableciendo el indicador de reindexación como true en
    y espere a que se vuelva a false (esto indica que la reindexación se ha completado). Tenga en cuenta que puede tardar unas horas según el tamaño del índice.

  4. Ejecute de nuevo el script de indexación realizando los pasos anteriores.

Actualización a la versión 4.2.1 upgrade-version-4-2-1

TIP
Se recomienda instalar la revisión 4.2.1.3 sobre la versión 4.2.1.

La actualización a la versión 4.2.1 depende de la versión actual de Experience Manager Guides. Si utiliza la versión 4.1, 4.1.x o 4.2, puede actualizar directamente a la versión 4.2.1.

NOTE
El posprocesamiento y la indexación pueden tardar unas horas. Le recomendamos que inicie el proceso de actualización durante las horas de menor actividad.

​Requisitos previos​

Antes de iniciar el proceso de actualización de Experience Manager Guides 4.2.1, asegúrese de lo siguiente:

  1. Se ha actualizado a la versión de Experience Manager Guides 4.1, 4.1.x o 4.2.
  2. Se cerraron todas las tareas de traducción.
  3. Se ha cambiado el nivel de registro a INFO para la clase com.adobe.fmdita.translationservices.TranslationMapUpgradeScript y se han anexado estos registros a un nuevo archivo de registro, por ejemplo, logs/translation_upgrade.log.
NOTE
Debe cerrar todas las revisiones activas. Si las tareas de revisión no se cierran al actualizar a la versión 4.2, las tareas de revisión en curso más antiguas siguen llevando a los usuarios a las páginas de revisión más antiguas y las tareas de revisión creadas después de la actualización mostrarán las actualizaciones más recientes en la funcionalidad.

Instalar versión 4.2.1

  1. Descargue el paquete de la versión 4.2.1 del Portal de distribución de software de Adobe.

  2. Instale el paquete de la versión 4.2.1.

  3. Puede elegir ENTRAR en el déclencheur para iniciar el trabajo de actualización del mapa de traducción. Para obtener más información, consulte Habilitar el déclencheur del script mediante un servlet.

  4. Después de completar la instalación del paquete, espere a que aparezca el siguiente mensaje en los registros:

    Completed the post deployment setup script

    El mensaje anterior indica que se han completado todos los pasos de la instalación.

    Si encuentra cualquiera de los siguientes prefijos ERROR, informe de ellos a su equipo de éxito del cliente:

    • Error en el script de configuración posterior a la implementación
    • Excepción al transferir el mapa de traducción
    • No se puede portar el mapa de traducción de v1 a v2 para la propiedad
  5. Actualice el complemento Conector de oxígeno lanzado con la versión 4.2 (si es necesario).

  6. Borre la caché del explorador después de instalar el paquete.

  7. Continúe actualizando las personalizaciones como se detalla en la siguiente sección.

Habilitar el déclencheur del script mediante un servlet enable-trigger-serverlet

POST:

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

Respuesta:

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

En el JSON de respuesta anterior, la clave lockNodePath contiene la ruta al nodo creado en el repositorio que señala al trabajo enviado. Se eliminará automáticamente una vez finalizado el trabajo y, hasta entonces, puede hacer referencia a este nodo para consultar el estado actual del trabajo.

Ejemplo de registro:
A continuación se muestra un ejemplo de registros que aparecerán en el archivo de registro después de almacenar en déclencheur la secuencia de comandos.

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

Busque com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2 y com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2 antes de continuar con los siguientes pasos.

Después de instalar la versión 4.2.1

IMPORTANT
La plantilla de alta tecnología no se muestra en el servidor actualizado. Para incluir la plantilla de alta tecnología en el servidor, puede copiarla: Source: /libs/fmdita/pdf/Hi-Tech Destino: /content/dam/dita-templates/pdf

Después de instalar Experience Manager Guides, puede combinar las distintas configuraciones aplicables desde la versión recién instalada con la configuración.

NOTE
El modelo dam-update-asset se puede personalizar. Por lo tanto, si se ha realizado alguna personalización, es necesario sincronizar las personalizaciones y Experience Manager Guides en la copia de trabajo del modelo.
  1. Flujo de trabajo del recurso de actualización DAM (Cambios posteriores al procesamiento):

  2. Abrir URL:

    code language-http
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
    
  3. Seleccione flujo de trabajo del recurso de actualización DAM.

  4. Haz clic en Editar.

  5. Si el componente Iniciador de procesamiento posterior DXML está presente, asegúrese de que las personalizaciones estén sincronizadas.

  6. Si el componente Iniciador de procesamiento posterior DXML no está presente, realice los siguientes pasos para insertarlo:

  7. Haga clic en Insertar componente (Responsable del posprocesamiento de Experience Manager Guides como paso final del proceso).

  8. Configure el paso del proceso con los siguientes detalles:

    Ficha común

    Título: Iniciador de procesamiento posterior DXML

    Descripción: paso del iniciador posterior del proceso DXML que almacenará en déclencheur un trabajo sling para el posprocesamiento DXML del recurso modificado/creado

    Ficha de proceso

    • Seleccione Iniciador de procesamiento posterior DXML de la lista desplegable Proceso

    • Seleccionar avance de controlador

    • Seleccionar Listo

  9. Haga clic en Sincronizar en la parte superior derecha después de completar los cambios. Recibirá una notificación de éxito.

    note note
    NOTE
    Actualice y compruebe que los cambios personalizados y el paso posterior al procesamiento de Experience Manager Guides estén presentes en el modelo final de flujo de trabajo.
  10. Una vez validado flujo de trabajo del recurso de actualización DAM, compruebe las configuraciones del iniciador correspondientes. AEM Para ello, vaya a la interfaz de flujo de trabajo de la y abra los iniciadores.

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

    Busque y realice cambios (si es necesario) en los dos iniciadores siguientes (que deberían estar activos) correspondientes a flujo de trabajo de recursos de actualización de DAM:

  11. Lanzador para "Nodo creado" para flujo de trabajo del recurso de actualización DAM- para la condición "jcr:content/jcr:mimeType!=video", el valor 'Globbing' debe ser:

    code language-json
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    
    • 'excludeList' debe tener "event-user-data:changedByWorkflowProcess".
    • Lanzador para "Nodo modificado" para flujo de trabajo de recursos de actualización DAM - para la condición "jcr:content/jcr:mimeType!=video", el valor 'Globbing' debe ser:
    code language-json
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    
    • excludeList debe tener "event-user-data:changedByWorkflowProcess".
  12. Una vez completada la actualización, asegúrese de que cualquiera de las personalizaciones/superposiciones se valide y actualice para que coincida con el nuevo código de la aplicación. A continuación se ofrecen algunos ejemplos:

    • Cualquier componente superpuesto de /libs/fmidator/libs debe compararse con el nuevo código de producto y las actualizaciones deben realizarse en archivos superpuestos en /apps.
    • Cualquier categoría clientlib utilizada desde el producto debe revisarse para ver si hay cambios. Cualquier configuración anulada (ejemplos abajo) debe compararse con las más recientes para obtener las últimas funciones:
    • elementmapping.xml
    • ui_config.json(puede haberse configurado en perfiles de carpeta)
    • se modificó com.adobe.fmdita.config.ConfigManager
    • Compruebe si alguno de los códigos personalizados estaba usando rutas antiguas (como se menciona en la sección Asignación de migración) - debe actualizarse a las nuevas rutas para que las personalizaciones también funcionen según lo esperado.
  13. Obtenga información sobre las nuevas configuraciones que se introdujeron en la versión actual (compruebe Notas de la versión) y vea si alguna funcionalidad se ve afectada y, a continuación, tome las medidas adecuadas. Un ejemplo podría ser utilizar el "Control de archivos y versiones mejorado" introducido en la versión 4.0, para el cual necesita habilitar una configuración.

Pasos para indexar el contenido existente y utilizar la nueva función de buscar y reemplazar:

Realice los siguientes pasos para indexar el contenido existente y utilice el nuevo texto de búsqueda y reemplazo a nivel de mapa:

  • Asegúrese de que se ha completado la indexación damAssetLucene. Puede tardar hasta unas horas, según la cantidad de datos presentes en el servidor. Puede confirmar que la reindexación se ha completado comprobando que el campo de reindexación está configurado como falso en
    http://<server:port>/oak:index/damAssetLucene. Además, si ha agregado personalizaciones en damAssetLucene, es posible que tenga que volver a aplicarlas.

  • Ejecute una solicitud de POST al servidor (con la autenticación correcta) - http://<server:port\>/bin/guides/map-find/indexing. (Opcional: puede pasar rutas específicas de las asignaciones para indexarlas; de forma predeterminada, todas las asignaciones se indexarán || Por ejemplo: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • También se puede pasar una carpeta raíz para indexar las asignaciones DITA de una carpeta específica (y sus subcarpetas). Por ejemplo, http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test. Tenga en cuenta que si se pasan tanto el parámetro de rutas como el parámetro raíz, solo se tendrá en cuenta el parámetro de rutas.

  • La API devolverá un jobId. Para comprobar el estado del trabajo, puede enviar una solicitud de GET con el ID de trabajo al mismo punto final: http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}(por ejemplo: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42)

  • Una vez completado el trabajo, la solicitud de GET anterior responderá correctamente y mencionará si alguna asignación ha fallado. Los mapas indexados correctamente se pueden confirmar desde los registros del servidor.

Actualización a la versión 4.3.0 upgrade-version-4-3

La actualización a la versión 4.3.0 depende de la versión actual de Experience Manager Guides. Si utiliza la versión 4.2 o 4.2.x, puede actualizar directamente a la versión 4.3.0.

NOTE
El posprocesamiento y la indexación pueden tardar unas horas. Le recomendamos que inicie el proceso de actualización durante las horas de menor actividad.

​Requisitos previos​

Antes de iniciar el proceso de actualización de Experience Manager Guides 4.3.0, asegúrese de lo siguiente:

  1. Se ha actualizado a la versión de Experience Manager Guides 4.2 o 4.2.x y se han completado sus respectivos pasos de instalación.
  2. Se cerraron todas las tareas de traducción.

Instalar versión 4.3.0

  1. Descargue el paquete de la versión 4.3.0 del Portal de distribución de software de Adobe.
  2. Instale el paquete de la versión 4.3.0.
  3. Borre la caché del explorador después de instalar el paquete.
  4. Actualice el archivo ui_config.json desde la ficha Configuración del editor XML del perfil de carpeta.

Después de instalar la versión 4.3.0

Después de instalar Experience Manager Guides, puede combinar las distintas configuraciones aplicables desde la versión recién instalada con la configuración.

Pasos para publicar y procesar el contenido existente a fin de utilizar el informe de vínculos rotos

Realice los siguientes pasos para posprocesar el contenido existente y utilizar el nuevo informe de vínculos rotos:

  1. (Opcional) Si hay más de 100 000 archivos dita en el sistema, actualice queryLimitReads en org.apache.jackrabbit.oak.query.QueryEngineSettingsService a un valor mayor (cualquier valor mayor que el número de recursos presentes, por ejemplo 200 000) y vuelva a implementar.

    table 0-row-3 1-row-3
    PID Clave de propiedad Valor de propiedad
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Valor: 200000
    Valor predeterminado: 100000
  2. Ejecute las siguientes API para ejecutar el posprocesamiento en todos los archivos:

    table 0-row-2 1-row-2 2-row-2
    Punto final /bin/guides/reports/upgrade
    Tipo de solicitud POST: este script es una solicitud de POST, por lo que debe ejecutarse a través de agentes como Postman.
    Respuesta esperada La API devolverá un jobId. Para comprobar el estado del trabajo, puede enviar una solicitud de GET con el ID de trabajo al mismo punto final.
    URL de ejemplo: http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    Punto final /bin/guides/reports/upgrade
    Tipo de solicitud GET
    Parámetro jobId: pase el jobId recibido de la solicitud de publicación anterior.
    Respuesta esperada - Una vez completado el trabajo, la solicitud de GET responde correctamente.
    : en caso de que haya errores, comparta los registros de errores junto con la salida de la API con el equipo de éxito del cliente.
    URL de ejemplo: http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
  3. Volver al valor predeterminado o anterior existente de queryLimitReads si lo ha cambiado en el paso 1.

Actualización a la versión 4.3.1 upgrade-version-4-3-1

La actualización a la versión 4.3.1 depende de la versión actual de Experience Manager Guides. Si utiliza las versiones 4.3.0, 4.2 o 4.2.1, puede actualizar directamente a la versión 4.3.1.

NOTE
El posprocesamiento y la indexación pueden tardar unas horas. Le recomendamos que inicie el proceso de actualización durante las horas de menor actividad.

​Requisitos previos​

Antes de iniciar el proceso de actualización de Experience Manager Guides 4.3.1, asegúrese de lo siguiente:

  1. Se ha actualizado a la versión de Experience Manager Guides 4.3.0, 4.2 o 4.2.1 y se han completado los pasos de instalación correspondientes.
  2. (Opcional) Cerró todas las tareas de traducción.
  3. Se ha cambiado el nivel de registro a INFO para la clase com.adobe.fmdita.translationservices.TranslationMapUpgradeScript y se han anexado estos registros a un nuevo archivo de registro, por ejemplo, logs/translation_upgrade.log.

Instalar versión 4.3.1

  1. Descargue el paquete de la versión 4.3.1 del Portal de distribución de software de Adobe.

  2. Instale el paquete de la versión 4.3.1.

  3. Puede elegir ENTRAR en el déclencheur para iniciar el trabajo de actualización del mapa de traducción. Para obtener más información, consulte Habilitar el déclencheur del script mediante un servlet.

  4. Después de completar la instalación del paquete, espere a que aparezca el siguiente mensaje en los registros:

    Completed the post deployment setup script

    El mensaje anterior indica que se han completado todos los pasos de la instalación.

    Si encuentra cualquiera de los siguientes prefijos ERROR, informe de ellos a su equipo de éxito del cliente:

    • Error en el script de configuración posterior a la implementación
    • Excepción al transferir el mapa de traducción
    • No se puede portar el mapa de traducción de v1 a v2 para la propiedad
  5. Actualice el complemento Conector de oxígeno lanzado con la versión 4.2 (si es necesario).

  6. Borre la caché del explorador después de instalar el paquete.

  7. Continúe actualizando las personalizaciones como se detalla en la siguiente sección.

Habilitar el déclencheur del script mediante un servlet enable-trigger-serverlet-4-3-1

POST:

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

Respuesta:

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

En el JSON de respuesta anterior, la clave lockNodePath contiene la ruta al nodo creado en el repositorio que señala al trabajo enviado. Se eliminará automáticamente una vez finalizado el trabajo y, hasta entonces, puede hacer referencia a este nodo para consultar el estado actual del trabajo.

Ejemplo de registro:
A continuación se muestra un ejemplo de registros que aparecerán en el archivo de registro después de almacenar en déclencheur la secuencia de comandos.

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

Busque com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2 y com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2 antes de continuar con los siguientes pasos.

Después de instalar la versión 4.3.1

Después de instalar Experience Manager Guides, puede combinar las distintas configuraciones aplicables desde la versión recién instalada con la configuración.

NOTE
El modelo dam-update-asset se puede personalizar. Por lo tanto, si se ha realizado alguna personalización, es necesario sincronizar las personalizaciones y Experience Manager Guides en la copia de trabajo del modelo.
  1. Flujo de trabajo del recurso de actualización DAM (Cambios posteriores al procesamiento):

  2. Abrir URL:

    code language-none
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
    
  3. Seleccione flujo de trabajo del recurso de actualización DAM.

  4. Haz clic en Editar.

  5. Si el componente Iniciador de procesamiento posterior DXML está presente, asegúrese de que las personalizaciones estén sincronizadas.

  6. Si el componente Iniciador de procesamiento posterior DXML no está presente, realice los siguientes pasos para insertarlo:

  7. Haga clic en Insertar componente (Responsable del posprocesamiento de Experience Manager Guides como paso final del proceso).

  8. Configure el paso del proceso con los siguientes detalles:

    Ficha común

    Título: Iniciador de procesamiento posterior DXML

    Descripción: paso del iniciador posterior del proceso DXML que almacenará en déclencheur un trabajo sling para el posprocesamiento DXML del recurso modificado/creado

    Ficha de proceso

    • Seleccione Iniciador de procesamiento posterior DXML de la lista desplegable Proceso

    • Seleccionar avance de controlador

    • Seleccionar Listo

  9. Haga clic en Sincronizar en la parte superior derecha después de completar los cambios. Recibirá una notificación de éxito.

    note note
    NOTE
    Actualice y compruebe que los cambios personalizados y el paso posterior al procesamiento de Experience Manager Guides estén presentes en el modelo final de flujo de trabajo.
  10. Una vez validado flujo de trabajo del recurso de actualización DAM, compruebe las configuraciones del iniciador correspondientes. AEM Para ello, vaya a la interfaz de flujo de trabajo de la y abra los iniciadores.

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

    Busque y realice cambios (si es necesario) en los dos iniciadores siguientes (que deberían estar activos) correspondientes a flujo de trabajo de recursos de actualización de DAM:

  11. Lanzador para "Nodo creado" para flujo de trabajo del recurso de actualización DAM- para la condición "jcr:content/jcr:mimeType!=video", el valor 'Globbing' debe ser:

    code language-json
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    
    • 'excludeList' debe tener "event-user-data:changedByWorkflowProcess".
    • Lanzador para "Nodo modificado" para flujo de trabajo de recursos de actualización DAM - para la condición "jcr:content/jcr:mimeType!=video", el valor 'Globbing' debe ser:
    code language-json
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    
    • excludeList debe tener "event-user-data:changedByWorkflowProcess".
  12. Una vez completada la actualización, asegúrese de que cualquiera de las personalizaciones/superposiciones se valide y actualice para que coincida con el nuevo código de la aplicación. A continuación se ofrecen algunos ejemplos:

    • Cualquier componente superpuesto de /libs/fmidator/libs debe compararse con el nuevo código de producto y las actualizaciones deben realizarse en archivos superpuestos en /apps.
    • Cualquier categoría clientlib utilizada desde el producto debe revisarse para ver si hay cambios. Cualquier configuración anulada (ejemplos abajo) debe compararse con las más recientes para obtener las últimas funciones:
    • elementmapping.xml
    • ui_config.json(puede haberse configurado en perfiles de carpeta)
    • se modificó com.adobe.fmdita.config.ConfigManager

Pasos para indexar el contenido existente

NOTE
No es necesario que realice estos pasos si actualiza desde la versión 4.3.0 o 4.2.1.

Realice los siguientes pasos para indexar el contenido existente y utilice el nuevo texto de búsqueda y reemplazo a nivel de mapa:

  • Ejecute una solicitud de POST al servidor (con la autenticación correcta) - http://<server:port\>/bin/guides/map-find/indexing. (Opcional: puede pasar rutas específicas de las asignaciones para indexarlas; de forma predeterminada, todas las asignaciones se indexarán || Por ejemplo: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • La API devolverá un jobId. Para comprobar el estado del trabajo, puede enviar una solicitud de GET con el ID de trabajo al mismo punto final: http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}(por ejemplo: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42)

  • Una vez completado el trabajo, la solicitud de GET anterior responderá correctamente y mencionará si alguna asignación ha fallado. Los mapas indexados correctamente se pueden confirmar desde los registros del servidor.

Pasos para publicar y procesar el contenido existente a fin de utilizar el informe de vínculos rotos

NOTE
No es necesario que realice estos pasos si actualiza desde la versión 4.3.0

Realice los siguientes pasos para posprocesar el contenido existente y utilizar el nuevo informe de vínculos rotos:

  1. (Opcional) Si hay más de 100 000 archivos dita en el sistema, actualice queryLimitReads en org.apache.jackrabbit.oak.query.QueryEngineSettingsService a un valor mayor (cualquier valor mayor que el número de recursos presentes, por ejemplo 200 000) y vuelva a implementar.

    table 0-row-3 1-row-3
    PID Clave de propiedad Valor de propiedad
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Valor: 200000
    Valor predeterminado: 100000
  2. Ejecute las siguientes API para ejecutar el posprocesamiento en todos los archivos:

    table 0-row-2 1-row-2 2-row-2
    Punto final /bin/guides/reports/upgrade
    Tipo de solicitud POST: este script es una solicitud de POST, por lo que debe ejecutarse a través de agentes como Postman.
    Respuesta esperada La API devolverá un jobId. Para comprobar el estado del trabajo, puede enviar una solicitud de GET con el ID de trabajo al mismo punto final.
    URL de ejemplo: http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    Punto final /bin/guides/reports/upgrade
    Tipo de solicitud GET
    Parámetro jobId: pase el jobId recibido de la solicitud de publicación anterior.
    Respuesta esperada - Una vez completado el trabajo, la solicitud de GET responde correctamente.
    : en caso de que haya errores, comparta los registros de errores junto con la salida de la API con el equipo de éxito del cliente.
    URL de ejemplo: http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
  3. Volver al valor predeterminado o anterior existente de queryLimitReads si lo ha cambiado en el paso 1.

Actualización a la versión 4.3.1.5 upgrade-version-4-3-1-5

La actualización a la versión 4.3.1.5 depende de la versión actual de Experience Manager Guides. Si utiliza la versión 4.3.1, puede actualizar directamente a la versión 4.3.1.5.

Instale la versión 4.3.1.5

  1. Descargue el paquete de la versión 4.3.1.5 desde el Portal de distribución de software de Adobe.

  2. Instale el paquete de la versión 4.3.1.5.

  3. Espere a que el proceso de instalación se complete correctamente.

  4. Continúe actualizando las personalizaciones como se detalla en la siguiente sección.

Después de instalar la versión 4.3.1.5

NOTE
Si desea utilizar el paquete org.apache.velocity, realice los siguientes pasos antes de cargar el paquete:
  1. Vaya a <server>:<port>/system/console/bundles.
  2. Busque org.apache.velocity.
  3. Desinstale el paquete buscado.
  4. Instale el paquete Velocity requerido.
  1. Una vez completada la actualización, asegúrese de que cualquiera de las personalizaciones/superposiciones se valide y actualice para que coincida con el nuevo código de la aplicación. A continuación se ofrecen algunos ejemplos:

    • Cualquier componente superpuesto de /libs/fmdita o /libs debe compararse con el nuevo código de producto y las actualizaciones deben realizarse en archivos superpuestos bajo /apps
    • Cualquier categoría clientlib utilizada desde el producto debe revisarse para ver si hay cambios. Cualquier configuración anulada (ejemplos abajo) debe compararse con las más recientes para obtener las últimas funciones:
    • elementmapping.xml
    • ui\_config.json\ (puede haberse configurado en perfiles de carpeta)
    • se modificó com.adobe.fmdita.config.ConfigManager

Actualización a la versión 4.4.0 upgrade-version-4-4-0

La actualización a la versión 4.4.0 depende de la versión actual de Experience Manager Guides. Si utiliza las versiones 4.3.1, 4.3.0, 4.2 o 4.2.1 (revisión 4.2.1.3), puede actualizar directamente a la versión 4.4.0

NOTE
El posprocesamiento y la indexación pueden tardar unas horas. Le recomendamos que inicie el proceso de actualización durante las horas de menor actividad.

​Requisitos previos​

Antes de iniciar el proceso de actualización de Experience Manager Guides 4.4.0, asegúrese de lo siguiente:

  1. Se ha actualizado a la versión de Experience Manager Guides 4.3.1, 4.3.0 o 4.2.1 (revisión 4.2.1.3) y se han completado los pasos de instalación correspondientes.
  2. (Opcional) Cerró todas las tareas de traducción.
  3. Se ha cambiado el nivel de registro a INFO para la clase com.adobe.fmdita.translationservices.TranslationMapUpgradeScript y se han anexado estos registros a un nuevo archivo de registro, por ejemplo, logs/translation_upgrade.log.

Instalar versión 4.4.0

  1. Descargue el paquete de la versión 4.4.0 del Portal de distribución de software de Adobe.

  2. Instale el paquete de la versión 4.4.0.

  3. Puede elegir ENTRAR en el déclencheur para iniciar el trabajo de actualización del mapa de traducción. Para obtener más información, consulte Habilitar el déclencheur del script mediante un servlet.

  4. Después de completar la instalación del paquete, espere a que aparezca el siguiente mensaje en los registros:

    Completed the post deployment setup script

    El mensaje anterior indica que se han completado todos los pasos de la instalación.

    Si encuentra cualquiera de los siguientes prefijos ERROR, informe de ellos a su equipo de éxito del cliente:

    • Error en el script de configuración posterior a la implementación
    • Excepción al transferir el mapa de traducción
    • No se puede portar el mapa de traducción de v1 a v2 para la propiedad
  5. Actualice el complemento Conector de oxígeno lanzado con la versión 4.4.0 (si es necesario).

  6. Borre la caché del explorador después de instalar el paquete.

  7. Continúe actualizando las personalizaciones como se detalla en la siguiente sección.

Después de instalar la versión 4.4.0

Después de instalar Experience Manager Guides, puede combinar las distintas configuraciones aplicables desde la versión recién instalada con la configuración.

NOTE
El modelo dam-update-asset se puede personalizar. Por lo tanto, si se ha realizado alguna personalización, es necesario sincronizar las personalizaciones y Experience Manager Guides en la copia de trabajo del modelo.
  1. Flujo de trabajo del recurso de actualización DAM (Cambios posteriores al procesamiento):

  2. Abrir URL:

    code language-none
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
    
  3. Seleccione flujo de trabajo del recurso de actualización DAM.

  4. Haz clic en Editar.

  5. Si el componente Iniciador de procesamiento posterior DXML está presente, asegúrese de que las personalizaciones estén sincronizadas.

  6. Si el componente Iniciador de procesamiento posterior DXML no está presente, realice los siguientes pasos para insertarlo:

  7. Haga clic en Insertar componente (Responsable del posprocesamiento de Experience Manager Guides como paso final del proceso).

  8. Configure el paso del proceso con los siguientes detalles:

    Ficha común

    Título: Iniciador de procesamiento posterior DXML

    Descripción: paso del iniciador posterior del proceso DXML que almacenará en déclencheur un trabajo sling para el posprocesamiento DXML del recurso modificado/creado

    Ficha de proceso

    • Seleccione Iniciador de procesamiento posterior DXML de la lista desplegable Proceso

    • Seleccionar avance de controlador

    • Seleccionar Listo

  9. Haga clic en Sincronizar en la parte superior derecha después de completar los cambios. Recibirá una notificación de éxito.

    note note
    NOTE
    Actualice y compruebe que los cambios personalizados y el paso posterior al procesamiento de Experience Manager Guides estén presentes en el modelo final de flujo de trabajo.
  10. Una vez validado flujo de trabajo del recurso de actualización DAM, compruebe las configuraciones del iniciador correspondientes. AEM Para ello, vaya a la interfaz de flujo de trabajo de la y abra los iniciadores.

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

    Busque y realice cambios (si es necesario) en los dos iniciadores siguientes (que deberían estar activos) correspondientes a flujo de trabajo de recursos de actualización de DAM:

  11. Lanzador para "Nodo creado" para flujo de trabajo del recurso de actualización DAM- para la condición "jcr:content/jcr:mimeType!=video", el valor 'Globbing' debe ser:

    code language-json
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    
    • 'excludeList' debe tener "event-user-data:changedByWorkflowProcess".
    • Lanzador para "Nodo modificado" para flujo de trabajo de recursos de actualización DAM - para la condición "jcr:content/jcr:mimeType!=video", el valor 'Globbing' debe ser:
    code language-json
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    
    • excludeList debe tener "event-user-data:changedByWorkflowProcess".
  12. Una vez completada la actualización, asegúrese de que cualquiera de las personalizaciones/superposiciones se valide y actualice para que coincida con el nuevo código de la aplicación. A continuación se ofrecen algunos ejemplos:

    • Cualquier componente superpuesto de /libs/fmidator/libs debe compararse con el nuevo código de producto y las actualizaciones deben realizarse en archivos superpuestos en /apps.
    • Cualquier categoría clientlib utilizada desde el producto debe revisarse para ver si hay cambios. Cualquier configuración anulada (ejemplos abajo) debe compararse con las más recientes para obtener las últimas funciones:
    • elementmapping.xml
    • ui_config.json(puede haberse configurado en perfiles de carpeta)
    • se modificó com.adobe.fmdita.config.ConfigManager
  13. Si ha añadido personalizaciones en damAssetLucene, es posible que tenga que volver a aplicarlas. Después de realizar estos cambios, establezca reindex como true. Esto reindexará todos los nodos existentes con las personalizaciones. Una vez finalizado, el indicador de reindexación se volverá a establecer en "false". Esto puede tardar unas horas, según la cantidad de recursos que haya en el sistema.

Pasos para indexar el contenido existente

NOTE
No es necesario que realice estos pasos si actualiza desde la versión 4.3.0 o 4.3.1.

Realice los siguientes pasos para indexar el contenido existente y utilice el nuevo texto de búsqueda y reemplazo a nivel de mapa:

  • Ejecute una solicitud de POST al servidor (con la autenticación correcta) - http://<server:port\>/bin/guides/map-find/indexing. (Opcional: puede pasar rutas específicas de las asignaciones para indexarlas; de forma predeterminada, todas las asignaciones se indexarán || Por ejemplo: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • La API devolverá un jobId. Para comprobar el estado del trabajo, puede enviar una solicitud de GET con el ID de trabajo al mismo punto final: http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}(por ejemplo: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42)

  • Una vez completado el trabajo, la solicitud de GET anterior responderá correctamente y mencionará si alguna asignación ha fallado. Los mapas indexados correctamente se pueden confirmar desde los registros del servidor.

Pasos para publicar y procesar el contenido existente a fin de utilizar el informe de vínculos rotos

NOTE
No es necesario que realice estos pasos si actualiza desde la versión 4.3.0 o 4.3.1.

Realice los siguientes pasos para posprocesar el contenido existente y utilizar el nuevo informe de vínculos rotos:

  1. (Opcional) Si hay más de 100 000 archivos dita en el sistema, actualice queryLimitReads en org.apache.jackrabbit.oak.query.QueryEngineSettingsService a un valor mayor (cualquier valor mayor que el número de recursos presentes, por ejemplo 200 000) y vuelva a implementar.

    table 0-row-3 1-row-3
    PID Clave de propiedad Valor de propiedad
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Valor: 200000
    Valor predeterminado: 100000
  2. Ejecute las siguientes API para ejecutar el posprocesamiento en todos los archivos:

    table 0-row-2 1-row-2 2-row-2
    Punto final /bin/guides/reports/upgrade
    Tipo de solicitud POST: este script es una solicitud de POST, por lo que debe ejecutarse a través de agentes como Postman.
    Respuesta esperada La API devolverá un jobId. Para comprobar el estado del trabajo, puede enviar una solicitud de GET con el ID de trabajo al mismo punto final.
    URL de ejemplo: http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    Punto final /bin/guides/reports/upgrade
    Tipo de solicitud GET
    Parámetro jobId: pase el jobId recibido de la solicitud de publicación anterior.
    Respuesta esperada - Una vez completado el trabajo, la solicitud de GET responde correctamente.
    : en caso de que haya errores, comparta los registros de errores junto con la salida de la API con el equipo de éxito del cliente.
    URL de ejemplo: http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
  3. Volver al valor predeterminado o anterior existente de queryLimitReads si lo ha cambiado en el paso 1.

Habilitar el déclencheur del script mediante un servlet enable-trigger-serverlet-4-4-0

NOTE
No es necesario que realice estos pasos si actualiza desde la versión 4.3.0 o 4.3.1.

POST:

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

Respuesta:

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

En el JSON de respuesta anterior, la clave lockNodePath contiene la ruta al nodo creado en el repositorio que señala al trabajo enviado. Se eliminará automáticamente una vez finalizado el trabajo y, hasta entonces, puede hacer referencia a este nodo para consultar el estado actual del trabajo.

Busque com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2 y com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2 antes de continuar con los siguientes pasos.

NOTE
Debe comprobar si el nodo sigue presente y el estado del trabajo.

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

Pasos para gestionar el conflicto 'fmdita rewriter'

Experience Manager Guides tiene un módulo reescritor de sling personalizado para administrar los vínculos generados en caso de mapas cruzados (vínculos entre los temas de dos mapas diferentes).

Si tiene otra reescritura de sling personalizada en la base de código, utilice un valor de 'order' mayor que 50, ya que la reescritura de sling de Experience Manager Guides utiliza 'order' 50. Para anular esto, necesita un valor >50. Para obtener más información, vea Canalizaciones de reescritura de salida.

Durante esta actualización, dado que el valor 'order' ha cambiado de 1000 a 50, debe combinar la reescritura personalizada existente, si la hay, con 'fmdita-rewriter'.

Tema principal: Descargar e instalar

Actualización a la versión 4.6.0 upgrade-version-4-6-0

La actualización a la versión 4.6.0 depende de la versión actual de Experience Manager Guides. Si utiliza las versiones 4.4.0, 4.3.1, 4.3.0, 4.2 o 4.2.1 (revisión 4.2.1.3), puede actualizar directamente a la versión 4.6.0

NOTE
El posprocesamiento y la indexación pueden tardar unas horas. Le recomendamos que inicie el proceso de actualización durante las horas de menor actividad.

​Requisitos previos​

Antes de iniciar el proceso de actualización de Experience Manager Guides 4.6.0, asegúrese de lo siguiente:

  1. Se ha actualizado a la versión de Experience Manager Guides 4.3.1, 4.3.0 o 4.2.1 (revisión 4.2.1.3) y se han completado los pasos de instalación correspondientes.
  2. (Opcional) Cerró todas las tareas de traducción.
  3. Se ha cambiado el nivel de registro a INFO para la clase com.adobe.fmdita.translationservices.TranslationMapUpgradeScript y se han anexado estos registros a un nuevo archivo de registro, por ejemplo, logs/translation_upgrade.log.

Instalar versión 4.6.0

  1. Descargue el paquete de la versión 4.6.0 del Portal de distribución de software de Adobe.

  2. Instale el paquete de la versión 4.6.0.

  3. Puede elegir ENTRAR en el déclencheur para iniciar el trabajo de actualización del mapa de traducción. Para obtener más información, consulte Habilitar el déclencheur del script mediante un servlet.

  4. Después de completar la instalación del paquete, espere a que aparezca el siguiente mensaje en los registros:

    Completed the post deployment setup script

    El mensaje anterior indica que se han completado todos los pasos de la instalación.

    Si encuentra cualquiera de los siguientes prefijos ERROR, informe de ellos a su equipo de éxito del cliente:

    • Error en el script de configuración posterior a la implementación
    • Excepción al transferir el mapa de traducción
    • No se puede portar el mapa de traducción de v1 a v2 para la propiedad
  5. Actualice el complemento Conector de oxígeno lanzado con la versión 4.6.0 (si es necesario).

  6. Borre la caché del explorador después de instalar el paquete.

Después de instalar la versión 4.6.0

Después de instalar Experience Manager Guides, puede combinar las distintas configuraciones aplicables desde la versión recién instalada con la configuración.

NOTE
El modelo dam-update-asset se puede personalizar. Por lo tanto, si se ha realizado alguna personalización, es necesario sincronizar las personalizaciones y Experience Manager Guides en la copia de trabajo del modelo.
  1. Flujo de trabajo del recurso de actualización DAM (Cambios posteriores al procesamiento):

  2. Abrir URL:

    code language-none
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
    
  3. Seleccione flujo de trabajo del recurso de actualización DAM.

  4. Haz clic en Editar.

  5. Si el componente Iniciador de procesamiento posterior DXML está presente, asegúrese de que las personalizaciones estén sincronizadas.

  6. Si el componente Iniciador de procesamiento posterior DXML no está presente, realice los siguientes pasos para insertarlo:

  7. Haga clic en Insertar componente (Responsable del posprocesamiento de Experience Manager Guides como paso final del proceso).

  8. Configure el paso del proceso con los siguientes detalles:

    Ficha común

    Título: Iniciador de procesamiento posterior DXML

    Descripción: paso del iniciador posterior del proceso DXML que almacenará en déclencheur un trabajo sling para el posprocesamiento DXML del recurso modificado/creado

    Ficha de proceso

    • Seleccione Iniciador de procesamiento posterior DXML de la lista desplegable Proceso

    • Seleccionar avance de controlador

    • Seleccionar Listo

  9. Haga clic en Sincronizar en la parte superior derecha después de completar los cambios. Recibirá una notificación de éxito.

    note note
    NOTE
    Actualice y compruebe que los cambios personalizados y el paso posterior al procesamiento de Experience Manager Guides estén presentes en el modelo final de flujo de trabajo.
  10. Una vez validado flujo de trabajo del recurso de actualización DAM, compruebe las configuraciones del iniciador correspondientes. AEM Para ello, vaya a la interfaz de flujo de trabajo de la y abra los iniciadores.

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

    Busque y realice cambios (si es necesario) en los dos iniciadores siguientes (que deberían estar activos) correspondientes a flujo de trabajo de recursos de actualización de DAM:

  11. Lanzador para "Nodo creado" para flujo de trabajo del recurso de actualización DAM- para la condición "jcr:content/jcr:mimeType!=video", el valor 'Globbing' debe ser:

    code language-json
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    
    • 'excludeList' debe tener "event-user-data:changedByWorkflowProcess".
    • Lanzador para "Nodo modificado" para flujo de trabajo de recursos de actualización DAM - para la condición "jcr:content/jcr:mimeType!=video", el valor 'Globbing' debe ser:
    code language-json
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    
    • excludeList debe tener "event-user-data:changedByWorkflowProcess".
  12. Una vez completada la actualización, asegúrese de que cualquiera de las personalizaciones/superposiciones se valide y actualice para que coincida con el nuevo código de la aplicación. A continuación se ofrecen algunos ejemplos:

    • Cualquier componente superpuesto de /libs/fmidator/libs debe compararse con el nuevo código de producto y las actualizaciones deben realizarse en archivos superpuestos en /apps.
    • Cualquier categoría clientlib utilizada desde el producto debe revisarse para ver si hay cambios. Cualquier configuración anulada (ejemplos abajo) debe compararse con las más recientes para obtener las últimas funciones:
    • elementmapping.xml
    • ui_config.json(puede haberse configurado en perfiles de carpeta)
    • se modificó com.adobe.fmdita.config.ConfigManager
  13. Si ha añadido personalizaciones en damAssetLucene, es posible que tenga que volver a aplicarlas. Después de realizar estos cambios, establezca reindex como true. Esto reindexará todos los nodos existentes con las personalizaciones. Una vez finalizado, el indicador de reindexación se volverá a establecer en "false". Esto puede tardar unas horas, según la cantidad de recursos que haya en el sistema.

Pasos para reindexar los índices de Experience Manager Guides

  1. Abra crx/de y vaya a la ruta de acceso del índice: /oak:index/guidesAssetProperties

  2. Establezca la propiedad reindex como true (false de forma predeterminada) y haga clic en Guardar todo.

  3. Una vez completado el reíndice, la propiedad reindex se vuelve a establecer en false y el recuento de reíndices se incrementa en 1.

    note note
    NOTE
    Esto puede tardar unos minutos, según la cantidad de datos presentes.

    4. Siga los mismos pasos para otros índices agregados o modificados: `guidesBulkActivation`, `guidesPeerLinkIndex` y `guidesKonnectTemplateIndex`.

Pasos para indexar el contenido existente

Siga estos pasos para indexar el contenido existente:

  • Ejecute una solicitud de POST al servidor (con la autenticación correcta) - http://<server:port\>/bin/guides/map-find/indexing. (Opcional: puede pasar rutas específicas de los mapas para indexarlas, de forma predeterminada se indexarán todas las asignaciones || Ejemplo: https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • La API devolverá un jobId. Para comprobar el estado del trabajo, puede enviar una solicitud de GET con el ID de trabajo al mismo punto final: http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}(por ejemplo: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678)

  • Una vez completado el trabajo, la solicitud de GET anterior responderá correctamente y mencionará si alguna asignación ha fallado. Los mapas indexados correctamente se pueden confirmar desde los registros del servidor.

NOTE
AEM Si está utilizando el esquema personalizado, debe definir la ruta de los archivos DTD y XSD catalog.xml personalizados en el repositorio de en la opción Integrar catálogos.

Pasos para gestionar el conflicto 'fmdita rewriter'

Experience Manager Guides tiene un módulo reescritor de sling personalizado para administrar los vínculos generados en caso de mapas cruzados (vínculos entre los temas de dos mapas diferentes).

Si tiene otra reescritura de sling personalizada en la base de código, utilice un valor de 'order' mayor que 50, ya que la reescritura de sling de Experience Manager Guides utiliza 'order' 50. Para anular esto, necesita un valor >50. Para obtener más información, vea Canalizaciones de reescritura de salida.

Durante esta actualización, dado que el valor 'order' ha cambiado de 1000 a 50, debe combinar la reescritura personalizada existente, si la hay, con 'fmdita-rewriter'.

Tema principal: Descargar e instalar

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