Show Menu
TÓPICOS×

Execução de uma atualização no local

Esta página descreve o procedimento de atualização do AEM 6.5. 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

Antes de executar a atualização, há várias etapas que devem ser concluídas. Consulte Atualização de código e personalizações e Tarefas de manutenção pré-atualização para obter mais informações. Além disso, verifique se o sistema atende aos requisitos para a nova versão do AEM. Veja como o Detector de padrões pode ajudá-lo a estimar a complexidade da atualização e também consulte a seção Escopo e requisitos de atualização do Planning Your Upgrade para obter mais informações.

Pré-requisitos de migração

  • Versão mínima necessária do Java: A ferramenta de migração só funciona com versões 7 e posteriores do Java. Observe que para o AEM 6.3 e versões posteriores, o JRE 8 da Oracle e o JRE 7 e 8 da IBM são as únicas versões compatíveis.
  • Instância atualizada: Se você estiver atualizando de uma versão anterior à 5.6 , certifique-se de ter realizado uma atualização no local para o AEM 6.0 seguindo o procedimento descrito na versão 6.0 da documentação de Atualização.

Preparação do arquivo jar do Quickstart do AEM

  1. Pare a instância se ela estiver sendo executada.
  2. Baixe o novo arquivo jar do AEM e use-o para substituir o arquivo antigo fora da crx-quickstart pasta.
  3. Desembale o novo boião de início rápido executando:
    java -Xmx4096m -jar aem-quickstart.jar -unpack
    
    

Migração do repositório de conteúdo

Essa migração não é necessária se você estiver atualizando do AEM 6.3. Para versões anteriores à 6.3, a Adobe fornece uma ferramenta que pode ser usada para migrar o repositório para a nova versão da barra de segmentos Oak presente no AEM 6.3. Ele é fornecido como parte do pacote de início rápido e é obrigatório para qualquer atualização que esteja usando o TarMK. As atualizações para ambientes que estejam usando o MongoMK não exigem a migração do repositório. For more information on what the benefits of the new Segment Tar format are, see the Migrating to Oak Segment Tar FAQ .
A migração real é realizada usando o arquivo jar de início rápido padrão do AEM, executado com uma nova -x crx2oak opção que executa a ferramenta crx2oak para simplificar a atualização e torná-la mais robusta.
Se você estiver executando a migração de conteúdo do repositório TarMK usando a extensão de Início Rápido CRX2Oak, você poderá remover o modo de execução de conteúdo de amostra adicionando o seguinte à linha de comando de migração:
  • --promote-runmode nosamplecontent
Para determinar o comando que deve ser executado, use o seguinte comando:
java -Xmx4096m -jar aem-quickstart.jar -v -x crx2oak -xargs -- --load-profile <<YOUR_PROFILE>> <<ADDITIONAL_FLAGS>>

Onde <<YOUR_PROFILE>> e <<ADDITIONAL_FLAGS>> forem substituídos pelo perfil e sinalizadores listados na tabela a seguir:
Repositório de origem Repositório do Target Perfil Sinalizadores adicionais
crx2 ou TarMK com FileDataStore TarMK segment-fds Consulte a seção Solução de problemas abaixo
crx2 MongoMK mongo-from-crx2 -T mongo-uri=mongo://mongo-host:mongo-port -T mongo-db=mongo-database-name
TarMK ou crx2 com S3DataStore TarMK segment-custom-ds Consulte a seção Solução de problemas abaixo
TarMK sem armazenamento de dados TarMK segment-no-ds
MongoMK MongoMK Nenhuma migração é necessária
Em que:
  • mongo-host é o IP do servidor MongoDB (por exemplo, 127.0.0.1)
  • mongo-port é a porta do servidor MongoDB (por exemplo: maio de 2017)
  • mongo-database-name representa o nome do banco de dados (por exemplo: aem-author)
Você também pode exigir switches adicionais para as seguintes situações:
  • Se você estiver executando a atualização em um sistema Windows em que o mapeamento da memória Java não é manipulado corretamente, adicione o --disable-mmap parâmetro ao comando.
  • Se você estiver usando o Java 7, adicione o -XX:MaxPermSize=2048m parâmetro logo após o -Xmx parâmetro.
Para obter instruções adicionais sobre como usar a ferramenta crx2oak, consulte Uso da ferramenta de migração CRX2Oak. O JAR auxiliar do crx2oak pode ser atualizado manualmente se necessário, substituindo-o manualmente por versões mais recentes depois de desempacotar o início rápido. Sua localização na pasta de instalação do AEM é: <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar . A versão mais recente da ferramenta de migração CRX2Oak está disponível para download no Adobe Repository em: https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/
Se a migração tiver sido concluída com êxito, a ferramenta sairá com um código de saída zero. Além disso, verifique se há mensagens WARN e ERROR no upgrade.log arquivo, localizado crx-quickstart/logs no diretório de instalação do AEM, pois isso pode indicar erros não fatais que ocorreram durante a migração.
Verifique os arquivos de configuração abaixo da crx-quickstart/install pasta. Se uma migração for necessária, ela será atualizada para refletir o repositório de destino.
Uma observação sobre os armazenamentos de dados:
Embora FileDataStore seja o novo padrão para instalações do AEM 6.3, não é necessário usar um armazenamento de dados externo. Embora o uso de um armazenamento de dados externo seja recomendado como uma prática recomendada para implantações de produção, não é um pré-requisito para a atualização. Devido à complexidade já presente na atualização do AEM, recomendamos executar a atualização sem fazer uma migração de armazenamento de dados. Se desejar, uma migração de armazenamento de dados pode ser executada posteriormente como um esforço separado.

Solução de problemas de migração

Ignore esta seção se estiver atualizando da 6.3. Embora os perfis de crx2oak fornecidos devam atender às necessidades da maioria dos clientes, há momentos em que parâmetros adicionais serão necessários. Se você encontrar um erro durante a migração, é possível que haja aspectos do seu ambiente que exijam opções de configuração adicionais. Em caso afirmativo, você provavelmente encontrará o seguinte erro:
Os pontos de verificação não serão copiados porque nenhum armazenamento de dados externo foi especificado. Isso resultará na reindexação completa do repositório na primeira inicialização. Use —ignore os pontos de verificação para forçar a migração ou consulte https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration para obter mais informações.
Por algum motivo, o processo de migração precisa acessar binários no armazenamento de dados e não consegue encontrá-lo. Para especificar a configuração do armazenamento de dados, inclua os seguintes sinalizadores na parte <<ADDITIONAL_FLAGS>> do comando de migração:
Para armazenamentos de dados S3:
--src-s3config=/path/to/SharedS3DataStore.config --src-s3datastore=/path/to/datastore

Onde /path/to/SharedS3DataStore.config representa o caminho para o arquivo de configuração do armazenamento de dados S3 e /path/to/datastore representa o caminho para o armazenamento de dados S3.
Para armazenamentos de dados de arquivo:
--src-datastore=/path/to/datastore

Onde /path/to/datastore representa o caminho para seu Arquivo de Dados.

Execução Da Atualização

Se estiver usando S3:
  1. Remova quaisquer frascos abaixo crx-quickstart/install associados a uma versão anterior do conector S3.
  2. Extraia o pacote para uma pasta temporária e copie o conteúdo do jcr_root/libs/system/install para a crx-quickstart/install pasta.

Determinando o comando correto de inicialização da atualização

Para executar a atualização, é importante iniciar o AEM usando o arquivo jar para exibir a instância. Para atualizar para a versão 6.5, veja também outras opções de reestruturação e migração de conteúdo na Migração de conteúdo ocioso que você pode escolher com o comando de atualização.
Observe que iniciar o AEM a partir do script inicial não iniciará a atualização. A maioria dos clientes inicia o AEM usando o script de início e personalizou esse script para incluir switches para configurações de ambiente, como configurações de memória, certificados de segurança etc. Por isso, recomendamos seguir este procedimento para determinar o comando de atualização correto:
  1. Em uma instância do AEM em execução, execute o seguinte na linha de comando:
    ps -ef | grep java
    
    
  2. Procure o processo do AEM. Será algo como:
    /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.2.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 nesse caso) pelo novo jar que é um irmão da crx-quickstart pasta. Usando nosso comando anterior como exemplo, nosso comando seria:
    /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar cq-quickstart-6.5.0.jar -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties
    
    
    Isso garantirá que todas as configurações de memória, modos de execução personalizados e outros parâmetros ambientais sejam aplicados para a atualização. Depois que a atualização for concluída, a instância poderá ser iniciada a partir do script de inicialização em inicializações futuras.

Implantar base de códigos atualizada

Quando 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 Código de atualização e Personalizações.

Execute verificações e solução de problemas após a atualização

Consulte Verificação e solução de problemas da pós-atualização .