Docs Menu
Docs Home
/
MongoDBマニュアル
/
自己管理型配置
/
インストール
/
Community Edition
/
Linux へのインストール

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

項目一覧

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

Overview

このチュートリアルでは、 aptパッケージ マネージャーを使用して、Ubuntu Linux の LTS (長期サポート) リリースに MongoDB 8.0 Community Editionをインストールします。

MongoDB バージョン

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

Considerations

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

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

  • 24.04 LTS ("Noble")

  • 22.04LTS("Jammy")

  • 20.04 LTS（Focal）

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

cat /etc/lsb-release

MongoDB 8.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 をインストールするには、次の手順に従います。

1

公開鍵をインポートします。

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

sudo apt-get install gnupg curl

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

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

リストファイルを作成します。

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

Ubuntu 24.04 (Noble) のリストファイルを作成します。

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

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

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

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

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

パッケージデータベースをリロードします。

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

sudo apt-get update
4

MongoDB Community Server をインストールします。

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

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

sudo apt-get install -y mongodb-org

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

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

mongodb-org=8.0.4 のみをインストールし、コンポーネント パッケージを含めない場合は、指定したバージョンに関係なく、各 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（サービス）] タブを選択します。


1

MongoDB を起動します。

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

sudo systemctl start mongod

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

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

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

sudo systemctl daemon-reload

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

2

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

sudo systemctl status mongod

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

sudo systemctl enable mongod
3

MongoDB を停止します。

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

sudo systemctl stop mongod
4

MongoDB を再起動します。

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

sudo systemctl restart mongod

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

5

MongoDB の使用を開始します。

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

mongosh

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

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

1

MongoDB を起動します。

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

sudo service mongod start
2

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

mongodプロセスが正常に開始されたことを確認します。

sudo service mongod status

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

[initandlisten] waiting for connections on port 27017

3

MongoDB を停止します。

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

sudo service mongod stop
4

MongoDB を再起動します。

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

sudo service mongod restart
5

MongoDB の使用を開始します。

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

mongosh

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

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

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

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

警告

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

1

MongoDB を停止します。

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

sudo service mongod stop
2

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

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

sudo apt-get purge mongodb-org*
3

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

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

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

詳細情報

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

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

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

  • 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 データベース ツールが含まれています。

mongodb-org-database-tools-extra

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

戻る

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

次へ

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