OpenSearch

出自 ArchWiki

出自 维基百科:OpenSearch (软件)

OpenSearch 是一个软件家族,包含一个搜索引擎(也名为 OpenSearch)和 OpenSearch Dashboards,一个用于该搜索引擎的数据可视化仪表盘。该软件于 2021 年开始,是 Elasticsearch 和 Kibana 的一个分支,由亚马逊网络服务主导开发。

安装

安装 opensearch 软件包。

各种插件被列为可选依赖项,可以根据您的需要安装。如果您正在使用 opensearch-dashboards,请记住安装相应的 Dashboards 插件。

配置

主要的 OpenSearch 配置文件有详细的文档,位于 /etc/opensearch/opensearch.yml官方文档 也应该有所帮助。

  • 默认情况下,OpenSearch 是公开可访问的,可能更希望只允许在主机上访问
network.host: 127.0.0.1
  • 可以使用自定义端口而不是默认的 9200 端口
http.port: 9200

使用

如果您在 /etc/opensearch/opensearch.keystore 中没有密钥库,则需要在启动 OpenSearch 之前创建一个

# opensearch-keystore create

之后,您可以启动/启用 opensearch.service

使用 CURL 确保 OpenSearch 正在运行且可访问

$ curl http://127.0.0.1:9200
{
  "name" : "opensearch.example.net",
  "cluster_name" : "opensearch",
  "cluster_uuid" : "TRylpzbsQB-Nk2KgktTQtA",
  "version" : {
    "number" : "7.10.2",
    "build_type" : "tar",
    "build_hash" : "unknown",
    "build_date" : "2022-01-07T15:57:30.358290Z",
    "build_snapshot" : false,
    "lucene_version" : "8.10.1",
    "minimum_wire_compatibility_version" : "6.8.0",
    "minimum_index_compatibility_version" : "6.0.0-beta1"
  },
  "tagline" : "The OpenSearch Project: https://opensearch.org/"
}

OpenSearch 服务器管理(文档维护、执行搜索等)通常由 客户端 完成,这些客户端应提供与首选编程语言的无缝集成。

诸如 opensearch-dashboardsopensearch-cli 等管理 OpenSearch 实例和集群的实用工具也可用于简化管理。

技巧与诀窍

从 Elasticsearch OSS 升级

要将 Elasticsearch OSS 的多节点集群升级到 OpenSearch,应查阅官方指南

对于独立节点,复制任何配置更改并将索引数据移动到其新位置可能就足够了

停止 elasticsearch.service

# cp -r /var/lib/elasticsearch/nodes /var/lib/opensearch/
# chown opensearch:opensearch -R /var/lib/opensearch

启动 opensearch.service

与 Beats OSS 的兼容性

诸如 filebeat 之类的 Beats 代理 在较新版本中与 OpenSearch 不兼容,官方文档 提供了兼容性表格。 7.13.X 及更高版本将无法工作,所有 7.X 版本都需要在配置中进行解决方法

/etc/opensearch/opensearch.yml
[...]
compatibility.override_main_response_version: true
[...]

这将使 OpenSearch 返回 7.10.2 作为其版本号。

与上述解决方法兼容的代理版本可用

本文或章节需要扩充。

原因: 解释每个软件包是什么,链接一堆软件包用处不大(在 Talk:OpenSearch 中讨论)