Move migrate_3_0 to migrate_5_0
This commit is contained in:
parent
5d8631848b
commit
1e1645d22b
|
@ -16,7 +16,7 @@ As a general rule:
|
|||
|
||||
See <<setup-upgrade>> for more info.
|
||||
--
|
||||
include::migrate_3_0.asciidoc[]
|
||||
include::migrate_5_0.asciidoc[]
|
||||
|
||||
include::migrate_2_3.asciidoc[]
|
||||
|
||||
|
|
|
@ -1,28 +1,28 @@
|
|||
[[breaking-changes-3.0]]
|
||||
== Breaking changes in 3.0
|
||||
[[breaking-changes-5.0]]
|
||||
== Breaking changes in 5.0
|
||||
|
||||
This section discusses the changes that you need to be aware of when migrating
|
||||
your application to Elasticsearch 3.0.
|
||||
your application to Elasticsearch 5.0.
|
||||
|
||||
* <<breaking_30_search_changes>>
|
||||
* <<breaking_30_rest_api_changes>>
|
||||
* <<breaking_30_cat_api>>
|
||||
* <<breaking_30_parent_child_changes>>
|
||||
* <<breaking_30_settings_changes>>
|
||||
* <<breaking_30_mapping_changes>>
|
||||
* <<breaking_30_plugins>>
|
||||
* <<breaking_30_java_api_changes>>
|
||||
* <<breaking_30_cache_concurrency>>
|
||||
* <<breaking_30_non_loopback>>
|
||||
* <<breaking_30_thread_pool>>
|
||||
* <<breaking_30_allocation>>
|
||||
* <<breaking_30_percolator>>
|
||||
* <<breaking_30_packaging>>
|
||||
* <<breaking_30_scripting>>
|
||||
* <<breaking_30_term_vectors>>
|
||||
* <<breaking_30_security>>
|
||||
* <<breaking_50_search_changes>>
|
||||
* <<breaking_50_rest_api_changes>>
|
||||
* <<breaking_50_cat_api>>
|
||||
* <<breaking_50_parent_child_changes>>
|
||||
* <<breaking_50_settings_changes>>
|
||||
* <<breaking_50_mapping_changes>>
|
||||
* <<breaking_50_plugins>>
|
||||
* <<breaking_50_java_api_changes>>
|
||||
* <<breaking_50_cache_concurrency>>
|
||||
* <<breaking_50_non_loopback>>
|
||||
* <<breaking_50_thread_pool>>
|
||||
* <<breaking_50_allocation>>
|
||||
* <<breaking_50_percolator>>
|
||||
* <<breaking_50_packaging>>
|
||||
* <<breaking_50_scripting>>
|
||||
* <<breaking_50_term_vectors>>
|
||||
* <<breaking_50_security>>
|
||||
|
||||
[[breaking_30_search_changes]]
|
||||
[[breaking_50_search_changes]]
|
||||
=== Warmers
|
||||
|
||||
Thanks to several changes like doc values by default or disk-based norms,
|
||||
|
@ -31,7 +31,7 @@ API have been removed: it is not possible anymore to register queries that
|
|||
will run before a new IndexSearcher is published.
|
||||
|
||||
Don't worry if you have warmers defined on your indices, they will simply be
|
||||
ignored when upgrading to 3.0.
|
||||
ignored when upgrading to 5.0.
|
||||
|
||||
=== Search changes
|
||||
|
||||
|
@ -94,7 +94,7 @@ Scroll requests sorted by `_doc` have been optimized to more efficiently resume
|
|||
from where the previous request stopped, so this will have the same performance
|
||||
characteristics as the former `scan` search type.
|
||||
|
||||
[[breaking_30_rest_api_changes]]
|
||||
[[breaking_50_rest_api_changes]]
|
||||
=== REST API changes
|
||||
|
||||
==== id values longer than 512 bytes are rejected
|
||||
|
@ -166,7 +166,7 @@ Removed support for the undocumented `query_binary` and `filter_binary` sections
|
|||
|
||||
Payloads are now loaded when needed.
|
||||
|
||||
[[breaking_30_cat_api]]
|
||||
[[breaking_50_cat_api]]
|
||||
=== CAT API changes
|
||||
|
||||
==== Use Accept header for specifying response media type
|
||||
|
@ -184,14 +184,14 @@ The `host` field has been removed from the cat nodes API as its value
|
|||
is always equal to the `ip` field. The `name` field is available in the
|
||||
cat nodes API and should be used instead of the `host` field.
|
||||
|
||||
[[breaking_30_parent_child_changes]]
|
||||
[[breaking_50_parent_child_changes]]
|
||||
=== Parent/Child changes
|
||||
|
||||
The `children` aggregation, parent child inner hits and `has_child` and `has_parent` queries will not work on indices
|
||||
with `_parent` field mapping created before version `2.0.0`. The data of these indices need to be re-indexed into a new index.
|
||||
|
||||
The format of the join between parent and child documents have changed with the `2.0.0` release. The old
|
||||
format can't read from version `3.0.0` and onwards. The new format allows for a much more efficient and
|
||||
format can't read from version `5.0.0` and onwards. The new format allows for a much more efficient and
|
||||
scalable join between parent and child documents and the join data structures are stored on disk
|
||||
data structures as opposed as before the join data structures were stored in the jvm heap space.
|
||||
|
||||
|
@ -213,15 +213,15 @@ is needed then the `max_children` option shouldn't be defined at all on the `has
|
|||
|
||||
==== `_parent` field no longer indexed
|
||||
|
||||
The join between parent and child documents no longer relies on indexed fields and therefor from `3.0.0` onwards
|
||||
The join between parent and child documents no longer relies on indexed fields and therefor from `5.0.0` onwards
|
||||
the `_parent` indexed field won't be indexed. In order to find documents that referrer to a specific parent id
|
||||
the new `parent_id` query can be used. The get response and hits inside the search response remain to include
|
||||
the parent id under the `_parent` key.
|
||||
|
||||
[[breaking_30_settings_changes]]
|
||||
[[breaking_50_settings_changes]]
|
||||
=== Settings changes
|
||||
|
||||
From Elasticsearch 3.0 on all settings are validated before they are applied. Node level and default index
|
||||
From Elasticsearch 5.0 on all settings are validated before they are applied. Node level and default index
|
||||
level settings are validated on node startup, dynamic cluster and index setting are validated before they are updated/added
|
||||
to the cluster state. Every setting must be a _known_ setting or in other words all settings must be registered with the
|
||||
node or transport client they are used with. This implies that plugins that define custom settings must register all of their
|
||||
|
@ -330,7 +330,7 @@ control the queue implementation used in the cluster service and the
|
|||
handling of ping responses during discovery. This was an undocumented
|
||||
setting and has been removed.
|
||||
|
||||
[[breaking_30_mapping_changes]]
|
||||
[[breaking_50_mapping_changes]]
|
||||
=== Mapping changes
|
||||
|
||||
==== Default doc values settings
|
||||
|
@ -358,8 +358,8 @@ instead of `not_analyzed`/`no`. The `string` field still accepts
|
|||
==== ++_source++'s `format` option
|
||||
|
||||
The `_source` mapping does not support the `format` option anymore. This option
|
||||
will still be accepted for indices created before the upgrade to 3.0 for backward
|
||||
compatibility, but it will have no effect. Indices created on or after 3.0 will
|
||||
will still be accepted for indices created before the upgrade to 5.0 for backward
|
||||
compatibility, but it will have no effect. Indices created on or after 5.0 will
|
||||
reject this option.
|
||||
|
||||
==== Object notation
|
||||
|
@ -382,7 +382,7 @@ enable doc values on a field. This no longer works: the only way to enable or
|
|||
disable doc values is by using the `doc_values` property of mappings.
|
||||
|
||||
|
||||
[[breaking_30_plugins]]
|
||||
[[breaking_50_plugins]]
|
||||
=== Plugin changes
|
||||
|
||||
The command `bin/plugin` has been renamed to `bin/elasticsearch-plugin`.
|
||||
|
@ -479,7 +479,7 @@ Mapper attachments has been deprecated. Users should use now the {plugins}/inges
|
|||
plugin.
|
||||
|
||||
|
||||
[[breaking_30_java_api_changes]]
|
||||
[[breaking_50_java_api_changes]]
|
||||
=== Java API changes
|
||||
|
||||
==== Count api has been removed
|
||||
|
@ -667,21 +667,21 @@ to index a document only if it doesn't already exist.
|
|||
|
||||
The inner DirectCandidateGenerator class has been moved out to its own class called DirectCandidateGeneratorBuilder.
|
||||
|
||||
[[breaking_30_cache_concurrency]]
|
||||
[[breaking_50_cache_concurrency]]
|
||||
=== Cache concurrency level settings removed
|
||||
|
||||
Two cache concurrency level settings `indices.requests.cache.concurrency_level` and
|
||||
`indices.fielddata.cache.concurrency_level` because they no longer apply to the cache implementation used for the
|
||||
request cache and the field data cache.
|
||||
|
||||
[[breaking_30_non_loopback]]
|
||||
[[breaking_50_non_loopback]]
|
||||
=== Remove bind option of `non_loopback`
|
||||
|
||||
This setting would arbitrarily pick the first interface not marked as loopback. Instead, specify by address
|
||||
scope (e.g. `_local_,_site_` for all loopback and private network addresses) or by explicit interface names,
|
||||
hostnames, or addresses.
|
||||
|
||||
[[breaking_30_thread_pool]]
|
||||
[[breaking_50_thread_pool]]
|
||||
=== Forbid changing of thread pool types
|
||||
|
||||
Previously, <<modules-threadpool,thread pool types>> could be dynamically adjusted. The thread pool type effectively
|
||||
|
@ -690,7 +690,7 @@ and high risk of being misused. The ability to change the thread pool type for a
|
|||
that it is still possible to adjust relevant thread pool parameters for each of the thread pools (e.g., depending on
|
||||
the thread pool type, `keep_alive`, `queue_size`, etc.).
|
||||
|
||||
[[breaking_30_cpu_stats]]
|
||||
[[breaking_50_cpu_stats]]
|
||||
=== System CPU stats
|
||||
|
||||
The recent CPU usage (as a percent) has been added to the OS stats
|
||||
|
@ -721,7 +721,7 @@ CPU usage can be obtained from `OsStats.Cpu#getPercent`.
|
|||
Only stored fields are retrievable with this option.
|
||||
The fields option won't be able to load non stored fields from _source anymore.
|
||||
|
||||
[[breaking_30_allocation]]
|
||||
[[breaking_50_allocation]]
|
||||
=== Primary shard allocation
|
||||
|
||||
Previously, primary shards were only assigned if a quorum of shard copies were found (configurable using
|
||||
|
@ -758,7 +758,7 @@ in the case where shard copies can be found. Previously, a node not holding the
|
|||
holding shard copies were satisfying the allocation deciders. Now, the shard will be assigned to a node having a shard copy,
|
||||
even if none of the nodes holding a shard copy satisfy the allocation deciders.
|
||||
|
||||
[[breaking_30_percolator]]
|
||||
[[breaking_50_percolator]]
|
||||
=== Percolator
|
||||
|
||||
Adding percolator queries and modifications to existing percolator queries are no longer visible in immediately
|
||||
|
@ -781,7 +781,7 @@ unmapped fields are not persisted in the mapping.
|
|||
|
||||
Percolator documents are no longer excluded from the search response.
|
||||
|
||||
[[breaking_30_packaging]]
|
||||
[[breaking_50_packaging]]
|
||||
=== Packaging
|
||||
|
||||
==== Default logging using systemd (since Elasticsearch 2.2.0)
|
||||
|
@ -795,7 +795,7 @@ changed to now route standard output to the journal and standard error
|
|||
to inherit this setting (these are the defaults for systemd). These
|
||||
settings can be modified by editing the elasticsearch.service file.
|
||||
|
||||
[[breaking_30_scripting]]
|
||||
[[breaking_50_scripting]]
|
||||
=== Scripting
|
||||
|
||||
==== Script mode settings
|
||||
|
@ -818,7 +818,7 @@ large set of dependencies, this also increases the surface area for
|
|||
security issues. This dependency has been reduced to the core Groovy
|
||||
language `org.codehaus.groovy:groovy` artifact.
|
||||
|
||||
[[breaking_30_term_vectors]]
|
||||
[[breaking_50_term_vectors]]
|
||||
=== Term vectors
|
||||
|
||||
The term vectors APIs no longer persist unmapped fields in the mappings.
|
||||
|
@ -826,9 +826,8 @@ The term vectors APIs no longer persist unmapped fields in the mappings.
|
|||
The `dfs` parameter has been removed completely, term vectors don't support
|
||||
distributed document frequencies anymore.
|
||||
|
||||
[[breaking_30_security]]
|
||||
[[breaking_50_security]]
|
||||
=== Security
|
||||
|
||||
The option to disable the security manager `--security.manager.enabled` has been removed. In order to grant special
|
||||
permissions to elasticsearch users must tweak the local Java Security Policy.
|
||||
|
Loading…
Reference in New Issue