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:

Warning

Before running the script, ensure the prerequisities 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
Info

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