Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DOCS] Add version compatability and alias errors to restore snapshot guide #80059

Open
jrodewig opened this issue Oct 29, 2021 · 2 comments
Open
Labels
:Distributed/Snapshot/Restore Anything directly related to the `_snapshot/*` APIs >docs General docs changes Team:Distributed Meta label for distributed team

Comments

@jrodewig
Copy link
Contributor

jrodewig commented Oct 29, 2021

We should add the following errors to the Restore a snapshot guide:

Version compatibility errors

  • [my_repo:my_snapshot/id] the snapshot was created with Elasticsearch version [x.y.z] which is higher than the version of this node [x1.y1.z1].
    --> Ensure cluster compatible.

  • The index [my_index/id] was created with version [x.y.z] but the minimum compatible version is [x1.y1.z1]. It should be re-indexed in Elasticsearch x1.y1 before upgrading to x2.y2.z2.
    --> Ensure index compatible.

Alias-related errors

  • index and alias names need to be unique, but the following duplicates were found [my_alias(alias of [my_index/id])]
  • index, alias, and data stream names need to be unique, but the following duplicates were found [my_alias(alias of [my_index/id]) conflicts with index]
  • alias [my_alias] has more than one write index [my_index_1,my_index_2]
  • Invalid index name [my_index], already exists as alias

--> fixing aliases issues. Index and alias cannot be the same, and single alias cannot be pointing to multiple write indices.

These are courtesy of @Leaf-Lin from #79081 (comment)

@jrodewig jrodewig added >docs General docs changes :Distributed/Snapshot/Restore Anything directly related to the `_snapshot/*` APIs labels Oct 29, 2021
@jrodewig jrodewig self-assigned this Oct 29, 2021
@elasticmachine elasticmachine added Team:Distributed Meta label for distributed team Team:Docs Meta label for docs team labels Oct 29, 2021
@elasticmachine
Copy link
Collaborator

Pinging @elastic/es-docs (Team:Docs)

@elasticmachine
Copy link
Collaborator

Pinging @elastic/es-distributed (Team:Distributed)

@jrodewig jrodewig changed the title [DOCS] Add compatability and alias-related errors to restore snapshot guide [DOCS] Add compatability and alias errors to restore snapshot guide Oct 29, 2021
@jrodewig jrodewig changed the title [DOCS] Add compatability and alias errors to restore snapshot guide [DOCS] Add version compatability and alias errors to restore snapshot guide Oct 29, 2021
@jrodewig jrodewig removed their assignment Nov 3, 2021
@debadair debadair removed the Team:Docs Meta label for docs team label Apr 27, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
:Distributed/Snapshot/Restore Anything directly related to the `_snapshot/*` APIs >docs General docs changes Team:Distributed Meta label for distributed team
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants