Uninstall Self-Hosted Deployment
This section describes how to safely delete a region from Self-hosted Private Cloud Director using the airctl CLI. Region deletion should be performed carefully, as it involves removing associated configuration and metadata.
Prerequisites & Safety Checks
Before proceeding with a region deletion, ensure the following:
Take a complete backup using the steps outlined in the Backup Guide.
This ensures that critical region data and configurations can be restored if needed.
Verify the current regions managed by your setup:
airctl get-regionsReview the output and confirm the target region name(s) you plan to delete.
Ensure no ongoing deployments, upgrades, or workloads are running in the target region.
Gracefully terminate or migrate workloads if needed.
Example :
$ /opt/pf9/airctl/airctl get-regions --config /opt/pf9/airctl/conf/airctl-config.yaml
Deployed Regions:
• Infra
• LONCommand Syntax
Delete a specific region
To delete a specific region, use the following airctl command
This command will uninstall and remove configured regions along with all infrastructure software like consul, vault, percona, k8sniff, etc.
Options:
--region <REGION_NAME>– Deletes the specified region.Omit the
--regionflag to delete all configured regions.Use the
--forceflag if the region deployment was halted or failed midway. This forces cleanup even when the state is inconsistent.
Use the --force flag if the region deployment was halted or failed midway. This forces cleanup even when the state is inconsistent.
Example:
Verification & Cleanup
After deletion, verify that the region has been successfully removed. The deleted region should no longer appear in the list of active regions.
If you plan to reuse the same nodes to deploy a new self-hosed Private Cloud Director environment, make sure to also run the following command on all nodes first.
Delete the Management Cluster
The final step is to delete the cluster to complete the cleanup or redeploy from scratch.
Last updated
Was this helpful?