Skip to content

[DOCS] Consolidated upgrade info#1970

Merged
debadair merged 14 commits intoelastic:8.0from
debadair:upgrade-8
Feb 4, 2022
Merged

[DOCS] Consolidated upgrade info#1970
debadair merged 14 commits intoelastic:8.0from
debadair:upgrade-8

Conversation

@LeeDr
Copy link
Copy Markdown
Contributor

LeeDr commented Feb 3, 2022

The preview version of https://stack-docs_1970.docs-preview.app.elstc.co/guide/en/elastic-stack/8.0/upgrading-elastic-stack.html still shows 8.0.0-rc1.
Other than that, we should add statements about CCS and CCR. Something along the lines of;

@LeeDr
Copy link
Copy Markdown
Contributor

LeeDr commented Feb 3, 2022

The preview of https://stack-docs_1970.docs-preview.app.elstc.co/guide/en/elastic-stack/8.0/upgrade-elastic-stack-for-elastic-cloud.html still shows 8.0.0-rc1.

In this page, I would suggest in the Important section where it talks about deprecations, maybe add the notes about CCS and CCR compatibility.

Copy link
Copy Markdown
Contributor

@gchaps gchaps left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good. Comments mainly have to do with formatting and links.

Once you have upgraded from {prev-major-last}, you need to update your {es} clients and ingest components
in the following order:

. Java API Client: dependency configuration
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Links missing for Logstash, Beats, and Elastic Agent

@debadair
Copy link
Copy Markdown
Contributor Author

debadair commented Feb 3, 2022

The RC1 references are due to the attribute used for the version. The attribute is updated as part of the release process.

include::upgrading-kibana.asciidoc[]

// include::upgrading-logstash.asciidoc[]

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FYI: WIP for linking is here: elastic/logstash#13705

@debadair debadair marked this pull request as ready for review February 4, 2022 21:33
@debadair debadair merged commit bc17db1 into elastic:8.0 Feb 4, 2022
debadair added a commit to debadair/stack-docs that referenced this pull request Feb 4, 2022
* [DOCS] Consolidated upgrade info

* Updated ES instructions to sync with ES changes.

* Incorporated review feedback

* Update docs/en/install-upgrade/upgrading-stack-cloud.asciidoc

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>

* Edits

* Update docs/en/install-upgrade/upgrading-elasticsearch.asciidoc

* Apply suggestions from code review

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>

* Update docs/en/install-upgrade/upgrading-kibana.asciidoc

* Update docs/en/install-upgrade/upgrading-stack.asciidoc

* Update docs/en/install-upgrade/upgrading-kibana.asciidoc

* Update docs/en/install-upgrade/upgrading-elasticsearch.asciidoc

* Apply suggestions from code review

* Update docs/en/install-upgrade/upgrading-kibana.asciidoc

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>
debadair added a commit to debadair/stack-docs that referenced this pull request Feb 4, 2022
* [DOCS] Consolidated upgrade info

* Updated ES instructions to sync with ES changes.

* Incorporated review feedback

* Update docs/en/install-upgrade/upgrading-stack-cloud.asciidoc

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>

* Edits

* Update docs/en/install-upgrade/upgrading-elasticsearch.asciidoc

* Apply suggestions from code review

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>

* Update docs/en/install-upgrade/upgrading-kibana.asciidoc

* Update docs/en/install-upgrade/upgrading-stack.asciidoc

* Update docs/en/install-upgrade/upgrading-kibana.asciidoc

* Update docs/en/install-upgrade/upgrading-elasticsearch.asciidoc

* Apply suggestions from code review

* Update docs/en/install-upgrade/upgrading-kibana.asciidoc

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>
debadair added a commit that referenced this pull request Feb 4, 2022
* [DOCS] Consolidated upgrade info
debadair added a commit that referenced this pull request Feb 4, 2022
* [DOCS] Consolidated upgrade info
jrodewig added a commit to elastic/elasticsearch that referenced this pull request Feb 7, 2022
This moves the bulk of the upgrade information into the consolidated upgrade guide, but leaves the primary upgrade topic in place as a cross reference.

Relates to: elastic/stack-docs#1970

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
elasticsearchmachine pushed a commit to elastic/elasticsearch that referenced this pull request Feb 7, 2022
This moves the bulk of the upgrade information into the consolidated upgrade guide, but leaves the primary upgrade topic in place as a cross reference.

Relates to: elastic/stack-docs#1970

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
(cherry picked from commit f6473d7)

Co-authored-by: debadair <debadair@elastic.co>
elasticsearchmachine pushed a commit to elastic/elasticsearch that referenced this pull request Feb 7, 2022
This moves the bulk of the upgrade information into the consolidated upgrade guide, but leaves the primary upgrade topic in place as a cross reference.

Relates to: elastic/stack-docs#1970

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
(cherry picked from commit f6473d7)

Co-authored-by: debadair <debadair@elastic.co>
jrodewig added a commit that referenced this pull request Feb 9, 2022
Re-adds an anchor removed by #1970. This will create a broken link when 8.0 is released.

I'll open a separate PR to remove the anchor once I fix any outstanding references.
jrodewig added a commit that referenced this pull request Feb 10, 2022
Re-adds an anchor removed by #1970. This will create a broken link when 8.0 is released.

I'll open a separate PR to remove the anchor once I fix any outstanding references.

(cherry picked from commit 7bf3570)
jrodewig added a commit that referenced this pull request Feb 10, 2022
Re-adds an anchor removed by #1970. This will create a broken link when 8.0 is released.

I'll open a separate PR to remove the anchor once I fix any outstanding references.

(cherry picked from commit 7bf3570)
jrodewig added a commit that referenced this pull request Feb 10, 2022
Updates the upgrade guide to clarify BWC for CCS. Based on [the CCS docs](https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-cross-cluster-search.html#ccs-supported-configurations), you can only search back one minor version.  This means a local 8.1 cluster can only search remote 8.0+ clusters.

Relates to elastic/kibana#125138 and #1970
jrodewig added a commit that referenced this pull request Feb 10, 2022
Updates the upgrade guide to clarify BWC for CCS. Based on [the CCS docs](https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-cross-cluster-search.html#ccs-supported-configurations), you can only search back one minor version.  This means a local 8.1 cluster can only search remote 8.0+ clusters.

Relates to elastic/kibana#125138 and #1970

(cherry picked from commit 70964c7)
jrodewig added a commit that referenced this pull request Feb 10, 2022
Updates the upgrade guide to clarify BWC for CCS. Based on [the CCS docs](https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-cross-cluster-search.html#ccs-supported-configurations), you can only search back one minor version.  This means a local 8.1 cluster can only search remote 8.0+ clusters.

Relates to elastic/kibana#125138 and #1970

(cherry picked from commit 70964c7)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants