Distributed Systems Administration Utilities User's Guide, Linux, March 2009

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 30)
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.
34 Configuration Synchronization