DocsPuppet Discovery
Troubleshooting

Troubleshooting

Sections

Use this section to troubleshoot issues with your Puppet Discovery installation.

Forgotten password

If you have forgotten your password, you must delete containers, volumes, and then reinstall Puppet Discovery.

  1. Delete the Puppet Discovery directory, by running this command:
    rm -rf .puppet-discovery
  2. Stop and remove each container, by running these commands:
    docker stop pd_ui
    docker rm pd_ui
    
    docker stop pd_licensing
    docker rm pd_licensing
    
    docker stop pd_edge
    docker rm pd_edge
    
    docker stop pd_gopdp
    docker rm pd_gopdp
    
    docker stop pd_export
    docker rm pd_export
    
    docker stop pd_controller
    docker rm pd_controller
    
    docker stop pd_pdp
    docker rm pd_pdp
    
    docker stop pd_vault
    docker rm pd_vault
    
    docker stop pd_storage
    docker rm pd_storage
    
    docker stop pd_identity
    docker rm pd_identity
    
    docker stop pd_ingress
    docker rm pd_ingress
  3. Delete each volume used to persist data for the data platform and the vault, by running these commands:
    docker volume rm pd_data_pdp_resources
    docker volume rm pd_data_pdp_schemas
    docker volume rm pd_data_pdpgo_resources
    docker volume rm pd_data_pdpgo_schemas
    docker volume rm pd_data_pdsql_graph
    docker volume rm pd_data_ui_data
    docker volume rm pd_data_vault_file
    docker volume rm pd_data_vault_logs
  4. To reinstall Puppet Discovery, run this command:

    macOS/Linux:

    ./puppet-discovery start

    Windows:

    .\puppet-discovery.exe start

Troubleshoot containers

Check status

Puppet Discovery consists of a number of Docker containers. To check the current status of the containers, run one of the following comands:

macOS/Linux:

./puppet-discovery status
The Puppet Discovery deployment is currently OK: true

Windows:

.\puppet-discovery.exe status
The Puppet Discovery deployment is currently OK: true

To view a list of all the containers, whether running or stopped, run the following command:

docker ps -a
CONTAINER ID        IMAGE                                          COMMAND                  CREATED              STATUS              PORTS                                         NAMES
a810639a3144        gcr.io/puppet-discovery/frontdoor:1.10.0       "nginx -g 'daemon of…"   59 seconds ago       Up 58 seconds       0.0.0.0:8080->80/tcp, 0.0.0.0:8443->443/tcp   pd_ingress
5be3ff489589        gcr.io/puppet-discovery/node-ui:1.10.0         "/usr/src/app/entryp…"   About a minute ago   Up 59 seconds                                                     pd_ui
124dc705098d        gcr.io/puppet-discovery/edge:1.10.0            "/shared/wait-for-it…"   About a minute ago   Up About a minute   9997/tcp                                      pd_edge
b52f739662c5        gcr.io/puppet-discovery/licensing-api:1.10.0   "/entrypoint.sh"         About a minute ago   Up About a minute   8443/tcp                                      pd_licensing
b75dab144dcd        gcr.io/puppet-discovery/controller:1.10.0      "/controller-svc"        About a minute ago   Up About a minute   9999/tcp                                      pd_controller
cebd586f1432        gcr.io/puppet-discovery/pdp-go:1.10.0          "/app/entrypoint.sh"     About a minute ago   Up About a minute   8082-8084/tcp, 8087/tcp                       pd_gopdp
c2fc09fde00c        gcr.io/puppet-discovery/pdp-proxy:1.10.0       "/pdp-proxy-svc"         About a minute ago   Up About a minute   9200/tcp                                      pd_export
92875501d1b9        gcr.io/puppet-discovery/pd-storage:1.10.0      "storageEntryPoint.s…"   About a minute ago   Up About a minute   5432/tcp                                      pd_storage
ec69dd769afb        gcr.io/puppet-discovery/identity:1.10.0        "/opt/jboss/tools/do…"   About a minute ago   Up About a minute   8080/tcp, 8443/tcp                            pd_identity
f27096eb5e8f        vault:0.9.0                                    "docker-entrypoint.s…"   About a minute ago   Up About a minute   0.0.0.0:8200->8200/tcp                        pd_vault

Restart

To restart the containers, run the following command:

macOS/Linux:

./puppet-discovery restart
Please enter your admin password: ********

Windows:

.\puppet-discovery.exe restart
Please enter your admin password: ********

Troubleshoot tasks

Whether managing a service or installing the Puppet agent on a target host, both tasks require root or Administrative privileges.

To troubleshoot a task, check the edge logs by running one of the following logs commands:

macOS/Linux:

./puppet-discovery logs edge

Windows:

.\puppet-discovery.exe logs edge

Docker:

docker logs pd_edge

View error logs

To check the error logs for a specific container, run one of the following commands:

macOS/Linux:

./puppet-discovery logs container_name

Windows:

.\puppet-discovery.exe logs container_name

Docker:

docker logs --details pd_container_name
How helpful was this page?
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.