Start installing PE on *nix
This guide walks you through an express installation of PE. This installation type is ideal for trying out PE with up to 10 nodes, and can be used to manage up to 4000 nodes.
On a single *nix machine, you install:
- The master, the central hub of activity, where Puppet code is compiled to create agent catalogs, and where SSL certificates are verified and signed.
- The PE console, the web interface, which features numerous configuration and reporting tools.
- PuppetDB, which collects data generated throughout your Puppet infrastructure.
When this installation is complete, move on to installing Puppet Enterprise on the nodes you wish to manage with Puppet, commonly known as agent nodes.
Download and verify the installation package
PE is distributed in downloadable packages specific to supported operating system versions and architectures. Installation packages include the full installation tarball and a GPG signature (.asc) file used to verify authenticity.
You must have GnuPG installed.
Install using express install
Express installation relies on default settings to install PE, so you don't have to edit a pe.conf
file before or during installation. At the end of the installation process, you're prompted to provide a console admininstrator password, which is the only user-required value.
You must restart the shell before you can use PE client tool subcommands.
Log into the PE console
On the validation page, the installer verifies various configuration elements (for example, if SSH credentials are correct, if there is enough disk space, and if the operating system is the same for the various components).
- When you click Start using Puppet Enterprise, you receive a browser warning about an untrusted certificate. This is because you were the signing authority for the console's certificate, and your Puppet Enterprise deployment is not known to your browser as a valid signing authority. Ignore the warning and accept the certificate.
- On the login page for the console, log in with the username
admin
and the password you created when installing the Puppet master.