Notas de versão: pacote de correção cumulativo do Oak do AEM 6.2

Pacotes de correções cumulativas do Oak

As correções para o repositório Oak são fornecidas via Pacotes de correções cumulativas do Oak (OCFP, Oak Cumulative Fix Packs), que são totalmente compatíveis, da mesma forma que os Pacotes de correções cumulativas padrão. Um Pacote de correções cumulativas do Oak é autônomo (sem dependências). Você não precisa se preocupar em encontrar/resolver as dependências.

Instale o pacote de correções cumulativas mais recente para sua versão do AEM para manter sua implantação atualizada.

Se necessário, poderá ser disponibilizada uma build de diagnóstico para o OCFP mais recente para fins de validação antes de disponibilizar oficialmente o próximo OCFP. A pré-condição é que você tenha o OCFP mais recente em execução. Um build de diagnóstico fornece apenas o mesmo nível de garantia de qualidade de um hotfix, portanto, não fornece o mesmo nível de garantia de qualidade de um pacote de correções cumulativas, service pack ou lançamento de produto. Todas as correções oficiais do Oak são lançadas como OCFP, que inclui o suporte completo.

Para saber mais sobre o CFP e outros tipos de lançamentos, consulte Maintenance Release Vehicle.

Instruções de instalação

Procedimento de pré-implantação para o Oak 1.4.8 e versões posteriores

O pacote cumulativo de correções do Oak 1.4.8 (e posteriores) contém definições de índice. Antes de implantar o Oak 1.4.8 + CFP, é recomendável  seguir o procedimento de pré-implantação abaixo para preparar o índice correspondente durante uma janela de manutenção, pois a indexação pode consumir muitos recursos. É um procedimento único: não é necessário realizá-lo novamente se você já o tiver feito ao aplicar um Oak CFP anterior tendo uma versão >= 1.4.8.

Importante: na configuração do Oak para a criação de índices, o limite deve ser definido com um valor mais alto, por exemplo, 200000. Isso também requer heap suficiente. 

1. Instale o pacote de definição de índice NPR-14064, que contém definições de índice com reindexação assíncrona (o pacote não deveria criar um novo índice imediatamente).
2. Para Mongo: pare todas as instâncias do AEM, exceto 1.
3. Visite este URL:
   
4. /system/console/jmx/org.apache.jackrabbit.oak%3Aname%3Dasync%2Ctype%3DPropertyIndexAsyncReindex
   
5. Invoque startPropertyIndexAsyncReindex() para iniciar a indexação.
6. Monitore os arquivos de log para a seguinte mensagem de log:
   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)] in 1.085 s
   
7. Verifique se os índices foram criados com êxito, comprovando as seguintes propriedades atualizadas:
   • reindexCount=1
   • async="async-reindex" estaria excluído (com isso, o índice retornaria à indexação síncrona)
8. Isso deve ser verificado para esses três índices (também é possível verificar se a seguinte consulta não possui resultados: //element(*, oak:QueryIndexDefinition)[@async = "async-reindex"]
   • /oak:index/repMembers
   • /oak:index/externalPrincipalNames
   • /oak:index/externalId
9. Observação: a construção do índice pode ser parada.  Vá para este URL:
   /system/console/jmx/org.apache.jackrabbit.oak%3Aname%3Dasync%2Ctype%3DIndexStats

Durante o processo de reindexação assíncrona, é criado um ponto de verificação de repositório. Uma vez concluída a tarefa de indexação, ela deve ser liberada conforme descrito abaixo, para garantir uma coleção de lixo de revisão sem problemas mais adiante:

1. Primeiro, abra o MBean CheckpointManager:
   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. Invoque a operação listCheckpoints (),
4. Encontre a linha do ponto de verificação com a propriedade "name=async-reindex",
5. Copie seu valor de id para a área de transferência
   No MongoMK, será semelhante a isto: r1234567aaaa-0-1
   No TarMK será parecido com isto: 6eac07d0-fe27-4d16-82f8-6d5da4cefd67
6. Em seguida, abra a operação releaseCheckpoint()
7. Cole a ID copiada como p1 e clique em “Invoke”,
8. Esta etapa libera o ponto de verificação.
   

Instalação do Pacote de correções cumulativas Oak

0. Faça backup dos dados 1. Vá para “Ferramentas” e clique duas vezes em “Pacotes” para abrir o Gerenciador de pacotes do CQ 2. Faça upload e instale o pacote de hotfix 3. Reinicie o AEM   Caso essa correção precise ser implantada no contexto de uma atualização para o AEM 6.2, siga as seguintes etapas:
0. Faça backup dos dados 1. Prepare a instância de origem conforme a documentação e encerre 2. Descompacte o AEM 6.2 Quickstart (java-jar quickstart.jar -unpack) 3. Descompacte o pacote de hotfix para um local temporário 4. Mova /jcr_root/libs/system/install/* para /crx-quickstart/install 5. Mova /jcr_root/libs/system/install/crx3/* para /crx-quickstart/install/15 6. Continue com a atualização conforme a documentação  

Pacotes de correções cumulativas do Oak disponíveis

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

O Oak 1.4.7 introduz uma alteração no comportamento de sincronização de associações a grupos externos (por exemplo, do LDAP).

O mapeamento de um grupo externo para um grupo local existente já não é possível. O grupo local precisa ser criado pelo processo de sincronização do IDP e não pode mais ser compartilhado com outros IDPs externos.

Isso é necessário para garantir limites entre membros de grupos estabelecidos localmente e externos e para garantir limites entre vários IDPs.

A ligação a um IDP é feita através da propriedade "rep: externalId", agora totalmente protegida em grupos e usuários. Para detalhes e soluções de migração, consulte: https://issues.apache.org/jira/browse/OAK-4397

Oak 1.4.6

Problemas conhecidos

• Para versões anteriores ao Oak 1.4.5, devido a um problema conhecido (OAK-4538, abordado no Oak 1.4.5), pode acontecer que o AEM não possa ser interrompido normalmente e, nesse caso, o término do processo jvm precisa ser forçado.
• Se estiver usando a integração LDAP do Oak, depois de aplicar o hotfix mais recente do Oak, a sincronização do usuário LDAP deixará de funcionar.  Para corrigir isso, acesse /system/console/configMgr e atualize a propriedade "Custom Attributes" da configuração "LDAP Identity Provider".  Atualize a propriedade com todos os atributos LDAP usados na configuração de sincronização.  Por exemplo, essas propriedades podem ser: cn, sn, givenName, mail

Recursos úteis

• Notas de versão do AEM 6.2
• Página do produto AEM
• Documentação do AEM 6.2
• Inscreva-se em Atualizações prioritárias de produtos da Adobe