Using cdp-doctor
Scope
The Cloudera-provided diagnostic and troubleshooting cluster health utility helps validate, monitor, and debug the health of various components in a Cloudera Data Platform Public Cloud environment. It performs system-level, service-level, and network-level checks to ensure all CDP subsystems are correctly configured, connected, and operational. The results reduce manual troubleshooting time with structured, component-wise health information in a single interface.
The cdp-doctor utility can be used across Cloudera Public Cloud clusters, and run on:
- Data Lake / Data Hub cluster nodes
- FreeIPA nodes
Use Case
- Proactively detect issues in infrastructure, networking, metering, or Cloudera services.
- Validate environment readiness during cluster deployment or upgrades.
- Diagnose problems when services fail, nodes become unreachable, or metrics are missing.
- Generate diagnostic data for Cloudera Support (e.g., connectivity, system metrics, etc.).
| Use cases | Reason to run |
|---|---|
| After cluster deployment, pre-upgrade, and post-upgrade. | Validate system, network, and service readiness. |
| Service failure (e.g., CM server, CM agent, or Knox). | Identify which service or dependency is down. |
| Connectivity or DNS issues. | Check network reachability and address mappings. |
| IPA or authentication issues. | Validate IPA health and trust relationships. |
| Metering or telemetry problems. | Ensure telemetry data is collected and sent properly. |
| Support case preparation. | Generate health reports or logs for Cloudera Support. |
