Installing in offline mode

Sections

Install Puppet Discovery on an air-gapped machine or a machine you plan to air-gap.

On an air-gapped machine

Before you begin

Make sure you meet the system requirements for installing and running Puppet Discovery.

  1. On a machine with internet connectivity, download the 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.
  2. 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.
  3. Transfer the puppet-discovery.tar.gz file and the Puppet Discovery file to the air-gapped machine.
  4. 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>
  5. To check that all the container images imported, run the docker images command.

    The list of images are:

    • gcr.io/puppet-discovery/frontdoor:<version>

    • gcr.io/puppet-discovery/licensing-api:<version>

    • gcr.io/puppet-discovery/node-ui:<version>

    • gcr.io/puppet-discovery/pdp_go:<version>

    • gcr.io/puppet-discovery/pd_storage:<version>

    • gcr.io/puppet-discovery/edge:<version>

    • gcr.io/puppet-discovery/controller:<version>

    • gcr.io/puppet-discovery/pdp-proxy:<version>

    • gcr.io/puppet-discovery/identity:<version>

    • vault:0.9.0

  6. To install and start running Puppet Discovery on the air-gapped machine, run the following command:
    macOS/Linux:
    ./puppet-discovery start --offline
    Windows:
    .\puppet-discovery.exe start --offline

    To continue with the installation, see Installing on Linux, Installing on MacOS, or Installing on Windows.

On a machine planned for an air-gap

Before you begin

Make sure you meet the system requirements for installing and running Puppet Discovery.

  1. Download the 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.
  2. To install Puppet Discovery, run the following command:
    macOS/Linux:
    ./puppet-discovery start
    Windows:
    .\puppet-discovery.exe start

    To continue with the installation, see Installing on Linux, Installing on MacOS, or Installing on Windows.

  3. Disconnect the machine from the network.
  4. To start and stop running Puppet Discovery, run the following commands:
    macOS/Linux:
    ./puppet-discovery start --offline
    ./puppet-discovery stop
    Windows:
    .\puppet-discovery.exe start --offline
    .\puppet-discovery.exe stop
How helpful was this page?
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.