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 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 AEM 6.3 e superior, 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 a AEM 6.0 seguindo o procedimento descrito na versão 6.0 da documentação de Atualização.

Preparação do ficheiro jar AEM Quickstart

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

2. Baixe o novo arquivo AEM jar 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, 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. 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 AEM quickstart padrão, executado com uma nova -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>>

Em que <<YOUR_PROFILE>> e <<ADDITIONAL_FLAGS>> são substituídos pelo perfil e pelos 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 --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çãoCRX2Oak. 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 upgrade.log arquivo, localizado 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 crx-quickstart/install pasta. 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 —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. Baixe a versão mais recente do conector S3 1.8.x em 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 do jcr_root/libs/system/install para a crx-quickstart/install pasta.

Como determinar 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 na Migração de conteúdo ocioso 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 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.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 a 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 deatualizaçã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.