High-availability installation
------------------------------

This topic discusses Enterprise Steam high availability in the context of active-passive configurations only; active-active configurations are currently unsupported.

Automatic restart
~~~~~~~~~~~~~~~~~

On systemd Linux distributions, Enterprise Steam is configured to automatically restart on failure.

Active-Passive Setup
~~~~~~~~~~~~~~~~~~~~

1. Prepare two or more servers for Enterprise Steam. One will server as primary and the others as backups.
2. Proceed with normal installation of Enterprise Steam on all servers. Do not start the service yet.
3. Provision a shared storage and mount it, so it is accessible for reading and writing on all servers.
4. Edit ``/opt/h2oai/steam/conf/steam.yaml`` and set ``STEAM_DATA_DIRECTORY`` to point to the shared storage.
5. Start Enterprise Steam on the primary and finish the setup.

Manual failover
~~~~~~~~~~~~~~~

In the event of a failure of the primary that did not get resolved by automatic restart, start the backup and reroute the load-balancer.