v7

Testes de migração

Última atualização em 2023-08-15
  • Tópicos
  • Upgrade
    Exibir mais informações sobre este tópico

Procedimento geral

Dependendo da sua configuração, há várias maneiras de realizar testes de migração.

Você deve ter um ambiente de teste/desenvolvimento para realizar testes de migração. Os ambientes Adobe Campaign estão sujeitos à licença: verifique seu contrato de licença ou entre em contato com o representante da Adobe.

  1. Interrompa todos os desenvolvimentos em andamento e transfira-os para o ambiente de produção.

  2. Faça um backup do banco de dados do ambiente de desenvolvimento.

  3. Pare todos os processos do Adobe Campaign na instância de desenvolvimento.

  4. Faça um backup do banco de dados do ambiente de produção e restaure-o como um ambiente de desenvolvimento.

  5. Antes de iniciar os serviços do Adobe Campaign, execute o freezeInstance.js script de cauterização que permite limpar o banco de dados de todos os objetos que estavam em execução quando o backup foi iniciado.

    nlserver javascript nms:freezeInstance.js -instance:<instance> -arg:<run|dry>
    
    OBSERVAÇÃO

    O comando é iniciado por padrão no seco e lista todas as solicitações que foram executadas por esse comando, sem inicializá-las. Para executar solicitações de cauterização, use executar no comando.

  6. Verifique se os backups estão corretos tentando restaurá-los. Verifique se você pode acessar o banco de dados, as tabelas, os dados etc.

  7. Testar o procedimento de migração no ambiente de desenvolvimento.

  8. Se a migração do ambiente de desenvolvimento tiver êxito, você poderá migrar o ambiente de produção.

ATENÇÃO

Devido a alterações feitas na estrutura de dados, não é possível importar e exportar pacotes de dados entre uma plataforma v5 e uma plataforma v7.

Ferramentas de migração

Várias opções permitem medir o impacto de uma migração e identificar os possíveis problemas. Estas opções devem ser executadas:

  • no config comando:

    nlserver.exe config <option> -instance:<instance-name>
    
  • ou no pós-atualização:

    nlserver.exe config -postupgrade <option> -instance:<instance-name>
    
OBSERVAÇÃO
  • Você deve usar o -instância:<instanceame> opção. Não recomendamos usar o -allinstances opção.
  • O comando Adobe Campaign update (pós-atualização) permite sincronizar recursos e atualizar schemas e o banco de dados. Esta operação só pode ser executada uma vez e somente no servidor de aplicativos. Após sincronizar recursos, a variável pós-atualização permite detectar se a sincronização gera erros ou avisos.

Objetos não padrão ou ausentes

  • A variável -showCustomEntities exibe a lista de todos os objetos não padrão:

    nlserver.exe config -showCustomEntities -instance:<instance-name>
    

    Exemplo de mensagem enviada:

    xtk_migration:opsecurity2 xtk:entity
    
  • A variável -showDeletedEntities exibe a lista de todos os objetos padrão que estão ausentes no banco de dados ou no sistema de arquivos. Para cada objeto ausente, o caminho é especificado.

    nlserver.exe config -showDeletedEntities -instance:<instance-name>
    

    Exemplo de mensagem enviada:

    Out of the box object 'nms:deliveryCustomizationMdl' belonging to the 'xtk:srcSchema' schema has not been found in the file system.
    

Processo de verificação

Integrado como padrão no comando postupgrade, esse processo permite exibir avisos e erros que podem fazer com que a migração falhe. Se forem exibidos erros, a migração não foi executada. Se isso acontecer, corrija todos os erros e reinicie o pós-upgrade.

Você pode iniciar o processo de verificação por conta própria (sem migração) usando o comando:

nlserver.exe config -postupgrade -check -instance:<instance-name>
OBSERVAÇÃO

Você pode ignorar todos os avisos e erros com o código JST-310040.

As seguintes expressões são pesquisadas (distinção entre maiúsculas e minúsculas):

Expressão
Código de erro
Tipo de log
Comentários
.@
PU-0001
Aviso
Esse tipo de sintaxe não é mais suportado na personalização da entrega.
common.js
PU-0002
Aviso
Esta biblioteca não deve ser usada.
logon(
PU-0003
Aviso
Este método de conexão não deve mais ser usado.
new SoapMethodCall()
PU-0004
Aviso
Esta função só é suportada quando usada no código JavaScript executado a partir de uma zona de segurança que está em sessionTokenOnly modo.
sql=
PU-0005
Erro
Esse tipo de erro leva a uma falha de migração.
crmDeploymentType="no local"
PU-0007
Erro
Esse tipo de implantação não é mais suportado. O Office 365 e o tipo de implantação do conector do Microsoft CRM no local foram descontinuados.
Se estiver usando um desses tipos de implantação obsoletos em uma conta externa, essa conta externa deve ser excluída e você deve executar o pós-atualização comando.
Para alterar para implantação da API da Web, consulte Aplicações web.
CRM v1(mscrmWorkflow/sfdcWorkflow)
PU-0008
Erro
As atividades de ação do Microsoft CRM, Salesforce e Oracle CRM On Demand não estão mais disponíveis. Para configurar a sincronização de dados entre o Adobe Campaign e um sistema CRM, é necessário usar o Conector do CRM atividade de direcionamento.

Também é realizada uma verificação de coerência do banco de dados e do esquema.

Opção de restauração

Essa opção permite restaurar objetos prontos para uso se eles tiverem sido modificados. Para cada objeto restaurado, um backup das alterações é armazenado na pasta selecionada:

nlserver.exe config -postupgrade -restoreFactory:<backupfolder> -instance:<instance-name>
OBSERVAÇÃO

É altamente recomendável usar caminhos absolutos de pastas e manter a estrutura de árvore de pastas. Por exemplo: backupFolder\nms\srcSchema\billing.xml.

Continuar a migração

Se você reiniciar o pós-upgrade após uma falha de migração, ele será retomado do mesmo local em que foi interrompido.

Nesta página