Falha na instalação e atualização do AEM Dispatcher devido à incompatibilidade de sistema operacional ou dependência

A instalação ou atualização do Adobe Experience Manager (AEM) Dispatcher falha quando o Apache não é iniciado, os módulos não são carregados ou as dependências não correspondem após as atualizações de sistema operacional, OpenSSL ou arquitetura. Esse problema ocorre devido a binários incompatíveis do Dispatcher com bibliotecas de sistema, seleção incorreta de módulo ou arquitetura não compatível durante atualizações de ambiente. Para resolver o problema, selecione o binário correto, valide as dependências e alinhe a configuração.

Descrição description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problema/Sintomas

  • O Apache não é iniciado após uma atualização devido à falta de dependências libssl ou libcrypto.
  • O módulo Dispatcher não carrega ou carrega incorretamente devido à arquitetura incompatível.
  • O ambiente mostra erros ao migrar entre versões OpenSSL, como 1.1 para 3.0.
  • O sistema mostra incerteza ou incompatibilidade para versões do sistema operacional compatíveis, como RHEL 8, RHEL 9 ou Amazon Linux 2023.

Causa raiz

O problema ocorre quando o módulo Dispatcher não corresponde ao ambiente do sistema, pois depende de uma arquitetura CPU específica, versão OpenSSL, build do Apache e bibliotecas no nível do SO. Quando o ambiente é atualizado ou alterado, o módulo existente não é carregado devido a incompatibilidades de dependência, seleção binária incorreta ou arquitetura não compatível, como o ARM64 em versões mais antigas.

Resolução resolution

Siga estas etapas para identificar o ambiente e instalar um módulo Dispatcher compatível.

  1. Identifique o ambiente operacional verificando o SO, o Apache, a arquitetura do CPU e as versões OpenSSL usando comandos do sistema.
  2. Determine o pacote correto do Dispatcher selecionando binários com base na versão, SO e arquitetura OpenSSL, como ssl1.1, ssl3.0 ou versões compatíveis com ARM64.
  3. Baixe e extraia o pacote do Dispatcher no servidor e confirme se o arquivo do módulo está disponível após a extração.
  4. Copie o arquivo do módulo Dispatcher para o diretório Apache modules e verifique se o arquivo existe no local correto.
  5. Atualize a configuração do Apache adicionando a diretiva LoadModule do Dispatcher com o caminho de módulo correto.
  6. Valide as dependências do módulo verificando se todas as bibliotecas necessárias estão presentes e correspondem à versão do OpenSSL.
  7. Reinicie o Apache e confirme se o módulo Dispatcher é carregado com êxito sem erros de inicialização.
  8. Limpe o cache do Dispatcher após as atualizações para garantir que novos ativos sejam carregados corretamente e evitar problemas de conteúdo obsoleto.
  9. Valide a resolução executando verificações de configuração, verificando logs, enviando solicitações de teste e confirmando o comportamento bem-sucedido de inicialização e cache do módulo.

Quando escalonar

  • O serviço Apache não é iniciado mesmo após resolver dependências e problemas de configuração.
  • O módulo do Dispatcher é carregado, mas ainda mostra erros de dependência ou compatibilidade.
  • O pacote Dispatcher necessário não existe para o sistema operacional ou a arquitetura de destino.
  • O ambiente requer configurações não compatíveis, como versões mais antigas do Dispatcher para ARM64.

Leitura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles