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の互換性および要件を参照してください。キーファイル アクセス制御を使用して開始されたレプリカセット。
手順
mongot tarball をダウンロードします。
システムアーキテクチャ用の最新の 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.tgzwget https://downloads.mongodb.org/mongodb-search-community/{VERSION_NUMBER}/mongot_community_{VERSION_NUMBER}_linux_x86_64.tgz(任意).tarball パッケージの整合性を検証します。
詳細については、「mongot パッケージの整合性の検証」を参照してください。
mongot tarballを抽出します。
{VERSION_NUMBER} をダウンロードした mongot のバージョンに置き換え、ターボールを展開するために、システム アーキテクチャに合わせてコマンドを実行します。
tar -zxvf mongot_community_{VERSION_NUMBER}_linux_aarch64.tgztar -zxvf mongot_community_{VERSION_NUMBER}_linux_x86_64.tgz注意
ウェブ ブラウザがダウンロード後にファイルを自動的に解凍する場合、ファイル拡張子は .tar です。
tarball には、サンプル構成ファイル、mongot ランサー スクリプト、MongoDB Search およびベクトル検索のライセンス情報が含まれています。
mongod を設定して mongot と通信できるようにします。
使用する既存のレプリカセットがある場合は、次の mongod パラメータを設定して、検索クエリとMongoDB ベクトル検索クエリをルーティングしてインデックスを管理します。
Parameter | 説明 |
|---|---|
|
|
|
|
| 検索インデックス管理サーバーの認証を有効にするかどうかを指定します |
| MongoDB Search で CRPC が有効かどうかを指定します |
例、mongod 構成ファイルに次の行を追加して、mongod を再起動します。
setParameter: searchIndexManagementHostAndPort: localhost:27028 mongotHost: localhost:27028 skipAuthenticationToSearchIndexManagementServer: false useGrpcForSearch: truemongodパラメータの設定に関する詳細については、「自己管理型配置の MongoDB Server パラメータ」を参照してください。検索固有の setParameter オプションの詳細については、「MongoDB Search オプション」を参照してください。
注意
mongotHost、searchIndexManagementHostAndPort、useGrpcForSearch パラメータは、スタートアップでのみ設定されます。setParameter では、実行中にそれらを変更できません。mongod を別の mongot インスタンスに指定するには、mongod 構成ファイル内のこれらのパラメータを更新し、mongod を再起動します。
キーファイル認証を使用して新しいレプリカセットを配置する場合は、キーファイル認証を使用した自己管理型レプリカセットの配置の手順に従ってください。
MongoDB配置上のmongotプロセス用のユーザーを作成します。
mongot searchCoordinator ロールを持つユーザーを介して MongoDB 配置に接続できる必要があります。
管理者ユーザーとして
mongoshに接続します。mongosh --port 27017 -u <your_admin_username> -p <your_admin_password>adminデータベースに接続します。次のコマンドを実行して、
adminデータベースに接続します。use adminmongotユーザーを作成します。searchCoordinatorロールを持つユーザーを作成するには:<mongot-username>をmongotユーザーのユーザー名に置き換え<mongot-password>を、次のステップのpasswordFileで指定したパスワードに置き換えます次のコマンドを実行します:
db.createUser( { user: <mongot-username>, pwd: <mongot-password>, roles: [ "searchCoordinator"] })
パスワードファイルを作成します。
mongod に接続するための mongot 用のパスワードファイルを作成します。
例、オペレーティング システムを選択し、<mongot-password> をパスワードに置き換えます。次に、次のコマンドを実行して passwordFile というファイルを作成します。
echo -n "<mongot-password>" > passwordFilechmod 400 passwordFile注意
-n フラグは末尾の改行を防止します。
echo|set /p="mongotPassword" > passwordFile[System.IO.File]::WriteAllText("passwordFile", "mongotPassword")mongot の構成オプションを指定します。
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が到達できるネットワーク インターフェイスにバインドします。mongodmongotHostおよびsearchIndexManagementHostAndPortパラメータをそのアドレスに設定します。同期ソースおよび gRPC 接続の TLS を有効にする。TLS なしでの実行は、
mongotとmongodが同じホストする上で実行される場合にのみ適切です。TLS を構成するには、mongotのための TLS 暗号化の構成 を参照してください。
logging.logPathを使用して、mongotが書き込むログファイルのパスを指定します。ログファイルのパスを指定しない場合、mongotは標準出力にログを出力します。
mongot プロセスの正常性を確認します。
確認するには、HTTP クライアントまたは curl を使用して、/health エンドポイントとなる接続されたデバイスにリクエストを送信します。例として、次のサンプル リクエストと同様の curl リクエストを送信します。
curl localhost:8080/healthエンドポイントは、応答として次のいずれかを返します。
SERVING,mongotプロセスが実行中の場合mongotインデックスのステータスをチェックしないため、クエリを処理できない可能性があります。クエリを処理するには、インデックスがReady状態である必要があります。NOT_SERVING,mongotプロセスが実行されていない場合
詳細については、mongot 接続を確認するを参照してください。
MongoDB Search とMongoDB ベクトル検索をアンインストールする
MongoDB Search と MongoDB ベクトル検索をシステムから削除するには、mongot、構成ファイル、データとログを含むすべてのディレクトリを削除する必要があります。次のセクションで必要な手順をご案内します。
mongotUser ユーザーを削除します。
mongotUser ユーザーを削除するには、次のコマンドを実行します。
use admindb.dropUser("mongotUser")詳細については、db.dropUser() を参照してください。
ログとログディレクトリをすべて削除します。 mongot
mongot のログとログディレクトリを削除するには、logging.logPath で指定したログディレクトリへのフルパスを使用して次のコマンドを実行します。
rm -rf /path/to/mongot-logs