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

If you have migrated from MongoDB to user-managed MSSQL, you will NOT be able to downgrade to a release earlier than 2024.1 because SQL Server support is only available starting in 2024.1.

To downgrade from a user-managed SQL environment, you need to first switch back to the last version of MongoDB you were using before you migrated to SQL. If you made a backup of your MongoDB before the migration, you can switch it out with your current SQL database. You can do this by updating the connection strings in Alteryx System Settings for the Controller and Server UI to point to the old MongoDB again. Refer to this knowledge article on Server Backup Recovery for more backup details. Note that by doing this, you will be reverting back to the MongoDB at the point in time you did the migration, so any changes made to the environment after the migration to SQL will not be present in your old 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 il servizio Alteryx e seleziona Arresta invece di 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. 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 .

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 noti gli errori riportati di seguito, contatta l' Assistenza Alteryx per indagare.

    • 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: