manageiq Cookbook

Pulls down the latest ManageIQ code, builds the code, installs the dependencies, and then starts the evm processes.

Requirements

Platforms

Tested on RHEL 6.5 and CentOS 6.5. Should work on any Red Hat family distributions.

Cookbooks

• git
• yum
• yum-epel
• iptables
• postgresql
• database
• xml
• ntp
• memcached

Attributes

######Attributes specifically for ManageIQ

• default["manageiq"]["db_username"] - Username for the ManageIQ database user (default: "evm")
• default['manageiq']['db_password'] - password for the ManageIQ database user
• default['manageiq']['code_repo'] - GIT Repo URL used to build the server

######Attributes for the RVM cookbook

• default['rvm']['user_installs'] - Username for the user who is building and running the ManageIQ processes

######Attributes for the PostgreSQL Database

• default['postgresql']['password']['postgres'] - Set the root password for the database (default: sets to the manageiq/db_password)
• default["postgresql"]["pg_hba"] - Configures the pg_hba file to allow incoming connections
• default["postgresql"]["config"]["port"] - Database Port (default: 5432)
• default["postgresql"]["host"] - Host Information (default: 127.0.0.1)
• default['postgresql']['config']['listen_addresses'] - Listen Addresses for the database (default: "*")

Usage

Simply add the cookbook to your runlist or add the cookbook to a role you have created.

Deploying a ManageIQ Server

This section details "quick deployment" steps.

1. Install Chef Client

      curl -L https://www.opscode.com/chef/install.sh | sudo bash
   

2. Create a Chef repo folder and a cookbooks folder under the /tmp directory

      mkdir -p /tmp/chef/cookbooks
      cd /tmp/chef/
   

3. Create a solo.rb file

      vi /tmp/chef/solo.rb
     
           file_cache_path "/tmp/chef/"
           cookbook_path "/tmp/chef/cookbooks"
   

4. Create a manageiq.json file, this will be the attributes file and contains the run_list

      vi /tmp/chef/manageiq.json
    
            {
              "run_list": [
              "recipe[chef-manageiq]"
             ]
            }
   

5. Install dependencies:

    cd /tmp/chef/cookbooks
    
    knife cookbook site download sudo
    tar xvfz sudo-*.tar.gz
    rm -f sudo-*.tar.gz        
    
    knife cookbook site download postgresql
    tar xvfz postgresql-*.tar.gz
    rm -f postgresql-*.tar.gz
     
    knife cookbook site download iptables
    tar xvfz iptables-*.tar.gz
    rm -f iptables-*.tar.gz
     
    knife cookbook site download database
    tar xvfz database-*.tar.gz
    rm -f database-*.tar.gz
     
    knife cookbook site download rvm
    tar xvfz rvm-*.tar.gz
    rm -f rvm-*.tar.gz
     
    knife cookbook site download xml
    tar xvfz xml-*.tar.gz
    rm -f xml-*.tar.gz
     
    knife cookbook site download git
    tar xvfz git-*.tar.gz
    rm -f git-*.tar.gz
     
    knife cookbook site download ntp
    tar xvfz ntp-*.tar.gz
    rm -f ntp-*.tar.gz
     
    knife cookbook site download memcached
    tar xvfz memcached-*.tar.gz
    rm -f memcached-*.tar.gz
     
    knife cookbook site download yum
    tar xvfz yum-*.tar.gz
    rm -f yum-*.tar.gz
         
    knife cookbook site download yum-epel
    tar xvfz yum-epel-*.tar.gz
    rm -f yum-epel-*.tar.gz
     
    knife cookbook site download openssl
    tar xvfz openssl-*.tar.gz
    rm -f openssl-*.tar.gz
     
    knife cookbook site download chef-sugar
    tar xvfz chef-sugar-*.tar.gz
    rm -f chef-sugar-*.tar.gz
     
    knife cookbook site download build-essential
    tar xvfz build-essential-*.tar.gz
    rm -f build-essential-*.tar.gz
    
    knife cookbook site download apt
    tar xvfz apt-*.tar.gz
    rm -f apt-*.tar.gz
   
    knife cookbook site download aws
    tar xvfz aws-*.tar.gz
    rm -f aws-*.tar.gz
   
    knife cookbook site download mysql
    tar xvfz mysql-*.tar.gz
    rm -f mysql-*.tar.gz
    
    knife cookbook site download yum-mysql-community
    tar xvfz yum-mysql-community-*.tar.gz
    rm -f yum-mysql-community-*.tar.gz
   
    knife cookbook site download mysql-chef_gem
    tar xvfz mysql-chef_gem-*.tar.gz
    rm -f mysql-chef_gem-*.tar.gz
   
    knife cookbook site download xfs
    tar xvfz xfs-*.tar.gz
    rm -f xfs-*.tar.gz
   
    knife cookbook site download dmg
    tar xvfz dmg-*.tar.gz
    rm -f dmg-*.tar.gz
   
    knife cookbook site download runit
    tar xvfz runit-*.tar.gz
    rm -f runit-*.tar.gz
    
    knife cookbook site download windows
    tar xvfz windows-*.tar.gz
    rm -f windows-*.tar.gz     
    
    knife cookbook site download chef_handler
    tar xvfz chef_handler-*.tar.gz
    rm -f chef_handler-*.tar.gz        
    
    knife cookbook site download chef_gem
    tar xvfz chef_gem-*.tar.gz
    rm -f chef_gem-*.tar.gz    
   

6. Download and extract the cookbook:

      yum install -y wget
      wget https://github.com/booz-allen-hamilton/chef-manageiq/archive/master.tar.gz
      tar xvfz master.tar.gz 
      rm -rf master.tar.gz 
      mv chef-manageiq-master/ chef-manageiq
   

7. Run Chef-solo:

      cd /tmp/chef
      chef-solo -c solo.rb -j manageiq.json
   

License & Authors

• Author:: Chris Kacerguis
• Author:: Mandeep Bal

Copyright:: 2015, Booz Allen Hamilton

For more information on the license, please refer to the LICENSE file in the repo