Troubleshooting common errors

Use this information to understand and troubleshoot common errors in the vSphere Plugin.

The following tables list common errors and how to resolve them:
Table 1. Common miscellaneous errors
Error text Error information Resolving

Unexpected error: ERROR

 An unexpected error has been encountered.

Check the quoted error and the vSphere Plugin log file for more details.

For more information, see Viewing logs.

If needed, contact IBM Support.

Table 2. Common snapshot errors
Snapshot scenario Error text Error information Resolving
Taking a snapshot A snapshot already exists with the name SNAPSHOT_NAME Snapshots must have unique names.

Change the snapshot name to something that is not already used.

For more information, see Taking a VMFS datastore snapshot.
Copying a snapshot Cannot copy from unprotected snapshot SNAPSHOT_NAME Snapshots must be protected in Ceph before they can be copied or cloned.

Protect the snapshot, by using either the Ceph Dashboard or the vSphere Plugin.

For more information, see Changing snapshot protection.
Copying a snapshot Snapshot SNAPSHOT_NAME is taking longer than expected to make from copy Long jobs can sometimes time out in the vSphere Plugin user interface. The snapshot copy creation takes place in the background. Monitor the copy creation from the Recent Tasks panel.
Deleting a snapshot Snapshot SNAPSHOT_NAME cannot be deleted when protected Snapshots must be unprotected in Ceph before they can be deleted.

Unprotect the snapshot, by using either the Ceph Dashboard or the vSphere Plugin.

For more information, see Changing snapshot protection.
Table 3. Common datastore errors
Snapshot scenario Error text Error information Resolving
Creating a datastore All hosts are offline Datastore creation requires at least one online host.

Ensure that a host is connected to the vSphere Plugin.

For more information, see Managing hosts in the plug-in dashboard.
Creating a datastore A datastore already exists with the nameDATASTORE_NAME Datastores must have unique names.

Change the datastore name to something that is not already used.

For more information, see Creating a VMFS datastore.
Creating a datastore Size SIZE is too large for datastore DATASTORE_NAME There is not enough free space on the Ceph cluster to create this datastore.

Check the space available using the Ceph GUI and adjust accordingly.

For more information, see Dashboard, within the IBM Storage Ceph documentation.
Creating a datastore Creating DATASTORE_NAME is taking longer than expected Long jobs can sometimes time out in the vSphere Plugin user interface. The datastore creation takes place in the background. Monitor the datastore creation from the Recent Tasks panel.
Expanding a datastore Size SIZE SIZE_UNIT is too large for datastore DATASTORE_NAME There is not enough free space on the Ceph cluster to expand this datastore.

Check the space available using the Ceph GUI and adjust accordingly.

For more information, see Dashboard, within the IBM Storage Ceph documentation.
Expanding a datastore Expanding DATASTORE_NAME is taking longer than expected. Long jobs can sometimes time out in the vSphere Plugin user interface. The datastore expansion takes place in the background. Monitor the datastore expansion from the Recent Tasks panel.