User:Renich/HowTo/Puppet

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