[DOCS] Supporting Upgrades from 6.x to 7.x
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 25/100
- Issue type
- Documentation
- Clarity
- Needs clarification
- Activity status
- Stale
- Domain
- documentation
Research direction
Start by reviewing the two unchecked items in the Installation and Upgrade Guide: feedback in stack-docs issue 226 and guidance for repairing a broken upgrade from a pre-6.7 version. Resolve whether the latter belongs in the Installation and Upgrade Guide or Elasticsearch Reference; the work is done when both remaining documentation decisions are addressed and the upgrade overview is complete.
Written by the indexing model from the issue text.
Description
This issue is meant to give a high level overview of all the work needed to update the documentation for users upgrading from 6.x to 7.x.
Installation and Upgrade Guide (https://www.elastic.co/guide/en/elastic-stack/7.0/index.html):
- Update upgrade steps. See https://github.com/elastic/stack-docs/pull/242
- Verify list of "notable" breaking changes.
- Address feedback in https://github.com/elastic/stack-docs/issues/226
- Add a topic that discusses the benefits of upgrading. See https://github.com/elastic/stack-docs/pull/287
- Provide information about how to fix a “broken” upgrade if you upgrade from a pre-6.7 version and do not use the Migration Assistant (or should this be in the Elasticsearch Reference?)
Elasticsearch Reference:
- Update upgrade steps in https://www.elastic.co/guide/en/elasticsearch/reference/7.0/setup-upgrade.html. See https://github.com/elastic/elasticsearch/pull/39944
- Update machine learning considerations. See https://github.com/elastic/elasticsearch/pull/40006
- Deprecate migration APIs. See https://github.com/elastic/elasticsearch/pull/40075
Kibana Guide:
- Verify upgrade steps in https://www.elastic.co/guide/en/kibana/7.0/upgrade.html). See https://github.com/elastic/kibana/issues/33543 and https://github.com/elastic/kibana/pull/34121
- Verify Upgrade Assistant screenshots and details (https://www.elastic.co/guide/en/kibana/6.7/upgrade-assistant.html)
Logstash Reference:
- Verify upgrade steps in https://www.elastic.co/guide/en/logstash/7.0/upgrading-logstash.html See https://github.com/elastic/logstash/pull/10621
- Update Breaking Changes docs https://www.elastic.co/guide/en/logstash/7.0/breaking-changes.html See https://github.com/elastic/logstash/pull/10632
Beats Platform Reference:
- Verify upgrade steps in https://www.elastic.co/guide/en/beats/libbeat/7.0/upgrading.html See https://github.com/elastic/beats/pull/11378
- Add release highlights: https://github.com/elastic/beats/pull/11621
Cloud:
- Author ESS- and ECE- specific upgrade docs. See https://github.com/elastic/cloud/issues/27673
APM?
- 7.0 Breaking changes, Release highlights, Migration assistant, ECS changes https://github.com/elastic/apm-server/pull/1940
- Dominant language
- Java
- Stars
- 105
- Forks
- 249
- PR merge metrics
- No merged PRs in 30d
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from elastic/stack-docs
-
Difficulty 1/5 Under an hour Newbie friendliness 35/100
elastic/stack-docs#2749 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 45/100
elastic/stack-docs#2395 ·
-
discussion help wanted
Difficulty 5/5 Over a week Newbie friendliness 25/100
elastic/stack-docs#2291 ·
-
Difficulty 3/5 1-2 days Newbie friendliness 35/100
elastic/stack-docs#2263 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 45/100
elastic/stack-docs#2224 ·
All issues in elastic/stack-docs
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
infinispan/infinispan#18150 ·
-
area/frontend
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
untriaged
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
opensearch-project/k-NN#3597 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 88/100