Appendix A. Component options


A.1. HA/DR provider options for SAPHanaSR

Parameters that are available for the configuration of the SAPHanaSR HA/DR provider are shown below:

Expand
Provider optionsRequiredDefaultDescription

provider = SAPHanaSR

yes

 

The provider parameter must be set to the hook script name without the .py ending.

path = /usr/share/SAPHanaSR-ScaleOut

yes

 

The full path to the location of the hook script.

execution_order = 1

yes

 

Set to 1 to ensure that the SAPHanaSR HA/DR provider is always executed before other optional hook scripts when an event occurs.

A.2. HA/DR provider options for ChkSrv

Parameters that are available for the configuration of the ChkSrv HA/DR provider are shown below:

Expand
Provider optionsRequiredDefaultDescription

provider = ChkSrv

yes

 

The provider parameter must be set to the hook script name without the .py ending.

path = /usr/share/SAPHanaSR-ScaleOut

yes

 

The full path to the location of the hook script.

execution_order = 2

yes

 

Set to 2 or higher. The mandatory SAPHanaSR provider must always be run first.

action_on_lost

no

ignore

Action to be triggered when a lost indexserver is identified.

  • ignore: do nothing, just write to trace files.
  • stop: execute sapcontrol …​ StopSystem.
  • kill: execute HDB kill-<signal>. The signal can be defined by the separate parameter kill_signal.

kill_signal

no

9

The signal that is used with the kill action.

stop_timeout

no

20s

How many seconds to wait for the stop action to return. This value must be greater than the value of the HANA parameter forcedterminationtimeout.

A.3. SAPHanaTopology resource parameters

Parameters that are available for the configuration of SAPHanaTopology resources are shown below:

Expand
Resource optionsRequiredDefaultDescription

SID

yes

 

SAP system identifier.

InstanceNumber

yes

 

Number of the SAP HANA instance.

HANA_CALL_TIMEOUT

no

120

Defines the timeout - how long a call to HANA to receive information can take, for example, when the resource agent executes landscapeHostConfiguration.py. There are some specific calls to HANA which have their own timeout values.

If you increase the timeout for HANA calls of this resource you must also consider increasing the operation timeout values of the same resource.

A.4. SAPHanaController resource parameters

Parameters that are available for the configuration of SAPHanaController resources are shown below:

Expand
Resource optionsRequiredDefaultDescription

SID

yes

 

SAP system identifier.

InstanceNumber

yes

 

Number of the SAP HANA instance.

DIR_EXECUTABLE

no

 

The fully qualified path to binaries such as sapstartsrv and sapcontrol. Specify this parameter if you have changed the SAP kernel directory location after the default SAP installation.

SAP standard paths are searched by default.

DIR_PROFILE

no

 

The fully qualified path to the SAP START profile. Specify this parameter if you have changed the SAP profile directory location after the default SAP installation.

SAP standard paths are searched by default.

HANA_CALL_TIMEOUT

no

120

Defines the timeout - how long a call to HANA to receive information can take, for example, when the resource agent runs landscapeHostConfiguration.py. There are some specific calls to HANA which have their own timeout values.

If you increase the timeout for HANA calls of this resource you must also consider increasing the operation timeout values of the same resource.

INSTANCE_PROFILE

no

 

The name of the SAP HANA instance profile. Specify this parameter if you have changed the name of the SAP HANA instance profile after the default SAP installation.

SAP standard paths are searched by default.

PREFER_SITE_TAKEOVER

no

false

Defines whether the resource agent should prefer to trigger takeover to the secondary site instead of restarting the primary site locally. However, a takeover is only triggered if the SAP HANA landscape status is on ERROR. For FATAL a local restart is initiated.

  • true: Prefer to trigger the takeover to the secondary site.
  • false: Prefer to restart locally.

AUTOMATED_REGISTER

no

false

Defines whether the resource agent automatically registers a former primary instance as a secondary during cluster resource start and if the DUPLICATE_PRIMARY_TIMEOUT condition is met. Registering an instance as a secondary initiates a data synchronisation from the primary and might overwrite local data.

  • false: Manual intervention is required.
  • true: The former primary is automatically registered as a secondary.

DUPLICATE_PRIMARY_TIMEOUT

no

7200

The time difference required between two primary time stamps (LPTs), in case a dual-primary situation occurs. If the difference between both nodes' last primary time stamps is less than DUPLICATE_PRIMARY_TIMEOUT, then the cluster holds one or both instances in a WAITING status. This gives an admin the chance to react to a failover.

How the recovery proceeds after the DUPLICATE_PRIMARY_TIMEOUT has passed depends on the parameter AUTOMATED_REGISTER.

We recommend that you set PREFER_SITE_TAKEOVER to true. This allows the HA cluster to trigger a takeover when a failure of the primary HANA instance is detected. In most cases it takes less time for the new HANA primary instance to become fully active after a takeover, than it takes for the original primary instance to restart and reload all data back from disk into memory.

Leave AUTOMATED_REGISTER set to false to give the operator the option to first verify the health and data consistency of the previously failed primary instance, before you manually register it as the new secondary instance to re-establish the HANA system replication between both instances and manually start the instance.

Set AUTOMATED_REGISTER to true to enable the automatic registration of the former primary instance as the new secondary after a takeover occurs. This increases the availability of the HANA system replication setup and prevents so-called dual-primary situations in the SAP HANA system replication environment.

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat Documentation

Legal Notice

Theme

© 2026 Red Hat
Back to top