Revises 8.x-8.x upgrade guide #5830
Open
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
natasha-moore-elastic
added
Feature: Upgrading
Priority: Medium
|
A documentation preview will be available soon. Request a new doc build by commenting
If your PR continues to fail for an unknown reason, the doc build pipeline may be broken. Elastic employees can check the pipeline status here. |
natasha-moore-elastic
requested review from
111andre111,
MikePaquette and
a03nikki
joepeeples
previously approved these changes
Sep 16, 2024
|
|
||
| Take these extra steps to ensure you are ready for migration. | ||
| Follow this guide to upgrade from an 8.x to an 8.x version. |
There was a problem hiding this comment.
"Upgrade from 8.x to 8.x" sounds redundant even though I know it's not really. At the risk of over-explaining:
Suggested change
| Follow this guide to upgrade from an 8.x to an 8.x version. | |
| Follow this guide to upgrade from an earlier 8.x version to a later 8.x version. |
| ... Ensure that the index and search rate are close to what they were before upgrading. Go to **Stack Monitoring** -> **{es}** -> **Overview**. | ||
| + | ||
| TIP: You can also check the index document count using the {ref}/cat-indices.html[cat index API]. | ||
| ... Verify that SLM is taking snapshots by {ref}/snapshots-take-snapshot.html#check-slm-history[checking the SLM history]. |
There was a problem hiding this comment.
I know we already established what SLM means earlier in the page, but it's a different section and this page is pretty dense. Wouldn't hurt to spell it out again.
|
|
||
| . Upgrade your ingest components (such as {ls}, {fleet} and {agent}, {beats}, etc.). For details, refer to the {stack-ref}/upgrading-elastic-stack.html[Elastic Stack upgrade docs]. | ||
|
|
||
| . Validate that Ingest is operating correctly. |
There was a problem hiding this comment.
Suggested change
| . Validate that Ingest is operating correctly. | |
| . Validate that ingest is operating correctly. |
| .. Open *Discover*, go through data views for each of your expected ingest data streams, and ensure that data is being ingested in the expected format and volume. | ||
|
|
||
| . Validate that {elastic-sec} is operating correctly. | ||
| .. Re-enable your desired SIEM detection rules (rule management), and ensure that enabled rules are running without errors or warnings (rule monitoring). |
There was a problem hiding this comment.
Seems like these might be references to specific UI tabs on the Rules page, so capitalize:
Suggested change
| .. Re-enable your desired SIEM detection rules (rule management), and ensure that enabled rules are running without errors or warnings (rule monitoring). | |
| .. Re-enable your desired SIEM detection rules (Rule Management), and ensure that enabled rules are running without errors or warnings (Rule Monitoring). |
Or maybe even more clarity:
Suggested change
| .. Re-enable your desired SIEM detection rules (rule management), and ensure that enabled rules are running without errors or warnings (rule monitoring). | |
| .. On the Rules page, re-enable your desired SIEM detection rules (Rule Management tab), and ensure that enabled rules are running without errors or warnings (Rule Monitoring tab). |
joepeeples
previously approved these changes
Sep 20, 2024
joepeeples
approved these changes
Sep 20, 2024
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Contributes to #5302.
Revises the instructions for upgrading from an 8.x to an 8.x version. Mostly reuses the content from the 7.17 to 8.x upgrade guide, but without the 7.17-specific information.