csync_wizard.1m (2012 03)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

csync_wizard(1M) csync_wizard(1M)

NAME

csync_wizard - The conﬁguration wizard for the Conﬁguration Engine (cfengine). csync_wizard is part of

the Distributed Systems Administration Utilities (DSAU).

SYNOPSIS

csync_wizard [-f ﬁlename | -h]

DESCRIPTION

The Conﬁguration Synchronization Wizard (csync_wizard) helps set up a Conﬁguration Engine (cfen-

gine) environment. cfengine is a policy-based conﬁguration management tool. The administrator

creates a conﬁguration-description ﬁle on the conﬁguration master that deﬁnes the management actions

for cfengine to perform on each managed client. The administrator can use cfengine to perform tasks

such as:

• synchronize a set of ﬁles across managed clients

• disable inappropriately conﬁgured ﬁles on the client

• check ﬁle permissions, ownership, and track checksum changes

• make edits to ﬁles

• execute arbitrary shell commands on each client

• check for processes or signal processes

For additional detailed cfengine information, refer to the cfengine reference manual in

/opt/dsau/doc/cfengine. (For the current version of cfengine, see the DSAU Release Notes.)

While there are many manual steps required to conﬁgure a cfengine environment, the csync_wizard

guides the administrator through the steps to create the conﬁguration master, allow managed-clients to

be added to and removed from the environment, and distribute the required security keys between the

conﬁguration master and the managed clients.

The administrator must choose a system to act as the conﬁguration master. This system can be a stan-

dalone system or a Serviceguard cluster.

• Standalone system acting as the conﬁguration master

In this conﬁguration, cfengine’s master conﬁguration description ﬁles and any reference ﬁles

that need to distributed to the managed clients reside in a designated directory on this stan-

dalone system.

Remote clients can include standalone systems and members of Serviceguard clusters. cfengine

securely communicates with the managed clients using a public/private key exchange mechan-

ism. The wizard helps the administrator distribute keys to managed clients but requires that

passwordless ssh be conﬁgured. See the csshsetup tool for details on conﬁguring ssh. An alter-

native, but less secure, way to distribute cfengine keys is to use cfrun -T. Refer to the cfen-

gine reference manual for details.

• Serviceguard cluster acting as the conﬁguration master

In a Serviceguard cluster, cfengine can be conﬁgured as a highly available (HA) service using a

Serviceguard package. All members of the cluster must be up when running the wizard, and

cluster members are automatically conﬁgured as cfengine clients. The node hosting the pack-

age acts as the conﬁguration master. Clients access the conﬁguration master using its relocat-

able IP address.

For the intra-cluster-only case, the wizard performs the initial cfengine public/private key

exchange automatically, and no special ssh setup is required for the cluster members. When

using the wizard to add remote clients, ssh is required. See the ssh description in the Stan-

dalone system case above for details.

When conﬁguring the cfengine master to run as part of a HA service using a Serviceguard pack-

age, several data points are required to establish the service. Refer to the "Prerequisites for

using the wizard" section of this man page for further details.

The wizard provides cfengine templates containing examples of common ﬁles that are synchron-

ized in a Serviceguard cluster.

If cfengine has previously been conﬁgured on the conﬁguration master, any existing cfengine

conﬁguration ﬁles are saved in the directory /var/opt/dsau/cfengine/backups. Files from the

HP-UX 11i Version 3: March 2012 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
csync_wizard(1M) csync_wizard(1M) NAME csync_wizard - The configuration wizard for the Configuration Engine (cfengine). csync_wizard is part of the Distributed Systems Administration Utilities (DSAU). SYNOPSIS csync_wizard [-f filename | -h] DESCRIPTION The Configuration Synchronization Wizard (csync_wizard) helps set up a Configuration Engine (cfengine) environment. cfengine is a policy-based configuration management tool.
PAGE 2
csync_wizard(1M) csync_wizard(1M) master inputs area are also saved here and will include "master.save" in the filename. Dated subdirectories are also created in this directory so that more than one copy of the files will be archived. Post-configuration Maintenance After completing configuration of the cfengine master, further administration is accomplished using the csync_wizard, with which you can perform the following tasks.
PAGE 3
csync_wizard(1M) csync_wizard(1M) should be "csync" instead of a hostname. • domain: The DNS domain of the master server or Serviceguard cluster specified for master:. • clients: A colon-separated list of hostnames for managed clients. In an highly available cluster configuration, you do not need to include the cluster members in this list. All members will be automatically configured. If the hostname is not fully qualified, the domain defaults to the domain of the master server or the cluster.
PAGE 4
csync_wizard(1M) csync_wizard(1M) AUTHORS csync_wizard was developed by Hewlett-Packard. FILES Note: Look in the file /etc/cmcluster.conf to determine the value for SGCONF, the path to the Serviceguard package configuration directory. HP-UX: /etc/rc.config.d/cfservd cfservd configuration file. /sbin/init.d/cfservd cfengine start/stop script. A cA Linux: /etc/sysconfig/cfservd cfservd configuration file. /etc/init.d/cfservd cfengine start/stop script.