Failover configuration options reference

Configure failover options in the opscenterd.conf file, which is located at /etc/opscenter/opscenterd.conf for package installations, and at INSTALL_DIRECTORY/conf/opscenterd.conf for tarball installations.

edit opscenterd.conf, and then add a [failover] section.

The following example increases the default values, sets a custom directory location for failover configuration (package installation), and overrides the primary redirect URL with a non-standard port:

opscenterd.conf
[failover]
heartbeat_period = 20
heartbeat_reply_period = 360
heartbeat_fail_window = 120
failover_configuration_directory = /myrsyncdir/opscenter/failover/
override_primary_redirect_url = https://opscenter:9999

Restart OpsCenter after making configuration changes.

The following options are available:

  • [failover] heartbeat_period

    How often OpsCenter should heartbeat to the backup. Default: 10 seconds.

  • [failover] heartbeat_reply_period

    How often a backup OpsCenter should heartbeat to the primary Opscenter. Default: 300 seconds.

  • [failover] heartbeat_fail_window

    The amount of time required before a lack of heartbeat triggers failover. Default: 60 seconds.

  • [failover] failover_configuration_directory

    The directory where failover specific configuration is stored. This directory should not be mirrored/replicated across OpsCenter installs when configuring OpsCenter to support failover. The default location is /var/lib/opscenter/failover/ for package installations and install_location/failover/ for tarball installations.

  • [failover] override_primary_redirect_url

    If set, overrides the primary OpsCenter URL automatically generated during failover.

Was this helpful?

Give Feedback

How can we improve the documentation?

© Copyright IBM Corporation 2025 | Privacy policy | Terms of use Manage Privacy Choices

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: Contact IBM