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.kubectl 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.
kubectl 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.
kubectl 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
kubectl describe pvc <PVC-NAME> -n <PVC-NAMESPACE>
-
PV describe
kubectl describe pv <pv-name>
-
Pod describe
kubectl describe pod <POD-NAME> -n <POD-NAMESPACE>
-
Logs of
controller-manager
podkubectl logs ibm-ibm-object-csi-operator-controller-manager-xxx -n ibm-object-csi-operator
-
Logs of
csi-node
podkubectl logs ibm-object-csi-node-xxx -n ibm-object-csi-operator