205 lines
6.3 KiB
Plaintext
205 lines
6.3 KiB
Plaintext
[[breaking_20_setting_changes]]
|
|
=== Setting changes
|
|
|
|
==== Command line flags
|
|
|
|
Command line flags using single dash notation must be now specified as the first arguments.
|
|
For example if previously using:
|
|
|
|
[source,sh]
|
|
---------------
|
|
./elasticsearch --node.name=test_node -Des.path.conf=/opt/elasticsearch/conf/test_node
|
|
---------------
|
|
|
|
This will now need to be changed to:
|
|
|
|
[source,sh]
|
|
---------------
|
|
./elasticsearch -Des.path.conf=/opt/elasticsearch/conf/test_node --node.name=test_node
|
|
---------------
|
|
|
|
for the flag to take effect.
|
|
|
|
[[migration-script-settings]]
|
|
==== Scripting settings
|
|
|
|
The `script.disable_dynamic` node setting has been replaced by fine-grained
|
|
script settings described in the <<enable-dynamic-scripting,scripting docs>>.
|
|
The following setting previously used to enable dynamic or inline scripts:
|
|
|
|
[source,yaml]
|
|
---------------
|
|
script.disable_dynamic: false
|
|
---------------
|
|
|
|
It should be replaced with the following two settings in `elasticsearch.yml` that
|
|
achieve the same result:
|
|
|
|
[source,yaml]
|
|
---------------
|
|
script.inline: true
|
|
script.indexed: true
|
|
---------------
|
|
|
|
==== Units required for time and byte-sized settings
|
|
|
|
Any settings which accept time or byte values must now be specified with
|
|
units. For instance, it is too easy to set the `refresh_interval` to 1
|
|
*millisecond* instead of 1 second:
|
|
|
|
[source,js]
|
|
---------------
|
|
PUT _settings
|
|
{
|
|
"index.refresh_interval": 1
|
|
}
|
|
---------------
|
|
|
|
In 2.0, the above request will throw an exception. Instead the refresh
|
|
interval should be set to `"1s"` for one second.
|
|
|
|
==== Merge and merge throttling settings
|
|
|
|
The tiered merge policy is now the only supported merge policy. These settings
|
|
have been removed:
|
|
|
|
* `index.merge.policy.type`
|
|
* `index.merge.policy.min_merge_size`
|
|
* `index.merge.policy.max_merge_size`
|
|
* `index.merge.policy.merge_factor`
|
|
* `index.merge.policy.max_merge_docs`
|
|
* `index.merge.policy.calibrate_size_by_deletes`
|
|
* `index.merge.policy.min_merge_docs`
|
|
* `index.merge.policy.max_merge_docs`
|
|
|
|
Merge throttling now uses a feedback loop to auto-throttle. These settings
|
|
have been removed:
|
|
|
|
* `indices.store.throttle.type`
|
|
* `indices.store.throttle.max_bytes_per_sec`
|
|
* `index.store.throttle.type`
|
|
* `index.store.throttle.max_bytes_per_sec`
|
|
|
|
==== Shadow replica settings
|
|
|
|
The `node.enable_custom_paths` setting has been removed and replaced by the
|
|
`path.shared_data` setting to allow shadow replicas with custom paths to work
|
|
with the security manager. For example, if your previous configuration had:
|
|
|
|
[source,yaml]
|
|
------
|
|
node.enable_custom_paths: true
|
|
------
|
|
|
|
And you created an index using shadow replicas with `index.data_path` set to
|
|
`/opt/data/my_index` with the following:
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
PUT /my_index
|
|
{
|
|
"index": {
|
|
"number_of_shards": 1,
|
|
"number_of_replicas": 4,
|
|
"data_path": "/opt/data/my_index",
|
|
"shadow_replicas": true
|
|
}
|
|
}
|
|
--------------------------------------------------
|
|
|
|
For 2.0, you will need to set `path.shared_data` to a parent directory of the
|
|
index's data_path, so:
|
|
|
|
[source,yaml]
|
|
-----------
|
|
path.shared_data: /opt/data
|
|
-----------
|
|
|
|
==== Resource watcher settings renamed
|
|
|
|
The setting names for configuring the resource watcher have been renamed
|
|
to prevent clashes with the watcher plugin
|
|
|
|
* `watcher.enabled` is now `resource.reload.enabled`
|
|
* `watcher.interval` is now `resource.reload.interval`
|
|
* `watcher.interval.low` is now `resource.reload.interval.low`
|
|
* `watcher.interval.medium` is now `resource.reload.interval.medium`
|
|
* `watcher.interval.high` is now `resource.reload.interval.high`
|
|
|
|
==== index.gateway setting renamed
|
|
|
|
* `index.gateway.local.sync` is now `index.translog.sync_interval`
|
|
|
|
==== Hunspell dictionary configuration
|
|
|
|
The parameter `indices.analysis.hunspell.dictionary.location` has been
|
|
removed, and `<path.conf>/hunspell` is always used.
|
|
|
|
==== CORS allowed origins
|
|
|
|
The CORS allowed origins setting, `http.cors.allow-origin`, no longer has a default value. Previously, the default value
|
|
was `*`, which would allow CORS requests from any origin and is considered insecure. The `http.cors.allow-origin` setting
|
|
should be specified with only the origins that should be allowed, like so:
|
|
|
|
[source,yaml]
|
|
---------------
|
|
http.cors.allow-origin: /https?:\/\/localhost(:[0-9]+)?/
|
|
---------------
|
|
|
|
==== JSONP support
|
|
|
|
JSONP callback support has now been removed. CORS should be used to access Elasticsearch
|
|
over AJAX instead:
|
|
|
|
[source,yaml]
|
|
---------------
|
|
http.cors.enabled: true
|
|
http.cors.allow-origin: /https?:\/\/localhost(:[0-9]+)?/
|
|
---------------
|
|
|
|
==== In memory indices
|
|
|
|
The `memory` / `ram` store (`index.store.type`) option was removed in
|
|
Elasticsearch. In-memory indices are no longer supported.
|
|
|
|
==== Log messages truncated
|
|
|
|
Log messages are now truncated at 10,000 characters. This can be changed in
|
|
the `logging.yml` configuration file with the `file.layout.conversionPattern`
|
|
setting.
|
|
|
|
==== Custom config file
|
|
|
|
It is no longer possible to specify a custom config file with the `CONF_FILE`
|
|
environment variable, or the `-Des.config`, `-Des.default.config`, or
|
|
`-Delasticsearch.config` parameters.
|
|
|
|
Instead, the config file must be named `elasticsearch.yml` and must be located
|
|
in the default `config/` directory, unless a custom config directory is specified.
|
|
|
|
The location of a custom config directory may be specified as follows:
|
|
|
|
[source,sh]
|
|
--------------
|
|
./bin/elasticsearch --path.conf=/path/to/conf/dir
|
|
./bin/elasticsearch-plugin -Des.path.conf=/path/to/conf/dir install analysis-icu
|
|
--------------
|
|
|
|
When using the RPM or debian packages, the plugin script and the
|
|
init/service scripts will consult the `CONF_DIR` environment variable
|
|
to check for a custom config location. The value of the `CONF_DIR`
|
|
variable can be set in the environment config file which is located either in
|
|
`/etc/default/elasticsearch` or `/etc/sysconfig/elasticsearch`.
|
|
|
|
==== Custom analysis file paths
|
|
|
|
It is no longer possible to set custom file path outside `CONF_DIR` for `*_path` settings
|
|
in <<analysis-charfilters,char>> or <<analysis-tokenfilters,token>> filters.
|
|
You must specify either relative path to `CONF_DIR` location or absolute path inside `CONF_DIR` location.
|
|
|
|
==== `ES_CLASSPATH removed`
|
|
|
|
The `ES_CLASSPATH` environment variable is no longer used to set the class
|
|
path. External libraries should preferably be loaded using the plugin
|
|
mechanism or, if you really must, be copied to the `lib/` directory.
|