From Fedora Project Wiki
No edit summary
(first draft)
Line 2: Line 2:


== Description ==
== Description ==
A simple Puppet installation HowTo.


The following assumptions have been made:
* server: puppetmaster.exmaple.tld
* client: puppet1.example.tld


== Applicable to Fedora Versions ==
== Applicable to Fedora Versions ==
 
* Fedora 14
* Fedora 15


== Requirements ==
== Requirements ==
* ruby


=== Server requirements ===
=== Server requirements ===
* puppet-server


=== These are the client's requirements ===
=== These are the client's requirements ===
* puppet
* facter
If you don't have a DNS server resolving the hostnames, add them to /etc/hosts
* Server <code>/etc/hosts</code>
<pre>
127.0.0.1      localhost localhost.localdomain localhost4 localhost4.localdomain4
::1            localhost localhost.localdomain localhost6 localhost6.localdomain6
127.0.0.1      puppetmaster.example.tld
192.168.1.100  puppet1.example.tld
</pre>
* Client <code>/etc/hosts</code>
<pre>
127.0.0.1      localhost localhost.localdomain localhost4 localhost4.localdomain4
::1            localhost localhost.localdomain localhost6 localhost6.localdomain6


127.0.0.1      puppet1.example.tld
192.168.1.1    puppetmaster.example.tld
</pre>


== Doing the Work ==
== Doing the Work ==
* Open up the firewall
<pre>su -c 'lokkit --high -p 8140:tcp'</pre>
=== Configuring the server (phase 1) ===
* Install ruby and puppet-server
<pre>su -c 'yum -y install ruby puppet-server'</pre>


=== Configuring the server ===
* Start puppetmaster
<pre>su -c 'service puppetmaster start'</pre>
 
* Enable it permanently
<pre>su -c 'chkconfig puppetmaster on'</pre>


=== Configuring clients ===
=== Configuring clients ===
* Install ruby and puppet
<pre>su -c 'yum -y install ruby puppet'</pre>
* Configure puppet by editing /etc/sysconfig/puppet
<pre>
# The puppetmaster server
PUPPET_SERVER=puppetmaster.example.tld
# If you wish to specify the port to connect to do so here
PUPPET_PORT=8140
# Where to log to. Specify syslog to send log messages to the system log.
PUPPET_LOG=/var/log/puppet/puppet.log
# You may specify other parameters to the puppet client here
PUPPET_EXTRA_OPTS=--waitforcert=60
</pre>
* Start puppet
<pre>su -c 'service puppet start'</pre>
* Enable it permanently
<pre>su -c 'chkconfig puppet on'</pre>
=== Configuring the server (phase 2) ===
* The puppet client has made a request for an autograph; verify it
<pre>su -c 'puppetca --list'</pre>
* If the information is coherent and proper, sign away
<pre>su -c 'puppetca -s puppet1.example.tld'</pre>




== How to test ==
== How to test ==
 
<pending>


== Troubleshooting ==
== Troubleshooting ==
 
* Conectivity: be sure that puppetmaster responds to ping from the client and vise-versa.
* Firewall: Both; server and client, need port 8140:tcp open.


== More Information ==
== More Information ==
 
<pending>


== Disclaimer ==
== Disclaimer ==
 
We take great effort on making this article flawless. Sometimes, we can't test every scenario. Please, contribute to this page's [[{{TALKPAGENAME}}|Talk page]] if you feel some corrections need to be made.


== Added Reading ==
== Added Reading ==
# http://docs.puppetlabs.com/guides/setting_up.html

Revision as of 08:54, 3 June 2011

Description

A simple Puppet installation HowTo.

The following assumptions have been made:

  • server: puppetmaster.exmaple.tld
  • client: puppet1.example.tld

Applicable to Fedora Versions

  • Fedora 14
  • Fedora 15

Requirements

  • ruby

Server requirements

  • puppet-server

These are the client's requirements

  • puppet
  • facter

If you don't have a DNS server resolving the hostnames, add them to /etc/hosts

  • Server /etc/hosts
127.0.0.1       localhost localhost.localdomain localhost4 localhost4.localdomain4
::1             localhost localhost.localdomain localhost6 localhost6.localdomain6

127.0.0.1       puppetmaster.example.tld
192.168.1.100   puppet1.example.tld
  • Client /etc/hosts
127.0.0.1       localhost localhost.localdomain localhost4 localhost4.localdomain4
::1             localhost localhost.localdomain localhost6 localhost6.localdomain6

127.0.0.1       puppet1.example.tld
192.168.1.1     puppetmaster.example.tld

Doing the Work

  • Open up the firewall
su -c 'lokkit --high -p 8140:tcp'

Configuring the server (phase 1)

  • Install ruby and puppet-server
su -c 'yum -y install ruby puppet-server'
  • Start puppetmaster
su -c 'service puppetmaster start'
  • Enable it permanently
su -c 'chkconfig puppetmaster on'

Configuring clients

  • Install ruby and puppet
su -c 'yum -y install ruby puppet'
  • Configure puppet by editing /etc/sysconfig/puppet
# The puppetmaster server
PUPPET_SERVER=puppetmaster.example.tld

# If you wish to specify the port to connect to do so here
PUPPET_PORT=8140

# Where to log to. Specify syslog to send log messages to the system log.
PUPPET_LOG=/var/log/puppet/puppet.log

# You may specify other parameters to the puppet client here
PUPPET_EXTRA_OPTS=--waitforcert=60
  • Start puppet
su -c 'service puppet start'
  • Enable it permanently
su -c 'chkconfig puppet on'

Configuring the server (phase 2)

  • The puppet client has made a request for an autograph; verify it
su -c 'puppetca --list'
  • If the information is coherent and proper, sign away
su -c 'puppetca -s puppet1.example.tld'


How to test

<pending>

Troubleshooting

  • Conectivity: be sure that puppetmaster responds to ping from the client and vise-versa.
  • Firewall: Both; server and client, need port 8140:tcp open.

More Information

<pending>

Disclaimer

We take great effort on making this article flawless. Sometimes, we can't test every scenario. Please, contribute to this page's Talk page if you feel some corrections need to be made.

Added Reading

  1. http://docs.puppetlabs.com/guides/setting_up.html