Enterprise API Examples · Tutorials. See Also: Tutorial for Running Examples. CFEngine Manual. Table of Contents. Table of Contents. CFEngine CFEngine is a configuration management system that provides a framework for.

Author: Tomuro Megar
Country: Mauritius
Language: English (Spanish)
Genre: Business
Published (Last): 23 October 2015
Pages: 337
PDF File Size: 3.51 Mb
ePub File Size: 1.53 Mb
ISBN: 449-5-94207-857-6
Downloads: 15079
Price: Free* [*Free Regsitration Required]
Uploader: Brajora

For the latest documentation, go here: On the server side, Windows Server and newer is supported. CFEngine Enterprise communicates bi-directionally on portso make sure that this port is open for outgoing and incoming TCP connections. All software dependencies are bundled with the CFEngine Enterprise documenattion.

The total disk consumption is about 70 MBand the memory usage is less than 30 MB. The Windows msi -packages will get silently installed no prompts to Cfengine under your program files directory e. It is important that the installer is run with Administrative priviliges. If you are just going to test your policies on a Windows host, it is more efficient to not bootstrap to a policy server, but run the policies locally just after you create them. You can install the license with the cf-key -l command — you will need to copy over the licensed public key as advised by cf-key -l.

Eventually, when you are done testing and want to bootstrap a Windows host to a policy server, please run the following command against a Linux-based policy server, as advised in the CFE Enterprise getting started document. If we assume the policy server’s IP address is ‘ Now, go to your terminal e. It should generate no output, which indicates correct syntax and license. We now have a basic skeleton policy that we can cfengihe our Windows promises with. These can later be integrated at the policy hub to ensure that they are run on all Windows systems.

We will assume this general skeleton for the rest of this document, modifying the contents of the test bundle only. CFEngine Enterprise supports fine-grained management of the Windows registry. These promises are encapsulated under the databases: Now, we again run cf-promises. Note that docuentation added the -I option which tells cf-agent. The output should look like the documenhation. When we run cf-agent. This is convergence — CFEngine is ensuring the desired state.


In order to remove values instead, we just need to adjust the policy slightly, resulting in the following bundle. See the CFEngine reference manual for an updated list of supported data types.

CFEngine 3.7 Manual

Cfenigne note the registryvalue function which can be used to read out value data from the registry and act upon it. Examples of its use are also available in the CFEngine reference manual. CFEngine Enterprise can maintain complete control of the state of all Windows services. For example, services prone to security issues or errors can easily be given a disabled state. A service can also be given a running state, in which case CFEngine Enterprise ensures that it is running, and starts it if it is not, with parameters if desired.

More advanced policy options are also available, including support for starting and stopping dependencies, and configuring when the services should be started e. CFEngine Enterprise policies use documentatikn name, not the display name, due to the need of uniqueness. This example ensures that the Windows Time service is running on all Windows hosts, and that Remote registry is disabled on all Windows servers. Windows ACLs are a complex topic by itself, with support for more than ten different permission bits and inheritance.

CFE Enterprise supports all of this, but we will just cover the basics in this document. This means it runs in the background and starts with Windows, before any user logs in. Event logs are the Windows counterpart to syslog from Unix.

The main difference is that event logs aim to group similar log messages, giving documentatiin group an event id. The following event ids are defined in CFEngine Enterprise, allowing categorisation of the log message based on its type. By default, only promise not vocumentation and generic error events are logged to avoid flooding the Event Log. You can turn on verbose logging to log all messages, like the following example. Note that these variables are not statically coded, but retrieved from documentaion current system.


The Windows version of CFEngine Enterprise defines hard classes to pinpoint the exact version of Windows that it is running on, the service pack version and if it’s a server or workstation. First of all, the class windows is defined on all Windows platforms.

In addition, if the server is a domain controller, DomainController is defined.

Note that if DomainController is defined, then WinServer is also defined, for natural reasons. To allow taking specific actions on different Windows versions, one of the following hard classes is defined.

Note that all defined hard classes for a given system is shown by running cf-promises -v.

A potential problem source when writing policies dofumentation windows is that paths to executables often contain spaces. This makes it documentattion for CFEngine to know where the executable ends and the parameters to it starts. To solve this, we place escaped quotes around the executable. Windows share paths double backslashes also need escaping. Additionally, Windows does not support that processes start themselves in in the background i.

The result is that CFEngine is always waiting for the commands to finish execution before checking the next promise. To avoid this, use the background attribute in the action body-part. Finally, one should note that Windows lacks support for certain features that are utilised in Unix versions of CFEngine. These include symbolic links, file groups, user and group identifiers.

Cfengone, the parts of promises containing these features will be ignored.

CFEngine master Documentation – Home

For example, the getgid function does not return anything on Windows. The CFEngine reference manual documents exactly which promises are ignored and not. Run cf-key -l C: Testing policies locallyPrevious: System requirementsUp: Windows registry managementPrevious: Windows service managementPrevious: Testing policies locallyUp: File and folder permissionsPrevious: Windows registry managementUp: Windows service managementUp: Windows special variablesPrevious: File and folder permissionsUp: Windows hard classesPrevious: Notes on windows policiesPrevious: Windows special variablesUp: Windows hard classesUp: