Cloudera Docs

cdp-doctor recipe results

Scope

The cdp-doctor recipe results command displays the execution status of custom recipes associated with a given CDP node.

Recipes in Cloudera are user-defined automation scripts (typically shell or Python scripts) that run at specific stages during environment creation or after deployment.

The cdp-doctor recipe results command validates and reports the status of all recipe executions under various deployment hooks. Each hook directory represents a deployment stage where recipes can be applied.

This command helps administrators verify whether each recipe executed successfully, identify failures, and confirm the correct order of recipe execution.

Recipe Types

pre-service-deployment (formerly pre-cloudera-manager-start and pre-cluster-manager-start)
During Data Hub, Data Lake, or environment deployment, the script will be executed on every node before the CM server starts, and after node repair or OS upgrade of a cluster.
post-cloudera-manager-start
During a Cloudera Data Hub or Data Lake deployment, the script will be executed on every node after the Cloudera Manager server starts, but before cluster installation. post-cluster-manager-start recipes are also executed after node repair or OS upgrade of a cluster. This option is not available for FreeIPA recipes.
post-service-deployment (formerly post-cluster-install)
The script will be executed on every node after cluster installation completes on the CM server.
pre-termination
The script will be executed on every node before cluster termination.

Use Case

  • Validating or initialising scripts post-deployment.
  • Troubleshooting failed recipe executions during Data Lake or Data Hub provisioning.
  • Ensuring that post-installation actions (e.g., custom configurations, monitoring setup) have completed successfully.
  • Auditing recipe usage and verifying environment customization consistency.

Sample Output

Running the cdp-doctor recipe results command displays the following output:

[START recipe checks for node default-aws-aw-dl-master0]
Recipe hook directories: ['post-cloudera-manager-start', 'post-service-deployment']
+------------------------------------------------+---------+-----------+
| RecipePath                                     | Result  | Exit Code |
+------------------------------------------------+---------+-----------+
| /opt/cloudera/cdp/recipes/post-deploy.sh       | SUCCESS | 0         |
| /opt/cloudera/cdp/recipes/custom-monitoring.sh | SUCCESS | 0         |
+------------------------------------------------+---------+-----------+
Field Description
Recipe Hook Directories Shows the recipe execution stages. Possible values:
  • pre-service-deployment
  • post-service-deployment
  • post-cloudera-manager-start
RecipePath The file path or name of the recipe executed on the node.
Result Outcome of the recipe run:
  • SUCCESS - Recipe executed successfully.
  • FAILED - The script encountered an error. Check logs for the exact failure cause.
Exit Code Numerical result of the script execution:
  • 0 = Success
  • non-zero = Failure

Missing entries may indicate the recipe wasn not triggered due to conditional logic or deployment type.