Validación de transferencias de contenido

Introducción

Los usuarios pueden determinar de forma fiable si todo el contenido extraído por la herramienta de transferencia de contenido se ha introducido correctamente en la instancia de destino. Esta función de validación funciona comparando un resumen de las rutas de todos los nodos implicados durante la extracción con un resumen de las rutas de todos los nodos implicados durante la ingesta. Si hay rutas de nodos incluidas en el compendio de extracción que falten en el compendio de ingesta, se considera que la validación ha fallado y que puede ser necesaria una validación manual adicional.

INFORMACIÓN

Esta función estará disponible a partir de la versión de la herramienta de transferencia de contenido (CTT) 1.8.x. El entorno de destino de AEM Cloud Service debe ejecutar al menos la versión 6158 o buena. También requiere que se configure el entorno de origen para ejecutarse copia previa. La función de validación busca el archivo azcopy.config en el origen. Si no encuentra este archivo, no se ejecutará la validación. Para obtener más información sobre cómo configurar un archivo azcopy.config, consulte esta página.

La validación de una transferencia de contenido es una función opcional. Al habilitar esta función, se aumentará el tiempo necesario para realizar una extracción y una ingesta. AEM Para utilizar la función, habilítela en la consola del sistema del entorno de origen de la siguiendo estos pasos:

  1. Vaya a la consola web de Adobe Experience Manager en la instancia de origen, en Herramientas - Operaciones - Consola web o directamente a la dirección URL en https://serveraddress:serverport/system/console/configMgr

  2. Buscar por Configuración del servicio de extracción de herramienta de transferencia de contenido

  3. Utilice el botón del icono de lápiz para editar sus valores de configuración

  4. Habilite la Habilitar validación de migración durante la extracción configuración, luego pulse Guardar:

    imagen

Con esta configuración habilitada y el entorno de AEM Cloud Service de destino ejecutando una versión compatible, la validación de la migración se producirá durante todas las extracciones e ingestas posteriores.

Para obtener más información sobre cómo instalar la herramienta de transferencia de contenido, consulte Introducción a la herramienta de transferencia de contenido.

Validación de una transferencia de contenido

AEM Con la validación de migración habilitada en el entorno de origen de la, inicie una extracción.

If Sobrescribir contenedor de almacenamiento provisional durante la extracción está activada, todos los nodos implicados en la extracción se registran en el resumen de la ruta de extracción. Cuando se utiliza esta configuración, es importante habilitar la variable Borrar contenido existente en la instancia de Cloud antes de la ingesta configuración durante la ingesta; de lo contrario, puede parecer que faltan nodos en el compendio de ingesta. Estos son los nodos que ya están presentes en el destino desde ingestas anteriores.

Para ver una ilustración gráfica de esto, consulte los siguientes ejemplos:

Ejemplo 1

  • Extracción (sobrescribir)

    imagen

  • Ingesta (borrado)

    imagen

  • Notas

    Esta combinación de "Sobrescribir" y "Borrar" dará como resultado resultados de validación coherentes, incluso para ingestas repetidas.

Ejemplo 2

  • Extracción

    imagen

  • Ingesta

    imagen

  • Notas

    Esta combinación de "Sobrescribir" y "Borrar" dará como resultado resultados de validación coherentes para la ingesta inicial.

    Si la ingesta se repite, el resumen de la ingesta está vacío y la validación parece haber fallado. El resumen de ingesta está vacío porque todos los nodos de esta extracción ya estarán presentes en el destino.

Una vez finalizada la extracción, comience la ingesta.

La parte superior del registro de ingesta contendrá una entrada, similar a aem-ethos/tools:1.2.438. Asegúrese de que este número de versión sea 1,2,438 o buena AEM, de lo contrario, la validación no es compatible con la versión de los as a Cloud Service de validación que está utilizando.

Una vez finalizada la ingesta y iniciada la validación, se anota la siguiente entrada de registro en el "log" de ingesta:

Gathering artifacts for migration validation...

Los detalles de la validación siguen esta entrada. A continuación, puede ver un ejemplo de una migración de gran tamaño:

Beginning publish migration validation. Migration job id=[3aba1f96-84b6-4bd0-8642-c61c0d528387]
Extraction path digest is being processed...
Extraction path digest processing took 982 seconds
Ingestion path digest is being processed...
Ingestion path digest processing took 999 seconds
Comparing the Extraction and Ingestion path digests...
----------------------------------------------------------
EXTRACTION: Number of nodes extracted: 51674784
INGESTION: Number of nodes ingested: 51674784
----------------------------------------------------------
Validation succeeded! No entries were detected to be missing from the ingestion digest.
----------------------------------------------------------
Comparing the path digests took 29 seconds
Migration validation took 33 minutes

Este es un ejemplo de una validación que se ha realizado correctamente, ya que no faltaban entradas en el resumen de ingesta que estuvieran presentes en el resumen de extracción.

Para comparar, el aspecto que tendría un informe de validación si la validación hubiera fallado es este:

Beginning publish migration validation. Migration job id=[ac217e5a-a08d-4e81-cbd6-f39f88b174ce]
Extraction path digest is being processed...
Extraction path digest processing took 0 seconds
Ingestion path digest is being processed...
Ingestion path digest processing took 0 seconds
Comparing the Extraction and Ingestion path digests...
----------------------------------------------------------
EXTRACTION: Number of nodes extracted: 4635
INGESTION: Number of nodes ingested: 0
----------------------------------------------------------
Validation failed. However, the following nodes may already be present in the target environment.
See our Migration Validation FAQ (https://www.adobe.com/go/aem_cloud_ctt_validation_en) or open a ticket with Customer Care.
There are 4635 entries present in the extraction digest that are missing from the ingestion digest.
/content/dam/bruce
/content/dam/bruce-assets
... more paths listed (up to 10k) ...
----------------------------------------------------------
Comparing the path digests took 0 seconds
Migration validation took 0 minutes

El ejemplo de error anterior se obtuvo ejecutando una ingesta y volviendo a ejecutar la misma ingesta con la opción Borrar deshabilitada, de modo que no había nodos involucrados durante la ingesta; todo estaba presente en el destino.

Además de incluirse en el registro de ingesta, también se puede acceder al informe de validación desde el Trabajos de ingesta interfaz de usuario en Cloud Acceleration Manager. Para ello, haga clic en los tres puntos () y haga clic en Informe de validación en la lista desplegable para ver el informe de validación.

imagen

Validación de la migración de entidades principales

Consulte Asignación de usuarios y migración de principales para leer los detalles de las migraciones principales y por qué es necesario.

Una vez que la extracción y la ingesta se hayan completado correctamente, estará disponible un resumen y un informe de la migración principal. Esta información se puede utilizar para validar qué usuarios y grupos se migraron correctamente y, quizás, para determinar por qué no se migraron algunos.

Para ver esta información, vaya a Cloud Acceleration Manager. Haga clic en la tarjeta de proyecto y en la tarjeta Transferencia de contenido. Vaya a Trabajos de ingesta y busque la ingesta que desea comprobar. Haga clic en los tres puntos () para esa ingesta, luego haga clic en Ver resumen principal en la lista desplegable.

imagen

Verá un cuadro de diálogo con la información de resumen. Utilice los iconos de ayuda para leer una descripción más completa. Haga clic en Descargar informe para descargar el informe completo separado por comas (CSV).

imagen

NOTA

Si la asignación de usuarios está deshabilitada, se muestra otra variante de este cuadro de diálogo. Indicará que la asignación de usuarios estaba deshabilitada y no mostrará los 3 campos que proporcionan valores de asignación de usuarios.

Solución de problemas

Error de validación. ¿Y ahora qué?

El primer paso es determinar si la ingesta falló realmente o si el contenido extraído ya está presente en el entorno de destino. Esto puede ocurrir si se repite una ingesta con el Borrar contenido existente en la instancia de Cloud antes de la ingesta opción desactivada.

Para verificarla, elija una ruta en el informe de validación y compruebe si está presente en el entorno de destino. Si es un entorno de publicación, puede limitarse a comprobar páginas y recursos directamente. Abra un ticket con el Servicio de atención al cliente si necesita ayuda con este paso.

El recuento de nodos es menor de lo que esperaba. ¿Por qué?

Algunas rutas de los resúmenes de extracción e ingesta se excluyen a propósito para mantener el tamaño de estos archivos manejable, con el objetivo de poder calcular el resultado de validación de migración en un plazo de dos horas desde que se completó la ingesta.

Las rutas que excluimos actualmente de los resúmenes incluyen: cqdam.text.txt representaciones, nodos dentro de /homey nodos dentro de /jcr:system.

Los grupos de usuarios cerrados no funcionan

Consulte Migración de grupos de usuarios cerrados por consideraciones adicionales al utilizar una directiva de grupo de usuarios cerrado (CUG).

En esta página