When image creation failures occur during VM image uploads through the OpenStack or pcdctl command-line tool, this troubleshooting guide provides resolution steps.
Private Cloud Director - v2025.4 and Higher.
Self-Hosted Private Cloud Director Virtualisation – v2025.4 and Higher.
Ensure the the prerequisites are meet also refer documentation about importing image via CLI
Source the OpenStack admin.rc file. Ensure that OS_USERNAME and OS_PASSWORD are correct as per your Private Cloud Director account.
Ensure you have administrator permission to upload the image.
Make sure that the OS_INTERFACE variable is set to the admin value as specified in the UI like mentioned in documentation.
Use command debug mode during image creation using:
$ openstack --debug image create
or
$ openstack --verbose image createReview 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.
Get glance API public endpoint which can be fetched using:
$ openstack endpoint list --service glance
$ openstack endpoint list --service glance-clusterVerify 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/If these steps prove insufficient to resolve the issue, kindly reach out to the Platform9 Support Team for additional assistance.
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.
Last updated