Skip to main content

Best practice per gli aggiornamenti di MongoDB in Server

Aggiornamento dello schema per MongoDB integrato e gestito dall'utente

La maggior parte degli aggiornamenti trimestrali modifica lo schema del database per integrare nuove funzionalità. La migrazione dello schema viene eseguita automaticamente alla prima attivazione del servizio Alteryx Server dopo l'aggiornamento. Anche se l'operazione è automatica, eventuali problemi nel processo possono impedire l'avvio di Server.

Verifica i controlli pre-aggiornamento di Alteryx poiché questo è il modo migliore per assicurarti che lo schema del database Mongo sia pronto per la migrazione senza errori.

Per confermare la migrazione dello schema alla versione prevista dopo l'avvio del servizio Alteryx Server, controlla la fine del log di migrazione e confrontala con lo schema corretto per la versione di Server: C:\ProgramData\Alteryx\Gallery\Logs\alteryx-migration.csv

Per ulteriori informazioni sullo schema MongoDB, consulta la pagina di assistenza Riferimento dello schema MongoDB .

Verifica della necessità di aggiornare la versione del database Mongo

Il riferimento dello schema MongoDB include la "Versione MongoDB integrata" e la "Versione MongoDB supportata per le istanze gestite dall'utente" per ciascuna versione di Server.

MongoDB integrato

  • Se appare un aggiornamento di versione, questo viene eseguito automaticamente al termine del processo di aggiornamento di Server. Consulta i dettagli di seguito per informazioni sulla quantità di spazio libero necessario e sulle cartelle che è possibile eliminare o archiviare al termine dell'aggiornamento.

  • Se stai effettuando un aggiornamento importante (ad esempio da 2019.2 a 2021.4) che prevede 2 upgrade della versione Mongo (da 3.4 a 4.0 e da 4.0 a 4.2), è necessario installare prima una versione di Server che utilizza la versione intermedia di Mongo (quindi da 2019.2 a 2019.3 per l'aggiornamento a Mongo 4.0 e da 2019.3 a 2021.4 per l'aggiornamento a Mongo 4.2).

MongoDB gestito dall'utente

Noterai che per ogni versione di Server sono supportate più versioni di Mongo. Verifica se l'aggiornamento di Mongo è obbligatorio o opzionale.

Aggiornamento della versione per diversi tipi di MongoDB

Alcuni aggiornamenti di Server interessano anche la versione integrata di MongoDB. La Guida all'aggiornamento tra versioni definisce tali aggiornamenti come upgrade intermedi. Per l'aggiornamento di MongoDB, puoi passare direttamente da una versione precedente a una versione successiva a uno di questi upgrade intermedi, a condizione che non salti 2 upgrade intermedi.

Importante

Se l'aggiornamento di Server interessa anche il database Mongo, avrai bisogno di uno spazio libero pari a 1-3 volte la dimensione del database Mongo corrente durante l'aggiornamento.

Se l'aggiornamento di Server non interessa la versione del database Mongo, non viene utilizzato spazio aggiuntivo durante l'operazione e questa sezione non è applicabile.

Per pianificare lo spazio necessario, controlla la dimensione della versione corrente di MongoDB.

Cartella: C:\ProgramData\Alteryx\Service\Persistence\MongoDB

  • Backup manuale del database prima dell'aggiornamento, Backup di MongoDB . Per risparmiare spazio, è possibile archiviare il backup prima di procedere.

  • Durante l'aggiornamento di Mongo, il database viene copiato in una cartella \MongoDB_PreUpgrade . Durante l'aggiornamento di Server viene chiesto di specificare il percorso di questa cartella e di scegliere un'altra unità sul computer. Sebbene sia possibile specificare un percorso di rete, questa operazione non è consigliabile in quanto un problema di connessione potrebbe compromettere il funzionamento di un database di grandi dimensioni.

  • Per gli aggiornamenti di Server 2018-2021.3.5, il database aggiornato viene creato in una nuova cartella denominata \MongoDB_MongoVer . Dopo l'aggiornamento, è possibile eliminare la cartella \MongoDB originale.

Organizzazione della cartella di aggiornamento alla versione MongoDB 2021.3.6+

MongoDB Version Upgrade folder organization 2021.4+

Organizzazione della cartella di aggiornamento alla versione MongoDB 2018 - 2021.3.5

MongoDB Version Upgrade Folder Organization 2018 - 2021.3

Se devi o desideri aggiornare la versione locale di Mongo gestito dall'utente, devi procedere indipendentemente da Alteryx Server. Non eseguire l'aggiornamento di entrambi i prodotti contemporaneamente senza aver testato accuratamente Server dopo aver aggiornato l'applicazione.

Per aggiornare la versione locale di Mongo gestito dall'utente:

  1. Arresta AlteryxService.

  2. Esegui il backup di MongoDB.

  3. Segui le raccomandazioni di Mongo per l'aggiornamento, poiché potrebbero essere richiesti upgrade intermedi. Ad esempio, se esegui la migrazione da Mongo 3.4 a 4.0, Mongo consiglia di passare dalla versione 3.4 alla versione 3.6 e successivamente da 3.6 a 4.0.

  4. Avvia Mongo.

  5. Avvia AlteryxService.

  6. Verifica che Server e i flussi di lavoro funzionino come previsto.

Per ulteriori informazioni, consulta i seguenti articoli:

Se devi o desideri aggiornare la versione di MongoDB Atlas gestito dall'utente, devi procedere indipendentemente da Alteryx Server. Non eseguire l'aggiornamento di entrambi i prodotti contemporaneamente senza aver testato accuratamente Server dopo aver aggiornato l'applicazione.

Per aggiornare Mongo Atlas gestito dall'utente:

  1. Arresta AlteryxService.

  2. Esegui il backup del database come da documentazione Mongo Atlas.

  3. Utilizza il pulsante Aggiorna versione come da documentazione Mongo.

  4. Avvia AlteryxService.

  5. Verifica che Server e i flussi di lavoro funzionino come previsto.