/ /

/ /

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

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

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

ターミナルから、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

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

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

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

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

sudo apt-get update

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

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

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

sudo apt-get install -y mongodb-org

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

sudo apt-get install -y \
   mongodb-org=8.0.12 \
   mongodb-org-database=8.0.12 \
   mongodb-org-server=8.0.12 \
   mongodb-mongosh \
   mongodb-org-shell=8.0.12 \
   mongodb-org-mongos=8.0.12 \
   mongodb-org-tools=8.0.12 \
   mongodb-org-database-tools-extra=8.0.12

mongodb-org=8.0.12 のみをインストールし、コンポーネントパッケージを含めない場合は、指定したバージョンに関係なく、各 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-cryptd hold" | sudo dpkg --set-selections
echo "mongodb-org-tools hold" | sudo dpkg --set-selections
echo "mongodb-org-database-tools-extra 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 バインディング

デフォルトでは、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 データベースツールが含まれています。 `mongodump` `mongorestore` `bsondump` `mongoimport` `mongoexport` `mongostat` `mongotop` `mongofiles`
`mongodb-org-database-tools-extra`	`install_compass` スクリプトが付属します

戻る

Red Hat へのインストール

Ubuntu へのインストールのトラブルシューティング

Overview

MongoDB バージョン

Considerations

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

プロダクション ノート

MongoDB の公式パッケージ

重要

MongoDB Community Edition のインストール

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

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

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

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

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

ulimit に関する考慮事項

注意

ディレクトリ

構成ファイル

手順

MongoDB を起動します。

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

MongoDB を停止します。

MongoDB を再起動します。

MongoDB の使用を開始します。

MongoDB を起動します。

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

MongoDB を停止します。

MongoDB を再起動します。

MongoDB の使用を開始します。

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

警告

MongoDB を停止します。

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

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

詳細情報

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

警告

MongoDB Community Edition パッケージ

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

プロダクションノート

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

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