HandyCafe Docs
it-admin

Sincronizacao de Arquivos

A Sincronizacao de Arquivos permite que administradores distribuam arquivos do HandyCafe Server para PCs clientes pela rede. Ela utiliza uma abordagem baseada em manifesto para garantir que apenas arquivos alterados ou novos sejam transferidos, minimizando o uso de largura de banda e o tempo de sincronizacao.

Explorador de Sincronizacao

O Explorador de Sincronizacao fornece uma interface de navegacao de arquivos para selecionar quais diretorios e arquivos devem ser sincronizados com os clientes. Os administradores navegam pelo sistema de arquivos do servidor, selecionam o conteudo desejado e iniciam a operacao de sincronizacao.

Como a Sincronizacao Funciona

Comparacao Baseada em Manifesto

Quando uma operacao de sincronizacao comeca, o servidor gera um manifesto de arquivos -- uma lista de todos os arquivos a serem sincronizados junto com seus checksums. Cada cliente compara esse manifesto com seus proprios arquivos locais:

  • Arquivos que nao existem no cliente sao marcados para download.
  • Arquivos cujos checksums diferem (indicando que foram modificados) sao marcados para download.
  • Arquivos que coincidem sao ignorados completamente.

Essa abordagem garante que apenas o delta entre servidor e cliente seja transferido, tornando sincronizacoes repetidas rapidas e eficientes.

Transferencia Baseada em Blocos

Arquivos grandes sao divididos em blocos menores para transferencia via TCP. Isso oferece diversos beneficios:

  • Confiabilidade -- Se um bloco falhar na transferencia, apenas aquele bloco precisa ser reenviado em vez do arquivo inteiro.
  • Rastreamento de progresso -- O progresso da transferencia pode ser reportado no nivel do bloco.
  • Eficiencia de rede -- Os tamanhos dos blocos sao ajustados para funcionar bem em condicoes tipicas de rede local.

Iniciando uma Sincronizacao

Administradores podem iniciar a sincronizacao de arquivos de duas formas:

  • Sincronizar para todos os clientes -- Envia os arquivos selecionados para todos os clientes conectados simultaneamente.
  • Sincronizar para clientes especificos -- Direciona um ou mais clientes individuais para a operacao de sincronizacao.

A sincronizacao pode ser iniciada manualmente pela interface do Explorador de Sincronizacao sempre que novo conteudo precisa ser distribuido.

Relatorio de Sincronizacao

Apos uma operacao de sincronizacao, cada cliente reporta seu status de volta ao servidor:

  • Sucesso -- Todos os arquivos foram sincronizados sem erros.
  • Falha -- Um ou mais arquivos falharam na transferencia, com detalhes sobre quais arquivos e por que.
  • Arquivos sincronizados -- Uma contagem de quantos arquivos foram efetivamente baixados (excluindo arquivos ignorados que ja estavam atualizados).

Esses relatorios sao visiveis no Explorador de Sincronizacao, permitindo que administradores verifiquem se a operacao foi concluida conforme esperado.

Casos de Uso

  • Distribuir atualizacoes de jogos -- Envie patches ou atualizacoes de jogos para todos os PCs de uma vez, garantindo que todas as maquinas executem a mesma versao.
  • Enviar arquivos de configuracao -- Distribua arquivos de configuracao atualizados (como opcoes de rede ou preferencias de aplicativos) para todos os clientes.
  • Distribuir software -- Instale novos aplicativos nos PCs clientes sincronizando pacotes de instalacao ou aplicativos portateis.
  • Atualizar recursos do menu do cliente -- Sincronize novos icones, posters ou arquivos de midia usados pela interface do menu do cliente.