Execução de uma atualização no local performing-an-in-place-upgrade

NOTE
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 pre-upgrade-steps

Antes de executar a atualização, há várias etapas que devem ser concluídas. Consulte Atualizando Código e Personalizações e Tarefas de Manutenção de Pré-Atualização para obter mais informações. Além disso, verifique se o seu sistema atende aos requisitos da nova versão do AEM. Veja como o Detector de Padrões pode ajudá-lo a estimar a complexidade de sua atualização. Veja também a seção Escopo e Requisitos de Atualização do Planejando sua Atualização para obter mais informações.

Pré-requisitos de migração migration-prerequisites

  • Versão mínima do Java necessária: a ferramenta de migração funciona somente com o Java versão 7 ou superior. Observe que para AEM 6.3 e superior, o JRE 8 do Oracle e o JRE 7 e 8 da IBM são as únicas versões compatíveis.

  • Instância Atualizada Se estiver atualizando de uma versão anterior à 5.6, verifique se você executou uma atualização in-loco para AEM 6.0 seguindo o procedimento descrito na versão 6.0 da documentação de Atualização.

Preparação do arquivo jar AEM Quickstart prep-quickstart-file

  1. Pare a instância se ela estiver em execução.

  2. Baixe o novo arquivo jar AEM e use-o para substituir o antigo fora da pasta crx-quickstart.

  3. Descompacte o novo jar de início rápido executando:

    code language-shell
    java -Xmx4096m -jar aem-quickstart.jar -unpack
    

Migração do repositório de conteúdo content-repository-migration

Essa migração não é necessária se você estiver atualizando a partir do AEM 6.3. Para versões anteriores à 6.3, o Adobe fornece uma ferramenta que pode ser usada para migrar o repositório para a nova versão do Oak Segment Tar presente no AEM 6.3. Ele é fornecido como parte do pacote de início rápido e é obrigatório para todos os upgrades que usarão TarMK. As atualizações para ambientes que usam MongoMK não exigem migração de repositório. Para obter mais informações sobre quais são os benefícios do novo formato do Segment Tar, consulte as Perguntas frequentes sobre a migração para o Oak Segment Tar.

A migração real é realizada usando o arquivo jar padrão AEM quickstart, executado com uma nova opção -x crx2oak que executa a ferramenta crx2oak para simplificar a atualização e torná-la mais robusta.

NOTE
Se você estiver executando a migração de conteúdo do repositório TarMK usando a extensão Quickstart do CRX2Oak, poderá remover o modo de execução samplecontent 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>> são substituídos pelo perfil e pelos sinalizadores listados na tabela a seguir:

Repositório do Source
Repositório de destino
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

Onde:

  • mongo-host é o IP do servidor MongoDB (por exemplo, 127.0.0.1)

  • mongo-port é a porta do servidor MongoDB (por exemplo: 27017)

  • mongo-database-name representa o nome do banco de dados (por exemplo: aem-author)

Você também pode precisar de opções adicionais para os seguintes cenários:

  • Se você estiver executando a atualização em um sistema Windows em que o mapeamento da memória Java não é tratado corretamente, adicione o parâmetro --disable-mmap ao comando.

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 descompactar o quickstart. Seu local 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 Repositório Adobe em: https://repo1.maven.org/maven2/com/adobe/granite/crx2oak/

Se a migração for concluída com êxito, a ferramenta será encerrada com um código de saída zero. Além disso, verifique se há mensagens de AVISO e ERRO no arquivo upgrade.log, localizado em crx-quickstart/logs no diretório de instalação do AEM, pois elas podem indicar erros não fatais que ocorreram durante a migração.

Verifique os arquivos de configuração abaixo da pasta crx-quickstart/install. Se uma migração for necessária, elas serão atualizadas para refletir o repositório de destino.

Uma observação sobre 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, a Adobe recomenda executar a atualização sem fazer uma migração do 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 troubleshooting-migration-issues

Pule esta seção se estiver atualizando do 6.3. Embora os perfis do crx2oak fornecidos devam atender às necessidades da maioria dos clientes, há momentos em que parâmetros adicionais serão necessários. Se ocorrer um erro durante a migração, é possível que existam aspectos do ambiente que exigem a oferta de opções de configuração adicionais. Em caso afirmativo, você provavelmente encontrará o seguinte erro:

Os pontos de verificação não são copiados porque nenhum armazenamento de dados externo foi especificado. Isso resultará na reindexação completa do repositório na primeira inicialização. Use —skip-checkpoints 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 pode encontrá-los. 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 o Armazenamento de Dados de Arquivos.

Execução Da Atualização performing-the-upgrade

Se estiver usando S3:

  1. Remova os jars abaixo de crx-quickstart/install associados a uma versão anterior do conector S3.

  2. Baixe a versão mais recente do conector S3 1.10.x de https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/

  3. Extrair o pacote para uma pasta temporária e copiar o conteúdo de jcr_root/libs/system/install para a pasta crx-quickstart/install.

Determinando o comando de início de atualização correto determining-the-correct-upgrade-start-command

Para executar a atualização, é importante iniciar o AEM usando o arquivo jar para ativar a instância. Para atualizar para a versão 6.5, consulte outras opções de reestruturação e migração de conteúdo em Migração de conteúdo lenta que você pode escolher com o comando de atualização.

IMPORTANT
Se você estiver executando o Oracle Java 11 (ou versões do Java mais recentes que 8), é necessário adicionar opções adicionais à linha de comando ao iniciar o AEM. Para obter mais informações, consulte Considerações sobre o Java 11.

Observe que iniciar o AEM a partir do script de inicialização não iniciará a atualização. A maioria dos clientes inicia o AEM usando o script de inicialização e personaliza esse script de inicialização para incluir switches para configurações de ambiente, como configurações de memória, certificados de segurança etc. Por esse motivo, a Adobe recomenda seguir esse procedimento para determinar o comando de atualização adequado:

  1. Em uma instância do AEM em execução, execute o seguinte a partir da linha de comando:

    code language-shell
    ps -ef | grep java
    
  2. Procure o processo de AEM. Será semelhante a:

    code language-shell
    /usr/bin/java -server -Xmx1024m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.5.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 neste caso) pelo novo jar que é irmão da pasta crx-quickstart. Usando nosso comando anterior como exemplo, nosso comando seria:

    code language-shell
    /usr/bin/java -server -Xmx1024m -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 apropriadas de memória, modos de execução personalizados e outros parâmetros ambientais sejam aplicados para a atualização. Após a conclusão da atualização, a instância poderá ser iniciada a partir do script de inicialização em inicializações futuras.

Implantar Base De Código Atualizada deploy-upgraded-codebase

Depois que 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 Atualizar Código e Personalizações.

Executar verificações de atualização e solução de problemas do Post perform-post-upgrade-check-troubleshooting

Consulte Verificações de Atualização e Solução de Problemas do Post.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2