Atualizar o GCDS

Se você usa uma versão mais antiga do Google Cloud Directory Sync (GCDS), talvez não esteja aproveitando todos os recursos da ferramenta.

Às vezes, o Google lança novas versões do GCDS. Recomendamos instalar a versão mais recente para ter acesso aos recursos e correções mais recentes. Para conferir as adições e melhorias nas versões mais recentes do GCDS, consulte as notas da versão do Google Cloud Directory Sync.

Observação: o suporte do Google Cloud só ajuda com problemas encontrados na versão mais recente do GCDS.

Há duas opções para atualizar o GCDS. A maioria dos clientes pode atualizar a configuração do GCDS no local. No entanto, caso sua organização exija que você mantenha a configuração existente, siga as instruções de atualização lado a lado abaixo ao configurar e testar a versão mais recente.

Atualização do GCDS no local

Para atualizar a configuração do GCDS, siga estas etapas:

  1. Faça uma sincronização manual do GCDS para analisar menos alterações após a atualização. Saiba mais
  2. Faça o download da versão correta do GCDS para sua plataforma:

  3. Abra o instalador e siga as instruções para instalar o GCDS.

    Quando o GCDS já está instalado no computador, o instalador identifica a ferramenta e sugere um upgrade.

  4. Após instalar o GCDS, inicie o Gerenciador de configuração do GCDS:

    1. Selecione Arquivo e depois Abrir para carregar o arquivo de configuração XML.

    2. Analise as arquivo de configuração e salve-o.

      Observação:você só poderá fazer uma sincronização depois que o arquivo de configuração XML tiver sido salvo com a versão atualizada do GCDS.

  5. Simule a sincronização e analise as alterações propostas. Saiba mais

    Se houver mudanças indesejadas, revise a configuração, faça as correções e salve o arquivo XML.

  6. Se você usar um utilitário, como uma tarefa agendada ou um cron job, para executar o GCDS, acione o programador de jobs manualmente para garantir que a sincronização funcione conforme o esperado.

    Esta etapa é especialmente importante se o utilitário programador de jobs for executado por um usuário do sistema diferente do utilizado para configurar o GCDS.

Atualização lado a lado do GCDS

Para instalar outra versão do GCDS, siga estas etapas:

  1. Faça uma sincronização manual do GCDS para analisar menos alterações após a atualização. Saiba mais
  2. Faça o download da versão correta do GCDS para sua plataforma:
  3. Abra o instalador e siga as instruções para instalar o GCDS.
    1. Quando o GCDS já está instalado no computador, o instalador identifica a ferramenta e sugere um upgrade.
    2. Selecione Não, instalar em um diretório diferente para instalar a nova versão em outro local, sem remover a versão atual.

  4. Após instalar o GCDS, inicie o Gerenciador de configuração.

    1. Para confirmar se você está usando a nova versão do GCDS, selecione Ajuda e depois Sobre o Google Cloud Directory Sync.
    2. Selecione Arquivo e depois Abrir para carregar o arquivo de configuração XML.

    3. Analise as configurações do arquivo e salve-o com um novo nome para criar uma cópia para essa nova versão do GCDS.

      Observação:você só poderá fazer uma sincronização depois que o arquivo de configuração XML tiver sido salvo com a nova versão do GCDS.

  5. Simule a sincronização e analise as alterações propostas. Saiba mais

    Se houver mudanças indesejadas, revise a configuração, faça as correções e salve o arquivo XML.

    Observação:para garantir que o GCDS veja todo o diretório do Google Workspace, selecione Limpar cache ao executar uma simulação de sincronização.

  6. Se você usar um utilitário, como uma tarefa agendada ou um cron job, para executar o GCDS, atualize-o para usar a nova versão e acione o programador de jobs manualmente para garantir que a sincronização funcione conforme o esperado.

    Esta etapa é especialmente importante se o utilitário programador de jobs for executado por um usuário do sistema diferente do utilizado para configurar o GCDS.

  7. Para evitar mudanças indesejadas devido a um arquivo de configuração desatualizado, desative o arquivo de configuração da versão anterior. Por exemplo, renomeie o arquivo XML sync.xml como sync-DISABLED.xml.

  8. Depois de confirmar que a nova versão está funcionando conforme o esperado, desinstale a versão anterior para evitar confusão.


Google, Google Workspace e marcas e logotipos relacionados são marcas registradas da Google LLC. Todos os outros nomes de empresas e produtos são marcas registradas das empresas às quais estão associados.