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 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 atualizações realizadas 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 script de inicialização standalone.sh executando esse comando a partir do terminal:

    jboss-install-folder/bin/standalone.sh

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

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

  3. Em seguida, desimplante o AEM 5.6:

    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:

    java -jar crx2oak.jar crx-quickstart/repository/ crx-quickstart/oak-repository
    OBSERVAÇÃO

    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:

    • 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

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

    mv crx-quickstart/oak-repository/segmentstore crx-quickstart/repository/segmentstore

  9. Copie também o armazenamento de dados:

    mv crx-quickstart/repository/repository/datastore crx-quickstart/repository/datastore

  10. Em seguida, é necessário criar a pasta que conterá as configurações 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 em org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config:

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

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

    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:

    jar xvf aem-quickstart-6.3.0.war

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

  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:

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

    jar cvf aem62.war

  18. Finalmente, implante o novo arquivo war:

    cp temp/aem62.war jboss-install-folder/standalone/deployments/aem61.war

Nesta página