Installation Issues

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

• Unable to Pull Images From the Aizen Repository

• Pods in a Failed State

• No Space Left on Device

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