Debugging the Cloud Object Storage add-on
Virtual Private Cloud Classic infrastructure
The ibm-object-csi-driver
add-on does not run properly.
Follow these steps to gather gather details about the issue.
- Pull the cluster configuration.
ibmcloud ks cluster config -c <cluster_name/cluster_id>
- Check the health of the add-on to ensure it is deployed properly.
ibmcloud ks cluster addon ls --cluster <cluster_name/cluster_id>
- Check the version of the installed add-on. It is recommended to use the latest version for better support.
ibmcloud ks cluster addon ls --cluster <cluster_name/cluster_id> | grep ibm-object-csi-driver
- Make sure that all CSI driver pods are in
running
state.oc get pods -n ibm-object-csi-operator | grep ibm-object-csi
If any CSI driver pod is in ImagePullBackOff
state, that means the image used for pods creation is not available in the registry or there might be permission issues. Gather the output from the previous steps and, contact support.
Open a support case. In the case details, be sure to include any relevant log files, error messages, or command outputs.
If any CSI driver pod is in CrashLoopBackOff
state, you can try the following steps:
-
Describe that pod.
oc describe pod ibm-ibm-object-csi-xxx -n ibm-object-csi-operator
-
Look for the container that is continuously restarting.
-
Collect logs for more details.
oc logs ibm-ibm-object-csi-xxx -n ibm-object-csi-operator
-
Upgrade the add-on to the latest version for a possible fix.
-
If the issue persists, contact support. Open a support case. In the case details, be sure to include any relevant log files, error messages, or command outputs.
If you need to contact support for further help, make sure you gather the following details for the support ticket.
-
Add-on health status and add-on version mentioned above.
-
PVC describe
oc describe pvc <PVC-NAME> -n <PVC-NAMESPACE>
-
PV describe
oc describe pv <pv-name>
-
Pod describe
oc describe pod <POD-NAME> -n <POD-NAMESPACE>
-
Logs of
controller-manager
podoc logs ibm-ibm-object-csi-operator-controller-manager-xxx -n ibm-object-csi-operator
-
Logs of
csi-node
podoc logs ibm-object-csi-node-xxx -n ibm-object-csi-operator