From 63d00cf26b2d69cb9a39c701cc874057f8c5f660 Mon Sep 17 00:00:00 2001 From: Ashwin Mehendale Date: Fri, 19 Sep 2025 17:48:56 +0530 Subject: [PATCH] OBSDOCS-2437: Implement Upgrading guide feedback --- ...n.adoc => deleting-the-logging-view-plugin.adoc} | 6 +++--- ...ing-storage-from-elasticsearch-to-lokistack.adoc | 6 +++--- upgrading/docinfo.xml | 4 ++-- upgrading/upgrading-to-logging-60.adoc | 13 +++++++------ 4 files changed, 15 insertions(+), 14 deletions(-) rename modules/{deleting-red-hat-log-visualization.adoc => deleting-the-logging-view-plugin.adoc} (64%) diff --git a/modules/deleting-red-hat-log-visualization.adoc b/modules/deleting-the-logging-view-plugin.adoc similarity index 64% rename from modules/deleting-red-hat-log-visualization.adoc rename to modules/deleting-the-logging-view-plugin.adoc index 87c265d45f26..53d61418d867 100644 --- a/modules/deleting-red-hat-log-visualization.adoc +++ b/modules/deleting-the-logging-view-plugin.adoc @@ -2,10 +2,10 @@ :_template-generated: 2025-06-03 :_mod-docs-content-type: PROCEDURE -[id="deleting-red-hat-log-visualization_{context}"] -= Deleting Red{nbsp}Hat log visualization +[id="deleting-the-logging-view-plugin_{context}"] += Deleting the logging view plugin -When updating from Logging 5 to Logging 6, delete Red{nbsp}Hat Log Visualization before installing the UIPlugin. +When updating from Logging 5 to Logging 6, delete the logging view plugin before installing the UIPlugin. .Prerequisites * You have administrator permissions. diff --git a/modules/migrating-storage-from-elasticsearch-to-lokistack.adoc b/modules/migrating-storage-from-elasticsearch-to-lokistack.adoc index 428778c0f71d..7c63dab5ef21 100644 --- a/modules/migrating-storage-from-elasticsearch-to-lokistack.adoc +++ b/modules/migrating-storage-from-elasticsearch-to-lokistack.adoc @@ -13,7 +13,7 @@ You can migrate your existing Red{nbsp}Hat managed Elasticsearch to LokiStack. .Procedure -. Temporarily set the state of the `ClusterLogging` resource as `Unmanaged` +. Temporarily set the state of the `ClusterLogging` resource as `Unmanaged`. + [source,terminal] ---- @@ -29,9 +29,9 @@ The following command ensures that the `ClusterLogging` resource no longer owns $ oc -n openshift-logging patch elasticsearch/elasticsearch -p '{"metadata":{"ownerReferences": []}}' --type=merge ---- -. Remove `ClusterLogging` `ownerReferences` from the `Kibana` resource +. Remove `ClusterLogging` `ownerReferences` from the `Kibana` resource. + -The following command ensures that *ClusterLogging* no longer owns the *Kibana* resource. Updates to the *ClusterLogging* resource's `visualization` field will no longer affect the *Kibana* resource. +The following command ensures that `ClusterLogging` no longer owns the `Kibana` resource. Updates to the `ClusterLogging` resource's `visualization` field will no longer affect the `Kibana` resource. + [source,terminal] ---- diff --git a/upgrading/docinfo.xml b/upgrading/docinfo.xml index 0a123d7b5417..a93125c0d7b7 100644 --- a/upgrading/docinfo.xml +++ b/upgrading/docinfo.xml @@ -1,9 +1,9 @@ Upgrading logging {product-title} {product-version} -Upgrading older viersions and upgrade paths +Upgrading logging 5 to 6 - This document includes information abotu how to upgrade older versiosn of logging, and what upgrade paths are supported. + This document includes information about how to upgrade logging 5 to logging 6. Red Hat OpenShift Documentation Team diff --git a/upgrading/upgrading-to-logging-60.adoc b/upgrading/upgrading-to-logging-60.adoc index 6b378d8846da..0afefd70b8ef 100644 --- a/upgrading/upgrading-to-logging-60.adoc +++ b/upgrading/upgrading-to-logging-60.adoc @@ -14,20 +14,20 @@ Logging 6 is a significant upgrade from earlier releases, achieving several long Introduction of distinct Operators to manage logging components:: -* {clo} manages both collections and forwarding. +* {clo} manages both collection and forwarding. * {loki-op} manages storage. * {coo-first} manages visualization. Removal of support for managed log storage and visualization based on Elastic products:: -* Elasticsearch has been replaced with Loki. -* Kibana has been replaced with the UIplugin provided by {coo-short}. +* Elasticsearch is replaced with Loki. +* Kibana is replaced with the UIplugin provided by {coo-short}. Removal of the Fluentd log collector implementation:: Vector is now the supported collection service. API change for log collection and forwarding:: -* The API log collection has been changed from `logging.openshift.io` to `observability.openshift.io`. +* The API for log collection is changed from `logging.openshift.io` to `observability.openshift.io`. * `ClusterLogForwarder` and `ClusterLogging` have been combined under the `ClusterLogForwarder` resource in the new API. [id="steps-for-upgrading-logging-5-to-6_{context}"] @@ -56,9 +56,10 @@ include::modules/migrating-storage-from-elasticsearch-to-lokistack.adoc[leveloff [id="migrating-logging-visualization_{context}"] == Migrating logging visualization -The OpenShift console UI plugin for log visualization has been moved to the {coo-full} from the Cluster Logging Operator. +The OpenShift console UI plugin for log visualization is moved to the {coo-full} from the Cluster Logging Operator. + +include::modules/deleting-the-logging-view-plugin.adoc[leveloffset=+2] -include::modules/deleting-red-hat-log-visualization.adoc[leveloffset=+2] include::modules/installing-the-logging-ui-plug-in-gui.adoc[leveloffset=+2] [id="log-storage_{context}"]