Adding classes quick start guide

This version is out of date. For current versions, see Puppet Enterprise support lifecycle.


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 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. In the console, click Nodes > Classification, and click Add group.
  2. In the Group name field, name your group, for example, windows_example, and click Add.
  3. Click Add membership rules, classes, and variables.
  4. On the Rules tab, in the Certname field, enter the name of the managed node you want to add to this group, and click Pin node.

    Repeat this step for any additional nodes you want to add.

    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.

  5. Commit changes.

Add the wsus_client class to the example group

  1. In the console, click Nodes > Classification, and find and select the windows_example group.

  2. On the Classes tab, in the Add new class field, select wsus_client.

    If wsus_client doesn’t appear in the list, you might have to click Refresh.

  3. Click Add class, and commit changes.

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

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

Next: Quick Start: Assign User Permissions

Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.