Image Creation Using CLI Failed

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. Ensure the the prerequisites are meet also refer documentation about importing image via CLI
2. Source the OpenStack admin.rc file. Ensure that OS_USERNAME and OS_PASSWORD are correct as per your Private Cloud Director account.
3. Ensure you have administrator permission to upload the image.
4. Make sure that the OS_INTERFACE variable is set to the admin value as specified in the UI like mentioned in documentation.
5. Use command debug mode during image creation using:

$ openstack --debug image create 

or 

$ openstack --verbose image create

5. Review glance server logs in the glance-api pod logs in case of Self-Hosted PCD. On the host, review the /var/log/pf9/glance-api.log to track the relevant events against a specific image ID.
6. Get glance API public endpoint which can be fetched using:

$ openstack endpoint list --service glance

$ openstack endpoint list --service glance-cluster

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

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

8. If these steps prove insufficient to resolve the issue, kindly 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.