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

Etapas de pré-atualização pre-upgrade-steps

Antes de executar sua 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 de 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 ajudar você a estimar a complexidade de sua atualização e também consulte a seção Escopo e requisitos de atualização de Planejamento da atualização para obter mais informações.

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

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

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

Essa migração não é necessária se você estiver atualizando do AEM 6.3. Para versões anteriores ao 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. Ela é fornecida como parte do pacote de início rápido e é obrigatória para todas as atualizações que usarão 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 Tar de segmento, consulte o Perguntas frequentes sobre a migração para o Oak Segment Tar.

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

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 sinalizadores listados na tabela a seguir:

Em que:

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

Para obter instruções adicionais sobre como usar a ferramenta crx2oak, consulte Uso do 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 após desempacotar o início rápido. Sua localização na pasta de instalação 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 de Adobe 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 AVISO e ERRO na seção upgrade.log arquivo, localizado em crx-quickstart/logs no diretório de instalação AEM, pois isso poderia indicar erros não fatais que ocorreram durante a migração.

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

Solução de problemas de migração troubleshooting-migration-issues

Ignore esta seção se estiver atualizando a partir da versão 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 você encontrar um erro durante a migração, é possível que haja aspectos do seu ambiente que exijam a disponibilização de opções de configuração adicionais. Nesse caso, 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 pode encontrá-los. Para especificar a configuração do armazenamento de dados, inclua os seguintes sinalizadores no <<ADDITIONAL_FLAGS>> parte do seu 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 armazenamento de dados de arquivo.

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

Se estiver usando S3:

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

Para executar a atualização, é importante começar a AEM usando o arquivo jar para trazer a instância para frente. Para atualizar para a versão 6.4, consulte também outras opções de reestruturação e migração de conteúdo em Migração de conteúdo ocioso que você pode escolher com o comando atualizar.

Observe que iniciar AEM a partir do script de início não iniciará a atualização. A maioria dos clientes começa a AEM usando o script de início e personalizou esse script para incluir switches para configurações do 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:

Implantar a 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 em Atualização da página Código e personalizações.

Executar verificações e solução de problemas pós-atualização perform-post-upgrade-check-troubleshooting

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