Desprovisionar ou excluir o ponto de extremidade do servidor de Sincronização de Arquivos do Azure

Remover um endpoint de servidor interrompe a sincronização entre essa localização do servidor e o compartilhamento de arquivos do Azure associado (o endpoint da nuvem) no mesmo grupo de sincronização. Antes de desprovisionar o ponto de extremidade do servidor, há algumas etapas que você deve tomar para manter a integridade e a disponibilidade dos dados. Este artigo aborda vários métodos de desprovisionamento e fornece as diretrizes apropriadas por cenário. Siga as etapas para o caso de uso que melhor se aplica a você.

Se estiver não for problema perder permanentemente os dados que você está sincronizando no momento, é possível pular para desprovisionar diretamente o ponto de extremidade do servidor.

Aviso

Não tente resolver problemas de sincronização desprovisionando um ponto de extremidade do servidor. Para obter ajuda para solucionar problemas, consulte Solucionar problemas de Sincronização de Arquivos do Azure. Pode ocorrer perda permanente de dados se você excluir o ponto de extremidade do servidor sem antes garantir que o servidor e o lado da nuvem estejam totalmente sincronizados um com o outro. A remoção de um ponto de extremidade de servidor é uma operação destrutiva, e os arquivos em camadas ('tiered files') dentro do ponto de extremidade do servidor não serão reconectados a seus locais no compartilhamento de arquivos do Azure depois que o ponto de extremidade do servidor for recriado. Isso causará erros de sincronização. Além disso, arquivos em camadas que existem fora do namespace do ponto de extremidade do servidor podem ser perdidos permanentemente. Arquivos em camadas podem existir em seu ponto de extremidade do servidor mesmo se nunca tiver ativado a camada de nuvem.

Cenário 1: quero excluir um ponto de extremidade do servidor e não preciso de dados locais do servidor da Sincronização de Arquivos do Azure

O objetivo é garantir que seus dados estejam atualizados no endpoint da nuvem. Para ter seu conjunto completo de arquivos atualizado em seus pontos de extremidade do servidor, consulte Cenário 2.

Alguns casos de uso que se enquadram nessa categoria incluem:

Migrar para um compartilhamento de arquivos do Azure
Ir sem servidor
Descontinuar o uso de um caminho de ponto de extremidade de servidor específico enquanto mantém o restante do grupo de sincronização intacto

Para esse cenário, há três etapas para seguir antes de excluir o endpoint do servidor:

Remova o acesso do usuário.
Inicie uma sessão de upload especial do VSS.
Aguarde a conclusão de uma sessão de sincronização final.

Remover o acesso do usuário ao endpoint do servidor

Antes de desprovisionar, pare o acesso do usuário ao endpoint do servidor para que nenhuma nova alteração de arquivo ocorra enquanto a sincronização final roda. Essa etapa dá à nuvem a chance de se atualizar com o estado atual dos seus dados.

Remover o acesso resulta em tempo de inatividade. Para reduzir o tempo de inatividade, considere redirecionar o acesso do usuário ao endpoint da nuvem.

Registre a data e hora em que removeu o acesso do usuário e depois avance para a próxima seção.

Iniciar uma sessão de carregamento especial do serviço de instantâneo de volume (VSS)

Todos os dias, o Sincronização de Arquivos do Azure cria um snapshot VSS temporário no servidor para sincronizar arquivos que estão abertos ou bloqueados por aplicativos (arquivos com handles abertos). Para garantir que sua sessão final de sincronização envie os dados mais recentes e reduzir erros por item, inicie uma sessão especial para o upload do VSS. Essa etapa também desencadeia uma sessão especial de upload de sincronização que começa após a captura de instantâneo.

Para isso, abra o Agendador de Tarefas no seu servidor local, vá em Microsoft\StorageSync, clique com o botão direito na VssSyncScheduledTask tarefa e selecione Executar.

Importante

Anote a data e a hora em que você concluir esta etapa. Você precisará dela na próxima seção.

Uma captura de tela do agendamento de uma sessão de upload do VSS.

Aguarde a conclusão de uma sessão de upload de sincronização final

Para garantir que os dados mais recentes estejam na nuvem, aguarde a sessão final de upload da sincronização.

Para verificar o status da sessão de sincronização, abra o Visualizador de Eventos no servidor local. Vá para o registro de eventos de telemetria (Aplicativos e Serviços\Microsoft\FileSync\Agente). Certifique-se de ver um evento 9102 com 'direção de sincronização' = upload, 'HResult' = 0 (sem erros) e 'PerItemErrorCount' = 0 (todos os arquivos sincronizados com sucesso) que ocorreu após você iniciar manualmente uma sessão de upload VSS.

Uma captura de tela de verificação se uma sessão de sincronização final foi concluída.

Se 'PerItemErrorCount' for maior que 0, os arquivos não serão sincronizados. Use o FileSyncErrorsReport.ps1 para ver os arquivos que estão falhando na sincronização. Esse script do PowerShell normalmente está localizado nesse caminho em um servidor com um agente de Sincronização de Arquivos do Azure instalado: C:\Program Files\Azure\StorageSyncAgent\FileSyncErrorsReport.ps1

Se esses arquivos não forem importantes, você pode excluir o endpoint do servidor. Se esses arquivos forem importantes, corrija os erros e aguarde que outro evento 9102 com 'sync direction' = upload, 'HResult' = 0 e 'PerItemErrorCount' = 0 ocorram antes de excluir o ponto de extremidade do servidor.

Cenário 2: quero excluir o ponto de extremidade do servidor e preciso que o servidor da Sincronização de Arquivos do Azure tenha todo o conjunto de dados

O objetivo nesse cenário é garantir que seus dados estejam atualizados no seu servidor local ou VM. Para ter seu conjunto completo de arquivos atualizado em seu ponto de extremidade na nuvem, consulte Cenário 1.

Para esse cenário, há quatro etapas a seguir antes de excluir o endpoint do servidor:

Desabilitar camada de nuvem.
Recuperar arquivos arquivados em camadas.
Inicie a detecção de alterações na nuvem.
Aguarde a conclusão de uma sessão de sincronização final.

Desabilitar as camadas de nuvem do Sincronização de Arquivos do Azure

Vá para a seção de hierarquização na nuvem em Propriedades do Endpoint do Servidor do endpoint do servidor que deseja desprovisionar e desative a hierarquização na nuvem.

Restaurar todos os arquivos armazenados em camadas para o servidor local

Mesmo que o gerenciamento em camadas de armazenamento em nuvem esteja desabilitado, você deve recuperar todos os arquivos gerenciados em camadas para ter certeza de que todos os arquivos estão armazenados localmente.

Antes de recuperar os arquivos, verifique se você tem espaço livre suficiente localmente para armazenar todos os seus arquivos. Seu espaço livre precisa ter aproximadamente o tamanho do compartilhamento de arquivos do Azure na nuvem, menos o tamanho armazenado em cache no servidor.

Use o cmdlet do Invoke-StorageSyncFileRecall PowerShell e especifique o parâmetro SyncGroupName para recuperar todos os arquivos.

Invoke-StorageSyncFileRecall -SyncGroupName "samplesyncgroupname" -ThreadCount 4

Depois que este cmdlet terminar de funcionar, avance para a próxima seção.

Iniciar a detecção de alterações na nuvem

Iniciar a detecção de alterações na nuvem garante que suas alterações mais recentes tenham sido sincronizadas.

Você pode iniciar a detecção de alterações com o Invoke-AzStorageSyncChangeDetection cmdlet:

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "myCloudEndpointGUID"

Essa etapa pode demorar um pouco para ser concluída.

Importante

Depois que essa verificação de detecção de alterações na nuvem iniciada for concluída, observe a data e a hora em que ela foi concluída. Você precisará dela na seção a seguir.

Aguarde a conclusão de uma sessão de sincronização final

Para garantir que seus dados estejam atualizados no seu servidor local, aguarde a sessão final de upload da sincronização.

Para verificar esse status, acesse o Visualizador de Eventos no seu servidor local. Vá para o registro de eventos de telemetria (Aplicativos e Serviços\Microsoft\FileSync\Agente). Certifique-se de ver um evento 9102 com sync direction = download, HResult = 0 (sem erros) e PerItemErrorCount = 0 (todos os arquivos sincronizados com sucesso) que ocorreu após a detecção de mudança de data e hora na nuvem.