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 usuario que inicia AEM pueda ejecutar el comando java.

  • Se recomienda desinstalar las versiones anteriores de la herramienta de transferencia de contenido al instalar la versión 1.3.0, ya que se ha producido un cambio importante en la arquitectura de la herramienta. Con 1.3.0, también debe crear nuevos conjuntos de migración y volver a ejecutar la extracción y la ingesta en los nuevos conjuntos de migración.

  • 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 blob de Azure.

  • Si utiliza un Entorno de espacio aislado, asegúrese de que su entorno esté actualizado y actualizado a la última versión. 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 local de AEM administradores en la instancia de Cloud Service a la que esté transfiriendo el contenido. Los usuarios sin privilegios no podrán recuperar el token de acceso para utilizar la herramienta de transferencia de contenido.

  • Si la opción Borrar contenido existente en la instancia de Cloud antes de la ingesta está habilitada, elimina todo el repositorio existente y crea un nuevo repositorio en el que introducir contenido. Esto significa que restablece toda la configuración, incluidos los permisos, en la instancia de Cloud Service de destino. Esto también se aplica a los usuarios administradores agregados al grupo administradores. El usuario deberá agregarse de nuevo al grupo administradores para recuperar el token de acceso para CTT.

  • El token de acceso puede caducar periódicamente después de un período de tiempo específico o después de actualizar el entorno del Cloud Service. Si el token de acceso ha caducado, no podrá conectarse a la instancia de Cloud Service y deberá recuperar el nuevo token de acceso. El icono de estado asociado con un conjunto de migración existente cambiará a una nube roja y mostrará un mensaje cuando pase el ratón por encima de él.

  • La herramienta de transferencia de contenido no realiza ningún tipo de análisis de contenido antes de transferir contenido de la instancia de origen a la instancia de destino. Por ejemplo, CTT no diferencia entre contenido publicado y no publicado al ingerir contenido en un entorno de publicación. Sea cual sea el contenido especificado en el conjunto de migración, se incorporará en la instancia de destino elegida. El usuario tiene la capacidad de ingerir un conjunto de migración en una instancia de Autor, una instancia de Publicación o ambas. Se recomienda que, al mover contenido a una instancia de Producción, CTT se instale en la instancia de Autor de origen para mover contenido a la instancia de Autor de destino e instale de forma similar CTT en la instancia de Publicación de origen para mover contenido a la instancia de Publicación de destino.

  • Los usuarios y grupos que transfiere la herramienta de transferencia de contenido son solo aquellos que necesita el contenido para satisfacer los permisos. El proceso Extraction copia todo el /home en el conjunto de migración y el proceso Ingestion copia todos los usuarios y grupos a los que se hace referencia en las ACL de contenido migrado. Para asignar automáticamente los usuarios y grupos existentes a sus ID de IMS, consulte Uso de la herramienta de asignación de usuarios.

  • 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 Extraction del proceso de transferencia de contenido y antes de iniciar la Fase de ingesta para introducir contenido en su AEM como Cloud Service Stage o Production instancias, deberá registrar un ticket de asistencia para notificar al Adobe su intención de ejecutar la Ingesta<a7<a>9/> para que el Adobe pueda garantizar que no se produzcan interrupciones durante el proceso Ingesta . Tendrá que registrar el ticket de soporte 1 semana antes de la fecha planificada Ingesta. Una vez que haya enviado el ticket de soporte, el equipo de soporte le proporcionará instrucciones sobre los pasos siguientes.

    • Registre un vale de soporte con los siguientes detalles:
      • Fecha exacta y hora estimada (con su zona horaria) en la que planea iniciar la fase Ingesta.
      • Tipo de entorno (fase o producción) en el que planea introducir datos.
      • ID del 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 ejecutan canalizaciones de Cloud Manager mientras está ejecutando la fase 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 última versión. Para obtener más información sobre la versión más reciente, consulte Notas de 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 -> Migración de contenido.

    image

  2. Seleccione la opción Content Transfer del asistente Content Migration.

    image

  3. La consola siguiente aparece al crear 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 conjuntos de migración existentes con su estado actual.

    Además, haga clic en Crear configuración de asignación de usuarios para acceder a la Herramienta de asignación de usuarios.

  4. Rellene los campos de la pantalla Crear conjunto de migración 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 Open access token. Debe asegurarse de pertenecer al grupo de administradores de AEM en la instancia de Cloud Service de destino.

    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. Incluir asignación de usuarios y grupos de IMS: Seleccione la opción para incluir la asignación de Usuarios y grupos de IMS.
        Consulte Herramienta de asignación de usuarios para obtener más información.

      3. Rutas que se incluyen: utilice el explorador para seleccionar las rutas que deben migrarse. El selector de rutas acepta entradas mediante escritura o selección.

        IMPORTANTE

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

        • /apps
        • /libs
        • /home
        • /etc (se permite seleccionar algunas /etc rutas en CTT)
  5. Haga clic en Guardar después de rellenar todos los campos en la pantalla de detalles Crear conjunto de migración.

  6. 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.
  7. 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. Aparece el cuadro de diálogo Migration Set extraction y haga clic en Extract para iniciar la fase de extracción.

    image

    NOTA

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

  2. El campo EXTRACTION ahora muestra el estado RUNNING 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 . Haga clic en Ingesta para iniciar la fase de ingesta. Es posible la ingesta del contenido al mismo tiempo en Autor y Publish.

    IMPORTANTE

    Cuando la opción Borrar contenido existente en la instancia de Cloud antes de la ingesta está habilitada, elimina todo el repositorio existente y crea un nuevo repositorio en el que introducir contenido. Esto significa que restablece toda la configuración, incluidos los permisos, en la instancia de Cloud Service de destino. Esto también se aplica a los usuarios administradores agregados al grupo administradores.

    image

    Además, haga clic en Servicio de atención al cliente para registrar un ticket, como se muestra en la figura anterior. Consulte también Consideraciones importantes sobre el uso de la herramienta de transferencia de contenido para obtener más información.

  2. Una vez finalizada la ingesta, el estado en el 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 .

    image

    IMPORTANTE

    Debe desactivar la opción Borrar contenido existente en la instancia de Cloud antes de la ingesta para evitar que se elimine el contenido existente de la actividad de ingesta anterior. Además, haga clic en Servicio de atención al cliente para registrar un ticket, como se muestra en la figura anterior.

Visualización de registros del conjunto de migraciones

Una vez completado cada paso (extracción e ingesta), compruebe los registros y busque errores. Cualquier error debe solucionarse inmediatamente, ya sea abordando los problemas notificados o poniéndose en contacto con el servicio de asistencia al Adobe.

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:

  • 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

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now