---
sourceDocument: Segurança da plataforma Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-security

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Segurança da plataforma Yokohama

ft:clusterId :

    - psec

bundleId :

    - psec

workflow :

    - Platform


---

# Ferramenta de migração de domínio

# Ferramenta de migração de domínio {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 min. de leitura

Use a Ferramenta de migração de domínio para mover um cliente de um ambiente separado por domínio para sua própria instância dedicada.

## Plug-in da Ferramenta de migração de domínio {#tenant-domain-migration-tool__section_qyj_gjx_5jb}

O plug-in da Ferramenta de migração de domínio (com.glide.domain.migration_tool) simplifica a tarefa de mover um cliente de um ambiente separado por domínio para uma instância dedicada mais flexível. Os clientes podem migrar para uma instância separada para aproveitar melhor os recursosNow Platform. Embora o plug-in Separação de domínios esteja instalado, as propriedades de separação de dados e processos estão desativadas.  
Nota:  
Você deve solicitar uma instância clonada e solicitar a ativação do plug-in Domain Migration Tool antes de usá-la.  
A Ferramenta de migração de domínio será executada somente se a separação de dados e de processo estiver habilitada na instância separada por domínio:

* A propriedade de dados glide.sys.domain.partitioning deve ser definida como verdadeira.
* A propriedade de processos glide.sys.domain.delegated_administration deve ser definida como verdadeira.
{#tenant-domain-migration-tool__ul_ltx_m3r_vjb}

## O que a ferramenta de migração faz {#tenant-domain-migration-tool__section_t2b_ckx_5jb}

* Automatiza grande parte do processo de migração, especialmente a limpeza de dados.
* Migra a instância separada por domínio para uma nova instância dedicada.
* Exclui dados da instância dedicada.  
  Nota:  
  A ferramenta não exclui dados globais, no domínio de destino ou em domínios de dados adicionais (se especificado).
* Recolhe os dados do processo ou, se não for possível recolher, exclui os dados do processo
* Mantém registros de processo que são visíveis para o domínio de destino
* Atualiza as tabelas especiais sys_choice, sys_ui_list e sys_ui_related_list
* Limpa os registros adicionados por plug-ins Separação de domínios:
  * Regras de negócio
  * Ações de IU
  * Trabalhos agendados
  * Saídas de instalação
  * Módulos de navegação
  {#tenant-domain-migration-tool__ul_fsr_yqr_vjb}
* Desabilita o Separação de domínios e remove domínios da instância clonada:
  * Define estas propriedades como falsas na instância clonada:
    * glide.sys.domain.partitioning
    * glide.sys.domain.delegated_administration
    * glide.sys.domain.enabled
    {#tenant-domain-migration-tool__ul_ntm_vrr_vjb}
  * Exclui todos os domínios, exceto o domínio de destino e todos os domínios de dados adicionais especificados.
  {#tenant-domain-migration-tool__ul_hs3_srr_vjb}
* Atualiza o campo Status na tabela domain_migration_tool_status.{#tenant-domain-migration-tool__table_ac3_qhr_fwb__entry__2}

  | Status | Descrição |
  |-|-|
  | Pendente | Status-padrão de tabelas separadas por domínio durante a migração. As tabelas estão Agendadas para serem migradas, mas ainda não iniciaram a migração. |
  | Falha | Falha no nível da tabela. Se o processo de migração for concluído com erros, este status indica quais tabelas têm erros. |
  | Em execução | O status da tabela que está sendo migrada no momento. Somente uma tabela pode ter este status e migrar no momento. |
  | Bem-sucedido | O status das tabelas que foram migradas com sucesso. |
  | Concluído com êxito | O processo de migração foi concluído sem erros. |
  | Concluído com erros | O processo de migração foi concluído com erros. |
  [Tabela 1. Status individual das tabelas]

  {#tenant-domain-migration-tool__table_ac3_qhr_fwb}
* Registra em log o andamento e o status em syslog_domainA origem é MigrationTool para todas as entradas de log associadas à migração.

  * Registra em log cada tabela de dados e quantas tabelas de dados permanecem
  * Registra em log cada tabela de processo e quais registros de domínio estão sendo desativados ou excluídos
  {#tenant-domain-migration-tool__ul_zqt_kfs_vjb}
{#tenant-domain-migration-tool__ul_pww_5lx_5jb}

## O que a ferramenta de migração não faz {#tenant-domain-migration-tool__section_qg4_5qx_5jb}

* Clonar a instância
* Criar outra instância separada por domínio
* Migrar registros (dados ou processo) se as propriedades de separação de dados ou de processo forem desabilitadas antes de executar a ferramenta
* Alterar quaisquer dados na instância de origem
* Excluir dados globais, no domínio de destino ou em domínios de dados adicionais (se especificado)
{#tenant-domain-migration-tool__ul_jq2_htx_5jb}

## O que você deve fazer após executar a ferramenta {#tenant-domain-migration-tool__section_zfc_xf1_wjb}

A Ferramenta de migração de domínio automatiza a remoção de dados fora dos domínios desejados (o domínio de destino, quaisquer domínios de dados adicionais e o domínio global). Você deve avaliar todas as configurações restantes para garantir que elas sejam apropriadas e funcionem para a instância dedicada. Por exemplo, se você tivesse uma regra de negócio que definisse o campo de domínio em registros, convém desabilitar essa regra de negócios, já que ela não atende mais a uma finalidade.

## Migração da instância separada por domínio para uma nova instância dedicada. {#ariaid-title2}

Mova um cliente de um ambiente separado por domínio para seu próprio ambiente de instância dedicada.

### Antes de Iniciar

Função necessária: administrador

### Procedimento

1. Eleve para a função security_admin.  
   Consulte [Elevação para uma função privilegiada](https://servicenow-prod.fluidtopics.net/ID3vF7WafSaInUy7wH9E3g "O administrador do sistema de base pode elevar a uma função privilegiada para ter acesso aos recursos das configurações de alta segurança.") para obter detalhes.
2. Navegar até TudoAdministrador de DomínioFerramenta de migração de domínio.  
   Acesse também com domain_migration_tool_status.list.
3. Clique em Novo.
4. Preencha o formulário.  
   {#migrate-domain-instance__table_csz_4n1_wjb__entry__2}

   | Campo | Descrição |
   |-|-|
   | Domínio de destino | Especifique o domínio usado para o processo e os dados que você deseja migrar. Somente o domínio de destino é retido, não qualquer um de seus secundários, a menos que especificado no campo Domínios de dados adicionais. |
   | Domínios de dados adicionais | Opcionalmente, especifique os domínios de dados adicionais que você deseja migrar. Se você quiser migrar o domínio de destino e todos os seus secundários, deverá especificar todos os secundários. |
   [ ]

   {#migrate-domain-instance__table_csz_4n1_wjb}
5. Selecione Enviar.
6. Abra o formulário que você acabou de enviar.
7. Navegar até TudoCentral da Separação de domíniosConfigurar auditorias .  
   Consulte [Central de Separação de domínios](https://servicenow-prod.fluidtopics.net/3qJS23RKSTG51rEyXmbNhw "Audite seus domínios regularmente para revelar problemas.") para obter informações adicionais.
8. Defina a auditoria Validar esquema de tabela separada por domínio como Ativa e atribua uma programação.  
   Esta é uma auditoria de domínio de precaução para verificar previamente o esquema quanto à integridade de tabelas separadas por domínio. Isso permite que você corrija erros antes de executar a migração.
9. Execute a Programação de auditoria que inclui o esquema.  
   Consulte [Execução de auditorias imediatamente](https://servicenow-prod.fluidtopics.net/iZB_BRAlo_tRktqxsAGyZA "As auditorias normalmente são executadas conforme agendado. Você pode, no entanto, executar todas as auditorias sob comando.") para obter detalhes.
10. Resolver problemas retornados da auditoria.  
11. Selecione Iniciar migração.  
    * A barra de andamento do rastreador de execução e a ferramenta de migração de domínio são acionadas.
    * A tabela de migração atual em andamento é exibida junto com a porcentagem total de tabelas migradas com êxito.
    * A tabela em que todas as tabelas separadas por domínio são registradas com o status da migração, o número total de registros em cada tabela e o número de registros migrados.
    * A contagem de tabelas em que a migração falhou também é registrada.
    * O Status é atualizado conforme a ferramenta executa suas funções.
    * A migração de domínio ainda estará em execução em segundo plano se você fechar a barra de andamento. Acesse a tabela sys_execution_tracker e procure por Migração em Execução nas Tabelas para verificar o processo de migração em execução em segundo plano.

    {#migrate-domain-instance__ul_wzq_qfr_fwb}

    O Status da Ferramenta de migração de domínio exibe os seguintes campos:
    {#migrate-domain-instance__table_ydj_vzw_fwb__entry__2}

    | Campo | Descrição |
    |-|-|
    | Status | Exibe o status da migração. * Migrando tabelas de dados...: status em andamento. * Migração bem-sucedida: o status atualizado após uma migração bem-sucedida. * Erro de configuração observado em uma das tabelas separadas por domínio: indica uma falha na migração de dados. Foi encontrado um erro de esquema, a migração não será iniciada. Execute a auditoria Validar esquema de tabela separada por domínio. A auditoria falhará e mostrará as tabelas que não seguem o padrão de esquema. * Concluído com erros nas tabelas de revisão: o número de tabelas para lidar com a migração de esquema é listado. Localize as falhas em Rever contagem de tabelas e resolva os problemas de esquema. * Falha na migração de domínio para tabelas...: registros que não sejam de destino devem ser excluídos manualmente das tabelas com falha. * Concluído com êxito: quando todas as tabelas forem migradas. {#migrate-domain-instance__ul_bt3_t1x_fwb} |
    | Domínio de destino | O domínio de destino selecionado para migração. |
    | Domínios de dados adicionais | Preenche se vários domínios de migração foram selecionados. |
    | Rever contagem de tabelas | Este campo será preenchido somente se houver falha na migração de uma tabela. Se não houver falhas, essa contagem será zero. Nesse caso, as tabelas serão revisadas para tentar novamente a migração. Se não houver falhas, não será necessário revisitar as tabelas ou tentar novamente a migração. |
    | Tabela em andamento atual | Exibe o nome da tabela que está sendo migrada. Após a migração bem-sucedida, este campo ficará vazio. |
    [Tabela 2. Campos de Status da ferramenta de migração de domínio]

    {#migrate-domain-instance__table_ydj_vzw_fwb}
12. Selecione o link Clique aqui na página Status da ferramenta de migração de domínio para abrir o Rastreador de execução.  
    Também é possível acessar a tabela sys_execution_tracker e procurar por Migração em execução nas tabelas para verificar o processo de migração em execução em segundo plano.
13. Selecione Mostrar status na seção Links relacionados para acessar a barra de andamento a qualquer momento durante a migração.  
    Caso uma tabela falhe na verificação de esquema, o status geral do Status da migração de tabelas separadas por domínio será Falha.

    Haverá entradas com Falha para cada tabela correspondente.

    O restante da migração continuará e um resumo de todas as tabelas com falha e o número total de Rever contagem de tabelas serão preenchidos no Status da ferramenta de migração de domínio.

    O Status é Concluído com êxito quando a migração é concluída.

