OpenSearchのソースを表示

[[Category:データベース管理システム]]
[[en:OpenSearch]]
[[Wikipedia:OpenSearch (software)]] より:
:OpenSearch は検索エンジン (その名も OpenSearch) と OpenSearch ダッシュボード (検索エンジンのためのデータ視覚化ダッシュボード) から構成されるソフトウェアファミリーである。ソフトウェアの開発は2021年に Elasticsearch と Kibana のフォークとして開始され、Amazon Web Services によって主導されている。

== インストール ==

{{Pkg|opensearch}} パッケージを[[インストール]]してください。

任意の依存パッケージとして様々なプラグインが存在し必要に応じてインストールできます。{{Pkg|opensearch-dashboards}} を使用する場合は Dashboards プラグインを忘れずにインストールしてください。

== 起動 ==

{{ic|/etc/opensearch/opensearch.keystore}} にキーストアが存在しない場合、OpenSearch を起動する前に作成する必要があります:

 # opensearch-keystore create

作成後、{{ic|opensearch.service}} を[[起動/有効化]]してください。

{{ic|curl '<protocol>://<host>:<port>'}} を使うことで OpenSearch が実行中か、{{pkg|curl}} でアクセスできるかどうか確認できます:
{{hc|curl http://127.0.0.1:9200|2=
<nowiki>
{
  "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/"
}
</nowiki>
}}

== 設定 ==

メインの OpenSearch 設定ファイルは {{ic|/etc/opensearch/opensearch.yml}} に存在し詳しい説明が書かれています。[https://opensearch.org/docs/latest/opensearch/configuration/ 公式ドキュメント] も役に立つでしょう。

* デフォルトでは OpenSearch はどこからでもアクセスできるようになっているため、ホスト上でしかアクセスできないように設定すると良いでしょう:

 network.host: 127.0.0.1

* デフォルトの {{ic|9200}} と異なるカスタムポートを使うこともできます:

 http.port: 9200

== 使用方法 ==

OpenSearch サーバーの管理 (ドキュメントのメンテナンスや検索の実行など) は基本的に [https://opensearch.org/docs/latest/clients/index/ クライアント] を使って行い、お好きなプログラミング言語でシームレスに使うことができます。

{{Pkg|opensearch-dashboards}} や {{Pkg|opensearch-cli}} などの便利なツールを使うことで OpenSearch インスタンスやクラスタの管理が楽になります。

== Elasticsearch OSS からのアップグレード ==

Elasticsearch OSS のマルチノードクラスタを OpenSearch にアップグレードする場合は [https://opensearch.org/docs/latest/upgrade-to/upgrade-to/ 公式ガイド] を参照してください。

スタンドアロンノードの場合は設定ファイルをコピーしてインデックスデータを新しく移動するだけで大丈夫です:
 # systemctl stop elasticsearch
 # cp -r /var/lib/elasticsearch/nodes /var/lib/opensearch/
 # chown opensearch:opensearch -R /var/lib/opensearch
 # systemctl start opensearch

== Beats OSS との互換性 ==

filebeat などの [https://github.com/elastic/beats Beats エージェント] は新しいバージョンの OpenSearch と互換性がありません。[https://opensearch.org/docs/latest/clients/agents-and-ingestion-tools/index/ 公式ドキュメント] に互換表が存在します。バージョン {{ic|7.13.X}} 以上では動作せず、{{ic|7.X}} バージョンでは設定に変更が必要です:
{{hc|/etc/opensearch/opensearch.yml|2=
<nowiki>
[...]
compatibility.override_main_response_version: true
[...]
</nowiki>
}}

上記の設定で OpenSearch はバージョン番号として {{ic|7.10.2}} を返すようになります。

AUR に存在するエージェントで上記の設定を行うことで使えるエージェントは:
* {{AUR|metricbeat-oss}}
* {{AUR|filebeat-oss}}
* {{AUR|packetbeat-oss}}
* {{AUR|heartbeat-oss}}
* {{AUR|auditbeat-oss}}
* {{AUR|journalbeat-oss}}

{{TranslationStatus|OpenSearch|2022-01-15|708921}}