Etapa 1: Configurar agentes do Gerenciador de Migração

Ao migrar compartilhamentos de arquivos com o Migration Manager, primeiro você precisa configurar um ou mais agentes de migração. Você pode executar o arquivo de instalação do agente em cada computador ou VM (máquina virtual) que escolher configurar. Você também pode agrupar agentes atribuindo migrações específicas a um conjunto específico de agentes ou separando os agentes em grupos com base na localização geográfica para otimizar o desempenho.

Ao executar o arquivo de configuração, você será solicitado a fornecer dois conjuntos de credenciais. Você precisa de credenciais de Administrador do SharePoint, dependendo do seu destino, e credenciais do Windows com acesso de Leitura à origem. Essas credenciais do Windows devem ter acesso de leitura a todos os compartilhamentos de arquivo que você planeja migrar. Esse par de credenciais cria uma confiança no Gerenciador de Migração. O Migration Manager agora o vê como um "agente" disponível para o qual pode distribuir tarefas de migração automaticamente.

Depois que um agente é configurado, qualquer pessoa com permissão para acessar o centro de administração do SharePoint pode criar tarefas. As tarefas são distribuídas automaticamente para um dos agentes configurados disponíveis.

Importante

Certifique-se de baixar a versão mais recente do arquivo de configuração do agente. As senhas não são armazenadas no instalador.

Lista de verificação de planejamento

Categoria Orientação
Determine quantos agentes você precisa. Quantos agentes criar.
Tenha as credenciais certas para usar Administrador do SharePoint ou OneDrive para destino de migração e uma conta local para origem que tenha acesso a TODOS os compartilhamentos de arquivos de rede que você planeja migrar. Verifique se você tem credenciais de Administração do SharePoint ou do OneDrive para acessar o "destino" de onde está migrando seu conteúdo. Verifique se as credenciais locais que você planeja usar para configurar o agente tem acesso a todos os compartilhamentos de arquivos de rede que você planeja migrar.
Máquinas virtuais ou computadores de usar. Determine quantas VMs ou computadores você planeja usar no seu projeto de migração. Liste os computadores ou VMs antes de começar.
Requisitos de sistema. Certifique-se de que seu computador atenda aos requisitos. Verificar os pré-requisitos
pontos de extremidade. Certifique-se de ter os pontos de extremidade necessários configurados. Verifique os pontos de extremidade necessários
Locatário multigeográfico. Se você tiver um locatário multigeográfico, certifique-se de entender onde o agente está instalado. Locatário multigeográfico.
Pré-provisionar contas do OneDrive Se você estiver migrando para contas do OneDrive, verifique se as contas estão pré-provisionadas antes de migrar. O pré-provisionamento pode ser feito usando um script como descrito aqui: Pré-provisionar o OneDrive para usuários em sua organização.
Nuvem Governamental Se seu locatário reside em uma nuvem governamental, você pode ter etapas extras para executar antes de usar o Gerenciador de Migração.

Dica

Crie uma conta de serviço com direitos administrativos para o seu agente executar no servidor ou na VM. Essa conta deve ter acesso de leitura às fontes que você planeja migrar e acesso de administrador do SharePoint ou do OneDrive ao destino especificamente para seu projeto de migração. Faça logon em cada VM ou computador com essa conta antes de executar o arquivo de instalação para garantir que o agente seja instalado como um serviço.

Observação

No momento, não há suporte para a autenticação multifator de terceiros.

Agentes e considerações de desempenho

Um fator para obter o melhor desempenho em sua migração é usar o menor número de agentes necessários para concluir a migração dentro do prazo. O uso de mais agentes do que o necessário pode aumentar a taxa de limitação quando os relatórios são carregados.

Exemplo: se sua migração puder ser feita dentro do intervalo de tempo desejado usando 10 agentes e em uma velocidade aceitável, não use 20 agentes. Usar mais agentes significa maior tráfego e uma maior taxa de solicitação de API.

Determinar quantos agentes você precisa

Para calcular o número mínimo necessário de agentes a serem usados para sua migração:

  1. Execute uma migração de teste com 20 a 30 tarefas usando um agente para testar a taxa de transferência por agente. Registre o tempo.
  2. Estime o número de tarefas para toda a migração. Pegue o tempo que um agente de teste levou para processar e calcule o número de agentes para a migração. Considere o tempo total que você tem para concluir seu projeto de migração.
  3. Se você criou mais agentes do que precisa, eles podem ser desativados selecionando o agente no Migration Manager.

Criar um agente

  1. Entre no computador ou VM que você escolher para configurar um agente com credenciais que tenham acesso de leitura a todos os compartilhamentos de arquivo que você planeja migrar.
  2. No Centro de administração do SharePoint, selecione Centro de Migração. Você precisa entrar com uma conta que tenha permissões de administrador do SharePoint para sua organização.
  3. Em "Para compartilhamentos de arquivos", selecionar iniciar.
  4. Selecionar o Agentes guia e selecione Adicionar.
  5. Selecione Baixar arquivo de configuração do agente. (Para obter as correções de bugs mais recentes, melhorias de recursos ou novos recursos, encontre o link de download da visualização pública mais recente em 'Novidades')
  6. Abrir o arquivo de instalação. Na página de Boas-vindas, selecione o método de autenticação e selecione Avançar.
  7. Se você selecionar Autenticação de Credencial do Usuário, insira o nome de usuário e a senha do administrador do SharePoint do ambiente em que você está migrando o conteúdo. Selecione Avançar. Se você selecionar Autenticação de Certificado, carregue o arquivo de configuração de autenticação do certificado. Selecione Avançar.
  8. Insira a senha da conta do Windows que fornece acesso a todos os compartilhamentos de arquivo contendo o conteúdo que você deseja migrar. Selecione Instalar.
  9. Acesso ao agente de teste (opcional) ou selecione Fechar. Após a conclusão da configuração, o novo agente é adicionado aos agentes disponíveis que podem receber tarefas.

Observação

Vários agentes: se você tiver um grande projeto de migração e precisar configurar vários agentes, recomendamos que baixe o arquivo de configuração do agente para um local compartilhado. Dessa forma, você pode baixar facilmente o arquivo de instalação em cada computador ou VM. Vários agentes permitem que você agrupe determinados trabalhos de migração em grupos específicos, dependendo de suas necessidades. Por exemplo, você pode agrupar agentes por datacenter para obter melhor desempenho com base na localização geográfica. Saiba mais.

Pasta de trabalho

Uma pasta de trabalho nomeada %appdata%\Microsoft\SPMigration é criada para cada agente. Esta pasta é onde são salvos os logs, relatórios e quaisquer pastas temporárias. Certifique-se de que a pasta de trabalho possua no mínimo 150 GB de espaço livre. Pode exigir mais, dependendo do tamanho dos dados que você planeja migrar.

Usar o armazenamento personalizado do Azure

Por padrão, os contêineres de armazenamento de blobs do Azure fornecidos pelo SharePoint são usados como o armazenamento temporário de conteúdo e manifesto durante a migração. Você também pode especificar seu próprio armazenamento do Azure no arquivo de configuração do agente. Primeiro, crie um armazenamento de blobs do Azure em seu locatário. Observe o nome de armazenamento e a chave de armazenamento. Em seguida, no host em que o agente está instalado, adicione a credencial de acesso no Gerenciador de Credenciais do Windows.

  • Abra o Gerenciador de Credenciais e navegue até a seção "Credenciais Genéricas"
  • Selecione "Adicionar uma credencial genérica"
    • Endereço de rede ou Internet: insira um nome (por exemplo, "MyAzureStorage")

    • Nome de usuário: insira o nome do armazenamento do Azure

    • Senha: insira a chave de armazenamento do Azure

Prepare um arquivo de configuração JSON, incluindo a definição "CostomizedAzureStorage". Defina "UseCustomAzureStorage" como true e "AzureStorageCredentialTargetName" como a credencial criada no Gerenciador de Credenciais.

{
	"CustomizedAzureStorage”:
	{	
		"UseCustomAzureStorage": true,
	 	"AzureStorageCredentialTargetName": "MyAzureStorage"	
	}
}

Durante a instalação do agente, escolha o arquivo de configuração que inclui as configurações personalizadas de armazenamento do Azure. O instalador verifica o acesso ao armazenamento do Azure definido no arquivo de configuração. Se bem-sucedida, "As configurações de credencial de armazenamento do Azure foram validadas com êxito" será exibido. Se não for bem-sucedido, uma mensagem de erro será exibida.

Configuração de agentes multigeográficos

Se você tiver um locatário Multi-Geo do SharePoint, o agente será instalado nas localizações geográficas definidas no centro de administração do SharePoint. Antes de instalar o agente, certifique-se de que a localização geográfica desejada seja aquela definida no centro de administração. Para alterar a localização geográfica de um agente, exclua e reinstale o agente.

Saiba mais: Recursos multigeográficos no OneDrive e no Microsoft 365

Para instalar um agente em uma localização Geográfica diferente:

  1. Baixe o arquivo de configuração do agente.

  2. Inicie o arquivo de configuração e permaneça na página de Boas-vindas.

  3. Abra este arquivo: %temp%\SPMigrationAgentSetup\SPMigrationAgentSetup\Microsoft.SharePoint.Migration.ClientShared.dll.config

  4. Em appSettings, adicione uma entrada, conforme mostrado no exemplo a seguir, para o país/região ou data center desejado. (Nota: aqui está um exemplo para o Canadá.)

    <add key="GeoLocation" value="CAN" />
    

    O código GEO do país ou da região pode ser encontrado aqui Disponibilidade Multi-Geo do Microsoft 365.

Importante

Migração para o Teams: se você estiver migrando para o Teams, o site de destino deverá estar no mesmo GEO que o administrador do locatário. Se forem diferentes, o canal do Teams não será carregado quando você selecionar o destino.

Instalando o agente como aplicativo

Se o sistema detectar que você não ingressou em um domínio ao instalar o agente, você poderá instalar o agente como um aplicativo do Windows. Se você ainda quiser instalá-lo como serviço, saia e entre com uma conta conectada ao domínio.

Importante

Se você instalar o agente como um aplicativo, ele não será executado se o computador estiver suspenso, pausando efetivamente sua migração.

  1. Selecione Instalar como aplicativo.
  2. Depois que o agente for instalado, entre com suas credenciais de administrador do SharePoint.
  3. Teste se o agente tem acesso aos compartilhamentos de arquivos que você deseja migrar (opcional).
  4. A tela de configurações exibe se e a qual locatário você está conectado. Selecione o locatário desvinculado se quiser entrar em um locatário diferente.
  5. O Microsoft 365 renova automaticamente a autorização para acessar seu locatário enquanto o agente de migração estiver ativo. Se o agente estiver inativo por mais de sete dias, talvez seja necessário entrar novamente.

Atribuição de tarefa do agente

O Gerenciador de Migração atribui tarefas automaticamente a um agente disponível. Você não pode atribuir manualmente uma tarefa a um agente específico. Cada agente pode ter até 10 tarefas em sua fila. No entanto, é possível atribuir tarefas a grupos de agentes.

Pausar uma tarefa não libera o agente para outra tarefa. Um agente permanece indisponível para aceitar uma nova tarefa até que a tarefa existente seja retomada e concluída ou excluída.

Por quanto tempo a conexão permanece ativa?

A conexão entre um agente (como serviço) e o Gerenciador de Migração permanece ativa enquanto o computador ainda estiver em execução, e as credenciais de administrador do SharePoint que foram usadas para entrar no agente ainda estiverem válidas.

Se o agente for desconectado, ele ainda manterá o token para o Gerenciador de Migração por até sete dias. Após esse período, o agente precisa ser reinstalado.