Commit Graph

42 Commits

Author SHA1 Message Date
Orhan Toy 6a3d1a077e [DOCS] Fixes "enables you to" typos () 2019-12-23 14:39:14 -05:00
Lisa Cawley 2106a7b02a
[7.x][DOCS] Updates ML links () () 2019-12-20 10:01:19 -08:00
David Turner 86a40f6d8b Drop snapshot instructions for autobootstrap fix ()
The "Restore any snapshots as required" step is a trap: it's somewhere between
tricky and impossible to restore multiple clusters into a single one.

Also add a note about configuring discovery during a rolling upgrade to
proscribe any rare cases where you might accidentally autobootstrap during the
upgrade.
2019-12-02 14:33:42 +00:00
Marios Trivyzas d5842aebab
[Docs] Enhance rolling upgrade guide ()
Add a couple of pointers for the user to check the
overall cluster health and the version of ES running
on every node.

Fixes: 

(cherry picked from commit 8ca11f54cd839f41632c556601e94da67e91a3d1)
2019-11-28 17:02:36 +01:00
Lisa Cawley b0054eecd6 [DOCS] Merges duplicate pages for file realms () 2019-11-18 12:02:18 -08:00
David Turner 7739938930 Clarify that you cannot abort an upgrade ()
We do mention that rolling back an upgrade requires a restore from a snapshot,
but it's hidden at the bottom of the "preparing to upgrade" instructions on a
different page from the actual upgrade instructions. This commit duplicates the
preparatory instructions onto the pages containing the actual upgrade
instructions and rewords the point about rollbacks a bit.
2019-10-02 09:29:10 +01:00
Robin Clarke 98c1c2f650 Clearer language around upgrade sequence () 2019-10-02 09:25:50 +01:00
David Turner 41bc878738 Clarify rolling-upgrade docs ()
Note to upgrade the master-eligible nodes last, and note that
`cluster.initial_master_nodes` should not be set.
2019-09-30 17:02:58 +01:00
James Rodewig 5990532cb7
[DOCS] Reformat flush API docs () () 2019-09-30 08:42:52 -04:00
James Rodewig 1f36c4e50c
[DOCS] Replace "// CONSOLE" comments with [source,console] () () 2019-09-05 10:11:25 -04:00
Ryan Ernst f20969959f Remove plugins dir reference from docs ()
While the plugin installation directory used to be settable, it has not
been so for several major versions. This commit removes a lingering
reference to the plugins directory in upgrade docs.

closes 
2019-08-28 10:50:35 -07:00
James Rodewig d46545f729 [DOCS] Update anchors and links for Elasticsearch API relocation () 2019-07-19 09:18:23 -04:00
Alexander Reelsen ac7e1476a0 Update docs to refer to 6.8 instead of 6.7 ()
A few places in the documentation had mentioned 6.7 as the version to
upgrade from, when doing an upgrade to 7.0. While this is technically
possible, this commit will replace all those mentions to 6.8, as this is
the latest version with the latest bugfixes, deprecation checks and
ugprade assistant features - which should be the one used for upgrades.

Co-Authored-By: James Rodewig <james.rodewig@elastic.co>
2019-07-02 09:35:04 +02:00
Jake Landis df8fef3c1a
fix assumption that 6.7 is last 6.x release () 2019-05-20 14:35:28 -05:00
David Turner 51376f98a7 Clarify rolling upgrade fallback to restart upgrade ()
Adds a note that restarting half-or-more of the master-eligible nodes means
you're no longer doing a rolling upgrade, and may need to upgrade all the
things before the cluster returns to health.
2019-05-16 13:38:48 -04:00
James Rodewig 06827a495f [DOCS] Fix delimited blocks for Asciidoctor migration () 2019-04-26 11:43:41 -04:00
Nik Everett 7c2e151bf2 Docs: Rework close ml section ()
Reworks the close ml section to work properly in Asciidoctor. It
renders a little funny in AsciiDoc but AsciiDoc is on its way out
anyway....
2019-04-23 11:05:08 -04:00
DeDe Morton 360d8d40be [Docs] Change example to show col headers ()
Command needs `?v` so user can see the column headers. Otherwise the instructions in the note about checking the init and relo columns don't make sense
2019-04-05 14:58:09 -04:00
Boaz Leskes 6efe748e2e Only recommend disabling allocation of replicas in a rolling upgrade ()
The current documentation recommends disabling allocations of all shards. This prevents shards of
new indices from being allocated as well. That means that during a rolling upgrade, operations like
roll over and index shrinking will operate correctly. This, in turn, can cause issues for data ingestion
and ILM.
2019-03-27 14:18:17 +01:00
Lisa Cawley 6f03a6c546 [DOCS] Simplify ML upgrade step () 2019-03-25 10:26:29 -07:00
Lisa Cawley 52b0b9cb55 [DOCS] Add reindex steps for internal indices () 2019-03-14 10:30:13 -07:00
debadair a3ef565a25 [DOCS] First pass at upgrade updates for 7.0. ()
* [DOCS] First pass at upgrade updates for 7.0.

* [DOCS] Updates X-Pack terminology

* [DOCS] Incorporated feedback from lcawl.
2019-03-13 14:43:32 -07:00
Lisa Cawley 77e46b4f53 [DOCS] Added upgrade step for realm settings () 2019-03-12 13:04:10 -07:00
Lisa Cawley bfc9a00d9f [DOCS] Unset machine learning upgrade mode () 2019-02-20 12:06:27 -08:00
Lisa Cawley d300048cd5
[DOCS] Updates methods for upgrading machine learning () () 2019-02-15 09:29:45 -08:00
Albert Zaharovits 4efbda1bc0
[DOCS] Rolling upgrade with old internal indices ()
Upgrading the Elastic Stack perfectly documents the process to
upgrade ES from 5 to 6 when internal indices are present. However,
the rolling upgrade docs do not mention anything about internal indices.

This adds a warning in the rolling upgrade procedure, highlighting that
internal indices should be upgraded before the rolling upgrade procedure
can be started.
2019-01-09 18:14:22 +02:00
Josh Soref edb48321ba [DOCS] Various spelling corrections () 2019-01-07 14:44:12 +01:00
David Turner 1a23417aeb
[Zen2] Update documentation for Zen2 ()
This commit overhauls the documentation of discovery and cluster coordination,
removing mention of the Zen Discovery module and replacing it with docs for the
new cluster coordination mechanism introduced in 7.0.

Relates 
2018-12-20 13:02:44 +00:00
Lisa Cawley a72430e1ef
[DOCS] Adds TLS warning to rolling upgrades () 2018-11-28 09:38:58 -08:00
Nik Everett 030e8c8fe3 Docs: Tweak upgrade docs
Tweak the upgrade instructions for moving from pre-6.3-with-x-pack to
post-6.3-default distribution. Specifically, you have to remove the
x-pack plugin before upgrading because 6.4 doesn't understand how to
remove it.

Relates to 
2018-10-17 08:17:12 -04:00
Tanguy Leroux 079d130d8c
[Test] Remove duplicate method in TestShardRouting () 2018-09-10 18:29:00 +02:00
Nikolay Vasiliev d9f394b099 [DOCS] fix a couple of typos () 2018-09-04 10:07:11 +02:00
debadair 5525cb1615
[DOCS] Clarified that you must remove X-Pack plugin when upgrading from pre-6.3. () 2018-07-20 14:17:48 -07:00
David Turner 89869a2d0d
Improve allocation-disabling instructions ()
Clarify the “one minute” in the instructions to disable the shard allocation
when doing maintenance to say that it is configurable.
2018-05-29 08:34:20 +01:00
Boaz Leskes f4901b8a19 Remove usage of transient settings to enable allocations in rolling upgrade docs ()
Since we disable allocation using persistent settings, we should be consistent and remove
the setting from the persistent storage. Otherwise an accidental restart will lead for shards
not being allocated.

Relates to 
2018-05-01 15:56:14 +02:00
Boaz Leskes 6229c0ce88 Remove usage of transient settings to enable allocations in full restart upgrade docs ()
Since we disable allocation using persistent settings, we should be consistent and remove
the setting from the persistent storage. Otherwise an accidental restart will leed for shards
not being allocated.

Relates to https://github.com/elastic/elasticsearch/pull/28757
2018-05-01 15:21:46 +02:00
Lisa Cawley f82376c4f8
[DOCS] Add X-Pack upgrade details () 2018-03-15 11:40:20 -07:00
Lisa Cawley aa01770302
[DOCS] Add monitoring upgrade details () 2018-03-14 13:38:24 -07:00
Deb Adair 7715813bc9 [DOCS] Fixed broken link. 2018-02-21 10:04:09 -08:00
Deb Adair 260d68aad0 [DOCS] Changed to use transient setting to reenabled allocation. Closes 2018-02-21 08:56:06 -08:00
Deb Adair 2f9a882061 [DOCS] Fixed typos and broken attribute. 2017-12-05 11:46:40 -08:00
debadair 25ec068aef
[DOCS] Added link to upgrade guide and bumped the upgrade topic up to the top level ()
* [DOCS] Added link to the upgrade guide & tweaked the intro.

* [DOCS] Bumped upgrade topic up to the top level of the TOC
2017-12-05 10:58:52 -08:00