MongoDB Community Edition を Ubuntu にインストール

項目一覧

Overview

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

注意

MongoDB Atlas

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

Overview

このチュートリアルでは、{0MongoDB MongoDB Community EditionUbuntuLinuxaptパッケージマネージャーを使用して、の LTS（長期サポート）リリースに 6.0 をインストールします。

MongoDB バージョン

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

Considerations

プラットフォームサポート

注意

EOL Notice

MongoDB 5.0 で、 x _8664 でMongoDB Community Edition のサポートが削除されます。Ubuntu16.04
MongoDB 5.0 は s x で390 MongoDB Community Editionのサポートを削除します。Ubuntu18.04

は、 x86_64 アーキテクチャ上の次のMongoDB MongoDB Community Edition64 ビットUbuntu LTS（長期サポート）リリースをサポートしています。

22.04 LTS （Jammy）（MongoDB 6.0.4 以降）
20.04 LTS（Focal）
18.04 LTS （Bionic）

MongoDB では、これらのプラットフォームの 64 ビット版のみをサポートしています。ホストが実行している Ubuntu リリースを確認するには、ホストのターミナルで次のコマンドを実行します。

cat /etc/lsb-release

MongoDB 6.0 MongoDB Community EditionをUbuntuで使用すると、特定のプラットフォームでARM64アーキテクチャをサポートします。

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

プロダクションノート

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

MongoDB の公式パッケージ

Ubuntu システムに MongoDB Community をインストールするには、MongoDB Inc. によって保守およびサポートされている公式の mongodb-org パッケージを使用します。公式の mongodb-org パッケージには常に最新バージョンの MongoDB が含まれおり、専用のリポジトリから入手できます。

重要

Ubuntu が提供する mongodb パッケージは MongoDB Inc. によって管理されていないため、公式の mongodb-org パッケージと競合します。Ubuntu システムの mongodb パッケージをすでにインストールしている場合は、これらの手順に入る前に、まず mongodb パッケージをアンインストールする必要があります。

公式パッケージの完全なリストについては、MongoDB Community Edition パッケージを参照してください。

MongoDB Community Edition のインストール

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

公開鍵のインポート

ターミナルから、gnupg と curl がまだ利用できない場合はインストールします。

sudo apt-get install gnupg curl

MongoDB 公開 GPG キーをインポートするには、次のコマンドを実行します。

curl -fsSL https://www.mongodb.org/static/pgp/server-6.0.asc | \
   sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg \
   --dearmor

リストファイルを作成する

Ubuntu のバージョンに合わせて /etc/apt/sources.list.d/mongodb-org-6.0.list のリストファイルを作成します。

Ubuntu 22.04 （Jammy）のリストファイルを作成します。

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

Ubuntu 20.04 （Focal）のリストファイルを作成します。

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

Ubuntu 18.04 （Bionic）のリストファイルを作成します。

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

パッケージデータベースを再ロードする

ローカルパッケージデータベースをリロードするには、次のコマンドを実行します。

sudo apt-get update

MongoDB Community Server のインストール

最新の安定版 MongoDB または特定のバージョンの MongoDB をインストールできます。

最新の安定したバージョンをインストールするには、以下を実行します。

sudo apt-get install -y mongodb-org

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

sudo apt-get install -y mongodb-org=6.0.17 mongodb-org-database=6.0.17 mongodb-org-server=6.0.17 mongodb-org-mongos=6.0.17 mongodb-org-tools=6.0.17

mongodb-org=6.0.17 のみをインストールし、コンポーネントパッケージを含めない場合は、指定したバージョンに関係なく、各 MongoDB パッケージの最新バージョンがインストールされます。

任意。使用可能な MongoDB のバージョンを任意に指定できますが、新しいバージョンが使用可能になると、apt-get によってパッケージがアップグレードされます。意図しないアップグレードを防ぐために、パッケージを現在インストールされているバージョンに固定することができます。

echo "mongodb-org hold" | sudo dpkg --set-selections
echo "mongodb-org-database hold" | sudo dpkg --set-selections
echo "mongodb-org-server hold" | sudo dpkg --set-selections
echo "mongodb-mongosh hold" | sudo dpkg --set-selections
echo "mongodb-org-mongos hold" | sudo dpkg --set-selections
echo "mongodb-org-tools hold" | sudo dpkg --set-selections

Ubuntu に MongoDB をインストール中に発生したエラーのトラブルシューティングについては、トラブルシューティングガイドを参照してください。

MongoDB コミュニティエディションの実行

ulimit に関する考慮事項: ほとんどの Unix 系オペレーティングシステムでは、プロセスが使用できるシステムリソースが制限されています。これらの制限は MongoDB の操作に悪影響を及ぼす可能性があるため、調整する必要があります。プラットフォームに推奨される設定については、「自己管理型配置の UNIX ulimit設定」を参照してください。
注意
オープンしているファイル数のulimit値が64000未満の場合、MongoDB は起動警告を生成します。

ディレクトリ

パッケージマネージャーを使用してインストールした場合、インストール中にデータディレクトリ/var/lib/mongodbとログディレクトリ/var/log/mongodbが作成されます。

デフォルトでは、MongoDB はmongodb ユーザーアカウントを使用して実行されます。MongoDB プロセスを実行するユーザーを変更する場合は、必ずデータディレクトリとログディレクトリのデータへの権限も変更して、このユーザーがこれらのディレクトリにアクセスできるようにしてください。

構成ファイル

公式 MongoDB パッケージには構成ファイル（/etc/mongod.conf）が含まれています。これらの設定（データディレクトリやログディレクトリの指定など）は起動時に有効になります。MongoDB インスタンスの実行中に構成ファイルを変更する場合、変更を有効にするにはインスタンスを再起動する必要があります。

手順

システム上で MongoDB Community Edition を実行するには、次の手順に従います。これらの手順では、Ubuntu が提供する非公式の mongodb パッケージではなく、公式の mongodb-org パッケージを使用し、デフォルト設定を使用していることを前提としています。

init システム

mongod プロセスを実行、管理するには、オペレーティングシステムに組み込まれている init システムを使用します。最近のバージョンの 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 start mongod

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

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

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

sudo systemctl daemon-reload

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

MongoDB が正常に起動したことを確認します。

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プロセスが正常に開始されたことを確認します。

sudo service mongod status

mongod プロセスの現在のステータスは、デフォルトで /var/log/mongodb/mongod.log にあるログファイルで確認することもできます。実行中の mongod インスタンスは、次の行で接続の準備ができていることを示します。

[initandlisten] waiting for connections on port 27017

MongoDB を停止します。

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

sudo service mongod stop

MongoDB を再起動します。

mongod を再起動するには、次のコマンドを実行します:

sudo service mongod restart

MongoDB の使用を開始します。

mongosh

MongoDB コミュニティエディションのアンインストール

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

警告

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

MongoDB を停止します。

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

sudo service mongod stop

パッケージを削除します。

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

sudo apt-get purge "mongodb-org*"

データディレクトリを削除します。

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

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

詳細情報

デフォルトの Localhost バインディング

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 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-mongosh

MongoDB Shell（mongosh）を含みます。

mongodb-org-tools

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

パッケージ名	説明
`mongodb-database-tools`	次の MongoDB データベースツールが含まれています。 `mongodump` `mongorestore` `bsondump` `mongoimport` `mongoexport` `mongostat` `mongotop` `mongofiles`
`mongodb-org-database-tools-extra`	`install_compass` スクリプトが付属します

戻る

.tgz を使用したインストールtarball

注意

MongoDB Atlas

Overview

MongoDB バージョン

Considerations

プラットフォーム サポート

注意

EOL Notice

プロダクション ノート

MongoDB の公式パッケージ

重要

MongoDB Community Edition のインストール

公開鍵のインポート

リスト ファイルを作成する

パッケージ データベースを再ロードする

MongoDB Community Server のインストール

MongoDB コミュニティ エディションの実行

注意

手順

MongoDB を起動します。

MongoDB が正常に起動したことを確認します。

MongoDB を停止します。

MongoDB を再起動します。

MongoDB の使用を開始します。

MongoDB を起動します。

MongoDB が正常に起動したことを確認します

MongoDB を停止します。

MongoDB を再起動します。

MongoDB の使用を開始します。

MongoDB コミュニティ エディション のアンインストール

警告

MongoDB を停止します。

パッケージを削除します。

データディレクトリを削除します。

詳細情報

デフォルトの Localhost バインディング

警告

MongoDB Community Edition パッケージ

プラットフォームサポート

プロダクションノート

リストファイルを作成する

パッケージデータベースを再ロードする

MongoDB コミュニティエディションの実行

MongoDB コミュニティエディションのアンインストール