You can use the Puppet plug-in Node Management workflows to accept or revoke agent certificates on the Puppet Master, install, configure, and remediate Linux and Windows Puppet agents.

You can find these workflows on the Workflows view of the Orchestrator client, in the Node Management subdirectory of the Puppet plug-in library.

Table 1. Node Management Workflows

Workflow

Description

Install Linux Agent with SSH

Uses SSH to install the Puppet agent on a Linux node.

To run this workflow, complete the following parameters:

  • Add a Puppet Master that was registered in the vRealize Orchestrator inventory in the Puppet Master text box.

  • (Optional) Override the default Puppet agent download path in the Installer Base URL text box.

    For example, the default agent download URLs for Puppet Open Source are http://yum.puppetlabs.com and http://apt.puppetlabs.com.

    For Puppet Enterprise, the Administrator must install the appropriate agent package from the Puppet Master package repository on the Puppet Master.

  • Enter the Linux node IP address in the Hostname text box.

  • Enter the root login credentials in the Username text box.

  • Enter the root password.

Configure Linux Agent with SSH

Uses SSH to configure the Puppet agent on a Linux node.

To run this workflow, complete the following parameters:

  • Add a Puppet Master that was registered in the vRealize Orchestrator inventory in the Puppet Master text box.

  • Enter the Linux node IP address in the Puppet Node Hostname text box.

  • Enter the root login credentials in the Puppet Node Username text box.

  • Enter the root password.

  • Define an environment that the Puppet node belongs to such as test, QE, or production.

  • (Optional) Click Yes to register the Puppet Master host name to the IP address in the node hosts file.

Install Windows Agent with PowerShell

Uses PowerShell to install the Puppet agent on a Windows node.

To run this workflow, complete the following parameters:

  • Add a Puppet Master that was registered in the vRealize Orchestrator inventory in the Puppet Master text box.

  • (Optional) Override the default Puppet agent download path in the Installer Base URL text box.

    The default agent download URL for the Puppet Enterprise https://s3.amazonaws.com/pe-builds/released and the Puppet Open Source https://downloads.puppetlabs.com/windows.

  • Select an HTTP or HTTPS protocol from the WinRM transport protocol drop-down menu.

    The WinRM protocol determines the authentication mechanism. The supported authentication mechanism is Basic.

  • Enter the Windows node IP address in the Hostname text box.

  • Enter the Administrator login credentials in the Username text box.

  • Enter the password.

Configure Windows Agent with PowerShell

Uses PowerShell to configure the Puppet agent on a Windows node.

To run this workflow, complete the following parameters:

  • Add a Puppet Master that was registered in the vRealize Orchestrator inventory in the Puppet Master text box.

  • Enter the password.

  • Select an HTTP or HTTPS protocol from the WinRM transport protocol drop-down menu.

    The WinRM protocol determines the authentication mechanism. The supported authentication mechanism is Basic.

  • Enter the Windows node IP address in the Hostname text box.

  • Enter the Administrator login credentials in the Username text box.

  • Enter the password.

  • Define an environment that the Puppet node belongs to such as test, QE, or production.

  • (Optional) Click Yes to register the Puppet Master host name to the IP address in the node hosts file.

Remediate Linux Node with SSH

Triggers an on-demand Puppet agent run of the Linux node.

To run this workflow, complete the following parameters:

  • Enter the Linux node IP address in the Hostname text box.

  • Enter the root login credentials in the Puppet Node Username text box.

  • Enter the root password.

Remediate Windows Node with PowerShell

Triggers an on-demand Puppet agent run of the Windows node.

To run this workflow, complete the following parameters:

  • Select an HTTP or HTTPS protocol from the WinRM transport protocol drop-down menu.

    The WinRM protocol determines the authentication mechanism. The supported authentication mechanism is Basic.

  • Enter the Windows node IP address in the Hostname text box.

  • Enter the Administrator login credentials in the Username text box.

  • Enter the password.

Sign Node Certificate

Signs node certificate signing request on Puppet Master.

To run this workflow, complete the following parameters:

  • Add a Puppet Master that was registered in the vRealize Orchestrator inventory in the Puppet Master text box.

  • Enter the node name to accept the certificate signing request on the Puppet Master.

  • Accept the default setting to allow the Puppet Master to retry the connection in case of a network lag.

Clean Node Certificate

Revokes applicable node certificate and removes all of the files related to that node from the Puppet Master certificate storage.

To run this workflow, complete the following parameters:

  • Add a Puppet Master that was registered in the vRealize Orchestrator inventory in the Puppet Master text box.

  • Enter the node name to revoke the certificate from and remove from the Puppet certificate storage.