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

$ 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:

Quick Run

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

• 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

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