After you've installed Puppet Discovery, administer the application by using the CLI, setting override configurations, or disabling analytics data collection.
Command line options
The command line interface (CLI) provides additional administrative and troubleshooting options beyond using the user interface.
| ||View and modify the configuration.|
| ||Deletes and removes the instance of the Puppet Discovery application. It also deletes all Puppet Discovery data.|
| ||Export the Discovery images in a tar file. See Installing in offline mode.|
| ||Displays the help commands.|
| ||Import the Discovery images in a tar file. See Installing in offline mode.|
| ||Displays Puppet Discovery logs.|
| ||Creates a mayday tarball for troubleshooting with the Puppet support team.|
| ||Displays the log in page.|
| ||Deletes all Puppet Discovery data, and resets the application to a newly installed state.|
| ||Restarts the Puppet Discovery service and displays the log in page.|
| ||Starts the Puppet Discovery service and displays the log in page.|
| ||Displays the current status of the Puppet Discovery deployment.|
| ||Stops the Puppet Discovery service.|
| ||Updates the Puppet Discovery application to the latest version. See Updating Discovery.|
| ||Displays the current version of the Puppet Discovery application.|
After you've installed Puppet Discovery, optimize it for your environment by configuring and tuning settings as needed.
To override a configuration value, run:
Mac OS X/Linux:
./puppet-discovery config set-override key value
.\puppet-discovery.exe config set-override key value
The following configuration values can be modified.
| ||The interval between each discovery run.||every 4h|
| ||The logging levels for the controller.|| |
| ||The maximum number of discovery jobs that run in parallel.||512|
| ||The maximum number of task jobs that run in parallel.||32|
| ||The time out value, in minutes, for each job.||25|
| ||The logging levels for the edge.|| |
| ||Enable IPv6 on ingress.||true|
| ||The interval, in minutes, checks are made for resources older than the TLL interval.||60|
| ||The TLL interval of when resources are deleted.||12h|
Set analytics data collection
The user interface (UI) automatically collects data about how you use Puppet Discovery. If you want to opt out of providing this data, you can do so, after installing.
What data does Puppet Discovery collect?
Browser name and version.
Form submission events, but not form input data.
Geographic data inferred by the IP address.
Link, button, and form element clicks.
Operating system and version.
How does sharing this data benefit you?
We use the data to identify organizations that could be affected by a security issue, alert them to the issue, and provide them with steps to take or fixes to download. In addition, the data helps us understand how people use the product, which helps us improve the product to meet your needs.
How does Puppet use the collected data?
The data we collect is one of many methods we use for learning about our customers. The more we know, the better we can address your needs. For example, understanding how you navigate through the web interface can help us optimize the navigation so that you can complete your work faster. And, learning what kinds of data sources you use helps us to prioritize new functionality like increasing how many resources we can discover for those sources.
Opt out after installing
If you have already installed Puppet Discovery, and want to disable data collection, run this command:
./puppet-discovery config opt-out-analytics true
.\puppet-discovery.exe config opt-out-analytics true