amf.conf (5)

amf.conf is the configuration file that determines the behaviour of the AIS Availability Management Framework service, AMF in the corosync implementation.

Entries in this file will for example determine what applications AMF will start and how to supervise them.

By default AMF opens /etc/ais/amf.conf. The environment variable OPENAIS_AMF_CONFIG_FILE can be set to the pathname of an AMF configuration file to override the default behaviour.

Any line whose first non-white-space character is a '#' is considered a comment line. Empty lines are ignored.

The file contains object entries of the form:

<Object Class> = <Object Name> {
<attribute> = <value>
...

}

Object entries are nested, one entry contains another entry. This way relations between objects are built up. For example a component object defined inside a Software Unit (SU) object means that the component belongs to the SU. In other words, the SU is composed of the component. See the example configuration file.

The relation between objects has to comply with the AMF model specified in [5].

Object names shall use only printable ASCII characters. Object names shall be unique within its context, i.e. two components within the same service unit has to have different names, but can have the same name as another component within another service unit.

Attribute names are consistent with the naming of the configuration attributes in [5].

AMF object attributes are either configuration or runtime attributes. The AMF configuration file is used to specify configuration attributes. Some configuration attributes have default values and does not need to be specified. Others are not valid in certain redundancy models and so on.

The type of an attribute value is either a string, a number, a time or an enumeration. Enumeration values are specified according to the type definition in the AIS specification. Time values are specified in milliseconds.

Multivalue attributes are specified using multiple entries with the same attribute name but different values. See the example configuration file.

The (RDN) value of 'safAmfNode' is a logical name for an AMF node. It is mapped to a real physical node using the attribute 'saAmfNodeClmNode'.

The value of the attribute 'saAmfNodeClmNode' should be the hostname (without domain name) as given to the host at boot time. This name is returned by the shell command 'hostname'.

Currently, AMF is enabled/disabled by an entry in the corosync.conf file, see [1]. It is default disabled.

The following list of attributes is currently supported:

safAmfCluster

saAmfClusterStartupTimeout

safAmfNode

saAmfNodeClmNode

Host name, required

saAmfNodeSuFailOverProb

Required but not used.

saAmfNodeSuFailoverMax

Required but not used.

safApp

clccli_path

A path added to all CLC-CLI scripts

saAmfSIProtectedbySG

Required when several SGs are specified

safSg

safSi

saAmfSINumCSIs

Required but not used.

safCSType

saAmfSGRedundancyModel

Currently only 'nplusm' is supported, required.

saAmfSGNumPrefActiveSUs

saAmfSGNumPrefStandbySUs

saAmfSGMaxActiveSIsperSUs

saAmfSGMaxStandbySIsperSUs

saAmfSGCompRestartProb

Required but not used.

saAmfSGCompRestartMax

saAmfSGSuRestartProb

Required but not used.

saAmfSGAutoAdjustProb

Required but not used.

saAmfSGSuRestartMax

safSu

saAmfSUNumComponents

Required but not used.

saAmfSUIsExternal

Required but not used.

saAmfSUFailover

Required but not used.

saAmfSUHostedByNode

Required. Set to AMF node name. Note: this is a deviation from the specification.

safComp

saAmfCompCsTypes

Multivalue

saAmfCompCategory

saAmfCompCapability

Required but not used.

saAmfCompNumMaxActiveCsi

Required but not used.

saAmfCompNumMaxStandbyCsi

Required but not used.

saAmfCompCmdEnv

Multivalue

saAmfCompDefaultClcCliTimeout

Required but not used.

saAmfCompDefaultCallbackTimeOut

Required but not used.

saAmfCompInstantiateCmdArgv

saAmfCompInstantiateCmd

saAmfCompTerminateCmdArgv

Required but not used.

saAmfCompTerminateCmd

Required but not used.

saAmfCompCleanupCmdArgv

saAmfCompCleanupCmd

saAmfCompRecoveryOnError

Required but not used.

safHealthcheckKey

saAmfHealthcheckPeriod

saAmfHealthcheckMaxDuration

safCsi

saAmfSIPrefActiveAssignments

saAmfSIPrefStandbyAssignments

saAmfCSTypeName

safCSIAttr

Multivalue

Hans.Feldt at ericsson.com

For an AMF configuration file example, see the amf.conf file under the corosync conf directory.

/etc/ais/amf.conf

/etc/ais/corosync.conf

[1] corosync_conf (5)

[2] corosync_overview (8)

[3] README.amf

[4] www.saforum.org - SAI-XMI-A.01.01.xml.xip

[5] www.saforum.org - SAI-Overview.B.02.01.pdf

[6] www.saforum.org - SAI-AIS-AMF-B.02.01.pdf