Use a task to enable or disable the Puppet daemon for a group of agents in Puppet Enterprise 2018.1

You’ve identified a group of nodes where you’d like to enable or disable the Puppet daemon.

Note You can identify nodes where the daemon is enabled or disabled using the steps in Identifying nodes where the Puppet daemon is enabled or disabled.

Version and installation information

PE version: 2018.1

Solution

You can enable or disable groups of agents by installing a module and running tasks.

Get the module and tasks

Download and install the puppetlabs-support_tasks module which includes the tasks for this solution.

Note: If you’re using a version of the puppetlabs-support_tasks module older than 1.1.1 (2020 17 January), please update the module to use these steps. We renumbered all the tasks in the module at that time.

To enable agents:

By default, this will enable all agents, however, you can apply it to a set of nodes by editing the list of nodes created in step 1.

1. Create a list of disabled nodes in a file called nodefile.txt by running a task. On the master:

   puppet task run support_tasks::st0285_find_disabled_agents --no-color --query 'nodes[certname] { }' | grep Finished | awk '{printf "%s%s",sep,$NF; sep=",\n"}' > nodefile.txt

   Learn more about this task in Identifying nodes where the Puppet daemon is enabled or disabled.

2. Enable all of the agents in the list by running a task with the list of nodes as input. On the master, run:

   puppet task run support_tasks::st0286_change_puppet_daemon_runmode puppet_mode=enable --nodes @nodefile.txt

   Note: To enable nodes, the required parameter puppet_mode is set to enable.

To disable an agent:

1. Disable an agent by running a task. For example to disable an agent that you’re doing testing on, on the master, run:

   puppet task run support_tasks::st0286_change_puppet_daemon_runmode puppet_mode=disable reason='down for testing' --nodes agent1.example.com

   Note: To disable nodes, the required parameter puppet_mode is set to disable. The reason parameter is optional.