From Fedora Project Wiki
< User:Renich | HowTo
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.