Diagnostica i problemi comuni di Z Understand and Refactor e rimuovi definitivamente il workload quando necessario.

Risoluzione dei problemi

Il pod Z Understand non è in esecuzione

Controlla lo stato del pod:

oc get pods -n <instance-namespace> \
  -l app=ibm-bobz-understand

Esamina i log del pod:

oc logs -n <instance-namespace> \
  -l app=ibm-bobz-understand

Controlla lo stato della custom resource:

oc get bob <cr-name> \
  -n <instance-namespace> \
  -o jsonpath='{.status.understand.status}'

Lo stato rimane in `ReconcileError`

L'operator ritenta automaticamente il processo di riconciliazione e bobctl continua a fare polling degli aggiornamenti dello stato. Se lo stato persiste, monitora i log dell'operator:

oc logs \
  -n <operator-namespace> \
  deploy/ibm-bob-operator -f

La creazione del Secret o l'aggiornamento della custom resource fallisce

Verifica che i permessi richiesti siano configurati correttamente e che il cluster sia accessibile:

oc auth can-i create secret -n <instance-namespace>

oc get bob -n <instance-namespace>

oc get pods -n <operator-namespace> \
  -l app=ibm-bob-operator

Disinstallazione

Usa la procedura di disinstallazione solo quando vuoi rimuovere definitivamente Z Understand and Refactor.

Attenzione:

La disinstallazione rimuove tutti i dati e la configurazione del workload. Questa azione non può essere annullata.

La disabilitazione del workload conserva tutti i dati e la configurazione esistenti. Al contrario, il comando uninstall rimuove definitivamente tutti i volumi persistenti, consentendo al workload di essere reinstallato da uno stato pulito.

Disabilita il workload aggiornando config.yaml:

bob:
  understand:
    enabled: false

Applica la modifica:

./bobctl upgrade

Esegui il comando di disinstallazione:

./bobctl understand uninstall

Flag	Descrizione
`--yes`	Salta il prompt di conferma. Adatto per deployment scriptati o automatizzati.
`--no-wait`	Aggiorna la CR ed esce immediatamente senza attendere che l'operator termini.
`--dry-run`	Mostra le azioni che verrebbero eseguite senza applicare alcuna modifica.

Reinstallazione

Dopo il completamento del processo di disinstallazione, puoi installare nuovamente il workload Z Understand and Refactor come nuovo deployment.

Abilita il workload in config.yaml:

bob:
  understand:
    enabled: true

Applica la configurazione:

./bobctl upgrade

Esegui nuovamente la configurazione:

./bobctl understand setup --config setup.json

Risoluzione dei problemi e disinstallazione