Installing a Failover (HA) Server
  • 04 Aug 2022
  • 3 Minutes to read
  • Dark
    Light
  This documentation version is deprecated, please click here for the latest version.

Installing a Failover (HA) Server

  • Dark
    Light

Article summary

Important Note
  • It is recommended that the user replicates SQL and the File Storage location when installing a Failover (HA) Server.

Overview 

This tutorial demonstrates how to install the Decisions platform as a Failover (HA) Server. This server type is identical to the Standard Server, except that it is not live until a setting is toggled. 

Upon installation, this server will add an <Offline> attribute to the settings.xml file that will be set to "True" which will prevent all users, except administrators, from logging into the server. In addition, the keys.dat and databaseid.txt file in the Failover (HA) Server file system must be replaced with the same files from the production environment file system so that it can operate identically in a disaster event.

The best use case for this install option is for a Disaster Recovery server that will stand up in an entirely different data center or hosting region. Otherwise, a cluster should be built if a Failover (HA) Server in the same region is desired. 

For more information, navigate to the Decisions Disaster Recovery Architecture article.

Self-Hosted Example

  1. Right-click the downloaded DecisionsServerInstaller application to Run as administrator.
  2. Select Install for the Installation Type.
  3. Then, read through the Decisions Software License Agreement and click the Next button. 
  4. Next, select the appropriate Installation Type. For this example, Failover (HA) Server is selected. Once done, click Next.
  5.  The Advanced Settings are listed and described in the table beneath the image below. Once done, click Next. 
    Show Advanced Settings
    This guide progresses with the Advanced Settings option checked to show customization of all installation options.


    Use Settings FileEnables a field that allows the selection of a 'saved settings' file from a previous installation.
    Install Emergency Password Reset ToolInstalls a command prompt tool that is used for resetting the user password in Decisions.
    Change Default System Administrator, Username and PasswordOffers an option to change the default Decisions account to something other than admin@decisions.com with the 'admin' password. Reveals a text box for the desired email and password, with a password confirmation box.
    Change Destination Folder for InstallationDecisions is installed to C:\Program Files\Decisions by default. This allows for the installation location to be changed.
    Pick Alternate SourceAllows for the selection of an alternate source for the installation files via URL or file directory.
    Show the Service SettingsEnabling this setting makes it possible to customize the username and password under which the Service Host Manager will run.
    Allow Dynamic Resource Loading (Local Module)Allows the system to store and load sources from local modules.
    Run Service Host Manager Watcher after InstallationRecommended so that Host Manager Watcher will run after the installation is complete. This is the service that can start and stop Service Host Manager if needed, as well as catching unexpected stops and attempting a restart automatically. 
    Skip DB Connection Testing - Not RecommendedSkips the database connection test at the end of the installation wizard. This is not recommended.
    Dynamic Compression (IIS) Check Disabled - Not RecommendedDisables the installer from checking for IIS Compression. This is not recommended. 
  6. Continue the installation as demonstrated in the Installation Guide. Following a successful installation, reopen the Decisions installer, and click EDIT SETTINGS.
  7.  In the Settings window, navigate to the DatabaseConnectString and ensure the Initial Catalog matches the database name used for the primary server.
  8. Then, navigate to the Offline attribute and use the drop-down menu to set it to "True". Click Save and exit.
  9. Lastly, replace the keys.dat and databaseid.txt files in the Failover (HA) Server file system with the keys.dat and databaseid.txt file from the primary server; the files must be identical in order for the new server to operate as the primary server in a disaster event. For this installation, the files can be found in the C:\Program Files\Decisions\Decisions Server\Instances\Control folder.

Was this article helpful?