Use a task to stay up to date with Puppet Enterprise z releases for PE 2017.3 and later

When you stay up to date with Puppet Enterprise, you get the latest bug and security fixes. There’s no built-in way to check if there's a new release of PE. However, you can use a task to check for and download the latest z release of your version of PE. If you’re using PE 2019.0 or later, you can run a scheduled task to make sure that you stay up to date.

The task does not upgrade your system. It downloads the most recent z release so that you can upgrade during your next maintenance window.

Version and installation information

PE version: 2017.3 and later

Installation type: Any

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.

Solution

By installing the puppetlabs-support_tasks module, you can use task st0362 to check if you are on the most up to date z release for your version of PE. For example, if you have PE 2019.0 installed, the task checks for the most recent z release of 2019.0, not 2019.1 or later versions.

If there’s a later z release available, you can download it to a location of your choice.

Note: This task requires that the primary server (formerly called a master) has internet access.

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

2. If you’re using PE 2019.0 or later, to check for and download the z release, you can schedule task st0362 with the primary server as the job target.

   This task takes one required parameter, dlpath, the download path on the primary server for the Puppet Enterprise installer. If the task fails, check the console output to make sure your path is correct.

   If you’re using an earlier version of PE or if you’d prefer to run the task ad hoc, to check for and download the z release, run task st0362 from the console with the primary server as the job target.

   This task takes one required parameter, dlpath, the download path on the primary server for the Puppet Enterprise installer. If the task fails, check the console output to make sure your path is correct.