OpenSearchのセットアップ

2025年9月15日

はじめに

OpenSearchはオープンソースの分散検索エンジンで、Elasticsearchのフォークである。ここでは、OpenSearchのセットアップについてメモする。

環境

  • Ubuntu 22.04 LTS
  • OpenSearch 3.1.0

セットアップ

セットアップは ここ に従う。

$ sudo apt update && sudo apt -y install lsb-release ca-certificates curl gnupg2
$ curl -o- https://artifacts.opensearch.org/publickeys/opensearch-release.pgp | sudo gpg --dearmor --batch --yes -o /usr/share/keyrings/opensearch-release-keyring
$ echo "deb [signed-by=/usr/share/keyrings/opensearch-release-keyring] https://artifacts.opensearch.org/releases/bundle/opensearch/3.x/apt stable main" | sudo tee /etc/apt/sources.list.d/opensearch-3.x.list
$ sudo apt update

なんか出た。

N: リポジトリ 'https://artifacts.opensearch.org/releases/bundle/opensearch/3.x/apt stable InRelease' がアーキテクチャ 'i386' をサポートしないため設定ファイル 'main/binary-i386/Packages' の取得をスキップ

/etc/apt/sources.list.d/opensearch-3.x.listを編集。

$ sudo vi /etc/apt/sources.list.d/opensearch-3.x.list
deb [signed-by=/usr/share/keyrings/opensearch-release-keyring] https://artifacts.opensearch.org/releases/bundle/opensearch/3.x/apt stable main

上記を次のように書き換える。

deb [arch=amd64 signed-by=/usr/share/keyrings/opensearch-release-keyring] https://artifacts.opensearch.org/releases/bundle/opensearch/3.x/apt stable main

パッケージを確認

$ sudo apt list -a opensearch
opensearch/stable 3.1.0 amd64
opensearch/stable 3.0.0 amd64

最新版を入れる。

$ sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=<custom-admin-password> apt install opensearch

エラー

ERROR: Something went wrong during demo configuration installation. Please see the logs in
 /var/log/opensearch/install_demo_configuration.log

ログ

"Password is too short". Please re-try with a minimum 8 character password and must contain at least one uppercase letter, one lowercase letter, one digit, and one special character that is strong. Password strength can be tested here: https://lowe.github.io/tryzxcvbn

自分で考えるのがめんどくさくなったので、パスワード生成

$ openssl rand -base64 8

サービスの起動

$ sudo systemctl enable opensearch
$ sudo systemctl start opensearch
$ sudo systemctl status opensearch
● opensearch.service - OpenSearch
     Loaded: loaded (/lib/systemd/system/opensearch.service; enabled; vendor preset: enab>
     Active: active (running) since Fri 2025-07-11 14:53:09 JST; 15s ago

テスト

$ curl -X GET https://localhost:9200 -u 'admin:<custom-admin-password>' --insecure

プラグインリスト

$ curl -X GET https://localhost:9200/_cat/plugins -u 'admin:<custom-admin-password>' --insecure

設定ファイル

$ sudo vi /etc/opensearch/opensearch.yml

JVM のヒープサイズの設定

$ sudo vi /etc/opensearch/jvm.options

初期と最大をそれぞれ 4 GB にするなら以下のようにする。

-Xms4g
-Xmx4g

ダッシュボード

OpenSearch用のダッシュボードのセットアップ

$ echo "deb [arch=amd64 signed-by=/usr/share/keyrings/opensearch-release-keyring] https://artifacts.opensearch.org/releases/bundle/opensearch-dashboards/3.x/apt stable main" | sudo tee /etc/apt/sources.list.d/opensearch-dashboards-3.x.list
$ sudo apt update
$ sudo apt list -a opensearch-dashboards
一覧表示... 完了
opensearch-dashboards/stable 3.1.0 amd64
opensearch-dashboards/stable 3.0.0 amd64

$ sudo apt install opensearch-dashboards

サービスの設定

$ sudo systemctl enable opensearch-dashboards
$ sudo systemctl start opensearch-dashboards
$ sudo systemctl status opensearch-dashboards
● opensearch-dashboards.service - "OpenSearch Dashboards"
     Loaded: loaded (/lib/systemd/system/opensearch-dashboards.service; enabled; vendor p>
     Active: active (running) since Fri 2025-07-11 15:38:19 JST; 7s ago

設定ファイル

$ sudo vi /etc/opensearch-dashboards/opensearch_dashboards.yml

ブラウザでhttp://localhost:5601にアクセスする。admin でログイン。

プラグイン

必要があればプラグインを入れておく。

$ cd /usr/share/opensearch/bin
$ sudo ./opensearch-plugin install analysis-kuromoji
$ sudo ./opensearch-plugin install analysis-icu
$ sudo systemctl restart opensearch