Skip to main content
Version: Deploy 22.1

Uninstalling Deploy Operator

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

You can uninstall the Deploy 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 to the Deploy:

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

Note: For the XL-CLI versions, refer to the Distribution Site

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 2—Verify the cluster connection

To check the connection to the cluster:

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

    Operator CIs

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

alt

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 Deploy Operator. To uninstall the CR, do the following:

  1. Click Environments.

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

  3. Click Undeploy. Undeploy

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

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 xld-operator-app(1.0.0) next to xld , 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 xld menu next to xld, 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 Deploy product only.

    alt

  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 Deploy 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-deploy/kubernetes/
  2. To delete the Operator Manager, run:

     kubectl delete –f <var>name of cr file  

    Example

    kubectl delete –f daideploy_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  

    Tip: Ensure to delete the PVCs related to Deploy product only.

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