settings.asciidoc 3.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125
  1. === Setting changes
  2. [[migration-script-settings]]
  3. ==== Scripting settings
  4. The `script.disable_dynamic` node setting has been replaced by fine-grained
  5. script settings described in the <<enable-dynamic-scripting,scripting docs>>.
  6. The following setting previously used to enable dynamic or inline scripts:
  7. [source,yaml]
  8. ---------------
  9. script.disable_dynamic: false
  10. ---------------
  11. It should be replaced with the following two settings in `elasticsearch.yml` that
  12. achieve the same result:
  13. [source,yaml]
  14. ---------------
  15. script.inline: on
  16. script.indexed: on
  17. ---------------
  18. ==== Units required for time and byte-sized settings
  19. Any settings which accept time or byte values must now be specified with
  20. units. For instance, it is too easy to set the `refresh_interval` to 1
  21. *millisecond* instead of 1 second:
  22. [source,js]
  23. ---------------
  24. PUT _settings
  25. {
  26. "index.refresh_interval": 1
  27. }
  28. ---------------
  29. In 2.0, the above request will throw an exception. Instead the refresh
  30. interval should be set to `"1s"` for one second.
  31. ==== Shadow replica settings
  32. The `node.enable_custom_paths` setting has been removed and replaced by the
  33. `path.shared_data` setting to allow shadow replicas with custom paths to work
  34. with the security manager. For example, if your previous configuration had:
  35. [source,yaml]
  36. ------
  37. node.enable_custom_paths: true
  38. ------
  39. And you created an index using shadow replicas with `index.data_path` set to
  40. `/opt/data/my_index` with the following:
  41. [source,js]
  42. --------------------------------------------------
  43. PUT /my_index
  44. {
  45. "index": {
  46. "number_of_shards": 1,
  47. "number_of_replicas": 4,
  48. "data_path": "/opt/data/my_index",
  49. "shadow_replicas": true
  50. }
  51. }
  52. --------------------------------------------------
  53. For 2.0, you will need to set `path.shared_data` to a parent directory of the
  54. index's data_path, so:
  55. [source,yaml]
  56. -----------
  57. path.shared_data: /opt/data
  58. -----------
  59. ==== Resource watcher settings renamed
  60. The setting names for configuring the resource watcher have been renamed
  61. to prevent clashes with the watcher plugin
  62. * `watcher.enabled` is now `resource.reload.enabled`
  63. * `watcher.interval` is now `resource.reload.interval`
  64. * `watcher.interval.low` is now `resource.reload.interval.low`
  65. * `watcher.interval.medium` is now `resource.reload.interval.medium`
  66. * `watcher.interval.high` is now `resource.reload.interval.high`
  67. ==== Hunspell dictionary configuration
  68. The parameter `indices.analysis.hunspell.dictionary.location` has been
  69. removed, and `<path.conf>/hunspell` is always used.
  70. ==== CORS allowed origins
  71. The CORS allowed origins setting, `http.cors.allow-origin`, no longer has a default value. Previously, the default value
  72. was `*`, which would allow CORS requests from any origin and is considered insecure. The `http.cors.allow-origin` setting
  73. should be specified with only the origins that should be allowed, like so:
  74. [source,yaml]
  75. ---------------
  76. http.cors.allow-origin: /https?:\/\/localhost(:[0-9]+)?/
  77. ---------------
  78. ==== JSONP support
  79. JSONP callback support has now been removed. CORS should be used to access Elasticsearch
  80. over AJAX instead:
  81. [source,yaml]
  82. ---------------
  83. http.cors.enabled: true
  84. http.cors.allow-origin: /https?:\/\/localhost(:[0-9]+)?/
  85. ---------------
  86. ==== In memory indices
  87. The `memory` / `ram` store (`index.store.type`) option was removed in
  88. Elasticsearch. In-memory indices are no longer supported.
  89. ==== Log messages truncated
  90. Log messages are now truncated at 10,000 characters. This can be changed in
  91. the `logging.yml` configuration file with the `file.layout.conversionPattern`
  92. setting.
  93. Remove mapping.date.round_ceil setting for date math parsing #8889 (issues: #8556, #8598)