Etapas de atualização para instalações do servidor de aplicativos

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 Tomcat como o Servidor de Aplicativos e implicam que você tem uma versão funcional do AEM já implantada. O procedimento destina-se a documentar atualizações realizadas de AEM versão 6.4 para 6.5.

1. Primeiro, comece o Tom Cat. Na maioria das situações, é possível fazer isso executando o script de inicialização ./catalina.sh iniciando ao executar esse comando a partir do terminal:

   $CATALINA_HOME/bin/catalina.sh start
   

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

   https://<serveraddress:port>/cq/system/console/bundles
   

3. Em seguida, desimplante o AEM 6.4. Isso pode ser feito no Gerenciador de aplicativos do TomCat (http://serveraddress:serverport/manager/html)

4. Agora, migre o repositório usando a ferramenta de migração crx2oak. Para fazer isso, baixe a versão mais recente do crx2oak de this location.

   SLING_HOME= $AEM-HOME/crx-quickstart java -Xmx4096m -XX:MaxPermSize=2048M -jar crx2oak.jar --load-profile segment-fds
   

5. 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

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

   • A pasta launchpad/startup. 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

   • Remova sling.options.file executando: find crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf

7. Agora, crie o armazenamento de nó e o armazenamento de dados que serão usados com o AEM 6.5. 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.

8. 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:

     path=./crx-quickstart/repository/datastore
     minRecordLength=4096
     

9. Agora é necessário alterar os modos de execução no arquivo war AEM 6.5. Para fazer isso, primeiro crie uma pasta temporária que estará hospedando a guerra AEM 6.5. 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:

   jar xvf aem-quickstart-6.5.0.war
   

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

    <param-value >author</param-value>
    

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

    <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>
    

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

    jar cvf aem65.war
    

13. Finalmente, implante o novo arquivo de guerra em TomCat.