Docs Menu
Docs Home
/
MongoDBマニュアル
/ / / /

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

項目一覧

  • Overview
  • Considerations
  • MongoDB Community Edition のインストール
  • MongoDB コミュニティ エディションの実行
  • MongoDB コミュニティ エディション のアンインストール
  • 詳細情報

注意

MongoDB Atlas

MongoDB Atlas は、インストールのオーバーヘッドが不要で、無料で始められるクラウドでホストされる MongoDBサービスオプションです。

このチュートリアルを使用して MongoDB 5.0をインストールします パッケージ マネージャーを使用して、MongoDB Community Edition Red Hat Enterprise 、LinuxCentOSLinux 、またはOracleLinux [1 ] 上の 。yum

このチュートリアルではMongoDB 5.0 MongoDB Community Editionをインストールします。 別のバージョンの MongoDB Community をインストールするには、このページの左上にあるバージョンのドロップダウンメニューを使用して、該当バージョンのドキュメントを選択します。

注意

EOL Notice

  • MongoDB 5.0 で x _8664 でMongoDB Community Edition RHEL /CentOS / のサポートが削除されます。Oracle6

  • MongoDB5.0MongoDB Community Edition ではCentOS Oracles390x の RHEL 、 、 7 のサポートが削除されています。

MongoDB 5.0 MongoDB Community Editionは、次の64 ビット バージョンの Red Hat EnterpriseLinux (RHEL)、CentOSLinux 、OracleLinux [1 ] 、RockyLinux 、AlmaLinux [2 ] x86 64でサポートしています。 _ アーキテクチャ:

  • RHEL 、CentOS、Oracle、Rocky、AlmaLinux 8

  • RHEL、CentOS、Oracle 7

MongoDB 5.0 は、 RHELMongoDB Community Edition 、 、 、Rocky、AlmaLinux64 上の ARMCentOS Oracle8アーキテクチャもサポートしています。

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

[1]12 MongoDB は Red Hat Compatible Kernel(RHCK)を実行している Oracle Linux のみをサポートしています。MongoDB は Unbreakable Enterprise Kernel(UEK)をサポートしていません
[2] RHEL バージョン 8.0 以降向けにリリースされた MongoDB オンプレミス製品は、Rocky Linux バージョン 8.0 以降、および AlmaLinux バージョン 8.0 以降と互換性があり、サポートします。ただし、これらのディストリビューションが完全な RHEL 互換性を提供する義務を果たすことが前提となります。

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

yum パッケージマネージャーを使用して MongoDB Community Edition をインストールするには、次の手順に従います。

1

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

[mongodb-org-5.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/8/mongodb-org/5.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-5.0.asc
[mongodb-org-5.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/7/mongodb-org/5.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-5.0.asc

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

MongoDB 5.0 以前のバージョンでは、MongoDB の開発リリース バージョンには、4.3 といった奇数番号が振られていました。MongoDB 5.1 以降、MongoDB は四半期ごとに Rapid Release を公開しています。Rapid Release と長期的にサポートされるリリースの相違に関する詳細については、「MongoDB バージョン管理」を参照してください。

2

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

sudo yum install -y mongodb-org

あるいは、MongoDB の特定のリリースをインストールするには、次の例のように、各コンポーネント パッケージを個別に指定し、パッケージ名にバージョン番号を追加します。

sudo yum install -y mongodb-org-5.0.29 mongodb-org-database-5.0.29 mongodb-org-server-5.0.29 mongodb-org-shell-5.0.29 mongodb-org-mongos-5.0.29 mongodb-org-tools-5.0.29

注意

yum は、新しいバージョンが利用可能になると、パッケージを自動的にアップグレードします。MongoDB のアップグレードを希望しない場合は、次の exclude ディレクティブを /etc/yum.conf ファイルに追加してパッケージを固定します。

exclude=mongodb-org,mongodb-org-database,mongodb-org-server,mongodb-mongosh,mongodb-org-mongos,mongodb-org-tools

ほとんどの 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 の構成」を参照してください。

重要

SELinux がenforcingモードの場合は、次の 2 つのポリシーを調整して、MongoDB の SELinux ポリシーをカスタマイズする必要があります。

現在の SELinux ポリシーでは、MongoDB プロセスが /sys/fs/cgroup にアクセスすることを許可していません。これは、システムで使用可能なメモリを決定するのに必要なものです。SELinux を enforcing モードで実行する場合は、SELinux ポリシーを次のように調整する必要があります。

  1. システムに checkpolicy パッケージがインストールされていることを確認します。

    sudo yum install checkpolicy
  2. カスタム ポリシー ファイル mongodb_cgroup_memory.te を作成します。

    cat > mongodb_cgroup_memory.te <<EOF
    module mongodb_cgroup_memory 1.0;
    require {
    type cgroup_t;
    type mongod_t;
    class dir search;
    class file { getattr open read };
    }
    #============= mongod_t ==============
    allow mongod_t cgroup_t:dir search;
    allow mongod_t cgroup_t:file { getattr open read };
    EOF
  3. 作成したら、次の 3 つのコマンドを実行してカスタム ポリシー モジュールをコンパイルしてロードします。

    checkmodule -M -m -o mongodb_cgroup_memory.mod mongodb_cgroup_memory.te
    semodule_package -o mongodb_cgroup_memory.pp -m mongodb_cgroup_memory.mod
    sudo semodule -i mongodb_cgroup_memory.pp

SELinux を enforcing に設定することで、MongoDB プロセスが正しいファイルにアクセスできるようになりました。

現在の SELinux ポリシーでは、MongoDB プロセスが /proc/net/netstat を開いて読み取ることを許可していません。これは、フルタイム診断データ取得(FTDC)に必要です。SELinux を enforcing モードで実行する場合は、SELinux ポリシーを次のように調整する必要があります。

  1. システムに checkpolicy パッケージがインストールされていることを確認します。

    sudo yum install checkpolicy
  2. カスタム ポリシー ファイル mongodb_proc_net.te を作成します。

    cat > mongodb_proc_net.te <<EOF
    module mongodb_proc_net 1.0;
    require {
    type cgroup_t;
    type configfs_t;
    type file_type;
    type mongod_t;
    type proc_net_t;
    type sysctl_fs_t;
    type var_lib_nfs_t;
    class dir { search getattr };
    class file { getattr open read };
    }
    #============= mongod_t ==============
    allow mongod_t cgroup_t:dir { search getattr } ;
    allow mongod_t cgroup_t:file { getattr open read };
    allow mongod_t configfs_t:dir getattr;
    allow mongod_t file_type:dir { getattr search };
    allow mongod_t file_type:file getattr;
    allow mongod_t proc_net_t:file { open read };
    allow mongod_t sysctl_fs_t:dir search;
    allow mongod_t var_lib_nfs_t:dir search;
    EOF
  3. 作成したら、次の 3 つのコマンドを実行してカスタム ポリシー モジュールをコンパイルしてロードします。

    checkmodule -M -m -o mongodb_proc_net.mod mongodb_proc_net.te
    semodule_package -o mongodb_proc_net.pp -m mongodb_proc_net.mod
    sudo semodule -i mongodb_proc_net.pp

重要

上記に加えて、SELinux がenforcingモードの場合は、次の 2 つのケースで SELinux ポリシーをさらにカスタマイズする必要もあります。

  • RHEL で、デフォルトのpidFilePathdbPathsystemLog.path 、または ではなく、 カスタム ディレクトリ7 パス0 を使用しています。 以降、かつ/または

  • デフォルトの MongoDB ポート ではなく、 カスタム ポート を使用しています。

  1. SELinux ポリシーを更新して、mongod サービスが新しいディレクトリを使用できるようにします。

    sudo semanage fcontext -a -t <type> </some/MongoDB/directory.*>

    ここで、必要に応じて次のいずれかのタイプを指定します。

    • mongod_var_lib_t データディレクトリ用

    • mongod_log_t ログファイル ディレクトリ用

    • mongod_var_run_t PID ファイル ディレクトリ用

    注意

    ディレクトリの最後に .* を必ず含めてください。

  2. 新しいディレクトリの SELinux ユーザー ポリシーを更新します。

    sudo chcon -Rv -u system_u -t <type> </some/MongoDB/directory>

    ここで、必要に応じて次のいずれかのタイプを指定します。

    • mongod_var_lib_t データディレクトリ用

    • mongod_log_t ログ ディレクトリ

    • mongod_var_run_t PID ファイル ディレクトリ用

  3. 更新された SELinux ポリシーをディレクトリに適用します。

    sudo restorecon -R -v </some/MongoDB/directory>

以下に例を挙げます。

Tip

.* の操作には、必ずディレクトリの最後に semanage fcontext を含めてください。

  • デフォルト以外の MongoDB データ パス /mongodb/data を使用する場合:

    sudo semanage fcontext -a -t mongod_var_lib_t '/mongodb/data.*'
    sudo chcon -Rv -u system_u -t mongod_var_lib_t '/mongodb/data'
    sudo restorecon -R -v '/mongodb/data'
  • デフォルト以外の MongoDB ログ ディレクトリ /mongodb/log を使用する場合(例: ログ ファイル パスが /mongodb/log/mongod.log の場合):

    sudo semanage fcontext -a -t mongod_log_t '/mongodb/log.*'
    sudo chcon -Rv -u system_u -t mongod_log_t '/mongodb/log'
    sudo restorecon -R -v '/mongodb/log'
sudo semanage port -a -t mongod_port_t -p tcp <portnumber>

注意

カスタム ポートを認識するにはmongodを再起動する必要がある場合があります。

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

init システム

mongod プロセスを実行、管理するには、オペレーティング システムに組み込まれている init システムを使用します。最近のバージョンの Linux では systemdsystemctl コマンドを使用)が使用される傾向があり、古いバージョンの Linux では System V initservice コマンドを使用)が使用される傾向があります。

プラットフォームで使用されている 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を実行すると、デフォルト ポート27017を使用してローカルホストで実行されているmongodに接続できます。

mongosh

mongosh を使った接続(別のホストやポートで実行されている mongod インスタンスへの接続など)の詳細については、「mongosh ドキュメント」を参照してください。

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

1

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

sudo service mongod start
2

mongod プロセスが正常に開始したことを確認するには、ログファイル /var/log/mongodb/mongod.log の内容で次の行を確認します。

[initandlisten] waiting for connections on port <port>

ここで、 <port>/etc/mongod.confで構成されたポートであり、デフォルトでは27017です。

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

sudo chkconfig mongod on
3

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

sudo service mongod stop
4

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

sudo service mongod restart

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

5

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

mongosh

mongosh を使った接続(別のホストやポートで実行されている mongod インスタンスへの接続など)の詳細については、「mongosh ドキュメント」を参照してください。

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

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

警告

このプロセスにより、MongoDB、その構成、およびすべてのデータベースが 完全に 削除されます。このプロセスは元に戻すことができないため、続行する前にすべての構成とデータがバックアップされていることを確認してください。

1

次のコマンドを発行して、mongod プロセスを停止します。

sudo service mongod stop
2

以前にインストールした MongoDB パッケージをすべて削除します。

sudo yum erase $(rpm -qa | grep mongodb-org)
3

MongoDB データベースとログ ファイルを削除します。

sudo rm -r /var/log/mongodb
sudo rm -r /var/lib/mongo

By default, MongoDB launches with bindIp set to 127.0.0.1, which binds to the localhost network interface. This means that the mongod can only accept connections from clients that are running on the same machine. Remote clients will not be able to connect to the mongod, and the mongod will not be able to initialize a replica set unless this value is set to a valid network interface which is accessible from the remote clients.

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

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

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

警告

非ローカルホスト(例: (一般にアクセス可能な)IP アドレスを使用して、クラスターを不正アクセスから保護していることを確認します。 セキュリティ推奨事項の完全なリストについては、「自己管理型配置のセキュリティ チェックリスト」を参照してください。 最低限、認証を有効化し、ネットワーク インフラストラクチャの強化 を検討してください。

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

MongoDB Community Edition は専用のリポジトリから利用可能で、以下の公式にサポートされているパッケージが含まれています

パッケージ名
説明

mongodb-org

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

mongodb-org-database

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

パッケージ名
説明

mongodb-org-server

mongod デーモン、関連する init スクリプト、構成ファイル/etc/mongod.conf)が付属します。init スクリプトを使用して、構成ファイルで mongod を起動できます。詳細については、上記の「MongoDB Community Edition の実行」セクションを参照してください。

mongodb-org-mongos

mongos デーモンが付属します。

mongodb-org-shell

レガシーのmongo shell が含まれています。

mongodb-mongosh

MongoDB Shell(mongosh)を含みます。

mongodb-org-tools

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

パッケージ名
説明

mongodb-database-tools

次の MongoDB データベース ツールが含まれています。

mongodb-org-database-tools-extra

install_compass スクリプトが付属します

戻る

Linux へのインストール