Overview
このチュートリアルでは、MongoDB 9.0YUMパッケージマネージャーを使用したAmazon Linux上のEnterprise Edition。
MongoDB Enterprise Editionは一部のプラットフォームで利用でき、セキュリティとモニタリングに関連する機能のサポートが含まれています。
Linux ディストリビューションの確認
実行中の Linux ディストリビューションを確認するには、コマンドラインで次のコマンドを実行します。
grep ^NAME /etc/*release結果は Amazon Linux または Amazon Linux AMI になります。別の Linux ディストリビューションを使用している場合は、プラットフォームのインストール手順を参照してください。
MongoDB バージョン
このチュートリアルでは、MongoDB 9.0エンタープライズ Edition。MongoDB Enterprise の別のバージョンをインストールするには、サイドバーのバージョン ドロップダウン メニューを使用して、そのバージョンのドキュメントを選択します。
Considerations
プラットフォーム サポート
MongoDB 9.0 Enterprise Edition は、 x86 _6464 アーキテクチャ上で次の ビット Amazon Linux リリースをサポートしています。
- Amazon Linux 2023
MongoDB はこのプラットフォームの 64 ビット版のみをサポートしています。
MongoDB 9.0 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-9.0.repo ファイルを作成します。
[mongodb-enterprise-9.0]name=MongoDB Enterprise Repositorybaseurl=https://repo.mongodb.com/yum/amazon/2023/mongodb-enterprise/9.0/$basearch/gpgcheck=1enabled=1gpgkey=https://pgp.mongodb.com/server-9.asc注意
このディレクトリに MongoDB の以前のインストールからの mongodb-enterprise.repo ファイルがある場合は、削除する必要があります。上記の mongodb-enterprise-9.0.repo ファイルを使用して MongoDB 9.0 をインストールします。
また、 MongoDB リポジトリから.rpmファイルを直接ダウンロードすることもできます。 ダウンロードは Amazon Linux のバージョン別に整理されています(例: 2023 )、次に MongoDB のリリース バージョン(例: 9.0 )、アーキテクチャ(例: x86_64 )。
MongoDB Enterprise 9.0 の最新の安定バージョンをインストールするには、次のコマンドを発行します。
sudo yum install -y mongodb-enterprise特定のリリースをインストールするには、次の例のように、各コンポーネント パッケージをバージョン番号とともに個別に指定する必要があります。
sudo yum install -y mongodb-enterprise-9.0.4 mongodb-enterprise-database-9.0.4 mongodb-enterprise-server-9.0.4 mongodb-mongosh mongodb-enterprise-mongos-9.0.4 mongodb-enterprise-tools-9.0.4注意
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 -ymongodb-mongosh-shared-openssl11次の例では、MongoDB Shell を削除し、システムの OpenSSL 3 を使用する MongoDB Shell をインストールしています。
sudo yum remove -y mongodb-mongosh && sudo yum install -ymongodb-mongosh-shared-openssl3MongoDB Shellが起動せず、以下のエラーが表示される場合は、前のコマンドを使用してmongodb-mongosh-shared-openssl3パッケージをインストールしてください。
mongosh: OpenSSL configuration error: ...:error:030000A9:digitalenvelope routines:alg_module_init:unknownoption:../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-databasemongodb-enterprise-tools mongodb-mongosh-shared-openssl11次の例では、MongoDB Enterprise とツール、およびシステムの OpenSSL 3 を使用する MongoDB Shell をインストールしています。
sudo yum install -y mongodb-enterprise-databasemongodb-enterprise-tools mongodb-mongosh-shared-openssl3MongoDB 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 mongodMongoDB を停止します。
必要に応じて、次のコマンドを発行して、mongod プロセスを停止できます。
sudo systemctl stop mongodMongoDB を再起動します。
次のコマンドを発行して、mongod プロセスを再開できます。
sudo systemctl restart mongodプロセスの状態をエラーや重要なメッセージで確認するには、/var/log/mongodb/mongod.log ファイルの出力を監視してください。
MongoDB の使用を開始します。
mongoshと同じホストマシン上でmongod セッションを開始します。コマンドライン オプションなしでmongoshを実行すると、デフォルト ポート27017を使用してローカルホストで実行されているmongodに接続できます。
mongoshmongosh を使った接続(別のホストやポートで実行されている mongod インスタンスへの接続など)の詳細については、「mongosh ドキュメント」を参照してください。
MongoDB をスムーズに使い始められるように、MongoDB ではさまざまなドライバー エディションでスタートガイドを提供しています。ドライバーのドキュメントについては、「MongoDB での開発スタートガイド」を参照してください。
MongoDB を起動します。
次のコマンドを発行して、mongod プロセスを開始できます。
sudo service mongod startMongoDB が正常に起動したことを確認します
mongod プロセスが正常に開始したことを確認するには、ログファイル /var/log/mongodb/mongod.log の内容で次の行を確認します。
[initandlisten] waiting for connections on port <port>ここで、 <port>は/etc/mongod.confで構成されたポートであり、デフォルトでは27017です。
必要に応じて、次のコマンドを実行すると、システムの再起動後に MongoDB が確実に起動するようにできます。
sudo chkconfig mongod onMongoDB を停止します。
必要に応じて、次のコマンドを発行して、mongod プロセスを停止できます。
sudo service mongod stopMongoDB を再起動します。
次のコマンドを発行して、mongod プロセスを再開できます。
sudo service mongod restartプロセスの状態をエラーや重要なメッセージで確認するには、/var/log/mongodb/mongod.log ファイルの出力を監視してください。
MongoDB の使用を開始します。
mongoshと同じホストマシン上でmongod セッションを開始します。コマンドライン オプションなしでmongoshを実行すると、デフォルト ポート27017を使用してローカルホストで実行されているmongodに接続できます。
mongoshmongosh を使った接続(別のホストやポートで実行されている mongod インスタンスへの接続など)の詳細については、「mongosh ドキュメント」を参照してください。
MongoDB をスムーズに使い始められるように、MongoDB ではさまざまなドライバー エディションでスタートガイドを提供しています。ドライバーのドキュメントについては、「MongoDB での開発スタートガイド」を参照してください。
詳細情報
デフォルトの Localhost バインディング
デフォルトでは、MongoDB は bindIp を 127.0.0.1 に設定して起動します。これは、ローカルホスト ネットワーク インターフェースにバインドされます。つまり、mongod インスタンスは、同じマシン上で実行されているクライアントからの接続のみを受け入れます。リモートクライアントが mongod インスタンスにアクセスできるようにするか、インスタンス上で レプリカセット を初期化するには、mongod をパブリックにアクセス可能なネットワークインターフェースにバインドする必要があります。
ネットワークインターフェースをバインドするには、構成ファイルの bindIp 設定を使用するか、--bind_ip コマンドラインオプションを使用して mongod を起動します。
警告
インスタンスをパブリックにアクセス可能な IP アドレスにバインドする前に、クラスターを不正アクセスから保護する必要があります。 セキュリティ推奨事項の完全なリストについては、「自己管理型配置のセキュリティ チェックリスト」を参照してください。 最低限、認証を有効化し、ネットワーク インフラストラクチャの強化 を検討してください。
bindIpの構成の詳細については、「自己管理型配置の IP バインディング 」を参照してください。
MongoDB Enterprise エディション パッケージ
MongoDB Enterprise エディションは専用のリポジトリから入手でき、次の公式にサポートされているパッケージが含まれています。
パッケージ名 | 説明 |
|---|---|
| 以下に掲げるコンポーネント パッケージを自動的にインストールする |
| 以下に掲げるコンポーネント パッケージを自動的にインストールする
|
| MongoDB Shell( |
| コンピューターにすでにインストールされている OpenSSL バージョン ( |
| 以下に掲げるコンポーネント パッケージを自動的にインストールする
|