AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

Linux での mongot のインストールまたはアンインストール

MongoDB Community EditionにMongoDB SearchとMongoDBベクトル検索プロセスmongotをインストールできます。.tgz拡張子を持つターボールとして、Red Hat、Ubuntu、Debian、SUSE、Amazon LinuxなどのすべてのLinuxディストリビューションでmongotプロセスを配置できます。

注意

実験用の配置でより迅速にオンボードするには、自己管理型配置の次のチュートリアルを参照してください。

自己管理型配置に mongot をインストールするには、次の前提条件が必要です。

  • MongoDB Community Edition v8.3 以降。

    インストール チュートリアルについては、 MongoDB Community Edition のインストール を参照してください。

    注意

    MongoDB Search および MongoDB ベクトル検索プロセスを実行するには、スタンドアロンの自己管理型配置を使用する場合でも、MongoDB Controllers for Kubernetes 演算子を使用して配置する場合でも、MongoDB 8.3 以降が必要です。詳細については、mongotの互換性および要件を参照してください。

  • キーファイル アクセス制御を使用して開始されたレプリカセット。

1

システムアーキテクチャ用の最新の Search in Community tarball を MongoDB Search in Community ダウンロード センター からダウンロードします。

コマンドラインから特定のバージョンをダウンロードするには、{VERSION_NUMBER} を、必要な mongot のバージョンに置き換え、システムアーキテクチャに対応するコマンドを実行します。

wget https://downloads.mongodb.org/mongodb-search-community/{VERSION_NUMBER}/mongot_community_{VERSION_NUMBER}_linux_aarch64.tgz
2

詳細については、「mongot パッケージの整合性の検証」を参照してください。

3

{VERSION_NUMBER} をダウンロードした mongot のバージョンに置き換え、ターボールを展開するために、システム アーキテクチャに合わせてコマンドを実行します。

tar -zxvf mongot_community_{VERSION_NUMBER}_linux_aarch64.tgz

注意

ウェブ ブラウザがダウンロード後にファイルを自動的に解凍する場合、ファイル拡張子は .tar です。

tarball には、サンプル構成ファイル、mongot ランサー スクリプト、MongoDB Search およびベクトル検索のライセンス情報が含まれています。

4

使用する既存のレプリカセットがある場合は、次の mongod パラメータを設定して、検索クエリとMongoDB ベクトル検索クエリをルーティングしてインデックスを管理します。

Parameter
説明

searchIndexManagementHostAndPort

mongot のホストアドレス。

mongotHost

mongot のホストアドレス。

searchIndexManagementHostAndPort と mongotHost では同じアドレスを指定する必要があります。

skipAuthenticationToSearchIndexManagementServer

検索インデックス管理サーバーの認証を有効にするかどうかを指定します

useGrpcForSearch

MongoDB Search で CRPC が有効かどうかを指定します

例、mongod 構成ファイルに次の行を追加して、mongod を再起動します。

setParameter: searchIndexManagementHostAndPort: localhost:27028 mongotHost: localhost:27028 skipAuthenticationToSearchIndexManagementServer: false useGrpcForSearch: true

mongodパラメータの設定に関する詳細については、「自己管理型配置の MongoDB Server パラメータ」を参照してください。検索固有の setParameter オプションの詳細については、「MongoDB Search オプション」を参照してください。

注意

mongotHost、searchIndexManagementHostAndPort、useGrpcForSearch パラメータは、スタートアップでのみ設定されます。setParameter では、実行中にそれらを変更できません。mongod を別の mongot インスタンスに指定するには、mongod 構成ファイル内のこれらのパラメータを更新し、mongod を再起動します。

キーファイル認証を使用して新しいレプリカセットを配置する場合は、キーファイル認証を使用した自己管理型レプリカセットの配置の手順に従ってください。

5

mongot searchCoordinator ロールを持つユーザーを介して MongoDB 配置に接続できる必要があります。

  1. 管理者ユーザーとして mongosh に接続します。

    mongosh --port 27017 -u <your_admin_username> -p <your_admin_password>
  2. adminデータベースに接続します。

    次のコマンドを実行して、adminデータベースに接続します。

    use admin
  3. mongot ユーザーを作成します。

    searchCoordinator ロールを持つユーザーを作成するには:

    • <mongot-username> を mongot ユーザーのユーザー名に置き換え

    • <mongot-password> を、次のステップの passwordFile で指定したパスワードに置き換えます

    • 次のコマンドを実行します:

    db.createUser( { user: <mongot-username>, pwd: <mongot-password>, roles: [ "searchCoordinator"] })
6

mongod に接続するための mongot 用のパスワードファイルを作成します。

例、オペレーティング システムを選択し、<mongot-password> をパスワードに置き換えます。次に、次のコマンドを実行して passwordFile というファイルを作成します。

echo -n "<mongot-password>" > passwordFilechmod 400 passwordFile

注意

-n フラグは末尾の改行を防止します。

7

YAML構成ファイルを使用して mongot を構成できます。config.default.yml という名前の付属のサンプル構成ファイルまたは新しい構成ファイルを使用して構成を定義します。mongot 構成オプションの詳細については、「mongot オプション」を参照してください。

tarball には、デフォルトのmongot 設定を持つ次のサンプル構成ファイルconfig.default.yml が含まれています。配置の設定を変更できます。

警告

システムトポロジーによっては、mongot クエリサーバーを MongoDB クラスターからアクセス可能なインターフェースにバインドする必要がある場合があります。0.0.0.0 IP アドレスへのバインディングは許可されていますが、サーバーがすべてのパブリック ネットワークに公開され、不正アクセスのリスクがあります。

セキュリティを強化するには、localhost やその他の信頼できる内部アドレスなど、ネットワークレイヤーで制御および保護されている特定のインターフェースに server.grpc.address を制限することを検討してください。

syncSource: replicaSet: hostAndPort: "localhost:27017" # Replace with the mongod host and port. scramAuth: username: mongotUser # Replace with mongod username enabled with "searchCoordinator" role. authSource: admin # Replace with the database to authenticate the user against. passwordFile: "/etc/mongot/secrets/passwordFile" # Replace with path to password file for the above user. tls: enabled: falsestorage: dataPath: "/var/lib/mongot" # Replace with the path where you want mongot to store search data.server:grpc: address: "localhost:27028" # Replace with the address and port for mongot listen server tls: mode: "disabled"metrics: enabled: true address: "localhost:9946"healthCheck: address: "localhost:8080"logging: verbosity: INFO

注意

構成ファイル内の dataPath ディレクトリは、mongot を実行するユーザーが書き込み可能である必要があります。

サンプル構成では、scramAuth ブロックで SCRAM 認証を使用します。同期ソースには、SCRAM または X.509 のいずれか 1 つの認証メカニズムのみを構成する必要があります。ユーザー名とパスワードの代わりに TLS クライアント証明書で認証するには、x509 ブロックを使用します。シャーディングされたクラスター syncSource.router 構成を含む両方のメカニズムについては、「mongot の認証と承認の構成」を参照してください。

このサンプルは、同じホストで mongot と mongod を実行するため、server.grpc.address を localhost にバインドし、TLS を無効にします。mongot と mongod を別々のホストするで実行する場合は、代わりに次の手順を実行します。

  • server.grpc.address を localhost ではなく、 mongod が到達できるネットワーク インターフェイスにバインドします。

  • mongod mongotHost および searchIndexManagementHostAndPort パラメータをそのアドレスに設定します。

  • 同期ソースおよび gRPC 接続の TLS を有効にする。TLS なしでの実行は、mongot と mongod が同じホストする上で実行される場合にのみ適切です。TLS を構成するには、mongot のための TLS 暗号化の構成 を参照してください。

logging.logPathを使用して、mongotが書き込むログファイルのパスを指定します。ログファイルのパスを指定しない場合、mongotは標準出力にログを出力します。

8

tarball とともにダウンロードした mongot ランサースクリプトを実行します。スクリプトは mongot-community フォルダーにあります。

mongot-community フォルダーに変更します。

cd <path-to-mongot>

サンプル構成ファイルを使用して mongot を起動するには、次のコマンドを実行します。

./mongot --config config.default.yml
9

確認するには、HTTP クライアントまたは curl を使用して、/health エンドポイントとなる接続されたデバイスにリクエストを送信します。例として、次のサンプル リクエストと同様の curl リクエストを送信します。

curl localhost:8080/health

エンドポイントは、応答として次のいずれかを返します。

  • SERVING, mongot プロセスが実行中の場合

    mongot インデックスのステータスをチェックしないため、クエリを処理できない可能性があります。クエリを処理するには、インデックスが Ready 状態である必要があります。

  • NOT_SERVING, mongot プロセスが実行されていない場合

詳細については、mongot 接続を確認するを参照してください。

MongoDB Search と MongoDB ベクトル検索をシステムから削除するには、mongot、構成ファイル、データとログを含むすべてのディレクトリを削除する必要があります。次のセクションで必要な手順をご案内します。

1

mongotUser ユーザーを削除するには、次のコマンドを実行します。

use admindb.dropUser("mongotUser")

詳細については、db.dropUser() を参照してください。

2

mongot バイナリを停止するには、実行中中のターミナルセッションで Ctrl + C を使用します。

3

mongot および mongod 構成ファイルを削除するには、root として、または sudo を使用して、構成ファイルへのフルパスを使用して次のコマンドを実行します。

sudo rm /path/to/config.default.ymlsudo rm /path/to/mongod.conf
4

キーファイルとパスワードファイル を削除するには、キーファイルとパスワードファイルへのフルパスを使用して次のコマンドを実行します。

rm /path/to/keyfilerm /path/to/passwordFile
5

mongot のログとログディレクトリを削除するには、logging.logPath で指定したログディレクトリへのフルパスを使用して次のコマンドを実行します。

rm -rf /path/to/mongot-logs
6

mongot データを保存しているデータディレクトリを削除するには、mongotデータディレクトリへのフルパスを使用して次のコマンドを実行します。

rm /path/to/mongot/data
このページを評価

ドキュメンテーション