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.1x 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\MongoDBoriginale.
Organizzazione della cartella di aggiornamento alla versione MongoDB 2021.3.6+
Organizzazione della cartella di aggiornamento alla versione MongoDB 2018 - 2021.3.5
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:
Arresta AlteryxService.
Esegui il backup di MongoDB.
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.
Avvia Mongo.
Avvia AlteryxService.
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:
Arresta AlteryxService.
Esegui il backup del database come da documentazione Mongo Atlas.
Utilizza il pulsante Aggiorna versione come da documentazione Mongo.
Avvia AlteryxService.
Verifica che Server e i flussi di lavoro funzionino come previsto.