The CFEngine application is fully contained within the /var/cfengine directory tree. Here is a quick breakdown of the directory structure and some of the files and functions associated with each subdirectory.

• /var/cfengine/bin
• Directories for Policy Files
• Output Directories
• Log Files in /var/cfengine
• Database Files in /var/cfengine
• Process (AKA PID) Files in /var/cfengine
• Sockets in /var/cfengine
• Datafiles in /var/cfengine
• Binary Files in /var/cfengine
• git in /var/cfengine/bin
• Misc. in /var/cfengine/bin
• Postgres in /var/cfengine/bin

/var/cfengine/bin

Agents

• cf-agent: Executes the promises.cf file; ensures that all promises are being kept
• cf-key
• cf-promises: Verifies CFEngine's configuration syntax
• cf-runagent: Contacts a remote system to run cf-agent
• cf-twin

Daemons

• cf-execd: Starts the cf-agent process at a specified time interval.
• cf-monitord: Collects system statistics
• cf-serverd: Provides network services; used to distribute policy and data files
• runalerts.sh: Updates Mission Portal status and activates alert actions (Enterprise only)
• cf-hub: Responsible for collecting reports from remote agents. (CFEngine Enterprise only)

See Also: CFEngine Component Applications and Daemons

Directories for Policy Files

/var/cfengine/modules

Location of scripts used in commands promises.

/var/cfengine/inputs

Cached policy repository on each CFEngine client. When cf-agent is invoked by cf-execd, it reads only from this directory.

/var/cfengine/masterfiles

Policy repository which grants access to local or bootstrapped CFEngine clients when they need to update their policies. Policies obtained from /var/cfengine/masterfiles are then cached in /var/cfengine/inputs for local policy execution. The cf-agent executable does not execute policies directly from this repository.

Output Directories

/var/cfengine/outputs

Directory where cf-agent creates its output files. The outputs directory is a record of spooled run-reports. These are often mailed to the administrator by cf-execd, or can be copied to another central location and viewed in an alternative browser. However, not all hosts have an email capability or are online, so the reports are kept here.

/var/cfengine/reports

Directory used to store reports. Reports are not tidied automatically, so you should delete these files after a time to avoid a build up.

/var/cfengine/state

State data such as current process identifiers of running processes, persistent classes and other cached data.

/var/cfengine/lastseen

Log data for incoming and outgoing connections.

/var/cfengine/cfapache

/var/cfengine/config

/var/cfengine/httpd

/var/cfengine/lib

Directory to store shared objects and dependencies that are in the bundled packages.

/var/cfengine/lib-twin

/var/cfengine/master_software_updates

/var/cfengine/plugins

/var/cfengine/ppkeys

Directory used to store encrypted public/private keys for CFEngine client/server network communications.

/var/cfengine/share

/var/cfengine/software_updates

/var/cfengine/ssl

Log Files in /var/cfengine

On hosts, CFEngine writes numerous logs and records to its private workspace.

CFEngine Enterprise provides solutions for centralization and network-wide reporting at an arbitrary scale.

• cf3.[hostname].runlog

A time-stamped log of when each lock was released. This shows the last time each individual promise was verified.

• cfagent.[hostname].log

Although ambiguously named (for historical reasons) this log contains the current list of setuid/setgid programs observed on the system. CFEngine warns about new additions to this list. This log has been deprecated.

• cf_notkept.log

In CFEngine Enterprise, a list of promises, with handles and comments, that were not kept.

• cf_repair.log

In CFEngine Enterprise, a list of promises, with handles and comments, that were repaired.

• promise_summary.log

A time-stamped log of the percentage fraction of promises kept after each run.

Database Files in /var/cfengine

• bundles.lmdb
• cf_classes.lmdb

A database of classes that have been defined on the current host, including their relative frequencies, scaled like a probability.

• cf_lastseen.lmdb

A database of hosts that last contacted this host, or were contacted by this host, and includes the times at which they were last observed.

• checksum_digests.lmdb

The database of hash values used in CFEngine's change management functions.

• nova_agent_execution.lmdb
• nova_track.lmdb
• performance.lmdb

A database of last, average and deviation times of jobs recorded by cf-agent. Most promises take an immeasurably short time to check, but longer tasks such as command execution and file copying are measured by default. Other checks can be instrumented by setting a measurement_class in the action body of a promise.

Process (AKA PID) Files in /var/cfengine

The CFEngine components keep their current process identifier number in `pid files' in the work directory.

• cf-execd.pid
• cf-hub.pid
• cf-monitord.pid
• cf-serverd.pid

Sockets in /var/cfengine

• cf-hub-local

Datafiles in /var/cfengine

• policy_server.dat

IP address of the policy server

Binary Files in /var/cfengine

• randseed

git in /var/cfengine/bin

• bin/git
• bin/git-cvsserver
• bin/gitk
• bin/git-receive-pack
• bin/git-shell
• bin/git-upload-archive
• bin/git-upload-pack

Misc. in /var/cfengine/bin

• bin/curl
• bin/lmdump
• bin/openssl
• bin/rpmvercmp
• bin/rsync
• bin/runalerts.sh

Postgres in /var/cfengine/bin

• bin/clusterdb
• bin/createdb
• bin/createlang
• bin/createuser
• bin/dropdb
• bin/droplang
• bin/dropuser
• bin/initdb
• bin/pg_basebackup
• bin/pg_config
• bin/pg_controldata
• bin/pg_ctl
• bin/pg_dump
• bin/pg_dumpall
• bin/pg_isready
• bin/pg_receivexlog
• bin/pg_resetxlog
• bin/pg_restore
• bin/postgres
• bin/postmaster
• bin/psql
• bin/reindexdb
• bin/vacuumdb

Not Verified

• state/cf_lock.lmdb

A database of active and inactive locks and their expiry times. Deleting this database will reset all lock protections in CFEngine.

• state/history.lmdb

CFEngine Enterprise maintains this long-term trend database.

• state/cf_observations.lmdb

This database contains the current state of the observational history of the host as recorded by cf-monitord.

• state/cf_state.lmdb

A database of persistent classes active on this current host.

• state/nova_measures.lmdb

CFEngine Enterprise database of custom measurements.

• state/nova_static.lmdb

CFEngine Enterprise database of static system discovery data.

• state/cf_procs A cache of the process table. This is useful for measurement promises about processes.

• state/cf_rootprocs A cache of the process table of processes owned by the root user. This is useful for measurement promises about processes.

• state/cf_otherprocs A cache of the process table for processes not owned by the root user. This is useful for measurement promises about processes.

• state/file_changes.log

A time-stamped log of which files have experienced content changes since the last observation, as determined by the hashing algorithms in CFEngine.

• state/*_measure.log

CFEngine Enterprise maintains user-defined logs based on specifically promised observations of the system.

• state/env_data

This file contains a list of currently discovered classes and variable values that characterize the anomaly alert environment. They are altered by the monitor daemon.

• /var/logs/CFEngineHub-Install.log

This file contains logs related to the CFEngine package installation.