monitoring

KubeMacPoolDown

Note: Starting from 4.14, this runbook was replaced by KubemacpoolDown runbook.

Meaning

KubeMacPool is down. KubeMacPool is responsible for allocating MAC addresses and preventing MAC address conflicts.

Impact

If KubeMacPool is down, VirtualMachine objects cannot be created.

Diagnosis

  1. Set the KMP_NAMESPACE environment variable:

    $ export KMP_NAMESPACE="$(kubectl get pod -A --no-headers -l \
       control-plane=mac-controller-manager | awk '{print $1}')"
    
  2. Set the KMP_NAME environment variable:

    $ export KMP_NAME="$(kubectl get pod -A --no-headers -l \
       control-plane=mac-controller-manager | awk '{print $2}')"
    
  3. Obtain the KubeMacPool-manager pod details:

    $ kubectl describe pod -n $KMP_NAMESPACE $KMP_NAME
    
  4. Check the KubeMacPool-manager logs for error messages:

    $ kubectl logs -n $KMP_NAMESPACE $KMP_NAME
    

Mitigation

If you cannot resolve the issue, see the following resources: