Notas de la versión: AEM 6.2 Oak Cumulative Fix Pack

Oak Cumulative Fix Packs

Las correcciones para el repositorio de Oak se entregan a través de Oak Cumulative Fix Packs (OCFP), que son totalmente compatibles, de forma similar a los Cumulative Fix Packs estándar. Un Oak Cumulative Fix Pack es autodependiente (sin dependencias). No tiene que preocuparse por las dependencias finding/resolving.

Instale el último paquete de correcciones acumulativas para su versión de AEM para mantener su implementación actualizada.

Si es necesario, se puede disponer de un diagnóstico basado en el último OCFP para fines de validación antes de la disponibilidad oficial del próximo OCFP. La condición previa es que se esté ejecutando el último OCFP. Una compilación de diagnóstico solo proporciona el mismo nivel de garantía de calidad que una corrección (parche). Por lo tanto, no proporciona el mismo nivel de garantía de calidad que un paquete de correcciones acumulativo, un paquete de servicios o una versión de producto. Todas las correcciones oficiales de Oak se publican como OCFP, que viene con el soporte completo.

Para obtener más información sobre Cumulative Fix Pack y otros tipos de versiones, consulte Maintenance Release Vehicle.

Instrucciones de instalación

Procedimiento de preimplementación para Oak 1.4.8 y versiones superiores

El Oak Cumulative Fix Pack 1.4.8 (y superior) contiene definiciones de índice. Antes de desplegar el Oak 1.4.8+ CFP, se recomienda  seguir el siguiente procedimiento de preimplementación para preparar el índice correspondiente a través de una ventana de mantenimiento, ya que la indexación puede requerir muchos recursos. Este es un procedimiento único (no es necesario volver a aplicarlo si ya lo ha hecho al aplicar un Oak CFP anterior con una versión >= 1.4.8).

Importante: Para los índices de compilación, la configuración de Oak debe establecer el límite en un valor más alto, por ejemplo, 200 000. Esto también requiere apilado suficiente. 

1. Instale el paquete de definición de índice NPR-14064, que contiene definiciones de índice con reindexación de asíncronos (no se debería generar un nuevo índice inmediatamente).
2. Para Mongo: Pare todas las instancias AEM excepto la primera.
3. Visite esta URL:
   
4. /system/console/jmx/org.apache.jackrabbit.oak%3Aname%3Dasync%2Ctype%3DPropertyIndexAsyncReindex
   
5. Recurra a startPropertyIndexAsyncReindex() para iniciar la indexación.
6. Monitorice los archivos de registro para este mensaje de registro:
   22.02.2017 11:34:32.602 *INFO* [aysnc-index-update-async-reindex] org.apache.jackrabbit.oak.plugins.index.AsyncIndexUpdate [async-reindex] Reindexing completed for indexes: [/oak:index/externalId*(0), /oak:index/externalPrincipalNames*(0), /oak:index/repMembers*(51)] en 1.085 s
   
7. Verifique que los índices se han generado con éxito revisando las siguientes propiedades actualizadas:
   • reindexCount=1
   • async="async-reindex" sería eliminado (con esto el índice volvería a la indexación síncrona).
8. Esto se debe comprobar para esos 3 índices (también se puede comprobar que la siguiente consulta no tiene resultados: //element(*, oak:QueryIndexDefinition)[@async = "async-reindex"]
   • /oak:index/repMembers
   • /oak:index/externalPrincipalNames
   • /oak:index/externalId
9. Nota: La generación de índices se puede detener.  Ir a esta URL:
   /system/console/jmx/org.apache.jackrabbit.oak%3Aname%3Dasync%2Ctype%3DIndexStats

Durante el proceso de reindexación de asíncronos, se crea un punto de comprobación de repositorios. Una vez finalizada la tarea de indexación, debe liberarse como se describe a continuación, para garantizar que la colección de residuos de revisión se realice sin problemas más adelante:

1. En primer lugar, abra el CheckpointManager MBean:
   MongoMK -
   /system/console/jmx/org.apache.jackrabbit.oak%3Aname%3DDocument+node+store+
   checkpoint+management%2Ctype%3DCheckpointManger
   
2. TarMK -
   /system/console/jmx/org.apache.jackrabbit.oak%3Aname%3DSegment+node+store+
   checkpoint+management%2Ctype%3DCheckpointManger
3. Invocar la operación listCheckpoints(),
4. Busque la fila del punto de comprobación con la propiedad name=async-reindex,
5. Copie su valor de id al portapapeles
   En MongoMK se verá similar a esto: r1234567aaaa-0-1
   En TarMK se verá similar a esto: 6eac07d0-fe27-4d16-82f8-6d5da4cefd67
6. Luego abra la operación releaseCheckpoint(),
7. Pegue el id copiado como p1 y haga clic en "Invocar",
8. Este paso liberará el punto de comprobación.
   

Instalación de Oak Cumulative Fix Pack

0. Compruebe que tiene una copia de seguridad de los datos. 1. Vaya a Herramientas y haga doble clic en Paquetes para abrir el Administrador de paquetes de CQ 2. Cargue e instale el paquete de correcciones 3. Reinicie AEM   En caso de que sea necesario que este parche se implemente en el contexto de una actualización de AEM 6.2, siga los siguientes pasos:
0. Compruebe que tiene una copia de seguridad de los datos. 1. Prepare la instancia de origen como se documenta y apague 2. Descomprima el AEM 6.2 Quickstart (java-jar quickstart.jar -unpack) 3. Desempaquete el paquete de correcciones en una ubicación temporal 4. Mueva /jcr_root/libs/system/install/* a /crx-quickstart/install 5. Mueva /jcr_root/libs/system/install/crx3/* a /crx-quickstart/install/15 6. Continúe con la actualización como está documentado  

Oak Cumulative Fix Packs disponibles

Oak 1.4.24

Oak 1.4.23

Oak 1.4.22

Oak 1.4.21

Oak 1.4.20

Oak 1.4.19

Oak 1.4.18

Oak 1.4.17

Oak 1.4.16

Oak 1.4.15

Oak 1.4.14

Oak 1.4.13

Oak 1.4.12

Oak 1.4.11

Oak 1.4.10

Oak 1.4.9

Oak 1.4.8

Oak 1.4.7

Nota importante

Oak 1.4.7 introduce un cambio en el comportamiento de sincronización de los miembros de grupos externos (por ejemplo, desde LDAP):

Ya no es posible asignar un grupo externo a un grupo local existente. El grupo local se debe crear con el proceso de sincronización del IdP y ya no se puede compartir con otros IdP externos.

Esto es necesario para asegurar los límites entre los miembros de grupos establecidos localmente y los externos, así como para asegurar los límites entre múltiples IdP.

La vinculación a un IdP se realiza a través de la propiedad “rep: externalId”, ahora totalmente protegida, de los grupos y usuarios. Para más detalles y soluciones de migración, véase: https://issues.apache.org/jira/browse/OAK-4397

Oak 1.4.6

Problemas conocidos

• En las versiones anteriores a Oak 1.4.5, debido a un problema conocido (OAK-4538, tratado en Oak 1.4.5), puede ocurrir que AEM no se detenga fácilmente y que en este caso sea necesario forzar la terminación del proceso jvm.
• Si utiliza la integración LDAP de Oak, después de aplicar la última corrección de Oak, la sincronización de usuarios LDAP ya no funcionará.  Para solucionar esto, vaya a /system/console/configMgr y actualice la propiedad “atributos personalizados” de su configuración de “proveedor de identidad de LDAP”.  Actualice la propiedad con todos los atributos LDAP utilizados en la configuración de sincronización.  Por ejemplo, estas propiedades pueden ser: cn, sn, givenName, mail

Recursos útiles

• Notas de la versión de AEM 6.2
• Página de producto AEM
• Documentación de AEM 6.2
• Suscríbase a Actualizaciones de productos de Adobe Priority