DocumentaçãoAEM 6.5 LTSGuia do usuário

Execução de uma atualização no local performing-an-in-place-upgrade

Last update: Wed May 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Aplica-se a:
  • Experience Manager 6.5 LTS
  • Tópicos:

Criado para:

  • Administrador
NOTE
Esta página descreve o procedimento de atualização no local do AEM 6.5 LTS. Se você tiver uma instalação implantada em um servidor de aplicativos, consulte Etapas de Atualização para Instalações do Servidor de Aplicativos.

Etapas de pré-atualização pre-upgrade-steps

Antes de executar a atualização, há várias etapas que devem ser concluídas. Consulte Atualizando Código e Personalizações e Tarefas de Manutenção de Pré-Atualização para obter mais informações. Além disso, verifique se o seu sistema atende aos requisitos do AEM 6.5 LTS e veja as considerações de planejamento de atualização e como o Analyzer pode ajudá-lo a estimar a complexidade.

Pré-requisitos de migração migration-prerequisites

  • Versão mínima do Java necessária: verifique se o Java™ 17/21 da Oracle está instalado no sistema.

Preparação do arquivo jar do AEM Quickstart prep-quickstart-file

  1. Baixe o novo arquivo jar do AEM 6.5 LTS

  2. Determine o comando de início de atualização correto

  3. Pare a instância se ela estiver em execução

  4. Use o novo jar do AEM 6.5 LTS para substituir o antigo fora da pasta crx-quickstart

  5. Faça um backup do arquivo sling.properties (geralmente presente no crx-quickstart/conf/) e exclua-o

  6. Descompacte o novo jar de início rápido executando:

    code language-shell 
    java -Xmx4096m -jar aem-quickstart.jar -unpack

  7. Se o sling.properties personalizado precisar ser aplicado, crie uma nova instância do AEM local e recupere o arquivo sling.properties do diretório crx-quickstart/conf. Aplique as alterações personalizadas necessárias a esse arquivo e copie-o no diretório crx-quickstart/conf da instância do AEM que está sendo atualizada. Se não houver propriedades personalizadas, esta etapa poderá ser ignorada.

Execução Da Atualização performing-the-upgrade

Se estiver usando S3:

  1. Remova os jars abaixo de crx-quickstart/install associados a uma versão anterior do conector S3.

  2. Baixe a versão mais recente do conector S3 1.60.2 de https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/

  3. Extraia o conector S3 (versão 1.60.2) e copie o conteúdo das seguintes pastas em crx-quickstart/install, da seguinte maneira:

    1. Copiar com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/1 em crx-quickstart/install/1
    2. Copiar com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/15 em crx-quickstart/install/15

Agora, inicie a instância do AEM usando o novo comando determinado usando as informações na seção Determinando o comando de início de atualização correto.

Determinando o comando de início de atualização correto determining-the-correct-upgrade-start-command

NOTE
O suporte para alguns argumentos do Java 8/11 foi removido no Java 17/21, consulte documentos do Oracle Java™ 17, documentos do Oracle Java™ 21 e Considerações de argumentos Java&trade para o AEM 6.5 LTS.

Para executar a atualização, é importante iniciar o AEM usando o arquivo jar para ativar a instância.

Observe que iniciar o AEM a partir do script de inicialização não iniciará a atualização. A maioria dos clientes inicia o AEM usando o script de inicialização e personaliza esse script de inicialização para incluir switches para configurações de ambiente, como configurações de memória, certificados de segurança etc. Por esse motivo, a Adobe recomenda seguir esse procedimento para determinar o comando de atualização adequado:

  1. Em uma instância do AEM em execução, execute o seguinte a partir da linha de comando:

    code language-shell 
    ps -ef | grep java

  2. Procure o processo do AEM. Será semelhante a:

    code language-shell 
    /usr/bin/java -server -Xmx1024m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.5.0-standalone-quickstart.jar start -c crx-quickstart -i launchpad -p 4502 -Dsling.properties=conf/sling.properties

  3. Modifique o comando substituindo o caminho para o jar existente ( crx-quickstart/app/aem-quickstart*.jar neste caso) pelo novo jar do AEM 6.5 LTS que é irmão da pasta crx-quickstart. Usando nosso comando anterior como exemplo, nosso comando seria:

    code language-shell 
    /usr/bin/java -server -Xmx4096m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar <AEM-6.5-LTS.jar> -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties

    Isso garantirá que todas as configurações apropriadas de memória, modos de execução personalizados e outros parâmetros ambientais sejam aplicados para a atualização. Após a conclusão da atualização, a instância poderá ser iniciada a partir do script de inicialização em inicializações futuras.

Implantar Base De Código Atualizada deploy-upgraded-codebase

Depois que o processo de atualização no local for concluído, a base de código atualizada deverá ser implantada. As etapas para atualizar a base de código para funcionar na versão de destino do AEM podem ser encontradas na página Atualizar Código e Personalizações.

Executar Verificações Pós-Upgrade e Solução de Problemas perform-post-upgrade-check-troubleshooting

Consulte Solução de problemas e verificações pós-atualização.

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2