Skip to content

[standalone-logging-docs-6.4] OBSDOCS-2437: Implement Upgrading guide feedback #99552

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Sep 23, 2025
Merged

[standalone-logging-docs-6.4] OBSDOCS-2437: Implement Upgrading guide feedback #99552

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions ...s/deleting-red-hat-log-visualization.adoc → ...les/deleting-the-logging-view-plugin.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
6 changes: 3 additions & 3 deletions modules/migrating-storage-from-elasticsearch-to-lokistack.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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]
----
Expand All @@ -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]
----
Expand Down
4 changes: 2 additions & 2 deletions upgrading/docinfo.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
<title>Upgrading logging</title>
<productname>{product-title}</productname>
<productnumber>{product-version}</productnumber>
<subtitle>Upgrading older viersions and upgrade paths</subtitle>
<subtitle>Upgrading logging 5 to 6</subtitle>
<abstract>
<para>This document includes information abotu how to upgrade older versiosn of logging, and what upgrade paths are supported.</para>
<para>This document includes information about how to upgrade logging 5 to logging 6.</para>
</abstract>
<authorgroup>
<orgname>Red Hat OpenShift Documentation Team</orgname>
Expand Down
13 changes: 7 additions & 6 deletions upgrading/upgrading-to-logging-60.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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}"]
Expand Down Expand Up @@ -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}"]
Expand Down