1. Documentation
×

Uninstalling ManageIQ

Running the Uninstall Playbook

You must upgrade your cluster to OKD version 3.9.16 or later before you uninstall ManageIQ. If your use an earlier version, uninstalling ManageIQ will remove all PVs from your cluster.

To uninstall and erase a deployed ManageIQ installation from OKD, run the following playbook:

# ansible-playbook -v [-i /path/to/inventory] \
    playbooks/openshift-management/uninstall.yml

NFS export definitions and data stored on NFS exports are not automatically removed. You are urged to manually erase any data from old application or database deployments before attempting to initialize a new deployment.

Troubleshooting

Failure to erase old PostgreSQL data can result in cascading errors, causing the postgresql pod to enter a crashloopbackoff state. This blocks the manageiq pod from ever starting. The cause of the crashloopbackoff is due to incorrect file permissions on the database NFS export created during a previous deployment.

To continue, erase all data from the PostgreSQL export and delete the pod (not the deployer pod). For example, if you had the following pods:

$ oc get pods
NAME                 READY     STATUS             RESTARTS   AGE
httpd-1-cx7fk        1/1       Running            1          21h
manageiq-0           0/1       Running            1          21h
memcached-1-vkc7p    1/1       Running            1          21h
postgresql-1-deploy  1/1       Running            1          21h
postgresql-1-6w2t4   0/1       CrashLoopBackOff   1          21h

Then you would:

  1. Erase the data from the database NFS export.

  2. Run:

    $ oc delete postgresql-1-6w2t4

The PostgreSQL deployer pod will try to scale up a new postgresql pod to replace the one you deleted. After the postgresql pod is running, the manageiq pod will stop blocking and begin application initialization.