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:

Command
    
​x
 
$ export KUBECONFIG=</path/to/your/pcd-management-cluster-kubeconfig.yaml>​# Verify connectivity$ kubectl get nodes
Copy

Installation:

Before running the script, ensure the prerequisities are met:.

Run this script to initiate the PCD cluster dump generation:

Quick Run
    
 
$ bash <(curl -Ls https://raw.githubusercontent.com/platform9/PCDDump/refs/heads/main/pcddump.sh)
Copy

For Manual execution:

Bash
    
# 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
Copy

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

Last updated on

Was this page helpful?