Skip to main content

Downgrade di Alteryx Server

Questo articolo fornisce indicazioni su come eseguire il downgrade di Alteryx Server.

Gli aggiornamenti di Alteryx Server talvolta possono generare complicazioni impreviste che vanno risolte o impongono la necessità di un downgrade per evitare ulteriori interruzioni. Puoi risolvere la maggior parte dei problemi con le risorse disponibili nella nostra pagina della community o contattare l'Assistenza Alteryx. In alcuni casi, è necessario ripristinare la versione funzionante più recente per risolvere i problemi.

Nota

Prima di effettuare il downgrade, puoi consultare la community di Alteryx e contattare l'Assistenza di Alteryx per analizzare i motivi del downgrade.

Importante

Assicurati di disporre di un backup di MongoDB prima dell'aggiornamento. Senza il backup, NON sarà possibile effettuare il downgrade.

Importante

Se hai eseguito la migrazione da MongoDB a MSSQL gestito dall'utente, NON potrai effettuare il downgrade a una release precedente alla 2024.1 poiché il supporto di SQL Server è disponibile solo a partire dalla versione 2024.1.

Per eseguire il downgrade da un ambiente SQL gestito dall'utente, è necessario prima tornare all'ultima versione di MongoDB utilizzata prima della migrazione a SQL. Se hai eseguito un backup di MongoDB prima della migrazione, puoi sostituirlo con il database SQL corrente aggiornando le stringhe di connessione nelle impostazioni di sistema di Alteryx in modo che l'interfaccia utente del controller e di Server faccia nuovamente riferimento alla versione precedente di MongoDB. Per ulteriori informazioni sul backup, consulta questo articolo della Knowledge base sul ripristino del backup di Server. Questa operazione ripristinerà MongoDB così com'era nel momento in cui è stata eseguita la migrazione, pertanto eventuali modifiche eseguite nell'ambiente dopo la migrazione a SQL non saranno presenti nella versione precedente di MongoDB.

Ambiente

  • Alteryx Server (tutte le versioni)

  • MongoDB integrato o gestito dall'utente (tutte le versioni)

Prerequisiti

  • Autorizzazioni di amministratore sul computer che ospita Server.

  • Finestra di inattività (manutenzione) di Server per eseguire il downgrade.

    La pianificazione di una finestra di inattività di Server non è un requisito e dipende dalle policy interne. La durata della finestra di inattività dipende dalla configurazione e dalle dimensioni del database.

  • File del programma di installazione per la versione precedente di Server da installare.

  • Backup di MongoDB della versione precedente che desideri installare. Per ulteriori informazioni, consulta l'articolo Procedure di backup e ripristino di Alteryx Server.

  • Se esegui il downgrade dalla versione 2022.3+ a una versione precedente alla 2022.3, devi eseguire il backup del file RuntimeSettings.xml per l'aggiornamento alla versione 2022.3+: C:\ProgramData\Alteryx\RuntimeSettings.22_2_legacy.xml

Downgrade di Alteryx Server

Questa procedura mostra come eseguire il downgrade da Alteryx Server a una versione precedente in esecuzione nello stesso ambiente. In questo articolo viene eseguito il downgrade da Alteryx Server 2023.1 alla versione 2022.3 a titolo esemplificativo.

  1. Attiva la connessione ad Alteryx Server. Per gli ambienti multinodo, connettiti al nodo del controller che ospita MongoDB integrato o gestito dall'utente.

  2. Apri la console Services.msc e arresta il servizio.

    Per ulteriori informazioni su come arrestare il servizio, consulta Come avviare AlteryxService. Nella procedura A descritta in questo articolo, utilizza Arresta anziché Avvia.

  3. Per aprire il pannello di controllo, cercalo nel menu Start.

  4. Seleziona Programmi e disinstalla Alteryx Server 2023.1. Il programma di disinstallazione disinstalla automaticamente anche gli strumenti predittivi di Alteryx.

    downgrade_Server_01_03.png

  5. Se esegui il downgrade dalla versione 2022.3+ a una versione precedente alla 2022.3, devi ripristinare il file originale RuntimeSettings.xml.

    1. Accedi alla cartella in cui si trova il file RuntimeSettings.xml (ad esempio, %ProgramData%\Alteryx\RuntimeSettings.xml), fai clic con il pulsante destro del mouse e seleziona Rinomina. Rinomina il file in RuntimeSettings_rollback_bkp.xml.

    2. Nella stessa cartella, rinomina RuntimeSettings.22_2_legacy.xml in RuntimeSettings.xml facendo clic con il pulsante destro del mouse e selezionando Rinomina.

  6. Al termine della disinstallazione, esegui il programma di installazione di Alteryx Server per la versione 2022.3 (o la versione precedente che desideri installare). Fai clic con il pulsante destro del mouse sul file di installazione e seleziona Esegui come amministratore.

    Nota

    Assicurati di eseguire il downgrade alla stessa versione utilizzata in precedenza, fino al livello di patch. Se non sei certo della patch utilizzata in precedenza, esegui il downgrade alla patch più recente della versione.

  7. Leggi il Contratto di licenza e seleziona Avanti.

  8. Seleziona il percorso della cartella di destinazione, se è diverso da quello predefinito, quindi scegli Avanti.

    downgrade_Server_02_02.png

  9. Al termine dell'installazione, ti verrà chiesto di installare gli strumenti predittivi, come mostrato nell'immagine seguente. Se desideri continuare a utilizzare questa versione e hai flussi di lavoro che si basano sugli strumenti predittivi, seleziona Installa strumenti predittivi e scegli Fine. In caso contrario, seleziona Chiudi ed esegui Alteryx Designer in un secondo momento, quindi seleziona Fine.

    downgrade_Server_03_02.png

Nota

Negli ambienti multinodo, segui lo stesso processo per ogni nodo.

Ripristino di MongoDB

Nel passaggio successivo, ripristina la versione precedente del database MongoDB.

  1. A questo punto, Alteryx Service dovrebbe risultare ancora arrestato. Per confermare, controlla la console Services.msc.

  2. Rename the current Persistence folder to “MongoDB_failedUpgradeAttempt_to_version##”.  While this folder is no longer in use, it’s best practice to avoid deleting files and folders during a Server incident.

  3. Recreate the Persistence folder in File Explorer. The folder is now empty and ready for the database restore.

  4. Ripristina MongoDB dall'ultimo backup proveniente dalla versione precedente che desideri installare. I passaggi per ripristinare MongoDB e verificare l'esito dell'operazione sono disponibili nella sezione Ripristino da un backup MongoDB nella pagina di assistenza Backup di MongoDB.

Nota

To confirm your Persistence folder, go to Alteryx System Settings > Controller > Persistence > Data Folder, or go to C:\ProgramData\Alteryx\RuntimeSettings.xml and search for <EmbeddedMongoDBEnabled>.

Controlli successivi al downgrade

  • Verifica che l'interfaccia utente di Server sia accessibile e che il contenuto previsto, come utenti, flussi di lavoro e pianificazioni, sia stato ripristinato.

  • Verifica la presenza di blocchi imprevisti nei log di Server. Verifica le posizioni dei file di log in Come allegare i file di log di Server. Se appaiono gli errori riportati di seguito, elimina i blocchi eseguendo il comando Mongo db.locks.remove({}). Al termine dell'operazione, dovrebbe apparire "writeResult({ “nRemoved” : N })", dove N è un numero compreso tra 0 e 3.

    • 2020-05-11 15:53:06.564593,FATAL,18,QueueWorker,RunOnce,,,,LD-LT-241,,,,,,Lock obtain timed out: MongoDB.Lucene.MongoDocumentLock->Retry in (1) seconds...,"Lucene.Net.Store.LockObtainFailedException: Lock obtain timed out: MongoDB.Lucene.MongoDocumentLock-context, String name)

    • 2020-05-11 15:33:59.700855,FATAL,20,QueueWorker,RunOnce,,,,LD-LT-241,,,,,,Failed to obtain IndexWriter lock.->Retry in (1) seconds...,System.Exception: Failed to obtain IndexWriter lock. -> at Alteryx.Server.Models.BackgroundThread.QueueWorker.RunOnce()

Nota

In caso di dubbi sul processo, contatta l'Assistenza Alteryx.

In questa sezione: