Adding Classes Quick Start Guide

A newer version is available; see the version menu above for details.


Every module contains one or more classes. Classes are named chunks of Puppet code and are the primary means by which Puppet Enterprise configures nodes. The Puppet Labs wsus_client module you installed in the Module Installation QSG contains a class called wsus_client. In this example, you’ll use the wsus_client class to supply the types and providers necessary to schedule updates using a WSUS server with Puppet.

In this example, you create a group called windows_example and add the wsus_client class to it.

Prerequisites: This guide assumes you’ve already installed a monolithic PE deployment, and have installed at least one Windows agent node and the puppetlabs-wsus_client module.

Note: The process for adding classes to agent nodes in the console is the same on both Windows and *nix operating systems.

Create the windows_example group

  1. From the console, click Nodes > Classification.
  2. Click Add group.
  3. In the Group name field, name your group (e.g., windows_example).
  4. Click Add.
  5. Select the windows_example group.
  6. On the Rules tab, in the Certname field, enter the name of the PE-managed node you’d like to add to this group.
  7. Click Pin node.

Note: Pinning a node adds the node to the group regardless of any rules specified for a node group. A pinned node remains in the node group until you manually remove it. Adding nodes dynamically describes how to use rules to add nodes to a node group.

  1. Click Commit 1 change.

    adding node to windows group

  2. Repeat steps 5-7 for any additional nodes you want to add.

Add the wsus_client class to the example group

  1. From the console, click Nodes > Classification.

  2. Select the windows_example group.

  3. Click the Classes tab.

  4. In the Add new class field, begin typing wsus, and select wsus_client from the autocomplete list. If wsus_client doesn’t appear in the list, you might have to click Refresh.

  5. Click Add class.

  6. Click Commit 1 change.

    Note that the wsus_client class now appears in the list of classes for your agent node.

  7. Puppet runs, which configures the windows_ example group using the newly-assigned class. Wait one or two minutes.

Next: Quick Start: Assign User Permissions

↑ Back to top