Viewing and Checking Region Status

This section explains how to list all deployed regions in Private Cloud Director and check their current deployment status using the airctl CLI tool.

List All Deployed Regions

To view the list of all regions currently deployed in the Self-Hosted version of Private Cloud Director , run:

Bash

/opt/pf9/airctl/airctl get-regions --config /opt/pf9/airctl/conf/airctl-config.yaml

This command retrieves region names directly from the state file and lists all currently active regions. Use it to confirm which regions are available before performing operations such as backups, deletions, or status checks.

Example output:

Bash

$ /opt/pf9/airctl/airctl get-regions --config /opt/pf9/airctl/conf/airctl-config.yaml 
Deployed Regions:
• Infra
• LON

Check Region Status

The airctl status command provides detailed information about the health and service status of each region.

By default, it shows the status of all deployed regions, including service counts and readiness indicators.

Status Command Flags

The airctl status command supports the following flags to customize output:

• --region : Specifies which region’s status to display. This flag is mandatory when using --ready or --desired.
• --ready: Displays only the number of Ready services for the specified region.
• --desired: Displays only the number of Desired services for the specified region

Info

• The --ready and --desired flags are mutually exclusive — only one can be used at a time.
• When used, these flags print only the number of services in the specified state for the given region.

Bash

Usage:
  airctl status [flags]

Flags:
      --desired         Show only the number of desired services for each region
  -h, --help            help for status
      --ready           Show only the number of ready services for each region
  -r, --region string   Display status for a specific region

Global Flags:
      --config string   config file (default is $HOME/airctl-config.yaml)
      --json            json output for commands (configure-hosts only currently)
      --quiet           disable spinners
      --verbose         print verbose logs to the console

Examples:

View All Regions and their Status :

Bash

$ /opt/pf9/airctl/airctl status --config /opt/pf9/airctl/conf/airctl-config.yaml
------------- deployment details ---------------
fqdn:                airctl-1-4161345-238.platform9.localnet
region:              airctl-1-4161345-238
deployment status:   ready
region health:       ✅ Ready
version:              PCD 2025.10-69
-------- region service status ----------
desired services:     30
ready services:       30


------------- deployment details ---------------
fqdn:                airctl-1-4161345-238-lon.platform9.localnet
region:              airctl-1-4161345-238-lon
deployment status:   ready
region health:       ✅ Ready
version:              PCD 2025.10-69
-------- region service status ----------
desired services:     84
ready services:       84

View status for a specific region :

Bash

$ /opt/pf9/airctl/airctl status --config /opt/pf9/airctl/conf/airctl-config.yaml --region Infra
------------- deployment details ---------------
fqdn:                airctl-1-4161345-238.platform9.localnet
region:              airctl-1-4161345-238
deployment status:   ready
region health:       ✅ Ready
version:              PCD 2025.10-69
-------- region service status ----------
desired services:     30
ready services:       30

View Ready Services for a Region :

Bash

$ /opt/pf9/airctl/airctl status --config /opt/pf9/airctl/conf/airctl-config.yaml --ready --region LON
84

View Desired Services for a Region :

Bash

$ /opt/pf9/airctl/airctl status --config /opt/pf9/airctl/conf/airctl-config.yaml --desired --region LON
84