Upgrade Analytics Hub

This article walks you through the steps to upgrade Analytics Hub. Only follow these steps if you are upgrading. For the initial installation, see the Install and Configure article.

Download the Installer

Download the Analytics Hub installer from the Alteryx Downloads and Licenses portal. Follow these steps:

1. Go to the Alteryx Downloads and Licenses portal at licenses.alteryx.com.
2. Sign in or select Don’t have an account? Create one now. If you’re creating a new account, register with the email address associated with your Alteryx License.
3. Under Product Downloads, select Alteryx Analytics Hub.
4. On the Download Products page, select the version of the product you want to download. The latest version is available on the New Versions tab. Access previous versions on the Previous Versions tab.
5. To download the file, select the link for Analytics Hub in the File Name column.

Before You Install

LDAPS:// is not checking for certificates in 20.2 or 20.2.1. Without proper certs in place, it will revert to LDAP://. If you're using LDAPS://, make sure to have a local (non-LDAP) platform admin account set up before you upgrade in case LDAP authentication fails after upgrade due to the certificate issue. 

Make sure that there are no users currently using the platform or schedules running. Follow these steps to back up some of your files. If you’d like to do a full backup, see the Backup and Restore article. 

1. Open File Explorer.
2. Copy the following files to a safe location:
   1. SslCertificates folder (Default Location: C:\Program Files\Alteryx)
   2. CutlassSettings.yml (Default Location: C:\Program Files\Alteryx\Alteryx Analytics Hub)
   3. Settings.yml (Default Location: C:\Program Files\Alteryx\Alteryx Analytics Hub)
3. Move vfs folder (Default Location: C:\Program Files\Alteryx) to a safe location.
4. Open Windows Command Prompt and select Run as administrator.
5. Use this xcopy command to back up your Postgres folder:
   xcopy "<InstallLocation>\Alteryx Analytics Hub\Postgres\data" "C:\moved\data" /O /X /E /H /K
6. When prompted Does C:\moved\data specify a file name or directory name on the target (F = file, D = directory), select D on your keyboard to create a directory.
7. Open regedit (Windows Registry Editor).
8. Go to HKEY_LOCAL_MACHINE\SOFTWARE\Alteryx Inc.\Alteryx Analytics Hub\HubInstallKey.
9. Double-click InstallKey and copy the key in the Value Data field. Save the key as a text file in a safe location.
10. Uninstall Analytics Hub:
    1. In Windows, go to Settings > Apps & features. 
    2. Find Alteryx Analytics Hub and select Uninstall. 
    3. When the Alteryx Analytics Hub window opens, select Uninstall.
    4. Select Finish. 
11. Some files remain after uninstalling. Open File Explorer. 
12. Go to <InstallLocation>
13. Delete everything in the <InstallLocation> folder (Default Location: C:\Program Files\Alteryx). Your folder might be named something else. Note that this removes Alteryx Intelligence Suite, YXI tools, and Predictive and R tools.

Install

1. Run the Analytics Hub installer as an administrator. 
2. Enter the installation path where Analytics Hub was previously installed (Default Location: C:\Program Files\Alteryx).
3. Select Next.
4. Enter the Username and Password for your database. This is the same username and password that you created for the Postgres admin during the initial installation of Analytics Hub.
5. Select Next.
6. Enter the same credentials that you used for your original Platform Admin.
7. Select Next.
8. Select Finish.

After Installation

1. Open Services and stop these services:
   1.  AAHBackend 
   2. AAHFrontend 
   3. Alteryx Engine Worker
   4. Alteryx License Service
   5. AlteryxPostgreSql
2. Open regedit (Windows Registry Editor).
3. Go to HKEY_LOCAL_MACHINE\SOFTWARE\Alteryx Inc.\Alteryx Analytics Hub\HubInstallKey and replace the value of InstallKey with the key you saved.
4. Return the files you copied or moved to the original locations:
   1. SslCertificates folder (Default Location: C:\Program Files\Alteryx)
   2. CutlassSettings.yml (Default Location: C:\Program Files\Alteryx\Alteryx Analytics Hub)
   3. Settings.yml (Default Location: C:\Program Files\Alteryx\Alteryx Analytics Hub)
   4. vfs folder (Default Location: C:\Program Files\Alteryx)
5. Open Windows Command Prompt and select Run as administrator.
6. Use this xcopy command to copy your Postgres data folder back:
   xcopy "C:\moved\data" "<InstallLocation>\Alteryx Analytics Hub\Postgres\data" /O /X /E /H /K
7. Copy pg_hba.conf from <InstallLocation>\Alteryx Analytics Hub\pg_hba.conf to <InstallLocation>\Alteryx Analytics Hub\Postgres\data\pg_hba.conf.
8. Open Services and restart these services:
   1.  AAHBackend 
   2. AAHFrontend 
   3. Alteryx Engine Worker
   4. Alteryx License Service
   5. AlteryxPostgreSql
9. (Optional) Reinstall Alteryx Intelligence Suite, YXI tools, and Predictive and R tools.

Next, upgrade your Analytics Hub Engine Workers.