Esta seção fornecerá uma apresentação detalhada do processo de atualização e das etapas para identificar e resolver conflitos.
A atualização da build deve ser realizada com cautela, seus impactos devem ser totalmente considerados com antecedência e o procedimento deve ser concluído com um alto nível de disciplina. Para garantir uma atualização bem-sucedida, verifique se apenas usuários especialistas executam as etapas descritas abaixo. Além disso, recomendamos entrar em contato com Atendimento ao cliente Adobe antes de iniciar qualquer atualização.
Os seguintes pré-requisitos são necessários:
Você pode encontrar mais informações nestas seções: Atualização do Adobe Campaign, Migração para uma nova versão.
Para instâncias hospedadas e híbridas, você deve solicitar a atualização de build para a equipe de operações técnicas do Adobe. Para obter mais informações, consulte a seção Perguntas frequentes na parte inferior desta página. Consulte também o Perguntas frequentes sobre atualização de build.
Antes de iniciar a atualização de build, você deve executar uma preparação completa conforme descrito abaixo.
Quando o sistema estiver pronto para ser atualizado, uma atualização de build levará pelo menos 2 horas.
O processo de atualização de build requer os seguintes recursos:
Estes são os pontos principais sobre como planejar uma atualização de build:
O processo de atualização de build requer que as seguintes pessoas estejam envolvidas:
arquiteto de Adobe: para arquiteturas hospedadas ou híbridas, o arquiteto deve entrar em contato com o Atendimento ao cliente da Adobe Campaign.
Gerente de projetos:
para instalações no local: o líder interno do projeto do cliente lidera a atualização e gerencia testes de ciclo de vida.
para instalação hospedada: a equipe de hospedagem fará uma parceria com a equipe de Atendimento ao cliente da Adobe Campaign e o cliente para coordenar a linha do tempo de atualização para todas as instâncias.
Administrador do Adobe Campaign:
para instalações no local: o administrador executa a atualização.
para instalações hospedadas: a equipe de hospedagem realiza a atualização.
Operador do Adobe Campaign\usuário de marketing: o operador executa testes em instâncias de desenvolvimento, teste e produção.
Antes de iniciar a atualização de build, os clientes locais precisam executar a seguinte preparação:
Certifique-se de que qualquer trabalho de desenvolvimento possa ser exportado antes da atualização, exporte como pacotes.
Executar um backup completo dos bancos de dados para todas as instâncias dos ambientes de origem e de destino.
Obtenha a versão mais recente do seu arquivo de configuração do servidor.
Você também precisa saber todas as linhas de comando úteis antes de iniciar uma atualização de build:
Os procedimentos abaixo são executados somente por no local clientes. Para clientes hospedados, a equipe de hospedagem cuida disso. Para atualizar o Adobe Campaign para um novo build, o procedimento detalhado é descrito abaixo.
Esta é a forma como você duplica um ambiente Adobe Campaign para restaurar um ambiente de origem para um ambiente de destino, resultando em dois ambientes de trabalho idênticos.
Para fazer isso, siga as etapas abaixo:
Crie uma cópia dos bancos de dados em todas as instâncias no ambiente de origem.
Restaurar essas cópias em todas as instâncias do ambiente de destino.
Execute o nms:freezeInstance.js script de cauterização no ambiente do target antes de iniciá-lo. Isso interromperá a interação de todos os processos com o exterior: logs, rastreamento, deliveries, workflows da campanha etc.
nlserverjavacsriptnms:freezeInstance.js–instance:<dev> -arg:run
Verifique a cauterização, como se segue:
Verifique se a única parte do delivery é aquela com a qual a ID está definida 0:
SELECT * FROM neolane.nmsdeliverypart;
Verifique se a atualização do status do delivery está correta:
SELECT iSate, count(*) FROM neolane.nmsdeliveryGroup By iProd;
Verifique se a atualização do status do workflow está correta:
SELECT iState, count (*) FROM neolane.xtkworkflowGROUP BY iState;
SELECT iStatus, count (*) FROM neolane.xtkworkflowGROUP BY iStatus;
Para substituir todos os arquivos pela nova versão, é necessário que todas as instâncias do nlserverservice sejam encerradas.
Encerre os seguintes serviços:
Verifique se o servidor de redirecionamento (webmdl) está parado, para que o arquivo nlsrvmod.dll usado pelo IIS possa ser substituído pela nova versão.
Valide se nenhuma tarefa está ativa executando o despejo nlserver comando. Se não houver tarefas, a saída será semelhante ao seguinte:
C:\<installation path>\bin>nlserverpdump HH:MM:SS > Application Server for Adobe Campaign version x.x (build xxx) dated xx/xx/xxxx No tasks
Verifique o Gerenciador de tarefas do Windows para confirmar se todos os processos foram interrompidos.
Execute o Setup.exe arquivo. Se precisar baixar este arquivo, acesse o Centro de download.
Selecione o modo de instalação: Atualizar ou Reparar.
Clique em Next.
Clique em Concluir: o programa de instalação copia os novos arquivos.
Quando a operação estiver concluída, clique em Concluir.
Abra a linha de comando.
Executar nlserver config -postupgrade -allinstances para executar o seguinte:
Esta operação só deve ser executada uma vez e somente em um servidor de aplicativos nlserverweb.
Para sincronizar apenas um banco de dados, execute o seguinte comando:
nlserver config -postupgrade -instance: <instance_name>
Verifique se a sincronização gerou erros ou avisos.
Os seguintes serviços precisam ser reiniciados:
O console do cliente deve estar na mesma build da instância do servidor.
Na máquina em que o servidor de aplicativos do Adobe Campaign está instalado (nlserverweb), baixe e copie o arquivo:
Setup-client-7.xxxx.exe in [path of the application]\datakit\nl\en\jsp
Na próxima vez que os consoles do cliente estiverem conectados, uma janela informará os usuários sobre a disponibilidade de uma nova atualização e oferecerá a eles a possibilidade de baixá-la e instalá-la.
Algumas configurações exigem tarefas adicionais específicas para atualizar para uma nova build.
Quando as mensagens transacionais (Centro de mensagens) estão ativadas na instância do Campaign, é necessário executar as seguintes etapas adicionais para atualizar:
Atualize o servidor de produção do Centro de mensagens para a versão escolhida.
Execute os scripts de pós-atualização.
Execute testes e verifique se os emails foram recebidos com êxito por meio da instância de produção do Centro de mensagens.
Atualizar clientes e limpar o cache.
Exportar pacotes:
Publique modelos do Centro de mensagens para garantir que a interface entre os servidores e a instância do Centro de mensagens esteja funcionando.
Execute testes para garantir que os emails sejam recebidos com êxito por meio da instância de produção do Centro de mensagens.
Execute testes de workflow na produção para garantir que os deliveries sejam recebidos.
No contexto de um ambiente mid-sourcing, é necessário executar estas etapas adicionais para atualizar:
Contato Atendimento ao cliente Adobe para coordenar a atualização do servidor Mid-Sourcing.
Validar se a versão foi atualizada executando um link de teste. Por exemplo:
http://[InsertServerURL]/r/test
O servidor Mid-Sourcing sempre deve executar a mesma versão (ou mais recente) dos servidores de marketing.
Você precisa verificar o resultado da sincronização. Esse procedimento só é executado por clientes no local. Para clientes hospedados, a equipe de hospedagem cuida disso. Há duas maneiras de exibir o resultado da sincronização:
Na interface de linha de comando, os erros são materializados por uma divisa tripla '>>>' e a sincronização é interrompida automaticamente. Os avisos são materializados por uma divisa dupla '>>' e devem ser resolvidos quando a sincronização estiver concluída. No final da pós-atualização, um resumo é exibido no prompt de comando. Ele pode ter esta aparência:
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 info log =========Summary of the update==========
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 info log <instance name> instance, 6 warning(s) and 0 error(s) during the update.
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 warning log The document with identifier 'mobileAppDeliveryFeedback' and type 'xtk:report' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 warning log The document with identifier 'opensByUserAgent' and type 'xtk:report' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.750Z 00002E7A 1 warning log The document with identifier 'deliveryValidation' and type 'nms:webApp' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.750Z 00002E7A 1 warning log Document of identifier 'nms:includeView‘ and type 'xtk:srcSchema' updated in the database and found in the file system. You will have to merge the two versions manually.
Se o aviso aborda um conflito de recursos, é necessária atenção do usuário para resolvê-lo.
A variável postupgrade_ServerVersionNumber_TimeOfPostUpgrade.log o arquivo contém o resultado da sincronização. Ela está disponível por padrão no seguinte diretório: installationDirectory/var/<instance-name>
/postupgrade. Os erros e avisos são indicados pelos atributos de erro e aviso.
Como um conflito é encontrado?
Conflitos podem ser encontrados no postupgrade.log no servidor em questão ou na interface do cliente do Campaign (Administration > Configuration > Package management > Edit conflicts).
O documento com o identificador "stockOverview" e o tipo "nms:webApp" está em conflito com a nova versão.
Se um conflito for encontrado, verifique se as seguintes condições são compatíveis:
Se nenhuma dessas condições se aplicar, isso será um falso positivo. Se ambas as condições se aplicarem, um conflito real foi encontrado.
O objeto foi modificado pelo cliente?
O objeto foi alterado na nova build?
Para resolver conflitos, aplique o seguinte processo:
No explorador do Adobe Campaign, acesse Administração > Configuração > Gerenciamento de pacotes > Editar conflitos.
Selecione o conflito que deseja resolver na lista.
Há três opções para resolver conflitos: Aceitar a nova versão, Manter a versão atual, Mesclar o código (e declarar como resolvido), Ignorar o conflito (não recomendado).
Quando posso aceitar a nova versão?
Quando posso manter a versão atual?
Quando executar uma mesclagem?
E se eu ignorar os conflitos?
É altamente recomendável resolver conflitos.
Há diferentes tipos de mesclagens:
Se você optar por resolver o conflito manualmente, proceda da seguinte maneira:
Estas são as etapas para executar uma mesclagem complexa:
Habilidades de desenvolvimento são necessárias para executar mesclagens complexas.
Tópicos relacionados