Verificações de pós-atualização e solução de problemas

Verificações de pós-atualização

Após a Atualização no local as seguintes atividades devem ser executadas para finalizar a atualização. Pressupõe-se que AEM foi iniciado com o jar 6.5 e que a base de código atualizada foi implantada.

• Verificar registros para o sucesso da atualização

• Verificar pacotes OSGi

• Verificar versão do Oak

• Inspect a pasta PreUpgradeBackup

• Validação inicial de páginas

• Aplicar AEM Service Packs

• Migrar recursos AEM

• Verificar configurações de manutenção programadas

• Ativar agentes de replicação

• Ativar Tarefas Agendadas Personalizadas

• Executar plano de teste

Verifique se os registros de atualização foram bem-sucedidos

upgrade.log

Anteriormente, inspecionar o estado pós-atualização da sua instância exigia uma inspeção cuidadosa de vários arquivos de log, partes do repositório e do bloco de lançamento. Gerar um relatório de atualização posterior pode ajudar a detectar atualizações defeituosas antes de entrar em funcionamento.

A principal finalidade desse recurso é reduzir a necessidade de interpretação manual ou de lógica de análise complexa em vários endpoints necessários para qualificar o sucesso de uma atualização. A solução tem como objetivo fornecer informações inequívocas para que os sistemas externos de automação reajam ao sucesso ou à falha identificada de uma atualização.

Mais especificamente, garante que:

• As falhas de atualização detectadas pela estrutura de atualização podem ser centralizadas em um único relatório de atualização;
• O relatório de atualização inclui indicadores sobre a intervenção manual necessária.

Para acomodar isso, foram feitas alterações na maneira como os logs são gerados no arquivo upgrade.log.

Este é um exemplo de relatório que não mostra erros durante a atualização:

Este é um exemplo de relatório que mostra um pacote que não foi instalado durante o processo de atualização:

error.log

O error.log deve ser cuidadosamente revisado durante e após o start de AEM usando o jar da versão do público alvo. Quaisquer avisos ou erros devem ser revisados. Em geral, é melhor procurar problemas no início do log. Os erros que ocorrem mais tarde no log podem ser efeitos colaterais de uma causa raiz que é chamada mais cedo no arquivo. Se ocorrerem erros repetidos e avisos, consulte abaixo para Analisar problemas com a Atualização.

Verificar pacotes OSGi

Navegue até o console do OSGi /system/console/bundles e verifique se os pacotes não foram iniciados. Se algum pacote estiver em um estado instalado, consulte error.log para determinar o problema raiz.

Verificar a versão do Oak

Após a atualização, você verá que a versão do Oak foi atualizada para 1.10.2. Para verificar a versão Oak, navegue até o console OSGi e verifique a versão associada aos pacotes Oak: Oak Core, Oak Commons, Oak Segment Tar.

Pasta Inspect PreUpgradeBackup

Durante a atualização, o AEM tentará fazer backup das personalizações e armazená-las abaixo de /var/upgrade/PreUpgradeBackup/<time-stamp-of-upgrade>. Para visualização desta pasta no CRXDE Lite, talvez seja necessário ativar temporariamente o CRXDE Lite.

A pasta com carimbo de data e hora deve ter uma propriedade chamada mergeStatus com um valor de COMPLETED. A pasta to-process deve estar vazia e o nó substituído indica quais nós foram substituídos durante a atualização. O conteúdo abaixo do nó esquerdos indica o conteúdo que não pôde ser unido com segurança durante a atualização. Se sua implementação depender de qualquer um dos nós filhos (e ainda não estiver instalado pelo seu pacote de códigos atualizado), eles precisarão ser unidos manualmente.

Desative o CRXDE Lite após este exercício se estiver em um Palco ou ambiente de produção.

Validação inicial de páginas

Execute uma validação inicial em relação a várias páginas no AEM. Se você estiver atualizando um ambiente do autor, abra a página Start e a página de boas-vindas ( /aem/start.html, /libs/cq/core/content/welcome.html). Nos ambientes Autor e Publicar, abra algumas páginas do aplicativo e teste de fumaça que são renderizados corretamente. Se algum problema ocorrer, consulte error.log para solucionar o problema.

Aplicar AEM Service Packs

Aplique todos os Service Packs relevantes AEM 6.5, se tiverem sido liberados.

Migrar recursos AEM

Vários recursos no AEM exigem etapas adicionais após a atualização. Uma lista completa desses recursos e etapas para migrá-los no AEM 6.5 pode ser encontrada na página Código de atualização e Personalizações.

Verifique as configurações de manutenção agendadas

Habilitar coleta de lixo do Data Store

Se estiver usando um Arquivo Data Store, verifique se a tarefa de coleta de lixo do Data Store está ativada e adicionada à lista de manutenção semanal. As instruções estão descritas aqui.

Ativar a Limpeza de Revisão Online

Se estiver usando MongoMK ou o novo formato de segmento TarMK, verifique se a tarefa de limpeza de revisão está ativada e adicionada à lista de manutenção diária. Instruções descritas aqui.

Executar plano de teste

Execute um plano de teste detalhado conforme definido Código de atualização e Personalizações na seção Procedimento de teste.

Ativar Agentes de Replicação

Depois que o ambiente de publicação tiver sido totalmente atualizado e validado, ative os agentes de replicação no Ambiente Autor. Verifique se os agentes podem se conectar às respectivas instâncias de Publicação. Consulte U pgrade Procedure para obter mais detalhes sobre a ordem dos eventos.

Ativar Tarefas Agendadas Personalizadas

Quaisquer trabalhos programados como parte da base de código podem ser ativados neste ponto.

Analisando problemas com a atualização

Esta seção contém alguns cenários de problema que podem ser enfrentados ao longo do procedimento de atualização para o AEM 6.3.

Esses cenários devem ajudar a rastrear a causa básica dos problemas relacionados à atualização e devem ajudar a identificar problemas específicos do projeto ou produto.

Falha na migração do repositório

A migração de dados do CRX2 para o Oak deve ser viável para qualquer cenário que comece com Instâncias de origem com base no CQ 5.4. Certifique-se de seguir exatamente as instruções de atualização neste documento, que incluem a preparação de repository.xml, certificando-se de que nenhum autenticador personalizado foi iniciado via JAAS e que a instância foi verificada quanto a inconsistências antes de iniciar a migração.

Se a migração ainda falhar, você pode descobrir qual é a causa raiz inspecionando o upgrade.log. Se o problema ainda não for conhecido, informe-o ao Suporte ao cliente.

A atualização não foi executada

Antes de iniciar as etapas de preparação, execute a instância source primeiro executando-a com o comando java -jar aem-quickstart.jar. Isso é necessário para garantir que o arquivo quickstart.properties seja gerado corretamente. Se estiver faltando, a atualização não funcionará. Como alternativa, você pode verificar se o arquivo está presente olhando em crx-quickstart/conf na pasta de instalação da instância de origem. Além disso, ao iniciar o AEM para iniciar a atualização, ele deve ser executado com o comando java -jar aem-quickstart.jar. A inicialização a partir de um script de start não irá AEM start no modo de atualização.

Pacotes e pacotes falham ao atualizar

Se os pacotes não forem instalados durante a atualização, os pacotes que eles contêm também não serão atualizados. Essa categoria de problemas costuma ser causada pela configuração incorreta do armazenamento de dados. Eles também serão exibidos como mensagens ERROR e WARN no error.log. Como na maioria desses casos o logon padrão pode falhar, você pode usar o CRXDE diretamente para inspecionar e localizar os problemas de configuração.

Alguns pacotes AEM não estão alternando para o estado ativo

No caso de pacotes que não estão sendo inicializados, verifique se há dependências insatisfeitas.

Caso esse problema esteja presente, mas se baseie em uma instalação de pacote com falha, o que fez com que os pacotes não fossem atualizados, eles serão considerados incompatíveis para a nova versão. Para obter mais informações sobre como solucionar problemas, consulte Pacotes e Pacotes falham ao atualizar acima.

Também é recomendável comparar a lista do pacote de uma nova instância AEM 6.5 com a atualizada para detectar os pacotes que não foram atualizados. Isso fornecerá um escopo mais próximo do que procurar no error.log.

Pacotes personalizados que não alternam para o estado ativo

Caso seus pacotes personalizados não estejam alternando para o estado ativo, é provável que haja um código que não esteja importando a API de alteração. Isso levará, com frequência, a dependências insatisfeitas.

A API que foi removida deve ser marcada como obsoleta em uma das versões anteriores. Você pode encontrar instruções sobre a migração direta do seu código neste aviso de desaprovação. O Adobe visa ao controle de versão semântico, sempre que possível, para que as versões possam indicar alterações de quebra.

Também é melhor verificar se a mudança que causou o problema foi absolutamente necessária e revertê-la, caso não seja. Verifique também se o aumento de versão da exportação do pacote foi aumentado mais do que o necessário, após o controle de versão semântico restrito.

Interface do usuário da plataforma com mau funcionamento

No caso de determinadas funcionalidades da interface que não estão funcionando corretamente após a atualização, verifique se há sobreposições personalizadas da interface. Algumas estruturas podem ter sido alteradas e a sobreposição pode precisar de uma atualização ou está obsoleta.

Em seguida, verifique se há erros do Javascript que podem ser rastreados até extensões adicionadas personalizadas que estão conectadas às bibliotecas do cliente. O mesmo pode se aplicar para CSS personalizado que pode estar causando problemas no layout AEM.

Por fim, verifique se o Javascript não consegue lidar com a configuração correta. Normalmente, isso ocorre com extensões desativadas incorretamente.

Componentes personalizados com mau funcionamento, modelos ou extensões de interface do usuário

Na maioria dos casos, as causas raiz desses problemas são as mesmas dos pacotes que não foram iniciados ou dos pacotes que não estão sendo instalados com a única diferença que o start de problemas ocorre ao usar os componentes pela primeira vez.

A maneira de lidar com códigos personalizados incorretos é primeiro realizar testes de fumaça para identificar a causa. Depois de encontrá-lo, verifique as recomendações nesta seção [link] do artigo para saber como corrigi-las.

Personalizações ausentes em /etc

/apps e /libs são bem manipuladas pela atualização, mas as alterações feitas em /etc talvez precisem ser restauradas manualmente /var/upgrade/PreUpgradeBackup após a atualização. Verifique se há algum conteúdo que precise ser unido manualmente neste local.

Analisando error.log e upgrade.log

Na maioria das situações, os registros precisam ser consultados em busca de erros para encontrar a causa de um problema. No entanto, no caso de atualizações, também é necessário monitorar problemas de dependência, já que os pacotes antigos podem não ser atualizados corretamente.

A melhor maneira de fazer isso é eliminar o error.log, removendo todas as mensagens que devem não estar relacionadas ao problema que você está enfrentando. Você pode fazer isso por meio de uma ferramenta como grep, usando:

grep -v UnrelatedErrorString

Algumas mensagens de erro podem não ser explicativas imediatamente. Nesse caso, observar o contexto em que ocorrem também pode ajudar a entender onde o erro foi criado. Você pode separar o erro usando:

• grep -B para adicionar linhas antes do erro;

ou

• grep -A para adicionar linhas depois.

Em alguns casos, também é possível encontrar mensagens WARN, pois pode haver casos válidos que levam a esse estado e o aplicativo nem sempre é capaz de decidir se esse é um erro real. Consulte também essas mensagens.

Entrando em contato com o suporte ao Adobe

Se você tiver seguido os conselhos desta página e ainda estiver vendo problemas, entre em contato com o Suporte ao Adobe. Para fornecer o máximo de informações possível ao engenheiro de suporte que trabalha em seu caso, certifique-se de incluir o arquivo upgrade.log da sua atualização.