Updating Discovery

Sections

Update to the 1.10.0 release of Puppet Discovery.

Online installation

To update from 1.8.0, or higher, run the following command from the directory of your current installation:

macOS/Linux usage:
./puppet-discovery update
Windows usage:
.\puppet-discovery update
Important: If you have Puppet Discovery open in a browser and update to the 1.8.0 release, you must refresh your browser to be able to sign in.

To update from 1.7.0 run the following commands from the directory of your current installation:

macOS/Linux usage:
./puppet-discovery stop
docker rm pd_pdp --volumes
docker volume rm pd_data_pdp_schemas
docker volume rm pd_data_pdp_resources
./puppet-discovery update
Windows usage:
.\puppet-discovery stop
docker rm pd_pdp --volumes
docker volume rm pd_data_pdp_schemas
docker volume rm pd_data_pdp_resources
.\puppet-discovery update

The update command downloads the latest Puppet Discovery binary or executable file, and the docker command removes all volumes currently not running in your system and resolves an issue relating to older volumes still in use.

Offline installation

Update your air-gapped installation to the 1.10.0 release.

  1. This step is required only if updating from 1.7.0, or lower. Otherwise, move on to step 2. On the air-gapped machine run the following commands:
    macOS/Linux:
    ./puppet-discovery stop
    docker rm pd_pdp --volumes
    docker volume rm pd_data_pdp_schemas
    docker volume rm pd_data_pdp_resources
    
    Windows:
    .\puppet-discovery stop
    docker rm pd_pdp --volumes
    docker volume rm pd_data_pdp_schemas
    docker volume rm pd_data_pdp_resources
    
  2. On a machine with internet connectivity, download the latest Puppet Discovery file for the operating system running on the air-gapped machine:
    • Binary file for macOS or Linux.

    • Executable file for Windows.

    Note: To make the binary executable on macOS and Linux machines, run the chmod a+x ./puppet-discovery command.
  3. To export the Puppet Discovery container images, create the puppet-discovery.tar.gz file by running the following command:
    macOS/Linux:
    ./puppet-discovery export
    Windows:
    .\puppet-discovery.exe export
    Remember: You must export to a machine running the same operating system. The file size is approximately 1 GB and may take time to export.
  4. Transfer the puppet-discovery.tar.gz file and the Puppet Discovery file to the air-gapped machine.
    Important: Transfer the Puppet Discovery binary or executable file to a different directory to that of your current Puppet Discovery installation.
  5. To import the Puppet Discovery container images into the local Docker registry, run the following command:
    macOS/Linux:
    ./puppet-discovery import -f <tar file>
    Windows:
    .\puppet-discovery.exe import -f <tar file>
  6. To update and start running Puppet Discovery on the air-gapped machine, run the following command and specify the location of the new binary or executable file:
    macOS/Linux:
    ./puppet-discovery update --offline -f /path/to/puppet-discovery
    Windows:
    .\puppet-discovery.exe update --offline -f /path/to/puppet-discovery.exe
How helpful was this page?
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.