Skip to main content
Version: Release 22.2

Uninstalling Release Operator

You may want to uninstall the Release Operator to troubleshoot an issue where the Release installation is not working properly, or you no longer want to use the Operator. This section describes the steps to uninstall the Digital.ai Release Operator.

You can uninstall the Release Operator using one of the following methods:

Intended Audience​

This guide is intended for administrators with cluster administrator credentials who are responsible for application deployment.

Before You Begin​

The following are the prerequisites required to uninstall Release Operator:

  • The Kubectl tool

  • The local instance of Digital.ai Deploy, or XL-CLI

    Check following link for details: Install the XL-CLI

    Note: Use the version that matches your product version in the public folder.

Uninstall the Operator Using Local Deploy Interface​

Step 1—Log in to Deploy​

  1. Go to http://IP:4516

  2. Enter the default username and password.
    The Operator configuration items (CI) are listed under Applications and Environment menu items of the Explorer tab.

    Operator CIs

Step 3—Verify the cluster connection​

To check the connection to the cluster:

  1. From the Infrastructure menu, click the vertical ellipsis xlr menu next to xlr , and then click Check Connection.

    Operator CIs

  2. If the Infrastructure fails to connect to the server, double-click xlr (Infrastructure). The property page appears.

    xlr property

Step 4—Update the parameters​

Verify the authentication parameters, and update the expired token, certificate, and so on. Ensure the connection check is passed before you proceed further.

Step 5—Validate the resources​

Validate the resources before uninstalling the Operator. The resources must be validated after uninstallation. To validate the resources, run the following command:

oc get pods

Sample Output

Validate Resources

Step 5—Uninstall Custom Resources​

The custom resource (CR) must be uninstalled before uninstalling the Release Operator. To uninstall the CR, do the following:

  1. Click Environments.

  2. Click the vertical ellipsis xlr menu next to xlr-cr.

  3. Click Undeploy.

    Undeploy

  4. In the Undeploy xlr-cr details page, click Undeploy.

Undeploy xlr-cr

Step 6—Uninstall other Configuration Items​

  1. Repeat Step 5 and Step 6 to uninstall other configuration items under Environments.

  2. Under Environments, click the vertical ellipsis xlr-operator-app(1.0.0) next to xlr , and then click Undeploy.
    The uninstallation process starts.

  3. Verify the uninstallation status.

    Uninstallation Status

Step 7—Delete the CI infrastructure​

  1. From the Infrastructure menu, click the vertical ellipsis next to xlrxlr menu], and then click Delete.

    Delete Infrastructure

    Delete other infrastructure CIs only if you do not have any other infrastructure created.

    Delete Other Infrastructure

Step 8—Validate resources​

Validate the resources after the uninstallation:

  1. Run the following command to check the pods:

    oc get pods

  2. Verify the PVCs before deleting. Ensure to delete only the PVCs related to Release product only.

    PVC List

  3. If there is no other product installed, after uninstallation and deletion, verify the status of the Explorer.

    Explorer Status

Uninstall the Operator Using CLI​

To uninstall the Release Operator using CLI, do the following:

Note: For all the commands below, use oc for OpenShift and kubectl for Kubernetes cluster.

  1. From Artifacts folder, go to the Kubernetes directory.

    path/digitalai-release/kubernetes/

  2. To delete the Operator Manager, run:

     kubectl delete –f <name of cr file>

    Example

    kubectl delete –f dairelease_cr.yaml

  3. To delete the Template, run:

    kubectl delete –f ./template

  4. To get a list of the PVCs, run:

    kubectl get pvc

  5. To delete PVCs, run:

    kubectl delete <PVC name>

    Note: Ensure to delete the PVCs related to Release product only.

Note: After the upgrade, if you want uninstall the newly upgraded Release instance to troubleshoot any issue with the Release installation but you do not have the old Release instance, run xl op --clean or use the uninstallation script to uninstall the existing version of Digital.ai Deploy. See Troubleshooting Operator Based Installer.