Uso de la herramienta de transferencia de contenido

Consideraciones importantes sobre el uso de la herramienta de transferencia de contenido

En la sección siguiente se comprenden las consideraciones importantes al ejecutar la herramienta de transferencia de contenido:

  • El requisito mínimo del sistema para la herramienta de transferencia de contenido es AEM 6.3+ y JAVA 8. Si dispone de una versión anterior de AEM, deberá actualizar el repositorio de contenido a AEM 6.5 para usar la herramienta de transferencia de contenido.

  • Java debe configurarse en el entorno de AEM para que el java comando pueda ser ejecutado por el usuario que AEM inicio.

  • La herramienta de transferencia de contenido se puede utilizar con los siguientes tipos de almacén de datos: Almacén de datos de archivos, almacén de datos S3, almacén de datos compartido S3 y almacén de datos del almacén de blob de Azure.

  • Si está utilizando un Entorno de Simulador para pruebas, asegúrese de que el entorno está actualizado y se ha actualizado a la versión más reciente. Si utiliza un Entorno de producción, se actualiza automáticamente.

  • Para utilizar la herramienta de transferencia de contenido, deberá ser un usuario administrador en la instancia de origen y pertenecer al grupo de administradores de AEM locales en la instancia de Cloud Service a la que esté transfiriendo contenido. Los usuarios sin privilegios no podrán recuperar el token de acceso para utilizar la herramienta de transferencia de contenido.

  • Actualmente, el tamaño predeterminado de MongoDB para una AEM como instancia de Cloud Service Author es de 32 GB. Se recomienda enviar un ticket de soporte técnico para aumentar el tamaño de MongoDB para el almacenamiento de segmentos de buenos 20 GB.

  • Los usuarios y grupos transferidos por la herramienta de transferencia de contenido son solo aquellos que el contenido requiere para satisfacer los permisos. El proceso de Extracción copia todo /home el conjunto de migración y el proceso de introducción copia todos los usuarios y grupos a los que se hace referencia en las ACL de contenido migrado.

  • Durante la fase de extracción, la herramienta de transferencia de contenido se ejecuta en una instancia de origen de AEM activa.

  • Después de completar la fase de Extracción del proceso de transferencia de contenido y antes de iniciar la fase de ingesta de contenido en su AEM como etapa de Cloud Service o instancias de producción , deberá registrar una entrada de soporte para notificar al Adobe su intención de ejecutar la ingestión ** de modo que el Adobe pueda garantizar que no se produzcan interrupciones durante el proceso de ingestiónde documentos. Tendrá que registrar el ticket de asistencia 1 semana antes de la fecha prevista de ingestión . Una vez que haya enviado el ticket de soporte técnico, el equipo de soporte técnico le proporcionará orientación sobre los próximos pasos.

    • Registre un ticket de asistencia técnica con los siguientes detalles:
      • Fecha exacta y hora estimada (con su huso horario) cuando planea realizar el inicio de la fase de ingestión .
      • Tipo de entorno (fase o producción) en el que se van a ingestar datos.
      • ID de programa.
  • La fase de Ingesta del autor reducirá la implementación de todo el autor. Esto significa que el autor de AEM no estará disponible durante todo el proceso de inserción. Asegúrese también de que no se ejecuten tuberías del Administrador de nube mientras está ejecutando la fase de ingesta .

Disponibilidad

La herramienta de transferencia de contenido se puede descargar como archivo zip desde el portal de distribución de software. Puede instalar el paquete mediante el Administrador de paquetes en la instancia de origen de Adobe Experience Manager (AEM). Asegúrese de descargar la versión más reciente. Para obtener más información sobre la versión más reciente, consulte Notasde la versión.

Nota

Descargue Content Transfer Tool desde el portal de distribución de software.

Ejecución de la herramienta de transferencia de contenido

Siga esta sección para aprender a utilizar la herramienta de transferencia de contenido para migrar el contenido a AEM as a Cloud Service (autor/publicación):

  1. Seleccione Adobe Experience Manager y vaya a las herramientas -> Operaciones -> Transferencia de contenido.

    image

  2. La consola siguiente aparece cuando se crea el primer conjunto de migración. Haga clic en Crear conjunto de migración para crear un conjunto de migración nuevo.

    image

    Nota

    Si tiene conjuntos de migración existentes, la consola mostrará la lista de los conjuntos de migración existentes con su estado actual.

  3. Rellene los campos de la pantalla de detalles del conjunto de migraciones de contenido como se describe a continuación.

    image

    1. Nombre: introduzca el nombre del conjunto de migración.

      Nota

      No se permiten caracteres especiales para el nombre del conjunto de migración.

    2. Configuración de Cloud Service: introduzca la URL de Autor de destino de AEM as a Cloud Service.

      Nota

      Puede crear y mantener un máximo de cuatro conjuntos de migración a la vez durante la actividad de transferencia de contenido.
      Además, debe crear una migración por separado para cada uno de los entornos específicos: Fase, Desarrollo o Producción.

    3. Token de acceso: introduzca el token de acceso.

      Nota

      Puede recuperar el token de acceso mediante el botón Abrir token de acceso . Debe asegurarse de pertenecer al grupo de administradores de AEM en la instancia de destinatario Cloud Service.

    4. Parámetros: seleccione los siguientes parámetros para crear el conjunto de migración:

      1. Incluir versión: seleccione la opción que desee.

      2. Rutas que se incluyen: utilice el explorador para seleccionar las rutas que deben migrarse. El selector de rutas acepta entradas escribiendo o seleccionando.

        IMPORTANTE

        Las siguientes rutas están restringidas al crear un conjunto de migración:

        • /apps
        • /libs
        • /home
        • /etc
  4. Haga clic en Guardar después de rellenar todos los campos en la pantalla de detalles del conjunto de migraciones de contenido.

  5. La vista del conjunto de migraciones se realizará en la página de Información general.

    image

    Todos los conjuntos de migración existentes en esta pantalla se muestran en la página Información general con su estado actual y la información de estado. Puede ver algunos de estos iconos que se describen a continuación.

    • La nube roja indica que no se puede completar el proceso de extracción.
    • La nube verde indica que se puede completar el proceso de extracción.
    • El icono amarillo indica que no se creó el conjunto de migración existente y que el específico lo crea otro usuario en la misma instancia.
  6. Seleccione un conjunto de migración de la página de información general y haga clic en Propiedades para consultar o editar las propiedades del conjunto de migración. Durante la edición de propiedades, no es posible cambiar el nombre del contenedor o la dirección URL del servicio.

Proceso de Extracción en transferencia de contenido

Siga los pasos a continuación para extraer el conjunto de migración de la herramienta de transferencia de contenido:

  1. Seleccione un conjunto de migraciones de la página Información general y haga clic en Extracción para empezar la extracción. The Migration Set extraction dialog box displays and click on Extract to start the extraction phase.

    image

    Nota

    Tiene la opción de sobrescribir el contenedor de ensayo durante la fase de extracción.

  2. El campo EXTRACCIÓN ahora muestra el estado EJECUTANDO para indicar que la extracción está en curso.

    image

    Una vez finalizada la extracción, el estado del conjunto de migración se actualiza a FINALIZADO y aparece un icono de nube verde lisa debajo del campo INFORMACIÓN .

    image

    Nota

    La interfaz de usuario tiene una función de recarga automática que vuelve a cargar la página de información general cada 30 segundos.
    Cuando se inicia la fase de extracción, el bloqueo de escritura se crea y se libera después de 60 segundos. Por lo tanto, si se detiene una extracción, hay que esperar un minuto para que se libere el bloqueo antes de volver a iniciarla.

Extracción superior

La herramienta de transferencia de contenido tiene una función que permite agregar contenido diferencial donde solo es posible transferir los cambios realizados desde la actividad de transferencia de contenido anterior.

Nota

Después de la transferencia de contenido inicial, se recomienda realizar frecuentes recargas de contenido diferencial para acortar el período de congelación de contenido para la transferencia de contenido diferencial final antes de lanzarse a Cloud Service.

Una vez completado el proceso de extracción, se puede transferir contenido delta mediante el método de extracción superior. Complete los siguientes pasos:

  1. Vaya a la página Información general y seleccione el conjunto de migración para el que desea realizar la extracción superior. Haga clic en Extracción para iniciar la extracción superior. Aparece el cuadro de diálogo extracción de conjunto de migración .

    IMPORTANTE

    Se debe desactivar la opción Sobrescribir el contenedor de ensayo durante la extracción .

    image

Proceso de Ingesta en transferencia de contenido

Siga los pasos a continuación para ingerir el conjunto de migración de la herramienta de transferencia de contenido:

  1. Seleccione un conjunto de migraciones de la página Información general y haga clic en Ingesta para empezar la extracción. Aparece el cuadro de diálogo ingesta de conjunto de migración . Click on Ingest to start the ingestion phase. Para fines de demostración, se desactiva la opción Ingesta de contenido de Autor . Es posible la ingesta del contenido al mismo tiempo en Autor y Publish.

    image

  2. Una vez finalizada la ingestión, el estado del campo PUBLISH INGESTION se actualiza a FINISHED.

    image

Ingesta superior

La herramienta de transferencia de contenido tiene una función que permite agregar contenido diferencial donde solo es posible transferir los cambios realizados desde la actividad de transferencia de contenido anterior.

Nota

Después de la transferencia de contenido inicial, se recomienda realizar frecuentes recargas de contenido diferencial para acortar el período de congelación de contenido para la transferencia de contenido diferencial final antes de lanzarse a Cloud Service.

Una vez completado el proceso de ingesta, se puede usar el contenido delta mediante el método de ingesta superior. Complete los siguientes pasos:

  1. Vaya a la página Información general y seleccione el conjunto de migración para el que desea realizar la ingesta superior. Haga clic en Ingesta para iniciar la extracción superior. Aparece el cuadro de diálogo ingesta de conjunto de migración .

    IMPORTANTE

    Debe desactivar la opción Borrar contenido existente en la instancia de Cloud antes de la ingestión , para evitar que se elimine el contenido existente de la actividad de ingestión anterior.

    image

Visualización de registros del conjunto de migraciones

La visualización de registros de un conjunto de migraciones existente en la página Información general .
Complete los siguientes pasos:

  1. Vaya a la página Información general, seleccione el conjunto de migración que desee eliminar y haga clic en Visualización de registros en la barra de acciones.

    image

  2. Aparece el cuadro de diálogo Registros . Haga clic en Extracción de registros para ver los registros en una nueva pestaña.

    image
    O

    también puede crear Visualización de registros para el conjunto de migraciones desde la pantalla Información general . Seleccione el conjunto de migración y haga clic en el estado en el campo EXTRACCIÓN . En este caso, haga clic en FINALIZADO para ver los registros de vista en una nueva pestaña.

    image

  3. Para rastrear los registros sin utilizar la interfaz de usuario, puede SSH en el entorno AEM de origen y seguir el crx-quickstart/cloud-migration/extraction-XXXXX/output.log file.

Eliminación de un conjunto de migraciones

Puede eliminar el conjunto de migraciones desde la página Información general .
Complete los siguientes pasos:

  1. Vaya a la página Información general, seleccione el conjunto de migración que desee eliminar y haga clic en Eliminar en la barra de acciones.

    image

  2. Haga clic en Eliminar del cuadro de diálogo Eliminación del conjunto de migraciones para confirmar la eliminación.

    image

Solución de problemas

ID de blob faltantes

Si se notifican identificaciones de blob faltantes como se menciona a continuación, entonces es necesario ejecutar una prueba de consistencia en el repositorio existente y restaurar los blobs que faltan.
ERROR o.a.j.o.p.b.AbstractSharedCachingDataStore - Error retrieving record [ba45c53f8b687e7056c85dceebf8156a0e6abc7e]

Se ejecuta el siguiente comando:

Nota

--verbose se necesita el indicador para informar de las rutas de nodos desde donde se hace referencia a los blobs.

Para repositorios AEM 6.5 (Oak 1.8 y posteriores)

java -jar oak-run.jar datastorecheck --consistency --store [<SEGMENT_STORE_PATH>|<MONGO_URI>] --[s3ds|fds] <DATASTORE_CFG> --verbose <OUT_DIR> --dump

Para repositorios con Oak > 1.10

java -jar oak-run.jar datastore --check-consistency [<SEGMENT_STORE_PATH>|<MONGO_URI>] --[s3ds|fds|azureds] <DATASTORE_CFG> --out-dir <OUT_DIR> --work-dir <TEMP_DIR> --verbose

Consulte Oak Runnable Jar para obtener más detalles.

Los archivos creados en OUT_DIR especificados anteriormente para mantener la consistencia se pueden comprobar en busca de rutas en las que falten binarios y acciones adecuadas como restaurar desde una copia de seguridad, eliminar las rutas, volver a indexar, etc.

Comportamiento de la IU

Como usuario, es posible que vea los siguientes cambios de comportamiento en la IU (IU) para la herramienta de transferencia de contenido:

  • El usuario crea un conjunto de migraciones para una URL de creación (Desarrollo, fase, producción) y realiza correctamente la extracción y la ingesta.

  • A continuación, el usuario crea un nuevo conjunto de migración para la misma URL de creación y realiza la extracción y la ingesta en el nuevo conjunto de migración. La IU muestra que el estado de ingesta del primer conjunto de migración cambia a ERRÓNEO y que no hay registros disponibles.

  • Esto no significa que se haya producido un error en la ingesta del primer conjunto de migración. Este comportamiento se observa porque cuando se inicia un nuevo trabajo de ingesta, se elimina el trabajo de ingesta anterior. Por lo tanto, se debe ignorar el estado de los cambios en el primer conjunto de migración.

  • Es posible que los iconos de la IU de la herramienta de transferencia de contenido sean diferentes de las capturas de pantalla que se muestran en esta guía o que no se muestren en absoluto según la versión de la instancia de origen de AEM.

En esta página