Alteryx Server Knowledge Base

Definitive answers from Server experts.

AlteryxService fails to start after upgrade from Alteryx Server 9.5 to 10.1+

fadib
Alteryx Alumni (Retired)
Created

As part of the upgrade from Alteryx Server 9.5 to 10.0+, the Mongo DB Alteryx Server uses for the persistence layer will be upgraded to MongoDB 3.0. During this process a backup of the existing database is created under the folder MongoDB_preAlteryx10 and the upgraded Database is created under the MongoDB_Alteryx10 folder. The existing persistence database, MongoDB, is not touched.

1.png

After completing the update, some users were unable to start AlteryxService (usually experiencedas browsing to thelocal Alteryx Gallery returnsan error page)becausethe configuration files were still pointing to the old Alteryx persistence database, MongoDB, instead of the upgraded one MongoDB_Alteryx10.

To get the service starting, the user must manually point to the MongoDB_Alteryx10 persistence directory in the Alteryx System Settings application.

Steps to get AlteryxService to start:

  • First identify the correct folder where the persistence layer exists. You can check by launching the Alteryx System Settings application, and navigating to the Persistence Settings under Controller:

2.png

3.png

  • Copy the path shown under Data Folder up to Persistence (C:\ProgramData\Alteryx\Service\Persistence) and paste it in a File Explorer window; you should be able to see the different copies of the Persistence layer.

4.png

  • Double-click the MongoDB_Alteryx10 folder, copy the full path from the File Explorer bar and paste it in place of the existing path under Data Folder.

5.png

6.png

  • Follow through with the rest of the configuration steps in the Alteryx System Settings app and press Done at the last step. This should restart the service.

7.png

  • You can check if the service is running by opening the Task Manager and checking the status of AlteryxService under the Services Tab. You can attempt to restart the service for this windows as well by right-clicking on AlteryxService and selecting Start Service.

8.png

If you still can't get AlteryxService to start:

  • From the Start Menu, search for CMD, right-click and press Run As Administrator.
  • Navigate to the location of the Alteryx installation by typing: cd "C:\ProgramFiles\Alteryx\bin" then pressing return (the part after cd depends on where you have Alteryx installed)
  • Type: AlteryxService Test and press return. Once the command stops running, take a screenshot of the window and send it to support@alteryx.com; a Customer Support Engineerwill reach out to you for further support.

9.png