NAME¶
amf.conf - corosync AMF configuration file
DESCRIPTION¶
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
AUTHOR¶
Hans.Feldt at ericsson.com
EXAMPLE¶
For an AMF configuration file example, see the amf.conf file under the corosync
conf directory.
FILES¶
- /etc/ais/amf.conf
- /etc/ais/corosync.conf
-
SEE ALSO¶
[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
