Installation Issues

This section provides recommended solutions to some commonly seen problems during deployment:

Unable to Pull Images From the Aizen Repository

Error: ImagePullBackOff or ErrImagePull

ImagePullBackOff will be seen when you describe the pod using the command:

kubectl describe pod <PODNAME>

kubectl get pods -n <NAMESPACE>

Solution

  1. Check if the Aizen Repository secret name used during deployment is missing in your namespace, or if the Aizen Repository credential name was misspelled during deployment:

    kubectl get secrets -n <NAMESPACE>
  2. If the names are missing, create them by running this command:

    kubectl create secret docker-registry aizenrepo-creds 
    --docker-username=aizencorp 
    --docker-password=<YOUR SECRET> 
    -n <NAMESPACE>

Pods in a Failed State

  1. When the state of specified pods is not in a Running state, run this command:

    kubectl -n <NAMESPACE> get pods
  2. Check the describe output for the pod:

    kubectl -n <NAMESPACE> describe pod <PODNAME>

No Space Left on Device

Error: No space left on device

This error is seen during the execution of console commands.

Solution

  1. Validate that the storage class has the property ALLOWVOLUMEEXPANSION set to true:

    kubectl describe sc <storage classname>
  2. Increase the storage size for the PersistentVolumeClaim (PVC) without any downtime:

    kubectl get pvc -n <namespace>
  3. Edit the storage size of the PVC:

    kubectl edit pvc <pvc name> -n <namespace>

    Edit and increase the storage size for all the PVCs listed by the previous command.

  4. Delete the storage StatefulSet:

    kubectl -n <namespace> get statefulset
     
    kubectl delete statefulset --cascade=orphan <statefulset name> -n namespace
  5. Redeploy the chart to re-create storage StatefulSet:

    helm upgrade <existing release name> <chartname> -n <>namespace>
  6. The storage StatefulSet will be created with the updated PVC size:

    kubectl -n <namespace> get pvc

Last updated