Planejamento da atualização planning-your-upgrade

Visão geral do projeto AEM aem-project-overview

AEM geralmente é usado em implantações de alto impacto que podem atender a milhões de usuários. Na maioria dos casos, há aplicativos personalizados que são implantados nas instâncias, o que aumenta a complexidade. Qualquer esforço de atualização dessa implantação precisa ser feito de forma metódica.

Este guia ajuda a estabelecer metas, fases e resultados claros ao planejar sua atualização. Centra-se na execução e orientações gerais do projeto. Embora forneça uma visão geral das etapas de atualização reais, ela se refere aos recursos técnicos disponíveis, quando adequado. Deve ser utilizado em conjunto com os recursos técnicos disponíveis referidos no documento.

O processo de atualização de AEM precisa de fases de planejamento, análise e execução cuidadosamente manipuladas com os principais resultados finais definidos para cada fase.

Observe que é possível atualizar diretamente de AEM versões 6.0 e até 6.4. Os clientes que executam a 5.6.x e versões inferiores precisam primeiro atualizar para a versão 6.0 ou superior, com a recomendação 6.0(SP3). Além disso, o novo formato OAK Segment Tar é usado agora para o Segment Node Store desde a versão 6.3, e a migração do repositório para esse novo formato é obrigatória mesmo para as versões 6.0, 6.1 e 6.2.

Atualização do escopo e dos requisitos upgrade-scope-requirements

Abaixo você encontrará uma lista de áreas afetadas em um projeto típico de Atualização de AEM:

É importante garantir que você esteja executando um sistema operacional compatível, Java runtime, httpd e versão do Dispatcher. Para obter mais informações, consulte o Página AEM 6.4 Requisitos técnicos. A atualização desses componentes precisará ser contabilizada no plano do projeto e deverá ocorrer antes da atualização do AEM.

Fases do projeto project-phases

Muito trabalho é feito no planejamento e na execução de uma atualização de AEM. A fim de clarificar os diferentes esforços desenvolvidos neste processo, dividimos os exercícios de planeamento e execução em fases distintas. Nas seções abaixo, cada fase resulta em um delivery que geralmente é aproveitado por uma fase futura do projeto.

Planejamento para treinamento de autores planning-for-author-training

Com qualquer nova versão, há possíveis alterações na interface do usuário e nos fluxos de trabalho do usuário que podem ser introduzidas. Além disso, novas versões apresentam novos recursos que podem ser benéficos para a empresa aproveitar. Recomendamos revisar as alterações funcionais que foram introduzidas e organizar um plano para treinar os usuários a aproveitá-las com eficiência.

Novos recursos do AEM 6.4 podem ser encontrados em a seção AEM de adobe.com. Observe todas as alterações nas interfaces do usuário ou nos recursos do produto que são comumente usados em sua organização. Ao examinar os novos recursos, tome nota de qualquer recurso que possa ser útil para sua organização. Depois de analisar o que mudou no AEM 6.4, desenvolva um plano de treinamento para seus autores. Isso pode envolver o aproveitamento de recursos disponíveis gratuitamente, como os vídeos de recursos do helpx ou o treinamento formal oferecido por meio de Serviços de aprendizado digital Adobe.

Criação de um plano de teste creating-a-test-plan

A implementação de AEM de cada cliente é exclusiva e foi personalizada para atender às necessidades de seus negócios. Como resultado, é importante determinar todas as personalizações feitas no sistema para que possam ser incluídas em um plano de teste. Esse plano de teste alimentará o processo de controle de qualidade que executamos na instância atualizada.

O ambiente de produção exato precisa ser duplicado e os testes devem ser executados nele após a atualização para garantir que todos os aplicativos e códigos personalizados ainda sejam executados como desejado. Você precisa recuperar toda a personalização e executar testes de desempenho, carga e segurança. Ao organizar seu plano de teste, certifique-se de cobrir todas as personalizações feitas no sistema, além de IUs e fluxos de trabalho prontos para uso que são aproveitados em suas operações diárias. Eles podem incluir serviços e servlets OSGI personalizados, integrações com a Adobe Marketing Cloud, integrações com terceiros por meio de conectores AEM, integrações personalizadas de terceiros, componentes e modelos personalizados, sobreposições de interface personalizada em AEM e fluxos de trabalho personalizados. Para clientes que migram de uma versão anterior ao AEM 6, quaisquer consultas personalizadas devem ser analisadas, pois elas podem precisar ser indexadas. Para clientes que já estão em uma versão AEM 6.x, essas consultas ainda devem ser testadas para garantir que seus índices continuem a funcionar efetivamente após a atualização.

Determinando as alterações necessárias na arquitetura e na infraestrutura determining-architectural-and-infrastructure-changes-needed

Ao atualizar, é possível que você também precise atualizar outros componentes em sua pilha técnica, como o sistema operacional ou a JVM. Além disso, é possível que, devido a alterações na composição do repositório, seja necessário hardware adicional. Isso geralmente só ocorre para clientes que migram de instâncias anteriores à versão 6.x, mas é importante considerar. Finalmente, pode haver alterações necessárias em suas práticas operacionais, incluindo monitoramento, manutenção e processos de backup e recuperação de desastres.

Revise os Requisitos Técnicos do AEM 6.4 e verifique se o hardware e o software atuais serão suficientes. Para possíveis alterações nos processos operacionais, consulte os seguintes documentos:

Monitorização e manutenção:

Painel de operações

Práticas recomendadas de monitoramento de ativos

Monitorar recursos do servidor usando o console JMX

Limpeza de revisão

Backup/restauração e recuperação de desastres:

Backup e restauração

Desempenho e escalabilidade

Como executar AEM com o TarMK Cold Standby

Considerações sobre a reestruturação de conteúdo content-restructuring-considerations

O AEM 6.4 introduziu alterações na estrutura do repositório que ajudarão a tornar as atualizações mais simples. As alterações envolvem mover o conteúdo da pasta /etc para pastas, incluindo /libs, /apps e /content, com base no fato de o Adobe ou um cliente deter o conteúdo, limitando assim as chances de substituir o conteúdo durante as versões. A reestruturação do repositório foi feita de tal forma que não deve exigir alterações de código no momento da atualização do 6.4, embora seja recomendável revisar os detalhes em Reestruturação do repositório no AEM 6.4 durante o planejamento de uma atualização.

Avaliação da complexidade da atualização assessing-upgrade-complexity

Devido à grande variedade na quantidade e na natureza das personalizações que nossos clientes aplicam a seus ambientes de AEM, é importante passar algum tempo antes para determinar o nível geral de esforço que deve ser esperado em sua atualização.

Há duas abordagens que você pode tomar para avaliar a complexidade da atualização, uma fase preliminar pode apenas usar o Detector de padrões recém-introduzido, que está disponível para ser executado em suas instâncias AEM 6.1, 6.2 e 6.3. O detector de padrões é a maneira mais fácil de avaliar a complexidade geral da atualização que se espera usando padrões relatados. O relatório do detector de padrões inclui padrões para identificação de APIs indisponíveis que estão em uso pela base de código personalizada (isso foi feito usando verificações de compatibilidade de pré-atualização no 6.3).

Após a avaliação inicial, poderá ser dado um passo mais abrangente no sentido de efetuar uma atualização numa instância de ensaio e realizar alguns ensaios básicos de fumos. O Adobe também fornece alguns . Além disso, a lista de Recursos obsoletos e removidos O deve ser revisado não apenas para a versão para a qual você está atualizando, mas também para qualquer versão entre as versões de origem e de destino. Por exemplo, se estiver atualizando do AEM 6.2 para o 6.4, é importante revisar os recursos obsoletos e removidos do AEM 6.3, além dos recursos do AEM 6.4.

O Detector de padrões introduzido na versão 6.4 deve fornecer uma estimativa bastante precisa do que esperar durante uma atualização para a maioria dos casos. No entanto, para personalizações e implantações mais complexas em que você tem alterações incompatíveis, é possível atualizar uma instância de desenvolvimento para AEM 6.4 de acordo com as instruções em Execução de uma atualização no local. Depois de concluído, faça alguns testes de fumaça de alto nível neste ambiente. O objetivo deste exercício não é concluir exaustivamente o inventário dos casos de teste e produzir um inventário formal de defeitos, mas fornecer uma estimativa aproximada da quantidade de trabalho que será necessária para atualizar o código para a compatibilidade com o 6.4. Quando combinado com o Detecção de padrão e as alterações de arquitetura determinadas na seção anterior, uma estimativa aproximada pode ser fornecida à equipe de gerenciamento do projeto para planejar a atualização.

Criando o Runbook de Atualização e Reversão building-the-upgrade-and-rollback-runbook

Embora o Adobe tenha documentado o processo de atualização de uma instância de AEM, o layout de rede, a arquitetura de implantação e as personalizações de cada cliente exigirão o ajuste e a personalização dessa abordagem. Por esse motivo, recomendamos que você revise toda a documentação que fornecemos e use-a para informar um runbook específico do projeto que descreve os procedimentos específicos de atualização e reversão que você seguirá em seu ambiente. Se estiver atualizando do CRX2, certifique-se de avaliar quanto tempo a migração de conteúdo levará ao mudar do CRX2 para o Oak. Para repositórios grandes, pode ser substancial.

Fornecemos procedimentos de atualização e reversão em Procedimento de atualização bem como instruções passo a passo para aplicar a atualização em Executar um Atualização no local. Essas instruções devem ser revisadas e consideradas com a arquitetura do sistema, as personalizações e a tolerância ao tempo de inatividade para determinar os procedimentos apropriados de switch e reversão que você executará durante a atualização. Quaisquer alterações na arquitetura ou no tamanho do servidor devem ser incluídas ao criar seu runbook personalizado. É importante notar que este aspecto deve ser tratado como um primeiro projeto. À medida que sua equipe conclui os ciclos de controle de qualidade e desenvolvimento e implanta a atualização no ambiente de preparo, é provável que a necessidade de algumas etapas adicionais seja necessária. Idealmente, esse documento deve conter informações suficientes para que, se ele fosse entregue a um membro da equipe de operações, ele pudesse concluir a atualização completamente a partir das informações contidas no .

Desenvolvimento de um plano de projeto developing-a-project-plan

Podemos usar o resultado dos exercícios anteriores para criar um plano de projeto que cubra os prazos esperados para nossos esforços de teste ou desenvolvimento, treinamento e execução de atualização real.

Um plano de projeto global deve incluir:

Desenvolvimento de desenvolvimento e controle de qualidade performing-development-and-qa

Fornecemos procedimentos para Atualização de código e personalizações para ser compatível com o AEM 6.4. Como esse processo iterativo é executado, as alterações devem ser feitas no runbook, conforme necessário. Consulte também Compatibilidade com versões anteriores no AEM 6.4 informações sobre como suas personalizações podem permanecer compatíveis na maioria dos casos sem exigir desenvolvimento imediatamente após a atualização.

O processo de desenvolvimento e teste é geralmente iterativo. Devido a personalizações, as alterações feitas durante a atualização podem tornar potencialmente inutilizável uma seção inteira do produto. Depois que os desenvolvedores resolverem a causa raiz do problema e a equipe de teste tiver acesso para testar esses recursos, há potencial para descobrir problemas adicionais. À medida que forem detectados problemas que exijam ajustes no processo de atualização, adicione-os ao seu runbook de atualização personalizado. Após várias iterações de teste e correção, a base de código deve ser totalmente validada e pronta para implantação no ambiente de preparo temporário.

Teste final final-testing

Recomendamos uma rodada final de testes depois que a base de código tiver sido certificada pela equipe de QA de sua organização. Essa rodada de testes envolverá a validação do runbook em um ambiente de preparo, seguido de rodadas de aceitação, desempenho e teste de segurança do usuário.

Essa etapa é essencial, pois é a única vez que você pode validar as etapas no runbook em relação a um ambiente semelhante à produção. Depois que o ambiente for atualizado, é importante permitir que os usuários finais façam logon e passem pelas atividades que fazem ao usar o sistema em suas atividades diárias. Não é incomum que os usuários aproveitem uma parte do sistema que não foi considerada anteriormente. Encontrar e corrigir problemas nessas áreas antes da ativação pode ajudar a evitar paralisações dispendiosas na produção. Como uma nova versão do AEM contém alterações significativas na plataforma subjacente, também é importante executar testes de desempenho, carga e segurança no sistema como se estivéssemos inicializando pela primeira vez.

Execução da atualização performing-the-upgrade

Depois de receber o último sinal de aprovação de todas as partes interessadas, é tempo de executar os procedimentos de runbook que foram definidos. Fornecemos etapas para atualização e reversão em Procedimento de atualização e etapas de instalação em Execução de um Atualização no local como ponto de referência.

Fornecemos algumas etapas nas instruções de atualização para validação de ambiente. Isso inclui verificações básicas, como verificar os logs de atualização e verificar se todos os pacotes OSGi foram iniciados corretamente, mas recomendamos também validar com seus próprios casos de teste com base em seus processos comerciais. Também recomendamos verificar o agendamento da limpeza de revisão online AEM e as rotinas relacionadas para garantir que elas ocorrerão durante um período de silêncio para sua empresa. Essas rotinas são essenciais para o desempenho a longo prazo da AEM.