Actualizar Adobe Experience Manager Guides id224MBE0M0XA
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.
Para obtener más información, consulte los siguientes procedimientos:
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.
Requisitos previos
Antes de iniciar el proceso de actualización de Experience Manager Guides, asegúrese de lo siguiente:
- Se han importado los comentarios de revisión en los temas abiertos para su revisión.
- Se cerraron todas las revisiones activas.
- Se cerraron todas las tareas de traducción.
- 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:
- Asegúrese de que en este momento Experience Manager Guides esté en la versión 3.8.5.
- 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.
- AEM Cargue este paquete en mediante el Administrador de paquetes e instálelo.
- 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:
- 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.
- No ejecute este script si la API Comprobar compatibilidad de actualización falla (no continuar).
- Una vez que la API de comprobación de compatibilidad de actualización devuelva un resultado correcto, puede ejecutar el script de actualización.
- 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.
Instalar versión 4.0 id23598G006XA
-
Instale la versión 4.0 solo si los pasos de actualización se realizaron correctamente.
-
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. -
Borre la caché del explorador después de instalar el paquete.
-
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é.
-
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:
- Se ha actualizado a la versión de Experience Manager Guides 4.0, 4.1 o 4.1.x.
- Se cerraron todas las tareas de traducción.
- 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.2 id2245IK0E0EV
-
Descargue el paquete de la versión 4.2 del Portal de distribución de software de Adobe.
-
Instale el paquete de la versión 4.2.
-
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
-
Actualice el complemento Conector de oxígeno lanzado con la versión 4.2 (si es necesario).
-
Borre la caché del explorador después de instalar el paquete.
-
Continúe actualizando las personalizaciones como se detalla en la siguiente sección.
Después de instalar la versión 4.2 id2326F02004K
Después de instalar Experience Manager Guides, puede combinar las distintas configuraciones aplicables desde la versión recién instalada con la configuración.
-
Flujo de trabajo del recurso de actualización DAM (Cambios posteriores al procesamiento):
-
Abrir URL:
code language-http http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
-
Seleccione flujo de trabajo del recurso de actualización DAM.
-
Haz clic en Editar.
-
Si el componente Iniciador de procesamiento posterior DXML está presente, asegúrese de que las personalizaciones estén sincronizadas.
-
Si el componente Iniciador de procesamiento posterior DXML no está presente, realice los siguientes pasos para insertarlo:
-
Haga clic en Insertar componente (Responsable del posprocesamiento de Experience Manager Guides como paso final del proceso).
-
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
-
-
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. -
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:
-
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"
.
- 'excludeList' debe tener
-
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.
-
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:
-
En el índice damAssetLucene oak, agregue la propiedad booleana
indexNodeName
comotrue
en el nodo./oak:index/damAssetLucene/indexRules/dam:Asset
-
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)
-
Reindexe el índice
damAssetLucene
(estableciendo el indicador de reindexación comotrue
en
y espere a que se vuelva afalse
(esto indica que la reindexación se ha completado). Tenga en cuenta que puede tardar unas horas según el tamaño del índice. -
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
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.
Requisitos previos
Antes de iniciar el proceso de actualización de Experience Manager Guides 4.2.1, asegúrese de lo siguiente:
- Se ha actualizado a la versión de Experience Manager Guides 4.1, 4.1.x o 4.2.
- Se cerraron todas las tareas de traducción.
- 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.2.1
-
Descargue el paquete de la versión 4.2.1 del Portal de distribución de software de Adobe.
-
Instale el paquete de la versión 4.2.1.
-
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.
-
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
-
Actualice el complemento Conector de oxígeno lanzado con la versión 4.2 (si es necesario).
-
Borre la caché del explorador después de instalar el paquete.
-
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
Después de instalar Experience Manager Guides, puede combinar las distintas configuraciones aplicables desde la versión recién instalada con la configuración.
-
Flujo de trabajo del recurso de actualización DAM (Cambios posteriores al procesamiento):
-
Abrir URL:
code language-http http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
-
Seleccione flujo de trabajo del recurso de actualización DAM.
-
Haz clic en Editar.
-
Si el componente Iniciador de procesamiento posterior DXML está presente, asegúrese de que las personalizaciones estén sincronizadas.
-
Si el componente Iniciador de procesamiento posterior DXML no está presente, realice los siguientes pasos para insertarlo:
-
Haga clic en Insertar componente (Responsable del posprocesamiento de Experience Manager Guides como paso final del proceso).
-
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
-
-
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. -
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:
-
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"
.
- 'excludeList' debe tener
-
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.
-
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 enhttp://<server:port>/oak:index/damAssetLucene
. Además, si ha agregado personalizaciones endamAssetLucene
, 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.
Requisitos previos
Antes de iniciar el proceso de actualización de Experience Manager Guides 4.3.0, asegúrese de lo siguiente:
- 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.
- Se cerraron todas las tareas de traducción.
Instalar versión 4.3.0
- Descargue el paquete de la versión 4.3.0 del Portal de distribución de software de Adobe.
- Instale el paquete de la versión 4.3.0.
- Borre la caché del explorador después de instalar el paquete.
- 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:
-
(Opcional) Si hay más de 100 000 archivos dita en el sistema, actualice
queryLimitReads
enorg.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 -
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
-
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.
Requisitos previos
Antes de iniciar el proceso de actualización de Experience Manager Guides 4.3.1, asegúrese de lo siguiente:
- 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.
- (Opcional) Cerró todas las tareas de traducción.
- 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
-
Descargue el paquete de la versión 4.3.1 del Portal de distribución de software de Adobe.
-
Instale el paquete de la versión 4.3.1.
-
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.
-
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
-
Actualice el complemento Conector de oxígeno lanzado con la versión 4.2 (si es necesario).
-
Borre la caché del explorador después de instalar el paquete.
-
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.
-
Flujo de trabajo del recurso de actualización DAM (Cambios posteriores al procesamiento):
-
Abrir URL:
code language-none http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
-
Seleccione flujo de trabajo del recurso de actualización DAM.
-
Haz clic en Editar.
-
Si el componente Iniciador de procesamiento posterior DXML está presente, asegúrese de que las personalizaciones estén sincronizadas.
-
Si el componente Iniciador de procesamiento posterior DXML no está presente, realice los siguientes pasos para insertarlo:
-
Haga clic en Insertar componente (Responsable del posprocesamiento de Experience Manager Guides como paso final del proceso).
-
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
-
-
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. -
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:
-
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"
.
- 'excludeList' debe tener
-
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
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
Realice los siguientes pasos para posprocesar el contenido existente y utilizar el nuevo informe de vínculos rotos:
-
(Opcional) Si hay más de 100 000 archivos dita en el sistema, actualice
queryLimitReads
enorg.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 -
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
-
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
-
Descargue el paquete de la versión 4.3.1.5 desde el Portal de distribución de software de Adobe.
-
Instale el paquete de la versión 4.3.1.5.
-
Espere a que el proceso de instalación se complete correctamente.
-
Continúe actualizando las personalizaciones como se detalla en la siguiente sección.
Después de instalar la versión 4.3.1.5
- Vaya a
<server>:<port>/system/console/bundles
. - Busque org.apache.velocity.
- Desinstale el paquete buscado.
- Instale el paquete Velocity requerido.
-
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
- Cualquier componente superpuesto de
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
Requisitos previos
Antes de iniciar el proceso de actualización de Experience Manager Guides 4.4.0, asegúrese de lo siguiente:
- 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.
- (Opcional) Cerró todas las tareas de traducción.
- 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
-
Descargue el paquete de la versión 4.4.0 del Portal de distribución de software de Adobe.
-
Instale el paquete de la versión 4.4.0.
-
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.
-
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
-
Actualice el complemento Conector de oxígeno lanzado con la versión 4.4.0 (si es necesario).
-
Borre la caché del explorador después de instalar el paquete.
-
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.
-
Flujo de trabajo del recurso de actualización DAM (Cambios posteriores al procesamiento):
-
Abrir URL:
code language-none http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
-
Seleccione flujo de trabajo del recurso de actualización DAM.
-
Haz clic en Editar.
-
Si el componente Iniciador de procesamiento posterior DXML está presente, asegúrese de que las personalizaciones estén sincronizadas.
-
Si el componente Iniciador de procesamiento posterior DXML no está presente, realice los siguientes pasos para insertarlo:
-
Haga clic en Insertar componente (Responsable del posprocesamiento de Experience Manager Guides como paso final del proceso).
-
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
-
-
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. -
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:
-
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"
.
- 'excludeList' debe tener
-
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
-
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
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
Realice los siguientes pasos para posprocesar el contenido existente y utilizar el nuevo informe de vínculos rotos:
-
(Opcional) Si hay más de 100 000 archivos dita en el sistema, actualice
queryLimitReads
enorg.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 -
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
-
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
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.
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
Requisitos previos
Antes de iniciar el proceso de actualización de Experience Manager Guides 4.6.0, asegúrese de lo siguiente:
- 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.
- (Opcional) Cerró todas las tareas de traducción.
- 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
-
Descargue el paquete de la versión 4.6.0 del Portal de distribución de software de Adobe.
-
Instale el paquete de la versión 4.6.0.
-
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.
-
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
-
Actualice el complemento Conector de oxígeno lanzado con la versión 4.6.0 (si es necesario).
-
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.
-
Flujo de trabajo del recurso de actualización DAM (Cambios posteriores al procesamiento):
-
Abrir URL:
code language-none http://localhost:4502/libs/cq/workflow/admin/console/content/models.html
-
Seleccione flujo de trabajo del recurso de actualización DAM.
-
Haz clic en Editar.
-
Si el componente Iniciador de procesamiento posterior DXML está presente, asegúrese de que las personalizaciones estén sincronizadas.
-
Si el componente Iniciador de procesamiento posterior DXML no está presente, realice los siguientes pasos para insertarlo:
-
Haga clic en Insertar componente (Responsable del posprocesamiento de Experience Manager Guides como paso final del proceso).
-
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
-
-
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. -
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:
-
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"
.
- 'excludeList' debe tener
-
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
-
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
-
Abra
crx/de
y vaya a la ruta de acceso del índice:/oak:index/guidesAssetProperties
-
Establezca la propiedad reindex como
true
(false
de forma predeterminada) y haga clic en Guardar todo. -
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.
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