Aggiornare GCDS

Se utilizzi una versione precedente di Google Cloud Directory Sync (GCDS), potresti non utilizzare al meglio lo strumento.

Di tanto in tanto, Google rilascia nuove versioni di GCDS. Ti consigliamo di installare l'ultima versione per assicurarti di avere le funzionalità e le correzioni più recenti. Per esaminare le integrazioni e i miglioramenti apportati alle versioni più recenti di GCDS, consulta le note di rilascio di Google Cloud Directory Sync.

Nota: l'assistenza Google Cloud è disponibile solo per i problemi rilevati nella versione più recente di GCDS.

Per aggiornare GCDS, puoi scegliere tra due opzioni. La maggior parte dei clienti può aggiornare la configurazione di GCDS sul posto. Tuttavia, se la tua organizzazione ti richiede di mantenere in esecuzione la configurazione esistente durante la configurazione e il test dell'ultima versione, puoi seguire le istruzioni per l'aggiornamento affiancato riportate di seguito.

Aggiornare la configurazione di GCDS esistente

Per aggiornare la configurazione di GCDS esistente, segui questi passaggi:

  1. Esegui una sincronizzazione di GCDS manuale, in modo da avere meno modifiche da esaminare dopo l'aggiornamento. Scopri di più
  2. Scarica la versione corretta di GCDS per la tua piattaforma:

  3. Apri il programma di installazione e segui le istruzioni visualizzate per installare GCDS.

    Se esegui l'installazione sullo stesso computer dell'attuale installazione di GCDS, il programma di installazione dovrebbe rilevare che GCDS è già installato e suggerire un upgrade.

  4. Dopo aver installato GCDS, avvia GCDS Configuration Manager:

    1. Seleziona File e poi Apri per caricare il file di configurazione XML esistente.

    2. Esamina le impostazioni del file di configurazione e salvalo.

      Nota:non sarà possibile eseguire una sincronizzazione finché il file di configurazione XML non viene salvato utilizzando la versione aggiornata di GCDS.

  5. Esegui una simulazione di sincronizzazione ed esamina le modifiche proposte. Scopri di più.

    Se sono elencate modifiche indesiderate, rivedi la configurazione, apporta le correzioni e salva il file XML.

  6. Se fai uso di un'utilità, come un'attività pianificata o un cron job, per eseguire GCDS, attiva il programma di pianificazione dei job manualmente per assicurarti che la sincronizzazione funzioni come previsto.

    Questo passaggio è particolarmente importante se il programma di pianificazione dei job viene eseguito da un utente di sistema diverso da quello utilizzato per configurare GCDS.

Aggiornamento side-by-side di GCDS

Per installare un'altra versione di GCDS, segui questi passaggi:

  1. Esegui una sincronizzazione di GCDS manuale, in modo da avere meno modifiche da esaminare dopo l'aggiornamento. Scopri di più
  2. Scarica la versione corretta di GCDS per la tua piattaforma:
  3. Apri il programma di installazione e segui le istruzioni visualizzate per installare GCDS.
    1. Se esegui l'installazione sullo stesso computer dell'attuale installazione di GCDS, il programma di installazione dovrebbe rilevare che GCDS è già installato e suggerire un upgrade.
    2. Seleziona No, installa in un'altra directory per installare la nuova versione in una posizione diversa, senza rimuovere la versione esistente.

  4. Dopo aver installato GCDS, avvia Configuration Manager.

    1. Verifica di utilizzare la nuova versione di GCDS selezionando Guida e poi Informazioni su Google Cloud Directory Sync.
    2. Seleziona File e poi Apri per caricare il file di configurazione XML esistente.

    3. Rivedi le impostazioni del file di configurazione e salvalo con un nuovo nome per creare una copia per questa nuova versione di GCDS.

      Nota:non sarà possibile eseguire una sincronizzazione finché il file di configurazione XML non viene salvato utilizzando la nuova versione di GCDS.

  5. Esegui una simulazione di sincronizzazione ed esamina le modifiche proposte. Scopri di più.

    Se sono elencate modifiche indesiderate, rivedi la configurazione, apporta le correzioni e salva il file XML.

    Nota:per assicurarti che GCDS visualizzi l'intera directory di Google Workspace, seleziona Svuota cache quando esegui una simulazione di sincronizzazione.

  6. Se fai uso di un'utilità, come un'attività pianificata o un cron job, per eseguire GCDS, aggiornala in modo che utilizzi la nuova versione, quindi attiva manualmente il programma di pianificazione dei job per assicurarti che la sincronizzazione funzioni come previsto.

    Questo passaggio è particolarmente importante se il programma di pianificazione dei job viene eseguito da un utente di sistema diverso da quello utilizzato per configurare GCDS.

  7. Per evitare modifiche indesiderate causate da un file di configurazione non aggiornato, assicurati che il file di configurazione della versione precedente sia disattivato. Ad esempio, rinomina il file XML da sync.xml a sync-DISABLED.xml.

  8. Quando avrai appurato che la nuova versione funziona come previsto, disinstalla la versione precedente per evitare confusioni.


Google, Google Workspace e i marchi e i loghi correlati sono marchi di Google LLC. Tutti gli altri nomi di società e prodotti sono marchi delle società a cui sono associati.