Doc: Update upgrade info for 8.0 in main#13705
Conversation
docs/static/upgrading.asciidoc
Outdated
| ** <<field-ref-strict,Field parser is more strict and how that affects processing>> | ||
| ** <<beats-ecs,Beats conforms to the Elastic Common Schema (ECS) and how that impacts {ls}>> | ||
| ** <<bc-ecs-compatibility,Elastic Common Schema (ECS) compatibility on by default>> | ||
| ** Secure communication with Elasticsearch |
There was a problem hiding this comment.
ToDo: Add link after security content has been merged (#13693)
docs/static/upgrading.asciidoc
Outdated
| [float] | ||
| [[upgrading-logstash-pqs-6.3]] | ||
| ==== Upgrading from version 6.3 (and later) with Persistent Queues Enabled | ||
| === Upgrading with the persistent queue enabled |
There was a problem hiding this comment.
I removed a lot of PQ upgrade content specific to pre-6.3. I left a smaller chunk of content for upgrading PQs. Let's decide if this makes sense or should be removed.
There was a problem hiding this comment.
I'm ok to remove, because in 7.x series the PQ format didn't change so there isn't any path forward in "upgrading" the PQ. If a user has an older version he has however to move 6.x -> 7.x -> 8 so reading the upgrade path of previous major versions he is covered.
andsel
left a comment
There was a problem hiding this comment.
Left a couple of notes.
Waiting for https://github.com/elastic/logstash/pull/13705/files#r799043866 to be completed.
Please , request again a review after those, so that I can approve
|
|
||
| [[upgrading-using-direct-download]] | ||
| === Upgrading Using a Direct Download | ||
| === Upgrading using a direct download |
There was a problem hiding this comment.
As a side note, the PR #13684 touches the same list, in case we want to have a unique PR
There was a problem hiding this comment.
Merged before this PR
docs/static/upgrading.asciidoc
Outdated
|
|
||
| [float] | ||
| [discrete] | ||
| [[upgrade-to-6.8-rec]] |
There was a problem hiding this comment.
Shouldn't we change also the title section from [[upgrade-to-6.8-rec]] to something like [[upgrade-to-latest-previous-major]] ?
docs/static/upgrading.asciidoc
Outdated
| [float] | ||
| [[upgrading-logstash-pqs-6.3]] | ||
| ==== Upgrading from version 6.3 (and later) with Persistent Queues Enabled | ||
| === Upgrading with the persistent queue enabled |
There was a problem hiding this comment.
I'm ok to remove, because in 7.x series the PQ format didn't change so there isn't any path forward in "upgrading" the PQ. If a user has an older version he has however to move 6.x -> 7.x -> 8 so reading the upgrade path of previous major versions he is covered.
| and have the persistent queue enabled, we strongly recommend that you drain or | ||
| delete the persistent queue before you upgrade. See <<upgrading-logstash-pqs>> | ||
| delete the persistent queue before you upgrade. See <<draining-pqs>> | ||
| for information and instructions. |
There was a problem hiding this comment.
Note that this info is in Breaking Changes, not Upgrade. If we decide to remove it post-release, we can do that. For now, I changed the link to avoid breaking the doc build by pointing to content that has been removed.
Backports #13705 to the 8.0 branch
PREVIEW: https://logstash_13705.docs-preview.app.elstc.co/guide/en/logstash/master/upgrading-logstash-8.0.html