Esta página descreve o procedimento de atualização do AEM 6.4. Se você tiver uma instalação implantada em um servidor de aplicativos, consulte Etapas de atualização para instalações do servidor de aplicativos.
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.
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.
Pare a instância se ela estiver sendo executada.
Baixe o novo arquivo jar AEM e use-o para substituir o arquivo antigo fora da pasta crx-quickstart
.
Desembale o novo boião de início rápido executando:
java -Xmx4096m -jar aem-quickstart.jar -unpack
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.
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ê pode remover o modo de execução <a0/>dele, 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>>
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.
Embora FileDataStore
seja o novo padrão para instalações 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 no AEM de atualização, 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.
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.
Se estiver usando S3:
Remova quaisquer frascos abaixo de crx-quickstart/install
associados a uma versão anterior do conector S3.
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/
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
.
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:
Em uma instância AEM em execução, execute o seguinte na linha de comando:
ps -ef | grep java
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
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.
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.
Consulte Verificações e solução de problemas de pós-atualização.