Verificação e solução de problemas da pós-atualização post-upgrade-checks-and-troubleshooting

Verificações da pós-atualização post-upgrade-checks

Seguindo Atualização no local as atividades a seguir devem ser executadas para finalizar a atualização. Pressupõe-se que AEM tenha sido iniciado com o jar 6.4 e que a base de código atualizada tenha sido implantada.

Verificar logs para o sucesso da atualização verify-logs-for-upgrade-success

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 a barra de lançamento. Gerar um relatório pós-atualização pode ajudar a detectar atualizações com defeito antes de entrar em funcionamento.

A principal finalidade desse recurso é reduzir a necessidade de interpretação manual ou 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:

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

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 a inicialização do AEM usando o jar da versão de destino. Quaisquer avisos ou erros devem ser revisados. Em geral, é melhor procurar problemas no início do log. Os erros que ocorrem posteriormente no log podem ser efeitos colaterais de uma causa raiz que é chamada precocemente no arquivo . Se ocorrerem erros e avisos repetidos, consulte abaixo para Analisando problemas com a atualização.

Verificar pacotes OSGi verify-osgi-bundles

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

Verificar a versão do Oak verify-oak-version

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

Pasta Inspect PreUpgradeBackup inspect-preupgradebackup-folder

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

A pasta com o carimbo de data e hora deve ter uma propriedade chamada mergeStatus com um valor de COMPLETED. O para processar deve estar vazia e a pasta substituído indica quais nós foram substituídos durante a atualização. Conteúdo abaixo do sobras nó indica o conteúdo que não pôde ser mesclado com segurança durante a atualização. Se sua implementação depender de qualquer um dos nós secundários (e ainda não estiver instalada pelo seu pacote de códigos atualizado), eles precisarão ser mesclados manualmente.

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

Validação inicial de páginas initial-validation-of-pages

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

Aplicar AEM Service Packs apply-aem-service-packs

Aplique todos os Service Packs relevantes do AEM 6.4 se tiverem sido lançados.

Migrar recursos AEM migrate-aem-features

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.4 pode ser encontrada no Atualização de código e personalizações página.

Verificar configurações de manutenção programadas verify-scheduled-maintenance-configurations

Habilitar coleta de lixo do armazenamento de dados enable-data-store-garbage-collection

Se estiver usando um Armazenamento de dados de arquivo, verifique se a tarefa Coleta de lixo do armazenamento de dados está habilitada e adicionada à lista Manutenção semanal . As instruções são descritas here.

Ativar Limpeza de Revisão Online enable-online-revision-cleanup

Se estiver usando o MongoMK ou o novo formato de segmento TarMK, certifique-se de que a tarefa Revisão de limpeza esteja habilitada e adicionada à lista Manutenção diária. Instruções descritas here.

Executar plano de teste execute-test-plan

Executar plano de teste detalhado em função da definição Atualização de código e personalizações nos termos do Procedimento de teste seção.

Ativar Agentes de Replicação enable-replication-agents

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

Habilitar trabalhos agendados personalizados enable-custom-scheduled-jobs

Quaisquer tarefas programadas como parte da base de código podem ser ativadas neste ponto.

Analisando Problemas Com A Atualização analyzing-issues-with-upgrade

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.4.

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

Recriar a configuração da Dynamic Media Cloud após a atualização dynamic-media-cloud-configuration

Após a atualização para o AEM 6.4 de uma versão anterior, a configuração da Dynamic Media Cloud das configurações anteriores pode se tornar inacessível a partir da interface de toque do AEM 6.4. Para resolver esse problema, use o CRXDE Lite para remover as configurações anteriores e crie uma nova Configuração da Dynamic Media Cloud. Consulte também Restruturação do repositório Dynamic Media no AEM 6.4.

Falha na Migração do Repositório repository-migration-failing-

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 da repository.xml, certificando-se de que nenhum autenticador personalizado personalizado seja iniciado via JAAS e que a instância tenha sido verificada em busca de inconsistências antes de iniciar a migração.

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

A atualização não foi executada the-upgrade-did-not-run

Antes de iniciar as etapas de preparação, execute o 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 pesquisando 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 início não iniciará AEM no modo de atualização.

Pacotes e pacotes não são atualizados packages-and-bundles-fail-to-update-

Caso ocorra falha na instalação dos pacotes durante a atualização, os pacotes que eles contêm também não serão atualizados. Normalmente, essa categoria de problemas é causada por erros de configuração do armazenamento de dados. Eles também aparecerão como ERRO e AVISO mensagens no error.log. Como na maioria desses casos o logon padrão pode falhar, você pode usar o CRXDE diretamente para inspecionar e encontrar os problemas de configuração.

Alguns pacotes de AEM não estão alternando para o estado ativo some-aem-bundles-are-not-switching-to-the-active-state

No caso de pacotes que não estão sendo iniciados, você deve verificar se há dependências insatisfeitas.

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

Também é recomendável comparar a lista de pacotes de uma nova instância do AEM 6.4 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 estão alternando para o estado ativo custom-bundles-not-switching-to-the-active-state

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 frequentemente levará 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 descontinuação. O Adobe visa o 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 da 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 que funciona incorretamente malfunctioning-platform-ui

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

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

Finalmente, verifique se há configuração incorreta que o Javascript talvez não consiga lidar. Isso geralmente ocorre com extensões desativadas incorretamente.

Componentes personalizados com mau funcionamento, modelos ou extensões de interface do usuário malfunctioning-custom-components-templates-or-ui-extensions

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 de que os problemas começam a ocorrer 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, examine as recomendações neste [link] seção do artigo para saber como corrigi-las.

Personalizações ausentes em etc missing-customizations-under-etc

/apps e /libs são bem manipuladas pela atualização, mas as alterações em /etc pode ser necessário restaurar manualmente de /var/upgrade/PreUpgradeBackup após a atualização. Certifique-se de verificar este local para qualquer conteúdo que precise ser mesclado manualmente.

Análise do error.log e do upgrade.log analyzing-the-error-log-and-upgrade-log

Na maioria das situações, os registros precisam ser consultados quanto a erros, para encontrar a causa de um problema. No entanto, no caso de atualizações, também é necessário monitorar os problemas de dependência, pois 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 ocorre também pode ajudar a entender onde o erro foi criado. Você pode separar o erro usando:

ou

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

Contato com o suporte da Adobe contacting-adobe-support

Se você tiver passado pelos conselhos nesta página e ainda estiver vendo problemas, entre em contato com o Suporte do Adobe. Para fornecer o máximo possível de informações ao engenheiro de suporte que trabalha no seu caso, inclua o arquivo upgrade.log da sua atualização.