Failover Controller(s) Configuration

Version:
2021.3
Last modified: November 10, 2021

The next step is to configure your failover controller(s). To ensure a seamless failover, each controller in the cluster needs to use the same controller token and Storage Keys for encryption. 

  1. For each failover controller, complete the Controller setup per the primary controller setup.  

  1. 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. Run the following command, replacing {Controller Token} with the value copied from step 3 of the Primary Controller ConfigurationAlteryxService.exe setserversecret={Controller Token} 
      Run the following command, replacing {Controller Token} with the value copied from step 3 of the Primary Controller Configuration.

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

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

  2. 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.  

  3. From the Controller section, copy the StorageKeysEncrypted key.  
     

    Example

    BwIAAACkAACunN7PkZcdMRM2N5pW+NRyqCdBiLuVqWRJELqix6Dg3ZAitUq9BbdlSLS8Ez+me45oiNGd​​​​8oJVo2itY4JN/RXp4iJJ+obK96UtL8h2k2nq5XZ9GEDANIurhnm5Ww/nKxUw7O0LXtqftXpXLkbD5n/+YAs58i
    5D4O0FAMcD0M+u06vC1zHMmTHSU9G+D6isaVgxQtHMOLP0zTzA+97UDkE0pQOK2IQPnSh58UpHEmQ
    wo3Gmp+qz3Qp//BkzMMa2Li8eXOmmxTSLpjS+syBiglS5Zu1QFgnxKnQRknex+IGRbCTbva1CIQPqAr/kCK/
    xgfMO4z1cZjDHt3vmLNr/U6xyr8WLlH1TiGTBg3c3s9zMlXvd9ZifFfoI62QVEFtH6TCrhTLxsIphbj/VOtLtKaY
    wwYVx/4GpwU7qEMWgG0sFuFSpw9+54b2NJk7avBxIU5EVaFsbBfWRULzazwjVaA5e93NZ6Q1qm/FCfAM
    pQCO7DnZoxdLr4oYLm+w5MOf5QUX3l/zqIiUcbDQHa5q

  4. 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. 

Was This Page Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support. Can't submit this form? Email us.