Etapas de atualização para instalações do servidor de aplicativos (WLP) upgrade-steps-for-application-server-installations-wlp

Verifique se você concluiu as etapas de pré-atualização, como fazer backup do servidor AEM 6.5, antes de executar qualquer atividade de atualização

Dependendo dos seus requisitos, escolha um dos seguintes caminhos de atualização:

1. Atualização no Local: se o servidor WLP atual der suporte ao Servlet 6, você poderá executar uma atualização no local e continuar com a etapa 3.
2. Sidegrade: se você preferir uma nova configuração ou se o servidor WLP não oferecer suporte ao Servlet 6, configure uma nova instância do WLP com o AEM 6.5 LTS e migre o conteúdo seguindo o guia AEM 6.5 para AEM 6.5 LTS Content Migration Using Oak-upgrade e pule para a seção Implantar Base de Código Atualizado

Pare a instância do AEM. Normalmente, isso pode ser feito usando este comando:

<path-to-wlp-directory>/bin/server stop server_name

Remova os arquivos e as pastas que não são mais necessários. Os itens que você precisa remover especificamente são:

• O cq-quickstart-65.war da pasta dropins e da pasta expanded geralmente localizados em <path-to-aem-server>/dropins/cq-quickstart-65.war e <path-to-aem-server>/apps/expanded/cq-quickstart-65.war, respectivamente

• A pasta launchpad/startup. Você pode excluí-lo executando o seguinte comando no terminal, supondo que você esteja na pasta do servidor:

  code language-shell
  rm -rf crx-quickstart/launchpad/startup

• O arquivo base.jar. Você pode fazer isso executando os seguintes comandos:

  code language-shell
  find crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \;

• O arquivo BootstrapCommandFile_timestamp.txt:

  code language-shell
  rm -f crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt

• Remova o arquivo sling.options executando:

  code language-shell
  find crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf {} \;

• Remover o arquivo sling.bootstrap.txt:

  code language-shell
  rm -rf crx-quickstart/launchpad/sling_bootstrap.txt

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

Alterar a versão do servlet para 6.0 no arquivo server.xml

Instale o Java 17/Java 21 e verifique se ele está instalado corretamente executando:

java -version

Revise os parâmetros de início do servidor do AEM e atualize os parâmetros de acordo com suas necessidades. Consulte Considerações sobre Java 17/Java 21 para obter mais informações.

Baixe o novo 6.5 LTS WAR e copie-o para a pasta de recados localizada em: /<path-to-aem-server>/dropins/

Iniciar instância do AEM: geralmente pode ser feito usando este comando:

<path-to-wlp-directory>/bin/server start server_name

Caso você tenha alterações personalizadas em sling.properties, siga as instruções abaixo:

1. Parar a instância do AEM executando <path-to-wlp-directory>/bin/server stop server_name
2. Aplicar as alterações personalizadas de sling.properties ao arquivo sling.properties recém-gerado (consultando o arquivo de backup criado na etapa 5)
3. Inicie a instância do AEM. Geralmente, isso pode ser feito executando: <path-to-wlp-directory>/bin/server start server_name