AMF.CONF(5)							File Formats Manual						       AMF.CONF(5)

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  'saAmfNode-
       ClmNode'.

       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

corosync Man Page						    2006-08-29							       AMF.CONF(5)