Ingesta de contenido en Cloud Service ingesting-content

Proceso de ingesta en Cloud Acceleration Manager ingestion-process

Siga los pasos a continuación para ingerir el conjunto de migración mediante Cloud Acceleration Manager:

  1. Vaya a Cloud Acceleration Manager. Haga clic en la tarjeta del proyecto y en la tarjeta Transferencia de contenido. Vaya a Trabajos de ingesta y haga clic en Nueva ingesta

    imagen

  2. Revise la lista de comprobación de ingesta y asegúrese de que se han completado todos los pasos. Estos pasos son necesarios para garantizar una ingesta correcta. Continúe con la Siguiente solo si se ha completado la lista de comprobación.

    imagen

  3. Proporcione la información necesaria para crear una ingesta.

    • Conjunto de migración: Seleccione el conjunto de migración que contiene los datos extraídos como origen.
      • Los conjuntos de migración caducarán después de un período de inactividad prolongado, por lo que se espera que la ingesta se produzca relativamente pronto después de realizar la extracción. Revisar Caducidad del conjunto de migración para obtener más información.
    note tip
    TIP
    Si la extracción se está ejecutando, el cuadro de diálogo lo indicará. Una vez que la extracción ha finalizado correctamente, la ingesta se inicia automáticamente. Si la extracción falla o se detiene, el trabajo de ingesta se rescindirá.
    • Destino: Seleccione el entorno de destino. En este entorno es donde se ingiere el contenido del conjunto de migración.

      • Las ingestas no admiten destinos de tipo Entorno de desarrollo rápido (RDE) o Vista previa, y no aparecen como una posible opción de destino, aunque el usuario tenga acceso a ellos.
      • Aunque un conjunto de migración se puede ingerir en varios destinos simultáneamente, un destino solo puede ser el destino de una ingesta en ejecución o en espera a la vez.
    • Nivel: Seleccione el nivel. (Autor/Publicación).

      • Si el origen era Author, se recomienda ingerirlo en el Author nivel en el objetivo. Del mismo modo, si el origen era Publish, el destino debe ser Publish y también.
    note note
    NOTE
    Si el nivel de destino es Author, la instancia de autor se cierra durante la duración de la ingesta y no está disponible para los usuarios (por ejemplo, los autores o cualquier persona que realice mantenimiento). El motivo es proteger el sistema y evitar cualquier cambio que pueda perderse o causar un conflicto de ingesta. Asegúrese de que su equipo esté al tanto de este hecho. Tenga en cuenta también que el entorno parece hibernado durante la ingesta del autor.
    • Borrar: Elija la Wipe valor

      • El Barrido establece el punto de inicio del destino de la ingesta. If Barrido AEM Cuando está activada, el destino, incluido todo su contenido, se restablece a la versión de la especificada en Cloud Manager. Si no está habilitado, el destino mantiene su contenido actual como punto de partida.
      • Esta opción hace lo siguiente NO afectar a cómo se realizará la ingesta de contenido. La ingesta siempre utiliza una estrategia de sustitución de contenido y no una estrategia de combinación de contenido para que, en ambos Barrido y Sin barrido En algunos casos, la ingesta de un conjunto de migración sobrescribirá el contenido en la misma ruta en el destino. Por ejemplo, si el conjunto de migración contiene /content/page1 y el destino ya contiene /content/page1/product1, la ingesta elimina el page1 ruta y sus subpáginas, incluidas product1y reemplácelo por el contenido del conjunto de migración. Esto significa que se debe realizar una planificación cuidadosa al realizar una Sin barrido la ingesta a un destino que incluya cualquier contenido que se deba mantener.
    note important
    IMPORTANT
    Si la configuración Barrido está habilitado para la ingesta, restablece todo el repositorio existente, incluidos los permisos de usuario en la instancia de Cloud Service de destino. Este restablecimiento también es verdadero para un usuario administrador agregado a administradores y ese usuario deben volver a agregarse al grupo de administradores para iniciar una ingesta.
    • Copia previa: Elija la Pre-copy valor

      • Puede ejecutar el paso opcional previo a la copia para acelerar de forma significativa la ingesta. Consulte Ingesta con AzCopy para obtener más información.
      • Si se utiliza la ingesta con copia previa (para S3 o Azure Data Store), se recomienda ejecutar Author la ingestión solo primero. Al hacerlo, se acelera el Publish la ingesta cuando se ejecuta más tarde.
    note important
    IMPORTANT
    Solo puede iniciar una ingesta en el entorno de destino si pertenece al entorno local de AEM administradores de en el servicio de creación del Cloud Service de destino. Si no puede iniciar una ingesta, consulte No se puede iniciar la ingesta para obtener más información.
  4. Clic Ingesta.

    imagen

  5. A continuación, puede monitorizar la ingesta desde la vista de lista de Trabajos de ingesta y utilizar el menú de acciones de la ingesta para ver las duraciones y registrar como progresa la ingesta.

    imagen

  6. Haga clic en (i) en la fila para obtener más información sobre el trabajo de ingesta. Puede ver la duración de cada paso de la ingesta cuando se está ejecutando o completando haciendo clic en y, a continuación, haga clic en Ver duraciones. La información de la extracción también muestra que se da cuenta de lo que se está ingiriendo.

    imagen

Ingesta superior top-up-ingestion-process

La herramienta de transferencia de contenido tiene una función que permite extraer contenido diferencial realizando una recargar del conjunto de migración. Esto permite modificar el conjunto de migración para incluir únicamente el contenido que ha cambiado desde la extracción anterior sin tener que extraer todo el contenido de nuevo.

NOTE
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 al Cloud Service. Si ha utilizado el paso de precopia para la primera ingesta, puede omitir la precopia para las ingestas de recarga posteriores (si el tamaño del conjunto de migración de recarga es inferior a 200 GB). El motivo es que puede añadir tiempo a todo el proceso.

Para introducir contenido diferencial una vez completadas algunas ingestas, debe ejecutar un Extracción Superiory, a continuación, utilice el método de ingesta con Barrido opción inhabilitado. Asegúrese de leer el Barrido Esta explicación anterior para evitar perder contenido que ya se encuentra en el destino.

Comience creando un trabajo de ingesta y asegúrese de que Barrido se desactiva durante la ingesta, como se muestra a continuación:

imagen

Solución de problemas troubleshooting

CAM no puede recuperar el token de migración cam-unable-to-retrieve-the-migration-token

La recuperación automática del token de migración puede fallar por diferentes motivos, entre los que se incluye configuración de una lista de permitidos IP mediante Cloud Manager en el entorno del Cloud Service de destino. En estos casos, verá el siguiente cuadro de diálogo cuando intente iniciar una ingesta:

imagen

Recupere el token de migración manualmente haciendo clic en el vínculo "Obtener token" en el cuadro de diálogo. Se abre otra pestaña que muestra el token. A continuación, puede copiar el token y pegarlo en Entrada de token de migración field. Ahora, debería poder iniciar la ingesta.

NOTE
El token está disponible para los usuarios que pertenecen al AEM administradores de en el servicio de creación del Cloud Service de destino.

No se puede iniciar la ingesta unable-to-start-ingestion

Solo puede iniciar una ingesta en el entorno de destino si pertenece al entorno local de AEM administradores de en el servicio de creación del Cloud Service de destino. AEM Si no pertenece al grupo de administradores de la, verá un error como se muestra a continuación cuando intente iniciar una ingesta. Puede pedir al administrador que le añada al local AEM administradores de o pida el token en sí, que puede pegar en el Entrada de token de migración field.

imagen

No se puede conectar con el servicio de migración unable-to-reach-migration-service

Después de solicitar una ingesta, se puede presentar al usuario un mensaje como el siguiente: "El servicio de migración en el entorno de destino es inaccesible. Si es así, vuelva a intentarlo más tarde o póngase en contacto con el soporte de Adobe".

imagen

Este mensaje indica que Cloud Acceleration Manager no pudo llegar al servicio de migración del entorno de destino para iniciar la ingesta. Esta situación puede ocurrir por varias razones.

NOTE
El campo "Token de migración" se muestra porque, en algunos casos, la recuperación de ese token es lo que realmente no está permitido. Al permitir que se proporcione manualmente, puede permitir al usuario iniciar la ingesta rápidamente, sin ninguna ayuda adicional. Si se proporciona el token y sigue apareciendo el mensaje, el problema no consistió en recuperar el token.
  • AEM El as a Cloud Service mantiene el estado del entorno y, ocasionalmente, debe reiniciar el servicio de migración por varios motivos normales. Si ese servicio se está reiniciando, no se podrá acceder a él, pero estará disponible en algún momento.
  • Es posible que se esté ejecutando otro proceso en la instancia. Por ejemplo, si AEM Actualizaciones de versión de está aplicando una actualización, el sistema puede estar ocupado y el servicio de migración no está disponible regularmente. Una vez completado ese proceso, se puede volver a intentar iniciar la ingesta.
  • Si un Se ha aplicado la Lista de permitidos IP a través de Cloud Manager, impide que Cloud Acceleration Manager llegue al servicio de migración. No se puede añadir una dirección IP para ingestas porque es dinámica. Actualmente, la única solución es deshabilitar la lista de permitidos de IP durante el proceso de ingesta e indexación.
  • Puede haber otras razones que requieren investigación. Si la ingesta o la indexación siguen fallando, póngase en contacto con el Servicio de atención al cliente de Adobe.

AEM Actualizaciones e ingestas de versiones de aem-version-updates-and-ingestions

AEM Actualizaciones de versión de AEM se aplican automáticamente a los entornos para mantenerlos actualizados con la versión as a Cloud Service más reciente de la. Si la actualización se activa cuando se realiza una ingesta, puede causar resultados impredecibles, incluido el daño del entorno.

AEM Si el programa de destino incorpora las "Actualizaciones de versión de", el proceso de ingesta intenta deshabilitar su cola antes de iniciarse. Cuando se completa la ingesta, el estado del actualizador de versiones se devuelve a como estaba antes de que se iniciaran las ingestas.

NOTE
AEM Ya no es necesario registrar un ticket de asistencia para desactivar las "Actualizaciones de versión de la versión de la aplicación" de la aplicación.

AEM Si "Actualizaciones de la versión de la versión de la" está activo (es decir, las actualizaciones se están ejecutando o están en cola para ejecutarse), la ingesta no comenzará y la interfaz de usuario mostrará el siguiente mensaje. Una vez completadas las actualizaciones, se puede iniciar la ingesta. Cloud Manager se puede utilizar para ver el estado actual de las canalizaciones del programa.

NOTE
AEM "Actualizaciones de la versión de la aplicación" se ejecuta en la canalización del entorno y espera hasta que la canalización esté limpia. Si las actualizaciones se ponen en cola durante más tiempo del esperado, asegúrese de que un flujo de trabajo personalizado no tenga la canalización bloqueada de forma involuntaria.

imagen

Error de ingesta superior debido a una infracción de la restricción de unicidad top-up-ingestion-failure-due-to-uniqueness-constraint-violation

Una causa común de una Ingesta superior el error es un conflicto en los id de nodo. Para identificar este error, descargue el registro de ingesta mediante la interfaz de usuario de Cloud Acceleration Manager y busque una entrada como la siguiente:

java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakConstraint0030: propiedad violada de la restricción de unicidad [jcr:uuid] con valor a1a1a1a1-b2b2-c3c3-d4d4-e5e5e5e5e5e5: /some/path/jcr:content, /some/other/path/jcr:content

AEM Cada nodo de la interfaz de usuario de debe tener un uuid único. Este error indica que un nodo que se está ingiriendo tiene el mismo uuid que uno que existe en una ruta diferente en la instancia de destino. Esta situación puede ocurrir por dos razones:

  • Un nodo se mueve en el origen entre una extracción y una siguiente Extracción Superior
    • RECORDAR: para las extracciones superiores, el nodo seguirá existiendo en el conjunto de migración, aunque ya no exista en el origen.
  • Un nodo en el destino se mueve entre una ingesta y una ingesta superior subsiguiente.

Este conflicto debe resolverse manualmente. Alguien familiarizado con el contenido debe decidir cuál de los dos nodos se debe eliminar, teniendo en cuenta otro contenido que haga referencia a él. La solución puede requerir que la extracción superior se realice de nuevo sin el nodo infractor.

Error de ingesta superior debido a que no se puede eliminar el nodo al que se hace referencia top-up-ingestion-failure-due-to-unable-to-delete-referenced-node

Otra causa común de una Ingesta superior el error es un conflicto de versiones para un nodo en particular en la instancia de destino. Para identificar este error, descargue el registro de ingesta mediante la interfaz de usuario de Cloud Acceleration Manager y busque una entrada como la siguiente:

java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakIntegrity0001: No se puede eliminar el nodo al que se hace referencia: 8a2289f4-b904-4bd0-8410-15e41e0976a8

Esto puede suceder si se modifica un nodo en el destino entre una ingesta y una Sin barrido ingesta de tal manera que se ha creado una nueva versión. Si el conjunto de migración se ha extraído con la opción "incluir versiones" habilitada, puede producirse un conflicto, ya que el destino tiene ahora una versión más reciente a la que hacen referencia el historial de versiones y otro contenido. El proceso de ingesta no puede eliminar el nodo de versión infractor porque se hace referencia a él.

La solución puede requerir que la extracción superior se realice de nuevo sin el nodo infractor. O bien, creando un pequeño conjunto de migración del nodo infractor, pero con la opción "incluir versiones" deshabilitada.

Las prácticas recomendadas indican que si Sin barrido La ingesta debe ejecutarse con un conjunto de migración que incluya versiones. Es crucial que el contenido del destino se modifique lo menos posible, hasta que se complete el recorrido de migración. De lo contrario, pueden producirse estos conflictos.

Error de ingesta debido a valores de propiedad de nodos grandes ingestion-failure-due-to-large-node-property-values

Los valores de propiedad del nodo almacenados en MongoDB no pueden superar los 16 MB. Si el valor de un nodo supera el tamaño admitido, la ingesta falla y el registro contiene un BSONObjectTooLarge y especifique qué nodo ha superado el máximo. Esta es una restricción de MongoDB.

Consulte la Node property value in MongoDB nota en Requisitos previos para la herramienta de transferencia de contenido para obtener más información y un vínculo a una herramienta Oak que pueda ayudar a encontrar todos los nodos grandes. Una vez corregidos todos los nodos con tamaños grandes, ejecute de nuevo la extracción y la ingesta.

Ingesta Rescindida ingestion-rescinded

Una ingesta creada con una extracción en ejecución como el conjunto de migración de origen espera pacientemente hasta que la extracción se realice correctamente y, en ese momento, comienza con normalidad. Si la extracción falla o se detiene, la ingesta y su trabajo de indexación no comenzarán, pero se rescindirán. En este caso, compruebe la extracción para determinar por qué ha fallado, corrija el problema y vuelva a empezar a extraer. Una vez que se esté ejecutando la extracción fija, se puede programar una nueva ingesta.

Siguientes pasos whats-next

AEM Cuando la ingesta se haya realizado correctamente, la indexación de la se iniciará automáticamente. Consulte Indexación después de migrar contenido para obtener más información.

Una vez que haya completado la ingesta de contenido en Cloud Service, puede ver los registros de cada paso (extracción e ingesta) y buscar errores. Consulte Visualización de registros del conjunto de migraciones para obtener más información.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab