GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PUPPET-CONFIG (8)

NAME

puppet-config - Interact with Puppet's settings.

CONTENTS

SYNOPSIS

puppet config action [--section SECTION_NAME]

DESCRIPTION

This subcommand can inspect and modify settings from Puppet's 'puppet.conf' configuration file. For documentation about individual settings, see https://docs.puppetlabs.com/references/latest/configuration.html.

OPTIONS

Note that any setting that's valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action. For example, server and run_mode are valid settings, so you can specify --server <servername>, or --run_mode <runmode> as an argument.

See the configuration file documentation at https://docs.puppetlabs.com/references/stable/configuration.html for the full list of acceptable parameters. A commented list of all configuration options can also be generated by running puppet with --genconfig.
--render-as FORMAT
  The format in which to render output. The most common formats are json, s (string), yaml, and console, but other options such as dot are sometimes available.
--verbose
  Whether to log verbosely.
--debug Whether to log debug information.
--section SECTION_NAME
  The section of the puppet.conf configuration file to interact with.
The three most commonly used sections are 'main', 'master', and 'agent'. 'Main' is the default, and is used by all Puppet applications. Other sections can override 'main' values for specific applications --- the 'master' section affects puppet master and puppet cert, and the 'agent' section affects puppet agent.
Less commonly used is the 'user' section, which affects puppet apply. Any other section will be treated as the name of a legacy environment (a deprecated feature), and can only include the 'manifest' and 'modulepath' settings.

ACTIONS

print - Examine Puppet's current settings.
  SYNOPSIS
puppet config print [--section SECTION_NAME] (all | setting [setting ...]
DESCRIPTION
Prints the value of a single setting or a list of settings.
This action is an alternate interface to the information available with puppet <subcommand> --configprint.
NOTES
By default, this action reads the general configuration in the 'main' section. Use the '--section' and '--environment' flags to examine other configuration domains.
set - Set Puppet's settings.
  SYNOPSIS
puppet config set [--section SECTION_NAME] [setting_name] [setting_value]
DESCRIPTION
Updates values in the puppet.conf configuration file.
NOTES
By default, this action manipulates the configuration in the 'main' section. Use the '--section' flag to manipulate other configuration domains.

EXAMPLES

print

Get puppet's runfile directory:

$ puppet config print rundir

Get a list of important directories from the master's config:

$ puppet config print all --section master | grep -E "(path|dir)"

set

Set puppet's runfile directory:

$ puppet config set rundir /var/run/puppetlabs

Set the vardir for only the agent:

$ puppet config set vardir /opt/puppetlabs/puppet/cache --section agent

COPYRIGHT AND LICENSE

Copyright 2011 by Puppet Labs Apache 2 license; see COPYING
Search for    or go to Top of page |  Section 8 |  Main Index


Puppet Labs, LLC PUPPET-CONFIG (8) May 2015

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.