diff --git a/getting-started/installation/installation-enterprise-free.markdown b/getting-started/installation/installation-enterprise-free.markdown index dc77f572..b57ede93 100644 --- a/getting-started/installation/installation-enterprise-free.markdown +++ b/getting-started/installation/installation-enterprise-free.markdown @@ -1,6 +1,6 @@ --- layout: default -title: Installing Enterprise Free 25 +title: Installing Enterprise 25 Free categories: [Getting Started, Installation, Installing Enterprise Free 25] published: true sorting: 20 @@ -8,123 +8,121 @@ alias: getting-started-installation-installing-enterprise-free.html tags: [getting started, installation, enterprise free] --- -These instructions describe how to install the latest version of CFEngine Enterprise using pre-compiled rpm and -deb packages for Ubuntu, Debian, Redhat, CentOS, and SUSE. +These instructions describe how to install the latest version of CFEngine Enterprise 25 Free. This is the full +version of CFEngine Enterprise, but the number of Hosts (clients) is limited to 25. + +To install this version of CFEngine Enterprise, your machine must be running a recent version of Linux. +This installation script has been tested on RHEL 5 and 6, SLES 11, CentOS 5 and 6, and Debian 6 and 7. Note: You need a minimum of 2 GB of available memory and a modern 64 bit processor. -## 1. Download Packages +## Installation Overview -CFEngine Enterprise is provided in two packages; one is for the Policy -Server (hub) and the other is for each Host (client). +* **Install CFEngine Enterprise onto a Policy Server and onto Host machines.** +A Policy Server (hub) is a CFEngine instance that contains promises (business policy) that get deployed to Hosts. +Hosts are clients that retrieve and execute promises. +* **Bootstrap the Policy Server to itself and then bootstrap each of the Hosts to the Policy Server.** Bootstrapping establishes a trust relationship between the Policy Server +and all Hosts. Thus, business policy that you create in the Policy Server can be deployed to Host machines throughout your company. +Bootstrapping completes the installation process. +* **Log in to the Mission Portal.** The Mission Portal is a graphical user interface that allows you to verify the +the actual state of all your machines, thus ensuring that your promises are being executed. By using the **Design Center** inside the Mission Portal, you +can also define new desired states (business policies) for your infrastructure. +* **Try out the Tutorials.** Links to three tutorials give you a head start on learning CFEngine. -**Select a Policy Server (hub) package to download:** -Ubuntu 10.04 +## 1. Download and install Enterprise on a Policy Server +Run the following script on your designated Policy Server (hub) 64-bit machine (32-bit is not supported on the Policy Server): ``` -wget http://s3.amazonaws.com/cfengine.packages/Enterprise-3.5.2/hub/ubuntu-10.04-x86_64/cfengine-nova-hub_3.5.2-1_amd64.deb +$ wget http://s3.amazonaws.com/cfengine.packages/quick-install-cfengine-enterprise.sh && sudo bash ./quick-install-cfengine-enterprise.sh hub ``` +This script installs the latest CFEngine Enterprise Policy Server on your machine. -Ubuntu 12.04 +## 2. Bootstrap the Policy Server -``` -wget http://s3.amazonaws.com/cfengine.packages/Enterprise-3.5.2/hub/ubuntu-12.04-x86_64/cfengine-nova-hub_3.5.2-1_amd64.deb -``` +The Policy Server must be bootstrapped to itself. Find the IP address of your Policy Server (type $ ifconfig). -RHEL 5.4 +Run the bootstrap command: ``` -wget http://s3.amazonaws.com/cfengine.packages/Enterprise-3.5.2/hub/rhel-5.4-x86_64/cfengine-nova-hub-3.5.2-1.x86_64.rpm +$ sudo /var/cfengine/bin/cf-agent --bootstrap ``` -SUSE 11.1 +**Example: $ sudo /var/cfengine/bin/cf-agent --bootstrap 192.168.1.12** -``` -wget http://s3.amazonaws.com/cfengine.packages/Enterprise-3.5.2/hub/sles-11.1-x86_64/cfengine-nova-hub-3.5.2-1.x86_64.rpm -``` +Upon successful completion, a confirmation message appears: "Bootstrap to '192.168.1.12' completed successfully!" -Debian 6.0 +Type the following to check which version of CFEngine your are running: ``` -wget http://s3.amazonaws.com/cfengine.packages/Enterprise-3.5.2/hub/debian-6.0-x86_64/cfengine-nova-hub_3.5.2-1_amd64.deb +$ /var/cfengine/bin/cf-promises --version ``` -RHEL 6.0 - -``` -wget http://s3.amazonaws.com/cfengine.packages/Enterprise-3.5.2/hub/rhel-6.0-x86_64/cfengine-nova-hub-3.5.2-1.x86_64.rpm -``` - -**Select a Host (client) package to download:** - -Ubuntu/Debian 32-bit: - -``` -wget http://s3.amazonaws.com/cfengine.packages/Enterprise-3.5.2/client/agent_deb_i386/cfengine-nova_3.5.2-1_i386.deb -``` +The Policy Server is installed. -Ubuntu/Debian 64-bit: +## 3. Install Enterprise on a Host + +Install Enterprise on your designated Host machine(s) by running the script below. Per the **Free 25** agreement, you can +install Enterprise on 25 machines. Note that the Host machine(s) must be +on the same network as the Policy Server that you just installed in Step 2. ``` -wget http://s3.amazonaws.com/cfengine.packages/Enterprise-3.5.2/client/agent_deb_x86_64/cfengine-nova_3.5.2-1_x86_64.deb +wget http://s3.amazonaws.com/cfengine.packages/quick-install-cfengine-enterprise.sh && sudo bash ./quick-install-cfengine-enterprise.sh client ``` -Redhat/CentOS/SUSE 32-bit: +Note that this installation works on 64- and 32-bit machines. -``` -wget http://s3.amazonaws.com/cfengine.packages/Enterprise-3.5.2/client/agent_rpm_i386/cfengine-nova-3.5.2-1.i386.rpm -``` +## 4. Bootstrap the Host to the Policy Server -Redhat/CentOS/SUSE 64-bit: +All Hosts must be bootstrapped to the Policy Server in order to establish a connection between the Host and +the Policy Server. Run the same commands that you ran in Step 3. The Policy Server and Hosts share the same IP address. ``` -wget http://s3.amazonaws.com/cfengine.packages/Enterprise-3.5.2/client/agent_rpm_x86_64/cfengine-nova-3.5.2-1.x86_64.rpm +$ sudo /var/cfengine/bin/cf-agent --bootstrap ``` -## 2. Install Packages +**Example: $ sudo /var/cfengine/bin/cf-agent --bootstrap 192.168.1.12** -**Log in as root** and then follow these steps to install CFEngine Enterprise: +The installation process is complete and CFEngine Enterprise is up and running on your system. -1. On the designated Policy Server, install the `cfengine-nova-hub` package: +## 5. Log in to the Mission Portal - ``` - [RedHat/CentOS/SUSE] $ rpm -i .rpm - [Debian/Ubuntu] $ dpkg -i .deb - ``` +The Mission Portal is immediately accessible. Connect to the Policy Server +through your web browser at http://``. -2. On each Host, install the `cfengine-nova` package: +username: admin +password: admin - ``` - [RedHat/CentOS/SUSE] $ rpm -i .rpm - [Debian/Ubuntu] $ dpkg -i .deb - ``` +During the initial setup, the Host(s) might take a few minutes to show up in the Mission Portal. Simply refresh the web page +and login again if necessary. -## 3. Bootstrap +Note: If you are running Enterprise with Vagrant, you must add the +correct port: http://localhost: in your browser. The is the port-forwarder +number you use in your **Vagrantfile** (e.g. policyserver.vm.network "forwarded_port", guest: 80, host: 8080; the port will be 8080). -Run the bootstrap command, **first** on the policy server and then on each -host: +
-``` -$ /var/cfengine/bin/cf-agent --bootstrap -``` +## Tutorials -## Next Steps +* [Configure and deploy a policy using sketches in the Design Center.][Configure and Deploy a Policy Using Sketches (Enterprise Only)] This tutorial +teaches you how to configure and deploy business policy by using the Design Center application in the Mission Portal. Next, it shows you how to verify +that your business policy is being activated by viewing the Reports in the Mission Portal. +* [Create a standalone policy (Hello World).][Hello World] Whereas the above tutorial uses pre-defined policy (called sketches) that you can modify in the Mission Portal, this +tutorial teaches you how to create business policy (promises) on the command line. Here, you +can get a taste of the CFEngine language as you create standalone and executable scripts. +* [Distribute files from a central location.][Distribute files from a central location] Whereas the first tutorial in this list teaches you how to deploy business policy +through the Mission Portal, this advanced, command-line tutorial shows you how to distribute policy files from the Policy Server to all pertinent Hosts. -When bootstrapping is complete, CFEngine is up and running on your system. +## Recommended Reading -The Mission Portal is immediately accessible. Connect to the Policy Server -through your web browser at http://``. - -To be able to use the [Mission Portal's][Mission Portal] Design Center -front-end, continue with [integrating Mission Portal with git] [Integrating Mission Portal with git]. - -Learn more about CFEngine by using the following resources: +* CFEngine [manuals][CFEngine Manuals]. +* Additional [tutorials, examples, and documentation][Learning Tools]. -* Tutorial: [Create a standalone policy (Hello World).][Hello World] +
-* Tutorial: [Configure and deploy a policy using sketches in the Design Center.][Configure and Deploy a Policy Using Sketches (Enterprise Only)] +## Rate your experience -* CFEngine [manuals][CFEngine Manuals]. +Everyone is a first-time user a some point. We want to make the CFEngine Enterprise installation process easy for all of our new users. +Before you forget your first-time experience, we would love for you to let us know how we can improve on this process. -* Additional [tutorials, examples, and documentation][Learning Tools]. +