Show Menu
TÓPICOS×

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

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 o AEM tenha sido iniciado com o jar 6.4 e que a base de código atualizada tenha sido implantada.

Verificar registros para o sucesso da atualização

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 com defeito 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 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 mais tarde no log podem ser efeitos colaterais de uma causa raiz que é chamada mais cedo no arquivo. Se ocorrerem erros e avisos repetidos, 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 o para determinar o problema raiz error.log .

Verificar versão do Oak

Após a atualização, você verá que a versão Oak foi atualizada para 1.8.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.

Inspecione a pasta PreUpgradeBackup

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 esta pasta no CRXDE Lite, talvez seja necessário ativar temporariamente o CRXDE Lite .
A pasta com o carimbo de data e hora deve ter uma propriedade nomeada mergeStatus com um valor de COMPLETED . A pasta para processamento 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 que não foi possível mesclar 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 pacote de códigos atualizado), eles precisarão ser unidos manualmente.
Desative o CRXDE Lite após este exercício se estiver em um ambiente de estágio ou de produção.

Validação inicial de páginas

Execute uma validação inicial em várias páginas no AEM. Se você atualizar um ambiente do 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 são renderizados corretamente. Se algum problema ocorrer, consulte o error.log para solucionar o problema.

Aplicar Service Packs do AEM

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

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

Verificar configurações de manutenção programadas

Enable Data Store Garbage Collection

Se estiver usando um Arquivo Data Store, verifique se a tarefa Coleta de lixo do Data Store está ativada e adicionada à lista Manutenção semanal. As instruções estão descritas aqui .
Isso não é recomendado para instalações personalizadas de armazenamento de dados S3 ou ao usar um armazenamento de dados compartilhado.

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 Manutenção diária. Instruções descritas aqui .

Executar plano de teste

Execute um plano de teste detalhado conforme definido em 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 de criação. 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.

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 durante o procedimento de atualização para o AEM 6.4.
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.

Recriando a configuração da Dynamic Media Cloud após a atualização

Depois de atualizar para o AEM 6.4 de uma versão anterior, a Configuração da Dynamic Media Cloud de configurações anteriores pode ficar inacessível na interface do usuário do AEM 6.4 TouchUI. 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 a reestruturação do repositório do Dynamic Media no AEM 6.4 .

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 do repository.xml , certificando-se de que nenhum autenticador personalizado foi iniciado via JAAS e de 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 principal inspecionando a 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 de origem 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 baixo 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 inicialização não iniciará o AEM 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 de 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 na atualização 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 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. A Adobe visa ao controle de versão semântico onde 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 de 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 do 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, modelos ou extensões de interface do usuário que funcionam mal

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 nesta seção de # 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 em /etc podem precisar 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 o error.log e o 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 usando 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.

Entrar em contato com o suporte da Adobe

Se você tiver seguido as recomendações desta página e ainda estiver vendo problemas, entre em contato com o Suporte da 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.