{"id":64,"date":"2014-07-09T07:17:15","date_gmt":"2014-07-09T07:17:15","guid":{"rendered":"http:\/\/tuxlabs.com\/?p=64"},"modified":"2014-08-16T21:03:59","modified_gmt":"2014-08-16T21:03:59","slug":"how-to-install-the-foreman-on-centos-6-5","status":"publish","type":"post","link":"https:\/\/tuxlabs.com\/?p=64","title":{"rendered":"How To: Install The Foreman on CentOS 6.5"},"content":{"rendered":"

\"2014-08-16<\/a><\/h2>\n

Overview<\/h2>\n

In this tutorial I will be demonstrating how to install The Foreman on the Linux CentOS 6.5 operating system. If you are not familiar with CentOS it is the Community version of RedHat Linux Enterprise, hence the name C(ommunity)ENT(erprise) O(perating)S(ystem). For more information on CentOS see : https:\/\/www.centos.org\/. I chose CentOS over Ubuntu or other Linux flavors for this set of tutorials because of it’s ubiquity in enterprise environments and because of RedHat’s leadership in the Openstack ecosystem. We will discuss Openstack (www.openstack.org) in later tutorials, for now The Foreman represents a great first step to setting up a world class Cloud environment.<\/p>\n

Why The Foreman<\/h2>\n

“Foreman is an open source project that helps system administrators manage servers throughout their lifecycle, from provisioning and configuration to orchestration and monitoring. Using Puppet or Chef and Foreman’s smart proxy architecture, you can easily automate repetitive tasks, quickly deploy applications, and proactively manage change, both on-premise with VMs and bare-metal or in the cloud.” From their website (www.theforeman.org).<\/p>\n

In other words it builds on well known configuration management systems (puppet in our case) and fully automates ‘things’ to provision and manage bare metal (physical) systems and Cloud Virtual Machines. This is really helpful when you have an Openstack Cloud and need to add compute nodes quickly.<\/p>\n

Starting The Install<\/h2>\n

My 3 machines in my lab, diamond, ruby and emerald are all running CentOS 6.5. To make sure I cover all the dependencies needed I did a minimal install on these machines. So you will see me install some convenience dependencies as well, which I will point out. The following steps are based loosely on the http:\/\/theforeman.org\/manuals\/1.5\/quickstart_guide.html<\/span><\/p>\n

You will want to install The Foreman on your ‘master’ or machine you intend to the be the ‘controller’ of your Cloud. In my case, diamond.tuxlabs.com<\/p>\n

Installing Basic System Dependencies<\/h3>\n
yum install -y openssh-clients\r\nyum install -y yum-utils\r\nyum install scl-utils scl-utils-build\r\nyum install -y wget\r\nyum install -y bind-utils<\/pre>\n
scl-utils is used for managing the rails console, the rest should be pretty self explanatory.<\/p>\n
Installing Foreman Dependencies<\/h3>\n
wget https:\/\/dl.fedoraproject.org\/pub\/epel\/6\/x86_64\/epel-release-6-8.noarch.rpm\r\nrpm -ivh epel-release-6-8.noarch.rpm<\/pre>\n
Add Yum Repos<\/h3>\n
yum-config-manager --enable rhel-6-server-optional-rpms rhel-server-rhscl-6-rpms<\/pre>\n
Check to make sure the Repo was added using<\/strong><\/p>\n
yum repolist<\/pre>\n
Installing The Foreman<\/h3>\n
yum -y install http:\/\/yum.theforeman.org\/releases\/1.5\/el6\/x86_64\/foreman-release.rpm\r\nyum -y install foreman-installer<\/pre>\n
\u00a0After grabbing the packages…finally…run the installer<\/strong><\/p>\n
foreman-installer<\/pre>\n
This part is pretty cool because foreman’s automated installer seems to work quite well, it takes a few minutes, but when completed you should see something like this.<\/p>\n
Preparing installation Done                                             \r\n  Success!\r\n  * Foreman is running at https:\/\/diamond.tuxlabs.com\r\n      Default credentials are 'admin:changeme'\r\n  * Foreman Proxy is running at https:\/\/diamond.tuxlabs.com:8443\r\n  * Puppetmaster is running at port 8140\r\n  The full log is at \/var\/log\/foreman-installer\/foreman-installer.log\r\n[root@diamond tuxninja]#<\/pre>\n
Iptables<\/h3>\n
If you have iptables running, you will have to flush the rules or open the need ports.<\/p>\n
iptables --flush<\/pre>\n
\u00a0Puppet<\/h3>\n
At this point Puppet should be installed on diamond (and your machine). You should test it by running the agents twice, yes twice \ud83d\ude42 The first time clears some warnings.<\/p>\n
puppet agent --test\r\npuppet agent --test<\/pre>\n
Follow the instructions for installing the NTP module in Puppet<\/strong><\/h3>\n
http:\/\/theforeman.org\/manuals\/1.5\/index.html#2.2PuppetManagement<\/p>\n
I could have re-wrote this or cropped it, but it was written very simply. Definitely do this though so you get a feel for how to add puppet modules and manage them in The Foreman.<\/p>\n
The Clients<\/h2>\n
Now before we get into The Foreman Dashboard, let’s setup our clients so we have more interesting stuff to look at then this one node. ssh to each of your machines (ruby,emerald in my case), and sudo or become root and run…<\/p>\n
rpm  -ivh http:\/\/yum.puppetlabs.com\/el\/6.4\/products\/x86_64\/puppetlabs-release-6-7.noarch.rpm\r\nyum install -y puppet<\/pre>\n
\u00a0Then start puppet<\/strong><\/p>\n
\/etc\/init.d\/puppet start<\/pre>\n
\u00a0Sign The Certs<\/h3>\n
Puppet uses SSL certificates to authenticate clients that it manages. By default you must permit each client by manually signing the certificate before the client is authenticated with the puppet master. Back on the master server (diamond) run the following modified for the correct FQDN’s (full hostnames).<\/p>\n
puppet cert --sign ruby.tuxlabs.com\r\npuppet cert --sign emerald.tuxlabs.com<\/pre>\n
Auto Starting<\/h3>\n
Make sure Puppet starts on boot, do this on all machines<\/p>\n
chkconfig puppet on<\/pre>\n
The Dashboard<\/h2>\n
Finally :-), If you have set everything up correctly you should be able to reach your console @ https:\/\/yourserversip.com or if you have DNS at the https:\/\/yourserversname.com (aka the FQDN Fully Qualified Domain Name).\u00a0 Note the console uses SSL so you want to use HTTPS (on port 443 by default) not HTTP (which is port 80 by default), so just remember the HTTPS part and you should see a login screen, like this.<\/p>\n
\"TheForemanOverview\"<\/a><\/p>\n
The first time Login is : admin and the Password is : changeme … make sure you do like the password says ! Also feel free to change you display name in your profile.<\/p>\n
The End<\/h2>\n
Now that you have The Foreman installed. The next logical step is to install Openstack. I will cover that next time folks, I hope this helps out !<\/p>\n","protected":false},"excerpt":{"rendered":"
Overview In this tutorial I will be demonstrating how to install The Foreman on the Linux CentOS 6.5 operating system. If you are not familiar with CentOS it is the Community version of RedHat Linux Enterprise, hence the name C(ommunity)ENT(erprise) O(perating)S(ystem). For more information on CentOS see : https:\/\/www.centos.org\/. I chose CentOS over Ubuntu or […]<\/p>\n<\/a>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1,5,12],"tags":[],"class_list":{"0":"post-64","1":"post","2":"type-post","3":"status-publish","4":"format-standard","6":"category-howtos","7":"category-puppet","8":"category-systems-administration","9":"h-entry","10":"hentry"},"_links":{"self":[{"href":"https:\/\/tuxlabs.com\/index.php?rest_route=\/wp\/v2\/posts\/64","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tuxlabs.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tuxlabs.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tuxlabs.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tuxlabs.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=64"}],"version-history":[{"count":11,"href":"https:\/\/tuxlabs.com\/index.php?rest_route=\/wp\/v2\/posts\/64\/revisions"}],"predecessor-version":[{"id":142,"href":"https:\/\/tuxlabs.com\/index.php?rest_route=\/wp\/v2\/posts\/64\/revisions\/142"}],"wp:attachment":[{"href":"https:\/\/tuxlabs.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=64"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tuxlabs.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=64"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tuxlabs.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=64"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}