Uninstalling logging

Red Hat OpenShift Logging 6.6

Uninstalling Loki Operator, Red Hat OpenShift Logging Operator and UIPlugin

Red Hat OpenShift Documentation Team

Abstract

This document provides information about uninstalling OpenShift Logging.

Chapter 1. Uninstalling logging

The following section provides instructions to uninstall the Red Hat OpenShift Logging Operator, Loki Operator, and UIPlugin from your cluster.

1.1. Uninstalling the Red Hat OpenShift Logging Operator

You can uninstall Red Hat OpenShift Logging Operator by using either the OpenShift CLI (oc) or the Red Hat OpenShift Logging web console.

1.1.1. Deleting the Red Hat OpenShift Logging Operator by using the CLI

Delete the Red Hat OpenShift Logging Operator by using the OpenShift CLI (oc).

Prerequisites

You have administrator permissions.
You installed the OpenShift CLI (oc).

Procedure

Delete the ClusterLogForwarder custom resource (CR) by running the following command:
```
$ oc delete ClusterLogForwarder instance -n openshift-logging
```
Change instance to the name of your ClusterLogForwarder CR if you have used a different name.

Delete the service account by running the following commands:

$ oc adm policy remove-cluster-role-from-user lokistack-tenant-logs -z logging-collector -n openshift-logging

$ oc adm policy remove-cluster-role-from-user collect-application-logs -z logging-collector -n openshift-logging

$ oc adm policy remove-cluster-role-from-user collect-infrastructure-logs -z logging-collector -n openshift-logging

$ oc adm policy remove-cluster-role-from-user collect-audit-logs -z logging-collector -n openshift-logging

$ oc adm policy remove-cluster-role-from-user logging-collector-logs-writer -z logging-collector -n openshift-logging

$ oc delete serviceaccount logging-collector -n openshift-logging

Delete the LogFileMetricExporter resource if you have deployed it by running the following command:
```
$  oc -n openshift-logging delete LogFileMetricExporter --all
```
Check the current version of the subscribed Red Hat OpenShift Logging Operator in the currentCSV field by running the following command:
```
$ oc get csv -n openshift-logging | grep cluster-logging
```
You get an output similar to the following example:
```
cluster-logging.v6.2.4    Red Hat OpenShift Logging   6.2.4     cluster-logging.v6.2.3    Succeeded
```
Note the first field in the output, it indicates the currentCSV value.
Delete the subscription associated with the Red Hat OpenShift Logging Operator by running the following command:
```
$ oc delete subscriptions.operators.coreos.com cluster-logging -n openshift-logging
```
Delete the CSV object for Red Hat OpenShift Logging Operator in the target namespace using the currentCSV value obtained from the earlier step:
```
$ oc delete csv cluster-logging.v6.2.4 -n openshift-logging
```
Uninstall the Red Hat OpenShift Logging Operator by running the following command:
```
$ oc delete OperatorGroup <name> -n openshift-logging
```

1.1.2. Deleting the Red Hat OpenShift Logging Operator by using the web console

You can delete the Red Hat OpenShift Logging Operator by using the Red Hat OpenShift Logging web console.

Prerequisites

You have administrator permissions.
You have access to the Red Hat OpenShift Logging web console.

Procedure

In the web console, go to Operators → Installed Operators.
Find Red Hat OpenShift Logging Operator in the list and click next to it, then click Uninstall Operator.
In the pop-up select Delete all operand instances for this operator and click Uninstall.

1.2. Uninstalling the Loki Operator

You can uninstall Loki Operator by using either the OpenShift CLI (oc) or the Red Hat OpenShift Logging web console. After uninstalling Loki Operator, delete persistent volume claims (PVCs) if you do not want to reuse them in other installations of LokiStack.

1.2.1. Deleting the Loki Operator by using the CLI

You can delete the Loki Operator by using the OpenShift CLI (oc).

Prerequisites

You have administrator permissions.
You installed the OpenShift CLI (oc).

Procedure

Delete the LokiStack custom resource (CR) by running the following command:
```
$ oc delete LokiStack logging-loki -n openshift-logging
```
Substitute logging-loki with the name of your LokiStack CR if you have used a different name.
Check the current version of the subscribed Loki Operator in the currentCSV field by running the following command:
```
$ oc get csv -n openshift-operators-redhat | grep loki-operator
```
You get an output similar to the following example:
```
loki-operator.v6.2.4      Loki Operator               6.2.4     loki-operator.v6.2.3                    Succeeded
```
Note the first field in the output, it indicates the currentCSV value.
Delete the subscription associated with the Loki Operator by running the following command:
```
$ oc delete subscriptions.operators.coreos.com loki-operator -n openshift-operators-redhat
```
Delete the CSV object for Loki Operator in the target namespace using the currentCSV value obtained from the earlier step:
```
$ oc delete csv loki-operator.v6.2.4 -n openshift-operators-redhat
```
Uninstall the Loki Operator by running the following command:
```
$ oc delete OperatorGroup <name> -n openshift-operators-redhat
```

1.2.2. Deleting the Loki Operator by using the web console

You can delete the Loki Operator by using the Red Hat OpenShift Logging web console.

Prerequisites

You have administrator permissions.
You have access to the Red Hat OpenShift Logging web console.

Procedure

In the web console, go to Operators → Installed Operators.
Find Loki Operator in the list and click next to it, then click Uninstall Operator.
In the pop-up, select Delete all operand instances for this operator and click Uninstall.

1.2.3. Deleting logging PVCs by using the CLI

You can delete persistent volume claims (PVCs) if you do not want to reuse them in other installations of LokiStack by using the OpenShift CLI (oc).

Prerequisites

You have administrator permissions.
You installed the OpenShift CLI (oc).

Procedure

Delete logging PVCs by running the following command:
```
$ oc -n openshift-logging delete pvc -l app.kubernetes.io/name=lokistack
```

1.2.4. Deleting logging PVCs by using the web console

You can delete persistent volume claims (PVCs) if you do not want to reuse them in other installations of LokiStack, by using the web console.

Prerequisites

You have administrator permissions.
You have access to the Red Hat OpenShift Logging web console.

Procedure

In the web console, go to the Storage → Persistent Volume Claims page.
Click next to each PVC, and select Delete Persistent Volume Claim.

1.3. Uninstalling the UIPlugin

You can uninstall UIPlugin by using either the OpenShift CLI (oc) or the Red Hat OpenShift Logging web console.

1.3.1. Deleting the UIPlugin by using the CLI

You can delete the UIPlugin by using the OpenShift CLI (oc).

Prerequisites

You have administrator permissions.
You installed the OpenShift CLI (oc).

Procedure

Delete the UIPlugin by running the following command:
```
$ oc delete uiplugin logging
```

1.3.2. Deleting the UIPlugin by using the web console

You can delete the UIPlugin plugin by using the Red Hat OpenShift Logging web console.

Prerequisites

You have administrator permissions.
You have access to the Red Hat OpenShift Logging web console.

Procedure

In the web console, go to Operators → Installed Operators.
Click Cluster Observability Operator from the Installed Operators list and go to the UIPlugin tab.
Click for the UIPlugin logging entry and select Delete UIPlugin.

1.4. Additional resources

This content is not included.Reclaiming a persistent volume manually

Legal Notice

Except as otherwise noted below, the text of and illustrations in this documentation are licensed by Red Hat under the Creative Commons Attribution–Share Alike 3.0 Unported license . If you distribute this document or an adaptation of it, you must provide the URL for the original version.

Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.

Red Hat, the Red Hat logo, JBoss, Hibernate, and RHCE are trademarks or registered trademarks of Red Hat, LLC. or its subsidiaries in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

XFS is a trademark or registered trademark of Hewlett Packard Enterprise Development LP or its subsidiaries in the United States and other countries.

The OpenStack® Word Mark and OpenStack logo are trademarks or registered trademarks of the Linux Foundation, used under license.

All other trademarks are the property of their respective owners.