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.5 e que a base de código atualizada tenha sido implantada.
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.
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.
Após a atualização, você deve ver que a versão do Oak foi atualizada para 1.10.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.
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.
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.
Aplique todos os Service Packs relevantes do AEM 6.5, se tiverem sido lançados.
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 no Atualização de código e personalizações página.
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.
Isso não é recomendado para instalações personalizadas de armazenamento de dados S3 ou ao usar um armazenamento de dados compartilhado.
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 detalhado em função da definição Atualização de código e personalizações nos termos do Procedimento de teste seção.
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. Ver U Procedimento de atualização para obter mais detalhes sobre a ordem dos eventos.
Quaisquer tarefas programadas como parte da base de código podem ser ativadas neste ponto.
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 raiz dos problemas relacionados à atualização e devem ajudar a identificar problemas específicos do projeto ou produto.
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.
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.
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.
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.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
.
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.
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.
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.
/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.
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:
grep -B
para adicionar linhas antes do erro;ou
grep -A
para adicionar linhas depois de.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.
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.