PE 1.2 Manual: Answer File Reference

A newer version of Puppet Enterprise has been released!

Answer File Reference

When run with the -a or -A flag and a filename argument, the Puppet Enterprise installer will read its installation instructions from an answer file. -a will use the provided answer file to perform a non-interactive installation (which will fail if any required variables are not set), and -A will perform a partially-interactive installation, prompting the user for any missing answers.

Answer files consist of normal shell script variable assignments (q_puppetdashboard_database_port=3306), and can include arbitrary control logic or assign variables based on the output of backtick-wrapped shell commands. One of the most common uses of answer files is to automatically set a puppet agent node’s unique identifier (certname) to something other than its fully-qualified domain name; this is most efficiently done by running the installer with -s ANSWER_FILE, then editing the resultant file to include, for example:

q_puppetagent_certname=`uuidgen`

The answer file could then be used for any number of puppet agent installations without further modification or interaction.

Boolean answers should use Y or N (case-insensitive) rather than true, false, 1, or 0.

A variable can be omitted if another answer ensures that it won’t be used (i.e. q_puppetmaster_certname can be left blank if q_puppetmaster_install = n).

Allowed Variables In Answer Files

puppet master Answers

q_puppetmaster_install
Y or N (Default: Y) — Sets whether the puppet master service will be installed on this computer.
q_puppetmaster_certname
String (Default: the node’s fully-qualified domain name) — Sets the puppet master’s SSL certificate common name (CN). This should usually be set to either “puppet” or the server’s fully-qualified domain name.
q_puppetmaster_certdnsnames
String (Default: “puppet:puppet.{domain}:{hostname}:{fully-qualified domain name}”) — Sets the puppet master’s certified hostnames. Must be a colon-separated list of hostnames and fully-qualified domain names.
q_puppetmaster_use_dashboard_reports
Y or N (Default: Y) — Sets whether the puppet master will send reports received from puppet agent nodes to Puppet Dashboard.
q_puppetmaster_use_dashboard_classifier
Y or N (Default: Y) — Sets whether the puppet master will request node definitions from Puppet Dashboard.
q_puppetmaster_dashboard_hostname
String (Default: “localhost”) — Sets the hostname where Puppet Dashboard is located. Used when q_puppetmaster_use_dashboard_reports = y or q_puppetmaster_use_dashboard_classifier = y.
q_puppetmaster_dashboard_port
String (Default: “3000”) — Sets the port to use when connecting to Puppet Dashboard. Used when q_puppetmaster_use_dashboard_reports = y or q_puppetmaster_use_dashboard_classifier = y.

Puppet Dashboard Answers

q_puppetdashboard_install
Y or N (Default: Y) — Sets whether Puppet Dashboard will be installed on this computer.
q_puppetdashboard_httpd_port
String (Default: “3000”) — Sets which port Puppet Dashboard will use.
q_puppetdashboard_database_install
Y or N (Default: Y) — Sets whether to install and configure a new MySQL database from the OS’s repositories.
q_puppetdashboard_database_root_password
Y or N (Default: Y, unless MySQL is already installed on this system) — Sets the password that will be assigned to MySQL’s root user. Used when q_puppetdashboard_database_install = y.
q_puppetdashboard_database_remote
Y or N (Default: Y) — Sets whether the MySQL database server is running on a remote host; if set to N, Dashboard will be configured to connect to a database on localhost. Used when q_puppetdashboard_database_install = n.
q_puppetdashboard_database_host
String (Default: “localhost”) — Sets the hostname of the remote MySQL database server. Used when q_puppetdashboard_database_remote = y.
q_puppetdashboard_database_port
String (Default: “3306”) — Sets the port used by the remote MySQL database server. Used when q_puppetdashboard_database_remote = y.
q_puppetdashboard_database_name
String (Default: “dashboard”) — Sets the name of the database Dashboard will use.
q_puppetdashboard_database_user
String (Default: “dashboard”) — Sets the MySQL user Dashboard will connect to the database server as. This user must already exist on the MySQL server, and must have the necessary privileges (see “Puppet Dashboard” above) for the database Puppet Dashboard will be using.
q_puppetdashboard_database_password
String or blank (Default: blank) — Sets the password with which Puppet Dashboard’s MySQL user will connect to the database.

puppet agent Answers

q_puppetagent_install
Y or N (Default: Y) — Sets whether the puppet agent service will be installed on this computer.
q_puppetagent_certname
String (Default: the node’s fully-qualified domain name) — Sets the unique identifier (“certname”) for this puppet agent node’s SSL certificate.
q_puppetagent_server
String (Default: “puppet”; however, if q_puppetmaster_install = y, this will default to the value of q_puppetmaster_certname.) — Sets the hostname of the puppet master.
q_puppetagent_pluginsync
Y or N (Default: Y) — Sets whether to sync executable Ruby code (e.g. custom facts, types, and providers) from the puppet master.

Other Answers

q_rubydevelopment_install
Y or N (Default: N) — Sets whether to install the Ruby development libraries for Puppet Enterprise’s copy of Ruby.
q_vendor_packages_install
Y or N (Default: Y) — Sets whether the installer has permission to install additional packages from the operating system’s repositories. If this is set to “n,” the installation will only go forward if the installer detects no missing dependencies.
q_puppet_symlinks_install
Y or N (Default: Y) — Sets whether /usr/local/bin should contain symbolic links to the Puppet executables (located in /opt/puppet/bin).
q_install
Y or N (Default: Y) — Sets whether the installation should occur. Setting this to “n” is not considered useful for non-interactive installation.

↑ Back to top