Skip to main content
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Resolución de problemas

Colaboradores juliantap netapp-aruldeepa netapp-mwallis netapp-shwetav
PDF

Utilice los punteros que se proporcionan aquí para solucionar problemas que podrían surgir durante la instalación y el uso de Trident.

Nota Si necesita ayuda con Trident, cree un paquete de soporte que utilice tridentctl logs -a -n trident y envíelo al soporte de NetApp.

Resolución de problemas generales

  • Si el pod de Trident no sale correctamente (por ejemplo, cuando el pod de Trident se encuentra atascado en el ContainerCreating fase con menos de dos contenedores listos para usar) en ejecución kubectl -n trident describe deployment trident y.. kubectl -n trident describe pod trident--** puede proporcionar información adicional. Obtención de registros de kubelet (por ejemplo, mediante journalctl -xeu kubelet) también puede ser útil.

  • Si no hay suficiente información en los registros de Trident, puede intentar habilitar el modo de depuración para Trident aprobando el -d marque el parámetro install en función de su opción de instalación.

    A continuación, confirme que la depuración se ha configurado mediante ./tridentctl logs -n trident y buscando level=debug msg en el registro.

    Instalado con el operador
    kubectl patch torc trident -n <namespace> --type=merge -p '{"spec":{"debug":true}}'

    Así se reiniciarán todos los pods de Trident, que pueden tardar varios segundos. Puede comprobarlo observando la columna "ANTIGÜEDAD" en la salida de kubectl get pod -n trident.

    Para Trident 20,07 y 20,10, utilice tprov en lugar de torc .

    Instalado con Helm
    helm upgrade <name> trident-operator-21.07.1-custom.tgz --set tridentDebug=true`
    Instalado con trimentctl
    ./tridentctl uninstall -n trident
./tridentctl install -d -n trident

  • También puede obtener registros de depuración para cada backend incluyendo debugTraceFlags en su definición de backend. Por ejemplo, incluya debugTraceFlags: {"api":true, "method":true,} para obtener llamadas a la API y recorridos de métodos en los registros de Trident. Los back-ends existentes se pueden debugTraceFlags configurar con un tridentctl backend update.

  • Cuando utilice Red Hat Enterprise Linux CoreOS (RHCOS), asegúrese de que iscsid está activado en los nodos de trabajo y se inicia de forma predeterminada. Esto se puede hacer usando OpenShift MachineConfigs o modificando las plantillas de ignición.

  • Un problema común que se puede encontrar cuando se usa Trident con "Azure NetApp Files" es cuando el inquilino y los secretos de cliente provienen de un registro de aplicación con permisos insuficientes. Para ver una lista completa de los requisitos de Trident, consulte "Azure NetApp Files" configuración.

  • Si hay problemas con el montaje de un PV en un contenedor, asegúrese de que rpcbind está instalado y en ejecución. Utilice el administrador de paquetes necesario para el sistema operativo del host y compruebe si rpcbind está en ejecución. Puede comprobar el estado de rpcbind ejecutar un systemctl status rpcbind o su equivalente.

  • Si un back-end de Trident informa que está en la failed estado a pesar de haber trabajado antes, es probable que sea por el cambio de las credenciales de SVM/administrador asociadas con el back-end. Actualización de la información del back-end mediante tridentctl update backend O rebotando el Pod de Trident se corregirá este problema.

  • Si se producen problemas de permisos al instalar Trident con Docker como el tiempo de ejecución de contenedores, intente instalar Trident con el --in cluster=false bandera. Esto no utilizará un módulo de instalación y evitará problemas de permisos vistos debido a la trident-installer usuario.

  • Utilice la uninstall parameter <Uninstalling Trident> para limpiar después de una ejecución fallida. De forma predeterminada, la secuencia de comandos no elimina los CRD creados por Trident, por lo que es seguro desinstalar e instalar de nuevo incluso en una implementación en ejecución.

  • Si desea degradar a una versión anterior de Trident, ejecute primero el tridentctl uninstall Comando para quitar Trident. Descargue el contenido que desee "Versión de Trident" e instálela utilizando tridentctl install comando.

  • Después de una instalación correcta, si un PVC está atascado en el Pending fase, en marcha kubectl describe pvc Puede proporcionar información adicional acerca de por qué Trident no pudo aprovisionar un VP para esta RVP.

Implementación incorrecta de Trident con el operador

Si utiliza el operador, el estado de implementación de Trident TridentOrchestrator cambios de Installing para Installed. Si observa la Failed y el operador no puede recuperarse por sí solo, debe comprobar los registros del operador ejecutando el siguiente comando:

tridentctl logs -l trident-operator

Al dejar atrás los registros del contenedor del operador-trident, puede indicar dónde se encuentra el problema. Por ejemplo, uno de estos problemas podría ser la incapacidad de extraer las imágenes contenedoras necesarias de los registros de entrada en un entorno con conexión aérea.

Para comprender por qué la instalación de Trident no ha tenido éxito, debería echar un vistazo al TridentOrchestrator estado.

kubectl describe torc trident-2
Name:         trident-2
Namespace:
Labels:       <none>
Annotations:  <none>
API Version:  trident.netapp.io/v1
Kind:         TridentOrchestrator
...
Status:
  Current Installation Params:
    IPv6:
    Autosupport Hostname:
    Autosupport Image:
    Autosupport Proxy:
    Autosupport Serial Number:
    Debug:
    Image Pull Secrets:         <nil>
    Image Registry:
    k8sTimeout:
    Kubelet Dir:
    Log Format:
    Silence Autosupport:
    Trident Image:
  Message:                      Trident is bound to another CR 'trident'
  Namespace:                    trident-2
  Status:                       Error
  Version:
Events:
  Type     Reason  Age                From                        Message
  ----     ------  ----               ----                        -------
  Warning  Error   16s (x2 over 16s)  trident-operator.netapp.io  Trident is bound to another CR 'trident'

Este error indica que ya existe un TridentOrchestrator`Que se utilizó para instalar Trident. Como cada clúster de Kubernetes puede tener una instancia de Trident, el operador se asegura de que en cualquier momento solo exista una activa `TridentOrchestrator que puede crear.

Además, observar el estado de los pods de Trident puede indicar con frecuencia si algo no es correcto.

kubectl get pods -n trident

NAME                                READY   STATUS             RESTARTS   AGE
trident-csi-4p5kq                   1/2     ImagePullBackOff   0          5m18s
trident-csi-6f45bfd8b6-vfrkw        4/5     ImagePullBackOff   0          5m19s
trident-csi-9q5xc                   1/2     ImagePullBackOff   0          5m18s
trident-csi-9v95z                   1/2     ImagePullBackOff   0          5m18s
trident-operator-766f7b8658-ldzsv   1/1     Running            0          8m17s

Puede ver claramente que las vainas no pueden inicializarse completamente porque no se obtuvieron una o más imágenes contenedoras.

Para solucionar el problema, debe editar el TridentOrchestrator CR. Como alternativa, puede eliminar TridentOrchestrator, y cree una nueva con la definición modificada y precisa.

Puesta en marcha de Trident incorrecta mediante tridentctl

Para ayudar a averiguar qué fue lo que salió mal, puede ejecutar el instalador de nuevo utilizando el -d argumento, que activa el modo de depuración y le ayuda a comprender cuál es el problema:

./tridentctl install -n trident -d

Después de solucionar el problema, puede limpiar la instalación de la siguiente manera y, a continuación, ejecutar el tridentctl install comando:

./tridentctl uninstall -n trident
INFO Deleted Trident deployment.
INFO Deleted cluster role binding.
INFO Deleted cluster role.
INFO Deleted service account.
INFO Removed Trident user from security context constraint.
INFO Trident uninstallation succeeded.

Eliminar completamente Trident y CRD

Puede eliminar completamente Trident y todos los CRD creados y los recursos personalizados asociados.

Advertencia Esta acción no se puede deshacer. No haga esto a menos que desee una instalación completamente nueva de Trident. Para desinstalar Trident sin eliminar CRD, consulte "Desinstale Trident".
Operador de Trident

Para desinstalar Trident y eliminar por completo los CRD mediante el operador Trident:

kubectl patch torc <trident-orchestrator-name> --type=merge -p '{"spec":{"wipeout":["crds"],"uninstall":true}}'
Timón

Para desinstalar Trident y eliminar por completo los CRD mediante Helm:

kubectl patch torc trident --type=merge -p '{"spec":{"wipeout":["crds"],"uninstall":true}}'
<code>tridentctl</code>

Para eliminar completamente los CRD después de desinstalar Trident utilizando tridentctl

tridentctl obliviate crd

Se produce un error al anular el almacenamiento en caché del nodo de NVMe con espacios de nombres de bloque sin configurar RWX o Kubernetes 1,26

Si ejecuta Kubernetes 1,26, la anulación del almacenamiento provisional del nodo puede fallar cuando se usa NVMe/TCP con espacios de nombres de bloque sin configurar de RWX. Los siguientes escenarios proporcionan una solución alternativa al fallo. También puede actualizar Kubernetes a 1,27.

Se ha eliminado el espacio de nombres y el pod

Piense en un escenario en el que tenga un espacio de nombres gestionado por Trident (volumen persistente NVMe) conectado a un pod. Si elimina el espacio de nombres directamente desde el backend de ONTAP, el proceso de anulación del almacenamiento provisional se bloquea después de intentar eliminar el pod. Este escenario no afecta al clúster de Kubernetes ni a otro funcionamiento.

Solución alternativa

Desmonte el volumen persistente (que corresponde al espacio de nombres) del nodo correspondiente y elimínelo.

LIF de datos bloqueadas

 If you block (or bring down) all the dataLIFs of the NVMe Trident backend, the unstaging process gets stuck when you attempt to delete the pod. In this scenario, you cannot run any NVMe CLI commands on the Kubernetes node.
.Solución alternativa
Abra dataLIFS para restaurar la funcionalidad completa.

Se ha eliminado la asignación de espacio de nombres

 If you remove the `hostNQN` of the worker node from the corresponding subsystem, the unstaging process gets stuck when you attempt to delete the pod. In this scenario, you cannot run any NVMe CLI commands on the Kubernetes node.
.Solución alternativa
Añada el `hostNQN` de vuelta al subsistema.

Los clientes NFSv4.2 informan "argumento no válido" después de actualizar ONTAP cuando esperaban que "v4.2-xattrs" estuviera habilitado

Después de actualizar ONTAP, los clientes NFSv4.2 pueden informar errores de "argumento inválido" al intentar montar exportaciones NFSv4.2. Este problema ocurre cuando el v4.2-xattrs La opción no está habilitada en el SVM. .Solución alternativa Habilite la v4.2-xattrs opción en SVM o actualizar a ONTAP 9.12.1 o posterior, donde esta opción está habilitada de forma predeterminada.