PCDDump for PCD Management Cluster Troubleshooting
Overview
PCDDump - A powerful utility script for collecting comprehensive PCD Management cluster information for offline troubleshooting. This script gathers detailed cluster dump information from Self-hosted Private Cloud Director Control Plane, providing administrators with comprehensive diagnostics and troubleshooting data for effective cluster management and issue resolution.
Features
- Comprehensive Data Collection - Gathers detailed cluster diagnostics.
- Platform9 Optimized - Specifically designed for Platform9 Managed Control Plane.
- Easy Deployment - Simple one-line installation and execution.
- Admin-Friendly - Provides actionable troubleshooting information.
Prerequisities
- Internet connectivity to download the script first time.
- cURL installed
- KUBECONFIG should be exported and kubectl with sufficient permission:
$ export KUBECONFIG=</path/to/your/pcd-management-cluster-kubeconfig.yaml>
# Verify connectivity
$ kubectl get nodes
Installation:
Before running the script, ensure the following requirements are met:.
- Run this script to initiate the PCD cluster dump generation:
$ bash <(curl -Ls https://raw.githubusercontent.com/platform9/PCDDump/refs/heads/main/pcddump.sh)
- For Manual execution:
# Download the script
$ curl -L https://raw.githubusercontent.com/platform9/PCDDump/refs/heads/main/pcddump.sh -o pcddump.sh
# Make it executable
$ chmod +x pcddump.sh
# Execute the script
$ ./pcddump.sh
The tar output file get saved under /tmp
directory as /tmp/pcddump-$(date +%F_%H-%M-%S).tar.gz
Additional Information
User can upload the /tmp/pcddump-$(date +%F_%H-%M-%S).tar.gz
file as suggested by the Platform9 support team. More information in https://github.com/platform9/PCDDump