Install PE using installer tarball

This installer employs default settings to install PE infrastructure components on a single node, creating a standard PE architecture. You can use a standard installation to try out PE with up to 10 nodes, or to manage up to 4,000 nodes. From there, you can scale up to the large or extra-large installation as your infrastructure grows, or customize your configuration as needed.

A standard PE installation consists of the following components installed on a single node:
  • The primary server: The central hub of activity. It is where Puppet code is compiled to create agent catalogs and where SSL certificates are verified and signed.
  • The console: The graphical web user interface. It has configuration and reporting tools.
  • PuppetDB: The data store for data generated throughout your Puppet infrastructure.
Important: The primary server can only run on a *nix machine. However, Windows machines can be Puppet agents, and you can manage them with your *nix primary server. Furthermore, you can operate your *nix primary server remotely from a Windows machine. To do this, before you install PE on your *nix primary server, you must configure an SSH client (such as PuTTY) with the hostname or IP address and port of the *nix machine that you'll use as your primary server. When you open an SSH session to install PE on the *nix primary server, log in as root or use sudo.

Install PE from tarball

Before you begin

Review the Hardware requirements for standard installations to make sure your system capacity can handle the standard PE installation.

Log in as root on your target primary server. If you're installing on a system that doesn't allow root login, you must use sudo su - to complete these steps.

  1. Download the tarball appropriate to your operating system and architecture.
    Tip: To download packages from the command line, run wget --content-disposition "<URL>" or curl -JLO "<URL>", using the URL for the tarball you want to download.
  2. To unpack the installation tarball, run: 
    tar -xzf <TARBALL_FILENAME>
  3. From the installer directory, run ./puppet-enterprise-installer and follow the CLI instructions to complete the installation.
  4. Optional: Restart the shell to use client tool commands.
What to do next
After completing the standard installation, you can scale or customize your installation, if needed. For information and requirements for large and extra-large installations, go to Supported architectures and System requirements. You can use Configuration parameters and the pe.conf file to customize your installation.