設置的改變 · Elasticsearch 5.4 中文文檔

# 設置的改變原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.0/breaking_50_settings_changes.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/breaking_50_settings_changes.html) 譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=4260784](http://www.apache.wiki/pages/viewpage.action?pageId=4260784) 貢獻者 : [片刻](/display/~jiangzhonglian) 從Elasticsearch 5.0對所有設置進行驗證，然后應用它們。節點級別和默認索引級別設置在節點啟動時驗證，動態集群和索引設置在更新/添加到集群狀態之前進行驗證。每個設置必須是已知設置。所有設置必須已向與其一起使用的節點或傳輸客戶端注冊。這意味著定義自定義設置的插件必須在插件加載期間使用 SettingsModule#registerSettings(Setting)?方法注冊其所有設置。 ## 索引級別設置在以前的版本中，Elasticsearch允許在節點級別，elasticsearch.yaml文件中或甚至通過命令行參數中將索引級別設置為默認值。從Elasticsearch 5.0只有選定的設置，例如index.codec可以在節點級別設置。所有其他設置必須在每個單獨的索引上設置。要在每個索引上設置默認值，應改用索引模板。 ## 節點設置 name設置已刪除，并由?node.name?替換。 -Dname=some_node_name?的用法不再受支持。 node.add_id_to_custom_path已重命名為add_lock_id_to_custom_path。 node.name??設置的默認值現在是節點ID的前7個字符，后者又是隨機生成的UUID。刪除設置node.mode和node.local。本地模式應通過 discovery.type: local?和?transport.type:local 配置。為了禁用http請使用?http.enabled: false ## 節點屬性設置用于分配過濾，強制意識或其他節點標識/分組的節點級屬性必須以node.attr為前綴。在以前的版本中，可以使用節點指定節點屬性。字首。除了node.master，node.data和node.ingest之外的所有節點屬性都必須移動到新的node.attr. 命名空間。 ## 節點類型設置 node.client設置已刪除。具有此設置集的節點將不會啟動。相反，每個節點角色需要使用現有的node.master，node.data和node.ingest支持的靜態設置分別設置。 ## 網關設置已刪除用于配置全局和索引狀態序列化格式的gateway.format設置。默認情況下，smile用作格式。 ## 傳輸設置具有netty中綴的所有設置已由其現有的傳輸同義詞替換。例如transport.netty.bind_host不再受支持，應該由替代設置transport.bind_host替換。 ## 安全管理器設置禁用安全管理器security.manager.enabled的選項已刪除。為了給予elasticsearch用戶特殊權限，用戶必須編輯本地Java安全策略。 ## 網絡設置設置的_non_loopback_值如network.host會任意選擇未標記為loopback的第一個接口。而是，通過地址范圍（例如_local _，_ site_指定所有環回和專用網絡地址）或通過顯式接口名稱，主機名或地址指定。 netty.epollBug解決方法設置已刪除。此設置允許人們在早期的JVM版本中啟用netty工作，以獲得[高CPU使用率問題](https://github.com/netty/netty/issues/327)。這個bug在[Java 7中修復](http://bugs.java.com/view_bug.do?bug_id=6403933)。由于Elasticsearch 5.0需要Java 8，所以設置被刪除。請注意，如果需要重新引入解決方法，您仍然可以設置org.jboss.netty.epollBugWorkaround系統屬性以直接控制Netty。 ## 禁止改變線程池類型以前，[線程池類型](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/modules-threadpool.html)可以動態調整。線程池類型有效地控制線程池的后備隊列，并且修改這是專家設置，具有最小的實際益處和被濫用的高風險。更改任何線程池的線程池類型的能力已被刪除。仍然可以為每個線程池調整相關的線程池參數（例如，取決于線程池類型，keep_alive，queue_size等）。 ## 線程設置建議的線程池已被刪除，現在建議請求使用搜索線程池。所有線程池設置上的前綴已從threadpool更改為thread_pool。縮放線程池的最小大小設置已從min更改為core。縮放線程池的最大大小設置已從大小更改為最大。固定線程池的隊列大小設置必須為queue_size（不再支持先前支持的所有其他變體）。線程池設置現在是節點級設置。因此，不可能通過集群設置API更新線程池設置。 ## 分析設置不再支持index.analysis.analyzer.default_index分析器。如果要更改分析器以用于索引，請改為更改index.analysis.analyzer.default分析器。 ## Ping設置以前，ping超時有三個設置：discovery.zen.initial_ping_timeout，discovery.zen.ping.timeout和discovery.zen.ping_timeout。前兩個已被刪除，并且ping超時的唯一設置鍵現在是discovery.zen.ping_timeout。 ping超時的默認值保持為3秒。已刪除discovery.zen.master_election.filter_client和discovery.zen.master_election.filter_data以支持新的discovery.zen.master_election.ignore_non_master_pings。此設置控制在主選舉期間如何解釋ping響應，并且應謹慎使用，并且僅在極端情況下使用。有關詳細信息，請參閱文檔 ## 恢復設置已刪除1.x中已棄用的恢復設置： * index.shard.recovery.translog_size由indexes.recovery.translog_size替代 * index.shard.recovery.translog_ops被indexes.recovery.translog_ops取代 * index.shard.recovery.file_chunk_size由indexes.recovery.file_chunk_size替代 * index.shard.recovery.concurrent_streams被indexes.recovery.concurrent_streams取代 * index.shard.recovery.concurrent_small_file_streams被indexes.recovery.concurrent_small_file_streams取代 * indices.recovery.max_size_per_sec被indexes.recovery.max_bytes_per_sec所取代如果您使用任何這些設置，請花時間審查其目的。上述所有設置都被視為專家設置，只有在絕對必要時才能使用。如果您將以上任何設置設置為永久群集設置，請使用設置更新API并相應地設置其取代的鍵。以下設置已刪除，無需替換 * indices.recovery.concurrent_small_file_streams - recoveries現在是單線程的。并發傳出恢復的數量通過分配決策器來節流 * indices.recovery.concurrent_file_streams - recoveries現在是單線程的。并發傳出恢復的數量通過分配決策器來節流 ## Translog設置不再支持index.translog.flush_threshold_ops設置。為了基于事務日志增長來控制刷新，請改用index.translog.flush_threshold_size。不再支持使用index.translog.fs.type更改translog類型，緩沖實現現在是唯一可用的選項，并使用固定的8kb緩沖區。默認情況下，translog在每個索引，創建，更新，刪除或批量請求后被同步。在每個操作上fsync的能力不再需要了。事實上，它可能是一個性能瓶頸，它是trappy，因為它通過在index.translog.sync_interval設置的特殊值啟用。現在，index.translog.sync_interval不接受小于100ms的值，如果啟用了異步持久性，則防止fsyncing太頻繁。不再支持特殊值0。 index.translog.interval已刪除。 ## 請求緩存設置已棄用的設置index.cache.query.enable和indices.cache.query.size已刪除，并分別替換為index.requests.cache.enable和indices.requests.cache.size。 indices.requests.cache.clean_interval已經替換為indices.cache.clean_interval，不再支持。 ## 字段數據高速緩存設置 indices.fielddata.cache.clean_interval設置已替換為indices.cache.clean_interval。 ## 分配設置 cluster.routing.allocation.concurrent_recoveries設置已替換為cluster.routing.allocation.node_concurrent_recoveries。 ## 相似性設置默認相似性已重命名為經典。 ## 索引設置 index.memory.min_shard_index_buffer_size和indices.memory.max_shard_index_buffer_size已刪除，因為Elasticsearch現在允許任何一個分片使用堆的數量，只要所有分片中使用的總索引緩沖堆低于節點的indices.memory.index_buffer_size（默認值到JVM堆的10％）。 ## 刪除es.max打開文件將系統屬性es.max-open-files設置為true可以使Elasticsearch打印Elasticsearch進程的最大打開文件數。此相同的信息可以從?[_Nodes Info_](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-nodes-info.html "Nodes Info")?API獲取，如果設置得太低，啟動時會記錄一個警告。 ## 已刪除es.netty.gathering 禁用Netty使用NIO收集可以通過將系統屬性“es.netty.gathering”設置為“false”的轉義填充。時間已被證明啟用收集默認是一個非問題，這個非文檔設置已刪除。 ## 已刪除es.useLinkedTransferQueue 系統屬性es.useLinkedTransferQueue可用于控制在集群服務中使用的隊列實現以及在發現期間處理ping響應。這是未記錄的設置，已被刪除。 ## 刪除高速緩存并發級別設置兩個高速緩存并發級別設置indices.requests.cache.concurrency_level和indices.fielddata.cache.concurrency_level，因為它們不再適用于用于請求高速緩存和字段數據高速緩存的高速緩存實現。 ## 使用系統屬性配置Elasticsearch 不能再通過設置系統屬性來配置Elasticsearch。這意味著已刪除對以下所有項的支持： * 通過命令行參數設置為elasticsearch為?-[Des.name](http://Des.name).of.setting=value.of.setting * 通過JAVA_OPTS環境變量設置?JAVA_OPTS=$JAVA_OPTS -[Des.name](http://Des.name).of.setting=value.of.setting * 通過ES_JAVA_OPTS環境變量設置?ES_JAVA_OPTS=$ES_JAVA_OPTS -[Des.name](http://Des.name).of.setting=value.of.setting 而應使用?-Ename.of.setting=value.of.setting 。 ## 使用雙劃線刪除配置Elasticsearch 以前可以在命令行上通過--name.of.setting value.of.setting設置設置來配置Elasticsearch。此功能已刪除。而應使用?-Ename.of.setting=value.of.setting 。 ## 刪除對.properties配置文件的支持 Elasticsearch配置和日志記錄配置不能再以Java屬性文件格式（具有.properties擴展名的行分隔鍵=值對）存儲。 ## 發現設置必須為設置了network.host，network.bind_host，network.publish_host，transport.host，transport.bind_host或transport.publish_host配置選項的節點設置discovery.zen.minimum_master_node。我們看到那些節點處于“生產”模式，因此需要設置。 ## 實時獲取設置 action.get.realtime設置已刪除。當未指定實時時，此設置是get和mget API的后備實時設置。現在如果不指定參數，我們總是默認為true。 ## 內存鎖定設置設置bootstrap.mlockall已重命名為bootstrap.memory_lock。 ## 快照設置用于恢復快照的默認設置include_global_state已從true更改為false。它在拍攝快照時沒有被更改，在這種情況下仍然默認為true。 ## 時間值解析不再支持表示星期的單位w。不再支持小數時間值（例如0.5秒）。例如，這意味著當設置超時時，“0.5s”將被拒絕，而應輸入為“500ms”。 ## 節點最大本地存儲節點以前的Elasticsearch版本默認允許多個節點共享同一個數據目錄（最多50個）。這可能會讓用戶意外啟動多個節點，并且最終認為它們丟失了數據，因為第二個節點將以空數據目錄開始。雖然允許多個節點的默認設置對于在筆記本電腦上形成一個小集群是友好的，并且終端用戶有時在同一主機上運行多個節點，但這往往是例外。保持Elasticsearch的持續運動朝著更安全的開箱即用默認值，并優化規范而不是異常，node.max_local_storage_nodes的默認值現在是一個。 ## 腳本設置 ## 索引腳本設置由于索引腳本已由存儲的腳本替代，以下設置已替換為： * script.indexed已被script.stored替換 * script.engine.*.indexed.aggs ? ? ? ?已替換為script.engine.*.stored.aggs（其中*表示腳本語言，如groovy，mustache，painless等） * script.engine.*.indexed.mapping ?已替換為script.engine.*.stored.mapping（其中*表示腳本語言，如groovy，mustache，painless等） * script.engine.*.indexed.search ? ? 已替換為script.engine.*.stored.search（其中*表示腳本語言，如groovy，mustache，painless等） * script.engine.*.indexed.update ? ? 已替換為script.engine.*.stored.update（其中*表示腳本語言，如groovy，mustache，painless等） * script.engine.*.indexed.plugin ? ? ?已替換為script.engine.*.stored.plugin（其中*表示腳本語言，如groovy，mustache，painless等） ## 腳本模式設置以前的腳本模式設置（例如，“script.inline：true”，“script.engine.groovy.inline.aggs：false”等）接受了大范圍的“真實”或“假的”值。這現在更加嚴格，只支持真假選項。 ## 已刪除腳本沙箱設置在5.0之前，可以為script.inline和script.stored設置（“沙盒”）指定第三個選項。這已被刪除，您現在可以只設置script.line：true或script.stored：true。 ## 搜索設置設置index.query.bool.max_clause_count已刪除。為了設置布爾子句的最大數量，應該使用indices.query.bool.max_clause_count。