Commit graph

233 commits

Author SHA1 Message Date
Liam Thompson
33a71e3289
[DOCS] Refactor book-scoped variables in docs/reference/index.asciidoc (#107413)
* Remove `es-test-dir` book-scoped variable

* Remove `plugins-examples-dir` book-scoped variable

* Remove `:dependencies-dir:` and `:xes-repo-dir:` book-scoped variables

- In `index.asciidoc`, two variables (`:dependencies-dir:` and `:xes-repo-dir:`) were removed.
- In `sql/index.asciidoc`, the `:sql-tests:` path was updated to fuller path
- In `esql/index.asciidoc`, the `:esql-tests:` path was updated idem

* Replace `es-repo-dir` with `es-ref-dir`

* Move `:include-xpack: true` to few files that use it, remove from index.asciidoc
2024-04-17 14:37:07 +02:00
Joe Gallo
a354be7b69
Fix a couple of docs typos (#99028) 2023-08-30 09:01:34 -04:00
James Rodewig
e00b354c26
[DOCS] Remove breaking change tags (#98144)
With https://github.com/elastic/stack-docs/pull/2495 merged, we no longer reuse breaking changes in the Stack Install/Upgrade guide.

This removes the related `notable-breaking-changes[]` tags from the 8.9+ docs and updates the RN generator template.

## Out of scope
With the removal of these tags, we may no longer need the `notable` property for changelog entries and can likely simplify the logic for the [BreakingChangesGenerator](https://github.com/elastic/elasticsearch/blob/main/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/release/BreakingChangesGenerator.java). Updating those files is outside the scope of this PR. I've opened https://github.com/elastic/elasticsearch/issues/98145 to track that work.
2023-08-03 15:23:47 -04:00
debadair
777598d602
[DOCS] Remove redirect pages (#88738)
* [DOCS] Remove manual redirects

* [DOCS] Removed refs to modules-discovery-hosts-providers

* [DOCS] Fixed broken internal refs

* Fixing bad cross links in ES book, and adding redirects.asciidoc[] back into docs/reference/index.asciidoc.

* Update docs/reference/search/point-in-time-api.asciidoc

Co-authored-by: James Rodewig <james.rodewig@elastic.co>

* Update docs/reference/setup/restart-cluster.asciidoc

Co-authored-by: James Rodewig <james.rodewig@elastic.co>

* Update docs/reference/sql/endpoints/translate.asciidoc

Co-authored-by: James Rodewig <james.rodewig@elastic.co>

* Update docs/reference/snapshot-restore/restore-snapshot.asciidoc

Co-authored-by: James Rodewig <james.rodewig@elastic.co>

* Update repository-azure.asciidoc

* Update node-tool.asciidoc

* Update repository-azure.asciidoc

---------

Co-authored-by: amyjtechwriter <61687663+amyjtechwriter@users.noreply.github.com>
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
Co-authored-by: Amy Jonsson <amy.jonsson@elastic.co>
Co-authored-by: James Rodewig <james.rodewig@elastic.co>
2023-05-24 12:32:46 +01:00
Luigi Dell'Aquila
6e5c3d952c
Update docs about EQL CCS (#91542) 2022-11-15 14:07:26 +01:00
James Rodewig
6f5541a9d6
[DOCS] Update CCS forward compatibility docs (#84055)
Documents the following:

* FWC for CCS within the same major version.
* A local cluster running the last minor of a major can search a remote cluster running any minor in the following major.
* Only features that exist across all searched clusters are supported.
2022-02-28 08:18:04 -05:00
Lisa Cawley
458ef91066
[DOCS] Move ML info and upgrade APIs (#84005) 2022-02-16 11:23:00 -08:00
Tobias Stadler
e3deacf547
[DOCS] Fix typos (#83895) 2022-02-15 12:42:17 -05:00
Adam Locke
428f3af865
[DOCS] Add deprecation notice for system indices (#83688)
* [DOCS] Add deprecation notice for system indices

* Fix spacing issue
2022-02-08 17:14:48 -05:00
Tim Vernum
ff9c8271e6
Document removal of custom REST wrappers in 8.0 (#83565)
In #71061 we removed support for custom REST Handler Wrappers.

This change adds that information to the migration guide under the
"Plugin changes" section
2022-02-07 19:46:56 -05:00
James Rodewig
3aee6171e7
[DOCS] Link to the 7.17 upgrade assistant docs (#83613) (#83615)
The 8.0 upgrade assistant is only available in 7.17. This updates our docs to link to the 7.17 version of the related Kibana docs page.

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>
(cherry picked from commit 3787c13619)

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2022-02-07 18:29:26 -05:00
James Rodewig
294c49c29f
[DOCS] Clean up 8.0 deprecations (#83548)
* Removes a duplicate breaking change/deprecation for `indices.query.bool.max_clause_count`.

* Relocates the `index.merge.policy.max_merge_at_once_explicit` deprecation content to a breaking changes section.

* Adds remediation steps for removing the settings. While they no longer have an effect, specifying these settings will issue a deprecation warning.

Relates to https://github.com/elastic/elasticsearch/pull/83412
2022-02-07 15:00:23 -05:00
James Rodewig
02ea65aaff
[DOCS] Switch xrefs to external links (#83590)
We reuse our breaking changes in the [Elastic Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/current/index.html). To prevent broken links, we have to use external links rather than xrefs inside breaking changes.

Relates to https://github.com/elastic/elasticsearch/pull/83487.
2022-02-07 09:27:48 -05:00
Jake Landis
5c73ad1da2
REST API compatiblity documentation (#83487)
Co-authored-by: debadair <debadair@elastic.co>
2022-02-04 16:32:22 -06:00
James Rodewig
882bac8948 [DOCS] Fix CCS compatibility typo 2022-02-02 13:09:40 -05:00
Jack Conradson
43052a1074
Fix joda migration for week based methods in Painless (#83232)
This change updates the docs to correct suggestions for migrating from 
JodaCompatibleZonedDateTime to ZonedDateTime in Painless for week based year and week of 
week based year.
2022-01-27 12:23:49 -08:00
James Rodewig
cb6265f9bd
[DOCS] Move snapshot repo types to separate pages (#82826)
With https://github.com/elastic/elasticsearch/pull/81870, the Azure, GCS, and S3 repository types have separate, dedicated pages in the Elasticsearch guide. For consistency, this PR creates separate pages for the shared file system, read-only URL, and source-only repository types.

Related changes:

- Adds redirects to the plugins docs
- Fixes a few breaking changes that refer to the Azure, GCS, and S3 repositories as plugins.

Co-authored-by: Adam Locke <adam.locke@elastic.co>
2022-01-26 17:13:39 -05:00
James Rodewig
84429e6ff2
[DOCS] Fix typo in action.destructive_requires_name breaking change (#83085)
In 8.0+, the `action.destructive_requires_name` setting defaults to `true`, not `false`.
2022-01-25 11:03:28 -05:00
Mat Schaffer
b2f2e3a7a3
Upgrade documentation for xpack.monitoring.history.duration (#82295)
* Upgrade documentation for xpack.monitoring.history.duration

* A few updates now that https://github.com/elastic/elasticsearch/pull/82498 has been opened with a concrete policy.

* Grammar fix

* Update docs/reference/migration/migrate_8_0/cluster-node-setting-changes.asciidoc

Co-authored-by: James Baiera <james.baiera@gmail.com>

Co-authored-by: James Baiera <james.baiera@gmail.com>
2022-01-24 11:10:16 +09:00
James Rodewig
49f9c0308c [DOCS] Use external link in 8.0 breaking change 2022-01-11 11:20:15 -05:00
James Rodewig
dfb9f6f18d
[DOCS] Document 8.0 BWC support for CCS (#80809)
As of 8.0, the compatibility window for cross-cluster search (CCS) to an earlier release will be one minor release. This updates the CCS docs and adds a related 8.0 breaking change.

Closes https://github.com/elastic/elasticsearch/issues/80782
2022-01-11 10:33:12 -05:00
Rory Hunter
d2dbef5063
Convert repository plugins to modules (#81870)
Closes #81652.

Convert the `repository-azure`, `repository-gcs` and `repository-s3`
plugins into modules, so that they are always included in the
Elasticsearch distribution. Also change plugin installation, removal
and syncing so that attempting to add or remove these plugins still
succeeds but is now a no-op.
2022-01-10 10:45:42 +00:00
Costin Leau
ec57fbec6f
SQL: Remove JDBC dependency on ES lib geo (#82166)
As part of the effort of making JDBC driver self sufficient, remove the
ES lib geo dependencies without any replacement.
Currently the JDBC driver takes the WKT text and instantiates a geo
object based on the ES lib geo.
Moving forward the driver will return the WKT string representation
without any conversion letting the user pick the geo library desired.
That can be ES lib geo, jts, spatial4j or others.

Note this is a breaking change.

Relates #80277
2022-01-04 07:55:41 +02:00
James Rodewig
efeb1983ae
[DOCS] Combine 8.0 breaking changes for mapping type endpoints (#81730)
Combines several 8.0 breaking changes for the removal of API endpoints that contain mapping types. These items were separate because we previously organized breaking changes by area.

This is a follow-on to #79162.
2021-12-17 16:03:51 -05:00
Alan Woodward
f0bf6f5ee3
Configure IndexSearcher.maxClauseCount() based on Node characteristics (#81525)
This commit deprecates the indices.query.bool.max_clause_count node setting,
and instead configures the maximum clause count for lucene based on the available
heap and the size of the thread pool.

Closes #46433
2021-12-17 11:37:32 +00:00
James Rodewig
cec4a79a8e [DOCS] Fix formatting typo 2021-12-09 15:46:44 -05:00
James Rodewig
1519bb6ecb
[DOCS] Update snapshot defaults for system indices (#81226)
Updates the snapshot and restore docs for https://github.com/elastic/elasticsearch/pull/79670.

Closes https://github.com/elastic/elasticsearch/issues/81183
2021-12-08 10:15:14 -05:00
Keith Massey
68a9eaa4dc
Adding discovery.zen.bwc_ping_timeout to the list of removed zen settings (#81310)
This commit adds the discovery.zen.bwc_ping_timeout setting our documentation about the
settings that have been removed in 8.0.
2021-12-03 16:16:48 -06:00
James Rodewig
e999ad0061
[DOCS] Relocate 8.0 repositories.fs.compress breaking change (#81216)
The change removes a node-level setting. It was accidentally placed with REST API changes as part of https://github.com/elastic/elasticsearch/issues/79162. This moves the breaking change to the cluster and node setting changes section.
2021-12-01 09:53:10 -05:00
James Rodewig
58f32b361f
[DOCS] Update 8.0 breaking change for searchable snapshot shared cache (#80793)
You can no longer configure `xpack.searchable.snapshot.shared_cache.size` as a user setting in ESS on 7.13+ deployments. This PR removes the ESS icon from the related 8.0 breaking change for the setting.

It also clarifies the breaking change text to indicate that configuring the setting on non-frozen nodes will result in an error on startup.

Relates to https://github.com/elastic/elasticsearch/pull/80795
2021-11-19 11:25:55 -05:00
James Rodewig
5061c460e6
[DOCS] Remove unneeded breaking changes files (#80729)
Removes some unneeded files related to the previous organization of breaking changes.

Relates to #79162 and https://github.com/elastic/stack-docs/pull/1877
2021-11-15 17:24:58 -05:00
James Rodewig
767a23727e
[DOCS] Organize breaking changes by component (#79162)
* Reorganizes the 8.0.0 and 8.1.0 breaking changes and deprecations into component-based categories.
* Adds an ESS icon to cluster settings on the ESS user settings allowlist.
* Adds tips for sections that aren't relevant to Cloud users.
* Updates the labels for some items to provide better context.

Co-authored-by: debadair <debadair@elastic.co>
2021-11-15 10:42:12 -05:00
Artem Prigoda
a2c3daead1
Return 200 OK response code for a cluster health timeout (#78968)
Returning 408 for a cluster health timeout was deprecated in #78180 and backported to 7.x in #78940

Now we can do a breaking change in 8.0 respecting the user choice to run ES in 7.x compatible mode via the REST Compatibility layer.

Fixes #70849
2021-11-06 19:46:27 +01:00
Lisa Cawley
a80be4d7ac
[DOCS] Fixes version in ML breaking change (#80240) 2021-11-02 18:47:53 -07:00
Lisa Cawley
18320c0757
[DOCS] Adds breaking change for allow_no_datafeeds and allow_no_jobs (#80155) 2021-11-01 12:08:29 -07:00
James Rodewig
51e65b4dcb
[DOCS] Fix whitespace in tier filtering 8.0 breaking change (#79913)
Adds some whitespace so these display as unordered lists.
2021-10-27 09:30:30 -04:00
Dan Hermann
9e93765ee1
Document removal of freeze index API in migration guide (#79801) 2021-10-27 08:01:21 -05:00
Adam Locke
4d8dd1ff3f
[DOCS] Fix typos in 8.0 security migration (#79802)
* [DOCS] Fix typo

* Fix other typos

* Fix line break in deprecation notice
2021-10-26 08:51:51 -04:00
Ioannis Kakavas
0eb2baa07d
CLI tool to (re)set users password (#79709)
This change introduces a new CLI tool that can be used to set and
reset the password of all the built-in users and users in the native
realm in Elasticsearch. It depends on the file realm being enabled
(which it is, by default) and can (re)set one built-in user password at a time.
It removes the previously introduced elasticsearch-reset-elastic-password
and elasticsearch-reset-kibana-system-password as their functionality is
covered by this new tool.
2021-10-26 07:57:18 +03:00
Lisa Cawley
c10bf9be84
[DOCS] Add transform breaking changes (#79531) 2021-10-25 08:08:18 -07:00
bellengao
fd68b04049
Throw a RepositoryConflictException when trying to put or delete a repository in use (#56070) 2021-10-21 13:16:36 +02:00
Przemyslaw Gomulka
6aa0db817c
[DOCS] Migration information about ES logging breaking changes (#79146)
Adds breaking change docs for #47105. (ECS layout and plaintext log files removal)

Relates to #46119
2021-10-20 17:02:29 +02:00
James Baiera
ceaf53cf9e
Add deprecation info API entries for deprecated monitoring settings (#78799)
Recently we have deprecated a number of settings in monitoring. These settings should be represented in the deprecation info API. This PR will be backported with some minor changes to the 7.x branch so that we can start the deprecation process in that release cycle.
2021-10-19 12:45:38 -04:00
Ioannis Kakavas
d6ef299975
Add note in breaking changes for nameid_format (#77785)
* Add note in breaking changes for nameid_format

We changed the default for `nameid_format` in 8.0 in #44090 but
did not add anything to the breaking changes in the release notes.
This change amends that.

* remove reference to settings

* Fix docs build

* Accepting most of James' suggested changes

Thanks James!

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>

* Incorporating changes from Ioannis

* Apply suggestions from code review

Co-authored-by: Tim Vernum <tim@adjective.org>

* Apply suggestions from code review

Co-authored-by: Ioannis Kakavas <ikakavas@protonmail.com>

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
Co-authored-by: Adam Locke <adam.locke@elastic.co>
Co-authored-by: Tim Vernum <tim@adjective.org>
2021-10-19 12:38:52 -04:00
Jack Conradson
55e5daf470
Add deprecated methods for JodaCompatibleZonedDateTime to docs (#79202)
This change adds all the JodaCompatibleZonedDateTime methods that no longer exist to the 
migration docs with their ZonedDateTime equivalents.

Fixes: #78739
2021-10-18 08:00:47 -07:00
Adam Locke
8510766e7d
[DOCS] Add deprecation notice for reset password tool (#78793)
* [DOCS] Add deprecation notice for elastic-reset-password

* Change links to be external

* Update wording

Co-authored-by: James Rodewig <40268737+jrodewig@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>
2021-10-18 07:59:01 -04:00
Martijn van Groningen
04e5823a69
Remove default maxmind geoip databases from distribution (#78362)
* Adjusted integration tests to use geoip test fixture or to use test databases provided via config dirs (for qa module / docs).
* Kept the geolite2-databases dependency for most of the unit tests only.
* Made fallback_to_default_databases parameter on geoip processor a noop and emit deprecation warning upon using it.
* If no geoip databases are available yet to a node then the geoip processor factory returns a processor implementation that flags documents that databases are unavailable. This allows these documents to be reindex later with a pipeline. These documents will have a tag string array field, which contains a string _geoip_database_unavailable_{database_name} for each missing database in a pipeline.
* Added reload pipeline capabilities is IngestService, so that when databases are available again on a node then pipelines with geoip processor definition can be reloaded.

Relates to #68920
2021-10-13 14:52:18 +02:00
James Rodewig
ae50acdbf8
[DOCS] Add 8.0 breaking change for adjacency matrix setting (#79023)
Adds an 8.0 breaking change for the removal of the
`index.max_adjacency_matrix_filters` index setting.

Relates to #77803.
2021-10-13 08:33:39 -04:00
James Rodewig
a023febd20
[DOCS] Update the 8.0 Java breaking change for consistency (#79018)
Portions of the change reference Java 11 while other portions reference
Java 17. This updates the docs to consistently use Java 17.
2021-10-13 07:27:31 -04:00
debadair
248b2293f9
[DOCS] Add info about FIPS and Java 17 (#78580)
* [DOCS] Updated breaking changes entry for Java 11.
2021-10-06 11:54:48 -07:00