重要
MongoDB 8.2 は最新のマイナー リリースです。MongoDB 8.2 以降では、特定のユースケースに対応したオンプレミス配置（MongoDB Community と Enterprise）でマイナー リリースを利用できます。詳細については、 MongoDB のバージョン管理 を参照してください。
オンプレミスでサポートされている最新のMongoDBバージョンをインストールするには、インストール手順を参照してください。
Overview
このチュートリアルを使用してMongoDB 8.2をインストールします yumパッケージマネージャーを使用して、 Amazon Linux上の Enterprise Edition を実行します。
MongoDB Enterpriseエディションは一部のプラットフォームで利用でき、セキュリティとモニタリングに関連する機能のサポートが含まれています。
Linux ディストリビューションの確認
実行中の Linux ディストリビューションを確認するには、コマンドラインで次のコマンドを実行します。
grep ^NAME /etc/*release
結果は Amazon Linux または Amazon Linux AMI になります。別の Linux ディストリビューションを使用している場合は、プラットフォームのインストール手順を参照してください。
MongoDB バージョン
このチュートリアルではMongoDB 8.2 をインストールしますエンタープライズ エディション。MongoDB Enterpriseの別のバージョンをインストールするには、このページの左側にある Self-Managed Deployments の下のバージョン ドロップダウンを使用して、そのバージョンのドキュメントを選択します。
Considerations
プラットフォーム サポート
MongoDB 8.2 Enterprise Edition は、 x86 _6464 アーキテクチャ上の次の ビット Amazon Linuxリリースをサポートしています。
Amazon Linux 2023
MongoDB はこのプラットフォームの 64 ビット版のみをサポートしています。
MongoDB 8.2 Enterprise Edition をAmazon Linuxで使用すると、特定のプラットフォームでARM 64アーキテクチャをサポートします。
詳しくは、「プラットフォーム サポート」を参照してください。
プロダクション ノート
MongoDB を本番環境に導入する前に、パフォーマンスに関する考慮事項と構成の推奨事項について、 自己管理型配置のプロダクションドキュメントのドキュメントを参照してください。
MongoDB Enterprise Editionをインストールする
yum パッケージ マネージャーを使用して MongoDB Enterprise エディションをインストールするには、次の手順に従います。 Amazon Linux のバージョンのタブを選択します。
パッケージ管理システム（yum）を構成します。
yum を使用して MongoDB Enterprise を直接インストールできるように、/etc/yum.repos.d/mongodb-enterprise-8.2.repo ファイルを作成します。
[mongodb-enterprise-8.2] name=MongoDB Enterprise Repository baseurl=https://repo.mongodb.com/yum/amazon/2023/mongodb-enterprise/8.2/$basearch/ gpgcheck=1 enabled=1 gpgkey=https://pgp.mongodb.com/server-8.0.asc
注意
このディレクトリに MongoDB の以前のインストールからの mongodb-enterprise.repo ファイルがある場合は、削除する必要があります。上記の mongodb-enterprise-8.2.repo ファイルを使用して MongoDB 8.2 をインストールします。
また、 MongoDB リポジトリから.rpmファイルを直接ダウンロードすることもできます。 ダウンロードは Amazon Linux のバージョン別に整理されています（例： 2023 ）、次に MongoDB のリリース バージョン（例: 8.2 ）、アーキテクチャ（例: x86_64 ）。
MongoDB Enterprise 8.0 の最新の安定バージョンをインストールするには、次のコマンドを発行します。
sudo yum install -y mongodb-enterprise
特定のリリースをインストールするには、次の例のように、各コンポーネント パッケージをバージョン番号とともに個別に指定する必要があります。
sudo yum install -y mongodb-enterprise-8.2.0 mongodb-enterprise-database-8.2.0 mongodb-enterprise-server-8.2.0 mongodb-mongosh mongodb-enterprise-mongos-8.2.0 mongodb-enterprise-tools-8.2.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 パッケージを選択することもできます。
次の例では、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
MongoDB Enterprise Edition を実行する
ulimit に関する考慮事項
ほとんどの Unix 系オペレーティング システムでは、プロセスが使用できるシステム リソースが制限されています。 これらの制限は MongoDB の操作に悪影響を及ぼす可能性があるため、調整する必要があります。 プラットフォームに推奨される設定については、 「 自己管理型配置の UNIX ulimit設定」を参照してください。
注意
オープンしているファイル数のulimit値が64000未満の場合、MongoDB は起動警告を生成します。
ディレクトリ
デフォルトでは、MongoDB インスタンスは次のように保存されます。
データファイルの保存先:
/var/lib/mongoログファイルの保存先:
/var/log/mongodb
パッケージマネージャーを使用してインストールした場合、これらのデフォルトディレクトリはインストール中に作成されます。
Tarball をダウンロードして手動でインストールした場合は、 MongoDB を実行するユーザーに応じて mkdir -p <directory> または sudo mkdir -p
<directory> を使用してディレクトリを作成します。 mkdir と sudo の詳細については、Linux のマニュアルページを参照してください。
デフォルトでは、MongoDB は mongod ユーザー アカウントを使用して実行されます。MongoDB プロセスを実行するユーザーを変更する場合は、/var/lib/mongo ディレクトリと /var/log/mongodb ディレクトリへの権限も変更して、このユーザーにこれらのディレクトリへのアクセス権を付与する必要があります。
別のログファイル ディレクトリとデータファイル ディレクトリを指定するには、/etc/mongod.conf の systemLog.path と storage.dbPath の設定を編集します。MongoDB を実行するユーザーがこれらのディレクトリにアクセスできるようにします。
手順
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（サービス）] タブを選択します。
MongoDB が正常に起動したことを確認します。
次のコマンドを実行すると、mongod プロセスが正常に開始されたことを確認できます。
sudo systemctl status mongod
必要に応じて、次のコマンドを実行すると、システムの再起動後に MongoDB が確実に起動するようにできます。
sudo systemctl enable mongod
MongoDB を停止します。
必要に応じて、次のコマンドを発行して、mongod プロセスを停止できます。
sudo systemctl stop mongod
MongoDB を再起動します。
次のコマンドを発行して、mongod プロセスを再開できます。
sudo systemctl restart mongod
プロセスの状態をエラーや重要なメッセージで確認するには、/var/log/mongodb/mongod.log ファイルの出力を監視してください。
MongoDB の使用を開始します。
mongoshと同じホストマシン上でmongod セッションを開始します。コマンドライン オプションなしでmongoshを実行すると、デフォルト ポート27017を使用してローカルホストで実行されているmongodに接続できます。
mongosh
mongosh を使った接続（別のホストやポートで実行されている mongod インスタンスへの接続など）の詳細については、「mongosh ドキュメント」を参照してください。
MongoDB をスムーズに使い始められるように、MongoDB ではさまざまなドライバー エディションでスタートガイドを提供しています。ドライバーのドキュメントについては、「MongoDB での開発スタートガイド」を参照してください。
MongoDB を起動します。
次のコマンドを発行して、mongod プロセスを開始できます。
sudo service mongod start
MongoDB が正常に起動したことを確認します
mongod プロセスが正常に開始したことを確認するには、ログファイル /var/log/mongodb/mongod.log の内容で次の行を確認します。
[initandlisten] waiting for connections on port <port>
ここで、 <port>は/etc/mongod.confで構成されたポートであり、デフォルトでは27017です。
必要に応じて、次のコマンドを実行すると、システムの再起動後に MongoDB が確実に起動するようにできます。
sudo chkconfig mongod on
MongoDB を停止します。
必要に応じて、次のコマンドを発行して、mongod プロセスを停止できます。
sudo service mongod stop
MongoDB を再起動します。
次のコマンドを発行して、mongod プロセスを再開できます。
sudo service mongod restart
プロセスの状態をエラーや重要なメッセージで確認するには、/var/log/mongodb/mongod.log ファイルの出力を監視してください。
MongoDB の使用を開始します。
mongoshと同じホストマシン上でmongod セッションを開始します。コマンドライン オプションなしでmongoshを実行すると、デフォルト ポート27017を使用してローカルホストで実行されているmongodに接続できます。
mongosh
mongosh を使った接続（別のホストやポートで実行されている mongod インスタンスへの接続など）の詳細については、「mongosh ドキュメント」を参照してください。
MongoDB をスムーズに使い始められるように、MongoDB ではさまざまなドライバー エディションでスタートガイドを提供しています。ドライバーのドキュメントについては、「MongoDB での開発スタートガイド」を参照してください。
MongoDB をアンインストールする
システムから MongoDB を完全に削除するには、MongoDB アプリケーション自体、構成ファイル、データとログを含むすべてのディレクトリを削除する必要があります。次のセクションで必要な手順をご案内します。
警告
このプロセスにより、MongoDB、その構成、およびすべてのデータベースが 完全に 削除されます。このプロセスは元に戻すことができないため、続行する前にすべての構成とデータがバックアップされていることを確認してください。
MongoDB を停止します。
次のコマンドを発行して、mongod プロセスを停止します。
sudo service mongod stop
詳細情報
デフォルトの Localhost バインディング
デフォルトでは、MongoDB は bindIp を 127.0.0.1 に設定して起動します。これは、ローカルホスト ネットワーク インターフェースにバインドされます。つまり、mongod は同じマシン上で実行中のクライアントからの接続のみを受け入れることができます。この値が有効なネットワークインターフェースに設定されていない限り、リモートクライアントは mongod に接続できず、mongod はレプリカセットを初期化できません。
この値は、次のいずれかに設定できます。
警告
インスタンスをパブリックにアクセス可能な IP アドレスにバインドする前に、クラスターを不正アクセスから保護する必要があります。 セキュリティ推奨事項の完全なリストについては、「自己管理型配置のセキュリティ チェックリスト」を参照してください。 最低限、認証を有効化し、ネットワーク インフラストラクチャの強化 を検討してください。
bindIpの構成の詳細については、「自己管理型配置の IP バインディング 」を参照してください。
MongoDB Enterprise エディション パッケージ
MongoDB Enterprise エディションは専用のリポジトリから入手でき、次の公式にサポートされているパッケージが含まれています。
パッケージ名 | 説明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| 以下に掲げるコンポーネント パッケージを自動的にインストールする | ||||||||
| 以下に掲げるコンポーネント パッケージを自動的にインストールする
| ||||||||
| MongoDB Shell（ | ||||||||
| コンピューターにすでにインストールされている OpenSSL バージョン ( | ||||||||
| 以下に掲げるコンポーネント パッケージを自動的にインストールする
|