Docs Menu
Docs Home
/
MongoDBマニュアル
/ / /

MongoDB Community Edition の macOS へのインストール

項目一覧

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

このチュートリアルでは、MongoDB 8.0 Community Edition を、サードパーティの Homebrew パッケージ マネージャーを使用して macOS にインストールします。

MongoDB 4.4.1 以降、Homebrew 経由で MongoDB をインストールすると 、MongoDB データベースツール もインストールされます。詳細については、「MongoDB データベースツールの使用」を参照してください。

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

MongoDB 8.0 Community Edition は macOS 11 以降をサポートしています。

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

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

システムが次の各前提条件を満たしていることを確認してください。 各前提条件ステップは、システム上で 1 回だけ実行する必要があります。 Homebrew を使用して以前の MongoDB インストールの一環として必要な手順をすでに実行している場合は、インストール手順に進んでください。

Homebrew には、Apple Xcode の Xcode コマンドライン ツールが必要です。

  • macOS ターミナルで次のコマンドを実行して、Xcode コマンドライン ツールをインストールします。

    xcode-select --install

macOS には、デフォルトでは Homebrew brew パッケージは含まれていません。

Homebrew の brew パッケージ マネージャーを使用して MongoDB Community Edition をインストールするには、次の手順に従います。手順に進む前に、上記のインストールの前提条件に従っていることを確認してください。

  1. [MongoDB Homebrew Tap] をタップして、MongoDB と Database Tools の公式 Homebrew フォーミュラをダウンロードし、macOS ターミナルで次のコマンドを実行してください。

    brew tap mongodb/brew

    MongoDB の以前のインストールですでにこれを実行している場合は、この手順を省略できます。

  2. To update Homebrew and all existing formulae:

    brew update
  3. MongoDB をインストールするには、macOS のターミナルアプリケーションで以下のコマンドを実行します。

    brew install mongodb-community@8.0

Tip

あるいは、必要に応じて、MongoDB の前のバージョンを指定することもできます。この方法では、複数のバージョンの MongoDB を並行して管理できます。

Tip

以前に古いバージョンのフォーミュラをインストールしたことがある場合は、 ChecksumMismatchError が発生することがあります。 解決するには、 「 ChecksumMismatchError のトラブルシューティング 」を参照してください。

インストールには、次のバイナリが含まれています。

さらに、お使いの Apple ハードウェアに応じて、インストールにより、以下の指定された場所に次のファイルとディレクトリが作成されます。

Intel プロセッサ
Apple Silicon Processor
/usr/local/etc/mongod.conf
/opt/homebrew/etc/mongod.conf
/usr/local/var/log/mongodb
/opt/homebrew/var/log/mongodb
/usr/local/var/mongodb
/opt/homebrew/var/mongodb

Apple Silicon プロセッサを使用する Apple ハードウェアの最新リストについては、Apple のドキュメント を参照してください。また、次のコマンドを実行して、brew で上記のファイルとディレクトリがインストールされた場所を確認することもできます。

brew --prefix

MongoDB 4.4.1 以降、インストールには MongoDB データベースツール も付属しています。詳細については、「MongoDB データベースツールの使用」を参照してください。

MongoDB コミュニティ エディション を実行するには、次の手順で行います。これらの手順は、デフォルト設定を使用していることを前提としています。

You can run MongoDB as a macOS service using brew, or you can run MongoDB manually as a background process. It is recommended to run MongoDB as a macOS service, as doing so sets the correct system ulimit values automatically (see ulimit settings for more information).

  • MongoDB(mongod プロセスなど)を macOS サービスとして実行するには、次を実行します。

    brew services start mongodb-community@8.0

    macOS サービスとして実行している mongod を停止するには、必要に応じて次のコマンドを使用します。

    brew services stop mongodb-community@8.0
  • 設定ファイルを使用して mongodバックグラウンド プロセスとして手動で実行するには、次を実行します。

    • For macOS running Intel processors:

      mongod --config /usr/local/etc/mongod.conf --fork
    • Apple Silicon プロセッサ

      mongod --config /opt/homebrew/etc/mongod.conf --fork
  • コマンドラインで --dbpath--logpath を指定して、バックグラウンド プロセスとして手動で mongod を起動するには、次を実行します。

    mongod --dbpath /path/to/dbdir --logpath /path/to/mongodb.log --fork

    バックグラウンド プロセスとして実行中の mongod を停止するには、mongosh を使用して mongod を接続し、shutdown コマンドを必要に応じて出します。

どちらの方法でも、インストール中に作成された mongod.conf ファイルが使用されます。このファイルに独自の MongoDB 構成オプションを追加することもできます。

注意

macOS が mongod の起動を防ぐ

macOS はインストール後に mongod の実行を妨げられる可能性があります。mongod を起動時に、開発者を識別または認証できなかったことを示すセキュリティ エラーが発生した場合は、次の操作を行って mongod のアクセスを許可してください。

  • システム環境設定を開く

  • [セキュリティとプライバシー] を選択します。

  • [一般] タブで、お使いの macOS のバージョンに応じて Open Anyway、または Allow Anyway と表示された、mongod に関するいずれかのメッセージの右側のボタンをクリックします。

To verify that MongoDB is running, perform one of the following:

  • MongoDB をmacOS サービスとして起動した場合、

    brew services list

    mongodb-community サービスが started と表示されます。

  • MongoDB をバックグラウンド プロセスとして手動で起動した場合、

    ps aux | grep -v grep | grep mongod

    出力に mongod プロセスが表示されます。

ログファイルを表示して、mongod プロセスの現在のステータスを /usr/local/var/log/mongodb/mongo.log として確認することもできます。

MongoDB の使用を開始するには、実行中のインスタンスに mongosh を接続します。新しいターミナルから、次のコマンドを実行します。

mongosh

For information on CRUD (Create,Read,Update,Delete) operations, see:

MongoDB 4.4.1 以降では、brew を介して MongoDB をインストールすると、MongoDB データベースツールもインストールされます。

MongoDB データベースツール は MongoDB 配置を操作するためのコマンドライン ユーティリティのコレクションであり、mongoimportmongodump などのデータのバックアップとインポートまたはエクスポート ツール、そしてmongotop などの監視ツールが含まれます。

上記の手順で MongoDB Server をインストールしたら、macOSのターミナルアプリケーションのコマンドラインから直接 Database Tools を利用できます。たとえば、次のように macOS ターミナルで呼び出すことで、実行中の MongoDB インスタンスに対して mongotop を実行できます。

mongotop

起動され、実行中の mongod に接続され、使用状況統計のレポート作成が開始されます。

各 Database Tools の使用方法については、「MongoDB データベースツールのドキュメント」を参照してください。

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

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

  • MongoDB設定ファイルでbindIpを使用する。または

  • コマンドライン引数を経由する。 --bind_ip

警告

インスタンスをパブリックにアクセス可能な IP アドレスにバインドする前に、クラスターを不正アクセスから保護する必要があります。 セキュリティ推奨事項の完全なリストについては、「自己管理型配置のセキュリティ チェックリスト」を参照してください。 最低限、認証を有効化し、ネットワーク インフラストラクチャの強化 を検討してください。

bindIpの構成の詳細については、「自己管理型配置の IP バインディング 」を参照してください。

以前に古いバージョンのフォーミュラをインストールしたことがある場合は、次のような ChecksumMismatchError が表示されることがあります。

Error: An exception occurred within a child process:
ChecksumMismatchError: SHA256 mismatch
Expected: c7214ee7bda3cf9566e8776a8978706d9827c1b09017e17b66a5a4e0c0731e1f
Actual: 6aa2e0c348e8abeec7931dced1f85d4bb161ef209c6af317fe530ea11bbac8f0
Archive: /Users/kay/Library/Caches/Homebrew/downloads/a6696157a9852f392ec6323b4bb697b86312f0c345d390111bd51bb1cbd7e219--mongodb-macos-x86_64-4.2.0.tgz
To retry an incomplete download, remove the file above.

修正するには、

  1. Remove the downloaded .tgz archive.

  2. Retap the formula.

    brew untap mongodb/brew && brew tap mongodb/brew
  3. インストールを再度行ってください。

    brew install mongodb-community@8.0

戻る

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