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

Etapas de pré-atualização

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 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 de sua atualização e também consulte a seção Escopo e requisitos de atualização de Planejando sua atualização 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 AEM 6.3 e superior, o Oracle JRE 8 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 a 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

1. Pare a instância se ela estiver sendo executada.

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

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, o 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 de ambientes que usam MongoMK não exigem migração de repositório. Para obter mais informações sobre os benefícios do novo formato de barra de segmentos, consulte Migração para Oak Segment Tar FAQ.

A migração real é realizada usando o arquivo jar AEM quickstart padrão, executado com uma nova opção -x crx2oak 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>>

Em que <<YOUR_PROFILE>> e <<ADDITIONAL_FLAGS>> são substituídos pelo perfil e sinalizadores listados na tabela a seguir:

Repositório de origem	Repositório de públicos alvos	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 parâmetro --disable-mmap ao comando.

• Se você estiver usando o Java 7, adicione o parâmetro -XX:MaxPermSize=2048m logo após o parâmetro -Xmx.

Para obter instruções adicionais sobre como usar a ferramenta crx2oak, consulte Usar a 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 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 WARN e ERROR no arquivo upgrade.log, localizado em crx-quickstart/logs no diretório de instalação AEM, pois isso pode 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, ela será atualizada para refletir o repositório do público alvo.

Solução de problemas de migração

Ignore esta seção se estiver atualizando da 6.3. Embora os perfis 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 no primeiro start. 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 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

Em que /path/to/datastore representa o caminho para o armazenamento de dados do arquivo.

Realização Da Atualização

Se estiver usando S3:

1. Remova quaisquer frascos 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.8.x de https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/com.adobe.granite.oak.s3connector/

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

Determinando o comando correto do start de atualização

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

Observe que iniciar AEM a partir do script de start não start a atualização. A maioria dos clientes AEM usando o script de start e personalizou esse script de start 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 AEM em execução, execute o seguinte na linha de comando:

   ps -ef | grep java
   

2. Procure o processo de 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 neste caso) pelo novo jar que é um irmão da pasta crx-quickstart. 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.4.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. Após a conclusão da atualização, a instância pode ser iniciada a partir do script do start em inicializações futuras.

Implantar base de códigos atualizada

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 público alvo do AEM podem ser encontradas na página Código de atualização e Personalizações.

Execute verificações e solução de problemas pós-atualização

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