Puppet Server: Installing From Packages
This version of Puppet Server is not included in Puppet Enterprise. The latest version of PE includes Puppet Server 2.3. A newer version is available; see the version menu above for details.
Puppet Server is configured to use 2GB of RAM by default. If you’d like to just play around with an installation on a Virtual Machine, this much memory is not necessary. To change the memory allocation, please see Memory Allocation.
- Enable the Puppet Labs package repositories, if you haven’t already done so.
- Stop the existing Puppet master service. The method for doing this varies depending on how your system is set up.
If you’re running a WEBrick Puppet master, use:
service puppetmaster stop.
If you’re running Puppet under Apache, you’ll instead need to disable the puppetmaster vhost and restart the Apache service. The exact method for this depends on what your Puppet master vhost file is called and how you enabled it. For full documentation, see the Passenger guide.
* On a Debian system, the command might be something like `sudo a2dissite puppetmaster`. * On RHEL/CentOS systems, the command might be something like `sudo mv /etc/httpd/conf.d/puppetmaster.conf ~/`. Alternatively, you can delete the file instead of moving it.
After you’ve disabled the vhost, restart Apache, which is a service called either
apache2, depending on your OS.
Alternatively, if you don’t need to keep the Apache service running, you can stop Apache with
service httpd stop or
service apache2 stop.
Install the Puppet Server package by running:
yum install puppetserver
apt-get install puppetserver
Note that there is no
-in the package name.
Start the Puppet Server service:
service puppetserver start
By default, Puppet Server will be configured to use 2GB of RAM. However, if you want to experiment with Puppet Server on a VM, you can safely allocate as little as 512MB of memory. To change the Puppet Server memory allocation:
/etc/sysconfig/puppetserverand modify these settings:
# Modify this if you'd like to change the memory allocation, enable JMX, etc JAVA_ARGS="-Xms2g -Xmx2g"
Replace 2g with the amount of memory you want to allocate to Puppet Server. For example, to allocate 1GB of memory, use
JAVA_ARGS="-Xms1g -Xmx1g"; for 512MB, use
For more information about the recommended settings for the JVM, please see http://docs.oracle.com/cd/E15523_01/web.1111/e13814/jvm_tuning.htm.
puppetserverservice after making any changes to this file.
Submit issues at https://tickets.puppetlabs.com/browse/SERVER.