Failover Controller(s) Configuration

After configuring each failover node, you need to set the Controller Token on each of the Controller failover nodes.

1. Open an Administrative Command Prompt.

2. In the command prompt, navigate to the Alteryx Server installation Directory (default: C:\Program Files\Alteryx\bin).

3. Restore DCME keys. This feature is only available from 2023.1 Patch 2.

   The steps in Encryption Key Transfer Process will allow you to transfer the DCM encryption key from your existing controller to your new one.

   Please note that this requires the Alteryx Service to be running on your original Server Controller node and your new Server will need to be able to access it over the network.

4. Run the following command, replacing {Controller Token} with the value copied from step 3 of the Primary Controller Configuration: AlteryxService.exe setserversecret={Controller Token}

   

5. Confirm that the Controller Token was set by running the following command: AlteryxService.exe getserversecret

6. If running, stop the AlteryxService with the following command: net stop AlteryxService

Finally, you need to copy the StorageKeysEncrypted value from the primary Controller to each of the nodes in the failover cluster.

1. Open Notepad on the primary Controller.

2. From the File menu, select Open.

3. Open the RuntimeSettings.xml file located at C:\ProgramData\Alteryx.

From the Controller section, copy the StorageKeysEncrypted key.

On each of the Failover nodes in the cluster:

1. Open Notepad as an administrator.

2. From the File menu, select Open.

3. Open the RuntimeSettings.xml file located at C:\ProgramData\Alteryx.

4. Replace the StorageKeysEncrypted key with the value copied from the primary Controller.

5. Save the RuntimeSettings.xml file.

6. Close Notepad.