Image Creation Failed Using CLI

Problem

When image creation failures occur during VM image uploads through the OpenStack or pcdctl command-line tool, this troubleshooting guide provides resolution steps.

Environment

• Private Cloud Director - v2025.4 and Higher.
• Self-Hosted Private Cloud Director Virtualisation – v2025.4 and Higher.

Procedure

1

Prerequisites

Ensure the the prerequisites are met. Also refer to the documentation about importing image via CLI.

2

Source OpenStack credentials

Source the OpenStack admin.rc file. Ensure that OS_USERNAME and OS_PASSWORD are correct as per your Private Cloud Director account.

3

Verify permissions

Ensure you have administrator permission to upload the image.

4

Set OS_INTERFACE

Make sure that the OS_INTERFACE variable is set to the admin value as specified in the UI as mentioned in the documentation.

5

Run OpenStack CLI in debug/verbose mode

Use command debug mode during image creation to get detailed output.

Command

openstack debug

$ openstack --debug image create 
or 
$ openstack --verbose image create

6

Review glance logs (Self-Hosted PCD)

Review glance server logs in the glance-api pod logs for Self-Hosted PCD. On the host, check /var/log/pf9/glance-api.log to track relevant events against a specific image ID.

7

Get glance endpoints

Get the glance API public endpoint:

Command

list glance endpoints

$ openstack endpoint list --service glance
$ openstack endpoint list --service glance-cluster

8

Verify glance API

Verify the glance API service by connecting to the glance endpoint. It will return the version, status and other details.

Command

curl glance

$ curl -s https://<PCD_FQDN>/glance/

9

Contact Support

If these steps do not resolve the issue, reach out to the Platform9 Support Team for additional assistance.

Most common causes

• Glance service on the underlying host is down.
• Glance host is unreachable from the VM from where the upload is being performed.
• OpenStack admin.rc file does not have the OS_INTERFACE variable set to the admin.
• The --insecure flag was not used as the Glance node uses self-signed certificates.
• The user does not have sufficient permissions to perform the image upload.
• Ensure that the glance Pre-Requisites are met.