It is critical to keep this file very simple and avoid errors. Errors in this file will require manually copying a new version to each managed client.

The file contains tokens in the form <%token-name%> which are replaced by the csync_wizard with the administrator’s answers to questions. Replace the tokens as follows:

—Replace the <%POLICYHOST_NAME%> token with the fully qualified domain name of the Serviceguard csync package. For example:

policyhost = ( “csync.abc.xyz.com” )

—Refer to “Manually Configuring a Standalone Synchronization Server” (page 27) for a discussion on setting the cfagent domain variable, which is used by cfagent’s resolve action.

•List Managed Clients in cfrun.hosts

cfrun requires that all managed clients be listed in the file cfrun.hosts. Since each cluster member is considered a client, make sure each member is listed in /csync/dsau/ cfengine_master/inputs/cfrun.hosts.

Edit it and add the hostnames of each member, one per line. It is simplest to make sure that all the host names are fully qualified. When using fully qualified hostnames, the “domain =“ line is not required and can be deleted. This domain specification is concatenated on any unqualified hostnames. If using unqualified hostnames, replace the “<%DEFAULT_CLIENT_DNS_DOMAIN%>” token with the simple domain name. For example:

domain = xyz.abc.com

Note that the csync_wizard will always write fully qualified hostnames when adding managed clients to this file.

•Edit the Master Policy File

The file /var/opt/dsau/cfengine_master/inputs/cfagent.conf is the master policy file. The default cfagent.conf includes the default template cf.main which is a commented template file with examples of common synchronization actions for both standalone systems and Serviceguard clusters. Edit cf.main to replace the <%POLICYHOST_NAME%> token as described in a previous list bullet “Initial Policy File Customization.” The “domain =” declaration used by the resolve action is also discussed in the same section.

Note that this default template performs no management actions. All the action lines are commented out. It does contain many examples specific to synchronizing files in a Serviceguard cluster. This is a starting point for creating a custom set of cfengine policies and actions for your cluster and other managed clients.

The cfengine reference manual which documents the syntax and all the possible management actions defined in this file is located in /opt/dsau/doc/cfengine/.

Other example cfengine configuration files which are included with the open source cfengine distribution are located in /opt/dsau/share/cfengine/examples.

2.3 Configuring cfengine

31