DocumentaçãoAEM 6.4Guia de implementação

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

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Developer
CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Esta seção descreve o procedimento que precisa ser seguido para atualizar AEM para instalações do Servidor de Aplicativos.

Todos os exemplos neste procedimento usam o JBoss como o Servidor de Aplicativos e implicam que você tenha uma versão funcional do AEM já implantada. O procedimento destina-se a documentar as atualizações realizadas a partir de AEM versão 5.6 para 6.3.

  1. Primeiro, inicie o JBoss. Na maioria das situações, é possível fazer isso executando o standalone.sh script de inicialização, executando este comando a partir do terminal:

    code language-shell 
    jboss-install-folder/bin/standalone.sh

  2. Se o AEM 5.6 já estiver implantado, verifique se os pacotes estão funcionando corretamente executando:

    code language-shell 
    wget https://<serveraddress:port>/cq/system/console/bundles

  3. Em seguida, desimplante o AEM 5.6:

    code language-shell 
    rm jboss-install-folder/standalone/deployments/cq.war

  4. Pare o JBoss.

  5. Agora, migre o repositório usando a ferramenta de migração crx2oak:

    code language-shell 
    java -jar crx2oak.jar crx-quickstart/repository/ crx-quickstart/oak-repository
    note note
    NOTE
    Neste exemplo, oak-repository é o diretório temporário onde o repositório recém-convertido residirá. Antes de executar esta etapa, verifique se você tem a versão mais recente do crx2oak.jar.

  6. Exclua as propriedades necessárias no arquivo sling.properties fazendo o seguinte:

    1. Abra o arquivo localizado em crx-quickstart/launchpad/sling.properties

    2. Texto da etapa Remova as seguintes propriedades e salve o arquivo:

      1. sling.installer.dir
      2. felix.cm.dir
      3. granite.product.version
      4. org.osgi.framework.system.packages
      5. osgi-core-packages
      6. osgi-compendium-services
      7. jre-*
      8. sling.run.mode.install.options

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

    • O pasta de inicialização/inicialização. Você pode excluí-lo executando o seguinte comando no terminal: rm -rf crx-quickstart/launchpad/startup
    • O arquivo base.jar: find crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \
    • O Arquivo BootstrapCommandFile_timestamp.txt: rm -f crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt

  8. Copie o armazenamento de segmentos recém-migrado para o local adequado:

    code language-shell 
    mv crx-quickstart/oak-repository/segmentstore crx-quickstart/repository/segmentstore

  9. Copie também o armazenamento de dados:

    code language-shell 
    mv crx-quickstart/repository/repository/datastore crx-quickstart/repository/datastore

  10. Em seguida, é necessário criar a pasta que conterá as configurações do OSGi que serão usadas com a nova instância atualizada. Mais especificamente, uma pasta chamada install precisa ser criada em crx-quickstart.

  11. Agora, crie o armazenamento de nó e o armazenamento de dados que serão usados com o AEM 6.3. Você pode fazer isso criando dois arquivos com os seguintes nomes em crx-quickstart\install:

    • org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.cfg

    • org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.cfg

    Esses dois arquivos configurarão AEM para usar um armazenamento de nó TarMK e um armazenamento de dados File.

  12. Edite os arquivos de configuração para prepará-los para uso. Mais especificamente:

    • Adicione a seguinte linha em org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config:

      customBlobStore=true

    • Em seguida, adicione as seguintes linhas a org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config:

      code language-none 
      path=./crx-quickstart/repository/datastore
 minRecordLength=4096

  13. Remova o modo de execução crx2 executando:

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

  14. Agora é necessário alterar os modos de execução no arquivo war AEM 6.3. Para fazer isso, primeiro crie uma pasta temporária que estará hospedando a guerra AEM 6.3. O nome da pasta neste exemplo será temp. Depois que o arquivo war for copiado, extraia seu conteúdo executando de dentro da pasta temporária:

    code language-shell 
    jar xvf aem-quickstart-6.3.0.war

  15. Depois que o conteúdo tiver sido extraído, vá para a variável WEB-INF e edite a web.xml para alterar os modos de execução. Para localizar o local em que estão definidos no XML, procure a variável sling.run.modes string. Depois de encontrá-lo, altere os modos de execução na próxima linha de código, que por padrão é definida como author:

    code language-shell 
    <param-value >author</param-value>

  16. Altere o valor do autor acima e defina os modos de execução como: author,crx3,crx3tar O bloco final de código deve ter esta aparência:

    code language-none 
    <init-param>
<param-name>sling.run.modes</param-name>
<param-value>author,crx3,crx3tar</param-value>
</init-param>
<load-on-startup>100</load-on-startup>
</servlet>

  17. Recrie o jar com o conteúdo modificado:

    code language-shell 
    jar cvf aem62.war

  18. Finalmente, implante o novo arquivo war:

    code language-shell 
    cp temp/aem62.war jboss-install-folder/standalone/deployments/aem61.war
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56