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

Red Hat または CentOS への MongoDB Enterprise Edition のインストール

このチュートリアルでは、YUMパッケージマネージャーを使用して、Red Hat Enterprise Linux、 CentOS Linux、またはOracle Linux []1 にMongoDB Enterprise9.0 Edition をインストールします。

MongoDB Enterpriseエディションは一部のプラットフォームで利用でき、セキュリティとモニタリングに関連する機能のサポートが含まれています。

このチュートリアルでは、MongoDB 9.0 Enterprise Edition をインストールします。MongoDB Enterprise の別のバージョンをインストールするには、このページの左上隅にあるバージョンのドロップダウンメニューから、そのバージョンのドキュメントを選択します。

MongoDB9.0 Enterprise Edition は、次の64 ビット バージョンの Red Hat Enterprise Linux (RHEL)、 CentOS Linux、 Oracle Linux []1 、Rocky Linux、AlmaLinux []2 を x86 64でサポートしています。 _ アーキテクチャ:

  • RHEL 、 CentOS Stream、 Oracle 、Rocky、AlmaLinux10

  • RHEL 、 CentOS Stream、 Oracle 、Rocky、AlmaLinux9

  • RHEL 、 CentOS Stream、 Oracle 、Rocky、AlmaLinux8

MongoDB はこれらのプラットフォームの 64 ビット版のみをサポートしています。

RHEL 、 CentOS 、 Oracle 、Rocky、Alma Linux上のMongoDB9.0 Enterprise Edition は、一部のプラットフォームで ARM64 アーキテクチャもサポートしています。

詳しくは、「プラットフォーム サポート」を参照してください。

[1](1 、2 ) MongoDB はRed Hat 互換カーネル(RHCK)を実行中Oracle Linuxのみをサポートしています。 MongoDBはUnbreakable Enterprise Kernel(UEK)をサポートして いません 。

[2 ] RHEL バージョン 8.0 以降向けにリリースされた MongoDB オンプレミス製品は、Rocky Linux バージョン 8.0 以降、および AlmaLinux バージョン 8.0 以降と互換性があり、サポートします。ただし、これらのディストリビューションが完全な RHEL 互換性を提供する義務を果たすことが前提となります。

MongoDB を本番環境に導入する前に、パフォーマンスに関する考慮事項と構成の推奨事項について、自己管理型配置のプロダクションドキュメントを参照してください。

UUMパッケージマネージャーを使用してMongoDB Enterpriseエディションをインストールするには、次の手順に従います。

1

yum を使用して MongoDB Enterprise を直接インストールできるように、/etc/yum.repos.d/mongodb-enterprise-9.0.repo ファイルを作成します。

[mongodb-enterprise-9.0]
name=MongoDB Enterprise Repository
baseurl=https://repo.mongodb.com/yum/redhat/10/mongodb-enterprise/9.0/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-9.asc

注意

このディレクトリに MongoDB の以前のインストールからの mongodb-enterprise.repo ファイルがある場合は、削除する必要があります。上記の mongodb-enterprise-9.0.repo ファイルを使用して MongoDB 9.0 をインストールします。

また、.rpm MongoDBリポジトリから ファイルを直接ダウンロードすることもできます。ダウンロード ファイルは Red Hat またはCentOS のバージョン(例:9 )、 MongoDB のリリース バージョン (例:9.0 )、アーキテクチャ(例:x86_64 )を基準にしてこの順序で整理されています。

2

MongoDB Enterprise 9.0 の最新の安定バージョンをインストールするには、次のコマンドを発行します。

sudo yum install -y mongodb-enterprise

特定のリリースをインストールするには、次の例のように、各コンポーネント パッケージをバージョン番号とともに個別に指定する必要があります。

sudo yum install -y mongodb-enterprise-9.0.0 mongodb-enterprise-database-9.0.0 mongodb-enterprise-server-9.0.0 mongodb-mongosh mongodb-enterprise-mongos-9.0.0 mongodb-enterprise-tools-9.0.0

注意

MongoDB Enterprise の利用可能な任意のバージョンを指定できますが、新しいバージョンが利用可能になると、yum はパッケージをアップグレードします。意図しないアップグレードを防ぐには、次の exclude ディレクティブを /etc/yum.conf ファイルに追加してパッケージを固定します。

exclude=mongodb-enterprise,mongodb-enterprise-database,mongodb-enterprise-server,mongodb-enterprise-shell,mongodb-enterprise-mongos,mongodb-enterprise-tools

注意

システムの OpenSSL を使用する MongoDB Shell をインストールすることもできます。このバージョンの MongoDB Shell をインストールする前に、システムに OpenSSL がインストールされている必要があります。

最初に MongoDB Shell を削除しなくても、すべての MongoDB Enterprise パッケージと、システムの OpenSSL を使用する MongoDB Shell をインストールできます。以下に例を挙げます。

sudo yum install -y mongodb-enterprise mongodb-mongosh-shared-openssl11

次の例では、MongoDB Shell を削除し、システムの OpenSSL 1.1 を使用する MongoDB Shell をインストールしています。

sudo yum remove -y mongodb-mongosh && sudo yum install -y
mongodb-mongosh-shared-openssl11

次の例では、MongoDB Shell を削除し、システムの OpenSSL 3 を使用する MongoDB Shell をインストールしています。

sudo yum remove -y mongodb-mongosh && sudo yum install -y
mongodb-mongosh-shared-openssl3

MongoDB Shell が次のエラーで起動に失敗する場合は、上記のコマンドを使用して mongodb-mongosh-shared-openssl3パッケージをインストールします。

mongosh: OpenSSL configuration error: ...:error:030000A9:digital
envelope routines:alg_module_init:unknown
option:../deps/openssl/openssl/crypto/evp/evp_cnf.c:61:name=rh-allow-sha1-signatures,
value=yes

このエラーは RHEL 9+ やAmazon Linux 2023 などの派生製品に影響します。

インストールする MongoDB パッケージを選択することもできます。

次の例では、MongoDB Enterprise とツール、およびシステムの OpenSSL 1.1 を使用する MongoDB Shell をインストールします。

sudo yum install -y mongodb-enterprise-database
mongodb-enterprise-tools mongodb-mongosh-shared-openssl11

次の例では、MongoDB Enterprise とツール、およびシステムの OpenSSL 3 を使用する MongoDB Shell をインストールしています。

sudo yum install -y mongodb-enterprise-database
mongodb-enterprise-tools mongodb-mongosh-shared-openssl3

ほとんどの Unix 系オペレーティング システムでは、プロセスが使用できるシステム リソースが制限されています。これらの制限はMongoDB の操作 に悪影響可能性があるため、調整する必要があります。プラットフォームに推奨される設定については、「 自己管理型配置の UNIX ulimit 設定 」を参照してください。

注意

オープンしているファイル数のulimit値が64000未満の場合、MongoDB は起動警告を生成します。

MongoDB は デフォルトで、mongod ユーザー アカウントを使用して実行され、次のデフォルト ディレクトリを使用します。

  • /var/lib/mongo (データディレクトリ)

  • /var/log/mongodb (ログディレクトリ)

パッケージマネージャーはインストール中にデフォルトのディレクトリを作成します。所有者とグループ名は mongod です。

デフォルト以外のデータディレクトリまたはログディレクトリを使用するには、次の手順に従います。

  1. 新しいディレクトリ(複数可)を作成します。

  2. 構成ファイル /etc/mongod.conf を編集し、必要に応じて次のフィールドを変更します。

    • storage.dbPath は、新しいデータディレクトリのパスを指定します。例: /some/data/directory

    • systemLog.path は、新しいログファイルのパスを指定します。例: /some/log/directory/mongod.log

  3. MongoDB を実行しているユーザーがディレクトリにアクセスできるようにします。

    sudo chown -R mongod:mongod <directory>

    MongoDB プロセスを実行するユーザーを変更する場合は、新しいユーザーにこれらのディレクトリへのアクセス権を付与する必要があります。

  4. SELinux が強制されている場合は、構成します。 「 SELinux の構成 」を参照してください。

MongoDB 5.0 以降、以下を実行する MongoDB インストールで新しい SELinux ポリシーを利用できるようになりました。

  • .rpm インストーラーを使用します。

  • デフォルトの構成設定を使用します。

  • RHEL7 以降で実行します。

注意

MongoDB 配置で次のいずれかのカスタム設定を使用する場合、

MongoDBが提供する SELinux ポリシーは使用できません。代替策として カスタム SELinux ポリシーを作成することもできますが、不適切に記述されたカスタム ポリシーによって安全性の低下や mongodインスタンスの動作停止が生じる恐れがあります。

  1. 次のパッケージがインストールされていることを確認してください。

    • git

    • make

    • checkpolicy

    • policycoreutils

    • selinux-policy-devel

    sudo yum install git make checkpolicy policycoreutils selinux-policy-devel
  2. ポリシーリポジトリをダウンロードします。

    git clone https://github.com/mongodb/mongodb-selinux
  3. ポリシーをビルドします。

    cd mongodb-selinux
    make
  4. ポリシーを適用します。

    sudo make install

重要

下位互換性のない機能

MongoDB 5.1 以降で MongoDB の前のバージョンにダウングレードするには、SELinux ポリシーのクローンが過去に作成されたディレクトリから次のコマンドをダウングレード前に実行する必要があります。

sudo make uninstall
  • SELinux ポリシーは、標準のMongoDB.rpm パッケージのインストールによって生成される構成で動作するように設計されています。詳細については、「 標準インストールの前提条件 」を参照してください。

  • SELinux ポリシーは mongod サーバー用に作成されており、次のような MongoDB の他のデーモンやツールには適用されません。

  • SELinux プロジェクトが提供する参照ポリシーにはmongodb_admin マニュアルが含まれています。このマニュアルはMongoDB SELinux ポリシーに含まれていません。 ドメインの管理者はunconfined_t mongodを管理できます。

  • ポリシーをアンインストールするには、ポリシー リポジトリをダウンロードしたディレクトリに移動して、次のコマンドを実行します。

    sudo make uninstall

システム上で MongoDB Enterprise Edition を実行するには、次の手順に従ってください。これらの手順は、デフォルト設定を使用していることを前提としています。

init システム

mongod プロセスを実行および管理するには、オペレーティング システムに組み込まれている初期化システムを使用します。最近のバージョンのLinuxでは systemd が systemctl コマンドを使用し、古いバージョンのLinuxでは System V init が service コマンドを使用します。

プラットフォームで使用されている init システムがわからない場合は、次のコマンドを実行します。

ps --no-headers -o comm 1

次に、結果に基づいて以下の適切なタブを選択します。

  • systemd - 以下の [systemd(systemctl)] タブを選択します。

  • init - 以下の [System V Init(サービス)] タブを選択します。

1

次のコマンドを発行して、mongod プロセスを開始できます。

sudo systemctl start mongod

mongod の起動時に次のようなエラーが表示された場合は以下に従ってください。

Failed to start mongod.service: Unit mongod.service not found.

最初に次のコマンドを実行します。

sudo systemctl daemon-reload

次に、上記の開始コマンドを再度実行します。

2

次のコマンドを実行すると、mongod プロセスが正常に開始されたことを確認できます。

sudo systemctl status mongod

必要に応じて、次のコマンドを実行すると、システムの再起動後に MongoDB が確実に起動するようにできます。

sudo systemctl enable mongod
3

必要に応じて、次のコマンドを発行して、mongod プロセスを停止できます。

sudo systemctl stop mongod
4

次のコマンドを発行して、mongod プロセスを再開できます。

sudo systemctl restart mongod

プロセスの状態をエラーや重要なメッセージで確認するには、/var/log/mongodb/mongod.log ファイルの出力を監視してください。

5

mongoshと同じホストマシンでmongod セッションを開始します。コマンドライン オプションなしでmongosh mongodを実行すると、デフォルトポート を使用してローカルホストで実行中いる27017 に接続できます。

mongosh

mongoshmongodを使用した接続(別のホストやポートで実行中 インスタンスへの接続など)の詳細については、 mongoshドキュメント をご覧ください。

MongoDBをスムーズに使い始められるように、 MongoDBさまざまなドライバー エディションで 使用開始ガイド をご用意しています。ドライバーのドキュメントについては、 「 MongoDBで開発を始める 」を参照してください。

デフォルトでは、MongoDB は bindIp を 127.0.0.1 に設定して起動します。これは、ローカルホスト ネットワーク インターフェースにバインドされます。つまり、mongod は同じマシン上で実行中のクライアントからの接続のみを受け入れることができます。この値が有効なネットワークインターフェースに設定されていない限り、リモートクライアントは mongod に接続できず、mongod はレプリカセットを初期化できません。

この値は、次のいずれかに設定できます。

  • MongoDB設定ファイルでbindIpを使用する。または

  • コマンドライン引数を経由する。 --bind_ip

警告

インスタンスをパブリックにアクセス可能な IP アドレスにバインドする前に、クラスターを不正アクセスから保護する必要があります。 セキュリティ推奨事項の完全なリストについては、「自己管理型配置のセキュリティ チェックリスト」を参照してください。 最低限、認証を有効化し、ネットワーク インフラストラクチャの強化 を検討してください。

bindIpの構成の詳細については、「自己管理型配置の IP バインディング 」を参照してください。

MongoDB Enterprise エディションは専用のリポジトリから入手でき、次の公式にサポートされているパッケージが含まれています。

パッケージ名
説明

mongodb-enterprise

以下に掲げるコンポーネント パッケージを自動的にインストールするmetapackage です。

mongodb-enterprise-database

以下に掲げるコンポーネント パッケージを自動的にインストールする metapackage です。

  • mongodb-enterprise-server: には、mongod デーモンと関連する構成スクリプトと初期化スクリプトが含まれています。

  • mongodb-enterprise-mongos: にはmongos デーモンが含まれています。

  • mongodb-enterprise-cryptd: には mongocryptd バイナリが含まれています。

mongodb-mongosh

MongoDB Shell が含まれています(mongosh )。

mongodb-shared-openssl*

コンピューターにすでにインストールされている OpenSSL バージョン ( )mongosh を使用するMongoDB Shell が含まれています。

mongodb-enterprise-tools

以下に掲げるコンポーネント パッケージを自動的にインストールする metapackage です。