Complete Answer File Reference
A newer version is available; see the version menu above for details.
The following doc provides a comprehensive list of all possible answers that can be used in an answer file.
A .txt file version can be found in the
answers directory of the PE installer tarball.
See the “Answer File Overview” and the section on installing with an answer file for more details.
These answers are always needed.
Y or N — Whether to install. Answer files must set this to Y.
Y or N — Whether the installer has permission to install additional packages from the OS’s repositories. If set to N, the installation will fail if the installer detects missing dependencies.
Y or N — Only used on AIX. Whether to run the
updtvpkg command to add info about native libraries to the RPM database. The answer should usually be Y, unless you have special needs around the RPM database.
These answers are only used in some cases, such as when upgrading or reinstalling.
Y or N — Whether the installer should backup the existing configuration files and then purge them, or leave them in place. If set to N the installer will fail. This is only needed if Puppet Enterprise was uninstalled without the
This option is no longer used, upgrades will be detected automatically.
C or R — Used if the installer cannot reach the Puppet master. If C, the installer will continue; if R, the installer will ask for a new Puppet master hostname. (This answer applies to all roles except for the master role.)
These answers are always needed.
Y or N — Whether to install the Puppet master role.
Y or N — Whether to install the database support (the PostgreSQL server and PuppetDB) role.
Y or N — Whether to install the console role.
Y or N — Whether to install the Puppet agent role.
Puppet Agent Answers
These answers are always needed.
String — An identifying string for this agent node. This per-node ID must be unique across your entire site. Fully qualified domain names are often used as agent certnames.
String — The hostname of the Puppet master server. For the agent to trust the master’s certificate, this must be one of the valid DNS names you chose when installing the Puppet master.
Y or N — Whether to quit the install if the Puppet master cannot be reached.
Y or N — This is a silent install option, default is N. When set to Y, the installer will skip master verification which allows the user to deploy agents when they know the master won’t be available.
Y or N — Controls whether or not the Puppet agent should run after being installed.
Puppet Master Answers
These answers are generally needed if you are installing the Puppet master role.
Y or N — Whether or not the installation is an all-in-one installation, (i.e., are PuppetDB and the console also being installed on this node).
String — An identifying string for the Puppet master. This ID must be unique across your entire site. The server’s fully qualified domain name is often used as the Puppet master’s certname.
String — Valid DNS names at which the Puppet master can be reached. Must be a comma-separated list. In a normal installation, defaults to
String — The hostname of the server running the console role. Only needed if you are not installing the console role on the Puppet master server.
Integer — The port on which to contact the console server. Only needed if you are not installing the console role on the Puppet master server.
y or n; MUST BE LOWERCASE — Whether to check for updates whenever the
pe-puppetserver service restarts. To get the correct update info, the server will pass some basic, anonymous info to Puppet Labs’ servers. Specifically, it will transmit:
- the IP address of the client
- the type and version of the client’s OS
- the installed version of PE
- the number of nodes licensed and the number of nodes used
If you wish to disable update checks (e.g. if your company policy forbids transmitting this information), you will need to set this to
n. You can also disable checking after installation by editing the
If you have a platform that uses systemd (currently RHEL-7 and SLES-12 only), there are additional steps to disable update checking.
String — The location from which PE agent tarballs will be downloaded before installation. Note that agent tarballs are only available for certain operating systems. For details, see the PE installation instructions
Y or N — (Upgrade only) Whether to accept the presence of a modified auth.conf file when upgrading. For details see modified auth.conf files.
String — The git url to be passed to the
r10k.yaml file. This can be any URL that is supported by r10k (and normally git). This answer is OPTIONAL and only needed if you would like r10k configured when Puppet Enterprise is installed.
String — The local filesystem path on the Puppet master where the SSH private key can be found and used by r10k. This answer is OPTIONAL and only needed if you would like r10k configured when Puppet Enterprise is installed. This must be specified in conjunction with
These answers are generally needed if you are installing the console role.
String — The hostname of the server running the Puppet master role. Only needed if you are not installing the console role on the Puppet master server.
Integer — The port on which to serve the console. The default is port 443, which will allow access to the console from a web browser without manually specifying a port. If port 443 is not available, the installer will try port 3000, 3001, 3002, 3003, 3004, and 3005.
String — The password for the console’s admin user. Must be longer than eight characters.
String — A publicly accessible hostname where the console can be accessed if the host name resolves to a private interface (e.g., Amazon EC2). This is set automatically by the installer on EC2 nodes, but can be set manually in environments with multiple hostnames.
Y or N — Whether the installer should backup the existing database directory and then purge it, or leave it in place. If set to N the installer will fail. Used when Puppet Enterprise was uninstalled without the
Y or N — Used when upgrading from PE 2.x to PE 3.x. Controls whether or not the existing data in the PE 2.x MySQL database should be converted and transferred to the newer PostgreSQL database.
Database Support Answers
These answers are only needed if you are installing the database support role.
String — The database PuppetDB will use.
String — The password for PuppetDB’s root user.
String — PuppetDB’s root user name.
String — The hostname of the server running PuppetDB.
Y or N — Whether or not to install PuppetDB.
Integer — The port where the PuppetDB server can be reached.
Integer — The port on which PuppetDB accepts plain-text HTTP connections (default port is 8080).
String — The database the node classifier will use.
String — The password for the node classifier root user.
String — The root user name for the node classifier.
String — The database the RBAC service will use.
String — The password for the RBAC service root user.
String — The root user name for the RBAC service.
String — The database the activity service will use.
String — The password for the activity service root user.
String — The root user name for the activity service.
Y or N — Used when upgrading and the amount of disk space available appears to be too low for the database to be converted. This can be a false alarm at times if the dataabse has not been vacuumed. If N the install will fail.
Y or N — Used when upgrading and the amount of disk space available cannot be determined. If N the install will fail.
Y or N — Whether to uninstall. Answer files must set this to Y.
Y or N — Whether to purge additional files when uninstalling, including all configuration files, modules, manifests, certificates, and the home directories of any users created by the PE installer.
Y or N — Whether to remove any PE-specific databases when uninstalling.