This site uses different types of cookies, including analytics and functional cookies (its own and from other sites). To change your cookie settings or find out more, click here. If you continue browsing our website, you accept these cookies.
on 08-05-202106:44 AM - edited on 08-05-202106:44 AM by SophiaF
How to downgrade Alteryx Server
Alteryx Server Upgrades can sometimes lead to unforeseen complications, creating an urgency to either resolve and or downgrade to avoid further disruption. While most issues can be resolved using resources on our community or by contacting Alteryx support, there are times when restoring to the last working version is a necessary step to address any underlying issues. This article provides on guidance on how to downgrade Alteryx Server.
A backup of the Runtimesettings prior to upgrading. Click here for the location. The restore will most likely complete without this file and only required for major functional changes between versions.
Versions 3.4 and 4.0 (Embedded)
Download the previous version of Alteryx from downloads.alteryx.com
This article assumes you already have administrator permissions.
Arrange downtime/maintenance window to perform downgrade
Please Note: Prior to downgrading its worth searching Alteryx community and contacting Alteryx Support to discuss the reasons for wanting to downgrade.
Important: Please ensure you have a backup of MongoDB prior to the upgrade. Without this you will NOT be able to downgrade.
Downgrade Alteryx Server
This procedure shows how to downgrade from Alteryx Server. For the purposes of this article we are downgrading from Alteryx Server 2021.2 to 2020.4 as an example.
Connect to the Alteryx Server (For multi-node environments the Controller Node hosting MongoDB (Embedded))
Note: If the service is stuck in a stopping state, its likely you have job running or queued. Please review this article for more info.
Open the Control Panel by Search Control Panel in the Start Menu
Click on Programs and Features and uninstall both Alteryx 2021.2 and Predictive Tools. (Note predictive tools may uninstall with server)
Click Remove and continue throughany prompts to uninstall the program. Check the Control Panel again to confirm both Alteryx Server Package and Predictive tools have been uninstalled.
Once completely uninstalled, Run the Alteryx Server Installer for 2020.4.6 (or whichever version your downgrading to). Remember to Right-click and select Run as administrator
Select the folder path to install to if different from the default location. and select Next.
Check the Licence Agreement and Click Next
Once the installation is complete, You will be prompted to install Predictive tools (see below). If you intend on staying on this version and have workflows that rely on predictive tools, Select Install the Predictive Tools before finishing. if not, you can skip this step.
Note: For Multi-node environments (i.e. Separate workers and gallery nodes) follow the same process of each node.
Restore MongoDB Database
The next step is to restore your MongoDB database to the previous version.
At this point the Alteryx Service should still be in a stop state.(check services.msc console to confirm). You can also stop the service via the cmd prompt as shown the example below
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()
Please Note: If you don't feel confident with the process please reach out to Alteryx Support for additional assistance.