forked from cfengine/design-center
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request cfengine#239 from deb-cfengine/install4
Complete workaround. Changed layout and steps
- Loading branch information
Showing
1 changed file
with
71 additions
and
73 deletions.
There are no files selected for viewing
144 changes: 71 additions & 73 deletions
144
getting-started/installation/installation-enterprise-free.markdown
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,130 +1,128 @@ | ||
| --- | ||
| layout: default | ||
| title: Installing Enterprise Free 25 | ||
| title: Installing Enterprise 25 Free | ||
| categories: [Getting Started, Installation, Installing Enterprise Free 25] | ||
| published: true | ||
| sorting: 20 | ||
| 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 <IP address of policy server> | ||
| ``` | ||
|
|
||
| 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 <IP address of policy server> | ||
| ``` | ||
|
|
||
| ## 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 <hub package>.rpm | ||
| [Debian/Ubuntu] $ dpkg -i <hub package>.deb | ||
| ``` | ||
| The Mission Portal is immediately accessible. Connect to the Policy Server | ||
| through your web browser at http://`<IP address of your Policy Server>`. | ||
|
|
||
| 2. On each Host, install the `cfengine-nova` package: | ||
| username: admin | ||
| password: admin | ||
|
|
||
| ``` | ||
| [RedHat/CentOS/SUSE] $ rpm -i <agent package>.rpm | ||
| [Debian/Ubuntu] $ dpkg -i <agent package>.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:<port> in your browser. The <port> 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: | ||
| <hr> | ||
|
|
||
| ``` | ||
| $ /var/cfengine/bin/cf-agent --bootstrap <IP address of the Policy Server> | ||
| ``` | ||
| ## 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://`<IP address of your Policy Server>`. | ||
|
|
||
| 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] | ||
| <hr> | ||
|
|
||
| * 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]. | ||
| <iframe src="https://docs.google.com/forms/d/1-D5ny2_5HDmPBpRR69aZeC-dVY08VlDouCsdGXBCnyc/viewform?embedded=true" width="760" height="500" frameborder="0" marginheight="0" marginwidth="0">Loading...</iframe> |