Troubleshooting images

These sections describe a behavior you might encounter and provide suggested actions you can take.


	TIP: For additional troubleshooting information, enable console access on your Foundation base appliance using the CLI and then find the following logs. To enable access, see Basic troubleshooting techniques and read the Enable console access recommendation. `/var/log/glance/api.log` `/var/log/glance/registry.log`

Add Image operation is unsuccessful

Apply the recommendations that pertain to your situation.

Symptom	Possible cause and recommendation
When uploading an image, `Error adding image` is displayed	Disk space allocated for image is full Increase the storage volume by expanding the logical volume for the storage file system, or clean up used disk space. Image to be uploaded has the same identifier as another image If there are duplicate identifiers, delete one image or create a new image with a different (unique) identifier. Now retry the Add Image action. If the error persists, download and check log files. From the Settings screen, select Actions→Download audit logs.
The size of the uploaded image is smaller than expected on the Images screen	The image upload was only partially completed due to browser upload size limits This might be the source of the problem if: The image file is more than 4 GB and your browser is Microsoft Internet Explorer or Mozilla Firefox The image file is more than 20 GB and your browser is Google Chrome In this situation, Manually delete the image using the Delete action, which deletes the image entry from the database. Place the image on a file server. Retry the Add Image action and Enter file URL. This option allows you to add a pointer to the image on the file server, which will be used to locate the image during provisioning.
The status of a recently uploaded image is “Killed”	You navigated away from the Add Image screen in your browser while the image was uploading Manually delete the image using the Delete action, which deletes the image entry from the database. Retry the Add Image action. The disk became full while the image was uploading Manually delete the image using the Delete action, which deletes the image entry from the database. Verify whether or not the disk space for image storage is full. Increase the storage volume by expanding the logical volume for the storage file system, or clean up used disk space. Retry the Add Image action.
You see `Error contacting image service` when uploading an image	Access permission for storage media might be incorrect Verify permissions for the storage media, and correct as needed. Retry the Add Image action. If the error persists, download and check log files. From the Settings screen, select Actions→Download audit logs.
The image remains in the “Uploading” state indefinitely	The Glance image service stopped or restarted while the image was uploading Check the size of the image on the file server and the time it started uploading on the Activity screen. If the image size is less than 10 GB and it has been uploading from a file server for more than 30 minutes, it might be in an indefinite upload state. (An image uploaded from your local system through your browser might take much longer to complete.) If it appears that the image upload will not complete, select the image and delete it using the Delete action. Retry the Add Image action.

Edit Image operation is unsuccessful

Apply the recommendations that pertain to your situation.

Symptom Possible cause and recommendation

Symptom	Possible cause and recommendation
You see `Error getting image` when editing an image	The image is set to “Read Only” Ensure that the image Protected setting shows “Read-Write.” Retry the Edit Image action. Other image settings or the image itself are incorrect Ensure that the image metadata is correct and that the image is valid. If the image is not valid, you will need to recreate it. Retry the Edit Image action. If the error persists, download and check log files. From the Settings screen, select Actions→Download audit logs.

You see Error getting image when editing an image

The image is set to “Read Only”

Ensure that the image Protected setting shows “Read-Write.”
Retry the Edit Image action.

Other image settings or the image itself are incorrect

Ensure that the image metadata is correct and that the image is valid. If the image is not valid, you will need to recreate it.
Retry the Edit Image action.

If the error persists, download and check log files. From the Settings screen, select Actions→Download audit logs.

Image server storage configuration is unsuccessful

Apply the recommendations that pertain to your situation.

Symptom Possible cause and recommendation

Symptom	Possible cause and recommendation
You see `Error occurred during image server storage configuration`	Dedicated glance storage volume is not available for mounting at startup Ensure that there is a device named `/dev/sdb` and that it is accessible to the appliance VM that was configured during initial installation. Download and check log files for additional information. From the Settings screen, select Actions→Download audit logs. If the error persists, contact your storage administrator.

You see Error occurred during image server storage configuration

Dedicated glance storage volume is not available for mounting at startup

Ensure that there is a device named /dev/sdb and that it is accessible to the appliance VM that was configured during initial installation.
Download and check log files for additional information. From the Settings screen, select Actions→Download audit logs.

If the error persists, contact your storage administrator.

prev	up	next
Troubleshooting compute nodes	home	Troubleshooting virtual machine instances